Module net
模块功能：网络管理、信号查询、GSM网络状态查询、网络指示灯控制、临近小区信息查询
Info:
- Copyright: openLuat
- Release: 2017.02.17
- License: MIT
- Author: openLuat
Functions
| switchFly (mode) | 设置飞行模式 |
| getNetMode () | 获取netmode |
| getState () | 获取GSM网络注册状态 |
| getMcc () | 获取当前小区的mcc |
| getMnc () | 获取当前小区的mnc |
| getLac () | 获取当前位置区ID |
| getCi () | 获取当前小区ID |
| getRssi () | 获取信号强度 |
| getCellInfo () | 获取当前和临近位置区、小区以及信号强度的拼接字符串 |
| getCellInfoExt () | 获取当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串 |
| getTa () | 获取TA值 |
| getMultiCell (cbFnc) | 实时读取“当前和临近小区信息” |
| cengQueryPoll (period) | 发起查询基站信息(当前和临近小区信息)的请求 |
| csqQueryPoll (period) | 发起查询信号强度的请求 |
| startQueryAll (...) | 设置查询信号强度和基站信息的间隔 |
| stopQueryAll () | 停止查询信号强度和基站信息 |
| setEngMode ([mode=1]) | 设置工程模式 |
Functions
- switchFly (mode)
-
设置飞行模式
Parameters:
- mode
bool
true:飞行模式开，false:飞行模式关
Returns:
-
nil
Usage:
net.switchFly(mode)
- mode
bool
- getNetMode ()
-
获取netmode
Returns:
-
number netMode,注册的网络类型 0：未注册 1：2G GSM网络 2：2.5G EDGE数据网络 3：3G TD网络 4：4G LTE网络 5：3G WCDMA网络
Usage:
net.getNetMode()
-
- getState ()
-
获取GSM网络注册状态
Returns:
-
string state,GSM网络注册状态， "INIT"表示正在初始化 "REGISTERED"表示已注册 "UNREGISTER"表示未注册
Usage:
net.getState()
-
- getMcc ()
-
获取当前小区的mcc
Returns:
-
string mcc,当前小区的mcc，如果还没有注册GSM网络，则返回sim卡的mcc
Usage:
net.getMcc()
-
- getMnc ()
-
获取当前小区的mnc
Returns:
-
string mcn,当前小区的mnc，如果还没有注册GSM网络，则返回sim卡的mnc
Usage:
net.getMnc()
-
- getLac ()
-
获取当前位置区ID
Returns:
-
string lac,当前位置区ID(16进制字符串，例如"18be")，如果还没有注册GSM网络，则返回""
Usage:
net.getLac()
-
- getCi ()
-
获取当前小区ID
Returns:
-
string ci,当前小区ID(16进制字符串，例如"93e1")，如果还没有注册GSM网络，则返回""
Usage:
net.getCi()
-
- getRssi ()
-
获取信号强度
Returns:
-
number rssi,当前信号强度(取值范围0-31)
Usage:
net.getRssi()
-
- getCellInfo ()
-
获取当前和临近位置区、小区以及信号强度的拼接字符串
Returns:
-
string cellInfo,当前和临近位置区、小区以及信号强度的拼接字符串，例如："6311.49234.30;6311.49233.23;6322.49232.18;"
Usage:
net.getCellInfo()
-
- getCellInfoExt ()
-
获取当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串
Returns:
-
string cellInfo,当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串，例如："460.01.6311.49234.30;460.01.6311.49233.23;460.02.6322.49232.18;"
Usage:
net.getCellInfoExt()
-
- getTa ()
-
获取TA值
Returns:
-
number ta,TA值
Usage:
net.getTa()
-
- getMultiCell (cbFnc)
-
实时读取“当前和临近小区信息”
Parameters:
- cbFnc
function
回调函数，当读取到小区信息后，会调用此回调函数，回调函数的调用形式为： cbFnc(cells)，其中cells为string类型，格式为：当前和临近位置区、小区、mcc、mnc、以及信号强度的拼接字符串，例如："460.01.6311.49234.30;460.01.6311.49233.23;460.02.6322.49232.18;"
Returns:
-
nil
- cbFnc
function
- cengQueryPoll (period)
-
发起查询基站信息(当前和临近小区信息)的请求
Parameters:
- period
number
查询间隔，单位毫秒
Returns:
-
bool result, true:查询成功，false:查询失败
Usage:
net.cengQueryPoll() --查询1次net.cengQueryPoll(60000) --每分钟查询1次
- period
number
- csqQueryPoll (period)
-
发起查询信号强度的请求
Parameters:
- period
number
查询间隔，单位毫秒
Returns:
-
bool , true:查询成功，false:查询停止
Usage:
net.csqQueryPoll() --查询1次net.csqQueryPoll(60000) --每分钟查询1次
- period
number
- startQueryAll (...)
-
设置查询信号强度和基站信息的间隔
Parameters:
- ...
number
查询周期,参数可变，参数为nil只查询1次，参数1是信号强度查询周期，参数2是基站查询周期
Returns:
-
bool ，true：设置成功，false：设置失败
Usage:
net.startQueryAll()
net.startQueryAll(60000) -- 1分钟查询1次信号强度，只立即查询1次基站信息
net.startQueryAll(60000,600000) -- 1分钟查询1次信号强度，10分钟查询1次基站信息
- ...
number
- stopQueryAll ()
-
停止查询信号强度和基站信息
Returns:
-
无
Usage:
net.stopQueryAll()
-
- setEngMode ([mode=1])
-
设置工程模式
Parameters:
- mode
number
[此参数可选，默认值为： 1]
工程模式，目前仅支持0和1 mode为0时，不支持临近小区查询，休眠时功耗较低 mode为1时，支持临近小区查询，但是休眠时功耗较高
Returns:
-
nil
Usage:
net.setEngMode(0)
- mode
number
[此参数可选，默认值为： 1]