调试说明
========

Log 接口函数介绍
-----------------

DBGLOG_LOG 接口支持串口 log 打印。

.. code-block:: c

    /*DBGLOG_LOG 可以设置 Log 等级参数*/
    DBGLOG_LOG(module, lvl, fmt, ...)    //log 等级可以参考枚举设置
    DBGLOG_LOG(0, 0,"WQ LOG %s %d\n",name,val);

也可以使用以下三个接口，固定 **lvl** 参数。

.. code-block:: c

    DBGLOG_INFO(module, fmt, ...)
    DBGLOG_WARNING(module, fmt, ...)
    DBGLOG_ERROR(module, fmt, ...)

**DBGLOG_STREAM_LOG** 包含特定的头信息，需借助 WQ 下载调试工具查看。

.. code-block:: c

    DBGLOG_STREAM_LOG(module, lvl, fmt, ...)

串口工具参数设置
------------------------------

串口 Log 可通过常规串口转换工具配合 PC 串口软件查看，也可通过 WQ 调试下载工具查看。

查看串口 Log 涉及如下参数配置：

- 波特率： 2000000 baud
- 数据位： 8
- 校验位： None
- 停止位： 1

.. attention::

   用户使用非物奇串口转换板时，请确保波特率能达到 2000000 baud。


串口 Log 示例如下图所示。

.. image:: ../../_static/SDK_Debugging_4-1.png
    :align: center

|

WQSHELL 介绍
------------

WQSHELL 是 WQ SDK 的命令行组件，支持通过 UART 与芯片交互。用户可以通过 WQSHELL 配置的 UART 口向设备发送命令。

用户可以通过 **WQSH_ADD_CMD(<cmd>,<handle_func>,<"help description">)** 来自定义命令。

WQSHELL 交互界面如下图所示。

.. image:: ../../_static/SDK_Debugging_4-2.png
    :align: center