登录

欢迎user新华三退出

简体中文

  • 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 关于我们

05-二层技术-广域网接入命令参考

目录

07-移动通信Modem管理命令

本章节下载： 07-移动通信Modem管理命令  (747.52 KB)

07-移动通信Modem管理命令

目  录

1 移动通信Modem管理

1.1 移动通信Modem管理公共配置命令

1.1.1 controller cellular

1.1.2 description

1.1.3 display cellular

1.1.4 display controller cellular

1.1.5 display sim traffic-statistic cellular

1.1.6 dm-port open

1.1.7 mode

1.1.8 modem reboot

1.1.9 modem response

1.1.10 pin modify

1.1.11 pin unlock

1.1.12 pin verification enable

1.1.13 pin verify

1.1.14 plmn search

1.1.15 plmn select

1.1.16 reset counters controller cellular

1.1.17 reset sim traffic-statistic cellular

1.1.18 rssi

1.1.19 sendat

1.1.20 set primary

1.1.21 shutdown

1.1.22 sim switch rssi-threshold

1.1.23 sim switch traffic-statistic threshold

1.1.24 sim traffic-statistic monthly enable

1.1.25 sim traffic-statistic monthly start-date

1.1.26 trust-imsi

1.2 3G Modem管理专用配置命令

1.2.1 gsm band

1.2.2 profile create

1.2.3 profile delete

1.2.4 profile main

1.2.5 serial-set

1.2.6 wcdma band

1.3 4G/5G Modem管理专用配置命令

1.3.1 apn

1.3.2 apn-profile

1.3.3 apn-profile apply

1.3.4 attach-format imsi-sn split

1.3.5 authentication-mode

1.3.6 bandwidth

1.3.7 default

1.3.8 description

1.3.9 display interface eth-channel

1.3.10 display sim mqtt statistics

1.3.11 display sim mqtt status

1.3.12 display sim register

1.3.13 eth-channel

1.3.14 interface eth-channel

1.3.15 ip address cellular-alloc

1.3.16 ipv6 address cellular-alloc

1.3.17 lte band

1.3.18 mtu

1.3.19 nr band

1.3.20 nr mode

1.3.21 pdp-type

1.3.22 reset counters interface

1.3.23 reset sim mqtt statistics

1.3.24 shutdown

1.3.25 sim mqtt client

1.3.26 sim mqtt connect

1.3.27 sim mqtt data-format

1.3.28 sim mqtt keepalive

1.3.29 sim mqtt server

1.3.30 sim register enable

1.3.31 sim register server

1.3.32 sim register ssl-client-policy

 

1 移动通信Modem管理

1.1  移动通信Modem管理公共配置命令

1.1.1  controller cellular

controller cellular命令用来进入Cellular接口视图。

【命令】

controller cellular cellular-number

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

cellular-number：Cellular接口的编号。

【举例】

# 进入接口Cellular2/4/0的视图。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular 2/4/0]

1.1.2  description

description命令用来设置当前接口的描述信息。

undo description命令用来恢复缺省情况。

【命令】

description text

undo description

【缺省情况】

接口的描述信息为“该接口的接口名 Interface”，比如：Cellular2/4/0 Interface。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

text：接口描述信息，为1～255个字符的字符串，区分大小写。

【举例】

# 设置接口Cellular2/4/0的描述信息为“Cellular-intf”。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] description Cellular-intf

1.1.3  display cellular

display cellular命令用来显示移动通信Modem的呼叫连接信息。

【命令】

display cellular [ interface-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-number：显示指定Cellular接口的移动通信Modem呼叫连接信息。如果不指定本参数，则显示所有在位Modem对应Cellular接口的移动通信Modem呼叫连接信息。

【使用指导】

对于不同厂家生产的移动通信Modem，此命令显示的内容和格式可能略有区别。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 显示3G Modem的呼叫连接信息（WCDMA网络）。

<Sysname> display cellular 2/4/0

Cellular2/4/0:

  Hardware Information:

    Model: E176G

    Modem Firmware Version: 11.604.09.00.00

    Hardware Version: CD25TCPU

    International Mobile Subscriber Identity (IMSI): 460029010431055

    International Mobile Equipment Identity (IMEI): 353871020138548

    Factory Serial Number (FSN):  DK9RAA1871500602

    Modem Status: Online

  Profile Information:

    Profile 1: Active

      PDP Type: IPv4, Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): 001

      Packet Session Status: Inactive

  Modem Setup Information:

    Diagnostics Monitor: Close

  Network Information:

    Current Service Status: Service available

    Current Service: Combined

    Packet Service: Attached

    Packet Session Status: Inactive

    Current Roaming Status: Roaming

    Network Selection Mode: Manual

    Network Connection Mode: WCDMA precedence

    Current Network Connection: HSDPA and HSUPA

    Mobile Country Code (MCC): 460

    Mobile Network Code (MNC): 00

    Location Area Code (LAC): 4318

    Cell ID: 25381

  Radio Information:

    Current Band: ANY

    Current RSSI: -51 dBm

  Modem Security Information:

    PIN Verification: Disabled

    PIN Status: Ready

    Number of Retries remaining: 3

    SIM Status: OK

表1-1 display cellular命令显示信息描述表（WCDMA网络）

字段

描述

Hardware Information

硬件信息

Model

3G Modem名称

Modem Firmware Version

3G Modem的软件版本号

Hardware Version

3G Modem的硬件版本号

International Mobile Subscriber Identity (IMSI)

SIM卡的IMSI号码串

International Mobile Equipment Identity (IMEI)

3G Modem的IMEI串号

Factory Serial Number (FSN)

3G Modem的产品序列号

Modem Status

3G Modem的状态：

·     Online：3G Modem处于上电状态

·     Offline：3G Modem处于下电状态或省电模式，cellular接口功能不可用

Profile Information

3G Modem的参数模板信息

Profile 1

3G Modem的PDP设置状态：

·     Active：已经配置参数模板

·     Undefined：还未配置参数模板

PDP Type

PDP类型，只有Profile 1: Active时，才显示该信息：

·     IPv4：PDP协议类型为IPv4

·     IPv6：PDP协议类型为IPv6

·     PPP：PDP协议类型为PPP透传

Header Compression

PDP头压缩模式：

·     On：使能PDP头压缩

·     Off：禁止PDP头压缩

Data Compression

PDP数据压缩模式：

·     On：使能PDP数据压缩

·     Off：禁止PDP数据压缩

Access Point Name (APN)

接入点名称

Packet Session Status

PDP的激活状态：

·     Active：处于激活状态，3G Modem正在进行PPP传输

·     Inactive：处于非激活状态，3G Modem接口的物理状态为Down

Modem Setup Information

Modem安装状态

Diagnostics Monitor

诊断口监控状态

·     Open：诊断监控打开

·     Close：诊断监控关闭

Network Information

网络信息

Current Service Status

3G Modem的服务状态：

·     Service available：提供有效服务

·     Emergency：提供有限制服务，Cellular接口功能不可用

·     No service：无法提供服务，Cellular接口功能不可用

·     Low power：处于省电模式，Cellular接口功能不可用

Current Service

当前服务类型：

·     Circuit-switched：仅CS域服务

·     Packet-switched：仅PS域服务

·     Combined：CS和PS域服务都有效

·     Invalid：服务无效

Packet Service

3G Modem PS域附着状态：

·     Detached：分离状态，Cellular接口功能不可用

·     Attached：连接状态

Current Roaming Status

漫游状态：

·     Roaming：漫游状态

·     Home：本地状态

Network Selection Mode

网络选择模式：

·     Manual：手动选择

·     Automatic：自动选择

Network Connection Mode

网络连接模式：

·     WCDMA only：仅连接WCDMA网络

·     WCDMA precedence：优先连接WCDMA网络

·     GSM only：仅连接GSM网络

·     GSM precedence：优先连接GSM网络

Current Network Connection

当前网络连接：

·     No Service：无服务

·     GSM：GSM网络

·     GPRS：GPRS网络

·     EDGE：EDGE网络

·     WCDMA：WCDMA网络

·     HSDPA：HSDPA网络

·     HSUPA：HSUPA网络

·     HSDPA and HSUPA：HSDPA和HSUPA网络

·     HSPA+：HSPA+网络

·     Unknown：未知网络

Mobile Country Code (MCC)

移动国家码，搜索到网络后才能显示该信息。

Mobile Network Code (MNC)

运营商网络代码，成功注册到网络后才能显示该信息。

Location Area Code (LAC)

位置码信息，成功注册到网络后才能显示该信息

Cell ID

小区信息，成功注册到网络后才能显示该信息

Current Band

当前频带选择模式：

·     GSM：选择GSM网络频带

·     WCDMA：选择WCDMA网络频带

·     ANY：选择任意频带

·     AUTO：自动选择频带

Current RSSI

当前信号质量：

·     信号质量的取值范围为-110dBm ～ -51dBm

·     Unknown：无信号，Cellular接口功能不可用

Modem Security Information

Modem安全信息

PIN Verification

PIN认证状态：

·     Disabled：未使能PIN认证

·     Enabled：使能了PIN认证

PIN Status

·     Ready：SIM卡状态正常

·     PIN Requirement：SIM卡有PIN认证请求，需要用户配置pin verify命令

·     PUK Requirement：SIM卡有PUK认证请求，需要用户配置pin unlock命令

Number of Retries remaining

PIN或PUK剩余尝试次数

SIM Status

SIM卡状态：

·     OK：SIM卡状态正常

·     Network Reject：SIM卡被拒绝接入网络，Cellular接口功能不可用

·     Not Insert：未插入SIM卡，Cellular接口功能不可用

 

# 显示3G Modem的呼叫连接信息（TD-SCDMA网络）。

<Sysname> display cellular 2/4/0

Cellular2/4/0:

  Hardware Information:

    Model: ET128

    Modem Firmware Version: 11.101.01.08.00

    Hardware Version:  CS31TCPU

    International Mobile Subscriber Identity (IMSI): 460079011105842

    International Mobile Equipment Identity (IMEI): 860039002369111

    Factory Serial Number (FSN):  GQ4CAB1942911350

    Modem Status: Online

  Profile Information:

    Profile 1: Active

      PDP Type: IPv4

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): cmnet

      Packet Session Status: Active

  Network Information:

    Current Service Status: Service available

    Network Selection Mode: Automatic

    Network Connection Mode: TD-SCDMA precedence

    Current Network Connection: HSDPA

    Mobile Network Name: CHINA MOBILE

    Downstream Bandwidth: 2800000 bps

  Radio Information:

    Current RSSI: -75 dBm

  Modem Security Information:

    PIN Verification: Disabled

    PIN Status: Ready

    Number of Retries remaining: 3

    SIM Status: OK

表1-2 display cellular命令显示信息描述表（TD-SCDMA网络）

字段

描述

Hardware Information

硬件信息

Model

3G Modem名称

Modem Firmware Version

3G Modem的软件版本号

Hardware Version

3G Modem的硬件版本号

International Mobile Subscriber Identity (IMSI)

SIM卡的IMSI号码串

International Mobile Equipment Identity (IMEI)

3G Modem的IMEI串号

Factory Serial Number (FSN)

3G Modem的产品序列号

Modem Status

3G Modem的状态：

·     Online：3G Modem处于上电状态

·     Offline：3G Modem处于下电状态或省电模式，cellular接口功能不可用

Profile Information

3G Modem的参数模板信息

Profile 1

3G Modem的PDP设置状态：

·     Active：已经配置参数模板

·     Undefined：还未配置参数模板

PDP Type

PDP类型，只有Profile 1: Active时，才显示该信息：

·     IPv4：PDP协议类型为IPv4

·     IPv6：PDP协议类型为IPv6

·     PPP：PDP协议类型为PPP透传

Header Compression

PDP头压缩模式：

·     On：使能PDP头压缩

·     Off：禁止PDP头压缩

Data Compression

PDP数据压缩模式：

·     On：使能PDP数据压缩

·     Off：禁止PDP数据压缩

Access Point Name (APN)

接入点名称

Packet Session Status

PDP的激活状态：

·     Active：处于激活状态，3G Modem正在进行PPP传输

·     Inactive：处于非激活状态，3G Modem接口的物理状态为Down

Network Information

网络信息

Current Service Status

3G Modem的服务状态：

·     Service available：提供有效服务

·     Emergency：提供有限制服务，Cellular接口功能不可用

·     No service：无法提供服务，Cellular接口功能不可用

·     Low power：处于省电模式，Cellular接口功能不可用

Network Selection Mode

网络选择模式：

·     Manual：手动选择

·     Automatic：自动选择

Network Connection Mode

网络连接模式：

·     TD-SCDMA only：仅连接TD-SCDMA网络

·     TD-SCDMA precedence：优先连接TD-SCDMA网络

·     GSM only：仅连接GSM网络

·     GSM precedence：优先连接GSM网络

Current Network Connection

当前网络连接：

·     No Service：无服务

·     GSM：GSM网络

·     GPRS：GPRS网络

·     EDGE：EDGE网络

·     TD-SCDMA：TD-SCDMA网络

·     HSDPA：HSDPA网络

·     Unknown：未知网络

Mobile Network Name

移动网络名称

Downstream Bandwidth

下行理论带宽，单位为bps

Radio Information

无线电通信信息

Current RSSI

当前信号质量：

·     信号质量的取值范围为-110dBm ～ -51dBm

·     Unknown：无信号，Cellular接口功能不可用

Modem Security Information

Modem安全信息

PIN Verification

PIN认证状态：

·     Disabled：未使能PIN认证

·     Enabled：使能了PIN认证

PIN Status

PIN状态：

·     Ready：SIM卡状态正常

·     PIN Requirement：SIM卡有PIN认证请求，需要用户配置pin verify命令

·     PUK Requirement：SIM卡有PUK认证请求，需要用户配置pin unlock命令

Number of Retries remaining

PIN或PUK剩余尝试次数

SIM Status

SIM卡状态：

·     OK：SIM卡状态正常

·     Network Reject：SIM卡被拒绝接入网络，Cellular接口功能不可用

·     Not Insert：未插入SIM卡，Cellular接口功能不可用

 

# 显示3G Modem的呼叫连接信息（CDMA网络）。

<Sysname> display cellular 2/4/0

Cellular2/4/0:

  Hardware Information:

    Model: EC169

    Manufacturer: HUAWEI TECHNOLOGIES CO.

    Modem Firmware Version: 11.002.03.01.45

    Hardware Version:  CE62TCPUVer A

    Electronic Serial Number (ESN): c1836f2d

    Preferred Roaming List (PRL) Version: 0

    International Mobile Subscriber Identity (IMSI): 460036101433925

    Modem Status: Online

  Network Information:

    Current Service Status: Service available

    Current Roaming Status: Home

    Network Connection Mode: Manual

    Current Network Connection: 1xRTT/EVDO HYBRID

    Downstream Bandwidth: 3100000 bps

  Radio Information:

    Current RSSI(1xRTT): -93 dBm

    Current RSSI(EVDO): -75 dBm

    Current Voltage: 3336 mV

  Modem Security Information:

    PIN Verification: Disabled

    PIN Status: Ready

    Number of Retries remaining: 3

    UIM Status: OK

  UIM Number Information:

    UIM Number: 0

表1-3 display cellular命令显示信息描述表（CDMA网络）

字段

描述

Hardware Information

硬件信息

Model

3G Modem名称

Manufacturer

设备生产商

Modem Firmware Version

3G Modem的软件版本号

Hardware Version

3G Modem的硬件版本号

Electronic Serial Number (ESN)

3G Modem的产品序列号

Preferred Roaming List (PRL) Version

首选漫游列表版本

International Mobile Subscriber Identity (IMSI)

UIM卡的IMSI号码串

Modem Status

3G Modem的状态：

·     Online：3G Modem处于上电状态

·     Offline：3G Modem处于下电状态或省电模式，cellular接口功能不可用

Network Information

网络信息

Current Service Status

3G Modem的服务状态：

·     Service available：提供有效服务

·     Emergency：提供有限制服务，Cellular接口功能不可用

·     No service：无法提供服务，Cellular接口功能不可用

·     Low power：处于省电模式，Cellular接口功能不可用

Current Roaming Status

漫游状态：

·     Roaming：漫游状态

·     Home：本地状态

Network Selection Mode

网络选择模式：

·     Manual：手动选择

·     Automatic：自动选择

Current Network Connection

当前网络连接：

·     No Service：无服务

·     1xRTT/EVDO HYBRID：1xRTT和EVDO网络

·     EVDO：EVDO网络

·     1xRTT：1xRTT网络

·     Unknown：未知网络

Downstream Bandwidth

下行理论带宽，单位为bps

Radio Information

无线电通信信息

Current RSSI (1xRTT)

当前1xRTT网络信号质量：

·     信号质量的取值范围为-125dBm ～ -75dBm

·     Unknown：无信号

Current RSSI (EVDO)

当前EVDO网络信号质量：

·     信号质量的取值范围为-120dBm ～ -60dBm

·     Unknown：无信号

Current Voltage

UIM卡电压值，单位为mV

Modem Security Information

Modem安全信息

PIN Verification

PIN认证状态：

·     Disabled：未使能PIN认证

·     Enabled：使能了PIN认证

PIN Status

·     Ready：UIM卡状态正常

·     PIN Requirement：UIM卡有PIN认证请求，需要用户配置pin verify命令

·     PUK Requirement：UIM卡有PUK认证请求，需要用户配置pin unlock命令

Number of Retries remaining

PIN或PUK剩余尝试次数

UIM Status

UIM卡状态：

·     OK：SIM卡状态正常

·     Network Reject：SIM卡被拒绝接入网络，Cellular接口功能不可用

·     Not Insert：未插入SIM卡，Cellular接口功能不可用

UIM Number Information

当前工作UIM卡卡槽号信息

UIM Number

当前工作UIM卡：

·     0：卡槽号为0的SIM卡正在工作

·     1：卡槽号为1的SIM卡正在工作

 

# 显示4G Modem的呼叫连接信息（LTE网络）。

<Sysname> display cellular 0/0

Cellular0/0:

  Hardware Information:

    Model: MC7750

    Manufacturer: Sierra Wireless, Incorporated

    Modem Firmware Version: SWI9600M_03.05.10.06

    Hardware Version: 10

    International Mobile Equipment Identity (IMEI): 990000560327506

    Modem Status: Online

  Profile Information:

    Profile index: 1

      PDP Type: IPv4

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): vzwinternet

  Network Information:

    Current Service Status: Service available

    Current Roaming Status: Roaming

    Current Data Bearer Technology: Unknown

    Network Selection Mode: Manual

    Mobile Country Code (MCC): 460

    Mobile Network Code (MNC): 00

    Location Area Code (LAC): 4318

    Cell ID: 25381

  Radio Information:

    Technology Preference: LTE only

    Technology Selected: LTE

  LTE related info:

    Current RSSI: -79 dBm

    Current RSRQ: -9 dB

    Current RSRP: -106 dBm

    Current SNR: 5 dB

    Tx Power: -3276 dBm

  Modem Security Information:

    PIN Verification: Disabled

    PIN Status: Ready

SIM Status: OK

  ICCID: 89860113811003195000

表1-4 display cellular命令显示信息描述表（LTE网络）

字段

描述

Hardware Information

硬件信息

Model

Modem名称

Manufacturer

设备生产商

Modem Firmware Version

Modem的软件版本号

Hardware Version

Modem的硬件版本号

International Mobile Equipment Identity (IMEI)

Modem的IMEI串号

Modem Status

Modem的状态：

·     Online：Modem处于上电状态

·     Offline：Modem处于下电状态或省电模式，Cellular接口功能不可用

Profile Information

Modem的参数模板信息

Profile index

Modem的参数模板索引

PDP Type

PDP类型，只有Profile 1 = Active时，才显示该信息：

·     IPv4：PDP协议类型为IPv4

·     IPv6：PDP协议类型为IPv6

·     PPP：PDP协议类型为PPP透传

Header Compression

PDP头压缩模式：

·     On：使能PDP头压缩

·     Off：禁止PDP头压缩

Data Compression

PDP数据压缩模式：

·     On：使能PDP数据压缩

·     Off：禁止PDP数据压缩

Access Point Name

接入点名称

Network Information

网络信息

Current Service Status

Modem的服务状态：

·     Limited：服务受限，Cellular接口功能不可用

·     Service available：提供有效服务

·     Emergency：提供有限制服务，Cellular接口功能不可用

·     No service：无法提供服务，Cellular接口功能不可用

·     Low power：处于省电模式，Cellular接口功能不可用

Current Roaming Status

漫游状态：

·     Roaming：漫游状态

·     Home：本地状态

Current Data Bearer Technology

当前载波制式，包括：

·     CDMA2000 1X

·     CDMA2000 HRPD (1xEV-DO)

·     GSM

·     UMTS

·     CDMA2000 HRPD (1xEV-DO RevA)

·     EDGE

·     HSDPA and WCDMA

·     WCDMA and HSUPA

·     HSDPA and HSUPA

·     LTE

·     CDMA2000 EHRPD

·     HSDPA+ and WCDMA

·     HSDPA+ and HSUPA

·     DC_HSDPA+ and WCDMA

·     DC_HSDPA+ and HSUPA

·     HSDPA+ and 64QAM

·     HSDPA+, 64QAM and HSUPA

·     TDSCDMA

·     TDSCDMA and HSDPA

·     Unknown

Network Selection Mode

网络选择模式：

·     Manual：手动选择

·     Automatic：自动选择

Mobile Country Code

移动国家码，搜索到网络后才能显示该信息。

Mobile Network Code

运营商网络代码，成功注册到网络后才能显示该信息。

Location Area Code

位置码信息，成功注册到网络后才能显示该信息

Cell ID

小区信息，成功注册到网络后才能显示该信息

Radio Information

无线电通信信息

Technology Preference

网络优先连接选择：

·     AUTO：自动选择连接网络

·     GSM only：仅连接GSM网络

·     GSM precedence：优先连接GSM网络

·     WCDMA only：仅连接WCDMA网络

·     WCDMA precedence：优先连接WCDMA网络

·     TD-SCDMA only：仅连接TD-SCDMA网络

·     TD-SCDMA precedence：优先连接TD-SCDMA网络

·     EVDO：仅连接CDMA-EVDO网络

·     1x RTT：仅连接CDMA-1x RTT网络

·     1xRTT/EVDO HYBRID：同时连接CDMA-EVDO和CDMA-1x RTT网络

·     LTE only：仅连接LTE网络

Technology Selected

当前选择的网络：

·     GSM：连接GSM网络

·     WCDMA：连接WCDMA网络

·     TD-SCDMA：连接TD-SCDMA网络

·     EVDO：连接CDMA-EVDO网络

·     1x RTT：连接CDMA-1x RTT网络

·     1xRTT/EVDO HYBRID：同时连接CDMA-EVDO和CDMA-1x RTT网络

·     LTE：连接LTE网络

LTE related info

LTE网络相关信息

Current RSSI

当前信号质量：

·     信号质量的取值范围为-110dBm～-51dBm

·     Unknown：无信号，Cellular接口功能不可用

Current RSRQ

当前参考信号接收质量

Current RSRP

当前参考信号接收功率

Current SNR

当前信噪比

Tx Power

发送功率

Modem Security Information

Modem安全信息

PIN Verification

PIN认证状态：

·     Disabled：未使能PIN认证

·     Enabled：使能了PIN认证

·     Unknown：当前PIN码状态未知

PIN Status

·     Ready：SIM卡状态正常

·     PIN Requirement：SIM卡有PIN认证请求，需要用户配置pin verify命令

·     PUK Requirement：SIM卡有PUK认真请求，需要用户配置pin unlock命令

SIM Status

SIM卡状态：

·     OK：SIM卡状态正常

·     Locked：SIM卡被锁定，Cellular接口功能不可用

·     Not Inserted：未插入SIM卡，Cellular接口功能不可用

·     Unknown：当前SIM卡状态未知

ICCID

SIM卡ID号，仅当SIM卡状态为正常时显示

 

# 显示5G Modem的呼叫连接信息（5G网络）。

<sysname>display cellular 0/0

Cellular0/0:

 Modem State:

  Hardware Information:

    Model: RM500QGL_VH

    Manufacturer: QUALCOMM INCORPORATED

    Modem Firmware Version: RM500QGLABR01A01M4G

    International Mobile Equipment Identity (IMEI): 863305040121609

    International Mobile Subscriber Identity (IMSI): 460028012255957

    Hardware Version: 20000

    Modem Status: Online

    Modem Status: IPv4 Active.

    Modem Status: IPv6 Unknown.

  Profile Information:

    Profile index: 1

      PDP Type: IPv4v6

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): cmiot

      Authentication: NONE

  * - Default profile

    Profile index: 2

      PDP Type: IPv4v6

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): ims

      Authentication: NONE

    Profile index: 3

      PDP Type: IPv4v6

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): CMNET

      Authentication: NONE

    Profile index: 4

      PDP Type: IPv4v6

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): CMWAP

      Authentication: NONE

    Profile index: 5

      PDP Type: IPv4v6

      Header Compression: Off

      Data Compression: Off

      Access Point Name (APN): SOS

      Authentication: NONE

  Network Information:

    Current Service Status: Service Available

    Registration Status: Registered

    Current Service: Combined

    Current Roaming Status: Home

    Current Data Bearer Technology = NR

    Network Selection Mode: Automatic

    Current IP address Mode: Cellular-alloc

    Current IPv6 address Mode: Unknown

    Mobile Network Name: C

    Mobile Country Code (MCC): 460

    Mobile Network Code (MNC): 00

    Tracking Area Code(TAC): 4526

    Cell ID: 20027137

  Radio Information:

    Technology Preference: No preference specified (AUTO)

    Technology Selected: NR && LTE

    Configured LTE Band = 1,2,3,4,5,7,8,12,13,14,17,18,19,20,25,26,28,29,30,32,34,38,39,40,41,42,43

  5G availability under LTE system info:

    Current PCI: 537

    Endc Available: 1

    Restrict Dcnr: 0

    R15Availabe: 1

  NR related info:

    Current RSRQ: -12 dB

    Current RSRP: -93 dBm

    Current SNR: 14 dB

  LTE related info:

    Current RSSI: -65 dBm

    Current RSRQ: -13 dB

    Current RSRP: -103 dBm

    Current SNR: -2 dB

    Tx Power: 10 dBm

    Active Band = E-UTRA Operating Band 39

  Modem Security Information:

    PIN Verification: Disabled

    PIN Status: PIN Requirement Disabled

    Number of PIN Retries Remaining: 3

    Number of PUK Retries Remaining: 10

    SIM Status: OK

        ICCID: 898600100119F0111820

  Error Information:

    IPv4 dialing failed: 0x00: No error in the request

    IPv6 dialing failed: N/A

 

GNSS Information:

  GNSS Info:

    GNSS State: Enabled

    GNSS Mode Configured: Standalone

    Latitude(WGS84): 31 Deg 50 Min 21.17 Sec North

    Longitude(WGS84): 117 Deg 7 Min 47.22 Sec East

    Timestamp (UTC): 09/24/2020  01:27:26

    Local time: 09/24/2020  09:27:26

    Heading: 0.00, Velocity Horiz: 0.00, Velocity Vert: 0.00

    Height (MSL): 212.30 m

  Satellite Info:

    Satellite ID: #2

      SvSystem:GPS Elevation: 44.00, Azimuth: 309.00, SNR: 33.00, Processing Status: Track

    Satellite ID: #1

      SvSystem:BEIDOU Elevation: 61.00, Azimuth: 116.00, SNR: 40.00, Processing Status: Track

    Satellite ID: #7

      SvSystem:GALILEO Elevation: 42.00, Azimuth: 71.00, SNR: 44.00, Processing Status: Track

表1-5 display cellular命令显示信息描述表（5G网络）

字段

描述

Hardware Information

硬件信息

Model

Modem名称

Manufacturer

设备生产商

Modem Firmware Version

Modem的软件版本号

International Mobile Equipment Identity (IMEI)

Modem的IMEI串号

International Mobile Subscriber Identity (IMSI)

Modem的IMSI串号

Hardware Version

Modem的硬件版本号

Modem Status

Modem的状态：

·     Online：Modem处于上电状态

·     Offline：Modem处于下电状态或省电模式，Cellular接口功能不可用

·     IPv4 Active：IPv4拨号状态激活

·     IPv4 Inactive：IPv4拨号状态未激活

·     IPv4 Unknow：IPv4拨号未使能

·     IPv6 Active：IPv6拨号状态激活

·     IPv6 Inactive：IPv6拨号状态未激活

·     IPv6 Unknow：IPv6拨号未使能

Profile Information

Modem的参数模板信息

Profile index

Modem的参数模板索引

PDP Type

PDP类型，只有Profile 1 = Active时，才显示该信息：

·     IPv4：PDP协议类型为IPv4

·     IPv6：PDP协议类型为IPv6

·     PPP：PDP协议类型为PPP透传

Header Compression

PDP头压缩模式：

·     On：使能PDP头压缩

·     Off：禁止PDP头压缩

Data Compression

PDP数据压缩模式：

·     On：使能PDP数据压缩

·     Off：禁止PDP数据压缩

Access Point Name

接入点名称

Authentication

鉴权方式：

·     NONE：无鉴权

·     CHAP：鉴权方式为CHAP

·     PAP：鉴权方式为PAP

·     PAP or CHAP：鉴权方式为CHAP或者PAP

Network Information

网络信息

Current Service Status

Modem的服务状态：

·     Limited：服务受限，Cellular接口功能不可用

·     Service available：提供有效服务

·     Emergency：提供有限制服务，Cellular接口功能不可用

·     No service：无法提供服务，Cellular接口功能不可用

·     Low power：处于省电模式，Cellular接口功能不可用

Registration Status

网络注册状态：

·     Registered：注册成功

·     Not Registered：未注册

·     Searching：正在搜索网络

·     Denied：注册被拒绝

·     Unknown：其他

Current Service

当前服务：

·     Combined：联合服务

·     Invalid：无效服务

·     Circuit-switched：cs域服务

·     Packet-switched：ps域服务

Current Roaming Status

漫游状态：

·     Roaming：漫游状态

·     Home：本地状态

Current Data Bearer Technology

当前载波制式，包括：

·     CDMA2000 1X

·     CDMA2000 HRPD (1xEV-DO)

·     GSM

·     UMTS

·     CDMA2000 HRPD (1xEV-DO RevA)

·     EDGE

·     HSDPA and WCDMA

·     WCDMA and HSUPA

·     HSDPA and HSUPA

·     LTE

·     NR

·     CDMA2000 EHRPD

·     HSDPA+ and WCDMA

·     HSDPA+ and HSUPA

·     DC_HSDPA+ and WCDMA

·     DC_HSDPA+ and HSUPA

·     HSDPA+ and 64QAM

·     HSDPA+, 64QAM and HSUPA

·     TDSCDMA

·     TDSCDMA and HSDPA

·     Unknown

Network Selection Mode

网络选择模式：

·     Manual：手动选择

·     Automatic：自动选择

Current IP address Mode

当前IPv4地址分配模式：

·     Cellular-alloc：Modem模块分配

·     dhcp-alloc：DHCP分配

·     Manual：手动分配

·     Unknown：其他

Current IPv6 address Mode

当前IPv6地址分配模式：

·     Cellular-alloc：Modem模块分配

·     dhcp-alloc：DHCP分配

·     Manual：手动分配

·     Unknown：其他

Mobile Country Code(MCC)

移动国家码，搜索到网络后才能显示该信息

Mobile Network Code(MNC)

运营商网络代码，成功注册到网络后才能显示该信息

Tracking Area Code(TAC)

跟踪区信息，成功注册到网络后才能显示该信息

Cell ID

小区信息，成功注册到网络后才能显示该信息

Radio Information

无线电通信信息

Technology Preference

网络优先连接选择：

·     AUTO：自动选择连接网络

·     GSM only：仅连接GSM网络

·     GSM precedence：优先连接GSM网络

·     WCDMA only：仅连接WCDMA网络

·     WCDMA precedence：优先连接WCDMA网络

·     TD-SCDMA only：仅连接TD-SCDMA网络

·     TD-SCDMA precedence：优先连接TD-SCDMA网络

·     EVDO：仅连接CDMA-EVDO网络

·     1x RTT：仅连接CDMA-1x RTT网络

·     1xRTT/EVDO HYBRID：同时连接CDMA-EVDO和CDMA-1x RTT网络

·     LTE only：仅连接LTE网络

·     NR only：仅选择NR网络

Technology Selected

当前选择的网络：

·     GSM：连接GSM网络

·     WCDMA：连接WCDMA网络

·     TD-SCDMA：连接TD-SCDMA网络

·     EVDO：连接CDMA-EVDO网络

·     1x RTT：连接CDMA-1x RTT网络

·     1xRTT/EVDO HYBRID：同时连接CDMA-EVDO和CDMA-1x RTT网络

·     LTE：连接LTE网络

·     NR && LTE：连接NR+LTE网络（NSA组网）

·     NR：连接NR网络

Configured LTE Band

配置的LTE频段

5G availability under LTE system info

NSA组网中4G基站下配置的5G基站信息

Current PCI

当前小区的PCI

Endc Available

SIB2消息指示5G是否可用

Restrict Dcnr

是否限制LTE/NR基站的双站连接

R15Availabe

基站的PLMN消息中指示R15是否可用

NR related info

NR相关信息

Current RSRQ

当前参考信号接收质量

Current RSRP

当前参考信号接收功率

Current SNR

当前信噪比

LTE related info

LTE网络相关信息

Current RSSI

当前信号质量：

·     信号质量的取值范围为-110dBm～-51dBm

·     Unknown：无信号，Cellular接口功能不可用

Tx Power

发送功率

Active Band

当前注册基站的Band编号

Modem Security Information

Modem安全信息

PIN Verification

PIN认证状态：

·     Disabled：未使能PIN认证

·     Enabled：使能了PIN认证

·     Unknown：当前PIN码状态未知

PIN Status

·     Ready：SIM卡状态正常

·     PIN Requirement：SIM卡有PIN认证请求，需要用户配置pin verify命令

·     PUK Requirement：SIM卡有PUK认真请求，需要用户配置pin unlock命令

Number of PIN Retries Remaining

PIN码剩余可尝试次数

Number of PUK Retries Remaining

PUK码剩余可尝试次数

SIM Status

SIM卡状态：

·     OK：SIM卡状态正常

·     Locked：SIM卡被锁定，Cellular接口功能不可用

·     Not Inserted：未插入SIM卡，Cellular接口功能不可用

·     Unknown：当前SIM卡状态未知

ICCID

SIM卡ID号，仅当SIM卡状态为正常时显示

Error Information

错误信息

IPv4 dialing failed

IPv4拨号失败：

·     0x00：IPv4拨号失败错误码

·     N/A：无

IPv6 dialing failed

IPv6拨号失败：

·     0x00：IPv6拨号失败错误码

·     N/A：无

GNSS Information

卫星定位信息

 

【相关命令】

·     mode cdma

·     mode td-scdma

·     mode wcdma

·     pin modify

·     pin unlock

·     pin verification enable

·     pin verify

·     plmn select

·     profile create

1.1.4  display controller cellular

display controller cellular命令用来显示Cellular接口的相关信息。

【命令】

display controller [ cellular [ interface-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-number：Cellular接口的编号。

【使用指导】

如果不指定cellular参数，将显示设备支持的所有接口的相关信息；

如果指定cellular参数，不指定interface-number参数，将显示所有已创建的Cellular接口的相关信息。

USB 移动通信Modem模块热插拔后，相关统计信息会被清零。

【举例】

# 显示接口Cellular2/4/0的相关信息。

<Sysname> display controller cellular 2/4/0

Cellular2/4/0

Current state: UP

Description: Cellular2/4/0 Interface

Last clearing of counters: Never

Current system time:2023-10-30 13:56:28

Last time when physical state changed to up:-

Last time when physical state changed to down:2023-10-30 07:02:40

Capability:

 1 Control channel, 1 ETH channel

Control channel traffic statistics:

 TX: 389760 packets

 RX: 389760 packets

Capability:

 1 Control AT channel 1 Control QMI channel1 Control Debug channel1 ETH channel

Control channel(AT) 0 traffic statistics:

  TX: 305028 packets, 0 errors

  RX: 305028 packets, 0 errors

Control channel(QMI) 0 traffic statistics:

  TX: 84732 packets, 0 errors

  RX: 84732 packets, 0 errors

 Debug channel 0 traffic statistics:

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

 ETH channel 0 traffic statistics:

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

表1-6 display controller cellular命令显示信息描述表

字段

描述

Cellular2/4/0

Current state

接口当前的物理状态和管理状态，可能的取值及含义如下：

·     Administratively DOWN：表示该接口已经通过shutdown命令被关闭，即管理状态为关闭

·     DOWN：表示该接口的管理状态为开启，但物理状态为关闭（可能因为没有物理连线或者线路故障）

·     UP：该接口的管理状态和物理状态均为开启

Description

Cellular接口的描述信息

Last clearing of counters

最近一次使用reset counters controller cellular命令清除接口下的统计信息的时间。如果从设备启动一直没有执行reset counters interface命令清除过该接口下的统计信息，则显示Never

Current system time

当前的系统时间

Last time when physical state changed to up

Cellular接口物理状态上一次变为UP的时间

Last time when physical state changed to down

Cellular接口物理状态上一次变为Down的时间

Modem status

USB 移动通信Modem模块的在位状态：

·     Present：表示在位

·     Absent：表示不在位

DM port status

DM功能的状态：

·     Enabled：表示DM功能处于打开状态

·     Disabled：表示DM功能处于关闭状态

Capability:

  x Control channel, x PPP channel

Cellular接口支持的通道类型及数量，取值包括：

·     x Control channel：支持x个控制通道

·     x PPP channel：支持x个异步串口子通道

·     x ETH channel：支持x个以太网子通道

·     x ETH channel：支持x个诊断（DIAG）通道

Control channel 0 traffic statistics:

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

Control channel的报文收发统计信息：

·     发送完成的报文数量，发送错误的报文数量

·     接收的报文数量，接收错误的报文数量

PPP channel 0 traffic statistics

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

PPP channel的报文收发统计信息：

·     发送完成的报文数量，发送错误的报文数量

·     接收的报文数量，接收错误的报文数量

Debug channel 0 traffic statistics:

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

Debug channel的报文收发统计信息：

·     发送完成的报文数量，发送错误的报文数量

·     接收的报文数量，接收错误的报文数量

ETH channel 0 traffic statistics

  TX: 0 packets, 0 errors

  RX: 0 packets, 0 errors

ETH channel的报文收发统计信息：

·     发送完成的报文数量，发送错误的报文数量

·     接收的报文数量，接收错误的报文数量

 

【相关命令】

·     reset counters controller cellular

1.1.5  display sim traffic-statistic cellular

display sim traffic-statistic cellular命令用来显示Cellular接口下SIM卡数据流量使用情况的统计信息。

【命令】

display sim traffic-statistic cellular [ interface-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-number：显示指定Cellular接口下SIM卡数据流量使用情况的统计信息。interface-number表示Cellular接口的编号。如果未指定本参数，则显示所有Cellular接口下SIM卡数据流量使用情况的统计信息。

【举例】

# 显示所有Cellular接口下SIM卡数据流量使用情况的统计信息。

<Sysname> display sim traffic-statistic cellular

Interface       Upload               Download             Total

Cellular2/4/0   0GB                  0GB                  0GB

Cellular2/4/1   1000GB               50000GB              51000GB

表1-7 display cellular sim traffic-statistic命令显示信息描述表

字段

描述

Interface

Cellular接口编号

Upload

SIM卡的上传流量，单位为GB

Download

SIM卡的下载流量，单位为GB

Total

SIM卡上传流量和下载流量的总和，单位为GB

 

【相关命令】

·     reset sim traffic-statistic cellular

1.1.6  dm-port open

dm-port open命令用来开启移动通信Modem的DM功能。

undo dm-port open命令用来关闭移动通信Modem的DM功能。

【命令】

dm-port open

undo dm-port open

【缺省情况】

本命令的缺省情况与移动通信Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

【使用指导】

本命令用于在移动通信Modem上打开或关闭DM功能。

DM（Diagnostic and Monitoring，诊断和监控），指某些类型的移动通信Modem支持通过移动通信Modem上的调试信息输出接口输出调试信息功能，用于连接第三方的调试工具进行诊断和监控。

不同型号的移动通信Modem对于DM功能的支持情况不同，具体使用请参考相应的移动通信Modem用户手册。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 打开移动通信Modem的DM功能。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] dm-port open

1.1.7  mode

mode命令用来选择网络连接方式。

【命令】

mode { 1xrtt | auto | evdo | gsm | gsm-precedence | hybrid | lte | nr| td | td-precedence | wcdma | wcdma-precedence }

【缺省情况】

本命令的缺省情况与移动通信Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

1xrtt：设置移动通信Modem只选择CDMA-1x RTT网络。

auto：设置移动通信Modem自动选择网络。

evdo：设置移动通信Modem只选择CDMA-EVDO网络。

gsm：设置移动通信Modem只选择GSM网络。

gsm-preference：设置移动通信Modem优先选择GSM网络。

hybrid：设置移动通信Modem同时选择CDMA-EVDO和CDMA-1x RTT网络。

lte：设置移动通信Modem只选择LTE网络。

nr：设置移动通信Modem只选择NR网络。

td：设置移动通信Modem只选择TD-SCDMA网络。

td-preference：设置移动通信Modem优先选择TD-SCDMA网络。

wcdma：设置移动通信Modem只选择WCDMA网络。

wcdma-preference：设置移动通信Modem优先选择WCDMA网络。

【使用指导】

本命令用于在移动通信Modem上选择网络连接方式。

本命令中各参数的支持情况与移动通信Modem设备的型号有关，请以设备的实际情况为准。

在NSA组网下，若将移动通信Modem配置为只选择NR网络，则有可能会导致网络不可用，请谨慎配置。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 设置4G/5G Modem只选择LTE网络。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] mode lte

1.1.8  modem reboot

modem reboot命令用来手动重启移动通信Modem。

【命令】

modem reboot

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

注意

当3G/4G Modem处于连接状态时，配置本命令会使3G/4G Modem连接断开。

 

移动通信Modem在运行过程中能够自动检测异常，并实施自动重启。如果无法自动重启，用户可以通过本命令手动重启移动通信Modem。

【举例】

# 手动重启移动通信Modem。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] modem reboot

1.1.9  modem response

modem response命令用来配置系统向移动通信Modem下发配置指令后，等待其回复的时间间隔，以及移动通信Modem连续不响应系统配置指令（配置指令失败或配置指令响应超时）次数的阈值，达到系统配置的阈值后，自动重启移动通信Modem。

undo modem response命令用来恢复缺省情况。

【命令】

modem response timer time auto-recovery threshold

undo modem response

【缺省情况】

系统等待移动通信Modem回复的时间间隔为10秒，移动通信Modem连续不响应系统配置指令次数的阈值为3次。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

timer time：系统向移动通信Modem下发配置指令后，等待其回复的时间间隔。若在该时间内系统没收到移动通信Modem的回复，则认为移动通信Modem不响应系统配置指令。time的取值范围为1～300，单位为秒。

auto-recovery threshold：移动通信Modem连续不响应系统配置指令次数的阈值，达到阈值后系统自动重启移动通信Modem。取值范围为0～10。当threshold配置为0时，关闭自动重启功能。

【使用指导】

移动通信网络的不稳定运行或应用环境变化可能导致移动通信Modem功能故障，无法自动拨号并连接网络。设备提供自动重启移动通信Modem功能，尽可能减少需要用户手工重启移动通信Modem的情况。

开启自动重启移动通信Modem功能后，如果连续多次下发配置指令失败或配置指令响应超时，系统将自动重启移动通信Modem。为避免因配置错误引起的多次拨号失败，而导致的反复自动重启移动通信Modem的情况，系统仅在上次自动重启移动通信Modem后有过至少一次拨号成功记录，并且多次发配置指令失败或配置指令响应超时的情况下才会自动重启移动通信Modem。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置系统向移动通信Modem下发配置指令时，等待其回复的时间间隔为20秒，配置移动通信Modem模块连续4次不响应系统配置指令，则自动重启。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] modem response timer 20 auto-recovery 4

1.1.10  pin modify

pin modify命令用来修改SIM/UIM卡的PIN码，修改后的PIN码保存在SIM/UIM卡上。

【命令】

pin modify current-pin new-pin

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

current-pin：插在移动通信Modem上的SIM/UIM卡的PIN码，由4～8位数字组成。

new-pin：用户重新设置的PIN码，由4～8位数字组成。

【使用指导】

本命令用于在移动通信Modem上修改SIM/UIM卡的PIN码。

需要注意的是：

如果开启了移动通信Modem的PIN码认证功能，修改PIN码后，需要配置pin verify命令以保持和修改后的PIN码一致。

如果连续多次修改PIN码失败，会导致SIM/UIM卡被锁。

如果SIM/UIM卡被锁，必须先通过pin unlock命令来解锁。

部分移动通信Modem必须在启用PIN码认证，并且PIN码认证通过后才可以修改PIN码。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 修改SIM/UIM卡的PIN码。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] pin modify 1234 4321

PIN will be changed to “4321”. Continue? [Y/N]:y

PIN has been changed successfully.

【相关命令】

·     pin unlock

·     pin verification enable

·     pin verify

1.1.11  pin unlock

pin unlock命令用来对移动通信Modem上的SIM/UIM卡进行PIN码解锁。

【命令】

pin unlock puk new-pin

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

puk：插在移动通信Modem上的SIM/UIM卡的PUK码，由网络提供商提供，由4～8位数字组成。

new-pin：用户重新设置的PIN码，由4～8位数字组成。重新设置的PIN码保存在SIM/UIM卡上。

【使用指导】

下列情况可能导致SIM/UIM卡PIN码被锁住：

·     连续多次修改PIN码失败。

·     连续多次开启或关闭移动通信Modem的PIN码认证功能失败。

·     连续多次PIN码认证失败。

如果PIN码被锁住，需要用户使用PUK码将PIN码解锁，否则移动通信Modem的数据通信功能不可用。

需要注意的是：

如果开启了移动通信Modem的PIN码认证功能，解锁PIN码后，需要配置pin verify命令以保持和重新设置的PIN码一致。

如果连续多次解锁失败，可能会导致SIM/UIM卡被永久锁定，无法使用。

如果SIM/UIM卡被永久锁定，请联系SIM/UIM卡的运营商为SIM/UIM卡解锁。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 使用PUK码解锁PIN码。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] pin unlock 87654321 1234

PIN will be unlocked and changed to “1234”. Continue? [Y/N]:y

PIN has been unlocked and changed successfully.

【相关命令】

·     pin modify

·     pin verification enable

1.1.12  pin verification enable

pin verification enable命令用来开启移动通信Modem的PIN码认证功能。

undo pin verification enable命令用来关闭移动通信Modem的PIN码认证功能。

【命令】

pin verification enable [ pin ]

undo pin verification enable [ pin ]

【缺省情况】

本命令的缺省情况与移动通信Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

pin：插在移动通信Modem上的SIM/UIM卡的PIN码，由4～8位数字组成。

【使用指导】

本命令用于在移动通信Modem上开启或关闭PIN码认证功能。

·     如果开启了移动通信Modem的PIN码认证功能，当移动通信Modem插入或移动通信Modem重启时，会使用pin verify命令配置的PIN码进行认证，否则移动通信Modem的数据通信功能不可用。重启移动通信Modem的途径包括：重启设备、使用modem reboot命令重启移动通信Modem、热拔插USB 移动通信Modem。对于SIC-3G/4G-CDMA模块，只有设备冷启动后，才需要重新进行PIN码认证。

·     如果关闭了移动通信Modem的PIN码认证功能，不需要进行PIN码认证就可以进行移动通信Modem数据通信。

如果开启了移动通信Modem的PIN码认证功能，需要通过pin verify命令将PIN码保存在设备上，在需要认证时，自动完成PIN码认证。

需要注意的是：

开启或关闭移动通信Modem的PIN码认证功能时，可能要求输入当前的PIN码。如果连续多次开启或关闭移动通信Modem的PIN码认证功能失败，可能会导致SIM/UIM卡被锁。如果SIM/UIM卡被锁，可以通过pin unlock命令来解锁。

部分移动通信Modem在启用PIN码认证功能后，必须PIN码认证通过后才可以关闭PIN码认证功能。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 开启PIN码认证功能。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] pin verification enable 1234

【相关命令】

·     pin unlock

·     pin verify

1.1.13  pin verify

pin verify命令用来配置移动通信Modem进行认证的PIN码，即插在移动通信Modem上的SIM/UIM卡的PIN码。

undo pin verify命令用来恢复缺省情况。

【命令】

pin verify { cipher | simple } string

undo pin verify

【缺省情况】

未配置移动通信Modem进行认证的PIN码。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

cipher：以密文方式设置PIN码。

simple：以明文方式设置PIN码，该PIN码将以密文形式存储。

string：插在移动通信Modem上的SIM/UIM卡的PIN码。明文PIN码为4～8位的数字，密文PIN码为37～41个字符的字符串。

【使用指导】

开启了移动通信Modem的PIN码认证功能后，当移动通信Modem插入或重启时，需要通过pin verify命令输入PIN码进行认证，如果输入的PIN码正确，则PIN码认证通过，否则，PIN码认证失败。如果连续多次PIN码认证失败，可能会导致SIM/UIM卡被锁。如果SIM/UIM卡被锁，可以通过pin unlock命令来解锁。

用户可以在需要PIN码认证时配置pin verify命令，也可以提前配置pin verify命令，只要配置一次pin verify命令，PIN码就会保存在设备上，在需要认证时，自动完成PIN码认证。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

#  配置移动通信Modem进行认证的PIN码为明文的1234。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] pin verify simple 1234

【相关命令】

·     pin unlock

·     pin verification enable

1.1.14  plmn search

plmn search命令用来搜索移动网络。

【命令】

plmn search

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

本命令用于触发移动通信Modem搜索移动网络。

搜索移动网络需要等待几分钟，完成搜索后，命令行会给出提示，显示搜索到的移动网络。

移动通信Modem使用时，需要在PLMN（Public Land Mobile Network，公共地带移动网络）进行选择接入的移动网络。如果用户需要手工指定接入的移动网络，则需要先搜索移动网络，获取当前区域内有信号的移动网络列表。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 搜索移动网络。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] plmn search

PLMN search done.

Available PLMNs:

PLMN No.     MCC    MNC    Status     Type

01           460    00     Current    GSM

02           460    00     Available  UTRAN

03           460    01     Forbidden  GSM

表1-8 plmn search命令显示信息描述表

字段

描述

PLMN No

序号

MCC

移动国家编码

MNC

移动网络编码，表示运营商，比如：

·     00、02、07：表示移动

·     01：表示联通

·     03：表示电信

Status

移动网络的状态，其取值及含义如下：

·     Current：表示当前正在使用的网络

·     Available：表示网络可达

·     Forbidden：表示网络被禁止使用

Type

搜索到的移动网络类型

 

【相关命令】

·     display cellular

·     plmn select

1.1.15  plmn select

plmn select命令用来配置选择移动网络的方式。

【命令】

plmn select { auto | manual mcc mnc }

【缺省情况】

本命令的缺省情况与移动通信Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

auto：表示自动选择PLMN（Public Land Mobile Network，公共地带移动网络）。

manual：表示人工指定PLMN。

mcc：MCC（Mobile Country Code，移动国家编码），取值范围为0～65535。

mnc：MNC（Mobile Network Code，移动网络编码），取值范围为0～65535。

【使用指导】

本命令用于在移动通信Modem上配置选择移动网络的方式。

当配置选择移动网络的方式为人工指定时，需要先通过plmn search命令搜索移动网络。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置选择移动网络的方式为人工指定。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] plmn select manual 65524 65524

【相关命令】

·     display cellular

·     plmn search

1.1.16  reset counters controller cellular

reset counters controller cellular命令用来清除Cellular接口的统计信息。

【命令】

reset counters controller cellular [ interface-number ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

cellular [ interface-number ]：Cellular接口的编号。如果不指定interface-number，则清除所有Cellular接口的统计信息；如果指定interface-number，则清除指定Cellular接口的统计信息。

【使用指导】

在某些情况下，需要统计一定时间内某接口的流量，这就需要在统计开始前清除该接口原有的统计信息，重新进行统计。

【举例】

# 清除接口Cellular2/4/0的统计信息。

<Sysname> reset counters controller cellular 2/4/0

【相关命令】

·     display controller cellular

1.1.17  reset sim traffic-statistic cellular

reset sim traffic-statistic cellular命令用来清除Cellular接口下SIM卡数据流量使用情况的统计信息。

【命令】

reset sim traffic-statistic cellular [ interface-number ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

interface-number：清除指定Cellular接口下SIM卡数据流量使用情况的统计信息。interface-number表示Cellular接口的编号。如果未指定本参数，则显示所有Cellular接口下SIM卡数据流量使用情况的统计信息。

【举例】

# 清除接口Cellular2/4/0下SIM卡数据流量使用情况的统计信息。

<Sysname> reset sim traffic-statistic cellular 2/4/0

【相关命令】

·     display sim traffic-statistic cellular

1.1.18  rssi

rssi命令用来配置移动通信网络RSSI监控阈值。

undo rssi命令用来恢复缺省情况。

【命令】

rssi { 1xrtt | evdo | gsm | lte } { low lowthreshold | medium mediumthreshold } *

undo rssi { 1xrtt | evdo | gsm | lte } [ low | medium ]

【缺省情况】

移动通信网络RSSI监控下限阈值为-150dBm、上限阈值为0dBm。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

1xrtt：1xRTT网络制式。

evdo：EVDO网络制式。

gsm：GSM网络制式。

lte：LTE网络制式。

low lowthreshold：配置RSSI监控的下限阈值，lowthreshold表示下限阈值的相反数，取值范围为0～150，代表阈值范围为-150dBm～0dBm。

medium mediumthreshold：配置RSSI监控的上限阈值，mediumthreshold表示上限阈值的相反数，取值范围为0～150，代表阈值范围为-150dBm～0dBm。

【使用指导】

移动通信网络通过RSSI表示当前信号的强度，用户可以通过display cellular命令查看当前网络的RSSI值来了解信号强弱的变化。

配置RSSI的监控的下限阈值必须小于等于上限阈值，但是由于lowthreshold参数和mediumthreshold参数表示的是RSSI值的相反数，所以lowthreshold参数的值必须大于等于mediumthreshold参数的值。当RSSI值大于配置的上限阈值时，发送一次显示信号强的trap信息；当RSSI值在配置的阈值范围内时，发送一次显示信号正常的trap信息；当RSSI值小于等于配置的下限阈值时，发送一次显示信号弱的trap信息，如果RSSI值一直小于等于配置的下限阈值时，每10分钟发送一次显示信号弱的trap信息。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置GSM网络制式RSSI监控的下限阈值为-110dBm。

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] rssi gsm low 110

1.1.19  sendat

sendat命令用来手工向移动通信Modem发送配置指令。

【命令】

sendat at-string

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

at-string：配置指令字符串，为1～300个字符的字符串。该字符串的内容格式不同产品有所区别，可能是AT指令（“+++”和“A/”以及任意以AT开头的字符串，AT指令的详细解释请参见“二层技术-广域网接入命令参考/Modem管理”中的命令sendat），也可能是CNS格式的报文（样例请参见表1-9）。

表1-9 CNS格式报文举例

指令

说明

CNSn

控制CNS心跳检测开关

·     n = 00000500000000000000，打开CNS心跳检测开关

·     n = 00000800000000000000，关闭CNS心跳检测开关

 

【使用指导】

sendat命令不检查配置指令的合法性，直接将用户输入的字符串送至移动通信Modem（遇到小写字母自动转化为大写字母）。

需要注意的是：

sendat命令一次只能配置一条配置指令。

通过配置指令配置移动通信Modem后，移动通信Modem的工作状态会被改变，有可能导致移动通信Modem的状态混乱从而影响到拨号等基本功能。请在专业人员的指导下慎重使用此功能。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 向移动通信Modem发送拨号指令，呼叫号码169。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] sendat ATD169

# 向移动通信Modem发送打开CNS心跳检测开关的指令。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] sendat cns00000500000000000000

1.1.20  set primary

set primary命令用来配置双卡单待设备的备用SIM卡为主卡。

undo set primary命令用来恢复缺省情况。

【命令】

set primary

undo set primary

【缺省情况】

双卡单待设备上第一个Cellular接口对应的SIM卡为主用SIM卡，第二个Cellular接口对应的SIM卡为备用SIM卡。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

使用场景

在双卡单待的移动通信设备上，当用户希望利用备用SIM卡作为主要通信手段时，可以使用此命令。例如，在特定场景下，备用SIM卡所属运营商提供的网络覆盖、信号质量或资费优于缺省主用SIM卡，用户可通过此命令切换主卡。

工作机制

当用户在备用SIM卡对应的Cellular接口下配置set primary命令时，移动通信Modem会在配置命令后强制重启，并在重启后将备用SIM卡设为主卡。设备将使用新配置的主用SIM卡进行通信。若要恢复设备缺省主用SIM卡，用户可执行undo set primary命令。

注意事项

·     该命令仅适用于双卡单待的移动通信设备。

·     本命令只支持在缺省的备用SIM卡对应的Cellular接口上配置。在缺省主SIM卡对应的Cellular接口下，设备会提示配置失败。

·     在切换主卡前，请确保备用SIM卡已插入且网络可用。若在备用SIM卡不在位的情况下配置本命令，本命令配置后不会立即生效，也不会重启移动通信Modem。之后，当备用SIM卡在位时，移动通信Modem并不会自动重启，需要管理员手动重启。在重启后，移动通信Modem会自动将备用SIM卡设为主卡。

·     若设备已与网络建立连接，切换主卡会导致连接中断。在执行此命令前，请确保中断对业务无影响或已获得用户许可。

·     在缺省的备用SIM卡对应的Cellular接口上，如果先配置了set primary命令，再配置sim switch-back enable命令，设备会提示sim switch-back enable命令配置失败。而如果先配置了sim switch-back enable命令，仍可继续配置set primary命令，但最终以set primary命令生效，sim switch-back enable命令将不生效。

【举例】

# 配置Cellular1/1对应的SIM卡为主卡。

<Sysname> system-view

[Sysname] controller cellular 1/1

[Sysname-Cellular1/1] set primary

【相关命令】

·     modem reboot

·     sim switch-back enable

1.1.21  shutdown

shutdown命令用来关闭Cellular接口。

undo shutdown命令用来打开Cellular接口。

【命令】

shutdown

undo shutdown

【缺省情况】

Cellular接口处于打开状态。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【举例】

# 关闭接口Cellular2/4/0。

<Sysname> system-view

[Sysname] interface cellular 2/4/0

[Sysname-Cellular2/4/0] shutdown

1.1.22  sim switch rssi-threshold

sim switch rssi-threshold命令用来配置设备根据RSSI（Received Signal Strength Indicator，接收信号强度指示）的门限值自动切换SIM卡。

undo sim switch rssi-threshold命令用来取消设备根据RSSI门限值自动切换SIM卡的配置。

【命令】

sim switch rssi-threshold [ rssi-threshold ] [ interval interval ] [ times times ]

undo sim switch rssi-threshold

【缺省情况】

设备不会根据RSSI门限值自动切换SIM卡。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

rssi-threshold：指定切换SIM卡的RSSI门限值，取值范围为-120～-60，单位为dBm，缺省值为-105。当接收的信号强度小于RSSI门限值时，设备会自动切换SIM卡。

interval interval：指定查询RSSI门限值的时间间隔，interval表示查询间隔，取值范围为1～3600，单位为秒，缺省值为10。

times times：指定信号强度连续低于门限值的次数，times表示信号强度连续低于门限值的次数，取值范围为1～255，单位为次，缺省值为1。当信号强度连续低于门限值的次数达到或超过times时，设备会自动切换SIM卡。

【使用指导】

应用场景

在双卡单待的移动通信设备上，当用户在双SIM卡场景下遇到3G/LTE链路信号质量不佳导致数据传输受影响时，如果希望能够及时切换至另一个SIM卡提供的3G/LTE服务，请配置本命令。

工作机制

移动通信网络通过RSSI表示当前信号的强度，用户可以通过display cellular命令查看当前网络的RSSI值来了解信号强弱的变化。

配置本命令后，设备每隔interval查询一次RSSI门限值，并判断信号强度是否低于查询到的RSSI门限值。当信号强度连续低于门限值的次数达到或超过times时，设备将自动切换SIM卡。

配置建议

通常情况下，建议用户使用缺省值，即配置本命令时不指定任何参数。

注意事项

请用户根据使用的3G/LTE链路的信号质量，设置合适的RSSI门限值：

·     如果RSSI门限值设置得过大（例如-70dBm），可能会导致设备频繁切换SIM卡，从而引发流量频繁中断。

·     如果RSSI门限值设置得过小（例如-110dBm），即使3G/LTE链路信号质量不佳，设备也不会切换SIM卡，导致用户长期使用提供较差3G/LTE服务的SIM卡。

在同一Cellular接口视图下重复执行本命令，最后一次执行的命令生效。

【举例】

# 配置当信号强度小于-100dBm时设备自动切换SIM卡。

<Sysname> system-view

[Sysname] controller cellular 1/0

[Sysname-Cellular1/0] sim switch rssi-threshold -100

1.1.23  sim switch traffic-statistic threshold

sim switch traffic-statistic threshold命令用来设置SIM卡的数据流量阈值。

undo sim switch traffic-statistic threshold命令用来恢复缺省情况。

【命令】

sim switch traffic-statistic threshold threshold

undo sim switch traffic-statistic threshold

【缺省情况】

不限制SIM卡的数据流量。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

threshold：设置SIM卡的数据流量阈值，取值范围为1～65535，单位为GB。

【使用指导】

应用场景

为了监控和管理双卡单待移动通信设备中SIM卡的数据流量使用，避免用户在使用单个SIM卡时流量超额产生额外费用，请使用如下配置方案：

(1)     通过sim traffic-statistic monthly enable命令开启设备按月统计SIM卡数据流量使用情况的功能。

(2)     通过sim switch traffic-statistic threshold命令为SIM卡设置数据流量阈值。这个阈值应该根据运营商提供的流量套餐和用户的使用习惯来确定。

(3)     在设备上配置sim traffic-statistic monthly start-date命令来跟踪SIM的数据流量使用情况。

完成上述配置后，当某个SIM卡的数据流量使用达到预设的阈值时，设备自动切换到另一张SIM卡。这样可以防止超额使用，避免产生额外费用。如果设备只插有一张SIM卡，当SIM卡的数据流量使用达到预设的阈值时，设备会关闭SIM卡对应的接口，切断网络流量。

工作机制

配置本命令后，如果主用SIM卡的数据流量达到阈值，则会自动切换为另外一张SIM卡。

用户可以通过display cellular sim traffic-statistic命令查看SIM卡数据流量使用情况的统计信息。

注意事项

如下两种方式均可触发设备自动切换SIM卡：

·     根据RSSI（Received Signal Strength Indicator，接收信号强度指示）的门限值切换SIM卡

·     根据数据流量的使用情况切换SIM卡

同时配置两种方式的SIM卡切换，生效顺序如下：

·     根据数据流量的使用情况切换SIM卡的优先级高于根据RSSI的门限值切换SIM卡的优先级

·     设备根据数据流量的使用情况切换过SIM卡后，不会再根据RSSI的门限值切换SIM卡

·     设备根据数据流量的使用情况切换过SIM卡后，用户又通过sim switch-to命令手工切换SIM卡，则根据数据流量使用情况切换SIM卡的配置重新生效

·     根据数据流量的使用情况切换SIM卡的配置是否生效，不会受到根据RSSI的门限值切换SIM卡配置的影响。即设备根据RSSI的门限值切换过SIM卡后，还可以根据数据流量的使用情况再次切换SIM卡

注意事项

只有开启sim traffic-statistic monthly enable命令后，本命令才会生效。

【举例】

# 在接口Cellular1/0下设置SIM卡的数据流量阈值为20GB。

<Sysname> system-view

[Sysname] controller cellular 1/0

[Sysname-Cellular1/0] sim switch traffic-statistic threshold 20

【相关命令】

·     display cellular sim traffic-statistic

·     sim traffic-statistic monthly enable

·     sim traffic-statistic monthly start-date

1.1.24  sim traffic-statistic monthly enable

sim traffic-statistic monthly enable命令用来开启设备按月统计SIM卡数据流量使用情况的功能。

undo sim traffic-statistic monthly enable命令用来关闭设备按月统计SIM卡数据流量使用情况功能。

【命令】

sim traffic-statistic monthly enable

undo sim traffic-statistic monthly enable

【缺省情况】

设备不统计SIM卡每月数据流量的使用情况。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

为了监控和管理双卡单待移动通信设备中SIM卡的数据流量使用，避免用户在使用单个SIM卡时流量超额产生额外费用，请使用如下配置方案：

(1)     通过sim traffic-statistic monthly enable命令开启设备按月统计SIM卡数据流量使用情况的功能。

(2)     通过sim switch traffic-statistic threshold命令为SIM卡设置数据流量阈值。这个阈值应该根据运营商提供的流量套餐和用户的使用习惯来确定。

(3)     在设备上配置sim traffic-statistic monthly start-date命令来跟踪SIM的数据流量使用情况。

完成上述配置后，当某个SIM卡的数据流量使用达到预设的阈值时，设备自动切换到另一张SIM卡。这样可以防止超额使用，避免产生额外费用。如果设备只插有一张SIM卡，当SIM卡的数据流量使用达到预设的阈值时，设备会关闭SIM卡对应的接口，切断网络流量。

工作机制

配置本命令后，设备开始按月统计SIM卡数据的流量使用情况。

用户可以通过display sim traffic-statistic cellular命令查看SIM卡数据流量使用情况的统计信息。

注意事项

配置sim traffic-statistic monthly enable命令后，建议用户不要配置sim switch-back enable命令，避免出现SIM卡切换不符合预期的情况。

【举例】

# 开启设备按月统计SIM卡数据流量使用情况的功能。

<Sysname> system-view

[Sysname] sim traffic-statistic monthly enable

【相关命令】

·     display sim traffic-statistic cellular

·     sim switch traffic-statistic threshold

·     sim switch-back enable

·     sim traffic-statistic monthly start-date

1.1.25  sim traffic-statistic monthly start-date

sim traffic-statistic monthly start-date命令用来配置设备开始统计SIM卡数据流量使用情况的起始日期。

undo sim traffic-statistic monthly start-date命令用来恢复缺省情况。

【命令】

sim traffic-statistic monthly start-date month-day

undo sim traffic-statistic monthly start-date

【缺省情况】

设备开始统计SIM卡数据流量使用情况的起始日期为每月1号。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

month-day：配置设备从指定的起始日期开始统计SIM卡数据流量使用情况。month-day表示日期，取值范围为1～31。

【使用指导】

应用场景

为了监控和管理双卡单待移动通信设备中SIM卡的数据流量使用，避免用户在使用单个SIM卡时流量超额产生额外费用，请使用如下配置方案：

(1)     通过sim traffic-statistic monthly enable命令开启设备按月统计SIM卡数据流量使用情况的功能。

(2)     通过sim switch traffic-statistic threshold命令为SIM卡设置数据流量阈值。这个阈值应该根据运营商提供的流量套餐和用户的使用习惯来确定。

(3)     在设备上配置sim traffic-statistic monthly start-date命令来跟踪SIM的数据流量使用情况。

完成上述配置后，当某个SIM卡的数据流量使用达到预设的阈值时，设备自动切换到另一张SIM卡。这样可以防止超额使用，避免产生额外费用。如果设备只插有一张SIM卡，当SIM卡的数据流量使用达到预设的阈值时，设备会关闭SIM卡对应的接口，切断网络流量。

工作机制

配置sim traffic-statistic monthly start-date命令后，设备统计SIM卡数据流量使用情况的机制如下：

(4)     设备自动获取系统时间的月份，并从该月month-day开始统计自然月的SIM卡数据流量使用情况。如果系统时间的月份中不包含指定的month-day，则设备从本月最后一天开始统计。例如，将month-day指定为31，系统时间为“12:20:26 UTC Tue 04/06/2024”，则设备从4月30号开始统计SIM卡数据流量使用情况。

通过display cellular sim traffic-statistic命令能够查看SIM卡数据流量使用情况的统计信息。

(5)     设备在下个月month-day的0点自动清除SIM卡流量使用情况的统计信息，然后重新开始统计。

例如，将month-day设置为2，系统时间为“12:20:26 UTC Tue 02/06/2024”，则设备统计从2月2号～3月1号的SIM卡数据流量使用情况。3月2号0点自动清除统计信息，然后重新开始统计。

注意事项

只有开启sim traffic-statistic monthly enable命令后，本命令才会生效。

【举例】

# 在接口Cellular1/0下配置设备开始统计SIM卡数据流量使用情况的起始日期为2号。

<Sysname> system-view

[Sysname] controller cellular 1/0

[Sysname-Cellular1/0] sim traffic-statistic monthly start-date 2

【相关命令】

·     display cellular sim traffic-statistic

·     sim switch traffic-statistic threshold

·     sim traffic-statistic monthly enable

1.1.26  trust-imsi

trust-imsi命令用来配置本地信任的IMSI。

undo trust-imsi命令用来删除本地信任的IMSI。

【命令】

trust-imsi string-imsi

undo trust-imsi [ string-imsi ]

【缺省情况】

未配置本地信任的IMSI。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

string-imsi：表示本地信任的IMSI，为1～31个字符的字符串，不区分大小写。

【使用指导】

配置了本地信任的IMSI后，只有安装的SIM卡的IMSI与配置的本地信任的IMSI一致时，才可以进行拨号。重复执行本命令，最多可以配置16个本地信任的IMSI。

【举例】

# 在Cellular0/0接口配置本地信任的IMSI为hccc123456789。

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] trust-imsi hccc123456789

 

1.2  3G Modem管理专用配置命令

1.2.1  gsm band

gsm band命令用来配置3G/4G Modem接入GSM网络的工作频段。

undo gsm band命令用来恢复缺省情况。

【命令】

gsm band { egsm900 | gsm450 | gsm480 | gsm750 | gsm850 | gsm1800 | gsm1900 | pgsm900 | rsgm900 }

undo gsm band

【缺省情况】

未配置3G/4G Modem接入GSM网络的工作频段。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

egsm900：使用E-GSM 900MHz频段。

gsm450：使用GSM 450MHz频段。

gsm480：使用GSM 480MHz频段。

gsm750：使用GSM 750MHz频段。

gsm850：使用GSM 850MHz频段。

gsm1800：使用GSM 1800MHz频段。

gsm1900：使用GSM 1900MHz频段。

pgsm900：使用P-GSM 900MHz频段。

rgsm900：使用GSM-R 900MHz频段。

【使用指导】

本命令仅Sierra的4G模块MC7354的ATT版本和MC7304支持。

GSM网络可以提供多种频段供用户接入。3G/4G Modem通过Cellular接口接入GSM网络后，当GSM网络频段发生变化时，3G/4G Modem会自动调整工作频段来适应网络环境的变化，从而影响3G链路的稳定性。为了避免因网络频段变化引起的3G链路不稳定，用户可以手动配置3G/4G Modem接入的GSM网络的工作频段。

【举例】

# 配置3G/4G Modem接入GSM网络的工作频段为gsm1800。

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] gsm band gsm1800

【相关命令】

·     lte band

·     wcdma band

1.2.2  profile create

profile create命令用来创建3G Modem的参数模板。

【命令】

profile create profile-number { dynamic | static apn } authentication-mode { none | { chap | pap } user username [ password password ] }

【缺省情况】

本命令的缺省情况与3G Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

profile-number：3G Modem的参数模板编号。不同型号的3G Modem设备支持的取值范围不同，请以设备的实际情况为准。

dynamic：由运营商根据接入用户动态分配接入点。

static apn：指定的由运营商提供的接入点名称，为1～100个字符的字符串，是否大小写敏感和运营商有关。

authentication-mode：认证方式。

none：不认证。

chap：认证方式为CHAP。

pap：认证方式为PAP。

user username：认证用户名，由运营商提供。为1～32个字符的字符串，区分大小写。

password password：认证密码，由运营商提供。为1～32个字符的字符串，区分大小写。

【使用指导】

本命令用于在3G Modem上创建参数模板。

参数模板可以配置接入点和认证方式，3G Modem会根据配置的接入点和认证方式，来和对应的服务商进行认证：

·     当选用None方式时，不需要输入用户名和密码。

·     当选用CHAP或PAP方式时，需要根据运营商的要求，选择配置用户名和密码，其中username字段是必选的，而password字段是可选的。

【举例】

# 创建3G Modem的参数模板1，指定的接入点名称为cmnet，认证方式采用PAP。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] profile create 1 static cmnet authentication-mode pap user abc password abc

【相关命令】

·     display cellular

·     profile delete

1.2.3  profile delete

profile delete命令用来删除3G Modem的参数模板。

【命令】

profile delete profile-number

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

profile-number：3G Modem的参数模板编号。

【举例】

# 删除3G Modem的参数模板1。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] profile delete 1

【相关命令】

·     display cellular

·     profile create

1.2.4  profile main

profile main命令用来配置3G Modem拨号使用的主备参数模板。

undo profile main命令用来恢复缺省情况。

【命令】

profile main main-profile-number backup backup-profile-number

undo profile main

【缺省情况】

3G Modem使用参数模板1进行拨号。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

main-profile-numbe：主参数模板索引。不同型号的3G Modem设备支持的取值范围不同，请以设备的实际情况为准。

backup backup-profile-number：备份参数模板索引。不同型号的3G Modem设备支持的取值范围不同，请以设备的实际情况为准。

【使用指导】

配置profile main命令后，3G Modem每次拨号都优先选择主参数模板，如果主参数模板拨号失败，将使用备份参数模板进行拨号。无论备份参数模板拨号是否成功，下次拨号时都使用主参数模板拨号。

需要注意的是：

使用的主备参数模板的用户名和密码必须配成一样的。

本命令的配置会在下次拨号时生效，不会影响当前的拨号结果。

【举例】

# 配置3G Modem拨号使用主参数模板1，备份参数模板2。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] profile main 1 backup 2

1.2.5  serial-set

serial-set命令用来将Cellular接口通道化出同/异步串口。

undo serial-set命令用来将Cellular接口通道化出的同/异步串口删除。

【命令】

serial-set set-number

undo serial-set set-number

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

set-number：通道化出的串口的编号。

【使用指导】

Cellular接口在配置该命令后通道化出一个Serial接口，接口名是serial cellular-number:set-number。

【举例】

# 将接口Cellular2/4/0通道化出一个Serial接口。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] serial-set 0

1.2.6  wcdma band

wcdma band命令用来配置3G/4G Modem接入WCDMA网络的工作频段。

undo wcdma band命令用来恢复缺省情况。

【命令】

wcdma band { wcdma800 | wcdma850 | wcdma900 | wcdma1700ip | wcdma1700us | wcdma1800 | wcdma1900 | wcdma2100 | wcdma2600 }

undo wcdma band

【缺省情况】

未配置3G/4G Modem接入WCDMA网络的工作频段。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

wcdma800：使用WCDMA 800MHz频段。

wcdma850：使用WCDMA 850MHz频段。

wcdma900：使用WCDMA 900MHz频段。

wcdma1700jp：使用日本WCDMA 1700MHz频段。

wcdma1700us：使用美国WCDMA 1700MHz频段。

wcdma1800：使用WCDMA 1800MHz频段。

wcdma1900：使用WCDMA 1900MHz频段。

wcdma2100：使用WCDMA 2100MHz频段。

wcdma2600：使用WCDMA 2600MHz频段。

【使用指导】

本命令仅Sierra的4G模块MC7354的ATT版本和MC7304支持。

WCMDA网络可以提供多种频段供用户接入。3G/4G Modem通过Cellular接口接入WCDMA网络后，当WCDMA网络频段发生变化时，3G/4G Modem会自动调整工作频段来适应网络环境的变化，从而影响3G链路的稳定性。为了避免因网络频段变化引起的3G链路不稳定，用户可以手动配置3G/4G Modem接入的WCDMA网络的工作频段。

【举例】

# 配置3G/4G Modem接入WCDMA网络的工作频段为wcdma1700。

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] wcdma band wcdma1700

【相关命令】

·     gsm band

·     lte band

1.3  4G/5G Modem管理专用配置命令

1.3.1  apn

apn命令用来配置接入4G/5G网络时的接入点。

undo apn命令用来删除接入4G/5G网络时的接入点。

【命令】

apn { dynamic | static apn }

undo apn

【缺省情况】

未配置接入4G/5G网络时的接入点。

【视图】

4G/5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

dynamic：动态接入点，接入点名称在拨号协商时由运营商分配。

static apn：指定的由运营商提供的接入点名称，为1～100个字符的字符串，是否大小写敏感和运营商有关。

【使用指导】

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 为4G/5G Modem参数模板test配置静态接入点apn1。

<Sysname> system-view

[Sysname] apn-profile test

[Sysname-apn-profile-test] apn static apn1

【相关命令】

·     apn-profile

1.3.2  apn-profile

apn-profile命令用来创建4G/5G Modem参数模版。

undo apn-profile命令用来删除4G/5G Modem参数模版。

【命令】

apn-profile profile-name

undo apn-profile profile-name

【缺省情况】

未配置4G/5G Modem参数模版。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

profile-name：参数模版的名称。

【使用指导】

当4G/5G Modem参数模版关联了4G/5G接口时，参数模版的配置才会起作用。当需要删除4G/5G参数模版时，必须先删除所有与4G/5G接口的关联。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 创建4G/5G Modem参数模版test。

<Sysname> system-view

[Sysname] apn-profile test

【相关命令】

·     apn-profile apply

1.3.3  apn-profile apply

apn-profile apply命令用来指定接口使用的4G/5G Modem参数模板。

undo apn-profile apply命令用来恢复缺省情况。

【命令】

apn-profile apply profile-name [ backup profile-name [ dial-retry retry-count ] ]

undo apn-profile apply

【缺省情况】

未指定接口使用的4G/5G Modem参数模板。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

profile-name：参数模板的名称。

backup profile-name：指定备份的4G/5G Modem参数模板。

dial-retry retry-count：主参数模板拨号重试次数，取值范围为1～255。使用主参数模板拨号失败次数达到本参数指定的次数后，移动通信Modem才使用备份参数模板进行拨号。retry-count的缺省值为3。

【使用指导】

配置apn-profile apply命令后，4G/5G Modem将使用4G/5G Modem参数模板中配置的拨号参数与运营商核心网设备进行协商。

当配置了备份4G/5G Modem参数模板时，4G/5G Modem使用主参数模板拨号失败，将使用备份参数模板进行拨号。无论备份参数模板拨号是否成功，下次拨号时仍使用主参数模板进行拨号。

本命令的配置会在下一次拨号时生效，不影响当前的拨号结果。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置主4G/5G Modem参数模板为test，备份4G/5G Modem参数模板为bktest。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] apn-profile apply test backup bktest

【相关命令】

·     apn-profile

1.3.4  attach-format imsi-sn split

attach-format imsi-sn split命令用来配置IMSI/SN捆绑协商认证时发送用户名使用的分隔符。

undo attach-format imsi-sn split命令用来恢复缺省情况。

【命令】

attach-format imsi-sn split splitchart [ sn-lenth sn-lenth ]

undo attach-format imsi-sn split

【缺省情况】

未配置IMSI/SN捆绑协商认证时发送用户名使用的分隔符。

【视图】

4G/5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

split splitchart：配置IMSI/SN捆绑协商认证时用户名发送使用的分隔符。splitchart表示分隔符，长度为1个字符，可以为字母、数值或%、#等符号。

sn-lenth sn-lenth：配置IMSI/SN捆绑协商认证时SN号的截取长度，sn-lenth表示SN号的截取长度，取值为10或20，缺省值为20。

【使用指导】

如果设置splitchart参数为#，则发送用户名的格式为imsiinfo#sninfo#username。

IMSI/SN捆绑协商认证时截取的SN号长度为SN号后几位，例如配置sn-lenth取值为10，则表示截取SN号的后10位。当本功能配合H3C iMC PLAT智能管理平台一起使用时，被截取的SN号会填充到接入服务菜单栏中的“sninfo字段”配置项处。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置协商认证时发送用户名使用的分隔符为为#，SN号的截取长度为10。

<Sysname> system-view

[Sysname] apn-profile test

[Sysname-apn-profile-test] attach-format imsi-sn split # sn-lenth 10

【相关命令】

·     apn-profile

1.3.5  authentication-mode

authentication-mode命令用来配置接入4G/5G网络时的认证方式。

undo authentication-mode命令用来删除接入4G/5G网络时的认证方式。

【命令】

authentication-mode { pap | chap | pap-chap } user user-name password { cipher | simple } string

undo authentication-mode

【缺省情况】

认证方式为不认证。

【视图】

4G/5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

chap：认证方式为CHAP。

pap：认证方式为PAP。

pap-chap：认证方式为PAP或CHAP。

user-name：认证用户名，为1～80个字符的字符串，区分大小写。

cipher：以密文方式设置密码。

simple：以明文方式设置密码，该密码将以密文形式存储。

string：密码字符串，区分大小写。明文密码为1～32个字符的字符串，密文密码为1～73个字符的字符串。

【使用指导】

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 为4G/5G Modem参数模板指定认证方式为CHAP，认证用户名为user1，密码为123456。

<Sysname> system-view

[Sysname] apn-profile test

[Sysname-apn-profile-test] authentication-mode chap user user1 password simple 123456

【相关命令】

·     apn-profile

1.3.6  bandwidth

bandwidth命令用来配置接口的期望带宽。

undo bandwidth命令用来恢复缺省情况。

【命令】

bandwidth bandwidth-value

undo bandwidth

【缺省情况】

接口的期望带宽＝接口的波特率÷1000（kbit/s）。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

bandwidth-value：表示接口的期望带宽，取值范围为1～400000000，单位为kbit/s。

【使用指导】

接口的期望带宽会影响链路开销值，具体介绍请参见“三层技术-IP路由配置指导”中的“OSPF“OSPFv3”和“IS-IS”。

【举例】

# 设置以太网通道接口Eth-channel2/4/0:0的期望带宽为1000 kbit/s。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] bandwidth 1000

1.3.7  default

default命令用来恢复当前接口的缺省配置。

【命令】

default

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【使用指导】

接口下的某些配置恢复到缺省情况后，会对设备上当前运行的业务产生影响。建议您在执行该命令前，完全了解其对网络产生的影响。

您可以在执行default命令后通过display this命令确认执行效果。对于未能成功恢复缺省的配置，建议您查阅相关功能的命令手册，手工执行恢复该配置缺省情况的命令。如果操作仍然不能成功，您可以通过设备的提示信息定位原因。

【举例】

# 将以太网通道接口Eth-channel2/4/0:0恢复为缺省配置。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] default

1.3.8  description

description命令用来设置当前接口的描述信息。

undo description命令用来恢复缺省情况。

【命令】

description text

undo description

【缺省情况】

接口的描述信息为“该接口的接口名 Interface”，比如“Echannel2/4/0:0 Interface”。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

text：接口描述信息，为1～255个字符的字符串，区分大小写。

【使用指导】

可以根据需要修改接口的描述。

修改后的描述信息会在display interface显示的接口信息中体现。

【举例】

# 设置以太网通道接口Eth-channel2/4/0:0的描述信息为“Echannel-interface”。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] description Echannel-interface

1.3.9  display interface eth-channel

display interface eth-channel命令用来显示以太网通道接口的相关信息。

【命令】

display interface [ eth-channel [ channel-id ] ] [ brief [ description | down ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

channel-id：以太网通道接口的编号。

brief：显示接口的概要信息。不指定该参数时，将显示接口的详细信息。

description：用来显示用户配置的接口的全部描述信息。如果某接口的描述信息超过27个字符，不指定该参数时，只显示描述信息中的前27个字符，超出部分不显示；指定该参数时，可以显示全部描述信息。

down：显示当前物理状态为down的接口的信息以及down的原因。不指定该参数时，将不会根据接口物理状态来过滤显示信息。

【使用指导】

如果不指定eth-channel参数，将显示设备支持的所有接口的相关信息；

如果指定eth-channel参数，不指定channel-id参数，将显示所有已通道化的以太网通道接口的相关信息。

【举例】

#显示以太网通道接口Eth-channel2/4/0:0的详细信息。

<Sysname> display interface eth-channel 2/4/0:0

Echannel2/4/0:0

Current state: DOWN

Line protocol state: DOWN

Description: Echannel2/4/0:0 Interface

Bandwidth: 100000kbps

Maximum Transmit Unit: 1500

Internet protocol processing: disabled

IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 000c-2963-b75d

IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 000c-2963-b75d

Output queue - Urgent queuing: Size/Length/Discards 0/100/0

Output queue - Protocol queuing: Size/Length/Discards 0/500/0

Output queue - FIFO queuing: Size/Length/Discards 0/75/0

Last link flapping: Never

Last clearing of counters: Never

Last 300 seconds input rate 0.00 bytes/sec, 0.00 packets/sec

Last 300 seconds output rate 0.00 bytes/sec, 0.00 packets/sec

Input: 0 packets, 0 bytes, 0 buffers

Output:0 packets, 0 bytes

# 显示以太网通道接口Eth-channel2/4/0:0的概要信息。

<Sysname> display interface eth-channel 2/4/0:0 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

Echannel2/4/0:0      UP   UP(s)    192.168.80.239

# 显示当前物理状态为down的以太网通道接口的信息以及down的原因。

<Sysname> display interface eth-channel brief down

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

Echannel2/4/0:0      ADM  Administratively

表1-10 display interface eth-channel命令显示信息描述表

字段

描述

Current state

接口当前的物理状态和管理状态，可能的取值及含义如下：

·     Administratively DOWN：表示该接口已经通过shutdown命令被关闭，即管理状态为关闭

·     DOWN：表示该接口的管理状态为开启，但物理状态为关闭（可能因为没有物理连线或者线路故障）

·     UP：该接口的管理状态和物理状态均为开启

Line protocol state

接口的链路层协议状态，由链路层经过参数协商决定，取值为：

·     UP：表示数据链路层协议状态为开启

·     DOWN：表示数据链路层协议状态为关闭

·     UP(spoofing)：表示该接口的数据链路层协议状态为开启，但实际可能没有对应的链路，或者所对应的链路不是永久存在而是按需建立。通常NULL、LoopBack等接口会具有该属性

Description

接口的描述信息

Bandwidth

接口的期望带宽

Maximum Transmit Unit

接口允许通过的最大传输单元

Internet address: ip-address/mask-length (Type)

接口IP地址。Type表示地址获取方式，取值如下：

·     Primary：手动配置的主地址

·     Sub：手动配置的从地址。当配置了主地址时，仅显示主地址；仅配置从地址时，才显示本信息

·     DHCP-allocated：通过DHCP获取的IP地址，详细介绍请参见“三层技术-IP业务配置指导”中的“DHCP”

·     BOOTP-allocated：通过BOOTP获取的IP地址，详细介绍请参见“三层技术-IP业务配置指导”中的“DHCP”

·     PPP-negotiated：PPP协商过程中由Server端分配的IP地址，详细介绍请参见“二层技术-广域网接入配置指导”中的“PPP”

·     Unnumbered：借用其他接口的IP地址

·     Cellular-allocated：通过Modem私有协议获取的IP地址，详细介绍请参见“二层技术-广域网接入配置指导”中的“移动通信Modem管理”

·     MAD：成员设备上配置的MAD IP地址，详细介绍请参见“虚拟化技术配置指导”中的“IRF”

·     MTunnel：组播隧道接口的IP地址（采用的是MD源接口的IP地址），关于MD源接口的详细介绍请参见“IP组播配置指导”中的“组播VPN”

说明

Type的取值情况与接口类型有关，请以实际情况为准

Internet protocol processing: disabled

接口当前不能处理IP报文

Internet Address is 192.168.1.200/24 Primary

接口的主IP地址，此IP地址由运营商自动分配

IP Packet Frame Type，Hardware Address

IP报文发送帧格式，硬件地址

IPv6 Packet Frame Type，Hardware Address

IPv6报文发送帧格式，硬件地址

Output queue - Urgent queuing: Size/Length/Discards

输出队列的紧急队列中当前的消息数/最大可容纳的消息数/已丢弃的消息数。

Output queue - Protocol queuing: Size/Length/Discards

输出队列的协议队列中当前的消息数/最大可容纳的消息数/已丢弃的消息数。

Output queue - FIFO queuing: Size/Length/Discards

输出队列的先进先出队列中当前的消息数/最大可容纳的消息数/已丢弃的消息数。该显示信息与用户的配置有关，当配置为CBQ、WFQ等队列时则显示为CBQ/WFQ等队列的消息数。

Last link flapping

接口最近一次物理状态改变到现在的时长。Never表示接口从设备启动后一直处于down状态（没有改变过）

Last clearing of counters

最近一次使用reset counters interface命令清除接口下的统计信息的时间。如果从设备启动一直没有执行reset counters interface命令清除过该接口下的统计信息，则显示Never

Last 300 seconds input rate

最近300秒钟的平均输入速率：bytes/sec表示平均每秒输入的字节数，bits/sec表示平均每秒输入的比特数，packets/sec表示平均每秒输入的包数

Last 300 seconds output rate

最近300秒钟的平均输出速率：bytes/sec表示平均每秒输出的字节数，bits/sec表示平均每秒输出的比特数，packets/sec表示平均每秒输出的包数

Input: 0 packets, 0 bytes, 0 buffers

输入报文：报文数，字节数，缓存单元的个数

Output:0 packets, 0 bytes

输出报文：报文数，字节数

Brief information on interface(s) under route mode:

三层模式下（route）接口的概要信息，即三层接口的概要信息

Link: ADM - administratively down; Stby - standby

·     如果某接口的Link属性值为“ADM”，则表示该接口被管理员手工关闭了，需要在该接口下执行undo shutdown命令才能恢复接口本身的物理状态

·     如果某接口的Link属性值为“Stby”，则表示该接口是一个备份接口，使用display interface-backup state命令可以查看该备份接口对应的主接口

Protocol: (s) - spoofing

如果某接口的Protocol属性值中带有“(s)”，则表示该接口的数据链路层协议状态显示为UP，但实际可能没有对应的链路，或者对应的链路不是永久存在而是按需建立的

Interface

接口名称缩写

Iink

接口物理连接状态，取值可能为：

·     UP：表示接口物理上是连通的

·     DOWN：表示接口物理上不通

·     ADM：表示接口被手工关闭了，需要执行undo shutdown命令才能打开接口

·     Stby：表示该接口是一个备份接口

Protocol

接口数据链路层协议状态，取值可能为：

·     UP：表示接口的数据链路层是连通的

·     DOWN：表示接口的数据链路层不通

·     UP(s)：表示接口的数据链路层协议状态显示为UP，但实际可能没有对应的链路，或者对应的链路不是永久存在而是按需建立的

Main IP

接口主IP地址

Description

用户通过description命令给接口配置的描述信息。使用display interface brief命令，不指定description参数时，该字段最多显示27个字符；指定description参数时，可显示配置的全部描述信息

Cause

接口物理连接状态为down的原因，取值为Administratively时表示本链路被手工关闭了（配置了shutdown命令），需要执行undo shutdown命令才能恢复真实的物理状态

 

1.3.10  display sim mqtt statistics

display sim mqtt statistics命令用来显示MQTT连接的统计信息。

【命令】

display sim mqtt statistics { all | connect | connect-fail | disconnect | packet }

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

all：表示显示MQTT连接的全部统计信息。

connect：表示显示MQTT连接成功的统计信息。

connect-fail：表示显示MQTT连接失败的统计信息。

disconnect：表示显示MQTT连接断开的统计信息。

packet：表示显示MQTT报文统计信息。

【使用指导】

本命令仅移动通信5G Modem支持。

【举例】

# 显示MQTT连接的全部统计信息。

<Sysname> display sim mqtt statistics all

Connection information:

  Sever info: www.example.com

  Port: 1883

  Connected at: 2022/05/01 10:13:33

 

  Sever info: www.example.com

  Port: 8883

  SSL policy name：test-policy

  Connected at: 2022/05/01 01:24:18

 

Disconnection information:

  Sever info: www.example.com

  Port: 8883

  SSL policy name：test-policy

  Disconnected at: 2022/05/01 10:13:19

  Disconnection reason: User cleared connection settings.

 

  Sever info: www.example.com

  Port: 8883

  SSL policy name：test-policy

  Disconnected at: 2022/05/01 01:24:17

  Disconnection reason: Keepalive timed out.

 

Connection fail information:

  Connection failed at: 2022/05/01 00:33:21

  Connection fail reason: Refused by the server

 

  Connection failed at: 2022/05/01 10:23:21

  Connection fail reason: Connection to the server timed out

 

Packet statistics:

  Connect          : 4                      Connack           : 4

  Publish          : 12                     Puback            : 1

  Pubrec           : 44                     Pubrel            : 44

  Pubcomp          : 2                      Subscribe         : 2

  Suback           : 1                      Unsubscribe       : 1

  Unsuback         : 0                      Pingrep           : 0

  Pingresp         : 0                      SendDisconnect    : 0

  RecvDisconnect   : 0                       RecvData         : 0

  SendData         : 20

表1-11 display sim mqtt statistics命令显示信息描述表

字段

描述

Connection information

MQTT连接成功的统计信息

Sever info

MQTT服务器域名或IP地址

Port

MQTT连接使用的服务端端口号

SSL policy-name

建立加密MQTT连接使用的SSL客户端策略

Connected at

设备与MQTT服务器建立连接成功的时间

Disconnection information

MQTT连接断开的统计信息

Disconnected at

设备与MQTT服务器连接断开的时间

Disconnection reason

设备与MQTT服务器连接断开的原因，包含：

·     Keepalive timed out：保活超时

·     User cleared connection settings：用户主动关闭了MQTT连接

·     Server sent disconnect packet：MQTT服务端发送断开连接信息

·     Memory usage alert：内存资源不足导致连接关闭

Connection fail information

MQTT连接失败的统计信息

Connection failed at

设备与MQTT服务器建立连接失败的时间

Connection fail reason

设备与MQTT服务器建立连接失败的原因，包含：

·     Refused by the server：MQTT服务端拒绝

·     Connection to the server timed out：连接到MQTT服务端超时

·     Server sent disconnect packet：MQTT服务端发送断开连接信息

·     Memory usage alert：内存门限引起的连接关闭

Packet statistics

MQTT连接报文的统计信息

Connect

设备向MQTT服务器发送连接请求的次数

Connack

设备收到MQTT服务器连接请求响应的次数

Publish

设备向MQTT服务器发布信息的次数

Puback

设备收到MQTT服务器发布信息响应的次数

Pubrec

设备向MQTT服务器发布消息已记录的次数

Pubrel

设备向MQTT服务器发布消息已释放的次数

Pubcomp

设备向MQTT服务器发布消息已完成的次数

Subscribe

设备向MQTT服务器订阅消息的次数

Suback

设备收到MQTT服务器订阅消息回执次数

Unsubscribe

设备向MQTT服务器取消订阅次数

Unsuback

设备收到MQTT服务器取消订阅回执次数

Pingreq

设备向MQTT服务器发送的保活心跳报文次数

Pingresp

设备收到MQTT服务器心跳确认报文的次数

SendDisconnect

设备向MQTT服务器发送终止连接次数

RecvDisconnect

设备收到MQTT服务器发送的终止连接次数

RecvData

设备从MQTT服务器收到数据报文的个数

SendData

设备向MQTT服务器发送数据报文的个数

 

【相关命令】

·     reset sim mqtt statistics

1.3.11  display sim mqtt status

display sim mqtt status命令用来显示MQTT连接的状态信息。

【命令】

display sim mqtt status

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

本命令仅移动通信5G Modem支持。

【举例】

# 显示MQTT连接的状态信息。

<Sysname> display sim mqtt status

Connection status         : Established

Reconnection interval     : 10s

Reconnection retries      : 5

Keepalive status          : Normal

Keepalive interval        : 30s

Keepalive retries         : 5

表1-12 display sim mqtt status命令显示信息描述表

字段

描述

Connection status

设备与MQTT服务器连接状态，取值包括：

·     Idle：连接未建立

·     Established：连接已建立

Connection interval

设备向MQTT服务器重新发起连接请求的时间间隔，单位为秒

Connection retries

设备向MQTT服务器重新发起连接请求的最大重发次数

Keepalive status

设备与MQTT服务器保活状态，取值包括：

·     Abnormal：连接处于非保活状态

·     Normal：连接处于保活状态

·     -：Keepalive功能未开启

Keepalive interval

设备向MQTT服务器发送Keepalive报文的时间间隔，单位为秒

Keepalive retries

设备向MQTT服务器重新发送Keepalive报文的最大重发次数

 

【相关命令】

·     sim mqtt connect

·     sim mqtt keeplive

1.3.12  display sim register

display sim register命令用来显示SIM卡的自注册信息。

【命令】

display sim register

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示SIM卡的自注册信息。

<Sysname> display sim register

ICCID: 89860312805320133131

Registration status: Succeeded

Last registration time: 2021/12/20 15:00:00

表1-13 display sim register命令显示信息描述表

字段

描述

ICCID

SIM卡的ICCID号，SIM的唯一标识符，由SIM卡厂商分配

Registration status

SIM卡自注册的状态，取值为Succeeded（仅显示自注册成功的注册信息）

Last registration time

SIM卡自注册的时间

 

【相关命令】

·     sim register enable

1.3.13  eth-channel

eth-channel命令用来将Cellular接口通道化出以太网通道接口。

undo eth-channel命令用来将Cellular接口通道化出的以太网通道接口删除。

【命令】

eth-channel channel-number

undo eth-channel channel-number

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

channel-number：通道化出的以太网通道接口编号。

【使用指导】

Cellular接口在配置该命令后通道化出一个以太网通道接口，接口名是eth-channel cellular-number:channel-number。

【举例】

# 将接口Cellular2/4/0通道化出一个以太网通道接口。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] eth-channel 0

1.3.14  interface eth-channel

interface eth-channel命令用来进入以太网通道接口视图。

【命令】

interface eth-channel interface-number

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface-number：以太网通道接口的编号。

【举例】

# 进入以太网通道接口Eth-channel2/4/0:0的视图。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0]

1.3.15  ip address cellular-alloc

ip address cellular-alloc命令用来配置接口通过Modem私有协议获取IP地址。

undo ip address cellular-alloc命令用来恢复缺省情况。

【命令】

ip address cellular-alloc

undo ip address cellular-alloc

【缺省情况】

接口不通过Modem私有协议获取IP地址。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【使用指导】

ip address cellular-alloc与ip address dhcp-alloc命令用于设置接口以何种方式从Modem获取接口IP地址，Modem的IP地址由运营商自动分配。

其中，ip address cellular-alloc命令是配置接口采用Modem私有协议获取IP地址，而ip address dhcp-alloc命令是配置接口采用标准DHCP协议获取IP地址。

【举例】

# 为接口Cellular2/4/0创建以太网通道接口，并采用Modem私有协议获取运营商自动分配的IP地址。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] eth-channel 0

[Sysname-Cellular2/4/0] quit

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] ip address cellular-alloc

1.3.16  ipv6 address cellular-alloc

ipv6 address cellular-alloc命令用来配置接口通过Modem私有协议获取IPv6地址。

undo ipv6 address cellular-alloc命令用来恢复缺省情况。

【命令】

ipv6 address cellular-alloc [ prefix-number ]

undo ipv6 address cellular-alloc

【缺省情况】

接口不通过Modem私有协议获取IPv6地址。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

prefix-number：指定生成的Cellular管理前缀的编号，取值范围为1～1024。

【使用指导】

ipv6 address cellular-alloc与ipv6 address dhcp-alloc命令用于设置接口以何种方式从Modem获取接口IPv6地址，Modem的IPv6地址由运营商自动分配。

其中，ipv6 address cellular-alloc命令是配置接口采用Modem私有协议获取IPv6地址，而ipv6 address dhcp-alloc命令是配置接口采用标准DHCP协议获取IPv6地址。

当配置接口通过Modem私有协议获取IPv6地址时，如果指定了IPv6前缀编号，则接口将在获取IPv6地址的同时，提取该IPv6地址的前64位作为Cellular管理前缀，并以指定的编号标识。设备可通过执行ipv6 address prefix-number命令引用该管理前缀生成接口地址，并将前缀分配给下连的其他设备。

在使用Cellular管理前缀的场景中，网络管理员需要注意Cellular接口上已经生效的IPv6地址，提前规划IPv6地址的使用范围，避免发生IPv6地址冲突从而导致功能不生效。

【举例】

# 为接口Cellular2/4/0创建以太网通道接口，并采用Modem私有协议获取运营商自动分配的IPv6地址。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] eth-channel 0

[Sysname-Cellular2/4/0] quit

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] ipv6 address cellular-alloc

# 为接口Cellular2/4/0创建以太网通道接口，并采用Modem私有协议获取运营商自动分配的IPv6地址，同时生成Cellular管理前缀1。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] eth-channel 0

[Sysname-Cellular2/4/0] quit

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] ipv6 address cellular-alloc 1

【相关命令】

·     ip address cellular-alloc

·     ipv6 address prefix-number（三层技术-IP业务命令参考/IPv6基础）

1.3.17  lte band

lte band命令用来配置LTE模块工作的频段。

undo lte band命令用来恢复缺省情况。

【命令】

lte band band-number

undo lte band

【缺省情况】

本命令的缺省情况与4G Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

band-number：LTE频段号。不同4G模块支持的频段号不同，请以设备的实际情况为准。

【使用指导】

本命令仅Sierra的MC7354和MC7304，龙尚的U8300C、U8300W和U8300，以及启基的DM11-2等4G模块支持。

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 为接口Cellular2/4/0配置选择3频段。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Controller-Cellular2/4/0] lte band 3

【相关命令】

·     gsm band

·     wcdma band

1.3.18  mtu

mtu命令用来配置接口的MTU（Maximum Transmission Unit，最大传输单元）值。

undo mtu命令用来恢复缺省情况。

【命令】

mtu size

undo mtu

【缺省情况】

接口的MTU值为1500字节。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

size：接口的MTU值，单位为字节。

【举例】

# 配置以太网通道接口Eth-channel2/4/0:0的MTU值为1430字节。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] mtu 1430

1.3.19  nr band

nr band命令用来配置5G NR模块工作的频段。

undo nr band命令用来恢复缺省情况。

【命令】

nr band nr-band-number

undo nr band

【缺省情况】

本命令的缺省情况与5G Modem设备的型号有关，请以设备的实际情况为准。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

nr-band-number：表示5G NR模块工作的频段号。不同5G模块支持的频段号不同，请以设备的实际情况为准。

【使用指导】

本命令仅移动通信5G Modem模块支持。

【举例】

# 为接口Cellular2/4/0配置选择3频段。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Controller-Cellular2/4/0] nr band n3

【相关命令】

·     gsm band

·     wcdma band

·     lte band

1.3.20  nr mode

nr mode命令用来配置5G Modem注册5G NR（New Radio，新空口）网络的网络模式。

undo nr mode命令用来恢复缺省情况。

【命令】

nr mode { nsa | sa | auto }

undo nr mode

【缺省情况】

5G Modem注册5G NR网络的网络模式为auto。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

nsa：设置5G Modem注册nsa模式的5G NR网络。

sa：设置5G Modem注册sa模式的5G NR网络。

auto：设置5G Modem优先注册sa模式的5G NR网络，无sa模式的5G NR网络时，则注册nsa模式的5G NR网络。

【使用指导】

本命令支持情况与设备的型号有关，请以设备的实际情况为准。

【举例】

# 配置5G Modem注册nsa模式的5G NR网络。

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] nr mode nsa

【相关命令】

·     nr band

1.3.21  pdp-type

pdp-type命令用来配置PDP协议的数据负载类型。

undo pdp-type命令用来恢复缺省情况。

【命令】

pdp-type { ipv4 | ipv6 | ipv4v6 }

undo pdp-type

【缺省情况】

PDP协议的数据负载类型为IPv4和IPv6。

【视图】

apn-profile视图

【缺省用户角色】

network-admin

【参数】

ipv4：PDP协议的数据负载类型为IPv4。

ipv6：PDP协议的数据负载类型为IPv6。

ipv4v6：PDP协议的数据负载类型为IPv4和IPv6。

【使用指导】

通过USB 4G Modem模块接入移动通信网络的设备不支持本命令。

【举例】

# 配置PDP协议的数据负载类型为IPv4。

<Sysname> system-view

[Sysname] apn-profile 1

[Sysname-apn-profile-1] pdp-type ipv4

1.3.22  reset counters interface

reset counters interface命令用来清除以太网通道接口的统计信息。

【命令】

reset counters interface [ eth-channel [ channel-id ] ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

eth-channel：清除以太网通道接口的统计信息。

channel-id：以太网通道接口的编号。

【使用指导】

在某些情况下，需要统计一定时间内某接口的流量，这就需要在统计开始前清除该接口原有的统计信息，重新进行统计。

·     如果不指定eth-channel和channel-id，则清除所有接口的统计信息；

·     如果指定eth-channel而不指定channel-id，则清除所有以太网通道接口的统计信息；

·     如果同时指定eth-channel和channel-id，则清除指定以太网通道接口的统计信息。

【举例】

# 清除以太网通道接口Eth-channel2/4/0:0的统计信息。

<Sysname> reset counters interface eth-channel 2/4/0:0

1.3.23  reset sim mqtt statistics

reset sim mqtt statistics命令用来清除MQTT连接的统计信息。

【命令】

reset sim mqtt statistics { all | connect | connect-fail | disconnect | packet }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

all：表示清除MQTT连接的全部统计信息。

connect：表示清除MQTT连接成功的统计信息。

connect-fail：表示清除MQTT连接失败的统计信息。

disconnect：表示清除MQTT连接断开的统计信息。

packet：表示清除MQTT连接的报文统计信息。

【使用指导】

本命令仅移动通信5G Modem支持。

【举例】

# 清除MQTT连接的全部统计信息。

<Sysname> reset sim mqtt statistics all

【相关命令】

·     display sim mqtt statistics

1.3.24  shutdown

shutdown命令用来关闭以太网通道接口。

undo shutdown命令用来打开以太网通道接口。

【命令】

shutdown

undo shutdown

【缺省情况】

缺省情况下，以太网通道接口为开启状态。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【举例】

# 关闭以太网通道接口Eth-channel2/4/0:0。

<Sysname> system-view

[Sysname] interface eth-channel 2/4/0:0

[Sysname-Eth-channel2/4/0:0] shutdown

1.3.25  sim mqtt client

sim mqtt client命令用来配置MQTT客户端的Client ID和认证密码。

undo sim mqtt client命令用来恢复缺省情况。

【命令】

sim mqtt client client-id client-id password { ciphertext | plaintext } string

undo sim mqtt client

【缺省情况】

未指定MQTT客户端的Client ID和认证密码。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

client-id client-id：设置MQTT客户端ID，为1～128个字符的字符串，区分大小写。

password：设置MQTT客户端的认证密码。

ciphertext：以密文方式设置密码。

plaintext：以明文方式设置密码，该密码将以密文形式存储。

string：密码字符串，区分大小写。明文密码为1～63个字符的字符串，密文密码为1～117个字符的字符串。

【使用指导】

通过配置本命令可以将设备与在第三方平台上创建的客户端信息进行绑定，当设备与第三方平台建立通信时，第三方平台会对MQTT客户端ID和认证密码验证，验证通过后，设备可以作为MQTT客户端接收第三方平台的网管指令、并向第三方平台发布数据信息。

【举例】

# 配置MQTT客户端的Client ID为168875671，并以明文方式设置认证密码为hello12345。

<Sysname> system-view

[Sysname] sim mqtt client client-id 168875671 password plaintext hello12345

1.3.26  sim mqtt connect

sim mqtt connect命令用来建立MQTT连接。

undo sim mqtt connect命令用来断开MQTT连接。

【命令】

sim mqtt connect [ interval interval ] [ retry retries ]

undo sim mqtt connect

【缺省情况】

设备不会与MQTT服务器建立MQTT连接。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval interval：指定重新发起连接的时间间隔，取值范围为0～3600，单位为秒，缺省值为60秒。

retry retries：指定重新发起连接的最大次数，取值范围为1～255次，缺省值为3次。

【使用指导】

配置本命令后，设备作为MQTT客户端会立即尝试向MQTT服务器建立MQTT连接。当设备尝试建立连接失败后，设备会创建一个MQTT连接重连计数器，对向MQTT服务器重复发起的建立连接次数进行计数。

·     若设备在达到重新发起连接的最大次数前，与MQTT服务器建立连接成功，则设备会清除设备中记录的重连计数。

·     若设备在达到重新发起连接的最大次数时，仍未与MQTT服务器建立连接，则宣告建立连接失败，不再尝试建立连接。请检查MQTT服务器的IP地址、域名等配置，重新使用本命令建立连接。

本命令仅移动通信5G Modem支持。

【举例】

# 建立MQTT连接，并指定连接失败后重新发起连接的时间间隔为5秒，重新发起连接的最大次数为10次。

<Sysname> system-view

[Sysname] sim mqtt connect interval 5 retry 10

1.3.27  sim mqtt data-format

sim mqtt data-format命令用来配置MQTT数据报文的解析和封装格式。

undo sim mqtt data-format命令用来恢复缺省情况。

【命令】

sim mqtt data-format format

undo sim mqtt data-format

【缺省情况】

未指定MQTT数据报文解析和封装格式。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

format：表示MQTT报文的解析和封装格式。当前仅支持取值为aiot（天翼智能物联网），表示设备将按照天翼平台支持的报文格式解析和封装报文。

【使用指导】

设备作为MQTT客户端与作为MQTT服务端的第三方平台建立通信并交互MQTT报文时，第三方平台会按照自身所支持的报文格式封装MQTT报文，若MQTT客户端无法识别和处理第三方平台发送的MQTT报文，则无法建立通信。通过配置本命令可以使设备按照指定的报文格式处理和发送MQTT报文，以便于能成功和第三方平台建立通信。

【举例】

# 配置MQTT数据报文的解析和封装格式为aiot，表示设备将按照天翼智能物联网平台支持的报文格式解析和封装报文。

<Sysname> system-view

[Sysname] sim mqtt data-format aiot

1.3.28  sim mqtt keepalive

sim mqtt keepalive命令用来开启MQTT连接的Keepalive功能。

undo sim mqtt keepalive命令用来关闭MQTT连接的Keepalive功能。

【命令】

sim mqtt keepalive [ interval interval ] [ retry retries ]

undo sim mqtt keepalive

【缺省情况】

设备对MQTT连接的Keepalive功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval interval：指定Keepalive报文发送的时间间隔，取值范围为1～65535，单位为秒，缺省值为180秒。

retry retries：指定Keepalive报文重发的最大次数，取值范围为1～255次，缺省值为3次。

【使用指导】

为方便MQTT客户端和MQTT服务器之间随时交互信息，MQTT连接建立后，可以通过配置本命令在MQTT客户端和MQTT服务器之间交互Keepalive报文来维持MQTT连接。

MQTT客户端按照指定的时间间隔向MQTT服务器发送Keepalive报文，MQTT服务器收到Keepalive报文后回复响应报文。当设备未收到MQTT服务器回复的响应报文时，设备会创建一个MQTT连接保活计数器，对向MQTT服务器重复发送的Keepalive报文进行计数。

·     若设备在达到Keepalive报文最大重发次数前，成功接收到MQTT服务器回复的响应报文，则设备会删除保活计数器。

·     若设备在达到Keepalive报文最大重发次数时，仍未收到MQTT服务器回复的响应报文，则认为与MQTT服务器的连接中断，不再发送Keepalive报文，并断开该MQTT连接。在MQTT连接断开后，需要重新配置sim mqtt connect命令尝试与MQTT服务器重新建立连接。

本命令仅移动通信5G Modem支持。

【举例】

# 配置向MQTT服务器保活的时间为30秒，失败情况下重发5次。

<Sysname> system-view

[Sysname] sim mqtt keepalive interval 30 retry 5

1.3.29  sim mqtt server

sim mqtt server命令用来配置MQTT服务器参数。

undo sim mqtt server命令用来恢复缺省情况。

【命令】

sim mqtt server { hostname name | ip ipv4-address | ipv6 ipv6-address } [ ssl-client-policy policy-name ]

undo sim mqtt server

【缺省情况】

未配置MQTT服务器参数。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

hostname name：指定MQTT服务器的主机名，为1～253个字符的字符串，不区分大小写，字符串中可以包含字母、数字、“-”、“_”和“.”。

ip ipv4-address：指定MQTT服务器的IPv4地址，点分十进制格式。

ipv6 ipv6-address：指定MQTT服务器的IPv6地址。

ssl-client-policy policy-name：指定设备和MQTT服务器建立MQTT连接时使用的SSL客户端策略，为1～31个字符的字符串，不区分大小写。如果不指定本参数，表示MQTT客户端使用非加密方式与MQTT服务器建立连接。

【使用指导】

本命令仅移动通信5G Modem支持。

MQTT客户端与MQTT服务器可以建立非加密的MQTT连接或者基于SSL安全协议的加密MQTT连接：

·     非加密连接使用的服务器端端口号为1883，缺省建立的为非加密MQTT连接。

·     加密连接使用的服务器端端口号为8883，建立加密MQTT连接时，设备将作为SSL客户端，需要配置与SSL服务端（MQTT服务器）相对应的SSL客户端安全策略才能建立连接。有关SSL客户端策略的详细介绍，请参见“安全配置指导”中的“SSL”。

执行undo sim mqtt server命令后，若存在已经建立的MQTT连接，会同时断开该连接。

【举例】

# 配置MQTT服务器的域名为www.example.com。

<Sysname> system-view

[Sysname] sim mqtt server hostname www.example.com

1.3.30  sim register enable

sim register enable命令用来开启SIM卡自注册功能。

undo sim register enable命令用来关闭SIM卡自注册功能。

【命令】

sim register enable

undo sim register enable

【缺省情况】

自注册功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启SIM卡自注册功能后，如果有新SIM卡插入设备，设备会在五分钟内向运营商注册管理服务器发送注册请求，向运营商注册管理服务器上报设备信息和SIM信息等。

·     如果注册成功，设备会保存当前SIM卡的ICCID和成功注册时间，并以30天为周期重新注册。

·     如果注册失败，设备会保存当前SIM卡的ICCID和注册失败时间，并以1小时为周期向运营商注册管理服务器发送注册请求，直到注册成功，或者连续10次注册失败，才停止发送。

本功能仅5G Modem支持。

【举例】

# 开启SIM卡自注册功能。

<Sysname> system-view

[Sysname] sim register enable

【相关命令】

·     sim register server

1.3.31  sim register server

sim register server命令用来配置运营商注册管理服务器的IP地址或域名。

undo sim register server命令用来恢复缺省情况。

【命令】

sim register server { hostname name | ipv4 ipv4-address | ipv6 ipv6-address } [ port port-number ]

undo sim register server

【缺省情况】

未配置运营商注册管理服务器的IP地址和域名。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

hostname name：指定运营商注册管理服务器的域名，name表示运营商注册管理服务器的域名，如www.example.com，不区分大小写。

ipv4 ipv4-address：指定运营商注册管理服务器IPv4地址，ipv4-address表示运营商注册管理服务器的IPv4地址。

ipv6 ipv6-address：指定运营商注册管理服务器IPv6地址，ipv6-address表示运营商注册管理服务器的IPv6地址。

port port-number：指定运营商注册管理服务器侦听的端口号，port-number表示侦听的端口号，取值范围为1024～65535。缺省值为9999。

【使用指导】

配置运营商注册管理服务器的IP地址或域名，并开启SIM卡自注册功能后，若满足注册条件，例如新插入SIM卡，或者更换SIM卡，设备会向指定的运营商注册管理服务器发送注册请求，以便接受运营商注册管理服务器的管理。

本功能仅5G Modem支持。

【举例】

# 配置运营商注册管理服务器的域名为www.example.com，侦听端口号为10000。

<Sysname> system-view

[Sysname] sim register server hostname www.example.com port 10000

【相关命令】

·     display sim register

·     sim register enable

·     sim register ssl-client-policy

1.3.32  sim register ssl-client-policy

sim register ssl-client-policy命令用来配置SIM卡自注册使用的SSL客户端策略。

undo sim register ssl-client-policy命令用来恢复缺省情况。

【命令】

sim register ssl-client-policy policy-name

undo sim register ssl-client-policy

【缺省情况】

未配置SIM卡自注册使用的SSL客户端策略。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

policy-name：SSL客户端策略名，为1～31个字符的字符串，不区分大小写。

【使用指导】

在设备上配置本命令后，设备将使用SSL客户端策略指定的SSL参数建立与运营商注册管理服务器建立HTTPS连接，并通过HTTPS连接向运营商注册管理服务器发送SIM自注册请求。运营商注册管理服务器会对设备进行安全认证，当设备通过安全认证后，才可能注册成功并上报设备信息和SIM信息。有关SSL客户端策略的配置，请参见“安全配置指导”中的“SSL”。

本功能仅5G Modem支持。

【举例】

# 配置SIM卡注册使用的SSL客户端策略为policy1。

<Sysname> system-view

[Sysname] sim register ssl-client-policy policy1

【相关命令】

·     display ssl client-policy（安全命令参考/SSL）

·     ssl client-policy（安全命令参考/SSL）

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们