Referencia de la estructura hw_module_t

Campos de datos
Referencia de la estructura hw_module_t

#include < hardware.h >

Campos de datos

uint32_t  etiqueta
 
uint16_t  module_api_version
 
uint16_t  hal_api_version
 
const char *  id
 
const char *  name
 
const char *  author
 
struct hw_module_methods_t *  métodos
 
void *  dso
 
uint32_t  reservado [32-7]
 

Descripción detallada

Cada módulo de hardware debe tener una estructura de datos llamada HAL_MODULE_INFO_SYM, y los campos de esta estructura de datos deben comenzar con hw_module_t , seguido de información específica del módulo.

Definición en la línea 86 del archivo hardware.h .

Documentación de campos

const char* author

Autor, propietario o implementador del módulo

Definición en la línea 139 del archivo hardware.h .

void* dso

dso del módulo

Definición en la línea 145 del archivo hardware.h .

uint16_t hal_api_version

Las definiciones de version_major/version_minor se proporcionan aquí para la compatibilidad temporal del código fuente. Se quitarán en la próxima versión. TODOS los clientes deben realizar la conversión al formato de la nueva versión. La versión de la API de la interfaz del módulo HAL. Esto se hace para crear versiones de las estructuras y definiciones de hw_module_t , hw_module_methods_t y hw_device_t .

La interfaz de HAL es propietaria de este campo. Los usuarios o implementaciones del módulo NO deben depender de este valor para obtener información de la versión.

Actualmente, 0 es el único valor válido.

Definición en la línea 129 del archivo hardware.h .

const char* id

Identificador del módulo

Definición en la línea 133 del archivo hardware.h .

struct hw_module_methods_t * methods

Métodos de los módulos

Definición en la línea 142 del archivo hardware.h .

uint16_t module_api_version

Es la versión de la API del módulo implementado. El propietario del módulo es responsable de actualizar la versión cuando cambia la interfaz de un módulo.

Los módulos derivados, como gralloc y audio, son propietarios y administran este campo. El usuario del módulo debe interpretar el campo de versión para decidir si debe o no interactuar con la implementación del módulo proporcionada. Por ejemplo, SurfaceFlinger es responsable de asegurarse de saber cómo administrar diferentes versiones de la API de gralloc-module, y AudioFlinger debe saber cómo hacer lo mismo para la API de audio-module.

La versión de la API del módulo debe incluir un componente principal y uno secundario. Por ejemplo, la versión 1.0 se podría representar como 0x0100. Este formato implica que las versiones 0x0100 a 0x01ff son compatibles con la API.

En el futuro, libhardware expondrá una función hw_get_module_version() (o equivalente) que tomará como argumentos las versiones mínimas o máximas compatibles y podrá rechazar módulos con versiones fuera del rango proporcionado.

Definición en la línea 111 del archivo hardware.h .

const char* name

Nombre de este módulo

Definición en la línea 136 del archivo hardware.h .

uint32_t reservado[32-7]

padding a 128 bytes, reservado para uso futuro

Definición en la línea 151 del archivo hardware.h .

Etiqueta uint32_t

La etiqueta se debe inicializar en HARDWARE_MODULE_TAG.

Definición en la línea 88 del archivo hardware.h .

La documentación de esta struct se generó a partir del siguiente archivo: