# Raspberry Pi

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

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

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

Alternativamente, [compre um iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) enviado com CUBE OS a partir do site da SONOFF ou da 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 descarregar 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 tiver um kit como a caixa e a ventoinha de arrefecimento.
{% endstep %}

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

1. Um cartão micro SD (TF Card) e um leitor de cartões. Recomenda-se cartões de armazenamento com classificação mínima C10 e A1.
2. Cabo Ethernet.
3. Se precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:
4. Adaptador de energia (Alternativamente, se tiver um PoE Hat instalado, certifique-se de que o seu switch ou router de rede, bem como o cabo Ethernet, podem fornecer energia suficiente)

{% hint style="info" %}
Certifique-se de que tem um [suprimento de energia adequado](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 apenas fornecem potência total a telefones de determinados fabricantes. Portas USB em 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 %}
Descarregue e instale o Raspberry Pi Imager a partir do [site do Raspberry Pi](https://www.raspberrypi.com/software/).

<img src="https://1945363319-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://1945363319-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 operativo, escolha “Use Custom” e selecione a imagem CUBE descarregada.

<img src="https://1945363319-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://1945363319-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 utilizar.

<img src="https://1945363319-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 confrontado com opções de personalização, clique `NÃO`.

<img src="https://1945363319-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. Note que o conteúdo do cartão será sobrescrito.

<img src="https://1945363319-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é que o processo de gravação alcance 100% e ejete o cartão SD após a conclusão.

<img src="https://1945363319-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. Iniciar o Raspberry Pi e aceder ao CUBE:

{% stepper %}
{% step %}
Insira o cartão Micro SD no Raspberry Pi (no lado curto da placa perto do LED).

<img src="https://1945363319-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 %}
Ligue o Raspberry Pi a uma fonte de alimentação e ao cabo Ethernet, assegurando que está na mesma rede que o seu computador e ligado à internet.

<img src="https://1945363319-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 tiver um Dongle Zigbee, ligue-o a uma porta USB.

<img src="https://1945363319-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 %}
Depois de ligar o Raspberry Pi, aguarde alguns minutos para que inicie. Em seguida, aceda à página de gestão web usando [cube.local](http://cube.local).

<img src="https://1945363319-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 pode encontrar o IP do CUBE na interface do seu router e usá-lo para aceder à página de gestão. Normalmente, pode ver o IP ao lado do dispositivo chamado `cube`, que também tem o maior tempo restante de expiração (Leasetime remaining).

<img src="https://1945363319-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 %}
Após o acesso bem-sucedido, veja um ID curto na página de definições. Aceda posteriormente à página de gestão web do CUBE usando cube-{short id}.local, especialmente útil para distinguir vários CUBEs na mesma rede local.

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