nbiot.isReady()#
网络是否就绪
参数
无
返回值
返回值类型 |
解释 |
---|---|
boolean |
已联网返回true,否则返回false |
例子文章来源地址https://www.toymoban.com/news/detail-745176.html
-- 判断是否已经联网 if nbiot.isReady() then log.info("nbiot", "net is ready") end
nbiot.imsi()
读取IMSI
参数
无
返回值
返回值类型 |
解释 |
---|---|
string |
返回IMSI值,如果不存在就返回nil |
例子
--读取imsi log.info("nbiot", "imsi", nbiot.imsi())
nbiot.iccid()
读取ICCID
参数
无
返回值
返回值类型 |
解释 |
---|---|
string |
返回ICCID值,如果不存在就返回nil |
例子
-- 读取iccid log.info("nbiot", "iccid", nbiot.iccid())
nbiot.imei(val)
读取或设置IMEI
参数
传入值类型 |
解释 |
---|---|
string |
传入需要设置的imei值,不传就是读取 |
返回值
返回值类型 |
解释 |
---|---|
string |
返回imei值,如果不存在就返回nil |
例子
-- 读取imei log.info("nbiot", "imei", nbiot.imei()) @usage -- 设置imei log.info("nbiot", "imei", nbiot.imei("898989898989899898"))
nbiot.rssi()
读取RSSI
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回rssi值 |
例子
-- 读取rssi log.info("nbiot", "rssi", nbiot.rssi())
nbiot.apn()
读取APN
参数
无
返回值
返回值类型 |
解释 |
---|---|
string |
返回apn值 |
例子
-- 读取APN log.info("nbiot", "apn", nbiot.apn())
nbiot.userApn(apn,Auth_User_Name,Auth_Password,PDN_TYPE)
读取设置用户APN
参数
传入值类型 |
解释 |
---|---|
return |
读取返回PDN_TYPE,Auth_User_Name,Auth_Password,设置返回bool |
返回值
无
例子
-- 读取APN log.info("nbiot", "apn", nbiot.userApn())
nbiot.tac()
读取TAC
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回TAC值 |
例子
-- 读取TAC log.info("nbiot", "tac", nbiot.tac())
nbiot.tauTime()
读取Tau Time
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回Tau Time值 |
例子
-- 读取Tau Time log.info("nbiot", "tau time", nbiot.tauTime())
nbiot.activeTime()
读取Active Time
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回Active Time值 |
例子
-- 读取Active Time log.info("nbiot", "Active Time", nbiot.activeTime())
nbiot.cellID()
读取CellID
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回CellID值 |
例子
-- 读取CellID log.info("nbiot", "CellID", nbiot.cellID())
nbiot.snr()
读取SNR
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回SNR值 |
例子
-- 读取SNR log.info("nbiot", "SNR", nbiot.snr())
nbiot.csq()
读取CSQ, 并不完全等价于GSM的CSQ
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回csq值 |
例子
-- 读取csq log.info("nbiot", "csq", nbiot.csq())
nbiot.ceLevel()
读取CE Level
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
返回CE Level值 |
例子
-- 读取CE Level log.info("nbiot", "CE Level", nbiot.ceLevel())
nbiot.sn(val)
读取或设置SN,普通刷机(刷底层/刷脚本)不会清除
参数
传入值类型 |
解释 |
---|---|
string |
需要设置的SN值(只能是可见字符),不传值则为读取 |
返回值
返回值类型 |
解释 |
---|---|
string |
返回SN值 |
例子
-- 读取SN log.info("nbiot", "SN", nbiot.sn()) @usage -- 设置SN log.info("nbiot", "SN", nbiot.sn("My Custom SN"))
nbiot.updateCellInfo()
刷新网络信息,可通过定时任务刷新,最小间隔5秒
参数
无
返回值
返回值类型 |
解释 |
---|---|
boolean |
成功启动刷新线程返回true,否则返回false. |
例子
-- 刷新网络信息 nbiot.updateCellInfo() sys.waitUntil("CELL_INFO_IND", 3000) log.info("nbiot", "cell", json.encode(nbiot.getCellInfo()))
nbiot.mcc()
读取MCC值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商MCC值 |
例子
-- 读取MCC log.info("nbiot", "mcc", nbiot.mcc())
nbiot.mnc()
读取MNC值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商MNC值 |
例子
-- 读取MNC log.info("nbiot", "mnc", nbiot.mnc())
nbiot.earfcn()
读取earfcn值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商earfcn值 |
例子
-- 读取earfcn log.info("nbiot", "earfcn", nbiot.earfcn())
nbiot.phyCellId()
读取phyCellId值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商phyCellId值 |
例子
-- 读取phyCellId log.info("nbiot", "phyCellId", nbiot.phyCellId())
nbiot.rsrq()
读取rsrq值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商ersrq值 |
例子
-- 读取rsrq log.info("nbiot", "rsrq", nbiot.rsrq())
nbiot.rsrp()
读取rsrp值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商rsrp值 |
例子
-- 读取rsrp log.info("nbiot", "rsrp", nbiot.rsrp())
nbiot.powerLevel()
读取PowerLevel值,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
运营商PowerLevel值 |
例子
-- 读取PowerLevel log.info("nbiot", "PowerLevel", nbiot.powerLevel())
nbiot.getCellInfo()
获取网络基站详情,注册网络后可用,通过nbiot.updateCellInfo()刷新
参数
无
返回值
返回值类型 |
解释 |
---|---|
table |
网络基站详情 |
例子
-- 读取基站信息 log.info("nbiot", "cell info", json.encode(nbiot.getCellInfo()))
nbiot.setCFUN(val)
进入或退出飞行模式
参数
传入值类型 |
解释 |
---|---|
int |
0飞行模式,1普通联网模式 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
设置成功返回true,否则返回false |
例子
-- 进入飞行模式 nbiot.setCFUN(0)
nbiot.setBootCFUN(val)
设置设备上电启动时,是否进入飞行模式
参数
传入值类型 |
解释 |
---|---|
int |
0飞行模式,1普通联网模式 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
设置成功返回true,否则返回false |
例子
-- 设置为上电进入飞行模式 nbiot.setBootCFUN(0)
nbiot.getBootCFUN(val)
获取设备上电启动时,是否进入飞行模式
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
开机就进入飞行模式返回0,进入普通模式返回1 |
例子
-- 获取上电模式 nbiot.getBootCFUN()
nbiot.setPSM(psmMode,tauTimeS,activeTimeS)
设置PSM参数
参数
传入值类型 |
解释 |
---|---|
int |
psm模式, CMI_MM_DISABLE_PSM(0)/CMI_MM_ENABLE_PSM(1)/CMI_MM_DISCARD_PSM(2) |
int |
TAU time(unit: S)—related to T3412 |
int |
active time(unit: S)—related to T3324 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
设置成功返回true,否则返回false |
例子
-- 设置PSM nbiot.setPSM(1, 60, 120)
nbiot.setEDRX(modeVal,actType,reqEdrxValueMs)
设置EDRX参数
参数
传入值类型 |
解释 |
---|---|
int |
模式,CMI_MM_DISABLE_EDRX = 0/CMI_MM_ENABLE_EDRX_AND_DISABLE_IND = 1/CMI_MM_ENABLE_EDRX_AND_ENABLE_IND = 2/CMI_MM_DISCARD_EDRX = 3 |
int |
可选值, 0或者5. CMI_MM_EDRX_NO_ACT_OR_NOT_USE_EDRX = 0/CMI_MM_EDRX_NB_IOT = 5 |
int |
edrx值,4个字节长度二进制字符串 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
设置成功返回true,否则返回false |
例子
-- 设置EDRX nbiot.setPSM(1, 5, "0101")
nbiot.getPSM()
获取PSM参数
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
psm模式, CMI_MM_DISABLE_PSM(0)/CMI_MM_ENABLE_PSM(1)/CMI_MM_DISCARD_PSM(2) |
int |
TAU time(unit: S)—related to T3412 |
int |
active time(unit: S)—related to T3324 |
例子
-- 获取PSM log.info("psm", nbiot.getPSM())
nbiot.getEDRX()
获取EDRX参数
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
模式,CMI_MM_DISABLE_EDRX = 0/CMI_MM_ENABLE_EDRX_AND_DISABLE_IND = 1/CMI_MM_ENABLE_EDRX_AND_ENABLE_IND = 2/CMI_MM_DISCARD_EDRX = 3 |
int |
可选值, 0或者5. CMI_MM_EDRX_NO_ACT_OR_NOT_USE_EDRX = 0/CMI_MM_EDRX_NB_IOT = 5 |
int |
edrx值,单位毫秒 |
例子
-- 获取EDRX log.info("edrx", nbiot.getEDRX())
nbiot.setTZ(tz, auto)
设置时区参数
参数
传入值类型 |
解释 |
---|---|
int |
时区参数,可选, 单位是1/4时区, 默认为 东8区, 对应的值为32 |
boolean |
是否自动设置时区,可选, 默认为true |
返回值
无
例子
-- 设置为东8区,禁用自动更新时区功能 nbiot.setTZ(32, false) @usage -- 启用自动更新时区功能 nbiot.setTZ(nil, true)
nbiot.getTZ()
获取时区参数
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
时区参数,单位1/4时区, 默认东8区, 值为32 |
boolean |
自动设置时区,默认为true |
例子
-- 获取时区参数 log.info("timezone", nbiot.getTZ())
nbiot.setBands(modes)
设置Band模式(暂不可用)
参数
传入值类型 |
解释 |
---|---|
any |
模式,需要是一个table形式的数组,必须传入 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
设置结果 |
例子
-- 仅搜索band 8 log.info("band", nbiot.setBands({8}))
nbiot.getBands()
获取当前使用的Band模式(暂不可用)
参数
无
返回值
返回值类型 |
解释 |
---|---|
table |
所设置的band的数组 |
例子
-- 仅搜索band 8 log.info("band", json.encode(nbiot.getBands()))
nbiot.setEDRXPtw(val)
设置EDRX PTW参数
参数
传入值类型 |
解释 |
---|---|
int |
需要设置的值 |
返回值
返回值类型 |
解释 |
---|---|
boolean |
成功返回true,否则返回false |
例子
-- 设置PTW值为X nbiot.setEDRXPtw(val) -- 可选值 reqPtwValue: NB-S1 mode The field contains the PTW value in seconds for NB-S1 mode.The PTW value is used as specified in 3GPP TS 23.682 [133a].The PTW value is derived as follows: bit Paging Time Window length 0 0 0 0 2,56 seconds 0 0 0 1 5,12 seconds 0 0 1 0 7,68 seconds 0 0 1 1 10,24 seconds 0 1 0 0 12,8 seconds 0 1 0 1 15,36 seconds 0 1 1 0 17,92 seconds 0 1 1 1 20,48 seconds 1 0 0 0 23,04 seconds 1 0 0 1 25,6 seconds 1 0 1 0 28,16 seconds 1 0 1 1 30,72 seconds 1 1 0 0 33,28 seconds 1 1 0 1 35,84 seconds 1 1 1 0 38,4 seconds 1 1 1 1 40,96 seconds
nbiot.getEDRXPtw()
获取EDRX PTW参数
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
ptw值 |
例子
-- 打印PTW值 log.info("ptw", nbiot.getEDRXPtw())
nbiot.ticks()
获取tick计数
参数
无
返回值
返回值类型 |
解释 |
---|---|
int |
tick计数文章来源:https://www.toymoban.com/news/detail-745176.html |
例子
-- 打印PTW值 log.info("tick", nbiot.ticks())
到了这里,关于LuatOS-SOC接口文档(air780E)--nbiot - NB-IOT操作库的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!