HAL（Hardware Abstraction Layer，硬件抽象层）是建立在Linux驱动上的一套程序库，这套程序库并不属于Linux内核，而属于Linux内核层之上的应用层。但是，HAL却可以看作是Android真正意义上的驱动层，Google增加HAL的主要目的是为了保护“私人财产”，编写于HAL层的代码并不用遵守Linux内核的GPL协议，也就避免了被公开。实际上，如果不考虑商业因素，仅仅对于开发者来说，HAL层的东西基本上都可以写入驱动层的。
Android HAL的源代码存储位置并不固定，一般会存储在<Android源码根目录>/hardware目录中。其中hardware/libhardware_legacy目录存储的是旧HAL框架的源代码文件，新HAL框架的源代码放在hardware/libhardware目录中。而MTK的HAL层代码，依旧放在其自建的mediatek目录下面，为了体现大众性，这里我们还是加在hardware/libhardware/目录下。HAL层最终编译生成的.so文件主要放在Android系统的/system/lib/hw目录下。
这里先介绍下HAL模块的编写步骤，HAL模块一般由一个.c文件和一个.h文件组成，本实验为hw_breath_leds.c和hw_breath_leds.h。
第一步：定义结构体和代表HAL ID的宏
编写HAL模块需要使用到3个非常重要的结构体（hw_module_t，hw_device_t和hw_module_methods_t，必须要用到）。首先要定义两个新的结构体，而且这两个结构体的第1个变量类型分别必须是hw_module_t和hw_device_t，以满足两个新结构体与hw_module_t和hw_device_t进行强制转换的条件。除此之外，还需要为HAL模块定义一个ID，上层会通过该ID与该HAL模块建立联系。实际上第一步就是编写.h文件的内容，本实验hw_breath_leds.h完整源码如下：
-
#ifndef ANDROID_INCLUDE_HW_BREATH_LEDS_H
-
#define ANDROID_INCLUDE_HW_BREATH_LEDS_H
-
-
#include <hardware/hardware.h>
-
-
__BEGIN_DECLS
-
-
//定义模块id,jni层通过该id查找该模块
-
#define BREATH_LEDS_HW_MODULE_ID "breath_leds"
-
-
//定义硬件模块结构体，HAL规定不能直接使用hw_module_t结构体，需要在该结构体外再套一层结构体，但hw_module_t结构体
-
//必须是该结构体的第一个成员变量数据类型，以方便两者之间的强制转换
-
struct breath_leds_module_t
-
{
-
struct hw_module_t breath_module;
//表示HAL模块的相关信息
-
};
-
-
//硬件接口结构体，同上，该结构体第一个成员变量数据类型必须是struct hw_device_t
-
struct breath_leds_device_t
-
{
-
struct hw_device_t breath_device;
-
-
int (*set_breath_value)(
struct breath_leds_device_t *dev,
int val);
//对外接口
-
};
-
-
__END_DECLS
-
-
#endif
下面看一看这3个重要结构体的定义代码。
1 描述HAL模块的hw_module_t结构体：
-
typedef
struct hw_module_t {
-
/** 模块Tag，值必须是HARDWARE_MODULE_TAG */
-
uint32_t tag;
-
/** 模块主版本号 */
-
uint16_t version_major;
-
/** 模块从版本号 */
-
uint16_t version_minor;
-
/** 模块ID，通过该ID找到当前模块 */
-
const
char *
id;
-
/** 模块名称 */
-
const
char *name;
-
/** 模块作者 */
-
const
char *author;
-
/** 与模块相关的函数指针，都包含在hw_module_methods_t结构体中 */
-
struct hw_module_methods_t* methods;
-
/** 模块的dso */
-
void *dso;
-
/** 保留的空间 */
-
uint32_t reserved[
32
-7];
-
} hw_module_t;
2 描述HAL设备的hw_device_t结构体：
-
typedef
struct hw_device_t {
-
/** 设备Tag，值必须是HARDWARE_DEVICE_TAG */
-
uint32_t tag;
-
/** HAL设备版本号 */
-
uint32_t version;
-
/** 指向描述HAL模块的hw_module_t结构体指针 */
-
struct hw_module_t* module;
-
/** 保留的内存空间 */
-
uint32_t reserved[
12];
-
/** 关闭设备的函数指针 */
-
int (*close)(
struct hw_device_t* device);
-
} hw_device_t;
-
typedef
struct hw_module_methods_t {
-
/** 打开设备时调用的open函数指针 */
-
int (*open)(
const
struct hw_module_t* module,
const
char*
id,
struct hw_device_t** device);
-
} hw_module_methods_t;
在这三个结构体中，hw_module_t是最先使用的，然后通过hw_module_t.methods找到hw_module_methods_t结构体，并调用hw_module_methods_t.open函数。这个open函数相当于HAL模块入口，一般在其中打开设备文件，初始化hw_device_t结构体等。
第二步：定义HAL_MODULE_INFO_SYM变量所有的HAL模块都必须有一个HAL_MODULE_INFO_SYM变量，该变量类型为hw_module_t或包含hw_module_t且第一个变量类型是hw_module_t的结构体（如本实验的brearh_leds_module_t）。在定义HAL_MODULE_INFO_SYM变量的代码中一般会初始化hw_module_t或brearh_leds_module_t结构体的一些成员变量，其中id和methods特别重要。id表示HAL模块在Android系统中的标识，使用HAL模块的程序会通过该id找到并装载HAL模块，methods变量需要指向一个hw_module_methods_t结构体变量地址，当调用者通过id找到并装载HAL模块后，就会通过methods变量找到hw_module_methods_t结构体，并调用其open函数。如本例：
-
struct breath_leds_module_t HAL_MODULE_INFO_SYM =
-
{
-
breath_module:
-
{
-
tag: HARDWARE_MODULE_TAG,
//HAL初始化标志，必须为该值
-
version_major:
1,
//初始化HAL模块的主版本号
-
version_minor:
0,
//初始化HAL模块的此版本号
-
id: BREATH_LEDS_HW_MODULE_ID,
//jni通过匹配该id找到该HAL模块，该id在hw_breath_leds.h中定义
-
name: HAL_NAME,
-
author: HAL_AUTHOR,
-
methods: &breath_module_methods,
//初始化HAL模块open函数指针，hw_module_methods_t结构体变量
-
}
-
};
HAL模块需要hw_module_methods_t结构体的open函数指针变量指定入口函数。如本例：
-
static
struct hw_module_methods_t breath_module_methods =
-
{
-
open: hw_breath_leds_open
-
};
即编写上步指定的hw_breath_leds_open函数。在该函数中初始化hw_device_t或包含hw_device_t变量的结构体，打开设备文件等一些初始化工作。
第五步：编写HAL模块的close函数
即hw_device_t.close指针指向的函数，该函数需要在上步的open函数中通过hw_device_t.close变量指定才能调用。
如上五步即为HAL模块的一般编写步骤，下面是hw_breath_leds.c的完整代码：
-
#include <hardware/hw_breath_leds.h>
-
#include <cutils/log.h>
-
#include <fcntl.h>
-
-
#define DEV_NAME "/dev/breath_leds"
-
#define HAL_NAME "Breath Leds HAL Stub" //HAL模块名称
-
#define HAL_AUTHOR "vip-wming"
-
-
//设备文件句柄，open函数返回值，映射/dev/breath_leds设备文件
-
static
int fd =
0;
-
-
//相当于对外接口的回调的函数
-
static
int hw_set_breath_value(
struct breath_leds_device_t *dev,
int val)
-
{
-
unsigned
char buf[
2] = {
0};
-
-
buf[
0] = val &
0xff;
//bit0~7
-
buf[
1] = (val >>
8) &
0xff;
//bit8~15
-
write(fd, buf,
2);
//将数据写入驱动设备
-
-
return
0;
-
}
-
-
//关闭HAL设备
-
static
int hw_breath_device_close(
struct hw_device_t* device)
-
{
-
//将hw_device_t类型强制转换成breath_leds_device_t类型，hw_device_t类型变量必须作为breath_leds_device_t第一个参数的原因
-
struct breath_leds_device_t* dev = (
struct breath_leds_device_t*) device;
-
if (dev)
-
{
-
free(dev);
//释放设备
-
}
-
close(dev);
//关闭设备
-
return
0;
-
}
-
-
//打开设备入口函数
-
static
int hw_breath_leds_open(
const
struct hw_module_t* module,
const
char* name,
-
struct hw_device_t** device)
-
{
-
struct breath_leds_device_t *dev;
-
dev = (
struct breath_leds_device_t *)malloc(
sizeof(*dev));
//分配空间
-
memset(dev,
0,
sizeof(*dev));
//为分配的空间清零
-
-
dev->breath_device.tag = HARDWARE_DEVICE_TAG;
//设置HAL设备标志
-
dev->breath_device.version =
0;
//设置HAL设备版本号
-
dev->breath_device.module = (
struct hw_module_t*) module;
-
dev->breath_device.close = hw_breath_device_close;
//设值关闭HAL设备的函数指针，自定义该函数的实现
-
dev->set_breath_value = hw_set_breath_value;
-
-
*device = &(dev->breath_device);
//将设置好的hw_device_t结构体传递给device参数指向的地址空间
-
-
//打开breath_leds设备驱动文件,与相应驱动关联起来
-
if((fd = open(DEV_NAME, O_RDWR)) <
0)
-
{
-
// LOGE("BREATH LEDS Stub: open /dev/breath_leds fail.\n");
-
}
-
-
return
0;
-
}
-
-
//描述模块入口函数的hw_module_methods_t结构体
-
static
struct hw_module_methods_t breath_module_methods =
-
{
-
open: hw_breath_leds_open
-
};
-
-
//初始化HAL模块信息，该结构体变量名必须为HAL_MODULE_INFO_SYM，HAL能被Android自动
-
//调用，靠的就是该名，类似于每个C执行程序都有一个main函数一样
-
struct breath_leds_module_t HAL_MODULE_INFO_SYM =
-
{
-
breath_module:
-
{
-
tag: HARDWARE_MODULE_TAG,
//HAL初始化标志，必须为该值
-
version_major:
1,
//初始化HAL模块的主版本号
-
version_minor:
0,
//初始化HAL模块的此版本号
-
id: BREATH_LEDS_HW_MODULE_ID,
//jni通过匹配该id找到该HAL模块，该id在hw_breath_leds.h中定义
-
name: HAL_NAME,
-
author: HAL_AUTHOR,
-
methods: &breath_module_methods,
//初始化HAL模块open函数指针，即上面定义的hw_module_methods_t结构体变量
-
}
-
};
1）编写hw_breath_leds.h头文件
进入hardware/libhardware/include/hardware/目录，新建hw_breath_leds.h文件，内容上面已展现。
2）编写hw_breath_leds.c源代码
进入hardware/libhardware/modules/目录，新建hw_breath_leds目录，进入该目录，新建hw_breath_leds.c，内容上面已展现。
3）打开设备文件读写权限
由于设备文件“/dev/breath_leds”是在内核驱动里面通过device_create创建的，该函数创建的设备文件默认只有root用户可读写，上层APP一般不具备root权限，调用open函数打开时就会导致打开设备文件失败。
解决办法，进入system/core/rootdir目录，打开ueventd.rc，添加：
/dev/breath_leds 0666 root root在hardware/libhardware/modules/hw_breath_leds目录下新建Android.mk：
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_PATH := $(TARGET_OUT_SHARED_LIBRARIES)/hw
LOCAL_SHARED_LIBRARIES := liblog
LOCAL_SRC_FILES := hw_breath_leds.c
#注意LOCAL_MODULE的定义规则，后面跟有default能保证我们的模块总能被硬件抽象层加载到
LOCAL_MODULE := breath_leds.default
LOCAL_MODULE_TAGS := optional
LOCAL_PRELINK_MODULE := false
include $(BUILD_SHARED_LIBRARY)然后打开hardware/libhardware/modules/Android.mk，将新建的目录名添加进hardware_modules变量：
hardware_modules := gralloc hwcomposer audio nfc local_time power usbaudio audio_remote_submix hw_breath_leds 完成上述操作后，可以进行模块编译并手动打包进system.img，但是new时却不能被自动编译进去，打开build/target/product/common.mk，在PRODUCT_PACKAGES变量中加入breath_leds.default（模块Android.mk中的LOCAL_MODULE值）然后编译即可。
1899
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
