【miniHexa六足机器人】结合ESP32S3/WonderLLM视觉模块烧录程序报错的排查与修复指南
本篇主角长这样
适用于产品：幻尔科技miniHexa六足机器人 + ESP32S3/WonderLLM视觉模块
涉及模块：miniHexa主控板 / ESP32S3视觉模块 / WonderLLM视觉模块 / IIC通信接口
一、问题描述
1、在miniHexa六足机器人结合ESP32S3/WonderLLM视觉模块使用时，烧录程序过程中出现以下异常现象：
（1）烧录程序时编译或上传报错，提示上传失败，请检查面板信息。
（2）程序烧录后，视觉模块无法正常工作，miniHexa无法接收视觉模块的识别数据。
（3）IIC通信异常，miniHexa与视觉模块之间数据交互失败。
2、该问题通常出现在以下场景：
（1）首次组合使用miniHexa与ESP32S3/WonderLLM视觉模块。
（2）接线时IIC接口插错位置或线序接反。
（3）仅给miniHexa烧录了程序，未给视觉模块烧录对应固件。
（4）误以为WonderLLM视觉模块可以通过WonderCode图形化编程进行开发。
二、问题说明
1、该问题通常由硬件接线错误或视觉模块程序未烧录引起，需逐一排查。
2、miniHexa与ESP32S3/WonderLLM视觉模块之间通过IIC总线通信。若接线不正确，两者之间无法建立有效的数据通道，烧录或运行时均会出现报错。
3、miniHexa结合视觉模块使用时，必须同时给两个设备分别烧录对应的程序：
（1）miniHexa主控板需要烧录miniHexa对应的控制程序。
（2）ESP32S3/WonderLLM视觉模块需要单独烧录视觉模块对应的固件程序。
4、特别注意：
（1）WonderLLM视觉模块不支持图形化编程，无法使用WonderCode进行编程开发。
（2）WonderLLM视觉模块的程序烧录需按照资料文档中指定的方式进行，不可套用miniHexa的烧录流程。
关键点：miniHexa与视觉模块是两个独立的控制器，各自需要烧录各自的程序。只烧录其中一个，另一个将无法正常工作，从而导致整体功能报错。
三、解决方法
排查一：检查硬件接线是否正确
1、确认IIC接口连接位置
（1）检查ESP32S3/WonderLLM视觉模块的接线是否正确。
（2）IIC接口必须对应miniHexa主控板上的前三个IIC接口，切勿插到其他扩展接口上。
（3）确认SDA、SCL、GND三根线的对应关系正确，不可交叉或反接。
2、检查接线牢固性
（1）确认杜邦线或排线插接牢固，无松动或虚接现象。
（2）检查线材是否有断裂或接触不良的情况。
（3）若使用转接板，确认转接板上的引脚定义与视觉模块一致。
排查二：确认视觉模块已烧录对应程序
1、分别烧录两个设备的程序
（1）给miniHexa烧录程序：按照资料文档中的步骤，将miniHexa对应的控制程序烧录到主控板中。
（2）给ESP32S3/WonderLLM视觉模块烧录程序：使用对应的烧录工具和固件文件，单独给视觉模块烧录其专属程序。下图以颜色识别例程举例：
2、【重要】WonderLLM视觉模块的编程限制
（1）WonderLLM视觉模块不能进行图形化编程。
（2）无法使用WonderCode对WonderLLM进行编程。
（3）请严格按照资料文档中提供的方式为WonderLLM烧录固件，不要尝试使用WonderCode或其他图形化编程工具。
3、烧录顺序建议
（1）先烧录视觉模块程序，确认视觉模块固件写入成功。
（2）再烧录miniHexa主控程序，确保主控板程序正常。
（3）两者均烧录完成后，重新上电，观察是否恢复正常。
四、资源下载
官方在线课程与资料库：幻尔科技官网在线教程
客服领取： 联系你购买设备的店铺客服（淘宝/京东/天猫客服），提供订单号即可免费领取最新版本的资料。
避坑提示：
1、IIC接口必须接在miniHexa的前三个IIC接口上，这是最常见的接线错误。接错接口后，无论程序是否正确，通信都无法建立。
2、miniHexa与视觉模块是两个独立设备，必须分别烧录各自的程序。很多用户只给miniHexa烧录了程序就以为万事大吉，忽略了视觉模块也需要单独烧录，这是报错的高频原因。
3、WonderLLM视觉模块不支持WonderCode图形化编程，请勿尝试用WonderCode对其进行开发或烧录，否则会出现不兼容或报错。
4、烧录视觉模块程序时，请确认使用的是资料包中提供的对应固件版本，不要使用其他来源的固件文件。
5、若接线和程序均确认无误仍报错，请检查供电是否充足，视觉模块与miniHexa同时工作时对电源有一定要求，供电不足也可能导致通信异常。