Partage via

Démarrage rapide : Installer le Kit de développement logiciel (SDK) Azure Sphere pour Linux

  • Article

Vous pouvez installer le Kit de développement logiciel (SDK) Azure Sphere sur un ordinateur exécutant le système d’exploitation Linux pour développer, déployer et déboguer des applications Azure Sphere.

Conditions préalables

L’installation du Kit de développement logiciel (SDK) Azure Sphere nécessite les prérequis suivants :

  • Un kit de développement Azure Sphere.
  • Un ordinateur avec un processeur x86-64 exécutant Ubuntu 24.04 (préversion), Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS. Seuls les processeurs x86-64 compatibles Intel sont pris en charge . les autres architectures telles qu’ARM (y compris le Raspberry Pi), Itanium ou SPARC ne sont pas prises en charge. L’architecture x86-64 est également appelée x64, x86_64, AMD64 et Intel 64.
  • Autorisation Linux sudo .
  • Une connexion Internet ou un moyen de transférer des fichiers à partir d’un ordinateur disposant d’une connexion Internet vers votre ordinateur. Pour plus d’informations, consultez Installer le Kit de développement logiciel (SDK) sans connexion Internet.

Ajouter les packages Linux requis

Avant d’exécuter le script d’installation du SDK, vous devez ajouter les packages Linux requis à votre ordinateur s’ils ne sont pas déjà installés. Entrez les lignes suivantes dans un terminal Linux. Vous pouvez omettre les packages déjà installés.

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

Installer le Kit de développement logiciel (SDK) Azure Sphere

Procédez comme suit :

  1. Téléchargez le script d’installation.

  2. Accédez au dossier dans lequel vous avez téléchargé le fichier compressé.

  3. Extrayez le contenu du fichier compressé. Par exemple, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Le fichier .tar.gz contient le fichier install_azure_sphere_sdk.sh.

  4. Exécutez le script d’installation en utilisant sudo comme suit :

    sudo ./install_azure_sphere_sdk.sh

    Si vous voyez l’erreur command not found lors de l’exécution du script, activez l’exécution du script d’installation avec cette commande :

    chmod +x install_azure_sphere_sdk.sh

  5. Pendant l’installation, le script affiche des messages de confirmation. Les messages de confirmation peuvent être ignorés en appelant le script avec l’indicateur -y :

    sudo ./install_azure_sphere_sdk.sh -y

    Sans l’indicateur -y , le script attend des réponses aux invites suivantes :

    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)

    Accédez au site de empreinte digitale de clé public de Microsoft et vérifiez que la valeur d’empreinte numérique hexadécimale affichée pendant l’installation correspond à l’empreinte digitale de clé publique Microsoft affichée sur la page. Ne continuez pas si les deux empreintes digitales ne correspondent pas.

    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)

    Sélectionnez cette option Y pour définir l’interface CLI Azure Sphere comme cli par défaut ou N pour définir l’interface CLI classique Azure Sphere comme cli par défaut.

    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)

    Sélectionnez cette option Y pour configurer le groupe azsphere et créer la règle udev.

  6. Une fois l’installation terminée, vous devez vous reconnecter à votre application de bureau ou à votre interpréteur de commandes de connexion pour initialiser l’interface CLI Azure Sphere (héritée).

Après l’installation, la commande azsphere se trouve sur le chemin d’accès et les nouvelles règles udev pour votre appareil se trouvent à /etc/udev/rules.d/.

Le script installe le Kit de développement logiciel (SDK) sur /opt/azurespheresdk et les chaînes d’outils sur /opt/azurespheresdk/Sysroots/sysroot-version/tools, où sysroot-version identifie un sysroot pour lequel le SDK prend en charge le développement d’applications.

Le programme d’installation installe les versions de l’interface CLI Azure Sphere (héritée) de l’interface CLI. Vous n’avez pas besoin de désinstaller la version actuelle, car l’installation met à jour toute version existante. L’interface CLI Azure Sphere (héritée) est installée dans /opt/azurespheresdk/Tools_v2 et l’interface CLI classique Azure Sphere (héritée) est installée dans /opt/azurespheresdk/Tools.

Sur Linux, vous pouvez exécuter l’interface CLI Azure Sphere (héritée) à partir d’un terminal à l’aide azsphere_v2 de et azsphere si elle a été sélectionnée comme cli par défaut pendant l’installation.

Après avoir installé l’interface CLI pour la première fois, case activée qu’elle est installée et que vous avez la version correcte en exécutant azsphere show-version.

Règles Udev

Le Kit de développement logiciel (SDK) Azure Sphere spécifie des règles pour les udev informations sur l’appareil de votre ordinateur. Le Kit de développement logiciel (SDK) crée un groupe appelé azsphere et ajoute l’utilisateur actuellement connecté au groupe. La udev règle accorde la propriété des périphériques USB correspondant à la description de l’appareil Azure Sphere. Après avoir installé le Kit de développement logiciel (SDK) et redémarré votre ordinateur, vous n’avez pas besoin d’utiliser sudo pour la récupération d’appareil ou le débogage ARM Cortex-M4.

Le azsphere groupe est ajouté afin d’accorder des autorisations à l’aide de la udev règle . Ne modifiez pas le groupe manuellement.

Installer le Kit de développement logiciel (SDK) sans connexion Internet

Si vous n’avez pas de connexion Internet sur l’ordinateur sur lequel vous installez le Kit de développement logiciel (SDK), vous devez télécharger les fichiers sur un ordinateur connecté à Internet et les transférer vers l’ordinateur d’installation.

  1. Téléchargez ces fichiers et transférez-les sur l’ordinateur d’installation :

  2. Sur l’ordinateur d’installation, accédez au dossier dans lequel vous avez transféré les fichiers.

  3. Extrayez le contenu du fichier de script d’installation compressé. Par exemple, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Le fichier .tar.gz contient le fichier install_azure_sphere_sdk.sh. Conservez l’offre groupée du KIT de développement logiciel (SDK) Azure Sphere en tant que fichier tar compressé (fichier tar.gz ).

  4. Exécutez le script d’installation à l’aide de sudo. Incluez le -i paramètre pour spécifier le chemin d’accès au bundle sdk et le -k paramètre pour spécifier le chemin d’accès à la clé. Votre commande doit ressembler à ceci :

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

    Si vous voyez l’erreur command not found lors de l’exécution du script, activez l’exécution du script d’installation avec cette commande :

    chmod +x install_azure_sphere_sdk.sh

Poursuivez l’installation comme décrit dans Installer le Kit de développement logiciel (SDK) Azure Sphere.

Installer l’extension Azure Sphere pour Azure CLI

L’outil en ligne de commande pour la gestion des appareils attachés à Azure Sphere et des déploiements cloud est distribué en tant qu’extension Azure CLI. Pour ajouter ou mettre à jour l’extension, procédez comme suit :

  1. Installez Azure CLI si vous ne l’avez pas encore fait.

  • Pour ajouter l’extension Azure Sphere, exécutez la commande suivante :

    az extension add --name azure-sphere

  • Pour mettre à jour l’extension Azure Sphere, exécutez la commande suivante :

    az extension udpate --name azure-sphere

Vous devez vous connecter avec Azure CLI pour vous connecter à l’abonnement Azure que vous souhaitez utiliser pour gérer les appareils Azure Sphere.

Pour plus d’informations, consultez Télécharger et exécuter l’extension Azure Sphere.

Configurer votre environnement de développement

Vous pouvez développer des applications Azure Sphere sur Linux à l’aide de Visual Studio Code ou de l’interface de ligne de commande (CLI). Quelle que soit l’utilisation que vous utilisez, vous devez installer CMake et Ninja sur votre ordinateur de développement, si vous ne les avez pas déjà. Reportez-vous aux instructions pour ajouter le référentiel APT Kitware à votre installation.

Installer CMake et Ninja

Pour installer CMake et Ninja, consultez d’abord les instructions pour ajouter le référentiel APT Kitware à votre installation, puis utilisez la commande suivante :

sudo apt-get install cmake ninja-build

Note

N’installez pas cmake ou ninja à l’aide de snap.

Installer l’extension Azure Sphere pour Visual Studio Code

Si vous souhaitez utiliser Visual Studio Code comme environnement de développement, vous devez l’installer et l’extension Azure Sphere.

  1. Utilisez les liens dans Télécharger Visual Studio Code pour installer Visual Studio Code, si vous ne l’avez pas déjà fait.

  2. Pour installer l’extension Azure Sphere, recherchez « Azure Sphere » dans la Place de marché des extensions à partir d’un navigateur ou dans Visual Studio Code. Vous devez voir deux résultats : Azure Sphere et l’interface utilisateur Azure Sphere. Sélectionnez Installer pour l’un ou l’autre ; l’autre doit être installé automatiquement.

  3. Après l’installation, vous devez voir les extensions Azure Sphere, C/C++ et CMake Tools dans le volet Extensions ACTIVÉEs de l’IDE Visual Studio Code.

Une fois l’installation terminée, la page Lisez-moi de l’extension s’ouvre. La page Lisez-moi fournit des informations utiles sur la configuration et la configuration requise de Visual Studio Code, et est mise à jour avec l’extension. Vous pouvez afficher la page Lisez-moi à tout moment en ouvrant le volet Extensions et en sélectionnant Azure Sphere.

Étapes suivantes

Revendiquer votre appareil

Note

N’installez pas cmake ou ninja à l’aide de snap.