25.MTK Androiod HAL如何向上层提供接口

Android中HAL如何向上层提供接口总结

转自:http://blog.csdn.net/flydream0/article/details/7086273

参考文献:

http://blog.csdn.net/luoshengyang/article/details/6573809

http://blog.csdn.net/hongtao_liu/article/details/6060734

1.什么是HAL?



HAL的全称是Hardware Abstraction Layer,即硬件抽象层.其架构图如下:

Android的HAL是为了保护一些硬件提供商的知识产权而提出的,是为了避开linux的GPL束缚。思路是把控制硬件的动作都放到了Android HAL中,而linux driver仅仅完成一些简单的数据交互作用,甚至把硬件寄存器空间直接映射到user space。而Android是基于Aparch的license,因此硬件厂商可以只提供二进制代码,所以说Android只是一个开放的平台,并不是一个开源的平台。也许也正是因为Android不遵从GPL,所以Greg Kroah-Hartman才在2.6.33内核将Andorid驱动从linux中删除。GPL和硬件厂商目前还是有着无法弥合的裂痕。Android想要把这个问题处理好也是不容易的。

总结下来,Android HAL存在的原因主要有:

1. 并不是所有的硬件设备都有标准的linux kernel的接口

2. KERNEL DRIVER涉及到GPL的版权。某些设备制造商并不原因公开硬件驱动,所以才去用HAL方式绕过GPL。

3. 针对某些硬件,Android有一些特殊的需求.

2.与接口相关的几个结构体



首先来看三个与HAL对上层接口有关的几个结构体:

[html] view plaincopy

  1. struct hw_module_t;                      //模块类型
  2. struct hw_module_methods_t;      //模块方法
  3. struct hw_device_t;                      //设备类型

这几个数据结构是在Android工作目录/hardware/libhardware/include/hardware/hardware.h文件中定义.

3.解释



一般来说,在写HAL相关代码时都得包含这个hardware.h头文件,所以有必要先了解一下这个头文件中的内容.

[cpp] view plaincopy

  1. /*
  2. * Copyright (C) 2008 The Android Open Source Project
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. *      http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #ifndef ANDROID_INCLUDE_HARDWARE_HARDWARE_H
  17. #define ANDROID_INCLUDE_HARDWARE_HARDWARE_H
  18. #include <stdint.h>
  19. #include <sys/cdefs.h>
  20. #include <cutils/native_handle.h>
  21. #include <system/graphics.h>
  22. __BEGIN_DECLS
  23. /*
  24. * Value for the hw_module_t.tag field
  25. */
  26. #define MAKE_TAG_CONSTANT(A,B,C,D) (((A) << 24) | ((B) << 16) | ((C) << 8) | (D))
  27. #define HARDWARE_MODULE_TAG MAKE_TAG_CONSTANT(‘H‘, ‘W‘, ‘M‘, ‘T‘)
  28. #define HARDWARE_DEVICE_TAG MAKE_TAG_CONSTANT(‘H‘, ‘W‘, ‘D‘, ‘T‘)
  29. struct hw_module_t;
  30. struct hw_module_methods_t;
  31. struct hw_device_t;
  32. /**
  33. * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM
  34. * and the fields of this data structure must begin with hw_module_t
  35. * followed by module specific information.
  36. */
  37. //每一个硬件模块都每必须有一个名为HAL_MODULE_INFO_SYM的数据结构变量,它的第一个成员的类型必须为hw_module_t
  38. typedef struct hw_module_t {
  39. /** tag must be initialized to HARDWARE_MODULE_TAG */
  40. uint32_t tag;
  41. /** major version number for the module */
  42. uint16_t version_major;
  43. /** minor version number of the module */
  44. uint16_t version_minor;
  45. /** Identifier of module */
  46. const char *id;
  47. /** Name of this module */
  48. const char *name;
  49. /** Author/owner/implementor of the module */
  50. const char *author;
  51. /** Modules methods模块方法列表,指向hw_module_methods_t */
  52. struct hw_module_methods_t* methods;
  53. /** module‘s dso */
  54. void* dso;
  55. /** padding to 128 bytes, reserved for future use */
  56. uint32_t reserved[32-7];
  57. } hw_module_t;

    //硬件模块方法列表的定义,这里只定义了一个open函数

  1. typedef struct hw_module_methods_t {
  2. /** Open a specific device */
  3. int (*open)(const struct hw_module_t* module, const char* id, //注意这个open函数明确指出第三个参数的类型为struct hw_device_t**
  4. struct hw_device_t** device);
  5. } hw_module_methods_t;
  1. /**
  2. * Every device data structure must begin with hw_device_t
  3. * followed by module specific public methods and attributes.
  4. */
  5. //每一个设备数据结构的第一个成员函数必须是hw_device_t类型,其次才是各个公共方法和属性
  6. typedef struct hw_device_t {
  7. /** tag must be initialized to HARDWARE_DEVICE_TAG */
  8. uint32_t tag;
  9. /** version number for hw_device_t */
  10. uint32_t version;
  11. /** reference to the module this device belongs to */
  12. struct hw_module_t* module;
  13. /** padding reserved for future use */
  14. uint32_t reserved[12];
  15. /** Close this device */
  16. int (*close)(struct hw_device_t* device);
  17. } hw_device_t;
  18. /**
  19. * Name of the hal_module_info
  20. */
  21. #define HAL_MODULE_INFO_SYM         HMI
  22. /**
  23. * Name of the hal_module_info as a string
  24. */
  25. #define HAL_MODULE_INFO_SYM_AS_STR  "HMI"
  26. /**
  27. * Get the module info associated with a module by id.
  28. *
  29. * @return: 0 == success, <0 == error and *module == NULL
  30. */
  31. int hw_get_module(const char *id, const struct hw_module_t **module);
  32. /**
  33. * Get the module info associated with a module instance by class ‘class_id‘
  34. * and instance ‘inst‘.
  35. *
  36. * Some modules types necessitate multiple instances. For example audio supports
  37. * multiple concurrent interfaces and thus ‘audio‘ is the module class
  38. * and ‘primary‘ or ‘a2dp‘ are module interfaces. This implies that the files
  39. * providing these modules would be named audio.primary.<variant>.so and
  40. * audio.a2dp.<variant>.so
  41. *
  42. * @return: 0 == success, <0 == error and *module == NULL
  43. */
  44. int hw_get_module_by_class(const char *class_id, const char *inst,
  45. const struct hw_module_t **module);
  46. __END_DECLS
  47. #endif  /* ANDROID_INCLUDE_HARDWARE_HARDWARE_H */

由以上内容可以看出(typedef struct hw_module_t ,typedef struct hw_device_t),如果我们要写一个自定义设备的驱动的HAL层时,我们得首先自定义两个数据结构:

假设我们要做的设备名为XXX:

在头文件中定义:XXX.h

[cpp] view plaincopy

  1. /*定义模块ID*/
  2. #define XXX_HARDWARE_MODULE_ID "XXX"
  3. /*硬件模块结构体*/
  4. //见hardware.h中的hw_module_t定义的说明,xxx_module_t的第一个成员必须是hw_module_t类型,其次才是模块的一此相关信息,当然也可以不定义,
  5. //这里就没有定义模块相关信息
  6. struct xxx_module_t {
  7. struct hw_module_t common;
  8. };
  9. /*硬件接口结构体*/
  10. //见hardware.h中的hw_device_t的说明,要求自定义xxx_device_t的第一个成员必须是hw_device_t类型,其次才是其它的一些接口信息.
  11. struct xxx_device_t {
  12. struct hw_device_t common;
  13. //以下成员是HAL对上层提供的接口或一些属性
  14. int fd;
  15. int (*set_val)(struct xxx_device_t* dev, int val);
  16. int (*get_val)(struct xxx_device_t* dev, int* val);
  17. };

注:特别注意xxx_device_t的结构定义,这个才是HAL向上层提供接口函数的数据结构,其成员就是我们想要关心的接口函数.

接下来我们在实现文件XXX.c文件中定义一个xxx_module_t的变量:

[cpp] view plaincopy

  1. /*模块实例变量*/
  2. struct xxx_module_t HAL_MODULE_INFO_SYM = {    //变量名必须为HAL_MODULE_INFO_SYM,这是强制要求的,你要写Android的HAL就得遵循这个游戏规则,
  3. //见hardware.h中的hw_module_t的类型信息说明.
  4. common: {
  5. tag: HARDWARE_MODULE_TAG,
  6. version_major: 1,
  7. version_minor: 0,
  8. id: XXX_HARDWARE_MODULE_ID,    //头文件中有定义
  9. name: MODULE_NAME,
  10. author: MODULE_AUTHOR,
  11. methods: &xxx_module_methods,  //模块方法列表,在本地定义
  12. }
  13. };

注意到上面有HAL_MODULE_INFO_SYM变量的成员common中包含一个函数列表xxx_module_methods,而这个成员函数列表是在本地自定义的。那么这个成员函数列是不是就是HAL向上层提供函数的地方呢?很失望,不是在这里,前面我们已经说过了,是在xxx_device_t中定义的,这个xxx_module_methods实际上只提供了一个open函数,就相当于只提供了一个模块初始化函数.其定义如下:

[cpp] view plaincopy

  1. /*模块方法表*/
  2. static struct hw_module_methods_t xxx_module_methods = {
  3. open: xxx_device_open
  4. };

注意到,上边的函数列表中只列出了一个xxx_device_open函数,这个函数也是需要在本地实现的一个函数。前面说过,这个函数只相当于模块初始化函数。

那么HAL又到底是怎么将xxx_device_t中定义的接口提供到上层去的呢?

且看上面这个函数列表中唯一的一个xxx_device_open的定义:

[cpp] view plaincopy

  1. static int xxx_device_open(const struct hw_module_t* module, const char* name, struct hw_device_t** device) {
  2. struct xxx_device_t* dev;
  3. dev = (struct hello_device_t*)malloc(sizeof(struct xxx_device_t));//动态分配空间
  4. if(!dev) {
  5. LOGE("Hello Stub: failed to alloc space");
  6. return -EFAULT;
  7. }
  8. memset(dev, 0, sizeof(struct xxx_device_t));
  9. //对dev->common的内容赋值,
  10. dev->common.tag = HARDWARE_DEVICE_TAG;
  11. dev->common.version = 0;
  12. dev->common.module = (hw_module_t*)module;
  13. dev->common.close = xxx_device_close;
  14. //对dev其它成员赋值
  15. dev->set_val = xxx_set_val;
  16. dev->get_val = xxx_get_val;
  17. if((dev->fd = open(DEVICE_NAME, O_RDWR)) == -1) {
  18. LOGE("Hello Stub: failed to open /dev/hello -- %s.", strerror(errno));
  19. free(dev);
  20. return -EFAULT;
  21. }
  22. //输出&(dev->common),输出的并不是dev,而是&(dev->common)!(common内不是只包含了一个close接口吗?)
  23. *device = &(dev->common);
  24. LOGI("Hello Stub: open /dev/hello successfully.");
  25. return 0;
  26. }

经验告诉我们,一般在进行模块初始化的时候,模块的接口函数也会“注册”,上面是模块初始化函数,那么接口注册在哪?于是我们找到*device =&(dev->common);这行代码,可问题是,这样一来,返回给调用者不是&(dev->common)吗?而这个dev->common仅仅只包含了一个模块关闭接口!到底怎么回事?为什么不直接返回dev,dev下不是提供所有HAL向上层接口吗?

在回答上述问题之前,让我们先看一下这xxx_device_open函数原型,还是在hardware.h头文件中,找到下面几行代码:

[cpp] view plaincopy

  1. typedef struct hw_module_methods_t {
  2. /** Open a specific device */
  3. int (*open)(const struct hw_module_t* module, const char* id,
  4. struct hw_device_t** device);
  5. } hw_module_methods_t;

这是方法列表的定义,明确要求了方法列表中有且只一个open方法,即相当于模块初始化方法,且,这个方法的第三个参数明确指明了类型是struct hw_device_t **,而不是用户自定义的xxx_device_t,这也就是解译了在open函数实现内为什么输出的是&(dev->common)而不是dev了,原来返回的类型在hardware.h中的open函数原型中明确指出只能返回hw_device_t类型.

可是,dev->common不是只包含close接口吗?做为HAL的上层,它又是怎么"看得到"HAL提供的全部接口的呢?

接下来,让我们来看看做为HAL上层,它又是怎么使用由HAL返回的dev->common的:

参考: 在Ubuntu为Android硬件抽象层(HAL)模块编写JNI方法提供Java访问硬件服务接口 这篇文章,从中可以看到这么几行代码:

[cpp] view plaincopy

  1. /*通过硬件抽象层定义的硬件模块打开接口打开硬件设备*/
  2. static inline int hello_device_open(const hw_module_t* module, struct hello_device_t** device) {
  3. return module->methods->open(module, HELLO_HARDWARE_MODULE_ID, (struct hw_device_t**)device);
  4. }

由此可见,返回的&(dev->common)最终会返回给struce hello_device_t **类型的输出变量device,换句话说,类型为hw_device_t的dev->common在初始化函数open返回后,会强制转化为xxx_device_t来使用,终于明白了,原来如此!另外,在hardware.h中对xxx_device_t类型有说明,要求它的第一个成员的类型必须是hw_device_t,原来是为了HAL上层使用时的强制转化的目的,如果xxx_device_t的第一个成员类型不是hw_device_t,那么HAL上层使用中强制转化就没有意义了,这个时候,就真的“看不到”HAL提供的接口了.

此外,在hardware.h头文件中,还有明确要求定义xxx_module_t类型时,明确要求第一个成员变量类型必须为hw_module_t,这也是为了方便找到其第一个成员变量common,进而找到本地定义的方法列表,从而调用open函数进行模块初始化.

综上所述,HAL是通过struct xxx_device_t这个结构体向上层提供接口的.

即:接口包含在struct xxx_device_t这个结构体内。

而具体执行是通过struct xxx_module_t HAL_MODULE_INFO_SYM这个结构体变量的函数列表成员下的open函数来返回给上层的.

原文地址:https://www.cnblogs.com/cyqx/p/10926492.html

时间: 2024-10-07 06:00:15

25.MTK Androiod HAL如何向上层提供接口的相关文章

Android:HAL向上层提供接口

研究Android的核心库框架,慢慢的想了解一写驱动开发,Android怎么和Linux打交道?下面介绍一个对Android核心框架的HAL(Hardware Abstraction Layer)的理解.Android核心框架如图: Android的HAL是为了保护一些硬件提供商的知识产权而提出的,是为了避开linux的GPL束缚.思路是把控制硬件的动作都放到了 Android HAL中,而linux driver仅仅完成一些简单的数据交互作用,甚至把硬件寄存器空间直接映射到user space

android中自定义view---实现竖直方向的文字功能,文字方向朝上,同时提供接口,判断当前touch的是哪个字符,并改变颜色

android自定义view,实现竖直方向的文字功能,文字方向朝上,同时提供接口,判断当前touch的是哪个字符,并改变颜色. 由于时间比较仓促,因此没有对代码进行过多的优化,功能远远不如android的自带的TextView强大,只是继承于view,而不是textview. 主要用途:电话本的侧边快速导航等 效果图:(自定义字符串 “#ABCDEFGHIJKLMN),可以实现自定义任意字符串 view的实现: 1 import cn.carbs.verticalstraighttextview

Java服务器对外提供接口以及Android端向服务器请求数据

讲解下java服务器是如何对移动终端提供接口的,以什么数据格式提供出去,移动端又是怎么请求服务器,接收以及解析返回数据的. 服务端:还是在原先S2SH框架的项目上(搭建SSH详细步骤及其相关说明),加入Servlet来做对终端提供接口的事情. Android端:用了一个网络访问框架okHttp,向服务器请求数据. 服务端: servlet接收移动端的get.post请求,进行相应逻辑处理后将要返回的数据封装成json格式写出去. 对数据库的操作传统的Servlet是用jdbc,但是操作过于繁琐,

使用WCF对外提供接口

本篇将通过WCF以webservices的方式对外提供接口.同时使用NUnit对webservices中的方法进行单元测试. 开发契约 contract Contract项目为类库项目,该项目下会包含WCF中的ServiceContract,这是一些被加上Attribute [ServiceContract]的接口.同时接口中的方法也需要加上Attribute [OperationContract].另,考虑到下一篇要对接口进行压力测试,所以接口中的方法也加上Attribute [WebGet]

整理一些网站 方便查看和搜索的想法 有合作伙伴么 (需要产品 前端人员 后端人员 只要做网站web, 目前不考虑app, 后期考虑做公众号或者小程序, 也或者对外提供接口)

有合作伙伴么  (需要产品 前端人员 后端人员 只要做网站web, 目前不考虑app, 后期考虑做公众号或者小程序, 也或者对外提供接口) 主要期望功能: 网站形式展示 建立全文索引 加一页查看方式 加一键全文搜索 条件分类搜索   不如中专 大专  以及拥有的专业 首先的目标网站: http://www.cdwx1.com/cqzx/list_2.html 优化点: 列表添加条件快速有效的筛选 根据详情页的相关类别信息进行筛选 把详情页几个分页直接一页展示  方便快速预览 做出选择 按照每学习

MTK andorid从底层到上层添加驱动

1 [编写linux驱动程序] 1.1 一.编写驱动核心程序 1.2 二.配置Kconfig 1.3 三.配置Makefile 1.4 四.配置系统的autoconfig 1.5 五.编译 2 [编写hal模块] 2.1 一.新建xxx.h文件 2.2 二.新建xxx.c文件  2.2.1 1.包含相关头文件和定义相关结构 2.2.2 2.定义hello_device_open函数 2.2.3 3.定义自定义的api函数 2.3 三.在hello目录下新建Android.mk文件 2.4 四.编

和app提供接口调接口那些事

有一个文档是很有必要的:基本内容 要有比如:名称,http方式,参数, 返回值 返回数据类型是JSON,还是 XML 对于返回值注意一个地方''[] , array(), null  这在php看来都是一个类型的比如empty; 然而由于android,ios 所用是强类型语言所以 这些类型在他们看来有着本质的天大的区别,所以要和app人员约定好,要么统一''代替其他类型,要么在文档中明确的注释,如数组有数据当然是数组,没数据是''还是[] php 中的array 特别不是数字键,是字符键的在

WebService cxf提供接口

1.pom.xml配置 <cxf.version>3.1.7</cxf.version> <!-- cxf.dependency --> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>${cxf.version}</version>

抓包工具的使用,为什么要用抓包工具。(因为现在好多公司做接口测试但是不提供接口文档,所以需要我们自己去抓取)

浏览器常用:Chrome/Firefox:F12进行抓包. APP常用:Android/IOS:Fiddler/Charles,进行抓包. 原文地址:https://www.cnblogs.com/wangffeng293/p/11775793.html