想了解HIDL介绍的可以参考《HIDL概述》,本篇文章主要介绍HIDL的详细编译流程及简单的客户端应用(C++跟Android客户端的应用)。
一、准备工作
整一套源码,Android O或者Android P的
保证全套代码已经全编译,原生代码全编译命令
source build/envset.sh
lunch
make
3、hidl-gen工具已经安装,安装命令
make hidl-gen
二、hidl-gen工具介绍
系统定义的所有的.hal接口,都是通过hidl-gen工具转换成对应的代码。hidl-gen源码路径:system/tools/hidl,是在ubuntu上可执行的二进制文件。
使用方法:hidl-gen -o output-path -L language (-r interface-root) fqname
例子:
hidl-gen -o hardware/interfaces/gunder/1.0/default/ -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport [email protected]
参数说明:
-L: 语言类型,包括c++, c++-headers, c++-sources, export-header, c++-impl, java, java-constants, vts, makefile, androidbp, androidbp-impl, hash等。hidl-gen可根据传入的语言类型产生不同的文件。
fqname: 完全限定名称的输入文件。比如本例中[email protected],要求在源码目录下必须有hardware/interfaces/ gunder /1.0/目录。对于单个文件来说,格式如下:package@version::fileName,比如android.hardware. gunder @1.0::types.Feature。对于目录来说。格式如下package@version,比如android.hardware. gunder @1.0。
-r: 格式package:path,可选,对fqname对应的文件来说,用来指定包名和文件所在的目录到Android系统源码根目录的路径。如果没有制定,前缀默认是:android.hardware,目录是Android源码的根目录。
-o:存放hidl-gen产生的中间文件的路径。
可以使用hidl-gen 查看帮助,如图1:
图1 hidl-gen的帮助信息
三、项目实例
1、在hardware/interfaces/目录下新建gunder/1.0目录,并在1.0目录中创建接口IGunder.hal。目录结构如下:
gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree
.
└── 1.0
└── IGunder.hal
IGunder.hal文件里面只有一个接口IGunder和一个方法helloWorld(string name),具体实现如下:
package [email protected];
interface IGunder{
helloWorld(string name) generates (string result);
};
2、执行下面三条命令会自动生成对应的c++文件;
[email protected]
LOC=hardware/interfaces/gunder/1.0/default/
hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE
执行命令后的目录结构如下:
gunder@ubuntu-MX8:~ /IMX8_b0beta2$ [email protected]
gunder@ubuntu-MX8:~ /IMX8_b0beta2$ LOC=hardware/interfaces/gunder/1.0/default/
gunder@ubuntu-MX8:~ /IMX8_b0beta2$ hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE
gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree
.
└── 1.0
├── default
│ ├── Gunder.cpp
│ └── Gunder.h
└── IGunder.hal
default 是新生成的目录,Gunder.cpp和Gunder.h是新生成的两个文件,打开Gunder.h文件,去掉// extern "C" IGunder* HIDL_FETCH_IGunder(const char* name);前面的注释,使用直通式HAL(Passthrough 模式)来通信。Gunder.h文件修改后如图2:
图2 Gunder.h修改后的内容
Gunder.cpp文件也要进行对应的修改,修改后如如图3:
图3 Gunder.cpp修改后的内容
3、执行下面命令
hidl-gen -o $LOC -Landroidbp-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE
会在hardware/interfaces/gunder/1.0/default目录生成Android.bp文件。
gunder@ubuntu-MX8:~ /IMX8_b0beta2/hardware/interfaces/gunder$ tree
.
└── 1.0
├── default
│ ├── Android.bp
│ ├── Gunder.cpp
│ └── Gunder.h
└── IGunder.hal
4、然后使用脚本update-makefiles.sh来更新Makefile,自动在hardware/interfaces/gunder/1.0目录生成Android,mk和 Android.bp,hardware/interfaces/gunder目录生成Android.bp。命令如下
./hardware/interfaces/update-makefiles.sh
执行完命令后目录结构如下:
gunder@ubuntu-MX8:~/IMX8_b0beta2$ ./hardware/interfaces/update-makefiles.sh
gunder@ubuntu-MX8:~/IMX8_b0beta2/hardware/interfaces/gunder$ tree
.
├── 1.0
│ ├── Android.bp
│ ├── Android.mk
│ ├── default
│ │ ├── Android.bp
│ │ ├── Gunder.cpp
│ │ └── Gunder.h
│ └── IGunder.hal
└── Android.bp
5、在hardware/interfaces/gunder/1.0/default目录下新建service.cpp跟[email protected],其中[email protected]是程序的入口函数。新的目录结构如下:
.
├── 1.0
│ ├── Android.bp
│ ├── Android.mk
│ ├── default
│ │ ├── Android.bp
│ │ ├── [email protected]
│ │ ├── Gunder.cpp
│ │ ├── Gunder.h
│ │ └── service.cpp
│ └── IGunder.hal
└── Android.bp
[email protected]的实现如图:
service.cpp的实现如图:
打开hardware/interfaces/gunder/1.0/default目录下的Android.bp,添加编译service.cpp成为可执行文件的代码。具体添加内容如下:
到此跟HAL相关的代码就实现完了。
6、编译生成服务端跟客户端要用各种库文件。首先执行下面两条命令
./hardware/interfaces/update-makefiles.sh
mmm hardware/interfaces/gunder/1.0/
执行后会生成下面的文件:
out/target/product/mek_8q/system/lib64/[email protected]
out/target/product/mek_8q/vendor/lib64/hw/[email protected]
out/target/product/mek_8q/vendor/etc/init/[email protected]
7、在manifest文件里添加vendor接口的定义编译device/fsl/mek_8q/manifest.xml文件(不同厂家路径可能不一样),添加以下内容,不然在client端是没法拿到service的。如下:
8、使用C++实现客户端调用
在hardware/interfaces/gunder/1.0目录下新建test目录,并且在test目录下新建Android.bp跟GunderTest.cpp文件,这两个文件的内容如下:
GunderTest.cpp:
Android.bp:
执行以下命令:
./hardware/interfaces/update-makefiles.sh
mmm hardware/interfaces/gunder/1.0/
执行第一条命令是为了更新hardware/interfaces/gunder/目录下的Android.bp文件,如下:
执行第二条命令会生成可执行文件:
out/target/product/mek_8q/vendor/bin/hw/gunder_client
9、使用JAVA实现客户端调用
为了方便eclipse或者Android Studio调用接口函数,需要编译出classes.jar包。但是jack编译出来的文件是classes.jack。如图:
为了编译出classes.jar,需要打开hardware/interfaces/gunder/1.0目录的Android.mk,在include $(CLEAR_VARS)下面添加LOCAL_JACK_ENABLED := disabled。这样编译的时候就不走jack编译了。如下:
执行下面命令
mmm hardware/interfaces/gunder/1.0/
执行完后生成了classes.jar。如图:
新建Android项目HIDLdemo,将classes.jar导入项目,MainActivity代码实现如下:
添加Android.mk文件,然后将项目放到packages/apps/进行编译。Android.mk文件内容如下:
执行命令
mmm packages/apps/HIDLdemo
会生成out/target/product/mek_8q/system/app/HIDLdemo/HIDLdemo.apk
10、测试客户端程序
执行下列命令:
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\lib64\hw\[email protected] /vendor/lib64/hw
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\system\lib64\[email protected] /system/lib64
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\bin\hw\gunder_client /vendor/bin/hw
adb push X:\IMX8_b0beta2\out\target\product\mek_8q\vendor\bin\hw\[email protected] /vendor/bin/hw
adb push X:\IMX8_b0beta2\device\fsl\evk_8mq\manifest.xml /vendor
adb install -r X:\IMX8_b0beta2\out\target\product\ mek_8q \system\app\HIDLdemo\HIDLdemo.apk
上面的命令是将需要的文件push到系统,方便调试。
C++客户端调试:
先启动./[email protected]服务,然后启动gunder_client程序,执行结果如下:
Android客户端执行:
先启动./[email protected]服务,然后通过命令拉起MainActivity界面
adb shell am start -n com.example.ytkj.hidldemo/.MainActivity,执行结果如下:
代码参考:https://github.com/gunder1129/android-tool/tree/master/HIDL
---------------------
作者:u013357557
来源:CSDN
原文:https://blog.csdn.net/u013357557/article/details/84561652
版权声明:本文为博主原创文章,转载请附上博文链接!