Utilizzo dei gateway

I gateway sono dispositivi che inviano dati allo IoT strumento, rispondono ai comandi, inviano dati dai dispositivi e trasmettono i comandi ai dispositivi.

Utilizzare i gateway per svolgere le seguenti attività:
  • Invia eventi
  • Comandi di ricezione
  • Invia eventi per conto dei dispositivi
  • Ricevere i comandi inviati ai dispositivi
  • Ricevi notifiche

Utilizzare i gateway quando si sviluppa una soluzione con più dispositivi fisici che non comunicano direttamente con lo IoT strumento, ma che invece inviano i dati a un dispositivo locale, che funge da punto di contatto centrale per lo IoT strumento.

Con questo scenario, i seguenti criteri sono veri:

  • Ogni dispositivo fisico è registrato nello IoT strumento come dispositivo, anche se non si connetterà direttamente.
  • Il gateway è il punto centrale di contatto.
  • Il gateway invia più eventi per conto dei dispositivi locali al gateway, piuttosto che rivendicare la proprietà dei dati inoltrando gli eventi come se i dati venissero dal gateway stesso.

Registrazione del gateway

Un gateway è un tipo speciale di dispositivo e deve essere registrato presso un'organizzazione prima di potersi connettere allo IoT strumento esattamente come un dispositivo normale. I dispositivi gateway registrati si identificano allo IoT strumento con un identificatore univoco composto da quattro parti:

  • ID classe ( classId).
    Questo identifica il dispositivo come gateway quando impostato su g.
  • ID organizzazione ( orgId).
    Si tratta di un identificatore univoco globale per la tua istanza, assegnato al momento della prima registrazione con lo IoT strumento.
  • Tipo ID ( typeId).
    Questo è l'ID del tipo di dispositivo gateway, univoco all'interno della propria organizzazione. Pensa a questo come analogo ad un numero di modello.
  • ID periferica ( deviceId).
    Questo è l'ID del dispositivo gateway, è univoco all'interno dei dispositivi di un solo tipo specifico. Pensa a questo come analogo ad un numero di serie.

Autenticazione del gateway

Sono supportati due metodi di autenticazione:

  • Default: autenticazione basata su token.
    Sulla registrazione di un gateway è possibile opzionalmente fornire il token di autenticazione che il gateway deve utilizzare o è possibile consentire al servizio di generarne uno per te.
  • Autenticazione certificato client.
    Per ulteriori informazioni sull'autenticazione tramite certificato client, vedere Autenticazione basata su certificato.

Connettività gateway

La connettività gateway tramite MQTT è trattata in modo esaustivo nella sezione Comunicazione con i gateway (MQTT).

Registrazione automatica del dispositivo

I dispositivi gateway possono registrare automaticamente i dispositivi ad essi collegati. Quando un gateway pubblica un messaggio o sottoscrive un argomento per conto di un dispositivo non registrato, tale dispositivo viene registrato automaticamente.

Nota: Le richieste di registrazione dai dispositivi gateway vengono throttate a 128 richieste in attesa di volta. Tentando di collegare molti nuovi dispositivi potrebbe causare un ritardo nella registrazione dei dispositivi tramite il gateway.
Nota: i dispositivi indirettamente connessi tramite un gateway non vengono visualizzati come connessi quando si utilizzano le API o i dashboard per eseguire la query dello stato di connettività del dispositivo. Solo il gateway collegato al servizio mostrerà come connesso.

Avviso: Failures di registrazione automatica

Se il gateway non riesce a registrare automaticamente un dispositivo, non tenta di registrare nuovamente quel dispositivo per un breve periodo. Eventuali messaggi o sottoscrizioni dal dispositivo non riuscito vengono sganciati in quel momento.

HTTP API per gateway

Quando tecnicamente possibile, MQTT è il metodo preferito per collegare il gateway allo IoT strumento.

Nei casi in cui MQTT non è un'opzione, è possibile utilizzare l'API di messaggistica per inviare eventi e ricevere comandi senza collegare il gateway allo IoT strumento. Per ulteriori informazioni, consultare la documentazione API locale. Per ulteriori informazioni sull'accesso alla documentazione locale, consultare API.