

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.

# Cómo empezar con el nodo IoT STMicroelectronics STM32 L4 Discovery Kit
<a name="getting_started_st"></a>

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

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

Asegúrese de tener instalada la última versión de firmware de Wi-Fi. Para descargar el firmware de Wi-Fi más reciente, consulte el [nodo IoT del kit STM32 L4 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. Bajo **Binary Resources (Recursos binarios)**, elija **Inventek ISM 43362 Wi-Fi module firmware update (read the readme file for instructions) (Actualización de firmware del módulo wifi ISM 43362 de Inventek [lea el archivo Léame para obtener instrucciones])**.

Antes de empezar, debes configurar AWS IoT la descarga de Freertos y el Wi-Fi para conectar tu dispositivo 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>

### Instale System Workbench para STM32
<a name="install-system-workbench"></a>

1. Navegue hasta [STM32Open.org](http://www.openstm32.org/HomePage).

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

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

Si tiene problemas durante la instalación, consulte el FAQs 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>

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

1. Abra el área de trabajo STM32 del sistema e introduzca un nombre para un nuevo espacio de trabajo.

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. Seleccione **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 cliente MQTT AWS IoT**

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\$1” 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 nodo IoT STMicroelectronics STM32 L4 Discovery Kit a su ordenador. (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 Aplicación **Ac6 C/C\$1\$1 STM32 **.

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

   1. **En STM32 System Workbench, en el menú **Ejecutar**, seleccione Depurar configuraciones.**

   1. Elija **aws\$1demos Debug (Depurar demos\$1aws)**. (Puede que necesite expandir **Ac6 STM32 ** Debugging).

   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 CMake con Freertos
<a name="w2aac31b9b7c25c46c17b9"></a>

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

En primer lugar, 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 no `arm-none-eabi-gcc` está en la ruta de tu shell, también debes configurar la `AFR_TOOLCHAIN_PATH` CMake variable. Por ejemplo:

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

Para obtener más información sobre el uso CMake con Freertos, consulte. [Uso CMake con Freertos](getting-started-cmake.md)

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

Si ve lo siguiente en la salida UART de la aplicación de demostración, debe actualizar el firmware del módulo wifi:

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

Para descargar el firmware de Wi-Fi más reciente, consulte el [nodo IoT del kit STM32 L4 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 **Binary Resources (Recursos binarios)**, elija el enlace de descarga para **Inventek ISM 43362 Wi-Fi module firmware update (Actualización de firmware del módulo wifi 43362 ISM de Inventek)**.

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