los_printf.h 文件参考

浏览源代码.

类型定义
typedef VOID(*	pf_OUTPUT) (const CHAR *fmt,...)

枚举
enum	OutputType { NO_OUTPUT = 0 , UART_OUTPUT = 1 , CONSOLE_OUTPUT = 2 , EXC_OUTPUT = 3 }

函数
VOID	LOS_LkPrint (INT32 level, const CHAR *func, INT32 line, const CHAR *fmt,...)
	打印 更多...
void	dprintf (const char *fmt,...)
	Format and print data. 更多...
VOID	OsVprintf (const CHAR *fmt, va_list ap, OutputType type)
	printf由 print 和 format 两个单词构成,格式化输出函数, 一般用于向标准输出设备按规定格式输出信息 更多...
VOID	UartPuts (const CHAR *s, UINT32 len, BOOL isLock)

类型定义说明

pf_OUTPUT

typedef VOID(* pf_OUTPUT) (const CHAR *fmt,...)

在文件 los_printf.h 第 70 行定义.

枚举类型说明

OutputType

enum OutputType

枚举值
NO_OUTPUT
UART_OUTPUT
CONSOLE_OUTPUT
EXC_OUTPUT

在文件 los_printf.h 第 104 行定义.

             { //输出类型
    NO_OUTPUT = 0,      
    UART_OUTPUT = 1,    //串口输出
    CONSOLE_OUTPUT = 2, //控制台输出
    EXC_OUTPUT = 3      //出现异常时的输出
} OutputType;

函数说明

LOS_LkPrint()

VOID LOS_LkPrint	(	INT32	level,
		const CHAR *	func,
		INT32	line,
		const CHAR *	fmt,
			...
	)

打印

在文件 los_printf.c 第 276 行定义.

{
    va_list ap;
 
    if (level > PRINT_LEVEL) {
        return;
    }
 
    if ((level != LOS_COMMON_LEVEL) && ((level > LOS_EMG_LEVEL) && (level <= LOS_TRACE_LEVEL))) {
        PRINTK("[%s][%s:%s]", g_logString[level],
                ((OsCurrProcessGet() == NULL) ? "NULL" : OsCurrProcessGet()->processName),
                ((OsCurrTaskGet() == NULL) ? "NULL" : OsCurrTaskGet()->taskName));
    }
 
    va_start(ap, fmt);
    OsVprintf(fmt, ap, CONSOLE_OUTPUT);//控制台打印
#ifdef LOSCFG_SAVE_EXCINFO
    if (OsGetSystemStatus() == OS_SYSTEM_EXC_CURR_CPU) {
        WriteExcBufVa(fmt, ap);
    }
#endif
    va_end(ap);
}

OsVprintf()

VOID OsVprintf	(	const CHAR *	fmt,
		va_list	ap,
		OutputType	type
	)

printf由 print 和 format 两个单词构成,格式化输出函数, 一般用于向标准输出设备按规定格式输出信息

在文件 los_printf.c 第 138 行定义.

{
    INT32 len;
    const CHAR *errMsgMalloc = "OsVprintf, malloc failed!\n";//内存分配失败的错误日志,注意这是在打印函数里分配内存失败的情况
    const CHAR *errMsgLen = "OsVprintf, length overflow!\n";//所以要直接向串口发送字符串,不能再调用 printK(...)打印日志了.
    CHAR aBuf[SIZEBUF] = {0};
    CHAR *bBuf = NULL;
    UINT32 bufLen = SIZEBUF;
    UINT32 systemStatus;
 
    bBuf = aBuf;
    len = vsnprintf_s(bBuf, bufLen, bufLen - 1, fmt, ap);//C语言库函数之一，属于可变参数。用于向字符串中打印数据、数据格式用户自定义。
    if ((len == -1) && (*bBuf == '\0')) {//直接碰到字符串结束符或长度异常
        /* parameter is illegal or some features in fmt dont support */ //参数非法或fmt中的某些功能不支持
        ErrorMsg();
        return;
    }
 
    while (len == -1) {//处理((len == -1) && (*bBuf != '\0'))的情况
        /* bBuf is not enough */
        OsVprintfFree(bBuf, bufLen);
 
        bufLen = bufLen << 1;
        if ((INT32)bufLen <= 0) {//异常情况下 向串口发送
            UartPuts(errMsgLen, (UINT32)strlen(errMsgLen), UART_WITH_LOCK);
            return;
        }
        bBuf = (CHAR *)LOS_MemAlloc(m_aucSysMem0, bufLen);
        if (bBuf == NULL) {//分配内存失败,直接向串口发送错误信息
            UartPuts(errMsgMalloc, (UINT32)strlen(errMsgMalloc), UART_WITH_LOCK);
            return;
        }
        len = vsnprintf_s(bBuf, bufLen, bufLen - 1, fmt, ap);//将ap按格式输出到buf中
        if (*bBuf == '\0') {//字符串结束符
            /* parameter is illegal or some features in fmt dont support */
            (VOID)LOS_MemFree(m_aucSysMem0, bBuf);
            ErrorMsg();
            return;
        }
    }
    *(bBuf + len) = '\0';
 
    systemStatus = OsGetSystemStatus();//获取系统的状态
    if ((systemStatus == OS_SYSTEM_NORMAL) || (systemStatus == OS_SYSTEM_EXC_OTHER_CPU)) {//当前CPU正常或其他CPU出现异常时
        OutputControl(bBuf, len, type);//输出到终端
    } else if (systemStatus == OS_SYSTEM_EXC_CURR_CPU) {//当前CPU出现异常
        OutputControl(bBuf, len, EXC_OUTPUT);//串口以无锁的方式输出
    }
    OsVprintfFree(bBuf, bufLen);
}

函数调用图:

这是这个函数的调用关系图:

UartPuts()

VOID UartPuts	(	const CHAR *	s,
		UINT32	len,
		BOOL	isLock
	)