LuatOS-SOC接口文档(air780E)–nbiot – NB-IOT操作库

nbiot.isReady()#

网络是否就绪

参数

无

返回值

返回值类型	解释
boolean	已联网返回true,否则返回false

例子

--判断是否已经联网if nbiot.isReady() then log.info("nbiot", "net is ready")end

nbiot.imsi()

读取IMSI

参数

无

返回值

返回值类型	解释
string	返回IMSI值，如果不存在就返回nil

例子

--读取imsilog.info("nbiot", "imsi", nbiot.imsi())

nbiot.iccid()

读取ICCID

参数

无

返回值

返回值类型	解释
string	返回ICCID值，如果不存在就返回nil

例子

-- 读取iccidlog.info("nbiot", "iccid", nbiot.iccid())

nbiot.imei(val)

读取或设置IMEI

参数

传入值类型	解释
string	传入需要设置的imei值，不传就是读取

返回值

返回值类型	解释
string	返回imei值，如果不存在就返回nil

例子

-- 读取imeilog.info("nbiot", "imei", nbiot.imei())@usage -- 设置imeilog.info("nbiot", "imei", nbiot.imei("898989898989899898"))

nbiot.rssi()

读取RSSI

参数

无

返回值

返回值类型	解释
int	返回rssi值

例子

-- 读取rssilog.info("nbiot", "rssi", nbiot.rssi())

nbiot.apn()

读取APN

参数

无

返回值

返回值类型	解释
string	返回apn值

例子

-- 读取APNlog.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

返回值

无

例子

-- 读取APNlog.info("nbiot", "apn", nbiot.userApn())

nbiot.tac()

读取TAC

参数

无

返回值

返回值类型	解释
int	返回TAC值

例子

-- 读取TAClog.info("nbiot", "tac", nbiot.tac())

nbiot.tauTime()

读取Tau Time

参数

无

返回值

返回值类型	解释
int	返回Tau Time值

例子

-- 读取Tau Timelog.info("nbiot", "tau time", nbiot.tauTime())

nbiot.activeTime()

读取Active Time

参数

无

返回值

返回值类型	解释
int	返回Active Time值

例子

-- 读取Active Timelog.info("nbiot", "Active Time", nbiot.activeTime())

nbiot.cellID()

读取CellID

参数

无

返回值

返回值类型	解释
int	返回CellID值

例子

-- 读取CellIDlog.info("nbiot", "CellID", nbiot.cellID())

nbiot.snr()

读取SNR

参数

无

返回值

返回值类型	解释
int	返回SNR值

例子

-- 读取SNRlog.info("nbiot", "SNR", nbiot.snr())

nbiot.csq()

读取CSQ, 并不完全等价于GSM的CSQ

参数

无

返回值

返回值类型	解释
int	返回csq值

例子

-- 读取csqlog.info("nbiot", "csq", nbiot.csq())

nbiot.ceLevel()

读取CE Level

参数

无

返回值

返回值类型	解释
int	返回CE Level值

例子

-- 读取CE Levellog.info("nbiot", "CE Level", nbiot.ceLevel())

nbiot.sn(val)

读取或设置SN,普通刷机(刷底层/刷脚本)不会清除

参数

传入值类型	解释
string	需要设置的SN值(只能是可见字符),不传值则为读取

返回值

返回值类型	解释
string	返回SN值

例子

-- 读取SNlog.info("nbiot", "SN", nbiot.sn())@usage -- 设置SNlog.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值

例子

-- 读取MCClog.info("nbiot", "mcc", nbiot.mcc())

nbiot.mnc()

读取MNC值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商MNC值

例子

-- 读取MNClog.info("nbiot", "mnc", nbiot.mnc())

nbiot.earfcn()

读取earfcn值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商earfcn值

例子

-- 读取earfcnlog.info("nbiot", "earfcn", nbiot.earfcn())

nbiot.phyCellId()

读取phyCellId值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商phyCellId值

例子

-- 读取phyCellIdlog.info("nbiot", "phyCellId", nbiot.phyCellId())

nbiot.rsrq()

读取rsrq值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商ersrq值

例子

-- 读取rsrqlog.info("nbiot", "rsrq", nbiot.rsrq())

nbiot.rsrp()

读取rsrp值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商rsrp值

例子

-- 读取rsrplog.info("nbiot", "rsrp", nbiot.rsrp())

nbiot.powerLevel()

读取PowerLevel值,注册网络后可用,通过nbiot.updateCellInfo()刷新

参数

无

返回值

返回值类型	解释
int	运营商PowerLevel值

例子

-- 读取PowerLevellog.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

例子

-- 设置PSMnbiot.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

例子

-- 设置EDRXnbiot.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

例子

-- 获取PSMlog.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值,单位毫秒

例子

-- 获取EDRXlog.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 8log.info("band", nbiot.setBands({8}))

nbiot.getBands()

获取当前使用的Band模式(暂不可用)

参数

无

返回值

返回值类型	解释
table	所设置的band的数组

例子

-- 仅搜索band 8log.info("band", json.encode(nbiot.getBands()))

nbiot.setEDRXPtw(val)

设置EDRX PTW参数

参数

传入值类型	解释
int	需要设置的值

返回值

返回值类型	解释
boolean	成功返回true,否则返回false

例子

-- 设置PTW值为Xnbiot.setEDRXPtw(val)-- 可选值reqPtwValue:NB-S1 modeThe field contains the PTW value in seconds for NB-S1 mode.The PTW value is usedas specified in 3GPP TS 23.682 [133a].The PTW value is derived as follows:bit Paging Time Window length0 0 0 02,56 seconds0 0 0 15,12 seconds0 0 1 07,68 seconds0 0 1 110,24 seconds0 1 0 012,8 seconds0 1 0 115,36 seconds0 1 1 017,92 seconds0 1 1 120,48 seconds1 0 0 023,04 seconds1 0 0 125,6 seconds1 0 1 028,16 seconds1 0 1 130,72 seconds1 1 0 033,28 seconds1 1 0 135,84 seconds1 1 1 038,4 seconds1 1 1 140,96 seconds

nbiot.getEDRXPtw()

获取EDRX PTW参数

参数

无

返回值

返回值类型	解释
int	ptw值

例子

-- 打印PTW值log.info("ptw", nbiot.getEDRXPtw())

nbiot.ticks()

获取tick计数

参数

无

返回值

返回值类型	解释
int	tick计数

例子

-- 打印PTW值log.info("tick", nbiot.ticks())

LuatOS-SOC接口文档(air780E)–nbiot – NB-IOT操作库

nbiot.isReady()#

nbiot.imsi()

nbiot.iccid()

nbiot.imei(val)

nbiot.rssi()

nbiot.apn()

nbiot.userApn(apn,Auth_User_Name,Auth_Password,PDN_TYPE)

nbiot.tac()

nbiot.tauTime()

nbiot.activeTime()

nbiot.cellID()

nbiot.snr()

nbiot.csq()

nbiot.ceLevel()

nbiot.sn(val)

nbiot.updateCellInfo()

nbiot.mcc()

nbiot.mnc()

nbiot.earfcn()

nbiot.phyCellId()

nbiot.rsrq()

nbiot.rsrp()

nbiot.powerLevel()

nbiot.getCellInfo()

nbiot.setCFUN(val)

nbiot.setBootCFUN(val)

nbiot.getBootCFUN(val)

nbiot.setPSM(psmMode,tauTimeS,activeTimeS)

nbiot.setEDRX(modeVal,actType,reqEdrxValueMs)

nbiot.getPSM()

nbiot.getEDRX()

nbiot.setTZ(tz, auto)

nbiot.getTZ()

nbiot.setBands(modes)

nbiot.getBands()

nbiot.setEDRXPtw(val)

nbiot.getEDRXPtw()

nbiot.ticks()

相关文章

最新关注

热文推荐