在Ubuntu上为Android增加硬件抽象层（HAL）模块访问Linux内核驱动程序（老罗学习笔记3）

#ifndef ANDROID_HELLO_INTERFACE_H  
#define ANDROID_HELLO_INTERFACE_H  
#include <hardware/hardware.h>  
  
__BEGIN_DECLS    /*--扩充C语言在编译的时候按照C++编译器进行统一处理，使得C++代码能够调用C编译生成的中间代码*/
 
/*定义模块ID*/  
#define HELLO_HARDWARE_MODULE_ID "hello"  
  
/*硬件模块结构体*/  
struct hello_module_t {  
    struct hw_module_t common;  
};  
  
/*硬件接口结构体*/  
struct hello_device_t {  
    struct hw_device_t common;  
    int fd;  
    int (*set_val)(struct hello_device_t* dev, int val);    /*--set_val什么类型？什么作用？以及后面这样复用结构体 何用？？--*/
    int (*get_val)(struct hello_device_t* dev, int* val);  
};  
  
__END_DECLS  
  
#endif  

/** 
 * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM 
 * and the fields of this data structure must begin with hw_module_t 
 * followed by module specific information. 
 */  
//每一个硬件模块都每必须有一个名为HAL_MODULE_INFO_SYM的数据结构变量，它的第一个成员的类型必须为hw_module_t  
typedef struct hw_module_t {  
    /** tag must be initialized to HARDWARE_MODULE_TAG */  
    uint32_t tag;   // 初始化硬件模块标签
  
    /** major version number for the module */  
    uint16_t version_major;  //主模块版本号
  
    /** minor version number of the module */  
    uint16_t version_minor;  //副模块版本号
  
    /** Identifier of module */  
    const char *id;    //模块标识符  
  
    /** Name of this module */  
    const char *name;  //模块名字
  
    /** Author/owner/implementor of the module */  
    const char *author;   //编写作者
  
    /** Modules methods */  
    //模块方法列表,指向hw_module_methods_t*  
    struct hw_module_methods_t* methods;      //硬件模块的方法
  
    /** module‘s dso */  
    void* dso;    //DSO： Device Software Optimization，设备软件优化“安全维和组织”（DSO）
  
    /** padding to 128 bytes, reserved for future use */  
    uint32_t reserved[32-7];    //填充到128字节,保留以供将来使用
  
} hw_module_t;

#define LOG_TAG "HelloStub"       
/*--HelloStub：什么作用？
答：

　　HAL stub的框架比较简单，三个结构体、两个常量、一个函数，简称321架构，它的定义在：

　　@hardware/libhardware/include/hardware/hardware.h

　　@hardware/libhardware/hardware.c

--*/
  
#include <hardware/hardware.h>  
#include <hardware/hello.h>  
#include <fcntl.h>     //文件控制
#include <errno.h>     //出错码
#include <cutils/log.h>     //?
#include <cutils/atomic.h>  //?
  
#define DEVICE_NAME "/dev/hello"   //需要是路径 ！ 
#define MODULE_NAME "Hello"  
#define MODULE_AUTHOR "[email protected]"   //模块作者
  
/*设备打开和关闭接口*/  
static int hello_device_open(const struct hw_module_t* module, const char* name, struct hw_device_t** device);  
static int hello_device_close(struct hw_device_t* device);  
  
/*设备访问接口*/  
static int hello_set_val(struct hello_device_t* dev, int val);  
static int hello_get_val(struct hello_device_t* dev, int* val);  
  
/*模块方法表*/  
//硬件模块方法列表的定义，这里只定义了一个open函数
static struct hw_module_methods_t hello_module_methods = {  
    open: hello_device_open  
};  
  
/*模块实例变量*/   
struct hello_module_t HAL_MODULE_INFO_SYM = {   //HAL_MODULE_INFO_SYM: 上层调用时的入口(相当于main)!!
    common: {  
        tag: HARDWARE_MODULE_TAG,  
        version_major: 1,  
        version_minor: 0,  
        id: HELLO_HARDWARE_MODULE_ID,  
        name: MODULE_NAME,  
        author: MODULE_AUTHOR,  
        methods: &hello_module_methods,   //解释看上
    }  
};  

static int hello_device_open(const struct hw_module_t* module, const char* name, struct hw_device_t** device) {  
    struct hello_device_t* dev;
　　 dev = (struct hello_device_t*)malloc(sizeof(struct hello_device_t));   
　　　　/*--将一个分配域的起始地址转换成struct hello_device_t* 类型
      如果此函数未能成功地执行（例如内存不足），则返回空指针（NULL,‘0‘）--*/
    if(!dev) {  
        LOGE("Hello Stub: failed to alloc space");  
        return -EFAULT;  
    }  
  
    memset(dev, 0, sizeof(struct hello_device_t));  //清空该段内存，然后该内存段重新赋值
    dev->common.tag = HARDWARE_DEVICE_TAG;  
    dev->common.version = 0;  
    dev->common.module = (hw_module_t*)module;  
    dev->common.close = hello_device_close;  
    dev->set_val = hello_set_val;dev->get_val = hello_get_val;  
  
    if((dev->fd = open(DEVICE_NAME, O_RDWR)) == -1) {       //返回 -1 时，模块打开失败
        LOGE("Hello Stub: failed to open /dev/hello -- %s.", strerror(errno));free(dev);  
        return -EFAULT;  
    }  
    *device = &(dev->common);  
    LOGI("Hello Stub: open /dev/hello successfully.");   //LOGI是打印信息吗？ 在哪定义的？
  
    return 0;  
}