Microbug / nRF51822_FOTA

Patched version of nrf51822 FOTA compatible driver, with GPTIO disabled, as it clashed with the mbed definitions...

Fork of nRF51822 by Nordic Semiconductor

nordic-sdk/components/drivers_nrf/hal/nrf_gpio.h@103:138bdc859cc9, 2015-04-15 (annotated)

Committer:
rgrover1
Date:
Wed Apr 15 08:59:11 2015 +0100
Revision:
103:138bdc859cc9
Synchronized with git rev fa183c40

Author: Rohit Grover

updating to v7.1 of the Nordic SDK.

Re-organized file layout to match that from the SDK.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 103:138bdc859cc9 1 #ifndef NRF_GPIO_H__
rgrover1 103:138bdc859cc9 2 #define NRF_GPIO_H__
rgrover1 103:138bdc859cc9 3
rgrover1 103:138bdc859cc9 4 #include "nrf51.h"
rgrover1 103:138bdc859cc9 5 #include "nrf51_bitfields.h"
rgrover1 103:138bdc859cc9 6
rgrover1 103:138bdc859cc9 7 /**
rgrover1 103:138bdc859cc9 8 * @defgroup nrf_gpio GPIO abstraction
rgrover1 103:138bdc859cc9 9 * @{
rgrover1 103:138bdc859cc9 10 * @ingroup nrf_drivers
rgrover1 103:138bdc859cc9 11 * @brief GPIO pin abstraction and port abstraction for reading and writing byte-wise to GPIO ports.
rgrover1 103:138bdc859cc9 12 *
rgrover1 103:138bdc859cc9 13 * Here, the GPIO ports are defined as follows:
rgrover1 103:138bdc859cc9 14 * - Port 0 -> pin 0-7
rgrover1 103:138bdc859cc9 15 * - Port 1 -> pin 8-15
rgrover1 103:138bdc859cc9 16 * - Port 2 -> pin 16-23
rgrover1 103:138bdc859cc9 17 * - Port 3 -> pin 24-31
rgrover1 103:138bdc859cc9 18 */
rgrover1 103:138bdc859cc9 19
rgrover1 103:138bdc859cc9 20 /**
rgrover1 103:138bdc859cc9 21 * @enum nrf_gpio_port_dir_t
rgrover1 103:138bdc859cc9 22 * @brief Enumerator used for setting the direction of a GPIO port.
rgrover1 103:138bdc859cc9 23 */
rgrover1 103:138bdc859cc9 24 typedef enum
rgrover1 103:138bdc859cc9 25 {
rgrover1 103:138bdc859cc9 26 NRF_GPIO_PORT_DIR_OUTPUT, ///< Output
rgrover1 103:138bdc859cc9 27 NRF_GPIO_PORT_DIR_INPUT ///< Input
rgrover1 103:138bdc859cc9 28 } nrf_gpio_port_dir_t;
rgrover1 103:138bdc859cc9 29
rgrover1 103:138bdc859cc9 30 /**
rgrover1 103:138bdc859cc9 31 * @enum nrf_gpio_pin_dir_t
rgrover1 103:138bdc859cc9 32 * Pin direction definitions.
rgrover1 103:138bdc859cc9 33 */
rgrover1 103:138bdc859cc9 34 typedef enum
rgrover1 103:138bdc859cc9 35 {
rgrover1 103:138bdc859cc9 36 NRF_GPIO_PIN_DIR_INPUT, ///< Input
rgrover1 103:138bdc859cc9 37 NRF_GPIO_PIN_DIR_OUTPUT ///< Output
rgrover1 103:138bdc859cc9 38 } nrf_gpio_pin_dir_t;
rgrover1 103:138bdc859cc9 39
rgrover1 103:138bdc859cc9 40 /**
rgrover1 103:138bdc859cc9 41 * @enum nrf_gpio_port_select_t
rgrover1 103:138bdc859cc9 42 * @brief Enumerator used for selecting between port 0 - 3.
rgrover1 103:138bdc859cc9 43 */
rgrover1 103:138bdc859cc9 44 typedef enum
rgrover1 103:138bdc859cc9 45 {
rgrover1 103:138bdc859cc9 46 NRF_GPIO_PORT_SELECT_PORT0 = 0, ///< Port 0 (GPIO pin 0-7)
rgrover1 103:138bdc859cc9 47 NRF_GPIO_PORT_SELECT_PORT1, ///< Port 1 (GPIO pin 8-15)
rgrover1 103:138bdc859cc9 48 NRF_GPIO_PORT_SELECT_PORT2, ///< Port 2 (GPIO pin 16-23)
rgrover1 103:138bdc859cc9 49 NRF_GPIO_PORT_SELECT_PORT3, ///< Port 3 (GPIO pin 24-31)
rgrover1 103:138bdc859cc9 50 } nrf_gpio_port_select_t;
rgrover1 103:138bdc859cc9 51
rgrover1 103:138bdc859cc9 52 /**
rgrover1 103:138bdc859cc9 53 * @enum nrf_gpio_pin_pull_t
rgrover1 103:138bdc859cc9 54 * @brief Enumerator used for selecting the pin to be pulled down or up at the time of pin configuration
rgrover1 103:138bdc859cc9 55 */
rgrover1 103:138bdc859cc9 56 typedef enum
rgrover1 103:138bdc859cc9 57 {
rgrover1 103:138bdc859cc9 58 NRF_GPIO_PIN_NOPULL = GPIO_PIN_CNF_PULL_Disabled, ///< Pin pullup resistor disabled
rgrover1 103:138bdc859cc9 59 NRF_GPIO_PIN_PULLDOWN = GPIO_PIN_CNF_PULL_Pulldown, ///< Pin pulldown resistor enabled
rgrover1 103:138bdc859cc9 60 NRF_GPIO_PIN_PULLUP = GPIO_PIN_CNF_PULL_Pullup, ///< Pin pullup resistor enabled
rgrover1 103:138bdc859cc9 61 } nrf_gpio_pin_pull_t;
rgrover1 103:138bdc859cc9 62
rgrover1 103:138bdc859cc9 63 /**
rgrover1 103:138bdc859cc9 64 * @enum nrf_gpio_pin_sense_t
rgrover1 103:138bdc859cc9 65 * @brief Enumerator used for selecting the pin to sense high or low level on the pin input.
rgrover1 103:138bdc859cc9 66 */
rgrover1 103:138bdc859cc9 67 typedef enum
rgrover1 103:138bdc859cc9 68 {
rgrover1 103:138bdc859cc9 69 NRF_GPIO_PIN_NOSENSE = GPIO_PIN_CNF_SENSE_Disabled, ///< Pin sense level disabled.
rgrover1 103:138bdc859cc9 70 NRF_GPIO_PIN_SENSE_LOW = GPIO_PIN_CNF_SENSE_Low, ///< Pin sense low level.
rgrover1 103:138bdc859cc9 71 NRF_GPIO_PIN_SENSE_HIGH = GPIO_PIN_CNF_SENSE_High, ///< Pin sense high level.
rgrover1 103:138bdc859cc9 72 } nrf_gpio_pin_sense_t;
rgrover1 103:138bdc859cc9 73
rgrover1 103:138bdc859cc9 74 /**
rgrover1 103:138bdc859cc9 75 * @brief Function for configuring the GPIO pin range as outputs with normal drive strength.
rgrover1 103:138bdc859cc9 76 * This function can be used to configure pin range as simple output with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
rgrover1 103:138bdc859cc9 77 *
rgrover1 103:138bdc859cc9 78 * @param pin_range_start specifies the start number (inclusive) in the range of pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 79 *
rgrover1 103:138bdc859cc9 80 * @param pin_range_end specifies the end number (inclusive) in the range of pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 81 *
rgrover1 103:138bdc859cc9 82 * @note For configuring only one pin as output use @ref nrf_gpio_cfg_output
rgrover1 103:138bdc859cc9 83 * Sense capability on the pin is disabled, and input is disconnected from the buffer as the pins are configured as output.
rgrover1 103:138bdc859cc9 84 */
rgrover1 103:138bdc859cc9 85 static __INLINE void nrf_gpio_range_cfg_output(uint32_t pin_range_start, uint32_t pin_range_end)
rgrover1 103:138bdc859cc9 86 {
rgrover1 103:138bdc859cc9 87 /*lint -e{845} // A zero has been given as right argument to operator '|'" */
rgrover1 103:138bdc859cc9 88 for (; pin_range_start <= pin_range_end; pin_range_start++)
rgrover1 103:138bdc859cc9 89 {
rgrover1 103:138bdc859cc9 90 NRF_GPIO->PIN_CNF[pin_range_start] = (GPIO_PIN_CNF_SENSE_Disabled << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 91 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 92 | (GPIO_PIN_CNF_PULL_Disabled << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 93 | (GPIO_PIN_CNF_INPUT_Disconnect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 94 | (GPIO_PIN_CNF_DIR_Output << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 95 }
rgrover1 103:138bdc859cc9 96 }
rgrover1 103:138bdc859cc9 97
rgrover1 103:138bdc859cc9 98 /**
rgrover1 103:138bdc859cc9 99 * @brief Function for configuring the GPIO pin range as inputs with given initial value set, hiding inner details.
rgrover1 103:138bdc859cc9 100 * This function can be used to configure pin range as simple input.
rgrover1 103:138bdc859cc9 101 *
rgrover1 103:138bdc859cc9 102 * @param pin_range_start specifies the start number (inclusive) in the range of pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 103 *
rgrover1 103:138bdc859cc9 104 * @param pin_range_end specifies the end number (inclusive) in the range of pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 105 *
rgrover1 103:138bdc859cc9 106 * @param pull_config State of the pin range pull resistor (no pull, pulled down or pulled high)
rgrover1 103:138bdc859cc9 107 *
rgrover1 103:138bdc859cc9 108 * @note For configuring only one pin as input use @ref nrf_gpio_cfg_input
rgrover1 103:138bdc859cc9 109 * Sense capability on the pin is disabled, and input is connected to buffer so that the GPIO->IN register is readable
rgrover1 103:138bdc859cc9 110 */
rgrover1 103:138bdc859cc9 111 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)
rgrover1 103:138bdc859cc9 112 {
rgrover1 103:138bdc859cc9 113 /*lint -e{845} // A zero has been given as right argument to operator '|'" */
rgrover1 103:138bdc859cc9 114 for (; pin_range_start <= pin_range_end; pin_range_start++)
rgrover1 103:138bdc859cc9 115 {
rgrover1 103:138bdc859cc9 116 NRF_GPIO->PIN_CNF[pin_range_start] = (GPIO_PIN_CNF_SENSE_Disabled << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 117 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 118 | (pull_config << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 119 | (GPIO_PIN_CNF_INPUT_Connect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 120 | (GPIO_PIN_CNF_DIR_Input << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 121 }
rgrover1 103:138bdc859cc9 122 }
rgrover1 103:138bdc859cc9 123
rgrover1 103:138bdc859cc9 124 /**
rgrover1 103:138bdc859cc9 125 * @brief Function for configuring the given GPIO pin number as output with given initial value set, hiding inner details.
rgrover1 103:138bdc859cc9 126 * This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
rgrover1 103:138bdc859cc9 127 *
rgrover1 103:138bdc859cc9 128 * @param pin_number specifies the pin number of gpio pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 129 *
rgrover1 103:138bdc859cc9 130 * @note Sense capability on the pin is disabled, and input is disconnected from the buffer as the pins are configured as output.
rgrover1 103:138bdc859cc9 131 */
rgrover1 103:138bdc859cc9 132 static __INLINE void nrf_gpio_cfg_output(uint32_t pin_number)
rgrover1 103:138bdc859cc9 133 {
rgrover1 103:138bdc859cc9 134 /*lint -e{845} // A zero has been given as right argument to operator '|'" */
rgrover1 103:138bdc859cc9 135 NRF_GPIO->PIN_CNF[pin_number] = (GPIO_PIN_CNF_SENSE_Disabled << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 136 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 137 | (GPIO_PIN_CNF_PULL_Disabled << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 138 | (GPIO_PIN_CNF_INPUT_Disconnect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 139 | (GPIO_PIN_CNF_DIR_Output << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 140 }
rgrover1 103:138bdc859cc9 141
rgrover1 103:138bdc859cc9 142 /**
rgrover1 103:138bdc859cc9 143 * @brief Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details.
rgrover1 103:138bdc859cc9 144 * This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
rgrover1 103:138bdc859cc9 145 *
rgrover1 103:138bdc859cc9 146 * @param pin_number specifies the pin number of gpio pin numbers to be configured (allowed values 0-30)
rgrover1 103:138bdc859cc9 147 *
rgrover1 103:138bdc859cc9 148 * @param pull_config State of the pin range pull resistor (no pull, pulled down or pulled high)
rgrover1 103:138bdc859cc9 149 *
rgrover1 103:138bdc859cc9 150 * @note Sense capability on the pin is disabled, and input is connected to buffer so that the GPIO->IN register is readable
rgrover1 103:138bdc859cc9 151 */
rgrover1 103:138bdc859cc9 152 static __INLINE void nrf_gpio_cfg_input(uint32_t pin_number, nrf_gpio_pin_pull_t pull_config)
rgrover1 103:138bdc859cc9 153 {
rgrover1 103:138bdc859cc9 154 /*lint -e{845} // A zero has been given as right argument to operator '|'" */
rgrover1 103:138bdc859cc9 155 NRF_GPIO->PIN_CNF[pin_number] = (GPIO_PIN_CNF_SENSE_Disabled << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 156 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 157 | (pull_config << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 158 | (GPIO_PIN_CNF_INPUT_Connect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 159 | (GPIO_PIN_CNF_DIR_Input << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 160 }
rgrover1 103:138bdc859cc9 161
rgrover1 103:138bdc859cc9 162 /**
rgrover1 103:138bdc859cc9 163 * @brief Function for configuring the given GPIO pin number as input with given initial value set, hiding inner details.
rgrover1 103:138bdc859cc9 164 * This function can be used to configure pin range as simple input with gate driving GPIO_PIN_CNF_DRIVE_S0S1 (normal cases).
rgrover1 103:138bdc859cc9 165 * Sense capability on the pin is configurable, and input is connected to buffer so that the GPIO->IN register is readable.
rgrover1 103:138bdc859cc9 166 *
rgrover1 103:138bdc859cc9 167 * @param pin_number specifies the pin number of gpio pin numbers to be configured (allowed values 0-30).
rgrover1 103:138bdc859cc9 168 *
rgrover1 103:138bdc859cc9 169 * @param pull_config state of the pin pull resistor (no pull, pulled down or pulled high).
rgrover1 103:138bdc859cc9 170 *
rgrover1 103:138bdc859cc9 171 * @param sense_config sense level of the pin (no sense, sense low or sense high).
rgrover1 103:138bdc859cc9 172 */
rgrover1 103:138bdc859cc9 173 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)
rgrover1 103:138bdc859cc9 174 {
rgrover1 103:138bdc859cc9 175 /*lint -e{845} // A zero has been given as right argument to operator '|'" */
rgrover1 103:138bdc859cc9 176 NRF_GPIO->PIN_CNF[pin_number] = (sense_config << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 177 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 178 | (pull_config << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 179 | (GPIO_PIN_CNF_INPUT_Connect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 180 | (GPIO_PIN_CNF_DIR_Input << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 181 }
rgrover1 103:138bdc859cc9 182
rgrover1 103:138bdc859cc9 183 /**
rgrover1 103:138bdc859cc9 184 * @brief Function for setting the direction for a GPIO pin.
rgrover1 103:138bdc859cc9 185 *
rgrover1 103:138bdc859cc9 186 * @param pin_number specifies the pin number [0:31] for which to
rgrover1 103:138bdc859cc9 187 * set the direction.
rgrover1 103:138bdc859cc9 188 *
rgrover1 103:138bdc859cc9 189 * @param direction specifies the direction
rgrover1 103:138bdc859cc9 190 */
rgrover1 103:138bdc859cc9 191 static __INLINE void nrf_gpio_pin_dir_set(uint32_t pin_number, nrf_gpio_pin_dir_t direction)
rgrover1 103:138bdc859cc9 192 {
rgrover1 103:138bdc859cc9 193 if(direction == NRF_GPIO_PIN_DIR_INPUT)
rgrover1 103:138bdc859cc9 194 {
rgrover1 103:138bdc859cc9 195 NRF_GPIO->PIN_CNF[pin_number] =
rgrover1 103:138bdc859cc9 196 (GPIO_PIN_CNF_SENSE_Disabled << GPIO_PIN_CNF_SENSE_Pos)
rgrover1 103:138bdc859cc9 197 | (GPIO_PIN_CNF_DRIVE_S0S1 << GPIO_PIN_CNF_DRIVE_Pos)
rgrover1 103:138bdc859cc9 198 | (GPIO_PIN_CNF_PULL_Disabled << GPIO_PIN_CNF_PULL_Pos)
rgrover1 103:138bdc859cc9 199 | (GPIO_PIN_CNF_INPUT_Connect << GPIO_PIN_CNF_INPUT_Pos)
rgrover1 103:138bdc859cc9 200 | (GPIO_PIN_CNF_DIR_Input << GPIO_PIN_CNF_DIR_Pos);
rgrover1 103:138bdc859cc9 201 }
rgrover1 103:138bdc859cc9 202 else
rgrover1 103:138bdc859cc9 203 {
rgrover1 103:138bdc859cc9 204 NRF_GPIO->DIRSET = (1UL << pin_number);
rgrover1 103:138bdc859cc9 205 }
rgrover1 103:138bdc859cc9 206 }
rgrover1 103:138bdc859cc9 207
rgrover1 103:138bdc859cc9 208 /**
rgrover1 103:138bdc859cc9 209 * @brief Function for setting a GPIO pin.
rgrover1 103:138bdc859cc9 210 *
rgrover1 103:138bdc859cc9 211 * Note that the pin must be configured as an output for this
rgrover1 103:138bdc859cc9 212 * function to have any effect.
rgrover1 103:138bdc859cc9 213 *
rgrover1 103:138bdc859cc9 214 * @param pin_number specifies the pin number [0:31] to
rgrover1 103:138bdc859cc9 215 * set.
rgrover1 103:138bdc859cc9 216 */
rgrover1 103:138bdc859cc9 217 static __INLINE void nrf_gpio_pin_set(uint32_t pin_number)
rgrover1 103:138bdc859cc9 218 {
rgrover1 103:138bdc859cc9 219 NRF_GPIO->OUTSET = (1UL << pin_number);
rgrover1 103:138bdc859cc9 220 }
rgrover1 103:138bdc859cc9 221
rgrover1 103:138bdc859cc9 222 /**
rgrover1 103:138bdc859cc9 223 * @brief Function for clearing a GPIO pin.
rgrover1 103:138bdc859cc9 224 *
rgrover1 103:138bdc859cc9 225 * Note that the pin must be configured as an output for this
rgrover1 103:138bdc859cc9 226 * function to have any effect.
rgrover1 103:138bdc859cc9 227 *
rgrover1 103:138bdc859cc9 228 * @param pin_number specifies the pin number [0:31] to
rgrover1 103:138bdc859cc9 229 * clear.
rgrover1 103:138bdc859cc9 230 */
rgrover1 103:138bdc859cc9 231 static __INLINE void nrf_gpio_pin_clear(uint32_t pin_number)
rgrover1 103:138bdc859cc9 232 {
rgrover1 103:138bdc859cc9 233 NRF_GPIO->OUTCLR = (1UL << pin_number);
rgrover1 103:138bdc859cc9 234 }
rgrover1 103:138bdc859cc9 235
rgrover1 103:138bdc859cc9 236 /**
rgrover1 103:138bdc859cc9 237 * @brief Function for toggling a GPIO pin.
rgrover1 103:138bdc859cc9 238 *
rgrover1 103:138bdc859cc9 239 * Note that the pin must be configured as an output for this
rgrover1 103:138bdc859cc9 240 * function to have any effect.
rgrover1 103:138bdc859cc9 241 *
rgrover1 103:138bdc859cc9 242 * @param pin_number specifies the pin number [0:31] to
rgrover1 103:138bdc859cc9 243 * toggle.
rgrover1 103:138bdc859cc9 244 */
rgrover1 103:138bdc859cc9 245 static __INLINE void nrf_gpio_pin_toggle(uint32_t pin_number)
rgrover1 103:138bdc859cc9 246 {
rgrover1 103:138bdc859cc9 247 const uint32_t pin_bit = 1UL << pin_number;
rgrover1 103:138bdc859cc9 248 const uint32_t pin_state = ((NRF_GPIO->OUT >> pin_number) & 1UL);
rgrover1 103:138bdc859cc9 249
rgrover1 103:138bdc859cc9 250 if (pin_state == 0)
rgrover1 103:138bdc859cc9 251 {
rgrover1 103:138bdc859cc9 252 // Current state low, set high.
rgrover1 103:138bdc859cc9 253 NRF_GPIO->OUTSET = pin_bit;
rgrover1 103:138bdc859cc9 254 }
rgrover1 103:138bdc859cc9 255 else
rgrover1 103:138bdc859cc9 256 {
rgrover1 103:138bdc859cc9 257 // Current state high, set low.
rgrover1 103:138bdc859cc9 258 NRF_GPIO->OUTCLR = pin_bit;
rgrover1 103:138bdc859cc9 259 }
rgrover1 103:138bdc859cc9 260 }
rgrover1 103:138bdc859cc9 261
rgrover1 103:138bdc859cc9 262 /**
rgrover1 103:138bdc859cc9 263 * @brief Function for writing a value to a GPIO pin.
rgrover1 103:138bdc859cc9 264 *
rgrover1 103:138bdc859cc9 265 * Note that the pin must be configured as an output for this
rgrover1 103:138bdc859cc9 266 * function to have any effect.
rgrover1 103:138bdc859cc9 267 *
rgrover1 103:138bdc859cc9 268 * @param pin_number specifies the pin number [0:31] to
rgrover1 103:138bdc859cc9 269 * write.
rgrover1 103:138bdc859cc9 270 *
rgrover1 103:138bdc859cc9 271 * @param value specifies the value to be written to the pin.
rgrover1 103:138bdc859cc9 272 * @arg 0 clears the pin
rgrover1 103:138bdc859cc9 273 * @arg >=1 sets the pin.
rgrover1 103:138bdc859cc9 274 */
rgrover1 103:138bdc859cc9 275 static __INLINE void nrf_gpio_pin_write(uint32_t pin_number, uint32_t value)
rgrover1 103:138bdc859cc9 276 {
rgrover1 103:138bdc859cc9 277 if (value == 0)
rgrover1 103:138bdc859cc9 278 {
rgrover1 103:138bdc859cc9 279 nrf_gpio_pin_clear(pin_number);
rgrover1 103:138bdc859cc9 280 }
rgrover1 103:138bdc859cc9 281 else
rgrover1 103:138bdc859cc9 282 {
rgrover1 103:138bdc859cc9 283 nrf_gpio_pin_set(pin_number);
rgrover1 103:138bdc859cc9 284 }
rgrover1 103:138bdc859cc9 285 }
rgrover1 103:138bdc859cc9 286
rgrover1 103:138bdc859cc9 287 /**
rgrover1 103:138bdc859cc9 288 * @brief Function for reading the input level of a GPIO pin.
rgrover1 103:138bdc859cc9 289 *
rgrover1 103:138bdc859cc9 290 * Note that the pin must have input connected for the value
rgrover1 103:138bdc859cc9 291 * returned from this function to be valid.
rgrover1 103:138bdc859cc9 292 *
rgrover1 103:138bdc859cc9 293 * @param pin_number specifies the pin number [0:31] to
rgrover1 103:138bdc859cc9 294 * read.
rgrover1 103:138bdc859cc9 295 *
rgrover1 103:138bdc859cc9 296 * @return
rgrover1 103:138bdc859cc9 297 * @retval 0 if the pin input level is low.
rgrover1 103:138bdc859cc9 298 * @retval 1 if the pin input level is high.
rgrover1 103:138bdc859cc9 299 * @retval > 1 should never occur.
rgrover1 103:138bdc859cc9 300 */
rgrover1 103:138bdc859cc9 301 static __INLINE uint32_t nrf_gpio_pin_read(uint32_t pin_number)
rgrover1 103:138bdc859cc9 302 {
rgrover1 103:138bdc859cc9 303 return ((NRF_GPIO->IN >> pin_number) & 1UL);
rgrover1 103:138bdc859cc9 304 }
rgrover1 103:138bdc859cc9 305
rgrover1 103:138bdc859cc9 306 /**
rgrover1 103:138bdc859cc9 307 * @brief Generic function for writing a single byte of a 32 bit word at a given
rgrover1 103:138bdc859cc9 308 * address.
rgrover1 103:138bdc859cc9 309 *
rgrover1 103:138bdc859cc9 310 * This function should not be called from outside the nrf_gpio
rgrover1 103:138bdc859cc9 311 * abstraction layer.
rgrover1 103:138bdc859cc9 312 *
rgrover1 103:138bdc859cc9 313 * @param word_address is the address of the word to be written.
rgrover1 103:138bdc859cc9 314 *
rgrover1 103:138bdc859cc9 315 * @param byte_no is the the word byte number (0-3) to be written.
rgrover1 103:138bdc859cc9 316 *
rgrover1 103:138bdc859cc9 317 * @param value is the value to be written to byte "byte_no" of word
rgrover1 103:138bdc859cc9 318 * at address "word_address"
rgrover1 103:138bdc859cc9 319 */
rgrover1 103:138bdc859cc9 320 static __INLINE void nrf_gpio_word_byte_write(volatile uint32_t * word_address, uint8_t byte_no, uint8_t value)
rgrover1 103:138bdc859cc9 321 {
rgrover1 103:138bdc859cc9 322 *((volatile uint8_t*)(word_address) + byte_no) = value;
rgrover1 103:138bdc859cc9 323 }
rgrover1 103:138bdc859cc9 324
rgrover1 103:138bdc859cc9 325 /**
rgrover1 103:138bdc859cc9 326 * @brief Generic function for reading a single byte of a 32 bit word at a given
rgrover1 103:138bdc859cc9 327 * address.
rgrover1 103:138bdc859cc9 328 *
rgrover1 103:138bdc859cc9 329 * This function should not be called from outside the nrf_gpio
rgrover1 103:138bdc859cc9 330 * abstraction layer.
rgrover1 103:138bdc859cc9 331 *
rgrover1 103:138bdc859cc9 332 * @param word_address is the address of the word to be read.
rgrover1 103:138bdc859cc9 333 *
rgrover1 103:138bdc859cc9 334 * @param byte_no is the the byte number (0-3) of the word to be read.
rgrover1 103:138bdc859cc9 335 *
rgrover1 103:138bdc859cc9 336 * @return byte "byte_no" of word at address "word_address".
rgrover1 103:138bdc859cc9 337 */
rgrover1 103:138bdc859cc9 338 static __INLINE uint8_t nrf_gpio_word_byte_read(const volatile uint32_t* word_address, uint8_t byte_no)
rgrover1 103:138bdc859cc9 339 {
rgrover1 103:138bdc859cc9 340 return (*((const volatile uint8_t*)(word_address) + byte_no));
rgrover1 103:138bdc859cc9 341 }
rgrover1 103:138bdc859cc9 342
rgrover1 103:138bdc859cc9 343 /**
rgrover1 103:138bdc859cc9 344 * @brief Function for setting the direction of a port.
rgrover1 103:138bdc859cc9 345 *
rgrover1 103:138bdc859cc9 346 * @param port is the port for which to set the direction.
rgrover1 103:138bdc859cc9 347 *
rgrover1 103:138bdc859cc9 348 * @param dir direction to be set for this port.
rgrover1 103:138bdc859cc9 349 */
rgrover1 103:138bdc859cc9 350 static __INLINE void nrf_gpio_port_dir_set(nrf_gpio_port_select_t port, nrf_gpio_port_dir_t dir)
rgrover1 103:138bdc859cc9 351 {
rgrover1 103:138bdc859cc9 352 if (dir == NRF_GPIO_PORT_DIR_OUTPUT)
rgrover1 103:138bdc859cc9 353 {
rgrover1 103:138bdc859cc9 354 nrf_gpio_word_byte_write(&NRF_GPIO->DIRSET, port, 0xFF);
rgrover1 103:138bdc859cc9 355 }
rgrover1 103:138bdc859cc9 356 else
rgrover1 103:138bdc859cc9 357 {
rgrover1 103:138bdc859cc9 358 nrf_gpio_range_cfg_input(port*8, (port+1)*8-1, NRF_GPIO_PIN_NOPULL);
rgrover1 103:138bdc859cc9 359 }
rgrover1 103:138bdc859cc9 360 }
rgrover1 103:138bdc859cc9 361
rgrover1 103:138bdc859cc9 362 /**
rgrover1 103:138bdc859cc9 363 * @brief Function for reading a GPIO port.
rgrover1 103:138bdc859cc9 364 *
rgrover1 103:138bdc859cc9 365 * @param port is the port to read.
rgrover1 103:138bdc859cc9 366 *
rgrover1 103:138bdc859cc9 367 * @return the input value on this port.
rgrover1 103:138bdc859cc9 368 */
rgrover1 103:138bdc859cc9 369 static __INLINE uint8_t nrf_gpio_port_read(nrf_gpio_port_select_t port)
rgrover1 103:138bdc859cc9 370 {
rgrover1 103:138bdc859cc9 371 return nrf_gpio_word_byte_read(&NRF_GPIO->IN, port);
rgrover1 103:138bdc859cc9 372 }
rgrover1 103:138bdc859cc9 373
rgrover1 103:138bdc859cc9 374 /**
rgrover1 103:138bdc859cc9 375 * @brief Function for writing to a GPIO port.
rgrover1 103:138bdc859cc9 376 *
rgrover1 103:138bdc859cc9 377 * @param port is the port to write.
rgrover1 103:138bdc859cc9 378 *
rgrover1 103:138bdc859cc9 379 * @param value is the value to write to this port.
rgrover1 103:138bdc859cc9 380 *
rgrover1 103:138bdc859cc9 381 * @sa nrf_gpio_port_dir_set()
rgrover1 103:138bdc859cc9 382 */
rgrover1 103:138bdc859cc9 383 static __INLINE void nrf_gpio_port_write(nrf_gpio_port_select_t port, uint8_t value)
rgrover1 103:138bdc859cc9 384 {
rgrover1 103:138bdc859cc9 385 nrf_gpio_word_byte_write(&NRF_GPIO->OUT, port, value);
rgrover1 103:138bdc859cc9 386 }
rgrover1 103:138bdc859cc9 387
rgrover1 103:138bdc859cc9 388 /**
rgrover1 103:138bdc859cc9 389 * @brief Function for setting individual pins on GPIO port.
rgrover1 103:138bdc859cc9 390 *
rgrover1 103:138bdc859cc9 391 * @param port is the port for which to set the pins.
rgrover1 103:138bdc859cc9 392 *
rgrover1 103:138bdc859cc9 393 * @param set_mask is a mask specifying which pins to set. A bit
rgrover1 103:138bdc859cc9 394 * set to 1 indicates that the corresponding port pin shall be
rgrover1 103:138bdc859cc9 395 * set.
rgrover1 103:138bdc859cc9 396 *
rgrover1 103:138bdc859cc9 397 * @sa nrf_gpio_port_dir_set()
rgrover1 103:138bdc859cc9 398 */
rgrover1 103:138bdc859cc9 399 static __INLINE void nrf_gpio_port_set(nrf_gpio_port_select_t port, uint8_t set_mask)
rgrover1 103:138bdc859cc9 400 {
rgrover1 103:138bdc859cc9 401 nrf_gpio_word_byte_write(&NRF_GPIO->OUTSET, port, set_mask);
rgrover1 103:138bdc859cc9 402 }
rgrover1 103:138bdc859cc9 403
rgrover1 103:138bdc859cc9 404 /**
rgrover1 103:138bdc859cc9 405 * @brief Function for clearing individual pins on GPIO port.
rgrover1 103:138bdc859cc9 406 *
rgrover1 103:138bdc859cc9 407 * @param port is the port for which to clear the pins.
rgrover1 103:138bdc859cc9 408 *
rgrover1 103:138bdc859cc9 409 * @param clr_mask is a mask specifying which pins to clear. A bit
rgrover1 103:138bdc859cc9 410 * set to 1 indicates that the corresponding port pin shall be
rgrover1 103:138bdc859cc9 411 * cleared.
rgrover1 103:138bdc859cc9 412 *
rgrover1 103:138bdc859cc9 413 * @sa nrf_gpio_port_dir_set()
rgrover1 103:138bdc859cc9 414 */
rgrover1 103:138bdc859cc9 415 static __INLINE void nrf_gpio_port_clear(nrf_gpio_port_select_t port, uint8_t clr_mask)
rgrover1 103:138bdc859cc9 416 {
rgrover1 103:138bdc859cc9 417 nrf_gpio_word_byte_write(&NRF_GPIO->OUTCLR, port, clr_mask);
rgrover1 103:138bdc859cc9 418 }
rgrover1 103:138bdc859cc9 419
rgrover1 103:138bdc859cc9 420 /** @} */
rgrover1 103:138bdc859cc9 421
rgrover1 103:138bdc859cc9 422 #endif