Connettere i Dispositivi

IronFlock supporta diversi modi per connettere i dispositivi, a seconda dell’hardware e del sistema operativo. Non hai hardware a disposizione? Puoi simulare un dispositivo sul tuo laptop in pochi minuti.

Prerequisiti

Prima di connettere un dispositivo, assicurati di avere:

Un progetto creato su IronFlock
Una voce dispositivo creata all’interno di quel progetto (clicca NUOVO DISPOSITIVO nel pannello Impostazioni -> Dispositivi del progetto.)
Il file di configurazione del dispositivo scaricato (.flock)

Prova Prima: Simula un Dispositivo sul Tuo Laptop

Non hai bisogno di hardware fisico per esplorare IronFlock. L’app FlockFlasher può eseguire l’agente IronFlock direttamente sul tuo laptop, così il tuo laptop impersona un dispositivo reale all’interno del tuo progetto — perfetto per testare app e dashboard prima di passare all’hardware vero e proprio.

Installa Docker Desktop (o Docker Engine su Linux) e assicurati che sia in esecuzione.
Scarica e installa l’app FlockFlasher per il tuo sistema operativo.
Fai doppio clic sul file .flock scaricato del tuo dispositivo — si apre in FlockFlasher e il dispositivo appare nell’elenco. (In alternativa, apri FlockFlasher e aggiungi il file tramite il pulsante +.)
Clicca Test Device (▶) sulla voce del dispositivo. FlockFlasher scarica automaticamente l’agente IronFlock al primo utilizzo e lo avvia con la configurazione del tuo dispositivo.

Il tuo laptop ora agisce come questo dispositivo all’interno del tuo progetto IronFlock: appare online e puoi installare ed eseguire app su di esso esattamente come su un dispositivo reale. Le app vengono eseguite come container Docker sul tuo laptop.

Quando hai finito, interrompi il test in FlockFlasher. In seguito potrai usare lo stesso file .flock per configurare il dispositivo reale — assicurati solo che una determinata configurazione del dispositivo venga eseguita da una sola macchina alla volta.

Metodo 1: Flash di una Scheda SD

Ideale per Raspberry Pi e altri dispositivi ARM che si avviano da schede SD.

Scarica l’app FlockFlasher per il tuo sistema operativo.
Inserisci una scheda SD (minimo 16 GB) nel computer.
Apri FlockFlasher e clicca il pulsante + per caricare il file .flock.
Seleziona l’unità della scheda SD (FlockFlasher rileva automaticamente le unità esterne).
Scegli l’immagine corretta per il tuo dispositivo (Raspberry Pi 3/4, Zero, ecc.).
Facoltativamente configura il WiFi in modo che il dispositivo possa connettersi a destinazione.
Clicca Flash e attendi il completamento di scrittura, validazione e configurazione.
Inserisci la scheda SD nel dispositivo e accendilo.

Il dispositivo dovrebbe andare online entro 20 minuti.

Avviso: Il processo di flashing cancella tutti i dati sull’unità selezionata. FlockFlasher nasconde le unità interne per impostazione predefinita, ma verifica sempre la tua selezione.

Metodo 2: Installatore USB per PC Industriali

Per dispositivi AMD64 con boot EFI (es. Siemens SIMATIC Box IPC).

Inserisci una chiavetta USB (minimo 16 GB) e apri FlockFlasher.
Carica il file .flock e seleziona l’unità USB.
Seleziona l’immagine Industrial PC x86_64 (EFI).
Clicca Flash e attendi il completamento.
Se necessario, modifica l’ordine di avvio nel BIOS del dispositivo per avviarsi da USB.
Inserisci la chiavetta USB e accendi il dispositivo.

Il dispositivo dovrebbe andare online entro 60 minuti.

Metodo 3: Installazione Personalizzata

Per dispositivi che mantengono il loro sistema operativo Linux esistente. Ideale per NVIDIA Jetson e hardware personalizzato.

Nota: Questo metodo di installazione manuale è pensato per hardware di produzione reale come PC industriali, gateway e dispositivi embedded — non per laptop. Se vuoi solo provare IronFlock sul tuo laptop, segui invece Prova Prima: Simula un Dispositivo sul Tuo Laptop — non è richiesta alcuna installazione manuale dell’agente.

Dispositivi Linux / Unix

Accedi tramite SSH al dispositivo.

Scarica il binario di installazione:


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

Copia il file .flock dal computer al dispositivo:


scp mydevice.flock user@device-ip:/home/user/

Esegui l’agente:
```
sudo ./ironflock-init -c mydevice.flock
```

Dietro un proxy aziendale? Esporta il tuo proxy prima del passo 2 affinché i download vadano a buon fine e passa --http-proxy / --https-proxy a ironflock-init nel passo 4 in modo che configuri il motore Docker per te. Consulta Dietro un Proxy Aziendale per il comando completo e i passaggi relativi alla CA aziendale.

Dispositivi Windows

Installa Docker Desktop sul dispositivo e attiva Start Docker Desktop when you sign in nelle impostazioni di Docker Desktop. Per i dispositivi non presidiati, configura anche l’accesso automatico di Windows in modo che Docker sia disponibile dopo un riavvio senza che nessuno effettui l’accesso.
Scarica reagent.exe.
Copia il file .flock sul dispositivo.
Installa e avvia l’agente come servizio Windows da un prompt dei comandi con privilegi elevati (Amministratore):
```
reagent.exe service install -config path\to\config.flock
```
Il servizio si avvia subito e poi a ogni accensione, si riavvia automaticamente in caso di errore e mantiene l’agente aggiornato. Aggiungi -noStart per installarlo senza avviarlo e controlla il suo stato in qualsiasi momento con reagent.exe service status.

Dietro un proxy aziendale? Aggiungi -proxy http://proxy.example.com:3128 al comando service install e configura il proxy di Docker Desktop in Settings → Resources → Proxies. Consulta Dietro un Proxy Aziendale per i dettagli e i passaggi per la CA aziendale.

Verifica della Connessione

Dopo la connessione, controlla lo stato del dispositivo nel tuo progetto:

Indicatore verde — Il dispositivo è online e comunica con IronFlock.
Indicatore rosso — Il dispositivo è offline. Controlla la connessione di rete e assicurati che l’agente sia in esecuzione.

La vista mappa del dispositivo mostra la posizione geografica di tutti i dispositivi nel progetto.