HIDL MemoryBlock
เป็นเลเยอร์นามธรรมที่สร้างขึ้นเมื่อ hidl_memory
, HIDL
@1.0::IAllocator
และ HIDL @1.0::IMapper
ออกแบบมาสำหรับบริการ HIDL
ที่มีบล็อกหน่วยความจำหลายบล็อกเพื่อแชร์ฮีปหน่วยความจำเดียว
ปรับปรุงประสิทธิภาพ
การใช้ MemoryBlock
ในแอปอาจลดจำนวน
ข้อผิดพลาด mmap
/munmap
และการแบ่งกลุ่มพื้นที่ผู้ใช้ จึงช่วยปรับปรุงประสิทธิภาพ
เช่น
- การใช้ต่อ
hidl_memory
สําหรับการจัดสรรบัฟเฟอร์แต่ละรายการโดยเฉลี่ย 238 us/1 การจัดสรร - การใช้
MemoryBlock
และการแชร์hidl_memory
รายการเดียวมีค่าเฉลี่ย 2.82 us/1 การจัดสรร
สถาปัตยกรรม
สถาปัตยกรรม HIDL MemoryBlock
ประกอบด้วยบริการ HIDL ที่มีหน่วยความจำหลายหน่วย
บล็อกการแชร์ฮีปหน่วยความจำเดียว:
รูปที่ 1 สถาปัตยกรรม HIDL MemoryBlock
การใช้งานปกติ
ส่วนนี้จะแสดงตัวอย่างการใช้ MemoryBlock
โดยการประกาศฟิลด์
HAL จากนั้นจึงนำ HAL มาปรับใช้
ประกาศ HAL
สำหรับตัวอย่าง IFoo HAL ต่อไปนี้
import android.hidl.memory.block@1.0::MemoryBlock;
interface IFoo {
getSome() generates(MemoryBlock block);
giveBack(MemoryBlock block);
};
Android.bp
มีดังนี้
hidl_interface {
...
srcs: [
"IFoo.hal",
],
interfaces: [
"android.hidl.memory.block@1.0",
...
};
ติดตั้งใช้งาน HAL
วิธีการใช้ HAL ตัวอย่าง
ดาวน์โหลด
hidl_memory
(โปรดดูรายละเอียดได้ที่ HIDL C++)#include <android/hidl/allocator/1.0/IAllocator.h> using ::android::hidl::allocator::V1_0::IAllocator; using ::android::hardware::hidl_memory; ... sp<IAllocator> allocator = IAllocator::getService("ashmem"); allocator->allocate(2048, [&](bool success, const hidl_memory& mem) { if (!success) { /* error */ } // you can now use the hidl_memory object 'mem' or pass it }));
สร้างอินสแตนซ์
HidlMemoryDealer
ด้วยhidl_memory
ที่ได้มา:#include <hidlmemory/HidlMemoryDealer.h> using ::android::hardware::HidlMemoryDealer /* The mem argument is acquired in the Step1, returned by the ashmemAllocator->allocate */ sp<HidlMemoryDealer> memory_dealer = HidlMemoryDealer::getInstance(mem);
จัดสรร
MemoryBlock
ซึ่งเป็นโครงสร้างที่กำหนดโดย HIDLตัวอย่าง
MemoryBlock
:struct MemoryBlock { IMemoryToken token; uint64_t size; uint64_t offset; };
ตัวอย่างการใช้
MemoryDealer
เพื่อจัดสรรMemoryBlock
#include <android/hidl/memory/block/1.0/types.h> using ::android::hidl::memory::block::V1_0::MemoryBlock; Return<void> Foo::getSome(getSome_cb _hidl_cb) { MemoryBlock block = memory_dealer->allocate(1024); if(HidlMemoryDealer::isOk(block)){ _hidl_cb(block); ...
ดีล
MemoryBlock
:Return<void> Foo::giveBack(const MemoryBlock& block) { memory_dealer->deallocate(block.offset); ...
จัดการข้อมูล
#include <hidlmemory/mapping.h> #include <android/hidl/memory/1.0/IMemory.h> using ::android::hidl::memory::V1_0::IMemory; sp<IMemory> memory = mapMemory(block); uint8_t* data = static_cast<uint8_t*>(static_cast<void*>(memory->getPointer()));
กำหนดค่า
Android.bp
:shared_libs: [ "android.hidl.memory@1.0", "android.hidl.memory.block@1.0" "android.hidl.memory.token@1.0", "libhidlbase", "libhidlmemory",
ตรวจสอบขั้นตอนเพื่อตัดสินใจว่าจำเป็นต้อง
lockMemory
หรือไม่โดยปกติ
MemoryBlock
จะใช้จำนวนข้อมูลอ้างอิงเพื่อรักษายอดดูที่แชร์hidl_memory
ซึ่งmmap()
ใช้งานเป็นครั้งแรกในMemoryBlock instances is mapped and is
munmap()-ed when nothing refers to it. To keep
hidl_memoryalways mapped, you can use
lockMemory, a RAII style object that keeps the corresponding
hidl_memory` ที่แมปตลอดทั้งล็อก ใหม่ ตัวอย่าง#include <hidlmemory/mapping.h> sp<RefBase> lockMemory(const sp<IMemoryToken> key);
การใช้งานเพิ่มเติม
ส่วนนี้จะแสดงรายละเอียดเกี่ยวกับการใช้งานเพิ่มเติมของ MemoryBlock
ใช้จำนวนข้อมูลอ้างอิงเพื่อจัดการ MemoryBlock
ในกรณีส่วนใหญ่ วิธีที่มีประสิทธิภาพมากที่สุดในการใช้ MemoryBlock
คือ
จัดสรร/จัดสรร อย่างไรก็ตาม ในแอปที่ซับซ้อนซึ่งใช้จำนวนข้อมูลอ้างอิง
สำหรับการเก็บขยะน่าจะดีกว่า หากต้องการเปิดการนับข้อมูลอ้างอิง
MemoryBlock
คุณสามารถเชื่อมโยง MemoryBlock
ด้วยออบเจ็กต์การเชื่อมโยงที่จะช่วยให้
นับจำนวนการอ้างอิงและจัดสรร MemoryBlock
เมื่อจำนวนลดลง
เป็น 0
ประกาศ HAL
เมื่อประกาศ HAL ให้อธิบายโครงสร้าง HIDL ที่มี MemoryBlock
อินสแตนซ์และ IBase:
import android.hidl.memory.block@1.0::MemoryBlock;
struct MemoryBlockAllocation {
MemoryBlock block;
IBase refcnt;
};
ใช้ MemoryBlockAllocation
เพื่อแทนที่ MemoryBlock
และนำเมธอดออก
เพื่อตอบแทน MemoryBlock
ได้รับการจัดสรรโดยการนับการอ้างอิง
ด้วย MemoryBlockAllocation
ตัวอย่าง
interface IFoo {
allocateSome() generates(MemoryBlockAllocation allocation);
};
ติดตั้งใช้งาน HAL
ตัวอย่างการใช้งาน HAL ฝั่งบริการของ
class MemoryBlockRefCnt: public virtual IBase {
MemoryBlockRefCnt(uint64_t offset, sp<MemoryDealer> dealer)
: mOffset(offset), mDealer(dealer) {}
~MemoryBlockRefCnt() {
mDealer->deallocate(mOffset);
}
private:
uint64_t mOffset;
sp<MemoryDealer> mDealer;
};
Return<void> Foo::allocateSome(allocateSome_cb _hidl_cb) {
MemoryBlockAllocation allocation;
allocation.block = memory_dealer->allocate(1024);
if(HidlMemoryDealer::isOk(block)){
allocation.refcnt= new MemoryBlockRefCnt(...);
_hidl_cb(allocation);
ตัวอย่างการใช้งาน HAL ฝั่งไคลเอ็นต์
ifoo->allocateSome([&](const MemoryBlockAllocation& allocation){
...
);
แนบและเรียกข้อมูลเมตา
แอปบางแอปต้องการข้อมูลเพิ่มเติมเพื่อเชื่อมโยงกับ MemoryBlock
ที่จัดสรร
คุณเพิ่มและเรียกข้อมูลเมตาได้ 2 วิธี ดังนี้
หากแอปเข้าถึงข้อมูลเมตาบ่อยเท่ากับตัวบล็อก ต่อท้ายข้อมูลเมตาและส่งต่อทั้งหมดเป็นโครงสร้าง ตัวอย่าง
import android.hidl.memory.block@1.0::MemoryBlock; struct MemoryBlockWithMetaData{ MemoryBlock block; MetaDataStruct metaData; };
หากแอปเข้าถึงข้อมูลเมตาน้อยกว่า การส่งข้อมูลเมตาแบบแฝงด้วย ของ Google ตัวอย่าง
import android.hidl.memory.block@1.0::MemoryBlock; struct MemoryBlockWithMetaData{ MemoryBlock block; IMetaData metaData; };
จากนั้นเชื่อมโยงข้อมูลเมตากับ
MemoryBlock
โดยใช้MemoryDealer
ตัวอย่างMemoryBlockWithMetaData memory_block; memory_block.block = dealer->allocate(size); if(HidlMemoryDealer::isOk(block)){ memory_block.metaData = new MetaData(...);