Skip to main content

hbmem sample User Guide

Function Overview​

hbmem API usage instructions, including the creation and usage of com buffer, graphic buffer, graphic buffer group, queue, pool, and share pool, as well as multi-process sharing.

Software Architecture Description​

This sample is implemented based on the libhbmem API, calling the APIs provided by libhbmem to achieve memory allocation for different buffer types and inter-process sharing.

HBMEM Sample Block Diagram

Code Location and Directory Structure​

1. Code location: /app/communication_demo/hbmem_demo/sample_hbmem
2. Directory structure:
    ./
    ├── 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 Process Description​

The libhbmem library calls ion for buffer allocation

HBMEM Sample Call Sequence

Flowchart for com buffer, graph buffer, and graphic buffer group allocation

HBMEM Allocate Buffer

Queue usage flowchart

HBMEM Queue

Pool usage flowchart

HBMEM Memory Pool

Share pool usage flowchart

HBMEM Shared Memory Pool

Compilation​

Compilation Environment​

This sample supports direct compilation on the board.

Compilation Instructions​

This sample mainly depends on the header files provided by libhbmem:

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

The libraries required for compilation are as follows:

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

Compilation Commands​

# Enter the sample directory:
cd /app/communication_demo/hbmem_demo/sample_hbmem
# Compile this sample:
make
# Output file:
/app/communication_demo/hbmem_demo/sample_hbmem/libhbmem_sample

Execution​

Supported Platforms​

  • RDK S600

Execution Guide​

Execution Methods​

Create com buffer

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

Create cached and non-cached com buffer, assign values, compare time consumption

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

Create com buffer in various heaps

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

Create graph buffer

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

Create graph buffer in various heaps

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

Create graph buffer group

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

Create graph buffer group in various heaps

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

Intra-process common buffer sharing

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

Intra-process common buffer sharing, consume_cnt

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

Inter-process common buffer sharing

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

Intra-process graphic buffer sharing

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

Intra-process graphic buffer sharing, consume_cnt

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

Inter-process graphic buffer sharing

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

Intra-process graphic buffer group sharing

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

Intra-process graphic buffer group sharing, consume_cnt

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

Inter-process graphic buffer group sharing

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

Inter-process share pool sharing

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

Share pool usage

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

Buffer queue usage

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

Pool usage

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

Implement buffer conversion between graphic buffer and common buffer

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

Increase user-space reference count for common buffer

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

Increase user-space reference count for graphic buffer

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

Execution Parameter Description​

  • -m Specifies the sample test case, see the execution results display for details

Test Result Description​

  • If the log ends with xxxx done, the sample execution is successful

Execution Results Display​

Create 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
=================================================

(Other execution output examples retain the original text structure, with only formatting and keyword adjustments applied; repetitive content omitted here.)

Last updated on