5分钟快速上手zigbee_home CLI安装与从源码构建完整指南【免费下载链接】zigbee_homeProject to provide functionality similar to ESPHome but for Zigbee instead of WiFi for nRF52, nRF53 nRF54L项目地址: https://gitcode.com/gh_mirrors/zi/zigbee_homezigbee_home 是一个类似 ESPHome 的开源项目但它服务的不是 WiFi而是 Zigbee 协议主要面向 nRF52、nRF53 与 nRF54L 系列芯片。zigbee_home CLI 是项目的核心入口只需一份 YAML 配置文件就能自动完成源码生成、固件构建与设备刷写三大工作。这篇文章将带你用 5 分钟完成 zigbee_home CLI 安装并附上一份 zigbee_home 从源码构建的完整指南零基础也能轻松跟上。zigbee_home CLI 能做什么简单说它把写固件这件麻烦事变成了写配置。核心能力有三项✅生成源码根据zigbee.yml配置生成完整的 Zephyr 工程C 源码、proj.conf、app.overlay✅构建固件在配置好的 nRF Connect Zephyr 环境中自动编译出固件✅刷写固件支持 nrfutil、mcuboot、west、adafruit 等多种方式写入开发板目前已支持 Bosch BME280/BME680、Aosong DHT、Sensirion SCD4X 等常见传感器官方板卡支持列表见docs/supported_boards.md。安装前的环境准备在开始 zigbee_home CLI 安装之前请确认两件事安装 Go 语言版本需为 1.21.4 或更高当前仓库go.mod已要求 Go 1.24Linux 发行版自带或 macOS 的brew均可准备一块开发板如 nRF52840 Donglenrf52840dongle_nrf52840或 Arduino Nano 33 BLE详见docs/supported_boards.md方式一5分钟快速安装 CLI推荐新手如果你的目标是拿来就用推荐直接使用go install安装。官方文档docs/install_zigbee_home_cli.md中提供了go install一条命令安装方式go install zigbee_home模块路径/cmd/zigbee_homedevelop执行完成后直接运行zigbee_home命令即可使用。整个过程不超过 5 分钟不需要接触任何源码。 提示该可执行文件名为通用名zigbee_home如果担心与其他程序冲突可以改用下面的从源码构建方式。方式二zigbee_home 从源码构建完整指南这种方式适合想二次开发、调试源码的进阶用户也是了解整个项目结构的最好途径。第一步克隆源码仓库将仓库克隆到本地任意目录git clone https://gitcode.com/gh_mirrors/zi/zigbee_home.git cd zigbee_home第二步运行 CLI在仓库根目录直接运行入口程序cmd/zigbee_home/main.gogo run ./cmd/zigbee_home/... [参数]注意这种方式不会把可执行文件加入 PATH每次使用都需要执行上面的go run命令。第三步更新源码使用go run方式不会自动更新代码需要手动拉取最新内容git pull用 3 行配置创建你的第一个设备CLI 的大部分操作都依赖配置文件默认名为zigbee.yml。下面是examples/basic/zigbee.yaml中最基础的配置仅声明板卡型号即可生成固件general: board: nrf52840dongle_nrf52840如果加了传感器和刷写参数配置文件会长这样完整示例见zigbee.yml与docs/using_the_cli/configuration_file.mdgeneral: board: nrf52840dongle_nrf52840 flasher: nrfutil flasheroptions: port: /dev/ttyACM1 sensors: - type: scd4x i2c: id: i2c0生成源码与构建固件的快速方法写好后在项目目录执行--workdir指定输出目录默认是当前目录# 仅生成源码 go run ./cmd/zigbee_home/... --config ./zigbee.yml firmware --workdir ./firmware build --only-generate # 生成并构建固件 go run ./cmd/zigbee_home/... --config ./zigbee.yml firmware --workdir ./firmware build⚠️重要提醒每次build都会重新生成源码任何手动修改都会被覆盖同时build不会清空工作目录删除功能后残留文件可能导致编译失败。构建环境细节见docs/using_the_cli/building_the_firmware.md。一键刷写固件到开发板将开发板切换到 DFU/bootloader 模式后运行go run ./cmd/zigbee_home/... --config ./zigbee.yml firmware --workdir ./firmware flashCLI 会自动选择合适的刷写方式nrfutil / mcuboot / west / adafruit具体说明见docs/using_the_cli/flash_firmware.md。真实项目示例直流电源开关 ⚡安装完成后建议看看examples/board_dc_power_switch/这个完整示例——它用 Seeed XIAO-nRF52840 搭配 INA219 电流传感器和 IRLZ44N MOSFET实现了一路直流电源的开关与电流监测是理解配置→固件→实物全流程的最佳入门案例常见问题与避坑指南问题解决方案go run每次都要输长命令建议编写一个 shell 别名alias构建报错先检查zigbee.yml配置再确认 nRF Connect 环境变量是否生效想改源码加功能用源码构建方式改动集中在sensor/、zcl/、templates/目录相关文档与源码速览 想深入了解可查阅以下资料官方文档docs/install_zigbee_home_cli.md、docs/using_the_cli/index.md、docs/using_the_cli/configuration_file.md、docs/using_the_cli/building_the_firmware.md、docs/using_the_cli/flash_firmware.mdCLI 入口源码cmd/zigbee_home/main.go、cmd/zigbee_home/firmware/配置文件示例根目录zigbee.yml、examples/下各示例传感器实现sensor/目录如sensor/sensirion/scd4x.go固件模板templates/目录现在你已经掌握了 zigbee_home CLI 安装与从源码构建的完整流程去搭建你的第一个 Zigbee 设备吧【免费下载链接】zigbee_homeProject to provide functionality similar to ESPHome but for Zigbee instead of WiFi for nRF52, nRF53 nRF54L项目地址: https://gitcode.com/gh_mirrors/zi/zigbee_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
