【免费下载链接】xiaozhi-esphomeAlternative code to use xiaozhi ai devices in esphome/home assistant.项目地址https://gitcode.com/gh_mirrors/xi/xiaozhi-esphome点击查看免费下载xiaozhi-esphome项目为 ESPHome / Home Assistant 提供了 25 套现成的 YAML 设备配置让你手中的 Xiaozhi AI 语音设备如 EchoEar、Guition P4 7.0、Spotpear Ball 等直接变身 Home Assistant 的语音助手卫星。本文以通俗的方式拆解这些设备 YAML 的通用结构、Modular 模块化架构以及从 ESP32-S3 到 ESP32-P4 的硬件适配差异帮助新手快速为自己的设备找到并读懂对应配置。一、项目是做什么的Xiaozhi AI 设备接入 Home Assistantxiaozhi-esphome 的核心理念很简单把市面上便宜的 Xiaozhi AI 硬件通常只要几十美元刷成 ESPHome 固件让它作为 Home Assistant 的语音助手而不需要单独部署一套 Xiaozhi 服务端。官方 Quick Start 只有 4 步见 README.mdUSB 连接设备在 ESPHome Web 中完成 NEW DEVICE初始化并配网在 ESPHome Builder 中接管设备粘贴对应设备的 YAML保留原来的name:无线保存并安装首次可能需要 USB 刷写以更新分区表在 Home Assistant 的Devices页面接受新设备语音助手自动完成设置。项目内置了 20 多个 AI 角色形象、9 种待机时钟壁纸和多种开机提示音见 sounds/ 与 images/README.md刷完后设备会自动下载对应素材开箱即用。二、25 设备 YAML 文件都在哪里devices/ 目录结构所有设备配置集中在devices/目录按厂商/系列分子目录组织每个子目录还附带 README 说明状态与识别方法目录代表设备配置文件示例devices/Espressif/EchoEar v1.0 / v1.2echoear1.2.yamldevices/Guition/1.8 Taichi Pi (JC3636W518)Taichi Pi V1.yamldevices/Spotpear Balls/Xiaozhi Ball v1 / v2Ball_v2.yamldevices/Spotpear Muma/Muma Box / Muma HorseMuma.yamldevices/Waveshare/1.85C、2.06 手表、3.49 蓝屏ESP32-S3-Touch-LCD-1.85C.yamldevices/Xingzhi/Cube 1.54 / 1.83 双麦xingzhi-cube-1.54.yamldevices/Breadboard/DIY 面包板 / Breadboard Minibreadboard_mini.yamldevices/Under_Development/Modular/全部 25 设备的模块化新配置Guition_P4_7.0.yaml选配置的小技巧devices/厂商/下的 YAML 是单文件完整版自包含全部内容最适合作为起点Under_Development/Modular/是持续更新的模块化版本新设备会先在这里以 alpha/beta 状态出现见 Modular/README.md各子目录 README 会标注工作状态。例如 Waveshare/README.md 用绿/黄/红点标出 1.85C、2.06 手表Working、3.5 寸Partly WorkingSpotpear Balls/README.md 则提醒Ball V1/V2 底部贴纸无法区分版本需对照外观图识别Guition/README.md 特别提醒 Taichi Pi 分 V1/V2 两版硬件且没有内置喇叭需走 3.5mm 小孔外接音箱。↑ 刷入 YAML 后设备会自动下载imagemodel指定的角色图默认 Gwen待机、聆听、思考、回复各有对应表情三、逐段读懂设备 YAML从 SETTINGS 到 hardware pack以最典型的 Guition_P4_7.0.yaml 为例一份完整的设备 YAML 由 4 大块组成1. SETTINGS 配置区新手只需改这里所有设备 YAML 开头都是substitutions:变量区官方用大段注释框出## SETTINGS ##Guition_P4_7.0.yaml。常用变量变量作用示例值imagemodelAI 角色形象20 可选Gwen、Alfred、Jarvis、GLaDOS…startup_sound开机提示音Home_Connected、Computer_Readyclock_background_image待机时钟壁纸tron、chip、starrysky、wavesimagewidth/imageheight角色图分辨率400/600screenwidth/screenheight屏幕实际分辨率大屏需单独配1024/600rotate_display屏幕旋转角度0、180sensor1_entity…sensor5_entity5 个房间的人体/光照传感器实体Home Assistant 实体 ID⚠️ 注意注释里的提醒Presence 传感器变量即使不用也不要删删除会导致脚本报错IF NOT USING THESE LEAVE THEM ALONE。2. 微唤醒词micro_wake_word 决定如何叫醒它Guition_P4_7.0.yaml 中默认启用okay_nabu和hey_jarvis两个唤醒词后面用注释列出了大量可取消注释的选项alexa、hey_mycroft、自定义hey_sarah等。项目还在 MicroWakeWords/README.md 托管了.tflite模型文件内存紧张时可以减配唤醒词数量——官方已贴心地写好了注释。↑ 说出口令后micro_wake_word组件在本地触发屏幕切换到listening.png表情3. packagesModular 版本的核心架构单文件版 YAML 把 3000 行代码写在一起而 Modular 版通过packages:把配置拆成公共核心 硬件包Guition_P4_7.0.yamlpackages: core: # 所有设备共享时钟、页面、语音助手逻辑 url: https://github.com/RealDeco/xiaozhi-esphome.git ref: main files: - devices/Under_Development/Modular/core.yaml hw: # 本设备独有GPIO、屏幕、音频编解码器 files: - devices/Under_Development/Modular/HW/guition_7.0_hw.yamlcore.yaml共享逻辑包含draw_display脚本、时钟屏保、API 全屏图片服务、虚拟触摸按钮、电池电量线性校准等HW/48 个硬件包每个设备的 GPIO 接线只改这里。比如 guition_7.0_hw.yaml 里定义了 I2C 总线GPIO7/8、ES8311 音频 DAC、ES7210 麦克风 ADC、GT911 触摸控制器及手势滑动的 lambda 逻辑。这套架构的好处上游更新一次 core.yaml你只需重新编译所有设备同步升级After this, if there is an update, all you need to do is compile again。4. 时钟与壁纸闲置屏保的两种玩法Modular v1.00 之后设备闲置超时会显示时钟屏保壁纸直接从images/Other/尺寸/下载。横屏大尺寸如 P4 7.0 的 1024×600提供chip、Rolex、neonwaves等专属壁纸↑ Guition P4 7.0 默认壁纸chipclock_background_image: chip↑ 另一款科技风clock壁纸可在 Home Assistant 中通过clock_background_image变量直接切换四、硬件适配对比EchoEar、Taichi Pi 与 Guition P4 7.0同样是小智设备三代硬件在芯片、屏幕、音频链路上差异明显YAML 也随之适配维度EchoEar 1.2Guition Taichi PiGuition P4 7.0主芯片ESP32-S3240MHz32MB flashESP32-S3ESP32-P4360MHz 协处理器 ESP32-C6屏幕360×360 圆屏1.8 360×360 圆屏1024×600 MIPI 屏MSP4331 等驱动需 MIPI-SPI 支持音频I2S DAC/ADC无内置喇叭3.5mm 输出ES8311 DAC ES7210 ADCI2C触摸无无GT911interrupt_pin: GPIO21配置入口echoear1.2.yamlTaichi Pi V1.yaml / Guition_1.80_Taichi_Pi_v2.yamlGuition_P4_7.0.yamlESPHome 要求≥ 2025.9.0≥ 2026.4.0Modular≥ 2026.4.0且需 MIPI 显示驱动几个值得新手注意的适配细节ESP32-P4 家族Guition 4.3 / 7.0、Waveshare ESP32-P4-86-ETH在 guition_7.0_hw.yaml 中还声明了esp32_hosted挂载 ESP32-C6 跑 WiFi和esp_ldo调压单文件旧版里看不到这些——这也是新设备先出现在 Modular 目录的原因触摸屏才有手势逻辑hw包里的on_touch/on_releaselambda 把滑动手势转换成左右换时钟、上下换壁纸/电量动作非触摸设备如 Taichi Pi则依赖按键分辨率变量决定素材下载路径角色图路径由${imagemodel}/${imagewidth}x${imageheight}/拼出所以400x600、600x600、1024x600各尺寸目录都有对应 PNG见 images/ 目录小屏用imagesize大屏则screensize与imagesize分开设置。↑ 把imagemodel改成Alfred即可获得这位管家形象全部 20 角色见 echoear1.2.yaml 的选项注释五、新手避坑清单版本、刷机与本地调试版本要求单文件版如 echoear1.2.yaml要求 ESPHome2025.9.0Modular 版要求2026.4.0带 Sendspin 音乐功能的变体Modular/SENDSPIN/要求2026.9.0。首次刷写走 USB第一次安装会更新分区表无线 OTA 可能失败按提示Plug into this computer用 USB 刷即可之后即可无线升级。遇到问题回退Modular 目录明确建议——If you run into problems, please return to the known-working non-modular YAMLs见 Modular/README.md。本地调试想脱离 Git 远程引用本地编辑可照 README 步骤把core.yamldisplay_pages.yaml 设备hw文件拷到localtest/并把packages:改成!include本地路径。DIY 玩家devices/Breadboard/README.md 给出了 INMP441 麦克风、MAX98357 功放、GC9A01/ILI9341 屏幕的完整 GPIO 接线表与官方面包板版引脚兼容甚至可刷回 Xiaozhi 官方固件。进阶玩法Modular v1.10 起暴露了EVENTSphase id、请求/回复文本和show_fullscreen_imageAPI 动作可配合 Home_Assistant_Automations/ 里的现成自动化 YAML实现回复时联动灯光、从语音阶段改灯色等玩法。总结xiaozhi-esphome 用一份 YAML 对应一块硬件的清晰组织把 25 款 Xiaozhi 系设备的接线差异封装进了HW/硬件包新手真正要动的只有 SETTINGS 区的imagemodel、startup_sound、clock_background_image几个变量。无论你的设备是入门的 EchoEar、圆屏的 Taichi Pi还是旗舰级的 Guition P4 7.0都能在devices/目录按厂商找到对应配置编译刷机后即可作为 Home Assistant 的语音助手卫星使用。赞分享【免费下载链接】xiaozhi-esphomeAlternative code to use xiaozhi ai devices in esphome/home assistant.项目地址https://gitcode.com/gh_mirrors/xi/xiaozhi-esphome点击查看免费下载相关推荐20 款硬件适配详解ESPHome Designer 支持的 reTerminal/M5Stack/Waveshare 设备选型指南20 款硬件适配详解ESPHome Designer 支持的 reTerminal/M5Stack/Waveshare 设备选型指南 ESPHome Desxiaozhi-esp32 板卡适配指南Waveshare ESP32-P4-WIFI6-Touch-LCD-3.5 的配置、构建与硬件初始化解析xiaozhi esp32 板卡适配指南Waveshare ESP32 P4 WIFI6 Touch LCD 3.5 的配置、构建与硬件初始化解析 本文以 x人工智能AI 应用语音交互助手物联网嵌入式智能硬件MCP 服务从YAML到芯片ESPHome如何将配置文件变成智能设备代码从YAML到芯片ESPHome如何将配置文件变成智能设备代码 你是否好奇一个简单的文本配置文件是如何让ESP8266/ESP32芯片实现复杂功能的本文将揭智能家居物联网嵌入式CLI上一篇GitHub_Trending/fu/fuck-u-code奖项荣誉行业认可与评价下一篇APKLeaks 终极指南如何快速扫描APK文件中的敏感信息与漏洞创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考