Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Guida introduttiva al Cypress CYW943907 AEVAL1 F Development Kit
<a name="getting_started_cypress_43"></a>

**Importante**  <a name="deprecation-message"></a>
Questa integrazione di riferimento è ospitata nel repository Amazon-FreeRTOS che è obsoleto. Ti consigliamo di [iniziare da qui quando crei un nuovo progetto](freertos-getting-started-modular.md). Se disponi già di un progetto FreeRTOS esistente basato sull'ormai obsoleto repository Amazon-FreerTOS, consulta il. [Guida alla migrazione del repository Github di Amazon-FreeRTOS](github-repo-migration.md)

Questo tutorial fornisce istruzioni per iniziare con il Cypress F Development Kit. CYW943907 AEVAL1 [Se non disponi del Cypress CYW943907 AEVAL1 F Development Kit, visita il AWS Partner Device Catalog per acquistarne uno dal nostro partner.](https://devices.amazonaws.com/detail/a3G0L00000AAPg0UAH/CYW943907AEVAL1F)

**Nota**  
Questo tutorial illustra la configurazione e l'esecuzione della demo di autenticazione reciproca di CoreMQTT. La porta FreerTOS per questa scheda attualmente non supporta le demo del server e del client TCP.

Prima di iniziare, devi configurare AWS IoT e scaricare FreerTOS per connettere il tuo dispositivo al Cloud. AWS Per istruzioni, consulta [Fase iniziale](freertos-prereqs.md).

**Importante**  
In questo argomento, il percorso della directory di download di FreerTOS viene definito come. `{{freertos}}`
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 delle 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:  
Attiva la [modalità sviluppatore](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) o, 
Utilizza una console con privilegi elevati di amministratore.
In questo modo, Windows può creare correttamente collegamenti simbolici quando estrae l'archivio. In caso contrario, i collegamenti simbolici verranno scritti come normali file che contengono i percorsi dei collegamenti simbolici sotto forma di testo o sono vuoti. Per ulteriori informazioni, consultate il post di blog [Symlinks in Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .  
Se usi Git in Windows, devi abilitare la modalità sviluppatore oppure devi:   
`core.symlinks`Imposta 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 sul sistema (ad esempio, **git pull****git clone**, e**git submodule update --init --recursive**).
Come indicato in[Scaricare FreerTOS](freertos-prereqs.md#freertos-download), le porte FreerTOS per Cypress sono attualmente disponibili solo su. [ GitHub](https://github.com/aws/amazon-freertos)

## Panoramica di
<a name="overview-for-cypress-tutorial"></a>

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.

1. Compilazione incrociata di un'applicazione demo FreerTOS con un'immagine binaria.

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

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

## Configurazione dell'ambiente di sviluppo
<a name="cypress43-setup-env"></a>

### Scaricare e installare l'SDK WICED Studio
<a name="cypress43-install-wiced-studio"></a>

In questa guida introduttiva, utilizzi l'SDK Cypress WICED Studio per programmare la tua scheda con la demo di FreerTOS. Visita il sito Web del [software WICED](https://www.cypress.com/products/wiced-software) 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
<a name="cypress43-environment"></a>

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**.

1. Nella scheda **Avanzate**, scegliere **Variabili di ambiente**.

1. In **Variabili utente** scegliere **Nuova**.

1. 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
   ```

1. Riavviare il computer.

1. 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
<a name="cypress43-serial-connection"></a>

**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.

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

1. 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](gsg-troubleshooting.md#uart-term).

## Monitoraggio dei messaggi MQTT in cloud
<a name="cypress43-monitor-mqtt"></a>

Prima di eseguire il progetto demo FreerTOS, puoi configurare il client MQTT nella console per monitorare AWS IoT i messaggi che il tuo dispositivo invia al Cloud. AWS 

**Per iscriversi all'argomento MQTT con il client MQTT AWS IoT**

1. Accedi alla [console AWS IoT](https://console.aws.amazon.com/iotv2/).

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

1. In **Argomento sottoscrizione**, digitare **{{your-thing-name}}/example/topic**, quindi scegliere **Effettua sottoscrizione all'argomento**.

## Crea ed esegui il progetto demo FreerTOS
<a name="gsg-cypress43-build-and-run-example"></a>

Dopo aver impostato una connessione seriale alla tua scheda, puoi creare il progetto demo FreerTOS, eseguire il flashing della demo sulla tua scheda e quindi eseguire la demo.

**Per creare ed eseguire il progetto demo FreerTOS in WICED Studio**

1. Avviare WICED Studio.

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

1. In **Select root directory (Seleziona directory root)**, selezionare **Browse... (Sfoglia...)**, passare al percorso `{{freertos}}/projects/cypress/CYW943907AEVAL1F/wicedstudio`, quindi selezionare **OK**.

1. 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)**.

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

1. 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
<a name="cypress43-troubleshooting"></a>
+ 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`.

  1. 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 su Getting Started with FreerTOS, consulta. [Nozioni di base sulla risoluzione dei problemi](gsg-troubleshooting.md)