如何在树莓派Pico上实现Arduino Serial.end()式的USB断开功能？

核心思路 #

Arduino的Serial.end()本质是关闭USB CDC串口设备，触发电脑端监听程序（如cat/stty）的断开信号；Pico的stdio_usb基于TinyUSB封装，需直接调用TinyUSB底层接口实现设备断开与重建，而非重复调用stdio_usb_init()。

具体实现步骤 #

1. 引入依赖头文件
   直接操作TinyUSB API需要引入对应头文件，代码开头添加：

   #include "tusb.h"
   #include "pico/stdio_usb.h"
   

2. 实现等效Serial.end()的函数
   完成数据刷新、USB连接断开、资源清理：

   void usb_serial_end(void) {
       // 确保所有待发送数据全部输出
       stdio_flush();
       // 主动断开USB CDC连接
       tud_cdc_disconnect();
       // 等待电脑端释放端口（避免残留连接导致挂起）
       sleep_ms(300);
       // 解除stdio与USB串口的绑定
       stdio_remove_channel(&stdio_usb);
   }
   

3. 实现等效Serial.begin()的函数
   重新初始化USB串口并等待电脑连接：

   void usb_serial_begin(void) {
       // 先清理旧的USB设备栈
       tud_deinit(BOARD_TUD_RHPORT);
       // 重新初始化TinyUSB设备栈
       tud_init(BOARD_TUD_RHPORT);
       // 等待电脑端完成USB枚举与连接
       while (!tud_cdc_connected()) {
           sleep_ms(100);
           // 处理USB设备事件，必须调用
           tud_task();
       }
       // 重新关联stdio到USB串口
       stdio_usb_init();
       // 开启CRLF自动转换（匹配Arduino默认行为）
       stdio_set_translate_crlf(&stdio_usb, true);
   }
   

4. 业务逻辑调用示例

   void capture_and_send_image(void) {
       // ... 此处省略图像捕获与数据准备代码 ...
       
       // 发送图像数据到USB串口
       fwrite(image_buffer, 1, image_size, stdout);
       
       // 结束当前传输，触发电脑端监听程序退出
       usb_serial_end();
       
       // 等待用户重启电脑端监听程序（或自动等待）
       sleep_ms(1000);
       
       // 重建连接，准备下一次传输
       usb_serial_begin();
   }
   

关键注意事项 #

• 必须调用tud_task()：等待USB连接的循环中，该函数负责处理USB设备的枚举、连接请求等事件，否则Pico无法正确响应电脑端的连接操作。
• 避免重复初始化无效：直接调用stdio_usb_init()不会重置已存在的USB串口，必须先通过tud_deinit()和stdio_remove_channel()清理资源。
• 解决端口挂起问题：通过tud_cdc_disconnect()主动断开连接，并预留足够等待时间让电脑端释放端口，可避免端口挂起。

内容的提问来源于stack exchange，提问作者the G