Prima di iniziare

Piano: la telemetria IoT è inclusa a partire dal piano Tenuta (e in tutti i piani superiori). Se il tuo piano non la include, aprendo IoT & Automazione Cepaos ti mostra quale piano la include e il suo prezzo nel tuo mercato.
Permessi: collegare attrezzature e gateway richiede il ruolo Titolare o Admin.
Cosa colleghi: se la tua attrezzatura (o il cloud del produttore) può inviare dati via internet da sola, segui il percorso A. Se è un PLC o una macchina industriale senza connessione propria, segui il percorso B. Hai dubbi tra attrezzatura e sensore? Leggi l'articolo «Attrezzatura o sensore?» di questo centro assistenza.

Percorso A — l'attrezzatura invia già dati via internet

Apri IoT & Automazione → Attrezzature → Attrezzature connesse e clicca su + Collega attrezzatura.
Scegli il tipo di attrezzatura (pressa, pompa, imbottigliatrice, stazione meteo…) e, se proposto, il profilo del tuo modello.
Inserisci un nome che il tuo team riconosca. Produttore, posizione e ID macchina sono facoltativi; indicando il produttore, Cepaos ti suggerisce i passi di installazione.
Alla creazione, Cepaos mostra la chiave API una sola volta. In «Per il Suo tecnico» trovi l'indirizzo a cui l'attrezzatura deve inviare i dati, un messaggio di esempio per quel tipo di attrezzatura, un test rapido con curl, un file di configurazione da scaricare e un codice QR. Conserva la chiave in un posto sicuro: se la perdi non può essere mostrata di nuovo; puoi solo ruotarla (ne viene generata una nuova e la precedente smette di funzionare).
Il tuo tecnico configura l'attrezzatura per inviare ogni lettura con una POST a quell'indirizzo, con l'intestazione Authorization: Bearer seguita dalla chiave e un JSON con almeno eventType (e, se serve, value e unit).
Apri la scheda dell'attrezzatura. Finché non arriva nulla vedrai una sala d'attesa che si aggiorna da sola ogni 10 secondi; quando arriva il primo dato, compare con ora e contenuto così puoi verificare che il formato sia corretto.

Percorso B — attrezzature senza connessione propria: Cepaos Gateway

Il gateway è un Raspberry Pi o un mini-PC installato in cantina che traduce i protocolli industriali in dati che Cepaos comprende.

Prepara il dispositivo: Raspberry Pi 3 o successivo (consigliato Pi 4 con almeno 2 GB) oppure un mini-PC, con Raspberry Pi OS Lite a 64 bit o Ubuntu Server 22.04 o successivo, collegato via cavo alla rete della cantina e con accesso a internet.
Apri IoT & Automazione → Attrezzature → Gateway e clicca su Collega gateway. Inserisci un nome e, se vuoi, la posizione.
Cepaos genera un comando di installazione con un token mostrato una sola volta, valido 24 ore e consumato alla prima connessione. Incollalo nel terminale del Pi (via SSH o con tastiera e schermo). Lo script installa l'agente come servizio e lo avvia; ci vogliono circa 2 minuti.
Nella pagina del gateway lo stato passa a «Online» quando l'agente si collega. Se dopo 5 minuti non compare nulla, controlla i log sul Pi con journalctl -u cepaos-gateway -f.
Il gateway scansiona la rete ed elenca ciò che trova in «Dispositivi rilevati» (nuova scansione ogni 5 minuti). Clicca su Adotta, assegna un nome e il dispositivo diventa un'attrezzatura connessa.

Protocolli: Modbus TCP e MQTT sono già stati validati con hardware reale. Modbus RTU, OPC-UA e Siemens S7 sono implementati ma non ancora validati con hardware reale: contattaci prima di farci affidamento in produzione.

Quando arrivano i dati

Panoramica (IoT & Automazione → Attrezzature → Panoramica): lo stato di tutte le tue attrezzature a colpo d'occhio.
Scheda dell'attrezzatura: letture, storico e vista in tempo reale.
Avvisi: la campanella in alto a destra nelle pagine IoT apre il centro avvisi (comandi falliti, errori segnalati dall'attrezzatura, analisi di laboratorio fuori range, imbottigliamenti non riconciliati). Puoi segnarli come letti o risolverli.
Email: attiva «Avvisi IoT critici via email» nelle tue preferenze di notifica (Impostazioni). Le email partono solo per i nuovi avvisi critici; quelli ripetuti vengono raggruppati.

Opzionale: controllo remoto (Cantina connessa)

Per ricevere dati non serve altro. Per inviare comandi a una macchina (pausa, ripresa, avvio di un ciclo, secondo ciò che supporta) serve l'add-on Cantina connessa, che trovi in Impostazioni → Moduli con il prezzo e il pulsante per attivarlo (in alcuni piani è incluso tramite contratto con il nostro team commerciale).

La prima volta che invii a una macchina un comando a rischio medio o alto, Cepaos ti chiede di accettare l'accordo d'uso per quella macchina.
I comandi ad alto rischio non vengono eseguiti finché un secondo amministratore non li approva (oppure, se la macchina ha la sua scheda con QR, finché non si conferma la presenza fisica scansionandolo). Quelli in attesa sono in IoT & Automazione → Attrezzature → Controllo remoto.

Se qualcosa non funziona

L'attrezzatura risulta senza segnale: controlla alimentazione e rete. Se è dietro un gateway, controlla prima il gateway.
L'attrezzatura riceve l'errore 401: la chiave è errata, è stata ruotata oppure l'attrezzatura è stata archiviata.
Errore 422 o 400: il JSON non ha il formato atteso (manca eventType o non è un JSON valido). Confrontalo con il messaggio di esempio in «Per il Suo tecnico».
Errore 413: il messaggio supera gli 8 KB; invia letture più piccole.