> 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/english-pt/primeiros-passos/quickstart/raspberry-pi.md).

# 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](/english-pt/primeiros-passos/quickstart/maquina-virtual/virtualbox.md) 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:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Outros listados](https://darkxst.github.io/silabs-firmware-builder/) pelo desenvolvedor @darkxst&#x20;

{% hint style="info" %}
Para obter mais informações sobre configurações e compatibilidade do Zigbee, consulte este [guia](/english-pt/verificacao-de-compatibilidade/zigbee.md).
{% endhint %}

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="/files/66571285293095503b502cd634a1b9974fdef383" alt="" data-size="original">
{% endstep %}

{% step %}
Abra o Raspberry Pi Imager e selecione o seu dispositivo Raspberry Pi.

<img src="/files/0d5acaac3e9d830bc150e519ad4e00c8c8a33f4f" alt="" data-size="original">
{% endstep %}

{% step %}
Para o sistema operativo, escolha “Use Custom” e selecione a imagem CUBE descarregada.

<img src="/files/5b7ca96dc7a4697e1b50739e8d580ce1f952b0f8" alt="" data-size="original">![](/files/ace9b1afc86b1d1624b6d3e19a79be185852917f)
{% endstep %}

{% step %}
Insira o cartão SD no computador e selecione-o como o armazenamento a utilizar.

<img src="/files/9ffb51814eb18b033cc9cf4b5655653e8c4b3362" alt="" data-size="original">
{% endstep %}

{% step %}
Se for confrontado com opções de personalização, clique `NÃO`.

<img src="/files/627becc40e2a685fd36c30f6fe6eeb1604b10554" 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="/files/e1580a9b9f85c934040f74bf83904ea949742c2f" 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="/files/349755c4c9dbd0eb31f3e6234388062ad36e0eb7" 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="/files/e2489fccbde5eb1326e747bcc570b671b9c8e5f4" 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="/files/fb4ebfa5f1a9932db8b37fe77dbbd2dd50f124fb" alt="" data-size="original">
{% endstep %}

{% step %}
Opcional: Se tiver um Dongle Zigbee, ligue-o a uma porta USB.

<img src="/files/a4451c70bacf2943b1d831707c95044cf99db8b2" 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="/files/7f0004342f30de295ed7fbe4d4c4e08443fdebe4" 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="/files/800ca8c4556f4e8950a46af5d862130ee7337b91" 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="/files/0ce1ee1c5645c22482d3dda7fb6223fcc03d6c12" 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 dynamically by asking a question.

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

```
GET https://cube.ewelink.cc/english-pt/primeiros-passos/quickstart/raspberry-pi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.