at-command at-command
tools>perform>mda>cellular
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.
a supported AT command
auto-boot {complete | retry | terminate}
[no] auto-boot echo [debugger]
tools>perform
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.
specifies that the ADP-Hm process is complete
specifies that the ADP-Hm process is being retried
specifies that the ADP-Hm process has been terminated
force-sim-switch
tools>perform>mda>cellular
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 firmware-file
update-firmware firmware-file sim 1 | 2
tools>perform>mda>cellular
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.
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
tools>perform>mda>cellular>sim
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
tools>perform>mda>cellular>sim
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.
Ensure that the specified SIM is the currently active SIM.
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
tools>perform>mda>cellular>sim
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.
Ensure that the specified SIM is the currently active SIM.
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
tools>perform>mda>cellular>sim
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.
Ensure that the specified SIM is the currently active SIM.
When this command is issued, the CLI prompts the user to enter the current PIN in order to unlock the SIM.
reset
tools>perform>port>cellular>cbsd-authorization
This command resets the CBSD authorization process so that it restarts from the beginning.
scan
tools>perform>mda>wlan
This command performs an SSID scan on the WLAN MDA. The WLAN MDA must be configured before the scan can be executed.
Executing this command disconnects the WLAN station port if it is connected to a remote AP and shuts down any configured WLAN AP ports that are enabled.
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.