net.md 6.0 KB
@[TOC]
net
模块功能：网络管理、信号查询、GSM网络状态查询、网络指示灯控制、临近小区信息查询
net.switchFly(mode)
设置飞行模式
注意：如果要测试飞行模式的功耗，开机后不要立即调用此接口进入飞行模式
在模块注册上网络之前，调用此接口进入飞行模式不仅无效，还会导致功耗数据异常
详情参考：http://doc.openluat.com/article/488/0
- 参数
|名称|传入值类型|释义| |-|-|-| |mode|bool|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()
获取网络注册状态
- 参数
无
- 返回值
string state,GSM网络注册状态，
"INIT"表示正在初始化
"REGISTERED"表示已注册
"UNREGISTER"表示未注册
例子
net.getState()
net.getMcc()
获取当前小区的mcc
- 参数
无
- 返回值
string mcc,当前小区的mcc，如果还没有注册GSM网络，则返回sim卡的mcc
例子
net.getMcc()
net.getMnc()
获取当前小区的mnc
- 参数
无
- 返回值
string mcn,当前小区的mnc，如果还没有注册GSM网络，则返回sim卡的mnc
例子
net.getMnc()
net.getLac()
获取当前位置区ID
- 参数
无
- 返回值
string lac,当前位置区ID(16进制字符串，例如"18be")，如果还没有注册GSM网络，则返回""
例子
net.getLac()
net.getBand()
获取当前注册的网络频段
- 参数
无
- 返回值
string band,当前注册的网络频段，如果还没有注册网络，则返回""
例子
net.getBand()
net.getCi()
获取当前小区ID
- 参数
无
- 返回值
string ci,当前小区ID(16进制字符串，例如"93e1")，如果还没有注册GSM网络，则返回""
例子
net.getCi()
net.getRssi()
获取信号强度
当前注册的是2G网络，就是2G网络的信号强度
当前注册的是4G网络，就是4G网络的信号强度
- 参数
无
- 返回值
number rssi,当前信号强度(取值范围0-31)
例子
net.getRssi()
net.getRsrp()
4G网络信号接收功率
- 参数
无
- 返回值
number rsrp,当前信号接收功率(取值范围-140 - -40)
例子
net.getRsrp()
net.getCellInfo()
获取当前和临近位置区、小区以及信号强度的拼接字符串
- 参数
无
- 返回值
string cellInfo,当前和临近位置区、小区以及信号强度的拼接字符串，例如："6311.49234.30;6311.49233.23;6322.49232.18;"
例子
net.getCellInfo()
net.getCellInfoExt(rssi)
获取当前和临近位置区、小区、mcc、mnc、以及信号的拼接字符串
- 参数
|名称|传入值类型|释义|
|-|-|-|
|rssi|bool|可选参数，默认为nil 信号是否拼接功率，true表示功率，false或者nil表示强度
表示强度时，信号的取值范围是0到31
表示功率时，信号的计算公式为 强度*2-113，取值范围为-113dB到-51dB|
- 返回值
string cellInfo,当前和临近位置区、小区、mcc、mnc、以及信号的拼接字符串，例如：
当rssi参数为true时，"460.01.6311.49234.-73;460.01.6311.49233.-67;460.02.6322.49232.-77;"
当rssi参数为false或者nil时，"460.01.6311.49234.30;460.01.6311.49233.23;460.02.6322.49232.18;"
例子
net.getCellInfoExt()
net.getTa()
获取TA值
- 参数
无
- 返回值
number ta,TA值
例子
net.getTa()
net.getMultiCell(cbFnc)
实时读取“当前和临近小区信息”
- 参数
|名称|传入值类型|释义|
|-|-|-|
|cbFnc|function|回调函数，当读取到小区信息后，会调用此回调函数，回调函数的调用形式为：
cbFnc(cells)，其中cells为string类型，格式为：当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串，例如："460.01.6311.49234.30;460.01.6311.49233.23;460.02.6322.49232.18;"|
- 返回值
nil
- 例子
无
net.cengQueryPoll(period)
发起查询基站信息(当前和临近小区信息)的请求
- 参数
|名称|传入值类型|释义| |-|-|-| |period|number|查询间隔，单位毫秒|
- 返回值
bool result, true:查询成功，false:查询失败
例子
net.cengQueryPoll() --查询1次 net.cengQueryPoll(60000) --每分钟查询1次
net.csqQueryPoll(period)
发起查询信号强度的请求
- 参数
|名称|传入值类型|释义| |-|-|-| |period|number|查询间隔，单位毫秒|
- 返回值
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.stopQueryAll()
停止查询信号强度和基站信息
- 参数
无
- 返回值
无
例子
net.stopQueryAll()
net.setEngMode(mode)
设置工程模式
- 参数
|名称|传入值类型|释义|
|-|-|-|
|mode|number|可选参数，默认为1 工程模式，目前仅支持0和1
mode为0时，不支持临近小区查询，休眠时功耗较低
mode为1时，支持临近小区查询，但是休眠时功耗较高|
- 返回值
nil
例子
net.setEngMode(0)