跳到主要内容

hbmem sample 使用说明

功能概述​

hbmem api 使用说明，包括 com buffer、graphic buffer、graphic buffer group、queue、pool、share pool 的创建使用，多进程共享等。

软件架构说明​

本 sample 基于 libhbmem API 实现，调用 libhbmem 提供的 API，实现不同 buffer 类型的内存申请和进程间共享。

HBMEM 示例框图

代码位置及目录结构​

1. 代码位置：/app/communication_demo/hbmem_demo/sample_hbmem
2. 目录结构：
    ./
    ├── Makefile
    ├── sample_alloc.c
    ├── sample.c
    ├── sample_common.c
    ├── sample_common.h
    ├── sample_pool.c
    ├── sample_queue.c
    ├── sample_share.c
    └── sample_share_pool.c

API 流程说明​

libhbmem 库调用 ion 进行 buffer 分配

HBMEM 示例调用序列

com buffer、graph buffer、graphic buffer group 分配流程图

HBMEM 分配缓冲区

queue 使用流程图

HBMEM 队列

pool 使用流程图

HBMEM 内存池

share pool 使用流程图

HBMEM 共享内存池

编译​

编译环境​

本 sample 支持在板端直接编译。

编译说明​

本 sample 主要依赖 libhbmem 提供的头文件：

#include <hb_mem_mgr.h>
#include <hb_mem_err.h>

编译依赖的库有如下：

LIBS += -lhbmem -lpthread -lalog -ldl -lstdc++

编译命令​

# 进入sample所在目录：
cd /app/communication_demo/hbmem_demo/sample_hbmem
# 编译本sample:
make
# 输出文件:
/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample

运行​

支持平台​

  • RDK S100/RDK S100P

运行指南​

运行方法​

创建 com buffer

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 1

创建 cache，noncached com buffer，赋值，比较耗时

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 2

在各个 heaps 里，创建 com buffer

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 3

创建 graph buffer

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 4

在各个 heaps 里，创建 graph buffer

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 5

创建 graph buffer group

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 6

在各个 heaps 里，创建 graph buffer group

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 7

进程内 common buffer 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 8

进程内 common buffer 共享，consume_cnt

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 9

进程间 common buffer 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 10

进程内 graphic buffer 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 11

进程内 graphic buffer 共享，consume_cnt

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 12

进程间 graphic buffer 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 13

进程内 graphic buffer group 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 14

进程内 graphic buffer group 共享，consume_cnt

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 15

进程间 graphic buffer group 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 16

进程间 share pool 共享

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 17

share pool 使用

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 18

buffer queue 使用

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 19

pool 使用

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 20

在 graphic buffer 与 common buffer 之间实现 buffer 转换

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 21

增加 common buffer 用户态引用计数

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 22

增加 graphic buffer 用户态引用计数

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 23

运行参数说明​

  • -m 指定 sample 用例，具体见运行结果展示

测试结果说明​

  • 如果 log 最后以xxxx done结尾，则表示 sample 执行成功

运行结果展示​

创建 com buffer​

/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample -m 1
sample_mode = 1
=================================================
Ready to sample_alloc_com_buf
alloc com buf, share_id: 16
[1752:1752] Do system command cat /sys/kernel/debug/ion/clients/1752*.
        heap_name:    size_in_bytes :  handle refcount :    handle import :       buffer ptr :  buffer refcount :  buffer share id : buffer share count
        ion_cma:           400000 :                1 :                1 :         fd48e1ab :                3:               16 :                1
[1752:1752] Do system command cat /sys/kernel/debug/ion/heaps/ion_cma | grep -w 1752 | grep -w libhbmem_sample.
        libhbmem_sample             1752          4194304
        libhbmem_sample             1752            other          4194304 0
[1752:1752] Result 0.
free com buf
[1752:1752] Do system command cat /sys/kernel/debug/ion/clients/1752*.
        heap_name:    size_in_bytes :  handle refcount :    handle import :       buffer ptr :  buffer refcount :  buffer share id : buffer share count
[1752:1752] Do system command cat /sys/kernel/debug/ion/heaps/ion_cma | grep -w 1752 | grep -w libhbmem_sample.
[1752:1752] Result 256.
sample_alloc_com_buf done
=================================================

（其他运行结果展示部分保持原有文本结构，仅作格式转换和关键词替换，此处略去重复内容）

最后于 更新