Cache#
Cache 模块提供 DCache(Data Cache)维护接口,作为 OSAL(OS Abstract Layer)的组成部分,支持按内存区域执行 DCache 回写、失效与清理操作,覆盖 linux、liteos、seliteos 系统。
模块公共头文件
#include "kernel/osal/include/memory/osal_cache.h"
接口清单#
接口名称 |
功能简述 |
|---|---|
对指定内存区域执行 DCache 回写操作 |
|
对指定内存区域执行 DCache 失效操作 |
|
对指定内存区域执行 DCache 清理操作 |
Functions#
osal_dcache_region_wb #
void osal_dcache_region_wb(void *kvirt, unsigned long phys_addr, unsigned long size)
声明头文件
#include "kernel/osal/include/memory/osal_cache.h"
功能说明
将指定内存区域的 DCache 数据写回主存(write-back)。
起始地址若未按 CACHE_LINE_SIZE(32Bytes)对齐,将自动向下对齐到 CACHE_LINE_SIZE 边界。
当 MMU(Memory Management Unit)不存在时,需确保 phys_addr 有效,此时用户通过 kvirt 参数设置地址。
前置条件
无 MMU 场景下,phys_addr 参数必须为有效的物理地址,或通过 kvirt 传入有效地址。
入参
名称 |
参数类型 |
说明 |
约束取值范围 |
|---|---|---|---|
kvirt |
void * |
内核虚拟地址指针 |
非 NULL 指针,指向有效内存区域 |
phys_addr |
unsigned long |
需要回写的起始物理地址 |
有效物理地址;当 MMU 不存在时需确保有效,若为 0 则使用 kvirt 的地址值 |
size |
unsigned long |
需要回写的内存大小(字节) |
大于 0 |
参考案例
src/middleware/utils/update/common/upg_verify.c
Kconfig配置
配置项 |
宏类型 |
说明 |
默认值 |
|---|---|---|---|
OSAL_API_SUPPORT_DCACHE |
特性宏 |
linux 实现体由 #ifdef 包裹,无前缀注入宏(接口级) |
由构建目标决定 |
LOSCFG_ARCH_ARM_CORTEX_A |
特性宏 |
liteos 实现内部分支宏(分支级) |
由构建目标决定 |
osal_dcache_region_inv #
void osal_dcache_region_inv(void *addr, unsigned long size)
声明头文件
#include "kernel/osal/include/memory/osal_cache.h"
功能说明
使指定内存区域的 DCache 缓存行失效(invalidate)。
起始地址若未按 CACHE_LINE_SIZE(32Bytes)对齐,将自动向下对齐到 CACHE_LINE_SIZE 边界。
用于 DMA 读取前使 CPU 缓存失效,确保后续读取来自主存而非缓存。
前置条件
addr 指向的内存区域必须有效且可访问。
入参
名称 |
参数类型 |
说明 |
约束取值范围 |
|---|---|---|---|
addr |
void * |
需要无效的起始地址 |
非 NULL 指针,指向有效内存区域 |
size |
unsigned long |
需要无效的内存大小(字节) |
大于 0 |
Kconfig配置
配置项 |
宏类型 |
说明 |
默认值 |
|---|---|---|---|
OSAL_API_SUPPORT_DCACHE |
特性宏 |
linux 实现体由 #ifdef 包裹,无前缀注入宏(接口级) |
由构建目标决定 |
LOSCFG_ARCH_ARM_CORTEX_A |
特性宏 |
liteos 实现内部分支宏(分支级) |
由构建目标决定 |
osal_dcache_region_clean #
void osal_dcache_region_clean(void *addr, unsigned int size)
声明头文件
#include "kernel/osal/include/memory/osal_cache.h"
功能说明
将指定内存区域的 DCache 数据写回主存(clean)。
根据起始地址和大小清除 DCache,将脏缓存行写回主存。
用于 DMA 写入前确保 CPU 已写入的数据已同步到主存。
前置条件
addr 指向的内存区域必须有效且可访问。
入参
名称 |
参数类型 |
说明 |
约束取值范围 |
|---|---|---|---|
addr |
void * |
需要清除的起始地址 |
非 NULL 指针,指向有效内存区域 |
size |
unsigned int |
需要清除的内存大小(字节) |
大于 0 |
Kconfig配置
配置项 |
宏类型 |
说明 |
默认值 |
|---|---|---|---|
LOSCFG_ARCH_ARM_CORTEX_A |
特性宏 |
liteos 实现内部分支宏(分支级) |
由构建目标决定 |