Comprenda las API de E/S comunes de FreeRTOS

Las API de E/S comunes actúan como capas de abstracción de hardware (HAL) y proporcionan una interfaz común entre controladores y código de aplicación de nivel superior. La E/S común de FreeRTOS proporciona un conjunto de API estándar para acceder a dispositivos serie comunes en placas de referencia compatibles; las implementaciones de estas API no están incluidas. Estas API comunes se comunican e interactúan con estos periféricos y permiten que el código funcione en todas las plataformas. Sin E/S común, el código para dispositivos de bajo nivel es específico del proveedor de hardware.

nota

FreeRTOS no requiere la implementación de las API de E/S comunes para funcionar, pero intentará utilizar las API de E/S comunes como una forma de interactuar con los periféricos específicos de una placa basada en un microcontrolador en lugar de con las API específicas del proveedor.

En general, los controladores de dispositivo son independientes del sistema operativo subyacente y son específicos de una configuración de hardware determinada. La capa HAL abstrae los detalles de cómo funciona un controlador específico y proporciona una API uniforme para controlar dichos dispositivos. Puede utilizar las mismas API para obtener acceso a varios controladores de dispositivo a través de placas de referencia basadas en varios microcontroladores (MCU).

Bibliotecas

Actualmente, FreeRTOS proporciona dos bibliotecas de E/S comunes: E/S común (básica) y E/S común (BLE).

E/S común: básica

Descripción general

E/S común: básica proporciona API que se ocupan de los periféricos y funciones de E/S básicos que se pueden encontrar en las placas basadas en MCU. El repositorio de E/S común: Básica está disponible en GitHub.

Periféricos admitidos

• ADC

• GPIO

• I2C

• PWM

• SPI

• UART

• Watchdog

• Flash

• RTC

• EFUSE

• Restablecimientos

• I2S

• Contador de rendimiento

• Información sobre la plataforma de hardware

Características admitidas

• Lectura y escritura sincrónicas

  La función no regresa hasta que se transfiere la cantidad de datos solicitada.

• Lectura y escritura asincrónicas

  La función regresa inmediatamente y la transferencia de datos se realiza de forma asíncrona. Cuando se completa la acción, se invoca una devolución de llamada de usuario registrado.

Código específico del periférico

• I2C

  Combina varias operaciones en una sola transacción. Se utiliza para acciones de escritura y luego lectura en una sola transacción.

• SPI

  Transfiere datos entre la principal y secundaria, lo que significa que la escritura y la lectura se realizan simultáneamente.

Referencia de la API

Para obtener una referencia completa sobre la API, consulte la referencia sobre la API E/S común - Básica.

E/S común: BLE

Descripción general

E/S común: BLE proporciona una abstracción de la pila de Bluetooth de bajo consumo del fabricante. Proporciona las siguientes interfaces que se pueden utilizar para controlar el dispositivo y realizar operaciones GAP y GATT. El repositorio de E/S común: BLE está disponible en GitHub.

Administrador de dispositivos Bluetooth:

Proporciona una interfaz para controlar el dispositivo Bluetooth, realizar operaciones de detección de dispositivos y otras tareas relacionadas con la conectividad.

Administrador de adaptadores BLE:

Proporciona una interfaz para las funciones de la API de GAP que son específicas de BLE.

Administrador de adaptadores Bluetooth clásico:

Proporciona una interfaz para controlar las funcionalidades de BT clásico de un dispositivo.

Servidor de GATT:

Proporciona una interfaz para utilizar la característica de servidor GATT de Bluetooth.

Cliente de GATT:

Proporciona una interfaz para utilizar la característica de cliente de GATT de Bluetooth.

Interfaz de conexión A2DP:

Proporciona una interfaz para el perfil de fuente A2DP del dispositivo local.

Referencia de la API

Para obtener una referencia completa sobre la API, consulte la referencia sobre la API E/S común - BLE.

E/S común para software común de Amazon

Las API de E/S común forman parte de las implementaciones requeridas por Amazon Common Software para dispositivos, específicamente para implementarlas en un kit de portabilidad de dispositivos (DPK) de un proveedor.

¿Qué es ACS?

Amazon Common Software (ACS) para dispositivos es un software que agiliza la integración de los SDK de dispositivos Amazon en sus dispositivos. ACS proporciona una capa de integración de API unificada, componentes previamente validados y con uso eficiente de la memoria para funciones comunes como la conectividad, un kit de portabilidad de dispositivos (DPK) y conjuntos de pruebas de varios niveles.

Programa de calificación

El programa de calificación Amazon Common Software para dispositivos verifica que una versión del DPK (kit de portabilidad de dispositivos) de ACS que se ejecuta en una placa de desarrollo específica basada en un microcontrolador sea compatible con las prácticas recomendadas publicadas por el programa y lo suficientemente sólida como para superar las pruebas exigidas por ACS especificadas en el programa de calificación.

Los proveedores que cumplen los requisitos de este programa figuran en la página de proveedores de chipsets de ACS.

Para obtener más información sobre la calificación, consulte ACS para dispositivos.