开发Android硬件抽象层模块接口

编写硬件抽象层模块接口分析

在阅读了“编写Android硬件抽象层相关规范说明”之后，我们应该很熟悉如何去定义和编写硬件抽象层模块接口了。下面即为本人实现的相关代码说明。

我们遵循Android源代码的相关习惯和规则，我想是有原因的；因此，我么也把编写的硬件抽象模块接口文件存放在hardware/libhardware/目录中。具体目录结构为（我的源代码放于Android文件夹中）：

$Android/hardware/libhardware/

---Include

    ---hardware

        ---helloworld.h

---modules

    ---helloworld

         ---helloworld.cpp

         ---Android.mk

那么下面即为具体的实现代码说明。

头文件helloworld.h实现：

#ifndef ANDROID_HELLOWORLD__INTERFACE_H

#define ANDROID_HELLOWORLD_INTERFACE_H

#include <hardware/hardware.h>

___BEGIN_DECLS

//定义模块编号

#define HELLOWORLD_HARDWARE_MODULE_ID “helloworld”

//定义模块结构体

Struct helloworld_module_t {

Struct hw_modult_t common;//第一个成员变量必须为 //hw_module_t类型

};

//定义设备编号

#define HELLOWORLD_HARDWARE_DEVICE_H “helloworld”

//定义设备结构体

Struct  helloworld_device_t {

Struct hw_module_t common;//第一个成员变量必须为该类型

int (*set_val)(struct helloworld_device_t* dev,int val);

Int(*get_val)(struct helloworld_device_t* dev,int* val);

Int fd;

};

__END_DECLS

#endif

这个头文件中的常量和结构体的定义都是按照Android系统的规范来定义的。宏变量HELLOWORLD_HARDWARE_MODULT_ID和HELLOWORLD_HARDWARE_DEVICE_ID分别用来描述欲编写的模块和其对应的设备编号；而结构体变量helloworld_module_t和helloworld_device_t则代表着欲编写的模块结构体和对应的设备描述结构体类型，并且这两个结构体的第一个成员变量类型必须为hw_module_t结构体类型。另外，helloworld_device_t中的其他三个变量的含义分别为:函数指针set_val和get_val用来对欲访问的设别进行写和读的操作，而fd表示打开的设备文件/dev/helloworld的描述符，借助这个描述符，我们可以知道当前打开的设备的状态。

实现文件helloworld.cpp：

#define LOG_TAG "HelloworldHALStub"

#include <hardware/hardware.h>

#include <fcntl.h>

#include <errno.h>

#include <cutils/log.h>

#include <cutils/atomic.h>

#include <hardware/helloworld.h>

#define DEVICE_NAME "/dev/helloworld"

#define MODULE_NAME "helloworld"

#define MODULE_AUTHOR "xxx@sina.com"

/*

*相关函数方法的定义部分

*/

static int helloworld_device_open(const struct hw_module_t* module, const char* id, struct hw_device_t** device);

static int helloworld_set_val(struct helloworld_device_t* dev, int val);

static int helloworld_get_val(struct helloworld_device_t* dev, int* val);

static int helloworld_device_close(struct hw_device_t* device);

static struct hw_module_methods_t helloworld_module_methods = {

open: helloworld_device_open

};

struct helloworld_module_t HAL_MODULE_INFO_SYM = {

common: {

tag: HARDWARE_MODULE_TAG,

version_major: 1,

version_minor: 0,

id: helloworld_HARDWARE_MODULE_ID,

name: MODULE_NAME,

author: MODULE_AUTHOR,

methods: &helloworld_module_methods,

}

};

/*

*相关实现部分

*/

/*

*打开设备方法实现

*第一个参数代表与要打开的设备对应的模块

*第二个参数代表着在抽象层中可能多个的设备的唯一标示，即区分打开那个设备

*第三个参数代表想要打开的目标设备

*/

static int helloworld_device_open(const struct hw_module_t* module, const char* id, struct hw_device_t** device) {

if(!strcmp(id, HELLOWORLD_HARDWARE_DEVICE_ID)) {

struct helloworld_device_t* dev;

//为设备文件分配物理空间大小

dev = (struct helloworld_device_t*)malloc(sizeof(struct helloworld_device_t));

if(!dev) {

LOGE("failed to alloc space for helloworld_device");

return -EFAULT;

}

memset(dev, 0, sizeof(struct helloworld_device_t));//设备驱动信号同步

dev->common.tag = HARDWARE_DEVICE_TAG;//成员变量tag必须为这个值

dev->common.version = 0;

dev->common.module = (hw_module_t*)module;

dev->common.close = helloworld_device_close;//调用设备自身函数关闭设备

//操作设备的两个方法

dev->set_val = helloworld_set_val;

dev->get_val = helloworld_get_val;

//判断当前设备是否打开

if((dev->fd = open(DEVICE_NAME, O_RDWR)) == -1) {

LOGE("failed to open device file /dev/helloworld -----%s.", strerror(errno));

free(dev);

return -EFAULT;

}

*device = &(dev->common);

LOGI("open device file /dev/helloworld success.");

return 0;

}

return -EFAULT;

}

/*

*第一个参数代表欲操作的设备

*第二个参数代表为操作的设备赋予的值

*/

static int helloworld_set_val(struct helloworld_device_t* dev, int val) {

if(!dev) {

LOGE("null dev pointer.");

return -EFAULT;

}

LOGI("set value %d to device file /dev/helloworld.", val);

write(dev->fd, &val, sizeof(val));//调用系统函数，通过对应的设备文件找到欲操作设备，    //并将设定的值写入设备中

return 0;

}

/*

*第一个参数代表操作的设备

*第二个参数表示从设别获取的值

*/

static int helloworld_get_val(struct helloworld_device_t* dev, int* val) {

if(!dev) {

LOGE("null dev pointer.");

return -EFAULT;

}

if(!val) {

LOGE("null val pointer.");

}

read(dev->fd, val, sizeof(*val));//调用系统函数，通过对应的设备文件找到欲操作设备，   //并获取值，留给硬件访问服务读取显示

LOGI("get value %d from device file /dev/helloworld.", *val);

return 0;

}

/*

*关闭设备，这个函数有设备自身提供调用来关闭对应设备

*唯一参数则代表欲关闭的设备

*/

static int helloworld_device_close(struct hw_device_t* device) {

struct helloworld_device_t* helloworld_device = (struct helloworld_device_t*)device;

if(helloworld_device) {

close(helloworld_device->fd);

free(helloworld_device);

}

return 0;

}

编译脚本文件Android.mk：

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional

LOCAL_PRELINK_MODULE := false

LOCAL_SHARED_LIBRARIES := liblog

LOCAL_SRC_FILES := helloworld.cpp

LOCAL_MODULE := helloworld.default

LOCAL_MODULE_PATH := $(TARGET_OUT_SHARED_LIBRARIES)/hw

include $(BUILD_SHARED_LIBRARY)//代表将编译的文件编译成为动态链接库文件，名 //称为helloworld.default，并保存在/out/target/product/generic/system/lib目录中。

准备好所有文件之后，使用命令:mmm ./hardware/libhardware/modules/helloworld/和make snod进行编译；最后可以得到一个位于/out/target/product/generic/system/lib目录中的helloworld.default.so文件。这时一个动态的链接库文件。

编写完硬件抽象层模块接口之后，接下来就是为这个模块接口编写一个硬件访问服务，这个硬件访问服务是位于框架层，用来为应用程序提供访问设备硬件的服务接口。敬请期待，硬件访问服务的实现！

本人刚创建了一个QQ群，目的是共同研究学习Android，期待兴趣相投的同学加入！！

群号：179914858