Snabbstart: Installera Azure Sphere SDK för Linux

Du kan installera Azure Sphere SDK på en dator som kör Linux-operativsystemet för att utveckla, distribuera och felsöka Azure Sphere-program.

Förutsättningar

Installationen av Azure Sphere SDK kräver följande krav:

• Ett Azure Sphere-utvecklingspaket.
• En dator med en x86-64-baserad processor som kör 64-bitars Ubuntu 24.04 (förhandsversion), Ubuntu 22.04 LTS eller Ubuntu 20.04 LTS. Endast Intel-kompatibla x86-64-processorer stöds. andra arkitekturer som ARM (inklusive Raspberry Pi), Itanium eller SPARC stöds inte . X86-64-arkitekturen kallas även x64, x86_64, AMD64 och Intel 64.
• Linux-behörighet sudo .
• En internetanslutning eller ett sätt att överföra filer från en dator som har en Internetanslutning till datorn. Mer information finns i Installera SDK utan internetanslutning.

Lägga till nödvändiga Linux-paket

Innan du kör SDK-installationsskriptet måste du lägga till nödvändiga Linux-paket på datorn om de inte redan är installerade. Ange följande rader i en Linux-terminal. Du kan utelämna paket som redan är installerade.

sudo apt-get update
sudo apt-get install -y net-tools curl

Installera Azure Sphere SDK

Följ de här stegen:

1. Ladda ned installationsskriptet.

2. Navigera till mappen där du laddade ned den komprimerade filen.

3. Extrahera innehållet i den komprimerade filen. Exempel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz Filen .tar.gz innehåller filen install_azure_sphere_sdk.sh.

4. Kör installationsskriptet med följande sudo :

   sudo ./install_azure_sphere_sdk.sh
   

   Om du ser felet command not found när du kör skriptet aktiverar du körning av installationsskriptet med det här kommandot:

   chmod +x install_azure_sphere_sdk.sh
   

5. Under installationen visar skriptet bekräftelsemeddelanden. Bekräftelsemeddelanden kan hoppas över genom att anropa skriptet med -y flaggan:

   sudo ./install_azure_sphere_sdk.sh -y
   

   -y Utan flaggan förväntar sig skriptet svar på följande frågor:

   The SDK tarball signature is valid. The fingerprint of the key used is:
   
   Primary key fingerprint: <hexadecimal>
   
   Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
   Proceed with installation? (Y/N)
   

   Gå till Microsofts offentliga fingeravtryckswebbplats och kontrollera att det hexadecimala fingeravtrycksvärdet som visas under installationen matchar microsofts fingeravtryck för offentlig nyckel som visas på sidan. Fortsätt inte om de två fingeravtrycken inte matchar.

   Installing CLI.
   This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.
   
   You can choose which version is available through the command 'azsphere'.
   
   Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
   Use the recommended (new) CLI for 'azsphere'? (Y/N)
   
   

   Välj Y för att ange Azure Sphere CLI som standard-CLI eller N för att ange klassiska Cli för Azure Sphere som standard-CLI.

   Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)
   
   

   Välj Y för att konfigurera azsphere-gruppen och skapa udev-regeln.

6. När installationen är klar måste du logga in igen till ditt skrivbordsprogram eller inloggningsgränssnittet för att initiera Azure Sphere (Legacy) CLI.

Efter installationen finns kommandot azsphere på PATH och de nya udev-reglerna för enheten finns på /etc/udev/rules.d/.

Skriptet installerar SDK till /opt/azurespheresdk och verktygskedjan till /opt/azurespheresdk/Sysroots/sysroot-version/tools, där sysroot-version identifierar en sysroot som SDK stöder apputveckling mot.

Installationsprogrammet installerar Azure Sphere(Legacy) CLI-versionerna av CLI. Du behöver inte avinstallera den aktuella versionen eftersom installationen uppdaterar någon befintlig version. Azure Sphere (Legacy) CLI installeras i /opt/azurespheresdk/Tools_v2 och klassiska Cli för Azure Sphere (äldre) installeras i /opt/azurespheresdk/Tools.

I Linux kan du köra Azure Sphere (Legacy) CLI från en terminal med och azsphere_v2 azsphere om den valdes som standard-CLI under installationen.

När du har installerat CLI för första gången kontrollerar du att det är installerat och att du har rätt version genom att köra azsphere show-version.

Udev-regler

Azure Sphere SDK anger udev regler för din dators enhetsinformation. SDK skapar en ny grupp med namnet azsphere och lägger till den inloggade användaren i gruppen. Regeln udev ger ägarskap för USB-enheter som matchar Enhetsbeskrivningen för Azure Sphere. När du har installerat SDK och startat om datorn behöver du inte använda sudo för enhetsåterställning eller ARM Cortex-M4-felsökning.

Gruppen azsphere läggs till för att bevilja behörigheter med hjälp av udev regeln. Ändra inte gruppen manuellt.

Installera SDK utan internetanslutning

Om du inte har någon Internetanslutning på datorn där du installerar SDK:t måste du ladda ned filerna till en dator som är ansluten till Internet och överföra dem till installationsdatorn.

1. Ladda ned dessa filer och överför dem till installationsdatorn:

   • Azure Sphere SDK för Linux: välj mellan Ubuntu 24.04 (förhandsversion) eller Ubuntu 22.04 LTS eller Ubuntu 20.04 LTS.

     Den nedladdade filen är en komprimerad tjärfil (.tar.gz fil) med ett namn som börjar Azure_Sphere_SDK_Bundle.

   • Installationsskript: det här är en komprimerad tjärfil (.tar.gz fil) med ett namn som börjar install_azure_sphere_sdk.

   • Microsofts offentliga GPG-nyckel: det här är en ASCII-textfil.

2. På installationsdatorn navigerar du till mappen som du överförde filerna till.

3. Extrahera innehållet i den komprimerade installationsskriptfilen. Exempel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz Filen .tar.gz innehåller filen install_azure_sphere_sdk.sh. Lämna Azure Sphere SDK-paketet som en komprimerad tjärfil (tar.gz fil).

4. Kör installationsskriptet med .sudo Inkludera parametern -i för att ange sökvägen till SDK-paketet och parametern -k för att ange sökvägen till nyckeln. Kommandot bör se ut ungefär så här:

   sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

   Om du ser felet command not found när du kör skriptet aktiverar du körning av installationsskriptet med det här kommandot:

   chmod +x install_azure_sphere_sdk.sh
   

Fortsätt med installationen enligt beskrivningen i Installera Azure Sphere SDK.

Installera Azure Sphere-tillägget för Azure CLI

Kommandoradsverktyget för att hantera Azure Sphere-anslutna enheter och molndistributioner distribueras som ett Azure CLI-tillägg. Utför följande steg för att lägga till eller uppdatera tillägget:

1. Installera Azure CLI om du inte har gjort det ännu.

• Om du vill lägga till Azure Sphere-tillägget kör du följande kommando:

  az extension add --name azure-sphere
  

• Kör följande kommando för att uppdatera Azure Sphere-tillägget:

  az extension udpate --name azure-sphere
  

Du måste logga in med Azure CLI för att logga in på den Azure-prenumeration som du vill använda för att hantera Azure Sphere-enheter.

Mer information finns i Ladda ned och kör Azure Sphere-tillägget.

Konfigurera utvecklingsmiljön

sudo apt-get install cmake ninja-build

Nästa steg