【RP2350】香瓜树莓派RP2350之USB虚拟串口

本文最后修改时间：2025年05月10日 01:57

一、本节简介

本节以树莓派pico2开发板为例，举例如何写一个USB虚拟串口的驱动加进工程里。

二、实验平台

1、硬件平台

1）树莓派pico2开发板

①树莓派pico2开发板（作为仿真器）

②micro usb数据线

2）电脑

3）香瓜RP2350目标板

2、软件平台

1）VS CODE

2）sscom5.13.1（串口工具）

三、版权声明

1）作者：甜甜的大香瓜

2）声明：喝水不忘挖井人，转载请注明出处。

3）纠错/业务合作：[e-mail]

4）香瓜嵌入式之树莓派群：512598061

5）本文出处：原创连载资料《简单粗暴学树莓派》

6）完整开源资料下载地址（电脑端打开）：

opengua.taobao.com

四、实验前提

1、在进行本文步骤前，请先阅读以下章节：

1）《简单粗暴学树莓派》的“第一章至第二章”章节​。

2、在进行本文步骤前，请先实现以下章节：

1）《简单粗暴学树莓派》的《香瓜树莓派RP2350之搭建开发环境（windows）》

2）《简单粗暴学树莓派》的《香瓜树莓派RP2350之新建工程》

五、硬件原理

1、硬件连接

实际只接了4根线，3.3V、GND、CLK、DIO

注意： 给pico2供电时接VSYS，是因为pico2会再经过稳压到3.3v供电给pico2目标板的rp2350。而香瓜使用的板子仿真接口是直接供电给rp2350的，所以需要直连3.3v。

2、原理图

RP2350的USB信号连接到板载的USB接口上

六、实验步骤

1、在VS CODE工程文件夹下，添加驱动GUA_USBtoUart.c（VS CODE会自动加载）

//********************************************************************** //name:         GUA_USBtoUart.c //introduce:    USB转串口驱动 //author:       opengua      //email:        [e-mail]   //QQ group:     香瓜嵌入式之树莓派群(512598061) //shop:         opengua.taobao.com //changetime:   2025.02.18 //********************************************************************** #include "pico/stdlib.h" #include "GUA_USBtoUart.h" #include "main.h" /*********************全局变量************************/ uint8_t gaGUA_USBtoUART_Rx_Buff[GUA_USB_TO_UART_RX_SIZE] = {0}; volatile uint8_t gGUA_USBtoUART_Rx_Length = 0;       //必须加volatile，否则会被优化 /*********************内部函数************************/ static void GUA_Chars_Available_Callback(void* param); //********************************************************************** //name:         GUA_Chars_Available_Callback //introduce:    回调函数 //parameter:    none //return:       none //author:       opengua //email:        [e-mail] //QQ group:     香瓜嵌入式之树莓派群(512598061) //shop:         opengua.taobao.com //changetime:   2025.02.18 //********************************************************************** static void GUA_Chars_Available_Callback(void* param) {     int nGUA_Temp = 0;     //记录接收数据前清零     gGUA_USBtoUART_Rx_Length = 0;     //如果不读出数据会一直进中断；正常数据大于等于0，读完后则会返回负数     while((nGUA_Temp = getchar_timeout_us(100)) >= 0)     {         gaGUA_USBtoUART_Rx_Buff[gGUA_USBtoUART_Rx_Length] = nGUA_Temp;         gGUA_USBtoUART_Rx_Length++;     }     //发送数据     //GUA_USBtoUart_Send(gaGUA_USBtoUART_Rx_Buff, gGUA_Length);     //进入通信处理事件     gnGUA_Function = FUNC_GUA_COMMUNICAION_PROCESS_EVT;     } //********************************************************************** //name:         GUA_USBtoUart_Send //introduce:    初始化 //parameter:    pGUA_Data:发送数据缓冲区 //              nGUA_Len:数据长度 //return:       none //author:       opengua //email:        [e-mail] //QQ group:     香瓜嵌入式之树莓派群(512598061) //shop:         opengua.taobao.com //changetime:   2025.02.18 //********************************************************************** void GUA_USBtoUart_Send(uint8_t *pGUA_Data, uint8_t nGUA_Len) {     for(uint8_t i = 0; i<nGUA_Len; i++)     {         stdio_putchar_raw(pGUA_Data[i]);     } } //********************************************************************** //name:         GUA_USBtoUart_Init //introduce:    初始化 //parameter:    none //return:       none //author:       opengua //email:        [e-mail] //QQ group:     香瓜嵌入式之树莓派群(512598061) //shop:         opengua.taobao.com //changetime:   2025.02.18 //********************************************************************** //需要在CMakeLists.txt文件中打开usb（同时关闭串口为0）：pico_enable_stdio_usb(ArgonOne_RP2350 1) void GUA_USBtoUart_Init(void) {     //初始化usb转串口 这条不能被调用两次，避免低功耗唤醒后被再次初始化，所以这条放到GUA_Init函数外     //stdio_init_all();      //usb的回调函数，如果有想传入回调函数的变量可以从第二个形参传入     stdio_set_chars_available_callback(&GUA_Chars_Available_Callback, (void*)NULL);     //打印     //printf("GUA_USBtoUart_Init ok\r\n"); }

注意USB的回调函数里有香瓜的项目变量，添加后需要增删一些报错内容。

2、在VS CODE工程文件夹下，添加驱动GUA_USBtoUart.h（VS CODE会自动加载）

//********************************************************************** //name:         GUA_USBtoUart.h //introduce:    USB转串口驱动头文件 //author:       opengua      //email:        [e-mail]   //QQ group:     香瓜嵌入式之树莓派群(512598061) //shop:         opengua.taobao.com //changetime:   2025.02.18 //********************************************************************** #ifndef _GUA_USB_TO_UART_H_ #define _GUA_USB_TO_UART_H_ /*********************头文件************************/ #include <stdio.h> /*********************宏定义************************/ //串口缓冲区大小 #define GUA_USB_TO_UART_RX_SIZE     128 /*********************全局变量************************/ extern uint8_t gaGUA_USBtoUART_Rx_Buff[GUA_USB_TO_UART_RX_SIZE]; volatile extern uint8_t gGUA_USBtoUART_Rx_Length; /*********************外部函数************************/ extern void GUA_USBtoUart_Send(uint8_t *pGUA_Data, uint8_t nGUA_Len); extern void GUA_USBtoUart_Init(void); #endif

3、添加对应驱动文件名称

4、打开USB开关、关闭串口开关（只能打开一个）

5、在应用层中调用

1）添加驱动头文件（main.c中）

#include "GUA_USBtoUart.h"

2）添加驱动初始化代码1（main.c的main函数中）

//串口转USB初始化     GUA_USBtoUart_Init();

3）添加驱动初始化代码2（main.c的main函数中前面）

//初始化usb转串口 这条不能被调用两次，避免低功耗唤醒后被再次初始化，所以这条放到GUA_Init函数外     stdio_init_all();

七、实验结果

用USB连接设备和电脑，编译并仿真，全速运行。即可通过sscom5.13.1识别到串口了，可进行收发（需要修改USB回调函数）

因此实验成功。