将行空板K10打造为Home Assistant语音助手（基于 ESPHome）

本文介绍如何将行空板K10（基于 ESPHome）也打造成Home Assistant 语音助手终端，通过Okay NABU唤醒词即可实现智能家居的语音控制。

1、ESPHome简介

ESPHome是一个用于控制ESP8266/ESP32设备的强大系统，无需编写复杂代码，仅通过YAML配置文件即可轻松定义设备功能和Home Assistant集成。

2、编辑配置

ESPHome 官方提供了适用于 ESP32-S3-BOX-3 的语音助手仓库：https://github.com/esphome/wake-word-voice-assistants，我们将官方仓库FORK到自己仓库，在此基础上新增unihiker-k10的配置。

配置核心是修改设备名称、屏幕、音频、GPIO等硬件相关配置。行空板 K10 的配置难点在于其采用了 I/O 扩展模块，需通过该模块配置实现显示屏背光开启。

# XL9535 I/O 扩展器配置
xl9535:
  - id: xl9535_hub
    address: 0x20
    i2c_id: i2c_a

output:
  # 背光输出：使用 XL9535 的 Pin 0
  - platform: gpio
    id: screen_backlight
    pin:
      xl9535: xl9535_hub
      number: 0          # 对应 P0
      mode: OUTPUT       # 必须设为输出
      inverted: false    # 非反转：写 HIGH = 开启背光
复制代码

相关代码可直接使用我已编辑完成的仓库（内含编译工作流）：https://github.com/pysn2012/wake-word-voice-assistants

3、编译固件

由于国内网络环境限制，本地编译固件易出现依赖包下载失败的问题，推荐使用 GitHub Actions workflows 进行云端编译，高效且稳定。

可参考之前的文章《基于GitHub Actions自动化工作流云端编译Micropython固件》，点击仓库页面上方的Actions选项卡，选择Build工作流，点击Run workflow触发编译。编译完成后，在工作流运行结果页面的Artifacts区域，下载对应 unihiker-k10 的固件文件即可。

编译好的固件已分享在 QQ 群962916097文件夹中。

4、烧录固件

我们使用的是ESPHOME提供的在线工具，操作简单且无需安装额外软件。

• 访问 ESPHome 在线工具：https://web.esphome.io/
• 将 unihiker-k10 开发板通过 USB 数据线连接至电脑，进入下载模式：按住 BOOT 键和 RST 键，先释放 RST 键，再释放 BOOT 键（与上一篇烧录步骤一致）
• 在在线工具页面点击CONNECT按钮，在弹出的设备列表中选择 unihiker-k10 对应的串口（如 COM12，可通过设备管理器查看）
  
  

• 连接成功后，点击页面中的INSTALL按钮，在弹出的固件选择窗口中，选择Custom firmware，上传之前编译好的固件
  
  

• 点击右下角的INSTALL开始烧录，工具会自动擦除原有固件、写入新固件
• 烧录完成后，按开发板上的 RST 键重启设备
  
  

也可以使用乐鑫官方烧录工具flash download tool。

5、网络配置

ESPHOME 官方仓库默认采用 AP 配网，可在上述在线工具页面完成配置。

• 再次点击在线工具（https://web.esphome.io/）的CONNECT，连接成功后点击右下角的三个点图标，选择Configure WIFI---->CONNECT TO WIFI
  
  

• 输入WiFi 名称和密码，设备会自动连接网络并完成初始化
  
  

也可选择手动配网：用手机或电脑连接设备发出的 WiFi 网络（名称通常为 unihiker-k10-XXXX），连接后会自动进入 WiFi 选择界面，选择你的 2.4G 网络并输入密码，即可完成设备联网。

配网完成后，打开Home Assistant，进入「设置」→「设备与服务」，系统应能自动发现unihiker-k10设备。

点击添加并完成初始设置。

此时，通过Okay NABU唤醒语音助手，发出指令（如 “打开客厅灯”“查询温度”），unihiker-k10 的屏幕会清晰显示对话内容，包括指令文本及执行结果。

由于部署了魔搭 AI 对话代理，还可与设备进行自由的语音互动。