Android O HIDL Binderized HAL 简单实现

本文旨在实现一个 android O 上简单的 HAL 库，并用 C++ 实现一个客户端的测试程序。

如果按照以下步骤依次创建并编辑相关文件的话，相信最终来完成这个测试应该是没有什么问题的。

 

首先在 hardware/interfaces 下新建 hidldebug 文件夹，进入该文件夹，

来吧，一起从"0"开始，先来看一下最终的目录结构：

.
├── 1.0
│   ├── Android.bp
│   ├── Android.mk
│   ├── default
│   │   ├── Android.bp
│   │   ├── Hidldebug.cpp
│   │   ├── Hidldebug.h
│   │   └── service.cpp
│   ├── hidldebug_test
│   │   ├── Android.bp
│   │   └── client.cpp
│   └── IHidldebug.hal
└── Android.bp

当然，你的目录是现在空的，别急，我们一步一步进行，接下来会依次创建每一个文件，

请紧跟操作步骤，缺少的文件夹要自己补充啊。

 

一、服务端实现

① 创建 .hal 文件 [ IHidldebug.hal ]：

IHidldebug.hal

package android.hardware.hidldebug@1.0;

interface IHidldebug {
    helloWorld(string name) generates (string result);
};

② 生成相应的 .cpp 及 .h 文件：

PACKAGE=android.hardware.hidldebug@1.0

LOC=hardware/interfaces/hidldebug/1.0/default/

out/host/linux-x86/bin/hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport $PACKAGE

③ 修改文件内容并加入函数的实现  [ Hidldebug.cpp ]：

#include "Hidldebug.h"

namespace android {
namespace hardware {
namespace hidldebug {
namespace V1_0 {
namespace implementation {

// Methods from ::android::hardware::hidldebug::V1_0::IHidldebug follow.
Return<void> Hidldebug::helloWorld(const hidl_string& name, helloWorld_cb _hidl_cb) {
    // TODO implement
    char buf[100];
    ::memset(buf, 0x00, 100);
    ::snprintf(buf, 100, "[Test Routine] Hello, %s", name.c_str());
    hidl_string result(buf);

    _hidl_cb(result);
    return Void();
}


// Methods from ::android::hidl::base::V1_0::IBase follow.

//IHidldebug* HIDL_FETCH_IHidldebug(const char* /* name */) {
//    return new Hidldebug();
//}

}  // namespace implementation
}  // namespace V1_0
}  // namespace hidldebug
}  // namespace hardware
}  // namespace android

④ 头文件基本不变  [ Hidldebug.h ]：

#ifndef ANDROID_HARDWARE_HIDLDEBUG_V1_0_HIDLDEBUG_H
#define ANDROID_HARDWARE_HIDLDEBUG_V1_0_HIDLDEBUG_H

#include <android/hardware/hidldebug/1.0/IHidldebug.h>
#include <hidl/MQDescriptor.h>
#include <hidl/Status.h>

namespace android {
namespace hardware {
namespace hidldebug {
namespace V1_0 {
namespace implementation {

using ::android::hardware::hidldebug::V1_0::IHidldebug;
using ::android::hidl::base::V1_0::DebugInfo;
using ::android::hidl::base::V1_0::IBase;
using ::android::hardware::hidl_array;
using ::android::hardware::hidl_memory;
using ::android::hardware::hidl_string;
using ::android::hardware::hidl_vec;
using ::android::hardware::Return;
using ::android::hardware::Void;
using ::android::sp;

struct Hidldebug : public IHidldebug {
    // Methods from ::android::hardware::hidldebug::V1_0::IHidldebug follow.
    Return<void> helloWorld(const hidl_string& name, helloWorld_cb _hidl_cb) override;

    // Methods from ::android::hidl::base::V1_0::IBase follow.

};

//extern "C" IHidldebug* HIDL_FETCH_IHidldebug(const char* name);

}  // namespace implementation
}  // namespace V1_0
}  // namespace hidldebug
}  // namespace hardware
}  // namespace android

#endif  // ANDROID_HARDWARE_HIDLDEBUG_V1_0_HIDLDEBUG_H

⑤ 创建 service.cpp：

touch hardware/interfaces/hidldebug/1.0/default/service.cpp

⑥ 在 service.cpp 文件中以下内容  [ service.cpp ]：

#define LOG_TAG "android.hardware.hidldebug@1.0-service"

#include <hidl/HidlSupport.h>
#include <hidl/HidlTransportSupport.h>

#include "Hidldebug.h"

using ::android::hardware::configureRpcThreadpool;
using ::android::hardware::hidldebug::V1_0::IHidldebug;
using ::android::hardware::hidldebug::V1_0::implementation::Hidldebug;
using ::android::hardware::joinRpcThreadpool;
using ::android::OK;
using ::android::sp;

int main(int /* argc */, char* /* argv */ []) {
    sp<IHidldebug> hidldebug = new Hidldebug;
    configureRpcThreadpool(1, true /* will join */);
    if (hidldebug->registerAsService() != OK) {
        ALOGE("Could not register service.");
        return 1;
    }
    joinRpcThreadpool();

    ALOGE("Service exited!");
    return 1;
}

⑦ 创建 android.hardware.hidldebug@1.0-service.rc 文件并填入以下内容：

service hidldebug_hal_service /vendor/bin/hw/android.hardware.hidldebug@1.0-service
    class hal
    user root
    group root

⑧ 创建服务端的 Android.bp 编译脚本并填入以下内容：

cc_binary {
    name: "android.hardware.hidldebug@1.0-service",
    relative_install_path: "hw",
    vendor: true,
    srcs: [
        "Hidldebug.cpp",
        "service.cpp"
    ],
    init_rc: ["android.hardware.hidldebug@1.0-service.rc"],
    shared_libs: [
        "liblog",
        "libhidlbase",
        "libhidltransport",
        "libutils",
        "libhardware",
        "android.hardware.hidldebug@1.0",
    ],
}

二、客户端实现

① 客户端代码实现  [ client.cpp ]：

# include <android/hardware/hidldebug/1.0/IHidldebug.h>
# include <hidl/Status.h>
# include <hidl/LegacySupport.h>
# include <utils/misc.h>
# include <hidl/HidlSupport.h>
# include <stdio.h>

using android::hardware::hidldebug::V1_0::IHidldebug;
using android::sp;
using android::hardware::hidl_string;

int main()
{
    int ret;

    android::sp<IHidldebug> service = IHidldebug::getService();
    if(service == nullptr) {
        printf("Failed to get service
");
        return -1;
    }

    service->helloWorld("Zackary.Liu", [&](hidl_string result) {
                printf("%s
", result.c_str());
        });

    return 0;
}

② 客户端的编译脚本内容 [ Android.bp ]：

cc_binary {
    name: "hidldebug_test",
    vendor: true,
    srcs: [
        "client.cpp",
    ],
    shared_libs: [
        "liblog",
        "libhidlbase",
        "libutils",
        "android.hardware.hidldebug@1.0",
    ],
}

三、编译所有文件

① 执行更新脚本，让系统帮我们创建其它需要的脚本文件：

hardware/interfaces/update-makefiles.sh

② 比对一下最终的文件结构是否和开篇时说的一样

③ 进行最终的编译：

mmm hardware/interfaces/hidldebug/

④ 如果编译成功，将会产出以下的库和可执行文件：

system/lib64/android.hardware.hidldebug@1.0.so
vendor/bin/hw/android.hardware.hidldebug@1.0-service
vendor/etc/init/android.hardware.hidldebug@1.0-service.rc
vendor/bin/hidldebug_test

四、运行测试

/ # vendor/bin/hw/android.hardware.hidldebug@1.0-service &
/ # hidldebug_test
[Test Routine] Hello, Zackary.Liu 

执行完成，成功调用到我们在服务端实现的函数，拼接了客户端输入的字符串并将其打印出来。

目前只是完成在 hal 层的一个测试，接下来还需要了解下 APP 层的调用流程，并实现一个直接的客户端再来进行测试。