📮 sys系统消息#

此处列举了LuatOS框架中自带的系统消息列表

touchkey#

touchkey接口文档页

TOUCHKEY_INC#

触摸按键消息

额外返回参数

返回参数类型

解释

number

port, 传感器id

number

state, 计数器,触摸次数统计

例子

sys.subscribe("TOUCHKEY_INC", function(id, count)
    -- 传感器id
    -- 计数器,触摸次数统计
    log.info("touchkey", id, count)
end)

keyboard#

keyboard接口文档页

KB_INC#

键盘矩阵消息

额外返回参数

返回参数类型

解释

number

port, keyboard id 当前固定为0, 可以无视

number

data, keyboard 按键 需要配合init的map进行解析

number

state, 按键状态 1 为按下, 0 为 释放

例子

sys.subscribe("KB_INC", function(port, data, state)
    -- port 当前固定为0, 可以无视
    -- data, 需要配合init的map进行解析
    -- state, 1 为按下, 0 为 释放
    log.info("keyboard", port, data, state)
end)

sys#

sys接口文档页

以0x01为第一个字节开头#

用于luatos内部的系统消息传递

额外返回参数

返回参数类型

解释

args

返回的数据

例子

--此为系统内部使用的消息，请勿在外部使用

w5500#

w5500接口文档页

IP_READY#

已联网

额外返回参数

无

例子

-- 联网后会发一次这个消息
sys.subscribe("IP_READY", function(ip, adapter)
    log.info("w5500", "IP_READY", ip, (adapter or -1) == socket.LWIP_GP)
end)

IP_LOSE#

已断网

额外返回参数

无

例子

-- 断网后会发一次这个消息
sys.subscribe("IP_LOSE", function(adapter)
    log.info("w5500", "IP_LOSE", (adapter or -1) == socket.ETH0)
end)

libgnss#

libgnss接口文档页

GNSS_STATE#

GNSS状态变化

额外返回参数

无

例子

sys.subscribe("GNSS_STATE", function(event, ticks)
    -- event取值有
    -- FIXED 定位成功
    -- LOSE  定位丢失
    -- ticks是事件发生的时间,一般可以忽略
    log.info("gnss", "state", event, ticks)
end)

mobile#

mobile接口文档页

SIM_IND#

sim卡状态变化

额外返回参数

无

例子

sys.subscribe("SIM_IND", function(status)
    -- status的取值有:
    -- RDY SIM卡就绪
    -- NORDY 无SIM卡
    -- SIM_PIN 需要输入PIN
    -- GET_NUMBER 获取到电话号码(不一定有值)
    log.info("sim status", status)
end)

CELL_INFO_UPDATE#

基站数据已更新

额外返回参数

无

例子

-- 订阅式, 模块本身会周期性查询基站信息,但通常不包含临近小区
sys.subscribe("CELL_INFO_UPDATE", function()
    log.info("cell", json.encode(mobile.getCellInfo()))
end)

IP_READY#

已联网

额外返回参数

无

例子

-- 联网后会发一次这个消息
sys.subscribe("IP_READY", function(ip, adapter)
    log.info("mobile", "IP_READY", ip, (adapter or -1) == socket.LWIP_GP)
end)

IP_LOSE#

已断网

额外返回参数

无

例子

-- 断网后会发一次这个消息
sys.subscribe("IP_LOSE", function(adapter)
    log.info("mobile", "IP_LOSE", (adapter or -1) == socket.LWIP_GP)
end)

NTP_UPDATE#

时间已经同步

额外返回参数

无

例子

-- 对于电信/移动的卡, 联网后,基站会下发时间,但联通卡不会,务必留意
sys.subscribe("NTP_UPDATE", function()
    log.info("mobile", "time", os.date())
end)

softkeyboard#

softkeyboard接口文档页

SOFT_KB_INC#

软件键盘矩阵消息

额外返回参数

返回参数类型

解释

number

port, keyboard id 当前固定为0, 可以无视

number

data, keyboard 按键 需要配合init的map进行解析

number

state, 按键状态 1 为按下, 0 为 释放

例子

sys.subscribe("SOFT_KB_INC", function(port, data, state)
    -- port 当前固定为0, 可以无视
    -- data, 需要配合init的map进行解析
    -- state, 1 为按下, 0 为 释放
    log.info("keyboard", port, data, state)
end)

socket#

socket接口文档页

NTP_UPDATE#

时间已经同步

额外返回参数

无

例子

sys.subscribe("NTP_UPDATE", function()
    log.info("socket", "sntp", os.date())
end)

NTP_ERROR#

时间同步失败

额外返回参数

无

例子

sys.subscribe("NTP_ERROR", function()
    log.info("socket", "sntp error")
end)

lora#

lora接口文档页

LORA_TX_DONE#

LORA 发送完成

额外返回参数

无

例子

sys.subscribe("LORA_TX_DONE", function()
    lora.recive(1000)
end)

LORA_RX_DONE#

LORA 接收完成

额外返回参数

无

例子

sys.subscribe("LORA_RX_DONE", function(data, size)
    log.info("LORA_RX_DONE: ", data, size)
    lora.send("PING")
end)

LORA_TX_TIMEOUT#

LORA 发送超时

额外返回参数

无

例子

sys.subscribe("LORA_TX_TIMEOUT", function()
    lora.recive(1000)
end)

LORA_RX_TIMEOUT#

LORA 接收超时

额外返回参数

无

例子

sys.subscribe("LORA_RX_TIMEOUT", function()
    lora.recive(1000)
end)

LORA_RX_ERROR#

LORA 接收错误

额外返回参数

无

例子

sys.subscribe("LORA_RX_ERROR", function()
    lora.recive(1000)
end)

sms#

sms接口文档页

SMS_INC#

收到短信

额外返回参数

返回参数类型

解释

string

手机号

string

短信内容，UTF8编码

例子

--使用的例子，可多行
-- 接收短信, 支持多种方式, 选一种就可以了
-- 1. 设置回调函数
--sms.setNewSmsCb( function(phone,sms)
    log.info("sms",phone,sms)
end)
-- 2. 订阅系统消息
--sys.subscribe("SMS_INC", function(phone,sms)
    log.info("sms",phone,sms)
end)

ntp#

ntp接口文档页

NTP_UPDATE#

NTP更新

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("NTP_UPDATE")
end)

wlan#

wlan接口文档页

WLAN_READY#

WIFI就绪

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_READY")
end)

NET_READY#

网络就绪

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("NET_READY")
end)

WLAN_SCAN_DONE#

扫描完成

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_SCAN_DONE")
end)

WLAN_STA_CONNECTED#

连接成功,但还没拿到ip

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_STA_CONNECTED")
end)

WLAN_STA_CONNECTED_FAIL#

连接失败,通常是密码错误

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_STA_CONNECTED_FAIL")
end)

WLAN_STA_DISCONNECTED#

断开连接

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_STA_DISCONNECTED")
end)

WLAN_AP_START#

热点启动

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_AP_START")
end)

WLAN_AP_STOP#

热点停止

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_AP_STOP")
end)

WLAN_AP_ASSOCIATED#

STA 接入

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_AP_ASSOCIATED")
end)

WLAN_AP_DISASSOCIATED#

STA 断开

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_AP_DISASSOCIATED")
end)

WLAN_PW_RE#

配网结束

额外返回参数

无

例子

sys.taskInit(function()
    sys.waitUntil("WLAN_PW_RE")
end)