Introducción al kit Cypress CY8CKIT-064S0S2-4343W

importante

Esta integración de referencia está alojada en el repositorio de Amazon-FreeRTOS, que está en desuso. Recomendamos empezar por aquí 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.

Este tutorial proporciona instrucciones para empezar a utilizar el kit CY8CKIT-064S0S2-4343W. Si aún no lo tiene, puede usar ese enlace para adquirir un kit. También puede usar ese enlace para acceder a la guía del usuario del kit.

Introducción

Antes de comenzar, debe configurar AWS IoT y FreeRTOS para conectar el dispositivo a la nube de AWS. Para obtener instrucciones, consulte Primeros pasos. Después de completar los requisitos previos, tendrá un paquete de FreeRTOS con credenciales de AWS IoT Core.

nota

En este tutorial, la ruta al directorio de descargas de FreeRTOS creado en la sección “Primeros pasos” se denomina freertos.

Configuración del entorno de desarrollo

FreeRTOS funciona con un flujo de creación de CMake o Make. Puede usar ModusToolbox para su flujo de creación de Make. Puede usar el IDE de Eclipse que se entrega con ModusToolbox o un IDE asociado, como IAR EW-Arm, Arm MDK o Microsoft Visual Studio Code. El IDE de Eclipse es compatible con los sistemas operativos Windows, macOS y Linux.

Antes de empezar, descargue e instale la última versión del software ModusToolbox. Para obtener más información, consulte la Guía de instalación de ModusToolbox.

Herramientas de actualización para ModusToolbox 2.1 o versiones anteriores

Si utiliza el IDE ModusToolbox 2.1 de Eclipse para programar este kit, tendrá que actualizar las herramientas OpenOCD y Firmware-Loader.

En los siguientes pasos, la ruta ModusToolbox predeterminada para:

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

• Linux es user_home/ModusToolbox o la ubicación donde elija extraer el archivo comprimido.

• MacOS se encuentra en la carpeta Aplicaciones del volumen que seleccione en el asistente.

Actualización de OpenOCD

Este kit requiere Cypress OpenOCD 4.0.0 o posterior para borrar y programar correctamente el chip.

Para actualizar Cypress OpenOCD

1. Vaya a la página de la versión de Cypress OpenOCD.

2. Descargue el archivo de almacenamiento para su sistema operativo (Windows/Mac/Linux).

3. Elimine los archivos existentes en ModusToolbox/tools_2.x/openocd.

4. Sustituya los archivos de ModusToolbox/tools_2.x/openocd por el contenido extraído del archivo que descargó en un paso anterior.

Actualización de Firmware-loader

Este kit requiere Cypress Firmware-Loader 3.0.0 o una versión posterior.

Para actualizar Cypress Firmware-Loader

1. Vaya a la página de la versión de Cypress Firmware-loader.

2. Descargue el archivo de almacenamiento para su sistema operativo (Windows/Mac/Linux).

3. Elimine los archivos existentes en ModusToolbox/tools_2.x/fw-loader.

4. Sustituya los archivos de ModusToolbox/tools_2.x/fw-loader por el contenido extraído del archivo que descargó en un paso anterior.

Como alternativa, puede usar CMake para generar archivos de creación del proyecto a partir del código fuente de la aplicación FreeRTOS, crear el proyecto con su herramienta de creación preferida y luego programar el kit con OpenOCD. Si prefiere usar una herramienta de interfaz gráfica de usuario para programar con el flujo de CMake, descargue e instale Cypress Programmer desde la página web de Cypress Programming Solutions. Para obtener más información, consulte Uso de CMake con FreeRTOS.

Configurar su hardware

Siga estos pasos para configurar el hardware del kit.

1. Aprovisione el kit

   Siga las instrucciones de la Guía de aprovisionamiento del kit CY8CKIT-064S0S2-4343W para aprovisionar el kit a AWS IoT de forma segura.

   Este kit requiere CySecureTools 3.1.0 o posterior.

2. Configure una conexión serie

   1. Conecte el kit al equipo host.

   2. El puerto serie USB del kit se enumera automáticamente en el equipo host. Identifique el número de puerto. En Windows, puede identificarlo mediante el Administrador de dispositivos en Puertos (COM y LPT).

   3. Inicie un terminal serie y abra una conexión con los siguientes valores de configuración:

      • Velocidad en baudios: 115 200

      • Datos: 8 bits

      • Paridad: ninguna

      • Bits de parada: 1

      • Control del flujo: ninguno

Creación y ejecución del proyecto de demostración de FreeRTOS

En esta sección, creará y ejecutará la demostración.

1. Asegúrese de seguir los pasos de la Guía de aprovisionamiento del kit CY8CKIT-064S0S2-4343W.

2. Cree la demostración de FreeRTOS.

   1. Abra el IDE de Eclipse para ModusToolbox y elija o cree un espacio de trabajo.

   2. En el menú Archivo, elija Importar.

      Expanda General, elija Proyectos existentes en el espacio de trabajo y, a continuación, elija Siguiente.

   3. En Directorio raíz, introduzca freertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demos y, a continuación, seleccione el nombre del proyecto aws_demos. Debería seleccionarse de forma predeterminada.

   4. Elija Finalizar para importar el proyecto en su espacio de trabajo.

   5. Cree la aplicación realizando una de las siguientes operaciones:

      • En Panel rápido, seleccione Crear la aplicación aws_demos.

      • Elija Proyecto y, a continuación, elija Crear todo.

      Asegúrese de que el proyecto se crea sin errores.

3. Monitorización de mensajes de MQTT en la nube

   Antes de ejecutar la demostración, puede configurar el cliente de MQTT en la consola de AWS IoT para monitorizar los mensajes que envía el dispositivo a la nube de AWS. Para suscribirse al tema de MQTT con el cliente de MQTT de AWS IoT, siga estos pasos.

   1. Inicie sesión en la consola de AWS IoT.

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

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

4. Ejecute el proyecto de demostración de FreeRTOS

   1. Seleccione el proyecto aws_demos en el espacio de trabajo.

   2. En Panel rápido, seleccione el programa aws_demos (KitProg3). Esto programa la placa y la aplicación de demostración comienza a ejecutarse una vez finalizada la programación.

   3. Puede ver el estado de la aplicación que se está ejecutando en el terminal serie. La siguiente figura muestra una parte de la salida del terminal.

      

      La demostración de MQTT publica mensajes sobre cuatro temas diferentes (iotdemo/topic/n, donde n=1 a 4) y se suscribe a todos esos temas para recibir los mismos mensajes. Cuando se recibe un mensaje, la demostración publica un mensaje de acuse de recibo sobre el tema iotdemo/acknowledgements. La siguiente lista describe los mensajes de depuración que aparecen en la salida del terminal, con referencias a los números de serie de los mensajes. En la salida, los detalles del controlador WICED Host Driver (WHD) se imprimen primero sin numeración de serie.

      1. 1 al 4 - El dispositivo se conecta al punto de acceso (AP) configurado y se aprovisiona conectándose al servidor AWS mediante el punto de conexión y los certificados configurados.

      2. 5 a 13 - La biblioteca coreMQTT se inicializa y el dispositivo establece la conexión MQTT.

      3. 14 a 17 - El dispositivo se suscribe a todos los temas para recibir los mensajes publicados.

      4. 18 a 30 - El dispositivo publica dos mensajes y espera a recibirlos de vuelta. Cuando se recibe cada mensaje, el dispositivo envía un mensaje de acuse de recibo.

      El mismo ciclo de publicación, recepción y acuse de recibo continúa hasta que se publiquen todos los mensajes. Se publican dos mensajes por ciclo hasta completar el número de ciclos configurado.

5. Uso de CMake con FreeRTOS

   También puede utilizar CMake para crear y ejecutar la aplicación de demostración. Para configurar CMake y un sistema de compilación nativo, consulte Requisitos previos.

   1. Utilice el siguiente comando para generar archivos de creación. Especifique la placa de destino con la opción -DBOARD.

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

      Si utiliza Windows, debe especificar el sistema de creación nativo con la opción -G porque CMake utiliza Visual Studio de forma predeterminada.

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

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

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

   2. Utilice el siguiente comando para crear el proyecto con CMake.

      cmake --build build_dir

   3. Por último, programe los archivos cm0.hex y cm4.hex generados en build_dir mediante Cypress Programmer.

Ejecución de otras demostraciones

Se ha probado y verificado que las siguientes aplicaciones de demostración funcionan con la versión actual. Puede encontrar estas demostraciones en el directorio freertos/demos. Para obtener información sobre cómo ejecutar estas demostraciones, consulte Demostraciones de FreRTOS.

• Demostración de Bluetooth de bajo consumo

• Demostración de actualizaciones inalámbricas

• Demostración de cliente de Echo de sockets seguros

• Demostración de sombra de dispositivo de AWS IoT

Debugging

El KitProg3 del kit admite la depuración mediante el protocolo SWD.

• Para depurar la aplicación FreeRTOS, seleccione el proyecto aws_demos en el espacio de trabajo y, a continuación, seleccione Depuración de aws_demos (KitProg3) en Panel rápido.

Actualizaciones OTA

Los MCU PSoC 64 han superado todas las pruebas de calificación de FreeRTOS requeridas. Sin embargo, la característica inalámbrica (OTA) opcional implementada en la biblioteca de firmware de AWS PSoC 64 Standard Secure aún está pendiente de evaluación. La característica OTA, tal como está implementada, supera actualmente todas las pruebas de calificación de OTA, excepto la de aws_ota_test_case_rollback_if_unable_to_connect_after_update.py.

Cuando una imagen OTA validada correctamente se aplica a un dispositivo mediante el estándar PSoC64 Standard Secure - MCU de AWS y el dispositivo no puede comunicarse con AWS IoT Core, el dispositivo no puede revertir automáticamente a la imagen original conocida correcta. Esto puede provocar que no se pueda acceder al dispositivo desde AWS IoT Core para realizar más actualizaciones. El equipo de Cypress aún está desarrollando esta funcionalidad.

Para obtener más información, consulte Actualizaciones OTA con AWS y el kit CY8CKIT-064S0S2-4343W. Si tiene más preguntas o necesita asistencia técnica, póngase en contacto con la Comunidad de desarrolladores de Cypress.