libxr  1.0
Want to be the best embedded framework
Loading...
Searching...
No Matches
ch32_uart.cpp
1// ch32_uart.cpp
2
3#include "ch32_uart.hpp"
4
5#include "ch32_dma.hpp"
6#include "ch32_gpio.hpp"
7
8using namespace LibXR;
9
10// === 静态对象指针表 ===
11CH32UART *CH32UART::map[ch32_uart_id_t::CH32_UART_NUMBER] = {nullptr};
12
13// === 构造函数:串口+DMA+GPIO初始化 ===
14CH32UART::CH32UART(ch32_uart_id_t id, RawData dma_rx, RawData dma_tx,
15 GPIO_TypeDef *tx_gpio_port, uint16_t tx_gpio_pin,
16 GPIO_TypeDef *rx_gpio_port, uint16_t rx_gpio_pin, uint32_t pin_remap,
17 uint32_t tx_queue_size, UART::Configuration config)
18 : UART(&_read_port, &_write_port),
19 id_(id),
20 _read_port(dma_rx.size_),
21 _write_port(tx_queue_size, dma_tx.size_ / 2),
22 dma_buff_rx_(dma_rx),
23 dma_buff_tx_(dma_tx),
24 instance_(CH32_UART_GetInstanceID(id)),
25 dma_rx_channel_(CH32_UART_RX_DMA_CHANNEL_MAP[id]),
26 dma_tx_channel_(CH32_UART_TX_DMA_CHANNEL_MAP[id])
27{
28 map[id] = this;
29
30 bool tx_enable = dma_tx.size_ > 1;
31 bool rx_enable = dma_rx.size_ > 0;
32
33 ASSERT(tx_enable || rx_enable);
34
35 /* GPIO配置(TX: 推挽输出,RX: 悬空输入) */
36 GPIO_InitTypeDef gpio_init = {};
37 gpio_init.GPIO_Speed = GPIO_Speed_50MHz;
38
39 if (tx_enable)
40 {
41 (*write_port_) = WriteFun;
42 gpio_init.GPIO_Pin = tx_gpio_pin;
43 gpio_init.GPIO_Mode = GPIO_Mode_AF_PP;
44 GPIO_Init(tx_gpio_port, &gpio_init);
45 RCC_APB2PeriphClockCmd(CH32GetGPIOPeriph(tx_gpio_port), ENABLE);
46 }
47
48 if (rx_enable)
49 {
50 (*read_port_) = ReadFun;
51 gpio_init.GPIO_Pin = rx_gpio_pin;
52 gpio_init.GPIO_Mode = GPIO_Mode_IN_FLOATING;
53 GPIO_Init(rx_gpio_port, &gpio_init);
54 RCC_APB2PeriphClockCmd(CH32GetGPIOPeriph(rx_gpio_port), ENABLE);
55 }
56
57 /* 可选:引脚重映射 */
58 if (pin_remap != 0)
59 {
60 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
61 GPIO_PinRemapConfig(pin_remap, ENABLE);
62 }
63
64 /* 串口外设时钟使能 */
65 if (CH32_UART_APB_MAP[id] == 1)
66 {
67 RCC_APB1PeriphClockCmd(CH32_UART_RCC_PERIPH_MAP[id], ENABLE);
68 }
69 else if (CH32_UART_APB_MAP[id] == 2)
70 {
71 RCC_APB2PeriphClockCmd(CH32_UART_RCC_PERIPH_MAP[id], ENABLE);
72 }
73 else
74 {
75 ASSERT(false);
76 }
77 RCC_AHBPeriphClockCmd(CH32_UART_RCC_PERIPH_MAP_DMA[id], ENABLE);
78
79 // 3. USART 配置
80 USART_InitTypeDef usart_cfg = {};
81 usart_cfg.USART_BaudRate = config.baudrate;
82 usart_cfg.USART_StopBits =
83 (config.stop_bits == 2) ? USART_StopBits_2 : USART_StopBits_1;
84 switch (config.parity)
85 {
86 case UART::Parity::NO_PARITY:
87 usart_cfg.USART_Parity = USART_Parity_No;
88 usart_cfg.USART_WordLength = USART_WordLength_8b;
89 break;
90 case UART::Parity::EVEN:
91 usart_cfg.USART_Parity = USART_Parity_Even;
92 usart_cfg.USART_WordLength = USART_WordLength_9b;
93 break;
94 case UART::Parity::ODD:
95 usart_cfg.USART_Parity = USART_Parity_Odd;
96 usart_cfg.USART_WordLength = USART_WordLength_9b;
97 break;
98 default:
99 ASSERT(false);
100 }
101
102 usart_cfg.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
103 usart_cfg.USART_Mode =
104 (tx_enable ? USART_Mode_Tx : 0) | (rx_enable ? USART_Mode_Rx : 0);
105 uart_mode_ = usart_cfg.USART_Mode;
106 USART_Init(instance_, &usart_cfg);
107
108 /* DMA 配置 */
109 DMA_InitTypeDef dma_init = {};
110 dma_init.DMA_PeripheralInc = DMA_PeripheralInc_Disable;
111 dma_init.DMA_MemoryInc = DMA_MemoryInc_Enable;
112 dma_init.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte;
113 dma_init.DMA_MemoryDataSize = DMA_MemoryDataSize_Byte;
114 dma_init.DMA_Priority = DMA_Priority_High;
115 dma_init.DMA_M2M = DMA_M2M_Disable;
116
117 if (rx_enable)
118 {
119 DMA_DeInit(dma_rx_channel_);
120 dma_init.DMA_PeripheralBaseAddr = (uint32_t)&instance_->DATAR;
121 dma_init.DMA_MemoryBaseAddr = (uint32_t)dma_buff_rx_.addr_;
122 dma_init.DMA_DIR = DMA_DIR_PeripheralSRC;
123 dma_init.DMA_Mode = DMA_Mode_Circular;
124 dma_init.DMA_BufferSize = dma_buff_rx_.size_;
125 DMA_Init(dma_rx_channel_, &dma_init);
126 DMA_Cmd(dma_rx_channel_, ENABLE);
127 DMA_ITConfig(dma_rx_channel_, DMA_IT_TC, ENABLE);
128 DMA_ITConfig(dma_rx_channel_, DMA_IT_HT, ENABLE);
129 USART_DMACmd(instance_, USART_DMAReq_Rx, ENABLE);
130 }
131
132 if (tx_enable)
133 {
134 DMA_DeInit(dma_tx_channel_);
135 dma_init.DMA_PeripheralBaseAddr = (u32)(&instance_->DATAR);
136 dma_init.DMA_MemoryBaseAddr = 0;
137 dma_init.DMA_DIR = DMA_DIR_PeripheralDST;
138 dma_init.DMA_Mode = DMA_Mode_Normal;
139 dma_init.DMA_BufferSize = 0;
140 DMA_Init(dma_tx_channel_, &dma_init);
141 DMA_ITConfig(dma_tx_channel_, DMA_IT_TC, ENABLE);
142 USART_DMACmd(instance_, USART_DMAReq_Tx, ENABLE);
143 }
144
145 // 6. USART和相关中断
146 USART_Cmd(instance_, ENABLE);
147
148 if (rx_enable)
149 {
150 USART_ITConfig(instance_, USART_IT_IDLE, ENABLE);
151 NVIC_EnableIRQ(CH32_DMA_IRQ_MAP[CH32_DMA_GetID(dma_rx_channel_)]);
152 }
153
154 if (tx_enable)
155 {
156 NVIC_EnableIRQ(CH32_DMA_IRQ_MAP[CH32_DMA_GetID(dma_tx_channel_)]);
157 }
158
159 NVIC_EnableIRQ(CH32_UART_IRQ_MAP[id]);
160}
161
162// === 串口运行时配置变更 ===
164{
165 USART_InitTypeDef usart_cfg = {};
166 usart_cfg.USART_BaudRate = config.baudrate;
167 usart_cfg.USART_StopBits =
168 (config.stop_bits == 2) ? USART_StopBits_2 : USART_StopBits_1;
169
170 switch (config.parity)
171 {
173 usart_cfg.USART_Parity = USART_Parity_No;
174 usart_cfg.USART_WordLength = USART_WordLength_8b;
175 break;
177 usart_cfg.USART_Parity = USART_Parity_Even;
178 usart_cfg.USART_WordLength = USART_WordLength_9b;
179 break;
181 usart_cfg.USART_Parity = USART_Parity_Odd;
182 usart_cfg.USART_WordLength = USART_WordLength_9b;
183 break;
184 default:
185 return ErrorCode::NOT_SUPPORT;
186 }
187
188 usart_cfg.USART_Mode = uart_mode_;
189 usart_cfg.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
190 USART_DeInit(instance_);
191 USART_Init(instance_, &usart_cfg);
192
193 if (uart_mode_ & USART_Mode_Rx)
194 {
195 USART_DMACmd(instance_, USART_DMAReq_Rx, ENABLE);
196 USART_ITConfig(instance_, USART_IT_IDLE, ENABLE);
197 }
198
199 if (uart_mode_ & USART_Mode_Tx)
200 {
201 USART_DMACmd(instance_, USART_DMAReq_Tx, ENABLE);
202 }
203
204 USART_Cmd(instance_, ENABLE);
205
206 return ErrorCode::OK;
207}
208
209// === 写操作回调(DMA搬运) ===
210ErrorCode CH32UART::WriteFun(WritePort &port)
211{
212 CH32UART *uart = CONTAINER_OF(&port, CH32UART, _write_port);
213 if (!uart->dma_buff_tx_.HasPending())
214 {
215 WriteInfoBlock info;
216 if (port.queue_info_->Peek(info) != ErrorCode::OK)
217 {
218 return ErrorCode::EMPTY;
219 }
220
221 uint8_t *buffer = nullptr;
222 bool use_pending = false;
223
224 // DMA空闲判断
225 bool dma_ready = uart->dma_tx_channel_->CNTR == 0;
226 if (dma_ready)
227 {
228 buffer = reinterpret_cast<uint8_t *>(uart->dma_buff_tx_.ActiveBuffer());
229 }
230 else
231 {
232 buffer = reinterpret_cast<uint8_t *>(uart->dma_buff_tx_.PendingBuffer());
233 use_pending = true;
234 }
235
236 if (port.queue_data_->PopBatch(buffer, info.data.size_) != ErrorCode::OK)
237 {
238 ASSERT(false);
239 return ErrorCode::EMPTY;
240 }
241
242 if (use_pending)
243 {
244 uart->dma_buff_tx_.SetPendingLength(info.data.size_);
245 uart->dma_buff_tx_.EnablePending();
246 // 检查当前DMA是否可切换
247 bool dma_ready = uart->dma_tx_channel_->CNTR == 0;
248 if (dma_ready && uart->dma_buff_tx_.HasPending())
249 {
250 uart->dma_buff_tx_.Switch();
251 }
252 else
253 {
254 return ErrorCode::FAILED;
255 }
256 }
257
258 port.queue_info_->Pop(uart->write_info_active_);
259
260 DMA_Cmd(uart->dma_tx_channel_, DISABLE);
261 uart->dma_tx_channel_->MADDR =
262 reinterpret_cast<uint32_t>(uart->dma_buff_tx_.ActiveBuffer());
263 uart->dma_tx_channel_->CNTR = info.data.size_;
264 uart->_write_port.write_size_ = info.data.size_;
265 DMA_Cmd(uart->dma_tx_channel_, ENABLE);
266
267 uart->write_info_active_.op.UpdateStatus(false, ErrorCode::OK);
268
269 return ErrorCode::FAILED; // 实际是发起传输成功,但等待DMA完成
270 }
271 return ErrorCode::FAILED;
272}
273
274// === 读操作回调(由中断驱动) ===
275ErrorCode CH32UART::ReadFun(ReadPort &port)
276{
277 UNUSED(port);
278 // 接收由 IDLE 中断驱动,读取在 ISR 中完成
279 return ErrorCode::EMPTY;
280}
281
282void CH32_UART_RX_ISR_Handler(LibXR::CH32UART *uart)
283{
284 auto rx_buf = static_cast<uint8_t *>(uart->dma_buff_rx_.addr_);
285 size_t dma_size = uart->dma_buff_rx_.size_;
286 size_t curr_pos = dma_size - uart->dma_rx_channel_->CNTR;
287 size_t last_pos = uart->last_rx_pos_;
288
289 if (curr_pos != last_pos)
290 {
291 if (curr_pos > last_pos)
292 {
293 // 普通区间
294 uart->_read_port.queue_data_->PushBatch(&rx_buf[last_pos], curr_pos - last_pos);
295 }
296 else
297 {
298 // 回卷区
299 uart->_read_port.queue_data_->PushBatch(&rx_buf[last_pos], dma_size - last_pos);
300 uart->_read_port.queue_data_->PushBatch(&rx_buf[0], curr_pos);
301 }
302 uart->last_rx_pos_ = curr_pos;
303 uart->_read_port.ProcessPendingReads(true);
304 }
305}
306
307// === USART IDLE中断服务 ===
308extern "C" void CH32_UART_ISR_Handler_IDLE(ch32_uart_id_t id)
309{
310 auto uart = CH32UART::map[id];
311 if (!uart)
312 {
313 return;
314 }
315
316 // 检查和清除IDLE标志
317 if (!USART_GetITStatus(uart->instance_, USART_IT_IDLE))
318 {
319 return;
320 }
321
322 USART_ReceiveData(uart->instance_);
323
324 CH32_UART_RX_ISR_Handler(uart);
325}
326
327// === DMA TX完成中断服务 ===
328extern "C" void CH32_UART_ISR_Handler_TX_CPLT(ch32_uart_id_t id)
329{
330 auto uart = CH32UART::map[id];
331 if (!uart)
332 {
333 return;
334 }
335
336 DMA_ClearITPendingBit(CH32_UART_TX_DMA_IT_MAP[id]);
337
338 size_t pending_len = uart->dma_buff_tx_.GetPendingLength();
339
340 if (pending_len == 0)
341 {
342 return;
343 }
344
345 uart->dma_buff_tx_.Switch();
346
347 auto *buf = reinterpret_cast<uint8_t *>(uart->dma_buff_tx_.ActiveBuffer());
348 DMA_Cmd(uart->dma_tx_channel_, DISABLE);
349 uart->dma_tx_channel_->MADDR = (uint32_t)buf;
350 uart->dma_tx_channel_->CNTR = pending_len;
351 uart->_write_port.write_size_ = pending_len;
352 DMA_Cmd(uart->dma_tx_channel_, ENABLE);
353
354 WriteInfoBlock &current_info = uart->write_info_active_;
355
356 // 有pending包,继续取下一包
357 if (uart->_write_port.queue_info_->Pop(current_info) != ErrorCode::OK)
358 {
359 ASSERT(false);
360 return;
361 }
362
363 current_info.op.UpdateStatus(true, ErrorCode::OK);
364
365 // 预装pending区
366 WriteInfoBlock next_info;
367 if (uart->write_port_->queue_info_->Peek(next_info) != ErrorCode::OK)
368 {
369 return;
370 }
371
372 if (uart->write_port_->queue_data_->PopBatch(
373 reinterpret_cast<uint8_t *>(uart->dma_buff_tx_.PendingBuffer()),
374 next_info.data.size_) != ErrorCode::OK)
375 {
376 ASSERT(false);
377 return;
378 }
379
380 uart->dma_buff_tx_.SetPendingLength(next_info.data.size_);
381
382 uart->dma_buff_tx_.EnablePending();
383}
384
385// === DMA 通道中断回调 ===
386void CH32UART::TxDmaIRQHandler(DMA_Channel_TypeDef *channel, ch32_uart_id_t id)
387{
388 if (DMA_GetITStatus(CH32_UART_TX_DMA_IT_MAP[id]) == RESET) return;
389
390 if (channel->CNTR == 0) CH32_UART_ISR_Handler_TX_CPLT(id);
391}
392
393void CH32UART::RxDmaIRQHandler(DMA_Channel_TypeDef *channel, ch32_uart_id_t id)
394{
395 UNUSED(channel);
396 auto uart = CH32UART::map[id];
397 if (!uart) return;
398
399 if (DMA_GetITStatus(CH32_UART_RX_DMA_IT_HT_MAP[id]) == SET)
400 {
401 DMA_ClearITPendingBit(CH32_UART_RX_DMA_IT_HT_MAP[id]);
402 CH32_UART_RX_ISR_Handler(uart);
403 }
404
405 if (DMA_GetITStatus(CH32_UART_RX_DMA_IT_TC_MAP[id]) == SET)
406 {
407 DMA_ClearITPendingBit(CH32_UART_RX_DMA_IT_TC_MAP[id]);
408 CH32_UART_RX_ISR_Handler(uart);
409 }
410}
411
412// === 各类串口中断入口适配 ===
413#if defined(USART1)
414extern "C" void USART1_IRQHandler(void) __attribute__((interrupt));
415extern "C" void USART1_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART1); }
416#endif
417#if defined(USART2)
418extern "C" void USART2_IRQHandler(void) __attribute__((interrupt));
419extern "C" void USART2_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART2); }
420#endif
421#if defined(USART3)
422extern "C" void USART3_IRQHandler(void) __attribute__((interrupt));
423extern "C" void USART3_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART3); }
424#endif
425#if defined(USART4)
426extern "C" void USART4_IRQHandler(void) __attribute__((interrupt));
427extern "C" void USART4_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART4); }
428#endif
429#if defined(USART5)
430extern "C" void USART5_IRQHandler(void) __attribute__((interrupt));
431extern "C" void USART5_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART5); }
432#endif
433#if defined(USART6)
434extern "C" void USART6_IRQHandler(void) __attribute__((interrupt));
435extern "C" void USART6_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART6); }
436#endif
437#if defined(USART7)
438extern "C" void USART7_IRQHandler(void) __attribute__((interrupt));
439extern "C" void USART7_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART7); }
440#endif
441#if defined(USART8)
442extern "C" void USART8_IRQHandler(void) __attribute__((interrupt));
443extern "C" void USART8_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_USART8); }
444#endif
445#if defined(UART1)
446extern "C" void UART1_IRQHandler(void) __attribute__((interrupt));
447extern "C" void UART1_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART1); }
448#endif
449#if defined(UART2)
450extern "C" void UART2_IRQHandler(void) __attribute__((interrupt));
451extern "C" void UART2_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART2); }
452#endif
453#if defined(UART3)
454extern "C" void UART3_IRQHandler(void) __attribute__((interrupt));
455extern "C" void UART3_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART3); }
456#endif
457#if defined(UART4)
458extern "C" void UART4_IRQHandler(void) __attribute__((interrupt));
459extern "C" void UART4_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART4); }
460#endif
461#if defined(UART5)
462extern "C" void UART5_IRQHandler(void) __attribute__((interrupt));
463extern "C" void UART5_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART5); }
464#endif
465#if defined(UART6)
466extern "C" void UART6_IRQHandler(void) __attribute__((interrupt));
467extern "C" void UART6_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART6); }
468#endif
469#if defined(UART7)
470extern "C" void UART7_IRQHandler(void) __attribute__((interrupt));
471extern "C" void UART7_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART7); }
472#endif
473#if defined(UART8)
474extern "C" void UART8_IRQHandler(void) __attribute__((interrupt));
475extern "C" void UART8_IRQHandler(void) { CH32_UART_ISR_Handler_IDLE(CH32_UART8); }
476#endif
ErrorCode SetConfig(UART::Configuration config)
设置 UART 配置 / Sets the UART configuration
size_t size_
数据大小(字节)。 The size of the data (in bytes).
uint8_t * PendingBuffer()
获取备用缓冲区的指针 Returns the pending (inactive) buffer
void EnablePending()
手动启用 pending 状态 Manually sets the pending state to true
bool HasPending() const
判断是否有待切换的缓冲区 Checks whether a pending buffer is ready
void SetPendingLength(size_t size)
设置备用缓冲区的数据长度 Sets the size of the pending buffer
void Switch()
切换到备用缓冲区(若其有效) Switches to the pending buffer if it's valid
uint8_t * ActiveBuffer()
获取当前正在使用的缓冲区指针 Returns the currently active buffer
size_t GetPendingLength() const
获取 pending 缓冲区中准备好的数据长度 Gets the size of valid data in pending buffer
ErrorCode PushBatch(const Data *data, size_t size)
批量推入数据 / Pushes multiple elements into the queue
ErrorCode PopBatch(Data *data, size_t size)
批量弹出数据 / Pops multiple elements from the queue
void UpdateStatus(bool in_isr, Status &&...status)
Updates operation status based on type.
Definition libxr_rw.hpp:171
原始数据封装类。 A class for encapsulating raw data.
size_t size_
数据大小(字节)。 The size of the data (in bytes).
void * addr_
数据存储地址。 The storage address of the data.
ReadPort class for handling read operations.
Definition libxr_rw.hpp:268
virtual void ProcessPendingReads(bool in_isr)
Processes pending reads.
Definition libxr_rw.cpp:127
通用异步收发传输(UART)基类 / Abstract base class for Universal Asynchronous Receiver-Transmitter (UART)
Definition uart.hpp:19
@ NO_PARITY
无校验 / No parity
@ ODD
奇校验 / Odd parity
@ EVEN
偶校验 / Even parity
WritePort * write_port_
写入端口 / Write port
Definition uart.hpp:52
WritePort class for handling write operations.
Definition libxr_rw.hpp:402
LibXR 命名空间
Definition ch32_gpio.hpp:9
ErrorCode(* ReadFun)(ReadPort &port)
Function pointer type for read operations.
Definition libxr_rw.hpp:245
ErrorCode(* WriteFun)(WritePort &port)
Function pointer type for write operations.
Definition libxr_rw.hpp:241
UART 配置结构体 / UART configuration structure.
Definition uart.hpp:44
uint8_t stop_bits
停止位长度 / Number of stop bits
Definition uart.hpp:48
Parity parity
校验模式 / Parity mode
Definition uart.hpp:46
uint32_t baudrate
波特率 / Baud rate
Definition uart.hpp:45