all | frequencies |
|
exhibits | applications |
---|---|---|---|---|
manual |
app s | submitted / available | |||||||
---|---|---|---|---|---|---|---|---|
1 |
|
User manual | Users Manual | 4.12 MiB | ||||
1 | RF Exposure Info | |||||||
1 | Cover Letter(s) | |||||||
1 | External Photos | |||||||
1 | Internal Photos | |||||||
1 | ID Label/Location Info | |||||||
1 | RF Exposure Info | |||||||
1 | Test Report | |||||||
1 | Test Setup Photos |
1 | User manual | Users Manual | 4.12 MiB |
Introduction Section 1: Introduction XW-210 WiFi Users Manual The XW-210 is an easy to use Wi-Fi enabled relay, temperature monitor and status alerting device. The XW-210 has a built-in relay for controlling lights, motors and other relatively high current loads, a digital input which can be used to monitor and report the status of switch closure sensors and a 1-wire port for connecting up to four digital temperature or other Xytronix 1-wire sensors. The XW-210 is ideal for applications where devices must be controlled or where temperature or events must be monitored and Ethernet wiring is not accessible or practical to install. The module is powered by an external wall transformer (9-28 VDC), solar panel, or other DC power source. The XW-210 works well as a standalone device that can be controlled using a web browser. It can be configured using simple menus and drop-down lists. It includes features such as logging, input state monitoring, and the ability to control other relays on other devices. The XW-210 can be a self-contained wireless access point that requires no additional servers or ControlByWeb devices. In this mode the XW-210 provides live, real-time temperatures or input status directly to a single user through web browsers or the CBW Mobile app. After being commissioned the XW-210 can recognize and attach to your Wi-
Fi access point. The XW-210 offers the ability to control it's relay, monitor temperature or input status and send out email alerts (which can be converted to text message alerts) whenever an alarm condition occurs. Plug-in terminal strips provide connections for the DC power, relay contacts, optically isolated input and up to 4-temperature or other Xytronix 1-wire sensors. No other cables, interfaces, or PC utility programs are needed. Two push-button switches aid in provisioning the module. Press the Access Point button anytime to active the access point mode. With a WiFi enabled PC or smart phone you then connect to and access the internal web server at the default IP address, port and password. Using the web server, you configure the access port, name, and other setup parameters. Alternatively, add the XW-210 to an existing network by pressing the WPS (Wi-Fi Protected Setup) button on both your access point (i.e., router) and the XW-
210. The XW-210 supports a number of Ethernet protocols with it's built-in server, including HTTP, Modbus/TCP, NTP, and XML. The XW-210 has a built-in BASIC interpreter. A control script can be written for special needs or custom applications not provided by the normal control functions. Page 2 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 1.1 Features Wireless Wi-Fi 802.11 b/g/n. Transmission range up to 250ft. Built-in web server for configuration and remote monitoring. Built-in high current relay. Optically isolated digital input. Use the input to control relays or trigger email messages. Pulse counter. 1-wire port for connecting up to 4 digital temperature or other Xytronix 1-wire sensors. Temperature sensors are accurate to +/-0.5C from -10C to +85C. Temperature probes are interchangeable and need no calibration. Powered from a 9 to 24V DC power adapter. The power supply voltage is monitored internally and can be logged. Sensor/Input status can control a relay on other ControlByWeb devices. Configurable logging of the input, counter, temperature, humidity, relay state and Vin. Real-time clock with manual or NTP time sync. Send email alerts (up to 8 addresses) based on any sensor or input conditions. Auxiliary protocols including XML, Modbus/TCP and Remote Services. Custom scrips using the built-in BASIC interpreter provide additional flexibility. Simple and easy to use. 5-year warranty. Xytronix Research & Design, Inc. Page 3 Introduction XW-210 WiFi Users Manual 1.2 Part Numbers and Accessories Device XW-210 Description Wi-Fi WebRelay with built-in web server Digital temperature sensor with short wire leads
(connects directly to the terminal strip) Digital temperature sensor with 3 foot wire leads
(housed in water resistant stainless steel probe) Digital temperature sensor with 32 foot wire leads
(housed in water resistant stainless steel probe) Digital temperature and humidity sensor housed in vented plastic enclosure Part Number XW-210I X-DTS-U X-DTS-S3C X-DTS-S32C X-DTHS-WM Magnetic mount for the temperature sensor probe XW-SMK-1 Wall Transformer, 100-240VAC in, 12V, 1.5A out PS12VW1.5-B Temperature Sensor Temperature Sensor Temperature Sensor Temperature/
Humidity Sensor
(Wall Mount) Magnetic Temperature Sensor Mount Power Supply Water Leak Sensor Water leak sensor Spare Connector 8-position, screw terminal connector Spare Connector 3-position, screw terminal connector GRI-2605 X-TERM8A X-TERM3B Magnetic temperature sensor mount Page 4 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 1.3 Wireless Communication Notes Due to the nature of wireless communications, transmission and reception of data can not be guaranteed. Data may be delayed, have errors, or be lost. Although delays or losses of data are rare with a well constructed network, data can be lost due to interference, noise, reflections, or other environmental conditions. The XW-210 should not be used in situations where failure to transmit or receive data could result in damage to property, equipment, direct, indirect, consequential, or incidental damage, including damage for loss of business profit, business interruption, loss of data, life, and the like. 1.4 Security Notes The XW-210 is a dedicated device and does not employ a general purpose computer operating system
(i.e. Windows, Linux etc.) It does not have features such as telnet, FTP, SSH, nor uncontrolled open ports. This means it is extremely difficult if not impossible for someone to break in to the XW-210 and access other devices on your local network. The simplicity of the XW-210 makes it an inherently secure device. Nevertheless, as with any device installed on a network, appropriate security precautions should be observed. It is recommended that passwords be enabled for the Control Page and Setup Pages. Passwords should be at least 8 characters in length and use a combination of upper and lower case letters and numbers. For additional security, a firewall may be used to limit access to selected IP addresses. Xytronix Research & Design, Inc. Page 5 Introduction XW-210 WiFi Users Manual 1.5 Connectors & Indicators Relay The XW-210 has an internal high-current relay. Screw terminals are provided for the Common, Normally Open, and Normally Closed contacts of the relay. The screw terminals are internally connected directly to the relay with no internal fuse or other over-current protection. The relay contacts are isolated from all other circuits. Digital Input The XW-210 has an optically-isolated digital input. The optically-isolated input provides electrical isolation between the digital input and the low voltage control circuits of the XW-210. The input can be used as a pulse counter and has a built-in debounce of 20ms. 1-Wire Sensor Bus The XW-210 works with 1-wire digital temperature and other Xytronix 1-wire sensors. The sensors are available in several configurations, are interchangeable and require no calibration. The sensors require three connections for communications and power (+5V, Gnd, Data). Control relays or trigger email messages based upon temperature and other sensor values. Power Supply The XW-210 employs modern switch-mode power supply which works from 9 to 28VDC. With this type of power supply the current draw decreases as the voltage increases. The power supply voltage (+Vin) is monitored internally and can be logged. LED Indicators Power: Illuminated whenever the module is powered Relay:
Illuminated whenever the relay is energized Illuminated when a sufficient voltage is applied to the opto-coupler input Input:
Link:
See table below:
WiFi State LINK LED Not connected WPS in progress Access Point mode Connected to network waiting for DHCP Connected to network with static or DHCP Solid on Off Slow flashing (1/4Hz) Med flashing (2Hz) Fast flashing Page 6 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual The XW-210 has an 8-position removable screw terminal connector for power, input and sensor connections. A separate 3-pin connector provides connections to the internal relay. 8-Pin Connector Terminal Description Vout Data Gnd Din+
Din-
Gnd Gnd
+Vin
+5V output to power 1-wire sensor(s), 50mA max Serial data line for 1-wire sensor(s) Gnd output for 1-wire sensor(s) Digital Input + The positive side of the optically-isolated input. Digital Input - The negative side of the optically-isolated input.
- Power Input (GND)
- Power input (GND)
+9 to 28VDC power input Terminal C NO NC 3-Pin Connector Description Relay COMMON Relay NORMALLY OPEN Relay NORMALLY CLOSED Xytronix Research & Design, Inc. Page 7 Introduction XW-210 WiFi Users Manual 1.6 Accessing the XW-210 using a Web Browser The XW-210 has a built-in web server that 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 just about any computer or smart phone. Page 8 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Section 2: Installation and Connections Installation consists of mounting the XW-210 and connecting it to a power source. See Section 3:
Provisioning for instructions on commissioning the XW-210 such that it can recognize and connect to your Wi-Fi access point. 2.1 Installation Guidelines This unit must be installed by qualified personnel. This unit must not be installed in unprotected outdoor locations. 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. Do not use to directly control motors or other actuators not equipped with limit switches or other safeguards to protect from equipment or wiring failures. The XW-210 should be located in a clean, dry location where it is protected from the elements. Ventilation is recommended for installations where ambient air temperatures are expected to be high. See Appendix E: Mechanical Information for additional mechanical details. The 1-wire temperature probes are water resistant and can be used in outdoor applications however, they are not suitable for immersion or use in pressure vessels. For immersion and other demanding applications use a thermowell to protect the sensor. 2.1.1 Wall Mounting Mount the XW-210 to a wall by using two #8 screws. Attach the screws to the wall vertically spaced exactly 2.5 inches apart. The head of the screw should be about 1/10 inch away from the wall. 2.1.2 DIN-Rail Mounting The XW-210 can be mounted to a standard (35mm by 7.55mm) DIN-
Rail. Attach the XW-210 to the DIN-Rail by hooking the top hook on the back of the enclosure to the DIN-Rail and then snap the bottom hook into place. To remove the XW-210 from the DIN-Rail, use a flat-
head screwdriver. Insert the screw driver into the notch in the release tab and pry against the enclosure to release the bottom hook. Xytronix Research & Design, Inc. Page 9 Installation and Connections XW-210 WiFi Users Manual 2.2 Making Connections CAUTION: Make sure the power is shut off before making connections CAUTION: This unit should be installed by a qualified technician. CAUTION: Miswiring or misconfiguration could cause permanent damage to the XW-210, the equipment to which it is connected, or both. A removable terminal connector is provided for making the power connections. To help protect the XW-
210 from mechanical stress remove the terminal connector before making the connections. 1. Make sure power is turned off. 2. Remove the terminal connector from the XW-210 and make wiring connections to the terminals. This technique avoids stressing the internal components while torquing the screws. 3. Reconnect the terminal connector. 4. Apply power. It is recommended that any load (device to be controlled) not be connected until after the XW-210 has been configured and tested. By doing this, wiring and configuration mistakes will not cause the load to turn on unexpectedly. Make certain the wires are properly inserted into to the terminals and that the screws are tight. Relay Connector Specifications:
Type:
Connection wire:
Stripping Length:
Connection capacity:
Conductor minimum:
Conductor maximum:
Conductor Type:
Tightening torque:
3-position, removable, 7.62 mm (.30) pitch Use wire rated for 75C (min) for connections to the relay terminal block 7mm 2.5mm2 stranded, 2.5mm2 solid 30AWG (UL/CUL) 12 AWG (UL/CUL) Copper 0.5 Nm (min), 0.6 Nm (max) 2.2.1 Power Supply Connections The XW-210 requires power for its internal logic circuits. Connect a 9-28 VDC power supply to the +Vin and GND terminals. A regulated power supply is recommended, such as a wall-mount AC-DC adapter. Verify that the adapter is rated for the operating current of the XW-210 (See Appendix A: Specifications for the current requirements.) Multiple XW-210 units may be connected to a single power supply by connecting the power supply input terminals in parallel. The power supply must have a high enough current rating to power all units connected. If the XW-210 is powered with a solar panel, the system must include a solar charge controller and a battery. Page 10 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 2.2.2 Antenna Connection The XW-210 comes with an approved 2.4GHz omnidirectional antenna for use with WLAN devices using WiFi (802.11b/g/n). The omnidirectional pattern is suitable for point-to-multipoint broadcasting in all directions. Connect the antenna to the Reverse SMA connector on the faceplate. Do not operate the XW-
210 without the antenna connected. The omnidirectional antenna radiates RF signals in all directions in one plane with a pattern shaped somewhat like a doughnut or torus. The radiated power decreases above or below the plane, dropping to zero on the antenna's axis. Orient the antenna vertically so the antenna will radiate in all horizontal directions and so little radio energy is aimed into the sky or down toward the earth and lost. This device has been approved to operate with an antenna (provided) with the maximum permissible gain specified in the specification (Appendix A: Specifications). Antenna types not included in this specification, having a gain greater than the maximum gain indicated for that type, are strictly prohibited for use with this device. The antenna used for this transmitter must be installed to provide a separation distance of at least 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter except in accordance with FCC multi-transmitter product guidelines. Xytronix Research & Design, Inc. Page 11 Installation and Connections XW-210 WiFi Users Manual 2.3 Relay Connections (Control a device over an IP network) The illustration below shows a simple example of using the relay in the XW-210 to control a device over an IP network. The device to be controlled is wired in series with the relay contacts. Note: The circuit must include a fuse or circuit breaker to provide over-current protection. Page 12 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 2.4 1-Wire Sensor Connections The XW-210 has a 1-wire port which supports up to four digital temperature or other Xytronix 1-wire sensors. The sensors share the same three connections for communications and power (+5V, Ground, Data). Every sensor on the bus is assigned a unique serial number when it is manufactured. That number is used to address the sensor during communication. The digital temperature sensors are interchangeable and require no calibration. The sensors accuracy is
+/-0.5C (-10C to +85C). The temperature sensor is available in several configurations. The encapsulated version has a stainless steel probe and can be used in outdoor applications however, the probe is not suitable for immersion or use in pressure vessels. For immersion and other demanding applications use a thermowell to protect the sensor. The basic sensor (non-encapsulated) must used in protected locations. The temperature sensors have three wires as shown below. Sensor Wire Color Connection Red Black Blue, White, Yellow
+5V Gnd Data Xytronix Research & Design, Inc. Page 13 Installation and Connections XW-210 WiFi Users Manual Multiple sensors can be connected in two ways: directly connected (star topology) or daisy chained
(linear topology). Many factors can determine the maximum length of the cable, including the sensor network topology, the type of cable used, the number of sensors and ambient electromagnetic noise. 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 making a permanent installation. The following are general recommendations that will maximize sensor runs and minimize problems. Cat 5 and Cat 5e network cable has proven to be an effective and low-cost solution for long runs. Other cable types can be used, but cable capacitance generally limits the length. The illustration shows the recommended connection using Cat 5 network cable. Connect all unused conductors to ground. Recommended connections using Cat 5 cable A linear (daisy chain) topology will minimize signal reflections, providing a more reliable connection and will allow longer cable length than a star topology. The 1-wire bus is "single-ended" and has no intrinsic noise protection. It is susceptible to interference if the cable is routed near power lines, fluorescent fixtures, motors or other noise sources. Keep the cable wiring short and avoid routing it near other electrical equipment. Page 14 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 2.5 Digital Input Connections The XW-210 has an optically-isolated digital input which can be used to control the relay and/or a remote relay (over the network), or simply to monitor the state of a device. To use this input, connect a DC control voltage directly to the input, and customize the input function using the XW-210 configuration pages. 2.5.1 DC Input The digital input is connected internally through a current-limiting resistor directly to a photo-coupler circuit. No external resistor is necessary as long as the input signal is within the proper range (See Appendix A: Specifications). A DC voltage can be reduced with an external resistor of the appropriate value and power rating to reduce the input current. The digital input has an internal 3K ohm resistor. The forward voltage drop of the photo-coupler is approximately 1.2V and works well with an input current of 9mA. Use the following formula to determine the resistor value needed for other voltage ranges:
R =((Vin-1.2)/0.009)-3000 Where:
R = External resistor value required Vin = Desired input voltage 1.2V = forward voltage drop of the LED in the photo coupler
.009A = workable LED current 3000 ohm = Internal resistor For example:
To connect a 48VDC signal voltage to the XW-210:
R = ((48-1.2)/0.009)-3000 = 2200 ohms Check the power dissipated by the resistor:
P = I x I x R, The resistor must be at least .009 x .009 x 2200 = 0.18 Watts, so use a 1/2 Watt resistor. Xytronix Research & Design, Inc. Page 15 Installation and Connections XW-210 WiFi Users Manual 2.5.2 Switch Closure Connections The XW-210 can sense the state of a switch closure sensor. Sensors with switch closure outputs include push buttons, magnetic door alarm switches, micro-switches, or any device which has a relay, switch closure or open collector output. The XW-210 can be configured for the alarm to be active when the switch is either open or closed. The illustration below shows an example of using the XW-210 to monitor the status of a gate or door over an IP network. The status of the device is detected with a switch. These types of sensors are called dry contacts in that the sensor output is a bare switch with no power source. In this example the voltage source for the switch is provided via the power supply for the XW-210. Page 16 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 2.5.3 Water Leak Sensor Connections A GRI-2605 water leak detector can be directly connected to the XW-210. The sensor detects the presence of water or other conductive liquids. The sensor has 4-wires which are connected as shown below. The GRI-2605 has an internal relay whose contacts (green & white wires) are closed when the sensor is dry. When the sensor is dry the digital input will be On. When water is detected the relay contacts open and the digital input will be Off. With the connections shown the sensor is a closed loop supervised alarm circuit such that if a wire is disconnected or the sensor fails, an alarm will be generated. The XW-210 can be programmed to activate it's relay, activate a relay at a remote location or send an e-mail warning when a water leak is detected. The GRI-2605 is not recommended for submerged applications or prolonged exposure to water. After installation test the sensor with a damp sponge or wet towel. Xytronix Research & Design, Inc. Page 17 Installation and Connections XW-210 WiFi Users Manual 2.5.4 AC Input Connections If an AC signal voltage needs to be detected, use a signal conditioner to convert the AC signal to a DC voltage within the input range. An AC signal conditioner can be made using a diode (or bridge rectifier) and a capacitor. Prepackaged signal converters are available as accessories at industrial automation distributors. A simple voltage converter module (RedLion VCM10000 or VCM20000) is shown below. These are available in two input voltage ranges that cover the spectrum from 4-270VAC/DC. These devices have a MOSFET output (solid state DC contact closure) which is compatible with the XW-210 input. The converter module accepts AC (50/60 Hz) or DC voltages with an input pulse rate up to 30 Hz. The converter provides isolation between the input and output using an opto-isolator. You must provide a voltage source for the converter circuit as shown in the example below:
Page 18 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Section 3: Provisioning After making the sensor connections and providing power, you must provision the XW-210 for use on your wireless network. The goal is to configure the XW-210 such that it can recognize and attach to your Wi-Fi access point. There are two methods for doing this:
3.1 Access Point By default, the XW-210 comes up as a wireless access point when powered for the first time. Pressing the "access point" push button any time also activates the access point mode. It isn't really an access point because it will not provide internet connectivity to your computer or smart phone, but it will appear as an access point meaning that your computer or smart phone will detect it as an access point and display it as such. When acting as an access point, the XW-210 broadcasts an SSID of XW210-
XXXXXX where XXXXXX are the last six digits of its MAC address. With your wireless device (laptop computer or smart phone) scan for, and attach to the XW210 wireless network. Next, access the web server in the XW-210 using a web browser. To access the setup pages, enter the following URL in the address bar of your web browser:
http://192.168.1.2/setup.html After the page is requested, a password prompt will appear. Enter the username and password. The username is admin and the password is webrelay (password is case sensitive). The next chapter explains each of the setup tabs and screens. Use the WiFi Networks tab for making the proper settings to allow the XW-210 to connect to your access point. Notes About Access Point Mode:
As an Access Point the XW-210 functions independently of other wireless networks. It broadcasts beacons and services WiFi packet requests. In this mode, your computer or smart-
phone is connected directly with the XW-210 on a private network and is NOT using another WiFi network. Typically you would use this for configuration and not for normal operation. The XW-210 has no hardware restore defaults button, to prevent the installer from being locked out, the default username (admin) and password (webrelay) always work in the access point mode, even if the password is changed. If the password has changed via the Password tab, both the new password and the webrelay password will work. Additionally, the IP address and HTTP port will temporarily revert to the default values shown above when in the access point mode. Only one client (computer or smart-phone) can be connected to XW-210 at a time. SSID and password cannot be customized (once again this mode is intended for configuration only). Access point is unsecured and open. Xytronix Research & Design, Inc. Page 19 Provisioning XW-210 WiFi Users Manual 3.2 WPS (Wi-Fi Protected Setup) The WPS Push button method, provides a simple method for attaching the XW-210 to a wireless network without needing to use any setup pages. Although using this method to connect the XW-210 to the network is simple, you will not be able to access the XW-210 web server unless you know the IP address that was assigned by the DHCP sever (router) or unless mDNS services are available on your device. For this reason, it is recommended that you use this method of configuration only when the XW-
210 units have been pre-configured to operate in a non-web-server mode or when you have full access to the DHCP server so you can obtain the IP address that was assigned. To begin, press the WPS button on your wireless router or access-point. You will generally have about two minutes to connect wireless devices to the network with WPS. Now press the WPS push button on your XW-210. After a few seconds, the XW-210 should register itself with the router or access-point. If WPS fails, the XW-210 will automatically enter the access point mode. The XW-210 will use DHCP to obtain an IP address after a successful WPS association. Additionally, the connection information is also broadcast using mDNS. If you need to access the XW-210 using its internal web server you will need to obtain the IP address that was assigned to the XW-210 through your DHCP server or router. Alternatively, if using an mDNS capable device, it may be accessed by entering the following into the address bar of your web browser:
http://xw-210.local/setup.html Page 20 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 3.3 Application Examples The XW-210 can be configured for many different applications. Two general examples are described below:
3.3.1 Warehouse Temperature Example with no Access Point You wish to monitor the temperature of a warehouse with a your smart phone. You don't have a WiFi access point. Mount an XW-210 inside the warehouse. Power it with a DC wall adapter. If no network profiles have been configured, the XW-210 will automatically enter the access point mode and you can access the XW-210 directly with a computer or smart device with a wireless connection. If the XW-210 has been previously configured for other uses, press the Access Point button. Scan for, and attach to the XW210-
XXXXXX wireless network. Access the setup pages with the following URL:
http://192.168.1.2/setup.html Click the Restore Defaults button on the Main setup page. Scan for and reattach to the XW210-XXXXXX network again. The XW-210 is workable for this application with the default settings, no further settings are needed. Note, only one device can be connected to the XW-210 at a time when it is in the Access Point mode. The XW-210 will continue to broadcast an SSID and you can connect to the XW-210 anytime with your smart phone and view the temperature on the Control page (http://192.168.1.2). Since the XW-210 is not connected to the internet, you must be within 250 feet or so with your smart phone to receive the WiFi signal from the XW-210. The XW-210 cannot send emails or remote relay commands because it is not connected to the internet. Be aware that the Access Point is unsecured and open and the default passwords cannot be changed. 3.3.2 Warehouse Temperature Example with an Access Point You wish to monitor the temperature of a warehouse with your smart phone or office computer. You have a WiFi access point in the warehouse. The HTTP web server is enabled to provide continuous access to the control page. Mount an XW-210 inside the warehouse. Power it with a DC wall adapter. First, the XW-210 must be configured to access your WiFi network. If no network profiles have been configured, the XW-210 will automatically enter the access point mode and you can access the XW-210 directly with a computer or smart device with a wireless connection. Access the setup pages with the following URL: http://192.168.1.2/setup.html For this application configure the XW-210 to connect to your wireless network. Navigate to the WiFi Networks tab and fill in the appropriate settings for your WiFi network. Obtain the IP address from your network administrator. Press the submit button at the bottom of the page. Once all the appropriate settings have been applied, click on the Reboot button. The XW-210 will connect to, and remain connected to your access point. The XW-210 will now be accessible from the IP address configured on the WiFi Networks tab. The XW-210 will no longer broadcast an SSID. You can access the control page any time to monitor the warehouse temperature by entering the IP address that was assigned to the device in the address bar of your web browser. Since your access point is connected to the internet, you can monitor the temperature from any computer in the building. If the XW-210 does not connect within a period of time, press the Access Point Button and repeat the above steps to verify the network settings. Xytronix Research & Design, Inc. Page 21 Web Server Section 4: Web Server XW-210 WiFi Users Manual The internal web server presents two classes of web pages; Setup pages and Control pages. Setup pages are used by an installer to provision and configure the XW-210. The Control page allows the relay to be controlled and displays temperature and digital input status information. To access the control page, enter the following URL in the address bar of a web browser:
http://192.168.1.2 To access the setup pages, enter the following URL in the address bar of a web browser:
http://192.168.1.2/setup.html Note that if you are accessing the unit as an access point the above IP address will work even if you have changed the IP address in the setup pages. If you are accessing the unit through the network after it has been configured you will use the IP address that was assigned to the device. If the XW-210 has been added to a network using WPS, it will use DHCP and you will need to use the IP address assigned to it. This can be found in the DHCP server, or by using mDNS. The mDNS name is:
http://xw-210.local/
When using the setup pages, you must click the Submit button at the bottom of a page if you have made changes to a setting on the page. 4.1 Main Tab This is the initial page that is displayed when setup.html is entered in the address bar of the browser. It displays model and serial number information, and has navigation tabs which allow access to the configuration and setup settings. Each of the configuration settings are described in the following sections. Page 22 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Temperature Units:
This global setting selects temperature units of either Fahrenheit and Celsius. All settings entered and displayed on subsequent pages will be in the units selected. Part Number:
This is the full model number of the XW-210. Firmware Revision:
This is the current revision of the internal software. Serial Number:
This is the serial number of the XW-210. The serial number is also the MAC address of the unit. Vin Voltage:
This field shows the input voltage on the +Vin and Gnd terminals from your power supply. Signal Strength:
This indicates the current receive Wi-Fi signal strength. The more negative the number the less signal is being received. -30dBm is a strong signal, and -90dBm is a very weak signal. Reboot:
After showing a confirmation message, this button will send a command to reboot the device. Restore Defaults:
After showing a confirmation message, this button will erase all user settings and return the module to its factory defaults. Xytronix Research & Design, Inc. Page 23 Web Server XW-210 WiFi Users Manual 4.2 WiFi Networks Tab As a Wi-Fi client device, the XW-210 attempts to automatically connect to configured Wi-Fi access points. The settings on this page are used to configure this process. WiFi SETTINGS SSID:
The SSID (Service Set Identifier) is the name of the Wi-Fi network you wish the XW-210 to connect to. Click the Refresh button to make a fresh scan of available networks. Note: The Refresh button is inactive if the XW-210 itself is an access point. The drop down list shows each Wi-Fi network discovered together with its signal strength. Security:
Page 24 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Type of authentication used by the access point for connections. Security Key:
Enter the security key or password for the WiFi network to connect to (hidden when not applicable.) IP SETTINGS Use DHCP:
This option allows DHCP to be enabled or disabled. If this option is set to Yes, the XW-210 will wait for an IP address from a DHCP server each time it is powered. The default setting is No (this is recommended for most installations). If DHCP is set to Yes, the Network page must be submitted and the XW-210 must be rebooted before an IP address will be assigned. Once the XW-210 is assigned an IP address by the DHCP, the new IP address can be found through the clients list kept by the DHCP server. For most instances, this is found on the local gateway or router. Alternatively, the device will broadcast its information via mDNS. Brief Notes About DHCP All devices on an IP network require an IP address. This is a unique address that identifies each device on the network. DHCP (Dynamic Host Control Protocol) is a mechanism that automatically assigns an IP address to a computer (or other devices) when it is connected to a network. This eliminates the need to manually enter the IP address. When a computer is connected to the network, another device on the network called a DHCP server detects the presence of the computer and dynamically assigns the IP address to that computer. On many small networks, the DHCP server is built into the router. DHCP works well for "client" devices such as computers, but is not ideal for servers. This is because servers usually don't initiate communications with other devices, but rather they wait for a request from
"clients." To make this request, the client must know the IP address of the server. If a server gets its IP address dynamically, the IP address may not always be the same so client devices may not be able to find the server. For this reason, servers usually use an IP address that is fixed and does not change. The XW-210 is a server and manual IP address assignment is usually recommended. IP Address:
Enter the IP address for the XW-210 in this field. The IP address is specific to the network where the XW-210 will be installed and is obtained from the network administrator. The default setting for this field is 192.168.1.2. Subnet Mask:
The subnet mask defines the size of the local network. This can be obtained from the network administrator. For additional information about sub-netting and IP networking, many tutorials are available on the Internet. The default setting for this field is 255.255.255.0. Gateway:
This specifies the IP address of the gateway router. This can be obtained from your network administrator. The default setting for this field is 192.168.1.1. DNS Server:
The IP address of the DNS server is specified here. When DNS services are required, this is the address that will be used. The default setting for this field is 192.168.1.1. An alternate DNS server is not supported. HTTP Port:
The TCP port used for HTTP communications with the XW-210 can be customized here. The default setting for this field is 80, which is the standard HTTP port. It is recommended that the port be left unchanged unless the user has an understanding of TCP/IP and ports. Xytronix Research & Design, Inc. Page 25 Web Server XW-210 WiFi Users Manual REMOTE SERVICES If Remote Services is enabled, the XW-210 will immediately attempt to make a connection with the remote server (power cycle not required). Once a connection is established, the connection will remain until it is disconnected by the remote server. If the connection is lost, it will automatically reconnect according to the Connection Interval. Hostname / IP Address:
The URL or IP address of the server you wish to send (push) data to. If the IP address is specified, enter it in this format aaa.bbb.ccc.ddd. For numbers that are less than 100, preceding zeros should not be included (for example, enter 80 rather than 080). This field can be up to 40 characters long and has no default setting. Remote Services Port:
The TCP port used for communications with the remote server. This can be set within the range of 1-
65535. The default setting for this field is 8000. Connection String:
This text is sent to the Remote Services server when the connection is established. This string should include any information required by the server at connection. For example, it may include an ID number, customer number, password, etc. The format is entirely dependent upon the server requirements. This field can be up to 80 characters long. Default text is provided only as an example placeholder. The default text is [<Serial Number>]:ControlByWeb,XW-210. Connection Interval:
This field specifies the periodic interval in which XW-210 attempts to connect to the remote server, or if XW-210 is already connected, it is the interval in which XW-210 sends the connection string. The default setting is 1 minute. Version This field specifies the version of the remote services' protocol to use. Version 1 of the protocol sends the connection string after successfully connecting to the remote server and then periodically per the connection interval specified. Version 2 of the protocol sends the connection string in addition to the MAC address, connection interval, model number and then immediately sends the state.xml file of the device. Version 2 of the protocol requires the remote server to reply to the connection string with a 3 byte packet Page 26 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual containing the text ACK. If the ACK is not received within 10 seconds of sending the connection string, the XW-210 will close the connection. Version 2 continues to send the connection string and the state.xml file periodically per the connection interval specified. Use SSL Certificate This option enables encryption of the remote services' connection with the remote services' server as well as authentication of the XW-210 to the server by a client certificate and key. Custom certificates and keys can be loaded into the XW-210 for this purpose. (See Remote Services at the end of this section for more information.) By default, the XW-210 does not come with any SSL certificates already installed. The certificates will need to be installed either manually by uploading the files or automatically with a token. The SSL certificates must be in the PEM format. Certificate Request Token When the XW-210 has a valid Certificate Request Token entered, it will automatically attempt to request and download its Client Certificate, Key, and CA. Once successful, the token will be erased and the XW-
210 will stop its requests. (See Remote Services at the end of this section for more information.) Certificate Request Port The certificate server is a server that has been configured to deliver the Client Certificate, Key, and CA when requested by the XW-210. For the XW-210 to request a Certificate, Key, and CA from the certificate server, it must have a previously issued Certificate Request Token. This field specifies what port the Certificate Server listens on. The server is found at the same host name as the remote services'
server. (See Remote Services at the end of this section for more information.) Manual Certificate Upload Client Certificate A client certificate is used with custom remote services' servers for device authentication. To upload a custom client certificate to the XW-210, click the Browse button, find the PEM formatted certificate file, and select Submit. Client Key A client key is used with custom remote services' servers for device authentication. The key that is uploaded must be the correct key associated with the Client Certificate. Care should be taken with where this client key is stored as it is meant only to be known to the XW-210. To upload a custom client key to the XW-210, click the Browse button, find the PEM formatted file, and select Submit. Client CA A CA (Certificate Authority) is used by the XW-210 to verify the authenticity of the remote services' server it is connecting to. It is important to note that this CA does not need to be the CA that signed the Client Certificate used by the XW-210. Rather the CA needs to be the one used to sign the certificate used by the remote services server. To upload a custom CA to the XW-210, click the Browse button, find the PEM formatted file, and select Submit. Remote Services Notes: Remote services initiates an outgoing connection to a server at a remote location. This can be used in an environment where a web server on the Internet provides a custom web page to XW-210 and other ControlByWeb products. Users access the XW-210 through the web server rather than communicating directly with it. This method is sometimes referred to as web services and allows programmers to create powerful, custom web pages to multiple devices using the web programming languages of their choice. Remote services initiates the connection to the external web server (rather than the web server initiating communications to the XW-210). This has two main benefits. First, the web server does not need to Xytronix Research & Design, Inc. Page 27 Web Server XW-210 WiFi Users Manual know the IP address of XW-210. This means that XW-210 can get its IP address dynamically from a DHCP server, simplifying the installation. Second, since the connection from XW-210 is outgoing, rather than incoming, the local router on the network where XW-210 resides doesn't need to be configured to forward sockets. This simplifies the installation. Since the router configuration is not modified, the risk of compromising security on the local network is eliminated. MODBUS/TCP XW-210 can support Modbus/TCP. Modbus is a messaging structure protocol used in industrial manufacturing control and automation. It is an open protocol and offers interoperability with software and devices from other manufacturers. (See Section 6.6: Modbus Operation.) Note: Modbus communications are disabled whenever the Control Password is enabled. Modbus Port:
This specifies the port used for Modbus/TCP communications with XW-210. By default this is set to port 502 which is the standard Modbus port. It can be set within the range of 1 to 65535. Endianness:
32-bit data is treated as two individual 16-bit words using IEEE 754 floating point format. Floating point format is used for sensor data and pulse counter as well as for setting output pulse duration. When the XW-210 is set for big-endian architecture, the most significant 16-bit word (big end) is sent first. Otherwise the XW-210 will use little-endian architecture, and the least significant word (little end) is sent first. The default setting for this is little-endian. For example, in little-endian format, a 32-bit floating point number represented by '1234 ABCD' is sent as
'ABCD1234 Page 28 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual EMAIL SETTINGS An email can be sent when a temperature alarm or digital event occur. A BASIC script can also initiate an email message. This section is used to configure the email settings for up to eight email addresses. The same message is sent to each email address. For email notification to work, the XW-210 must have a properly configured network connection and a SMTP server must be defined. Emails only work if the XW-210 is connected to an access point and can send messages on the internet. Email triggers can be generated within a BASIC script (See Section 6.7: BASIC Scripts), or can be explicitly defined for each Sensor, Input, and Relay. The email options and recipients for each Sensor, Input, and Relay are configured separately. For each Sensor, Input, and Relay select the Email Option and the check box for the desired email recipient. SMTP Server:
The SMTP mail server host name. SMTP Server Port:
The port number of the SMTP mail server. This is generally 25 for non encrypted SMTP servers. If using SSL/TLS, this port number is generally 465. SSL:
Check this check box if the server and port you have configured is expecting a SSL connection. User Name:
Email user name (if required). Password:
If the SMTP mail server requires authentication, the password must be entered here. There is no default setting for this field. Return Email:
XW-210 will not receive email messages, but when XW-210 sends email messages, it must include a return email address. This field is used to specify the return email address. Note that although XW-210 will send email messages with any email address specified in this field, some email filters (spam filters) will not allow messages through that include an invalid email address. There is no default setting for this field. Email 1:
When an alert occurs an email message is sent to this address. Email 2:
When an alert occurs an email message is sent to this address. Email 3:
When an alert occurs an email message is sent to this address. Email 4:
When an alert occurs an email message is sent to this address. Email 5:
When an alert occurs an email message is sent to this address. Email 6:
When an alert occurs an email message is sent to this address. Xytronix Research & Design, Inc. Page 29 Web Server XW-210 WiFi Users Manual Email 7:
When an alert occurs an email message is sent to this address. Email 8:
When an alert occurs an email message is sent to this address. Email Content:
When Full State is selected, all visible fields in the control page will be included in the email message to be sent out. Trigger Only only includes the status of the I/O that triggered the email alert to be sent. Short messages can be easier to read when sent to cell phones as text messages. Test Email:
Pressing this button will submit any changes to the email settings and trigger an alert email to be sent to the configured email addresses. The result of the test email will be displayed next to this button once the attempt has been completed. The Test Email button is disabled if the device is in the Access-point mode. The following are typical responses you may see along with a description of what they mean:
Error initiating communications: Did not receive the expected HELO from SMTP server. Ensure you are using the proper port and host/IP settings. Error with EHLO: Error sending or error receiving proper response to the SMTP EHLO command. Server may be unavailable or port and IP address settings are not correct. Error authenticating: Error sending or error receiving proper response to the SMTP AUTH PLAIN command. This may indicate the use of an incorrect username or password. Error with FROM field: Error sending or error receiving proper response to the SMTP MAIL FROM command. Ensure the Return Email address has been properly specified. Error with RCPT(To) field: Error sending or error receiving proper response to the SMTP RCPT TO command. Ensure the To email addresses are using valid characters and formatted properly. Error sending DATA command: Error sending or error receiving proper response to the SMTP DATA command. This error generally indicates a problem with the SMTP server. Error sending message body: Error sending or error receiving proper response to sending the content of the email. This error generally indicates a problem with the SMTP server. Error resolving DNS: Error resolving the hostname in the SMTP Server field on the setup pages. If this field is an IP address, ensure no numbers are greater than 255, there are four numbers separated by dots, and there are no alphabetic characters. If the SMTP Server field is a host name, ensure the DNS Server on the WiFi Networks tab or DNS server issued via DHCP is valid and has a proper DNS record for the SMTP Server host provided. Error establishing connection: Error configuring security on SSL socket or error creating socket. Error with SSL handshake: Could not successfully negotiate a cipher or protocol version to use for the SSL connection to the SMTP server. Ensure the configured port is indeed expecting an SSL connection. No SMTP server configured: No valid SMTP Server has been specified. Enter the host name or IP address of the SMTP Server you would like to use. No To address configured: No recipients of the email alerts has been configured. Enter at least one email address into any of the Email fields. Success: The test email was sent successfully. Note: When the XW-210 is in Access Point mode, your smart-phone or computer connects directly to it Page 30 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual and the XW-210 is not connected to the Internet. In this mode, no email messages can be sent and the Test Email button is disabled. Xytronix Research & Design, Inc. Page 31 Web Server XW-210 WiFi Users Manual 4.3 Password Tab The XW-210 has separate passwords for the Setup and Control pages. The passwords can be changed on this page. The username (admin) is fixed and cannot be changed. SETUP PAGE Setup Password:
The Setup Password, which is required to access the setup pages, can be modified by entering a new password here. Passwords that are 8 characters or longer (up to 13 characters can be entered in this field) with both alphabetic and numeric characters are recommended. For security purposes, the password will not be displayed as it is entered. Note: the username required for accessing the setup pages is admin (all lower case). The default Setup Password is webrelay (all lower case). Re-enter Setup Password:
When the Setup Password is changed, it must be entered twice. One time in the previous field and a second time in this field. If the password is not entered identically in both fields, the password will not be changed. CONTROL PAGE Enable Control Password:
The user (control) web page is normally viewed without entering a password. For security purposes, a password can be enabled. When this field is set to Yes, a password will be required to view the control page. The default setting for this field is No. Note: Since Modbus has no provision for passing passwords, the Control Page password will disable Modbus if it is enabled. Control Password:
The password for the control page can be modified by entering a new password here. Passwords that are 8 characters or longer (up to 13 characters can be entered in this field) with both alphabetic and numeric characters are recommended. For security purposes, the password will not be displayed as it is entered. Re-enter Control Password:
When the Control Password is changed, it must be entered twice for verification. If the password is not entered identically in both fields, the password will not be changed. Page 32 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 4.4 Date/Time Tab XW-210 uses the time of day for logging (a time stamp is included with each logged event.) The time is stored and displayed in 24-hour time format. The XW-210 does not have an event scheduler. The time in the XW-210 is not battery backed and will be lost if the device loses power. For this reason, it is recommended to use NTP as it will retrieve the time from the NTP server at power-up. Current Date/Time:
This is the current date and time stored in XW-210. The time is stored and displayed in 24-hour format. DATE/TIME SETTINGS Set Time:
This drop-down list offers two options for setting the time: Manually or Sync with NTP server. The options that follow this field will change based upon how this option is set. Manually: Requires the user to enter the time and date. Sync with NTP server: Allows the user to set the clock automatically by using an NTP (Network Time Protocol) server. MANUAL TIME CONFIGURATION Date:
The current date is entered by first selecting the correct month and year, using the left and right arrows at the top of the calender. The single arrows(< and >) change the month and the double arrows (<< and >>) change the year. Once the current month and year are displayed, select the correct day, which will then be highlighted. Time (24-Hour Format):
Enter the time as HH:MM:SS. (HH represents hours in 24-hour format [00-23], MM represents minutes
[00-59], SS represents seconds [00-59].) Xytronix Research & Design, Inc. Page 33 Web Server XW-210 WiFi Users Manual SYNC WITH NPT SERVER Server Name/IP Address This field is used to specify the name or IP address of the NTP server. If a name is specified, a working DNS server address must be entered into the Network settings. If the IP address is specified, it should be entered in the following format aaa.bbb.ccc.ddd where each of the letters represents a number between 0 and 255. This field can be up to 40 characters. There is no default value for this field. Many NTP Internet servers are available. In addition, many desktop computers will function as an NTP server (both Mac and PC). If a desktop computer is used, firewall settings may need to be adjusted to allow for NTP communications on UDP port 123. Public NTP servers can be found at www.pool.ntp.org. Some of these are listed below. US Servers (http://www.pool.ntp.org/zone/us):
0.us.pool.ntp.org 1.us.pool.ntp.org 2.us.pool.ntp.org 3.us.pool.ntp.org North America (http://www.pool.ntp.org/zone/north-america):
0.north-america.pool.ntp.org 1.north-america.pool.ntp.org 2.north-america.pool.ntp.org 3.north-america.pool.ntp.org Europe (http://www.pool.ntp.org/zone/europe):
0.europe.pool.ntp.org 1.europe.pool.ntp.org 2.europe.pool.ntp.org 3.europe.pool.ntp.org Australia (http://www.pool.ntp.org/zone/au):
0.au.pool.ntp.org 1.au.pool.ntp.org 2.au.pool.ntp.org 3.au.pool.ntp.org South America (http://www.pool.ntp.org/zone/south-america):
Page 34 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 0.south-america.pool.ntp.org 1.south-america.pool.ntp.org 2.south-america.pool.ntp.org 3.south-america.pool.ntp.org Africa (http://www.pool.ntp.org/zone/africa):
1.africa.pool.ntp.org 1.pool.ntp.org 3.pool.ntp.org Sync With Server This option allows the user to specify how often the time on XW-210 will be synchronized with the time server. When the submit button on this page is pressed, XW-210 will immediately synchronize with the time server. If Daily, Weekly, or Monthly options are selected, XW-210 will thereafter re-synchronize with the time server at the period interval specified starting at the time of day the settings were submitted. The default value of this setting is Once (the unit will immediately sync with the NTP server, but will not automatically sync again until power cycled). UTC Offset Time servers return the current time in Universal Time (GMT). It is common for many servers and data loggers to use GMT as their official time, even when they are not located within the GMT time zone. The default value for this field is -7 (Mountain Standard Time). For convenience, the time can be converted to local standard time by entering the offset here. This manual cannot include the UTC Offset for all parts of the world, but the offset for GMT time and the four major US Time zones are listed here. GMT Time: 00:00 Eastern Standard Time: -5:00 Central Standard Time: -6:00 Mountain Standard Time: -7:00 Pacific Standard Time: -8:00 Xytronix Research & Design, Inc. Page 35 Web Server XW-210 WiFi Users Manual DAYLIGHT SAVINGS Daylight Savings Enabled:
In many parts of the United States and in some other countries, the time is shifted forward by one hour during the summer months. This is an effort to conserve energy by making the daylight last longer into the evening hours. If this option is set to Yes, the time on XW-210 will automatically be shifted forward by one hour between the hours of 12:00 AM 5:00 AM on the Daylight Savings Start date set below, and it will shift back to standard time between the hours of 12:00 AM 5:00 AM on the Daylight Savings End date set below. The time change is made at a random time within the previously mentioned, five-hour time frame, in order to prevent several different devices from simultaneously requesting a time and overwhelming the NTP server. The default setting is Yes. Note: Logged data includes a time stamp based upon the current time in the device, so it is possible to duplicate log times in the spring and miss log times in the fall. To avoid confusion, many servers and data loggers are set to remain on GMT time and do not shift for daylight savings. Daylight Savings Start:
This is the date that daylight savings will start. Note that on this date, between the hours of 12:00 AM 5:00 AM, the current time will be shifted forward by one hour (i.e. the time will jump from 12:02 AM
[00:02] to 1:02 AM [01:02]). By default this is set to the 2nd Sunday in March which is the date used in the United States. Daylight Savings End:
This is the date that daylight savings will end. On this date, between the hours of 12:00 AM 5:00 AM, the current time will be shifted backward by one hour (i.e. time will jump from 12:02 AM [00:02] to 11:02 PM [23:02] the day before). By default this is set to the 1st Sunday in November which is the date used in the U.S. Page 36 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 4.5 Logging Tab XW-210 can be configured to record data such as sensor data and changes in I/O state. Both periodic and event-based logging are supported. The logged data is stored in internal nonvolatile memory and can be retrieved by entering the command http://{XW-210 IP address}/log.txt. For more information on logging, see Section 6.5: Log File. The log is stored in non-volatile flash memory using a circular buffer (old data is over written). 512-
Kbytes of memory space is reserved for logging. Log entries are composed of the following components, 5-byte header, 4-byte time stamp and 4 bytes for each sensor selected, 1-byte for input, 4-bytes for the counter, 1-byte for relay and 4-bytes for Vin. A log of Vin 1 (4 bytes) and the digital input (1 byte) will occupy 14 bytes per entry. Note: Changing the log settings will erase the current log file. Logging Enabled:
When this option is set to Yes, XW-210 will record data as configured on this page. The default setting for this option is No. LOGGING SETUP Start Time:
If a logging interval is specified (periodic logging rather than event logging), logging will occur relative to this start time. For example, if the start time is 01:00 and the logging rate is 6 hours, logging will occur at 01:00, 07:00, 13:00, and 19:00. Start time is specified in 24-hour time format. The default setting for this field is 01:00. Xytronix Research & Design, Inc. Page 37 Web Server XW-210 WiFi Users Manual Logging Rate:
This field is used to specify the time period of logging. A numerical value is entered into the text field, and the unit of time is selected using the adjacent radio buttons. The range of values in this field is 1-20864. Time units are Minutes, Hours, and Days. Periodic logging can be disabled by selecting the Event Logging Only radio button. Sensor Trigger Delta:
XW-210 can be configured to log data when the count, voltage, temperature, or humidity measured by a sensor changes by the amount specified in this field. This can be set from 1.0 to 9999 units, in 0.1 increments. The default setting for these fields is shown below. Sensor Trigger Delta Vin Temperature Humidity Counter 2.0 V 2.0 2.0%
2 counts Logging Configuration:
Check the items you wish to log. Check the event trigger box if the corresponding I/O should be allowed to cause the I/O state to be logged. For example, if the check box for the relay in the Event Trigger column is checked, a log entry will be entered each time the relay changes state even if the log is configured to only log periodically. Log entries recorded due to an event will not interfere with periodic logging. LOGGING EMAIL SETUP Daily Email Log Send Time:
The XW-210 can periodically Email the log file at a specific time. For example; use this feature to Email the temperature log of a restaurant food cooler once per day to provide the documentation required for health regulations. Use Email Address:
These check boxes determine what Email addresses the periodic data log is sent to. Up to eight email addresses can be assigned. The same data log is sent to each Email address. For Email notification to work, the XW-210 must have a properly configured network connection and a SMTP server must be defined. When an Email address is entered via the WiFi Networks tab, the check boxes will show the respective Email addresses. Page 38 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 4.6 Input Tab These settings determine how the XW-210 processes the digital input. The digital input has a counter which counts the number of input pulses. The input has a set debounce of 20ms before counters or events are processed. This page provides configuration options for the input and its counter. Input Description:
This text is used to describe the function of the digital input. The text appears to the left of corresponding input status on the Control Page, and in email messages when email alerts are enabled. This field may be up to 24 characters long. Enter a descriptive name such as Stockroom Door. On Status Text:
The text in this field specifies the text that will be displayed in the Control Page and in email messages when the input is ON (switch is closed). Up to 15 characters may be entered in this field. Enter a descriptive status such as Door is Open. On Status Color:
This field specifies the color that will be displayed on the Control Page when the input is considered On. Options are Green, Red, Yellow, Blue and Grey. Off Status Text:
The text in this field specifies the text that will be displayed in the Control Page and in email messages when the input is Off (switch is open). Enter a descriptive status such as Door is Closed. Xytronix Research & Design, Inc. Page 39 Web Server XW-210 WiFi Users Manual Off Status Color:
This field specifies the color that will be displayed on the Control Page when the input is considered Off. Options are Green, Red, Yellow, Blue and Grey. Counter Options This settings determines what triggers the counter to increment. The default setting for this field is:
Counter off. Counter off: No input transitions will be counted. Increment when input on: The counter will increment each time the input turns on. Increment when input off: The counter will increment each time the input turns off. Increment when input changes: The counter will increment each time the input changes on or off. Description This text field is used to describe the counter. The text appears to the left of the corresponding counter on the Control Page, and in email messages when email alerts are enabled. This field may be up to 9 characters long. The default text is Count 1. Units This text field is used to describe the units counted. The text appears to the right of the counter reading. This field may be up to 4 charters long. Slope (Multiplier) The counter value can be scaled into engineering units. The XW-210 reads the raw value from the counter and calculates a new value in engineering units. This scaled value is calculated using a linear Y=mX+b formula. Scaled Value = Slope * Count + Offset The calculated scaled value is used for trigger logs, email messages, control page, XML page, and returned when Modbus values are read. The slope in the formula above is provided by the user and is entered in this field. When both the slope and offset are set to their default values (m=1 and y=0) the scaled value equals the actual count. Offset The offset in the formula above is provided by the user and is entered in this field. The default value for this field is 0. Email Alert:
Simple email messages can be sent in response to changes in the digital input. This setting is used to specify what conditions, if any, will cause email messages to be sent. No email Messages: No email messages will be sent due to input conditions. Send email when Input On: Email notifications will be sent when the input is on. Send email when Input Off: Email notifications will be sent when the input is off. Send email when Input Changes State: Email notifications will be sent when the input turns on or off. Use Email Address:
These check boxes determine what Email addresses the input alert message is sent to. Up to eight Email addresses can be assigned. The same message is sent to each Email address. For email notification to work, the XW-210 must have a properly configured network connection and a SMTP Page 40 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual server must be defined. When an Email address is entered via the WiFi Networks tab, the check boxes will show the respective Email addresses. Remote Service:
When this box Send State Message on Input Change is checked, State messages will be sent whenever the input state changes. Remote Services must be enabled and properly configured for this feature to be effective. Xytronix Research & Design, Inc. Page 41 Web Server 4.7 Relay Tab XW-210 WiFi Users Manual Description This text field is used to describe the function of the relay. The text appears to the left of the corresponding relay status on the Control Page and in the email message when email alerts are enabled. Up to 24 characters may be entered in this field. The default text is Relay 1. On Button Label The text entered in this field appears in the 'On' button for the corresponding output on the Control Page. Up to 15 characters may be entered in this field. The default text is On. Off Button Label The text entered in this field appears in the 'Off' button for the corresponding output on the Control Page. Up to 15 characters may be entered in this field. The default text is Off. Pulse Button Label The text entered in this field appears in the 'Pulse' button for the corresponding output on the Control Page 42 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Page. Up to 15 characters may be entered in this field. The default text is PULSE. On Status Text The text in this field specifies the text that will be displayed in the Control Page and in email messages when the relay is On. Up to 15 characters may be entered in this field. The default text is On. On Status Color This field specifies the color that will be displayed on the Control Page when the relay is considered On. Options are Green, Red, Yellow, Blue and Grey. The default color is Green. Off Status Text The text in this field specifies the text that will be displayed in the Control Page and in email messages when the relay is Off. Up to 15 characters may be entered in this field. The default text is Off. Off Status Color This field specifies the color that will be displayed on the Control Page when the relay is considered Off. Options are Green, Red, Yellow, Blue and Grey. The default color is Red. Pulse Duration When XW-210 receives a pulse command for the relay (through the web page or through a command), the relay will pulse for the time specified in this field. Note that when a pulse command is sent through the command interface (XML or ModBus), the command can include a pulse time which will over-ride this value (for that pulse only). The time is specified in seconds and can range from 0.1 seconds to 86400 seconds in 0.1 second increments. The default time is 1.5 seconds. Relay State at Power up This drop down menu lets the user specify the state of the relay when the XW-210 is powered up. The following options can be selected:
Off: The relay will be off upon power up (this is the default setting.) On: The relay will be on upon power up. Evaluate Logic: Upon power up, the control source and action are evaluated to determine the proper state of the relay. Control Source These drop down menus specify what input or sensor controls the state of the relay. The following options can be selected:
None: The state of the relay will be controlled only by the web page. Digital Input: The state of the relay will be controlled by the digital input and/or the web page. 1-Wire Sensor: The state of the relay will be controlled by a 1-Wire Sensor and/or the web page. Depending on the Control Source selected, the menu will change. If Digital Input is selected the following Action options are available:
Set relay equal input: When the input is on, the relay is on. When the input is off, the relay is off. Set relay opposite of input: When the input is on, the relay is off. When the input is off, Xytronix Research & Design, Inc. Page 43 Web Server the relay is on. XW-210 WiFi Users Manual Latch relay on when input [on, off, changes] (reset via web): The relay latches on when the input is [on, off, changes]
Latch relay off when input [on, off, changes] (reset via web): The relay latches off when the input is [on, off, changes]
Toggle relay when input [on, off, changes]: The relay changes state when the input is [on, off, changes]
Pulse relay when input [on, off, changes]: The relay is pulsed when the input is [on, off, changes]
If 1-Wire Sensor is selected, choose the sensor number. For each sensor the following Action options are available:
Set Relay On: The relay turns on when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Set Relay Off: The relay turns off when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Latch Relay On: The relay latches on when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Latch Relay Off: The relay latches off when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Toggle Relay: The relay changes state when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Pulse Relay: The relay is pulsed when [Alarm 1, Alarm 2, Alarm 1 or Alarm 2] is true Email Alert:
Simple email messages can be sent in response to relay state changes. This parameter is used to specify what relay state changes, if any, will cause email messages to be sent. Note that email notification will work only if the email settings are correctly set up in the Network setup page. The following options are available:
No Email Messages: No email notifications will be sent due to relay state changes. Send Email when relay on: Email notifications will be sent when relay state changes to on. Send Email when relay off: Email notifications will be sent when relay state changes to off. Send Email when relay changes state: Email notifications will be sent when relay changes state from off to on or on to off. Use Email Address:
These check boxes determine what Email addresses the relay alert message is sent to. Up to eight Email addresses can be assigned. The same message is sent to each Email address. For email notification to work, the XW-210 must have a properly configured network connection and a SMTP server must be defined. When an Email address is entered via the WiFi Networks tab, the check boxes will show the respective Email addresses. Remote Service:
When this box Send State Message on Relay Change is checked, State messages will be sent Page 44 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual whenever the selected source changes. Remote Services must be enabled and properly configured for this feature to be effective. The digital input can be configured to control the relay contacts of another ControlByWeb device (such as WebRelay) at a remote location. The Remote Service Options setting is used to specify if and how the input affects the remote relay. The options in the drop-down list are described below. Note that in all cases, input changes will only affect the remote relay at the time the input is changed. Once the change has taken place, the state of the input has no effect on the state of the remote relay. In other words, if the input causes the remote relay to go on, a user may turn that remote relay off from the web browser, even if the local input is still on. REMOTE RELAY The XW-210 can be configured to control a relay on other ControlByWeb devices across the network. These relays are called remote relays. Control Source:
Select the resource to control the remote relay. The following options are available:
None: No commands are sent to a remote relay Digital Input: The state of the remote relay will be controlled by the digital input. Relay: The state of the remote relay will be controlled by the local relay. 1-Wire Sensor: The state of the remote relay will be controlled by 1-Wire Sensor alarms. Action:
These drop down menus specify what action to take when a criteria is met. The actions change depending on what control source has been selected. The following section lists the options available based for each control source selected. If Digital Input is selected the following Action options are available:
Remote command equals input: When the input is on, a command is sent to the remote device to set the relay state to on. When the input is off, a command is sent to the remote device to set the relay state to off. Remote command opposite of input: When the input is on, a command is sent to the remote device to set the relay state to off. When the input is off, a command is sent to the remote device to set the relay state to on. Send on command when input [on, off, changes] (no off command): When the input is [on, off, changes] a command is sent to the remote device to set the relay state to on. No off commands are sent to the remote device. Send off command when input [on, off, changes] (no on command): When the input is [on, off, changes] a command is sent to the remote device to set the relay state to off. No on commands are sent to the remote device. Send toggle command when input [on, off, changes]: When the input is [on, off, changes] a command is sent to the remote device to toggle the relay (change the remote relay to the state opposite of its current state). Send pulse command when input [on, off, changes]: When the input is [on, off, changes] a Xytronix Research & Design, Inc. Page 45 Web Server XW-210 WiFi Users Manual command is sent to the remote device to pulse the relay. If Relay is selected the following Action options are available:
Remote command equals relay: When the local relay is on, a command is sent to the remote device to set the relay state to on. When the local relay is off, a command is sent to the remote device to set the relay state to off. Remote command opposite of relay: When the local relay is on, a command is sent to the remote device to set the relay state to off. When the local relay is off, a command is sent to the remote device to set the relay state to on. Send on command when relay [on, off, changes] (no off command): When the local relay is [on, off, changes], a command is sent to the remote device to set the relay state to on. No off commands are sent to the remote device.. Send off command when relay [on, off, changes] (no on command): When the local relay is [on, off, changes] a command is sent to the remote device to set the relay state to off. No on commands are sent to the remote device. Send toggle command when relay [on, off, changes]: When the local relay is [on, off, changes] a command is sent to the remote device to toggle the relay (change the remote relay to the state opposite of its current state). Send pulse command when relay [on, off, changes]: When the local relay is [on, off, changes] a command is sent to the remote device to pulse the relay. If 1-Wire Sensor is selected, choose the sensor number. For each sensor the following action options are available:
Send On Command When [Alarm1, Alarm2, Alarm1 or Alarm2]: A command is sent to the remote device to set the relay state to on when [Alarm1, Alarm2, Alarm1 or Alarm2] becomes true. A command is sent to the remote device to set the relay state to off when [Alarm1, Alarm2, Alarm1 or Alarm2] becomes false. Send Off Command When [Alarm1, Alarm2, Alarm1 or Alarm2]: A command is sent to the remote device to set the relay state to off when [Alarm1, Alarm2, Alarm1 or Alarm2] becomes true. A command is sent to the remote device to set the relay state to on when [Alarm1, Alarm2, Alarm1 or Alarm2] becomes false. Send On Command When [Alarm1, Alarm2, Alarm 1 or Alarm2] (no off command): A command is sent to the remote device to set the relay state to on when [Alarm1, Alarm2, Alarm1 or Alarm2]
becomes true. No off command is sent. Send Off Command When [Alarm1, Alarm2, Alarm 1 or Alarm2] (no on command): A command is sent to the remote device to set the relay state to off when [Alarm1, Alarm2, Alarm1 or Alarm2]
becomes true. No on command is sent. Send toggle command when [Alarm 1, Alarm2, Alarm 1 or Alarm2]: A command is sent to the remote device to toggle the relay (change the remote relay to the state opposite of its current state when [Alarm1, Alarm 2, Alarm 1 or Alarm 2] becomes true. Send Pulse Command When [Alarm1, Alarm2, Alarm1 or Alarm2]: A command is sent to the remote device to pulse the relay when [Alarm1, Alarm 2, Alarm 1 or Alarm 2] becomes true. Page 46 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 4.8 Sensor Tab Up to four temperature or other Xytronix 1-wire sensors can be connected to XW-210. Each of the1-wire sensors have specific settings. The settings for the first 2 sensors are shown below. Sensor Description:
This text will appear in email messages when email alerts are enabled as well as to the left of the corresponding temperature/humidity value on the Control Page. This field may be up to 35 characters long. Sensor Address:
Each sensor connected to XW-210 must be associated (assigned) to a sensor number. Every sensor comes from the factory with a unique, non-changeable address. When the sensors tab is selected, the XW-210 scans the bus for sensors. The addresses of the sensors that are found on the bus are listed in the drop-down list. For each sensor number (Sensor 1... Sensor 4), select the address of the appropriate Xytronix Research & Design, Inc. Page 47 Web Server XW-210 WiFi Users Manual sensor from the drop-down list. Selecting sensors is simplest when the sensors are connected to the bus one at a time. The procedure is to start with one sensor and associate it with the appropriate sensor number by selecting the sensor address within the appropriate drop-down list. Submit the page, connect a second sensor, and press the Sensors tab. Associate the second sensor to the appropriate sensor number. Continue this procedure until all sensors are set up. Offset:
The value of the offset will be added to the sensor's reading. Normally this should be set to zero. Alarm 1:
This setting is used to set the trigger point for an alarm condition. The numeric field specifies the temperature/humidity at which the alarm is triggered. The High and Low radio buttons indicate whether the alarm is triggered as a high or low alarm. A high alarm is triggered when the sensor reading exceeds the alarm value, and a low alarm is occurs when the sensor reading falls below the alarm value. Generally this value will be static, but a Register can be used as a trigger point for an alarm condition as well. To use a Register select the desired Register using the drop down box. The value of a Register can be changed through a basic script, and directly through the control page. Alarm 2:
This is a second alarm trigger that works similarly to Alarm 1 Deadband:
The deadband (hysteresis) prevents alarms from triggering excessively when the measurement value vacillates around the trigger point. With high alarms, the measurement must fall below the high alarm point minus the dead band before the high alarm will be triggered again. Likewise the deadband on the low alarm requires the measurement to rise above the low alarm point plus the deadband before the low alarm will be triggered again. For example, if the dead band is set to 0.5C, and a high alarm is set at 13C, the high alarm will occur at 13C; however, it will not turn off until the temperature drops below 12.5C (13C - 0.5C). Page 48 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Email/Action Delay:
Number of seconds to delay before considering the sensor to be in an alarm state. For example, if the temperature sensor is monitoring a freezer and is mounted near the door, the sensor may go in to an alarm state each time the door is opened and cause false alarms. The delay will cause the temperature to be in an alarm state for the specified number of seconds before processing any triggers based on that sensors alarm state. Email Option:
Simple email messages can be sent in response to alarm conditions. This parameter is used to specify what alarm conditions, if any, will cause email messages to be sent. Email notifications will work only if email is correctly setup in the WiFi Networks tab. No email Messages: No email messages will be sent due to alarm conditions. Send email on Alarm 1: Email notifications will be sent due to an Alarm 1 condition. Send email on Alarm 2: Email notifications will be sent due to an Alarm 2 condition. Send email on Alarm 1 and Alarm 2: Email notifications will be sent due to an Alarm 1 or Alarm 2 condition. Send email on Alarm 1, Alarm 2 and normal: Email notifications will be sent when Alarm 1 or Alarm 2 occur, or when normal conditions are restored. Use Email Address:
These check boxes determine what Email addresses the temperature alarm message is sent to. Up to eight Email addresses can be assigned. The same message is sent to each Email address. For email notification to work, the XW-210 must have a properly configured network connection and a SMTP server must be defined. When an Email address is entered via the WiFi Networks tab, the check boxes will show the respective Email addresses. Remote Services:
The XW-210 can be configured to send messages to other ControlByWeb products that are located at a remote location on the network. This field specifies the action taken due to a temperature alarm condition. The following actions are available:
No Action: No action is taken. Send state on Alarm 1: state.xml will be sent when Alarm 1 becomes true. Send state on Alarm 2: state.xml will be sent when Alarm 2 becomes true. Send state on Alarm 1 and Alarm 2: state.xml will be sent when Alarm 1 or Alarm 2 becomes true. Xytronix Research & Design, Inc. Page 49 Web Server 4.9 Script Tab XW-210 WiFi Users Manual The XW-210 can run custom programs written in a simplified version of BASIC. This page is used to load and execute these programs. Before it can be loaded to the XW-210, a script must first be prepared as a
.txt file. The file must then be uploaded to XW-210 via the Script tab. The maximum size of script that can be uploaded to the device is 4-Kbytes. Information on writing a basic program for XW-210 can be found in Section 6.7: Basic Scripts. An ASCII standard text file format should be used, such as Windows Notepad, Programmer's Notepad, vi, or other text editor that output the file as a .txt. Rich Text Format (.rtf) used by Microsoft WordPad is NOT compatible. Current Script This field displays the .txt file that is uploaded to XW-210. Text displayed in this screen cannot be edited. In order to edit any script, it must be rewritten in the .txt file and uploaded again. Interpreter Status This field displays whether the program is running, has stopped or finished, or if there are errors contained in the script. If there are errors in the script, the line on which the error occurred is displayed. Upload BASIC Script This field displays the script selected to be uploaded to the device. To upload a script to XW-210, click the Browse button, find the .txt file previously created, and select Open. The location of the file should appear in the neighboring field. To upload the script to the unit, select Submit. Run Script This option selects whether or not the selected script will be run after it has been uploaded. The Submit button must be clicked to run the script. Page 50 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 4.9.1 Example Script The following is an example script which monitors a door switch. An alarm sounds after a door has been open for 10 seconds and turns off if the door is closed. It includes a trigger to exit the timer if the input turns off before 10 seconds has elapsed. This helps insure that the alarm will only turn on if the door has been open for 10 seconds.
'This example will turn on a relay after an input has been on for 10 seconds LET relay1 = 0 DO IF input1 = 1 THEN CALL delay IF input1 = 1 THEN END IF LET relay1 = 0 LET relay1 = 1 ELSE END IF LOOP END SUB delay LOOP END SUB LET t1 = 100 DO WHILE t1 > 0 IF input1 = 0 THEN END IF LET t1 = 0
'Make sure the relay is off when the script starts
'Begin main program loop
'Checks if input 1 is on - Door is open
'Calls the delay function
'After the delay is done, it will check the door again
'Turns the relay on, sounding the alarm
'If input1 is off - door is closed
'Turn relay1/alarm off after closed door
'End of IF input1 = 1
'Loop main program
'End main program loop
'SUB function
'Set timer = 10.0 seconds
'Loop while timer is counting down to 0.0 seconds
'If the input turns off (door closed), exit loop
'Sets timer to 0 to exit loop
'End of IF input1 = 0
'Loop the DO WHILE statement above
'End of the SUB routine Xytronix Research & Design, Inc. Page 51 Web Server XW-210 WiFi Users Manual 4.10 Control Page and Register Setup Tab The Control Page Setup page is used to set parameters that affect the view of the Control Page, including what measurement values and buttons are to be shown. Module Description The text entered here appears at the top of the Control Page. It also appears in the header of the email text when the email notification is used. This field can be up to 40 characters in length. The default text is XW-210. Page 52 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Refresh rate:
How often the Control Page status is updated. The default value is 3 seconds. Display Configuration These check boxes select which input/output resource is displayed on the control page. Each check box determines whether or not the status of the resource is displayed. Relay: Determines if the relay status and/or what buttons are visible on the control page. Input: Determines if the input status is visible on the control page. Display Counter: Determines the visibility of the counter value on the control page. Sensors (1-4): Determines the visibility of the 1-wire sensor readings on the control page. Registers (1-4): Determines the visibility of the registers on the control page. Registers:
Registers can be changed externally thru the Control Page, XML requests or the BASIC script. This allows a BASIC script to react to user input. These variables are considered to be floating point numbers, just like other variables in the BASIC script. This section has settings for each of the registers. Description Text entered here will be displayed in the left column of the control page. Up to 14 characters may be entered here. The default text is Register 1. Button 1 Label This text field is used to describe the function of button 1 of the selected Register. When the user clicks button 1, the Register is set to 1. The text also appears to the right of the corresponding Register status. Up to 9 characters may be entered here. By default, this text is ON. Button 2 Label This text field is used to describe the function of button 2 of the selected Register. When the user clicks button 2, the Register is set to 0. The text also appears to the right of the corresponding Register status. Up to 9 characters may be entered here. By default, this text is OFF. Status 1 Text The text in this field specifies the text that will be displayed when the Register is value 1. The text also appears in the status column on the Control Page. If the Register is any other value than 1 or 0, the value itself will be displayed in the same column. Up to 9 characters may be entered here. By default the text is ON Status 2 Text The text in this field specifies the text that will be displayed when the Register is value 0. The text also appears in the status column on the Control Page. If the Register is any other value than 1 or 0, the value itself will be displayed in the same column. Up to 9 characters may be entered here. By default the text is OFF. Xytronix Research & Design, Inc. Page 53 Control Page Section 5: Control Page XW-210 WiFi Users Manual The relay, digital input and temperature sensors can be monitored and controlled using a web browser, by sending text commands to an XML status/control page, and/or by sending Modbus/TCP requests. 5.1 Browser Operation Once the XW-210 is set up, users can access the Control Page using a web browser. There are two ways to do this. The first is by typing the IP address of the XW-210 directly into the web browser address bar. For example, using the default IP address, the user would enter http://192.168.1.2. If the IP address is changed from the default, the user must use the new IP address. Note that if any port is used other than the default port 80, the port must also be included in the request. For example, accessing the unit at port 8000 would be as follows: http://192.168.1.2:8000. The following screen appears when the Control Page is requested from the address bar. This example has all of the optional resources enabled. The I/O on the control page updates every three seconds. The Control Page is normally what users see and use and it can be highly configured to fit your needs. The Control Page Setup tab has check boxes that determine if a specific resource is displayed or not. The description (text) shown for certain rows is also specified in the Control Page Setup tab. Page 54 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Header Displays the text entered in the Module Description Text field on the Control Page Setup tab in the setup pages. This is usually a description of the application such as 2nd Floor Freezer. Input This row displays the current state of the digital input. The text in the left column (by default reads Input 1) is specified in the description field of the Input tab in the setup pages. Counter A cumulative count of OFF to ON states of the digital input. A reset button can be enabled which resets the counter. Relay This row displays the current state of the internal relay and has buttons to allow the user to change the relay state. The text in the left column (by default reads Relay 1) is specified in the description field of the Relay tab in the setup pages. The state of the relay is shown to the right of the relay description text. By default, the status text will read ON or OFF; however, the status text can be changed in the Relay tab. To the right of the relay status, three buttons provide on/off and pulse control of the relay. The buttons can be removed when not needed (in the Control Page Setup tab) and the text within the buttons can be customized (in the Relay tab). Sensor 1-4 These fields display the current temperature or other values measured by the associated sensors. Each sensor has a description field specified in the Description field in the Sensors tab in the setup pages. Registers These rows display the current state of the four registers used in the BASIC script. The state of the register is shown to the right of the description text. By default the status text will read ON or OFF when the register is a value of 1 or 0 respectively. To the right of the register status, two buttons are provided to control the state of the register. These buttons can be enabled or disabled in the Control Page Setup tab. Xytronix Research & Design, Inc. Page 55 Control Page XW-210 WiFi Users Manual 5.2 Control Page Tab The second method of accessing the control page is through the setup pages
(http://192.168.1.2/setup.html). Clicking the Control Page Tab will open a new browser window and display the control page shown below. To access the setup tabs again, click on the XW-210 Setup tab in your browser to return to the previous browser window. Page 56 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Section 6: Auxiliary Operations 6.1 XML Custom XML computer applications may be created to monitor and control the XW-210. This method does not use a web browser. There is a single XML page that can be used to monitor and control the XW-210, state.xml. The XW-210 does not support diagnostics.xml. 6.1.1 state.xml XML Monitor All Functions The state of the Relays, Inputs, Sensors, Registers, and Vin can be monitored by sending a request to port 80 (or port specified in setup). This can be demonstrated by entering the following URL into the address bar of a web browser (substituting the IP address as necessary):
http://192.168.1.2/state.xml The following state.xml page is returned:
<datavalues>
<input1state>0</input1state>
<relay1state>0</relay1state>
<units>F</units>
<sensor1>x.x</sensor1>
<sensor2>x.x</sensor2>
<sensor3>x.x</sensor3>
<sensor4>x.x</sensor4>
<s1Alrm>0</s1Alrm>
<s2Alrm>0</s2Alrm>
<s3Alrm>0</s3Alrm>
<s4Alrm>0</s4Alrm>
<count1>23</count1>
<register1>0.00</register1>
<register2>0.00</register2>
<register3>0.00</register3>
<register4>0.00</register4>
<vin>9.577</vin>
<time>1343647469</time>
</datavalues>
The numbers enclosed by the tags, <tag>, indicate the current state or value monitored by XW-210. Values for each tag are described in the table below. XML computer applications will open a TCP/IP socket with the XW-210 and send a GET command followed by the state.xml command string. (See Section 6.2: HTTP Get Requests for instructions on using GET.) XML Tags*
<input1state>
<relay1state>
<units>
Monitor Values 0=off (voltage not applied to input one) 1=on (voltage applied to input one) 0=off (coil one off) 1=on (coil one energized) F=Fahrenheit C=Celsius Xytronix Research & Design, Inc. Page 57 Auxiliary Operations XML Tags*
<sensorX>
<sXAlarm>
<count1>
<registerX>
<vin>
XW-210 WiFi Users Manual Monitor Values x.x = Indicates that no sensor reading is available 77.3 = Current sensor reading Current state of the sensor alarms 0 = Normal 1 = Alarm 1 2 = Alarm 2 The scaled count value (rawCount * multiplier + offset). Value of each Register. Scaled internal Vin measurement Time displayed in epoch time (number of seconds since January 1, 1970)
<time>
* 'X' is replaced by the sensor or register number. 6.1.2 XML Control Commands can be sent to the XW-210 to control the relays, counters, and registers. Relay State Control Commands are sent using a variable called relay1State. A few examples of using relay1State are given here. Command state.xml?relay1State=0 Description Turn Relay 1 OFF Turn Relay 1 ON state.xml?relay1State=1 Pulse Relay When the pulse command is sent, the output will turn ON for the Pulse Duration specified in the Relay setup page. It is also possible to send a pulse time command that is different than the configured Pulse Duration. This is done by sending a pulseTime1 variable. The pulseTime1 variable does not change the Pulse Duration in the setup page and it is not stored or recorded. The pulseTime1 variable only changes the duration for the single pulse initiated by that command. In other words, you must issue the pulseTime1 command for each pulse command that differs from the preset value. For example, if the XW-210 is configured for a Pulse Duration of 1.5 seconds. To issue one 1.5 second pulse and one 5 second pulse you would issue the following commands. Command state.xml?relay1State=2 state.xml?relay1State=2&pulseTime1=5 Description Pulse Relay 1 for the preset time (1.5 seconds). Pulse Relay 1 for 5 seconds. XML Set Counter The counter value can be set using the count1 command. Command state.xml?count1=200 Description Set counter1 to 200. Page 58 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.1.3 Message Acknowledgment By default, when commands are sent to XW-210, the state.xml page is returned. The xml reply can be disabled by adding the noReply field as follows:
Command state.xml?relay1State=1&noReply=1 state.xml?relay1State=0&noReply=1 Description Turn Relay 1 ON without returning state Turn Relay 1 OFF without returning state Xytronix Research & Design, Inc. Page 59 Auxiliary Operations XW-210 WiFi Users Manual 6.2 HTTP GET Requests (for custom applications) The XW-210 has a built in web server that responds to HTTP GET requests. The server is always active. These GET requests are sent from web browsers when a web page is requested. They are fairly similar to the actual addresses seen in the browser's address bar. The following section describes the HTTP GET protocol and how it can be used to control and monitor the XW-210. 6.2.1 Using GET for Control and Monitoring There are many libraries and methods for sending a HTTP request programmatically. For reference, an example of how to manually build the HTTP request to control a relay is shown below. Please note that
\r\n is not needed in all instances. The '\r\n' string is used to represent the Carriage Return and Line Feed characters. Since not all methods of using a string can handle the actual CR LF characters, the '\r\n' is used in its place. For example, if you are using a programming language, you will likely use '\r\n'. If you are typing the command directly into a terminal program for testing, you will simply press enter once for each set of '\r\n'. If you are unsure, try using '\r\n' first and if that doesn't work, you may try using the enter key. In no case will you need to use the string '\\r\\n'. No Password GET requests to the device for XML files. Example request state.xml:
GET /state.xml HTTP/1.1\r\n\r\n Example turn Relay1 On:
GET /state.xml?relay1State=1 HTTP/1.1\r\n\r\n Password Enabled If the Control Password is enabled on XW-210 and the state.xml page is requested through a browser, the user will be prompted for a password. If the XML request is sent from an XML application, the html request will need to contain the password, encoded as Base64. The following is an html request header without the password:
GET /state.xml?relay1State=1&noReply=1 HTTP/1.1\r\n\r\n The following example adds the password:
GET /state.xml?relay1State=1&noReply=1 HTTP/1.1\r\n Authorization: Basic bm9uZTp3ZWJyZWxheQ==\r\n\r\n bm9uZTp3ZWJyZWxheQ== is the Base64 encoded version of the user name:password, none:webrelay. A utility is provided at http://www.controlbyweb.com/encoder to encode the password. Simply type the string username:password into the website and press 'Encode'. cURL Example The following is an html request without a password:
curl "http://192.168.1.2/state.xml?relay1State=1"
The following example adds the ability to supply a password curl --basic -u none:webrelay "http://192.168.1.2/state.xml?relay1State=1"
Page 60 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.3 External Server and Remote Services Note: The following methods are supported by the XW-210; however, Xytronix Research & Design, Inc. does not provide or support custom third party applications, or external web servers. 6.3.1 Accessing the XW-210 with custom software or third party applications Custom applications can send commands to XW-210 for monitoring and control functions using XML.
(See Section 6.1: XML Operation for more information.) The application interface can be used to provide a custom user interface, access to multiple units in a single screen, and allow for automation, logging, and other application-specific features. 6.3.2 Using an External Web Server Rather than accessing XW-210 directly from a computer, an external web server can be used. The term external web server is used here to mean a separate web server (such as Apache or IIS) that is not the web server built into XW-210. In this scenario, users access custom web pages that reside on the external web server and the external web server communicates with XW-210. An external web server can integrate multiple ControlByWeb products into a single control page. In other words, the user may not be aware that he/she is using multiple ControlByWeb devices, but rather the user sees an integrated control page for the entire system. In addition, the use of an external web server allows programmers to create custom user interfaces that take advantage of the additional resources typically available on larger web servers, including more memory and various web programming languages. There are two approaches that an external server can use to communicate with XW-210 and other ControlByWeb devices, Direct Server Control and Remote Services. 6.3.3 Direct Server Control The first approach is for the external server to create a TCP connection whenever it needs to access the XW-210. In this case, the external server opens the connection, sends commands and/or reads the device, and closes the connection. This method is ideal when the web server and all of the XW-210 devices are on the same network
(without routers between them). In this case, the server can communicate with the XW-210 devices directly and securely since data never has to leave the local network. When the server and the XW-210 are on different networks, routers must be configured to allow appropriate access. If a public network is used, such as the Internet, security precautions should be considered. 6.3.4 Remote Services The second approach is for the XW-210 to initiate a connection using the Remote Services. The settings under the WiFi Network tab in the setup pages will enable the XW-210 to open a TCP connection with an external server. Once the connection is open, the external server can send commands and/or read the device. The external server can leave the connection open (so that it never closes) or close the connection. Remote Services is ideal for installations where the server and the XW-210 are installed on different networks. This is especially useful when each XW-210 is installed on a separate private network. For example, if the user doesn't control the network connections where the XW-210 is installed, Remote Services would initiate a TCP connection over the Internet with the control computer. Since the XW-210 initiates the connection, the control computer doesn't have to know the IP address of the XW-210. This Xytronix Research & Design, Inc. Page 61 Auxiliary Operations XW-210 WiFi Users Manual means that the XW-210 can be installed using DHCP. In addition, no special router configuration is required. This makes the network installation of the XW-210 very simple, and since no incoming ports need to be opened in the router, security is not compromised. See Section 4.2: WiFi Networks Tab for more information. The XW-210 can be configured to establish a connection when triggered by an event, such as a I/O state changing. This is done by setting the Remote Service checkbox in the I/O setup tabs. When an event occurs and a connection is open, the state.xml file is sent. If a connection is not open and Remote Services is enabled, a connection will be established by sending the connection string. Once the connection is established state.xml will be sent. In version 2.0 of the protocol, it is required for the server to send back an acknowledgment packet after every connection string message received. The server does this by sending a 3 byte packet back containing the string 'ACK'. Additionally, version 2.0 of the protocol introduces the use of SSL client certificates for authentication and encryption. 6.3.5 Connection String With Remote Services enabled, a connection attempt will be made periodically according to the Connection Interval setting in the Advanced Network setup tab. The Connection String is a user-defined character string configured in the Advanced Network tab. The connection string is also sent at the same interval once the connection is open. The external server is responsible for closing the connection when it is done. In version 2.0 of the protocol, each connection string is prepended with the connection string type, MAC address, model number code and connection interval. Page 62 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.4 Email Notification 6.4.1 Email Notification Description XW-210 can be configured to send messages to eight email addresses when certain events occur. Events that can trigger email messages include relay/input state changes and temperature/humidity changes. When an email message is sent, it looks similar to this:
XW-210 Trigger: Relay 1 ON Relay 1: ON Input 1: OFF Count 1: 5.00 Sensor 1: 76.2 F Sensor 2: 73.7 F Sensor 3: 32.0 F Sensor 4: 84.5 F Note: Relays, Inputs, and Sensor names as well as ON and OFF status text may be customized by the user (installer) in the setup pages. The same field names are used on the Control Page. Subject Line The top line (that reads XW-210), appears in the subject line of the email message. This is the same text that appears as the header on the Control Page. It is set in the Main Header Text field under the Control Page Setup tab. Trigger The first line displayed in the body of the message shows the event that triggered the message. The text Trigger will always appear and cannot be changed. The remaining text includes the trigger name, and what caused the trigger. The text that describes the trigger and its current state are configured in the setup pages as described below. Current Status of the Digital Inputs, Relays, and Sensors The remainder of the email message will display the same information shown on the Control Page. If the Short Message option has been selected, only the I/O that triggered the email will be shown. Xytronix Research & Design, Inc. Page 63 Auxiliary Operations XW-210 WiFi Users Manual 6.4.2 Email Notification Setup Email notification requires that the following fields are properly configured. See Section 4.2: WiFi Networks Tab for a description of each field. WiFi Networks Tab IP Address Subnet Mask Gateway Preferred DNS Server (this is required if Mail Server is entered by name and not by IP address) SMTP Server SMTP Server Port User Name (If Required) Password (If Required) Return Email Email 1 Email 2 Email 3 Email 4 Email 5 Email 6 Email 7 Email 8 Note: XW-210 must be power-cycled (power disconnected, then reconnected) or rebooted before network settings take effect. Only the settings on the Network tab require power-cycling before taking effect. Email triggers can be explicitly defined for each Relay, Input, and sensor under the Relay, Input and Sensors tabs. The email options and recipients for each Relay, Input, and Sensor are configured separately. Select the Email Option and the check box for the desired email recipient for each Relay, Input, and Sensor. Once the email settings are entered, the email functionality can be tested by clicking the 'Test Email'
button. This will cause an email message to be sent immediately. Page 64 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.5 LogFile XW-210 logs information to log.txt. This log file is a text file stored in nonvolatile memory and will not be lost due to power failure. The log files are stored in a circular buffer which writes from the beginning of the allocated memory space to the end and then repeats from the beginning (over-writing the original data). The nonvolatile memory is divided into 4-Kbyte sectors. Each time data gets erased to make room for new data, a full sector (4-Kbytes) is erased at one time. 6.5.1 Data Log File log.txt This log file is user-configurable under the Logging setup tab, and stores real-world data such as temperatures and events such as relay state changes (see Section 4.6: Logging Tab for more information). It can be up to 512-Kbytes long and is stored using a comma separated value formatting scheme. Inputs, Relays, Vin, and Sensors will only be displayed if they are selected in the Logging setup tab. The file is read by requesting the log.txt file from XW-210. For example, using the default IP address the following command would be used to request the log file:
http://192.168.1.2/log.txt File Format:
MM/DD/YYYY HH:MM:SS, Sensors 1-4, Relay 1, Input 1, Counter, Vin Date and Time Format:
MM Month (1-12) DD Day (1-31) YYYY Year (1970 - 2106) HH Hour in 24 hour time (0 -23) MM Minutes (0-59) SS Seconds (0-59) Sample File:
The file can then be saved using the 'Save As...' option under the 'File' menu of the web browser. If the TCP port has been changed (not port 80), the port will be required to read the file. For example, using Xytronix Research & Design, Inc. Page 65 Auxiliary Operations XW-210 WiFi Users Manual the default IP address, and port 8000, the log file would be read as follows:
http://192.168.1.2:8000/log.txt The log.txt file may be erased with the following command:
http://192.168.1.2/log.txt?erase=1 After erasing the file, it might be necessary to refresh the page. Note: If the Control Password is enabled in the setup pages, the password will be required to access the log file. Page 66 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.6 Modbus/TCP XW-210 can be controlled and monitored using Modbus/TCP protocol. This provides a standard means of using XW-210 with devices and software from other manufacturers. This section is not a tutorial on Modbus and it is assumed that the reader is already familiar with Modbus. Detailed Modbus information can be found at http://www.modbus.org. Note: Modbus communications are disabled whenever the Control Password is enabled. This is because Modbus/TCP does not provide a mechanism for password protection. Make sure the Control Password is disabled (default) and Modbus functionality is enabled on the Advanced Network. XW-210 functions as a Modbus slave. Host devices, such as PLCs, open a connection with XW-210 on port 502 (configurable under Advanced Network tab) and then send requests to read or set relay states, read input states, or sensor values. When XW-210 receives a command, it will perform the desired function and return a response. The following sections provide an overview and explanation of Modbus operation. 6.6.1 XW-210 Modbus Function Code Summary XW-210 supports the following function codes:
Code Name XW-210 Feature Modbus Function Read Coils Read Discrete Inputs Read Analog Inputs Read Sensors Read Counters Write Single Coil Write Multiple Coils Pulse Coils 01 02 03 03 03 05 15 16 Relay 1 Input 1 Vin Sensors 1-4 Counter 1 Relay 1 Relay 1 Relay 1 XW-210 Start Address Hexadecimal 0x0000 0x0000 0x0010 0x0110-0x0116 0x0210 0x0000 0x0000 0x0310-0x0311 Decimal 0 0 16 272-278 528 0 0 784-785 Multiple commands may be sent without closing and re-opening the connection, but if no data is transferred for 50 seconds, the connection will time out and close. To keep the connection open, a read request can be sent periodically. XW-210 has two TCP sockets available for Modbus/TCP. This allows two connections to be open at one time. Requests for more than two open connections will be rejected. When errors occur, an error code is returned. Most Modbus client software will interpret this code in a human readable form. The code is comprised of the original function code plus 0x80. For example, an error during the read coils function 0x01 would return 0x81. Each error has a qualifying exception number. The following are the possible exception codes and their meanings:
0x01 - Function code not supported (also when Modbus is disabled in the setup pages). 0x02 - Incorrect starting address/quantity of output combination. Xytronix Research & Design, Inc. Page 67 Auxiliary Operations 6.6.2 PLC Device Addressing XW-210 WiFi Users Manual There are generally two schemes for accessing Modbus devices. The first is by specifying the Modbus function code, memory type, and address. The second, sometimes called PLC addressing, requires only the address. Modbus protocol uses four different address ranges for discrete inputs, coils, input registers, and holding registers. The function code determines the address range of the message. The following are common function codes and their respective address ranges. Code Name Coils (Read/Write) Discrete Inputs (Read only) Registers (Read only) Holding Registers
(Read/Write) Modbus Function 01, 05, 15 02 04 03, 06, 16 Data Type*
Discrete Discrete 8-64 bits 8-64 bits PLC Address Mode 485 1-1000 1001-2000 3001-4000 4001-5000 PLC Address Mode 584/984 1-10000 10001-20000 30001-40000 40001-50000
* Data types may be implemented at the discretion of the manufacturer. Address ranges may also over lap. Discrete is a binary or boolean value, 1 or 0. Function codes, memory types, and addresses can be converted to the PLC addressing equivalent using the table below. To use the table, look up the row corresponding to the Modbus function code. Then take the desired XW-210 feature address and add to it the address offset in the PLC address mode column. Input Address + PLC Base Address = PLC Address For example, to read discrete Input 2 Input Address PLC Base address PLC Address 1 1001 1002 Programming the PLC to read from 1002 will return the value of Input 2. Code Name Modbus Function 01 Read Coils Read Discrete Inputs 02 Read Holding 03 Registers Write Coils 05 Write Multiple Coils 15 16 Write Multiple Registers XW-210 Addresses 0 (Relay 1) 0 (Input 1) 16 (Vin) 272-278 (Sensors 1-4) 528 (Counter 1) 0 (Relay 1) 0 (Relay 1) 784-785 (Relay 1) Data Type PLC Address Mode 485 Addr + 1 Discrete Discrete Addr + 1001 32-bit float Addr + 4001 32-bit float Addr + 4001 32-bit float Addr + 4001 Discrete Discrete 32-bit float Addr + 4001 Addr + 1 Addr + 1 PLC Address Mode 584/984 Addr + 1 Addr + 10001 Addr + 40001 Addr + 40001 Addr + 40001 Addr + 1 Addr + 1 Addr + 40001 For 32-bit numbers or floats, two registers must be read starting at the desired address, examples of each are given for the applicable functions. Page 68 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.6.3 XW-210 Full Address Table The table below gives commonly used function codes, memory types, data sizes, and equivalent PLC addresses for accessing the XW-210. The data size will be the same regardless of the addressing mode. Function Code 01 05 02 03 03 03 03 03 03 15 16 Address
(Decimal) 0 0 0 16 272 274 276 278 528 0 784 Data Size Discrete Discrete Discrete 32-bit Float 32-bit Float 32-bit Float 32-bit Float 32-bit Float 32-bit int 8-bit 32-bit Float PLC Address Mode 485 1 1 1001 4017 4273 4275 4277 4279 4529 1 4785 PLC Address Mode 584/984 1 1 10001 40017 40273 40275 40277 40279 40529 1 40785 Read Relay 1 Write Relay 1 Read Input 1 State Read Vin Read Sensor 1 Read Sensor 2 Read Sensor 3 Read Sensor 4 Read Counter 1 Write Multiple Relays Pulse Relay Xytronix Research & Design, Inc. Page 69 Auxiliary Operations XW-210 WiFi Users Manual 6.6.4 Read Coils - Modbus Function Code 01 (0x01) Read the state of the relay. Request Start Address: 0x0000 (coil 1) Coil Quantity: 0x0001 (1 coil) Response The XW-210 will respond to the request with a data field of one byte, each bit representing the coil status. A '1' indicates the Output is ON. A '0' indicates that the Output is OFF. Bit zero of the return value will be the state of the coil corresponding to the start address. For example, if a start address of 0x0000 is used, bit zero will be the status of Relay 1. Bit 7 X 6 X 5 X Coil State Byte 3 4 X X 2 X 1 X Bit 0 Relay 1 Errors The sum of the start address and coil count cannot exceed the maximum coil count or an error response will be returned. The following are possible error responses. Coil Read Error Function Code (1 byte): 0x81 Exception Codes (1 byte):
0x01 Function code not supported. 0x02 Incorrect combination of start address and quantity of Relays Page 70 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.6.5 Read Discrete Inputs Modbus Function Code 02 (0x02) This function returns the state of the digital input. Request Start Address: 0x0000 (input1) Input Quantity: 0x0001 The sum of the starting address and the quantity of coils must not be greater than 0x0001. Response The input state is indicated by bit zero of the status byte. A 1 indicates that the input is switched high ON. A 0 indicates that the input switched low OFF. Bit zero of the return value will be the state of the coil corresponding to the start address. For example, if a start address of 0x0000 is used, bit zero will be the status of input 1. Discrete Input State Byte Bit 7 X 6 X 5 X 4 X 3 X 2 X 1 X Bit 0 Input 1 Errors Input Read Error Function Code (1 Byte): 0x82 Exception codes (1 Byte):
0x01 Function not supported. 0x02 Incorrect combination of start address and input quantity. Xytronix Research & Design, Inc. Page 71 Auxiliary Operations XW-210 WiFi Users Manual 6.6.6 Read Sensors Modbus Function Code 03 (0x03) The Read Holding Registers function is used for the temperature and other Xytronix 1-wire sensors. Request 32-bit sensor values are read from 16-bit register pairs. Consequently, senors addresses and registers must be even numbers. Vin Start Addresses Start Address: 0x0010 (Vin) Input Quantity: 0x0002 Temperature and Other Sensor Start Addresses Start Address: 0x0110 (Sensor Input 1) to 0x0116 (Sensor Input 4) Input Quantity: 0x0002 to 0x0008 Counter Start Addresses Start Address: 0x0210 (Count 1) Input Quantity: 0x0002 Response 32-bit floating-point values are returned, either as little-endian or big-endian numbers, depending on the configuration in the Advanced Network tab. With little-endian ordering, a temperature reading of sensor 1 (0x0110) would return 0x800042A2. The least significant word would be 8000 hex and the most significant word would be 42A2. This hexadecimal value converts to a temperature reading of 81.25 degrees. If a temperature or other sensor is not installed, a value of 0xFFFFFFFF (NaN) is returned. Other inputs will show measured values of the open circuits. Errors Sensor Read Error Function Code (1 byte): 0x83 Exception Codes (1 byte):
0x01 Function not supported. 0x02 Incorrect combination of start address and input quantity Page 72 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.6.7 Write Single Coil Modbus Function Code 05 (0x05) 0x0000 (Relay 1) 0x00 (OFF), 0xFF(ON) 0x00 Relays may be controlled one at a time. Request Start Address (2 bytes):
Output Value (1 byte):
Padding (1 byte):
Response The response mirrors the requested state, 0x00 or 0xFF. Errors Single Coil Write Error Function Code (1 Byte): 0x85 Exception codes (1 Byte):
0x01 Function not supported. 0x02 Address out of range. 0x03 Padding value. Xytronix Research & Design, Inc. Page 73 Auxiliary Operations XW-210 WiFi Users Manual 6.6.8 Write Multiple Coils - Modbus Function Code 15 (0x0F) One byte can be written to set the state of all relays, each bit representing one relay. Request Relay states are controlled by specifying the start address of the first relay to be controlled, the count of the relays to be affected, and the relay state byte. A relay value of 0xFFFF would be used to turn ON all of the relays in the range or 0x0000 to turn them OFF. In the above example, the relay value 0xFF would turn relay 1 ON. Start Address (2 bytes):
Output Quantity (2 bytes):
Byte Count (1-2 bytes):
Relay Value (1 bytes):
0x0000 (Relays 1) 0x0001 0x01 0x0000 0x0001 Bit 7 X 6 X 5 X Relay State Byte 4 X 3 X 2 X 1 X Bit 0 Relay 1 Response The quantity value is returned. Errors Multiple Coil Write Error Function Code (1 Byte): 0x8F Exception codes (1 Byte):
0x01 Function not supported. 0x02 Incorrect combination of start address and Relay quantity 0x03 Byte count out of range. Page 74 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.6.9 Write Multiple Registers Modbus Function Code 16 (0x10) The Modbus Write Multiple Registers function can be used to pulse the relays. Request The Modbus Write Multiple Registers function is used to pulse the relay(s) for a specified time. When the XW-210 receives this command, it immediately turns the appropriate relay(s) ON (if not already on) and starts the pulse timer. The pulse time is specified using floating point format in the register value field and can range from 0.1 seconds to 86400 seconds (1 day). When the pulse time expires, the relay will be turned OFF. If a pulse time command is sent with a value greater than 86400, the pulse timer will be set to 86400. If a pulse time command is sent with a value less than 0.1, the pulse timer will be set to 0.1. If any commands are sent to XW-210 (Modbus, XML or HTML) before the pulse timer has expired, the pulse timer will be canceled immediately and the new command will be executed. IEEE 754 floating point format is used for the pulse time. XW-210 may be configured for little-endian or big-endian transmission. The endian-ness is configured in the Advanced Network tab. (See 2.4.3 Advanced Network Tab for more information.) Start Address (2 bytes):
Register Quantity (2 bytes):
Byte Count (1 byte):
Pulse Duration (4 bytes/relay):
0x0310 (relay 1) 0x0002 0x04 0x3DCCCCCC 0x47A8C000 (big-endian) 0xCCCC3DCC 0xC00047A8 (little-endian) Response The request is acknowledged by responding with the register quantity that was requested. Errors Pulse Function code Error (1 Byte):
Exception codes (1 Byte):
0x90 0x01 Feature not supported. 0x02 Address quantity not an even number. Incorrect combination of start address and relay count. Xytronix Research & Design, Inc. Page 75 Auxiliary Operations 6.7 Basic Scripts XW-210 WiFi Users Manual BASIC (Beginners All-purpose Symbolic Instruction Code) is a computer programming language that has been in use for many years. The XW-210 has an integrated BASIC interpreter for a simple BASIC script. This provides a great deal of flexibility by allowing users to customize basic functions of the unit. The interpreter only supports a small subset of the BASIC commands that are available for larger computers. Some non-standard commands have been added, and some commands may function differently on the XW-210 BASIC interpreter than on other platforms. The following is a short tutorial on the supported BASIC functions. Example scripts are available at www.controlbyweb.com. Contact customer support if further assistance is required. 6.7.1 Structure A BASIC script is written as a .txt file, which is then uploaded to the device using the Script setup tab. The maximum script size is 4-Kbytes. Each line within the script contains a single statement. Line numbers are not used. Statements are not case sensitive; however, variables are. IF THEN, FOR loops, and DO loops can only be nested up to 5 times per command. For those not familiar with nesting, the following is an example of nested FOR loops:
FOR a = 0 to 100 FOR b = 0 to 100 NEXT b NEXT a Every program must end with an END statement. Subroutines would then follow after the END statement, if required. The last line of the script should be left blank. 6.7.2 Line Format Every line follows the same format. The basic format is:
statement (variable) (=, <, >, <=, >=, <>) (expression) (THEN) The fields in parentheses are optional depending on the statement. Spaces must be used between all statements, numbers, variables, operators, expressions, etc. Multiple spaces are invalid. Comments may be inserted, but must begin with an apostrophe. All text on a line after the apostrophe is ignored. Examples:
LET a=1 LET a = 1 LET a = 1
'this will return an error because of insufficient spacing
'this is valid
'this will return an error because of too many spaces Only a single variable or literal is allowed on the left side of any operator. The following example is incorrect and will return an error. The error occurs because there is more than a single value to the left of the comparison operator (a + 2 is to the left of =). IF a + 2 = 3 THEN 'this will return an error To fix the above line, replace 'a + 2'. One of the following options may be used:
LET b = a + 2 IF b = 3 THEN
... END IF Page 76 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.7.3 Supported Statements The following are the statements supported by the ControlByWeb BASIC interpreter. LET The LET statement assigns a variable a value. The format is:
LET (variable) = (expression) IF THEN, ELSE, END IF The IF THEN statement tests the truth of a condition. The ELSE statement defines a second function if the condition is found false. In other words, if the condition is true, then a function is performed. If it is not true, a second function may be performed. The second function may or may not be necessary depending on the application. The IF THEN (ELSE) statement must always be followed with an END IF statement. The format is:
IF (variable) (=, <, >, <=, >=, <>) (expression) THEN
(Function 1) ELSE
(Function 2) END IF Note: In most BASIC interpreters, 'Function 1' (see above) may be placed after the THEN statement. This interpreter requires 'Function 1' to be put on the following line. FOR TO, NEXT The FOR TO statement loops a section of code a predefined number of times. The NEXT statement always follows the section of code to be looped. The format is:
FOR (variable) = (expression) TO (expression)
(code to be looped) NEXT (variable) DO WHILE, LOOP The DO WHILE statement loops a section of code while a condition is found true. The LOOP statement always follows the section of code to be looped. Note that if the condition is omitted, the code will be looped without end. The format is:
DO WHILE (variable) (=, <, >, <=, >=, <>) (expression)
(code to be looped) LOOP Example:
let t0 = 100 do while t0 > 0
' wait loop LOG The LOG statement causes the device to log data according to the settings specified under the Logging setup tab. Note: In order to log, logging must be enabled in the Logging setup tab. The format is: LOG Xytronix Research & Design, Inc. Page 77 Auxiliary Operations EMAIL The EMAIL statement causes the device to send an email of the same format as that generated by other status change and alarm conditions. The event that triggered the email is given, followed by the I/O or Sensor that you want to email. The format is:
XW-210 WiFi Users Manual EMAIL (feature state relay1, input1, tempX) 'X represents the feature number such as temp2 Examples:
...or... ..or... ..or...
'Status email sent to addresses listed under Network tab. EMAIL EMAIL relay1 'Sends state change message to emails setup in I/O tab. EMAIL input1 'Input state change message to emails setup in I/O tab. EMAIL temp2 'Temp alarm message sent to recipients in the Sensors tab. END The END statement ends the main body of code. CALL The CALL statement is found within the main body of code, but requires the interpreter to skip to a subroutine found at the end of the program. After the subroutine is finished, the interpreter returns to the line immediately following the CALL statement. The format is:
CALL (name of subroutine) SUB, END SUB The SUB statement defines the beginning and name of a subroutine. The END SUB statement defines the end of the respective subroutine. Subroutine names can be up to 20 characters long and are case sensitive. The SUB and END SUB statements always must follow the END statement. The format is:
END
'*** Subroutines Go Here ***
SUB (name of subroutine)
(contents of subroutine) END SUB SUB (name of subroutine)
(contents of subroutine) END SUB REM or '
The REM or apostrophe ( ' ) statement designates remarks made by the programmer. The interpreter will disregard any characters on the line following these statements. PRINT The PRINT statement displays a variable or message to the display. The PRINT statement is only available for the PC version of the BASIC interpreter. The device will not recognize the command since it does not have an operator display. The format is:
PRINT (variable) PRINT "(message)"
'show variable value to screen
'show '(message)' to screen Page 78 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.7.4 User-Defined Variables Two types of variables are available for use in the ControlByWeb BASIC interpreter, user-defined variables, and predefined variables. Up to 10 user variables may be initialized. These must be single character, lower case letters. a, b, c, d, e, f, g, h, i, j They are always global and stored internally as floating point numbers. Variables are defined using the LET statement. Examples:
Let b = 5 Let d = b + 2
'variable b will be set to 5
'variable d will be set to 7 6.7.5 Predefined Variables The following are useful predefined variables for the ControlByWeb BASIC interpreter. These are useful for accessing internal values and features states. 6.7.5.1 Timer Variables Six timers are available for use in BASIC scripts. t0, t1, t2, t3, t4, t5 Timers can be set to any positive integer (or 0) by using the LET statement. As soon as a value is assigned to a timer, it will begin to count down immediately by decrementing one count every 100 ms until it reaches zero. Examples:
Let t3 = 1500 Let t1 = 0
'set timer 3 to 150 seconds
'disable time 1 6.7.5.2 Relay Variables Relay variables represent the state of the relays and can be used to change the state of the relays. Remote relays can also be controlled, but not read. The following variables are available. relay1 rmt_relay1 rmt_relay2
'relay 1
'remote relay 1 Note: Commands can be sent to remote relays, but the states of those relays cannot be read. Consequently, remote relays should not be used in safety or security-critical applications. Relay outputs can be turned ON, turned OFF, pulsed, toggled, or read in BASIC scripts. The LET statement is used to set the output state. The state options available are:
0 turn relay off 1 turn relay on 2 pulse relay 5 toggle relay The pulse time is specified in the Relay setup tab. Examples:
Let relay1 = 1 Let relay1 = 0 Let relay1 = 2 Let relay1 = 5 Let a = relay2
'turn on relay 1
'turn off relay 1
'pulse relay 1
'toggle relay 1
'read the state of relay 2, state will be 0 or 1 Xytronix Research & Design, Inc. Page 79 Auxiliary Operations XW-210 WiFi Users Manual 6.7.5.3 Input Variables The digital input states can be read in BASIC scripts. input1 Example:
'digital input 1 Let a = input1
'sets 'a' equal to value of input 1 6.7.5.4 Counter Variables The input counter can be read in BASIC scripts. count1
'input 1 counter Example:
If count1 > 5000 Then Let relay1 = 1 End If
'If input counter 1 is greater than 5000 then
'turn output 1 on 6.7.5.5 Vin Variable The vin voltage can be read in BASIC scripts. vin Example:
'Read the Vin voltage If vin > 10 Then Else End If Let relay1 = 2 Let relay1 = 0
'If Vin is greater than 10 volts then
'Pulse output 1, otherwise
'output1 will be off 6.7.5.6 Temperature/Other Sensor Variables Each temperature sensor or other Xytronix 1-wire sensor can be read in BASIC scripts. temp1 temp2 temp4 Example:
'temp or other sensor 1
'temp or other sensor 2
'temp or other sensor 4 If temp2 >= 80 Then Let relay2 = 1 End If
'If temperature sensor reads greater than 80
' degrees, then
'Turn on relay 2 6.7.5.7 Date and Time Variables The variables 'time' and 'date' are predefined, read only variables that store the current date and time. They can be used to schedule events and activities, such as sending emails, reading temperature, or setting Outputs. The date uses the mm/dd/yyyy format. Clock time is formatted as hh:mm:ss (24-hour clock). Example:
If date = 01/01/2014 Then If time > 12:30:00 Then Let relay2 = 1 Let relay3 = 0 End If End If Note: Current date and time can only be set in the Date/Time tab. Page 80 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.7.5.8 Event Variables Data and time variables can be used to execute script events. Up to five date variables are available.
'event date variable 1
'ed2, ed3, ed4
'event date variable 5 ed1 ed5 The value assigned to event variables should be in the format mm/dd/yyyy. The event date variables store the number of days that have passed since January 1, 1970. Event time variables may be used in math expressions as well as comparison statements. Time variables have a similar naming convention. et1
... et5
'event time variable 1
' et2, et3, et4
'event time variable 5 Event time variables are declared in the format hh:mm:ss in 24-hour time. The event time variables store the number of seconds from the beginning of the day. Event date and event time variables of the same number are linked. If the event time variable is incremented more than the number of seconds in a day (86400 seconds), the variable is reset to 0 and the event date variable is incremented by one. For example, if et3 rolls over to zero, ed3 will be incremented. The following script example demonstrates defining the event variables and comparing it to the current date and time. Assume current time is April 10, 2010 at 1:30 AM and the event should occur in one hour and every hour thereafter. Example:
Let a = 1 Let ed1 = 04/10/2010 Let et1 = 02:30:00 Do While a <> 0 If ed1 >= date Then If et1 >= time Then Let et1 = et1 + 3600 Print "Event"
End If End If Loop End
'sets the event date to April 10,
'2010.
'sets the event time to 2:30
'Tests event date versus current date.
'Tests event time versus current time.
'Increments the event time by one hour
'(in seconds).
'Event to occur 6.7.6 Registers Registers are similar to general purpose variables and can be used in the same manner. The difference between general purpose variables and registers is that external registers can be accessed by the user through a web browser and modified while the script is running. Scripts can use registers as a method of retrieving user input. register1 register4
'register variable 1
'register2, register3
'register variable 4 The following example demonstrates this by creating a script that will turn Remote Relay 1 ON if register1 equals 1 and OFF otherwise. Xytronix Research & Design, Inc. Page 81 Auxiliary Operations XW-210 WiFi Users Manual Example:
Do If register1 = 1 Then Let rmt_relay1 = 1 Else Let rmt_relay1 = 0 End If Call delay Loop End SUB delay Let t1 = 10 Do While t1 > 0 Loop End Sub Registers can also be used to show numeric values, such as a count down timer. If the register is any other value than 1 or 0, the value will be displayed in the Status 2 column. See Section 4.11: Control Page Setup for instructions on configuring Registers for visibility on the Control Page. The following code will show a count down from 10 seconds and automatically restart. The refresh rate for the control page is set to 3 seconds, so the countdown may appear to jump. Example:
'Initialize variables and start timer let t0 = 10 let register1 = 10
'Main Loop Do if t0 = 0 let register1 = register1 - 1 let t0 = 10 end if if register1 < 0 end if let register1 = 10 loop end
'when timer reaches 0 decrement counter
'restart when counter reaches zero register1 can be set and cleared by entering the following requests into a web browser or by configuring on and off buttons to appear on the Control Page for register1:
http://192.168.1.2/state.xml?register1=1 http://192.168.1.2/state.xml?register1=0 6.7.7 Testing and Debugging A copy of the BASIC interpreter for Windows is available on www.controlbyweb.com for testing and debugging. The XW-210 will only acknowledge errors as it runs. This means that if a path of the script is not encountered, errors may still exist. The Windows version of the interpreter, however, will check for errors before the script is run. The PRINT function is available for use with the Windows version of the BASIC interpreter. The interpreter on the device, however, will not recognize this command. Note: The script will be restarted by submitting any of the setup pages or by power cycling the unit. The MISSING END OF LINE error may be caused by misspelled names or a program that is too long. 4096 bytes of memory is reserved for BASIC scripts. Each text character, space, punctuation mark, tab, or carriage return uses one byte. If the script is too long, the script will be truncated and will not function as desired. Page 82 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual 6.8 Network Discovery XW-210 has implemented a network discovery and provisioning protocol to aid in accessing the device. With this protocol, a user may connect the device to a network without knowing the IP address, search and identify the IP address, query basic information and if not yet configured send the desired network and remote services configurations. This feature can be utilized in the latest versions of the Android and iOS apps. The network discovery protocol listens for specific requests on UDP port 65431 sent to the IP broadcast address 255.255.255.255. All requests must have the proper header and, when applicable, the correct MAC address. This header is the first 12 bytes of all messages and is simply the string 'ControlByWeb'. C 0x43 o 0x6f n t r 0x6e 0x74 0x72 o 0x6f l B y 0x6c 0x42 0x79 W 0x57 e b 0x65 0x62 Header 6.8.1 Initial Contact The initial contact request is sent to discover ControlByWeb devices on the network. It is recommended to send this message multiple times in environments where many ControlByWeb devices are present due to potentially lost traffic where collisions occur as UDP does not guarantee deliver of packets. Request:
Header (12 bytes) Message ID (1 byte) ASCII String Initial Contact Request ControlByWeb 0x00 Response:
Header (12 bytes) Message ID (1 byte) MAC Address (6 bytes) Device Info (2 bytes) ASCII String Initial Contact Response Binary version Bit[15-7] Reserved Bit 6 Mode Bit 5 Reserved Bit 4 Remote Services Status Bit 3 DHCP Status Bit 2 Remote Services Enabled Bit 1 DHCP Enabled Bit 0 Configuration Allowed Model Code (2 bytes) IP Address (4 bytes) Network endianness ControlByWeb 0x01 0x00 0x0c 0xc8 0x00 0x00 0x00 0b0 0b0=Station, 0b1=AP 0b0 0b0=Disconnected, 0b1=Connected 0b0=Waiting, 0b1=Success 0b0=Disabled, 0b1=Enabled 0b0=Disabled, 0b1=Enabled 0b0=Not Allowed, 0b1=Allowed 0x00 0x2A=XW-210 0xc0 0xa8 0x01 0x02 (192.168.1.2) Xytronix Research & Design, Inc. Page 83 Auxiliary Operations 6.8.2 Setup Information XW-210 WiFi Users Manual ASCII String Setup Information request Binary version Enable DHCP Enable Remote Services ControlByWeb 0x03 -or- 0x06 0x00 0x0c 0xc8 0x00 0x00 0x00 0x00=Disabled, 0x01=Enabled 0x00=Disabled, 0x01=Enabled The Setup Information request allows the device to receive IP network, remote services and WiFi network configuration data that it should use. Once this request is properly received, the device will apply the settings and reboot. There are two variants of this request, one has message ID 0x03 and the other has message ID 0x06. The only difference in these requests is message ID 0x06 includes fields for WiFi SSID, security and password. Once the device has received this command or after the user has configured the device through the web-pages, this request will be ignored and will return an error. The only way to re-enable this request, is to reset the device to factory defaults, or re-associate the device to a WiFi network via WPS. Request:
Header (12 bytes) Message ID (1 byte) MAC Address (6 bytes) DHCP (1 byte) Enable Remote Services (1 byte) Token (32 bytes) IP Address (4 bytes) Subnet (4 bytes) Gateway (4 bytes) Primary DNS (4 bytes) Alternate DNS (4 bytes) Remote Services Version (1 byte) Remote Services port number
(1 byte) Remote Services Connection Interval (2 bytes) Remote Services uses SSL (1 byte) Certificate retrieval port number
(2 bytes) Remote Services host Remote Services Connection String WiFi Security option (1 byte) SSID Port Remote Services server is listening on (Network Endianness) Time in minutes between connection attempts and pushing state.xml Only applicable to Remote Services Version 2.0 Port used to pass token information to retrieve certificates Null terminated ASCII string Null terminated ASCII string
''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 0xc0 0xa8 0x01 0x02 (192.168.1.2) 0xff 0xff 0xff 0x00 (255.255.255.0) 0xc0 0xa8 0x01 0x01 (192.168.1.1) 0x08 0x08 0x08 0x08 (8.8.8.8) 0x08 0x08 0x04 0x04 (8.8.4.4) 0x01=1.0, 0x02=2.0 ASCII String, no null terminator Network endianness Network endianness Network endianness Network endianness Not used by the XW-210 Specify protocol version 0x00=none, 0x01=WEP, 0x02=WPA(2) 0x00=No SSL, 0x01=Use SSL devices.controlbyweb.cloud 0x00 0x01 (1 minute) 0x1f 0x40 (8000) 0x01 0xbb (443) Message ID 0x06 only Null terminated ASCII string
(message ID 0x06 only) Null terminated ASCII string
(message ID 0x06 only) Password Page 84 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Successful Response:
Header (12 bytes) Message ID (1 byte) MAC Address (6 bytes) ASCII String Setup successful response Binary version ControlByWeb 0x04 0x00 0x0c 0xc8 0x00 0x00 0x00 Error Response:
Header (12 bytes) Message ID (1 byte) MAC Address (6 bytes) ASCII String Command not recognized response Binary version ControlByWeb 0x05 0x00 0x0c 0xc8 0x00 0x00 0x00 Xytronix Research & Design, Inc. Page 85 Appendix A: Specifications Appendix A: Specifications XW-210 WiFi Users Manual Wireless Specifications Network Standards:
Frequency Band Wi-Fi Security Standards Open, WEP, WPA, WPA2 Network Settings:
Wireless Range RF Output Power (typ) Antenna:
IEEE 802.11b/g/n 2.412 2.462 GHz DHCP or Static Up to 250ft (typical for Wi-Fi devices) depends on environment 14dBM (802.11b/g), 12dBM (802.11n) External, 2.4 GHz, 50, omni directional, 1/4 wavelength, gain: 2.1dBi. With articulated reverse SMA connector. Operation Provisioning:
Access Point:
WPS:
Connectivity:
Remote Server:
Remote Relays:
Polling:
Power Requirements Via internal web server (no cables or PC utilities needed) Yes, push button activated (setup via web page) Yes, push button activated (Wi-Fi Protected Setup) Always connected ControlByWeb's X-600 or cloud-based server Control relays on other ControlByWeb products state.xml (web-server is always active) Input Voltage:
Current:
9-28 VDC See table below for typical values at 25C Test Conditions AP Mode relay Off and input Off Attempting to connect to AP relay Off and input Off Connected to AP with network traffic relay Off and input Off Connected to AP with network traffic relay On and input Off Connected to AP with network traffic relay Off and input On Connected to AP with network traffic relay On and input On 9VDC 68mA 12VDC 51mA 24VDC 31mA 68mA 52mA 36mA 65mA 50mA 28mA 185mA 140mA 72mA 75mA 57mA 31mA 188mA 143mA 75mA Push Buttons Button 1:
Button 2:
Relay Contacts Load Type:
Contact Form:
Contact Material:
Max Voltage:
Force access-point mode Activate WPS mode General purpose SPDT (form C) Silver Nickel 277 VAC (general purpose) 30 VDC (NC contact, resistive) Page 86 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Max Current:
Electrical Life:
Mechanical Life:
Environmental Rating:
Control Options:
Pulse Timer Duration:
12A 100K cycles, typical @ full-rated load (higher with smaller load) 10M cycles, typical Over voltage Category II, Pollution Degree 2 On/Off or Pulsed 100ms to 86400 Seconds (1-day) Digital Input Number of Inputs:
Minimum Pulse Time (high or low):
Input Current (Iin):
Isolation (Viso):
Reverse voltage (Vr):
Vin:
Vin Hi:
Vin Lo:
Input counter:
1 25mS 950uA @ 4V, 8.5mA @ 26V 1,500 Vrms 6V max 28V (max) 4V (min) 1.5V (max) 32-bit floating-point 1-Wire Sensor Input 4 Maximum number of sensors:
Works with digital 1-wire thermometer probes Interchangeable, no calibration needed Dallas Semiconductor DS18B20 digital 1-wire thermometer Available in bare or encapsulated versions Also works with ControlByWeb wall-mount humidity sensors and other Xytronix 1-wire sensors. Measurement Range:
Accuracy:
Maximum cable length:
-55C-to 125C (-67F to 257F)
+/-0.5C from -10C to +85C. 600 feet maximum cable length LED Indicators (4) Green:
Yellow:
Configuration Power On Relay On, Input On, Link Celsius/Fahrenheit:
Temperature Reports:
Switch Status Reports:
Report Rate:
User configurable Interval Interval, on state change, or both User configurable Email alerts Email Alerts:
Encrypted Email Alerts:
Temperature Alerts:
Input Status Alerts:
Configurable, up to 8-addresses Yes High or low temperature Input on, input off, or input change Real-Time Clock Manual or NTP (Network Time Protocol) setup, (not battery backed) NTP sync configurable for once, daily, weekly or on power-up Automatic daylight savings adjustment Xytronix Research & Design, Inc. Page 87 Appendix A: Specifications Logging XW-210 WiFi Users Manual Stored in non-volatile flash memory Circular buffer 512-Kbytes (16000 to 32512 log entries depending on configuration) Scripts Implement special or custom features with a BASIC script Max size 4-Kbytes Environmental Indoor use or NEMA-4 protected location up to 2000m Altitude:
Operating Temperature:
-40C to 65.5C (-40F to 150F)
-40C to 85C (-40F to 185F) Storage Temperature:
Humidity:
5-95%, non-condensing Mechanical Size:
Weight:
Certifications 1.41 x 3.88 x 3.1 in. (35.7 x 98.5 x 78 mm), (not including connector) 5.4 oz (154 g), (including connectors and antenna) FCC ID: 2AE4Z-XWD002 FCC 47CFR15 (Class B) IEC CISPR 22, CISPR 24 EN55024 ITE Immunity (2010) EN55022 Emissions (2010) IC: 21441-XWD002 Page 88 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Appendix B: Trademark and Copyright Information This document is Copyright 2016 by Xytronix Research & Design, Inc. All rights reserved. XW-210, WebRelay, ControlByWeb, and Xytronix Research & Design are trademarks of Xytronix Research & Design, Inc. 2005-2017. All other trademarks are the property of their respective owners. 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. 2005-2017. XW-210 may not be 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 products features, specifications, documentation, warranties, fee schedules, and conditions at any time and without notice. Xytronix Research & Design, Inc. Page 89 Appendix C: Warranty Appendix C: Warranty XW-210 WiFi Users Manual This Xytronix Research & Design, Inc. product is warrantied against defects in material and workmanship for a period of five years 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, customer must contact Xytronix Research & Design, Inc. technical support
(support@ControlByWeb.com) and obtain a Return Authorization number (RA#). Before issuing an RA#, a support technician will work with customer to try to resolve the issue without returning the product. If technician determines that product must be returned for service an RA# will be issued. Next, the product must be properly packaged and returned to Xytronix Research & Design, Inc. with the RA# clearly marked on the package. The purchaser shall prepay all charges for shipping to Xytronix Research &
Design, Inc. For warranty repairs of products less than one year old, 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 continental United States. If the product is shipped outside of the continental United States or the product was shipped more than one year earlier, 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. Page 90 Xytronix Research & Design, Inc. XW-210 WiFi Users Manual Appendix D: FCC Statement This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
1. This device may not cause harmful interference. 2. 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 against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not in-stalled and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee 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 a relay on a circuit different from where 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 users authority to operate the equipment. RF Exposure Information This equipment complies with the FCC RF radiation exposure limits set forth for an uncontrolled environment. The antennas used with this transmitter must be installed to provide a separation distance of at least 20cm from all persons and must not be located or operating in conjunction with any other antenna or transmitter. Canadian License-Exempt Radio Apparatus (RSS-GEN) This device complies with Industry Canada license-exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device. Le prsent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence. L'exploitation est autorise aux deux conditions suivantes : (1) l'appareil ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radiolectrique subi, mme si le brouillage est susceptible d'en compromettre le fonctionnement. Under Industy Canada regulations, this radio transmitter may only operate using an antenna of a type and maximum (or lesser) gain approved for the transmitter by Industry Canada. To reduce potential radio interference to other users, the antenna type and its gain should be so chosen that the equivalent isotropically radiated power (eirp) is not more than that necessary for successful communication. Xytronix Research & Design, Inc. Page 91 Appendix E: Mechanical Dimensions Appendix E: Mechanical Dimensions XW-210 WiFi Users Manual Page 92 Xytronix Research & Design, Inc.
frequency | equipment class | purpose | ||
---|---|---|---|---|
1 | 2017-09-20 | 2412 ~ 2462 | DTS - Digital Transmission System | Original Equipment |
app s | Applicant Information | |||||
---|---|---|---|---|---|---|
1 | Effective |
2017-09-20
|
||||
1 | Applicant's complete, legal business name |
Xytronix Research & Design, Inc.
|
||||
1 | FCC Registration Number (FRN) |
0024689721
|
||||
1 | Physical Address |
1681 West 2960 South
|
||||
1 |
Nibley, UT
|
|||||
1 |
United States
|
|||||
app s | TCB Information | |||||
1 | TCB Application Email Address |
j******@metlabs.com
|
||||
1 | TCB Scope |
A4: UNII devices & low power transmitters using spread spectrum techniques
|
||||
app s | FCC ID | |||||
1 | Grantee Code |
2AE4Z
|
||||
1 | Equipment Product Code |
XWD002
|
||||
app s | Person at the applicant's address to receive grant or for contact | |||||
1 | Name |
D******** W********
|
||||
1 | Title |
President
|
||||
1 | Telephone Number |
435-7********
|
||||
1 | Fax Number |
435-7********
|
||||
1 |
d******@ControlByWeb.com
|
|||||
app s | Technical Contact | |||||
1 | Firm Name |
Xytronix Research & Design
|
||||
1 | Name |
D******** W****
|
||||
1 | Physical Address |
1681 West 2960 South
|
||||
1 |
Nibley, Utah 84321
|
|||||
1 |
United States
|
|||||
1 | Telephone Number |
435-7********
|
||||
1 | Fax Number |
435-7********
|
||||
1 |
d******@ControlByWeb.com
|
|||||
app s | Non Technical Contact | |||||
n/a | ||||||
app s | Confidentiality (long or short term) | |||||
1 | Does this application include a request for confidentiality for any portion(s) of the data contained in this application pursuant to 47 CFR § 0.459 of the Commission Rules?: | Yes | ||||
1 | Long-Term Confidentiality Does this application include a request for confidentiality for any portion(s) of the data contained in this application pursuant to 47 CFR § 0.459 of the Commission Rules?: | No | ||||
if no date is supplied, the release date will be set to 45 calendar days past the date of grant. | ||||||
app s | Cognitive Radio & Software Defined Radio, Class, etc | |||||
1 | Is this application for software defined/cognitive radio authorization? | No | ||||
1 | Equipment Class | DTS - Digital Transmission System | ||||
1 | Description of product as it is marketed: (NOTE: This text will appear below the equipment class on the grant) | Wireless WebRelay | ||||
1 | Related OET KnowledgeDataBase Inquiry: Is there a KDB inquiry associated with this application? | No | ||||
1 | Modular Equipment Type | Does not apply | ||||
1 | Purpose / Application is for | Original Equipment | ||||
1 | Composite Equipment: Is the equipment in this application a composite device subject to an additional equipment authorization? | No | ||||
1 | Related Equipment: Is the equipment in this application part of a system that operates with, or is marketed with, another device that requires an equipment authorization? | No | ||||
1 | Grant Comments | Output power is conducted. The device supports 20MHz bandwidth. | ||||
1 | Is there an equipment authorization waiver associated with this application? | No | ||||
1 | If there is an equipment authorization waiver associated with this application, has the associated waiver been approved and all information uploaded? | No | ||||
app s | Test Firm Name and Contact Information | |||||
1 | Firm Name |
Eurofins MET Laboratories, Inc.
|
||||
1 | Name |
J****** F******
|
||||
1 | Telephone Number |
41094********
|
||||
1 | Fax Number |
44392********
|
||||
1 |
j******@metlabs.com
|
|||||
Equipment Specifications | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Line | Rule Parts | Grant Notes | Lower Frequency | Upper Frequency | Power Output | Tolerance | Emission Designator | Microprocessor Number | |||||||||||||||||||||||||||||||||
1 | 1 | 15C | 2412.00000000 | 2462.00000000 | 0.0300000 |
some individual PII (Personally Identifiable Information) available on the public forms may be redacted, original source may include additional details
This product uses the FCC Data API but is not endorsed or certified by the FCC