156 lines
10 KiB
ReStructuredText
Executable File
156 lines
10 KiB
ReStructuredText
Executable File
PSRAM内存配置
|
||
=======================
|
||
|
||
:link_to_translation:`en:[English]`
|
||
|
||
1、PSRAM概述
|
||
-------------------------
|
||
|
||
PSRAM提供足够的内存空间，供不同的模块使用，当前BK7258支持两种类型的PSRAM，它们的内存大小不同，分别为8Mbyte和16Mbyte，使用不同的宏进行区分。
|
||
多媒体中定义了四种类型的模块需要使用PSRAM，由于PSRAM还会用来在不同的CPU上作为heap使用，所以并不是全部的PSRAM空间都被多媒体使用，长度和空间都是需要进行区分的。
|
||
|
||
2、PSRAM的类型
|
||
----------------------------
|
||
|
||
BK7258支持两种类型的PSRAM，具体配置如下：
|
||
|
||
+--------------------+---------------+
|
||
| name | size(Mbyte) |
|
||
+--------------------+---------------+
|
||
| APS6408L_O | 8 |
|
||
+--------------------+---------------+
|
||
| APS128XXO_OB9 | 16 |
|
||
+--------------------+---------------+
|
||
|
||
注意：不同的工程默认使用的psram类型不一样，需要看编译后的sdkconfig文件。
|
||
|
||
3、PSRAM的划分
|
||
--------------------------
|
||
|
||
PSRAM主要分为两部分，一部分是多媒体当作数据内存进行使用，另一部分当作不同CPU的heap空间进行使用，需要参考下面的宏定义去识别各自使用的大小：
|
||
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| marco | value | implication |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM | Y | 使能PSRAM模块 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_AS_SYS_MEMORY | Y | 使能PSRAM作为Heap |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_USE_PSRAM_HEAP_AT_SRAM_OOM | Y | 使能sram申请不到内存，从psram申请 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_HEAP_BASE | 0x60700000 | 当前CPU上psram作为heap的起始地址 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_HEAP_SIZE | 0x80000 | 当前CPU上psram作为heap的长度 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER | 0x60700000 | 当前芯片上psram作为heap的起始地址 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
|
||
- 功能开关CONFIG_PSRAM_AS_SYS_MEMORY依赖CONFIG_PSRAM和CONFIG_FREERTOS_V10
|
||
|
||
.. note::
|
||
|
||
注意：上面的值在不同的核上定义的值是有区别的，CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER表示PSRAM作为heap的起始地址，表示psram从这个地址开始作为heap空间。
|
||
系统默认从PSRAM的起始地址(0x60000000)，到CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER为止都是分配给多媒体使用，剩余的部分给Heap使用。用宏CONFIG_PSRAM_HEAP_BASE
|
||
定义当前核上PSRAM作为Heap的起始地址，用CONFIG_PSRAM_HEAP_SIZE定义空间大小，不同的核上定义的值不一样，CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER在不同的核上值是一样的。
|
||
应该与不同核上CONFIG_PSRAM_HEAP_BASE的最小值保持一致，比如默认BK7258的工程，CPU0上CONFIG_PSRAM_HEAP_BASE=0x60700000，CONFIG_PSRAM_HEAP_SIZE=0x80000，那么CPU1上
|
||
CONFIG_PSRAM_HEAP_BASE=0x60780000，CONFIG_PSRAM_HEAP_SIZE=0x80000，CPU2上默认PSRAM不作为Heap使用，所以CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER=0x60700000。
|
||
某个核上是否需要将psram作为heap，是由CONFIG_PSRAM_AS_SYS_MEMORY控制。
|
||
|
||
4、PSRAM作为heap使用
|
||
-----------------------
|
||
|
||
- 通过如下两个配置项配置psram heap的起始地址和大小::
|
||
|
||
CONFIG_PSRAM_HEAP_BASE //配置psram heap的起始地址
|
||
CONFIG_PSRAM_HEAP_SIZE //配置psram size的起始地址
|
||
|
||
- 内存申请和释放接口::
|
||
|
||
void *psram_malloc(size_t size);
|
||
void psram_free(void *p);
|
||
|
||
- BK7258芯片低压功能PSRAM会下电， 如果上层有使用的psram内存没有释放, 会导致无法进入低压, 可以通过如下接口打印当前psram内存使用情况::
|
||
|
||
void bk_psram_heap_get_used_state(void);
|
||
|
||
- 将Task创建在psram上接口::
|
||
|
||
bk_err_t rtos_create_psram_thread(beken_thread_t *thread, uint8_t priority, const char *name, beken_thread_function_t function, uint32_t stack_size, beken_thread_arg_t arg);
|
||
bk_err_t rtos_delete_thread(beken_thread_t *thread); // 删除task接口不变
|
||
|
||
5、PSRAM在多媒体上的划分
|
||
----------------------------
|
||
|
||
PSRAM在多媒体上使用，根据功能被划分为四个模块，参考结构体：``psram_heap_type_t``，位置：``bk_idk/include/driver/psram_types.h``.
|
||
|
||
各个模块使用的内存是由结构体：``psram_mem_slab_mapping``，定义的，参考路径：``bk_avdk_main/components/media_utils/Kconfig``。各个模块分配的内存大小由宏进行控制，如下所示：
|
||
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| marco | value(byte) | implication |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_MEM_SLAB_USER_SIZE | 102400 | 分配给user使用的大小 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_MEM_SLAB_AUDIO_SIZE | 102400 | 分配给audio使用的大小 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_MEM_SLAB_ENCODE_SIZE | 1433600 | 分配给编码(jpeg/h264)使用的大小 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
| CONFIG_PSRAM_MEM_SLAB_DISPLAY_SIZE | 5701632 | 分配给显示使用的大小 |
|
||
+-------------------------------------+---------------+-------------------------------------+
|
||
|
||
.. note::
|
||
|
||
注意：上面宏定义的值是默认定义的，使用时可以根据自身需求，动态调整，直接在对应project中cpu的config进行修改即可，但是注意上面的长度加起来,
|
||
不能超过Heap使用的地址(CONFIG_PSRAM_HEAP_CPU0_BASE_ADDER)，否则会出问题。
|
||
|
||
5、多媒体各个模块内存调整
|
||
-----------------------------
|
||
|
||
根据上节所述，psram被划分为四个模块，不同的模块存储的数据类型不同，具体如下：
|
||
|
||
- UASER：分配给用户使用，分配的大小为宏CONFIG_PSRAM_MEM_SLAB_USER_SIZE定义；
|
||
- AUDIO：分配给audio使用，分配的大小为宏CONFIG_PSRAM_MEM_SLAB_AUDIO_SIZE定义；存储的是音频数据；
|
||
- ENCODE：分配给编码使用，分配的大小为宏CONFIG_PSRAM_MEM_SLAB_ENCODE_SIZE定义，存储的是完整的JPEG图像或者H264图像；
|
||
- DISPLAY：分配给显示使用，分配的大小为宏CONFIG_PSRAM_MEM_SLAB_DISPLAY_SIZE定义，存储的是显示的数据类型，如YUV、RGB565、RGB888等；
|
||
|
||
根据上面不同的模块功能，以及大小，存储的数据量也不一样，比如ENCODE模块可以存储不止一帧的JPEG图像或H264图像，
|
||
系统还定义了一帧图像的大小的宏，参考文件：``./bk_idk/middleware/driver/camera/Kconfig``:
|
||
|
||
+----------------------------+---------------+-------------------------------------+------------------+
|
||
| marco | value(byte) | implication | range |
|
||
+----------------------------+---------------+-------------------------------------+------------------+
|
||
| CONFIG_JPEG_FRAME_SIZE | 153600 | 定义一帧JPEG图像的大小 | [0, 204800] |
|
||
+----------------------------+---------------+-------------------------------------+------------------+
|
||
| CONFIG_H264_FRAME_SIZE | 65536 | 定义一帧H264图像的大小 | [0, 204800] |
|
||
+----------------------------+---------------+-------------------------------------+------------------+
|
||
|
||
上面的大小需要根据自身需求需要调整，比如需要存储1280X720的JPEG图像，150K的空间可能不够，需要改成200K(204800)，甚至更大，根据实际使用情况调整。
|
||
同样针对H264数据，有时候需要调整H264的压缩率，以达到更清楚的画质，默认的64K可能不够，需要继续调大，所以也需要根据实际情况做调整。
|
||
|
||
根据上面的定义的大小，不同块存储的个数可以计算出来，假设DISPLAY模块使用的RGB565，且分辨率为：800X480，那么一帧图像的大小为：800*480*2=768000，
|
||
可存储的个数为：CONFIG_PSRAM_MEM_SLAB_DISPLAY_SIZE/768000=7，表示最大存7帧800X480的RGB565图像；
|
||
|
||
假设ENCODE模块都用来存储JPEG图像，最多存储数量：CONFIG_PSRAM_MEM_SLAB_ENCODE_SIZE/CONFIG_JPEG_FRAME_SIZE=9；但实际情况会同时存储JPEG和H264数据，代码中定义了
|
||
各个图像模块最大的存储个数，参考：``bk_avdk_main/components/multimedia/comm/frame_buffer.c``，如下语句定义：
|
||
|
||
``uint8_t fb_count[FB_INDEX_MAX] = {5, 4, H264_GOP_FRAME_CNT * 2};``，表示最大保存5帧DISPLAY数据，4帧JPEG数据，H264_GOP_FRAME_CNT*2帧H264数据。
|
||
|
||
上面的数量可以调整，只要保证总的数据量不超过各自模块的size即可。
|
||
|
||
6、多媒体上PSRAM使用
|
||
----------------------
|
||
|
||
因为多媒体的功能都在CPU1上使用，所以针对PSRAM的使用，只能在CPU1上直接调用，系统CPU1启动后会自动给多媒体整个PSRAM进行初始化，用户不需要去自己调用实现。
|
||
当CPU1掉电时，多媒体不再使用PSRAM，不需要额外调用注销的接口去释放相应的内存。
|
||
|
||
- 内存初始化接口::
|
||
|
||
bk_psram_frame_buffer_init
|
||
|
||
- 内存申请和释放接口::
|
||
|
||
void *bk_psram_frame_buffer_malloc(psram_heap_type_t type, uint32_t size);
|
||
void bk_psram_frame_buffer_free(void* mem_ptr);
|
||
|
||
.. note::
|
||
|
||
客户使用时，建议使用系统的接口去申请和释放psram内存(psram_malloc\psram_free)，不建议使用上面多媒体模块自定义的申请和释放psram内存接口 |