> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/cube-os-ru/nachalo-raboty/quickstart/raspberry-pi.md).

# Raspberry Pi

Руководство по установке CUBE OS на Raspberry Pi 4B/5.

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

{% hint style="info" %}
Модели с меньшим объёмом памяти (ОЗУ) могут испытывать проблемы с производительностью. Рекомендуется **Raspberry Pi с не менее чем 4 ГБ памяти.**

Если у вас нет Raspberry Pi, рассмотрите [виртуальную машину](https://cube.ewelink.cc/cube-os-ru/nachalo-raboty/quickstart/virtualnaya-mashina/virtualbox.md) установку.

В качестве альтернативы, [приобретите iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) доставляемый с CUBE OS с сайта SONOFF или Amazon, если ни один из вариантов невозможен.
{% endhint %}

## 1. Подготовка

{% stepper %}
{% step %}
Посетите этот [репозиторий](https://github.com/eWeLinkCUBE/CUBE-OS/releases/) чтобы скачать последнюю сборку.
{% endstep %}

{% step %}
Получите [Raspberry Pi](https://amzn.to/2S0Gcl1) и подготовьте его, следуя официальным [руководствам](https://www.raspberrypi.com/documentation/computers/getting-started.html) если у вас есть комплект, такой как корпус и вентилятор охлаждения.
{% endstep %}

{% step %}
Другие необходимые аксессуары:

1. Карта micro SD (TF Card) и кардридер. Рекомендуются карты памяти с рейтингом не ниже C10 и A1.
2. Патч-корд Ethernet.
3. Если вам нужно добавить Zigbee-устройства, подготовьте Zigbee-донгл. Проверенные Zigbee-донглы включают:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Другие перечислены](https://darkxst.github.io/silabs-firmware-builder/) от разработчика @darkxst&#x20;

{% hint style="info" %}
Для получения дополнительной информации о конфигурациях и совместимости Zigbee, пожалуйста, обратитесь к этому [руководству](https://cube.ewelink.cc/cube-os-ru/proverka-sovmestimosti/zigbee.md).
{% endhint %}

4. Адаптер питания (В качестве альтернативы, если установлен PoE Hat, убедитесь, что ваш сетевой коммутатор или роутер, а также Ethernet-кабель могут обеспечивать достаточную мощность)

{% 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 Imager с [сайта Raspberry Pi](https://www.raspberrypi.com/software/).

<img src="https://610313518-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&amp;token=a3871eb8-b815-4c2c-8d75-1e5c96e1bbe8" alt="" data-size="original">
{% endstep %}

{% step %}
Откройте Raspberry Pi Imager и выберите вашу модель Raspberry Pi.

<img src="https://610313518-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&amp;token=0c249868-3a45-4092-bd06-1aae77ee2956" alt="" data-size="original">
{% endstep %}

{% step %}
Для операционной системы выберите «Use Custom» и укажите скачанный образ CUBE.

<img src="https://610313518-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&amp;token=68f3ee2c-b2cc-4ab4-b63d-a30966b60861" alt="" data-size="original">![](https://610313518-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 %}
Вставьте SD-карту в компьютер и выберите её как носитель для записи.

<img src="https://610313518-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&amp;token=f50f39f7-bf42-4fb9-9f7a-ea0cc6e98edd" alt="" data-size="original">
{% endstep %}

{% step %}
Если появятся опции настройки, нажмите `НЕТ`.

<img src="https://610313518-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&amp;token=9d3aef50-65b2-418b-bb2a-b583ba489607" alt="" data-size="original">
{% endstep %}

{% step %}
Нажмите «Далее», чтобы записать образ на SD-карту. Обратите внимание, что содержимое карты будет перезаписано.

<img src="https://610313518-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&amp;token=dbec868e-06db-41e8-9f94-e6b9f1209990" alt="" data-size="original">
{% endstep %}

{% step %}
Дождитесь, пока процесс записи не достигнет 100%, и извлеките SD-карту по завершении.

<img src="https://610313518-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&amp;token=b6a0ef97-904d-401e-9014-be54c13f1aed" alt="" data-size="original">
{% endstep %}
{% endstepper %}

## 3. Загрузка Raspberry Pi и доступ к CUBE:

{% stepper %}
{% step %}
Вставьте Micro SD-карту в Raspberry Pi (с короткой стороны платы рядом со светодиодом).

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

{% step %}
Подключите Raspberry Pi к источнику питания и Ethernet-кабелю, убедившись, что он находится в той же сети, что и ваш компьютер, и имеет доступ в интернет.

<img src="https://610313518-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&amp;token=9915c5cd-ecd6-4238-a679-917f59ff4c3e" alt="" data-size="original">
{% endstep %}

{% step %}
Опционально: если у вас есть Zigbee-донгл, подключите его к USB-порту.

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

{% step %}
После подачи питания на Raspberry Pi подождите несколько минут, пока он загрузится. Затем зайдите на страницу веб-управления, используя [cube.local](http://cube.local).

<img src="https://610313518-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&amp;token=6176bc04-01b5-4e18-aec9-7830c149b0cf" alt="" data-size="original">

Или вы можете найти IP CUBE через интерфейс вашего роутера и использовать его для доступа к странице управления. Обычно IP отображается рядом с устройством с именем `cube`, у которого также самое долгое оставшееся время аренды (Leasetime remaining).

<img src="https://610313518-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&amp;token=298b1360-1267-4ca0-9e92-c4c022801501" alt="" data-size="original">
{% endstep %}

{% step %}
После успешного доступа на странице настроек вы увидите короткий идентификатор. В дальнейшем заходите на веб-страницу управления CUBE, используя cube-{short id}.local, что особенно удобно для различения нескольких CUBE в одной локальной сети.

<img src="https://610313518-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&amp;token=eb4c5fc2-307f-41d9-b0c7-ccefb6d3ad73" alt="" data-size="original">
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cube.ewelink.cc/cube-os-ru/nachalo-raboty/quickstart/raspberry-pi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
