产品 FAQ

软件配置

问：示例中 ESP32-S3 是如何通过 4G 模组的 USB 进行拨号上网的？

答： ESP32-S3 通过串口、USB 都可以进行 PPP 拨号上网，本示例中通过 TinyUSB 协议，使用枚举 USB 的地址进行拨号上网。

问：当前用的是哪个版本固件库，有 2.0.13 的吗？

答：

当前用的是 2.0.7 的版本固件库，这是基于当时的开发需求和适配情况确定的。
对于 2.0.13 版本，暂时没有直接可用的相关示例，这边也会尽快出更新的 LVGL 版本程序。
您也可尝试自行将其集成到项目中，但需注意兼容性等问题。

问：ESP32-S3 拨号上网代码如何修改？

答：

本示例中的代码通过 esp-idf 进行编译烧录，使用 Arduino IDE 需要进行 TinyUSB 和 PPP 数据包处理等移植工作。
请直接参考：https://github.com/espressif/esp-iot-solution/tree/master/examples/usb/host/usb_cdc_4g_module ，这是乐鑫官方方案，我们不协助修改和分析代码。
如遇到编译环境问题，也可以先编译此简单示例程序：https://files.waveshare.com/wiki/ESP32-S3-A-SIM7670X-4G-HAT/Demo/ESP-7670-call-IDF.zip

问：能帮我看下代码吗？能否帮我修改代码？

答：本产品定位于开发板，并不是成品产品。关于产品生态属于是 ESP32 核心，生态很成熟，开发环境也很友好，我们不协助修改代码，请各位创客、极客自行发挥 DIY 能力，如有疑问可以询问工程师为您解答。如您觉得我们的产品不错，希望批量定制硬件、定制外壳、定制软件等，欢迎联系销售。

定制说明

问：代码可以协助修改么？

答：我们不协助修改和分析代码，请自行处理。

问：随身 WiFi 打开网页很卡，这是正常现象吗？

答：

测速软件会尽可能拉满速度，导致模组与 ESP32-S3 之间的数据包传输占满，出现卡顿。
Cat-1 模组速率有限，仅适合测试使用。
若客户端需求带宽过大，可能出现崩溃情况，可自行从源码层面做处理。

问：是否可以通过模组本身连接 WaveshareCloud 并上报经纬度等数据？

答：开发板通过软串口连接 A/SIM7670X 4G 模组串口，通过 AT 指令开启 GNSS 功能后，将模组接收到的卫星数据切换为串口输出。
此时执行 Publish 指令即可上报数据，平台侧需对返回的 NMEA 数据做好过滤处理。

问：针对随身 WiFi 例程，如何为不同运营商手动设置模组 APN？

答：随身 WiFi 例程默认 APN 为空，如模组无法自动识别 SIM 卡运营商，需要修改源码。

步骤如下：

参照 ESP-IDF 篇配置开发环境，安装 ESP-IDF 与 VS Code。
使用 VS Code 打开示例程序，在 menuconfig 中手动设置 APN。
烧录程序并断电重启开发板。

问：为何使用例程时经常提示头文件不存在？是否能提供库文件？

答：所有示例所用库均通过 Arduino IDE 的 Library Manager 下载。
库文件持续更新迭代，如缺失库文件，直接在 Arduino IDE 中下载安装即可。

问：收不到 GPS 信号，没有获取到位置信息怎么办？

答：

请将 GPS 天线连接至 GNSS 天线接口，并放置在空旷的室外环境，上电后需等待约 1 分钟。

备注

由于 GPS 在室内搜星不稳定，请将模块或天线放到阳台、窗户旁，或直接在户外可视天空环境下测试。

可视天空

问：是否有摄像头视频通过 4G 远程传输的示例？

答：

暂无现成示例程序，需要自行二次开发实现。
模组仅提供数据连接，ESP32 采集的摄像头视频流目前通过 HTML 页面显示。
业务逻辑较简单时，可通过 TCP 指令控制 ESP32-S3 拍照并上传图片数据。
理论上可通过公网服务器实现 4G 图传，但性能有限，尚未实测。
如需稳定高清视频传输，建议使用树莓派等 Linux 主控搭配 4/5G 蜂窝模块方案。

问：为什么摄像头画面黑屏？

答：请按如下方式配置

相关设置：
- Flash Size: 16MB (128Mb)
- PSRAM: QSPI PSRAM
- Flash Mode: QIO 80MHz
- Partition Scheme: 16M Flash (3MB APP / 9.9MB FATFS)
使用说明：
- 进入网页后，先点击 Get Still 拍照，再点击 Stop Stream 进行监控。
注意事项：

如为 2026 年元旦后收到的模块，请使用示例程序 V2。
如仍异常，可参考以下配置：
- Board: ESP32S3 Dev Module
- USB CDC On Boot: Enabled
- CPU Frequency: 240MHz
- Flash Mode: QIO 80MHz
- Flash Size: 16MB (128Mb)
- PSRAM: Disabled
- Partition Scheme: 16M Flash (3MB APP / 9.9MB FATFS)

问：为什么烧录 AP 示例程序后没有出现热点？

答：需满足以下条件：

X7670X 已成功注册网络并完成拨号。
开发板背面拨码开关设置为 4G 开启、USB 关闭，并重新上电。
下载正确固件，勿混淆 A7670 与 SIM7670。
验证阶段建议使用可通话的手机卡。

问：如何单独测试模组的通话、定位等功能？

答：

将所有拨码开关全部打开。
可使用以下示例测试通话、短信和定位功能：
https://files.waveshare.com/wiki/ESP32-S3-A7670E-4G/code/Hard-serial-esp32-7670.zip
网络检查程序：
https://files.waveshare.com/wiki/ESP32-S3-A7670E-4G/code/X7670_Network.ino

问：烧录固件失败，提示等待上电同步且指示灯不闪？

答：请确认已切换为 UART 下载模式，当前需使用 UART 下载 ESP32-S3 程序。

UART 配置

问：在 macOS 设备上烧录失败？

答：请先安装 CH34X macOS 驱动后重新烧录：
https://files.waveshare.com/wiki/common/CH34XSER_MAC.7z

问：离线安装板找不到文件夹路径？

答：请在文件管理器中勾选查看 → 隐藏的项目，路径位于当前用户名目录下。

路径示例

硬件功能

问：ESP32-S3-A7670E-4G 能部署小智或火山引擎吗？支持语音交互吗？

答：

ESP32 硬件本身可以部署 AI。
板载喇叭和扬声器仅用于 A7670E 拨号通话，与 ESP32 无连接，不能直接用于 ESP32 语音交互。
如需语音交互，需要额外为 ESP32 接入扬声器和麦克风。
推荐使用已适配小智的音响模块：https://www.waveshare.net/shop/ESP32-S3-Touch-LCD-1.85C-BOX.htm
若您具备较丰富的 ESP32 开发经验，也可以自行外接麦克风模块，可参考开源示例：https://github.com/Jamm02/esp32-audio-router?tab=readme-ov-file#wm8960
我们不提供相关代码修改或分析支持，请自行处理。

问：板载的麦克风和喇叭接口能实现 ESP32 语音交互吗？可以直接说话吗？

答：

不可以，板载麦克风和喇叭均直连 A7670E，仅用于通话功能，与 ESP32 无连接。
如需 ESP32 实现录音和播放功能，需要额外接入 SPI 等接口的音频模块。

问：模块下载程序后，再次下载时有时无法连接串口或烧录失败，怎么办？

答：

按下 RESET 键 1 秒以上，等待 PC 端重新识别设备后再次下载。
长按 BOOT 键，同时按下 RESET，先松开 RESET，再松开 BOOT，此时模块会进入下载模式，可解决大多数无法下载的问题。

问：ESP32-S3-SIM7670G-4G 不接外部电源，仅使用电池可以开机吗？

答：

首次安装电池后需要接入外部电源以激活保护机制（用于防止电池反接），电池充满后可不接外部电源使用。
也可以通过放电方式激活，Type-C 接口除充电外，还可对外部设备供电，使模块放电，从而完成激活。

问：摄像头是否支持自动对焦？

答：配套摄像头不支持自动对焦。

问：这款产品功耗是多少？一节电池可以工作多久？

答：

实际工作时间取决于应用场景。
例如持续拍照或视频时，电流约 1.8A，功耗约 9W。
使用约 2600mAh 的 18650 电池，连续工作时间约 1.5 小时。

问：每个拨码开关分别有什么功能？

答：各拨码开关功能如下图所示：

拨码开关说明

问：如何让 4G 模块关机？

答：

最简单的方法是关闭 4G 拨码开关，关闭后模块关机，再打开可重新开机。
若需通过程序控制，请保持拨码开关关闭，通过 GPIO33 或 GPIO22 控制：
- GPIO 拉高：模块开机
- GPIO 拉低：模块关机

示例代码如下，实现 4G 模块每 10 秒开关一次：

const int pin = 33;

void setup() {
  pinMode(pin, OUTPUT);
  Serial.begin(115200);
}

void loop() {
  digitalWrite(pin, HIGH);
  delay(10000);

  digitalWrite(pin, LOW);
  delay(10000);
}

问：ESP32-S3-A7670E-4G 开发板有多少 IO 和外设可以自定义？

答：

深绿色标注的 IO 尚未使用，可自由配置为 SPI、I2C、I2S 等功能。
浅绿色标注的 IO 被摄像头、TF 卡等板载外设占用，如不使用对应外设，可通过排针引出作为其他功能使用。

IO 资源说明

问：为什么程序下载异常？

答：请先按住 BOOT 键，再重新拔插 USB，确认是否能识别到 COM 口。

问：模块如何组装？

答：请参考 组装文档。

问：如何改用外置 WiFi 天线？

答：

需焊接外置天线对应的电阻。
使用外置天线时，建议移除板载贴片天线，否则可能影响信号性能。
如果您用的是 V2 版本，不用移除电阻，去掉陶瓷天线后，直接接上外置天线

问：为什么设备显示为未知设备？

答：建议通过 USB 集线器连接，优先使用 USB 3.0 接口。

问：为什么新版本与旧版本的摄像头程序不能通用？

答：

2026 年后新版本默认配套 OV5640 摄像头，背面带有 V2.0 丝印。
旧版本使用 OV2640 摄像头，两者驱动和程序不通用，需要区分使用。

OV2640 与 OV5640 区分

软件配置​

硬件功能​

软件配置

硬件功能