Guida introduttiva al kit Cypress CY8CKIT-064S0S2-4343W

Importante

Questa integrazione di riferimento è ospitata nel repository Amazon-FreeRTOS che è obsoleto. Ti consigliamoinizia da quidurante la creazione di 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 usareCY8CKIT-064S0S2-4343Wkit. Se non disponi già dell'account, ne richiederemo la creazione durante la registrazione. Puoi anche utilizzare quel link per accedere alla guida per l'utente del kit.

Nozioni di base

Prima di iniziare, ne richiederemo la configurazioneAWS IoTe FreerTOS per connettere il tuo dispositivo alAWSNuvola. Per istruzioni, consulta Fase iniziale. Dopo aver completato i prerequisiti, avrai un pacchetto FreerTOS conAWS IoT Corecredenziali.

Nota

In questo tutorial, il percorso della directory di download di FreerTOS creata nella sezione «Primi passi» è indicato comefreertos.

Configurazione dell'ambiente di sviluppo

FreerTOS funziona con un flusso di build CMake o Make. Puoi usare ModusToolbox per il tuo Make build flow. È possibile utilizzare l'IDE Eclipse fornito con ModusToolbox o un IDE partner come IAR EW-Arm, Arm MDK o Microsoft Visual Studio Code. Eclipse IDE è compatibile con i sistemi operativi Windows, macOS e Linux.

Prima di iniziare, scarica e installa la versione più recenteModusToolbox software. Per ulteriori informazioni, consulta laModusToolbox Guida all'installazione.

Strumenti di aggiornamento per ModusToolbox 2.1 o precedente

Se si dispone di un account ModusToolbox 2.1 Eclipse IDE per programmare questo kit, è necessario aggiornare gli strumenti OpenOCD e Firmware-Loader.

Nei passaggi seguenti, per impostazione predefinitaModusToolboxpercorso per:

• Windows èC:\Users\user_name\ModusToolbox.

• Linux èuser_home/ModusToolboxo dove scegli di estrarre il file di archivio.

• macOS si trova nella cartella Applicazioni del volume selezionato nella procedura guidata.

Aggiornamento di OpenOCD

Questo kit richiede Cypress OpenOCD 4.0.0 o successivo per cancellare e programmare correttamente il chip.

Per aggiornare Cypress OpenOCD

1. Vai allaPagina di rilascio di Cypress OpenOCD.

2. Scarica il file di archivio per il tuo sistema operativo (Windows/Mac/Linux).

3. Elimina i file esistenti inModusToolbox/tools_2.x/openocd.

4. Sostituisci i file inModusToolbox/tools_2.x/openocdcon i contenuti estratti dell'archivio che è stata scaricata nel passaggio precedente.

Aggiornamento del firmware-Loader

Questo kit richiede Cypress Firmware-Loader 3.0.0 o versione successiva.

Per aggiornare Cypress Firmware-Loader

1. Vai allaPagina di rilascio di Cypress Firmware-Loader.

2. Scarica il file di archivio per il tuo sistema operativo (Windows/Mac/Linux).

3. Elimina i file esistenti inModusToolbox/tools_2.x/fw-loader.

4. Sostituisci i file inModusToolbox/tools_2.x/fw-loadercon i contenuti estratti dell'archivio che è stata scaricata nel passaggio precedente.

In alternativa, puoi usare CMake per generare file di build del progetto dal codice sorgente dell'applicazione FreerTOS, creare il progetto utilizzando il tuo strumento di compilazione preferito e quindi programmare il kit utilizzando OpenOCD. Se preferisci utilizzare uno strumento GUI per la programmazione con il flusso CMake, scarica e installa Cypress Programmer dalSoluzioni di programmazione Cypresspagina web. Per ulteriori informazioni, consulta Usare CMake con FreerTOS.

Configurazione dell'hardware

Segui questi passaggi per configurare l'hardware del kit.

1. Esegui il provisioning del kit

   Segui ilGuida alla fornitura per il kit CY8CKIT-064S0S2-4343Wistruzioni per fornire in modo sicuro il kit perAWS IoT.

   Questo kit richiede CySecureTools 3.1.0 o versione successiva.

2. Configura una connessione seriale

   1. Connect il kit al computer host.

   2. La porta seriale USB del kit viene automaticamente enumerata sul computer host. Identifica il numero di porta. In Windows, è possibile identificarlo utilizzandoGestione dei dispositivisottoporti(COM E LPT).

   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

Crea ed esegui il progetto FreerTOS Demo

In questa sezione crei ed esegui la demo.

1. Assicurati di seguire la proceduraGuida alla fornitura per il kit CY8CKIT-064S0S2-4343W.

2. Crea la demo di FreerTOS.

   1. Apri l'IDE di Eclipse per ModusToolbox e scegli, o crea, uno spazio di lavoro.

   2. Dal menu File scegliere Import (Importa).

      EspandiGenerale, scegliProgetto esistente in Workspace, e poi scegliAvanti.

   3. NelDirectory principale, immetterefreertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demose quindi seleziona il nome del progettoaws_demos. Per impostazione predefinita, ne richiederemo la selezione.

   4. ScegliFinireper importare il progetto nel tuo spazio di lavoro.

   5. Create l'applicazione effettuando una delle seguenti operazioni:

      • DalPannello rapido, selezionaCrea un'applicazione aws_demos.

      • ScegliProgettoe scegliCostruisci tutto.

      Assicurati che il progetto venga compilato senza errori.

3. Monitoraggio dei messaggi MQTT nel cloud

   Prima di eseguire la demo, è possibile configurare il client MQTT nelAWS IoTconsole per monitorare i messaggi che il dispositivo invia alAWSNuvola. Per abbonarsi all'argomento MQTT conAWS IoTClient MQTT, segui questi passaggi.

   1. Accedi alla console AWS IoT.

   2. Nel riquadro di navigazione, scegliTest, quindi scegliClient di test MQTTper aprire il client MQTT.

   3. PerArgomento dell'account, inserisciyour-thing-name/example/topic, e poi scegliIscriviti all'argomento.

4. Esegui il progetto demo FreerTOS

   1. Seleziona il progettoaws_demosnell'area di lavoro.

   2. DalPannello rapido, selezionaProgramma aws_demos (KitProg3). Questo programma la scheda e l'applicazione demo inizia a funzionare al termine della programmazione.

   3. È possibile visualizzare lo stato dell'applicazione in esecuzione nel terminale seriale. La figura seguente mostra una parte dell'uscita del terminale.

      

      La demo MQTT pubblica messaggi su quattro argomenti diversi (iotdemo/topic/n, dove da n=1 a 4) e si iscrive a tutti questi argomenti per ricevere gli stessi messaggi. Quando viene ricevuto un messaggio, la demo pubblica un messaggio di conferma sull'argomentoiotdemo/acknowledgements. L'elenco seguente descrive i messaggi di debug che appaiono nell'output del terminale, con riferimenti ai numeri di serie dei messaggi. Nell'output, i dettagli del driver WICED Host Driver (WHD) vengono stampati per primi senza numerazione seriale.

      1. da 1 a 4: il dispositivo si connette all'Access Point (AP) configurato e viene fornito collegandosi alAWSserver che utilizza l'endpoint e i certificati configurati.

      2. da 5 a 13 — La libreria CoreMQTT viene inizializzata e il dispositivo stabilisce una connessione MQTT.

      3. Da 14 a 17 — Il dispositivo si iscrive a tutti gli argomenti per ricevere di nuovo i messaggi pubblicati.

      4. Da 18 a 30: il dispositivo pubblica due messaggi e attende di riceverli. Quando ogni messaggio viene ricevuto, il dispositivo invia un messaggio di conferma.

      Lo stesso ciclo di pubblicazione, ricezione e conferma continua fino alla pubblicazione di tutti i messaggi. Vengono pubblicati due messaggi per ciclo fino al completamento del numero di cicli configurati.

5. Usare CMake con FreerTOS

   Puoi anche utilizzare CMake per creare ed eseguire l'applicazione demo. Per configurare CMake e un sistema di build nativo, vediPrerequisiti.

   1. Utilizzate il seguente comando per generare i file di build. Specificate la scheda di destinazione con-DBOARDopzione.

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir

      Se utilizzi Windows, devi specificare il sistema di compilazione nativo utilizzando-Gopzione perché CMake utilizza Visual Studio per impostazione predefinita.

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir -G Ninja

      Se arm-none-eabi-gcc non è incluso nel percorso della shell, è inoltre necessario impostare la variabile CMake AFR_TOOLCHAIN_PATH.

       -DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin

   2. Usa il seguente comando per creare il progetto usando CMake.

      cmake --build build_dir

   3. Infine, programma ilcm0.hexecm4.hexfile generati conbuild_dirutilizzando Cypress Programmer.

Esecuzione di altre demo

Le seguenti applicazioni demo sono state testate e verificate per funzionare con la versione corrente. Puoi trovare queste demo sottofreertos/demosrubrica. Per informazioni su come eseguire queste demo, consultaDemo FreeRTOS FreeRS.

• Demo Bluetooth Low Energy

• Demo degli aggiornamenti via etere

• Dimostrazione del client Secure Sockets Echo

• AWS IoTDemo di Device Shadow

Debug

Il KitProg3 del kit supportano il debug tramite il protocollo SWD.

• Per eseguire il debug dell'applicazione FreerTOS, selezionaprogetto aws_demosnell'area di lavoro e quindi selezionaaws_demos Debug (KitProg3)dalPannello rapido.

Aggiornamenti OTA

Gli MCU PSoC 64 hanno superato tutti i test di qualificazione FreerTOS richiesti. Tuttavia, l'opzionale over-the-airFunzionalità (OTA) implementata nel PSoC 64 Standard SecureAWSla libreria del firmware è ancora in attesa di valutazione. La funzionalità OTA così come implementata attualmente supera tutti i test di qualificazione OTA tranneaws_ota_test_case_rollback_if_unable_to_connect_after_update.py.

Quando un'immagine OTA convalidata con successo viene applicata a un dispositivo utilizzando PSOC64 Standard Secure —AWSNon si dispone di un account, ne richiederemo la comunicazioneAWS IoT Core, il dispositivo non può tornare automaticamente alla buona immagine originale nota. Ciò potrebbe rendere il dispositivo non raggiungibile daAWS IoT Coreper ulteriori aggiornamenti. Questa funzionalità è ancora in fase di sviluppo da parte del team di Cypress.

Per ulteriori informazioni, consulta la paginaAggiornamenti OTA conAWSe il kit CY8CKIT-064S0S2-4343W. Se avete ulteriori domande o avete bisogno di assistenza tecnica, contattate ilComunità di sviluppatori di Cypress.