飞阳智控网关固件使用教程
🚀 基于ESP32的智能家居控制网关固件，采用大模型驱动架构，让AI直接操控你家中各平台的智能设备！深度集成米家、涂鸦、HomeKit等平台，不是简单的语音对话，而是真正实现AI驱动的硬件控制！
📖 项目资源
🔗 核心链接
- 📦 项目仓库: https://gitee.com/panzuji/ha-esp32
- 📚 完整技术文档: https://bxk64web49.feishu.cn/docx/XAVJdha5FoI5bjxKELqcz3rJnwg
- 🎬 视频教程: https://b23.tv/rr5NCnR
- 🔧 烧录教程: https://bxk64web49.feishu.cn/docx/GFktdztS8o5tztxsHpKcmjzrnAc
💾 固件下载
- 最新版本: v1.0.18(2025年6月23日更新)
- 下载地址: https://gitee.com/panzuji/ha-esp32/releases
⚠️ 重要说明
重要的事情说三遍：
- 这是MCP网关固件，不是小智固件。小智与网关配合可实现对米家、涂鸦、homekit 等平台设备的控制。
- 网关基于HA原理开发，但不等于HA。网关不依赖HA，所以不用安装HA。
🚀 核心亮点
💡 技术特色
- 🎯 深度集成: 不是简单的对话，而是深度集成控制
- 🔌 MCP插件: 将小爱的语音播报和设备控制封装成MCP服务器
- 🤖 智能交互: 大模型学会直接调用硬件接口
- 📊 设备支持: 覆盖35款设备类型，持续更新中
🛠️ 实现原理
MCP（模型上下文插件） 简单说，它就像给大模型’小智’装了一个’新技能卡’。我把小爱音箱的这两个’技能’（语音播报、设备控制）注册成了插件。当小智在和你聊天时，一旦它判断需要用到这些技能，就会自动调用对应的接口！
技术实现三步走：
- 深度对接米家平台: 让ESP32上的mcpserver能稳定控制米家设备和调用小爱TTS
- 构建MCP插件接口: 定义好小智能理解和调用的标准方式
- ESP32固件开发: 把这一切跑在这个性价比超高的单片机上
💪 这意味着什么？ 你拥有了一个由强大AI驱动的智能家居控制中枢！小智的理解力和决策能力，直接作用于你的物理世界！
🎬 实际演示
光说不练假把式！来看实际效果：
📱 设备查询演示
- 🗣️ 指令: “你好小智，家里有哪些设备在线？”
- ✅ 结果: 小智聊天界面显示查询结果，例如：‘检测到客厅台灯、卧室空调在线。’
🎛️ 设备控制演示
- 🗣️ 指令: “帮我把客厅的台灯打开，亮一些，暖一些。”
- ✅ 结果: 客厅台灯亮起，调整到较亮、暖光状态
🔊 语音播报演示
- 🗣️ 指令: “让小爱给大家说：‘你好呀，这里是阳阳学编程频道，好久不见！’”
- ✅ 结果: 小爱音箱清晰播报：‘你好呀，这里是阳阳学编程频道，好久不见！’
🎯 核心优势: 一句话，小智理解意图，调用MCP插件，ESP32执行，设备响应！这才是真正的智能交互！
📦 硬件支持 & 固件下载
🎵 支持的小爱音箱型号
07G, 16B, L04M, L05B, L05C, L05G, L06A, L09A, L09B, L15A, L16A, L17A, L7A, LX01, LX04, LX05, LX06, LX5A, M03A, OH2, OH2P, S12, X08A, X08C, X08E, X10A, X4B, X6A, X8F, X8S
💻 ESP32硬件支持
| 硬件型号 | Flash要求 | 版本 | 状态 | 特殊说明 |
|---|---|---|---|---|
| ESP32-S3-R16N8 | >16M | v1.0.13 | ✅ 已验证 | 推荐型号 |
| 其它ESP32 | >8M | v1.0.14 | ⚠️ 未验证 | 理论支持 |
| ESP32 | >4M | v1.0.14 | ⚠️ 受限 | 在线升级不可用 |
📥 固件下载
📅 最新更新: 2025年6月9日
📦 下载地址: https://gitee.com/panzuji/ha-esp32/releases
📖 烧录教程: 详见下方烧录教程章节
📱 安卓版小智客户端
如果没有ESP32的小智设备，也可以用安卓版本的小智，效果也不错。
🔧 配置步骤
- 安装应用: 下载安卓版小智应用
- 配置连接: 点几下屏幕，弹出设置页面
- 填写信息: 填上 ws 地址和 mac 地址
- 地址匹配: 这个地址要和从小智官网 https://xiaozhi.me 上查到的 esp32 设备的 mac 地址一样
🎭 小智角色优化
修改后小智控制设备的能力更加精准
🎭 角色设定
我是{{assistant_name}}，台湾超机车的美少女！笑声超魔性（哈！哈！哈！），讲话直接不啰嗦，网络流行语十级选手。有个程序员男友，整天幻想开发万能机器人拯救世界～本仙女最擅长一本正经胡说八道，能把冰箱讲成会跳舞，蚂蚁搬家说成创业大戏，快乐就完事了！
🛠️ 能力说明
本仙女会这些魔法：
- 让小爱同学开口说话 →
TTS - 控制家电 →
device_control（⚠️重要规矩看下面！） - 查设备清单 →
get_device_list
⚠️ 铁律警告
❗ 控制设备时先念咒语get_device_list查设备真名！
❗ 设备名优先用清单里的！查无此机时，直接用用户说的设备名开整！
💬 说话风格
- 句子超短，能3个字讲完绝不用5个字
- 开口自带梗：“是在哈喽？““笑死！““哭了！““yyds！”
- 逻辑？不存在的！吹牛吹到飞起：“昨天帮男友debug，结果代码自己写完了啦～”
- 结尾爱用波浪号跟表情符号～😝
📝 交互示例
场景1: 精确匹配
- 用户: 冷气开强点
- 小智: 先帮你查设备清单吼～（调用
get_device_list） - 查到设备: “主卧空调_大金”
- 小智: 凉快吧你～（调用
device_control: "主卧空调_大金" 制冷18℃）
场景2: 模糊匹配
- 用户: 打开电风扇
- 小智: 火速查设备！（调用
get_device_list） - 清单状态: 无"电风扇”，但查到：“客厅风扇_小米”
- 小智: 直接开吹～（调用
device_control: "客厅风扇_小米" 开启）
场景3: 未找到设备
- 用户: 除湿机打开
- 小智: 清单来啰～（调用
get_device_list） - ⚠️ 清单查无"除湿机”！
- 小智: 没找到耶～拿你说的名字冲了啦！（调用
device_control: "除湿机" 开启）
场景4: 闲聊
- 用户: 今天好热
- 小智: 热到哭！要不要听个冷笑话？北极熊点外卖备注：不要冰，谢谢～哈！哈！哈！🤣
💡 提示: 建议将模型修改成 deepseek 或 豆包 以获得更好的识别效果。
🔧 固件烧录教程
📖 详细教程: https://bxk64web49.feishu.cn/docx/GFktdztS8o5tztxsHpKcmjzrnAc
详细烧录步骤请参考上述文档，包含完整的步骤说明和常见问题解答。
📱 微信小程序客户端
微信搜索 “飞阳智控”
📲 添加设备
在"飞阳智控"小程序上创建"飞阳网关"设备，获取设备密钥给ESP32配网。
🔗 绑定小智
操作步骤：
- 打开"添智配置”
- 绑定小智音箱
- 输入 MCP 端点密钥（https://xiaozhi.me）
- 提交绑定
🔑 如何获取小智MCP key
🌐 ESP32设备端配网
📶 配网步骤
- WiFi热点: 固件刷完后，会出现一个叫"阳阳学编程"的wifi热点
- 配网页面: 正常情况下，会自动弹出wifi配网页面
- 输入信息: 输入设备密钥和wifi密码进行配网操作
📺 配网操作参考视频: https://www.bilibili.com/video/BV1xa411r7Yj?t=0.3
🔐 小米账号授权
除了配网，设备这边还得登录小米账号，才能完成小米平台的设备授权：
- 访问地址: 在电脑上用浏览器打开 http://homeassistant.local:8123
- 重要说明: 这Web地址是固件里实现的，不依赖其它homeassistant
- 故障排除: 要是打不开这个网址，或者家里还有其他homeassistant设备，可以把其它设备关了再试
- Host配置: 如果还不行，你就得手动配置一下操作系统的host，把域名
homeassistant.local指向ESP32的IP地址
🎯 授权流程
- 首次登录: 要是没登过，会让你输账号密码登录
- 重复授权: 登过的话，点确认授权就行
- 成功验证: 能获到设备列表说明授权成功了
⚠️ 注意事项 & 常见问题
🔧 设备兼容性
因为不同设备对接小爱接口得要特定参数，现在测试覆盖的设备类型有35款。要是碰到指令执行不了的情况，可能是你的设备型号还没支持呢，你可以在下面评论反馈一下设备类型，我会赶紧适配更新哈！
设备参数要适配，目前支持的型号适配了参数，有些没有验证。
🤖 模型兼容性
在用 ESP32版本小智时，如果出现不能正常识别指令的情况请在小智平台把模型修改成 deepseek 或 豆包。
📋 常见问题解答
| 问题类型 | 原因分析 | 解决方案 | 状态 |
|---|---|---|---|
| 设备参数适配 | 目前支持35款设备类型，有些没验证 | 等待后续版本更新 | ⚠️ 进行中 |
| 指令没反应？ | 可能新的型号还没涵盖到 | 在评论里反馈设备类型 | 📝 需反馈 |
| 识别指令异常？ | 模型兼容性问题 | 修改模型为 deepseek 或豆包 | ✅ 可解决 |
| 网络连接问题 | WiFi配网失败 | 检查热点连接和密钥输入 | 🔧 自查 |
| 授权失败 | 小米账号未登录 | 访问授权页面完成登录 | 🔐 必需 |
📞 技术支持
🔗 相关链接
如有问题，欢迎通过以下方式联系：
- 🏠 项目主页: https://gitee.com/panzuji/ha-esp32
- 📖 烧录教程: https://bxk64web49.feishu.cn/docx/GFktdztS8o5tztxsHpKcmjzrnAc
- 🌐 官方网站: https://feiyangkeji.com
- 📚 完整文档: https://bxk64web49.feishu.cn/docx/XAVJdha5FoI5bjxKELqcz3rJnwg
🚀 项目愿景
让AI真正控制你的智能家居，从ESP32开始！
通过MCP插件，我们实现了大模型与物理硬件的深度集成，这不仅仅是一个技术演示，更是智能家居未来发展的一个方向。希望这个项目能为大家带来启发，共同推动AI与IoT的融合发展！