总结Android HAL层的使用方法

1、使用HAL的方法

下面以Sensor传感器为例介绍使用HAL的方法，具体流程如下所示。

 

step1. Native code通过 hw_get_module 调用 HAL stub。

[cpp]  view plain copy

1. hw_get_module( LED_HARDWARE_MODULE_ID, (const hw_module_t**)&module)  

step2. 通过继承 hw_module_methods_t 的callback来打开设备。

[cpp]  view plain copy

1. module->methods->open(module, LED_HARDWARE_MODULE_ID, (struct hw_device_t**)device);  

step3. 通过继承 hw_device_t 的 callback（回调函数）来控制设备。

[cpp]  view plain copy

1. sLedDevice->set_on( sLedDevice, led);  
2. sLedDevice->set_off( sLedDevice, led);  

 

2、编写 HAL stub 的方法

编写 HAL stub 的基本流程如下所示。

 

step1. 自定义 HAL 结构体，编写头文件 led.h 和 hardware/hardware.h，主要代码如下所示。

[cpp]  view plain copy

1. struct led_module_t {  
2.     struct hw_module_t common;  
3. };  
4. struct led_control_device_t {  
5.     struct hw_device_t commom;  
6.     int fd;     // LED设备文件标码  
7.     // 支持控制的 API接口  
8.     int (*set_on)(struct led_control_device_t *dev, int32_t led);  
9.     int (*set_off)(struct led_control_device_t *dev, int32_t led);  
10. };  

 

step2. 编写文件 led.c 实现 HAL stub 注册功能。

 

step3. 设置 led_module_methods 继承于hw_module_methods_t，并实现对 open() 方法的回调。

[cpp]  view plain copy

1. struct hw_module_methods_t led_module_methods = {  
2.     open: led_device_open  
3. };  

step4. 使用HAL_MODULE_INFO_SYM 实例化 led_module_t，注意各个名称不可以修改。

[cpp]  view plain copy

1. const struct led_module_t HAL_MODULE_INFO_SYM = {  
2.     common: {  
3.         tag: HARDWARE_MODULE_TAG,  
4.         version_major: 1,  
5.         version_minor: 0,  
6.         id: LED_HARDWARE_MODULE_ID,  
7.         name: "Sample LED Stub",  
8.         author: &led_module_methods,  
9.     }  
10. };  

补充说明：

tag ：表示需要指定为 HARDWARE_MODULE_TAG.

id ：表示指定为 HAL Stub 的 module ID。

methods ：为 HAL 所定义的方法。

step5. open()是一个必须实现的回调 API，用于负责申请结构体控件并填充信息，并且可以注册具体操作API接口，并打开linux驱动。
但是因为存在多重继承关系，所以只需对子结构体 hw_device_t 对象申请控件即可。

[cpp]  view plain copy

1. int led_device_open(const struct hw_module_t* module, const char* name, struct hw_device_t** device)  
2. {  
3.     struct led_control_device_t* dev;  
4.     dev = (struct led_control_device_t *)malloc( sizeof(*dev) );  
5.     memset(dev, 0, sizeof(*dev) );  
6.     dev->common.tag = HARDWARE_DEVICE_TAG;  
7.     dev->common.version = 0;  
8.     dev->common.module = module;  
9.     dev->common.close = led_device_close;  
10.     dev->set_on = led_on;  
11.     dev->set_off = led_off;  
12.     *device = &dev->common;  
13.     // initialize Led hardware here  
14.     dev->fd = open(LED_DEVICE, O_RDONLY);  
15.     if( dev->fd < 0 ) return -1;  
16.     led_off(dev, LED_C608);  
17.     led_off(dev, LED_C609);  
18.   
19. success:  
20.     return 0;  
21. }  

 

step6. 填充具体API操作，具体代码如下所示。

[cpp]  view plain copy

1. int led_on(struct led_control_device_t* dev, int32_t led)  
2. {  
3.     int fd;  
4.     LOGI("LED Stub: set %d on.", led);  
5.     fd = dev->fd;  
6.     switch(fd)  
7.     {  
8.         case LED_C608:  
9.             ioctl(fd, 1, &led);  
10.             break;  
11.         case LED_C609:  
12.             ioctl(fd, 1, &led);  
13.             break;  
14.         default:  
15.             return -1;  
16.     }  
17.       
18.     return 0;  
19. }  
20.   
21. int led_off(struct led_control_device_t* dev, int32_t led)  
22. {  
23.     int fd;  
24.     LOGI("LED Stub: set %d off.", led);  
25.     fd = dev->fd;  
26.     switch(fd)  
27.     {  
28.         case LED_C608:  
29.             ioctl(fd, 2, &led);  
30.             break;  
31.         case LED_C609:  
32.             ioctl(fd, 2, &led);  
33.             break;  
34.         default:  
35.             return -1;  
36.     }  
37.       
38.     return 0;  
39. }