# Raspberry Pi

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

{% hint style="info" %}
Modelos com menos memória (RAM) podem apresentar problemas de desempenho. Um **Raspberry Pi com pelo menos 4GB de memória é recomendado.**

Se você não tiver um Raspberry Pi, considere a [máquina virtual](https://cube.ewelink.cc/english-pt-br/introducao/quickstart/maquina-virtual/virtualbox) instalação.

Alternativamente, [compre um iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) enviado com o CUBE OS pelo site da SONOFF ou pela Amazon se nenhuma das opções for viável.
{% endhint %}

## 1. Preparação

{% stepper %}
{% step %}
Visite este [repositório](https://github.com/eWeLinkCUBE/CUBE-OS/releases/) para baixar a imagem mais recente.
{% endstep %}

{% step %}
Obtenha um [Raspberry Pi](https://amzn.to/2S0Gcl1) e prepare-o seguindo os [guias](https://www.raspberrypi.com/documentation/computers/getting-started.html) oficiais do Raspberry Pi se você tiver um kit como gabinete e ventilador de resfriamento.
{% endstep %}

{% step %}
Outros acessórios necessários:

1. Um cartão micro SD (TF Card) e um leitor de cartão. Recomenda-se cartões de armazenamento com pelo menos classificação C10 e A1.
2. Cabo Ethernet.
3. Se você precisar adicionar dispositivos Zigbee, prepare um dongle Zigbee. Dongles Zigbee testados incluem:
4. Adaptador de alimentação (Alternativamente, se você tiver um HAT de Power over Ethernet (PoE) instalado, certifique-se de que seu switch ou roteador de rede, bem como o cabo Ethernet, possam fornecer energia suficiente)

{% hint style="info" %}
Certifique-se de ter um [adaptador de energia apropriado](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#power-supply) para o Raspberry Pi. Carregadores de smartphone podem não ser adequados, pois alguns fornecem energia total apenas para telefones de determinados fabricantes. Portas USB de computadores não fornecem energia adequada e não devem ser usadas.
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. Gravar o CUBE OS no cartão SD

{% stepper %}
{% step %}
Baixe e instale o Raspberry Pi Imager a partir do [site do Raspberry Pi](https://www.raspberrypi.com/software/).

<img src="https://1475877759-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 %}
Abra o Raspberry Pi Imager e selecione o seu dispositivo Raspberry Pi.

<img src="https://1475877759-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 %}
Para o sistema operacional, escolha “Use Custom” e selecione a imagem do CUBE baixada.

<img src="https://1475877759-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://1475877759-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 %}
Insira o cartão SD no computador e selecione-o como o armazenamento a ser usado.

<img src="https://1475877759-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 %}
Se for solicitado a opções de personalização, clique `NÃO`.

<img src="https://1475877759-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 %}
Clique em “Next” para gravar a imagem no cartão SD. Observe que o conteúdo do cartão será sobrescrito.

<img src="https://1475877759-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 %}
Aguarde até o processo de gravação chegar a 100% e ejete o cartão SD ao concluir.

<img src="https://1475877759-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 %}

## 3. Inicializar o Raspberry Pi e acessar o CUBE:

{% stepper %}
{% step %}
Insira o cartão Micro SD no Raspberry Pi (no lado curto da placa próximo ao LED).

<img src="https://1475877759-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 %}
Conecte o Raspberry Pi a uma fonte de energia e ao cabo Ethernet, garantindo que esteja na mesma rede que seu computador e conectado à internet.

<img src="https://1475877759-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 %}
Opcional: se você tiver um dongle Zigbee, conecte-o a uma porta USB.

<img src="https://1475877759-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 %}
Após ligar o Raspberry Pi, aguarde alguns minutos para que ele inicialize. Em seguida, acesse a página de gerenciamento Web usando [cube.local](http://cube.local).

<img src="https://1475877759-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">

Ou você pode encontrar o IP do CUBE na interface do seu roteador e usá-lo para acessar a página de gerenciamento. Normalmente, você pode ver o IP ao lado do dispositivo chamado `cube`, que também tem o tempo restante de concessão (Leasetime remaining) mais longo.

<img src="https://1475877759-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 %}
Ao acessar com sucesso, visualize um ID curto na página de configurações. Após isso, acesse a página de gerenciamento Web do CUBE usando cube-{short id}.local, especialmente útil para distinguir múltiplos CUBEs na mesma rede local.

<img src="https://1475877759-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 %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/english-pt-br/introducao/quickstart/raspberry-pi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
