Command descriptions
Show commands
Show cellular MDA commands
mda
Syntax
mda mda-id [detail]
Context
show
Description
This command displays information about the cellular MDA.
When a band-list is configured, the output shows the following information:
the LTE bands that are supported globally on the MDA and whether 3G is available
the LTE bands that are supported by the firmware on the active SIM and whether 3G is included
the list of bands configured for each SIM
whether a configured band list on the active SIM is in use. If only a subset of bands on the list is supported by the firmware on the active SIM, the field shows only those bands.
The Band list in-use field shows the "all bands enabled by fw" message when:
there is no band list configured
a band list is configured with bands that are valid for the MDA but are not supported by the current firmware
none of the bands on the band list are supported by the firmware on the active SIM
Parameters
- mda-id
the identifier for the cellular MDA
Output
The following output is an example of cellular MDA information.
*A:Dut-A# show mda 1/1 detail
===============================================================================
MDA 1/1 detail
===============================================================================
Slot Mda Provisioned Type Admin Operational
Equipped Type (if different) State State
-------------------------------------------------------------------------------
1 1 i2-cellular up up
MDA Specific Data
Maximum port/connector count : 2
Num ports/connectors equipped : 2
Capabilities : Wireless, Cellular
Fail On Error : Disabled
Hardware Data
Platform type : 7705
Part number : 3HE11600AAAA0125
CLEI code : INM2100DRA
Serial number : NS215062172
Manufacture date : 12182021
Manufacturing deviations : D04829
Manufacturing assembly number :
Administrative state : up
Operational state : up
Temperature : 35C
Temperature threshold : 75C
Over-temperature status : ok
Software boot (rom) version : (Not Specified)
Software version : (Not Specified)
Time of last boot : 2022/10/05 11:29:32
Current alarm state : alarm cleared
Base MAC address : f8:ba:e6:bc:39:44
Firmware version : ATT 02.32.11.00 002.070_005
Cellular MDA Information
Configured active SIM card : SIM 1
Actual active SIM card : SIM 1
Automatic SIM switch status : N/A
SIM 1 firmware : ATT 02.32.11.00 002.070_005
SIM 2 firmware : GENERIC 02.38.00.00 002.082_000
No service reset interval : disabled
No service reset status : N/A
Bands supported on MDA : b1 b2 b3 b4 b5 b7 b8 b12 b13 b20 b25 b26
b29 b30 b41 3g
Bands enabled by active fw : b1 b2 b3 b4 b5 b7 b8 b12 b13 b20 b25 b26
b29 b30 b41 3g
Band list in-use : b2 b5 b12
SIM card number : 1
Band list configured : b2 b5 b12
RSSI threshold : none
RSSI alarm wait time : 60 seconds
Failure criteria : port
Failure duration : 5 minutes
SIM card number : 2
Band list configured : none
RSSI threshold : none
RSSI alarm wait time : 60 seconds
Failure criteria : port
Failure duration : 5 minutes
===============================================================================
Show cellular port commands
port
Syntax
port port-id [detail]
Context
show
Description
This command displays operational state information for a cellular port, including information for the cellular PDN interface, the installed SIM, and the packet data network (PDN). It also displays port statistics.
The CBSD information is available only for the 7705 SAR-Hmc NA (3HE12472AA) and the 7705 SAR-Hmc NA variant 2 (3HE12473AA) when the PDN router interface is configured to operate as a CBSD.
Parameters
- port-id
-
the identifier for the cellular port
Output
The following output is an example of cellular interface information.
*A:Dut-A# show port 1/1/1 detail
===============================================================================
Cellular PDN Interface
===============================================================================
Description : Cellular
Interface : 1/1/1 IfIndex : 35684352
Admin State : up Oper State : up
State Change Count: 1
IMEI : 35-241842-015157-1
Sync System Time : Disabled
Network Status : registered-home Radio Mode : lte
Band : 48 Channel : 55990
RSSI : >= -51 dBm RSRP : -52 dBm
RSRQ : >= -3 dB SINR : +30.0 dB
Tracking Area Code: 0001 Cell Identity : 01a2d001
-------------------------------------------------------------------------------
SIM Card 1
-------------------------------------------------------------------------------
Description : (Not Specified)
Specified Firmware: GENERIC 01.14.03.00 002.036_001
Equipped : yes
Locked : no PIN status : ready
PIN retries left : 3 PUK retries left : 10
ICCID : 8988211000000484017 IMSI : 001001000048401
-------------------------------------------------------------------------------
Packet Data Network
-------------------------------------------------------------------------------
PDN Profile : 1 Protocol : IPv4
Configured APN : internet
PDN State : connected
IP Address : 10.30.28.11
Primary DNS : 8.8.8.8
Secondary DNS : 8.8.4.4
IP MTU : 1500
APN : internet
-------------------------------------------------------------------------------
CBSD
-------------------------------------------------------------------------------
Admin State : enabled
Oper State : up
User ID : V8User5
Antenna Gain : 7 dBm
Category : A
Client TLS : sas_harness_client_tls_profile
Primary SAS Server : https://10.0.4.102:8080/v1.2
Secondary SAS Server :
SAS Server in Use : primary
SAS Server IP : 10.0.4.102
FCC ID : AS57705SARHMC-2A
CBSD ID : 1004
Grant ID : 2006
Registration State : registered
Grant State : authorized
Grant Expiry Time : 2022/09/18 05:03:30 UTC
Tx Expiry Time : 2022/09/17 05:03:31 UTC
Heartbeat Interval : 60 seconds
Channel Type : pal
-------------------------------------------------------------------------------
CBSD Statistics
-------------------------------------------------------------------------------
Type Requests Successes Failures
-------------------------------------------------------------------------------
Registration 1 1 0
Grant 1 1 0
Heartbeat 1 1 0
-------------------------------------------------------------------------------
===============================================================================
==================================================================
Bearer Information
==================================================================
Bearer Id Bearer Type QCI UL GBR UL MBR DL GBR DL MBR
------------------------------------------------------------------
5 default 9
==================================================================
===============================================================================
Port Statistics
===============================================================================
Input Output
-------------------------------------------------------------------------------
Packets 81 99
Discards 0 0
Unknown Proto Discards 0
===============================================================================
A:Dut-A#
Show GNSS receiver commands
gnss
Syntax
gnss
Context
show>mda
Description
This command displays detailed GNSS information, including position and satellite information.
If a GNSS fix is acquired and then subsequently lost by the node, the last known GNSS fix data continues to be displayed in the CLI. When a GNSS fix is reacquired, the GNSS data is updated to match the new fix.
The last GNSS fix data is not preserved after a power-cycle, admin reboot, clear mda 1/1, or shutdown command is issued for GNSS.
Output
The following output is an example of GNSS information.
*A:Dut-A#: show mda 1/1 gnss
===============================================================================
GNSS Information
===============================================================================
Admin State : Enabled
Oper State : Up
Satellite Constellation : gps-glonass
NMEA Sentence Streaming : Enabled
Sentences : gga rmc vtg gns
Sentence Interval (seconds) : 5
-------------------------------------------------------------------------------
Acquired Fix : Yes
Time : 2018/07/27 12:59:47 UTC
Position (degrees) : 45.34810, -75.92147
Position (degrees minutes seconds) : 45 20'53.1"N, 75 55'17.2"W
Altitude above mean sea level : 124.8 meters
Heading : 0.0 degrees
Speed : 0.0 kph
===============================================================================
==========================================
Visible Satellites
==========================================
# type elevation azimuth SNR(dB)
------------------------------------------
1 gps 22 158 43
7 gps 73 229 53
8 gps 64 54 57
9 gps 8 209 44
11 gps 48 165 49
13 gps 9 324 40
16 gps 2 90 40
18 gps 38 135 54
27 gps 27 50 49
28 gps 29 284 46
30 gps 52 296 51
69 glonass 7 302 31
70 glonass 4 352 43
77 glonass 49 113 44
78 glonass 68 343 53
79 glonass 28 316 47
81 glonass 18 199 42
86 glonass 0 28 45
87 glonass 54 43 44
88 glonass 66 177 43
------------------------------------------
No. of visible satellites: 20
==========================================
*A:Dut-A#
Show serial and raw socket commands
port
Syntax
port 1/3/1
Context
show
Description
This command displays serial and raw socket information.
Output
The following output is an example of serial and raw socket information.
*A:Dut# show port 1/3/1
===============================================================================
Serial RS-232 Interface
===============================================================================
Description : RS-232 Serial
Interface : 1/3/1 Port IfIndex : 39878656
Admin Status : down Oper Status : down
Physical Link : no Mode : access
Device Mode : asynchronous Speed : 9600
Character Length : 8 Parity : none
Stop Bits : 1
Device Gender : dce Duplex : full
Last State Change : 07/17/2017 17:20:13
Loopback : none
Hold time up : 0 milliseconds
Hold time down : 0 milliseconds
=============================================
Serial Control Leads
=============================================
Inputs Cfg Netw Line Mon
---------------------------------------------
dtr-dsr [DTR] : high 0 off
rts-dcd [RTS] : high 0 off
Outputs Cfg Netw Line
---------------------------------------------
dcd-rts [DCD] : high 1
cts-alb [CTS] : high 1
ri-rdl [RI] : high 1
===============================================================================
===============================================================================
Serial Socket
===============================================================================
EOP Length : 1500 Squelch Delay : Disabled
EOP Idle Timeout : 50 Unsquelch Delay : Disabled
EOP Special Char : Disabled Inter-Session Delay : 10
Squelch Status : off
===============================================================================
=============================================================
Socket Statistics
=============================================================
Count
-------------------------------------------------------------
Characters received 0
Characters transmitted 0
End of packet idle timeout 0
End of packet length 0
End of packet special character 0
Ingress forwarded packets 0
Egress forwarded packets 0
Ingress dropped packets 0
Egress dropped packets 0
Squelch activated 0
=============================================================
*A:Dut#
Show WLAN radio commands
mda
Syntax
mda 1/4 [detail]
Context
show
Description
This command displays WLAN radio MDA information.
Output
The following output is an example of WLAN radio MDA information.
*A:Dut# show mda 1/4 detail
===============================================================================
WLAN Radio Data
Radio : 1
Type : Wifi Dualband 2.4/5.0 GHz
Administrative state : up
Operational state : up
Country : canada
Beacon Interval : 200 msecs
Cfg. Band/Channel/Width : 2400 MHz/Ch.1/20 MHz
Oper. Band/Channel/Width : 2400 MHz/Ch.1/20 MHz
Oper. Center Frequency : 2412 MHz
=============================================================
*A:Dut#
port
Syntax
port port-id [statistics] [detail]
Context
show
Description
This command displays WLAN radio port statistics and RADIUS configuration information.
Parameters
- port-id
specifies the physical port identifier in the format slot/mda/port, where slot is always 1, mda is always 4, and port is 1 to 4
- statistics
shows ingress and egress statistics for the port
- detail
shows more information about the WLAN port
Output
The following output is an example of WLAN radio port information.
*A:Dut# show port 1/4/1
===============================================================================
Wireless LAN Interface
===============================================================================
Description : Wireless LAN
Interface : 1/4/1 Port IfIndex : 41975808
Admin Status : up Oper Status : up
Oper Flags :
Last State Change : 05/14/2021 08:52:32
Hardware Address : cc:66:b2:0a:dd:05
Mode : WLAN Access Point
-------------------------------------------------------------------------------
RF Interface
-------------------------------------------------------------------------------
Frequency : 2437 MHz
Band/Channel : 2400 MHz/Ch.6 Channel Width : 20 MHz
-------------------------------------------------------------------------------
Network Parameters
-------------------------------------------------------------------------------
SSID : kansarhmrtb5
Security : wpa2-psk
Passphrase : **********
Encryption : aes
SSID Broadcast : enabled
Client Idle Timeout: 300 secs Client Limit : 24
DHCP Relay : disabled DHCP Action : replace
Auth Radius Policy : N/A
Re-Auth Period : 3600 secs
-------------------------------------------------------------------------------
Connected Clients
-------------------------------------------------------------------------------
Client Authorized Connect Time
-------------------------------------------------------------------------------
00:23:a7:f0:8f:8b Yes 05/14/2021 08:54:35
-------------------------------------------------------------------------------
Count: 1 (Limit: 24)
-------------------------------------------------------------------------------
===============================================================================
=============================================================
Access Point Statistics
=============================================================
Count
-------------------------------------------------------------
Client attaches 1
Client detaches 0
Successful authentications 1
Failed authentications 0
=============================================================
===============================================================================
Port Statistics
===============================================================================
Input Output
-------------------------------------------------------------------------------
Packets 2 2
Discards 0 0
Unknown Proto Discards 0
===============================================================================
A:Dut-A>config>port# show port 1/4/4
===============================================================================
Wireless LAN Interface
===============================================================================
Description : Wireless LAN
Interface : 1/4/4 Port IfIndex : 42074112
Admin Status : up Oper Status : up
Oper Flags :
Last State Change : 05/14/2021 08:54:36
Hardware Address : cc:66:b2:0a:da:1a
Mode : WLAN Station
-------------------------------------------------------------------------------
RF Interface
-------------------------------------------------------------------------------
Frequency : 2437 MHz
Band/Channel : 2400 MHz/Ch.6 Channel Width : 20 MHz
-------------------------------------------------------------------------------
Network Parameters
-------------------------------------------------------------------------------
SSID : kansarhm8b
Security : none
Connected : yes
Connection Time : 2022/09/30 17:44:18 Duration : 0d 00:00:08
BSSID : 00:23:a7:8e:d9:04 Channel Number : 1
Rx Signal Level : -39 dBm Frequency : 2412 MHz
-------------------------------------------------------------------------------
SSID : kanlnx963
Security : none
-------------------------------------------------------------------------------
SSID : abcd
Security : wpa2-psk
Passphrase : **********
Encryption : aes
===============================================================================
===============================================================================
Port Statistics
===============================================================================
Input Output
-------------------------------------------------------------------------------
Packets 2 2
Discards 0 0
Unknown Proto Discards 0
===============================================================================
Clear commands
Clear cellular port commands
port
Syntax
port port-id statistics
Context
clear
Description
This command clears statistical information for a cellular interface port.
Parameters
- port-id
specifies the cellular port, from 1/1/1 to 1/1/2
- statistics
clears statistical information
Clear raw socket statistics commands
port
Syntax
port 1/3/1 statistics
Context
clear
Description
This command clears raw socket statistical information for a serial port.
Parameters
- statistics
clears statistical information
Clear WLAN statistics commands
port
Syntax
port port-id statistics
Context
clear
Description
This command clears WLAN statistical information for a WLAN port.
Parameters
- port-id
-
the WLAN port identifier
- statistics
-
clears statistical information
Tools commands
Tools perform commands
at-command
Syntax
at-command at-command
Context
tools>perform>mda>cellular
Description
This command executes an ATtention (AT) command on the cellular port. AT commands are instruction commands that are used to control a modem. The commands are issued to the modem, and responses to the commands from the modem are displayed directly on the CLI console.
These commands can also be used to view operational information about the cellular port.
Risk of service outage. Do not change any at-command settings.
The commands are reserved for use by Nokia personnel only.
Some commands may take up to several minutes to complete.
Parameters
- at-command
a supported AT command
auto-boot
Syntax
auto-boot {complete | retry | terminate}
[no] auto-boot echo [debugger]
Context
tools>perform
Description
This command is used to configure the status of the ADP-Hm process running on the node.
The auto-reboot echo command controls the echo of log updates to the console. When the debugger parameter is specified, auto-boot debug logs are sent to the console.
Parameters
- complete
-
specifies that the ADP-Hm process is complete
- retry
-
specifies that the ADP-Hm process is being retried
- terminate
-
specifies that the ADP-Hm process has been terminated
diag-port-access
Syntax
diag-port-access listening-port port-number start
diag-port-access stop
Context
tools>perform>cellular
Description
This command enables or disables the TCP port used by the TCP server for remote access to the cellular diagnostics port on the node. When enabled, third-party applications use the port to connect directly to the cellular modem to stream binary diagnostic information from the cellular radio in real time.
Parameters
- listening-port port-number start
-
specifies that the TCP port used by the TCP server is enabled for remote access to the cellular diagnostics port
- listening-port stop
-
specifies that the TCP port used by the TCP server is disabled for remote access to the cellular diagnostics port
force-sim-switch
Syntax
force-sim-switch
Context
tools>perform>mda>cellular
Description
This command manually forces a SIM activity switch. This command is used in a dual SIM deployment when the active-sim command is set to auto.
update-firmware
Syntax
update-firmware firmware-file
update-firmware firmware-file sim 1 | 2
Context
tools>perform>mda>cellular
Description
This command preloads the correct firmware onto the cellular modem when specific firmware is needed to attach to a cellular network.
The 7705 SAR-Hm supports the update-firmware firmware-file sim 1 | 2 command. The command updates the firmware for the specified SIM. This form of command is supported only on the 7705 SAR-Hm, and specifying either sim 1 or sim 2 is mandatory. The firmware is updated only after the system reboots. When the command is executed, a prompt appears asking the operator whether to proceed with a reboot in order to update the firmware. Entering y at the prompt reboots the system immediately and the firmware is updated. Entering n at the prompt postpones the reboot and the firmware is updated the next time the system is rebooted.
For the 7705 SAR-Hm, in a dual SIM deployment, to update the firmware on both SIMs at the same time, the operator must execute the update-firmware command for the first SIM and enter n at the reboot prompt. The operator must then execute the update-firmware command for the second SIM and enter y at the reboot prompt in order to proceed with a system reboot. The firmware for both SIMs is updated when the reboot is complete. If the operator enters n at the second reboot prompt, the reboot is postponed and the firmware for both SIMs is updated the next time the system is rebooted.
The command can be executed on the SIMs in either order, SIM 1 first or SIM 2 first.
The firmware for both SIMs can be updated individually, but this requires the system to be rebooted twice.
If the update-firmware command is executed multiple times for the same SIM but with different firmware files and no reboot occurs at the time the command is executed, when a system reboot does occur, the firmware is updated with the last firmware file specified in the command.
The 7705 SAR-Hmc supports the update-firmware firmware-file command.
The firmware that is bundled with SR OS is considered the default firmware for the radio module on the 7705 SAR-Hmc. If the update-firmware command is not used, the radio module uses the default firmware and system upgrades to a newer version of SR OS will automatically use the firmware version that is bundled in SR OS. If the update-firmware command is used, the radio module uses the version of firmware specified in the command and when the system upgrades to a newer version of SR OS, the radio module continues using the version of firmware specified in the command and ignores the bundled version of firmware in SR OS.
The update-firmware command is used to specify the version of firmware that will be used by the radio module on both SIMs (the firmware cannot be updated per SIM). The command overwrites the firmware currently used by the radio module, which can be the default firmware automatically loaded by SR OS or another specified version of firmware. When the system is rebooted, this updated firmware is used by the radio module.
To return to the default firmware, the operator must execute the update-firmware command using "default" as the specified firmware file. Using "default" informs the system that the current version of firmware must be discarded and replaced with the firmware version that is bundled with SR OS.
When this command is executed, the operator prompted to proceed with a reboot in order to update the firmware. Entering y at the prompt reboots the system immediately and the firmware is updated. Entering n at the prompt postpones the reboot and the firmware is updated the next time the system is rebooted.
Parameters
- firmware-file
specifies a cellular radio firmware file located on the cf3: file system. If "default" is specified, the firmware is updated to use the bundled version of firmware in SR OS.
change-pin
Syntax
change-pin
Context
tools>perform>mda>cellular>sim
Description
This command launches an interactive CLI session to change the PIN on the SIM.
Ensure that the specified SIM is the currently active SIM.
It is not possible to change the PIN on a SIM unless the SIM is locked. See the lock-sim command.
When a SIM is procured from a carrier, the SIM PIN is set to a default value. When this command is issued, the CLI prompts the user to enter the current PIN once and then correctly enter the new PIN twice in order to change it.
When an operator successfully locks a SIM, unblocks a SIM, or changes a SIM PIN, the system updates the PIN value in the system configuration. However, the system does not automatically save the system configuration containing the new PIN. The operator must perform an admin>save command immediately after changing the PIN in order to save the new PIN in the system configuration file and avoid potential service interruptions such as the node becoming unreachable.
If the SIM becomes blocked when setting the PIN remotely using in-band management over a cellular port, the node will be unreachable. Physical access to the node will be required to unblock the SIM.
lock-sim
Syntax
lock-sim
Context
tools>perform>mda>cellular>sim
Description
This command enables the PIN verification function on the SIM and locks the SIM. When locked, the SIM can only be accessed if the operator enters the PIN stored in the configuration file.
When this command is issued, the CLI prompts the user to enter the current PIN in order to lock the SIM.
When an operator successfully locks a SIM, unblocks a SIM, or changes a SIM PIN, the system updates the PIN value in the system configuration. However, the system does not automatically save the system configuration containing the new PIN. The operator must perform an admin>save command immediately after changing the PIN in order to save the new PIN in the system configuration file and avoid potential service interruptions such as the node becoming unreachable.
If the SIM becomes blocked when setting the PIN remotely using in-band management over a cellular port, the node will be unreachable. Physical access to the node will be required to unblock the SIM.
unblock-sim
Syntax
unblock-sim
Context
tools>perform>mda>cellular>sim
Description
This command unblocks a SIM that is currently blocked as a result of too many attempts being made to access the SIM using an incorrect PIN.
When this command is issued, the CLI prompts the user to enter the personal unblocking key (PUK) for the SIM and then enter a new PIN value twice. The PUK is acquired from the service provider or administrator and is also stored on the SIM. The lock/unlock state of the SIM does not change when it becomes unblocked.
When an operator successfully locks a SIM, unblocks a SIM, or changes a SIM PIN, the system updates the PIN value in the system configuration. However, the system does not automatically save the system configuration containing the new PIN. The operator must perform an admin>save command immediately after changing the PIN in order to save the new PIN in the system configuration file and avoid potential service interruptions such as the node becoming unreachable.
If the SIM becomes blocked when setting the PIN remotely using in-band management over a cellular port, the node will be unreachable. Physical access to the node will be required to unblock the SIM.
unlock-sim
Syntax
unlock-sim
Context
tools>perform>mda>cellular>sim
Description
This command disables the PIN verification function on the SIM and unlocks the SIM. When unlocked, the PIN is not required in order to access the SIM.
When this command is issued, the CLI prompts the user to enter the current PIN in order to unlock the SIM.
reset
Syntax
reset
Context
tools>perform>port>cellular>cbsd-authorization
Description
This command resets the CBSD authorization process so that it restarts from the beginning.
scan
Syntax
scan
Context
tools>perform>mda>wlan
Description
This command performs an SSID scan on the WLAN MDA. The WLAN MDA must be configured before the scan can be executed.
When the scan is complete, the WLAN station port attempts to reconnect to the remote AP that it was previously connected to, and the configured WLAN APs are re-enabled so that AP clients can reconnect.
Tools dump commands
diag-port-access
Syntax
diag-port-access status
Context
tools>dump>cellular
Description
This command retrieves information about the TCP server used for remote access to the cellular diagnostics port.The listening port is the TCP port used by the TCP server.
When the TCP server is not enabled, the CLI shows the server status as "disabled" and the server state as "down". The CLI shows the listening port status as "none".
When the TCP server is enabled with a specific port number but no client is connected, the CLI shows the server status as "enabled" and the server state as "waiting for client". The listening port field indicates the TCP port number.
When the TCP server is enabled and a client is connected, the CLI shows the server status as "enabled". It also shows the server state as "client connected" along with the client IP address and client port number. The listening port field indicates the TCP port number.
cbsd-authorization
Syntax
cbsd-authorization
Context
tools>dump>port>cellular
Description
This command shows more information about the CBSD authorization process by displaying the contents of the following messages:
last received registration response
last received grant request response
last received heartbeat response
last transmitted grant request
last-scan-result
Syntax
scan
Context
tools>dump>mda>wlan>last-scan-result
Description
This command displays the results of the last SSID scan on the WLAN MDA.