Debug

Debug 模块提供 OSAL（OS Abstract Layer）内核调试与诊断功能，包括格式化日志打印、内核 panic 触发、调用栈回溯打印与 CPU（Central Processing Unit） D-Cache（Data Cache）刷新能力，用于系统运行时调试与异常诊断。该模块面向 linux、liteos、seliteos、freertos、nonos 等多种操作系统环境提供统一的调试接口抽象。

模块公共头文件

#include "debug/osal_debug.h"

接口清单

接口名称	功能简述
osal_printk	格式化日志打印，支持可变参数
osal_panic	触发内核 panic 并打印栈信息
osal_dump_stack	打印当前任务调用栈回溯信息
osal_flush_cache	刷新 CPU D-Cache

Functions

osal_printk

void osal_printk(const char *fmt, ...)

声明头文件

#include "debug/osal_debug.h"

功能说明

提供内核日志打印功能，支持可变参数格式化输出。
支持 linux、liteos、seliteos、freertos 系统。
当 fmt 为 NULL 时，函数直接返回，不执行打印操作。

入参

名称	参数类型	说明	约束取值范围
fmt	const char *	格式化字符串指针	非 NULL，指向有效的格式化字符串
...	...	可变参数列表	与 fmt 中的格式说明符匹配

参考案例

src/application/samples/bt/ble/ble_speed_server/src/ble_speed_server.c
src/application/samples/peripheral/uart/uart_demo.c

osal_panic

void osal_panic(const char *fmt, const char *fun, int line, const char *cond)

声明头文件

#include "debug/osal_debug.h"

功能说明

内核 panic 函数，打印内核 panic 信息及调用栈后系统停止响应。
支持 linux、liteos 系统。
调用后系统将无法继续运行，属于致命错误处理接口。

前置条件

仅在 linux、liteos 系统下可用。
仅在发生不可恢复的致命错误时调用。

入参

名称	参数类型	说明	约束取值范围
fmt	const char *	格式化字符串指针	非 NULL
fun	const char *	发生 panic 的函数名	非 NULL
line	int	发生 panic 的行号	有效源码行号
cond	const char *	触发 panic 的条件表达式	非 NULL

osal_dump_stack

void osal_dump_stack(void)

声明头文件

#include "debug/osal_debug.h"

功能说明

内核回溯函数，打印当前运行任务的调用栈信息。
支持 linux、liteos 系统。
用于调试定位问题时的调用链追踪。

前置条件

仅在 linux、liteos 系统下可用。

Kconfig配置

配置项	宏类型	说明	默认值
OSAL_DEBUG_DUMP	特性宏	linux 实现中控制 dump_stack 调用分支（分支级，无前缀注入宏）	由构建目标决定

osal_flush_cache

void osal_flush_cache(void)

声明头文件

#include "debug/osal_debug.h"

功能说明

刷新 CPU DCache，将数据缓存写回内存。
支持 liteos 系统。
在 DMA（Direct Memory Access）传输等需要 Cache 一致性操作的场景下调用。

前置条件

仅在 liteos 系统下可用。