Skapa ett program som kan användas i realtid

Det enklaste sättet att skapa ett nytt program som kan användas i realtid är att börja med mallen Tom från tillägget Visual Studio Code Azure Sphere och justera konfigurationen till ditt projekt genom att följa de här stegen:

  1. Starta Visual Studio-kod. Välj Visa>kommandopalett och skriv sedan Azure Sphere: Generera nytt projekt.

    Kommandofältet i Visual Studio-kod

  2. Välj RTCore Blank på menyn Mallar.

    popup-meny med mallnamn

  3. Visual Studio-kod visar sedan ett Utforskaren fönster. Navigera till mappen där du vill placera det tomma programmet och ange ett namn för projektet, till exempel NewRTApp. Visual Studio Code skapar mappen NewRTApp på den valda platsen och genererar build-filerna för det tomma programmet. Du bör se meddelanden från CMake.

Du kan också skapa ett nytt program som kan användas i realtid från något av de Azure Sphere-exempel som kan användas i realtid:

  1. Klona exempelrepo om du inte redan har gjort det. Kopiera en av programmapparna på hög nivå och byt namn på den till ditt projekt.

  2. I den CMakeLists.txt filen ändrar du projektnamnet till namnet på den nya mappen. Till exempel:

    PROJECT(NewRTApp C)

Det enklaste sättet att skapa ett nytt program som kan användas i realtid är att börja med mallen Tom från Tillägget Visual Studio Azure Sphere och justera konfigurationen till projektet genom att följa de här stegen:

  1. Starta Visual Studio och välj Skapa ett nytt projekt.

  2. Skriv Azure Sphere i sökrutan Sök efter mallar. Välj Azure Sphere RTCore Blank i den returnerade listan och välj sedan Nästa.

  3. Ange ett projektnamn (till exempel NewRTApp), en projektfilplats och ett lösningsnamn (som kan vara samma som projektnamnet) och välj sedan Skapa. Visual Studio skapar mappen NewRTApp på den valda platsen och genererar build-filerna för det tomma programmet. Du bör se meddelanden från CMake.

Du kan också skapa ett nytt realtidsbaserat program från något av Azure Sphere-exempel på hög nivå:

  1. Klona exempelrepo om du inte redan har gjort det. Kopiera en av de programmappar som kan användas i realtid och byt namn på den till ditt projekt.

  2. I den CMakeLists.txt filen ändrar du projektnamnet till namnet på den nya mappen. Till exempel:

    PROJECT(NewRTApp C)

Det enklaste sättet att skapa ett nytt program som kan användas i realtid är att börja med det HelloWorld_RTApp_MT3620_BareMetal exemplet och justera konfigurationen till projektet genom att följa de här stegen:

  1. Klona exempelrepo om du inte redan har gjort det. Kopiera mappen HelloWorld_RTApp_MT3620_BareMetal och byt namn på den till projektet.

  2. I den CMakeLists.txt filen ändrar du projektnamnet till namnet på den nya mappen. Till exempel:

    PROJECT(NewRTApp C)

Grundläggande filstruktur i ett program som kan användas i realtid

Oavsett hur du skapar ditt program har alla Azure Sphere-program följande kärnfiler:

  • Programkällans kod i en eller flera filer. För närvarande stöds endast C-språkkällkod.
  • CMake-byggfiler. CMakeLists.txt krävs. CMake används tillsammans med ninja lightweight build-verktyget för att styra azure sphere-programbyggprocessen.
  • En appmanifestfil som beskriver de funktioner som är tillgängliga för programmet.

I realtidsaktiverade program läggs minst en fil till: en linker.ld-fil för att ange exakt var olika komponenter i programmet ska läsas in i realtidskärnan.

Skriv din kod

  1. Skriv programkoden med azure sphere RTApp-exempel som guider. I följande avsnitt beskrivs specifika implementeringsscenarier:
  2. I filen app_manifest.json:
    • Ange Name ditt projektnamn
    • Ange ApplicationType till "RealTimeCapable"
    • Lägg till programspecifika funktioner som din kod kräver, till exempel maskinvaruresurser eller anslutningar. Om RTApp kommunicerar med en app på hög nivå lägger du till komponent-ID:t för högnivåprogrammet till AllowedApplicationConnections funktionen.

Om du vill distribuera din RTApp tillsammans med en partnerapp på hög nivå lägger du till komponent-ID:t för partnern i fältet partnerkomponenter i konfigurationsavsnittet i filen launch.vs.json (Visual Studio) eller .vscode/launch.json (Visual Studio Code):

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

Se även