Een toepassing op hoog niveau maken

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is door te beginnen met de lege sjabloon uit de Azure Sphere-extensie van Visual Studio Code en de configuratie aan uw project aan te passen door de volgende stappen uit te voeren:

1. Start Visual Studio Code. Selecteer Opdrachtpalet weergeven> en typ vervolgens Azure Sphere: Nieuw project genereren.

   

2. Kies HL Leeg in het menu Sjablonen.

   

3. Visual Studio Code geeft vervolgens een Bestandenverkenner-venster weer. Navigeer naar de map waarin u de lege toepassing wilt plaatsen en geef een naam op voor uw project, bijvoorbeeld NewHLApp. Visual Studio Code maakt de map NewHLApp op de geselecteerde locatie en genereert de buildbestanden voor de lege toepassing. U ziet nu berichten van CMake.

4. Open het bestand CMakeLists.txt en geef de map op die definities bevat voor de hardware die u gebruikt. Standaard bevat de HL Blank-toepassing geen hardwaredefinities. U kunt voorbeeldhardwaredefinities vinden in de opslagplaats Azure Sphere-voorbeelden of er een maken zoals beschreven in Hardwaredefinities.

   Hieronder ziet u hoe u de voorbeeldhardwaredefinities toevoegt voor de Seeed Azure Sphere MT3620 Development Kit:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Deze regel moet worden ingevoegd voordat de laatste opdracht begint azsphere_target_add_image_package.

U kunt ook een nieuwe toepassing op hoog niveau maken op een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het bestand CMakeLists.txt de naam van het project in de naam van de nieuwe map. Bijvoorbeeld:

   PROJECT(NewHLApp C)

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is door te beginnen met de lege sjabloon uit de Visual Studio Azure Sphere-extensie en de configuratie aan uw project aan te passen door de volgende stappen uit te voeren:

1. Start Visual Studio en selecteer Een nieuw project maken.

2. Typ Azure Sphere in het zoekvak met het label Zoeken naar sjablonen. Selecteer Azure Sphere HLCore Blank in de geretourneerde lijst en selecteer vervolgens Volgende.

3. Geef een projectnaam op (bijvoorbeeld NewHLApp), een projectbestandslocatie en een oplossingsnaam (die hetzelfde kan zijn als de projectnaam) en selecteer vervolgens Maken. Visual Studio maakt de map NewHLpp op de geselecteerde locatie en genereert de buildbestanden voor de lege toepassing. U ziet nu berichten van CMake.

4. Open het bestand CMakeLists.txt en geef de map op die definities bevat voor de hardware die u gebruikt. Standaard bevat de HL Blank-toepassing geen hardwaredefinities. U kunt voorbeeldhardwaredefinities vinden in de opslagplaats Azure Sphere-voorbeelden of er een maken zoals beschreven in Hardwaredefinities.

   Hieronder ziet u hoe u de voorbeeldhardwaredefinities toevoegt voor de Seeed Azure Sphere MT3620 Development Kit:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Deze regel moet worden ingevoegd voordat de laatste opdracht begint azsphere_target_add_image_package.

U kunt ook een nieuwe toepassing op hoog niveau maken op een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het bestand CMakeLists.txt de naam van het project in de naam van de nieuwe map. Bijvoorbeeld:

   PROJECT(NewHLApp C)

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is door te beginnen met een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het bestand CMakeLists.txt de naam van het project in de naam van de nieuwe map. Bijvoorbeeld:

   PROJECT(NewHLApp C)

Basisbestandsstructuur van een toepassing op hoog niveau

Ongeacht hoe u uw toepassing maakt, delen alle Azure Sphere-toepassingen de volgende kernbestanden:

• Toepassingsbroncode in een of meer bestanden. Op dit moment wordt alleen de broncode van de C-taal ondersteund.
• CMake build-bestanden. CMakeLists.txt is vereist. CMake wordt samen met het ninja lightweight build-hulpprogramma gebruikt om het buildproces van de Azure Sphere-toepassing te beheren.
• Een app-manifestbestand met een beschrijving van de mogelijkheden die beschikbaar zijn voor de toepassing.

Toepassingen op hoog niveau hebben doorgaans ten minste drie andere bestanden:

• Een bestand applibs-versions.h om de versieniveaus van verschillende Azure Sphere-API's op te geven
• Twee hardwaredefinitiebestanden (een bewerkbare versie in JSON-indeling en een C-taal bevatten een bestand dat daaruit is gegenereerd) die een handige manier bieden om te verwijzen naar hardwareonderdelen in uw code. Met een consistente set hardwaredefinitiebestanden kunt u hardwareonafhankelijke broncode schrijven en vervolgens toepassingsinstallatiekopieën bouwen voor specifieke hardware door het juiste hardwaredefinitiebestand in uw CMakeLists.txt-bestand opnieuw te richten.

Uw code schrijven

1. Schrijf uw toepassingscode met behulp van de app-voorbeelden op hoog niveau van Azure Sphere als richtlijnen. In de volgende onderwerpen worden specifieke implementatiescenario's beschreven:
   • Randapparatuur gebruiken in een toepassing op hoog niveau
   • Verbinding maken met webservices
   • WolfSSL gebruiken voor TLS-verbindingen
   • Certificaten beheren
   • Geheugengebruik begrijpen
   • Apparaatupdates uitstellen
   • Tijd beheren en de realtime klok gebruiken
   • Apparaatopslag gebruiken
   • Communiceren met een toepassing die geschikt is voor realtime
   • Power Down-status beheren
   • Energieprofielen instellen
   • Servicedetectie uitvoeren
2. In het CMakeLists.txt-bestand:
   • Revisie van Azure Sphere SDK-hulpprogramma's opgeven
   • Doel-API-set opgeven
   • De doelhardware opgeven
3. In het bestand app_manifest.json:
   • Stel in Name op de naam van uw project.
   • Voeg toepassingsspecifieke mogelijkheden toe die uw code vereist, zoals hardwareresources of verbindingen. Als de app op hoog niveau communiceert met een RTApp, voegt u de onderdeel-id van de toepassing op hoog niveau toe aan de AllowedApplicationConnections mogelijkheid.

Als u uw app op hoog niveau wilt implementeren naast een realtime compatibele partner-app, voegt u de onderdeel-id van de partner toe aan het veld partnerComponents van de sectie configuraties van het bestand launch.vs.json (Visual Studio) of .vscode/launch.json (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Zie ook

• Een toepassing op hoog niveau bouwen.
• Fouten opsporen in een toepassing op hoog niveau.