Guia de Provisionamento Orange Pi R2S¶
Configuracao Passo a Passo do Dispositivo¶
Este guia acompanha voce em todo o processo de configuracao de um dispositivo Orange Pi R2S para EmiliaVision. O processo leva aproximadamente 20 minutos no total.
Publico-alvo: Tecnicos de campo e operadores responsaveis pela instalacao de dispositivos em restaurantes. Nao e necessario conhecimento de terminal ou programacao.
Resumo¶
| Passo | Acao | Tempo |
|---|---|---|
| 1 | Baixar o Balena Etcher | 2 min |
| 2 | Gravar a imagem de provisionamento no USB | 5 min |
| 3 | Conectar o hardware | 1 min |
| 4 | Aguardar o provisionamento (automatico) | 11 min |
| 5 | Remover o USB e reconectar a energia | 1 min |
Pre-requisitos¶
Antes de comecar, certifique-se de ter:
- Orange Pi R2S (novo ou com configuracao de fabrica restaurada)
- Pendrive USB (minimo 4GB — todos os dados serao apagados)
- Cabo Ethernet conectado a um roteador com acesso a internet
- Adaptador de energia USB-C (minimo 5V / 3A)
- Computador (Windows, macOS ou Linux) para gravar o USB
- Arquivo de imagem:
orangepi-provision-exp-YYYY-MM-DD.img.xz
Verifique a Data de Expiracao da Imagem
O nome do arquivo contem a data de expiracao. Por exemplo: orangepi-provision-exp-2026-05-11.img.xz expira em 11 de maio de 2026. Se a data de hoje e posterior a data de expiracao, entre em contato com a equipe EmiliaVision para obter uma nova imagem.
Passo 1: Baixar e Instalar o Balena Etcher¶
Balena Etcher e uma ferramenta gratuita usada para gravar a imagem de provisionamento em um pendrive USB. Funciona em Windows, macOS e Linux.
- Acesse https://etcher.balena.io/
- Baixe a versao para o seu sistema operacional (Windows, macOS ou Linux)
- Instale o aplicativo

Passo 2: Gravar a Imagem de Provisionamento no USB¶
- Insira o pendrive USB no seu computador
- Abra o Balena Etcher
- Clique em "Flash from file" (Gravar a partir de arquivo)

- Selecione o arquivo de imagem (
orangepi-provision-exp-YYYY-MM-DD.img.xz)
Nao e necessario descompactar
O Balena Etcher pode gravar arquivos .img.xz diretamente. Nao descompacte o arquivo antes de gravar.

- Clique em "Select target" (Selecionar destino) e escolha seu pendrive USB

Verifique a unidade de destino
Certifique-se de selecionar o pendrive USB correto. Todos os dados na unidade selecionada serao apagados permanentemente.
- Clique em "Flash!" para comecar a gravar a imagem

- Aguarde a gravacao e validacao serem concluidas (aproximadamente 3-5 minutos)

- Quando terminar, voce vera a mensagem "Flash Completed!"

- Feche o Balena Etcher e ejete com seguranca o pendrive USB do seu computador
Passo 3: Conectar o Orange Pi R2S¶
Agora e hora de configurar o hardware. Siga estas conexoes nesta ordem exata:
3.1: Inserir o pendrive USB¶
Insira o pendrive USB gravado na porta USB 3.0 azul do Orange Pi R2S.

Use a Porta Azul
O Orange Pi R2S tem duas portas USB. Sempre use a porta USB 3.0 azul para maior velocidade de leitura durante o provisionamento.
3.2: Conectar o cabo Ethernet¶
Conecte um cabo Ethernet na porta Gigabit Ethernet (a porta mais proxima do conector de energia USB-C). A outra ponta deve ser conectada a um roteador ou switch com acesso a internet.
Internet e Necessaria
O dispositivo precisa de acesso a internet durante o provisionamento para baixar e se registrar na rede EmiliaVision. O provisionamento falhara sem uma conexao ativa com a internet.
3.3: Conectar o cabo de energia¶
Conecte o adaptador de energia USB-C na porta USB-C do Orange Pi R2S. O dispositivo sera ligado automaticamente e comecara o processo de provisionamento.
Passo 4: Aguardar a Conclusao do Provisionamento¶
Uma vez ligado, o dispositivo executa o processo de provisionamento automaticamente. Nao desconecte nada durante este tempo. O processo completo leva aproximadamente 11 minutos.
Fase 1: Inicializando (~4 min)¶
O dispositivo inicia a partir do pendrive USB. Voce vera:
- LED vermelho (energia) — fixo
- 1 LED verde na porta Ethernet — enlace de rede ativo

Fase 2: Gravando eMMC + Provisionamento (~3 min)¶
O dispositivo esta gravando a imagem do sistema operacional no armazenamento interno e se configurando. Voce vera:
- LED vermelho (energia) — fixo
- LED verde na placa — atividade de armazenamento
- 2 LEDs de Ethernet (verde + ambar) — trafego de rede

Fase 3: Pronto — O Dispositivo Desliga (~4 min)¶
Quando o provisionamento e concluido, o dispositivo desliga automaticamente. Todos os LEDs apagam.

Como saber que terminou
Todos os LEDs estao apagados. O dispositivo desligou sozinho. Tempo total desde o inicio: aproximadamente 11 minutos.
Nao Interrompa o Processo
Nao desconecte a energia, USB ou cabo Ethernet enquanto algum LED estiver aceso. Interromper o processo pode danificar o armazenamento interno do dispositivo e exigir recuperacao manual.
Passo 5: Remover USB e Reconectar Energia¶
Quando o dispositivo desligar (todos os LEDs apagados):
- Remova o pendrive USB do Orange Pi R2S
- Reconecte a energia (desconecte e reconecte o cabo USB-C)
O dispositivo agora vai iniciar a partir do armazenamento interno (eMMC) com a configuracao da EmiliaVision.
Por que remover o USB?
O Orange Pi R2S sempre tenta iniciar pelo USB primeiro. Se o USB ainda estiver inserido, ele vai executar o processo de provisionamento novamente. Sempre remova o USB antes de reconectar a energia.
Passo 6: Verificar o Dispositivo¶
Apos reconectar a energia, o dispositivo vai:
- Iniciar a partir do armazenamento interno (~1 minuto)
- Conectar-se a internet via Ethernet
- Registrar-se na rede EmiliaVision (~2 minutos)
A equipe EmiliaVision pode verificar se o dispositivo apareceu no console de administracao. Se voce precisar confirmar, entre em contato com a equipe em [email protected] informando:
- Localizacao: O nome e endereco do restaurante onde o dispositivo foi instalado
- Horario: Quando voce concluiu o provisionamento
Provisionamento de Multiplos Dispositivos¶
O mesmo pendrive USB pode ser usado para provisionar multiplos dispositivos Orange Pi R2S, um de cada vez. Cada dispositivo recebe uma identidade unica baseada no seu endereco de hardware.
Para provisionar outro dispositivo:
- Insira o mesmo USB no proximo Orange Pi R2S
- Conecte Ethernet e energia
- Aguarde o desligamento automatico (~8 min)
- Remova o USB, reconecte a energia
- Repita
Provisionamento em Lote
Voce pode gravar multiplos pendrives USB com a mesma imagem para provisionar varios dispositivos em paralelo. Cada dispositivo precisa da sua propria conexao Ethernet e adaptador de energia.
Solucao de Problemas¶
O dispositivo nao desliga apos 20 minutos¶
| Possivel causa | Solucao |
|---|---|
| Sem conexao com a internet | Verifique o cabo Ethernet e o roteador. Certifique-se de que o roteador tem internet. |
| USB nao reconhecido | Tente a outra porta USB (USB 2.0 preta). Se falhar, tente outro pendrive USB. |
| Fonte de energia insuficiente | Use um adaptador USB-C de no minimo 5V / 3A. |
O dispositivo desliga imediatamente (menos de 1 minuto)¶
| Possivel causa | Solucao |
|---|---|
| Imagem expirada | Verifique a data de expiracao no nome do arquivo. Solicite uma nova imagem a equipe. |
| USB corrompido | Grave novamente o USB usando o Balena Etcher. |
O dispositivo inicia mas nao aparece no console de administracao¶
| Possivel causa | Solucao |
|---|---|
| Sem internet na inicializacao final | Certifique-se de que o Ethernet esta conectado quando o dispositivo inicia a partir do eMMC. |
| Firewall da rede | O dispositivo precisa de acesso HTTPS de saida (porta 443). Consulte o administrador de rede. |
| Aguarde mais tempo | O dispositivo pode levar ate 5 minutos para se registrar apos iniciar. |
Diagrama de Conexao¶
┌──────────────┐
│ Internet │
└──────┬───────┘
│
┌──────┴───────┐
│ Roteador │
└──────┬───────┘
│ Ethernet
┌──────┴───────┐
Pendrive USB ────►│ Orange Pi R2S│◄─────── USB-C 5V/3A
(porta azul) │ │ (energia)
└──────────────┘
Para suporte tecnico, entre em contato com a equipe EmiliaVision em [email protected].