Interrupt library

Functions
int	gpio_interrupt_init (void)
void	gpio_ack_interrupt (void)
void	verify_interrupt_request (const gpio_t pin)
void	gpio_print_interrupt (void)
void	gpio_enable_interrupt (const gpio_t pin)
void	gpio_disable_interrupt (const gpio_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 gpio_t pin)

Detailed Description

This library provides 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(SWB_LD0, GPIO_DIR_OUTPUT);
  // initialize the interrupt
  gpio_interrupt_init(void);
  gpio_enable_interrupt(SWB_BTN0);
  gpio_set_direction(SWB_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] == SWB_BTN0) {
      printf("interrupt on SWB_BTN0, turning on SWB_LD0\n");
      gpio_set_level(SWB_LD0, 1);
    } else {
      printf("interrupt on pin %d\n",interruptPin[0]);
      gpio_set_level(SWB_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

)

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.

gpio_disable_all_interrupts()

void gpio_disable_all_interrupts

(

void

)

Disables all interrupts from being raised.

Definition at line 77 of file interrupt.c.

gpio_disable_interrupt()

void gpio_disable_interrupt

(

const gpio_t

pin

)

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.

gpio_enable_interrupt()

void gpio_enable_interrupt

(

const gpio_t

pin

)

enables a specific pin to raise interrupts.

Parameters

pin	to raise interrupts

Definition at line 59 of file interrupt.c.

gpio_get_interrupt()

uint64_t gpio_get_interrupt

(

void

)

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 caller graph for this function:

gpio_get_interrupt_pins()

uint8_t * gpio_get_interrupt_pins

(

uint8_t *

positions

)

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 164 of file interrupt.c.

Here is the call graph for this function:

gpio_interrupt_init()

int gpio_interrupt_init

(

void

)

Enables interrupts to be set and read.

Definition at line 48 of file interrupt.c.

gpio_print_interrupt()

void gpio_print_interrupt

(

void

)

prints the current interrupt word

Definition at line 121 of file interrupt.c.

gpio_wait_for_interrupt()

void gpio_wait_for_interrupt

(

const gpio_t

pin

)

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 142 of file interrupt.c.

Here is the call graph for this function:

verify_interrupt_request()

void verify_interrupt_request

(

const gpio_t

pin

)

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 100 of file interrupt.c.

Here is the caller graph for this function: