模块简介

ESP32-S3 是乐鑫双核 Xtensa LX7 MCU，集成 2.4 GHz Wi-Fi 与 Bluetooth 5（LE）。在本平台场景中，常用于作为蓝牙 HID 设备（模拟键盘/鼠标等）与手机或收银端配合，实现远程确认、自动化操作等功能。

硬件准备

• 一块 ESP32-S3 开发板（建议带 USB 口，便于烧录与串口调试）。
• USB 数据线（优先使用数据线，避免仅充电线导致无法识别端口）。
• 若使用外设（按键、指示灯等），按原理图连接 GPIO，注意电平为 3.3V。

开发环境（Arduino）

1. 安装 Arduino IDE 2.x 或 VS Code + Arduino 插件。
2. 在「开发板管理器」中添加 ESP32 包地址（乐鑫官方 JSON），安装 esp32 平台，开发板型号选择带 S3 的条目（如 ESP32S3 Dev Module）。
3. 选择正确的 USB CDC On Boot、Partition Scheme 与 PSRAM 选项，与您的模组规格一致。
4. 连接 USB 后，在「工具 → 端口」中选择对应串口；若驱动异常，可安装 CP210x/CH340 等芯片驱动。

烧录固件

将编译生成的 .bin 烧录到 Flash 常用方式：

• Arduino IDE：直接点击「上传」，IDE 会调用 esptool 完成擦写与写入。
• esptool.py：命令行指定芯片 esp32s3、端口与合并后的固件地址（具体分区需与分区表一致）。
• 进入下载模式：按住 BOOT（或 IO0）上电/复位，再松开；不同开发板丝印可能为 BOOT、FLASH、IO0。

蓝牙与 HID

固件中若启用 Bluetooth HID，开发板可被手机/平板识别为键盘或复合 HID 设备。使用前请确认：

• 手机蓝牙设置中完成配对与连接；部分系统需在「已连接设备」中勾选「输入设备」类权限。
• 与业务端保持协议一致（键码、报告描述符、连接间隔等），避免乱码或无响应。
• 若同时开启 Wi-Fi，注意射频共存导致的延迟或断连，可按需调整发射功率与共存策略。

常见问题

无法上传

检查端口、数据线、是否进入下载模式；关闭占用串口的其他软件。

反复重启

供电不足或 GPIO 冲突；查看串口监视器波特率与启动日志。

蓝牙连不上

确认固件已初始化 BLE、未处于深度睡眠；清除手机侧配对记录后重试。