目  录

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 dm-port open

1.1.6 mode

1.1.7 modem reboot

1.1.8 modem response

1.1.9 pin modify

1.1.10 pin unlock

1.1.11 pin verification enable

1.1.12 pin verify

1.1.13 plmn search

1.1.14 plmn select

1.1.15 reset counters controller cellular

1.1.16 rssi

1.1.17 sendat

1.1.18 shutdown

1.1.19 sim backup enable track

1.1.20 sim switch-back enable

1.1.21 sim switch-to

1.1.22 trust-imsi

1.1.23 wcdma band

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

1.2.1 apn

1.2.2 apn-profile

1.2.3 apn-profile apply

1.2.4 attach-format imsi-sn split

1.2.5 authentication-mode

1.2.6 bandwidth

1.2.7 default

1.2.8 description

1.2.9 display interface eth-channel

1.2.10 eth-channel

1.2.11 imsi bind

1.2.12 interface eth-channel

1.2.13 ip address cellular-alloc

1.2.14 ipv6 address cellular-alloc

1.2.15 lte band

1.2.16 mtu

1.2.17 nr band

1.2.18 nr mode

1.2.19 pdp-type

1.2.20 reset counters interface

1.2.21 shutdown

 

1 移动通信Modem管理

 

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

型号	说明
MSR1008	不支持
MSR1004-G	不支持
MSR1004-G-5GCN	支持
MSR2630E-X1	支持
MSR3610E-X1、MSR3610E-X1-DP	支持
MSR3610-G-X3-DP、MSR3610-G-X3、MSR3610-G-X3-DP-DC、 MSR3610-G-X3-DC	支持
MSR3620-G-X3	支持

 

型号	说明
MSR2660-XS	不支持
MSR2680-XS	支持

 

型号	说明
MSR2600-12X-WiNet	不支持
MSR2610-13X-WiNet	支持

‌

 

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呼叫连接信息。

【举例】

# 显示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

  SIM Number Information:

    SIM Number: 0

  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-1 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卡状态为正常时显示
SIM Number Information	当前工作SIM卡卡槽号信息
SIM Number	当前工作SIM卡： ·     0：卡槽号为0的SIM卡正在工作 ·     1：卡槽号为1的SIM卡正在工作
Error Information	错误信息
IPv4 dialing failed	IPv4拨号失败： ·     0x00：IPv4拨号失败错误码 ·     N/A：无
IPv6 dialing failed	IPv6拨号失败： ·     0x00：IPv6拨号失败错误码 ·     N/A：无
GNSS Information	卫星定位信息

 

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接口的相关信息。

【举例】

# 显示接口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

Modem status: Present

DM port status: Disabled

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-2 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  dm-port open

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

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

【命令】

dm-port open

undo dm-port open

【缺省情况】

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

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 2/4/0

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

1.1.6  mode

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

【命令】

mode { auto | lte | nr| wcdma }

【缺省情况】

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

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

【使用指导】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] mode lte

1.1.7  modem reboot

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

【命令】

modem reboot

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

 

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

【举例】

# 手动重启移动通信Modem。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

[Sysname-Cellular2/4/0] modem reboot

1.1.8  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。

【举例】

# 配置系统向移动通信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.9  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码。

【举例】

# 修改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.10  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卡解锁。

【举例】

# 使用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.11  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。

·     如果关闭了移动通信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码认证功能。

【举例】

# 开启PIN码认证功能。

<Sysname> system-view

[Sysname] controller cellular 2/4/0

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

【相关命令】

·     pin unlock

·     pin verify

1.1.12  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码认证。

【举例】

#  配置移动通信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.13  plmn search

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

【命令】

plmn search

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

【举例】

# 搜索移动网络。

<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-3 plmn search命令显示信息描述表

字段	描述
PLMN No	序号
MCC	移动国家编码
MNC	移动网络编码，表示运营商，比如： ·     00、02、07：表示移动 ·     01：表示联通 ·     03：表示电信
Status	移动网络的状态，其取值及含义如下： ·     Current：表示当前正在使用的网络 ·     Available：表示网络可达 ·     Forbidden：表示网络被禁止使用
Type	搜索到的移动网络类型

 

【相关命令】

·     display cellular

·     plmn select

1.1.14  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命令搜索移动网络。

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 2/4/0

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

【相关命令】

·     display cellular

·     plmn search

1.1.15  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.16  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信息。

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] rssi gsm low 110

1.1.17  sendat

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

【命令】

sendat at-string

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

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

表1-4 CNS格式报文举例

指令	说明
CNSn	控制CNS心跳检测开关 ·     n = 00000500000000000000，打开CNS心跳检测开关 ·     n = 00000800000000000000，关闭CNS心跳检测开关

 

【使用指导】

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

需要注意的是：

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

通过配置指令配置移动通信Modem后，移动通信Modem的工作状态会被改变，有可能导致移动通信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.18  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.19  sim backup enable track

sim backup enable track命令用来配置移动通信链路备份与Track项联动。

undo sim backup enable命令用来恢复缺省情况。

【命令】

sim backup enable track entry-number

undo sim backup enable

【缺省情况】

未配置移动通信链路备份与Track项联动。

【视图】

cellular接口视图

【缺省用户角色】

network-admin

【参数】

entry-number：指定Track项的序号，取值范围为1～1024。

【使用指导】

在配置移动通信链路备份与Track项关联后，设备可以通过Track项来监测主链路的状态，根据网络环境的变化实现双卡单待的移动通信链路备份功能。当Track项从Positive变为Negative状态时，当前的移动通信链路将停用，备份的移动通信链路将启用。关于Track项的详细介绍，请参见“可靠性配置指导”中“Track”。

一条移动通信链路只能关联一个Track项。多次执行本命令，最后一次执行的命令生效。

只有当该Track项创建后，联动功能才开始生效。

【举例】

# 配置SIM0对应的接口Cellular1/0与Track项1关联。

<sysname> system

[system] controller cellular 1/0

[system-Cellular1/0] sim backup enable track 1

【相关命令】

·     sim switch-back enable

·     sim switch-to

1.1.20  sim switch-back enable

sim switch-back enable命令用来开启由备用SIM卡自动切换至主用SIM卡功能。

undo sim switch-back enable命令用来关闭由备用SIM卡自动切换至主用SIM卡功能。

【命令】

sim switch-back enable [ wait-time time ]

undo sim switch-back enable

【缺省情况】

由备用SIM卡自动切换至主用SIM卡功能处于关闭状态。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

time：由备用SIM卡自动切换至主用SIM卡的等待时间，取值范围为1～65535，单位为分钟，缺省值为60。

【使用指导】

通过本命令可以实现由备用SIM卡自动切换至主用SIM卡。如果执行了sim switch-back enable命令，则设备切换到备用SIM卡后，使用备用SIM卡工作time时间，之后自动切换回主用SIM卡。

需要注意的是，用户需要确认经过设定的时间后，主用SIM卡建立的链路能够恢复正常，否则会造成流量在主备SIM卡间频繁切换，影响业务传输。

【举例】

# 开启由备用SIM卡自动切换至主用SIM卡功能，并设置由备用SIM卡自动切换至主用SIM卡的等待时间为100分钟。

<Sysname> system-view

[Sysname] controller cellular 1/0

[Sysname-Cellular1/0] sim switch-back enable wait-time 100

1.1.21  sim switch-to

sim switch-to命令用来配置设备使用主用SIM卡或者备用SIM卡。

【命令】

sim switch-to card-number

【缺省情况】

设备使用主用SIM卡。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

card-number：SIM卡的槽位号，取值为0或者1。0表示设备使用主用SIM卡，1表示设备使用备用SIM卡。

【使用指导】

在主备双SIM卡的组网下，当主用SIM卡建立的移动通信链路信号质量差、接入的运营商网络发生故障或者主用SIM卡发生故障时，用户可以通过sim switch-to命令手动切换至备用SIM卡。

当主用SIM卡建立的移动通信链路信号质量好转、接入的运营商网络修复或更换了主用SIM卡时，用户可以通过sim switch-to命令手动切换至主用SIM卡。

需要注意的是，手动切换SIM卡时可能会造成流量的中断，影响业务传输，请谨慎操作。

【举例】

# 配置设备使用备用SIM卡。

<Sysname> system-view

[Sysname] controller cellular 1/0

[Sysname-Cellular1/0] sim switch-to 1

1.1.22  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.1.23  wcdma band

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

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

【命令】

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

undo wcdma band

【缺省情况】

未配置5G 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频段。

【使用指导】

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

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

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 0/0

[Sysname-Cellular0/0] wcdma band wcdma1700

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

1.2.1  apn

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

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

【命令】

apn { dynamic | static apn }

undo apn

【缺省情况】

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

【视图】

5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

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

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

【举例】

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

<Sysname> system-view

[Sysname] apn-profile test

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

【相关命令】

·     apn-profile

1.2.2  apn-profile

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

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

【命令】

apn-profile profile-name

undo apn-profile profile-name

【缺省情况】

未配置5G Modem参数模版。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

仅5G Modem参数模版需要通过apn-profile apply命令应用到以太网通道接口后，参数模版才会生效。若需要删除5G参数模版，必须先解除参数模板在以太网通道接口的应用。

【举例】

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

<Sysname> system-view

[Sysname] apn-profile test

【相关命令】

·     apn-profile apply

1.2.3  apn-profile apply

apn-profile apply命令用来为以太网通道接口应用5G Modem参数模板。

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

【命令】

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

undo apn-profile apply

【缺省情况】

以太网通道接口未应用5G Modem参数模板。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

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

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

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

【使用指导】

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

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

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

【举例】

# 配置主5G Modem参数模板为test，备份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.2.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

undo attach-format imsi-sn split

【缺省情况】

未配置协商认证时发送用户名使用的分隔符。

【视图】

5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 配置协商认证时发送用户名使用的分隔符为为#。

<Sysname> system-view

[Sysname] apn-profile test

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

【相关命令】

·     apn-profile

1.2.5  authentication-mode

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

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

【命令】

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

undo authentication-mode

【缺省情况】

认证方式为不认证。

【视图】

5G Modem参数模板视图

【缺省用户角色】

network-admin

【参数】

chap：认证方式为CHAP。

pap：认证方式为PAP。

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

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

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

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

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

【举例】

# 为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.2.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.2.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.2.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.2.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-5 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管理” ·     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.2.10  eth-channel

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

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

【命令】

eth-channel channel-number

undo eth-channel channel-number

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

channel-number：通道化出的以太网通道接口编号。本参数的取值范围与移动通信Modem的型号有关，请以实际情况为准。

【使用指导】

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.2.11  imsi bind

imsi bind命令用来配置本地SIM卡的IMSI与接口绑定。

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

【命令】

imsi bind interface-type interface-number

undo imsi bind

【缺省情况】

本地SIM卡的IMSI未绑定到任何接口。

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：接口类型和接口编号。目前仅支持与L2TP特性的Virtual-PPP接口绑定。

【使用指导】

5G路由器作为LAC端时，并按照L2TP的LAC-Auto-Initiated模式自动触发接入LNS时需要配置LAC端支持PPP LCP协商IMSI/SN号。配置了本地SIM卡的IMSI与Virtual-PPP接口绑定后，5G路由器发送的报文携带5G路由器的IMSI。

需要注意的是，分布式和IRF环境不支持该特性。

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

【举例】

# 配置本地SIM卡的IMSI与接口Virtual-PPP 1绑定。

<Sysname> system-view

[Sysname] controller Cellular 0/0

[Sysname-Cellular0/0] imsi bind virtual-ppp 1

1.2.12  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.2.13  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

【举例】

# 为接口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.2.14  ipv6 address cellular-alloc

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

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

【命令】

ipv6 address cellular-alloc

undo ipv6 address cellular-alloc

【缺省情况】

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

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【举例】

# 为接口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

【相关命令】

·     ip address cellular-alloc

1.2.15  lte band

lte band命令用来配置5G Modem接入LTE网络的工作频段。

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

【命令】

lte band band-number

undo lte band

【缺省情况】

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

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

band-number：LTE频段号。本参数的取值范围与移动通信Modem的型号有关，请以实际情况为准。

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 2/4/0

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

1.2.16  mtu

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

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

【命令】

mtu size

undo mtu

【缺省情况】

接口的MTU值为1500字节。

【视图】

以太网通道接口视图

【缺省用户角色】

network-admin

【参数】

size：接口的MTU值，单位为字节。本参数的取值范围与Modem的型号有关，请以实际情况为准。

【举例】

# 配置以太网通道接口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.2.17  nr band

nr band命令用来配置5G Modem接入5G NR网络的工作频段。

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

【命令】

nr band nr-band-number

undo nr band

【缺省情况】

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

【视图】

Cellular接口视图

【缺省用户角色】

network-admin

【参数】

nr-band-number：表示5G NR网络的工作频段号。本参数的取值范围与移动通信Modem的型号有关，请以实际情况为准。

【举例】

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

<Sysname> system-view

[Sysname] controller cellular 2/4/0

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

1.2.18  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

1.2.19  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。

【举例】

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

<Sysname> system-view

[Sysname] apn-profile 1

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

1.2.20  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.2.21  shutdown

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

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

【命令】

shutdown

undo shutdown

【缺省情况】

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

【视图】

以太网通道接口视图

【缺省用户角色】

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