企业官网建设流程全解析

xiaozhi-esp32 + ML307 4G 模块：让 ESP32 设备插上 SIM 卡就上线

【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32

想把 ESP32 语音助手放到公园、仓库或车里，Wi-Fi 基本走不通。xiaozhi-esp32 项目支持 ML307 4G 模块（Cat.1）接入蜂窝网络：接好线、插一张 SIM 卡，设备就能自己完成入网，语音对话流程在户外也能完整跑起来。下面按接线、烧录、验证、排错的顺序讲一遍。

先说问题：设备为什么需要一张 SIM 卡

Wi-Fi 的"服务半径"就是那台路由器。设备位置固定、在室内，Wi-Fi 够用；设备位置会变——户外、车载、车间巡检——蜂窝网络才是现实选择。

ML307 是 Cat.1 模块，速率比 4G 高配低一档，但做语音、控制、小数据上报完全够，功耗和成本都更友好。

认识一下 ML307：给 ESP32 加的"蜂窝网卡"

在 xiaozhi-esp32 里，ML307 不参与音频链路，只负责网络接入，分两层：

1. 底层是 AT 指令层，向模块发标准 AT 命令，完成开机、注册、收发数据；
2. 上层是网络接口层，把模块包装成标准网络接口，应用层拿到的体验和 Wi-Fi 一致。

打个比方：AT 层是翻译官，网络层是插卡槽——翻译把话递到位，上面的应用不关心底下插的是 Wi-Fi 还是 4G。

ESP32 4G 模块接线：交叉两根线 + 一根电源控制

接线一共三根线：

1. 模块 RX → ESP32 TX（交叉接，别接反）；
2. 模块 TX → ESP32 RX；
3. 一根专用电源控制引脚（DTR），固件用它控制模块的供电与复位。

以项目里的面包板方案 bread-compact-ml307 为例，TX 用 GPIO12、RX 用 GPIO11（见 config.h）。接线示意：

电源控制这根线最容易漏。就算串口两根线全对，供电时序不对，模块照样没反应。

Cat.1 模块部署：三条命令完成烧录

先把目标芯片定成 esp32s3，再进 menuconfig 选中带 ML307 的板型（面包板、星智 Cube、征辰等型号都有 4G 版本），然后编译烧录：

idf.py set-target esp32s3 idf.py menuconfig idf.py build flash monitor

烧完打开 monitor 盯串口输出。

另外说明一点：这类板子是双网络设计，Wi-Fi 和 4G 并存，启动阶段双击 boot 键就能在两者之间切换。现场可以先连 Wi-Fi 调试，稳定后再切到 4G 验证。

验证效果：信号到底有几格 📶

串口输出分三步看：

1. Detecting modem...—— 固件以 921600 波特率探测模块；
2. Modem detected successfully—— AT 握手成功，接着会打印 IMEI、ICCID，说明 SIM 卡被读到了；
3. Network connected—— 注册完成，网络就绪。

之后就看信号图标。固件把 CSQ（0–31）映射成四档：

信号稳定在三格以上、Network connected不再闪烁，部署就算完成了。

4G 模块没反应？先查这 4 处 🔧

Q：串口一直停在探测阶段，模块像不存在A：按顺序查三样——供电（模块电流需求不低，USB 直供电容易带不动）、RX/TX 是否交叉接对、波特率是否匹配（固件默认 921600）。

Q：模块找到了，注册却反复失败A：先看 SIM 卡状态——是否已实名激活、有没有开通数据业务；再核对 APN 配置是否正确。

Q：注册成功，但信号时好时坏、频繁重连A：大概率是天线问题。把天线挪离金属外壳和板子大电流区域，换个位置再测一轮。

Q：信号一直只有一格A：CSQ 落在 0–9 属于"较弱"。检查天线型号与安装位置，也确认一下当地本身有没有蜂窝覆盖。

下一步就干一件事：按 bread-compact-ml307 的引脚把三根线接好，烧完固件盯一眼串口——出现Modem detected successfully，4G 链路就通了，剩下的只是等Network connected而已。

【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32