123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660 |
- #ifndef NRF_DRV_UART_H__
- #define NRF_DRV_UART_H__
- #include <nrfx.h>
- #if defined(UARTE_PRESENT) && NRFX_CHECK(NRFX_UARTE_ENABLED)
- #define NRF_DRV_UART_WITH_UARTE
- #endif
- #if defined(UART_PRESENT) && NRFX_CHECK(NRFX_UART_ENABLED)
- #define NRF_DRV_UART_WITH_UART
- #endif
- #if defined(NRF_DRV_UART_WITH_UARTE)
- #include <nrfx_uarte.h>
- #define NRF_DRV_UART_CREATE_UARTE(id) \
- .uarte = NRFX_UARTE_INSTANCE(id),
- #else
-
-
-
- #define nrfx_uarte_init(...) 0
- #define nrfx_uarte_uninit(...)
- #define nrfx_uarte_task_address_get(...) 0
- #define nrfx_uarte_event_address_get(...) 0
- #define nrfx_uarte_tx(...) 0
- #define nrfx_uarte_tx_in_progress(...) 0
- #define nrfx_uarte_tx_abort(...)
- #define nrfx_uarte_rx(...) 0
- #define nrfx_uarte_rx_ready(...) 0
- #define nrfx_uarte_rx_abort(...)
- #define nrfx_uarte_errorsrc_get(...) 0
- #define NRF_DRV_UART_CREATE_UARTE(id)
- #endif
- #if defined(NRF_DRV_UART_WITH_UART)
- #include <nrfx_uart.h>
- #define NRF_DRV_UART_CREATE_UART(id) _NRF_DRV_UART_CREATE_UART(id)
- #define _NRF_DRV_UART_CREATE_UART(id) NRF_DRV_UART_CREATE_UART_##id
- #define NRF_DRV_UART_CREATE_UART_0 \
- .uart = NRFX_UART_INSTANCE(0),
- #define NRF_DRV_UART_CREATE_UART_1 \
- .uart = { .p_reg = NULL },
- #else
-
-
-
- #define nrfx_uart_init(...) 0
- #define nrfx_uart_uninit(...)
- #define nrfx_uart_task_address_get(...) 0
- #define nrfx_uart_event_address_get(...) 0
- #define nrfx_uart_tx(...) 0
- #define nrfx_uart_tx_in_progress(...) 0
- #define nrfx_uart_tx_abort(...)
- #define nrfx_uart_rx(...) 0
- #define nrfx_uart_rx_enable(...)
- #define nrfx_uart_rx_disable(...)
- #define nrfx_uart_rx_ready(...) 0
- #define nrfx_uart_rx_abort(...)
- #define nrfx_uart_errorsrc_get(...) 0
- #define NRF_DRV_UART_CREATE_UART(id)
-
-
- #define NRF_UART_BAUDRATE_1200 NRF_UARTE_BAUDRATE_1200
- #define NRF_UART_BAUDRATE_2400 NRF_UARTE_BAUDRATE_2400
- #define NRF_UART_BAUDRATE_4800 NRF_UARTE_BAUDRATE_4800
- #define NRF_UART_BAUDRATE_9600 NRF_UARTE_BAUDRATE_9600
- #define NRF_UART_BAUDRATE_14400 NRF_UARTE_BAUDRATE_14400
- #define NRF_UART_BAUDRATE_19200 NRF_UARTE_BAUDRATE_19200
- #define NRF_UART_BAUDRATE_28800 NRF_UARTE_BAUDRATE_28800
- #define NRF_UART_BAUDRATE_38400 NRF_UARTE_BAUDRATE_38400
- #define NRF_UART_BAUDRATE_57600 NRF_UARTE_BAUDRATE_57600
- #define NRF_UART_BAUDRATE_76800 NRF_UARTE_BAUDRATE_76800
- #define NRF_UART_BAUDRATE_115200 NRF_UARTE_BAUDRATE_115200
- #define NRF_UART_BAUDRATE_230400 NRF_UARTE_BAUDRATE_230400
- #define NRF_UART_BAUDRATE_250000 NRF_UARTE_BAUDRATE_250000
- #define NRF_UART_BAUDRATE_460800 NRF_UARTE_BAUDRATE_460800
- #define NRF_UART_BAUDRATE_921600 NRF_UARTE_BAUDRATE_921600
- #define NRF_UART_BAUDRATE_1000000 NRF_UARTE_BAUDRATE_1000000
- typedef nrf_uarte_baudrate_t nrf_uart_baudrate_t;
- #define NRF_UART_ERROR_OVERRUN_MASK NRF_UARTE_ERROR_OVERRUN_MASK
- #define NRF_UART_ERROR_PARITY_MASK NRF_UARTE_ERROR_PARITY_MASK
- #define NRF_UART_ERROR_FRAMING_MASK NRF_UARTE_ERROR_PARITY_MASK
- #define NRF_UART_ERROR_BREAK_MASK NRF_UARTE_ERROR_BREAK_MASK
- typedef nrf_uarte_error_mask_t nrf_uart_error_mask_t;
- #define NRF_UART_HWFC_DISABLED NRF_UARTE_HWFC_DISABLED
- #define NRF_UART_HWFC_ENABLED NRF_UARTE_HWFC_ENABLED
- typedef nrf_uarte_hwfc_t nrf_uart_hwfc_t;
- #define NRF_UART_PARITY_EXCLUDED NRF_UARTE_PARITY_EXCLUDED
- #define NRF_UART_PARITY_INCLUDED NRF_UARTE_PARITY_INCLUDED
- typedef nrf_uarte_parity_t nrf_uart_parity_t;
- typedef nrf_uarte_task_t nrf_uart_task_t;
- typedef nrf_uarte_event_t nrf_uart_event_t;
- #define NRF_UART_PSEL_DISCONNECTED NRF_UARTE_PSEL_DISCONNECTED
- #define nrf_uart_event_clear(...)
- #endif
- #ifdef __cplusplus
- extern "C" {
- #endif
- typedef struct
- {
- uint8_t inst_idx;
- #if defined(NRF_DRV_UART_WITH_UARTE)
- nrfx_uarte_t uarte;
- #endif
- #if defined(NRF_DRV_UART_WITH_UART)
- nrfx_uart_t uart;
- #endif
- } nrf_drv_uart_t;
- #define NRF_DRV_UART_INSTANCE(id) \
- { \
- .inst_idx = id, \
- NRF_DRV_UART_CREATE_UARTE(id) \
- NRF_DRV_UART_CREATE_UART(id) \
- }
- typedef enum
- {
- NRF_DRV_UART_EVT_TX_DONE,
- NRF_DRV_UART_EVT_RX_DONE,
- NRF_DRV_UART_EVT_ERROR,
- } nrf_drv_uart_evt_type_t;
- typedef struct
- {
- uint32_t pseltxd;
- uint32_t pselrxd;
- uint32_t pselcts;
- uint32_t pselrts;
- void * p_context;
- nrf_uart_hwfc_t hwfc;
- nrf_uart_parity_t parity;
- nrf_uart_baudrate_t baudrate;
- uint8_t interrupt_priority;
- #if defined(NRF_DRV_UART_WITH_UARTE) && defined(NRF_DRV_UART_WITH_UART)
- bool use_easy_dma;
- #endif
- } nrf_drv_uart_config_t;
- #if defined(NRF_DRV_UART_WITH_UARTE) && defined(NRF_DRV_UART_WITH_UART)
- extern uint8_t nrf_drv_uart_use_easy_dma[];
- #define NRF_DRV_UART_DEFAULT_CONFIG_USE_EASY_DMA .use_easy_dma = true,
- #else
- #define NRF_DRV_UART_DEFAULT_CONFIG_USE_EASY_DMA
- #endif
- #define NRF_DRV_UART_DEFAULT_CONFIG \
- { \
- .pseltxd = NRF_UART_PSEL_DISCONNECTED, \
- .pselrxd = NRF_UART_PSEL_DISCONNECTED, \
- .pselcts = NRF_UART_PSEL_DISCONNECTED, \
- .pselrts = NRF_UART_PSEL_DISCONNECTED, \
- .p_context = NULL, \
- .hwfc = (nrf_uart_hwfc_t)UART_DEFAULT_CONFIG_HWFC, \
- .parity = (nrf_uart_parity_t)UART_DEFAULT_CONFIG_PARITY, \
- .baudrate = (nrf_uart_baudrate_t)UART_DEFAULT_CONFIG_BAUDRATE, \
- .interrupt_priority = UART_DEFAULT_CONFIG_IRQ_PRIORITY, \
- NRF_DRV_UART_DEFAULT_CONFIG_USE_EASY_DMA \
- }
- typedef struct
- {
- uint8_t * p_data;
- uint8_t bytes;
- } nrf_drv_uart_xfer_evt_t;
- typedef struct
- {
- nrf_drv_uart_xfer_evt_t rxtx;
- uint32_t error_mask;
- } nrf_drv_uart_error_evt_t;
- typedef struct
- {
- nrf_drv_uart_evt_type_t type;
- union
- {
- nrf_drv_uart_xfer_evt_t rxtx;
- nrf_drv_uart_error_evt_t error;
- } data;
- } nrf_drv_uart_event_t;
- typedef void (*nrf_uart_event_handler_t)(nrf_drv_uart_event_t * p_event, void * p_context);
- ret_code_t nrf_drv_uart_init(nrf_drv_uart_t const * p_instance,
- nrf_drv_uart_config_t const * p_config,
- nrf_uart_event_handler_t event_handler);
- __STATIC_INLINE
- void nrf_drv_uart_uninit(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- uint32_t nrf_drv_uart_task_address_get(nrf_drv_uart_t const * p_instance,
- nrf_uart_task_t task);
- __STATIC_INLINE
- uint32_t nrf_drv_uart_event_address_get(nrf_drv_uart_t const * p_instance,
- nrf_uart_event_t event);
- __STATIC_INLINE
- ret_code_t nrf_drv_uart_tx(nrf_drv_uart_t const * p_instance,
- uint8_t const * const p_data,
- uint8_t length);
- __STATIC_INLINE
- bool nrf_drv_uart_tx_in_progress(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- void nrf_drv_uart_tx_abort(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- ret_code_t nrf_drv_uart_rx(nrf_drv_uart_t const * p_instance,
- uint8_t * p_data,
- uint8_t length);
- __STATIC_INLINE
- bool nrf_drv_uart_rx_ready(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- void nrf_drv_uart_rx_enable(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- void nrf_drv_uart_rx_disable(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- void nrf_drv_uart_rx_abort(nrf_drv_uart_t const * p_instance);
- __STATIC_INLINE
- uint32_t nrf_drv_uart_errorsrc_get(nrf_drv_uart_t const * p_instance);
- #ifndef SUPPRESS_INLINE_IMPLEMENTATION
- #if defined(NRF_DRV_UART_WITH_UARTE) && defined(NRF_DRV_UART_WITH_UART)
- #define NRF_DRV_UART_USE_UARTE (nrf_drv_uart_use_easy_dma[p_instance->inst_idx])
- #elif defined(NRF_DRV_UART_WITH_UARTE)
- #define NRF_DRV_UART_USE_UARTE true
- #else
- #define NRF_DRV_UART_USE_UARTE false
- #endif
- #define NRF_DRV_UART_USE_UART (!NRF_DRV_UART_USE_UARTE)
- __STATIC_INLINE
- void nrf_drv_uart_uninit(nrf_drv_uart_t const * p_instance)
- {
- if (NRF_DRV_UART_USE_UARTE)
- {
- nrfx_uarte_uninit(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrfx_uart_uninit(&p_instance->uart);
- }
- }
- __STATIC_INLINE
- uint32_t nrf_drv_uart_task_address_get(nrf_drv_uart_t const * p_instance,
- nrf_uart_task_t task)
- {
- uint32_t result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_task_address_get(&p_instance->uarte,
- (nrf_uarte_task_t)task);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_task_address_get(&p_instance->uart, task);
- }
- return result;
- }
- __STATIC_INLINE
- uint32_t nrf_drv_uart_event_address_get(nrf_drv_uart_t const * p_instance,
- nrf_uart_event_t event)
- {
- uint32_t result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_event_address_get(&p_instance->uarte,
- (nrf_uarte_event_t)event);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_event_address_get(&p_instance->uart, event);
- }
- return result;
- }
- __STATIC_INLINE
- ret_code_t nrf_drv_uart_tx(nrf_drv_uart_t const * p_instance,
- uint8_t const * p_data,
- uint8_t length)
- {
- uint32_t result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_tx(&p_instance->uarte,
- p_data,
- length);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_tx(&p_instance->uart,
- p_data,
- length);
- }
- return result;
- }
- __STATIC_INLINE
- bool nrf_drv_uart_tx_in_progress(nrf_drv_uart_t const * p_instance)
- {
- bool result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_tx_in_progress(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_tx_in_progress(&p_instance->uart);
- }
- return result;
- }
- __STATIC_INLINE
- void nrf_drv_uart_tx_abort(nrf_drv_uart_t const * p_instance)
- {
- if (NRF_DRV_UART_USE_UARTE)
- {
- nrfx_uarte_tx_abort(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrfx_uart_tx_abort(&p_instance->uart);
- }
- }
- __STATIC_INLINE
- ret_code_t nrf_drv_uart_rx(nrf_drv_uart_t const * p_instance,
- uint8_t * p_data,
- uint8_t length)
- {
- uint32_t result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_rx(&p_instance->uarte,
- p_data,
- length);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_rx(&p_instance->uart,
- p_data,
- length);
- }
- return result;
- }
- __STATIC_INLINE
- bool nrf_drv_uart_rx_ready(nrf_drv_uart_t const * p_instance)
- {
- bool result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_rx_ready(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- result = nrfx_uart_rx_ready(&p_instance->uart);
- }
- return result;
- }
- __STATIC_INLINE
- void nrf_drv_uart_rx_enable(nrf_drv_uart_t const * p_instance)
- {
- if (NRF_DRV_UART_USE_UARTE)
- {
- NRFX_ASSERT(false);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrfx_uart_rx_enable(&p_instance->uart);
- }
- }
- __STATIC_INLINE
- void nrf_drv_uart_rx_disable(nrf_drv_uart_t const * p_instance)
- {
- if (NRF_DRV_UART_USE_UARTE)
- {
- NRFX_ASSERT(false);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrfx_uart_rx_disable(&p_instance->uart);
- }
- }
- __STATIC_INLINE
- void nrf_drv_uart_rx_abort(nrf_drv_uart_t const * p_instance)
- {
- if (NRF_DRV_UART_USE_UARTE)
- {
- nrfx_uarte_rx_abort(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrfx_uart_rx_abort(&p_instance->uart);
- }
- }
- __STATIC_INLINE
- uint32_t nrf_drv_uart_errorsrc_get(nrf_drv_uart_t const * p_instance)
- {
- uint32_t result = 0;
- if (NRF_DRV_UART_USE_UARTE)
- {
- result = nrfx_uarte_errorsrc_get(&p_instance->uarte);
- }
- else if (NRF_DRV_UART_USE_UART)
- {
- nrf_uart_event_clear(p_instance->uart.p_reg, NRF_UART_EVENT_ERROR);
- result = nrfx_uart_errorsrc_get(&p_instance->uart);
- }
- return result;
- }
- #endif
- #ifdef __cplusplus
- }
- #endif
- #endif
|