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"
接口清单#
接口名称 |
功能简述 |
|---|---|
格式化日志打印,支持可变参数 |
|
触发内核 panic 并打印栈信息 |
|
打印当前任务调用栈回溯信息 |
|
刷新 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.csrc/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 系统下可用。