Esercizio - Creare un'applicazione Azure IoT Central

  • 8 minuti

Creare un'applicazione Azure IoT Central a cui connettere i dispositivi IoT Edge e da cui gestirli.

Tenere presente che si prevede di distribuire un dispositivo IoT Edge in ogni punto vendita per gestire i sensori locali e filtrare i dati inviati ad Azure IoT Central.

In questa unità si usa l'interfaccia della riga di comando di Azure per creare un'applicazione Azure IoT Central dal modello Applicazione personalizzata. I comandi dell'interfaccia della riga di comando vengono eseguiti nella sandbox di Azure e quindi si passa all'interfaccia utente Web dell'applicazione. Nell'interfaccia utente Web è possibile completare la configurazione aggiungendo un modello di dispositivo per il dispositivo IoT Edge.

Nota

Questo esercizio è facoltativo. Per completare questo esercizio, sarà necessario creare una sottoscrizione di Azure prima di iniziare. Se non si dispone di un account Azure o non si vuole crearne uno in questo momento, è possibile leggere le istruzioni per avere un'idea delle informazioni contenute.

Scaricare il manifesto della distribuzione

Quando si crea il modello di dispositivo per il dispositivo IoT Edge, sono necessari il manifesto della distribuzione e una definizione di interfaccia nel computer locale. Per scaricare questi file, fare clic con il pulsante destro del mouse su questi collegamenti e scegliere Salva con nome:

Ricordare il percorso in cui si salvano i file, che serviranno in seguito.

Creare e configurare l'applicazione Azure IoT Central

La procedura seguente crea un'applicazione Azure IoT Central e genera un token API da usare più avanti in questo modulo.

  1. Eseguire i comandi seguenti in Azure Cloud Shell per generare un nome univoco per l'applicazione Azure IoT Central e salvarlo in una variabile di ambiente da usare in un secondo momento:

    APP_NAME="store-manager-$RANDOM"
echo "Your application name is: $APP_NAME"

    Prendere nota del nome dell'applicazione nel caso si verifichi il timeout della shell con conseguente perdita della variabile di ambiente.

  2. Per creare un'applicazione Azure IoT Central nella sandbox, eseguire il comando seguente in Cloud Shell:

    az iot central app create \
--resource-group <rgn>[sandbox resource group name]</rgn> \
--name $APP_NAME --sku ST2 --location centralus \
--subdomain $APP_NAME --template iotc-pnp-preview \
--display-name 'Store Management'
echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"

    L'esecuzione del comando può richiedere un minuto o due.

  3. In un'altra scheda o finestra del browser passare all'URL visualizzato nell'output del comando precedente. In questa pagina dell'interfaccia utente Web viene caricato un manifesto della distribuzione IoT Edge:

    Screenshot che mostra la pagina dei manifesti della distribuzione in cui si gestiscono i manifesti della distribuzione IoT Edge nell'applicazione Azure IoT Central.

  4. Selezionare Creare un manifesto perimetrale, immettere il nome Sensore ambientale, selezionare Carica un file e quindi selezionare il file EnvironmentalSensorManifest-1-4.json scaricato in precedenza.

  5. Selezionare Avanti e quindi Crea per caricare il manifesto. Il manifesto configura tre moduli IoT Edge: edgeAgent, edgeHub e SimulatedTemperatureSensor.

  6. Selezionare quindi Modelli di dispositivo. Questa pagina dell'interfaccia utente Web è la posizione in cui si crea un modello di dispositivo:

    Screenshot che mostra la pagina dei modelli di dispositivo in cui si gestiscono i modelli nell'applicazione Azure IoT Central.

  7. Selezionare Crea un modello di dispositivo scegliere il riquadro Azure IoT Edge e quindi selezionare Avanti: Personalizza.

  8. Immettere Dispositivo perimetrale sensore ambientale come nome del modello di dispositivo. Quindi selezionare Avanti: Verifica.

  9. Selezionare Crea per creare il modello di dispositivo. Selezionare quindi Modello personalizzato per iniziare con un modello vuoto.

Il manifesto della distribuzione caricato ha un modulo denominato SimulatedTemperatureSensor con un'interfaccia denominata management. L'interfaccia management include le proprietà scrivibili SendData e SendInterval. Per aggiungere queste informazioni al nuovo modello di dispositivo, seguire questa procedura:

  1. Nella pagina del modello di dispositivo selezionare Moduli nella sezione Modello.

  2. Selezionare Importa moduli dal manifesto:

    Screenshot che mostra la pagina dei modelli di dispositivo in cui si importano le definizioni dei moduli dal manifesto della distribuzione.

  3. Selezionare il manifesto della distribuzione Sensore ambientale per importare i moduli.

Il modello di dispositivo include ora il modulo SimulatedTemperatureSensor con un'interfaccia management. L'interfaccia definisce le proprietà scrivibili SendData e SendInterval.

Il manifesto della distribuzione non include informazioni sui dati di telemetria inviati dai moduli del dispositivo. Per consentire a Azure IoT Central di creare visualizzazioni per i dati di telemetria, aggiungere un'interfaccia con le definizioni necessarie:

  1. Selezionare il modulo SimulatedTemperatureSensor e quindi selezionare + Aggiungi interfaccia ereditata. Potrebbe essere necessario selezionare il pulsante con i puntini di sospensione (...) per visualizzare questa opzione.

  2. Scegliere il riquadro Importa interfaccia e selezionare il file TelemetryInterface.json scaricato in precedenza.

    L'interfaccia Telemetry definisce i tipi di dati di telemetria machine e ambient come oggetti. L'oggetto machine include i dati di telemetria relativi a temperatura e pressione. L'oggetto ambient include i dati di telemetria relativi a temperatura e umidità. L'interfaccia include anche timeCreated come tipo di dati di telemetria DateTime.

    Screenshot che mostra l'interfaccia di telemetria nel modello di dispositivo.

Per consentire a un operatore di registrare informazioni su ogni dispositivo IoT Edge, aggiungere le Proprietà cloud seguenti al modello Dispositivo perimetrale sensore ambientale:

Nome visualizzato Nome Tipo di funzionalità Schema
Nome archivio StoreName Proprietà String
Service Date (Data assistenza) ServiceDate Proprietà Data

Screenshot che mostra le proprietà cloud nel modello di dispositivo.

Suggerimento

È necessario espandere la proprietà cloud per visualizzare l'impostazione dello schema.

Seleziona Salva per salvare le modifiche.

Per consentire a un operatore di visualizzare i dati ambientali dei punti vendita, aggiungere la visualizzazione seguente al modello di dispositivo:

  1. Per aggiungere una nuova visualizzazione, selezionare Visualizzazioni nel modello di dispositivo. Quindi scegliere il riquadro Visualizzazione del dispositivo.

    Screenshot che mostra il riquadro per la visualizzazione del dispositivo nel modello di dispositivo.

  2. Modificare il nome della visualizzazione in Visualizza dati di telemetria dispositivo IoT Edge.

  3. Selezionare Start with devices (Inizia con i dispositivi).

  4. Aggiungere i tipi di dati di telemetria ambient/temperature, humidity, machine/temperature e pressure e quindi selezionare Aggiungi riquadro.

  5. Seleziona Salva.

    Screenshot che mostra la definizione della visualizzazione dei dati di telemetria.

Per consentire all'operatore di registrare informazioni su ogni punto vendita e gestire il dispositivo, aggiungere la visualizzazione seguente al modello di dispositivo:

  1. Per aggiungere una nuova visualizzazione, selezionare Visualizzazioni nel modello di dispositivo. Quindi scegliere il riquadro Modifica dei dati del dispositivo e del cloud.

  2. Modificare il nome del modulo in Informazioni punto vendita.

  3. Selezionare le proprietà cloud Store Name (Nome punto vendita) e Service Date (Data assistenza). Fare quindi clic su Aggiungi sezione.

  4. Seleziona Salva.

    Screenshot che mostra la definizione del modulo delle proprietà cloud.

A questo punto è possibile pubblicare il modello e aggiungere un dispositivo:

  1. Nella parte superiore della pagina selezionare Pubblica e quindi nella finestra di dialogo Pubblica questo modello di dispositivo nell'applicazione selezionare Pubblica.

  2. Passare alla pagina Dispositivi nell'applicazione Azure IoT Central.

  3. Selezionare il modello Dispositivo perimetrale sensore ambientale e quindi selezionare + Nuovo.

  4. Nella finestra di dialogo Crea un nuovo dispositivo immettere store-001 come ID dispositivo. Assicurarsi che il modello di dispositivo sia Dispositivo perimetrale sensore ambientale e che Dispositivo Azure IoT Edge? sia già impostato su Sì. Selezionare quindi Sensore ambientale come manifesto perimetrale. Seleziona Crea.

Il dispositivo store-001 viene visualizzato nell'elenco dei dispositivi con lo stato Registrato.

Screenshot che mostra il dispositivo registrato nell'elenco dei dispositivi.

Controlla il tuo lavoro

  1. Nell'elenco dei dispositivi selezionare il nome del dispositivo Dispositivo perimetrale sensore ambientale - store-001. È possibile visualizzare le visualizzazioni disponibili per il dispositivo, tra cui Informazioni punto vendita e Visualizza dati di telemetria dispositivo IoT Edge.

  2. Nella parte superiore della pagina selezionare Connetti. Prendere nota dell'ID ambito e della Chiave primaria. Questi valori verranno usati in seguito per configurare il dispositivo IoT Edge per connettersi all'applicazione.

    Mantenere aperta questa pagina nel Web browser. In seguito si tornerà a questa applicazione Azure IoT Central.

È stata creata un'applicazione per gestire i negozi. È stato creato un modello di dispositivo che include un manifesto della distribuzione IoT Edge per i dispositivi che si prevede di installare nei negozi. Il modello include visualizzazioni che consentono a un operatore di monitorare le condizioni ambientali del punto vendita e di gestire i dispositivi in remoto.