Skip to content

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.

  1. Acesse https://etcher.balena.io/
  2. Baixe a versao para o seu sistema operacional (Windows, macOS ou Linux)
  3. Instale o aplicativo

Pagina de download do Balena Etcher mostrando os botoes de download para Windows, macOS e Linux


Passo 2: Gravar a Imagem de Provisionamento no USB

  1. Insira o pendrive USB no seu computador
  2. Abra o Balena Etcher
  3. Clique em "Flash from file" (Gravar a partir de arquivo)

Tela principal do Balena Etcher com o botao "Flash from file" destacado

  1. 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.

Balena Etcher com o arquivo de imagem selecionado e "Select target" destacado

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

Dialogo de selecao de destino do Balena Etcher mostrando o pendrive USB selecionado

Verifique a unidade de destino

Certifique-se de selecionar o pendrive USB correto. Todos os dados na unidade selecionada serao apagados permanentemente.

  1. Clique em "Flash!" para comecar a gravar a imagem

Balena Etcher gravando a 22% com barra de progresso

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

Balena Etcher validando a imagem gravada

  1. Quando terminar, voce vera a mensagem "Flash Completed!"

Balena Etcher mostrando a mensagem "Flash Completed!" com marca de verificacao verde

  1. 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.

Visao geral do Orange Pi R2S mostrando a porta USB 3.0 azul, portas Ethernet e conector de energia USB-C

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 1: Orange Pi R2S iniciando pelo USB — LED vermelho de energia e um LED verde de Ethernet visiveis

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 2: Orange Pi R2S gravando eMMC — LED vermelho, LED verde da placa e dois LEDs de Ethernet (verde + ambar) visiveis

Fase 3: Pronto — O Dispositivo Desliga (~4 min)

Quando o provisionamento e concluido, o dispositivo desliga automaticamente. Todos os LEDs apagam.

Fase 3: Orange Pi R2S desligado — todos os LEDs apagados, provisionamento completo

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):

  1. Remova o pendrive USB do Orange Pi R2S
  2. 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:

  1. Iniciar a partir do armazenamento interno (~1 minuto)
  2. Conectar-se a internet via Ethernet
  3. 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:

  1. Insira o mesmo USB no proximo Orange Pi R2S
  2. Conecte Ethernet e energia
  3. Aguarde o desligamento automatico (~8 min)
  4. Remova o USB, reconecte a energia
  5. 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].