多功能交互模块乐鑫原厂是 ESP-Mosaico 最常用的磁吸扩展模块板载多种感知 输出外设带 AT24C02 EEPROM 自动识别Claw 固件插上即识别、自动加载驱动与 UI 面板创客语音编程首选模块。为官方磁吸扩展板板型编号0x16依托板载 AT24C02 EEPROM 实现 Claw 固件自动识别支持左槽 H2、右槽 H1 双槽安装是语音 AI 编程最常用的感知交互扩展外设。正面以下按图中标号沿顺时针方向介绍正面主要组件。背面以下按图中标号介绍背面主要组件。1、硬件总览 板载器件模块型号标识board type 0x16GL5506 光敏电阻LDR光照 ADC 采集AS312 人体红外 PIR 传感器移动检测IR 红外发射管 AO3400A 驱动管红外遥控发射6 颗 WS2812 单点 RGB 灯珠顶部 4 颗 按键下方 2 颗2 个触摸焊盘支持电容触摸也可以焊成机械按键AT24C02 EEPROMI2C用于主板自动识别模块接口2×10P 2.54mm 排针磁吸卡扣结构适配 H2 左槽 / H1 右槽2、左右插槽引脚对照表重点同一模块插左、右槽GPIO 映射完全不一样右槽必须旋转 180° 倒装否则识别失败、外设异常。供电3V3、5V、GND由主板插槽受控输出单槽最大 100mA。3、硬件参考1插槽与发现ESP-Mosaico 通过 EEPROM 地址区分左右插槽模块 I2C 使用扩展接口 SDA / SCLGPIO0 / GPIO1。CoreBoard V1.2 上该总线为对外 I2C1V1.0 上与板载器件共享同一路 I2C。2左右插槽管脚下表给出多功能交互模块在左右插槽上的信号对应关系。模块采用2×10P2.54mm 标准双排排针磁吸卡扣结构供电由主板插槽受控输出3V3、5V 单路最大输出 100mA由主板 GPIO60 统一使能开关不适合驱动大功率舵机、电机。总线说明CoreBoard V1.0扩展 I2C 与板载 IMU、音频 Codec 共用总线多模块同时挂载容易 I2C 冲突锁死CoreBoard V1.2扩展 I2C1 独立板载传感器使用 I2C0稳定性更强支持左右双交互模块同时使用。左侧模块接口电路图右侧模块接口电路图3外设说明光敏电阻 (LDR)GL5506 经 ADC 采样读数以 0–100 表示环境明暗可用于指示或调节 LED 亮度。人体感应 (PIR)AS312 输出运动检测电平。检测到人体活动时界面对应状态会点亮。红外发射 (IR)红外 LED 经 AO3400A 驱动发送 NEC 红外码8-bit 地址与命令载波 38 kHz。WS2812模块共 6 颗 WS2812可单独或一起设置颜色并限制亮度。按键与触摸KEY_L / KEY_R 共用同一对焊盘可作按键或触摸按键机械按下对地有效。触摸手指触摸焊盘即可触发按下按键同样会触发。4电源模块由主机扩展接口的 VCC_3V3 供电该电源仅在 GPIO60 置低时输出。CoreBoard V1.2 的对外 3.3 V 由独立 DCDC 产生与内部 MCU 供电隔离。5相关文档ESP-Mosaico 多功能交互模块原理图4、开始使用必备硬件ESP-MosaicoCoreBoard V1.0 或 V1.2ESP-Mosaico 多功能交互模块USB 数据线支持数据传输电脑Windows、Linux 或 macOS安装说明安装方式重点高频踩坑必须断电插拔禁止热插拔带电插拔极易造成 I2C 总线挂死、IO 口损坏。左槽 H2模块正向插入丝印方向和主板保持一致识别地址 0x50识别脚 GPIO14 拉低。右槽 H1模块整体旋转 180° 倒装识别地址 0x51识别脚 GPIO39 拉高不翻转会引脚错位、识别失败严重可短路。安装完成后上电主板 I2C 读取 EEPROM 信息校验板型 0x16识别成功后屏幕自动弹出模块控制面板。未写入该信息的模块不会被识别。支持左右插槽同时插上两块多功能交互模块两套外设独立工作、互不干扰。确认主机已关机或已关闭对外 3.3 V / 5 V 输出后将模块插入左侧或右侧模块插槽。插入右侧时请按 180° 方向安装。通过 Type-C 为 ESP-Mosaico 供电并开机。扩展 3.3 V / 5 V 仅在 GPIO60 置低时输出。使用说明识别成功后屏幕会为每个已插入的插槽提供功能入口可在环境光 (LDR)、人体感应 (PIR)、红外发射 (IR)、RGB 灯 (LED)、按键 (Key) 与触摸 (Touch) 之间切换。左右插槽可以同时使用功能互不影响。5、软件使用两种开发路线路线 AClaw AI 语音编程推荐创客教学主流无需手动写底层驱动即插即用模块识别成功后屏幕自动加载功能面板可直接在屏幕上查看光照值、PIR 状态、控制 RGB、测试红外发射、触摸按键。长按橙色 AI 键唤起 AI 语音编程直接用自然语言描述功能自动生成 Lua 代码一键部署运行。示例指令“读取光敏电阻光线低于阈值点亮彩虹 RGB”“PIR 检测到人红灯闪烁同时发射红外码打开空调”“左触摸切换灯效右触摸关闭灯光”接入 Web 控制台设备 IP在线实时查看传感器日志、调试参数、自定义红外码、保存项目为 Skill 技能包可导出分享。路线 BESP-IDF 原生底层开发绕过 EEPROM 自动识别机制直接操作 GPIO可自由使用 ADC、RMT、触摸外设驱动对应硬件WS2812 推荐使用 RMT 外设驱动。电源控制GPIO60 置位可以关断扩展槽 5V/3V3 输出用于低功耗管理。自制兼容模块可以写入对应 EEPROM 地址与板型 0x16接入 Claw 自动识别体系无 EEPROM 也可裸驱 GPIO。6、常见问题与限制要点模块识别失败优先检查是否断电插拔、右槽是否 180° 翻转其次排查主板版本V1.0 尽量不要多 I2C 模块同开EEPROM 损坏则无法自动识别只能底层裸驱。供电上限单槽 100mA仅适合传感器、小功率 RGB大功率外设必须独立外部供电。资源复用风险V1.0 主板部分扩展引脚和音频 I2S 复用如果需要麦克风、扬声器功能尽量避开复用引脚。PIR 传感器有延时人体感应触发后会保持一段时间高电平属于传感器本身特性。触摸焊盘默认裸露可贴导电胶或者焊接轻触开关使用。7、典型创客项目参考环境光自动补光灯、人体感应提醒门铃、红外万能遥控器、触摸交互小游戏、简易入侵检测告警装置。