Android 14之HIDL转AIDL通信
- 1、interface接口
- 1.1 接口变更
- 1.2 生成hidl2aidl工具
- 1.3 执行hidl2aidl指令
- 1.4 修改aidl的Android.bp文件
- 1.5 创建路径
- 1.6 拷贝生成的aidl到1和current
- 1.7 更新与冻结版本
- 1.8 编译模块接口
- 2、服务端代码适配hal代码修改
- 2.1 修改Android.bp的hidl依赖
- 2.2 修改头文件依赖
- 2.3 修改服务启动的rc脚本
- 2.4 修改接口函数,返回值Return<>拆分
- 2.5 aidl 服务实现
1、interface接口
1.1 接口变更
google原生的::ndk::ScopedAStatus 已经支持status返回了,hal接口理论上不需要再自定义status。所以需要删除掉目前我们HIDL文件里面里所有使用到status的接口。
注意:需要用到的返回值不需要删除,要保留,只需要删除无用的status即可。
例子1:
gwm_subscribe(IDiagCallback callback, vec<uint16_t> didList) generates (GWM_StatusCode status);
修改为:
gwm_subscribe(IDiagCallback callback, vec<uint16_t> didList) ;
并删掉enum GWM_StatusCode 枚举(GWM_StatusCode不需要使用的话)
例子2:
gwm_registerCallback(ISwumCallback callback) generates (bool status);
修改为:
bool gwm_registerCallback(ISwumCallback callback);
例子3:
gwm_setCallback(IInformationCallback callback) generates (GWM_StatusCode status, int32_t clientid);
修改为:
int gwm_setCallback(in IInformationCallback callback);
后续的例子以ILog.hal为例:
修改前:
sendToServer(String data) generates(boolean result) ;
void setCallback(ILogCallback callback);
修改后:
boolean sendToServer(in String data);
void setCallback(in vendor.mediatek.hardware.log.ILogCallback callback);
1.2 生成hidl2aidl工具
注意:需要先执行source和lunch命令
m hidl2aidl -j128
1.3 执行hidl2aidl指令
hidl2aidl -o 要生成的aidl的路径 -r 转换的hidl的路径 hidl_interface name
这里用的命令是:
hidl2aidl -o vendor/mediatek/proprietary/hardware/interfaces/log/aidl -r vendor/mediatek/proprietary/hardware/interfaces/log vendor.mediatek.hardware.log@1.0
hidl_interface name一般是hidl同级目录下Android.bp文件里面定义的。
1、如果有报错,按照提示修改即可。
2、VehicleHAL/wifi/sensor等原生接口除外,如VehicleHAL为原生接口,需要根据原生接口适配aidl 服务器
3、当执行完上述的hidl2aidl指令后,会在-o 对应目录下生成aidl文件,和一些translate文件,以及Android.bp。
1.4 修改aidl的Android.bp文件
删除translate文件。
会生成如下截图红框所示文件:
文件结构:
Android.bp:
aidl_interface {name: "vendor.mediatek.hardware.log",system_ext_specific: true,vendor_available: true,host_supported: true,frozen: true,srcs: ["vendor/mediatek/hardware/log/*.aidl"],stability: "vintf",backend: {cpp: {// FIXME should this be disabled?// prefer NDK backend which can be used anywhere// If you disable this, you also need to delete the C++// translate code.enabled: true, },java: {sdk_version: "system_current",enabled: true, },},versions_with_info: [{version: "1",imports: [],},],
}
backend: 服务的后端,AIDL支持四种后端,分别是C++/JAVA/NDK/RUST, 我们要使用NDK(谷歌推荐),CPP和JAVA后端,加上enabled: true。
vendor_available配置参考vndk介绍文档
ILog.aidl:
package vendor.mediatek.hardware.log;import vendor.mediatek.hardware.log.ILogCallback;@VintfStability
interface ILog {// Adding return type to method instead of out param boolean success since there is only one return value.boolean sendToServer(in String data);void setCallback(in ILogCallback callback);}
ILogCallback.aidl:
// FIXME: license file, or use the -l option to generate the files with the header.package vendor.mediatek.hardware.log;@VintfStability
interface ILogCallback {// Adding return type to method instead of out param boolean success since there is only one return value.boolean callbackToClient(in String data);}
1.5 创建路径
mkdir -p aidl_api/vendor.mediatek.hardware.log
cd aidl_api/vendor.mediatek.hardware.log
mkdir 1
mkdir current
1.6 拷贝生成的aidl到1和current
我自己本地尝试不拷贝直接进行下一步:更新和冻结版本会遇到问题,提示文件夹1下面没有文件。如果可以用1.7更新api和冻结api直接生成的请跳过这一步。
1.7 更新与冻结版本
先生成hash文件
croot && system/tools/aidl/build/hash_gen.sh vendor/mediatek/proprietary/hardware/interfaces/log/aidl/aidl_api/vendor.mediatek.hardware.log/1 latest-version vendor/mediatek/proprietary/hardware/interfaces/log/aidl/aidl_api/vendor.mediatek.hardware.log/1/.hash
//更新api:
m vendor.mediatek.hardware.log-update-api
//执行后生成current的api
//冻结api:
m vendor.mediatek.hardware.log-freeze-api
//执行后生成初始版本号为1的api,并且生成.hash文件,并将frozen改为true
如果提示version:这个错误,需要在Android.bp添加:
versions_with_info: [
{
version: "1",
imports: [],
},
],
错误提示:
vendor/mediatek/proprietary/hardware/interfaces/log/aidl/Android.bp:3:1: module “vendor.mediatek.hardware.log_interface”: versions: must be set (need to be frozen) because: “this is a release branch - freeze it or set ‘owners:’”
1.8 编译模块接口
先将interface编译通过:
mmm vendor/mediatek/proprietary/hardware/interfaces/log/aidl
有错解错
会编译生成jar包,还有ndk相关文件
2、服务端代码适配hal代码修改
2.1 修改Android.bp的hidl依赖
去掉hidl依赖库
“libhidlbase”,
“libhidltransport”,
添加binder依赖库:
“libbinder_ndk”,
“libbinder”,
去掉hidl接口模块:
vendor.mediatek.hardware.log@1.0
添加aidl接口模块:
“vendor.mediatek.hardware.lbs-V1-ndk”,
2.2 修改头文件依赖
HIDL的特点是,服务端和客户端都引用相同的接口文件即可,由编译时工具自动进行展开。这里需要将HIDL的引用该为AIDL的。
将vendor/mediatek/hardware/log/2.0/ILog.h
改为aidl/vendor/mediatek/hardware/log/BnILog.h //BinderNative
在路径gen\include\aidl\vendor\mediatek\hardware\log路径下生成的头文件。
2.3 修改服务启动的rc脚本
service mtk_lbs_service.rc:
service mtk_lbs_service /vendor/bin/mtk_lbs_serviceclass haluser systemgroup system gps radio inet
2.4 修改接口函数,返回值Return<>拆分
AIDL不再使用Return<>模板函数,直接将其拆分为状态和值,状态由 ::ndk::ScopedAStatus返回,非void的值由输出参数返回。
之前实现的hidl接口返回类型为Return的需要改成**::ndk::ScopedAStatus**,返回值也需要同步修改为ScopedAStatus::ok()
例子:
virtual ::android::hardware::Return<bool> gwm_registerCallback(
const ::android::sp<::vendor::gwm::hardware::swum::V2_0::ISwumCallback>& callback)
override;
修改为:
virtual ::ndk::ScopedAStatus gwm_registerCallback(
const ::android::sp<::vendor.gwm.hardware.swum::ISwumCallback>& callback,bool* _aidl_return) override;
状态拆分成了::ndk::ScopedAStatus作为返回值,HIDL的GWM_StatusCode 返回值放到了输出参数中,使用指针的形式返回。
注意:
1、::ndk::ScopedAStatus 依然可以使用isOk的方法。类似于下面这种用法,在aidl仍然适用。具体作用就不在这里详细讲了,后面有机会更新下。
auto ret = mCallback->LocationInfoStructOnChange(locationStruct);
if (!ret.isOk()) {
ALOGI("%s has error", func);
}
除了拆分其实也可以直接去参考BnILog.h文件,最后头文件的声明为:
virtual ScopedAStatus setCallback(const std::shared_ptr<ILbsCallback>& callback) override;
virtual ScopedAStatus sendToServer(const std::vector<uint8_t>& data, bool* result) override;
cpp文件的实现为:
ScopedAStatus AgpsDebugInterfaceLbsService::setCallback(const std::shared_ptr<ILbsCallback>& callback) {if (callback == nullptr) {LOGE("[%s][%s] AgpsDebugInterfaceLbsService setCallback is null !!!", g_ver, mName);return ScopedAStatus::ok();;}BaseLbsService::setCallback(callback);if(mLocalFd != -1) {LOGE("[%s][%s] DebugInterface::setCallback() mLocalFd is not -1", g_ver, mName);return ScopedAStatus::ok();}if (connectToAgpsd3()) {mIsExit = false;};return ScopedAStatus::ok();
}ScopedAStatus AgpsDebugInterfaceLbsService::sendToServer(const std::vector<uint8_t>& data,bool* result) {char buff[MAX_BUFFER_SIZE] = {0};int read_len = 0;LOGD("[%s][%s] DebugInterface::sendToServer() size=[%d]", g_ver, mName, (int)data.size());if (data.size() == 0 || data.size() > MAX_BUFFER_SIZE) {LOGE("[%s][%s] DebugInterface::sendToServer() data size check fail !", g_ver, mName);*result = false;return ScopedAStatus::ok();}covertVector2Array(data, buff);read_len = mtk_socket_write(mLocalFd, buff, (int)data.size());if (read_len <= 0 ) {LOGE("[%s][%s] DebugInterface mtk_socket_write() failed, len=%d", g_ver, mName, read_len);}// we don't care the error happens in this scenarioUNUSED(read_len);mIsExit = true;*result = true;return ScopedAStatus::ok();
}
注意:在aidl中所有的指针类型都会定义为智能指针std_sharedptr,之前hidl定义的强指针sp需要修改为智能指针。
2.5 aidl 服务实现
模板大概是:
hidl hal:
auto service = std::make_unique<Diag>(); //创建对象
configureRpcThreadpool(4, true /* callerWillJoin */); //配置线程池
ALOGD("Diag HAL service starting");
status_t status = service->registerAsService(); //注册服务
if (status != OK) {ALOGE("Unable to register Diag HAL service (%d)", status); return 1;
}ALOGI("Register DiagHAL Service successfully");
joinRpcThreadpool(); //加入线程池
aidl hal:
android::ProcessState::initWithDriver("/dev/vndbinder"); //使用vndbinder设备节点
ABinderProcess_setThreadPoolMaxThreadCount(1); // vnbinder的线程池独立,需要单独配置
ABinderProcess_startThreadPool(); //手动启动线程池
// registering
std::shared_ptr<Diag> service = ::ndk::SharedRefBase::make<Diag>(); //创建对象
const std::string desc = Diag::descriptor + "/default"s;binder_exception_t err = AServiceManager_addService(service>asBinder().get(), desc.c_str()); //注册服务
CHECK_EQ(err, STATUS_OK);
ABinderProcess_joinThreadPool();
//加入线程池
最终实现:
#define LOG_TAG "mtk_lbs_service"#include <android/binder_process.h>
#include <log/log.h>#include "mtk_lbs_service.h"//namespace aidl::vendor::mediatek::hardware::lbs {
//extern int mtk_lbs_main();
//}int main() { Register AIDL servicebinder_exception_t err = AServiceManager_addService(service->asBinder().get(), "vendor.mediatek.hardware.log.ILog/lbs");if (err != EX_NONE) {ALOGE("failed to register vendor.mediatek.hardware.log.ILog service, exception: %d", err);return 1;}ABinderProcess_setThreadPoolMaxThreadCount(20);ABinderProcess_startThreadPool();//aidl::vendor::mediatek::hardware::lbs::mtk_lbs_main();ABinderProcess_joinThreadPool();return EXIT_FAILURE; // should not reach
}
然后就是编译hal模块,编译遇到什么问题改什么。