Conectar Dispositivos

O IronFlock oferece várias maneiras de conectar dispositivos, dependendo do hardware e do sistema operacional. Não tem hardware à mão? Você pode simular um dispositivo no seu notebook em poucos minutos.

Pré-requisitos

Antes de conectar um dispositivo, certifique-se de ter:

Um projeto criado no IronFlock
Uma entrada de dispositivo criada dentro desse projeto (clique em NEW DEVICE no painel Settings -> Devices do projeto.)
O arquivo de configuração do dispositivo (.flock) baixado

Teste Primeiro: Simule um Dispositivo no Seu Notebook

Você não precisa de hardware físico para explorar o IronFlock. O app FlockFlasher pode executar o agente IronFlock diretamente no seu notebook, fazendo com que ele se passe por um dispositivo real dentro do seu projeto — perfeito para testar apps e dashboards antes de partir para o hardware de verdade.

Instale o Docker Desktop (ou o Docker Engine no Linux) e certifique-se de que ele está em execução.
Baixe e instale o app FlockFlasher para o seu SO.
Clique duas vezes no arquivo .flock baixado do seu dispositivo — ele abre no FlockFlasher e o dispositivo aparece na lista. (Alternativamente, abra o FlockFlasher e adicione o arquivo pelo botão +.)
Clique em Test Device (▶) (testar dispositivo) na entrada do dispositivo. O FlockFlasher baixa automaticamente o agente IronFlock no primeiro uso e o inicia com a configuração do seu dispositivo.

Seu notebook agora atua como esse dispositivo dentro do seu projeto IronFlock: ele aparece online, e você pode instalar e executar apps nele exatamente como em um dispositivo real. Os apps rodam como contêineres Docker no seu notebook.

Quando terminar, pare o teste no FlockFlasher. Mais tarde, você pode usar o mesmo arquivo .flock para provisionar o dispositivo real — apenas certifique-se de que somente uma máquina execute uma determinada configuração de dispositivo por vez.

Método 1: Gravar um Cartão SD

Ideal para Raspberry Pi e outros dispositivos ARM que inicializam a partir de cartões SD.

Baixe o app FlockFlasher para o seu SO.
Insira um cartão SD (16 GB no mínimo) no seu computador.
Abra o FlockFlasher e clique no botão + para carregar o arquivo .flock.
Selecione a unidade do cartão SD (o FlockFlasher detecta unidades externas automaticamente).
Escolha a imagem correta para o seu dispositivo (Raspberry Pi 3/4, Zero, etc.).
Opcionalmente, configure o WiFi para que o dispositivo possa se conectar no destino.
Clique em Flash e aguarde a conclusão da gravação, validação e configuração.
Insira o cartão SD no dispositivo e ligue-o.

O dispositivo deve ficar online em até 20 minutos.

Aviso: O processo de gravação apaga todos os dados da unidade selecionada. O FlockFlasher oculta as unidades internas por padrão, mas sempre verifique novamente a sua seleção.

Método 2: Instalador USB para PCs Industriais

Para dispositivos AMD64 com boot EFI (por exemplo, Siemens SIMATIC Box IPC).

Insira um pen drive USB (16 GB no mínimo) e abra o FlockFlasher.
Carregue o arquivo .flock e selecione a unidade USB.
Selecione a imagem Industrial PC x86_64 (EFI).
Clique em Flash e aguarde a conclusão.
Se necessário, altere a ordem de boot na BIOS do dispositivo para inicializar a partir do USB.
Insira o pen drive USB e ligue o dispositivo.

O dispositivo deve ficar online em até 60 minutos.

Método 3: Instalação Personalizada

Para dispositivos que mantêm seu sistema operacional Linux existente. Ideal para NVIDIA Jetson e hardware personalizado.

Nota: Este método de instalação manual é destinado a hardware de produção real, como PCs industriais, gateways e dispositivos embarcados — não a notebooks. Se você só quer experimentar o IronFlock no seu notebook, siga Teste Primeiro: Simule um Dispositivo no Seu Notebook — nenhuma instalação manual do agente é necessária.

Dispositivos Linux / Unix

Conecte-se ao dispositivo via SSH.

Baixe o binário de configuração:


curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash

Copie o arquivo .flock do seu computador para o dispositivo:
```
scp mydevice.flock user@device-ip:/home/user/
```
Execute o agente:
```
sudo ./ironflock-init -c mydevice.flock
```

Atrás de um proxy corporativo? Exporte seu proxy antes do passo 2 para que os downloads sejam bem-sucedidos, e passe --http-proxy / --https-proxy ao ironflock-init no passo 4 para que ele configure o Docker engine para você. Veja Atrás de um Proxy Corporativo para o comando completo e os passos da CA corporativa.

Dispositivos Windows

Instale o Docker Desktop no dispositivo e ative Start Docker Desktop when you sign in nas configurações do Docker Desktop. Para dispositivos sem supervisão, configure também o início de sessão automático do Windows para que o Docker fique disponível após uma reinicialização sem ninguém iniciar sessão.
Baixe o reagent.exe.
Copie o arquivo .flock para o dispositivo.
Instale e inicie o agente como um serviço do Windows a partir de um prompt de comando elevado (Administrador):
```
reagent.exe service install -config path\to\config.flock
```
O serviço inicia imediatamente e depois a cada arranque do sistema, reinicia automaticamente em caso de falha e mantém o agente atualizado. Adicione -noStart para instalá-lo sem iniciá-lo e verifique o estado a qualquer momento com reagent.exe service status.

Atrás de um proxy corporativo? Adicione -proxy http://proxy.example.com:3128 ao comando service install e configure o proxy do Docker Desktop em Settings → Resources → Proxies. Consulte Atrás de um Proxy Corporativo para detalhes e os passos da CA corporativa.

Verificando a Conexão

Depois de conectar, verifique o status do dispositivo no seu projeto:

Indicador verde — O dispositivo está online e se comunicando com o IronFlock.
Indicador vermelho — O dispositivo está offline. Verifique a conexão de rede e certifique-se de que o agente está em execução.

A visualização em mapa de dispositivos mostra a localização geográfica de todos os dispositivos do projeto.