Interrupt library

Functions
int	gpio_interrupt_init (void)
void	gpio_ack_interrupt (void)
void	verify_interrupt_request (const io_t pin)
void	gpio_print_interrupt (void)
void	gpio_enable_interrupt (const io_t pin)
void	gpio_disable_interrupt (const io_t pin)
void	gpio_disable_all_interrupts (void)
uint64_t	gpio_get_interrupt (void)
uint8_t *	gpio_get_interrupt_pins (uint8_t *positions)
void	gpio_wait_for_interrupt (const io_t pin)

Detailed Description

Functions for interrupt handling.

An example of using this library

#include <libpynq.h>
int main (void)
{
  gpio_init(void);
  gpio_reset(void);
  switchbox_init(void);
  switchbox_reset(void);
  gpio_set_direction(IO_LD0, GPIO_DIR_OUTPUT);
  // initialize the interrupt
  gpio_interrupt_init(void);
  gpio_enable_interrupt(IO_BTN0);
  gpio_set_direction(IO_LD0, GPIO_DIR_OUTPUT);
  while(1) {
    gpio_wait_for_interrupt(64); //Wait untill an interupt arrives
    uint8_t* interruptPin = gpio_get_interrupt_pins(void);
    if (interruptPin[0] == IO_BTN0) {
      printf("interrupt on IO_BTN0, turning on IO_LD0\n");
      gpio_set_level(IO_LD0, 1);
    } else {
      printf("interrupt on pin %d\n",interruptPin[0]);
      gpio_set_level(IO_LD0, 0);
    }
    gpio_ack_interrupt(void);
  }
  gpio_destroy(void);
  switchbox_destroy(void);
  return EXIT_SUCCESS;
}

Function Documentation

gpio_ack_interrupt()

void gpio_ack_interrupt ( void  )

extern

acknowledges the raised interrupts and resets the interrupt word. Allows new interrupts to occur on the previously triggered pins.

Definition at line 91 of file interrupt.c.

Here is the call graph for this function:

gpio_disable_all_interrupts()

void gpio_disable_all_interrupts ( void  )

extern

Disables all interrupts from being raised.

Definition at line 77 of file interrupt.c.

Here is the call graph for this function:

gpio_disable_interrupt()

void gpio_disable_interrupt ( const io_t  pin )

extern

Disables interrupts from occuring on the specific pin. Hereafter, the pin will not trigger an interrupt.

Parameters

pin	to be disabled from obtianing interrupts

Definition at line 72 of file interrupt.c.

Here is the call graph for this function:

gpio_enable_interrupt()

void gpio_enable_interrupt ( const io_t  pin )

extern

enables a specific pin to raise interrupts.

Parameters

pin	to raise interrupts

Definition at line 59 of file interrupt.c.

Here is the call graph for this function:

gpio_get_interrupt()

uint64_t gpio_get_interrupt ( void  )

extern

Returns

the 64 bits on which interrupts are indicated by a one. The bits are in accordance with the pins described in pinmap.h

Definition at line 83 of file interrupt.c.

Here is the call graph for this function:

Here is the caller graph for this function:

gpio_get_interrupt_pins()

uint8_t * gpio_get_interrupt_pins ( uint8_t *  positions )

extern

Gets all pins on which an interrupt occurred.

Returns

a pointer to an array of maximum 64 intergers. The integers correspond to pins with a pending interrupt.

Definition at line 160 of file interrupt.c.

Here is the call graph for this function:

gpio_interrupt_init()

int gpio_interrupt_init ( void  )

extern

Enables interrupts to be set and read.

Definition at line 48 of file interrupt.c.

gpio_print_interrupt()

void gpio_print_interrupt ( void  )

extern

prints the current interrupt word

Definition at line 117 of file interrupt.c.

Here is the call graph for this function:

gpio_wait_for_interrupt()

void gpio_wait_for_interrupt ( const io_t  pin )

extern

Waits untill an interrupt occurs on the specified pin or if the value of pin is larger than 63, if any interrupt has occurred.

Parameters

pin	The pin on which an interrupt should occur

Definition at line 138 of file interrupt.c.

Here is the call graph for this function:

verify_interrupt_request()

void verify_interrupt_request ( const io_t  pin )

extern

Checks for error in enabled pin. Terminates the process if the pin is not enabled.

Parameters

pin	indicates a specific pin or if larger than 63, if any interrupt pin is enabled

Definition at line 96 of file interrupt.c.

Here is the caller graph for this function: