

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Introducción al STMicroelectronics STM32L4 Discovery Kit IoT Node
<a name="getting_started_st"></a>

**importante**  <a name="deprecation-message"></a>
Esta integración de referencia está alojada en el Amazon-FreeRTOS repositorio, que está en desuso. Recomendamos [empezar por aquí](freertos-getting-started-modular.md) al crear un nuevo proyecto. Si ya tiene un proyecto de Freertos existente basado en el Amazon-FreeRTOS repositorio ahora obsoleto, consulte la. [Amazon-FreeRTOS Guía de migración del repositorio de Github](github-repo-migration.md)

Este tutorial ofrece instrucciones para la introducción a STMicroelectronics STM32L4 Discovery Kit IoT Node. [Si aún no tiene el nodo IoT STM32L4 Discovery Kit de STMicroelectronics, visite AWS el catálogo de dispositivos asociados para comprar uno de nuestros socios.](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)

Asegúrese de haber instalado el firmware más reciente. Wi-Fi Para descargar el Wi-Fi firmware más reciente, consulte el [nodo IoT del kit STM32L4 Discovery, inalámbrico de bajo consumo, Bluetooth de bajo consumo, NFC, subGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi En **Recursos binarios**, seleccione la **actualización del firmware del Wi-Fi módulo Inventek ISM 43362** (lea las instrucciones en el archivo readme).

Antes de empezar, debe configurar AWS IoT, descargar FreeRTOS y conectar su dispositivo Wi-Fi a la AWS nube. Para obtener instrucciones, consulte [Primeros pasos](freertos-prereqs.md). En este tutorial, la ruta al directorio de descargas de FreeRTOS se denomina `{{freertos}}`.

## Descripción general de
<a name="w2aac31b9b7c25c46c13"></a>

Este tutorial contiene instrucciones para los siguientes pasos de introducción:

1. Instalación de software en el equipo host para desarrollar y depurar las aplicaciones integradas de la placa de su microcontrolador.

1. Compilación cruzada de una aplicación de demostración de FreeRTOS en una imagen binaria.

1. Carga de la imagen binaria de la aplicación en su placa y, a continuación, ejecución de la aplicación.

## Cómo configurar el entorno de desarrollo.
<a name="st-setup-env"></a>

### Instalación de System Workbench para STM32
<a name="install-system-workbench"></a>

1. Desplácese hasta [OpenSTM32.org](http://www.openstm32.org/HomePage).

1. Regístrese en la página web OpenSTM32. Debe para iniciar sesión para descargar System Workbench.

1. Vaya al [instalador de System Workbench para STM32](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32) para descargar e instalar System Worbench.

Si tiene problemas durante la instalación, consulte las preguntas frecuentes en el [sitio web de System Workbench](http://www.openstm32.org/HomePage).

## Creación y ejecución del proyecto de demostración de FreeRTOS
<a name="st-build-and-run-example"></a>

### Importación de la demostración de FreeRTOS a STM32 System Workbench
<a name="st-freertos-import-project"></a><a name="st-import-project"></a>

1. Abra STM32 System Workbench y escriba un nombre para un espacio de trabajo nuevo.

1. En el menú **File**, elija **Import**. Expanda **General**, elija **Existing Projects into Workspace (Proyectos existentes a Workspace)** y, a continuación, elija **Next (Siguiente)**.

1. En **Select Root Directory (Seleccionar directorio raíz)**, escriba `projects/st/stm32l475_discovery/ac6/aws_demos`.

1. El proyecto `aws_demos` debe seleccionarse de forma predeterminada.

1. Elija **Finish (Finalizar)** para importar el proyecto a STM32 System Workbench.

1. En el menú **Project (Proyecto)** elija **Build All (Compilar todo)**. Confirme que el proyecto se compila sin ningún error.

### Monitorización de mensajes de MQTT en la nube
<a name="w2aac31b9b7c25c46c17b5"></a>

Antes de ejecutar el proyecto de demostración de Freertos, puede configurar el cliente MQTT en la AWS IoT consola para supervisar los mensajes que su dispositivo envía a la nube. AWS 

**Para suscribirse al tema MQTT con el AWS IoT Cliente MQTT**

1. Inicie sesión en la [consola de AWS IoT](https://console.aws.amazon.com/iotv2/).

1. En el panel de navegación, seleccione **Probar** y, a continuación, seleccione el **cliente de prueba MQTT** para abrir el cliente MQTT.

1. En **Tema de suscripción**, escriba **{{your-thing-name}}/example/topic** y, a continuación, elija **Suscribirse al tema**.

Cuando el proyecto de demostración se ejecute correctamente en su dispositivo, verá el mensaje “¡Hola, mundo\!” enviado varias veces al tema al que se ha suscrito.

### Ejecución del proyecto de demostración de FreeRTOS
<a name="st-run-example"></a>

1. Utilice un cable USB para conectar su STMicroelectronics STM32L4 Discovery Kit IoT Node a su equipo. (Consulte la documentación del fabricante que viene con la placa para saber cuál es el puerto USB correcto que debe utilizar).

1. En el **Explorador de proyectos**, haga clic con el botón derecho del ratón`aws_demos`, seleccione **Depurar como** y, a continuación, seleccione la aplicación **Ac6 STM32 \+\+ C/C**.

   Si se produce un error de depuración al lanzar por primera vez una sesión de depuración, siga estos pasos:

   1. En System Workbench STM32, en el menú **Run (Ejecutar)**, elija **Debug Configurations (Configuraciones de depuración)**.

   1. Elija **aws\_demos Debug (Depurar demos\_aws)**. (Es posible que tenga que ampliar **Ac6 STM32 Debugging (Depuración de Ac6 STM32)**.)

   1. Elija la pestaña **Debugger (Depurador)**.

   1. En **Configuration Script (Script de configuración)**, elija **Show Generator Options (Mostrar opciones del generador)**.

   1. En **Mode Setup (Configuración de modo)**, establezca **Reset Mode (Modo de restablecimiento)** en **Software System Reset (Restablecimiento de sistema de software)**. Elija **Apply (Aplicar)** y, a continuación, **Debug (Depurar)**. 

1. Cuando el depurador se detenga en el punto de ruptura en `main()`, desde el menú **Run (Ejecutar)**, elija **Resume (Reanudar)**.

### Uso de CMake con FreeRTOS
<a name="w2aac31b9b7c25c46c17b9"></a>

Si prefiere no utilizar un IDE para el desarrollo de FreeRTOS, también puede usar CMake para crear y ejecutar las aplicaciones de demostración o las aplicaciones que ha desarrollado con herramientas de depuración y editores de código de terceros.

Primero cree una carpeta que contenga los archivos de compilación generados (). {{build-folder}}

Utilice el siguiente comando para generar archivos de creación:

```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S {{freertos}} -B {{build-folder}}
```

Si `arm-none-eabi-gcc` no se encuentra en la ruta del shell, también debe configurar la variable `AFR_TOOLCHAIN_PATH` de CMake. Por ejemplo:

```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```

Para obtener más información sobre cómo usar CMake con FreeRTOS, consulte [Uso de CMake con FreeRTOS](getting-started-cmake.md).

## Resolución de problemas
<a name="st-troubleshooting"></a>

Si ve lo siguiente en el resultado del UART de la aplicación de demostración, debe actualizar el firmware del Wi-Fi módulo:

```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```

Para descargar el Wi-Fi firmware más reciente, consulte el [nodo IoT del kit STM32L4 Discovery, inalámbrico de bajo consumo, Bluetooth de bajo consumo, NFC, subGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi **En **Recursos binarios**, seleccione el enlace de descarga para ver la actualización del firmware del módulo Inventek ISM 43362. Wi-Fi **

Si necesita información general de solución de problemas que pueden surgir al empezar a trabajar con FreeRTOS, consulte [Introducción a solución de problemas](gsg-troubleshooting.md).