Remote Spectrum Monitor User Guide : Graphical User Interface : Setting Secure Mode : Commands
 
Commands
set_secure_mode,<system override password>,<on/off>
Description
Sets Secure Mode on or off. Responds with “ok” if secure mode has been successfully turned ON or OFF. If secure mode is OFF, sending “on” turns secure mode ON (blocking all users not on the whitelist from accessing any port except 8001) and adds the user to a whitelist. If secure mode is ON already and the user sends “on”, the user is simply added to the whitelist. Sending “off” triggers a master reset and unblocks ports for all users. Responds with “password_match_fail” if provided System Override password is incorrect. Responds with “command_match_fail” if “on” or “off” is not sent.
The maximum number of registered clients is 100. Responds with “exceeded_max_secure_mode_users_fail” if max number of secure mode users have already been reached prior to the command being sent.
Parameters
<system override password>,<on or off>
Syntax Example
set_secure_mode,<demopassword>,<on>
force_reboot,<system override password>
Description
Reboots the remote spectrum analyzer. Responds with “ok” if command is accepted. A response of “password_match_fail” is returned if the provided System Override password is incorrect.
Parameters
<system override password>
Syntax Example
force_reboot,<demopassword>
change_password,<System Override Password>,<New Password>
Description
Changes the System Override Password. A response of “ok” if password has successfully been changed.
“password_match_fail” is returned if the provided System Override password is incorrect.
“command_match_fail” is returned if the new password is empty.
“password_over_50_characters_fail” is returned if the password length is greater than 50 characters.
Parameters
<system override password>,<new password>
Syntax Example
change_password,<demopassword>,<newdemopassword>
reset_password
Description
Resets the System Override password back to the default value. A response of “ok” is returned when the password has successfully been reset.
Parameters
None
Syntax Example
reset_password
query_secure_mode_state
Description
Retrieves secure mode state, ON or OFF. A response of “on” is returned if secure mode is ON or “off” if secure mode is OFF.
Parameters
None
Syntax Example
query_secure_mode_state