Calificación de la placa
Requisitos previos
Requisitos de hardware:
La placa de desarrollo basada en MCU en la que se ejecutan las bibliotecas de AWS IoT de FreeRTOS debe tener:
-
Capacidad de conectividad Ethernet, Wi-Fi o móvil
Requisitos de software:
En el diagrama de flujo de portabilidad de la Guía de portabilidad de FreeRTOS se identifican las bibliotecas de AWS IoT de FreeRTOS necesarias para cualquier placa de desarrollo basada en MCU. El subconjunto mínimo es:
Kernel FreeRTOS
coreMQTT
Actualizaciones vía inalámbrica (OTA) de AWS IoT
Requisitos para pruebas:
Verifique la implementación de las API específicas de la plataforma de hardware requeridas por las bibliotecas de FreeRTOS comparándolas con el repositorio de GitHub de pruebas
definidas utilizando AWS IoT Device Tester para FreeRTOS. Consulte Verificación de las bibliotecas de FreeRTOS portadas mediante AWS IoT Device Tester (IDT). Verifique la interoperabilidad con AWS IoT Core mediante Device Advisor. Consulte el paso 4 de Verificación de las bibliotecas de FreeRTOS portadas mediante AWS IoT Device Tester (IDT).
Recomendaciones
Para mejorar la seguridad, recomendamos lo siguiente.
-
Para evitar que un acceso temporal o fuera de línea se convierta en permanente, almacene los secretos y las credenciales en una raíz de confianza de hardware que resista los ataques físicos, como un elemento seguro
o un enclave seguro. -
Para mitigar el riesgo de suplantación
de redes y ataques de intermediarios que pueden provocar la divulgación de datos no autorizada, utilice un generador de números aleatorios verdaderos (TRNG) para las bibliotecas de FreeRTOS que implementan protocolos como DHCP, DNS, TCP/IP y TLS. Para obtener más información, consulte la página 50 de Recomendación para la generación de números aleatorios mediante generadores de bits aleatorios determinísticos (NIST SP 800-90A).
Pasos de la calificación
Verificación de las bibliotecas de FreeRTOS portadas mediante AWS IoT Device Tester (IDT)
Realice la portabilidad de las bibliotecas de FreeRTOS a su placa. Consulte la Guía de portabilidad de FreeRTOS para obtener instrucciones.
Cree un proyecto de prueba y realice la portabilidad de las pruebas necesarias desde el repositorio GitHub de FreeRTOS-Libraries-Integration-Tests
. Llama a la tarea del ejecutor de la prueba RunQualificationTest . nota
Para una buena experiencia de desarrollador, se recomienda realizar la portabilidad de las bibliotecas de FreeRTOS y ejecutar el grupo de pruebas individual correspondiente de forma local mediante un IDE para verificar la integración.
La tarea del ejecutor de pruebas se ejecuta en un proyecto de prueba individual o en su proyecto de aplicación de demostración.
Cree un archivo
manifest.ymlpara enumerar todas las dependencias utilizadas en sus calificaciones. Las dependencias incluyen las bibliotecas de FreeRTOS y los repositorios de pruebas. Para obtener más información, consulte Instrucciones para el archivo de manifiesto de FreeRTOS.nota
IDT utiliza
manifest.ymlpara encontrar las dependencias necesarias para las comprobaciones de integridad con versiones específicas de la biblioteca FreeRTOS y para configurar el proyecto de prueba para crear, instalar y ejecutar los binarios de prueba.IDT no exige una estructura de proyecto específica y utiliza la ruta de referencia incluida en el archivo
manifest.yml.-
Verifique la interoperabilidad de AWS IoT mediante Device Advisor.
-
Cree un proyecto de demostración que utilice los mismos componentes, incluidas las bibliotecas FreeRTOS, la portabilidad y las tareas de integración, como OTA, que se utilizaron en las pruebas anteriores.
Para la calificación, la aplicación de demostración debe proporcionar las siguientes características:
Realizar la publicación y suscripción de MQTT a un tema.
Realizar actualizaciones OTA.
Crear un cargador de arranque compatible con actualizaciones OTA. Use su propio cargador de arranque o MCUBoot
. Consulte Labs-FreeRTOS-Plus-MCUBoot .
nota
El repositorio GitHub de FreeRTOS
tiene ejemplos preconfigurados que muestran tareas individuales. También hay una demostración de agente de coreMQTT integrada que incorpora las tareas de coreMQTT y OTA. Consulte también las integraciones de IoT destacadas de FreeRTOS en Ejemplos de proyectos de calificación. -
AWS IoT Device Tester ejecutará su demostración en AWS IoT Device Advisor. Se requieren los siguientes casos de prueba de Device Advisor para obtener la calificación.
Casos de prueba Caso de prueba Casos de prueba Obligatorio TLS Conexión TLS Sí TLS Compatibilidad de TLS con conjuntos de cifrado de AWS AWS IoT Sí, con los conjuntos de cifrado recomendados TLS Certificado de servidor no seguro de TLS Sí TLS Certificado de servidor con nombre de asunto incorrecto de TLS Sí MQTT Conexión MQTT Sí MQTT Reintentos de fluctuación de conexión MQTT Sí, sin advertencias MQTT Suscripción a MQTT Sí MQTT Publicación MQTT Sí MQTT MQTT ClientPuback Qos1 Sí MQTT MQTT sin acuse recibo de PingResp Sí
-
Ejecute las pruebas desde AWS IoT Device Tester y genere un informe de prueba.
-
IDT configura las pruebas, las crea y las instala en la placa automáticamente. Para habilitarlo, debe configurar IDT para que ejecute los comandos build y flash para su dispositivo en el archivo
userdata.json. Consulte Configuración de los ajustes de creación, instalación y prueba en la Guía del usuario de IDT para FreeRTOS. -
Proporcione en el archivo
device.jsonlas características compatibles con el dispositivo, como el tipo de conectividad, el algoritmo de criptografía y el método de aprovisionamiento de claves, para que IDT determine las pruebas que debe ejecutar. Consulte Creación de un grupo de dispositivos en IDT para FreeRTOS en la Guía del usuario de IDT para FreeRTOS. -
Cree y configure su cuenta de AWS para que IDT cree los recursos de nube necesarios. Consulte Creación y configuración de la cuenta de AWS para que IDT cree los recursos de nube necesarios en la Guía del usuario de IDT para FreeRTOS.
-
Preparación del envío
Escriba una guía de introducción para ejecutar el proyecto de demostración de MQTT u OTA en su dispositivo. Consulte Creación de una guía de introducción a FreeRTOS para su dispositivo para obtener instrucciones.
Proporcione un documento de modelado de amenazas que verifique que mitiga los riesgos definidos en Modelado de amenazas para el cargador de arranque del dispositivo de AWS IoT que se describe en Portabilidad de la biblioteca OTA en la Guía de portabilidad de FreeRTOS. Este documento debe cargarse como recurso de apoyo al enviar el dispositivo a la Central de socios de APN
. Proporcione un repositorio público para la descarga de códigos. Le recomendamos que proporciones un enlace al repositorio corporativo de GitHub.
Envío de la calificación
Informe de la prueba de IDT.
Informe de prueba de AWS IoT Device Advisor.
Documento de modelado de amenazas.
Repositorio de GitHub con el código fuente para las descargas.
