Dela via

Skapa ett realtidskompatibelt program

  • Artikel

Viktigt!

Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).

Det enklaste sättet att skapa ett nytt realtidskompatibelt program är att börja med den tomma mallen från Visual Studio Code Azure Sphere-tillägget och justera konfigurationen till projektet genom att följa dessa steg:

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

    Kommandofältet i Visual Studio Code

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

    popup-meny med mallnamn

  3. Visual Studio Code 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 byggfilerna för det tomma programmet. Meddelanden från CMake bör visas.

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

  1. Klona lagringsplatsen för exempel om du inte redan har gjort det. Kopiera en av programmapparna på hög nivå och byt namn på den för projektet.

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

    PROJECT(NewRTApp C)

Det enklaste sättet att skapa ett nytt realtidskompatibelt program är att börja med den tomma mallen från Visual Studio Azure Sphere-tillägget och justera konfigurationen till projektet genom att följa dessa steg:

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

  2. Skriv Azure Sphere i sökrutan med etiketten 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 byggfilerna för det tomma programmet. Meddelanden från CMake bör visas.

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

  1. Klona lagringsplatsen för exempel om du inte redan har gjort det. Kopiera en av de realtidskompatibla programmapparna och byt namn på den för projektet.

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

    PROJECT(NewRTApp C)

Det enklaste sättet att skapa ett nytt realtidskompatibelt program är att börja med HelloWorld_RTApp_MT3620_BareMetal exempel och justera konfigurationen till projektet genom att följa dessa steg:

  1. Klona lagringsplatsen för exempel om du inte redan har gjort det. Kopiera mappen HelloWorld_RTApp_MT3620_BareMetal och byt namn på den för projektet.

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

    PROJECT(NewRTApp C)

Grundläggande filstruktur för ett realtidskompatibelt program

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

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

Realtidskompatibla program lägger till minst en annan fil: 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 hjälp av Azure Sphere RTApp-exemplen som guider. Följande avsnitt beskriver specifika implementeringsscenarier:
  2. I filen app_manifest.json:
    • Ange Name som projektnamn.
    • Ställ in ApplicationType på "RealTimeCapable"
    • Lägg till programspecifika funktioner som din kod kräver, till exempel maskinvaruresurser eller anslutningar. Om RTApp kommunicerar med en högnivåapp lägger du till komponent-ID:t för högnivåprogrammet i 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 partnerComponents i avsnittet konfigurationer i filen launch.vs.json (Visual Studio) eller .vscode/launch.json (Visual Studio Code):

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

Se även