日志输出

一、LuatOS 日志输出介绍

LuatOS 使用 log 库是进行日志输出，通过 log 库可以输出不同等级的用户日志；

1.1 日志的等级

debug：调试内容输出，为日志输出优先级第 4 等级，优先级最低；

info：信息输出，为日志输出优先级第 3 等级，仅比 debug 级别高；

warn：为警告输出，为日志输出优先级第 2 等级；

error：为错误输出，为日志输出优先级第 1 等级，级别最高；

注：LuatOS 默认日志等级是 debug，可以输出 debug 及以上等级的日志；

如：log.debug(PROJECT, "debug message")，debug 为 log 模块的函数，使用小写英文字母；

1.2 日志输出等级

SILENT：静默所有日志，即禁止日志有任何内容输出；

DEBUG：输出 debug 级及以上级别的日志

INFO：输出 info 级及以上级别的日志

WARN：输出 warn 级及以上级别的日志

ERROR：输出 error 级的日志

如：log.setLevel("INFO")，INFO 作为 setLevel 函数的参数存在，使用大写英文字母；

注：debug 小写与 DEBUG 大写（其他以此类比）具有不同作用，使用过程要注意！

综上所述，LuatOS 的 log 库具有基本的日志输出功能，通过灵活运用日志功能，开发者可以随时查看变量的数值或跟踪程序运行的逻辑顺序，非常适合嵌入式开发过程中用于调试，同时也方便长时间跟踪运行，排查问题。

二、演示功能概述

本文使用 Air201模组，输出不同等级，以便开发者能快速了解日志功能的使用。

三、准备硬件环境

3.1 Air201模组

点击链接购买：合宙Air201模组淘宝购买链接；

此模组的详细使用说明参考：Air201 产品手册

3.2 TYPE-C 数据线

购买链接（注意：必须是具备USB通信的数据线！）

四、准备软件环境

4.1 Luatools

Luatools 日志打印与程序烧录软件下载

4.2 core 固件和源码脚本

注：core 固件，是基础环境，该固件由合宙官方提供，用户不可修改；源码脚本，为应用程序，可由客户自行修改；右键点我,另存为,下载完整压缩文件包

五、软硬件资料

1、此模组的详细使用说明参考：Air201 产品手册

2、API 使用介绍说明

5.1 开发板按钮与指示灯图示与说明

5.2 硬件安装与连接

5.2.1 SIM 卡安装

5.2.2 实物连接图

注：开发板与电脑通过 TYPE-C 线连接，用于通信与供电，所以必须使用支持 USB 通信的 TYPE-C 线才可以；

六、代码示例介绍

6.1 完整程序清单

注：完整复制后保存为 main.lua，可直接使用

-- LuaTools需要PROJECT和VERSION这两个信息
PROJECT = "LOG"
VERSION = "2.0.0"

-- sys库是标配
_G.sys = require("sys")

sys.taskInit(function ()
    sys.wait(1000) -- 免得看不到日志
    local tmp

        --实验1：输出四个等级的日志，日志等级排序从低到高为 debug < info < warn < error
        log.debug(PROJECT, "debug message")
        log.info(PROJECT, "info message")
        log.warn(PROJECT, "warn message")
        log.error(PROJECT, "error message")


        --实验2：输出INFO及更高级别日志，即debug日志不输出
        log.setLevel("INFO")
        print(log.getLevel())

        -- 这条debug级别的日志不会输出
        log.debug(PROJECT, "debug message")
        log.info(PROJECT, "info message")
        log.warn(PROJECT, "warn message")
        log.error(PROJECT, "error message")

        --实验3：通过日志输出变量内容
        local myInteger = 42
    log.info("Integer", myInteger)
end)
-- 这里演示4G模块上网后，会自动点亮网络灯，方便用户判断模块是否正常开机
sys.taskInit(function()
    while true do
        sys.wait(6000)
        if mobile.status() == 1 then
            gpio.setup(1, 1, gpio.PULLUP)                
        else
            gpio.setup(1, 0, gpio.PULLUP) 
            mobile.reset()
        end
    end
end)
-- 用户代码已结束---------------------------------------------
-- 结尾总是这一句
sys.run()
-- sys.run()之后后面不要加任何语句!!!!!