GPIOTE driver

group nrfx_gpiote

GPIO Task Event (GPIOTE) peripheral driver.

Defines

NRFX_GPIOTE_DEFAULT_OUTPUT_CONFIG

Output pin default configuration.

NRFX_GPIOTE_DEFAULT_INPUT_CONFIG

Input pin default configuration.

NRFX_GPIOTE_CONFIG_IN_SENSE_LOTOHI(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.

Set hi_accu to true to use IN_EVENT.

NRFX_GPIOTE_CONFIG_IN_SENSE_HITOLO(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.

Set hi_accu to true to use IN_EVENT.

NRFX_GPIOTE_CONFIG_IN_SENSE_TOGGLE(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.

Set hi_accu to true to use IN_EVENT.

NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_LOTOHI(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.

Set hi_accu to true to use IN_EVENT.

Note

This macro prepares configuration that skips the GPIO setup.

NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_HITOLO(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.

Set hi_accu to true to use IN_EVENT.

Note

This macro prepares configuration that skips the GPIO setup.

NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_TOGGLE(hi_accu)

Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.

Set hi_accu to true to use IN_EVENT.

Note

This macro prepares configuration that skips the GPIO setup.

NRFX_GPIOTE_CONFIG_OUT_SIMPLE(init_high)

Macro for configuring a pin to use as output. GPIOTE is not used for the pin.

NRFX_GPIOTE_CONFIG_OUT_TASK_LOW

Macro for configuring a pin to use the GPIO OUT TASK to change the state from high to low.

The task will clear the pin. Therefore, the pin is set initially.

NRFX_GPIOTE_CONFIG_OUT_TASK_HIGH

Macro for configuring a pin to use the GPIO OUT TASK to change the state from low to high.

The task will set the pin. Therefore, the pin is cleared initially.

NRFX_GPIOTE_CONFIG_OUT_TASK_TOGGLE(init_high)

Macro for configuring a pin to use the GPIO OUT TASK to toggle the pin state.

The initial pin state must be provided.

NRFX_GPIOTE_APP_CHANNELS_MASK

Bitfield representing all GPIOTE channels available to the application.

Typedefs

typedef uint32_t nrfx_gpiote_pin_t

Pin.

typedef void (*nrfx_gpiote_interrupt_handler_t)(nrfx_gpiote_pin_t pin, nrfx_gpiote_trigger_t trigger, void *p_context)

Pin interrupt handler prototype.

Param pin

[in] Pin that triggered this event.

Param trigger

[in] Trigger that led to this event.

Param p_context

[in] User context.

typedef void (*nrfx_gpiote_evt_handler_t)(nrfx_gpiote_pin_t pin, nrf_gpiote_polarity_t action)

Legacy pin event handler prototype.

Param pin

[in] Pin that triggered this event.

Param action

[in] Action that led to triggering this event.

Enums

enum nrfx_gpiote_trigger_t

Triggering options.

Values:

enumerator NRFX_GPIOTE_TRIGGER_NONE

No trigger on a pin.

enumerator NRFX_GPIOTE_TRIGGER_LOTOHI

Low to high edge trigger.

enumerator NRFX_GPIOTE_TRIGGER_HITOLO

High to low edge trigger.

enumerator NRFX_GPIOTE_TRIGGER_TOGGLE

Edge toggle trigger.

enumerator NRFX_GPIOTE_TRIGGER_LOW

Level low trigger.

enumerator NRFX_GPIOTE_TRIGGER_HIGH

Level high trigger.

enumerator NRFX_GPIOTE_TRIGGER_MAX

Triggering options count.

Functions

nrfx_err_t nrfx_gpiote_init(uint8_t interrupt_priority)

Function for initializing the GPIOTE module.

Parameters

  • interrupt_priority – [in] Interrupt priority.

Return values

  • NRFX_SUCCESS – Initialization was successful.

  • NRFX_ERROR_INVALID_STATE – The driver was already initialized.

bool nrfx_gpiote_is_init(void)

Function for checking if the GPIOTE module is initialized.

The GPIOTE module is a shared module. Therefore, check if the module is already initialized and skip initialization if it is.

Return values

  • true – The module is already initialized.

  • false – The module is not initialized.

void nrfx_gpiote_uninit(void)

Function for uninitializing the GPIOTE module.

nrfx_err_t nrfx_gpiote_channel_alloc(uint8_t *p_channel)

Function for allocating a GPIOTE channel.

This function allocates the first unused GPIOTE channel from pool defined in NRFX_GPIOTE_APP_CHANNELS_MASK.

Note

Function is thread safe as it uses nrfx_flag32_alloc.

Note

Routines that allocate and free the GPIOTE channels are independent from the rest of the driver. In particular, the driver does not need to be initialized when this function is called.

Parameters

  • p_channel – [out] Pointer to the GPIOTE channel that has been allocated.

Return values

  • NRFX_SUCCESS – The channel was successfully allocated.

  • NRFX_ERROR_NO_MEM – There is no available channel to be used.

nrfx_err_t nrfx_gpiote_channel_free(uint8_t channel)

Function for freeing a GPIOTE channel.

This function frees a GPIOTE channel that was allocated using nrfx_gpiote_channel_alloc.

Note

Function is thread safe as it uses nrfx_flag32_free.

Note

Routines that allocate and free the GPIOTE channels are independent from the rest of the driver. In particular, the driver does not need to be initialized when this function is called.

Parameters

  • channel – [in] GPIOTE channel to be freed.

Return values

  • NRFX_SUCCESS – The channel was successfully freed.

  • NRFX_ERROR_INVALID_PARAM – The channel is not user-configurable.

nrfx_err_t nrfx_gpiote_input_configure(nrfx_gpiote_pin_t pin, nrfx_gpiote_input_config_t const *p_input_config, nrfx_gpiote_trigger_config_t const *p_trigger_config, nrfx_gpiote_handler_config_t const *p_handler_config)

Function for configuring the specified input pin and input event/interrupt.

Prior to calling this function pin can be uninitialized or configured as input or output. However, following transitions and configurations are invalid and result in error returned by the function:

  • Setting level trigger (e.g. NRFX_GPIOTE_TRIGGER_HIGH) and using GPIOTE channel for the same pin.

  • Reconfiguring pin to input (p_input_config not NULL) when pin was configured to use GPIOTE task. Prior to that, task must be disabled by configuring it with polarity set to NRF_GPIOTE_POLARITY_NONE.

  • Configuring trigger using GPIOTE channel for pin previously configured as output pin. Only sensing can be used for an output pin.

Function can be used to configure trigger and handler for sensing input changes on an output pin. In that case, prior to that output pin must be configured with input buffer connected. In that case p_input_config is NULL to avoid reconfiguration of the pin.

Parameters

  • pin – [in] Absolute pin number.

  • p_input_config – [in] Pin configuration. If NULL, the current configuration is untouched.

  • p_trigger_config – [in] Interrupt/event configuration. If NULL, the current configuration is untouched.

  • p_handler_config – [in] Handler configuration. If NULL it is untouched.

Return values

  • NRFX_SUCCESS – Configuration was successful.

  • NRFX_ERROR_INVALID_PARAM – Invalid configuration.

nrfx_err_t nrfx_gpiote_output_configure(nrfx_gpiote_pin_t pin, nrfx_gpiote_output_config_t const *p_config, nrfx_gpiote_task_config_t const *p_task_config)

Function for configuring the specified output pin to be used by the driver.

Prior to calling this function pin can be uninitialized or configured as input or output. However, following transitions and configurations are invalid and result in error returned by the function:

  • Reconfiguring pin to output when pin was configured as input with trigger using GPIOTE channel. Prior to that, trigger must be disabled by configuring it as NRFX_GPIOTE_TRIGGER_NONE.

  • Configuring pin as output without input buffer connected when prior to that trigger was configured. In that case input buffer must be connected.

  • Configuring GPIOTE task for pin which was previously configured as input. Before using GPIOTE task pin must be configured as output by providing p_config.

Parameters

  • pin – [in] Absolute pin number.

  • p_config – [in] Pin configuration. If NULL pin configuration is not applied.

  • p_task_config – [in] GPIOTE task configuration. If NULL task is not used.

Return values

  • NRFX_SUCCESS – Configuration was successful.

  • NRFX_ERROR_INVALID_PARAM – Invalid configuration.

nrfx_err_t nrfx_gpiote_pin_uninit(nrfx_gpiote_pin_t pin)

Function for deinitializing the specified pin.

Specified pin and associated GPIOTE channel are restored to the default configuration.

Warning

GPIOTE channel used by the pin is not freed.

Parameters

  • pin – [in] Absolute pin number.

Return values

  • NRFX_SUCCESS – Uninitialization was successful.

  • NRFX_ERROR_INVALID_PARAM – Pin not used by the driver.

void nrfx_gpiote_trigger_enable(nrfx_gpiote_pin_t pin, bool int_enable)

Function for enabling trigger for the given pin.

When GPIOTE event is used trigger can be enabled without enabling interrupt, e.g. for PPI.

Parameters

  • pin – [in] Absolute pin number.

  • int_enable – [in] True to enable the interrupt. Must be true when sensing is used.

void nrfx_gpiote_trigger_disable(nrfx_gpiote_pin_t pin)

Function for disabling trigger for the given pin.

Parameters

  • pin – [in] Absolute pin number.

void nrfx_gpiote_global_callback_set(nrfx_gpiote_interrupt_handler_t handler, void *p_context)

Set global callback called for each event.

Parameters

  • handler – [in] Global handler.

  • p_context – [in] Context passed to the handler.

nrfx_err_t nrfx_gpiote_channel_get(nrfx_gpiote_pin_t pin, uint8_t *p_channel)

Function for retrieving Task/Event channel index associated with the given pin.

Parameters

  • pin – [in] Absolute pin number.

  • p_channel – [out] Location to write the channel index.

Return values

  • NRFX_SUCCESS – Channel successfully written.

  • NRFX_ERROR_INVALID_PARAM – Pin is not configured or not using Task or Event.

nrfx_err_t nrfx_gpiote_out_init(nrfx_gpiote_pin_t pin, nrfx_gpiote_out_config_t const *p_config)

Function for initializing a GPIOTE output pin.

The output pin can be controlled by the CPU or by PPI. The initial configuration specifies which mode is used. If PPI mode is used, the driver attempts to allocate one of the available GPIOTE channels. If no channel is available, an error is returned.

Note

This function is deprecated. Use nrfx_gpiote_output_configure preceded by nrfx_gpiote_channel_alloc (provided that GPIOTE task is to be utilized) instead.

Parameters

  • pin – [in] Pin.

  • p_config – [in] Initial configuration.

Return values

  • NRFX_SUCCESS – Initialization was successful.

  • NRFX_ERROR_BUSY – The pin is already used.

  • NRFX_ERROR_NO_MEM – No GPIOTE channel is available.

nrfx_err_t nrfx_gpiote_out_prealloc_init(nrfx_gpiote_pin_t pin, nrfx_gpiote_out_config_t const *p_config, uint8_t channel)

Function for initializing a GPIOTE output pin with preallocated channel.

The output pin can be controlled by PPI.

Note

This function is deprecated. Use nrfx_gpiote_output_configure instead.

Parameters

  • pin – [in] Pin.

  • p_config – [in] Initial configuration.

  • channel – [in] GPIOTE channel allocated with nrfx_gpiote_channel_alloc.

Return values

  • NRFX_SUCCESS – Initialization was successful.

  • NRFX_ERROR_BUSY – The pin is already used.

  • NRFX_ERROR_INVALID_PARAM – Pin is configured to not be controlled by the GPIOTE task and cannot be used with preallocated channel. Use nrfx_gpiote_out_init instead.

void nrfx_gpiote_out_uninit(nrfx_gpiote_pin_t pin)

Function for uninitializing a GPIOTE output pin.

The driver frees the GPIOTE channel if the output pin was using one.

Note

This function is deprecated. Use nrfx_gpiote_pin_uninit, followed by nrfx_gpiote_channel_free (provided that GPIOTE task was utilized) instead.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_out_set(nrfx_gpiote_pin_t pin)

Function for setting a GPIOTE output pin.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_out_clear(nrfx_gpiote_pin_t pin)

Function for clearing a GPIOTE output pin.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_out_toggle(nrfx_gpiote_pin_t pin)

Function for toggling a GPIOTE output pin.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_out_task_enable(nrfx_gpiote_pin_t pin)

Function for enabling a GPIOTE output pin task.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_out_task_disable(nrfx_gpiote_pin_t pin)

Function for disabling a GPIOTE output pin task.

Parameters

  • pin – [in] Pin.

nrf_gpiote_task_t nrfx_gpiote_out_task_get(nrfx_gpiote_pin_t pin)

Function for getting the OUT task for the specified output pin.

The returned task identifier can be used within GPIOTE HAL, for example, to configure a DPPI channel.

Parameters

  • pin – [in] Pin.

Returns

OUT task associated with the specified output pin.

uint32_t nrfx_gpiote_out_task_addr_get(nrfx_gpiote_pin_t pin)

Function for getting the address of the OUT task for the specified output pin.

Parameters

  • pin – [in] Pin.

Returns

Address of OUT task.

nrf_gpiote_task_t nrfx_gpiote_set_task_get(nrfx_gpiote_pin_t pin)

Function for getting the SET task for the specified output pin.

The returned task identifier can be used within GPIOTE HAL, for example, to configure a DPPI channel.

Parameters

  • pin – [in] Pin.

Returns

SET task associated with the specified output pin.

uint32_t nrfx_gpiote_set_task_addr_get(nrfx_gpiote_pin_t pin)

Function for getting the address of the SET task for the specified output pin.

Parameters

  • pin – [in] Pin.

Returns

Address of SET task.

nrf_gpiote_task_t nrfx_gpiote_clr_task_get(nrfx_gpiote_pin_t pin)

Function for getting the CLR task for the specified output pin.

The returned task identifier can be used within GPIOTE HAL, for example, to configure a DPPI channel.

Parameters

  • pin – [in] Pin.

Returns

CLR task associated with the specified output pin.

uint32_t nrfx_gpiote_clr_task_addr_get(nrfx_gpiote_pin_t pin)

Function for getting the address of the SET task for the specified output pin.

Parameters

  • pin – [in] Pin.

Returns

Address of CLR task.

nrfx_err_t nrfx_gpiote_in_init(nrfx_gpiote_pin_t pin, nrfx_gpiote_in_config_t const *p_config, nrfx_gpiote_evt_handler_t evt_handler)

Function for initializing a GPIOTE input pin.

The input pin can act in two ways:

  • lower accuracy but low power (high frequency clock not needed)

  • higher accuracy (high frequency clock required)

The initial configuration specifies which mode is used. If high-accuracy mode is used, the driver attempts to allocate one of the available GPIOTE channels. If no channel is available, an error is returned. In low accuracy mode SENSE feature is used. In this case, only one active pin can be detected at a time. It can be worked around by setting all of the used low accuracy pins to toggle mode. For more information about SENSE functionality, refer to Product Specification.

Note

This function is deprecated. Use nrfx_gpiote_input_configure preceded by nrfx_gpiote_channel_alloc (provided that IN event is to be utilized) instead.

Parameters

  • pin – [in] Pin.

  • p_config – [in] Initial configuration.

  • evt_handler – [in] User function to be called when the configured transition occurs.

Return values

  • NRFX_SUCCESS – Initialization was successful.

  • NRFX_ERROR_BUSY – The pin is already used.

  • NRFX_ERROR_NO_MEM – No GPIOTE channel is available.

nrfx_err_t nrfx_gpiote_in_prealloc_init(nrfx_gpiote_pin_t pin, nrfx_gpiote_in_config_t const *p_config, uint8_t channel, nrfx_gpiote_evt_handler_t evt_handler)

Function for initializing a GPIOTE input pin with preallocated channel.

The input pin can act in higher accuracy (high frequency clock required) mode.

Note

This function is deprecated. Use nrfx_gpiote_input_configure instead.

Parameters

  • pin – [in] Pin.

  • p_config – [in] Initial configuration.

  • channel – [in] GPIOTE channel allocated with nrfx_gpiote_channel_alloc.

  • evt_handler – [in] User function to be called when the configured transition occurs.

Return values

  • NRFX_SUCCESS – Initialization was successful.

  • NRFX_ERROR_BUSY – The pin is already used.

  • NRFX_ERROR_INVALID_PARAM – Pin is configured to not be controlled by the GPIOTE task and cannot be used with preallocated channel. Use nrfx_gpiote_in_init instead.

void nrfx_gpiote_in_uninit(nrfx_gpiote_pin_t pin)

Function for uninitializing a GPIOTE input pin.

The driver frees the GPIOTE channel if the input pin was using one.

Note

This function is deprecated. Use nrfx_gpiote_pin_uninit, followed by nrfx_gpiote_channel_free (provided that IN event was utilized) instead.

Parameters

  • pin – [in] Pin.

NRFX_STATIC_INLINE void nrfx_gpiote_in_event_enable(nrfx_gpiote_pin_t pin, bool int_enable)

Function for enabling sensing of a GPIOTE input pin.

If the input pin is configured as high-accuracy pin, the function enables an IN_EVENT. Otherwise, the function enables the GPIO sense mechanism. The PORT event is shared between multiple pins, therefore the interrupt is always enabled.

Note

This function is deprecated. Use nrfx_gpiote_trigger_enable instead.

Parameters

  • pin – [in] Pin.

  • int_enable – [in] True to enable the interrupt. Always valid for a high-accuracy pin.

NRFX_STATIC_INLINE void nrfx_gpiote_in_event_disable(nrfx_gpiote_pin_t pin)

Function for disabling a GPIOTE input pin.

Note

This function is deprecated. Use nrfx_gpiote_trigger_disable instead.

Parameters

  • pin – [in] Pin.

bool nrfx_gpiote_in_is_set(nrfx_gpiote_pin_t pin)

Function for checking if a GPIOTE input pin is set.

Parameters

  • pin – [in] Pin.

Return values

  • true – The input pin is set.

  • false – The input pin is not set.

nrf_gpiote_event_t nrfx_gpiote_in_event_get(nrfx_gpiote_pin_t pin)

Function for getting the GPIOTE event for the specified input pin.

The returned event identifier can be used within GPIOTE HAL, for example, to configure a DPPI channel. If the pin is configured to use low-accuracy mode, the PORT event is returned.

Parameters

  • pin – [in] Pin.

Returns

Event associated with the specified input pin.

uint32_t nrfx_gpiote_in_event_addr_get(nrfx_gpiote_pin_t pin)

Function for getting the address of a GPIOTE input pin event.

If the pin is configured to use low-accuracy mode, the address of the PORT event is returned.

Parameters

  • pin – [in] Pin.

Returns

Address of the specified input pin event.

void nrfx_gpiote_out_task_force(nrfx_gpiote_pin_t pin, uint8_t state)

Function for forcing a specific state on the pin configured as task.

Parameters

  • pin – [in] Pin.

  • state – [in] Pin state.

void nrfx_gpiote_out_task_trigger(nrfx_gpiote_pin_t pin)

Function for triggering the task OUT manually.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_set_task_trigger(nrfx_gpiote_pin_t pin)

Function for triggering the task SET manually.

Parameters

  • pin – [in] Pin.

void nrfx_gpiote_clr_task_trigger(nrfx_gpiote_pin_t pin)

Function for triggering the task CLR manually.

Parameters

  • pin – [in] Pin.

struct nrfx_gpiote_task_config_t
#include <nrfx_gpiote.h>

Structure for configuring a GPIOTE task.

Public Members

uint8_t task_ch

GPIOTE channel to be used.

Set to value allocated using nrfx_gpiote_channel_alloc. It is a user responsibility to free the channel.

nrf_gpiote_polarity_t polarity

Task polarity configuration.

NRF_GPIOTE_POLARITY_NONE is used to disable previously configured task.

nrf_gpiote_outinit_t init_val

Initial pin state.

struct nrfx_gpiote_output_config_t
#include <nrfx_gpiote.h>

Structure for configuring an output pin.

Public Members

nrf_gpio_pin_drive_t drive

Drive configuration.

nrf_gpio_pin_input_t input_connect

Input buffer connection.

nrf_gpio_pin_pull_t pull

Pull configuration.

Pull setting is used together with drive configurations D0 and D1.

struct nrfx_gpiote_input_config_t
#include <nrfx_gpiote.h>

Structure for configuring an input pin.

Public Members

nrf_gpio_pin_pull_t pull

Pull configuration.

struct nrfx_gpiote_trigger_config_t
#include <nrfx_gpiote.h>

Structure for configuring pin interrupt/event.

Public Members

nrfx_gpiote_trigger_t trigger

Specify trigger.

uint8_t const *p_in_channel

Pointer to GPIOTE channel for IN event.

If NULL, the sensing mechanism is used instead. Note that when channel is provided only edge triggering can be used.

struct nrfx_gpiote_handler_config_t
#include <nrfx_gpiote.h>

Structure for configuring a pin interrupt handler.

Public Members

nrfx_gpiote_interrupt_handler_t handler

User handler.

void *p_context

Context passed to the event handler.

struct nrfx_gpiote_in_config_t
#include <nrfx_gpiote.h>

Input pin configuration.

Public Members

nrf_gpiote_polarity_t sense

Transition that triggers the interrupt.

nrf_gpio_pin_pull_t pull

Pulling mode.

bool is_watcher

True when the input pin is tracking an output pin.

bool hi_accuracy

True when high accuracy (IN_EVENT) is used.

bool skip_gpio_setup

Do not change GPIO configuration

struct nrfx_gpiote_out_config_t
#include <nrfx_gpiote.h>

Output pin configuration.

Public Members

nrf_gpiote_polarity_t action

Configuration of the pin task.

nrf_gpiote_outinit_t init_state

Initial state of the output pin.

bool task_pin

True if the pin is controlled by a GPIOTE task.