Apparaatupdate voor Azure IoT Hub met Behulp van Azure RTOS
In dit artikel leest u hoe u de Device Update voor Azure IoT Hub-agent maakt in Azure RTOS NetX Duo. Het biedt ook eenvoudige API's voor ontwikkelaars om de Device Update-mogelijkheid in hun toepassing te integreren. Bekijk voorbeelden van belangrijke evaluatieborden voor halfgeleiders met de introductiehandleidingen voor meer informatie over het configureren, bouwen en implementeren van draadloze updates op de apparaten.
Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
Vereisten
- Toegang tot een IoT Hub-exemplaar. U wordt aangeraden een S1-laag (Standard) of hoger te gebruiken.
- Een Device Update-exemplaar en -account dat is gekoppeld aan uw IoT-hub. Volg de handleiding om een apparaatupdateaccount te maken en te koppelen als u dit nog niet eerder hebt gedaan.
Aan de slag
Elk bordspecifiek voorbeeldproject van een Azure Real-Time Operating System (RTOS) bevat code en documentatie over het gebruik van Device Update voor IoT Hub erop. U gaat het volgende doen:
- Download de bordspecifieke voorbeeldbestanden van Azure RTOS- en Device Update-voorbeelden.
- Zoek de map docs in het gedownloade voorbeeld.
- Volg in de documenten de stappen voor het voorbereiden van Azure-resources en een account en het registreren van IoT-apparaten.
- Volg de documenten om een nieuwe firmware-installatiekopie te maken en een manifest voor uw bord te importeren.
- Publiceer de installatiekopieën en het manifest van de firmware naar Device Update voor IoT Hub.
- Download het project en voer het uit op uw apparaat.
Meer informatie over Azure RTOS.
Uw apparaat taggen
Houd de apparaattoepassing actief uit de vorige stap.
Meld u aan bij de Azure Portal en ga naar de IoT-hub.
Selecteer Apparaten in het linkerdeelvenster. Zoek uw IoT-apparaat en ga naar de apparaatdubbel.
Verwijder in de apparaatdubbel alle bestaande tagwaarden voor Device Update door deze in te stellen op null.
Voeg een nieuwe tagwaarde voor Device Update toe aan het JSON-hoofdobject, zoals wordt weergegeven:
"tags": { "ADUGroup": "<CustomTagValue>" }
Een updategroep maken
Ga naar het tabblad Groepen en implementaties bovenaan de pagina.
Selecteer Groep toevoegen om een nieuwe groep te maken.
Selecteer een IoT Hub tag en Apparaatklasse in de lijst. Selecteer vervolgens Groep maken.
Nadat de groep is gemaakt, ziet u dat het updatenalevingsdiagram en de lijst met groepen zijn bijgewerkt. In de grafiek voor updatenaleving ziet u het aantal apparaten in verschillende nalevingsstatussen: Bij de laatste update, Nieuwe updates beschikbaar en Updates wordt uitgevoerd. Meer informatie over updatecompatibiliteit.
U ziet nu de zojuist gemaakte groep en eventuele beschikbare updates voor de apparaten in de nieuwe groep. Als er apparaten zijn die niet voldoen aan de apparaatklassevereisten van de groep, worden ze weergegeven in een bijbehorende ongeldige groep. Als u de best beschikbare update wilt implementeren voor de nieuwe door de gebruiker gedefinieerde groep vanuit deze weergave, selecteert u Implementeren naast de groep.
Meer informatie over het toevoegen van tags en het maken van updategroepen.
Nieuwe firmware implementeren
Nadat de groep is gemaakt, ziet u een nieuwe update beschikbaar voor uw apparaatgroep met een koppeling naar de update onder Beste update. Mogelijk moet u één keer vernieuwen. Meer informatie over updatecompatibiliteit.
Selecteer de doelgroep door de groepsnaam te selecteren. U wordt omgeleid naar de groepsdetails onder Basisprincipes van groep.
Ga naar het tabblad Huidige implementatie om de implementatie te starten. Selecteer de koppeling implementeren naast de gewenste update in de sectie Beschikbare updates . De best beschikbare update voor een bepaalde groep wordt aangeduid met de markering Beste .
Plan de implementatie om onmiddellijk of in de toekomst te beginnen. Selecteer vervolgens Maken.
Tip
Standaard zijn de begindatum en -tijd 24 uur verwijderd van uw huidige tijd. Zorg ervoor dat u een andere datum en tijd selecteert als u wilt dat de implementatie eerder begint.
Onder Implementatiedetails wordt Status ingesteld op Actief. De geïmplementeerde update is gemarkeerd met (implementeren).
Bekijk de nalevingsgrafiek om te zien dat de update nu wordt uitgevoerd.
Nadat uw apparaat is bijgewerkt, ziet u dat uw nalevingsgrafiek en implementatiegegevens zijn bijgewerkt om hetzelfde weer te geven.
De update-implementatie bewaken
Selecteer het tabblad Implementatiegeschiedenis bovenaan de pagina.
Selecteer Details naast de implementatie die u hebt gemaakt.
Selecteer Vernieuwen om de meest recente statusdetails weer te geven.
U hebt nu een geslaagde end-to-end-update van installatiekopieën voltooid met behulp van Device Update voor IoT Hub op een ingesloten Azure RTOS-apparaat.
Volgende stappen
Zie de Azure RTOS-webpagina voor meer informatie over Azure RTOS en hoe het werkt met IoT Hub.