Creazione di attività FUOTA e dotazione dell'immagine del firmware

Per aggiornare il firmware dei dispositivi LoRaWAN, creare innanzitutto un'attività FUOTA e fornire l'immagine del firmware, provvista di firma digitale, che si desidera utilizzare per l'aggiornamento. È quindi possibile aggiungere dispositivi e gruppi multicast all'attività e pianificare una sessione FUOTA. All'inizio della sessione, AWS IoT Core per LoRaWAN imposta una sessione di frammentazione e i dispositivi finali raccolgono i frammenti, ricostruiscono l'immagine e applicano il nuovo firmware. Per ulteriori informazioni sul processo FUOTA, consulta Panoramica del processo FUOTA.

Di seguito viene illustrato come creare un'attività FUOTA e caricare l'immagine del firmware o l'immagine delta che verrà memorizzata in un bucket S3.

Prerequisiti

Prima di poter eseguire i FUOTA, l'immagine del firmware deve essere firmata digitalmente in modo che i dispositivi finali possano verificare l'autenticità dell'immagine al momento dell'applicazione. È possibile utilizzare qualsiasi strumento di terze parti per generare la firma digitale per l'immagine del firmware. Si consiglia di utilizzare uno strumento di firma digitale come quello incorporato in ARM Mbed GitHub repository (Repository GitHub ARM Mbed), che include anche strumenti per la generazione dell'immagine delta e per i dispositivi per l'utilizzo di tale immagine.

Creazione di un'attività FUOTA e caricamento dell'immagine del firmware utilizzando la console

Per creare un'attività FUOTA e caricare l'immagine del firmware utilizzando la console, vai alla scheda FUOTA tasks (Attività FUOTA) della console e quindi scegli Create FUOTA task (Crea attività FUOTA).

1. Creazione di un'attività FUOTA

   Per creare l'attività FUOTA, specificare le proprietà e i tag dell'attività.

   1. Specificazione proprietà delle attività FUOTA

      Per specificare le proprietà delle attività FUOTA, immettere le seguenti informazioni.

      • Name (Nome): Inserire un nome univoco per l'attività FUOTA. Il nome può includere solo lettere, numeri, trattini e caratteri di sottolineatura. Non può contenere spazi.

      • Descrizione: puoi fornire una descrizione per il gruppo multicast. La descrizione può contenere fino a 2.048 caratteri.

      • RFRegion: imposta la banda di frequenza per l'attività FUOTA. La banda di frequenza deve corrispondere a quella utilizzata per effettuare il provisioning dei dispositivi wireless o dei gruppi multicast.

   2. Tag per attività FUOTA

      È inoltre possibile fornire qualsiasi coppia chiave-valore come Tag per la tua attività FUOTA. Scegliere Next (Successivo) per continuare la creazione dell'immagine.

2. Caricamento dell'immagine del firmware

   Scegliere il file immagine del firmware che si desidera utilizzare per aggiornare il firmware dei dispositivi da aggiungere all'attività FUOTA. Il file di immagine del firmware è archiviato in un bucket S3. È possibile fornire a AWS IoT Core per LoRaWAN le autorizzazioni per accedere all'immagine del firmware per tuo conto. Si consiglia di firmare digitalmente le immagini del firmware in modo da verificarne l'autenticità quando viene eseguito l'aggiornamento del firmware.

   1. Scelta del file immagine del firmware

      È possibile caricare un nuovo file immagine del firmware in un bucket S3 o scegliere un'immagine esistente già caricata in un bucket S3.

      Nota

      Il file di immagine del firmware non deve avere dimensioni superiori a 1 megabyte. Maggiore è la dimensione del firmware, maggiore sarà il tempo necessario per completare il processo di aggiornamento.

      • Per utilizzare un'immagine esistente, scegli Select an existing firmware image (Seleziona un'immagine firmware esistente), scegli Browse S3 (Sfoglia S3) e quindi scegli il file immagine del firmware che desideri utilizzare.

        AWS IoT Core per LoRaWAN popola l'URL S3, ovvero il percorso del file immagine del firmware nel bucket S3. Il formato del percorso è s3://bucket_name/file_name. Per visualizzare il file nella console Amazon Simple Storage Service, scegli View (Visualizza).

      • Per caricare una nuova immagine firmware.

        1. Scegliere Upload a new firmware image (Carica una nuova immagine del firmware) e caricare l'immagine del firmware. Il file immagine non deve essere superiore a 1 megabyte.

        2. Per creare un bucket S3 e inserire un Bucket name (Nome bucket) per memorizzare il file immagine del firmware, scegliere Create S3 bucket (Crea bucket S3).

   2. Autorizzazioni per accedere al bucket

      Puoi creare un nuovo ruolo di servizio o scegliere un ruolo esistente per permettere a AWS IoT Core per LoRaWAN di accedere al file immagine del firmware nel bucket S3 per tuo conto. Seleziona Avanti.

      Per creare un nuovo ruolo, è possibile inserire un nome di ruolo o lasciarlo vuoto per generare automaticamente un nome casuale. Per visualizzare le autorizzazioni della policy che consentono l'accesso al bucket S3, scegliere View policy permissions (Visualizza le autorizzazioni della policy).

   Per ulteriori informazioni sull'utilizzo di un bucket S3 per archiviare l'immagine e concedere a AWS IoT Core per LoRaWAN le autorizzazioni per l'accesso, vedi Caricare il file del firmware in un bucket S3 e aggiungere un ruolo IAM.

3. Rivedi e crea

   Per creare l'attività FUOTA, esaminare i dettagli di configurazione e attività FUOTA specificati e scegliere Create task (Crea attività).

Creazione di attività FUOTA e caricamento dell'immagine del firmware utilizzando l'API

Per creare un'attività FUOTA e specificare il file immagine del firmware utilizzando l'API, utilizzare l'operazione API CreateFuotaTask o il comando CLI create-fuota-task. È possibile fornire questo file input.json come input per il comando create-fuota-task. Quando si utilizza l'API o la CLI, il file immagine del firmware fornito come input deve essere già caricato in un bucket S3. È inoltre possibile specificare il ruolo IAM che fornisce a AWS IoT Core per LoRaWAN l'accesso all'immagine del firmware nel bucket S3.

aws iotwireless create-fuota-task \
    --cli-input-json file://input.json

dove:

Contenuti di input.json

{   
   "Description": "FUOTA task to update firmware of devices in multicast group.",
   "FirmwareUpdateImage": "S3:/firmware_bucket/firmware_image
   "FirmwareUpdateRole": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"
   "LoRaWAN": { 
      "RfRegion": "US915"
   },
   "Name": "FUOTA_Task_MC"  
}

Dopo aver creato l'attività FUOTA, è possibile utilizzare le seguenti operazioni API o comandi CLI per aggiornare, eliminare o ottenere informazioni sull'attività FUOTA.

• UpdateFuotaTask o update-fuota-task

• GetFuotaTask o get-fuota-task

• ListFuotaTasks o list-fuota-tasks

• DeleteFuotaTask o delete-fuota-task

Passaggi successivi

Dopo aver creato un'attività FUOTA e fornito l'immagine del firmware, è possibile aggiungere dispositivi all'attività per aggiornare il firmware. È possibile aggiungere singoli dispositivi o gruppi multicast all'attività. Per ulteriori informazioni, consultare Aggiunta di dispositivi e gruppi multicast per un'attività FUOTA e pianificazione di una sessione FUOTA.