Guida introduttiva: Installare Azure Sphere SDK per Linux

Articolo
03/25/2024

È possibile installare Azure Sphere SDK in un computer che esegue il sistema operativo Linux per sviluppare, distribuire ed eseguire il debug di applicazioni Azure Sphere.

Prerequisiti

L'installazione di Azure Sphere SDK richiede i prerequisiti seguenti:

Un kit di sviluppo Azure Sphere.
Un computer con un processore basato su x86-64 che esegue Ubuntu 24.04 a 64 bit (versione non finale), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS. Sono supportati solo processori x86-64 compatibili con Intel; non sono supportate altre architetture come ARM (inclusi Raspberry Pi), Itanium o SPARC. L'architettura x86-64 è anche nota come x64, x86_64, AMD64 e Intel 64.
Autorizzazione Linux sudo .
Una connessione Internet o un modo per trasferire file da un computer dotato di connessione Internet al computer. Per ulteriori informazioni, vedi Installare l'SDK senza una connessione Internet.

Aggiungere i pacchetti Linux necessari

Prima di eseguire lo script di installazione dell'SDK, è necessario aggiungere i pacchetti Linux necessari al computer, se non sono già installati. Immettere le righe seguenti in un terminale Linux. È possibile omettere pacchetti già installati.

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

Installare Azure Sphere SDK

Seguire questa procedura:

Scaricare lo script di installazione.
Passare alla cartella in cui è stato scaricato il file compresso.
Estrarre il contenuto del file compresso. Ad esempio, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Il file .tar.gz contiene il file install_azure_sphere_sdk.sh.
Eseguire lo script di installazione nel sudo modo seguente:
```
sudo ./install_azure_sphere_sdk.sh
```
Se viene visualizzato l'errore command not found durante l'esecuzione dello script, abilitare l'esecuzione dello script di installazione con questo comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Durante l'installazione, lo script visualizza messaggi di conferma. I messaggi di conferma possono essere ignorati richiamando lo script con il -y contrassegno:

sudo ./install_azure_sphere_sdk.sh -y

Senza il -y flag, lo script si aspetta risposte alle seguenti richieste:

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)

Passa al sito impronta digitale pubblica di Microsoft e verifica che il valore esadecimale dell'impronta digitale visualizzato durante l'installazione corrisponda all'impronta digitale della chiave pubblica Microsoft visualizzata nella pagina. Non procedere se le due impronte digitali non corrispondono.

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)

Seleziona Y per impostare Azure Sphere CLI come cli predefinito o N per impostare la cli classica di Azure Sphere come cli predefinita.

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)

Selezionare Y per impostare il gruppo azsfera e creare la regola di dev udev.

Al termine dell'installazione, è necessario accedere di nuovo all'applicazione desktop o alla shell di accesso per inizializzare cli.

Dopo l'installazione, il comando azsfera è sul PERCORSO e le nuove regole di udev per il tuo dispositivo sono in /etc/udev/rules.d/.

Lo script installa l'SDK in /opt/azuresferasdk e i toolchains in /opt/azuresferasdk/Sysroots/sysroot-version/tools, dove sysroot-version identifica una sysroot in base alla quale l'SDK supporta lo sviluppo di app.

Il programma di installazione installa sia azure sphere CLI che la versione CLI classica di Azure Sphere . Non è necessario disinstallare la versione corrente perché l'installazione aggiornerà qualsiasi versione esistente. Azure Sphere CLI è installato in /opt/azure spheresdk/Tools_v2 e Azure Sphere classico CLI è installato in /opt/azure spheresdk/Tools.

Su Linux, è possibile eseguire Azure Sphere CLI da un terminale utilizzando azsphere_v2 e azsphere se è stato selezionato come cli predefinito durante l'installazione.

Dopo aver installato cli per la prima volta, verificare che sia installato e si ha la versione corretta eseguendo azsfera show-version.

Regole di Udev

Azure Sphere SDK specifica udev le regole per le informazioni sul dispositivo del computer. L'SDK crea un nuovo gruppo chiamato azsphere e aggiunge l'utente attualmente connesso al gruppo. La udev regola concede la proprietà dei dispositivi USB corrispondenti alla descrizione del dispositivo Azure Sphere. Dopo aver installato l'SDK e riavviato il computer, non sarà necessario utilizzare sudo per il ripristino del dispositivo o il debug ARM Cortex-M4.

Il azsphere gruppo viene aggiunto per concedere le autorizzazioni usando la udev regola. Non modificare manualmente il gruppo.

Installare l'SDK senza una connessione Internet

Se nel computer in cui si sta installando l'SDK non è disponibile una connessione Internet, è necessario scaricare questi file in un computer connesso a Internet e trasferirli nel computer di installazione.

Scaricare questi file e trasferirli nel computer di installazione:
- Azure Sphere SDK per Linux: scegli tra Ubuntu 24.04 (pre-release), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS.
  
  Il file scaricato è un file di tar compresso (.tar.gz file) con un nome che inizia Azure_Sphere_SDK_Bundle.
- Installa script: si tratta di un file di tar compresso (file .tar.gz ) con un nome che inizia install_azure_sphere_sdk.
- Chiave pubblica gpg di Microsoft: si tratta di un file di testo ASCII.
Nel computer di installazione passare alla cartella in cui sono stati trasferiti i file.
Estrarre il contenuto del file script di installazione compresso. Ad esempio, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Il file .tar.gz contiene il file install_azure_sphere_sdk.sh. Lascia il bundle di Azure Sphere SDK come file di catrame compresso (file tar.gz ).
Eseguire lo script di installazione usando sudo. Includere il -i parametro per specificare il percorso del bundle sdk e il -k parametro per specificare il percorso della chiave. Il comando dovrebbe essere simile al seguente:

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

Se viene visualizzato l'errore command not found durante l'esecuzione dello script, abilitare l'esecuzione dello script di installazione con questo comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Procedere con l'installazione come descritto in Installare Azure Sphere SDK.

Configurare l'ambiente di sviluppo

Puoi sviluppare app Azure Sphere su Linux usando Visual Studio Code o l'interfaccia della riga di comando (CLI). Indipendentemente da ciò che usi, dovrai installare CMake e Ninja nella tua macchina di sviluppo, se non li hai già. Fare riferimento alle istruzioni per l'aggiunta del repository APT Kitware all'installazione.

Installare CMake e Ninja

Per installare CMake e Ninja, consultare le istruzioni per l'aggiunta del repository Kitware APT all'installazione, quindi utilizzare il seguente comando:

sudo apt-get install cmake ninja-build

Nota

Non installare cmake o ninja con snap.

Installare l'estensione Azure Sphere per Visual Studio Code

Se vuoi usare Visual Studio Code come ambiente di sviluppo, devi installarlo e l'estensione Azure Sphere.

Usa i collegamenti in Scarica Visual Studio Code per installare Visual Studio Code, se non l'hai già fatto.
Per installare l'estensione Azure Sphere, cerca "Azure Sphere" in Extension Marketplace da un browser o all'interno di Visual Studio Code. Dovresti vedere due risultati, Azure Sphere e Azure Sphere UI. Seleziona Installa per una delle due opzioni; l'altro dovrebbe essere installato automaticamente.
Dopo l'installazione, le estensioni Azure Sphere, C/C++ e CMake Tools dovrebbero essere visualizzate nel riquadro ENABLED Extensions nell'IDE di Visual Studio Code.

Al termine dell'installazione, verrà aperta la pagina Leggimi per l'estensione. La pagina Leggimi fornisce informazioni utili sulla configurazione e sui requisiti di Visual Studio Code e viene aggiornata insieme all'estensione. Puoi visualizzare la pagina Leggimi in qualsiasi momento aprendo il riquadro Estensioni e selezionando Azure Sphere.

Passaggi successivi

Richiedi il tuo dispositivo

Share via