ESP32S3使用esp-iot-solution SDK开发USBHID鼠标键盘教程
文章目录
-
- 一、前言
- 二、环境搭建
- 三、sdkmenu参数配置
-
- 1、设置开发环境
- 2、开始编译
- 3、程序烧录
- 四、错误集合解决办法
-
- 1、这个错误的原因就是sdk版本低不支持S3
- 2、这个错误的原因就是ESP-IDF和add_usb_solutions同名组件版本不一致造成的，我的临时做法是将add_usb_solutions下的audio改个名字。重新编译问题即可解决。
- 结语
一、前言
手里最近翻到了一个ESP32S3开发板，于是想做个鼠标键盘玩玩，这是我第二次接触ESP32,上一次18年买的吃灰板子至今没上过电。新找到的S3看手册是支持OTG的，按照官方的教程搭建的WSL+VSCODE环境。然而一切准备就绪发现ESP-IDF里面没有USB-HIDdemo。没有demo怎么玩。于是乎查找资料找，找到了专为物联网开发SDK esp-iot-solution简介如下。该框架支持usb OTG 功能。
二、环境搭建
这里面要注意的是官方说明写的 esp-iot-solution支持的依赖是ESP-IDFv4.3。但是我这里用的是 esp-iot-solution其中的一个分支USB。按照官方的依赖V4.3做USB的话搞到地老天荒都搞不出来。原因是TinaUsb组件要ESP-IDF依赖是4.4。这个问题困扰了我好几天。
好了下面开始下载分支按照教程安装即可。
仓库下载地址
https://github.com/espressif/esp-idf
https://github.com/espressif/esp-iot-solution
克隆 esp-iot-solution usb分支
clone -b usb/add_usb_solutions --recursive https://github.com/espressif/esp-iot-solution
克隆 ESP-IDF4.4 分支
git clone -b release/v4.3 --recursive https://github.com/espressif/esp-idf.git
克隆后如下图所示
按照官方教程激活环境
略
进入到usb_hid_device目录下，在CmakeLists.txt中增加一条指令保存，不要按官方手册都复制进去。
三、sdkmenu参数配置
1、设置开发环境
这里面有个坑，如果配置内核开发板为ESPS3 目标芯片也为ESP32的话，就会报example 只支持ESP32错误。
翻看官方issue发现类似问题，官方解释这是ESp32S3 bug 之后会修复，临时的解决办法是开发板设置SaoLa ESP32S2
然后目标芯片设置成ESP32S3
idf.py set-target esp32s3
2、开始编译
重新编译，漫长等待结果还是报错，不过这回的错误变了
error: unknown type name 'button_handle_t'
提示找不到类型名称，根据多年经验分析，这个情况多半是头文件没有包含进来或者源文件没有添加。
通过vscode 定位到该类型在iot_button.h
既然文件存在那么分析一下为啥找不到。看主程序的头文件引用，在主程序里面没有直接引用iot_button.h，那么最有可能在board.h中间接包含，打开board.h文件。
果然如我所料间接包含了，但是编译的时候还是找不到，通过分析发现，该board.h在目录esp32s3_usb_otg_ev路径下，这个目录是否被包含是根据是上文menuconfig中 boards options 选项选择开发板决定的，上文已经说了该SDK只支持esp32s2，为了适配S3开发板只能选择saola,所以导致生成的sdkconfig不包含esp32s3_usb_otg_ev路径，所以主程序不能找到board.h文件，间接的不能找到iot_button.h文件。
既然问题已经发现了，那就开始着手解决问题，第一步既然没有包含iot_button.h那么直接在主程序里包含好了，然后编译。
上述问题解决，但是又出现新问题了，iot_board_button_register_cb按键注册回调函数找不到。根据函数就知道了它也在board.h中。
通过程序分析，该函数模注册个按键事件模拟鼠标或者键盘发送数据，不影响主体USB相关功能，而且按键发送程序，不一定要用demo的写法，所以这是个可有可无的功能，后期可以自己从写，为了大业先屏蔽掉，然后编译。
哈哈 终于编译通过了
3、程序烧录
串口烧录要频繁在现实与虚拟环境切换串口麻烦，所以这里通过flash烧录软件进行烧录如下图，主要偏移地址和S2不一样。
烧写完成后将将开发板插到电脑上，见证奇迹时刻了。
四、错误集合解决办法
1、这个错误的原因就是sdk版本低不支持S3
error: 'ADC_BUTTON_WIDTH' undeclared (first use in this function); did you mean 'ADC_BUTTON_ATTEN'?
没有S3的定义，增加一个宏定义即可
2、这个错误的原因就是ESP-IDF和add_usb_solutions同名组件版本不一致造成的，我的临时做法是将add_usb_solutions下的audio改个名字。重新编译问题即可解决。
error: unknown type name 'i2s_dac_mode_t'
i2s_dac_mode_t dac_mode; /*!< DAC mode configurations - see i2s_dac_mode_t*/
结语
有朋友反馈，找不到我，今打油诗一首
加流一壶真千金
微云澹日映寒流
信意麾毫无点误
KING_SONGING
唱奇腾怪可删修
歌咏康衢了此生
的然民仰如父母
国家涵养自建隆
王俭归来幕府非
有朋自远发来，不亦说乎！