UARTE peripheral driver.
More...
UARTE peripheral driver.
#define NRFX_UARTE_DEFAULT_CONFIG |
Value:{ \
.pseltxd = NRF_UARTE_PSEL_DISCONNECTED, \
.pselrxd = NRF_UARTE_PSEL_DISCONNECTED, \
.pselcts = NRF_UARTE_PSEL_DISCONNECTED, \
.pselrts = NRF_UARTE_PSEL_DISCONNECTED, \
.p_context = NULL, \
}
UARTE default configuration.
#define NRFX_UARTE_INSTANCE |
( |
|
id | ) |
|
Value:
Macro for creating a UARTE driver instance.
typedef void(* nrfx_uarte_event_handler_t)(nrfx_uarte_event_t const *p_event, void *p_context) |
UARTE interrupt event handler.
- Parameters
-
[in] | p_event | Pointer to event structure. Event is allocated on the stack so it is available only within the context of the event handler. |
[in] | p_context | Context passed to the interrupt handler, set on initialization. |
Types of UARTE driver events.
Enumerator |
---|
NRFX_UARTE_EVT_TX_DONE |
Requested TX transfer completed.
|
NRFX_UARTE_EVT_RX_DONE |
Requested RX transfer completed.
|
NRFX_UARTE_EVT_ERROR |
Error reported by UART peripheral.
|
uint32_t nrfx_uarte_errorsrc_get |
( |
nrfx_uarte_t const * |
p_instance | ) |
|
Function for reading error source mask. Mask contains values from nrf_uarte_error_mask_t.
- Note
- Function must be used in the blocking mode only. In case of non-blocking mode, an error event is generated. Function clears error sources after reading.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
- Returns
- Mask of reported errors.
Function for getting the address of the specified UARTE event.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
[in] | event | Event. |
- Returns
- Event address.
Function for initializing the UARTE driver.
This function configures and enables UARTE. After this function GPIO pins are controlled by UARTE.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
[in] | p_config | Pointer to the structure with the initial configuration. |
[in] | event_handler | Event handler provided by the user. If not provided driver works in blocking mode. |
- Return values
-
NRFX_SUCCESS | Initialization was successful. |
NRFX_ERROR_INVALID_STATE | Driver is already initialized. |
NRFX_ERROR_BUSY | Some other peripheral with the same instance ID is already in use. This is possible only if Peripheral Resource Sharing (PRS) module is enabled. |
Function for receiving data over UARTE.
If an event handler is provided in the nrfx_uarte_init() call, this function returns immediately and the handler is called when the transfer is done. Otherwise, the transfer is performed in blocking mode, that is this function returns when the transfer is finished. Blocking mode is not using interrupt so there is no context switching inside the function. The receive buffer pointer is double-buffered in non-blocking mode. The secondary buffer can be set immediately after starting the transfer and will be filled when the primary buffer is full. The double-buffering feature allows receiving data continuously.
- Note
- Peripherals using EasyDMA (including UARTE) require the transfer buffers to be placed in the Data RAM region. If this condition is not met, this function fails with the error code NRFX_ERROR_INVALID_ADDR.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
[in] | p_data | Pointer to data. |
[in] | length | Number of bytes to receive. Maximum possible length is dependent on the used SoC (see the MAXCNT register description in the Product Specification). The driver checks it with assertion. |
- Return values
-
NRFX_SUCCESS | Initialization is successful. |
NRFX_ERROR_BUSY | The driver is already receiving (and the secondary buffer has already been set in non-blocking mode). |
NRFX_ERROR_FORBIDDEN | The transfer is aborted from a different context (blocking mode only). |
NRFX_ERROR_INTERNAL | The UARTE peripheral reports an error. |
NRFX_ERROR_INVALID_ADDR | p_data does not point to RAM buffer. |
Function for aborting any ongoing reception.
- Note
- NRFX_UARTE_EVT_RX_DONE event will be generated in non-blocking mode. It will contain number of bytes received until the abort was called. The event handler will be called from the UARTE interrupt context.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
Function for testing the receiver state in blocking mode.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
- Return values
-
true | The receiver has at least one byte of data to get. |
false | The receiver is empty. |
Function for getting the address of the specified UARTE task.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
[in] | task | Task. |
- Returns
- Task address.
Function for sending data over UARTE.
If an event handler is provided in nrfx_uarte_init() call, this function returns immediately and the handler is called when the transfer is done. Otherwise, the transfer is performed in blocking mode, that is this function returns when the transfer is finished. Blocking mode is not using interrupt so there is no context switching inside the function.
- Note
- Peripherals using EasyDMA (including UARTE) require the transfer buffers to be placed in the Data RAM region. If this condition is not met, this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
[in] | p_data | Pointer to data. |
[in] | length | Number of bytes to send. Maximum possible length is dependent on the used SoC (see the MAXCNT register description in the Product Specification). The driver checks it with assertion. |
- Return values
-
NRFX_SUCCESS | Initialization was successful. |
NRFX_ERROR_BUSY | Driver is already transferring. |
NRFX_ERROR_FORBIDDEN | The transfer was aborted from a different context (blocking mode only). |
NRFX_ERROR_INVALID_ADDR | p_data does not point to RAM buffer. |
Function for aborting any ongoing transmission.
- Note
- NRFX_UARTE_EVT_TX_DONE event will be generated in non-blocking mode. It will contain number of bytes sent until the abort was called. The event handler will be called from the UARTE interrupt context.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
bool nrfx_uarte_tx_in_progress |
( |
nrfx_uarte_t const * |
p_instance | ) |
|
Function for checking if UARTE is currently transmitting.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |
- Return values
-
true | The UARTE is transmitting. |
false | The UARTE is not transmitting. |
Function for uninitializing the UARTE driver.
- Parameters
-
[in] | p_instance | Pointer to the driver instance structure. |