📮 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, value)
    -- status的取值有:
    -- RDY SIM卡就绪, value为nil
    -- NORDY 无SIM卡, value为nil
    -- SIM_PIN 需要输入PIN, value为nil
    -- GET_NUMBER 获取到电话号码(不一定有值), value为nil
    -- SIM_WC SIM卡的写入次数统计,掉电归0, value为统计值
    log.info("sim status", status, value)
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)

---

ctiot

ctiot接口文档页

CTIOT_RX

CTIOT 接收回调消息

额外返回参数

返回参数类型	解释
string	data, CTIOT 接收数据

例子

sys.subscribe("CTIOT_RX", function(data)
    log.info("CTIOT_RX", data:toHex())
end)

---

CTIOT_TX

CTIOT 发送回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_TX", function (error, error_code, param)
    log.info("CTIOT_TX", error, error_code, param)
end)

---

CTIOT_REG

CTIOT REG回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_REG", function (error, error_code, param)
    log.info("CTIOT_REG", error, error_code, param)
end)

---

CTIOT_DEREG

CTIOT DEREG回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_DEREG", function (error, error_code, param)
    log.info("CTIOT_DEREG", error, error_code, param)
end)

---

CTIOT_WAKEUP

CTIOT 唤醒回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_WAKEUP", function (error, error_code, param)
    log.info("CTIOT_WAKEUP", error, error_code, param)
end)

---

CTIOT_OTHER

CTIOT 其他回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_OTHER", function (error, error_code, param)
    log.info("CTIOT_OTHER", error, error_code, param)
end)

---

CTIOT_FOTA

CTIOT FOTA回调消息

额外返回参数

返回参数类型	解释
bool	error, 是否成功
number	error_code, 错误代码
number	param, 数据

例子

sys.subscribe("CTIOT_FOTA", function (error, error_code, param)
    log.info("CTIOT_FOTA", error, error_code, param)
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, rssi, snr)
    -- rssi 和  snr 于 2023-09-06 新增
    log.info("LORA_RX_DONE: ", data, size, rssi, snr)
    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)

---