参考:
有关于 SDI printf 更多的信息和资料吗?
关于 CH32 系列 MCU SDI 虚拟串口功能的使用
【CH32X035 评估板测评】+ 教你使用 SDI 接口重定向 printf
SDI (Serial Data Interface) 是沁恒微电子 RISC-V 内核的私有外设接口,CH32 RISC-V 系列目前提供了 SDI 的 printf 打印功能
(有点类似RTT Viewer,但是是由WCH-LinkE调试器虚拟出来的一个串口,可以使用各种串口上位机查看打印的调试信息)
0.前言
有段时间没有看CH32V单片机的开发了,今天帮新来的同事调试时候看到debug.c里面有新的函数SDI_Printf_Enable
:
大概看了下,感觉有点像RTT,去wch官方那个技术社区搜了下果然有相关内容。
主要看了这篇:关于 CH32 系列 MCU SDI 虚拟串口功能的使用写的很详细了。
在此下载最新的WCH-LinkUtility,解压后Doc文件夹中有WCH-Link使用说明,看来通用MCU的支持的多点,CH582、CH592还没有支持。
1.试验
1.1 打开SDI_PRINT
这里我使用的是CH32V303RCT6单片机,打开官方EVT中的例程
默认的Printf是关闭SDI功能、打开串口1的
在debug.h
中将SDI_PRINT
改为SDI_PR_OPEN
即可编译。
1.2 打开串口助手
打开 WCH-LinkE 对应的串口,115200、8N1
1.3.使用WCH-LinkUtility下载固件并打开SDI 功能
1.4.下载查看串口信息
wch-linke只连接了SWCLK、SWDIO,没有连接自身的TX、RX,但还是可以看到有数据打印出来。
2.SDI Printf 虚拟串口功能原理简单推测分析
感谢**【CH32X035 评估板测评】+ 教你使用 SDI 接口重定向 printf**的分享
从debug.c
中的_write
函数可以大概推测下SDI实现的原理:
,
#define DEBUG_DATA0_ADDRESS ((volatile uint32_t*)0xE0000380)
#define DEBUG_DATA1_ADDRESS ((volatile uint32_t*)0xE0000384)__attribute__((used)) int _write(int fd, char *buf, int size)
{int i = 0;#if (SDI_PRINT == SDI_PR_OPEN)int writeSize = size;do{/*** data0 data1 8 bytes* data0 The lowest byte storage length, the maximum is 7**/while( (*(DEBUG_DATA0_ADDRESS) != 0u)){}if(writeSize>7){*(DEBUG_DATA1_ADDRESS) = (*(buf+i+3)) | (*(buf+i+4)<<8) | (*(buf+i+5)<<16) | (*(buf+i+6)<<24);*(DEBUG_DATA0_ADDRESS) = (7u) | (*(buf+i)<<8) | (*(buf+i+1)<<16) | (*(buf+i+2)<<24);i += 7;writeSize -= 7;}else{*(DEBUG_DATA1_ADDRESS) = (*(buf+i+3)) | (*(buf+i+4)<<8) | (*(buf+i+5)<<16) | (*(buf+i+6)<<24);*(DEBUG_DATA0_ADDRESS) = (writeSize) | (*(buf+i)<<8) | (*(buf+i+1)<<16) | (*(buf+i+2)<<24);writeSize = 0;}} while (writeSize);#elsefor(i = 0; i < size; i++){
#if(DEBUG == DEBUG_UART1)while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET);USART_SendData(USART1, *buf++);
#elif(DEBUG == DEBUG_UART2)while(USART_GetFlagStatus(USART2, USART_FLAG_TC) == RESET);USART_SendData(USART2, *buf++);
#elif(DEBUG == DEBUG_UART3)while(USART_GetFlagStatus(USART3, USART_FLAG_TC) == RESET);USART_SendData(USART3, *buf++);
#endif}
#endifreturn size;
}
SDI (Serial Data Interface) 是沁恒微电子 RISC-V 内核的私有外设接口
#define DEBUG_DATA0_ADDRESS ((volatile uint32_t*)0xE0000380)
#define DEBUG_DATA1_ADDRESS ((volatile uint32_t*)0xE0000384)
可以看到_write
函数写的数据地址正是在其MCU内核的Core Private Peripherals
范围中
这段代码来看,SDI 接口发送的数据存放于 DATA0 和 DATA1 地址的寄存器,每个寄存器可以存放 32 位数据也就是 4 个字节,两个寄存器可以存储 8 个字节数据,因为 DATA0 的低位第一个字节存放发送数据的个数,那么得知 SDI 接口一次性一包数据可以发送 7 个字节。
综上分析,SDI 接口还可以做其他用途的数据传输,目前来看,貌似给出的资料目前只能发送不能接收。
- WCH-LinkE调试器在Enable SDI Printf后,会虚拟出来一个串口供上位机串口助手使用,默认波特率115200、8N1
- MCU 开启SDI,
#define SDI_PRINT SDI_PR_OPEN
- MCU程序运行中调用Printf函数,要打印的数据最终通过
_write
函数不断地写在内核中的DEBUG_DATA0_ADDRESS
和DEBUG_DATA1_ADDRESS
地址上,而不是通过硬件串口外设调用USART_SendData
发送 - WCH-LinkE调试器会不断地查询位于MCU的内核中上述
DEBUG_DATA0/1_ADDRESS
两地址的数据,并将该数据打包通过虚拟出来的串口发送给串口上位机
比较类似于RTT Viewer
功能,通过调试器不断快速地访问RAM/内核中的指定地址范围的数据来实现MCU和调试器到上位机的数据传输。
只不过WCH的SDI功能目前仅有Printf 打印,对用户RAM区占用很小,但还没支持双向的数据传输,但也算是很好的提升了,WCH加油啊!
3.WCH-LinkUtility的问题
WCH-LinkUtility在菜单栏 Target下拉可以随时控制SDI的开关,但是下图这里的开关不是即时发生的,实测只有在下载程序时会生效。(2024-04-25)