nRF51 SDK - S110 SoftDevice
|
GPIO pin abstraction and port abstraction for reading and writing byte-wise to GPIO ports. More...
Macros | |
#define | NUMBER_OF_PINS 32 |
Enumerations | |
enum | nrf_gpio_port_dir_t { NRF_GPIO_PORT_DIR_OUTPUT, NRF_GPIO_PORT_DIR_INPUT } |
Enumerator used for setting the direction of a GPIO port. More... | |
enum | nrf_gpio_pin_dir_t { NRF_GPIO_PIN_DIR_INPUT, NRF_GPIO_PIN_DIR_OUTPUT } |
enum | nrf_gpio_port_select_t { NRF_GPIO_PORT_SELECT_PORT0 = 0, NRF_GPIO_PORT_SELECT_PORT1, NRF_GPIO_PORT_SELECT_PORT2, NRF_GPIO_PORT_SELECT_PORT3 } |
Enumerator used for selecting between port 0 - 3. More... | |
enum | nrf_gpio_pin_pull_t { NRF_GPIO_PIN_NOPULL = GPIO_PIN_CNF_PULL_Disabled, NRF_GPIO_PIN_PULLDOWN = GPIO_PIN_CNF_PULL_Pulldown, NRF_GPIO_PIN_PULLUP = GPIO_PIN_CNF_PULL_Pullup } |
Enumerator used for selecting the pin to be pulled down or up at the time of pin configuration. More... | |
enum | nrf_gpio_pin_sense_t { NRF_GPIO_PIN_NOSENSE = GPIO_PIN_CNF_SENSE_Disabled, NRF_GPIO_PIN_SENSE_LOW = GPIO_PIN_CNF_SENSE_Low, NRF_GPIO_PIN_SENSE_HIGH = GPIO_PIN_CNF_SENSE_High } |
Enumerator used for selecting the pin to sense high or low level on the pin input. More... | |
Functions | |
__STATIC_INLINE void | nrf_gpio_range_cfg_output (uint32_t pin_range_start, uint32_t pin_range_end) |
Function for configuring the GPIO pin range as outputs with normal drive strength. This function can be used to configure pin range as simple output with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases). More... | |
__STATIC_INLINE void | nrf_gpio_range_cfg_input (uint32_t pin_range_start, uint32_t pin_range_end, nrf_gpio_pin_pull_t pull_config) |
Function for configuring the GPIO pin range as inputs with given initial value set, hiding inner details. This function can be used to configure pin range as simple input. More... | |
__STATIC_INLINE void | nrf_gpio_cfg_output (uint32_t pin_number) |
Function for configuring the given GPIO pin number as output with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases). More... | |
__STATIC_INLINE void | nrf_gpio_cfg_input (uint32_t pin_number, nrf_gpio_pin_pull_t pull_config) |
Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases). More... | |
__STATIC_INLINE void | nrf_gpio_cfg_default (uint32_t pin_number) |
Function for reseting pin configuration to its default state. More... | |
__STATIC_INLINE void | nrf_gpio_cfg_watcher (uint32_t pin_number) |
Function for configuring the given GPIO pin number as a watcher. Only input is connected. More... | |
__STATIC_INLINE void | nrf_gpio_input_disconnect (uint32_t pin_number) |
Function for disconnecting input for the given GPIO. More... | |
__STATIC_INLINE void | nrf_gpio_cfg_sense_input (uint32_t pin_number, nrf_gpio_pin_pull_t pull_config, nrf_gpio_pin_sense_t sense_config) |
Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases). Sense capability on the pin is configurable, and input is connected to buffer so that the GPIO->IN register is readable. More... | |
__STATIC_INLINE void | nrf_gpio_cfg_sense_set (uint32_t pin_number, nrf_gpio_pin_sense_t sense_config) |
Function for configuring sense level for the given GPIO. More... | |
__STATIC_INLINE void | nrf_gpio_pin_dir_set (uint32_t pin_number, nrf_gpio_pin_dir_t direction) |
Function for setting the direction for a GPIO pin. More... | |
__STATIC_INLINE void | nrf_gpio_pin_set (uint32_t pin_number) |
Function for setting a GPIO pin. More... | |
__STATIC_INLINE void | nrf_gpio_pin_clear (uint32_t pin_number) |
Function for clearing a GPIO pin. More... | |
__STATIC_INLINE void | nrf_gpio_pin_toggle (uint32_t pin_number) |
Function for toggling a GPIO pin. More... | |
__STATIC_INLINE void | nrf_gpio_pin_write (uint32_t pin_number, uint32_t value) |
Function for writing a value to a GPIO pin. More... | |
__STATIC_INLINE uint32_t | nrf_gpio_pin_read (uint32_t pin_number) |
Function for reading the input level of a GPIO pin. More... | |
__STATIC_INLINE uint32_t | nrf_gpio_pins_read (void) |
Function for reading the input level of all GPIO pins. More... | |
__STATIC_INLINE nrf_gpio_pin_sense_t | nrf_gpio_pin_sense_get (uint32_t pin_number) |
Function for reading the sense configuration of a GPIO pin. More... | |
__STATIC_INLINE void | nrf_gpio_word_byte_write (volatile uint32_t *word_address, uint8_t byte_no, uint8_t value) |
Generic function for writing a single byte of a 32 bit word at a given address. More... | |
__STATIC_INLINE uint8_t | nrf_gpio_word_byte_read (const volatile uint32_t *word_address, uint8_t byte_no) |
Generic function for reading a single byte of a 32 bit word at a given address. More... | |
__STATIC_INLINE void | nrf_gpio_port_dir_set (nrf_gpio_port_select_t port, nrf_gpio_port_dir_t dir) |
Function for setting the direction of a port. More... | |
__STATIC_INLINE uint8_t | nrf_gpio_port_read (nrf_gpio_port_select_t port) |
Function for reading a GPIO port. More... | |
__STATIC_INLINE void | nrf_gpio_port_write (nrf_gpio_port_select_t port, uint8_t value) |
Function for writing to a GPIO port. More... | |
__STATIC_INLINE void | nrf_gpio_port_set (nrf_gpio_port_select_t port, uint8_t set_mask) |
Function for setting individual pins on GPIO port. More... | |
__STATIC_INLINE void | nrf_gpio_port_clear (nrf_gpio_port_select_t port, uint8_t clr_mask) |
Function for clearing individual pins on GPIO port. More... | |
GPIO pin abstraction and port abstraction for reading and writing byte-wise to GPIO ports.
Here, the GPIO ports are defined as follows:
enum nrf_gpio_pin_dir_t |
enum nrf_gpio_pin_pull_t |
enum nrf_gpio_pin_sense_t |
enum nrf_gpio_port_dir_t |
__STATIC_INLINE void nrf_gpio_cfg_default | ( | uint32_t | pin_number | ) |
Function for reseting pin configuration to its default state.
pin_number | Specifies the pin number (allowed values 0-30). |
__STATIC_INLINE void nrf_gpio_cfg_input | ( | uint32_t | pin_number, |
nrf_gpio_pin_pull_t | pull_config | ||
) |
Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
pin_number | Specifies the pin number (allowed values 0-30). |
pull_config | State of the pin range pull resistor (no pull, pulled down or pulled high). |
__STATIC_INLINE void nrf_gpio_cfg_output | ( | uint32_t | pin_number | ) |
Function for configuring the given GPIO pin number as output with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
pin_number | specifies the pin number (allowed values 0-30) |
__STATIC_INLINE void nrf_gpio_cfg_sense_input | ( | uint32_t | pin_number, |
nrf_gpio_pin_pull_t | pull_config, | ||
nrf_gpio_pin_sense_t | sense_config | ||
) |
Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details. This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases). Sense capability on the pin is configurable, and input is connected to buffer so that the GPIO->IN register is readable.
pin_number | Specifies the pin number (allowed values 0-30). |
pull_config | State of the pin pull resistor (no pull, pulled down or pulled high). |
sense_config | Sense level of the pin (no sense, sense low or sense high). |
__STATIC_INLINE void nrf_gpio_cfg_sense_set | ( | uint32_t | pin_number, |
nrf_gpio_pin_sense_t | sense_config | ||
) |
Function for configuring sense level for the given GPIO.
pin_number | Specifies the pin number of gpio pin numbers to be configured (allowed values 0-30). |
sense_config | Sense configuration. |
__STATIC_INLINE void nrf_gpio_cfg_watcher | ( | uint32_t | pin_number | ) |
Function for configuring the given GPIO pin number as a watcher. Only input is connected.
pin_number | Specifies the pin number (allowed values 0-30). |
__STATIC_INLINE void nrf_gpio_input_disconnect | ( | uint32_t | pin_number | ) |
Function for disconnecting input for the given GPIO.
pin_number | Specifies the pin number (allowed values 0-30). |
__STATIC_INLINE void nrf_gpio_pin_clear | ( | uint32_t | pin_number | ) |
Function for clearing a GPIO pin.
Note that the pin must be configured as an output for this function to have any effect.
pin_number | specifies the pin number [0:31] to clear. |
__STATIC_INLINE void nrf_gpio_pin_dir_set | ( | uint32_t | pin_number, |
nrf_gpio_pin_dir_t | direction | ||
) |
Function for setting the direction for a GPIO pin.
pin_number | specifies the pin number [0:31] for which to set the direction. |
direction | specifies the direction |
__STATIC_INLINE uint32_t nrf_gpio_pin_read | ( | uint32_t | pin_number | ) |
Function for reading the input level of a GPIO pin.
Note that the pin must have input connected for the value returned from this function to be valid.
pin_number | specifies the pin number [0:31] to read. |
0 | if the pin input level is low. |
1 | if the pin input level is high. |
> | 1 should never occur. |
__STATIC_INLINE nrf_gpio_pin_sense_t nrf_gpio_pin_sense_get | ( | uint32_t | pin_number | ) |
Function for reading the sense configuration of a GPIO pin.
pin_number | specifies the pin number [0:31] to read. |
Sense | configuration |
__STATIC_INLINE void nrf_gpio_pin_set | ( | uint32_t | pin_number | ) |
Function for setting a GPIO pin.
Note that the pin must be configured as an output for this function to have any effect.
pin_number | specifies the pin number [0:31] to set. |
__STATIC_INLINE void nrf_gpio_pin_toggle | ( | uint32_t | pin_number | ) |
Function for toggling a GPIO pin.
Note that the pin must be configured as an output for this function to have any effect.
pin_number | specifies the pin number [0:31] to toggle. |
__STATIC_INLINE void nrf_gpio_pin_write | ( | uint32_t | pin_number, |
uint32_t | value | ||
) |
Function for writing a value to a GPIO pin.
Note that the pin must be configured as an output for this function to have any effect.
pin_number | specifies the pin number [0:31] to write. |
value | specifies the value to be written to the pin.
|
__STATIC_INLINE uint32_t nrf_gpio_pins_read | ( | void | ) |
Function for reading the input level of all GPIO pins.
Note that the pin must have input connected for the value returned from this function to be valid.
Status | of input of all pins |
__STATIC_INLINE void nrf_gpio_port_clear | ( | nrf_gpio_port_select_t | port, |
uint8_t | clr_mask | ||
) |
Function for clearing individual pins on GPIO port.
port | is the port for which to clear the pins. |
clr_mask | is a mask specifying which pins to clear. A bit set to 1 indicates that the corresponding port pin shall be cleared. |
__STATIC_INLINE void nrf_gpio_port_dir_set | ( | nrf_gpio_port_select_t | port, |
nrf_gpio_port_dir_t | dir | ||
) |
Function for setting the direction of a port.
port | is the port for which to set the direction. |
dir | direction to be set for this port. |
__STATIC_INLINE uint8_t nrf_gpio_port_read | ( | nrf_gpio_port_select_t | port | ) |
Function for reading a GPIO port.
port | is the port to read. |
__STATIC_INLINE void nrf_gpio_port_set | ( | nrf_gpio_port_select_t | port, |
uint8_t | set_mask | ||
) |
Function for setting individual pins on GPIO port.
port | is the port for which to set the pins. |
set_mask | is a mask specifying which pins to set. A bit set to 1 indicates that the corresponding port pin shall be set. |
__STATIC_INLINE void nrf_gpio_port_write | ( | nrf_gpio_port_select_t | port, |
uint8_t | value | ||
) |
Function for writing to a GPIO port.
port | is the port to write. |
value | is the value to write to this port. |
__STATIC_INLINE void nrf_gpio_range_cfg_input | ( | uint32_t | pin_range_start, |
uint32_t | pin_range_end, | ||
nrf_gpio_pin_pull_t | pull_config | ||
) |
Function for configuring the GPIO pin range as inputs with given initial value set, hiding inner details. This function can be used to configure pin range as simple input.
pin_range_start | specifies the start number (inclusive) in the range of pin numbers to be configured (allowed values 0-30) |
pin_range_end | specifies the end number (inclusive) in the range of pin numbers to be configured (allowed values 0-30) |
pull_config | State of the pin range pull resistor (no pull, pulled down or pulled high) |
__STATIC_INLINE void nrf_gpio_range_cfg_output | ( | uint32_t | pin_range_start, |
uint32_t | pin_range_end | ||
) |
Function for configuring the GPIO pin range as outputs with normal drive strength. This function can be used to configure pin range as simple output with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
pin_range_start | specifies the start number (inclusive) in the range of pin numbers to be configured (allowed values 0-30) |
pin_range_end | specifies the end number (inclusive) in the range of pin numbers to be configured (allowed values 0-30) |
__STATIC_INLINE uint8_t nrf_gpio_word_byte_read | ( | const volatile uint32_t * | word_address, |
uint8_t | byte_no | ||
) |
Generic function for reading a single byte of a 32 bit word at a given address.
This function should not be called from outside the nrf_gpio abstraction layer.
word_address | is the address of the word to be read. |
byte_no | is the byte number (0-3) of the word to be read. |
__STATIC_INLINE void nrf_gpio_word_byte_write | ( | volatile uint32_t * | word_address, |
uint8_t | byte_no, | ||
uint8_t | value | ||
) |
Generic function for writing a single byte of a 32 bit word at a given address.
This function should not be called from outside the nrf_gpio abstraction layer.
word_address | is the address of the word to be written. |
byte_no | is the word byte number (0-3) to be written. |
value | is the value to be written to byte "byte_no" of word at address "word_address" |