瑞萨RA系列FSP库开发实战指南之DTC+UART串口收发实验

19.10

实验4：DTC+UART串口收发

19.10.1

软件设计

19.10.1.1

新建工程

本实验新建工程的步骤与上面的实验3基本一致。

对于e2studio开发环境：

拷贝一份我们之前的e2s工程 “19_UART_Receive_Send”，然后将工

程文件夹重命名为“20_DTC_Using_UART”，最后再将它导入到我们的e2studio工作空间中。

对于Keil开发环境：

拷贝一份我们之前的Keil工程“19_UART_Receive_Send”，然后将工程文

件夹重命名为“20_DTC_Using_UART”，并进入该文件夹里面双击Keil工程文件，打开该工程。

工程新建好之后，在工程根目录的“src”文件夹下面新建“dtc”文件夹，再进入“dtc”文件夹里面新建源文件和头文件：“bsp_dtc.c”和“bsp_dtc.h”。工程文件结构如下。

列表26：文件结构

左右滑动查看完整内容

20_DTC_External_Interrupt
├─ ......
└─src
├─ led
│ ├─ bsp_led.c
│ └─ bsp_led.h
├─ debug_uart
│ ├─ bsp_debug_uart.c
│ └─ bsp_debug_uart.h
├─ dtc
│ ├─ bsp_dtc.c
│ └─ bsp_dtc.h
└─ hal_entry.c

19.10.1.2

FSP配置

打开该工程的FSP配置界面。

在“Stacks”一栏里面我们可以看到，工程“19_UART_Receive_Send”已有UART模块的配置了，如下图所示。

在这个已有的UART模块上面，我们下一步直接在该UART模块的底层添加DTC传输驱动。如下图所示。

按照如下的步骤操作，为UART的发送和接收都添加DTC底层驱动：

UART发送：用鼠标依次点击“Add DTC Driver for Transmission”→“New”→“Transfer （r_dtc）”。

UART接收：用鼠标依次点击“Add DTC Driver for Reception”→“New”→“Transfer（r_dtc）”。

我们注意到：“Add DTC Driver for Transmission”之后有“[Recommended but optional]”的字眼、“Add DTC Driver for Reception”之后有“[Not recommended]”的字眼，即：瑞萨FSP库官方推荐我们使用DTC来发送UART数据（虽然也可以不使用DTC），但不推荐使用DTC来接收UART数据。后面我们再来讲讲这是为什么。

添加完成后如下图所示：

上图中显示的UART模块显示为红色，是报错的，对此还需要修改下UART模块的配置。点击UART 模块，在属性配置里将“Common”→“DTC Support”属性由“Disable”改为“Enable”即可。

接着顺便也点击下UART下面的DTC模块，会发现DTC是基本默认配置好的了，不用我们更改，也无法更改，能改的只有名字，我们把名字改一下，就可以点击生成代码，然后编译了。

与上面使用DTC一些不同的地方是，瑞萨已经将DTC融入到UART中了，所以我们在使用过程中基本感觉不到我们在使用DTC传输数据给UART。

比如，正常情况下会有一个open函数去开启DTC的，但现在不同自己去调用该函数，因为我们在使用g_uart_on_sci.open函数去开启串口时，就已经在内部调用了DTC的开启函数。

我们只需调用g_transfer_on_dtc.enable函数进行使能就好了。

列表27：代码清单20‑23使能dtc

左右滑动查看完整内容

err = g_transfer_on_dtc.enable(g_uart4.p_cfg->p_transfer_rx->p_ctrl);
assert(FSP_SUCCESS == err);

使能后就可以像正常使用串口基本一样了。区别主要在于：

使用DTC后，串口可以不用等待发送完成，只需激活DTC后自动进行搬运数据，不占用CPU；

中断开启DTC后相当于DTC接管了串口的中断。

使用g_uart_on_sci.write或者R_SCI_UART_Write函数将字符串数据发送到串口，该函数内部会采用DTC来传输。

列表28：代码清单20‑24测试dtc串口

左右滑动查看完整内容

uint8_t sci_tx_data[] = {"embedfire-野火 www.embedfire.com
"};
/* 在 while(1) 中循环调用 */
// 可以尝试在 configuration.xml 中将 DTC 模块去除，再进行代码调试，看看会有什么区别
g_uart_on_sci.write(g_uart4.p_ctrl, (uint8_t *)(sci_tx_data),sizeof(sci_
→tx_data)/sizeof(sci_tx_data[0]));

19.10.1.3

为什么不用DTC接收串口数据

在实际使用过程中DTC有一些限制：

在本实验中使用DTC发送串口数据，但我们没有配置使用DTC接收串口数据，因为具体配置过程可能会很复杂，而且我们并不知道串口具体要接收多少数据，而DTC是传输完成了才会产生中断，这样就可能存在，我设定接受数据长度为128，但实际传输可能只有100，这时候就不会产生中断，虽然接收了数据，但我们不知道。

如果使用DTC接口进行传输，则传输大小必须小于或等于64K字节。

所以，虽然在FSP配置页面上，显示有DTC这个选项，但不建议去使用DTC进行接收。

19.10.2

实验现象

运行例程代码时，可以在串口助手看到字符串“embedfire-野火 www.embedfire.com”，以一秒传输一次的频率传输字符串，led 也是一秒变换一次。