【PC电脑windows-学习样例tusb_serial_device-ESP32的USB模拟串口程序+VScode建立工程+usb组件添加+-基础样例学习】

1、概述

最为新手，想要快速入门相关设备，比如ESP32，可能最好的方式就是直接手动去敲一遍代码，而USB模拟串口其中一个应用，自己作为新手，虽然只是简单运行这个历程，但是认为依然有记录的价值。自己感觉官网样例还是有点晦涩难懂，今天我们就是学习这个样例。

2、实验环境

ESP32说明：ESP32-S3 是一款集成 2.4 GHz Wi-Fi 和 Bluetooth 5 (LE) 的 MCU 芯片，支持远距离模式 (Long Range)。ESP32-S3 搭载 Xtensa® 32 位 LX7 双核处理器，主频高达 240 MHz，内置 512 KB SRAM (TCM)，具有 45 个可编程 GPIO 管脚和丰富的通信接口。ESP32-S3 支持更大容量的高速 Octal SPI flash 和片外 RAM，支持用户配置数据缓存与指令缓存。

硬件信息：开发板 ESP32-S3-DevKitM-1（EPS32-S3-wroom-1模块）

其它硬件：杜邦线，两个usb-type-c连接线。

3-1、 物品说明

ESP32对自己来说还是比较新的，最近也是刚刚接触，这里对自己使用ESP32进行简单说明。
博文链接：【在英伟达nvidia的jetson-orin-nx和PC电脑ubuntu20.04上-装配ESP32开发调试环境-基础测试】

另外如果对ESP32相关型号比较感兴趣，可以去官网查看，或者找些资。
官网文档：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitm-1.html

3-2、所遇问题：ESP32 cannot open source file "tinyusb.h"或者“tinyusb.h:No such file or directory …”

在运行过程中，发现报错如下：

3-3、解决问题：被抛弃，变成组件了，需要添加组件

文档说明链接：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/migration-guides/release-5.x/5.0/removed-components.html?highlight=tinyusb%20h

相关链接：https://components.espressif.com/components/espressif/esp_tinyusb

具体命令

idf.py add-dependency esp_tinyusb~1.4.2

这块 自己也反复重试才通过的，运行上述命令后，如下图所示

重新编译，可以看到多了文件，就是添加进来的组件

4、自我总结

（1）本案例难点：问题相关
自己认为本样例难点，不是说练习代码或者理解代码，而是如何解决问题。如果你拿样例直接编程，不会出现任何问题，但是自己手动重建时，必然会遇到，而网上对这个说的比较少。

（2）USB模拟串口会覆盖掉原本串口，下载需要复位启动
因为使用USB模拟串口，USB原本是用来下载的，所以使用本次样例，USB连接的串口，会变成另一个串口，下载的时候，要重新复位才可以。

（3）自己增加恢复信息的代码
自己的尝试的时候，想着，如何发送消息为特定时候，ESP32会回一些消息。也遇到了一些问题，经过大佬指导，也顺利解决了，这主要自己对基础语法不熟练吧，也能体现练习必要性。

（4）样例说明
本样例，就是你发送什么信息，ESP32的模拟串口，收到后，就会回复给你什么信息。

5、本次实验说明

本次实验是使用样例tusb_serial_device，直接复制一份在桌面，然后手动敲写一遍。
然后加入了一些自己的设定，收到自己的规定的字符的时候，不是回复对应信息，而是回复特定信息。

自己在另一台电脑上，安装在D盘，找如下目录。

D:\Espressif\frameworks\esp-idf-v5.1.1\examples\peripherals\usb\device\tusb_serial_device

6、实验过程

（1）复制目录到桌面

（2）VScode建立工程-详细步骤

我们重新使用使用VScode建立一个工程。
相关环境可以看这个：
【ESP32-PC电脑windows-环境搭建-记录-hello-world-运行基础样例学习】

1：命令模式，建立模板

2：建立

3：选择文件夹

可以看到我这里有了，没有选择一个。

4：选择模板APP

5：如此就会出现一个模板了

在文件夹下，VScode就会添加一些文件，

（3）手动敲写代码

我们重新使用使用VScode建立一个工程。

我们可以继续需要VScode,进行练习代码了。
在main.c里加入手动桥写。

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include <stdlib.h>
#include <time.h>
#include <string.h>
#include <assert.h>
#include "freertos/FreeRTOS.h"
#include "freertos/semphr.h"
#include "freertos/task.h"
#include "freertos/timers.h"
#include "nvs_flash.h"
#include "esp_event.h"
#include "esp_netif.h"
#include "esp_wifi.h"
#include "esp_log.h"
#include "esp_system.h"
#include "esp_now.h"
#include "esp_crc.h"
#include "tinyusb.h"
#include "tusb_cdc_acm.h"
#include "sdkconfig.h"static const char *TAG = "example";
static uint8_t buf[CONFIG_TINYUSB_CDC_RX_BUFSIZE+1];
//static const char buf_send = "12345\n";
//static uint8_t buf_send="abcdef";
//const uint8_t *buf_send='12345';
//const uint8_t *buf_send='12345';
const uint8_t buf_send[]="ABCD78654321";void tinyusb_cdc_rx_callback(int itf,cdcacm_event_t *event){size_t rx_size=0;//size_t send_data_size=sizeof(buf_send);size_t send_data_size=strlen(&buf_send);//printf("Hello,USB Serial_rx_callback!\n");//ESP_LOGI(TAG,"Hello,USB Serial_rx_callback!\n");esp_err_t ret=tinyusb_cdcacm_read(itf,buf,CONFIG_TINYUSB_CDC_RX_BUFSIZE,&rx_size);if(buf[0]==0x31 && buf[1]==0x32 && buf[2]==0x33  ){tinyusb_cdcacm_write_queue(itf,buf_send,send_data_size);  tinyusb_cdcacm_write_flush(itf,0);}else{tinyusb_cdcacm_write_queue(itf,buf,rx_size);tinyusb_cdcacm_write_flush(itf,0);}if(ret==ESP_OK){ESP_LOGI(TAG,"Data from channel %d:",itf);ESP_LOG_BUFFER_HEXDUMP(TAG,buf,rx_size,ESP_LOG_INFO);}else{ESP_LOGE(TAG,"Read error");}// tinyusb_cdcacm_write_queue(itf,&buf_send,9);}void tinyusb_cdc_line_state_changed_callback(int itf,cdcacm_event_t *event){int dtr=event->line_state_changed_data.dtr;int rts=event->line_state_changed_data.rts;ESP_LOGI(TAG,"Line state_changed on channel %d: DTR:%d, RTS:%d",itf,dtr,rts);}void app_main(void)
{//初始化 USB的串口// printf("Hello,USB Serial!\n");// while(1){//     printf("output data:this is my app_usb_uart_test_wifi_test!\n");//     vTaskDelay(pdMS_TO_TICKS(1000));//      printf("test_wifi_file_tinyUSB.c_file!\n");//     vTaskDelay(pdMS_TO_TICKS(1000));// }ESP_LOGI(TAG,"USB initialization");const tinyusb_config_t tusb_cfg = {.device_descriptor = NULL,.string_descriptor = NULL,.external_phy = false ,.configuration_descriptor = NULL,};ESP_ERROR_CHECK(tinyusb_driver_install(&tusb_cfg));tinyusb_config_cdcacm_t acm_cfg = {.usb_dev = TINYUSB_USBDEV_0,.cdc_port = TINYUSB_CDC_ACM_0,.rx_unread_buf_sz = 64,.callback_rx = &tinyusb_cdc_rx_callback,   //the first way to register a callback.callback_rx_wanted_char = NULL,.callback_line_state_changed = NULL,.callback_line_coding_changed = NULL };ESP_ERROR_CHECK(tusb_cdc_acm_init(&acm_cfg));ESP_ERROR_CHECK(tinyusb_cdcacm_register_callback(TINYUSB_CDC_ACM_0,CDC_EVENT_LINE_STATE_CHANGED,&tinyusb_cdc_line_state_changed_callback));#if (CONFIG_TINYUSB_CDC_COUNT > 1)acm_cfg.cdc_port = TINYUSB_CDC_ACM_1;ESP_ERROR_CHECK(tinyusb_cdc_acm_init(&acm_cfg));ESP_ERROR_CHECK(tinyusb_cdcacm_register_callback(TINYUSB_CDC_ACM_1,CDC_EVENT_LINE_STATE_CHANGED,&tinyusb_cdc_line_state_changed_callback));#endifESP_LOGI(TAG,"USB_initialization DONE");}

然后自己手都敲写一遍。

1：选择端口

最好保证你只是连接一个esp32USB串口，一般没下代码的话，出现的串口就是下载端口。
如下，确保你的USB相关接口，连接的是USB上

而一般如你个下载过代码后，或者拿到手了时候，已经不是下载端口，或者说，已经是模拟串口了，该怎么能，就需要重新复位下ESP32.

复位后，立刻使用串口工具查看，这样出现的端口，就是下载端口。

然后我们在VScode选择串口

2：选择芯片

之后就是选择芯片了，这就像进行如下的命令


选择匹配的型号

选择下载方式

然后软件就会帮助我们，建立文件夹“build”。

加入编译需要文件

3：编译

对于命令行下，其实就是命令

idf.py build

编译过程如下

4：加入组件-解决问题演示

一般不出意外，都会出现错误，告诉你没有发现这个tusbxxx相关文件。

如果在"ESP-IDF 5.0 PowerShell"编译也是一样的

我们使用命令行进行加入组件。
具体命令

idf.py add-dependency esp_tinyusb~1.4.2

重新编译，可以看到多了文件，就是添加进来的组件

5：使能usb模拟串口

如下，报错，意思也很明显，需要使能，在menuconfig下设置
命令：

idf.py menuconfig

选择component config->TinyUSB Stack->com…
如下目录，这里也就不截图太多了，按照目录找吧

然后重新编译

（4）加入信息解析部分

可这块自己也是反了很多低级错误，或者说是对c代码写法不熟悉，最后大佬指点才弄明白吧。
如下代码，如果发的字符有“123（十六进制就是31 32 33）”，那么就返回字符串“ABCD…”

（5）串口验证

下载成功后，按下复位键，验证
（1）

（2）
可以看到如字符串首位是123，那么会回复自定义字符，如果开头是ABCD,那就回原始数据。

7、代码连接

代码链接：https://download.csdn.net/download/qq_22146161/88502147

8、相关细节

（1）相关官方文档：USB外设说明

https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/usb_device.html?highlight=usb

（2）github上相关说明与代码

连接：https://github.com/espressif/esp-idf/tree/8fc8f3f479/examples/peripherals/usb/device/tusb_serial_device

（3）编译环境配置

相关配置情况自己的其他文章：【ESP32-PC电脑windows-环境搭建-记录-hello-world-运行基础样例学习】

（4）练习回复信息，报错，代码写法问题。

如下，自己对代码不熟练，总是提示一些写法问题。

（5）其他错误：误导的博客，注意自查

相关链接：https://blog.csdn.net/oHuanCheng/article/details/127203208

按照网上教程，说是解决找不到文件“”

结果尝试后，引入了其他问问题。

（6）没有文件build.ninja

如下图

一般需要重新设置下芯片。
命令：

（7）命令行尝试，历史截图

如下图，是自己在终端上所做的尝试，前面VScode构建工程，后面"ESP-IDF 5.0 PowerShell"添加组件和编译下载什么的。

  Id CommandLine-- -----------1 cd C:\Users\Admin\Desktop\esp_32_work\now_test_tusb_serial_device\template-app2 idf.py add-dependency esp_tinyusb~1.4.23 idf.py add-dependency esp_tinyusb 1.4.24 idf.py add-dependency esp_tinyusb~1.4.25 idf.py add-dependency esp_tinyusb~1.0.06 idf.py add-dependency "espressif/esp_tinyusb^1.4.2"7 idf.py add-dependency esppressif/esp_tinusb8 idf.py build9 idf.py menuconfig10 idf.py build11 idf.py build12 idf.py build13 idf.py build14 idf.py -p com27 flash15 idf.py build16 idf.py -p com27 flash

9、总结

时间有点久了，我都记不住了，多尝试吧吧，这样这块也算了一段学习了。

另外这样我们也有了 使用VScode建立工程相关经验了。以后就可以以这个为参照了。