log - 系统日志记录,分级别日志工具
适用范围
| 层面 | 说明 |
|---|---|
| 运行环境 | LuatOS-Air 脚本框架，展锐 8910 平台（Air724UG / Air722UG / Air795UG / Air720UH 等） |
| 前提条件 | 无外设依赖；要看到日志需日志口（UART 或虚拟 AT 口）已打开 |
| 不适用 | Air780E 及以后跑 LuatOS 的 Cat.1 模组；这些模组的同名库在 osapi 里是另一套接口，不能照抄 |
常量
| 常量 | 值 | 含义 |
|---|---|---|
| log.LOG_SILENT | 0x00 | 不输出任何日志 |
| log.LOGLEVEL_TRACE | 0x01 | 跟踪信息，最详细 |
| log.LOGLEVEL_DEBUG | 0x02 | 调试信息 |
| log.LOGLEVEL_INFO | 0x03 | 普通信息，不设置时的默认级别 |
| log.LOGLEVEL_WARN | 0x04 | 警告 |
| log.LOGLEVEL_ERROR | 0x05 | 错误 |
| log.LOGLEVEL_FATAL | 0x06 | 致命错误 |
数值越大级别越高。设置级别后在脚本最前面给全局变量 LOG_LEVEL 赋值，只有该级别及更严重的日志才会输出：
LOG_LEVEL = log.LOGLEVEL_WARN
不设置 LOG_LEVEL 时按 log.LOGLEVEL_INFO 输出。
_log(level, tag, ...) (local函数 无法被外部调用)
内部函数，支持不同级别的log打印及判断
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| level | param | 日志级别，可选LOGLEVEL_TRACE，LOGLEVEL_DEBUG等 |
| tag | param | 模块或功能名称(标签），作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
_log(LOGLEVEL_TRACE,tag, 'log content')
_log(LOGLEVEL_DEBUG,tag, 'log content')
log.trace(tag, ...)
输出trace级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
trace('moduleA', 'log content')
log.debug(tag, ...)
输出debug级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
debug('moduleA', 'log content')
log.info(tag, ...)
输出info级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
info('moduleA', 'log content')
log.warn(tag, ...)
输出warn级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
warn('moduleA', 'log content')
log.error(tag, ...)
输出error级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
error('moduleA', 'log content')
log.fatal(tag, ...)
输出fatal级别的日志
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| tag | param | 模块或功能名称，作为日志前缀 |
| ... | param | 日志内容，可变参数 |
返回值
nil
例子
fatal('moduleA', 'log content')
log.openTrace(v, uartid, baudrate)
开启或者关闭print的打印输出功能
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| v | bool | false或nil为关闭，其余为开启 |
| uartid | param | 输出Luatrace的端口：nil表示host口，1表示uart1,2表示uart2 |
| baudrate | number | number类型，uartid不为nil时，此参数才有意义，表示波特率，默认115200\ 支持1200,2400,4800,9600,10400,14400,19200,28800,38400,57600,76800,115200,230400,460800,576000,921600,1152000,4000000 |
返回值
nil
例子
sys.openTrace(1,nil,921600)