Xytronix Research & Design WebSwitch XRDI-WS3 User manual

Switch™
a division of....
Xytronix Research & Design, Inc.
North Logan, Utah, USA
© 2012 Xytronix Research and Design, Inc.
Users Manual
Revision: 1.1
Covers:
XRDI-WS3
XRDI-WS3P

Revision 1.1 WebSwitch™ Users Manual
Contents
Trademark and Copyright Information
Warranty
FCC Statement
Installation Guidelines (Read Before Installing)
Section : Introduction
1.1 Features
1.2 Applications
1.3 WebSwitch™ Models Available
1.3.1 Optional Accessories
1. Connectors & Indicators
1.5 Accessing WebSwitch™
Section 2: Installation and Setup
2.1 Mounting
2.2 Connection
2.2.1 Power Supply Connection
2.2.2 Outlet Connection
2.2.3 Network Connection
2.2. Terminal Connector
2.3 Establishing Communications for Setup
2.3.1 Option 1: Assign a temporary IP address to WebSwitch™
2.3.2 Option 2: Assign a temporary IP address to configuration computer
2.3.3 Open Configuration Web Page
2. WebSwitch™ Setup Pages
2. .1 Main Tab
2. .2 Network Tab
2. .3 Advanced Network Tab
2.3.3 2. . Password Tab
2. .5 Date/Time Tab
2. .6 Logging Tab
2. .7 Outlets Tab
2. .8 Inputs Tab
2. .9 Sensors Tab
2. .10 Events Scheduler Tab
2. .11 Script Tab
2. .12 Control Page Setup Tab
Xytronix Research & Design, Inc. 1

Revision 1.1 WebSwitch™ Users Manual
Section 3: Operation
3.1 Browser Operation
3.2 XML Operation
3.2.1 Controlling the unit through state.xml
3.2.2 GET Requests
3.2.3 Monitoring Events through eventX.xml
3.2. XML Diagnostics
3.3 Configuring Events Through Get Requests
3. Modbus Operation
3.4.1 Read Coils (Modbus Function Code 01 (0x01))
3.4.2 Read Discrete Inputs (Modbus Function Code 02 (0x02))
3.4.3 Read Holding Registers (Modbus Function Code 03 (0x03))
3.4.4 Write Single Coil (Modbus Function Code 05 (0x05))
3.4.5 Write Multiple Coils (Modbus Function Code 15 (0x0F))
3.4.6 Write Multiple Registers (Modbus Function Code 16 (0x10))
3.5 Email Notification
3.5.1 Email Notification Description
3.5.2 Email Notification Setup
Appendix
Appendix A: Restoring Factory Default Settings
Appendix B: Installing New Firmware
Appendix C: Accessing WebSwitch™ Remotely Over the Internet
Appendix D: External Server and Remote Services
Appendix E: Log Files
Appendix F: SNMP Requests, Objects and Community Strings
Appendix G: BASIC Scripts
Appendix H: Specifications
Appendix I: Mechanical Information
Xytronix Research & Design, Inc. 2

Revision 1.1 WebSwitch™ Users Manual
Trademark and Copyright Information
This document is Copyright ©2012 by Xytronix Research & Design, Inc. All rights reserved.
WebSwitch™, WebRelay™, ControlByWeb™, and Xytronix Research & Design™ are trademarks of
Xytronix Research & Design™, Inc. 2012.
All parts of this product and design including but not limited to firmware, hardware design, schematics,
PCB layout, concept, graphics, users manual, etc., are property of Xytronix Research & Design, Inc.
©2012. WebSwitch™ may not be opened, disassembled, copied or reverse-engineered.
No part of this manual may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying or scanning, for any purpose other than the personal use by the
purchaser of this product. Xytronix Research & Design, Inc., assumes no responsibility for any errors
that may appear in this document.
Whereas reasonable effort has been made to make the information in this document as useful and
accurate as possible, Xytronix Research & Design, Inc. assumes no responsibility for the application,
usefulness, or completeness of the information contained herein. Under no circumstance will Xytronix
Research & Design, Inc. be responsible or liable for any damages or losses including direct, indirect,
special, incidental, or consequential damages or losses arising from either the use of any information
contained within this manual or the use of any products or services referenced in this manual.
Xytronix Research & Design, Inc. reserves the right to change any product’s features, specifications,
documentation, warranties, fee schedules, and conditions at any time and without notice.
Xytronix Research & Design, Inc. 3

Revision 1.1 WebSwitch™ Users Manual
Warranty
This Xytronix Research & Design, Inc. product has a warranty against defects in material and
workmanship for a period of one year from the date of shipment. During the warranty period, Xytronix
Research & Design, Inc. will, at its option, either repair or replace products that prove to be defective.
This warranty is extended to the original purchaser of the equipment only.
For warranty service or repair, the product must be properly packaged, and returned to Xytronix
Research & Design, Inc. The purchaser shall prepay all charges for shipping to Xytronix Research &
Design, Inc., and Xytronix Research & Design, Inc. will pay the shipping charges to return the product to
the purchaser as long as the product is shipped within the United States. If the product is shipped
outside of the United States, the purchaser shall pay all shipping charges, duties, and taxes.
Limitation
The foregoing warranty shall not apply to defects or damage resulting from improper use or misuse,
unauthorized repair, tampering, modification, improper connection, or operation outside the
electrical/environmental specifications for the product. Further, the warranty does not cover Acts of God,
such as fire, flood, hurricanes, and tornadoes. This warranty does not cover damage to property,
equipment, direct, indirect, consequential, or incidental damage (including damage for loss of business
profit, business interruption, loss of data, and the like) arising out of the use or misuse of this product.
UNDER NO CIRCUMSTANCES WILL THE LIABILITY OF XYTRONIX RESEARCH & DESIGN, INC. TO
THE PURCHASER OR ANY OTHER PARTY EXCEED THE ORIGINAL PURCHASE PRICE OF THE
PRODUCT, REGARDLESS OF THE FORM OF THE CLAIM. No other warranty is expressed or implied.
Xytronix Research & Design, Inc. specifically disclaims the implied warranties or merchantability and
fitness for a particular purpose. Some jurisdictions may not allow the exclusion of limitation of liability for
consequential or incidental damage.
Xytronix Research & Design, Inc.

Revision 1.1 WebSwitch™ Users Manual
FCC Statement
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
━This device may not cause harmful interference.
━This device must accept any interference received, including interference that may cause undesired
operation.
Warning
This equipment has been tested and found to comply with the limits for a Class B digital device,
pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection. This
equipment generates, uses and can radiate radio frequency energy and, if not installed and used in
accordance with the instructions, may cause interference to radio communications. There is no
guarantee, however, that interference will not occur in a particular installation. If this equipment does
cause harmful interference to radio or television reception, which can be determined by turning the
equipment off and on, the user is encouraged to try to correct the interference by one or more of the
following measures:
━Reorient or relocate the receiving antenna.
━Increase the separation between the equipment and receiver.
━Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
━Consult the dealer or an experienced radio/TV technician for help.
Notice
Changes or modification not expressly approved by the party responsible for compliance could void the
user’s authority to operate the equipment.
Xytronix Research & Design, Inc. 5

Revision 1.1 WebSwitch™ Users Manual
Installation Guidelines (Read Before Installing)
━Do not open WebSwitch™ enclosure. This could damage the unit or cause personal harm and will
void the warranty.
━This unit must be installed by qualified personnel.
━This unit must not be installed directly outdoors.
━This unit must not be used for medical, life saving purposes, or for any purpose where its failure
could cause serious injury or the loss of life.
━This unit must not be used in any way where its function or failure could cause significant loss or
property damage.
Notes about security:
By design, WebSwitch™ is very secure. It does not support terminal or file transfer programs such as
telnet, FTP, SSH, etc. This means it is not possible for someone to ‘break in’ to WebSwitch™ and
access other devices on your local network. The simplicity of WebSwitch™ makes it a very secure
device. As with any device to be installed on a network, there are some security precautions that should
be observed. If WebSwitch™ is installed on the Internet, it is recommended that passwords be enabled
for the Control Page. Make sure secure passwords are used. Passwords should be at least 8
characters in length and should be a combination of upper case letters, lower case letters, and numbers.
Don’t use passwords that would be easy to guess. For additional security, a firewall may be used to limit
access only to selected IP addresses. Another option may be to set up a Virtual Private Network (VPN)
between the network where WebSwitch™ resides and the client machine (web browser, another,
ControlByWeb™ product, etc.).
Final installation note:
This ControlByWeb™ product supports connection to 10Mbps and 100Mbps networks. Although
100Mbps networks are faster, the amount of data transferred to and from this device is very minimal and
little, if any, performance increase will be gained by setting it to 100Mbps. There are advantages,
however, to operate this device at 10Mbps. At 10Mbps, less power is required, the unit runs cooler, and
the lifetime of the product will be extended.
Xytronix Research & Design, Inc. 6

Revision 1.1 WebSwitch™ Users Manual
Section : Introduction
WebSwitch™ is a self contained, remote power controller with two electrical outlets and a built-in web
server. Each outlet can be individually controlled and/or monitored over any IP network including private
networks, IP-based industrial control networks, and the Internet.
Users can operate WebSwitch™ using a web browser, or applications (custom or off the shelf) can be
used to control WebSwitch™ from a computer, PLC, or other automation controller.
. Features
WebSwitch™ includes the following features:
✔Two individually controlled AC outlets with selectable power-on state.
✔Designed for Worldwide use; accepts an input voltage range of 100-2 0V AC.
✔Control from a standard web browser; no special software required.
✔Automatic Reboot mode can be used to reboot devices when they fail to respond to PING requests.
✔Built-in web server provides direct access to the device; no external servers, services, or subscriptions
required.
✔Supports SNMP and Modbus/TCP for interoperability with other devices and/or software.
✔“Remote Services” provides a convenient mechanism for connection with external servers and web
services for special applications.
✔Control page can be customized with appropriate text for descriptions and buttons.
✔Password protection.
✔IP filter provides simple firewall functionality for added security.
✔Selectable TCP Ports.
✔10/100 Mbps Ethernet connectivity.
✔Field re-programmable; users can install firmware updates when available.
✔Attractive, rugged enclosure made of flame resistant plastic.
✔Designed for performance and reliability rather than lowest production cost.
✔Wall mountable, or optional rack mounting kit is available.
Xytronix Research & Design, Inc. 7

Revision 1.1 WebSwitch™ Users Manual
WebSwitch Plus™ (model XRDI-WS3P) also includes the following features:
✔Temperature and/or humidity sensors can be connected for environmental monitoring. (One temperature
sensor is included, use up to three sensors.)
✔Dry-contact sensors or switches can be connected for local control of outlets or for monitoring external
devices such as access doors (two discrete inputs).
✔Real-time clock can automatically adjust for daylight savings time and can be synchronized with NTP
server.
✔Event scheduler with yearly calendar; automatically turn outlets on/off or reboot at pre-scheduled times.
✔Email alerts can be configured to send email or text messages when outlets/inputs change or when
temperature goes out of range.
✔Logging; log outlet changes, automatic reboots, high/low temperatures, network traffic, and more.
✔Simple scripts can be written in BASIC for advanced functionality.
✔System log provides detailed diagnostic information.
✔Configure manually or with DHCP.
Note: WebSwitch Plus™ sends out email messages only. Most wireless carriers provide free services to
convert email messages to text messages.
.2 Applications
WebSwitch™ can be used with servers, computers, routers, etc., to provide remote control, automatic
reboot, or scheduled control of these devices. When configured for automatic reboot, WebSwitch™ will
periodically ping a designated IP address and wait for a response. If there is no response to the ping,
WebSwitch™ will attempt to bring the device back to normal operation by rebooting the device. There
are two common scenarios where the Automatic Reboot feature is useful.
1. WebSwitch™ may be set up to ping a server directly and reboot the server if it fails to respond.
2. WebSwitch™ could be used to reboot a network or communications device if pings to a remote
address fail. In this case, WebSwitch controls the power to a network router, switch, radio,
modem, etc., but pings a device elsewhere on the network. The assumption is that if the pings
cannot reach the remote device, the local communications device may be at fault, so rebooting
the device will hopefully restore network communications.
Xytronix Research & Design, Inc. 8

Revision 1.1 WebSwitch™ Users Manual
.3 WebSwitch™ Models Available
WebSwitch™ is currently available in two models. The main differences between each model are listed
below.
XRDI-WS3 Standard WebSwitch™ with two individually controlled outlets, built-in web
server, and automatic reboot functions.
XRDI-WS3P WebSwitch Plus™ includes all features of standard model plus
temperature/humidity monitoring (humidity monitoring requires optional humidity
sensor), discrete inputs, event scheduling, logging, and additional relay contact
protection.
.3. Optional Accessories
Accessory Description Part Number
Temperature Sensor Digital temperature sensor with 12 inch wire leads.
(Model XRDI-WS3P only)
Note: eads may be extended
X-DTS-U
Temperature Sensor
(Wall Mount)
Digital temperature sensor housed in vented plastic
enclosure
(Model XRDI-WS3P only)
X-DTS-WM
Temperature/Humidity
Sensor
Digital temperature and humidity sensor housed in
vented plastic enclosure. (Model XRDI-WS3P only)
X-DTHS-WM
Rack Mount Kit Rack mount hardware for mounting WebSwitch™ in a
standard 19 inch rack.
X-WS-RMK
Xytronix Research & Design, Inc. 9

Revision 1.1 WebSwitch™ Users Manual
.4 Connectors & Indicators
WebSwitch™ has two AC power outlets (IEC 320 C13 female connectors), one AC power input (IEC 320
C1 male connector) and one Ethernet connector. WebSwitch Plus™ also includes a 5-position
removable terminal connector to provide connection to discrete inputs and temperature and/or humidity
sensors.
WebSwitch™ has five LED indicators. Three LEDs are located on the front panel. One LED is labeled
Power and is illuminated green when the module is powered. Two LEDs are labeled Out 1 and Out 2.
These are illuminated when the associated outlet is powered. The other two LEDs are located on the
Ethernet connector on the back panel. They are labeled LINK and ACT. LINK is illuminated green when
the module is properly connected to an Ethernet network and is ready to communicate. Network
communications will only occur if this LED is illuminated. The ACT LED flashes amber when activity is
detected on the network.
Xytronix Research & Design, Inc. 10
Figure 1.4a- Connectors and Indicators

Revision 1.1 WebSwitch™ Users Manual
.5 Accessing WebSwitch™
Standard Access Using a Web Browser
WebSwitch™ has a built-in web server and provides simple web pages that can be accessed directly
using a standard web browser. This allows users to access the unit with NO SPECIAL SOFTWARE
installed on their computer. This is ideal for applications that require a quick, simple solution that does
not need to be accessible to more than a few people. This configuration is simple to setup, simple to
use, and can be accessed from any computer.
Note: Computers that are not on the local network may only access WebSwitch™ if the local network
router is configured to allow access from users beyond the local network (see Appendix C).
Note: This manual assumes standard access. Other methods of accessing WebSwitch™ are explained
in Appendix D.
Xytronix Research & Design, Inc. 11

Revision 1.1 WebSwitch™ Users Manual
Section 2: Installation and Setup
Installation consists of mounting WebSwitch™, connecting to an IP Network, providing power, and
configuring via a web browser.
For WebSwitch Plus™ models, inputs and sensors can be wired to the device using the 5-position
terminal connector.
2. Mounting
WebSwitch™ can be placed upon a table top, wall mounted, or rack mounted (with optional rack mount
kit). It should be mounted in a clean, dry location where it is protected from the elements. Ventilation is
recommend for installations where ambient air temperature is expected to be high.
To mount WebSwitch™ to a wall, use two #8 screws. Attach the screws to the wall horizontally spaced
6 3/8 inches (162 mm) apart. The head of the screws should be about 1/10 inch away from the wall. See
Appendix I for additional mechanical details.
If WebSwitch™ is to be rack mounted, the rack mounting kit should be purchased separately. Insert the
rack mount ears on both sides of WebSwitch™. Secure the rack mount ears by inserting the two pins on
the bottom of the unit. Place WebSwitch™ in the desired location on the rack. Use four rack mount
screws to secure WebSwitch™ to the rack.
Xytronix Research & Design, Inc. 12
Figure 2.1a - WebSwitch™ Shown with Optional Rac Mount Ears

Revision 1.1 WebSwitch™ Users Manual
2.2 Connection
2.2. Power Supply Connection
Connect the IEC 320 C1 Male Connector Power Input of WebSwitch™ to a power source (120-2 0V
AC).
2.2.2 Outlet Connection
Connect one or both of the outlets on WebSwitch™ using the IEC 320 C13 Female Connectors to the
device(s) to be controlled.
WARNING: DO NOT USE WEBSWITCH™ TO CONTROL A COMBINED LOAD OF MORE THAN 10
AMPS
Xytronix Research & Design, Inc. 13
Figure 2.2a - Connections

Revision 1.1 WebSwitch™ Users Manual
2.2.3 Network Connection
Connect the Ethernet port to a 10 Base T or 10/100 Base T Ethernet connection. This typically connects
to an Ethernet hub, switch, or router. For configuration, WebSwitch™ may be connected directly to the
Ethernet port on a computer using a “crossover” cable. Otherwise, for connection through a hub or
router, a standard “straight-through” cable should be used.
WebSwitch™ can be used indirectly on a wireless network. This is done by using a wireless Ethernet
bridge or a wireless router. The network connection of WebSwitch™ is connected to the wireless device
and the wireless device makes the connection to the wireless network.
Note: The wireless Ethernet bridge or router must be properly setup for the wireless network used. Refer
to the installation instructions that came with the wireless device.
Xytronix Research & Design, Inc. 1
Figure 2.2c - Wireless Connection
Figure 2.2b - Networ Connection

Revision 1.1 WebSwitch™ Users Manual
2.2.4 Terminal Connector (XRDI-WS3P only)
The WebSwitch Plus™ model includes a removable 5-position terminal connector which is used for
connecting temperature sensors, humidity sensors, or discrete inputs. The terminals are described in the
table below.
IMPORTANT: MAKE SURE WIRES ARE PROPERLY ATTACHED TO THE TERMINALS AND THAT
THE TERMINALS ARE TIGHT!
5-pin connector pinout for XRDI-WS3P Only
Pin Description
Data
Temperature/Humidity Data. This is the data line
connection for the digital temperature/humidity
sensors.
+5V Out This output voltage is used to provide power for the
digital temperature/humidity sensors.
Ground Ground connection for 5V DC output, and Inputs.
Input 1 & 2 Discrete Inputs.
Xytronix Research & Design, Inc. 15

Revision 1.1 WebSwitch™ Users Manual
2.2.4. Input Connection (Model XRDI-WS3P only)
Two discrete inputs are provided which can be connected to dry contact sensors or switches. Sensors
can be used for monitoring alarm conditions such as access or thresholds. Alternatively, if local control of
the outlets is needed, switches can be connected to the inputs and the unit can be configured such that
they control the outlets.
Connect one terminal of sensor or switch to the input terminal (Input 1 or Input 2) on WebSwitch Plus™.
Connect the other terminal to the ground terminal on WebSwitch Plus™. When contacts are closed the
input is connected to ground and the input is considered to be “ON”.
Xytronix Research & Design, Inc. 16
Figure 2.2d - Input Schematic
Figure 2.2e - Input Connection

Revision 1.1 WebSwitch™ Users Manual
2.2.5 Temperature/Humidity Sensor Connection(Model XRDI-WS3P only)
Temperature and/or humidity sensors can be used for monitoring environmental conditions. The sensors
all share the same terminals (+5V, Ground, Data) and up to three sensors can be connected. The
sensors are able to share the same terminals without interference because they communicate with
WebSwitch Plus™ using a digital bus called the “one-wire bus” which was developed by Dallas
Semiconductor. Every sensor on the one-wire bus is assigned a unique serial number when it is
manufactured. That number is used to address the device during communication.
The sensors have three wires; the wire color is explained below.
Sensor Wire Color Connection
Red Vout
Black Gnd
Blue (or White) Data
Multiple sensors can be connected in two ways. They can all be directly connected to the unit, or they
can be “daisy chained” as shown in Figure 2.2g.
Many factors will determine the maximum length of cable used to connect sensors to WebSwitch Plus™.
Some of these factors include, but are not limited to, the type of cable used, the number of sensor,
ambient electromagnetic noise, and sensor network topology. Combined cable lengths to all sensors of
600 ft using Cat 5e cable have been successful. However due to the uniqueness of installation
environments, results may vary. Please test in the desired environment before permanent installation.
The following are general recommendations that will maximize sensor runs and minimize problems.
Cat 5 and Cat 5e network cable have proven to be an effective and low-cost solution for long runs. Other
cable types can be used, but cable capacitance may limit length. Figure 2.2h shows the recommended
connection using Cat 5 network cable.
Xytronix Research & Design, Inc. 17
Figure 2.2f - Temperature Sensor
Figure 2.2g - Direct Connection and Daisy Chain Connection
Figure 2.2h - Recommended connection using Cat 5 cable

Revision 1.1 WebSwitch™ Users Manual
A linear (daisy chain) topology will minimize signal reflections, providing a more reliable connection and
longer cable lengths than a star topology.
Appropriate strain relief should be used at WebSwitch™ and other connections may be subjected to
vibration, movement, or repeated handling.
Avoid sensor runs adjacent to industrial equipment power cables. These cables have high current spikes
that may induce noise on the sensor signals. Similarly, avoid running sensor cables near any radio
transmission antennas or coaxial feedlines.
Protect any electrical connections with appropriate weather shielding.
Due to the broad range of applications and environments were the WebSwitch™ may be employed,
installation success on long sensor runs may vary significantly.
Xytronix Research & Design, Inc. 18

Revision 1.1 WebSwitch™ Users Manual
2.3 Establishing Communications for Setup
WebSwitch™ is set up using a web browser. The first task is to establish communications between a
computer and WebSwitch™ so that the browser-based configuration can begin. To do this, the computer
and the WebSwitch™ must be physically connected to the same network and both must have IP
addresses on the same network. There are two ways to set up the computer and WebSwitch™ so that
they are on the same network. The first (Option 1) is to change the IP address of WebSwitch™ to an
address that is on the same network as the computer. The second (Option 2) is to change the IP
address of the computer to an address that is on the same network that WebSwitch™ is set to by
default.
2.3. Option : Assign a temporary IP address to WebSwitch™
This option is used to TEMPORARILY assign an IP address to WebSwitch™ without the need to change
the IP address of the configuration computer. Note that WebSwitch™ will only use this IP address as
long as power is maintained. Once power is lost and restored, WebSwitch™ will use the IP address
assigned in the setup page and not the temporary address assigned here. This means that once
communications are established, the desired IP address should be entered into the Network setup tab
using the browser.
To assign the temporary IP address...
1. Make sure WebSwitch™ and the configuration computer are connected to the same network.
This will not work through routers or gateways.
2. Assign the address as follows:
Windows:
Open a Command Prompt (select START, then RUN, then type “cmd”).
Note: For Vista, the Command Prompt should be run as administrator (select Start, then type “cmd” and
right click on “cmd” and select “Run as administrator”).
Type:
arp -s {new IP address} {serial number of WebSwitch™ }
Note: IP address format is xxx.xxx.xxx.xxx
Serial number format is ss-ss-ss-ss-ss-ss
For example, to set WebSwitch™ (with serial number 00-0C-C8-01-00-01 ) to 10.10.10. 0 the
following command would be used:
arp -s 10.10.10.40 00-0c-c8-01-00-01
Next, type:
ping -l 102 {new IP address}
For example, if the new IP address is 10.10.10. 0, the following command would be used:
ping -l 102 10.10.10.40
Linux/Unix:
Open a terminal, change to root user (su -, then enter root password).
Xytronix Research & Design, Inc. 19