2.4 haas506 2.0开发教程-高级组件库-net（2.2版本接口与有更新）

-----------------------------------待完善---------------------------------------------------------

最新2.2版本net相关接口：
modem.net（仅支持2.2以上版本）

1.获取net信息

案例说明：

1. 开发板联网需要插入SIM卡
2. 本案例使用net模块获取信号强度，临近CELL的信息等。

mian.py

import net
import utime
print("-----------start net test----------")
utime.sleep(4)
print("methods in net:",dir(net))
print("信号强度:",net.csqQueryPoll())
print("获取邻近 CELL 的信息:",net.getCellInfo())
print("获取当前连接的网络注册信息:",net.getState())
print("------------end net test------------")

日志输出

-----------start net test----------
methods in net: ['__class__', '__name__', 'checkNet', 'dataCall', 'setApn', 
                 'getApn', 'csqQueryPoll', 'getCellInfo', 'getConfig', 'setConfig',
                 'getNetMode', 'getSignal', 'nitzTime',   'operatorName', 'getState', 
                 'getCi', 'getMnc', 'getMcc', 'getLac', 'getModemFun', 'setModemFun']
信号强度: 31
获取邻近 CELL 的信息:([], [], [(0, 68395803, 1120, 272, 46, 0, 16734, -65), 
                          (0, 68395804, 1120, 272, 45, 0, 16734, -68), 
                          (0, 68395825, 1120, 272, 69, 0, 16734, -73)])
获取当前连接的网络注册信息: ([], [], [0, 127206787, 1120, 272, 71, 100, 16734, -76])
------------end net test------------

2. Class-net

csqQueryPoll	getCellInfo	getState
获取信号强	获取邻近 CELL 的信息	获取当前连接的网络注册信息

net.csqQueryPoll()

作用：获取信号强度
返回：信号强度值

net.getState()

作用：获取当前连接的 网络注册信信息
返回：一个元组,如([], [], [0, 85410822, 1120, 0, 382, 39148, 20616, -81])

net.getCellInfo()

作用: 获取邻近 CELL 的信息
返回:失败返回整型值-1，成功返回包含三种网络系统（GSM、UMTS、LTE）的信息的list，如果对应网络系统信息为空，则返回空的List。
	 返回值格式如下：([(flag, cid, mcc, mnc, lac, arfcn, bsic, rssi)], [(flag, cid, licd, mcc, mnc,lac, arfcn, bsic, rssi)], [(flag, cid, mcc, mnc, pci, tac, earfcn,rssi, rsrq),…])
GSM网络系统返回值说明：

返回参数	说明
flag	返回 0 - 3， 0：present，1：neighbor，2：neighbor_intra 3：neighbor_inter
cid	返回GSM网络下的cell id信息，0则为空，范围0 ~ 65535
mcc	移动设备国家代码，范围 0 ~ 999注意：EC100Y/EC600S/EC600N系列的模组，该值是用十六进制来表示，比如下面示例中的十进制数1120，用十六进制表示为0x460，表示移动设备国家代码460，其他型号模组，该值直接用十进制表示，比如移动设备国家代码460，就是用十进制的460来表示。
mnc	移动设备网络代码，范围 0 ~ 99
lac	位置区码，范围 1 ~ 65534
arfcn	无线频道编号，范围 0 ~ 65535
bsic	基站识别码，范围 0 ~ 255
rssi	GSM网络下，该值表示接收电平，描述接收到信号强度，99表示未知或者无法检测到，该值的计算方式如下:rssi = RXLEV - 111，单位dBm，RXLEV 的范围是 0 ~ 63，所以rssi范围是 -111 ~ -48 dBm；

UMTS网络系统返回值说明

返回参数	说明
flag	返回 0 - 3， 0：present，1：neighbor，2：neighbor_intra 3：neighbor_inter
cid	返回UMTS网络下的 Cell identity 信息，Cell identity = RNC_ID * 65536 + Cell_ID，Cell identity范围 0x0000000 ~ 0xFFFFFFF（注意这里是28bits）；其中RNC_ID的范围是0 ~ 4095，Cell_ID的范围是0 ~ 65535
Iicd	URA ID，范围 0 ~ 65535，0表示该信息不存在
mcc	移动设备国家代码，范围 0 ~ 999
mnc	移动设备网络代码，范围 0 ~ 99
lac	位置区码，范围 1 ~ 65534
arfcn	无线频道编号，范围 0 ~ 65535
bsic	基站识别码，范围 0 ~ 255
rssi	UMTS网络下，该值表示 CPICH/PCCPCH 接收信号码功率，范围 -5 ~ 99，单位dBm

LTE网络系统返回值说明

返回参数	说明
flag	返回 0 - 3， 0：present，1：neighbor，2：neighbor_intra 3：neighbor_inter
cid	返回LTE网络下的 Cell identity 信息，Cell identity = RNC_ID * 65536 + Cell_ID，Cell identity范围 0x0000000 ~ 0xFFFFFFF（注意这里是28bits）；其中RNC_ID的范围是0 ~ 4095，Cell_ID的范围是0 ~ 65535
mcc	移动设备国家代码，范围 0 ~ 999
mnc	移动设备网络代码，范围 0 ~ 99
pci	物理层小区标识号，0 ~ 503
tac	跟踪区域码，0 ~ 65535
earfcn	无线频道编号，范围 0 ~ 65535
rssi	接收的信号强度，在LTE网络下，表示RSRP质量（负值），是根据RSRP测量报告值换算而来，换算关系如下：RSRP质量（负数）= RSRP测量报告值 - 140，单位dBm，范围 -140 ~ -44 dBm
rsrq	LTE参考信号接收质量

3.总结

本节介绍了如何使用haas506的高级组件库中的net模块。使用net模块可以获得邻近 CELL 的信息、信号强度值等信息。