Remote Command Instructions

This feature can be accessed by Laundry/Integration/Amusement Vendor Admin. Only roles with both Room Management and Remote Command permissions can use this feature.

Click the “Remote Command” tab on the Room View page, you will see a new section displayed. This feature allows users to send remote commands to devices including readers, modems, and kiosks, etc. In this way operators don’t need to physically visit the field to execute actions like rebooting readers, kiosks, and modems, starting machines, setting readers in/out of service and cycling the power to devices. You can follow the major steps below to issue a remote command.

To perform the tasks remotely, all hardware must be online and connected to the internet.

Terminals below following versions do not support Remote Command: Ultra VXT USA [1300.847.013.012]; Ultra VXT CAN [1400.841.000.019]; Elevate Card Connect & PCS [0100.295.001.007]; Ultra LX [1200.834.013.011]; AVU Touch [1.7.0.0].

1) Click the drop-down list of “Action” then the remote commands will be revealed. Click to select the action you’d like to perform.

• The Remote Power Cycle command requires a Remote Power Cycle Module (RPC-M) paired to the machine that you’d like to cycle the power to. If the machine is paired with the RPC-M, you will see an plug-shaped icon displayed aside it in Room View.

• The Reboot Modem command applies to the KioSoft modem only.

2) In the Comments field, you can leave a note which will be displayed on the Activity Detail page of Activity Audit Log. This field is not mandatory.

3) Click the Date/Time picker of the field “Issue Command Time” which follows the server time to schedule the remote command. Pick a date on the calendar then choose a specific time on the page followed. You can schedule a remote command to maximum 1 month later. Or you can click the “Today” button to issue the command immediately after all steps are completed.

If you select Today to issue an immediate remote command, you’ll need to finish the remaining steps within 1 minute otherwise it will fail and prompt the message “Issue Command Time cannot be earlier than the current time.”

4) Then it comes to the step to select the device(s) to issue the command. There are basically two ways to make the selection. You can use the search bar to input the keyword supported, including machine #, SN, and Machine ID/Name, to search for the desired device, tick its checkbox then click the “Submit” button. Or you can look through the list to tick the checkbox(es) of the desired device(s) then click the “Submit” button. The checkbox in the list heading can be used to select all devices. The latter method supports to issue one command to multiple devices.

Offline devices are not selectable. If a reader’s offline status is caused due to failure to connect to MQTT, reconnection action will be performed during the next daily reboot or manual power cycle. And if a modem is rebooting, all its connected readers will also turn to offline status in about 2 minutes and in about 5 minutes after the modem reboots, the readers will be online and available for remote command.

5) After all parameters are set, click “Submit” to issue the remote command. You need to click the Search button again to obtain the updated command status. You may experience the following scenarios after the remote command is submitted.

• If it’s a scheduled task in future time, you will see it listed with the Command Status being “Wait To Process” and a Cancel button in red. When there is a time conflict between the reader and the paired router, a prompt message will be displayed to the user as a reminder. The cancellation action will impact both devices.

  

• When the command is not successfully executed, a Retry option will be displayed in the list. It is an immediate action upon click.

  

• If a device is busy, the remote command won’t be executed so as not to interfere with the ongoing operations. It will also indicate the busy status in the record list.

  

• When the command is issued and no response is received, its Command Status will be displayed as Wait to Process (otherwise it will be Processing). For Remote Power Cycle, after 10 minutes with no result returned, its status will be marked as failed; for the other commands, the status will be marked as failed after 5 minutes with no result returned.

• For the Remote Power Cycle command, you may need to wait for 10 minutes or so to get the final status of the command. If the command status displays successful, it means the command is successfully received by the reader. You can go to Activity Audit Log to view the execution result of this command. Please see the below chart for the remote commands and their related activity types to select in the Activity Audit Log.

  No.	Remote Command	Activity to Select
  1	Reboot Reader	Reboot Reader
  2	Reboot Kiosk	Reboot Kiosk
  3	Reboot Modem	Reboot Modem
  4	Start Machine	Start Machine
  5	Set Reader In Service	Set Reader In Service
  6	Set Reader Out of Service	Set Reader Out of Service
  7	Remote Power Cycle	Manual Power Cycle
  8	All Remote Commands	Canceled Remote Control

• For the command Start Machine, if it is issued successfully but the machine user does not press the Start button of the machine within 1 minute, the command status will indicate start failed and the reader will return to the idle page.

• If you set a reader out of service, it will not accept any payment and display OOS on the reader screen. You can issue another remote command like reboot but it will stay in out-of-service status after the reboot. You need to set an OOS reader in service for it to start to work and accept payments again.