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 分 分配速度。
建築
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 }));
使用取得的
hidl_memory
建立HidlMemoryDealer
例項:#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
設為零
聲明 HAL
宣告 HAL 時,請說明包含 MemoryBlock
的 HIDL 結構
執行個體和 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
繫結。
您可以使用兩種方法附加及擷取中繼資料:
如果應用程式經常像區塊本身存取中繼資料 附加中繼資料,然後把它們全都透過結構體傳遞。例子:
import android.hidl.memory.block@1.0::MemoryBlock; struct MemoryBlockWithMetaData{ MemoryBlock block; MetaDataStruct metaData; };
如果應用程式存取中繼資料的頻率遠低於 如果將中繼資料設為被動方式 存取 API例子:
import android.hidl.memory.block@1.0::MemoryBlock; struct MemoryBlockWithMetaData{ MemoryBlock block; IMetaData metaData; };
接下來,使用
MemoryDealer
將中繼資料與MemoryBlock
繫結。 例子:MemoryBlockWithMetaData memory_block; memory_block.block = dealer->allocate(size); if(HidlMemoryDealer::isOk(block)){ memory_block.metaData = new MetaData(...);