Dela via

Enhetsuppdatering för Azure IoT Hub med Eclipse ThreadX

  • Artikel

Den här artikeln visar hur du skapar enhetsuppdateringen för Azure IoT Hub-agenten i Eclipse ThreadX NetX Duo. Den innehåller också enkla API:er som utvecklare kan använda för att integrera funktionen Enhetsuppdatering i sitt program. Utforska exempel på utvärderingstavlor för viktiga halvledare som innehåller kom igång-guiderna för att lära dig hur du konfigurerar, skapar och distribuerar uppdateringar via luften till enheterna.

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Förutsättningar

  • Åtkomst till en IoT Hub-instans. Vi rekommenderar att du använder en S1-nivå (Standard) eller högre.
  • En enhetsuppdateringsinstans och ett konto som är länkat till din IoT-hubb. Följ guiden för att skapa och länka ett enhetsuppdateringskonto om du inte har gjort det tidigare.

Kom igång

Varje rtos-projekt (Board Specific Sample) i Realtidsoperativsystem i Azure innehåller kod och dokumentation om hur du använder Enhetsuppdatering för IoT Hub på det. Du kommer att:

  1. Ladda ned de brädspecifika exempelfilerna från Eclipse ThreadX- och Device Update-exempel.
  2. Leta upp mappen docs från det nedladdade exemplet.
  3. I dokumenten följer du stegen för hur du förbereder Azure-resurser och ett konto och registrerar IoT-enheter till dem.
  4. Följ dokumenten för att skapa en ny avbildning av inbyggd programvara och importera manifestet för din styrelse.
  5. Publicera avbildningen av den inbyggda programvaran och manifestet till Enhetsuppdatering för IoT Hub.
  6. Ladda ned och kör projektet på enheten.

Läs mer om Eclipse ThreadX.

Tagga enheten

  1. Håll enhetsappen igång från föregående steg.

  2. Logga in på Azure-portalen och gå till IoT-hubben.

  3. Välj Enheter i det vänstra fönstret. Hitta din IoT-enhet och gå till enhetstvillingen.

  4. I enhetstvillingen tar du bort alla befintliga taggvärden för enhetsuppdatering genom att ställa in dem på null.

  5. Lägg till ett nytt taggvärde för enhetsuppdatering i JSON-rotobjektet enligt följande:

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

Visa enhetsgrupper

Enhetsuppdatering använder grupper för att organisera enheter. Enhetsuppdatering sorterar automatiskt enheter i grupper baserat på deras tilldelade taggar och kompatibilitetsegenskaper. Varje enhet tillhör bara en grupp, men grupper kan ha flera undergrupper för att sortera olika enhetsklasser.

  1. Gå till fliken Grupper och distributioner överst på sidan.

    Skärmbild som visar ogrupperade enheter.

  2. Visa listan över grupper och uppdateringskompatibilitetsdiagrammet. Diagrammet för uppdateringsefterlevnad visar antalet enheter i olika efterlevnadstillstånd: Vid den senaste uppdateringen, Nya tillgängliga uppdateringar och Uppdateringar pågår. Läs mer om uppdateringsefterlevnad.

    Skärmbild som visar vyn uppdateringsefterlevnad.

  3. Du bör se en enhetsgrupp som innehåller den simulerade enhet som du konfigurerade i den här självstudien tillsammans med eventuella tillgängliga uppdateringar för enheterna i den nya gruppen. Om det finns enheter som inte uppfyller enhetens klasskrav för gruppen visas de i en motsvarande ogiltig grupp. Om du vill distribuera den bästa tillgängliga uppdateringen till den nya användardefinierade gruppen i den här vyn väljer du Distribuera bredvid gruppen.

Mer information om taggar och grupper finns i Hantera enhetsgrupper.

Distribuera ny inbyggd programvara

  1. När gruppen har skapats bör du se en ny uppdatering som är tillgänglig för din enhetsgrupp med en länk till uppdateringen under Bästa uppdatering. Du kan behöva uppdatera en gång. Läs mer om uppdateringsefterlevnad.

  2. Välj målgruppen genom att välja gruppnamnet. Du dirigeras till gruppinformationen under Grunderna för grupp.

    Skärmbild som visar gruppinformation.

  3. Starta distributionen genom att gå till fliken Aktuell distribution . Välj distributionslänken bredvid önskad uppdatering i avsnittet Tillgängliga uppdateringar . Den bästa tillgängliga uppdateringen för en viss grupp anges med en bästa markering.

    Skärmbild som visar hur du väljer en uppdatering.

  4. Schemalägg distributionen så att den startar omedelbart eller i framtiden. Välj sedan Skapa.

    Dricks

    Som standard är startdatum och tid 24 timmar från den aktuella tiden. Se till att välja ett annat datum och en annan tid om du vill att distributionen ska börja tidigare.

    Skärmbild som visar skärmen Skapa distribution.

  5. Under Distributionsinformation övergår Status till Aktiv. Den distribuerade uppdateringen är markerad med (distribution).

    Skärmbild som visar distributionen som Aktiv.

  6. Visa efterlevnadsdiagrammet för att se att uppdateringen pågår.

  7. När enheten har uppdaterats ser du att efterlevnadsdiagrammet och distributionsinformationen har uppdaterats för att återspegla samma sak.

    Skärmbild som visar att uppdateringen lyckades.

Övervaka uppdateringsdistributionen

  1. Välj fliken Distributionshistorik överst på sidan.

    Skärmbild som visar distributionshistoriken.

  2. Välj Information bredvid den distribution som du skapade.

    Skärmbild som visar distributionsinformation.

  3. Välj Uppdatera för att visa den senaste statusinformationen.

Nu har du slutfört en lyckad avbildningsuppdatering från slutpunkt till slutpunkt med hjälp av Enhetsuppdatering för IoT Hub på en Inbäddad Eclipse ThreadX-enhet.

Nästa steg

Mer information om Eclipse ThreadX och hur det fungerar med IoT Hub finns i Eclipse ThreadX.