Nozioni di base sul kit di sviluppo Cypress CYW954907AEVAL1F

Importante

Questa integrazione di riferimento è ospitata nel repository Amazon-FreeRTOS che è obsoleto. Ti consigliamo di iniziare da qui quando crei un nuovo progetto. Se hai già un progetto FreeRTOS esistente basato sull'ormai obsoleto repository Amazon-FreeRTOS, consulta ilGuida alla migrazione del repository Github di Amazon-FreeRTOS.

Questo tutorial fornisce istruzioni per iniziare a usare il kit di sviluppo Cypress CYW954907AEVAL1F. Se non disponi del kit di sviluppo Cypress CYW954907AEVAL1F, visita l'AWS Partner Device Catalog per acquistarne uno dal nostro partner.

Nota

Questo tutorial ti guiderà nella creazione e nella creazione della demo di Mutual Authentication di CoreMQTT. La porta FreeRTOS per questa scheda attualmente non supporta le demo del server e del client TCP.

Prima di iniziare, devi configurareAWS IoT e scaricare FreeRTOS per connettere il tuo dispositivo alAWS Cloud. Per istruzioni, consulta Fase iniziale. In questo tutorial, il percorso della directory di download di FreeRTOS viene chiamatofreertos.

Importante

• In questo argomento, il percorso della directory di download di FreeRTOS viene definito comefreertos.

• Gli spazi contenuti nel percorso freertos possono causare errori di compilazione. Quando si clona o si copia il repository, assicurarsi che il percorso creato non contenga spazi.

• La lunghezza massima di un percorso di file su Microsoft Windows è di 260 caratteri. I lunghi percorsi della directory di download di FreeRTOS possono causare errori di compilazione.

• Poiché il codice sorgente può contenere collegamenti simbolici, se utilizzi Windows per estrarre l'archivio, potresti dover:

  • Abilita la modalità sviluppatore o,

  • Usa una console con privilegi di amministratore.

  In questo modo, Windows può creare correttamente collegamenti simbolici quando estrae l'archivio. Altrimenti, i collegamenti simbolici verranno scritti come file normali che contengono i percorsi dei collegamenti simbolici come testo o sono vuoti. Per ulteriori informazioni, consulta la voce di blog Symlinks in Windows 10! .

  Se usi Git in Windows, devi abilitare la modalità sviluppatore oppure devi:

  • core.symlinksImposta su true con il seguente comando:

    git config --global core.symlinks true

  • Usa una console con privilegi di amministratore ogni volta che usi un comando git che scrive nel sistema (ad esempiogit pull,git clone, egit submodule update --init --recursive).

• Come indicato inScaricare FreerTOS, le porte FreeRTOS per Cypress sono attualmente disponibili solo su GitHub.

Panoramica

Questo tutorial contiene le istruzioni per i seguenti passaggi iniziali:

1. Installazione di software sul computer host per lo sviluppo e il debug di applicazioni integrate per la scheda a microcontroller.

2. Compilazione incrociata di un'applicazione demo FreeRTOS con un'immagine binaria.

3. Caricamento dell'immagine binaria dell'applicazione sulla scheda in uso e successiva esecuzione dell'applicazione.

4. Interazione con l'applicazione in esecuzione sulla scheda attraverso una connessione seriale, per scopi di monitoraggio e debug.

Configurazione dell'ambiente di sviluppo

Scaricare e installare l'SDK WICED Studio

In questa guida introduttiva, usi Cypress WICED Studio SDK per programmare la tua scheda con la demo di FreeRTOS. Visita il sito Web del software WICED per scaricare l'SDK WICED Studio da Cypress. Per scaricare il software è necessario effettuare la registrazione per un account Cypress gratuito. L'SDK WICED Studio è compatibile con i sistemi operativi Windows, macOS e Linux.

Nota

Alcuni sistemi operativi richiedono fasi di installazione aggiuntive. Assicurarsi di leggere e seguire tutte le istruzioni di installazione del sistema operativo e della versione di WICED Studio che si stanno installando.

Impostazione delle variabili di ambiente

Prima di utilizzare WICED Studio per programmare la scheda, è necessario creare una variabile di ambiente per la directory di installazione dell'SDK WICED Studio. Se WICED Studio è in esecuzione durante la creazione delle variabili, sarà necessario riavviare l'applicazione dopo l'impostazione delle variabili.

Nota

Il programma di installazione di WICED Studio crea due cartelle separate denominate WICED-Studio-m.n sul computer in cui m e n sono rispettivamente i numeri di versione principale e secondaria. Questo documento presuppone il nome della cartella WICED-Studio-6.2 ma assicurati di utilizzare il nome corretto per la versione installata. Una volta definita la variabile di ambiente WICED_STUDIO_SDK_PATH assicurati di specificare il percorso completo di installazione dell'SDK WICED Studio e non il percorso di installazione dell'interfaccia utente WICED Studio. In Windows e macOS, la cartella WICED-Studio-m.n per l'SDK viene creata per impostazione predefinita nella cartella Documents.

Per creare la variabile di ambiente in Windows

1. Aprire il Pannello di controllo di Windows fare clic su Sistema, Impostazioni di sistema avanzate.

2. Nella scheda Avanzate, scegliere Variabili di ambiente.

3. In Variabili utente scegliere Nuova.

4. In Nome variabile, inserire WICED_STUDIO_SDK_PATH. Per Valore della variabile, immettere la directory di installazione dell'SDK WICED Studio.

Per creare la variabile di ambiente in Linux o macOS

1. Aprire il file /etc/profile nel compute, quindi aggiungere quanto segue all'ultima riga del file:

   export WICED_STUDIO_SDK_PATH=installation-path/WICED-Studio-6.2

2. Riavviare il computer.

3. Aprire una finestra del terminale ed eseguire i comandi seguenti:

   cd freertos/vendors/cypress/WICED_SDK

   perl platform_adjust_make.pl

   chmod +x make

Stabilire una connessione seriale

Per stabilire una connessione seriale tra il computer host e la scheda

1. Collegare la scheda al computer host tramite un cavo USB da Standard-A a Micro-B.

2. Identificare il numero della porta seriale USB per la connessione alla scheda sul computer host.

3. Avviare un terminale seriale e aprire una connessione con le impostazioni seguenti:

   • Velocità in baud: 115200

   • Dati: 8 bit

   • Parità: nessuna

   • Bit di stop: 1

   • Controllo di flusso: nessuno

Per ulteriori informazioni sull'installazione di un terminale e la configurazione di una connessione seriale, consultare Installazione di un emulatore di terminale.

Monitoraggio dei messaggi MQTT in cloud

Prima di eseguire il progetto demo di FreeRTOS, puoi configurare il client MQTT nellaAWS IoT console per monitorare i messaggi che il tuo dispositivo invia alAWS Cloud.

Per effettuare la sottoscrizione all'argomento MQTT con il client AWS IoT

1. Accedi alla console AWS IoT.

2. Nel pannello di navigazione, scegli Test, quindi scegli MQTT test client per aprire il client MQTT.

3. In Argomento sottoscrizione, digitare your-thing-name/example/topic, quindi scegliere Effettua sottoscrizione all'argomento.

Crea ed esegui il progetto demo FreeRTOS

Dopo aver impostato una connessione seriale alla scheda, è possibile creare il progetto demo FreeRTOS, eseguire il flashing della demo sulla scheda e quindi eseguire la demo.

Per creare ed eseguire il progetto demo FreeRTOS in WICED Studio

1. Avviare WICED Studio.

2. Dal menu File scegliere Import (Importa). Espandere la cartella General, scegliere Existing Projects into Workspace (Progetti esistenti in Workspace) e Next (Successivo).

3. In Select root directory (Seleziona directory root), selezionare Browse... (Sfoglia...), passare al percorso freertos/projects/cypress/CYW954907AEVAL1F/wicedstudio, quindi selezionare OK.

4. In Projects (Progetti), selezionare la casella solo per il progetto aws_demo . Selezionare Finish (Fine) per importare il progetto. Il progetto di destinazione aws_demo (aws_demo) dovrebbe comparire nella finestra Make Target (Crea destinazione).

5. Espandere il menu WICED Platform (Piattaforma WICED) e selezionare WICED Filters off (Disattiva filtri WICED).

6. Nella finestra Make Target (Crea destinazione), espandere aws_demo (aws_demo), fare clic con il tasto destro del mouse sul file demo.aws_demo, quindi selezionare Build Target (Compila destinazione) per compilare e scaricare la demo sulla scheda. L'esecuzione della demo dovrebbe avvenire automaticamente dopo che viene compilata e scaricata nella scheda.

Risoluzione dei problemi

• Se si utilizza Windows, quando si compila e si esegue il progetto demo si potrebbe ricevere il seguente errore:

  : recipe for target 'download_dct' failed
  make.exe[1]: *** [download_dct] Error 1

  Per risolvere questo errore, eseguire questi passaggi:

  1. Passa a WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32 e fai doppio clic su openocd-all-brcm-libftdi.exe.

  2. Passa a WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1 e fai doppio clic su InstallDriver.exe.

• Se si utilizza Linux o macOS, quando si compila e si esegue il progetto demo si potrebbe ricevere il seguente errore:

  make[1]: *** [download_dct] Error 127

  Per risolvere questo errore, utilizza il comando seguente per aggiornare il pacchetto libusb-dev:

  sudo apt-get install libusb-dev

Per informazioni generali sulla risoluzione dei problemi relativi a Getting Started with FreeRTOS, consultaNozioni di base sulla risoluzione dei problemi.