WCH RISC CH32V303RCT6 单片机的SDI Printf 虚拟串口功能类似RTT打印功能简单分析

news2024/11/20 6:26:14

参考：
有关于 SDI printf 更多的信息和资料吗？
关于 CH32 系列 MCU SDI 虚拟串口功能的使用
【CH32X035 评估板测评】+ 教你使用 SDI 接口重定向 printf

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 虚拟串口功能原理简单推测分析

从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);


#else
    for(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
    }
#endif
    return size;
}

WCH-LinkE调试器在Enable SDI Printf后，会虚拟出来一个串口供上位机串口助手使用，默认波特率115200、8N1
MCU 开启SDI，#define SDI_PRINT SDI_PR_OPEN
MCU程序运行中调用Printf函数，要打印的数据最终通过_write函数不断地写在RAM中的DEBUG_DATA0_ADDRESS 和DEBUG_DATA1_ADDRESS 地址上，而不是通过硬件串口外设调用USART_SendData发送
WCH-LinkE调试器会不断地查询位于MCU的RAM中上述DEBUG_DATA0/1_ADDRESS两地址的数据，并将该数据打包通过虚拟出来的串口发送给串口上位机
比较类似于RTT Viewer功能，通过调试器不断快速地访问RAM中的指定范围的数据来实现MCU和调试器到上位机的数据传输。
只不过WCH的SDI功能目前仅有Printf 打印且RAM缓冲区占用很小，但还没支持双向的数据传输，但也算是很好的提升了，WCH加油啊！