net¶
net¶
模块功能：网络管理、信号查询、GSM网络状态查询、网络指示灯控制、临近小区信息查询
net.switchFly(mode)¶
设置飞行模式
注意：如果要测试飞行模式的功耗，开机后不要立即调用此接口进入飞行模式 在模块注册上网络之前，调用此接口进入飞行模式不仅无效，还会导致功耗数据异常 详情参考：https://luatdoc.papapoi.com/488/ * 参数
传入值类型 |
释义 |
|---|---|
bool |
mode，true:飞行模式开，false:飞行模式关 |
返回值
nil
例子
net.switchFly(mode)
net.getNetMode()¶
获取netmode
参数
无
返回值
number netMode,注册的网络类型0：未注册1：2G GSM网络2：2.5G EDGE数据网络3：3G TD网络4：4G LTE网络5：3G WCDMA网络
例子
net.getNetMode()
net.getState()¶
获取GSM网络注册状态
参数
无
返回值
string state,GSM网络注册状态，“INIT”表示正在初始化“REGISTERED”表示已注册“UNREGISTER”表示未注册
例子
net.getState()
net.getLac()¶
获取当前位置区ID
参数
无
返回值
string lac,当前位置区ID(16进制字符串，例如“18be”)，如果还没有注册GSM网络，则返回””
例子
net.getLac()
net.getCellInfo()¶
获取当前和临近位置区、小区以及信号强度的拼接字符串
参数
无
返回值
string cellInfo,当前和临近位置区、小区以及信号强度的拼接字符串，例如：“6311.49234.30;6311.49233.23;6322.49232.18;”
例子
net.getCellInfo()
net.getCellInfoExt(rssi)¶
获取当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串
参数
无
返回值
string cellInfo,当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串，例如：“460.01.6311.49234.30;460.01.6311.49233.23;460.02.6322.49232.18;”
例子
net.getCellInfoExt()
net.getMultiCell(cbFnc)¶
实时读取“当前和临近小区信息”
参数
传入值类型 |
释义 |
|---|---|
function |
cbFnc，回调函数，当读取到小 区信息后，会调用此回调函数，回调 函数的调用形式为：cbFnc(cells)， 其中cells为string类型，格式为：当 前和临近位置区、小区、mcc、mnc、 以及信号强度的拼接字符串，例如： “460.01.6311.49234.30;460.01.631 1.49233.23;460.02.6322.49232.18;” |
返回值
nil
例子
无
net.cengQueryPoll(period)¶
发起查询基站信息(当前和临近小区信息)的请求
参数
传入值类型 |
释义 |
|---|---|
number |
period 查询间隔，单位毫秒 |
返回值
bool result, true:查询成功，false:查询失败
例子
net.cengQueryPoll() --查询1次
net.cengQueryPoll(60000) --每分钟查询1次
net.csqQueryPoll(period)¶
发起查询信号强度的请求
参数
传入值类型 |
释义 |
|---|---|
number |
period 查询间隔，单位毫秒 |
返回值
bool , true:查询成功，false:查询停止
例子
net.csqQueryPoll() --查询1次
net.csqQueryPoll(60000) --每分钟查询1次
net.startQueryAll(…)¶
设置查询信号强度和基站信息的间隔
参数
传入值类型 |
释义 |
|---|---|
number |
… 查询周期,参数可变，参数为nil只 查询1次，参数1是信号强度查询周期，参数2是基站查询周期 |
返回值
bool ，true：设置成功，false：设置失败
例子
net.startQueryAll()
net.startQueryAll(60000) -- 1分钟查询1次信号强度，只立即查询1次基站信息
net.startQueryAll(60000,600000) -- 1分钟查询1次信号强度，10分钟查询1次基站信息
net.setEngMode(mode)¶
设置工程模式
参数
传入值类型 |
释义 |
|---|---|
number |
可选参数，默认为`` 1``，mode，工程模式，目前仅支 持0和1mode为0时，不支持临近小区查 询，休眠时功耗较低mode为1时，支持 临近小区查询，但是休眠时功耗较高 |
返回值
nil
例子
net.setEngMode(0)