18#ifndef __HAL_DRIVER_NATIONS_N32H76X_N32H78X_USART_H__ 
   19#define __HAL_DRIVER_NATIONS_N32H76X_N32H78X_USART_H__ 
   25#if VSF_HAL_USE_USART == ENABLED 
   52#define VSF_USART_CFG_REIMPLEMENT_TYPE_MODE         ENABLED 
   53#define VSF_USART_CFG_REIMPLEMENT_TYPE_STATUS       ENABLED 
   54#define VSF_USART_CFG_REIMPLEMENT_TYPE_IRQ_MASK     ENABLED 
   55#define VSF_USART_CFG_REIMPLEMENT_TYPE_CTRL         ENABLED 
   56#define VSF_USART_CFG_REIMPLEMENT_TYPE_CFG          DISABLED 
   57#define VSF_USART_CFG_REIMPLEMENT_TYPE_CAPABILITY   DISABLED 
   65#if VSF_USART_CFG_REIMPLEMENT_TYPE_MODE == ENABLED 
   70#define VSF_USART_TX_DISABLE            VSF_USART_TX_DISABLE 
   73#define VSF_USART_RX_DISABLE            VSF_USART_RX_DISABLE 
   83#define VSF_USART_9_BIT_LENGTH          VSF_USART_9_BIT_LENGTH 
   88#define VSF_USART_0_5_STOPBIT           VSF_USART_0_5_STOPBIT 
   92#define VSF_USART_2_STOPBIT             VSF_USART_2_STOPBIT 
   98#define VSF_USART_SYNC_CLOCK_DISABLE    VSF_USART_SYNC_CLOCK_DISABLE 
  103#define VSF_USART_SYNC_CLOCK_POLARITY_HIGH      VSF_USART_SYNC_CLOCK_POLARITY_HIGH 
  108#define VSF_USART_SYNC_CLOCK_PHASE_2_EDGE       VSF_USART_SYNC_CLOCK_PHASE_2_EDGE 
  112#define VSF_USART_SYNC_CLOCK_LAST_BIT_ENABLE    VSF_USART_SYNC_CLOCK_LAST_BIT_ENABLE 
  113#define VSF_USART_SYNC_CLOCK_LAST_BIT_DISABLE   VSF_USART_SYNC_CLOCK_LAST_BIT_DISABLE 
  114#define VSF_USART_SYNC_CLOCK_LAST_BIT_MASK      VSF_USART_SYNC_CLOCK_LAST_BIT_ENABLE | VSF_USART_SYNC_CLOCK_LAST_BIT_DISABLE 
  120#define VSF_USART_TX_FIFO_THRESHOLD_HALF_EMPTY  VSF_USART_TX_FIFO_THRESHOLD_HALF_EMPTY 
  124#define VSF_USART_TX_FIFO_THRESHOLD_QUARTER     VSF_USART_TX_FIFO_THRESHOLD_QUARTER 
  128#define VSF_USART_TX_FIFO_THRESHOLD_EMPTY       VSF_USART_TX_FIFO_THRESHOLD_EMPTY 
  133#define VSF_USART_RX_FIFO_THRESHOLD_HALF_FULL   VSF_USART_RX_FIFO_THRESHOLD_HALF_FULL 
  137#define VSF_USART_RX_FIFO_THRESHOLD_QUARTER     VSF_USART_RX_FIFO_THRESHOLD_QUARTER 
  141#define VSF_USART_RX_FIFO_THRESHOLD_FULL        VSF_USART_RX_FIFO_THRESHOLD_FULL 
  143#define VSF_USART_TX_FIFO_THRESHOLD_MASK    ( VSF_USART_TX_FIFO_THRESHOLD_NOT_FULL\ 
  144                                            | VSF_USART_TX_FIFO_THRESHOLD_HALF_EMPTY\ 
  145                                            | VSF_USART_TX_FIFO_THRESHOLD_EMPTY\ 
  146                                            | VSF_USART_TX_FIFO_THRESHOLD_ONE_EIGHTH\ 
  147                                            | VSF_USART_TX_FIFO_THRESHOLD_QUARTER\ 
  148                                            | VSF_USART_TX_FIFO_THRESHOLD_THREE_FOURTH) 
  149#define VSF_USART_RX_FIFO_THRESHOLD_MASK    ( VSF_USART_RX_FIFO_THRESHOLD_NOT_EMPTY\ 
  150                                            | VSF_USART_RX_FIFO_THRESHOLD_HALF_FULL\ 
  151                                            | VSF_USART_RX_FIFO_THRESHOLD_FULL\ 
  152                                            | VSF_USART_RX_FIFO_THRESHOLD_ONE_EIGHTH\ 
  153                                            | VSF_USART_RX_FIFO_THRESHOLD_QUARTER\ 
  154                                            | VSF_USART_RX_FIFO_THRESHOLD_THREE_FOURTH ) 
  159#define VSF_USART_RTS_HWCONTROL         VSF_USART_RTS_HWCONTROL 
  168#define VSF_USART_HALF_DUPLEX_ENABLE    VSF_USART_HALF_DUPLEX_ENABLE 
  179#define VSF_USART_SWAP                  VSF_USART_SWAP 
  239#if VSF_USART_CFG_REIMPLEMENT_TYPE_IRQ_MASK == ENABLED 
  270#define VSF_USART_IRQ_MASK_RX_TIMEOUT   VSF_USART_IRQ_MASK_RX_TIMEOUT 
  276#define VSF_USART_IRQ_MASK_NOISE_ERR    VSF_USART_IRQ_MASK_NOISE_ERR 
  309#if VSF_USART_CFG_REIMPLEMENT_TYPE_CTRL == ENABLED 
  327#if VSF_USART_CFG_REIMPLEMENT_TYPE_STATUS == ENABLED 
  332#define __VSF_HW_USART_STS_XOR_MASK     (1 << 8) 
  333#define __VSF_HW_USART_STS_MASK         0xF7FF 
  347#define VSF_USART_STATUS_BREAK_SENT     11 
  365#if VSF_USART_CFG_REIMPLEMENT_TYPE_CFG == ENABLED 
  385#if VSF_USART_CFG_REIMPLEMENT_TYPE_CAPABILITY == ENABLED 
  402#   ifdef VSF_USART_IRQ_MASK_TX_IDLE 
  405#   ifdef VSF_USART_IRQ_MASK_RX_IDLE 
vsf_usart_mode_t
Definition uart.h:32
vsf_usart_irq_mask_t
Definition uart.h:106
@ VSF_USART_HALF_DUPLEX_DISABLE
Definition usart.h:108
@ VSF_USART_SYNC_CLOCK_ENABLE
Definition usart.h:116
@ VSF_USART_EVEN_PARITY
Definition usart.h:113
@ VSF_USART_OVERSAMPLE_16
Definition usart.h:148
@ VSF_USART_ODD_PARITY
Definition usart.h:112
@ VSF_USART_SYNC_CLOCK_PHASE_1_EDGE
Definition usart.h:122
@ VSF_USART_10_BIT_LENGTH
Definition usart.h:132
@ VSF_USART_RTS_HWCONTROL
Definition usart.h:101
@ VSF_USART_SWAP
Definition usart.h:142
@ VSF_USART_RX_ENABLE
Definition usart.h:96
@ VSF_USART_FORCE_0_PARITY
Definition usart.h:186
@ __VSF_HW_USART_NOT_SUPPORT_MASK
Definition usart.h:201
@ VSF_USART_OVERSAMPLE_MASK
Definition usart.h:149
@ VSF_USART_TX_ENABLE
Definition usart.h:94
@ VSF_USART_SYNC_CLOCK_POLARITY_HIGH
Definition usart.h:120
@ VSF_USART_1_STOPBIT
Definition usart.h:89
@ VSF_USART_FORCE_1_PARITY
Definition usart.h:187
@ VSF_USART_SYNC_CLOCK_POLARITY_LOW
Definition usart.h:119
@ VSF_USART_RX_DISABLE
Definition usart.h:97
@ VSF_USART_2_STOPBIT
Definition usart.h:91
@ VSF_USART_CTS_HWCONTROL
Definition usart.h:102
@ VSF_USART_SYNC_CLOCK_DISABLE
Definition usart.h:117
@ VSF_USART_RTS_CTS_HWCONTROL
Definition usart.h:103
@ VSF_USART_SYNC_CLOCK_PHASE_2_EDGE
Definition usart.h:123
@ VSF_USART_HALF_DUPLEX_ENABLE
Definition usart.h:107
@ VSF_USART_TX_DISABLE
Definition usart.h:95
@ VSF_USART_OVERSAMPLE_8
Definition usart.h:147
@ VSF_USART_0_5_STOPBIT
Definition usart.h:88
@ VSF_USART_NO_HWCONTROL
Definition usart.h:100
@ VSF_USART_1_5_STOPBIT
Definition usart.h:90
@ VSF_USART_IRQ_MASK_CTS
Definition usart.h:217
@ VSF_USART_IRQ_MASK_BREAK_ERR
Definition usart.h:248
@ VSF_USART_IRQ_MASK_RX_OVERFLOW_ERR
Definition usart.h:249
@ VSF_USART_IRQ_MASK_PARITY_ERR
Definition usart.h:226
@ __VSF_HW_USART_IRQ_MASK
Definition usart.h:230
@ VSF_USART_IRQ_MASK_FRAME_ERR
Definition usart.h:247
#define VSF_USART_SYNC_CLOCK_LAST_BIT_ENABLE
Definition usart.h:127
vsf_usart_ctrl_t
Definition usart.h:256
@ VSF_USART_CTRL_CLEAR_BREAK
Definition usart.h:260
@ VSF_USART_CTRL_SEND_BREAK
Definition usart.h:257
@ __VSF_HW_USART_SUPPORT_CMD_MASK
Definition usart.h:262
@ VSF_USART_CTRL_SET_BREAK
Definition usart.h:259
#define VSF_USART_SYNC_CLOCK_LAST_BIT_DISABLE
Definition usart.h:128
struct vsf_usart_cfg_t vsf_usart_cfg_t
struct vsf_usart_capability_t vsf_usart_capability_t
@ VSF_USART_EVEN_PARITY
Definition usart.h:78
@ VSF_USART_ODD_PARITY
Definition usart.h:77
@ VSF_USART_NO_PARITY
Definition usart.h:76
@ __VSF_HW_USART_CTRL3_SHIFT_MASK
Definition usart.h:212
@ __VSF_HW_USART_CTRL1_MASK
Definition usart.h:182
@ __VSF_HW_USART_FIFO_SHIFT_BITS
Definition usart.h:218
@ __VSF_HW_USART_FIFO_MASK
Definition usart.h:215
@ __VSF_HW_USART_CTRL3_SHIFT_BITS
Definition usart.h:213
@ __VSF_HW_USART_CTRL2_MASK
Definition usart.h:192
@ __VSF_HW_USART_FIFO_SHIFT_MASK
Definition usart.h:217
@ __VSF_HW_USART_CTRL2_SHIFT_BITS
Definition usart.h:208
@ __VSF_HW_USART_CTRL2_SHIFT_MASK
Definition usart.h:204
@ __VSF_HW_USART_CTRL3_MASK
Definition usart.h:210
#define VSF_USART_TX_FIFO_THRESHOLD_ONE_EIGHTH
Definition usart.h:122
#define VSF_USART_TX_FIFO_THRESHOLD_THREE_FOURTH
Definition usart.h:126
#define VSF_USART_9_BIT_LENGTH
Definition usart.h:83
#define VSF_USART_RX_FIFO_THRESHOLD_QUARTER
Definition usart.h:137
#define VSF_USART_RX_FIFO_THRESHOLD_HALF_FULL
Definition usart.h:133
#define VSF_USART_TX_FIFO_THRESHOLD_EMPTY
Definition usart.h:128
#define VSF_USART_RX_FIFO_THRESHOLD_ONE_EIGHTH
Definition usart.h:135
#define VSF_USART_RX_FIFO_THRESHOLD_MASK
Definition usart.h:149
struct vsf_usart_isr_t vsf_usart_isr_t
#define VSF_USART_RX_FIFO_THRESHOLD_FULL
Definition usart.h:141
#define VSF_USART_RX_FIFO_THRESHOLD_THREE_FOURTH
Definition usart.h:139
#define VSF_USART_TX_FIFO_THRESHOLD_MASK
Definition usart.h:143
@ __VSF_HW_USART_CTRL3_IRQ_MASK
Definition usart.h:302
@ __VSF_HW_USART_CTRL2_IRQ_MASK
Definition usart.h:301
@ __VSF_HW_USART_STS_IRQ_MASK
Definition usart.h:303
@ __VSF_HW_USART_CTRL1_IRQ_MASK
Definition usart.h:293
#define VSF_USART_RX_FIFO_THRESHOLD_NOT_EMPTY
Definition usart.h:131
#define VSF_USART_IRQ_MASK_TX_IDLE
Definition usart.h:262
#define VSF_USART_IRQ_MASK_RX_IDLE
Definition usart.h:255
#define VSF_USART_TX_FIFO_THRESHOLD_HALF_EMPTY
Definition usart.h:120
void vsf_usart_isr_handler_t(void *target_ptr, vsf_usart_t *usart_ptr, vsf_usart_irq_mask_t irq_mask)
Definition usart.h:367
#define VSF_USART_TX_FIFO_THRESHOLD_QUARTER
Definition usart.h:124
#define VSF_USART_TX_FIFO_THRESHOLD_NOT_FULL
Definition usart.h:118
#define VSF_USART_IRQ_MASK_NOISE_ERR
Definition usart.h:276
vsf_usart_mode_t
Definition usart.h:42
@ VSF_USART_8_BIT_LENGTH
Definition usart.h:43
@ VSF_USART_7_BIT_LENGTH
Definition usart.h:44
@ VSF_USART_5_BIT_LENGTH
Definition usart.h:46
@ VSF_USART_6_BIT_LENGTH
Definition usart.h:45
vsf_usart_irq_mask_t
Definition usart.h:86
@ VSF_USART_IRQ_MASK_TX_CPL
Definition usart.h:90
@ VSF_USART_IRQ_MASK_TX
Definition usart.h:88
@ VSF_USART_IRQ_MASK_RX
Definition usart.h:87
@ VSF_USART_IRQ_MASK_RX_TIMEOUT
Definition usart.h:98
@ VSF_USART_IRQ_MASK_RX_CPL
Definition usart.h:89
struct vsf_usart_status_t vsf_usart_status_t
vsf_arch_prio_t
Definition cortex_a_generic.h:88
const i_spi_t vsf_spi_irq_mask_t irq_mask
Definition spi_interface.h:38
unsigned uint32_t
Definition stdint.h:9
unsigned char uint8_t
Definition stdint.h:5
USART capability structure Defines the hardware capabilities and limitations of the USART interface.
Definition vsf_template_usart.h:955
uint8_t support_tx_idle
Support TX idle interrupt.
Definition vsf_template_usart.h:975
uint8_t max_data_bits
Maximum data bits per frame.
Definition vsf_template_usart.h:967
uint8_t support_set_and_clear_break
Support set and clear break.
Definition vsf_template_usart.h:972
vsf_usart_irq_mask_t irq_mask
Definition usart.h:387
uint8_t support_rx_timeout
Support receive timeout.
Definition vsf_template_usart.h:970
uint8_t rxfifo_depth
RX FIFO depth in data frames (0 means no FIFO)
Definition vsf_template_usart.h:965
uint8_t support_rx_idle
Support RX idle interrupt.
Definition vsf_template_usart.h:978
uint8_t support_send_break
Support send break.
Definition vsf_template_usart.h:971
uint8_t txfifo_depth
TX FIFO depth in data frames (0 means no FIFO)
Definition vsf_template_usart.h:964
uint8_t min_data_bits
Minimum data bits per frame.
Definition vsf_template_usart.h:968
uint32_t min_baudrate
Minimum supported baudrate (bps) according to current clock configurations.
Definition vsf_template_usart.h:962
uint32_t max_baudrate
Maximum supported baudrate (bps) according to current clock configurations.
Definition vsf_template_usart.h:961
uint8_t support_sync_clock
Support Synchronous clock.
Definition vsf_template_usart.h:973
USART configuration structure Contains all parameters needed to initialize and configure a USART inst...
Definition vsf_template_usart.h:843
vsf_usart_mode_t mode
USART working mode.
Definition vsf_template_usart.h:844
uint32_t baudrate
Baudrate in Hz.
Definition vsf_template_usart.h:845
uint32_t rx_timeout
RX timeout in microseconds.
Definition vsf_template_usart.h:846
vsf_usart_isr_t isr
Interrupt configuration.
Definition vsf_template_usart.h:850
USART interrupt configuration structure Contains all necessary information for configuring USART inte...
Definition vsf_template_usart.h:829
vsf_usart_isr_handler_t * handler_fn
Interrupt handler function pointer.
Definition vsf_template_usart.h:830
vsf_arch_prio_t prio
Interrupt priority.
Definition vsf_template_usart.h:832
void * target_ptr
User target pointer.
Definition vsf_template_usart.h:831
USART status information structure Contains the current status of USART operations and FIFO threshold...
Definition uart.h:157
uint32_t is_rxfifo_empty
Definition usart.h:338
uint32_t is_txfifo_full
Definition usart.h:335
uint32_t noise_err
Definition usart.h:270
uint32_t cts_changed
Definition usart.h:277
uint32_t rxdne
Definition usart.h:344
uint32_t overrun_err
Definition usart.h:271
uint32_t is_rxfifo_full
Definition usart.h:336
uint32_t is_txfifo_threahold
Definition usart.h:340
uint32_t is_tx_busy
TX is busy transmitting data.
Definition vsf_template_usart.h:935
uint32_t value
Definition usart.h:284
uint32_t tx_fifo_data
Definition usart.h:353
uint32_t is_txfifo_empty
Definition usart.h:337
uint32_t txde
Definition usart.h:342
uint32_t frame_err
Definition usart.h:269
uint32_t break_sent
BREAK signal sent.
Definition vsf_template_usart.h:937
uint32_t rx_fifo_data
Definition usart.h:354
uint32_t is_rx_idle
Definition usart.h:341
uint32_t rx_timeout
Definition usart.h:352
uint32_t is_rxfifo_threshold
Definition usart.h:339
uint32_t parity_err
Definition usart.h:268
USART instance structure Used for USART Multi Class support.
Definition vsf_template_usart.h:1008
vsf_usart_irq_mask_t
Definition usart.h:174
void vsf_usart_isr_handler_t(void *target_ptr, vsf_usart_t *usart_ptr, vsf_usart_irq_mask_t irq_mask)
Definition usart.h:255
vsf_usart_ctrl_t
USART control commands Defines the available control operations for USART instances.
Definition vsf_template_usart.h:863