Entorno de ejecución del centro de contexto (CHRE)

Los smartphones contienen varios procesadores, cada uno optimizado para realizar tareas diferentes. Sin embargo, Android solo se ejecuta en un procesador: el procesador de aplicaciones (AP). El AP está ajustado para ofrecer un excelente rendimiento en casos de uso con la pantalla encendida, como los juegos, pero consume demasiada energía para admitir funciones que requieren ráfagas de procesamiento frecuentes y cortas todo el tiempo, incluso cuando la pantalla está apagada. Los procesadores más pequeños pueden controlar estas cargas de trabajo de manera más eficiente y completar sus tareas sin afectar de manera significativa la duración de batería. Sin embargo, los entornos de software en estos procesadores de baja potencia son más limitados y pueden variar mucho, lo que dificulta el desarrollo multiplataforma.

El entorno de tiempo de ejecución del centro de contexto (CHRE) proporciona una plataforma común para ejecutar apps en un procesador de baja potencia, con una API simple, estandarizada y compatible con la incorporación. La CHRE permite que los OEMs de dispositivos y sus socios de confianza descarguen el procesamiento del AP, ahorren batería y mejoren varias áreas de la experiencia del usuario, y habiliten una clase de funciones siempre activas y contextualmente conscientes, en especial aquellas que involucran la aplicación del aprendizaje automático a la detección ambiental.

Conceptos clave

El CHRE es el entorno de software en el que las apps nativas pequeñas, llamadas nanoapps, se ejecutan en un procesador de baja potencia y, además, interactúan con el sistema subyacente a través de la API común de CHRE. Para acelerar la implementación correcta de las APIs de CHRE, se incluye una implementación de referencia multiplataforma de CHRE en AOSP. La implementación de referencia incluye código y abstracciones comunes para el hardware y el software subyacentes a través de una serie de capas de abstracción de plataforma (PAL). Las nanoapps casi siempre están vinculadas a una o más apps cliente que se ejecutan en Android, que interactúan con el CHRE y las nanoapps a través de las APIs del sistema ContextHubManager de acceso restringido.

En un nivel alto, se pueden establecer paralelismos entre la arquitectura de CHRE y Android en su totalidad. Sin embargo, existen algunas distinciones importantes:

  • CHRE admite solo la ejecución de nanoapps desarrolladas en código nativo (C o C++). No se admite Java.
  • Debido a las restricciones de recursos y las limitaciones de seguridad, el CHRE no está abierto para que lo usen apps de terceros de Android arbitrarias. Solo las apps de confianza del sistema pueden acceder a él.

También es importante distinguir entre el concepto de CHRE y un concentrador de sensores. Si bien es común usar el mismo hardware para implementar el concentrador de sensores y el CHRE, este último no proporciona las capacidades de los sensores que requiere el HAL de sensores de Android. El CHRE está vinculado al HAL de Context Hub y actúa como cliente de un framework de sensores específico del dispositivo para recibir datos de sensores sin involucrar al AP.

Arquitectura del framework de CHRE

Figura 1: Arquitectura del framework de CHRE

HAL de Context Hub

La capa de abstracción de hardware (HAL) de Context Hub es la interfaz entre el framework de Android y la implementación de CHRE del dispositivo, que se define en hardware/interfaces/contexthub. El HAL de Context Hub define las APIs a través de las cuales el framework de Android descubre los centros de contexto disponibles y sus nanoapps, interactúa con esas nanoapps a través del paso de mensajes y permite que se carguen y descarguen nanoapps. En system/chre/host, hay disponible una implementación de referencia del HAL de Context Hub que funciona con la implementación de referencia de CHRE.

En caso de conflicto entre esta documentación y la definición de HAL, prevalecerá la definición de HAL.

Inicialización

Cuando se inicia Android, ContextHubService invoca la función HAL de getHubs() para determinar si hay algún centro de contexto disponible en el dispositivo. Esta es una llamada única de bloqueo, por lo que debe completarse rápidamente para evitar retrasar el inicio y debe mostrar un resultado preciso, ya que no se pueden agregar nuevos centros de contexto más adelante.

Carga y descarga nanoapps

Un concentrador de contexto puede incluir un conjunto de nanoapps que se incluyen en la imagen del dispositivo y se cargan cuando se inicia el CHRE. Estas se conocen como nanoapps precargadas y deben incluirse en la primera respuesta posible a queryApps().

El HAL de Context Hub también admite la carga y descarga de nanoapps de forma dinámica en el tiempo de ejecución, a través de las funciones loadNanoApp() y unloadNanoApp(). Las nanoapps se proporcionan a la HAL en un formato binario específico para la implementación de hardware y software de CHRE del dispositivo.

Si la implementación para cargar una nanoaplicación implica escribirla en una memoria no volátil, como el almacenamiento flash conectado al procesador que ejecuta CHRE, la implementación de CHRE siempre debe iniciarse con estas nanoaplicaciones dinámicas en el estado inhabilitado. Esto significa que no se ejecuta ninguno de los códigos de la nanoaplicación hasta que se recibe una solicitud de enableNanoapp() a través del HAL. Las nanoapps precargadas se pueden inicializar en el estado habilitado.

Reinicios del centro de contexto

Si bien no se espera que el CHRE se reinicie durante el funcionamiento normal, puede ser necesario recuperarse de condiciones inesperadas, como un intento de acceder a una dirección de memoria no asignada. En estas situaciones, el CHRE se reinicia de forma independiente de Android. El HAL notifica esto a Android a través del evento RESTARTED, que solo debe enviar después de que se haya reiniciado el CHRE hasta el punto en que pueda aceptar solicitudes nuevas, como queryApps().

Descripción general del sistema de CHRE

El CHRE se diseñó en torno a una arquitectura orientada a eventos, en la que la unidad principal de procesamiento es un evento que se pasa al punto de entrada de manejo de eventos de una nanoaplicación. Si bien el framework de CHRE puede ser multiproceso, una nanoaplicación determinada nunca se ejecuta desde varios subprocesos en paralelo. El framework de CHRE interactúa con una nanoapp determinada a través de uno de los tres puntos de entrada de nanoapp (nanoappStart(), nanoappHandleEvent() y nanoappEnd()) o a través de una devolución de llamada proporcionada en una llamada anterior a la API de CHRE, y las nanoapps interactúan con el framework de CHRE y el sistema subyacente a través de la API de CHRE. La API de CHRE proporciona un conjunto de funciones básicas, así como herramientas para acceder a indicadores contextuales, incluidos sensores, GNSS, Wi-Fi, WWAN y audio, y se puede ampliar con funciones adicionales específicas del proveedor para que las usen las nanoapps específicas del proveedor.

Sistema de compilación

Si bien el HAL de Context Hub y otros componentes necesarios del lado del AP se compilan junto con Android, el código que se ejecuta dentro de CHRE puede tener requisitos que lo hagan incompatible con el sistema de compilación de Android, como la necesidad de una cadena de herramientas especializada. Por lo tanto, el proyecto de CHRE en AOSP proporciona un sistema de compilación simplificado basado en GNU Make para compilar nanoapps y, de manera opcional, el framework de CHRE en bibliotecas que se pueden integrar en el sistema. Los fabricantes de dispositivos que agregan compatibilidad con CHRE deben integrar la compatibilidad del sistema de compilación para sus dispositivos de destino en AOSP.

La API de CHRE se escribe en el estándar de lenguaje C99, y la implementación de referencia usa un subconjunto restringido de C++11 adecuado para apps con recursos limitados.

API de CHRE

La API de CHRE es una colección de archivos de encabezado de C que definen la interfaz de software entre una nanoaplicación y el sistema. Está diseñado para que el código de nanoapps sea compatible con todos los dispositivos que admiten CHRE, lo que significa que no es necesario modificar el código fuente de una nanoapp para admitir un nuevo tipo de dispositivo, aunque es posible que deba volver a compilarse específicamente para el conjunto de instrucciones del procesador o la interfaz binaria de la aplicación (ABI) del dispositivo de destino. La arquitectura y el diseño de la API de CHRE también garantizan que las nanoapps sean compatibles con objetos binarios en diferentes versiones de la API de CHRE, lo que significa que no es necesario volver a compilar una nanoapp para ejecutarla en un sistema que implemente una versión diferente de la API de CHRE en comparación con la API de destino para la que se compiló la nanoapp. En otras palabras, si un objeto binario de nanoaplicación se ejecuta en un dispositivo que admite la API de CHRE v1.3 y ese dispositivo se actualiza para admitir la API de CHRE v1.4, el mismo objeto binario de nanoaplicación seguirá funcionando. De manera similar, la nanoaplicación puede ejecutarse en la API de CHRE v1.2 y determinar en el tiempo de ejecución si requiere capacidades de la API v1.3 para lograr su uso o si puede funcionar, posiblemente con una degradación elegante de las funciones.

Las versiones nuevas de la API de CHRE se lanzan junto con Android. Sin embargo, como la implementación de CHRE forma parte de la implementación del proveedor, la versión de la API de CHRE compatible con un dispositivo no está necesariamente vinculada a una versión de Android.

Resumen de la versión

Al igual que el esquema de control de versiones de HIDL de Android, la API de CHRE sigue el control de versiones semántico. La versión principal indica la compatibilidad binaria, mientras que la versión secundaria aumenta cuando se introducen funciones retrocompatibles. La API de CHRE incluye anotaciones de código fuente para identificar qué versión introdujo una función o un parámetro, por ejemplo, @since v1.1.

La implementación de CHRE también expone una versión de parche específica de la plataforma a través de chreGetVersion(), que indica cuándo se realizan correcciones de errores o actualizaciones menores en la implementación.

Versión 1.0 (Android 7)

Incluye compatibilidad con sensores y funciones principales de nanoaplicaciones, como eventos y temporizadores.

Versión 1.1 (Android 8)

Presenta capacidades de ubicación a través de la ubicación GNSS y las mediciones sin procesar, el escaneo de Wi-Fi y la información de la red móvil, junto con mejoras generales para habilitar la comunicación de nanoaplicaciones a nanoaplicaciones y otras mejoras.

Versión 1.2 (Android 9)

Se agregó compatibilidad con datos de un micrófono de baja potencia, rango de RTT de Wi-Fi, notificaciones de activación y desactivación de AP, y otras mejoras.

Versión 1.3 (Android 10)

Mejora las funciones relacionadas con los datos de calibración del sensor, agrega compatibilidad para borrar datos de sensores por lotes a pedido, define el tipo de sensor de detección de pasos y extiende los eventos de ubicación del GNSS con campos de precisión adicionales.

Versión 1.4 (Android 11)

Se agregó compatibilidad con información de celdas 5G, volcado de depuración de nanoapp y otras mejoras.

Funciones obligatorias del sistema

Si bien las fuentes de indicadores contextuales, como los sensores, se clasifican en áreas de atributos opcionales, se requieren algunas funciones principales en todas las implementaciones de CHRE. Esto incluye las APIs principales del sistema, como las que se usan para configurar temporizadores, enviar y recibir mensajes a clientes en el procesador de aplicaciones, el registro y otras. Para obtener más información, consulta los encabezados de la API.

Además de las funciones principales del sistema codificadas en la API de CHRE, también hay funciones obligatorias a nivel del sistema de CHRE especificadas a nivel de la HAL de Context Hub. La más significativa de ellas es la capacidad de cargar y descargar nanoapps de forma dinámica.

Biblioteca estándar C/C++

Para minimizar el uso de memoria y la complejidad del sistema, las implementaciones de CHRE deben admitir solo un subconjunto de las bibliotecas estándar de C y C++, y las funciones de lenguaje que requieren compatibilidad con el entorno de ejecución. Siguiendo estos principios, algunas funciones se excluyen de forma explícita debido a su memoria y a sus amplias dependencias a nivel del SO, y otras porque se reemplazan por APIs específicas de CHRE más adecuadas. Si bien no se trata de una lista exhaustiva, las siguientes funciones no están diseñadas para estar disponibles para las nanoapps:

  • Excepciones de C++ y la información del tipo de tiempo de ejecución (RTTI)
  • Compatibilidad con subprocesos de bibliotecas estándar, incluidos los encabezados de C++11 <thread>, <mutex>, <atomic> y <future>
  • Bibliotecas de entrada y salida estándar de C y C++
  • Biblioteca de plantillas estándar (STL) de C++
  • Biblioteca de expresiones regulares estándar de C++
  • Asignación de memoria dinámica a través de funciones estándar (por ejemplo, malloc, calloc, realloc, free, operator new) y otras funciones de bibliotecas estándar que usan de forma inherente la asignación dinámica, como std::unique_ptr
  • Compatibilidad con la localización y los caracteres Unicode
  • Bibliotecas de fecha y hora
  • Funciones que modifican el flujo normal del programa, incluidas <setjmp.h>, <signal.h>, abort y std::terminate
  • Acceso al entorno de host, incluidos system y getenv
  • POSIX y otras bibliotecas que no se incluyen en los estándares de lenguaje C99 o C++11

En muchos casos, las funciones equivalentes están disponibles en las bibliotecas de utilidades y las funciones de la API de CHRE. Por ejemplo, chreLog se puede usar para el registro de depuración segmentado para el sistema Logcat de Android, en el que un programa más tradicional podría usar printf o std::cout.

Por el contrario, se requieren algunas funciones de biblioteca estándar. Depende de la implementación de la plataforma exponerlos a través de bibliotecas estáticas para su inclusión en un objeto binario de nanoaplicación o mediante la vinculación dinámica entre la nanoaplicación y el sistema. Esto incluye, entre otros, lo siguiente:

  • Utilidades de cadenas y arrays: memcmp, memcpy, memmove, memset, strlen
  • Biblioteca matemática: Funciones de punto flotante de precisión simple de uso general:

    • Operaciones básicas: ceilf, fabsf, floorf, fmaxf, fminf, fmodf, roundf, lroundf, remainderf
    • Funciones exponenciales y de potencia: expf, log2f, powf, sqrtf
    • Funciones trigonométricas y hiperbólicas: sinf, cosf, tanf, asinf, acosf, atan2f, tanhf

Si bien algunas plataformas subyacentes admiten capacidades adicionales, una nanoaplicación no se considera portátil en las implementaciones de CHRE, a menos que restrinja sus dependencias externas a las funciones de la API de CHRE y a las funciones de bibliotecas estándar aprobadas.

Funciones opcionales

Para promocionar el hardware y el software, la API de CHRE se divide en áreas de funciones, que se consideran opcionales desde la perspectiva de la API. Si bien es posible que estas funciones no sean obligatorias para admitir una implementación de CHRE compatible, es posible que sean obligatorias para admitir una nanoaplicación en particular. Incluso si una plataforma no admite un conjunto determinado de APIs, las nanoapps que hacen referencia a esas funciones deben poder compilarse y cargarse.

Sensores

La API de CHRE permite solicitar datos de sensores, como el acelerómetro, el giroscopio, el magnetómetro, el sensor de luz ambiental y la proximidad. Estas APIs están diseñadas para proporcionar un conjunto de atributos similar al de las APIs de sensores de Android, incluida la compatibilidad con la agrupación de muestras de sensores para reducir el consumo de energía. El procesamiento de datos de sensores dentro de CHRE permite un procesamiento de señales de movimiento con una latencia y una energía mucho más bajas en comparación con la ejecución en el AP.

GNSS

CHRE proporciona APIs para solicitar datos de ubicación desde un sistema global de navegación satelital (GNSS), incluido el GPS y otras constelaciones de satélites. Esto incluye solicitudes de correcciones de posición periódicas, así como datos de medición sin procesar, aunque ambas son capacidades independientes. Como la CHRE tiene un vínculo directo con el subsistema GNSS, se reduce la energía en comparación con las solicitudes de GNSS basadas en AP, ya que el AP puede permanecer inactivo durante todo el ciclo de vida de una sesión de ubicación.

Wi-Fi

El CHRE permite interactuar con el chip Wi-Fi, principalmente para fines de ubicación. Si bien el GNSS funciona bien para ubicaciones al aire libre, los resultados de los análisis de Wi-Fi pueden proporcionar información de ubicación precisa en interiores y en áreas desarrolladas. Además de evitar el costo de activar el AP para una búsqueda, el CHRE puede escuchar los resultados de las búsquedas de Wi-Fi que realiza el firmware de Wi-Fi para fines de conectividad, que, por lo general, no se entregan al AP por motivos de energía. Aprovechar los análisis de conectividad con fines contextuales ayuda a reducir la cantidad total de análisis de Wi-Fi realizados, lo que ahorra energía.

Se agregó compatibilidad con Wi-Fi en la versión 1.1 de la API de CHRE, incluida la capacidad de supervisar los resultados de análisis y activar análisis a pedido. Estas capacidades se ampliaron en la versión 1.2 con la capacidad de realizar mediciones de tiempo de ida y vuelta (RTT) en puntos de acceso que admiten la función, lo que permite una determinación precisa de la posición relativa.

WWAN

La API de CHRE permite recuperar información de identificación de la celda para la celda de publicación y sus vecinos, que se suele usar con fines de ubicación de gran detalle.

Audio

El CHRE puede procesar lotes de datos de audio desde un micrófono de baja potencia, que, por lo general, aprovecha el hardware que se usa para implementar el HAL de SoundTrigger. El procesamiento de datos de audio en CHRE puede permitir que se combinen con otros datos, como los sensores de movimiento.

Implementación de referencia

El código de referencia del framework de CHRE se incluye en AOSP en el proyecto system/chre, que se implementa en C++11. Si bien no es estrictamente necesario, se recomienda que todas las implementaciones de CHRE se basen en esta base de código para garantizar la coherencia y acelerar la adopción de nuevas funciones. Este código se puede ver como un análogo del framework principal de Android, ya que es una implementación de código abierto de las APIs que usan las apps, que sirve como modelo de referencia y estándar de compatibilidad. Si bien se puede personalizar y extender con capacidades específicas del proveedor, la recomendación es mantener el código común lo más cerca posible de la referencia. Al igual que los HAL de Android, la implementación de referencia de CHRE usa varias abstracciones de plataforma para permitir que se adapte a cualquier dispositivo que cumpla con los requisitos mínimos.

Para obtener detalles técnicos y una guía de portabilidad, consulta el archivo README incluido en el proyecto system/chre.