SupportDocumentationRoutersAccess RoutersAR5700&6700&8000Reference GuidesCommand Reference

NetEngine AR5700, AR6700, and AR8000 V600R022C00 Command Reference

5G Interface Configuration Commands

5G Interface Configuration Commands

5G interfaces can be configured only on the models that support 5G cards. For details about the models that support 5G cards, see "Version Mapping" in "Get to Know the Product > Hardware Description > Cards > 5G Card."

apn

Function

The apn command configures an APN in an APN profile.

The undo apn command deletes the APN configured in an APN profile.

By default, the device uses the APN profile name as the APN name.

This command is supported only on the AR8100 series and AR6700 series.

Format

apn apn-name

undo apn

Parameters

Parameter Description Value
apn-name

Specifies an APN.

The value is a string of 1 to 99 case-sensitive characters, and cannot contain spaces. The value can contain letters, digits, dots (.), and hyphens (-), and must start and end with a letter or digit.

Views

APN template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An APN identifies an external public data network (PDN) that users want to access, for example, the Internet or International Mobile Subscriber (IMS) network.

Precautions

  • To obtain an APN, contact the local carrier.
  • After an APN is configured, the APN is recorded in the modem. If the APN changes, you need to reconfigure it.
  • If you run the apn command multiple times in the same APN profile view, only the latest configuration takes effect.

Example

# Configure the APN 5gnet in an APN profile.
<HUAWEI> system-view
[HUAWEI] apn-profile 5gprofile
[HUAWEI-apn-profile-5gprofile] apn 5gnet

apn-profile (cellular channel interface view)

Function

The apn-profile command binds an APN profile to a cellular channel interface.

The undo apn-profile command unbinds an APN profile from a cellular channel interface.

By default, no APN profile is bound to a cellular channel interface.

This command is supported only on the AR8100 series and AR6700 series.

Format

apn-profile profile-name [ priority priority ]

undo apn-profile profile-name

Parameters

Parameter Description Value
profile-name

Specifies an APN profile name.

The value is a string of 1 to 64 case-sensitive characters, and cannot contain spaces. The value can contain letters, digits, dots (.), and hyphens (-), and must start and end with a letter or digit.
priority priority

Specifies an APN profile priority.

The value is an integer in the range from 1 to 255. The default value is 100.

A larger value indicates a higher priority.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After configuring an APN profile, you must bind the APN profile to a cellular channel interface so that the APN profile configuration can take effect on the cellular channel interface.

Precautions

After an APN profile is bound to a cellular channel interface not for the first time, you need to run the shutdown and undo shutdown commands or run the restart command to restart the interface for the configuration to take effect.

Example

# Bind the APN profile 5Gnet to a cellular channel interface.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] apn-profile 5Gnet
[HUAWEI-Cellular2/0/0:1] shutdown
[HUAWEI-Cellular2/0/0:1] undo shutdown

apn-profile (system view)

Function

The apn-profile command creates an APN profile and displays the APN profile view.

The undo apn-profile command deletes an APN profile.

By default, no APN profile is created on the device.

This command is supported only on the AR8100 series and AR6700 series.

Format

apn-profile profile-name

undo apn-profile profile-name

Parameters

Parameter Description Value
profile-name

Specifies the APN profile name.

The value is a string of 1 to 64 case-sensitive characters, spaces not supported. The value can be any combination of letters, digits, dots (.), and hyphens (-), and must start and end with a letter or digit.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After creating an APN profile, you can configure an APN in the APN profile so that users can use the configured APN to access an external PDN.

Follow-up Procedure

Run the user command to configure the user name, password, and authentication mode for accessing the APN gateway.

Example

# Create APN profile 5gprofile and display the APN profile view.
<HUAWEI> system-view
[HUAWEI] apn-profile 5gprofile
[HUAWEI-apn-profile-5gprofile]

apn-profile default-bearer

Function

The apn-profile default-bearer command configures the default APN for a WLAN.

The undo apn-profile default-bearer command deletes the default APN for a WLAN.

By default, no default APN is configured.

This command is supported only on the AR8100 series and AR6700 series.

Format

apn-profile default-bearer apn-name [ user username password password authentication-mode { pap | chap } ] sim-id sim-id

undo apn-profile default-bearer sim-id sim-id

Parameters

Parameter Description Value
apn-name

Specifies the APN name.

The value is a string of 1 to 99 case-sensitive characters, and cannot contain spaces. The value can contain letters, digits, dots (.), and hyphens (-), and must start and end with a letter or digit.
user username

Specifies the user name for accessing an external PDN, which is provided by the carrier.

The value is a string of 1 to 64 case-sensitive characters, and cannot contain spaces.
password password

Specifies the password for accessing an external PDN, which is provided by the carrier.

The value is a string of 1 to 64 case-sensitive characters in plain text, without spaces.
authentication-mode

Specifies the authentication mode.

-
pap

Specifies the PAP authentication mode.

-
chap

Specifies the CHAP authentication mode.

-
sim-id sim-id

Specifies the ID of the SIM card associated with an APN profile.

The value is 1 or 2.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Some carriers require that devices connect to wireless networks through the default APN. In dual-card single-standby scenarios, if the two SIM cards need to connect to carrier networks through different default APNs, you can run the apn-profile default-bearer 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 module during a SIM card switchover.

After the default APN function is configured, if no APN profile is bound to a cellular interface, the cellular interface uses the default APN configuration for dial-up connection.

You can run the undo apn-profile default-bearer sim-id command to delete the default APN configured for a wireless network.

Example

# Configure the default APN.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] apn-profile default-bearer net user huawei password YsHsjx_202206 authentication-mode chap sim-id 1

band auto

Function

The band auto command enables a cellular interface to automatically select the working frequency band for conneting to a WCDMA, LTE, or 5G network.

By default, a cellular interface automatically selects the working frequency band for connecting to a WCDMA, LTE, or 5G network.

This command is supported only on the AR8100 series and AR6700 series.

Format

band auto

Parameters

None

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Network carriers usually provide multiple frequency bands for user access. After the device connects to a WCDMA, LTE, or 5G network, you can run the band auto command to configure the modem to automatically adjust its working frequency band to adapt to network environment changes.

Example

# Configure an interface to automatically select the working frequency band for network access in the cellular profile view.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] band auto

band lte

Function

The band lte command configures the operating frequency band for a cellular interface to connect to an LTE network.

The undo band lte command restores the default operating frequency band for a cellular interface to connect to an LTE network.

By default, a cellular interface automatically selects the operating frequency band for connecting to an LTE network.

This command is supported only on the AR8100 series and AR6700 series.

Format

band lte { band1 | band2 | band3 | band5 | band7 | band8 | band20 | band28 | band34 | band38 | band39 | band40 | band41 } *

undo band lte

Parameters

Parameter Description Value
band1

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 1 (the transmit band is 1920 MHz to 1980 MHz and the receive band is 2110 MHz to 2170 MHz).

-
band2

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 2 (the transmit band is 1850 MHz to 1910 MHz and the receive band is 1930 MHz to 1990 MHz).

-
band3

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 3 (the transmit band is 1710 MHz to 1785 MHz and the receive band is 1805 MHz to 1880 MHz).

-
band5

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 5 (the transmit band is 824 MHz to 849 MHz and the receive band is 869 MHz to 894 MHz).

-
band7

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 7 (the transmit band is 2500 MHz to 2570 MHz and the receive band is 2620 MHz to 2690 MHz).

-
band8

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 8 (the transmit band is 880 MHz to 915 MHz and the receive band is 925 MHz to 960 MHz).

-
band20

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 20 (the transmit band is 832 MHz to 862 MHz and the receive band is 791 MHz to 821 MHz).

-
band28

Sets the frequency band in which a cellular interface connected to an LTE network operates to Band 28 (the transmit band is 703 MHz to 748 MHz and the receive band is 758 MHz to 803 MHz).

-
band34

Sets the frequency band in which a cellular interface connected to an LTE network operates to 2010 MHz to 2025 MHz.

-
band38

Sets the frequency band in which a cellular interface connected to an LTE network operates to 2570 MHz to 2620 MHz.

-
band39

Sets the frequency band in which a cellular interface connected to an LTE network operates to 1880 MHz to 1920 MHz.

-
band40

Sets the frequency band in which a cellular interface connected to an LTE network operates to 2300 MHz to 2400 MHz.

-
band41

Sets the frequency band in which a cellular interface connected to an LTE network operates to 2496 MHz to 2690 MHz.

-

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

LTE networks operated by network carriers usually provide multiple frequency bands for users to access. If a cellular interface is connected to an LTE network and the LTE network frequency band changes, the modem automatically adjusts the working frequency band to adapt to the network environment change. This affects LTE link stability.

If the frequency band of an LTE network is fixed, you can run the band lte command to set the frequency band in which a cellular interface connected to the LTE network operates. This prevents frequency band changes caused by frequency interference and ensures LTE link stability.

Precautions

  • This command is valid only when a modem is properly installed on the cellular interface.
  • You can run the display cellular command and then check the Current Network Connection field in the command output to determine whether the cellular interface is connected to an LTE network.
  • You need to confirm the frequency bands of the LTE network in your area with the network carrier, so that you can set the most suitable working frequency band.

Example

# Set the frequency band in which a cellular interface connected to an LTE network operates to band1.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] band lte band1
# Restore the default operating frequency band for a cellular interface to connect to an LTE network.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] undo band lte

band nr

Function

The band nr command configures the operating frequency band for a cellular interface to connect to a 5G network.

The undo band nr command restores the default operating frequency band for a cellular interface to connect to a 5G network.

By default, a cellular interface automatically selects the operating frequency band for connecting to a 5G network.

This command is supported only on the AR8100 series and AR6700 series.

Format

band nr { n1 | n28 | n41 | n77 | n78 | n79 } *

undo band nr

Parameters

Parameter Description Value
n1

Sets the frequency band in which a cellular interface connected to an NR network operates to n1 (the transmit band is 1920 MHz to 1980 MHz and the receive band is 2110 MHz to 2170 MHz).

-
n28

Sets the frequency band in which a cellular interface connected to an 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 an NR network operates to 2496 MHz to 2690 MHz.

-
n77

Sets the frequency band in which a cellular interface connected to an NR network operates to 3300 MHz to 4200 MHz.

-
n78

Sets the frequency band in which a cellular interface connected to an NR network operates to 3300 MHz to 3800 MHz.

-
n79

Sets the frequency band in which a cellular interface connected to an NR network operates to 4400 MHz to 5000 MHz.

-

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

5G networks operated by network carriers usually provide multiple frequency bands for users to access. If a cellular interface is connected to a 5G network and the 5G network frequency band changes, the modem automatically adjusts the working frequency band to adapt to the network environment change. This affects 5G link stability.

If the frequency band of a 5G network is fixed, you can run the band nr command to set the frequency band in which a cellular interface connected to the 5G network operates. This prevents frequency band changes caused by frequency interference and ensures 5G link stability.

Precautions

  • This command is valid only when a modem is properly installed on the cellular interface.
  • You can run the display cellular command and then check the Current Network Connection field in the command output to determine whether the cellular interface is connected to a 5G network.
  • You need to confirm the frequency bands of the 5G network in your area with the network carrier, so that you can set the most suitable working frequency band.

Example

# Set the frequency band in which a cellular interface connected to a 5G network operates to n41.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] band nr n41
# Restore the default operating frequency band for a cellular interface to connect to a 5G network.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] undo band nr

band wcdma

Function

The band wcdma command configures the operating frequency band for a cellular interface to connect to a WCDMA network.

The undo band wcdma command restores the default operating frequency band for a cellular interface to connect to a WCDMA network.

By default, a cellular interface automatically selects the operating frequency band for connecting to a WCDMA, LTE, or 5G network.

This command is supported only on the AR8100 series and AR6700 series.

Format

band wcdma { wcdma2100 | wcdma1900 | wcdma850 | wcdma900 } *

undo band wcdma

Parameters

Parameter Description Value
wcdma2100

Sets the frequency band in which a cellular interface connected to a WCDMA network operates to 2100 MHz.

-
wcdma1900

Sets the frequency band in which a cellular interface connected to a WCDMA network operates to 1900 MHz.

-
wcdma850

Sets the frequency band in which a cellular interface connected to a WCDMA network operates to 850 MHz.

-
wcdma900

Sets the frequency band in which a cellular interface connected to a WCDMA network operates to 900 MHz.

-

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

WCDMA networks operated by network carriers usually provide multiple frequency bands for users to access. If a cellular interface is connected to a WCDMA network and the WCDMA network frequency band changes, the modem automatically adjusts the working frequency band to adapt to the network environment change. This affects WCDMA link stability.

If the frequency band of a WCDMA network is fixed, you can run the band wcdma command to set the frequency band in which a cellular interface connected to the WCDMA network operates. This prevents frequency band changes caused by frequency interference and ensures WCDMA link stability.

Precautions

  • This command is valid only when a modem is properly installed on the cellular interface.
  • You can run the display cellular command and then check the Current Network Connection field in the command output to determine whether the cellular interface is connected to a WCDMA network.
  • You need to confirm the frequency bands of the WCDMA network in your area with the network carrier, so that you can set the most suitable working frequency band.

Example

# Configure a cellular interface to connect to a WCDMA network on the 1900 MHz and 900 MHz frequency bands.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] band wcdma wcdma1900 wcdma900
# Restore the default operating frequency band for a cellular interface to connect to a WCDMA network.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] undo band wcdma

cellular log enable

Function

The cellular log enable command enables the cellular log function.

The undo cellular log enable command disables the cellular log function.

By default, the cellular log function is enabled.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular log enable

undo cellular log enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To view the signal strength change, cell ID change, or network type change in logs, run the cellular log enable command to enable the cellular log function.

Example

# Enable the cellular log function.
<HUAWEI> system-view
[HUAWEI] cellular log enable
# Disable the cellular log function.
<HUAWEI> system-view
[HUAWEI] undo cellular log enable

cellular log lte-rsrp-threshold

Function

The cellular log lte-rsrp-threshold command sets the RSRP (Reference Signal Received Power) threshold for determining the LTE signal strength in cellular logs.

The undo cellular log lte-rsrp-threshold command restores the default RSRP threshold for determining the LTE signal strength in cellular logs.

By default, the RSRP threshold used to determine the LTE signal strength in cellular logs is –110 dBm.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular log lte-rsrp-threshold rsrp-threshold

undo cellular log lte-rsrp-threshold

Parameters

Parameter Description Value
rsrp-threshold

Specifies the RSRP threshold used to determine the LTE signal strength in cellular logs, in –dBm.

The value is an integer in the range from 80 to 136. The default value is 110.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To view the LTE signal strength change in logs, run the cellular log enable command to enable the cellular log function. You can run the cellular log lte-rsrp-threshold command to configure the RSRP threshold for determining the LTE signal strength. The device records signal strength change logs based on the threshold.

  • If the strength of received signals is greater than the RSRP threshold 10 consecutive times and the signal strength becomes normal, the device records the WWAN/5/WWAN_LTE_RSRP_NORMAL log.
  • If the strength of received signals is not greater than the RSRP threshold 10 consecutive times and the signal strength becomes weak, the device records the WWAN/5/WWAN_LTE_RSRP_WEAK log.

Prerequisites

Before running the cellular log lte-rsrp-threshold command to record logs based on a configured threshold, you must run the cellular log enable command to enable the cellular log function.

Example

# Set the RSRP threshold used to determine the LTE signal strength to –80 dBm.
<HUAWEI> system-view
[HUAWEI] cellular log enable
[HUAWEI] cellular log lte-rsrp-threshold 80

cellular log lte-sinr-threshold

Function

The cellular log lte-sinr-threshold command sets the signal to interference plus noise ratio (SINR) threshold used to determine the LTE signal strength in cellular logs.

The undo cellular log lte-sinr-threshold command restores the default SINR threshold used to determine the LTE signal strength in cellular logs.

By default, the SINR threshold used to determine the LTE signal strength in cellular logs is 10 dB.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular log lte-sinr-threshold sinr-threshold

undo cellular log lte-sinr-threshold

Parameters

Parameter Description Value
sinr-threshold

Specifies the SINR threshold used to determine the LTE signal strength in cellular logs, in dB.

The value is an integer in the range from 0 to 30. The default value is 10.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To view the LTE signal strength change in logs, run the cellular log enable command to enable the cellular log function. You can run the cellular log lte-sinr-threshold command to configure the SINR threshold for determining the LTE signal strength. The device records signal strength change logs based on the threshold.

  • If the strength of received signals is greater than the SINR threshold 10 consecutive times and the signal strength becomes normal, the device records the WWAN/5/WWAN_LTE_SINR_NORMAL log.
  • If the strength of received signals is not greater than the SINR threshold 10 consecutive times and the signal strength becomes weak, the device records the WWAN/5/WWAN_LTE_SINR_WEAK log.

Example

# Set the SINR threshold used to determine the LTE signal strength to 15 dB.
<HUAWEI> system-view
[HUAWEI] cellular log enable
[HUAWEI] cellular log lte-sinr-threshold 15

cellular log nr-rsrp-threshold

Function

The cellular log nr-rsrp-threshold command configures the RSRP (Reference Signal Received Power) threshold for determining the NR signal strength in cellular logs.

The undo cellular log nr-rsrp-threshold command restores the default RSRP threshold for determining the NR signal strength in cellular logs.

By default, the RSRP threshold used to determine the NR signal strength in cellular logs is –110 dBm.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular log nr-rsrp-threshold rsrp-threshold

undo cellular log nr-rsrp-threshold

Parameters

Parameter Description Value
rsrp-threshold

Specifies the RSRP threshold used to determine the NR signal strength in cellular logs, in –dBm.

The value is an integer in the range from 80 to 136. The default value is 110.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To view the NR signal strength change in logs, run the cellular log enable command to enable the cellular log function. You can run the cellular log nr-rsrp-threshold command to set the RSRP threshold for determining the NR signal strength. The device records signal strength change logs based on the threshold.

  • If the strength of received signals is greater than the RSRP threshold 10 consecutive times and the signal strength becomes normal, the device records the WWAN/5/WWAN_NR_RSRP_NORMAL log.
  • If the strength of received signals is not greater than the RSRP threshold 10 consecutive times and the signal strength becomes weak, the device records the WWAN/5/WWAN_NR_RSRP_WEAK log.

Example

# Set the RSRP threshold used to determine the NR signal strength in cellular logs to –80 dBm.
<HUAWEI> system-view
[HUAWEI] cellular log enable
[HUAWEI] cellular log nr-rsrp-threshold 80

cellular log nr-sinr-threshold

Function

The cellular log nr-sinr-threshold command sets the Signal to Interference Plus Noise Ratio (SINR) threshold for determining the NR signal strength in cellular logs.

The undo cellular log nr-sinr-threshold command restores the default SINR threshold used to determine the NR signal strength in cellular logs.

By default, the SINR threshold used to determine the NR signal strength in cellular logs is 10 dB.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular log nr-sinr-threshold sinr-threshold

undo cellular log nr-sinr-threshold

Parameters

Parameter Description Value
sinr-threshold

Specifies the SINR threshold used to determine the NR signal strength in cellular logs, in dB.

The value is an integer in the range from 0 to 30. The default value is 10.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To view the NR signal strength change in logs, run the cellular log enable command to enable the cellular log function. You can run the cellular log nr-sinr-threshold command to set the SINR threshold for determining the NR signal strength. The device records signal strength change logs based on the threshold.

  • If the strength of received signals is greater than the SINR threshold 10 consecutive times and the signal strength becomes normal, the device records the WWAN/5/WWAN_NR_SINR_NORMAL log.
  • If the strength of received signals is not greater than the SINR threshold 10 consecutive times and the signal strength becomes weak, the device records the WWAN/5/WWAN_NR_SINR_WEAK log.

Example

# Set the SINR threshold used to determine the NR signal strength in cellular logs to 15 dB.
<HUAWEI> system-view
[HUAWEI] cellular log enable
[HUAWEI] cellular log nr-sinr-threshold 15

cellular-profile (cellular interface view)

Function

The cellular-profile command binds a cellular profile to a cellular interface.

The undo cellular-profile command unbinds a cellular profile from a cellular interface.

By default, no cellular profile is bound to a cellular interface.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular-profile profile-name

undo cellular-profile profile-name

Parameters

Parameter Description Value
profile-name

Specifies the name of a cellular profile.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value can contain letters, digits, dots (.), and hyphens (-).

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

After configuring a cellular profile, you must bind the cellular profile to a cellular interface so that the cellular profile configuration can take effect on the cellular interface.

Example

# Bind the cellular profile 5Gnet to a cellular interface.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] cellular-profile 5Gnet

cellular-profile (system view)

Function

The cellular-profile command creates a cellular profile and displays the cellular profile view.

The undo cellular-profile command deletes a cellular profile.

By default, no cellular profile is created on the device.

This command is supported only on the AR8100 series and AR6700 series.

Format

cellular-profile profile-name

undo cellular-profile profile-name

Parameters

Parameter Description Value
profile-name

Specifies the cellular profile name.

The value is a string of 1 to 64 case-sensitive characters, and cannot contain spaces. The value can be any combination of letters, digits, dots (.), and hyphens (-).

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After creating a cellular profile, you can configure a modem in the cellular profile so that users can use the cellular profile to access an external PDN.

Example

# Create cellular profile 5gprofile and display the cellular profile view.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gprofile
[HUAWEI-cellular-profile-5gprofile]

dialer timer

Function

The dialer timer command sets the automatic dial-up interval.

The undo dialer timer command restores the default automatic dial-up interval.

By default, the automatic dial-up interval is 10 seconds and exponential backoff is disabled.

This command is supported only on the AR8100 series and AR6700 series.

Format

dialer timer { seconds seconds | minutes minutes } [ exponential [ times times ] ]

undo dialer timer

Parameters

Parameter Description Value
seconds seconds

Specifies the interval for initiating the next dial-up attempt, in seconds.

The value is an integer in the range from 1 to 604800. The default value is 10.
minutes minutes

Specifies the interval for initiating the next dial-up attempt, in minutes.

The value is an integer in the range from 1 to 10080.
exponential

Indicates whether exponential backoff is enabled.

-
times times

Indicates the maximum number of exponential backoff times at the specified dial-up interval.

The value is an integer in the range from 1 to 16. The default value is 5.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

After the ip address modem-alloc command is run on a device, if the device fails to set up a dial-up connection with the peer end, it attempts to set up a dial-up connection again at a specified interval. You can run the dialer timer command to set this interval.<br /> To prevent the core network from identifying frequent dial-up attempts as network attacks, you can set run the dialer timer seconds exponential command to specify the exponential dial-up interval. The interval for the nth dial-up attempt is calculated as follows: T(n) = T(n-1) + 2^n + Random (180 x n). After the number of dial-up attempts exceeds n, the device still attempts to set up a dial-up connection, but the dial-up interval does not back off.

Example

# Set the automatic dial-up interval to 90 seconds in the cellular profile 5gprofile.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gprofile
[HUAWEI-cellular-profile-5gprofile] dialer timer seconds 90

display apn-profile configuration

Function

The display apn-profile configuration command displays the configuration of APN profiles.

This command is supported only on the AR8100 series and AR6700 series.

Format

display apn-profile configuration [ apn-profile-number ]

Parameters

Parameter Description Value
apn-profile-number

Specifies the number of APN profiles to be displayed.

  • If this parameter is specified, the configurations of APN profiles are displayed in the sequence in which they were configured.
  • If this parameter is not specified, the configurations of all APN profiles are displayed.

The value is an integer in the range from 1 to 32.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the configuration of existing APN profiles on the device.

Example

The actual command output varies according to the device. The command output here is only an 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
Table 2-64 Description of the display apn-profile configuration command output
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 a user name for accessing an external PDN, run the user command.
sim-id

SIM card ID.

To configure a SIM card ID in an APN profile, run the sim-id command.
authentication-mode

Authentication mode for users to access an external PDN:

  • auto: PAP or CHAP authentication.
  • pap: PAP authentication.
  • chap: CHAP authentication.
  • null: no authentication.

You can run the user command with the authentication-mode parameter specified to configure the authentication mode for users to access an external PDN.

If the authentication-mode parameter is not specified, the value null is used by default.

display cellular

Function

The display cellular command displays information about call sessions on a modem.

This command is supported only on the AR8100 series and AR6700 series.

Format

display { cellular interface-number | interface-name } { all | hardware | sim | network | radio | apn | modem-configuration }

Parameters

Parameter Description Value
interface-number

Specifies an interface number.

The value depends on device hardware configuration.
all

Displays information about all call sessions on a modem, including hardware information, SIM card information, network information, wireless information, and APN profile information.

-
hardware

Displays hardware information about a modem.

-
sim

Display SIM card information about a modem.

-
network

Displays network information about a modem.

-
radio

Displays wireless information about a modem.

-
apn

Displays APN information about a modem.

-
modem-configuration

Displays configuration information about a modem.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display cellular command to view information about call sessions on a modem, including hardware information, SIM card information, network information, wireless information, APN profile information, or all the preceding information.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display hardware information about a modem.
<HUAWEI> display cellular 2/0/0 hardware
Hardware Information: 
  Modem Type                  : 5G modem
  Modem Firmware Version      : 11.870.02.10.11 
  International Mobile Equipment Identity (IMEI)  : 354661034412719
# Display SIM card information about a modem.
<HUAWEI> display cellular 2/0/0 sim
SIM Information:
  Current SIM ID              : 1
  SIM Status                  : Normal
  PIN Status                  : Ready
  Number of Retries remaining : 3
  Integrate circuit card identity (ICCID)         : 98681011274300909893
  International Mobile Subscriber Identity (IMSI) : 460016002707237
# Display network information about a modem.
<HUAWEI> display cellular 2/0/0 network
Network Information:
  Mobile Operator Information : CHN-CUGSM
  Mobile Country Code (MCC)   : 460
  Mobile Network Code (MNC)   : 01
  Tracking Area Code (TAC)    : 1002
  Cell ID                     : 6012
  Packet Service              : Attached
  Current Service Status      : Service available
# Display wireless information about a modem.
<HUAWEI> display cellular 2/0/0 radio
Radio Information:
  Current Network Connection  : 5G(NSA)
  LTE:
    Current Band : B3
    Current RSSI : -48 dBm
    Current RSRP : -69 dBm(strong)
    Current RSRQ : -3 dB
    Current SINR : 22 dB
  NR:
    Current Band : N78
    Current RSRP : -81 dBm(strong)
    Current RSRQ : -10 dB
    Current SINR : 35 dB
  Bands supported :
    WCDMA     : WCDMA2100  WCDMA1900 WCDMA850 WCDMA900
    FDD LTE   : B1 B2 B3 B5 B7 B8 B20 B28
    TDD LTE   : B34 B38 B39 B40 B41
    FDD NR    : N1 N28
    TDD NR    : N41 N77 N78 N79
# Display APN information about a modem.
<HUAWEI> display cellular 2/0/0 apn
APN Information:
  NO  Access Point Name         Packet Session State
  0   a1                        -                                                                                                  
  1   me906                     Active
  2   test11111111111111111111  Active
# Display the module configuration.
[HUAWEI-diagnose] display cellular 2/0/0 modem-configuration
Current Bands config:                                                                                                               
 WCDMA  : Auto                                                                                                                      
 LTE    : Auto                                                                                                                      
 NR     : Auto                                                                                                                      
Network Selection Mode  : Auto                                                                                                      
Network Connection Mode : Auto                                                                                                      
Upgrade state           : Idle                                                                                                      
Last upgrade state      : None
# Display all information about the module in 3G mode.
[HUAWEI-diagnose] display  Cellular 3/0/0 all
Hardware Information: 
  Modem Type                  : 5G modem
  Modem Firmware Version      : 11.870.02.10.11 
  International Mobile Equipment Identity (IMEI)  : 354661034412719                                                              
SIM Information:                                                                                                                    
  Current SIM ID              : 1                                                                                                   
  SIM Status                  : Lock auto-verify                                                                                    
  PIN Status                  : Ready                                                                                               
  Number of Retries remaining : 3                                                                                                   
  Integrate circuit card identity (ICCID)         : 98681020100202000064                                                            
  International Mobile Subscriber Identity (IMSI) : 369770075592946                                                                 
Network Information:                                                                                                                
  Mobile Operator Information : None                                                                                                
  Mobile Country Code (MCC)   : 369                                                                                                 
  Mobile Network Code (MNC)   : 77                                                                                                  
  Location Area Code (LAC)    : 5003                                                                                                
  Cell ID                     : 81969154                                                                                            
  Packet Service              : Attached                                                                                            
  Current Service Status      : Service available                                                                                   
Radio Information:                                                                                                                  
  Current Network Connection: WCDMA                                                                                                                                                                                                                                                                                                                                       
    Current RSSI : -73 dBm                                                                                            
    Current RSCP: -3 dB                                                                                                            
    Current ECIO: 28 dB                                                                                                           
  Bands supported:                                                                                                                  
    WCDMA  : WCDMA2100 WCDMA1900 WCDMA850 WCDMA900                                                                                  
    FDD LTE: B1 B2 B3 B5 B7 B8 B20 B28                                                                                              
    TDD LTE: B34 B38 B39 B40 B41                                                                                                    
    FDD NR : N1 N28                                                                                                                 
    TDD NR : N41 N77 N78 N79                                                                                                        
APN Information:                                                                                                                    
  NO  Access Point Name  Packet Session State                                                                                       
  1   -                  Active                                                                                                     
  2   -                  Active                                                                                                     
  3   -                  Active                                                                                                     
  4   -                  Inactive
Table 2-65 Description of the display cellular command output
Item Description
Hardware Version

Hardware version.
Hardware Information

Hardware information.
Modem Type

Modem type:

  • WCDMA.
  • LTE.
  • 5G.
Modem Firmware Version

Firmware version of the modem.
International Mobile Equipment Identity (IMEI)

International mobile equipment identity (IMEI).
International Mobile Subscriber Identity (IMSI)

International mobile subscriber identity (IMSI).
Mobile Operator Information

Carrier information.
Mobile Country Code (MCC)

Mobile country code (MCC).
Mobile Network Code (MNC)

Mobile network code (MNC).
SIM Status

SIM card status:

  • Normal: The SIM card status is normal.
  • Invalid: The SIM card status is abnormal.
  • Not insert: No SIM card is inserted into the device.
  • Lock enable: The SIM card lock is enabled.
  • Lock auto-verify: The SIM card lock and automatic PIN authentication functions are enabled.
SIM Information

SIM card information.
Current SIM ID

Current SIM card slot ID.
Current Service Status

Current service status:

  • Service available: Services are available currently.
  • No service: No service is available.
  • Emergency: Only the emergency service is available.
  • Region emergency: The regional emergency service is available.
  • Saving status: The modem is in power saving and deep sleep state.
Current Network Connection

Type of the connected network:

  • WCDMA: 3G network.
  • LTE: 4G network.
  • 5G(NSA): 5G non-standalone network.
  • 5G(SA): 5G standalone network.
Current Band

Frequency bands in use:

  • WCDMA: WCDMA2100, WCDMA1900, WCDMA850, and WCDMA900.
  • FDD LTE: B1, B2, B3, B5, B7, B8, B20, and B28.
  • TDD LTE: B34, B38, B39, B40, and B41.
  • FDD NR : N1 and N28.
  • TDD NR : N41, N77, N78, and N79.
Current RSSI

Received signal strength indicator (RSSI).
Current RSCP

Received signal code power (RSCP).

For a WCDMA network, the relationships between the signal strength and RSCP are as follows:

  • strong: The RSCP is greater than or equal to –87 dBm.
  • good: The RSCP is greater than or equal to –93 dBm and lower than –87 dBm.
  • normal: The RSCP is greater than –99 dBm and lower than –93 dBm.
  • slow: The RSCP is greater than –105 dBm and lower than –99 dBm.
  • weak: The RSCP is less than –105 dBm.
Current ECIO

Energy Per Chip to Interference of Other Cell Ratio.
Current RSRP

Reference signal received power (RSRP).

For an LTE/NR network, the relationships between the signal strength and RSRP are as follows:

  • strong: The RSRP is greater than or equal to –97 dBm.
  • good: The RSRP is greater than or equal to –105 dBm and lower than –97 dBm.
  • normal: The RSRP is greater than –110 dBm and lower than –105 dBm.
  • slow: The RSRP is greater than –115 dBm and lower than –110 dBm.
  • weak: The RSRP is lower than –115 dBm.
Current RSRQ

Reference signal received quality (RSRQ).
Current SINR

Signal-to-noise-plus-interference ratio (SNIR).
PIN Status

PIN authentication status:

  • Unknown: The PIN authentication status is unknown.
  • Ready: The modem is ready for PIN authentication.
  • PIN Requirement: The PIN needs to be entered for authentication.
  • PUK Requirement: The PUK needs to be entered to unlock the PIN.
Number of Retries remaining

Number of PIN/PUK authentication attempts allowed.
Integrate circuit card identity (ICCID)

Integrated circuit card identifier (ICCID).
Network Information

Network information.
Tracking Area Code (TAC)

Tracking area code (TAC). (The TAC is displayed only for LTE or NR networks.).
Cell ID

Cell ID.
Packet Service

Relation between the modem and PS domain:

  • Attached: The modem is attached to the PS domain.
  • Detached: The modem is detached from the PS domain.
Packet Session State

Data transmission status:

  • Active: Data is transmitted properly.
  • Inactive: Data transmission is abnormal.
Radio Information

Wireless information.
Bands supported

Supported frequency band.
APN Information

APN information.
Access Point Name

APN, which needs to be obtained from the carrier.

To configure this parameter, run the apn command in the APN profile view.
Location Area Code (LAC)

Local area code (LAC). (The LAC is displayed only for 3G networks.).
Model

5G modem model.
Factory Serial Number (FSN)

Factory serial number (FSN).
No

APN ID.

display modem-configuration

Function

The display modem-configuration command displays all configurations of a modem.

This command is supported only on the AR8100 series and AR6700 series.

Format

display { interface-type interface-number | interface-name } modem-configuration

Parameters

Parameter Description Value
interface-type

Specifies the type of an interface. This command applies only to cellular interfaces.

-
interface-number

Specifies the number of an interface.

The value depends on device hardware configuration.
interface-name

Specifies an interface name.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view all configurations of a modem.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the configuration of a modem.
<HUAWEI> display cellular 2/0/0 modem-configuration
Current Bands config:                                                                                                               
 WCDMA  : Auto                                                                                                                      
 LTE    : Auto                                                                                                                          
 NR     : Auto                                                                                                                           
Network Selection Mode  : Auto                                                                                                      
Network Connection Mode : LTE only                                                                                                  
Upgrade state           : Idle                                                                                                      
Last upgrade state      : None
# Display the configuration of a modem when the modem is offline.
<HUAWEI> display cellular 2/0/0 modem-configuration
Warning: The modem is not ready.
# Display the configuration of a modem when the modem is busy.
<HUAWEI> display cellular 2/0/0 modem-configuration
Warning: The modem is busy for plmn search.
Table 2-66 Description of the display modem-configuration command output
Item Description
Current Bands config

Current working frequency band.

  • WCDMA: WCDMA2100 WCDMA1900 WCDMA850 WCDMA900.
  • LTE: B1 B2 B3 B5 B7 B8 B20 B28 B34 B38 B39 B40 B41.
  • NR: N1 N28 N41 N77 N78 N79.
WCDMA

Wideband Code Division Multiple Access.
LTE

Long-term evolution.
NR

New air interface.
Network Selection Mode

Network selection mode.

  • Auto.
  • Manual.
  • Mix.
  • Unknown.
Network Connection Mode

Network connection mode.

  • Auto.
  • WCDMA only.
  • LTE only.
  • LTE-WCDMA.
  • NR only.
  • NR-LTE.
Upgrade state

Upgrade status.

  • Idle.
  • Upgrading.
Last upgrade state
  • [time] Upgrade failed: The upgrade failed.
  • [time] Upgrade success: The upgrade is successful.
  • None: No upgrade record is available.
Warning: The modem is not ready.

Message indicating that tee modem is offline.
Warning: The modem is busy for plmn search.

Message indicating that the modem is searching for a network.

display plmn search result

Function

The display plmn search result command displays the last public land mobile network (PLMN) search result.

This command is supported only on the AR8100 series and AR6700 series.

Format

display { interface-type interface-number | interface-name } plmn search result

Parameters

Parameter Description Value
interface-type

Specifies the interface type. This command only applies to cellular interfaces.

-
interface-number

Specifies the interface number.

The value depends on device hardware configuration.
interface-name

Specifies the name of an interface.

-
plmn

Specifies a PLMN.

-
search

Searches for a PLMN.

-
result

Displays the network search result.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After searching for PLMNs, you can run this command to view the search result.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the PLMN search result.
<HUAWEI> display Cellular 2/0/0 plmn search result
2021-05-01 10:00:00 Available PLMNs: 
PLMN NO.    MCC    MNC      Status       Type
   01       460    00      Available    NG-RAN 
   02       460    01      Forbidden    NG-RAN
   03       460    11      Available    E-UTRAN
   04       369    77      Available    E-UTRAN
# Display the PLMN search result when the modem is offline.
<HUAWEI> display Cellular 2/0/0 plmn search result
Warning: The modem is not ready.
# Display the PLMN search result when the modem is busy.
<HUAWEI> display Cellular 2/0/0 plmn search result
Warning: The modem is busy for plmn search.
# Display the PLMN search result after the PLMN search times out.
<HUAWEI> display Cellular 2/0/0 plmn search result
Warning: Plmn search time out.
# Display the PLMN search result when no PLMN is available.
<HUAWEI> display Cellular 2/0/0 plmn search result
Info: No plmn search result.
# Display the PLMN search result after the main interface is shut down.
<HUAWEI> display Cellular 2/0/0 plmn search result
Plmn search failed.
Table 2-67 Description of the display plmn search result command output
Item Description
PLMN NO.

PLMN ID.
MCC

Mobile country code (MCC).
MNC

Mobile network code (MNC).
Status

PLMN status.

Unknown.

Current.

Available.

Forbidden.
Type

PLMN type.

NG-RAN: 5G.

E-UTRAN: 4G.

UTRAN: 3G.

E-UTRAN-NR: dual-connection.

ip address modem-alloc

Function

The ip address modem-alloc command enables the automatic dial-up function to obtain an IP address.

The undo ip address modem-alloc command disables the automatic dial-up function.

By default, the automatic dial-up function is disabled on a device.

This command is supported only on the AR8100 series and AR6700 series.

Format

ip address modem-alloc

undo ip address modem-alloc

Parameters

None

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

When the device needs to obtain an IP address from the core network, you need to run this command to enable the automatic dial-up function.

Example

# Enable the automatic dial-up function on a cellular channel interface.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] ip address modem-alloc

mode (Cellular template view)

Function

The mode command configures the mode for a modem to connect to a WCDMA/LTE/5G network.

The undo mode command restores the default WCDMA/LTE/5G network connection mode for a modem.

By default, a modem automatically selects a WCDMA, LTE, or 5G network to connect to.

This command is supported only on the AR8100 series and AR6700 series.

Format

mode { auto | wcdma-only | lte-only | lte-wcdma | nr-only | nr-lte }

undo mode

Parameters

Parameter Description Value
auto

Configures a modem to automatically select a network to connect to.

-
lte-only

Configure a modem to select only an LTE network to connect to.

-
nr-only

Configure a modem to select only an NR network to connect to.

-
nr-lte

Configure a modem to select an NR or LTE network to connect to.

-
wcdma-only

Configure a modem to select only a WCDMA network to connect to.

-
lte-wcdma

Configure a modem to select an LTE or WCDMA network to connect to.

-

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

The cellular interface can connect to a WCDMA/LTE/5G network only when the modem connects to the WCDMA/LTE/5G network in the same mode as the WCDMA/LTE/5G network provided by the carrier. If they are different, run the mode command to change the mode for a modem to connect to the WCDMA/LTE/5G network.

Example

# Configure a modem to select only the NR network to connect to.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] mode nr-only
# Restore the default mode for a modem to connect to the WCDMA/LTE/5G network.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] undo mode

modem reboot

Function

The modem reboot command restarts a modem.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem reboot

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A modem restarts automatically when it detects an exception. If the modem cannot restart automatically, you can run this command to manually restart it.

Precautions

When this command is executed to manually restart a modem, services on the corresponding cellular interface are interrupted.

Example

# Restart a modem manually.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] modem reboot
Warning: The cellular module will reboot. Continue? [Y/N]:y

modem-event detect action

Function

The modem-event detect action command configures the self-recovery action of a channel interface.

The undo modem-event detect action command restores the default self-recovery action parameters of a channel interface.

By default, the self-recovery action is modem-reboot.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event detect action { redial | modem-reboot }

undo modem-event detect action [ { redial | modem-reboot } ]

Parameters

Parameter Description Value
redial

Indicates the self-recovery action is redial when the number of consecutive detection failures reaches the maximum value.

-
modem-reboot

Indicates the self-recovery action is modem restart when the number of consecutive detection failures reaches the maximum value.

-

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

To modify the self-recovery action of a channel interface, enter the channel interface view and perform configuration.

Example

# Set the self-recovery action of a channel interface to redial.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] modem-event detect action redial

modem-event detect fail-times

Function

The modem-event detectfail-times command sets the detection failure threshold for a channel interface.

The undo modem-event detect fail-times command restores the default detection failure threshold of a channel interface.

By default, the detection failure threshold is 5.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event detect fail-times fail-times

undo modem-event detect fail-times [ fail-times ]

Parameters

Parameter Description Value
fail-times

Specifies the detection failure threshold.

The value is an integer ranging from 1 to 128. The default value is 5.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

To change the detection failure threshold of a channel interface, change the value of fail-times.

Example

# Set the detection failure threshold of a channel interface to 10.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] modem-event detect fail-times 10

modem-event detect interval

Function

The modem-event detect interval command sets the detection interval on a channel interface.

The undo modem-event detect interval command restores the default detection interval of a channel interface.

By default, the detection interval is 60 seconds.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event detect interval interval

undo modem-event detect interval [ interval ]

Parameters

Parameter Description Value
interval

Specifies the detection interval.

The value is an integer ranging from 15 to 1800. The default value is 60.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

To change the detection interval of a channel interface, change the value of interval.

Example

# Set the detection interval of the channel interface to 20 seconds.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] modem-event detect interval 20

modem-event detect ipv4

Function

The modem-event detect ipv4 command configures a detection address and enables the address detection function.

The undo modem-event detect ipv4 command deletes the detection address.

By default, no detection address is configured.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event detect ipv4 ipv4-address

undo modem-event detect ipv4 ipv4-address

Parameters

Parameter Description Value
ipv4-address

Specifies the IP address of an interface.

The value is in dotted decimal notation.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a wireless link is unstable due to weak signals or noise interference, users cannot access external networks through the wireless link even after successful dialup. In this case, you can run the modem-event detect ipv4 command to enable address detection. When the number of consecutive detection failures reaches the threshold, the device triggers an action (restarting the modem or redialing up) to restore the wireless link.

Precautions

A maximum of two modem-event detect ipv4 commands can be configured.

Example

# Enable ICMP detection and set the destination IP address to 8.8.8.8.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] modem-event detect ipv4 8.8.8.8

modem-event detect retry-times

Function

The modem-event detect retry-times command configures the threshold for the number of module restart times or re-dialup times on a channel interface.

The undo modem-event detect retry-times command restores the default threshold for the number of module restart times or re-dialup times on a channel interface.

By default, the threshold for the number of module restart times or re-dialup times is 3.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event detect retry-times retry-times

undo modem-event detect retry-times [ retry-times ]

Parameters

Parameter Description Value
retry-times

Specifies the threshold for the number of module restart times or re-dialup times.

The value is an integer ranging from 0 to 10. The value 0 indicates that the number of automatic restart attempts is unlimited.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

To change the threshold for the number of module restart times or re-dialup times on a channel interface, modify the retry-times parameter.

Example

# Set the threshold for the number of module restart times or re-dialup times on a channel interface to 5.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular2/0/0:1] modem-event detect retry-times 5

modem-event dial-failed

Function

The modem-event dial-failed command sets the maximum number of consecutive dial-up failures for triggering restart of a modem and the maximum number of restart attempts.

The undo modem-event dial-failed command restores the default configuration.

By default, the maximum numbers of consecutive dial-up failures and automatic restart attempts are 30 and 3, respectively.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event dial-failed fail-times fail-times action { none | modem-reboot retry-times retry-times }

undo modem-event dial-failed

Parameters

Parameter Description Value
fail-times fail-times

Specifies the maximum number of consecutive dial-up failures.

The value is an integer in the range from 1 to 128. The default value is 30.
action

Specifies the automatic recovery action in the case of consecutive dial-up failures.

-
none

Indicates that no operation is performed.

-
modem-reboot

Sets the automatic recovery action to restart in the case of consecutive dial-up failures.

-
retry-times retry-times

Specifies the maximum number of automatic recovery attempts.

The value is an integer in the range from 0 to 10. The default value is 3. The value 0 indicates that the number of automatic recovery attempts is unlimited.

Views

Cellular channel interface view

Default Level

2: Configuration level

Usage Guidelines

You can run the modem-event dial-failed command to set the maximum number of consecutive dial-up failures on a cellular interface and the maximum number of restart attempts of the modem. In this manner, when the number of consecutive dial-up failures on the cellular interface reaches the maximum value, the device restarts the modem so that the fault can be rectified automatically. When the number of automatic restart attempts reaches the maximum value, the modem will not attempt to restart.

A modem attempts to restart upon consecutive dial-up failures only when automatic dial-up has been enabled on the corresponding cellular channel interface.

After automatic dial-up is enabled, the device restarts the modem when the number of consecutive dial-up failures reaches 30 by default. You can run the modem-event dial-failed command to change the maximum number of consecutive dial-up failures and the maximum number of restart attempts. You can also run the modem-event dial-failed action none command to disable automatic restart upon consecutive dial-up failures.

Example

# Set the maximum number of consecutive dial-up failures to 10 and the maximum number of automatic restart attempts to 7.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0:1
[HUAWEI-Cellular 2/0/0:1] modem-event dial-failed fail-times 10 action modem-reboot retry-times 7

modem-event icmp-unreachable

Function

The modem-event icmp-unreachable command enables the device to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic is abnormal and to restart the modem to restore the link if the DNS server is unreachable. The uplink and downlink traffic of a modem is detected at an interval of one minute. If only uplink traffic is detected and downlink traffic does not increase for 10 minutes, the device restarts the modem.

The undo modem-event icmp-unreachable action none command restores the default configuration.

By default, the device sends ICMP packets to detect whether the DNS server is reachable when the downlink traffic is abnormal and restarts the modem to restore the link if the DNS server is unreachable. The uplink and downlink traffic of a modem is detected at an interval of one minute. If only uplink traffic is detected and downlink traffic does not increase for 10 minutes, the device restarts the modem. The default number of restart attempts is 3.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event icmp-unreachable action { none | modem-reboot retry-times retry-times }

undo modem-event icmp-unreachable

Parameters

Parameter Description Value
none

Indicates that the automatic recovery action is null, that is, no action is taken.

-
modem-reboot

Indicates that the automatic recovery action is restart.

-
retry-times retry-times

Specifies the maximum number of automatic recovery attempts.

The value is an integer ranging from 0 to 10. The value 0 indicates that the number of automatic recovery attempts is unlimited.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

If the device fails to receive packets over a link, you can run the modem-event icmp-unreachable command to enable the device to send ICMP packets to detect whether the DNS server is reachable when the 5G downlink traffic is abnormal. If the DNS server is unreachable, you can restart the modem to restore the link. If you do not want the link to automatically recover when the device cannot receive packets over the link, you can run the modem-event icmp-unreachable action none command.

Example

# Enable the device to send ICMP packets to detect whether the DNS server is reachable when the downlink traffic is abnormal and restart the modem if the DNS server is unreachable, and set the maximum number of restart attempts to 5.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] modem-event icmp-unreachable action modem-reboot retry-times 5

modem-event packet-service-detached

Function

The modem-event packet-service-detached command configures the device to automatically restart a modem when it is not attached to a PS domain and sets the interval at which the modem automatically restarts.

The undo modem-event packet-service-detached command restores the default configuration.

By default, the device automatically restarts a modem if it is not attached to a PS domain for 3600s and the maximum number of restart times is 3.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event packet-service-detached interval interval action { none | modem-reboot retry-times retry-times }

undo modem-event packet-service-detached

Parameters

Parameter Description Value
interval interval

Specifies the maximum duration within which a modem is not attached to a PS domain.

The value is an integer in the range from 10 to 86400. The default value is 3600.
action

Specifies the automatic recovery action to take when a modem is not attached to a PS domain for a long time.

-
none

Indicates that no automatic recovery action is taken.

-
modem-reboot

Indicates that the automatic recovery action of a modem is restart when it is not attached to a PS domain for a long time.

-
retry-times retry-times

Specifies the maximum number of automatic recovery attempts.

The value is an integer in the range from 0 to 10. The default value is 3.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

If a modem is not attached to a PS domain, you can run the modem-event packet-service-detached command to configure the modem to automatically restart and specify the interval at which the modem automatically restarts and the maximum number of restart attempts. Then the modem will automatically restart and start to dial up within the specified interval until it is attached to a PS domain. You can use modem-event packet-service-detached action none to disable the PS domain attachment detection function.

Example

# Set the interval at which a modem automatically restarts to 200 seconds and the maximum number of restart attempts to 5.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gNet
[HUAWEI-cellular-profile-5gNet] modem-event packet-service-detached interval 200 action modem-reboot retry-times 5

modem-event services-unavailable

Function

The modem-event services-unavailable command sets the service availability detection interval and sets the maximum number of automatic modem restart attempts or the maximum number of automatic SIM card switchover attempts.

The undo modem-event services-unavailable command restores the default configuration.

By default, the service availability detection interval is 3600s, the automatic recovery action is modem restart, and the number of restart attempts is 0, indicating that the number of restart attempts is unlimited.

This command is supported only on the AR8100 series and AR6700 series.

Format

modem-event services-unavailable interval interval action { none | { modem-reboot | sim-switch } retry-times retry-times }

undo modem-event services-unavailable

Parameters

Parameter Description Value
interval interval

Specifies the service availability detection interval.

The value is an integer in the range from 60 to 3600, in seconds. The default value is 3600.
action

Specifies the automatic recovery action when no service is available.

-
none

Indicates that the automatic recovery action is null, that is, no action is taken.

-
modem-reboot

Indicates that the automatic recovery action is modem restart when no service is available.

-
sim-switch

Indicates that the automatic recovery action is SIM card switchover when no service is available.

-
retry-times retry-times

Specifies the maximum number of automatic recovery attempts.

The value is an integer in the range from 0 to 10. The default value is 0, 0 indicating that the number of automatic recovery times is unlimited.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

The service of a cellular interface may become unavailable due to a network exception. You can run the modem-event services-unavailable command to set the service availability detection interval and the maximum number of automatic modem restart attempts or the maximum number of automatic SIM card switchover attempts upon service unavailability. When the detection interval expires, the device automatically restarts the modem or switches the SIM card based on the configuration.

When the service recovers within the detection interval or the number of automatic modem restart attempts or SIM card switchover attempts reaches the maximum value, the device will not attempt to recover the service.

You can run the display cellular command to view the current service status of the modem. When the value of Current Service Status is displayed as Service available, the service of the modem is restored.

Service availability detection can be performed only after automatic dial-up is enabled on a cellular channel interface.

After automatic dial-up is enabled, the service availability detection interval is 3600s, the service recovery action is modem restart, and the maximum number of automatic restart attempts is 0 by default. You can run the modem-event services-unavailable command to modify the detection interval, service recovery action, and maximum number of automatic restart attempts. You can also run the modem-event services-unavailable action none command to disable service availability detection.

Example

# Set the service availability detection interval to 300s, the service recovery action to modem restart, and the maximum number of restart attempts to 7.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] modem-event services-unavailable interval 300 action modem-reboot retry-times 7
# Set the service availability detection interval to 400s, the service recovery action to SIM card switchover, and the maximum number of switchover attempts to 7.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] modem-event services-unavailable interval 400 action sim-switch retry-times 7

pin modify

Function

The pin modify command changes the personal identification number (PIN) of a SIM card.

This command is supported only on the AR8100 series and AR6700 series.

Format

pin modify

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the pin modify command to change the PIN of a SIM card. The new PIN is saved on the SIM card.

Precautions

This command takes effect only when both a modem and SIM card are installed.

The PIN of a SIM card can be changed only after the PIN authentication function of the modem is enabled.

Example

# Change the PIN of a SIM card.
<HUAWEI> system-view
[HUAWEI] interface Cellular 2/0/0
[HUAWEI-Cellular2/0/0] pin modify
Enter Current Pin Code:
Enter Pin Code:
Confirm Pin Code:
Warning: PIN will be changed. Continue? [Y/N]:y
Info: The PIN is changed successfully.
Info: Remember the password and enable automatic verify?[Y/N]

pin unlock

Function

The pin unlock unlocks a SIM card using the PUK and resets the PIN.

This command is supported only on the AR8100 series and AR6700 series.

Format

pin unlock

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The PUK is allocated by the carrier. If a user enters incorrect PINs for a SIM card three consecutive times, the SIM card is locked to protect user information security. To unlock the SIM card, enter the PUK.

Precautions

This command is valid only when both a modem and a SIM card are installed.

Example

# Use the PUK to unlock a SIM, USIM, or UIM card, and reset the PIN.
<HUAWEI> system-view
[HUAWEI] interface Cellular 2/0/0
[HUAWEI-Cellular2/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...
Info: The PIN is unlocked and changed successfully.
Info: Remember the password and enable automatic verify?[Y/N]

pin verify

Function

The pin verify command authenticates the PIN.

This command is supported only on the AR8100 series and AR6700 series.

Format

pin verify

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

After PIN authentication is enabled for a SIM card, you are required to enter the correct PIN every time you use the SIM card. If the PIN authentication fails, the modem cannot provide data communication functions.

Example

# Authenticate the PIN.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] pin verify
Enter Current Pin Code:
Verifying PIN...Please wait...
Info: The PIN is verified successfully.
Info: Remember the password and enable automatic verify?[Y/N]

plmn

Function

The plmn command selects the Public Land Mobile Network (PLMN) in automatic or manual mode.

The undo plmn command restores the default configuration.

By default, a modem automatically selects a PLMN.

This command is supported only on the AR8100 series and AR6700 series.

Format

plmn select manual mcc mnc [ fail-over-auto ]

undo plmn select manual

Parameters

Parameter Description Value
mcc

Specifies a mobile country code (MCC).

The value is an integer ranging from 0 to 999.
mnc

Specifies a mobile network code (MNC).

The value is an integer ranging from 0 to 999.
fail-over-auto

Indicates that a modem automatically selects a PLMN when manual PLMN selection fails.

-
select

Selects a PLMN.

-
manual

Indicates that the PLMN of a modem is manually specified. The mcc and mnc parameters must be specified.

-

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

For a WCDMA, LTE, or 5G network, you can manually select a PLMN for a modem or configure a modem to automatically select a PLMN. You can run the display cellular command to query the network selection result.

Precautions

This command is valid only when both the modem and SIM card are installed properly.

If the PLMN is selected manually, run the undo plmn select manual command to restore the automatic PLMN selection mode. If the PLMN is already selected automatically, no operation is performed after the undo plmn select manual command is executed.

Example

# Manually select a PLMN.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] plmn select manual 460 03
# Configure a modem to automatically select a PLMN.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] undo plmn select manual

plmn search

Function

The plmn search command searches for public land mobile networks (PLMNs).

This command is supported only on the AR8100 series and AR6700 series.

Format

plmn search

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

The plmn search command is a network detection command, and is used to search for PLMNs.

The search result can be queried by using the display cellular plmn search result command.

Example

# Search for PLMNs.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] plmn search
Warning: Network will be disconnected when search for plmns. Continue? [Y/N]:

sim switch to

Function

The sim switch to command enables the manual switchover between SIM cards.

This command is supported only on the AR8100 series and AR6700 series.

Format

sim switch to sim-id

Parameters

Parameter Description Value
sim-id

Specifies the ID of a SIM card.

The value is 1 or 2.

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a dual-SIM card scenario, when the automatic SIM card switchover is not configured or the switchover condition is not met, you can run the sim switch to command to manually switch services between the SIM cards.

Precautions

Manual switchover between SIM cards causes temporary service interruption and affects service transmission. Exercise caution when performing this operation.

Example

# Manually switch services to the backup SIM card.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] sim switch to 2
Warning: The SIM card will switch. Continue? [Y/N]:y

sim wait-restore enable

Function

The sim wait-restore enable command enables automatic switchback from the backup SIM card to the master SIM card.

The undo sim wait-restore enable command disables automatic switchback from the backup SIM card to the master SIM card.

By default, traffic on the backup SIM card is not automatically switched back to the master SIM card.

This command is supported only on the AR8100 series and AR6700 series.

Format

sim sim-id wait-restore enable [ timer time ]

undo sim wait-restore enable

Parameters

Parameter Description Value
enable

Enables automatic switchback from the backup SIM card to the master SIM card.

-
timer time

Indicates the time required for automatic switchback from the backup SIM card to the master SIM card.

When this parameter is not specified, traffic on the backup SIM card is switched back to the master SIM card after 60 minutes.

The value is an integer in the range from 1 to 65535. The default value is 60.
sim sim-id

Specifies the ID of a SIM card.

The value is 1 or 2.

Views

Cellular template view

Default Level

2: Configuration level

Usage Guidelines

In a dual-SIM card scenario, when the WCDMA/LTE/5G link signal quality is poor on the master SIM card or the connected carrier network is faulty, traffic is automatically switched to the backup SIM card. After a period of time, the WCDMA/LTE/5G link signal quality on the master SIM card becomes better or the connected carrier network recovers from the fault. You can run the sim wait-restore enable command to enable automatic switchback from the backup SIM card to the master SIM card.

Example

# Enable automatic switchback from the backup SIM card to the master SIM card 1.
<HUAWEI> system-view
[HUAWEI] cellular-profile 5gnet
[HUAWEI-cellular-profile-5gnet] sim 1 wait-restore enable

sim-card

Function

The sim-card lock command enables personal identification number (PIN) authentication for a modem.

The sim-card unlock command disables PIN authentication for a modem.

By default, PIN authentication is disabled.

This command is supported only on the AR8100 series and AR6700 series.

Format

sim-card { lock | unlock }

Parameters

None

Views

Cellular interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A PIN identifies the user of a SIM card.

To prevent unauthorized users from using the SIM card, you can enable the PIN authentication function for the modem. A user can use the modem for data communication only after the PIN is authenticated.

Precautions

This command is valid only when both a modem and a SIM card are installed.

If automatic PIN authentication fails, you must manually enter the PIN for authentication.

Example

# Enable PIN authentication for a modem.
<HUAWEI> system-view
[HUAWEI] interface cellular 2/0/0
[HUAWEI-Cellular2/0/0] sim-card lock
Enter Current Pin Code:
Info: The SIM card is locked successfully.
Info: Remember the password and enable automatic verify?[Y/N]

sim-id

Function

The sim-id command sets the ID of a SIM card in 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.

By default, no SIM card is specified.

This command is supported only on the AR8100 series and AR6700 series.

Format

sim-id sim-id

undo sim-id

Parameters

Parameter Description Value
sim-id

Specifies the ID of the SIM card to which the APN profile is to be bound.

The value is 1 or 2.

Views

APN template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To improve the reliability of data transmission over WCDMA/LTE/5G links, you can use two cellular interfaces. On interface provides the primary link for connecting to a WCDMA/LTE/5G network, and the other interface provides the secondary link for connecting to another WCDMA/LTE/5G network. If the primary link fails, traffic can be quickly switched to the secondary link, enhancing the reliability of Internet access for enterprises.

However, if the device does not have two cellular interfaces, you can select a cellular interface that supports two SIM cards. One SIM card functions as the master SIM card to connect to a WCDMA/LTE/5G network, and the other SIM card functions as the backup SIM card to connect to another WCDMA/LTE/5G network. If the master SIM card is unavailable or faulty, the link signal quality is poor, or the connected WCDMA/LTE/5G network fails and dial-up fails, traffic is automatically switched to the backup SIM card, reducing the impact on user services.

When dual SIM cards are used, you can run the sim-id command in the APN profile view 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 and the cellular channel interface is bound to the APN profile, the master SIM card can be used to connect to the WCDMA/LTE/5G network.
  • When the APN profile is bound to the backup SIM card and the cellular channel interface is bound to the APN profile, the backup SIM card can be used to connect to the WCDMA/LTE/5G network.

Precautions

If you run the sim-id command multiple times in the same APN profile view, only the latest configuration takes effect.

The master and backup SIM cards cannot work at the same time. Switching the SIM card will transiently interrupt traffic.

Example

# Set the ID of the SIM card to 2 in APN profile ltenet.
<HUAWEI> system-view
[HUAWEI] apn-profile ltenet
[HUAWEI-apn-profile-ltenet] sim-id 2

user

Function

The user command configures the user name, password, and authentication mode for accessing an external public data nework (PDN).

The undo user command deletes the user configured for accessing an external PDN.

By default, the user name, password, and authentication mode for accessing an external PDN are not configured.

This command is supported only on the AR8100 series and AR6700 series.

Format

user name username password password [ authentication-mode { auto | pap | chap } ]

undo user name username

Parameters

Parameter Description Value
password password

Specifies the password provided by a carrier for accessing an external PDN.

The value is a string of 1 to 32 case-sensitive characters in plain text or a string of 128 to 168 case-sensitive characters in cipher text, spaces not supported.
authentication-mode

Specifies the authentication mode. If this parameter is not specified, the auto mode is used by default.

-
auto

Sets the authentication mode to PAP or CHAP authentication.

-
pap

Sets the authentication mode to PAP authentication.

-
chap

Sets the authentication mode to CHAP authentication.

-
name username

Specifies the user name provided by a carrier for accessing an external PDN.

The value is a string of 1 to 64 case-sensitive characters, spaces not supported.

Views

APN template view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a user uses a cellular interface to access an external PDN through a WCDMA, LTE, or 5G network, the external PDN needs to authenticate the user to ensure information security. The user can use the cellular interface to perform data communication with the external PDN through the WCDMA, LTE, or 5G network only after passing the authentication.

Precautions

  • Contact the carrier for the user name, password, and authentication mode.
  • PAP authentication provides low security. If you select auto or pap, the password is transmitted in plain text on the network, which poses security risks. Therefore, you are advised to select chap. Select an authentication mode based on carrier network requirements.
  • To ensure device security, change the password periodically.
  • The password cannot contain only asterisks (*).

Example

# Configure the user name, password, and authentication mode for accessing an external PDN.
<HUAWEI> system-view
[HUAWEI] apn-profile 5gnet
[HUAWEI-apn-profile-5gnet] user name jack password YsHsjx_202206 authentication-mode chap
Translation
Favorite
Download
Update Date：2024-05-24
Document ID：EDOC1100262560
Views：62830
Downloads：197
Average rating：0.0Points

Related Documents

Digital Signature File

digtal sigature tool