pio_handler.c File Reference

Parallel Input/Output (PIO) interrupt handler for SAM.

Copyright (c) 2011-2018 Microchip Technology Inc. and its subsidiaries.

#include "pio.h"
#include "pio_handler.h"

Data Structures
struct	s_interrupt_source
	Describes a PIO interrupt source, including the PIO instance triggering the interrupt and the associated interrupt handler. More...

Macros
#define	MAX_INTERRUPT_SOURCES   7
	Maximum number of interrupt sources that can be defined. More...

Functions
void	pio_handler_process (Pio *p_pio, uint32_t ul_id)
	Process an interrupt request on the given PIO controller. More...
uint32_t	pio_handler_set (Pio *p_pio, uint32_t ul_id, uint32_t ul_mask, uint32_t ul_attr, void(*p_handler)(uint32_t, uint32_t))
	Set an interrupt handler for the provided pins. More...
void	pio_handler_set_priority (Pio *p_pio, IRQn_Type ul_irqn, uint32_t ul_priority)
	Initialize PIO interrupt management logic. More...

Variables
static struct s_interrupt_source	gs_interrupt_sources [MAX_INTERRUPT_SOURCES]
static uint32_t	gs_ul_nb_sources = 0

#define MAX_INTERRUPT_SOURCES   7

Maximum number of interrupt sources that can be defined.

This constant can be increased, but the current value is the smallest possible one that will be compatible with all existing projects.

Referenced by pio_handler_process(), and pio_handler_set().

void pio_handler_process	(	Pio *	p_pio,
		uint32_t	ul_id
	)

Process an interrupt request on the given PIO controller.

Parameters

p_pio	PIO controller base address.
ul_id	PIO controller ID.

References gs_interrupt_sources, s_interrupt_source::handler, s_interrupt_source::mask, MAX_INTERRUPT_SOURCES, pio_get_interrupt_mask(), and pio_get_interrupt_status().

uint32_t pio_handler_set	(	Pio *	p_pio,
		uint32_t	ul_id,
		uint32_t	ul_mask,
		uint32_t	ul_attr,
		void(*)(uint32_t, uint32_t)	p_handler
	)

Set an interrupt handler for the provided pins.

The provided handler will be called with the triggering pin as its parameter as soon as an interrupt is detected.

Parameters

p_pio	PIO controller base address.
ul_id	PIO ID.
ul_mask	Pins (bit mask) to configure.
ul_attr	Pins attribute to configure.
p_handler	Interrupt handler function pointer.

Returns

0 if successful, 1 if the maximum number of sources has been defined.

References s_interrupt_source::attr, gs_interrupt_sources, gs_ul_nb_sources, s_interrupt_source::handler, s_interrupt_source::id, s_interrupt_source::mask, MAX_INTERRUPT_SOURCES, and pio_configure_interrupt().

Referenced by configure_button().

void pio_handler_set_priority	(	Pio *	p_pio,
		IRQn_Type	ul_irqn,
		uint32_t	ul_priority
	)

Initialize PIO interrupt management logic.

Parameters

p_pio	PIO controller base address.
ul_irqn	NVIC line number.
ul_priority	PIO controller interrupts priority.

References pio_disable_interrupt(), pio_enable_interrupt(), pio_get_interrupt_mask(), and pio_get_interrupt_status().

Referenced by init_specific_board().

struct s_interrupt_source gs_interrupt_sources[MAX_INTERRUPT_SOURCES]

static

Referenced by pio_handler_process(), and pio_handler_set().

uint32_t gs_ul_nb_sources = 0

static

Referenced by pio_handler_set().