树莓派

在 Raspberry Pi 4B/5 上安装 CUBE OS 的指南。

内存（RAM）较小的型号可能会影响性能。一个 建议使用至少4GB内存的Raspberry Pi。

如果你没有Raspberry Pi，可以考虑 虚拟机 安装。

或者， 购买一台 iHost 如果上述两种选择都不可行，可从SONOFF官网或亚马逊购买预装CUBE OS的设备。

1. 准备工作

1

访问此 仓库 以下载最新镜像。

2

获取一台 Raspberry Pi 并按Raspberry Pi官方 指南 准备好，如果你有外壳和散热风扇等套件。

3

其他所需配件：

1. 一张micro SD卡（TF卡）和读卡器。建议使用至少具备C10和A1等级的存储卡。

2. 以太网线。

3. 如果需要添加 Zigbee 设备，请准备一个 Zigbee 加密狗。已测试的 Zigbee 加密狗包括：

SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P 其他列出项 由开发者 @darkxst 提供

有关 Zigbee 配置和兼容性的更多信息，请参阅此 指南.

1. 电源适配器（或者，如果你安装了PoE HAT，请确保你的网络交换机或路由器以及以太网线能够提供足够的电力）

确保你有一个 适配的电源 用于Raspberry Pi。手机充电器可能不适合，因为有些仅能为特定厂商的手机提供满功率。电脑上的USB端口无法提供足够电力，不应使用。

2. 将 CUBE OS 写入 SD 卡

1

从 Raspberry Pi 网站.

2

下载并安装 Raspberry Pi Imager。

3

打开 Raspberry Pi Imager 并选择你的 Raspberry Pi 设备。

4

在操作系统选项中，选择“Use Custom（使用自定义）”，并选择下载的 CUBE 镜像。

5

将 SD 卡插入电脑并选择其作为要使用的存储设备。 如果出现自定义选项提示，点击.

6

否

7

点击“下一步”将镜像写入 SD 卡。注意卡内内容将被覆盖。

等待写入过程完成至100%，完成后弹出 SD 卡。

1

3. 启动 Raspberry Pi 并访问 CUBE：

2

将 Micro SD 卡插入 Raspberry Pi（板上靠近LED的短边）。

3

将 Raspberry Pi 连接到电源和以太网线，确保它与电脑在同一网络且已连接互联网。

4

可选：如果你有 Zigbee 加密狗，请将其插入 USB 端口。 cube.local.

开机后，等待几分钟让 Raspberry Pi 启动。然后使用以下方式访问 Web 管理页面 或者你可以在路由器界面找到 CUBE 的 IP 并使用该 IP 访问管理页面。通常你可以在名为cube

5

的设备旁看到该 IP，且该设备通常具有最长的剩余租约时间（Leasetime remaining）。在成功访问后，可在设置页面上查看一个短 ID。随后使用 cube-{short id}.local 访问 CUBE Web 管理页面，这在同一局域网中区分多个 CUBE 时尤其有用。