Android O ออกแบบระบบปฏิบัติการ Android ใหม่เพื่อกำหนดอินเทอร์เฟซที่ชัดเจนระหว่างแพลตฟอร์ม Android ที่ไม่ขึ้นกับอุปกรณ์และรหัสเฉพาะอุปกรณ์และผู้จำหน่าย Android ได้กำหนดอินเทอร์เฟซดังกล่าวไว้แล้วในรูปแบบของอินเทอร์เฟซ HAL ซึ่งกำหนดเป็นส่วนหัว C ใน hardware/libhardware HIDL แทนที่อินเทอร์เฟซ HAL เหล่านี้ด้วยอินเทอร์เฟซเวอร์ชันที่เสถียรซึ่งอาจเป็นอินเทอร์เฟซ HIDL ฝั่งไคลเอ็นต์และเซิร์ฟเวอร์ใน C ++ (อธิบายด้านล่าง) หรือ Java
หน้าในส่วนนี้อธิบายการใช้งาน C ++ ของอินเตอร์เฟส HIDL รวมถึงรายละเอียดเกี่ยวกับไฟล์ที่สร้างขึ้นโดยอัตโนมัติจากไฟล์ .hal โดยคอมไพเลอร์ hidl-gen วิธีการรวมไฟล์เหล่านี้และวิธีการรวมไฟล์เหล่านี้กับโค้ด C ++ ใช้พวกเขา
การใช้งานไคลเอนต์และเซิร์ฟเวอร์
อินเทอร์เฟซ HIDL มีการใช้งานไคลเอนต์และเซิร์ฟเวอร์:
- ไคลเอ็นต์ ของอินเทอร์เฟซ HIDL คือรหัสที่ใช้อินเทอร์เฟซโดยการเรียกใช้เมธอดบนอินเทอร์เฟซ
- เซิร์ฟเวอร์ คือการนำอินเทอร์เฟซ HIDL ที่รับสายจากไคลเอนต์และส่งกลับผลลัพธ์ (ถ้าจำเป็น)
ในการเปลี่ยนจาก libhardware HALs เป็น HIDL HALs การใช้งาน HAL จะกลายเป็นเซิร์ฟเวอร์และกระบวนการที่เรียกเข้าสู่ HAL จะกลายเป็นไคลเอนต์ การใช้งานตามค่าเริ่มต้นสามารถให้บริการได้ทั้ง HAL แบบพาสทรูและแบบผูกมัดและสามารถเปลี่ยนแปลงได้ตลอดเวลา:
รูปที่ 1. ความก้าวหน้าของการพัฒนาสำหรับ HAL ดั้งเดิม
การสร้างไคลเอ็นต์ HAL
เริ่มต้นด้วยการรวมไลบรารี HAL ไว้ใน makefile:
- ยี่ห้อ:
LOCAL_SHARED_LIBRARIES += android.hardware.nfc@1.0 - Soong:
shared_libs: [ …, android.hardware.nfc@1.0 ]
จากนั้นรวมไฟล์ส่วนหัว HAL:
#include <android/hardware/nfc/1.0/IFoo.h> … // in code: sp<IFoo> client = IFoo::getService(); client->doThing();
การสร้างเซิร์ฟเวอร์ HAL
ในการสร้างการนำไปใช้งาน HAL คุณต้องมีไฟล์. .hal ที่แสดงถึง HAL ของคุณและได้สร้าง makefiles สำหรับ HAL ของคุณแล้วโดยใช้ -Lmakefile หรือ -Landroidbp บน hidl-gen ( ./hardware/interfaces/update-makefiles.sh ทำเพื่อ ไฟล์ HAL ภายในและเป็นข้อมูลอ้างอิงที่ดี) เมื่อถ่ายโอนผ่าน HAL จาก libhardware คุณสามารถทำงานหลายอย่างได้อย่างง่ายดายโดยใช้ c2hal
ในการสร้างไฟล์ที่จำเป็นเพื่อใช้งาน HAL ของคุณ:
PACKAGE=android.hardware.nfc@1.0
LOC=hardware/interfaces/nfc/1.0/default/
m -j hidl-gen
hidl-gen -o $LOC -Lc++-impl -randroid.hardware:hardware/interfaces \
-randroid.hidl:system/libhidl/transport $PACKAGE
hidl-gen -o $LOC -Landroidbp-impl -randroid.hardware:hardware/interfaces \
-randroid.hidl:system/libhidl/transport $PACKAGE
เพื่อให้ HAL ทำงานในโหมด passthrough คุณต้องมีฟังก์ชัน HIDL_FETCH_IModuleName อยู่ใน /(system|vendor|...)/lib(64)?/hw/android.hardware.package@3.0-impl( OPTIONAL_IDENTIFIER ).so โดยที่ OPTIONAL_IDENTIFIER คือสตริงที่ระบุการใช้งานแบบพาส ข้อกำหนดของโหมด passthrough จะเป็นไปตามคำสั่งข้างต้นโดยอัตโนมัติซึ่งจะสร้างเป้าหมาย android.hardware.nfc@1.0-impl ด้วย แต่สามารถใช้ส่วนขยายใดก็ได้ ตัวอย่างเช่น android.hardware.nfc@1.0-impl-foo ใช้ -foo เพื่อแยกความแตกต่าง
หาก HAL เป็นเวอร์ชันรองหรือส่วนขยายของ HAL อื่นควรใช้ HAL พื้นฐานเพื่อตั้งชื่อไบนารีนี้ ตัวอย่างเช่นการใช้งาน android.hardware.graphics.mapper@2.1 ควรอยู่ในไบนารีที่เรียกว่า android.hardware.graphics.mapper@2.0-impl( OPTIONAL_IDENTIFIER ) โดยปกติ OPTIONAL_IDENTIFIER ที่นี่จะรวมเวอร์ชัน HAL จริง ด้วยการตั้งชื่อไบนารีเช่นนี้ไคลเอนต์ 2.0 สามารถดึงข้อมูลได้โดยตรงและไคลเอนต์ 2.1 สามารถอัปเดตการใช้งานได้
จากนั้นกรอกข้อมูลในส่วนของฟังก์ชันและตั้งค่า daemon ตัวอย่างโค้ด daemon (รองรับ passthrough):
#include <hidl/LegacySupport.h>
int main(int /* argc */, char* /* argv */ []) {
return defaultPassthroughServiceImplementation<INfc>("nfc");
}
defaultPassthroughServiceImplementation จะ dlopen() ไลบรารี -impl ให้มาและจัดให้เป็นบริการแบบ binderized ตัวอย่างโค้ด daemon (สำหรับเซอร์วิส binderized):
int main(int /* argc */, char* /* argv */ []) {
// This function must be called before you join to ensure the proper
// number of threads are created. The threadpool will never exceed
// size one because of this call.
::android::hardware::configureRpcThreadpool(1 /*threads*/, true /*willJoin*/);
sp<INfc> nfc = new Nfc();
const status_t status = nfc->registerAsService();
if (status != ::android::OK) {
return 1; // or handle error
}
// Adds this thread to the threadpool, resulting in one total
// thread in the threadpool. We could also do other things, but
// would have to specify 'false' to willJoin in configureRpcThreadpool.
::android::hardware::joinRpcThreadpool();
return 1; // joinRpcThreadpool should never return
}
ภูตตัวนี้มักจะอยู่ใน $PACKAGE + "-service-suffix" (เช่น android.hardware.nfc@1.0-service ) แต่อาจอยู่ที่ใดก็ได้ sepolicy สำหรับคลาสเฉพาะของ HAL คือแอตทริบิวต์ hal_<module> (เช่น hal_nfc) ต้องใช้แอ็ตทริบิวต์นี้กับ daemon ที่รัน HAL เฉพาะ (หากกระบวนการเดียวกันให้บริการ HAL หลายตัวสามารถใช้แอ็ตทริบิวต์หลายตัวได้)