ControlByWeb WebRelay X-WR-1R12-1I5-5 User Manual page 47

WebRelay Users Manual
For a more technical description of this option, commands sent to remote WebRelay units look like this:
http://192.168.1.2/state.xml?relayState=1
When a 0 is entered into this field, the above format is used which is required for standard WebRelay
units. Commands sent to a remote WebRelay-Quad look like this:
http://192.168.1.2/state.xml?relay1State=1
http://192.168.1.2/state.xml?relay2State=1
http://192.168.1.2/state.xml?relay3State=1
http://192.168.1.2/state.xml?relay 4 State=1
In this case, each of the four relays can be addressed as illustrated. The address of the specific relay on
the WebRelay-Quad board is given in this field.
For custom computer applications, the 'Relay #' option may be useful to monitor input changes as they
happen. This works by pointing the 'Remote Relay IP Address' above, to a computer instead of another
WebRelay device. Each time the input changes, a message is sent to the computer indicating the
change. The computer can identify the device sending the message by the 'Relay #'. Note that when
remote relay commands are sent to a computer instead of a WebRelay, the computer must appear to
this WebRelay as another WebRelay device which may require some advanced programming. This field
may be set from 0 to 255.
Password
When any option in the 'Remote Relay Options' setting is selected other than no remote relay control,
this password is included with commands that are sent to the remote WebRelay unit. If the remote
WebRelay unit has the control password option enabled, the password for that unit must be entered
here for the remote commands to have any effect.
Keep Alive
When any option in the 'Remote Relay Options' setting is selected other than no remote relay control,
the Keep Alive option may be turned on to keep the TCP connection to the remote WebRelay unit alive.
If the connection is alive, commands sent to the remote unit will change the state of the remote relay
almost instantly (with a good network connection). If the connection is not alive, commands sent to the
remote unit will be delayed a few seconds while the connection is being setup. There are three options
available in this field.
NO: When this option is selected, the TCP connection between the two units will be terminated if
there is a time gap (more than about 50 seconds) between commands. Once the connection is
closed, the two WebRelay units must re-establish a connection before the next command can be
sent. This means that when the input voltage toggles, it may take a few seconds for the remote
relay to respond. In many cases, this delay may not be a problem. This option uses the least
network bandwidth (and is the most secure) because communications only take place when the
input voltage changes.
YES (No TX State): When this option is selected, a message is sent to the remote unit every 50
seconds to keep the TCP connection alive. The message does not contain the state of the local
input. If power is lost and the control voltage changes while the unit is not powered, the new
control voltage status will not be sent to the remote unit when the power is restored. The state
will not be updated until the next time the control input changes.
YES (TX State): When this option is selected, a message is sent to the remote unit every 50
seconds to keep the TCP connection alive. This message will contain the current state of the
input. By sending the state of the unit, changes to the control voltage input will eventually be
sent to the remote unit, even if the change occurred during a power loss. Transmit state is only
valid for the 'Remote Relay Options' remote command equals input, remote command
Xytronix Research & Design, Inc. Page 47