Aggiornamento dei dispositivi per hub IoT di Azure con Eclipse ThreadX

Questo articolo illustra come creare l'aggiornamento dei dispositivi per hub IoT di Azure agente in Eclipse ThreadX NetX Duo. Fornisce anche API semplici per gli sviluppatori per integrare la funzionalità Device Update nell'applicazione. Esplorare esempi di schede di valutazione dei semiconduttori chiave che includono le guide introduttive per informazioni su come configurare, compilare e distribuire aggiornamenti over-the-air nei dispositivi.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Prerequisiti

• Accesso a un'istanza di hub IoT. È consigliabile usare un livello S1 (Standard) o superiore.
• Un'istanza di Aggiornamento dispositivi e un account collegati all'hub IoT. Seguire la guida per creare e collegare un account di aggiornamento del dispositivo, se non è stato fatto in precedenza.

Operazioni preliminari

Ogni progetto RTOS (Board-Specific Sample Operating System) di Azure contiene codice e documentazione su come usare Aggiornamento dispositivi per hub IoT su di esso. Si eseguiranno le seguenti attività:

1. Scaricare i file di esempio specifici della scheda dagli esempi di Eclipse ThreadX e Device Update.
2. Trovare la cartella docs dall'esempio scaricato.
3. Nella documentazione seguire la procedura per preparare le risorse di Azure e un account e registrare i dispositivi IoT.
4. Seguire la documentazione per compilare una nuova immagine del firmware e importare il manifesto per la scheda.
5. Pubblicare l'immagine del firmware e il manifesto in Aggiornamento dispositivi per hub IoT.
6. Scaricare ed eseguire il progetto nel dispositivo.

Altre informazioni su Eclipse ThreadX.

Contrassegna il dispositivo

1. Mantenere l'applicazione del dispositivo in esecuzione dal passaggio precedente.

2. Accedere al portale di Azure e passare all'hub IoT.

3. Nel riquadro a sinistra selezionare Dispositivi. Trovare il dispositivo IoT e passare al dispositivo gemello.

4. Nel dispositivo gemello eliminare i valori dei tag di Aggiornamento dispositivi esistenti impostandoli su Null.

5. Aggiungere un nuovo valore del tag Device Update all'oggetto JSON radice, come illustrato di seguito:

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

Visualizzare i gruppi di dispositivi

Aggiornamento dispositivi usa i gruppi per organizzare i dispositivi. Aggiornamento dispositivi ordina automaticamente i dispositivi in gruppi in base ai tag assegnati e alle proprietà di compatibilità. Ogni dispositivo appartiene a un solo gruppo, ma i gruppi possono avere più sottogruppi per ordinare classi di dispositivi diverse.

1. Passare alla scheda Gruppi e distribuzioni nella parte superiore della pagina.

   

2. Visualizzare l'elenco dei gruppi e il grafico di conformità degli aggiornamenti. Il grafico conformità degli aggiornamenti mostra il numero di dispositivi in vari stati di conformità: aggiornamento più recente, Nuovi aggiornamenti disponibili e Aggiornamenti in corso. Informazioni sulla conformità degli aggiornamenti.

   

3. Verrà visualizzato un gruppo di dispositivi che contiene il dispositivo simulato configurato in questa esercitazione insieme agli eventuali aggiornamenti disponibili per i dispositivi nel nuovo gruppo. Se sono presenti dispositivi che non soddisfano i requisiti di classe del dispositivo del gruppo, verranno visualizzati in un gruppo non valido corrispondente. Per distribuire il miglior aggiornamento disponibile al nuovo gruppo definito dall'utente da questa visualizzazione, selezionare Distribuisci accanto al gruppo.

Per altre informazioni su tag e gruppi, vedere Gestire i gruppi di dispositivi.

Distribuire un nuovo firmware

1. Dopo aver creato il gruppo, verrà visualizzato un nuovo aggiornamento disponibile per il gruppo di dispositivi con un collegamento all'aggiornamento in Aggiornamento migliore. Potrebbe essere necessario eseguire l'aggiornamento una sola volta. Altre informazioni sulla conformità degli aggiornamenti.

2. Selezionare il gruppo di destinazione selezionando il nome del gruppo. Si viene indirizzati ai dettagli del gruppo in Nozioni di base sui gruppi.

   

3. Per avviare la distribuzione, passare alla scheda Distribuzione corrente. Selezionare il collegamento distribuisci accanto all'aggiornamento desiderato nella sezione Aggiornamenti disponibili . L'aggiornamento migliore disponibile per un determinato gruppo è indicato con un'evidenziazione migliore .

   

4. Pianificare l'avvio immediato o futuro della distribuzione. Selezionare Crea.

   Suggerimento

   Per impostazione predefinita, la data e l'ora di inizio sono 24 ore dall'ora corrente. Assicurarsi di selezionare una data e un'ora diverse se si vuole che la distribuzione inizi in precedenza.

   

5. In Dettagli distribuzione lo stato diventa Attivo. L'aggiornamento distribuito è contrassegnato con (distribuzione).

   

6. Visualizzare il grafico di conformità per verificare che l'aggiornamento sia in corso.

7. Dopo che il dispositivo è stato aggiornato correttamente, si noterà che il grafico di conformità e i dettagli della distribuzione sono stati aggiornati per riflettere lo stesso.

   

Monitorare la distribuzione degli aggiornamenti

1. Selezionare la scheda Cronologia distribuzione nella parte superiore della pagina.

   

2. Selezionare Dettagli accanto alla distribuzione creata.

   

3. Selezionare Aggiorna per visualizzare i dettagli dello stato più recenti.

A questo punto è stato completato un aggiornamento dell'immagine end-to-end con Aggiornamento dispositivi per hub IoT in un dispositivo incorporato Eclipse ThreadX.

Passaggi successivi

Per altre informazioni su Eclipse ThreadX e sul relativo funzionamento con hub IoT, vedere Eclipse ThreadX.