View a markdown version of this page

Cómo empezar con el kit Cypress CY8CKIT-064S0S2-4343W - FreeRTOS
IntroducciónEntorno de desarrolloHardwareCree y ejecuteDebuggingActualizaciones OTA

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 kit Cypress CY8CKIT-064S0S2-4343W

importante

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

En este tutorial se proporcionan instrucciones para empezar a utilizar el CY8CKIT-064S0S2-4343Wkit. 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 empezar, debes configurar AWS IoT FreeRTOS para conectar tu dispositivo a la AWS nube. Para obtener instrucciones, consulte Primeros pasos. Tras completar los requisitos previos, dispondrá de un paquete AWS IoT Core FreeRTOS con credenciales.

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. Puedes usarlo ModusToolbox para tu flujo de compilación de Make. Puede usar el IDE de Eclipse suministrado con ModusToolbox o con 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 el software más recienteModusToolbox . Para obtener más información, consulte la Guía ModusToolbox de instalación.

Herramientas de actualización para la ModusToolbox versión 2.1 o anterior

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

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.

Actualización de 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 Firmware-loader

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

Para actualizar Cypress Firmware-loader

  1. Ve a la página de Firmware-loader lanzamiento de Cypress.

  2. Descargue el archivo comprimido 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 CY8CKIT-064S0S2-4343W kit para aprovisionar su kit de forma segura. AWS IoT

    Este kit requiere la CySecureTools versión 3.1.0 o una versión 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 ModusToolbox y elija o cree un espacio de trabajo.

    2. En el menú File, elija Import.

      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 MQTT en la AWS IoT consola para supervisar los mensajes que su dispositivo envía a la AWS nube. Para suscribirse al tema MQTT con el cliente AWS IoT MQTT, 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. Ejecución del proyecto de demostración de FreeRTOS

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

    2. En el Panel rápido, seleccione el programa aws_demos (3). KitProg 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.

      Captura de pantalla de la salida del terminal después de crear el proyecto aws_demo.

      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. Del 1 al 4: el dispositivo se conecta al punto de acceso (AP) configurado y se aprovisiona conectándose al AWS servidor 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.

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

      ejemplo
       -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 FreeRTOS.

  • Demostración de Bluetooth de bajo consumo

  • Over-the-Air Demostración de actualizaciones

  • Demostración de cliente de Echo de sockets seguros

  • AWS IoT Demostración de Device Shadow

Debugging

Los KitProg 3 del kit admiten 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 aws_demos Debug KitProg (3) en el Panel rápido.

Actualizaciones OTA

Los MCU PSoC 64 han superado todas las pruebas de calificación de FreeRTOS requeridas. Sin embargo, la función inalámbrica (OTA) opcional implementada en la biblioteca de firmware PSoC 64 Standard Secure aún está pendiente de evaluación. AWS 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 se aplica una imagen OTA validada correctamente a un dispositivo mediante el PSoC64 Standard Secure ( AWS MCU) y el dispositivo no puede comunicarse con ella AWS IoT Core, el dispositivo no puede volver automáticamente a la imagen original en buen estado. Esto puede provocar que no se pueda acceder al dispositivo para realizar más actualizaciones. AWS IoT Core El equipo de Cypress aún está desarrollando esta funcionalidad.

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