# Raspberry Pi

{% embed url="<https://youtu.be/DKgI4VWSGUM?si=eChZLV6MoFySbS5z>" %}

{% hint style="info" %}
内存（RAM）较小的型号可能会影响性能。一个 **建议使用至少 4GB 内存的 Raspberry Pi。**

如果你没有 Raspberry Pi，可以考虑 [虚拟机](https://cube.ewelink.cc/english-zh/ru-men-zhi-nan/quickstart/xu-ni-ji/virtualbox) 安装。

或者， [购买一台 iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) 可从 SONOFF 官方网站或亚马逊购买预装 CUBE OS 的设备，如果上述选项都不可行。
{% endhint %}

## 1. 准备工作

{% stepper %}
{% step %}
访问此 [仓库](https://github.com/eWeLinkCUBE/CUBE-OS/releases/) 以下载最新镜像。
{% endstep %}

{% step %}
获取一台 [Raspberry Pi](https://amzn.to/2S0Gcl1) 并按照 Raspberry Pi 官方的说明进行准备， [指南](https://www.raspberrypi.com/documentation/computers/getting-started.html) 如果你有外壳和散热风扇等套件，请一并准备。
{% endstep %}

{% step %}
其他所需配件：

1. 一张 micro SD 卡（TF 卡）和读卡器。建议使用至少具有 C10 和 A1 评级的存储卡。
2. 以太网线。
3. 如果需要添加 Zigbee 设备，请准备一个 Zigbee 加密狗。已测试的 Zigbee 加密狗包括：
4. 电源适配器（可选：如果你安装了 PoE Hat，请确保网络交换机或路由器以及以太网线能够提供足够电力）

{% hint style="info" %}
确保你有一个 [适配的电源供应](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#power-supply) 用于 Raspberry Pi。手机充电器可能不适用，因为有些只会对特定厂商的手机提供满载电力。电脑的 USB 端口无法提供足够电力，不应使用。
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. 将 CUBE OS 写入 SD 卡

{% stepper %}
{% step %}
从 [Raspberry Pi 网站](https://www.raspberrypi.com/software/).

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F5B46Vg2xra7HWPE07VaK%2FScreenshot%202024-11-18%20at%2010.55.07.png?alt=media&#x26;token=a3871eb8-b815-4c2c-8d75-1e5c96e1bbe8" alt="" data-size="original">
{% endstep %}

{% step %}
下载并安装 Raspberry Pi Imager。

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Faspk4R2HmFtRFuoHKWSZ%2FScreenshot%202024-11-15%20at%2017.27.08.png?alt=media&#x26;token=0c249868-3a45-4092-bd06-1aae77ee2956" alt="" data-size="original">
{% endstep %}

{% step %}
打开 Raspberry Pi Imager 并选择你的 Raspberry Pi 设备。

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FRPdxJoo4RUIjS7LoSlju%2FScreenshot%202024-11-15%20at%2017.27.12.png?alt=media&#x26;token=68f3ee2c-b2cc-4ab4-b63d-a30966b60861" alt="" data-size="original">![](https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FVSEZsAF8RhxQetSQKr2l%2FScreenshot%202024-11-15%20at%2017.27.40.png?alt=media\&token=6b1a3e5f-825d-4039-98d5-8a805ac63b4f)
{% endstep %}

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

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FJf1GeNXHY34sNUkQwcKX%2FScreenshot%202024-11-15%20at%2017.27.48.png?alt=media&#x26;token=f50f39f7-bf42-4fb9-9f7a-ea0cc6e98edd" alt="" data-size="original">
{% endstep %}

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

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoaVBw3HwqvZCiZHSgfO5%2FScreenshot%202024-11-15%20at%2017.27.52.png?alt=media&#x26;token=9d3aef50-65b2-418b-bb2a-b583ba489607" alt="" data-size="original">
{% endstep %}

{% step %}
否

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FFVyczYr2WXfmIIJAkcES%2FScreenshot%202024-11-15%20at%2017.27.56.png?alt=media&#x26;token=dbec868e-06db-41e8-9f94-e6b9f1209990" alt="" data-size="original">
{% endstep %}

{% step %}
点击“下一步”以将镜像写入 SD 卡。请注意，卡内内容将被覆盖。

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoXSRA52I2y31mPWujWXc%2FScreenshot%202024-11-15%20at%2017.28.06.png?alt=media&#x26;token=b6a0ef97-904d-401e-9014-be54c13f1aed" alt="" data-size="original">
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
3\. 启动 Raspberry Pi 并访问 CUBE：

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FeG76zDQ7Do73B4AcmPHj%2FIMG_3191.JPG?alt=media&#x26;token=5ed8d8d3-5872-4705-83da-8b643fdc1ccf" alt="" data-size="original">
{% endstep %}

{% step %}
将 Micro SD 卡插入 Raspberry Pi（位于板上靠近 LED 的短侧）。

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F79Kb4vE4uFcwr6IUJaHU%2FF17ABFCB-DC06-43F1-A1D9-266A7F063FD0_1_201_a.jpeg?alt=media&#x26;token=9915c5cd-ecd6-4238-a679-917f59ff4c3e" alt="" data-size="original">
{% endstep %}

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

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fy8fbNvPTAbTykeYOhIt2%2FIMG_3192.JPG?alt=media&#x26;token=f455cc05-2d50-478b-ae2a-6fa6aeac4f8f" alt="" data-size="original">
{% endstep %}

{% step %}
可选：如果你有 Zigbee 加密狗，请将其插入 USB 端口。 [给 Raspberry Pi 供电后，等待几分钟让其完成启动。然后使用以下地址访问 Web 管理页面：](http://cube.local).

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FAihP549ni2nOMCEPJRyF%2FScreenshot%202024-11-18%20at%2011.24.57.png?alt=media&#x26;token=6176bc04-01b5-4e18-aec9-7830c149b0cf" alt="" data-size="original">

cube.local `或者你也可以从路由器界面查找 CUBE 的 IP 并使用该 IP 访问管理页面。通常你可以在名为`cube

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F86D0Dm4uHbjX61IaAJGG%2FScreenshot%202024-11-18%20at%2011.28.29.png?alt=media&#x26;token=298b1360-1267-4ca0-9e92-c4c022801501" alt="" data-size="original">
{% endstep %}

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

<img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FXJi8azaU8jWkoxymkz8K%2FScreenshot%202024-11-18%20at%2011.33.14.png?alt=media&#x26;token=eb4c5fc2-307f-41d9-b0c7-ccefb6d3ad73" alt="" data-size="original">
{% endstep %}
{% endstepper %}