GPIOTE handler module. More...

Macros
#define	GPIOTE_USER_NODE_SIZE 20

#define	NO_OF_PINS 32

#define	APP_GPIOTE_BUF_SIZE(MAX_USERS) ((MAX_USERS) * GPIOTE_USER_NODE_SIZE)
	Compute number of bytes required to hold the GPIOTE data structures. More...

#define	APP_GPIOTE_INIT(MAX_USERS)
	Macro for initializing the GPIOTE module. More...

Typedefs
typedef uint8_t	app_gpiote_user_id_t

typedef void(*	app_gpiote_event_handler_t )(uint32_t event_pins_low_to_high, uint32_t event_pins_high_to_low)
	GPIOTE event handler type.

Functions
uint32_t	app_gpiote_init (uint8_t max_users, void *p_buffer)
	Function for initializing the GPIOTE module. More...

uint32_t	app_gpiote_user_register (app_gpiote_user_id_t *p_user_id, uint32_t pins_low_to_high_mask, uint32_t pins_high_to_low_mask, app_gpiote_event_handler_t event_handler)
	Function for registering a GPIOTE user. More...

uint32_t	app_gpiote_user_enable (app_gpiote_user_id_t user_id)
	Function for informing the GPIOTE module that the specified user wants to use the GPIOTE module. More...

uint32_t	app_gpiote_user_disable (app_gpiote_user_id_t user_id)
	Function for informing the GPIOTE module that the specified user is done using the GPIOTE module. More...

uint32_t	app_gpiote_pins_state_get (app_gpiote_user_id_t user_id, uint32_t *p_pins)
	Function for getting the state of the pins which are registered for the specified user. More...

Detailed Description

The GPIOTE handler allows several modules ("users") to share the GPIOTE interrupt, each user defining a set of pins able to generate events to the user. When a GPIOTE interrupt occurs, the GPIOTE interrupt handler will call the event handler of each user for which at least one of the pins generated an event.

The GPIOTE users are responsible for configuring all their corresponding pins, except the SENSE field, which should be initialized to GPIO_PIN_CNF_SENSE_Disabled. The SENSE field will be updated by the GPIOTE module when it is enabled or disabled, and also while it is enabled.

The module specifies on which pins events should be generated if the pin(s) goes from low->high or high->low or both directions.

Note: Even if the application is using the Scheduler, the GPIOTE event handlers will be called directly from the GPIOTE interrupt handler.

Macro Definition Documentation

#define GPIOTE_USER_NODE_SIZE 20

Size of app_gpiote.gpiote_user_t (only for use inside APP_GPIOTE_BUF_SIZE()).

#define NO_OF_PINS 32

Number of GPIO pins on the nRF51 chip.

#define APP_GPIOTE_BUF_SIZE ( MAX_USERS ) ((MAX_USERS) * GPIOTE_USER_NODE_SIZE)

Parameters

[in] MAX_USERS Maximum number of GPIOTE users.

Returns: Required buffer size (in bytes).

#define APP_GPIOTE_INIT ( MAX_USERS )

Value:

do                                                                                             \
    {                                                                                              \
        static uint32_t app_gpiote_buf[CEIL_DIV(APP_GPIOTE_BUF_SIZE(MAX_USERS), sizeof(uint32_t))];\
        uint32_t ERR_CODE = app_gpiote_init((MAX_USERS), app_gpiote_buf);                          \
        APP_ERROR_CHECK(ERR_CODE);                                                                 \
    } while (0)

It will handle dimensioning and allocation of the memory buffer required by the module, making sure that the buffer is correctly aligned.

Parameters

[in] MAX_USERS Maximum number of GPIOTE users.

Note: Since this macro allocates a buffer, it must only be called once (it is OK to call it several times as long as it is from the same location, e.g. to do a reinitialization).

Function Documentation

uint32_t app_gpiote_init	(	uint8_t	max_users,
		void *	p_buffer
	)

Note: Normally initialization should be done using the APP_GPIOTE_INIT() macro, as that will allocate the buffer needed by the GPIOTE module (including aligning the buffer correctly).

Parameters

[in]	max_users	Maximum number of GPIOTE users.
[in]	p_buffer	Pointer to memory buffer for internal use in the app_gpiote module. The size of the buffer can be computed using the APP_GPIOTE_BUF_SIZE() macro. The buffer must be aligned to a 4 byte boundary.

Return values

NRF_SUCCESS	Successful initialization.
NRF_ERROR_INVALID_PARAM	Invalid parameter (buffer not aligned to a 4 byte boundary).

uint32_t app_gpiote_user_register	(	app_gpiote_user_id_t *	p_user_id,
		uint32_t	pins_low_to_high_mask,
		uint32_t	pins_high_to_low_mask,
		app_gpiote_event_handler_t	event_handler
	)

Parameters

[out]	p_user_id	Id for the new GPIOTE user.
[in]	pins_low_to_high_mask	Mask defining which pins will generate events to this user when state is changed from low->high.
[in]	pins_high_to_low_mask	Mask defining which pins will generate events to this user when state is changed from high->low.
[in]	event_handler	Pointer to function to be executed when an event occurs.

Return values

NRF_SUCCESS	Successful initialization.
NRF_ERROR_INVALID_PARAM	Invalid parameter (buffer not aligned to a 4 byte boundary).
NRF_ERROR_INALID_STATE	If app_gpiote_init has not been called on the GPIOTE module.
NRF_ERROR_NO_MEM	Returned if the application tries to register more users than defined when the GPIOTE module was initialized in app_gpiote_init.

uint32_t app_gpiote_user_enable ( app_gpiote_user_id_t user_id )

Parameters

[in] user_id Id of user to enable.

Return values

NRF_SUCCESS	On success.
NRF_ERROR_INVALID_PARAM	Invalid user_id provided, No a valid user.
NRF_ERROR_INALID_STATE	If app_gpiote_init has not been called on the GPIOTE module.

uint32_t app_gpiote_user_disable ( app_gpiote_user_id_t user_id )

Parameters

[in] user_id Id of user to enable.

Returns: NRF_SUCCESS On success.

Return values

NRF_ERROR_INVALID_PARAM	Invalid user_id provided, No a valid user.
NRF_ERROR_INALID_STATE	If app_gpiote_init has not been called on the GPIOTE module.

uint32_t app_gpiote_pins_state_get	(	app_gpiote_user_id_t	user_id,
		uint32_t *	p_pins
	)

Parameters

[in]	user_id	Id of user to check.
[out]	p_pins	Bit mask corresponding to the pins configured to generate events to the specified user. All bits corresponding to pins in the state 'high' will have value '1', all others will have value '0'.

Returns: NRF_SUCCESS On success.

Return values

NRF_ERROR_INVALID_PARAM	Invalid user_id provided, No a valid user.
NRF_ERROR_INALID_STATE	If app_gpiote_init has not been called on the GPIOTE module.

Macros

Typedefs

Functions

Detailed Description

Macro Definition Documentation

Function Documentation