NetEngine AR600, AR6100, AR6200, and AR6300 V300R021 Command Reference
Cellular Interface Configuration Commands
Cellular interfaces are classified into 3G cellular interface, LTE cellular interface, and 5G cellular interface.
Cellular channel interfaces are classified into 3G channel interface, LTE channel interface, and 5G channel interface.
- Support for Cellular Interfaces
- apn
- apn profile
- apn-profile
- band auto
- band gsm
- band wcdma
- band lte
- band nr
- cellular log enable
- cellular log rssi-threshold
- cellular log sinr-threshold
- cellular log rsrp-threshold
- cellular log nr-sinr-threshold
- cellular log nr-rsrp-threshold
- dialer mode ppp
- dialer-number (APN view)
- dialer timer probe-interval
- display apn-profile configuration
- diagnostics-monitor-port on
- display cellular
- display interface cellular
- display cellular encryption-algorithm
- display cellular feature
- display sms interface cellular
- display sms interface cellular statistics
- display sms send-history
- display snmp-agent trap feature-name ifmtrap all
- interface cellular
- ip address negotiate
- mode lte
- mode wcdma
- mode 5g
- modem auto-recovery track nqa
- modem auto-recovery track action
- modem auto-recovery icmp-unreachable action modem-reboot
- modem auto-recovery dial action modem-reboot fail-times
- modem auto-recovery services-unavailable action modem-reboot
- modem auto-recovery services-unavailable action sim-switch
- modem encryption-algorithm
- modem reboot
- modem peer network-route
- mtu(3G/LTE/5G)
- multi-apn enable
- packet-service recover
- pin modify
- pin unlock
- pin verification
- pin verify
- plmn search
- plmn select
- profile create
- profile delete
- profile create lte-default
- profile create lte-default sim-id
- profile delete lte-default
- profile delete lte-default sim-id
- profile create default
- profile create default sim-id
- profile delete default
- profile delete default sim-id
- reset counters cellular
- rssi-threshold
- service domain
- sim-card reboot
- sim-id
- sim switch to
- sim switch rssi-threshold
- sim switch-back enable
- sms delete interface cellular
- sms send interface cellular
- sms-pool
- sms item
- sms send-item
- sms service-center-address
- snmp-agent trap enable feature-name ifmtrap
- user
Support for Cellular Interfaces
Hardware Requirements
This section is applicable to all models. For details about differences for specific models, see the description in the corresponding section.
apn
Function
The apn command configures an APN in an APN profile.
The undo apn command deletes an APN from an APN profile.
By default, no APN is configured in an APN profile, and an APN profile name is used as an APN during dial-up.
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn-name |
Specifies an APN name. |
To obtain an APN, contact the local carrier. The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
Usage Guidelines
Usage Scenario
An APN identifies an external public data network (PDN) that users want to access, for example, the Internet or and International Mobile Subscriber (IMS) network.
You can run the apn command to configure an APN in an APN profile.
Precautions
- To obtain an APN, contact the local carrier.
- After an APN is configured, it is recorded in the modem and always exists. If the APN changes, reconfigure it.
- If you run the apn command multiple times in the same APN profile view, only the latest configuration takes effect.
apn profile
Function
The apn profile command creates an APN profile and displays the APN profile view.
The undo apn profile command deletes the created APN profile.
By default, no APN profile is created.
Parameters
Parameter |
Description |
Value |
|---|---|---|
profile-name |
Specifies the name of the APN profile. |
The value is a string of 1 to 64 with numbers, uppercase and lowercase characters and "." and "-". |
apn-profile
Function
The apn-profile command binds an APN profile to a cellular interface or cellular channel interface.
The undo apn-profile command deletes the APN profile bound to a cellular interface or cellular channel interface.
By default, no APN profile is bound to a cellular interface or cellular channel interface.
Format
apn-profile profile-name [ priority priority ] [ track nqa { admin-name test-name } &<1-2> ]
undo apn-profile profile-name
Parameters
Parameter |
Description |
Value |
|---|---|---|
profile-name |
Specifies the name of the APN profile. |
The value is a string of 1 to 64 with case-sensitive characters without spaces. |
priority priority |
Specifies the priority of the APN profile. |
The value is an integer that ranges from 1 to 255. The default value is 100. A larger value indicates a higher priority. When dual SIM cards are available, two APN profiles can be bound to a cellular interface or LTE/5G channel interface. The APN profile with a higher priority can access the LTE/5G network first. You are advised to set the priority of the APN profile bound to the master SIM card to higher than that of the APN profile bound to the backup SIM card. |
track nqa admin-name test-name |
Specifies the administrator and name of an NQA test instance. If this parameter is specified, the device performs an NQA probe on the 3G, LTE or 5G network when the dial-up initiated through a cellular interface or cellular channel interface succeeds. The device terminates the 3G, LTE or 5G link after three consecutive NQA probe failures. Additionally, you can run the dialer timer probe-interval command to set the NQA probe interval. NOTE:
The NQA test instance type must be ICMP test. To specify this parameter, configure an NQA test instance and ensure that the route from the NQA test instance to the destination is reachable. |
The value is a string of 1 to 32 case-sensitive characters without spaces. |
Usage Guidelines
Usage Scenario
After configuring an APN profile, you must bind the APN profile to a cellular interface or cellular channel interface so that the APN profile configuration takes effect on the cellular interface or cellular channel interface.
Prerequisites
Run the dialer enable-circular command to enable the circular DCC (C-DCC) function.
Precautions
After an APN profile is bound to a cellular interface or cellular channel interface, run the shutdown and undo shutdown commands or the restart command to restart the interface so that the configurations can take effect.
band auto
Function
The band auto command deletes the configured frequency band of the network and then cellular interfaces can automatically select a frequency band to connect to the network.
Usage Guidelines
Usage Scenario
The networks of network carriers can provide multiple frequency bands for user access. To delete the configured frequency band of the network so that cellular interfaces can automatically select a frequency band, run the band auto command.
Precautions
This command is valid only when the modem is installed.
When the network signal is weak, a modem is automatically migrated to another network for normal operation.
band gsm
Function
The band gsm command sets the frequency band of the GSM network that cellular interfaces are connected to.
By default, cellular interfaces automatically select a frequency band to connect to the GSM network.
Parameters
Parameter |
Description |
Value |
|---|---|---|
gsm1800 |
Indicates that the GSM network that cellular interfaces are connected to works at the 1800 MHz frequency. |
- |
gsm1900 |
Indicates that the GSM network that cellular interfaces are connected to works at the 1900 MHz frequency. |
- |
gsm850 |
Indicates that the GSM network that cellular interfaces are connected to works at the 850 MHz frequency. |
- |
gsm900 |
Indicates that the GSM network that cellular interfaces are connected to works at the 900 MHz frequency. |
- |
Usage Guidelines
Usage Scenario
GSM networks of network carriers can provide multiple frequency bands for user access. When the frequency band of a GSM network changes after cellular interfaces are connected to the GSM network, the modem automatically adjusts the frequency band accordingly, which affects stability of links.
When the frequency band of a GSM network that you access is fixed, you can run the band gsm command to set the frequency band of the GSM network that cellular interfaces are connected to. This prevents frequency band changes caused by frequency interference and ensures link stability.
Precautions
This command is valid only when the modem is installed.
5G cellular interfaces do not support this command.
Run the display cellular interface-number network command to view the Current Network Connection field and check whether cellular interfaces are connected to the GSM network.
Confirm the frequency band of the GSM network in your location with the GSM network carrier to set the optimal frequency band.
band wcdma
Function
The band wcdma command sets the frequency band of the WCDMA network that cellular interfaces are connected to.
By default, cellular interfaces automatically select a frequency band to connect to the WCDMA network.
Parameters
Parameter |
Description |
Value |
|---|---|---|
wcdma1900 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 1900 MHz frequency. |
- |
wcdma2100 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 2100 MHz frequency. |
- |
wcdma850 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 850 MHz frequency. |
- |
wcdma900 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 900 MHz frequency. |
- |
aws |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 1700/2100(US) MHz frequency. |
- |
wcdma1700 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 1700 MHz frequency. |
- |
wcdma1800 |
Indicates that the WCDMA network that cellular interfaces are connected to works at the 1800 MHz frequency. |
- |
Usage Guidelines
Usage Scenario
WCDMA networks of network carriers can provide multiple frequency bands for user access. When the frequency band of a WCDMA network changes after cellular interfaces are connected to the WCDMA network, the modem automatically adjusts the frequency band accordingly, which affects stability of links.
When the frequency band of a WCDMA network that you access is fixed, you can run the band wcdma command to set the frequency band of the WCDMA network that cellular interfaces are connected to. This prevents frequency band changes caused by frequency interference and ensures link stability.
Precautions
This command is valid only when the modem is installed.
Run the display cellular interface-number network command to view the Current Network Connection field and check whether cellular interfaces are connected to the WCDMA network.
Confirm the frequency band of the WCDMA network in your location with the WCDMA network carrier to set the optimal frequency band.
band lte
Function
The band lte command manually sets the frequency band of the LTE network that cellular interfaces are connected to.
By default, an LTE cellular interface automatically selects the frequency band of the LTE network that is connected to.
Format
band lte { band1 | band2 | band3 | band4 | band5 | band7 | band8 | band12 | band13 | band17 | band18 | band19 | band20 | band26 | band28 | band32 | band34 | band38 | band39 | band40 | band41 }*
Parameters
Parameter |
Description |
Value |
|---|---|---|
band1 |
Indicates that the frequency band of the LTE network is Band 1 (transmit: 1920 MHz to 1980 MHz; receive: 2110 MHz to 2170 MHz). |
- |
band2 |
Indicates that the frequency band of the LTE network is Band 2 (transmit: 1850 MHz to 1910 MHz; receive: 1930 MHz to 1990 MHz). |
- |
band3 |
Indicates that the frequency band of the LTE network is Band 3 (transmit: 1710 MHz to 1785 MHz; receive: 1805 MHz to 1880 MHz). |
- |
band4 |
Indicates that the frequency band of the LTE network is Band 4 (transmit: 1710 MHz to 1755 MHz; receive: 2110 MHz to 2155 MHz). |
- |
band5 |
Indicates that the frequency band of the LTE network is Band 5 (transmit: 824 MHz to 849 MHz; receive: 869 MHz to 894 MHz). |
- |
band7 |
Indicates that the frequency band of the LTE network is Band 7 (transmit: 2500 MHz to 2570 MHz; receive: 2620 MHz to 2690 MHz). |
- |
band8 |
Indicates that the frequency band of the LTE network is Band 8 (transmit: 880 MHz to 915 MHz; receive: 925 MHz to 960 MHz). |
- |
band13 |
Indicates that the frequency band of the LTE network is Band 13 (transmit: 777 MHz to 787 MHz; receive: 746 MHz to 756 MHz). |
- |
band17 |
Indicates that the frequency band of the LTE network is Band 17 (transmit: 704 MHz to 716 MHz; receive: 734 MHz to 746 MHz). |
- |
band18 |
Indicates that the frequency band of the LTE network is Band 18 (transmit: 815 MHz to 830 MHz; receive: 860 MHz to 875 MHz). |
- |
band19 |
Indicates that the frequency band of the LTE network is Band 19 (transmit: 830 MHz to 845 MHz; receive: 875 MHz to 890 MHz). |
- |
band20 |
Indicates that the frequency band of the LTE network is Band 20 (transmit: 832 MHz to 862 MHz; receive: 791 MHz to 821 MHz). |
- |
band26 |
Indicates that the frequency band of the LTE network is Band 26 (transmit: 814 MHz to 849 MHz; receive: 859 MHz to 894 MHz). |
- |
band28 |
Indicates that the frequency band of the LTE network is Band 28 (transmit: 703 MHz to 748 MHz; receive: 758 MHz to 803 MHz). |
- |
band34 |
Indicates that the frequency band of the LTE network ranges from 2010MHz to 2025MHz. |
- |
band38 |
Indicates that the frequency band of the LTE network ranges from 2570 MHz to 2620 MHz. |
- |
band39 |
Indicates that the frequency band of the LTE network ranges from 1880 MHz to 1920 MHz. |
- |
band40 |
Indicates that the frequency band of the LTE network ranges from 2300 MHz to 2400 MHz. |
- |
band41 |
Indicates that the frequency band of the LTE network ranges from 2496 MHz to 2690 MHz. |
- |
Usage Guidelines
Usage Scenario
LTE networks of network carriers can provide multiple frequency bands for user access. When the frequency band of an LTE network changes after cellular interfaces are connected to the LTE network, the LTE modem automatically adjusts the frequency band accordingly, which affects stability of links.
When the frequency band of an LTE network that you access is fixed, you can manually run the band lte command to set the frequency band of the LTE network that cellular interfaces are connected to. This prevents frequency band changes caused by frequency interference and ensures link stability.
Precautions
This command is valid only when the modem is installed.
Run the display cellular interface-number network command to view the Current Network Connection field and check the network of cellular interfaces are connected.
Confirm the frequency band of the LTE network in your location with the LTE network carrier to set the optimal frequency band.
When the modem selects a 2G/3G network, the band lte command configuration fails to be delivered if the command is run on the 1ELTE6-EA and 1ELTE-L-S interface cards.
band nr
Function
The band nr command sets the frequency band in which a cellular interface connected to the NR network operates.
By default, LTE cellular interfaces automatically select a frequency band to connect to the NR network.
Parameters
Parameter |
Description |
Value |
|---|---|---|
n1 |
Sets the frequency band in which a cellular interface connected to the NR network operates to n1 (the transmit band is 1920 MHz to 1980 MHz and the receive band is 2110 MHz to 2170 MHz). |
- |
n3 |
Sets the frequency band in which a cellular interface connected to the NR network operates to n3 (the transmit band is 1710 MHz to 1785 MHz and the receive band is 1805 MHz to 1880 MHz). |
- |
n28 |
Sets the frequency band in which a cellular interface connected to the NR network operates to n28 (the transmit band is 703 MHz to 748 MHz and the receive band is 758 MHz to 803 MHz). |
- |
n41 |
Sets the frequency band in which a cellular interface connected to the NR network operates to 2496 MHz to 2690 MHz. |
- |
n77 |
Sets the frequency band in which a cellular interface connected to the NR network operates to 3300 MHz to 4200 MHz. |
- |
n78 |
Sets the frequency band in which a cellular interface connected to the NR network operates to 3300 MHz to 3800 MHz. |
- |
n79 |
Sets the frequency band in which a cellular interface connected to the NR network operates to 4400 MHz to 5000 MHz. |
- |
Usage Guidelines
Usage Scenario
The 5G networks of carriers can provide multiple types of frequency bands for user access. When cellular interfaces connect to an NR network and the frequency band of the NR network changes, the modem automatically adjusts its operating frequency band to adapt to the changing network environment, which affects link stability.
Precautions
This command is valid only when a modem is installed.
Run the display cellular interface-number network command to check whether the cellular interface is connected to a 5G network according to the Current Network Connection field.
cellular log enable
Function
The cellular log enable command enables the WWAN log function.
The undo cellular log enable command disables the WWAN log function.
By default, the WWAN log function is enabled.
cellular log rssi-threshold
Function
The cellular log rssi-threshold command configures the received signal strength indicator (RSSI) threshold used for determining the 3G or LTE signal strength.
The undo cellular log rssi-threshold command restores the RSSI threshold used for determining the 3G or LTE signal strength to the default value.
By default, the RSSI threshold used for determining the 3G or LTE signal strength is -89 dBm.
Parameters
Parameter |
Description |
Value |
|---|---|---|
rssi-threshold |
Specifies the RSSI threshold used for determining the 3G or LTE signal strength.
|
The value is a negative integer that ranges from -110 to -60, in dBm. |
Usage Guidelines
Usage Scenario
You can run the cellular log enable command to enable the WWAN log function and view the 3G or LTE signal strength change in WWAN logs. You can run the cellular log rssi-threshold command to configure the RSSI threshold used for determining the 3G or LTE signal strength. The device records the signal strength change in logs based on the RSSI threshold.
Precautions
After enabling the WWAN log function using the cellular log enable command, run the cellular log rssi-threshold command to configure the device to record logs based on the configured RSSI threshold.
cellular log sinr-threshold
Function
The cellular log sinr-threshold command sets the signal to interference plus noise ratio (SINR) threshold used to determine the LTE signal strength.
The undo cellular log sinr-threshold command restores the default SINR threshold used to determine the LTE signal strength.
By default, the SINR threshold used to determine the LTE signal strength is 10 dB.
Parameters
Parameter |
Description |
Value |
|---|---|---|
sinr-threshold |
Sets the SINR threshold used to determine the LTE signal strength.
|
The value is an integer that ranges from 0 to 30, in dB. |
Usage Guidelines
Usage Scenario
To check the LTE signal strength change in logs, run the cellular log enable command to enable the WWAN log function first. You can then run the cellular log sinr-threshold command to set the SINR threshold used to determine the LTE signal strength. The device then records signal strength change logs based on the configured threshold.
Precautions
After the WWAN log function is enabled using the cellular log enable command, the device records logs based on the SINR threshold configured using the cellular log sinr-threshold command.
cellular log rsrp-threshold
Function
The cellular log rsrp-threshold command configures the reference signal received power (RSRP) threshold for determining the LTE signal strength.
The undo cellular log rsrp-threshold command restores the default RSRP threshold for determining the LTE signal strength.
The default RSRP threshold for determining the LTE signal strength is –125 dBm.
Parameters
Parameter |
Description |
Value |
|---|---|---|
rsrp-threshold |
Specifies the RSRP threshold for determining the LTE signal strength.
|
The value is an integer that ranges from –136 to –80, in dBm. |
Usage Guidelines
Usage Scenario
To view the LTE signal strength change through logs, run the cellular log enable command to enable the WWAN log function. You can run the cellular log rsrp-threshold command to configure the RSRP threshold for determining the LTE signal strength. Logs about signal strength changes are then generated based on the threshold.
Precautions
After the WWAN log function is enabled using the cellular log enable command, logs are generated based on the configured threshold only after the cellular log rsrp-threshold command is run.
cellular log nr-sinr-threshold
Function
The cellular log nr-sinr-threshold command sets the signal to interference plus noise ratio (SINR) threshold used to determine the NR signal strength.
The undo cellular log nr-sinr-threshold command restores the default SINR threshold used to determine the NR signal strength.
By default, the SINR threshold used to determine the NR signal strength is 10 dB.
Parameters
Parameter |
Description |
Value |
|---|---|---|
sinr-threshold |
Sets the SINR threshold used to determine the NR signal strength.
|
The value is an integer that ranges from 0 to 30, in dB. |
Usage Guidelines
Usage Scenario
To check the NR signal strength change in logs, run the cellular log enable command to enable the WWAN log function first. You can then run the cellular log nr-sinr-threshold command to set the SINR threshold used to determine the NR signal strength. The device then records signal strength change logs based on the configured threshold.
Precautions
After the WWAN log function is enabled using the cellular log enable command, the device records logs based on the SINR threshold configured using the cellular log nr-sinr-threshold command.
cellular log nr-rsrp-threshold
Function
The cellular log nr-rsrp-threshold command configures the reference signal received power (RSRP) threshold for determining the NR signal strength.
The undo cellular log nr-rsrp-threshold command restores the default RSRP threshold for determining the NR signal strength.
The default RSRP threshold for determining the NR signal strength is –125 dBm.
Parameters
Parameter |
Description |
Value |
|---|---|---|
rsrp-threshold |
Specifies the RSRP threshold for determining the NR signal strength.
|
The value is an integer that ranges from –136 to –80, in dBm. |
Usage Guidelines
Usage Scenario
To view the NR signal strength change through logs, run the cellular log enable command to enable the WWAN log function. You can run the cellular log nr-rsrp-threshold command to configure the RSRP threshold for determining the NR signal strength. Logs about signal strength changes are then generated based on the threshold.
Precautions
After the WWAN log function is enabled using the cellular log enable command, logs are generated based on the configured threshold only after the cellular log nr-rsrp-threshold command is run.
dialer mode ppp
Function
The dialer mode ppp command configures the PPP dial-up mode for the LTE modem to connect to a 3G or an LTE network.
The undo dialer mode command restores the default dial-up mode for the LTE modem to connect to a 3G or an LTE network.
By default, the LTE modem uses the standard interface defined in the network diver interface specification to connect to a 3G or an LTE network.
Only AR617VW-LTE4EA, AR617VW-LTE4, support this function.
Usage Guidelines
By default, the LTE modem uses the standard interface defined in the network diver interface specification to connect to a 3G or an LTE network. If the carrier's device only supports the PPP dial-up mode for 3G/LTE network access, you must run the dialer mode ppp command to set the dial-up mode to PPP.
Example
# Configure the PPP dial-up mode for the LTE modem to connect to a 3G or an LTE network.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] dialer mode ppp Warning: The module will reboot. Continue? [Y/N]:y Modem reboot for changing modem dialer mode May 20 2020 17:41:04+00:00 Huawei %%01IFPDT/4/MODEM_REBOOT(1)[23]:The user choose YES when there is a selection about whether to reboot modem.
dialer-number (APN view)
Function
The dialer-number command configures a dial number for calling the remote end for an APN.
The undo dialer-number command deletes a dial number configured for calling the remote end.
By default, no dial number for calling the remote end is configured.
Parameters
Parameter |
Description |
Value |
|---|---|---|
dial-number |
Specifies a dial number. |
The value is a string of 1 to 32 case-insensitive characters. |
dialer timer probe-interval
Function
The dialer timer probe-interval command sets the NQA probe interval for a cellular interface or cellular channel interface.
The undo dialer timer probe-interval command restores the default NQA probe interval.
By default, the NQA probe interval of a cellular interface or cellular channel interface is 60 seconds.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interval |
Specifies the NQA probe interval for a cellular interface or cellular channel interface. |
The value is an integer that ranges from 1 to 60, in seconds. |
display apn-profile configuration
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn-profile-number |
Specifies the number of APN profiles.
|
The value is an integer that ranges from 1 to 128. |
Usage Guidelines
To check the configurations of existing APN profiles on the device, run this command.
Example
# Display the configurations of all APN profiles on the device.
<Huawei> display apn-profile configuration -------------------------------------------------------------------------------- profile-name :unicom apn :ltenet1 user-name :user1 authentication-mode:chap sim-id :1 -------------------------------------------------------------------------------- profile-name :telcom apn :ltenet2 user-name :user2 authentication-mode:auto sim-id :2
Item |
Description |
|---|---|
profile-name |
Name of an APN profile. To create an APN profile and enter the APN profile view, run the apn profile command. |
apn |
Name of an APN. To configure an APN in an APN profile, run the apn command. |
user-name |
User name for accessing an external PDN. To configure the user name for accessing an external PDN, run the user command. |
authentication-mode |
Authentication mode for accessing an external PDN.
To configure the authentication mode for accessing an external PDN, run the user command and specify the authentication-mode parameter. When authentication-mode is not specified: null is selected by default. auto is selected by default. |
sim-id |
SIM card ID. To configure a SIM card ID in an APN profile, run the sim-id command. NOTE:
The dual-SIM function can be configured on the AR611W-LTE4CN, AR617VW-LTE4, AR617VW-LTE4EA, LTE interface card (except 1LTE-Lo and 1LTE6-EA), SIC-5G-100, and LTE cellular interface (Cellular 0/0/0). |
diagnostics-monitor-port on
Function
The diagnostics-monitor-port on command enables the MiniUSB interface on the 3G/LTE card.
The undo diagnostics-monitor-port on command disables the MiniUSB interface on the 3G/LTE card.
By default, the MiniUSB interface on the 3G/LTE card is disabled.
Usage Guidelines
Usage Scenario
After the diagnostics-monitor-port on command enables the MiniUSB interface on the 3G/LTE card, you can use the PC to implement Internet access through dialup or upgrade the module. The PC can connect to the MiniUSB interface on the 3G/LTE card through the USB line.
Precautions
The original 3G/LTE service is interrupted after the diagnostics-monitor-port on command is run.
The firmware version of the modem cannot be upgraded after the diagnostics-monitor-port on command is run.
- If the device or 3G/LTE card is reset, the diagnostics-monitor-port on command cannot take effect. You must reconfigure the command.
- The diagnostics-monitor-port on command takes effect only when there is a MiniUSB interface on the 3G/LTE card.
display cellular
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
all |
Displays all information about call sessions on a modem. The information involves hardware, parameter description profile, network, radio, and security information. |
- |
hardware |
Displays hardware information about the modem. |
- |
security |
Displays security information about the modem. |
- |
network |
Displays network information about the modem. |
- |
profile |
Displays parameter profile information about the modem. |
- |
radio |
Displays radio information about the modem. |
- |
Usage Guidelines
The display cellular command displays information about call sessions on a modem, including the modem's hardware information, parameter profile information, network information, radio information, security information or all the preceding information.
Example
<Huawei> display cellular 0/0/0 all Modem State: Hardware Information. ===================== Model = ME906E Modem Type = LTE module Modem Firmware Version = 11.833.15.00.000 Hardware Version = CD2E392UM Integrate circuit card identity (ICCID) = 98681011274300909893 International Mobile Subscriber Identity (IMSI) = 460016002731442 Mobile Station International ISDN Number (MSISDN) = 86013987654321 International Mobile Equipment Identity (IMEI) = 861230010006485 Factory Serial Number (FSN) = T2Y01A9211900298 Modem Status = Online Profile Information. ==================== Profile 1 -------- PDP Type = IPv4, Header Compression = OFF Data Compression = OFF Access Point Name (APN) = LTENET Packet Session Status = Active * - Default profile Network Information. ==================== Current Service Status = Service available Service Domain = Combined Current Service = Combined Packet Service = Attached Packet Session Status = Active Current Roaming Status = Home Network Selection Mode = Automatic Network Connection Mode = LTE only Current Network Connection = LTE(LTE) Mobile Country Code (MCC) = 460 Mobile Network Code (MNC) = 07 Mobile Operator Information = CHINA MOBILE Cell ID = 55924 Upstream Bandwidth = 50mbps Downstream Bandwidth = 100mbps Radio Information. ================== Current Bands : GSM: GSM1800 WCDMA: AUTO LTE: AUTO Current RSSI = -55 dBm Current RSRP = -86 dBm Current RSRQ = -6 dB Current SINR = 29 dB (good) Bands supported : GSM: GSM850 GSM900 GSM1800 GSM1900 WCDMA: WCDMA850 WCDMA900 WCDMA2100 WCDMA1900 LTE: LTE900 LTE2100 Modem Security Information. =========================== SIM ID=1 PIN Verification = Disabled PIN Status = Ready Number of Retries remaining = 3 SIM Status = OK
<Huawei> display cellular 0/0/0 all Modem State: Hardware Information. ===================== Model = ME906E Modem Type = LTE module Modem Firmware Version = 11.833.15.00.000 Hardware Version = CD2E392UM Integrate circuit card identity (ICCID) = 98681011274300909893 International Mobile Subscriber Identity (IMSI) = 460016002731442 Mobile Station International ISDN Number (MSISDN) = 86013987654321 International Mobile Equipment Identity (IMEI) = 861230010006485 Factory Serial Number (FSN) = T2Y01A9211900298 Modem Status = Online Profile Information. ==================== Profile 1 -------- PDP Type = IPv4, Header Compression = OFF Data Compression = OFF Access Point Name (APN) = LTENET Packet Session Status = Active * - Default profile Network Information. ==================== Current Service Status = Service available Service Domain = PS-only Current Service = PS Packet Service = Attached Packet Session Status = Active Current Roaming Status = Home Network Selection Mode = Automatic Network Connection Mode = WCDMA only Current Network Connection = WCDMA(WCDMA) Mobile Country Code (MCC) = 460 Mobile Network Code (MNC) = 07 Mobile Operator Information = CHINA MOBILE Location Area Code (LAC) = 53515 Cell ID = 55924 Upstream Bandwidth = 384kbps Downstream Bandwidth = 384kbps Radio Information. ================== Current Bands : GSM: GSM1800 WCDMA: AUTO LTE: AUTO Current RSSI = -55 dBm (good) Current RSCP = -47 dBm Current ECIO = 0 dB Bands supported : GSM: GSM850 GSM900 GSM1800 GSM1900 WCDMA: WCDMA850 WCDMA900 WCDMA2100 WCDMA1900 LTE: LTE900 LTE2100 Modem Security Information. =========================== SIM ID=1 PIN Verification = Disabled PIN Status = Ready Number of Retries remaining = 3 SIM Status = OK
# Display all information about call sessions on a 5G modem.
<Huawei> display cellular 2/0/0 all
Modem State:
Hardware Information.
=====================
Model = RG801
Modem Type = 5G module
Modem Firmware Version = RG801HEAAAR01A06M8G
Hardware Version = HiB5000_MODEM Ver.A
Integrate circuit card identity (ICCID) = 98681020100202000079
International Mobile Subscriber Identity (IMSI) = 460070075591997
Mobile Station International ISDN Number (MSISDN) = None
International Mobile Equipment Identity (IMEI) = 867147050004622
Factory Serial Number (FSN) = 0123456789ABCDEF
Modem Status = Online
Profile Information.
====================
Profile 1
--------
PDP Type = IPv4, Header Compression = OFF
Data Compression = OFF
Packet Session Status = Active
* - Default profile
Network Information.
====================
Current Service Status = Service available
Service Domain = Combined
Current Service = PS
Packet Service = Attached
Packet Session Status = Active
Current Roaming Status = Roaming
Network Selection
--IPOP Time:2020/9/25_0:48:36--
Mode = Automatic
Network Connection Mode = Automatic
Current Network Connection = 5G(NSA)
Mobile Country Code (MCC) = 369
Mobile Network Code (MNC) = 77
Mobile Operator Information = Unknown
Tracking Area Code (TAC) = 1002
Cell ID = 9881858
Radio Information.
==================
Current Bands :
WCDMA: AUTO
LTE: B3
NR: AUTO
LTE:
Current Band = B3
Current RSSI = -54 dBm
Current RSRP = -84 dBm (strong)
Current RSRQ = -10 dB
Current SINR = 20 dB
NR:
Current Band = N77
Current RSRP = -72 dBm (strong)
Current RSRQ = -10 dB
Current SINR = 35 dB
Bands supported :
WCDMA: WCDMA850 WCDMA900 WCDMA2100
FDD LTE: B1 B3 B5 B7 B8 B20 B28
TDD LTE: B34 B38 B39 B40 B41
FDD NR: N1 N3 N28
TDD NR: N41 N77 N78 N79
Modem Security Information.
===========================
SIM ID = 1
PIN Verification = Disabled
PIN Status = Ready
Number of Retries remaining = 3
<Huawei> display cellular 0/0/0 network Modem State: Network Information. ==================== Current Service Status = Service available Service Domain = Combined Current Service = Combined Packet Service = Attached Packet Session Status = Inactive Current Roaming Status = Home Network Selection Mode = Automatic Network Connection Mode = WCDMA precedence Current Network Connection = WCDMA(WCDMA) Last Network Connection Capabicity = WCDMA Mobile Country Code (MCC) = 460 Mobile Network Code (MNC) = 01 Mobile Operator Information = CHN-UNICOM Location Area Code (LAC) = 53515 Cell ID = 55924 Upstream Bandwidth = 384kbps Downstream Bandwidth = 384kbps
Item |
Description |
|---|---|
Modem State |
Status of the modem. |
Hardware Information |
Information about the modem hardware. |
Model |
Model of the modem. |
Modem Type |
Modular type of the modem. The displayed modular type consists of the modular standard type and modular physical type. The modular standard types are as follows:
|
Modem Firmware Version |
Firmware version of the modem. |
Hardware Version |
Hardware version of the modem. |
Integrate circuit card identity (ICCID) |
Integrate circuit card identity of the modem. |
International Mobile Subscriber Identity (IMSI) |
International Mobile Subscriber Identity (IMSI) allocated to the user. |
Mobile Station International ISDN Number (MSISDN) |
Mobile Station International ISDN Number (MSISDN). |
International Mobile Equipment Identity (IMEI) |
International Mobile Equipment Identity (IMEI) of the modem. |
Factory Serial Number (FSN) |
Factory serial number (FSN) of the modem. |
Modem Status |
Whether the modem is online:
|
Profile Information |
Information about the parameter profile configured for the modem. |
Profile 1/Profile 2 |
Status of profile 1 or profile 2. |
PDP Type |
Packet data protocol (PDP) type:
|
Header Compression |
Whether IP header compression is enabled:
|
Data Compression |
Whether IP packet data compression is enabled:
|
Access Point Name (APN) |
APN that the carrier allocated to the modem. To set an APN, run the apn command in the APN profile view. |
Packet Session Status |
Session status:
|
Default profile |
Default parameter profile, profile 1. |
Network Information |
Information about the network connected to the modem. |
Current Service Status |
Service status of the modem:
|
Service Domain |
Configured PS or CS domain:
This parameter can be configured using the service domain command. |
Current Service |
Service type:
NOTE:
The 1ELTE6-EA and 1ELTE-L-S interface cards do not support the query of this parameter. |
Packet Service |
Relationship between the modem and the PS domain:
|
Current Roaming Status |
Roaming status of the user:
|
Network Selection Mode |
Method used to select a public land mobile network (PLMN):
This parameter can be configured using the plmn select command. |
Network Connection Mode |
A 3G modem selects the WCDMA network connection mode, an LTE modem selects the LTE network connection mode, or a 5G modem selects the 5G network connection mode. The following connection modes are available for a WCDMA network:
This parameter can be configured using the mode wcdma command. The following connection modes are available for an LTE network:
This parameter can be configured using the mode lte command. The following connection modes are available for a 5G network:
This parameter can be configured using the mode 5g command. |
Current Network Connection |
Type of the network connected to the modem. |
Last Network Connection Capabicity |
Last optimal network connection status. |
Mobile Country Code (MCC) |
Mobile country code of the network. This parameter can be configured using the plmn select command. |
Mobile Network Code (MNC) |
Mobile network code of the network. This parameter can be configured using the plmn select command. |
Mobile Operator Information |
Carrier information. |
Location Area Code (LAC) |
Location area code of the network. |
Cell ID |
Cell ID of the network. |
Upstream Bandwidth |
Upstream bandwidth of the modem. |
Downstream Bandwidth |
Downstream bandwidth of the modem. |
Radio Information |
Information about the radio used by the modem. |
Current Bands |
Frequency band used by the modem. The option AUTO indicates that the modem automatically selects the frequency band of the carrier network to be connected to. To set the frequency band, run the band gsm, band wcdma, band lte, or band nr command. |
Current RSSI |
Received signal strength indicator. On a WCDMA network, the relationship between the signal strength and RSSI is as follows:
On a CDMA2000 network, the relationship between the signal strength and RSSI is as follows:
|
Current RSRP |
Reference signal received power. The relationship between the signal strength and RSRP is as follows:
|
Current RSRQ |
Reference signal received quality. |
Current SINR |
Signal to interference plus noise ratio. By default, the SINR threshold is used for the LTE signal strength. The relationship between the signal strength and SINR is as follows:
|
Current RSCP |
Received signal code power. The relationship between the signal strength and RSCP is as follows:
|
Current ECIO |
Energy per chip to interference of other cell ratio. |
Bands supported |
Frequency band supported by the modem. |
Modem Security Information |
Modem's security information. |
SIM ID |
ID of SIM card. |
PIN Verification |
Whether PIN authentication is enabled:
This parameter can be configured using the pin verification command. |
PIN Status |
Status of the PIN:
|
Number of Retries remaining |
Number of PIN authentication attempts allowed. By default, the PIN is locked after the user enters incorrect PINs consecutively 3 times. |
SIM Status |
Status of the SIM card:
|
display interface cellular
Function
The display interface cellular command displays the status of and traffic statistics on a cellular interface or cellular channel interface.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. If this parameter is not specified, the status of and traffic statistics on all cellular interfaces or cellular channel interfaces are displayed. |
- |
Usage Guidelines
The display interface cellular command displays the status of and traffic statistics on a cellular interface or cellular channel interface. You can collect traffic statistics and locate faults on the serial interface according to the command output.
Example
# Display the status of and traffic statistics on cellular interface 0/0/0.
<Huawei> display interface cellular 0/0/0 Cellular0/0/0 current state : UP Line protocol current state : UP Description:HUAWEI, AR Series, Cellular0/0/0 Interface Route Port,The Maximum Transmit Unit is 1500, Hold timer is 10(sec) Internet Address is negotiated, 10.1.1.2/24 Link layer protocol is PPP LCP opened, IPCP opened Current system time: 2011-06-08 11:35:23 Modem State: Present Model = ME906E Current Network Connection = LTE(LTE) Current RSSI = -91 dBm Current SINR = 6 dB (weak) Antenna = outer Last 300 seconds input rate 555 bytes/sec 4440 bits/sec 12 packets/sec Last 300 seconds output rate 11230 bytes/sec 89840 bits/sec 311 packets/sec Input: 210 packets, 87205 bytes Unicast: 200, Ununicast: 10 Output:225340 packets, 6760917 bytes Unicast: 225300, Ununicast: 40 Input bandwidth utilization : 0.01% Output bandwidth utilization : 0.01%
Item |
Description |
|---|---|
Cellular0/0/0 current state |
Status of the cellular interface:
|
Line protocol current state |
Link layer protocol status of the cellular interface:
|
Description |
Interface description. |
The Maximum Transmit Unit is |
Maximum Transmission Unit (MTU) of the interface. Run the mtu command to set the maximum transmission unit (MTU) of an interface. |
Hold timer is 10(sec) |
Lifecycle of a packet. If a packet is not sent out before the hold timer times out, the packet is discarded. |
Internet Address |
IP address of the cellular interface. If no IP address is assigned to the interface, the system displays "Internet protocol processing : disabled". |
Link layer protocol |
Link layer protocol used by the cellular interface. |
LCP opened |
Status of the Link Control Protocol (LCP). |
IPCP opened |
Internet Protocol Control Protocol (IPCP) status of the MP link. |
Current system time |
Current system time. If the time zone is configured and the daylight saving time is used, the time is in YYYY-MM-DD HH:MM:SS UTC±HH:MM DST format. |
Modem State |
Whether a modem has been connected to the cellular interface. |
Model |
Model of the modem. |
Current Network Connection |
Type of the network connected to the modem. |
Current RSSI/RSRP |
Received signal strength indicator or reference signal receiving power. On a WCDMA network, the relationship between the signal strength and RSSI is as follows:
On a CDMA2000 network, the relationship between the signal strength and RSSI is as follows:
On a LTE network, the relationship between the signal strength and RSRP is as follows:
|
Current SINR |
Signal to interference plus noise ratio. By default, the SINR threshold is used for the LTE signal strength The relationship between the signal strength and SINR is as follows:
|
Last 300 seconds input rate |
Incoming packet rate (bits per second and packets per second) within the last 300 seconds. |
Last 300 seconds output rate |
Outgoing packet rate (bits per second and packets per second) within the last 300 seconds. |
Input |
Number of packets received by the cellular interface. |
Output |
Number of packets sent by the cellular interface. |
Unicast |
Number of unicast packets received or sent by the cellular interface. |
Ununicast |
Number of non-unicast packets received or sent by the cellular interface. |
Input bandwidth utilization |
Inbound bandwidth usage. |
Output bandwidth utilization |
Outbound bandwidth usage. |
display cellular encryption-algorithm
Function
The display cellular encryption-algorithm command displays the GPRS configuration status on an interface.
This command is supported in V300R021C10 and later versions.
The device embedded with the ME909s-821 or EC200T-CN modem supports this command.
Parameters
| Parameter | Description | Value |
|---|---|---|
interface-number |
Displays the GPRS configuration status on a specified interface. |
- |
Usage Guidelines
You can run the display cellular interface-number encryption-algorithm command to check the GPRS configuration status on a specified interface.
Example
# Display the GPRS configuration status on Cellular0/0/0.
<Huawei> display cellular 0/0/0 encryption-algorithm
------------------------------
Model name : EC200T-EU
------------------------------
GEA1 status : enabled
GEA2 status : disabled
GEA3 status : disabled
GEA4 status : enabled
------------------------------
Item |
Description |
|---|---|
Model name |
Modem name. |
GEA1 status |
Status of the GPRS encryption algorithm GEA1.0.
|
GEA2 status |
Status of the GPRS encryption algorithm GEA2.0.
|
GEA3 status |
Status of the GPRS encryption algorithm GEA3.0.
|
GEA4 status |
Status of the GPRS encryption algorithm GEA4.0.
|
display cellular feature
Function
The display cellular feature command displays the status of the source address verification, LTE QoS flow control, and DHCP transparent transmission functions of the modem.
Only routers with built-in ME909s-120 modules support this command.
Parameters
| Parameter | Description | Value |
|---|---|---|
interface-number |
Displays the status of the source address verification, LTE QoS flow control, and DHCP transparent transmission functions of the modem on a specified interface. |
- |
Usage Guidelines
You can run the display cellular feature command to check the status of the source address verification, LTE QoS flow control, and DHCP transparent transmission functions of the modem. If the modem's firmware version is correct, the status of source address verification function is disabled, and the status of the LTE QoS flow control and DHCP transparent transmission functions is enabled according to customization. If the modem feature status does not meet the customized status, run the module-upgrade command in the diagnostic view to upgrade the modem version.
Example
# Display the status of the source address verification, LTE QoS flow control, and DHCP transparent transmission functions of the modem on Cellular0/0/0.
<Huawei> display cellular 0/0/0 feature
Modem feature status:
Source address check: disabled
LTE QoS control: enabled
DHCP transfer packet: enabled
Audio optimize: enabled
DrxClose: enabled
Sms resend: enabled
Modem log status: locked
Encryption algorithm: gea1 gea2
Item |
Description |
|---|---|
Modem feature status |
Status of the source address verification, LTE QoS flow control, and DHCP transparent transmission functions of the modem. |
Source address check |
Status of source MAC address verification. |
LTE QoS control |
Status of the LTE QoS flow control feature. |
DHCP transfer packet |
Status of the DHCP transparent transmission function. |
Audio optimize |
Status of the audio optimization function. |
DrxClose |
Status of the Discontinuous Reception (DRX) function. |
Sms resend |
Status of the SM resending function. |
Modem log status |
Log status of the current modem:
|
Encryption algorithm |
GPRS encryption algorithm supported by the modem. You can run the modem encryption-algorithm command to change the GPRS encryption algorithm. |
display sms interface cellular
Function
The display sms interface cellular command displays information about received SMS messages.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
brief |
Displays brief information about all SMS messages. |
- |
id sms-id |
Displays information about the SMS message with a specified ID. sms-id specifies the SMS message ID. |
The value is an integer that ranges from 0 to 255. |
verbose |
Displays detailed information about all SMS messages. |
- |
Usage Guidelines
Usage Scenario
You can run this command to view information about SMS messages received by the device, including the source number, sending date and time, size, and content of the messages.
Precautions
The device only displays SMS messages in the 7bit encoding mode, and cannot normally display SMS messages in other encoding modes.
The characters [ ] ^ ` { | } ~ / \ @ among nonprintable and printable characters in SMS messages cannot be displayed.
Example
# Display brief information about all SMS messages received by Cellular2/0/0.
<Huawei> display sms interface cellular 2/0/0 brief
ID FROM DATE TIME SIZE
5 ****6951 19/10/31 11:59:51 38
6 ****6951 19/10/31 11:59:51 153
7 ****6951 19/10/31 14:17:13 153
8 ****6951 19/10/31 14:17:13 38
9 ****5227 19/10/31 14:47:14 153
10 ****5227 19/10/31 14:47:14 58
11 ****6951 19/10/31 15:26:17 153
12 ****6951 19/10/31 15:26:17 38
13 ****6951 19/10/31 15:27:45 38
14 ****6951 19/10/31 15:27:45 153
15 ****6951 19/10/31 15:33:16 153
# Display detailed information about all SMS messages received by Cellular2/0/0.
<Huawei> display sms interface cellular 2/0/0 verbose
[ ID: 2 TIME: 19/10/31 11:27:48 FROM: ****6951 ]
[ ID: 3 TIME: 19/10/31 11:47:16 FROM: ****6951 ]
[ ID: 4 TIME: 19/10/31 11:47:16 FROM: ****6951 ]
[ ID: 5 TIME: 19/10/31 11:59:51 FROM: ****6951 ]
[ ID: 6 TIME: 19/10/31 11:59:51 FROM: ****6951 ]
[ ID: 7 TIME: 19/10/31 14:17:13 FROM: ****6951 ]
[ ID: 8 TIME: 19/10/31 14:17:13 FROM: ****6951 ]
[ ID: 9 TIME: 19/10/31 14:47:14 FROM: ****5227 ]
[ ID: 10 TIME: 19/10/31 14:47:14 FROM: ****5227 ]
[ ID: 11 TIME: 19/10/31 15:26:17 FROM: ****6951 ]
# Display information about the SMS message with the ID 1 received by Cellular2/0/0.
<Huawei> display sms interface cellular 2/0/0 id 1
ID: 1
FROM: ****6951
DATE: 19/10/31
TIME: 11:27:48
SIZE: 153
Item |
Description |
|---|---|
Inbox total SMS |
Number of received SMS messages. |
ID |
ID of a received SMS message. |
FROM |
Source number of a received SMS message. |
DATE |
Date when an SMS message is received. |
TIME |
Time when an SMS message is received. |
SIZE |
Size of a received SMS message. |
display sms interface cellular statistics
Function
The display sms interface cellular statistics command displays statistics about SMS messages.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
Usage Guidelines
You can run this command to check statistics about SMS messages, including the number of received SMS messages, number of SMS messages sent successfully, number of SMS messages failed to be sent, and number of deleted SMS messages.
Example
# Display statistics about SMS messages received or sent by Cellular2/0/0.
<Huawei> display sms interface cellular 2/0/0 statistics
Total SMS received = 8
Total SMS sent successfully = 3
Total SMS sent failure = 0
Total SMS deleted = 3
Item |
Description |
|---|---|
Total SMS received |
Number of received SMS messages. |
Total SMS sent successfully |
Number of SMS messages sent successfully. |
Total SMS sent failure |
Number of SMS messages failed to be sent. |
Total SMS deleted |
Number of deleted SMS messages. |
display sms send-history
Function
The display sms send-history command displays records of sent short messages saved in the memory.
Usage Guidelines
Usage Scenario
You can run this command to check records of sent short messages.
Precautions
A maximum of 20 records of recently sent short messages can be displayed. The new record overrides the old ones.
After the device restarts, the historical records of sent short messages disappear.
Example
# Display records of sent short messages saved in the memory.
<Huawei> display sms send-history
ID RECEIVER YYYY/MM/DD HH:MM:SS INTERFACE RESULT
0 ****5678 2019/10/31 17:15:54 FAIL
Item |
Description |
|---|---|
ID |
ID of a short message record. The ID ranges from 0 to 19. |
RECEIVER |
User phone number for receiving short messages. To configure the user phone number, run the sms item command. |
YYYY/MM/DD |
Date when short messages are sent. |
HH:MM:SS |
Time when short messages are sent. |
INTERFACE |
Cellular interface that successfully sends short messages. |
RESULT |
Result of sending short messages.
|
display snmp-agent trap feature-name ifmtrap all
Function
The display snmp-agent trap feature-name ifmtrap all command displays the status of all traps on the IFM module.
Usage Guidelines
You can run the display snmp-agent trap feature-name ifmtrap all command to check the status of all traps on the IFM module. The status of a trap is configured using the snmp-agent trap enable feature-name ifmtrap command.
Example
# Display the status of all traps on the IFM module.
<Huawei> display snmp-agent trap feature-name ifmtrap all ------------------------------------------------------------------------------ Feature name: IFMTRAP Trap number : 5 ------------------------------------------------------------------------------ Trap name Default switch status Current switch status hw3GPinModify on on hwPortPhysicalEthHalfDuplexAlarm off off hwPortPhysicalEthFullDuplexClear off off hw3GMIBTrapCellIdChange off off hwPortSpeedChangeTrap off off
Item |
Description |
|---|---|
Feature name |
Name of the module to which a trap belongs. |
Trap number |
Number of traps. |
Trap name |
Name of a trap. Traps on the IFM module include:
|
Default switch status |
Default trap status:
|
Current switch status |
Current trap status:
|
interface cellular
Function
Using the interface cellular command, you can enter the cellular interface view or cellular channel interface view.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface.
|
- |
Usage Guidelines
Usage Scenario
To configure the 3G, LTE or 5G function on a cellular interface or cellular channel interface, run the interface cellular command to enter the cellular interface view.
Cellular channel interfaces only apply to the multi-APN scenario.
Prerequisites
The multi-APN function has been enabled on the cellular interface before you enter the cellular channel interface view.
Example
# Enter the view of cellular interface 0/0/0.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0]
# Display the view of cellular channel interface 1.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] multi-apn enable [Huawei-Cellular0/0/0] quit [Huawei] interface cellular 0/0/0:1 [Huawei-Cellular0/0/0:1]
ip address negotiate
Function
The ip address negotiate command enables a cellular interface or cellular channel interface to dynamically obtain an IP address.
The undo ip address negotiate command disables a cellular interface or cellular channel interface from dynamically obtaining an IP address.
By default, a cellular interface or cellular channel interface cannot dynamically obtain an IP address.
mode lte
Function
The mode lte command configures the 3G or LTE network connection mode for a modem.
By default, the 3G or LTE network connection mode is auto for an LTE modem.
Format
mode lte { auto | gsm-only | 1xrtt-only | evdo-only | hybrid | lte-only | tdscdma-only | umts-gsm | umts-only | wcdma-gsm | wcdma-only }
Parameters
Parameter |
Description |
Value |
|---|---|---|
auto |
Indicates that a modem automatically connects to a network. |
- |
gsm-only |
Indicates that a modem can only connect to a GSM network. |
- |
1xrtt-only |
Indicates that a modem can only connect to a 1xRTT network. |
- |
evdo-only |
Indicates that a modem can only connect to a EV-DO network. |
- |
hybrid |
Indicates that a modem connects to a 1xRTT and EV-DO combined network. |
- |
lte-only |
Indicates that a modem can only connect to a LTE network. |
- |
tdscdma-only |
Indicates that a modem can only connect to a TD-SCDMA network. |
- |
umts-gsm |
Indicates that a modem connects to either a UMTS or GSM network and preferentially connects to the UMTS network. |
- |
umts-only |
Indicates that a modem can only connect to either a WCDMA or TD-SCDMA network. |
- |
wcdma-gsm |
Indicates that a modem connects to either a WCDMA or GSM network and preferentially connects to the WCDMA network. |
- |
wcdma-only |
Indicates that a modem can only connect to a WCDMA network. |
- |
Usage Guidelines
Usage Scenario
LTE cellular interfaces can connect to the network only when the network connection mode is configured for a modem based on the type of the network provided by the carrier. If the connection mode is inconsistent with the network type, run the mode lte command to modify the network connection mode for the LTE modem.
Precautions
This command is valid only when the modem is working.
If you run the mode lte command multiple times in the same cellular interface view, only the latest configuration takes effect.
mode wcdma
Function
Using the mode wcdma command, you can configure a WCDMA network connection mode for a modem.
Parameters
Parameter |
Description |
Value |
|---|---|---|
gsm-only |
Indicates that a modem connects to a GSM network. |
- |
gsm-precedence |
Indicates that a modem preferentially connects to a GSM network. |
- |
wcdma-only |
Indicates that a modem connects to a WCDMA network. |
- |
wcdma-precedence |
Indicates that a modem preferentially connects to a WCDMA network. |
- |
Usage Guidelines
Usage Scenario
The modem has various types. By default, each type of the modem has a unique WCDMA network connection mode. After a WCDMA network connection mode is configured, it is recorded in the modem and permanently valid.
Configure a correct WCDMA network connection mode for the modem based on the type of the network provided by the carrier. If the WCDMA network connection mode is incorrect, you need to run the mode wcdma command to change the WCDMA network connection mode for the modem.
Precautions
This command is valid only when a modem is connected to a cellular interface.
If you run the mode wcdma command multiple times in the same cellular interface view, only the latest configuration takes effect.
mode 5g
Function
The mode 5g command configures the 5G network connection mode for a modem.
By default, the 5G network connection mode is auto for a modem.
Parameters
Parameter |
Description |
Value |
|---|---|---|
auto |
Indicates that a modem automatically connects to a network. |
- |
wcdma-only |
Indicates that a modem can only connect to a WCDMA network. |
- |
lte-only |
Indicates that a modem can only connect to a LTE network. |
- |
nr-only |
Indicates that a modem can only connect to a NR network. |
- |
lte-wcdma |
Indicates that a modem connects to a LTE and WCDMA combined network. |
- |
lte-nr |
Indicates that a modem can only connect to a LTE and NR network. A modem first connects to an LTE network. Then the 5G module determines whether there is a NR on the LTE network. If so, the modem connects to the NR, forming a 5G NSA network. If not, the modem still connects to the LTE network. |
- |
nr-lte |
Indicates that a modem can only connect to a NR and LTE network. A modem first connects to a NR. If an SA network is available, the modem is connected to the 5G SA network. Otherwise, the modem connects to an LTE network to form a 5G NSA network after the 5G module finds that there is a NR on the LTE network. If there is no NR on the LTE network, the modem still connects to the LTE network. |
- |
Usage Guidelines
Usage Scenario
Cellular interfaces can connect to the 5G network only when the 5G network connection mode is configured for a modem based on the type of the network provided by the carrier. If the connection mode is inconsistent with the network type, run the mode 5g command to modify the 5G network connection mode for the modem.
Precautions
This command is valid only when the modem is working.
After running the mode 5g command, run the modem reboot command to make the configuration take effect.
modem auto-recovery track nqa
Function
The modem auto-recovery track { nqa | nqa-group } command configures the device to use an NQA or NQA groups test instance to detect the 3G, LTE or 5G link status.
The undo modem auto-recovery track { nqa | nqa-group } command restores the default setting.
By default, the device does not use an NQA or NQA groups test instance to detect a 3G, LTE or 5G link.
Format
modem auto-recovery track { nqa admin-name test-name | nqa-group group-name } [ probe-cycle period | probe-cycle seconds period-s ]
undo modem auto-recovery track { nqa | nqa-group }
Parameters
Parameter |
Description |
Value |
|---|---|---|
admin-name |
Specifies the administrator name of an NQA test instance. |
The value is a string of 1 to 32 case-sensitive characters without spaces. |
test-name |
Specifies the name of an NQA test instance. |
The value is a string of 1 to 32 case-sensitive characters without spaces. |
nqa-group group-name |
Indicates the name of an NQA group for an NQA test instance. |
The value is a string of 1 to 32 case-sensitive characters without spaces. |
probe-cycle period |
Specifies the interval for querying NQA test results. |
The value is an integer that ranges from 1 to 30, in minutes. The default value is 5. |
probe-cycle seconds period-s |
Specifies the interval for querying NQA test results, in seconds. |
The value is an integer that ranges from 1 to 1800, in seconds. The default value is 300. |
Usage Guidelines
Use Scenario
When a 3G, LTE or 5G link is unstable because of weak 3G, LTE or 5G signals or interference, you may fail to access external networks through the 3G, LTE or 5G link even if the dialup succeeds. To solve this problem, configure the device to use an NQA test instance to detect the 3G, LTE or 5G link status. When the 3G, LTE or 5G link is unstable, the device triggers an action to recover the 3G, LTE or 5G link.
Prerequisites
An ICMP NQA test instance has been configured.
Follow-up Procedure
Run the modem auto-recovery track action command to set the maximum number of 3G, LTE or 5G link detection failures in an NQA test instance. When the number of consecutive 3G, LTE or 5G link detection failures in an NQA test instance reaches the maximum value, the device triggers an action to recover the 3G, LTE or 5G link.
modem auto-recovery track action
Function
The modem auto-recovery track action command sets the maximum number of 3G, LTE or 5G link detection failures in an NQA test instance. When the number of consecutive 3G, LTE or 5G link detection failures in an NQA test instance reaches the maximum value, the device triggers an action to recover the 3G, LTE or 5G link.
The undo modem auto-recovery track action command restores the default setting.
By default, the maximum number of 3G, LTE or 5G link detection failures in an NQA test instance is not configured. That is, the device does not trigger an action to recover a 3G, LTE or 5G link when 3G, LTE or 5G link detection fails for several consecutive times.
Format
modem auto-recovery track action { plmn-search | redial } fail-times times
modem auto-recovery track action modem-reboot fail-times times [ mandatory ]
undo modem auto-recovery track action { plmn-search | modem-reboot | redial }
Parameters
Parameter |
Description |
Value |
|---|---|---|
plmn-search |
Configures the device to search the PLMN again when the number of consecutive 3G, LTE or 5G link detection failures reaches the maximum value. NOTE:
The number of times the device searches the PLMN must be larger than the number of times the device creates a dial-up connection. |
- |
modem-reboot |
Configures the device to restart the modem when the number of consecutive 3G, LTE or 5G link detection failures reaches the maximum value. NOTE:
The number of times the device restarts the modem must be larger than the number of times the device searches the PLMN. |
- |
redial |
Configures the device to create a dial-up connection when the number of consecutive 3G, LTE or 5G link detection failures reaches the maximum value. |
- |
fail-times times |
Specifies the maximum number of 3G, LTE or 5G link detection failures in an NQA test instance. |
The value is an integer that ranges from 1 to 128. |
mandatory |
Configures the device to perform operations based on the NQA detection result without considering the interface status. |
- |
Usage Guidelines
Usage Scenario
After the modem auto-recovery track nqa command is run to use an NQA test instance to test the 3G/LTE/5G link status, if the link is unreachable for a long period, run the modem auto-recovery track action command to set the maximum number of link detection failures. When the number of consecutive link detection failures in the NQA test instance reaches the maximum value, the device triggers an action (re-establishing a dial-up connection, searching the PLMN, or restarting the modem) to recover the 3G/LTE/5G link.
Precautions
When mandatory is not specified and IPv4 dial-up is configured, the number of link detection failures increases by one if the cellular main interface is Up and there is no incoming traffic on the interface in case of an NQA test failure. When mandatory is specified, the number of link detection failures increases by one in case of an NQA test failure. When the number of link detection failures reaches the threshold, the system restarts the module. The interval for querying NQA test results is closely related to the probe-cycle parameter in the modem auto-recovery track command. The minimum detection time for executing an action is probe-cycle x fail-times.
modem auto-recovery icmp-unreachable action modem-reboot
Function
The modem auto-recovery icmp-unreachable action modem-reboot command enables the device to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic of the 5G cellular interface is abnormal. If the DNS server is unreachable, the device restarts the 5G modem to restore the link.
The undo modem auto-recovery icmp-unreachable action modem-reboot command disables the device from sending ICMP packets to detect whether the DNS server is reachable when the downlink traffic of the 5G cellular interface is abnormal.
By default, the device is not enabled to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic of the 5G cellular interface is abnormal. If the DNS server is unreachable, the device restarts the 5G modem to restore the link.
Format
modem auto-recovery icmp-unreachable action modem-reboot
undo modem auto-recovery icmp-unreachable action modem-reboot
Usage Guidelines
Usage Scenario
If the 5G link cannot receive packets correctly, run the modem auto-recovery icmp-unreachable action modem-reboot command to configure the device to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic of the 5G cellular interface is abnormal. If the DNS server is unreachable, the device restarts the 5G modem to restore the link. If you do not want the 5G link to automatically recover when it cannot receive packets correctly, run the undo modem auto-recovery icmp-unreachable action modem-reboot command.
Precautions
If the device module is not a 5G module, this function is not supported.
The IP address of the DNS server is negotiated through the cellular interface. If the device does not learn the IP address of the DNS server, the device does not perform ICMP detection.
Example
# Enable the device to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic of the 5G cellular interface is abnormal. If the DNS server is unreachable, the device restarts the 5G modem to restore the link.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] modem auto-recovery icmp-unreachable action modem-reboot
modem auto-recovery dial action modem-reboot fail-times
Function
The modem auto-recovery dial action modem-reboot fail-times command sets the maximum number of dial-up failures. When the number of consecutive dial-up failures reaches the maximum value, the device restarts a modem.
The undo modem auto-recovery dial action modem-reboot command deletes the maximum number of dial-up failures.
By default, the maximum number of dial-up failures is not configured. That is, the device does not restart the modem or restart itself in consecutive dial-up failures
Format
modem auto-recovery dial action modem-reboot fail-times times
undo modem auto-recovery dial action modem-reboot
Parameters
Parameter |
Description |
Value |
|---|---|---|
times |
Specifies the maximum number of dial-up failures. |
The value is an integer that ranges from 1 to 128. The value less than 8 is recommended. |
Usage Guidelines
When the dial-up initiated through a cellular interface fails multiple times, you can run the modem auto-recovery dial action modem-reboot fail-times command to set the maximum number of dial-up failures. When the number of consecutive dial-up failures reaches the maximum value, the device restarts the modem so that the fault can be rectified automatically.
modem auto-recovery services-unavailable action modem-reboot
Function
The modem auto-recovery services-unavailable action modem-reboot command sets the out-of-service state detection interval and the maximum number of times the modem automatically restarts.
The undo modem auto-recovery services-unavailable command disables the function of automatically restarting the modem upon the out-of-service state.
By default, the maximum number of times the modem automatically restarts and the out-of-service state detection interval are not set on the device. That is, the modem does not automatically restart upon the out-of-service state.
Format
modem auto-recovery services-unavailable action modem-reboot test-times times interval interval
undo modem auto-recovery services-unavailable
Parameters
Parameter |
Description |
Value |
|---|---|---|
action modem-reboot |
Restarts the modem automatically upon the out-of-service state. |
- |
test-times times |
Specifies the maximum number of times the modem automatically restarts. |
The value is an integer that ranges from 0 to 10. You are not advised to set the value greater than 8. The value 0 indicates that the number of times the modem automatically restarts is infinite. |
interval interval |
Specifies the out-of-service state detection interval. |
The value is an integer that ranges from 60 to 3600, in seconds. The default value is 3600. |
Usage Guidelines
When the cellular interface is in out-of-service state because of a network exception, you can run the modem auto-recovery services-unavailable action modem-reboot test-times command to set the out-of-service state detection interval and the maximum number of times the modem automatically restarts. When the period of time the modem remains in out-of-service state reaches the detection interval, the modem automatically restarts.
When the interface recovers from the out-of-service state within the detection interval or the number of times the modem automatically restarts reaches the upper limit, the modem no longer restarts. You can run the display cellular interface-number network command to view the current status of the modem. When Current Service Status is displayed as Service available in the command output, the modem recovers from the out-of-service state.
Example
# Set the out-of-service state detection interval of the modem to 300s and the maximum number of times the modem automatically restarts to 5.
<Huawei> system-view [Huawei] interface cellular 1/0/0 [Huawei-Cellular1/0/0] modem auto-recovery services-unavailable action modem-reboot test-times 5 interval 300
modem auto-recovery services-unavailable action sim-switch
Function
The modem auto-recovery services-unavailable action sim-switch command enables the automatic active/standby SIM card switchover function.
The undo modem auto-recovery services-unavailable command disables the automatic active/standby SIM card switchover function.
By default, the device does not automatically switch the active and standby SIM cards when no service is available.
Format
modem auto-recovery services-unavailable action sim-switch [ test-times times ] [ interval interval ]
undo modem auto-recovery services-unavailable
Parameters
Parameter |
Description |
Value |
|---|---|---|
action sim-switch |
Automatically switches the active and standby SIM cards. |
- |
test-times times |
Specifies the threshold for the number of SIM card switchovers. |
The value is an integer that ranges from 0 to 10. You are advised to set this parameter to a value less than or equal to 8. The value 0 indicates that the number of SIM card switchovers is unlimited. |
interval interval |
Specifies the interval for detecting whether no service is available. |
The value is an integer ranging from 60 to 3600, in seconds. The default value is 600, in seconds. |
Usage Guidelines
Usage Scenario
When the network environment of a cellular interface is abnormal and no service is available, you can run the modem auto-recovery services-unavailable action sim-switch interval interval command to set the interval for detecting whether no service is available and enable the automatic active/standby SIM card switchover function.
Precautions
After an active/standby SIM card switchover, the modem automatically restarts. Exercise caution when performing this operation.
Example
# Set the interval for detecting whether no service is available to 400s and enable the automatic active/standby SIM card switchover function.
<Huawei> system-view [Huawei] interface cellular 1/0/0 [Huawei-Cellular1/0/0] modem auto-recovery services-unavailable action sim-switch interval 400
modem encryption-algorithm
Function
The modem encryption-algorithm command configures the GPRS encryption algorithm for a modem.
By default, the modem supports the GEA1.0 and GEA2.0 encryption algorithms, but does not support the GEA3.0 encryption algorithm.
The device embedded with the ME909s-821 modem supports the modem encryption-algorithm { gea1_gea2 | gea2_gea3 } command.
The device embedded with the EC200T-EA modem in V300R021C10 and later versions supports the modem encryption-algorithm { gea1 | gea2 | gea3 | gea4 } * command.
Format
modem encryption-algorithm { gea1_gea2 | gea2_gea3 }
modem encryption-algorithm { gea1 | gea2 | gea3 | gea4 } *
Parameters
Parameter |
Description |
Value |
|---|---|---|
gea1_gea2 |
Sets the GPRS encryption algorithms of a modem to GEA1.0 and GEA2.0. |
- |
gea2_gea3 |
Sets the GPRS encryption algorithms of a modem to GEA2.0 and GEA3.0. |
- |
gea1 |
Sets the GPRS encryption algorithm of a modem to GEA1.0. |
- |
gea2 |
Sets the GPRS encryption algorithm of a modem to GEA2.0. |
- |
gea3 |
Sets the GPRS encryption algorithm of a modem to GEA3.0. |
- |
gea4 |
Sets the GPRS encryption algorithm of a modem to GEA4.0. |
- |
Usage Guidelines
Usage Scenario
When a modem registers with the network, the modem sends a registration request carrying the GPRS encryption algorithms GEA1.0 and GEA2.0 to the core network by default. The core network then selects an encryption mode based on its encryption capability. The device can access the network only when the encryption mode matches the device.
If the encryption mode supported by the core network does not match the device, run the modem encryption-algorithm gea2_gea3 command to set the GPRS encryption algorithms of the modem to GEA2.0 and GEA3.0.
Precautions
This command can be executed only when the modem is properly installed.
To ensure that the configured GPRS encryption algorithm takes effect when the device accesses the network next time, you can choose to restart the modem immediately.
If you choose not to restart the modem immediately, you can run the modem reboot command to manually restart the modem later.
Example
# Set the GPRS encryption algorithms of a modem to GEA1.0 and GEA2.0, and choose not to restart the modem immediately.
<Huawei> system-view [Huawei] interface cellular 1/0/0 [Huawei-Cellular1/0/0] modem encryption-algorithm gea1_gea2 Warning: The gea1_gea2 is insecure. For security purposes, use gea2_gea3. Warning: The modified GPRS encryption algorithm can take effect only after the modem reboot. The modem will reboot. Continue? [Y/N]: n Info: The encryption algorithm takes effect next time after the modem reboot. [Huawei-Cellular1/0/0] Jun 9 2020 06:32:54+00:00 Huawei %%01IFPDT/4/MODEM_REBOOT(l)[0]:The user choose NO when there is a selection about whether to reboot modem.
modem reboot
Usage Guidelines
Usage Scenario
A modem restarts automatically when it detects an exception. If the modem cannot automatically restart, you can run this command to manually restart the modem.
Precautions
When this command is executed to manually restart a modem, services on the specified cellular interface are interrupted.
SIM, USIM, and UIM cards are not hot swappable.
- To ensure that the installed SIM, USIM, or UIM card works properly, run the modem reboot [ fast ] command to manually restart the modem after removing and installing the SIM, USIM, or UIM card.
To check whether SIM, USIM, and UIM cards are working properly, run the display cellular command to view the SIM Status or UIM Status field.
Example
# Manually restart a modem.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] modem reboot Warning: The module will reboot. Continue? [Y/N]:y [Huawei-Cellular0/0/0] May 4 2014 16:49:55+00:00 2220-29 %%01IFPDT/4/MODEM REBOOT(l)[90]:The user chooses YES when there is a selection about whether to re boot modem.
modem peer network-route
Function
The modem peer network-route command enables the function of installing the peer's routes in the local routing table.
The undo modem peer network-route command disables the function of installing the peer's routes in the local routing table.
By default, the local routing table does not contain the peer's routes.
Format
modem peer network-route
undo modem peer network-route
Parameters
None
Views
Cellular interface view
Default Level
3: Management level
Usage Guidelines
Usage Scenario
You can run the modem peer network-route or undo modem peer network-route command to determine whether to install the host routes for the peer IP address in the local routing table.
After the modem peer network-route command is run, the local routing table contains the peer's routes.
After the undo modem peer network-route command is run, the local routing table does not contain the peer's routes.
Precautions
After this command is run, the dial-up command must be triggered again for the configuration to take effect.
Example
# Enable the function of installing the peer's routes in the local routing table.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] modem peer network-route
mtu(3G/LTE/5G)
Function
Using the mtu command, you can set the maximum transmission unit (MTU) for a cellular interface or cellular channel interface.
Using the undo mtu command, you can restore the default MTU.
By default, the MTU of a cellular interface or cellular channel interface is 1500 bytes.
Parameters
Parameter |
Description |
Value |
|---|---|---|
mtu |
Specifies the MTU of a cellular interface. |
The value is an integer that ranges from 128 to 1500, in bytes. |
Usage Guidelines
Usage Scenario
Generally, the IP layer limits the size of a packet sent each time. Any time the IP layer receives an IP packet, it checks to which local interface the packet needs to be sent and obtains the MTU of the interface. Then, the IP layer compares the MTU with the packet size. If the packet size is larger than the MTU, the IP layer disassembles the packet to fragments smaller than the MTU.
If forcible unfragmentation is configured, oversized packets are discarded at the IP layer. To prevent packet loss on the network, large packets must be forcibly fragmented. Run the mtu command to set the size of a fragment.
Precautions
If you run the mtu command multiple times in the same cellular interface view or cellular channel interface, only the latest configuration takes effect.
Follow-up Procedure
Run the shutdown and undo shutdown/restart commands to restart the related physical interface to make the configuration take effect.
multi-apn enable
Function
The multi-apn enable command enables the multi-APN function on a cellular interface.
The undo multi-apn enable command disables the multi-APN function on a cellular interface.
By default, the multi-APN function is disabled on a cellular interface.
Usage Guidelines
Usage Scenario
A cellular interface can be configured with two cellular channel interfaces. After the multi-APN function is configured, you can create two APN profiles and bind the APN profiles respectively to the two cellular channel interfaces. One APN connects to the Internet for data communication, and the other connects to the IMS network for VoIP communication.
Precautions
The multi-APN function can be configured on the LTE cellular interface (Cellular 0/0/0) of the AR611W-LTE4CN, AR617VW-LTE4EA, and AR617VW-LTE4.
LTE interface cards (except 1LTE-Lo and 1LTE6-EA) support the multi-APN function.
5G interface cards support the multi-APN function.
If the multi-apn enable or undo multi-apn enable command is run on the 1ELTE6-EA, 1ELTE-L-S, AR617VW-LTE4 in V300R021C10 or a later version, the device restarts the modem to make the command take effect.
Example
# Enable the multi-APN function on the cellular interface.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] multi-apn enable Warning: The modified multi-apn can take effect only after the modem reboot. The modem will reboot. Continue? [Y/N]: Jun 8 2020 03:03:06+00:00 Huawei %%01IFPDT/4/IF_STATE(l)[0]:Interface Cellular0/0/0 has turned into UP state.
packet-service recover
Function
The packet-service recover command configures a modem to automatically restart and sets the interval at which a modem automatically restarts.
The undo packet-service recover command cancels the configuration.
By default, a modem does not automatically restart.
Parameters
Specification |
Description |
Value |
|---|---|---|
interval |
Specifies the interval at which a modem automatically restarts. |
The value is an integer that ranges from 10 to 86400, in seconds. |
Usage Guidelines
When a modem is not attached to a PS domain, you can run the packet-service recover command to configure a modem to automatically restart and set the interval at which the modem automatically restarts. Then the modem automatically restarts and starts dialing until it is attached to a PS domain.
pin modify
Function
The pin modify command changes the personal identification number (PIN) of a SIM, USIM or UIM card.
Usage Guidelines
Usage Scenario
You can run this command to set a new PIN for the SIM, USIM, or UIM card. The new PIN is saved on the SIM, USIM or UIM card.
Precautions
This command is valid only when a modem with a SIM, USIM, or UIM card is connected to a cellular interface.
The PIN of a SIM, USIM, or UIM card can be changed only when PIN authentication is enabled on the modem.
pin unlock
Function
The pin unlock command unlocks the SIM, USIM or UIM card using the personal identification number unlocked key (PUK) and sets a new PIN.
Usage Guidelines
Usage Scenario
The PIN unblocking key (PUK) is allocated by the carrier. If a user enters incorrect PINs three consecutive times, the SIM, USIM or UIM card is locked to ensure security of the card. To unlock the card, enter the PUK.
Precautions
This command is valid only when a modem with a SIM, USIM, or UIM card is connected to a cellular interface.
If a user enters incorrect PUKs ten consecutive times, the SIM, USIM, or UIM card is permanently locked and the user needs to obtain a new one from the carrier.
Example
# Unlock the SIM, USIM or UIM card using the PUK and sets a new PIN.
<Huawei> system-view [Huawei] interface cellular 0/0/0 [Huawei-Cellular0/0/0] pin unlock Enter Current Puk Code: Enter Pin Code: Confirm Pin Code: Warning: PIN will be unlocked and changed. Continue? [Y/N]:y Unlocking PIN...Please wait... PIN has been unlocked and changed successfully.
pin verification
Function
The pin verification command enables or disables PIN authentication on a modem.
By default, PIN authentication is disabled.
Parameters
Parameter |
Description |
Value |
|---|---|---|
enable |
Enables PIN authentication. |
- |
disable |
Disables PIN authentication. |
- |
auto |
Indicates automatic PIN authentication. This parameter can be specified if you do not require high security of the SIM, USIM, or UIM card. After this parameter is specified, you do not need to enter the PIN every time you use the SIM, USIM, or UIM card. |
- |
Usage Guidelines
Usage Scenario
A PIN identifies the user of a SIM, USIM, or UIM card.
PIN authentication prevents unauthorized users from using a SIM, USIM, or UIM card. You can use a modem only after the PIN is authenticated.
Precautions
This command is valid only when a modem with a SIM, USIM, or UIM card is connected to a cellular interface.
If PIN authentication in auto mode fails, you must manually enter the PIN for authentication.
pin verify
Parameters
Parameter |
Description |
Value |
|---|---|---|
auto |
Indicates automatic PIN authentication. This parameter can be specified if you do not require high security of the SIM, USIM or UIM card. After this parameter is specified, you do not need to enter the PIN every time you use the SIM, USIM or UIM card. |
- |
Usage Guidelines
Usage Scenario
After PIN authentication is enabled, you are required to enter the correct PIN every time you use the SIM, USIM or UIM card. If the PIN authentication fails, data communication is unavailable on the modem.
Precautions
If you enter incorrect PINs three consecutive times, the PIN of the SIM, USIM or UIM card is locked.
This command is valid only when a modem with a SIM, USIM or UIM card is connected to a cellular interface.
A PIN is a decimal integer of 4 to 8 digits. Obtain the initial PIN from the carrier.
plmn search
Function
Using the plmn search command, you can configure a modem to search for available public land mobile networks (PLMNs).
Usage Guidelines
Usage Scenario
The plmn search command is a network detection command.
Precautions
This command applies only to WCDMA or LTE or 5G networks. This command is valid only when a modem with a SIM or USIM card is connected to a cellular interface.
It takes several minutes for a modem to complete the search after this command is executed.
![]()
If the modem fails to search PLMNs after executing this command, the possible causes include poor signal quality, coverage hole, and signal interference. Wait for a period and run the command again.
Follow-up Procedure
After PLMNs are found, the system shows the searching results. Users can run the plmn select command to select a PLMN manually.
plmn select
Function
The plmn select command allows you to manually select a PLMN for a modem or configure the modem to automatically select a PLMN.
By default, a modem automatically selects a PLMN.
Format
Manually selecting a PLMN:
plmn select manual mcc mnc [ fail-over-auto ]
undo plmn select manual
Automatically selecting a PLMN:
plmn auto
Parameters
Parameter |
Description |
Value |
|---|---|---|
manual |
Manually selects a PLMN for a modem. When this keyword is used, set the mcc and mnc parameter. |
- |
mcc |
Specifies the mobile country code (MCC) of a PLMN. |
The value is an integer that ranges from 0 to 999. |
mnc |
Specifies the mobile network code (MNC) of a PLMN. |
The value is an integer that ranges from 0 to 999. |
fail-over-auto |
Indicates that a modem automatically selects a PLMN when manual selection of a PLMN fails. |
- |
auto |
Automatically selects a PLMN. |
- |
Usage Guidelines
Usage Scenario
For a WCDMA, LTE or 5G network, you can manually select a PLMN for a modem or configure the modem to automatically select a PLMN.
By default, a modem automatically selects a PLMN. If you have subscribed to WCDMA, LTE or 5G services and obtained the mobile country code (MCC) and mobile network code (MNC), you can manually select a PLMN.
Precautions
This command applies only to WCDMA, LTE or 5G networks. This command is valid only when a modem with a SIM or USIM card is connected to a cellular interface.
When the manual PLMN selection mode is use, the automatic PLMN selection mode is restored after you run the undo plmn select manual command. When the automatic PLMN selection mode is used, there is no change after you run this command.
If the manually selected PLMN is invalid or the manually selected PLMN is different from the operator code of the SIM card of the subscriber, the modem cannot connect to the network. Run the undo plmn select manual or plmn auto command to configure the modem to automatically select a PLMN, and run the modem reboot command to manually restart the modem.
Follow-up Procedure
Run the display cellular command to view information about the selected PLMN.
profile create
Parameters
Parameter |
Description |
Value |
|---|---|---|
profile-number |
Specifies the number of a parameter profile. |
The value is 1. |
dynamic |
Configures an APN dynamically. |
- |
static apn |
Configures an APN manually. |
To obtain an APN, contact the local carrier. The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
Usage Guidelines
Usage Scenario
An access point name (APN) identifies a service type on a WCDMA, LTE, or 5G network. The WCDMA, LTE, or 5G system provides services based on the APN used by a user to access the WCDMA, LTE, or 5G network.
Precautions
This command applies only to WCDMA, LTE, and 5G networks. This command takes effect only when the modem and SIM/USIM card are installed.
APNs vary depending on WCDMA, LTE, and 5G network carriers. You can obtain the APN from the local carrier.
profile delete
profile create lte-default
Format
profile create lte-default apn [ user username password { cipher | simple } password authentication-mode { chap | pap } ]
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn |
Specifies the default APN for an LTE network. |
The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
user username |
Specifies the user name provided by a carrier for accessing an external PDN. |
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
password { cipher | simple } password |
Specifies the password provided by a carrier for accessing an external PDN. The password types are as follows:
|
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
authentication-mode { chap | pap } |
Specifies the authentication mode.
|
- |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to LTE networks through the default APN, whereas other carriers do not have such requirements. If users are required to connect to a carrier's LTE network through the default APN, you can run the profile create lte-default command to configure the default APN for the LTE network.
You can run the profile delete lte-default command to delete the default APN configured for an LTE network.
Precautions
This command applies only to LTE networks. This command takes effect only when the LTE modem and SIM/USIM card are installed.
APNs vary depending on LTE network carriers. You can obtain the APN from the local carrier.
profile create lte-default sim-id
Function
The profile create lte-default command configures the default APN for an LTE network.
By default, no default APN is configured for an LTE network.
Format
profile create lte-default apn [ user username password { cipher | simple } password authentication-mode { chap | pap } ] sim-id sim-id
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn |
Specifies the default APN for an LTE network. |
The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
user username |
Specifies the user name provided by a carrier for accessing an external PDN. |
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
password { cipher | simple } password |
Specifies the password provided by a carrier for accessing an external PDN. The password types are as follows:
|
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
authentication-mode { chap | pap } |
Specifies the authentication mode.
|
- |
sim-id |
Specifies the ID of the SIM card to which the default APN is bound. |
The value is 1 or 2, corresponding to the device ID. |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to LTE networks through the default APN. In dual-card single-standby scenarios, if the two SIM cards need to connect to different carriers' LTE networks through different default APNs, you can run the profile create lte-default sim-id command to bind different default APNs to the IDs of the SIM cards, so that the corresponding default APN is delivered to the LTE modem during a SIM card switchover.
You can run the profile delete lte-default sim-id command to delete the default APN configured for an LTE network.
Precautions
This command applies only to LTE networks. This command takes effect only when the LTE modem and SIM/USIM card are installed.
APNs vary depending on LTE network carriers. You can obtain the APN from the local carrier.
If two SIM cards connect to a carrier's LTE network through the same default APN, it is recommended that you run the profile create lte-default command to configure the default APN.
If the profile create lte-default command has been configured, an error message will be displayed when the profile create lte-default sim-id command is configured. To run the profile create lte-default sim-id command, delete the original configuration first. Similarly, if the profile create lte-default sim-id command has been configured, you need to delete the command configuration first before running the profile create lte-default command.
If the profile create lte-default command has been executed to configure two SIM cards to connect to a carrier's LTE network through the same default APN, you can only delete the default APN configured for the LTE network using the profile delete lte-default command.
profile delete lte-default
Function
The profile delete lte-default command deletes the default APN configured for an LTE network.
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to LTE networks through the default APN, whereas other carriers do not have such requirements. To delete the default APN configured using the profile create lte-default command for an LTE network, run the profile delete lte-default command.
Precautions
This command applies only to LTE networks. This command takes effect only when the LTE modem and SIM/USIM card are installed.
profile delete lte-default sim-id
Function
The profile delete lte-default sim-id command deletes the default APN configured for an LTE network.
Parameters
Parameter |
Description |
Value |
|---|---|---|
sim-id |
Specifies the ID of the SIM card to which the default APN to be deleted is bound. |
The value is 1 or 2, corresponding to the device ID. |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to LTE networks through the default APN, whereas other carriers do not have such requirements. To delete the default APN configured for an LTE network using the profile create lte-default sim-id command, run the profile delete lte-default sim-id command.
Precautions
This command only applies to LTE networks. This command takes effect only when the LTE modem and SIM/USIM card are installed.
If the default APN for the SIM card to connect to a carrier's LTE network has been configured using the profile create lte-default sim-id command, you can only delete the default APN configured for the LTE network using the profile delete lte-default_sim-id command.
profile create default
Format
profile create default apn [ user username password { cipher | simple } password authentication-mode { chap | pap } ]
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn |
Specifies the default APN for a 5G network. |
The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
user username |
Specifies the user name provided by a carrier for accessing an external PDN. |
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
password { cipher | simple } password |
Specifies the password provided by a carrier for accessing an external PDN. The password types are as follows:
|
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
authentication-mode { chap | pap } |
Specifies the authentication mode.
|
- |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to 5G networks through the default APN, whereas other carriers do not have such requirements. If users are required to connect to a carrier's 5G network through the default APN, you can run the profile create default command to configure the default APN for the 5G network.
You can run the profile delete default command to delete the default APN configured for a 5G network.
Precautions
This command applies to 5G networks. This command takes effect only when the modem and SIM/USIM card are installed.
APNs vary depending on 5G network carriers. You can obtain the APN from the local carrier.
profile create default sim-id
Function
The profile create default command configures the default APN for a 5G network.
By default, no default APN is configured for a 5G network.
Format
profile create default apn [ user username password { cipher | simple } password authentication-mode { chap | pap } ] sim-id sim-id
Parameters
Parameter |
Description |
Value |
|---|---|---|
apn |
Specifies the default APN for a 5G network. |
The value is a string of characters that can contain only digits, uppercase letters, lowercase letters, periods (.), and hyphens (-). The length range is as follows:
To obtain the modem type, run the display cellular command and check the Model field. |
user username |
Specifies the user name provided by a carrier for accessing an external PDN. |
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
password { cipher | simple } password |
Specifies the password provided by a carrier for accessing an external PDN. The password types are as follows:
|
The value is a string of 1 to 127 case-sensitive characters. If the string is enclosed in double quotation marks (" "), the string can contain spaces. |
authentication-mode { chap | pap } |
Specifies the authentication mode.
|
- |
sim-id |
Specifies the ID of the SIM card to which the default APN is bound. |
The value is 1 or 2, corresponding to the device ID. |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to 5G networks through the default APN. In dual-card single-standby scenarios, if the two SIM cards need to connect to different carriers' 5G networks through different default APNs, you can run the profile create default sim-id command to bind different default APNs to the IDs of the SIM cards, so that the corresponding default APN is delivered to the 5G modem during a SIM card switchover.
You can run the profile delete default sim-id command to delete the default APN configured for a 5G network.
Precautions
This command applies to 5G networks. This command takes effect only when the modem and SIM/USIM card are installed.
APNs vary depending on 5G network carriers. You can obtain the APN from the local carrier.
If two SIM cards connect to a carrier's 5G network through the same default APN, it is recommended that you run the profile create default command to configure the default APN.
If the profile create default command has been configured, an error message will be displayed when the profile create default sim-id command is configured. To run the profile create default sim-id command, delete the original configuration first. Similarly, if the profile create default sim-id command has been configured, you need to delete the command configuration first before running the profile create default command.
If the profile create default command has been executed to configure two SIM cards to connect to a carrier's 5G network through the same default APN, you can only delete the default APN configured for the 5G network using the profile delete default command.
profile delete default
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to 5G networks through the default APN, whereas other carriers do not have such requirements. To delete the default APN configured using the profile create default command for an 5G network, run the profile delete default command.
Precautions
This command applies to 5G networks. This command takes effect only when the 5G modemand SIM/USIM card are installed.
profile delete default sim-id
Function
The profile delete default sim-id command deletes the default APN configured for an 5G network.
Parameters
Parameter |
Description |
Value |
|---|---|---|
sim-id |
Specifies the ID of the SIM card to which the default APN to be deleted is bound. |
The value is 1 or 2, corresponding to the device ID. |
Usage Guidelines
Usage Scenario
Some carriers require that devices connect to 5G networks through the default APN, whereas other carriers do not have such requirements. To delete the default APN configured for an 5G network using the profile create default sim-id command, run the profile delete default sim-id command.
Precautions
This command applies to 5G networks. This command takes effect only when the 5G modem and SIM/USIM card are installed.
If the default APN for the SIM card to connect to a carrier's 5G network has been configured using the profile create default sim-id command, you can only delete the default APN configured for the 5G network using the profile delete default_sim-id command.
reset counters cellular
Function
Using the reset counters cellular command, you can clear traffic statistics on a cellular interface or cellular channel interface.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
rssi-threshold
Function
The rssi-threshold command sets the RSSI threshold for successfully establishing a 3G/LTE/5G link. Only when the RSSI is greater than the threshold, a modem can establish a 3G/LTE/5G link successfully.
The undo rssi-threshold restores the default setting.
By default, a modem does not establish a 3G/LTE/5G link based on the RSSI threshold.
Parameters
Parameter |
Description |
Setting |
|---|---|---|
rssi-threshold |
Specifies the RSSI threshold for successfully establishing a 3G/LTE/5G link. |
The value is an integer that ranges from -120 to -60, in dBm. |
Usage Guidelines
Usage Scenario
Usually, signal quality does not affect 3G/LTE/5G link establishment by a modem in dialup mode. You can use the rssi-threshold command to configure signal quality to affect establishment and disconnection of 3G/LTE/5G links. When the RSSI is less than or equal to the threshold, the modem cannot establish 3G/LTE/5G link in dialup mode, and the established 3G/LTE/5G links will be disconnected.
- When services have high 3G/LTE/5G link quality requirements and will be greatly affected by poor link quality, set a large RSSI threshold to detect link quality and take measures in a timely manner.
- When services have low 3G/LTE/5G link quality requirements and will be slightly affected by poor link quality, set a small RSSI threshold to prevent establishment failures and disconnection of 3G/LTE/5G links.
Precautions
When you run the rssi-threshold rssi-threshold command multiple times on a cellular interface or cellular channel interface, only the latest configuration takes effect.
When you run the rssi-threshold command on both the cellular interface and cellular channel interface, only the configuration on the cellular channel interface takes effect.
service domain
Function
The service domain command configures the service domain of a modem.
By default, a modem works in both the CS domain and PS domain.
Parameters
Parameter |
Description |
Value |
|---|---|---|
ps-only |
Configures a modem to work only in the PS domain. |
- |
combined |
Configures a modem to work in both the CS domain and PS domain. |
- |
Usage Guidelines
Usage Scenario
The 3G network supports both the CS domain and PS domain. The LTE or 5G network supports only the PS domain. To prevent services in the CS domain from changing the network from an LTE or 5G network to a 3G network, you can run the service domain ps-only command to configure a modem to work only in the PS domain when it connects to an LTE or 5G network.
Precautions
You can run the display cellular command to view the configured service domain of a modem.
After configuring the service domain of a modem, run the modem reboot command to restart the modem to make the configuration take effect.
sim-card reboot
Usage Guidelines
Usage Scenario
A modem can automatically detect whether a SIM, USIM, or UIM card is properly installed. To restart a SIM, USIM, or UIM card, run the sim-card reboot command.
When this command is executed to manually restart a SIM, USIM, or UIM card, services on the specified cellular interface will be interrupted.
SIM, USIM, and UIM cards are not hot swappable.
To ensure that the installed SIM, USIM, and UIM cards work properly, run the sim-card reboot command to manually restart the cards after hot swapping these cards.
To check whether SIM, USIM, and UIM cards are working properly, run the display cellular command to view the SIM Status or UIM Status field.
sim-id
Function
The sim-id command sets the ID of a SIM card on an APN profile to determine the master or backup SIM card to be bound to the APN profile.
The undo sim-id command restores the default setting.
The default ID of a SIM card is 1.
Parameters
Parameter |
Description |
Value |
|---|---|---|
sim-id |
Specifies the ID of the SIM card bound to an APN profile. |
The value is 1 or 2.
|
Usage Guidelines
Usage Scenario
To improve data transmission reliability of the 3G or LTE or 5G link, you can use two 3G cellular interfaces. One cellular interface functions as the master link to connect to a 3G or LTE or 5G network, the other cellular interface functions as the backup link to connect to another 3G or LTE or 5G network. When the master 3G or LTE or 5G link is faulty, traffic is automatically switched to the backup 3G or LTE or 5G link, improving reliability of access to the Internet.
However, some devices do not support two cellular interfaces or the costs of two cellular interfaces are high for users. Users can use a cellular interface supporting dual SIM cards. One SIM card functions as the master SIM card, the other SIM card functions as the backup SIM card. The master and backup SIM cards connect to different 3G or LTE or 5G networks. If dial-up fails because the account balance of the master SIM card is insufficient, the master SIM card is faulty, the 3G or LTE or 5G link signal quality is poor, or the connected 3G or LTE or 5G network is faulty, traffic is automatically switched to the backup SIM card, ensuring uninterrupted enterprise services.
You can run the sim-id command on an APN profile to set the ID of a SIM card to determine the master or backup SIM card to be bound to the APN profile.
- When the APN profile is bound to the master SIM card, the cellular interface can connect to the 3G or LTE or 5G network through the master SIM card.
- When the APN profile is bound to the backup SIM card, the cellular interface can connect to the 3G or LTE or 5G network through the backup SIM card.
- When the cellular interface are bound both to the APN profiles, the master SIM card is preferentially used to connect to the 3G or LTE or 5G network. Only if dial-up fails because the account balance of the master SIM card is insufficient, the master SIM card is faulty, the 3G or LTE or 5G link signal quality is poor, or the connected 3G or LTE or 5G network is faulty, traffic is automatically switched to the backup SIM card.
Precautions
If you run the sim-id command in the same APN profile view multiple times, only the latest configuration takes effect.
The master and backup SIM cards cannot simultaneously work. Upon a SIM card switchover, traffic is interrupted for a short period.
sim switch to
Parameters
Parameter |
Description |
Value |
|---|---|---|
sim-id |
Specifies the ID of the SIM card to which services are switched. |
The value is 1 or 2.
|
Usage Guidelines
Usage Scenario
In a dual-SIM card scenario, if the automatic SIM card switchover function is not configured or the conditions for an automatic SIM card switchover are not met, and you need to quickly switch the SIM cards, run the sim switch to command to perform a manual SIM card switchover.
Precautions
- A manual SIM card switchover leads to service interruptions for a short period and affects service transmission. Exercise caution when performing this operation.
- After the SIM cards are switched using the sim switch to command, configurations cannot be saved and are restored to the configurations of the active SIM card once the device restarts.
- After an active/standby SIM card switchover, the modem automatically restarts. Exercise caution when performing this operation.
sim switch rssi-threshold
Function
The sim switch rssi-threshold command enables the active/standby SIM card switchover function based on the received signal strength indicator (RSSI) threshold.
The undo sim switch rssi-threshold command disables the active/standby SIM card switchover function based on the RSSI threshold.
By default, a cellular interface does not perform active/standby SIM card switchovers based on the RSSI threshold.
Parameters
Parameter |
Description |
Value |
|---|---|---|
rssi-threshold |
Specifies the RSSI threshold for an active/standby SIM card switchover. When the received signal strength is lower than the RSSI threshold, the cellular interface automatically performs an active/standby SIM card switchover. For example, if the RSSI threshold is –105 dBm, the SIM cards are switched when the received signal strength is lower than –105 dBm. |
The value is an integer in the range –120 to –60, in dBm. The recommended value is –105 dBm. |
Usage Guidelines
Usage Scenario
When two SIM cards are available, if the 3G, LTE, or 5G link signal quality on one SIM card is poor and affects data transmission, the other SIM card needs to provide 3G, LTE, or 5G services in time.
The RSSI indicates the strength of signals received on a cellular interface. You can run the sim switch rssi-threshold command to configure the active/standby SIM card switchover function based on the RSSI threshold. When the received signal strength is lower than the RSSI threshold, the cellular interface automatically performs an active/standby SIM card switchover.
Precautions
Set the RSSI threshold based on the 3G, LTE, or 5G link signal quality.
- A large RSSI threshold (for example, –70 dBm) results in frequent switchovers between SIM cards. As a result, traffic is frequently interrupted.
- A small RSSI threshold (for example, –110 dBm) results in no switchover between SIM cards even if the 3G, LTE, or 5G link signal quality is poor. As a result, users will always use SIM cards that provide poor 3G, LTE, or 5G services.
If you run the sim switch rssi-threshold rssi-threshold command multiple times in the same cellular interface view, only the latest configuration takes effect.
After an active/standby SIM card switchover, the modem automatically restarts. Exercise caution when performing this operation.
sim switch-back enable
Function
The sim switch-back enable command enables an automatic switchback from the standby SIM card to the active SIM card.
The undo sim switch-back enable command disables an automatic switchback from the standby SIM card to the active SIM card.
By default, traffic on the standby SIM card is not automatically switched back to the active SIM card.
Parameters
Parameter |
Description |
Value |
|---|---|---|
timer time |
Indicates the specified period of time after which traffic on the standby SIM card is automatically switched back to the active SIM card. When this parameter is not specified, traffic on the standby SIM card is automatically switched back to the active SIM card after 60 minutes. |
The value is an integer ranging from 1 to 65535, in minutes. |
Usage Guidelines
Usage Scenario
When two SIM cards are available, if the link signal quality of the active SIM card is poor or the connected carrier network is faulty, traffic is automatically switched to the standby SIM card. After a period of time, if the link signal quality becomes good or the connected carrier network is recovered, you can run the sim switch-back enable command to enable an automatic switchback from the standby SIM card to the active SIM card.
Precautions
If you run the sim switch-back enable timer time command multiple times in the same cellular interface view, only the latest configuration takes effect.
After you run the sim switch-back enable [ timer time ] command to enable an automatic switchback from the standby SIM card to the active SIM card, ensure that the link on the active SIM card can recover after the time specified by timer time expires. Otherwise, traffic is frequently switched between the active and standby SIM cards, affecting service transmission.
After an active/standby SIM card switchover, the modem automatically restarts. Exercise caution when performing this operation.
sms delete interface cellular
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
sms-id |
Specifies the ID of an SMS message to be deleted. |
The value is an integer that ranges from 0 to 255. |
all |
Deletes all SMS messages. |
- |
sms send interface cellular
Function
The sms send interface cellular command sends an SMS message to a specified destination number.
Parameters
Parameter |
Description |
Value |
|---|---|---|
interface-number |
Specifies the number of a cellular interface or cellular channel interface. |
- |
destination-telephone-number |
Specifies the destination number that receives the SMS message. |
The value is a string of 1 to 21 characters without spaces. It can contain an asterisk (*), a plus sign (+), a number sign (#), and digits 0 to 9. The plus sign (+) can be used only at the start of a character string. If a character string starts with a plus sign (+), the maximum string length is 21. If a character string starts with other characters, the maximum string length is 20. |
Usage Guidelines
Usage Scenario
To send an SMS message to a specified mobile number, you can run this command and write the SMS message to send it to the destination number.
Precautions
This command is an interactive command. After running the command, you can press Enter and enter the SMS message as prompted. Currently, the device can only send English SMS messages.
The content of an SMS message is a string of 0 to 160 case-sensitive characters with spaces. An SMS message uses a percent sign (%) as the terminator. The percent sign (%) is not included in the SMS message content.
A line feed in the SMS message content is considered as two characters, and cannot be deleted after being entered.
Example
# Configure the device to send the SMS message "I have received your message." to the user with the mobile number 13812345678.
<Huawei> system-view [Huawei] sms send interface cellular 2/0/0 +8613812345678 Info: Please input sms content within 160 characters, end with character '%': I have received your message.% Info: SMS send success.
sms-pool
Function
The sms-pool command displays the SMS service pool view.
The undo sms-pool command deletes all configurations in the SMS service pool view.
By default, there is no configuration in the SMS service pool view.
Usage Guidelines
Usage Scenario
Before running the sms item command to configure an SMS service, run the sms-pool command to enter the SMS service pool view.
Precautions
If an SMS service in the SMS service pool has been referenced by the sms send-item command, short messages cannot be sent after the undo sms-pool command is run to delete the configuration from the SMS service pool.
sms item
Function
The sms item command configures the phone numbers for receiving short messages, and short message content in the SMS service pool.
The undo sms item command deletes the configured SMS services.
By default, no SMS service is configured in the SMS service pool.
Parameters
Parameter |
Description |
Value |
|---|---|---|
item-id |
Specifies the ID of an SMS service. |
The value is an integer that ranges from 1 to 20. |
telephone-number tel-number |
User phone number for receiving short messages. A maximum of three phone numbers can be specified. NOTE:
A user's phone number must be valid; otherwise, the user cannot receive short messages. |
The value is a string of 1 to 21 characters. The value can contain the digits 0-9 and plus sign (+), and does not support spaces. In addition, the plus sign (+) can only be the first character in the value. When the first character is the plus sign (+), the maximum value length is 21. When the first character is a digit, the maximum value length is 20. |
content |
Specifies the short message content. NOTE:
This command is an interactive command. After running the command, press Enter and enter the short message content as prompted. |
The value is a string of 1 to 160 case-sensitive characters with spaces. The value ends with %. |
Usage Guidelines
Usage Scenario
After the SMS service is configured in the SMS service pool, run the sms send-item command on a service interface to reference the SMS service with a specified ID. When the service interface status changes, the short message preset in the SMS service is sent to the specified user phone number.
Precautions
A maximum of 20 SMS services can be configured in an SMS service pool. Each SMS service can be preset with 3 phone numbers. Each short message can contain at most 160 characters. The short message content is configured to end with %.
When the SMS service with a specified ID is referenced, it can be modified and can be deleted. If the SMS service is deleted, short messages cannot be sent.
Example
# Configure the SMS service with ID 1 to send the short message "The interface is in Up state." to the phone number +8613812345678.
<Huawei> system-view [Huawei] sms-pool [Huawei-sms-pool] sms item 1 telephone-number +8613812345678 content Info: Please input the sms content within 160 characters, end with '%': The interface is in Up state.%
sms send-item
Function
The sms send-item command configures the SMS alarm function on an interface to send a specified short message alarm to specific users when the interface status changes.
The undo sms send-item command deletes the configured SMS alarm function.
By default, the SMS alarm function is not configured on an interface.
Format
sms send-item item-id track-interface { up | down } [ after time ]
undo sms send-item item-id
Parameters
Parameter |
Description |
Value |
|---|---|---|
item-id |
Specifies the ID of the SMS service to be referenced. NOTE:
The value of item-id must have been configured using the sms item command; otherwise, the command cannot be run. |
The value is an integer that ranges from 1 to 20. |
track-interface { up | down } |
Sends a short message alarm when detecting that the link status changes. |
- |
after time |
Specifies the delay for sending a short message alarm. If after time is not specified, a short message alarm is sent immediately. After this parameter is specified, a short message alarm is sent only when the link status remains unchanged within the value of time. If the link status changes within the time, no short message alarm is sent. |
The value is an integer that ranges from 1 to 65535, in minutes. |
Usage Guidelines
Usage Scenario
In the scenario of active/standby interface backup, when the active and standby links are switched, the active/standby interface status changes. Users can view the alarm on the device to know the interface status change. If users want to sense the interface status change anytime and anywhere, run this command to configure the SMS alarm function on the interface. After the function is configured, the alarm with the interface status change is sent to users in a short message.
Prerequisites
The SMS service with a specified ID has been configured using the sms item command.
Precautions
Currently, the SMS alarm function can be configured on interfaces only when cellular, ATM, and serial interfaces are used as the active and standby interfaces.
This command can be run on each interface at most four times, and the latest configuration does not override the previous ones.
Example
# Configure the SMS alarm function on Cellular0/0/0 to send the short message "The interface is in Up state." to the phone number +8613812345678 when the link on the interface goes Up. Send the short message "The interface is still in Up state." to the phone number if services are not switched back to the active link after 120 minutes.
<Huawei> system-view [Huawei] sms-pool [Huawei-sms-pool] sms item 1 telephone-number +8613812345678 content Info: Please input the sms content within 160 characters, end with '%': The interface is in Up state.% [Huawei-sms-pool] sms item 2 telephone-number +8613812345678 content Info: Please input the sms content within 160 characters, end with '%': The interface is still in Up state.% [Huawei-sms-pool] quit [Huawei] interface cellular 2/0/0 [Huawei-Cellular2/0/0] sms send-item 1 track-interface up [Huawei-Cellular2/0/0] sms send-item 2 track-interface up after 120
sms service-center-address
Function
The sms service-center-address command configures the SMS center number on a cellular interface.
The undo sms service-center-address command deletes the configured SMS center number.
By default, no SMS center number is configured on a cellular interface.
Parameters
Parameter |
Description |
Value |
|---|---|---|
service-center-number |
Specifies the SMS center number. |
The value is a string of 1 to 21 characters. The value can contain the digits 0-9 and plus sign (+). It does not support spaces. In addition, the plus sign (+) can only be the first character in the value. When the first character is the plus sign (+), the maximum value length is 21. When the first character is a digit, the maximum value length is 20. |
snmp-agent trap enable feature-name ifmtrap
Function
The snmp-agent trap enable feature-name ifmtrap command enables the trap function for the IFM module.
The undo snmp-agent trap enable feature-name ifmtrap command disables the trap function for the IFM module.
By default, the trap function of IFM module is enabled.
Format
snmp-agent trap enable feature-name ifmtrap [ trap-name { hw3gmibtrapcellidchange | hw3gpinmodify | hwifnumalarm | hwportlinedown | hwportlineup | hwportphysicalethfullduplexclear | hwportphysicalethhalfduplexalarm | hwportspeedchangetrap } ]
undo snmp-agent trap enable feature-name ifmtrap [ trap-name { hw3gmibtrapcellidchange | hw3gpinmodify | hwifnumalarm | hwportlinedown | hwportlineup | hwportphysicalethfullduplexclear | hwportphysicalethhalfduplexalarm | hwportspeedchangetrap } ]
Parameters
| Parameter | Description | Value |
|---|---|---|
trap-name |
Enables the trap function for a specified event. If this parameter is not specified, all trap functions for the IFM module are enabled. |
- |
hw3gmibtrapcellidchange |
Enables the trap function for the cell ID change. |
- |
hw3gpinmodify |
Enables the trap function for the PIN change. |
- |
hwifnumalarm |
Enables the trap function for the number of interface reach the maximum. |
- |
hwportlinedown |
Enables the trap function for the port line turn into DOWN. |
- |
hwportlineup |
Enables the trap function for the port line turn into UP. |
- |
hwportphysicalethfullduplexclear |
Enables the trap function for the interface duplex mode change from half-duplex to full-duplex. |
- |
hwportphysicalethhalfduplexalarm |
Enables the trap function for the interface duplex mode change from full-duplex to half-duplex. |
- |
hwportspeedchangetrap |
Enables the trap function for the interface rate change. |
- |
user
Function
The user command configures the user name, password, and authentication mode for accessing an external PDN network.
The undo user command deletes the user configured for accessing an external PDN network.
By default, the user name, password, and authentication mode for accessing an external PDN network are not configured.
Format
user name username password { cipher | simple } password [ authentication-mode { auto | pap | chap } ]
undo user name username
Parameters
Parameter |
Description |
Value |
|---|---|---|
name username |
Specifies the user name for accessing an external PDN network, which is provided by the carrier. |
The value is a string of 1 to 64 case-sensitive characters without spaces. |
cipher |
Displays the password in cipher text. |
- |
simple |
Displays the password in plain text. NOTE:
When you specify simple, the password is saved in plain text in the configuration, which brings potential security risks. You are advised to specify cipher to save the password in the cipher text. |
- |
password |
Specifies the user password for accessing an external PDN network, which is provided by the carrier. |
The value is a case-sensitive character string without spaces. If simple is specified, the password is in plain text and contains 1 to 32 characters. If cipher is specified, the password is either in cipher text containing 24 to 68 characters, for example, %^%#k5bf>8df@:_;Na'+R"U,#L#w88HE1M.L4YY2~W2u0%RDL#z#%^%#, or in plain text containing 1 to 32 characters, for example, 214357. |
authentication-mode { auto | pap | chap } |
Specifies the authentication mode.
When the authentication-mode parameter is not specified, no authentication is performed by default. NOTE:
Select a proper authentication mode based on the carrier network. PAP authentication provides lower security. When you specify auto or pap to enable the device to use PAP authentication, the password is transmitted in plain text on the network. This brings potential security risks. |
- |
Usage Guidelines
Usage Scenario
A user uses a cellular interface to access an external PDN network through a network. To ensure information security, the external PDN network authenticates the access user. The user can use the cellular interface to perform data communication with the external PDN network through a network only after the user passes the authentication.
Precautions
Contact the carrier when configuring the user name, password, and authentication mode.
- Support for Cellular Interfaces
- apn
- apn profile
- apn-profile
- band auto
- band gsm
- band wcdma
- band lte
- band nr
- cellular log enable
- cellular log rssi-threshold
- cellular log sinr-threshold
- cellular log rsrp-threshold
- cellular log nr-sinr-threshold
- cellular log nr-rsrp-threshold
- dialer mode ppp
- dialer-number (APN view)
- dialer timer probe-interval
- display apn-profile configuration
- diagnostics-monitor-port on
- display cellular
- display interface cellular
- display cellular encryption-algorithm
- display cellular feature
- display sms interface cellular
- display sms interface cellular statistics
- display sms send-history
- display snmp-agent trap feature-name ifmtrap all
- interface cellular
- ip address negotiate
- mode lte
- mode wcdma
- mode 5g
- modem auto-recovery track nqa
- modem auto-recovery track action
- modem auto-recovery icmp-unreachable action modem-reboot
- modem auto-recovery dial action modem-reboot fail-times
- modem auto-recovery services-unavailable action modem-reboot
- modem auto-recovery services-unavailable action sim-switch
- modem encryption-algorithm
- modem reboot
- modem peer network-route
- mtu(3G/LTE/5G)
- multi-apn enable
- packet-service recover
- pin modify
- pin unlock
- pin verification
- pin verify
- plmn search
- plmn select
- profile create
- profile delete
- profile create lte-default
- profile create lte-default sim-id
- profile delete lte-default
- profile delete lte-default sim-id
- profile create default
- profile create default sim-id
- profile delete default
- profile delete default sim-id
- reset counters cellular
- rssi-threshold
- service domain
- sim-card reboot
- sim-id
- sim switch to
- sim switch rssi-threshold
- sim switch-back enable
- sms delete interface cellular
- sms send interface cellular
- sms-pool
- sms item
- sms send-item
- sms service-center-address
- snmp-agent trap enable feature-name ifmtrap
- user