学步园

1、使用HAL的方法

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

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

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

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

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

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

sLedDevice->set_on( sLedDevice, led);
sLedDevice->set_off( sLedDevice, led);

2、编写 HAL stub 的方法

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

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

struct led_module_t {
	struct hw_module_t common;
};
struct led_control_device_t {
	struct hw_device_t commom;
	int fd;		// LED设备文件标码
	// 支持控制的 API接口
	int (*set_on)(struct led_control_device_t *dev, int32_t led);
	int (*set_off)(struct led_control_device_t *dev, int32_t led);
};

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

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

struct hw_module_methods_t led_module_methods = {
	open: led_device_open
};

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

const struct led_module_t HAL_MODULE_INFO_SYM = {
	common: {
		tag: HARDWARE_MODULE_TAG,
		version_major: 1,
		version_minor: 0,
		id: LED_HARDWARE_MODULE_ID,
		name: "Sample LED Stub",
		author: &led_module_methods,
	}
};

补充说明：

tag ：表示需要指定为 HARDWARE_MODULE_TAG.

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

methods ：为 HAL 所定义的方法。

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

int led_device_open(const struct hw_module_t* module, const char* name, struct hw_device_t** device)
{
	struct led_control_device_t* dev;
	dev = (struct led_control_device_t *)malloc( sizeof(*dev) );
	memset(dev, 0, sizeof(*dev) );
	dev->common.tag = HARDWARE_DEVICE_TAG;
	dev->common.version = 0;
	dev->common.module = module;
	dev->common.close = led_device_close;
	dev->set_on = led_on;
	dev->set_off = led_off;
	*device = &dev->common;
	// initialize Led hardware here
	dev->fd = open(LED_DEVICE, O_RDONLY);
	if( dev->fd < 0 )	return -1;
	led_off(dev, LED_C608);
	led_off(dev, LED_C609);

success:
	return 0;
}

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

int led_on(struct led_control_device_t* dev, int32_t led)
{
	int fd;
	LOGI("LED Stub: set %d on.", led);
	fd = dev->fd;
	switch(fd)
	{
		case LED_C608:
			ioctl(fd, 1, &led);
			break;
		case LED_C609:
			ioctl(fd, 1, &led);
			break;
		default:
			return -1;
	}
	
	return 0;
}

int led_off(struct led_control_device_t* dev, int32_t led)
{
	int fd;
	LOGI("LED Stub: set %d off.", led);
	fd = dev->fd;
	switch(fd)
	{
		case LED_C608:
			ioctl(fd, 2, &led);
			break;
		case LED_C609:
			ioctl(fd, 2, &led);
			break;
		default:
			return -1;
	}
	
	return 0;
}