Vytvoření aplikace vysoké úrovně

Důležité

Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.

Nejjednodušší způsob, jak vytvořit novou aplikaci vysoké úrovně, je začít s prázdnou šablonou z rozšíření Visual Studio Code Azure Sphere a upravit konfiguraci projektu pomocí následujícího postupu:

1. Spusťte Visual Studio Code. Vyberte Paletu příkazů Zobrazit>a zadejte Azure Sphere: Vygenerovat nový projekt.

   

2. V nabídce Šablony zvolte PRÁZDNÉ HL.

   

3. Visual Studio Code pak zobrazí okno Průzkumník souborů. Přejděte do složky, kam chcete umístit prázdnou aplikaci, a zadejte název projektu, například NewHLApp. Visual Studio Code vytvoří ve vybraném umístění složku NewHLApp a vygeneruje soubory sestavení pro prázdnou aplikaci. Měli byste vidět zprávy od CMake.

4. Otevřete soubor CMakeLists.txt a zadejte složku obsahující definice hardwaru, který používáte. Ve výchozím nastavení prázdná aplikace HL neobsahuje žádné definice hardwaru. Ukázkové definice hardwaru najdete v úložišti ukázek Azure Sphere nebo můžete vytvořit definici hardwaru, jak je popsáno v definicích hardwaru.

   Následující příklad ukazuje, jak přidat ukázkové definice hardwaru pro Seeed Azure Sphere MT3620 Development Kit:

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

   Tento řádek by měl být vložen před poslední příkaz začátek azsphere_target_add_image_package.

Můžete také vytvořit novou aplikaci vysoké úrovně z některé z ukázek Azure Sphere vysoké úrovně:

1. Pokud jste to ještě neudělali, naklonujte úložiště ukázek. Zkopírujte jednu ze složek aplikací vysoké úrovně a přejmenujte ji pro svůj projekt.

2. V souboru CMakeLists.txt změňte název projektu na název nové složky. Příklad:

   PROJECT(NewHLApp C)

Nejjednodušší způsob, jak vytvořit novou aplikaci vysoké úrovně, je začít s prázdnou šablonou z rozšíření Visual Studio Azure Sphere a upravit konfiguraci projektu pomocí následujícího postupu:

1. Spusťte Visual Studio a vyberte Vytvořit nový projekt.

2. Zadejte Azure Sphere vyhledávací pole s popiskem Hledat šablony. V vráceném seznamu vyberte Azure Sphere HLCore Blank a pak vyberte Další.

3. Zadejte název projektu (například NewHLApp), umístění souboru projektu a název řešení (který může být stejný jako název projektu) a pak vyberte Vytvořit. Visual Studio vytvoří ve vybraném umístění složku NewHLpp a vygeneruje soubory sestavení pro prázdnou aplikaci. Měli byste vidět zprávy od CMake.

4. Otevřete soubor CMakeLists.txt a zadejte složku obsahující definice hardwaru, který používáte. Ve výchozím nastavení prázdná aplikace HL neobsahuje žádné definice hardwaru. Ukázkové definice hardwaru najdete v úložišti ukázek Azure Sphere nebo můžete vytvořit definici hardwaru, jak je popsáno v definicích hardwaru.

   Následující příklad ukazuje, jak přidat ukázkové definice hardwaru pro Seeed Azure Sphere MT3620 Development Kit:

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

   Tento řádek by měl být vložen před poslední příkaz začátek azsphere_target_add_image_package.

Můžete také vytvořit novou aplikaci vysoké úrovně z některé z ukázek Azure Sphere vysoké úrovně:

1. Pokud jste to ještě neudělali, naklonujte úložiště ukázek. Zkopírujte jednu ze složek aplikací vysoké úrovně a přejmenujte ji pro svůj projekt.

2. V souboru CMakeLists.txt změňte název projektu na název nové složky. Příklad:

   PROJECT(NewHLApp C)

Nejjednodušší způsob, jak vytvořit novou aplikaci vysoké úrovně, je začít s některou z ukázek Azure Sphere vysoké úrovně:

1. Pokud jste to ještě neudělali, naklonujte úložiště ukázek. Zkopírujte jednu ze složek aplikací vysoké úrovně a přejmenujte ji pro svůj projekt.

2. V souboru CMakeLists.txt změňte název projektu na název nové složky. Příklad:

   PROJECT(NewHLApp C)

Základní struktura souborů aplikace vysoké úrovně

Bez ohledu na to, jak aplikaci vytvoříte, sdílejí všechny aplikace Azure Sphere následující základní soubory:

• Zdrojový kód aplikace v jednom nebo více souborech. V současné době se podporuje pouze zdrojový kód jazyka C.
• Soubory sestavení CMake CMakeLists.txt se vyžaduje. CMake společně s ninja lightweight build utility slouží k řízení procesu sestavení aplikace Azure Sphere.
• Soubor manifestu aplikace popisující možnosti, které jsou pro aplikaci k dispozici.

Aplikace vysoké úrovně mají obvykle alespoň tři další soubory:

• Soubor applibs-versions.h pro určení úrovní verzí různých rozhraní API Azure Sphere
• Dva soubory definice hardwaru (upravitelná verze ve formátu JSON a jazyk C obsahují soubor vygenerovaný z něj), které poskytují pohodlný způsob, jak odkazovat na hardwarové komponenty v kódu. S konzistentní sadou definičních souborů hardwaru můžete napsat zdrojový kód nezávislý na hardwaru a pak vytvářet image aplikací pro konkrétní hardware jednoduše opětovným cílením na příslušný soubor definice hardwaru ve vašem CMakeLists.txt souboru.

Napsání kódu

1. Napište kód aplikace pomocí ukázek aplikací vysoké úrovně Azure Sphere jako vodítka. Následující témata popisují konkrétní scénáře implementace:
   • Použití periferních zařízení v aplikaci vysoké úrovně
   • Připojení k webovým službám
   • Použití wolfSSL pro připojení TLS
   • Správa certifikátů
   • Vysvětlení využití paměti
   • Odložit aktualizace zařízení
   • Správa času a používání hodin v reálném čase
   • Použití úložiště zařízení
   • Komunikace s aplikací podporující v reálném čase
   • Správa stavu Napájení dolů
   • Nastavení profilů napájení
   • Provádění zjišťování služeb
2. V souboru CMakeLists.txt:
   • Určení revize nástrojů sady Azure Sphere SDK
   • Určení sady cílových rozhraní API
   • Určení cílového hardwaru
3. V souboru app_manifest.json:
   • Name nastavte na název svého projektu.
   • Přidejte všechny funkce specifické pro aplikaci, které váš kód vyžaduje, například hardwarové prostředky nebo připojení. Pokud aplikace vysoké úrovně komunikuje s aplikací RTApp, přidejte do AllowedApplicationConnections této funkce ID komponenty aplikace vysoké úrovně.

Pokud chcete nasadit aplikaci vysoké úrovně společně s partnerovou aplikací podporující v reálném čase, přidejte ID komponenty partnera do pole partnerComponents v části konfigurace launch.vs.json (Visual Studio) nebo souboru .vscode/launch.json (Visual Studio Code):

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

Viz také

• Sestavte aplikaci vysoké úrovně.

• Ladění aplikace vysoké úrovně