Rychlý start: Instalace sady Azure Sphere SDK pro Linux

Sadu Azure Sphere SDK můžete nainstalovat do počítače s operačním systémem Linux a vyvíjet, nasazovat a ladit aplikace Azure Sphere.

Požadavky

Instalace sady Azure Sphere SDK vyžaduje následující požadavky:

• Vývojová sada Azure Sphere.
• Počítač s procesorem x86-64 s 64bitovou verzí Ubuntu 24.04 (předběžná verze), Ubuntu 22.04 LTS nebo Ubuntu 20.04 LTS. Podporují se pouze procesory intel kompatibilní s x86-64; jiné architektury, jako je ARM (včetně Raspberry Pi), Itanium nebo SPARC, se nepodporují . Architektura x86-64 se také označuje jako x64, x86_64, AMD64 a Intel 64.
• Oprávnění Linuxu sudo .
• Připojení k internetu nebo způsob přenosu souborů z počítače, který má připojení k internetu k počítači. Další informace naleznete v tématu Instalace sady SDK bez připojení k internetu.

Přidání požadovaných linuxových balíčků

Před spuštěním instalačního skriptu sady SDK musíte do počítače přidat požadované balíčky Linuxu, pokud ještě nejsou nainstalované. Do terminálu Linuxu zadejte následující řádky. Můžete vynechat balíčky, které jsou již nainstalovány.

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

Instalace sady Azure Sphere SDK

Postupujte následovně:

1. Stáhněte instalační skript.

2. Přejděte do složky, do které jste stáhli komprimovaný soubor.

3. Extrahujte obsah komprimovaného souboru. Například tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Soubor .tar.gz obsahuje soubor install_azure_sphere_sdk.sh.

4. Spusťte instalační skript následujícím způsobem sudo :

   sudo ./install_azure_sphere_sdk.sh
   

   Pokud se při spuštění skriptu zobrazí chyba command not found , povolte spuštění instalačního skriptu pomocí tohoto příkazu:

   chmod +x install_azure_sphere_sdk.sh
   

5. Během instalace skript zobrazí potvrzovací zprávy. Potvrzovací zprávy je možné přeskočit vyvoláním skriptu příznakem -y :

   sudo ./install_azure_sphere_sdk.sh -y
   

   Bez příznaku -y skript očekává odpovědi na následující výzvy:

   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)
   

   Přejděte na web otisku prstu veřejného klíče od Microsoftu a ověřte, že hodnota šestnáctkového otisku prstu zobrazená během instalace odpovídá otisku prstu veřejného klíče Microsoftu, který se zobrazuje na stránce. Nepokračujte, pokud se dva otisky prstů neshodují.

   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)
   
   

   Vyberte Y , jestli chcete nastavit Rozhraní příkazového řádku Azure Sphere jako výchozí rozhraní příkazového řádku, nebo N jako výchozí rozhraní příkazového řádku nastavit Azure Sphere Classic 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)
   
   

   Vyberte Y , pokud chcete nastavit skupinu azsphere a vytvořit pravidlo udev.

6. Po dokončení instalace se musíte znovu přihlásit k desktopové aplikaci nebo k přihlašovacímu prostředí, abyste inicializovali rozhraní příkazového řádku Azure Sphere (starší verze).

Po instalaci je příkaz azsphere na cestě PATH a nová pravidla udev pro vaše zařízení jsou na /etc/udev/rules.d/adrese .

Skript nainstaluje sadu SDK do /opt/azurespheresdk a sady nástrojů do /opt/azurespheresdk/Sysroots/sysroot-version/tools, kde sysroot-version/tools identifikuje složku sysroot, pro kterou sada SDK podporuje vývoj aplikací.

Instalační program nainstaluje verze rozhraní příkazového řádku Azure Sphere (starší verze). Aktuální verzi nemusíte odinstalovat, protože instalace aktualizuje jakoukoli existující verzi. Rozhraní příkazového řádku Azure Sphere (starší verze) je nainstalované v prostředí /opt/azurespheresdk/Tools_v2 a rozhraní příkazového řádku Azure Sphere (starší verze) je nainstalované v /opt/azurespheresdk/Tools.

V Linuxu můžete z terminálu spustit Rozhraní příkazového řádku Azure Sphere (starší verze) pomocí azsphere_v2 terminálu a azsphere pokud jste ho během instalace vybrali jako výchozí rozhraní příkazového řádku.

Po první instalaci rozhraní příkazového řádku zkontrolujte, jestli je nainstalovaná a že máte správnou verzi spuštěním příkazu azsphere show-version.

Pravidla Udev

Sada Azure Sphere SDK určuje udev pravidla pro informace o zařízení vašeho počítače. Sada SDK vytvoří volanou azsphere novou skupinu a přidá do skupiny aktuálně přihlášeného uživatele. Pravidlo udev uděluje vlastnictví zařízení USB odpovídající popisu zařízení Azure Sphere. Po instalaci sady SDK a restartování počítače nebudete muset použít sudo pro obnovení zařízení ani ladění ARM Cortex-M4.

Skupina azsphere se přidá, aby bylo možné udělit oprávnění pomocí udev pravidla. Skupinu neupravujte ručně.

Instalace sady SDK bez připojení k internetu

Pokud na počítači, na který instalujete sadu SDK, nemáte připojení k internetu, musíte soubory stáhnout do počítače, který je připojený k internetu, a přenést je do instalačního počítače.

1. Stáhněte si tyto soubory a přeneste je do instalačního počítače:

   • Sada Azure Sphere SDK pro Linux: Vyberte si z Ubuntu 24.04 (předběžná verze) nebo Ubuntu 22.04 LTS nebo Ubuntu 20.04 LTS.

     Stažený soubor je komprimovaný soubor tar (.tar.gz soubor) s názvem začínajícím Azure_Sphere_SDK_Bundle.

   • Instalační skript: jedná se o komprimovaný soubor tar (.tar.gz soubor) s názvem začínajícím install_azure_sphere_sdk.

   • Veřejný klíč GPG od Microsoftu: jedná se o textový soubor ASCII.

2. V instalačním počítači přejděte do složky, do které jste přenesli soubory.

3. Extrahujte obsah komprimovaného instalačního souboru skriptu. Například tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Soubor .tar.gz obsahuje soubor install_azure_sphere_sdk.sh. Sadu azure Sphere SDK ponechte jako komprimovaný soubor tar (tar.gz soubor).

4. Spusťte instalační skript pomocí sudopříkazu . -i Zahrňte parametr, který určuje cestu k sadě SDK, a -k parametr, který určuje cestu ke klíči. Příkaz by měl být podobný tomuto:

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

   Pokud se při spuštění skriptu zobrazí chyba command not found , povolte spuštění instalačního skriptu pomocí tohoto příkazu:

   chmod +x install_azure_sphere_sdk.sh
   

Pokračujte v instalaci, jak je popsáno v části Instalace sady Azure Sphere SDK.

Instalace rozšíření Azure Sphere pro Azure CLI

Nástroj příkazového řádku pro správu připojených zařízení Azure Sphere a cloudových nasazení se distribuuje jako rozšíření Azure CLI. Přidáním nebo aktualizací rozšíření proveďte následující kroky:

1. Pokud jste to ještě neudělali, nainstalujte Azure CLI .

• Pokud chcete přidat rozšíření Azure Sphere, spusťte následující příkaz:

  az extension add --name azure-sphere
  

• Pokud chcete aktualizovat rozšíření Azure Sphere, spusťte následující příkaz:

  az extension udpate --name azure-sphere
  

Pokud se chcete přihlásit k předplatnému Azure, které chcete použít ke správě zařízení Azure Sphere, musíte se přihlásit pomocí Azure CLI .

Další informace najdete v tématu Stažení a spuštění rozšíření Azure Sphere.

Nastavení vývojového prostředí

Aplikace Azure Sphere můžete vyvíjet v Linuxu pomocí editoru Visual Studio Code nebo rozhraní příkazového řádku (CLI). Bez ohledu na to, co používáte, budete muset nainstalovat CMake a Ninja na vývojovém počítači, pokud je ještě nemáte. Pokyny k přidání úložiště Kitware APT do instalace

Instalace CMake a Ninja

Pokud chcete nainstalovat CMake a Ninja, nejprve si přečtěte pokyny pro přidání úložiště Kitware APT do instalace a pak použijte následující příkaz:

sudo apt-get install cmake ninja-build

Poznámka:

Neinstalujte cmake nebo ninja pomocí přichycení.

Instalace rozšíření Azure Sphere pro Visual Studio Code

Pokud chcete jako vývojové prostředí používat Visual Studio Code, musíte ho nainstalovat a rozšíření Azure Sphere.

1. Pokud jste to ještě neudělali, použijte odkazy v nástroji Download Visual Studio Code k instalaci nástroje Visual Studio Code .

2. Pokud chcete nainstalovat rozšíření Azure Sphere, na webu Marketplace rozšíření vyhledejte v prohlížeči nebo v editoru Visual Studio Code výraz Azure Sphere. Měly by se zobrazit dva výsledky: Azure Sphere a uživatelské rozhraní Azure Sphere. Vyberte Možnost Nainstalovat pro jednu z nich. Druhá by měla být nainstalována automaticky.

3. Po instalaci byste měli vidět rozšíření Nástrojů Azure Sphere, C/C++ a CMake v podokně POVOLENÉ rozšíření v integrovaném vývojovém prostředí (IDE) editoru Visual Studio Code.

Po dokončení instalace se otevře stránka Readme rozšíření. Stránka Readme poskytuje užitečné informace o konfiguraci a požadavcích editoru Visual Studio Code a aktualizuje se společně s rozšířením. Stránku Readme si můžete kdykoli zobrazit tak, že otevřete podokno Rozšíření a vyberete Azure Sphere.

Další kroky

Deklarace zařízení

Poznámka:

Neinstalujte cmake nebo ninja pomocí přichycení.