log
===

.. _log-1:

log
---

模块功能：系统日志记录,分级别日志工具

\_log(level, tag, …) (local函数 无法被外部调用)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

内部函数，支持不同级别的log打印及判断

-  参数

========== ======================================================
传入值类型 释义
========== ======================================================
param      level ，日志级别，可选LOGLEVEL_TRACE，LOGLEVEL_DEBUG等
param      tag ，模块或功能名称(标签），作为日志前缀
param      … ，日志内容，可变参数
========== ======================================================

-  返回值

nil

-  例子

.. code:: lua

   _log(LOGLEVEL_TRACE,tag, 'log content')
   _log(LOGLEVEL_DEBUG,tag, 'log content')

--------------

log.trace(tag, …)
~~~~~~~~~~~~~~~~~

输出trace级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   trace('moduleA', 'log content')

--------------

log.debug(tag, …)
~~~~~~~~~~~~~~~~~

输出debug级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   debug('moduleA', 'log content')

--------------

log.info(tag, …)
~~~~~~~~~~~~~~~~

输出info级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   info('moduleA', 'log content')

--------------

log.warn(tag, …)
~~~~~~~~~~~~~~~~

输出warn级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   warn('moduleA', 'log content')

--------------

log.error(tag, …)
~~~~~~~~~~~~~~~~~

输出error级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   error('moduleA', 'log content')

--------------

log.fatal(tag, …)
~~~~~~~~~~~~~~~~~

输出fatal级别的日志

-  参数

========== ==================================
传入值类型 释义
========== ==================================
param      tag ，模块或功能名称，作为日志前缀
param      … ，日志内容，可变参数
========== ==================================

-  返回值

nil

-  例子

.. code:: lua

   fatal('moduleA', 'log content')

--------------

log.openTrace(v, uartid, baudrate)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

开启或者关闭print的打印输出功能

-  参数

+-----------------------------------+-----------------------------------+
| 传入值类型                        | 释义                              |
+===================================+===================================+
| bool                              | v：false或nil为关闭，其余为开启   |
+-----------------------------------+-----------------------------------+
| param                             | uartid：输出Luatrace的端口：nil   |
|                                   | 表示host口，1表示uart1,2表示uart2 |
+-----------------------------------+-----------------------------------+
| number                            | baudrate：nu                      |
|                                   | mber类型，uartid不为nil时，此参数 |
|                                   | 才有意义，表示波特率，默认115200  |
|                                   | <br>支持1200,2400,480             |
|                                   | 0,9600,10400,14400,19200,28800,38 |
|                                   | 400,57600,76800,115200,230400,460 |
|                                   | 800,576000,921600,1152000,4000000 |
+-----------------------------------+-----------------------------------+

-  返回值

nil

-  例子

.. code:: lua

   sys.openTrace(1,nil,921600)

--------------