Wireless Sensors GWAY-1100 User manual

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
1 / 35
GWAY-1100 Rack Sentry
Ethernet Gateway
Operation Manual
Rev 2.0

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
2 / 35
Table of Contents
GWAY-1100 Operation Manual................................................................................................................. 1
Table of Contents................................................................................................................................. 2
Introduction.......................................................................................................................................... 3
QUICK START GUIDE............................................................................................................................. 4
INTERFACE............................................................................................................................................. 5
Physical ............................................................................................................................................... 5
USB ..................................................................................................................................................... 5
Web ..................................................................................................................................................... 5
Programmatic....................................................................................................................................... 6
CONFIGURATION................................................................................................................................... 7
Network Configuration.......................................................................................................................... 7
POST Client Configuration................................................................................................................... 8
1-Wire Configuration............................................................................................................................ 9
USB ..................................................................................................................................................... 9
WEB ACCESS TO DATA ........................................................................................................................11
Home Page.........................................................................................................................................11
Individual Sensor Selection................................................................................................................ 13
1-Wire Device Details......................................................................................................................... 14
Communications..................................................................................................................15
Interface ..............................................................................................................................15
INTEGRATION....................................................................................................................................... 17
HTTP ................................................................................................................................................. 17
Retrieving XML File .............................................................................................................17
Writing Data to 1-Wire Devices............................................................................................18
Firmware Upgrading............................................................................................................18
SNMP (Simple Network Management Protocol)................................................................................. 19
edsEnterprise Branch..........................................................................................................19
dTrap Branch.......................................................................................................................19
Telnet...................................................................................................................................21
UDP................................................................................................................................................... 22
Low Level 1-Wire Interface................................................................................................................. 24
POST Client....................................................................................................................................... 24
MAINTENANCE..................................................................................................................................... 25
Firmware and Support Files Upgrade................................................................................................. 25
Factory Reset..................................................................................................................................... 27
ADDITIONAL RESOURCES.................................................................................................................. 28
Supported 1-Wire Devices ................................................................................................................. 28
GWAY-1100 Form Factor.................................................................................................................... 28
Power Supply Requirements.............................................................................................................. 28
Ethernet Interface .............................................................................................................................. 28
1-Wire Interface ................................................................................................................................. 29
Power Supply Schematic ................................................................................................................... 30
1-Wire Interface Schematic................................................................................................................ 30
Specifications..................................................................................................................................... 30
Appliance Scanner Software............................................................................................................. 31
Support.............................................................................................................................................. 31
REGULATORY COMPLIANCE.............................................................................................................. 32
ACKNOWLEDGEMENTS...................................................................................................................... 32
APPENDIX A ......................................................................................................................................... 33
Low Level 1-Wire Communication Protocol........................................................................................ 33

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
3 / 35
Introduction
Thank you for purchasing the Wireless Sensors GWAY-1100. The GWAY-1100 provides an easy
and simple method for the continuous monitoring of 1-Wire®sensors that you might install in
such places as computer server rooms or manufacturing facilities.
The Wireless Sensors GWAY-1100 product line features a lightweight, low-power space saving
design coupled with powerful on-board, web-based monitoring software. Data from connected 1-
Wire sensors is provided in open, industry-standard formats (e.g., XML, SNMP) making it easy
to integrate with existing business automation and monitoring systems.
This manual is divided into the following sections:
Quick Start Guide—this section provides simple and easy steps to get up and running
quickly with your GWAY-1100
Interface—this section describes the three interfaces (physical, web, and programmatic)
to the GWAY-1100
Configuration—this section provides information on how to setup a GWAY-1100 with
your existing network and/or business systems as well as how to configure attached 1-
Wire devices
Web Access—this section describes how to utilize the on-board web application to ac-
cess real-time monitoring of your connected 1-Wire sensors
Integration—this section provides details on how to integrate the GWAY-1100 with exist-
ing systems and applications. This section is aimed at software programmers and engi-
neers who want to interface directly to the GWAY-1100
Maintenance—this section covers various activities related to maintaining or upgrading
the GWAY-1100
Additional Resources—this section provides links to other resources, how to get sup-
port, and frequently asked questions

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
4 / 35
QUICK START GUIDE
Getting started with the GWAY-1100 is simple. Just follow a few easy steps:
1. Apply power to the GWAY-1100. The
green PWR/ACT LED will begin to
flash at one-second intervals, indicat-
ing that the product is operating nor-
mally. Power must be 5 volts at 400
milliamp (minimum).
2. Connect it to your Network. Connect
a live network cable to the Ethernet
Port on the device. The green LED on the Ethernet connector will illuminate, indicating a
valid network connection. The yellow LED on the Ethernet connector blinks only when
there is network traffic.
3. Connect a 1-Wire Device. Connect a supported 1-Wire device to any of the 1-Wire RJ12
connectors.
4. Determine the IP address of the GWAY-1100 by checking your DHCP server logs or
running the GWAY-1100 scanner software. If the GWAY-1100 does not find a DHCP serv-
er running on your network, it will default to
the following IP address: 169.254.1.1.
5. Configure your device. Type the IP ad-
dress of the GWAY-1100 into your Web
browser (e.g., http://192.168.1.27) and
press enter. Select the tab “Network Setup”.
When the name and password is request-
ed, enter “admin” for the name and
“sensicast” for the password. A Web page
similar to the one shown to the right will en-
able you to configure and monitor various
aspects of your GWAY-1100.
6. CONGRATULATIONS! You have successfully installed your Wireless Sensors’ GWAY-
1100. Please refer to the Web Access section of the Operation Manual to obtain an un-
derstanding of the function of each of the Web pages served by the GWAY-1100.
Some things to keep in mind:
The GWAY-1100 has an internal flash drive that may be used to set it to a fixed IP address. See the section
Configuration/USB for more information.
No support is provided for GWAY-1100 IP address identification when utilizing any method other than the
GWAY-1100 scanner software. Please consult your network administrator if you cannot locate the DHCP
address.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
5 / 35
INTERFACE
The GWAY-1100 has three types of interface:
Physical—the ports, buttons, and other elements on the unit itself
Web—the on-board Web application that provides real-time access of monitoring data
Programmatic—the methods by which to interface directly with monitoring data
Physical
The physical interface of the GWAY-1100 includes five parts:
1-Wire Connector Panel: provides connectivity to 1-Wire sensors through three (3) RJ12
connectors. Each connector is a separate 1-
Wire bus
Power: a single micro USB connector. The
power connector also has a USB port,
which may be used to configure the net-
work settings. See section Configura-
tion/USB
Ethernet: connects the device to an existing 10/100-baseT network via a standard RJ45
connector
Power/Activity Indicator: flashes green to indicate the unit is receiving power and operat-
ing correctly, flashes yellow to indicate data activity
USB
The power / USB port may be used to configure the network settings via the internal flash drive.
This method would typically be used to configure the network settings to a fixed IP address with
the DHCP server turned off, as shown below. See the section Configuration/USB below.
Web
Each GWAY-1100 includes an integrated Web-server
that provides access to monitored data from any In-
ternet connected device such as a Web browser on
your PC, smartphone, or even an iPad®!
The Web interface provides you an easy way to con-
figure the network setting for the GWAY-1100 and is
accessible by navigating to its IP address. When you
connect the GWAY-1100 to your network it will auto-
matically request an IP address from an available
DHCP server if the feature is turned on, otherwise it
will use an IP address assigned by you. See configu-
ration section below.
Simply open a Web browser and enter that IP address to access the Web monitoring applica-
tion.
The Web interface provides the following menu items:

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
6 / 35
Home—the default, opening screen that provides a snapshot of all connected devices,
graphing of one value for all connected devices and GWAY-1100 basic information
oIndividual Sensor Data—by highlighting and clicking an individual sensor listed
on the Home page, a user can access alarm settings, modify limits and graph up
to 3 different sensor values.
Advanced:
oDetails—allows user to view detailed information about each device connected to
the GWAY-1100.
oDetailed XML File—allows user to view complete XML File
System Configuration:
oNetwork Setup—provides access to security and network configuration infor-
mation.
oPOST Client Setup—provides access to configuration fields for HTTP Post and
Proxy Server features
o1-Wire Interface Setup—provides access to configuration fields for activating di-
rect control of the 1-Wire bus via TCP using ASCII based command set
Contact—provides contact information and website link
Note: If you don’t know the IP address being assigned to the GWAY-1100 by your network,
simply access your DHCP’s assignment or run the GWAY-1100 Scanner software that will auto-
matically find and display the IP address for any GWAY-1100 on the network. For more infor-
mation about the GWAY-1100 Scanner software, see section Additional Resources.
Note: If your network does not have a DHCP server, the GWAY-1100 will default to a self-
assigned address of 169.254.1.1. In the event of this situation, you will need to temporarily re-
configure your computer’s network settings to be on the same network as the GWAY-1100 in or-
der to talk to the device for the first time. Only when the GWAY-1100 is in the same address
space as your other computers can you access it using a web browser.
Programmatic
Through a number of different channels, you can access the GWAY-1100 programmatically to
create integration with existing systems and network services:
HTTP—service provides delivery of html and xml data files via http get command, and
firmware upload via http post
SNMP—provides access to data from all connected sensors, and pushes SNMP traps to
remote listeners for alarming capabilities
Telnet—service provides ability to monitor the internal activities of the GWAY-1100 for di-
agnostic purposes
UDP Broadcast—listener on port number 30303 will respond to properly formatted pack-
ets broadcast to this port number, allowing other devices and applications to discover any
GWAY-1100 that exists on the same network. For assistance in determining the units IP
address, see the section Additional Resources.
1-Wire Interface—service provides a TCP client that implements a command/response
low level interface that may be used to directly control the 1-Wire bus
POST Client—provides a method of pushing XML data about connected 1-Wire devices
to a server; ideal for circumventing firewall issues

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
7 / 35
CONFIGURATION
Any configuration of your GWAY-1100 (with the exception of SNMP Traps) can be carried out
through the integrated Web application and, in some cases, the USB port. The on-board, Web
based tools provide a method to configure both the unit itself as well as any attached supported
1-Wire devices. The USB port provides a way to configure the network settings.
To access the configuration elements,
Navigate to the IP Address your network has assigned to the GWAY-1100. This will open
the Web interface.
From the default Home screen, you can access the
System Configuration tab using the top row menu.
Here you will find:
Network (configuration)
Post Client (configuration)
1-Wire (configuration)
Network Configuration
The Network Configuration page displays a number of fields to configure the GWAY-1100 opera-
tions within your network.
Note: In order to access this portion of the Web tool, you will need a username and password.
The factory default settings are: user name = “admin”, and password = “sensicast” (all in lower
case.)
You can configure the following aspects of the GWAY-1100:
Device name—the factory default is OWServer_v2-Enet.
However this is a user definable name, maximum 24 char-
acters. Alphanumeric characters, dashes, periods, spaces,
colons and underscores are permitted. This flexibility allows
you to distinguish a device by its location or function for
clarity. This field is included in the XML file.
User name—this is the user name, case-sensitive maxi-
mum 12 characters, used to access the configuration sec-
tions of the on-board Web tool and the Telnet interface. Up-
percase and lowercase Alphanumeric Characters permit-
ted. The factory default is "admin".
Password—this is the password used to access the con-
figuration sections of the on-board Web tool and the Telnet
interface. Uppercase and lowercase Alphanumeric Charac-
ters permitted. The factory default is "sensicast".
Password—confirm the password entered in the previous
password field.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
8 / 35
Host Name—the factory default name for the GWAY-1100 is SENSINET. You can
change the name but it is limited to 16 UPPERCASE characters. This field is also includ-
ed in the XML file.
Enable DHCP—check this box to automatically enable the GWAY-1100 to receive an IP
address and other network configuration information (such as gateway and subnet mask)
from a DHCP provider on your network. Note: this is the factory default setting of the de-
vice. If you elect NOT to enable DHCP, you must manually provide network adapter set-
tings for the device:
oIP Address—a standard IPV4 address. Note: if you configure the device with an
IP Address that is NOT a part of your network IP-range or class you will be unable
to access the device unless connected directly to it with a computer configured
with the same IP settings
oGateway—the IP address of your network gateway
oSubnet Mask—the Subnet mask
oPrimary DNS—the IP address of the primary DNS server
oSecondary DNS—the IP Address of a secondary DNS server. Note: this is option-
al
oHTTP Port—the port through which the GWAY-1100 will listen for incoming HTTP
requests. Normally programmed to 80
Save—when you have finished making settings, click the “Save” button to commit the
settings to the device. This will cause the device to reboot
Note: At the time of initial boot-up, the device will look for a DHCP server. If one cannot be
found, the following default configuration settings will be applied:
IPAddress: 169.254.1.1
Gateway: 169.254.1.1
Subnet Mask: 255.255.0.0
DNS: 169.254.1.1
POST Client Configuration
The POST Client Configuration page of
the Web tool allows you to configure the
POST Client and Proxy features of the
GWAY-1100.
To configure POST Client
Enable the feature by clicking the
check box
Select the URL of the HTTP POST
server. This field requires a fully
qualified URL and may include an
alternate port number.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
9 / 35
This example sets the port to 12391:
“http://www.wirelesssensors.com:12391/files/myfile.htm”
Select how often to send the “details.xml” file
Proxy server may be enabled by clicking the check box
Set the Proxy URL to the appropriate address, which is typically obtained from the net-
work administrator. For example, if the proxy server is at 192.168.1.230, port number
8080, then the Proxy URL field would be programmed to http://192.168.1.230:8080. The-
se proxy parameters only apply to the POST Client feature, they have no effect on any of
the other features.
1-Wire Configuration
The 1-Wire Configuration feature of the Web-tool
allows you to configure the 1-Wire interface on the
GWAY-1100.
At this time, the only configuration setting allowed
is to enable direct TCP communication with the 1-
Wire bus. This allows you to send commands di-
rectly to 1-Wire devices connected to the system.
It is ideal for solutions developers looking to inte-
grate the GWAY-1100 with 1-Wire devices not currently supported at a high level or for legacy
applications. For specific 1-Wire commands see Low Level 1-Wire Communication Protocol in
Appendix A.
To configure the port
Click the “Enable” check box `
Specify a port number through which communication will occur
When you are finished, click the “Save” Button to commit the settings to the device
USB
The power / USB port may be used to configure the network settings via the internal flash drive.
Using a cable with a micro USB connector, simply plug
the GWAY-1100 into a USB port of a computer and read
the file CONFIG.TXT on the flash drive.
Edit the file as desired, save it, eject the disk and discon-
nect the GWAY-1100 from the computer's USB port. Apply
power using the wall transformer and the GWAY-1100 will
power up with the new network settings.
This method would typically be used to configure the network settings to a fixed IP address with
the DHCP server turned off, as shown below.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
10 / 35
Note: The USB port cannot be used to determine the cur-
rent IP address assigned by the DHCP server.
HOWEVER using the USB port, you can disable DHCP, set
the device to a fixed IP address then find the device at that
address (assuming that there is no conflict with the de-
sired IP address.)

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
11 / 35
WEB ACCESS TO DATA
The GWAY-1100 provides a robust, on-
board, Web-based tool to access connect-
ed 1-Wire devices from any Web brows-
er—whether on a PC or a smartphone!
To access the connected 1-Wire devices;
Navigate to the IP Address your
network has assigned to the GWAY-
1100. This will open the Web inter-
face.
Home Page
From the default Home page you can:
View GWAY-1100 Summary data
View basic 1-Wire Device information
Select whether English or Metric units are displayed
Graph a single value for devices connected to one or all channels
Download data into .csv file
Select additional Menu items such as Advanced, System Configuration or Contact Us
Access individual sensors to modify alarm settings and graph data
Summary Data
Devices connected—the number of 1-Wire devices connected to the GW-1100
Loop time—the time, in seconds, it takes for the GWAY-1100 to cycle through polling all
of the devices and receive a response. As more devices are added, each individual de-
vice gets read less frequently since only a single device can be read at a time. This value
is useful for determining how frequently each sensor gets read
Device poll count—the number of times the GWAY-1100 has polled devices. The rate of
polling depends upon the number of devices and the specific device. Some 1-Wire devic-
es refresh every second while others may do so much faster (e.g., The DS18B20 causes
a 900ms delay while waiting for the temperature to be converted, whereas the DS2406
has no delay)
Supply Voltage—the voltage being supplied to the GWAY-1100
Channel Chart—displays parameters specific to each channel
oDevices—number of devices on each channel
oErrors—number of errors on the 1-Wire bus for each channel since the last reset
oVoltage—voltage of each channel

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
12 / 35
Basic 1-Wire Device Information
oDescription—the description of the device1
oROM ID—the unique number assigned to each 1-Wire device
oDevice—the name of the device
oChannel—the channel the device is connected to
oHealth—the health of the device. Each time a device is successfully read, its
health field is incremented by 1, to a maximum value of 7. If a device fails to read
properly for any reason, its health field is decremented by 1, to a minimum value of
0. Generally, a health value of 7 indicates a properly functioning device, 0 indi-
cates a device that has been disconnected, and anything in between might indi-
cate intermittent communication or a recently connected device.
oValue—the primary value of the sensor on the connected device
During normal operation the GWAY-1100 automatically scans the 1-Wire bus in the following or-
der:
Searches for devices—if new devices are found, they are added to the end of the de-
vice list2
Reads data—each sensor is read and fields are updated before proceeding to next sen-
sor
English/Metric Conversion
Select the Metric or English system of measurement. The page will refresh to display the data in
the system of your choice.
Graph
On the Home page, a single value of all devices connected to a one, or all channels of the
GWAY-1100 can be graphed. The duration of the graph window ranges from 15 minutes to 3
days. Select the appropriate variable; press begin. Graphing will not start until
the Begin button is selected.
Data is not stored - if you leave the Web page, the graph will be lost. You can
open multiple Web pages to view additional information, however each additional
Web page browser will slow the response from the GWAY-1100.
Download
1Please note that the description is commonly based on the Maxim IC, not the sensor type (i.e. humidity, light,
barometric pressure) connected to the chip.
2The order of devices in the list may change if the power is cycled.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
13 / 35
This feature captures all data currently displayed in the graph. The download method is browser
dependent; Clicking the download typically saves the date to a .csv file or displays it on a new
Web page that allows you to manually save the data as a .csv file.
Individual Sensor Selection
By highlighting and clicking on a sensor listed on the Home page, the user can access alarm
settings, modify limits and graph up to 3 different sensor values.
After an individual sensor
is selected a new screen
will appear that displays
variables associated with
the sensing device. Sen-
sors with many variables
will have some hidden, so
the More button may be
used to view the extended
list of variables.
Device Data
The top part of the screen displays information
about each connected device. Sliding the cursor
over and selecting a programmable value al-
lows users to assign a limit, change a function or

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
14 / 35
reset an alarm. When the unit does go into alarm, the current value will display in red if the unit
is in high alarm, or blue if in low.
Because each supported device may have different elements, they are not covered in detail in
this manual.
Graph
The opening screen of the Individual Sensor Selection will begin graphing the value Tempera-
ture automatically with 15-minute display duration. Two additional values may be graphed, but
the user must use the Begin button to start the modified graphing. The duration of the graph
window ranges from 15 minutes to 3 days.
Data is not stored - if you leave the Web page, the graph will be lost. You can open multiple Web
pages to view additional information, however each additional Web page browser will slow the
response from the GWAY-1100.
Download
This feature captures all data currently displayed in the graph and saves it to a .csv file or
displays it on a new Web page that allows you to manually save the data as a .csv file. The
download method is browser dependent.
1-Wire Device Details
To access details about the connected devices:
Choose the Advanced
menu and the Details sub-
menu. This will open the
Device Details screen.
The data is presented in two
groups:
1-Wire Communication in-
terface
Details for all connected
devices.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
15 / 35
Communications
Interface
The top of the screen shows information about the communication status between the
GWAY-1100, the 1-Wire devices as a group, and the Web browser:
Firmware Version—the version
of firmware currently operating in
the GWAY-1100
Devices Connected—the total
number of devices communi-
cating with the GWAY-1100
Device poll count—the number of times the GWAY-1100 has cycled through polling all
of the connected devices. The rate of polling depends upon the number of devices and
the specific device. Some 1-Wire devices refresh every second while others may do so
much faster (e.g., The DS18B20 causes a 900ms delay while waiting for the temperature
to be converted, whereas the DS2406 has no delay).
Loop time—the time, in seconds, it takes for the GWAY-1100 to cycle through polling all
of the devices and receive a response. As more devices are added, each individual de-
vice gets read less frequently since only a single device can be read at a time. This value
is useful for determining how frequently each sensor gets read.
Device Name—the programmable name given to the GWAY-1100 to distinguish one
GWAY-1100 from another.
Host Name—the name used by NBNS
MAC Address—This is the globally unique MAC address of the GWAY-1100
Connection status—the connection status between the GWAY-1100 and the Web
browser that is accessing the GWAY-1100 Network configuration page. If a connection er-
ror exists, the line will stop spinning.
Data activity—this light will flash green every time the browser receives a data push of
new values from the GWAY-1100. This is useful to know that the data feed is alive, even if
the values are not changing.
Enable auto update—check this box to enable the browser to update the Web page as
new data is received from the GWAY-1100. Uncheck the box if you would like to pause
the automatic refresh between browser and the GWAY-1100 to analyze information on
the screen. Note: if you leave this box unchecked, the Web page will not update with new
values automatically but the GWAY-1100 will continue to poll attached 1-Wire devices.
The bottom part of the screen displays information about each connected device. Because each
supported device may have different elements, they are not covered in detail in this manual.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
16 / 35
For those devices that have “programmable” elements (e.g., UserByte1 and UserByte2 in the
Programmable Resolution Thermometer example depicted above), you can click the “Write” but-
ton to specify a value.
All of the current sensor data is available for download at the details.xml link on the bottom of
the page.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
17 / 35
INTEGRATION
The GWAY-1100 provides a powerful set of tools to enable developers and network administra-
tors the ability to integrate the device (and data from connected 1-Wire devices) with existing
management and/or monitoring systems. The following are the network services supported by
GWAY-1100, accessible via TCP/IP:
HTTP—service provides delivery of html and xml data files via http get, a method of writ-
ing data to 1-Wire devices, the Web browser interface previously discussed and firmware
upgrading
SNMP—provides access to data from all connected sensors, and pushes SNMP traps to
remote listeners for alarming capabilities
Telnet—service provides login to monitor some of the GWAY-1100’s communication ac-
tivities for diagnostic purposes
UDP Broadcast—listener on port number 30303 will respond to properly formatted pack-
ets broadcast to this port number, allowing other devices and applications to discover
GWAY-1100s that exist on the same network.
1-Wire Interface—service provides a TCP client that implements a command / response
low level interface that may be used to directly control the 1-Wire bus
POST Client—provides a method of pushing XML data about connected 1-Wire devices
to a server.
HTTP
The HTTP mechanism enables programmers to utilize a GET command to retrieve various data
elements that are contained in an XML file as well as write data to 1-Wire devices that support
control functions.
The GWAY-1100 provides the following XML file for data retrieval:
Details.xml—this file provides detailed information on the GWAY-1100 and all connected
devices.
Retrieving XML File
To retrieve the XML file, simply access it by corresponding URL.
For example: “http://192.254.1.1/details.xml”
Once the file has been retrieved, it can be parsed according to the methods available to the de-
veloper in whatever programming language they are using.
Details.xml
The following is an example of the details.xml file:
<Devices-Detail-Response xmlns="http://www.wirelesssensors.com/schema/GWAY-1100"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<PollCount>85</PollCount>
<DevicesConnected>1</DevicesConnected>
<LoopTime>1.046</LoopTime>
<DevicesConnectedChannel1>0</DevicesConnectedChannel1>
<DevicesConnectedChannel2>0</DevicesConnectedChannel2>
<DevicesConnectedChannel3>1</DevicesConnectedChannel3>

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
18 / 35
<DataErrorsChannel1>0</DataErrorsChannel1>
<DataErrorsChannel2>0</DataErrorsChannel2>
<DataErrorsChannel3>0</DataErrorsChannel3>
<VoltageChannel1>4.83</VoltageChannel1>
<VoltageChannel2>4.85</VoltageChannel2>
<VoltageChannel3>4.76</VoltageChannel3>
VoltagePower>5.08</VoltagePower>
<DeviceName>OWServer_v2-Enet</DeviceName>
<HostName>GWAY-1100</HostName>
<MACAddress>00:04:A3:19:E9:ED</MACAddress>
<owd_DS18B20 Description="Programmable resolution thermometer">
<Name>DS18B20</Name>
<Family>28</Family>
<ROMId>7B0000030EBA4E28</ROMId>
<Health>7</Health>
<Channel>3</Channel>
<RawData>6E0107087FFF021032FF00000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000</RawData>
<PrimaryValue>22.8750 Deg C</PrimaryValue>
<Temperature Units="Centigrade">22.8750</Temperature>
<UserByte1 Writable="True">7</UserByte1>
<UserByte2 Writable="True">8</UserByte2>
<Resolution>12</Resolution>
<PowerSource>255</PowerSource>
</owd_DS18B20>
</Devices-Detail-Response>
Each “owd_xxx” element contains the device name (Name), family code (Family), ROM ID
(ROMId), health (Health), raw data used to obtain the data fields (RawData) displayed in hex
format, and a list of the data fields where the name of the data field provides the description.
Writing Data to 1-Wire Devices
To write data to a connected 1-Wire device that supports control commands simply make a re-
quest of devices.htm with the appropriate URL parameters. Below is an example:
devices.htm?rom=4300000200AD1928&variable=UserByte1&value=75
The URL parameters in the example are as follows:
rom—the ROM ID of the device to modify, alpha characters must be upper case
variable—the name of the variable to modify. The name is the same as the XML field
name, only XML fields with attributes of ‘Writable=”True”’ may be written, (e.g.,
<UserByte....)
value—the new decimal value to write to the 1-Wire device
Firmware Upgrading
Firmware may be upgraded using the link on the Network Configuration page. At the bottom,
under the heading “Controller Maintenance” is a link to upload new firmware. Follow the instruc-
tions to complete the process.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
19 / 35
Once firmware has been upgraded, the firmware support data must be updated. This link is di-
rectly below the firmware link on the Network Configuration page. For more information, see the
MAINTENANCE section of this manual.
SNMP (Simple Network Management Protocol)
Simple Network Management Protocol (SNMP) is a protocol commonly used to maintain net-
work equipment. Every piece of equipment in a network is described in its .mib file (Machine
Information Base file); Using an SNMP application, network administrators can monitor and
interact with equipment throughout the network.
The GWAY-1100-MIB file can be loaded into your SNMP program, making it available for man-
agement and machine-to-machine communication. It defines all available SNMP nodes availa-
ble, complete with a text description.
The file also contains text descriptions and explanations of the various OID functions.
This screenshot of the iReasoning
MIB Browser1shows the GWAY-
1100 .mib file loaded into the
SNMP interface and expanded to
display the 3 nodes—
edsEnterprise,dTrap and
owDevices, as shown below.
edsEnterprise Branch
The edsEnterprise branch presents
basic information such as name
and version.
dTrap Branch
The dTrap contains 2 tables used
to send traps based on preset con-
ditions. The 2 tables are the
dTrapTable and the
dTrapDeviceTable. The dTrapTable
contains information about where
to send the trap, the
dTrapDeviceTable defines when to
send the trap. The 2 tables are de-
picted in the diagram below.
1This application is available from the iReasoning website and is only used as an example. There is no affiliation of
any kind between Wireless Sensors and the creator of iReasoning.

Wireless Sensors, LLC
Ethernet Gateway Model GWAY-1100
Version 2.0 © July 2013
20 / 35
The dTrapTable defines where to
send traps. It has 2 rows, each
defining an IP address, communi-
ty string and enable flag. In order
for a trap to be sent, the IP ad-
dress must not be zero and the
enable flag must be one (zero
disables). The community string
is not used by the GWAY-1100,
except to send the string in the
trap PDU.
The dTrapDeviceTable specifies
the criteria for sending a trap. The
table has 7 rows that support 7
different traps. The rows of this
table are as follows:
odTrapDeviceEnable –
must be 1 to enable
sending traps, zero disables sending
odTrapSendPointer –may be 0 or 1. Points to the row of the dTrap table which
defines where to send the trap. Note that all data in the row in this table and
the corresponding row of the dTrap table must be valid for the trap to be sent.
odTrapDeviceROM –Stores the 1-Wire ROM ID of the device to base sending
traps on. To be valid, this value must not be zero and must match a ROM code
of a currently connected and active 1-Wire device.
odTrapDeviceVariable –Defines which variable of the 1-Wire device to base
calculation on. The value must refer to a valid variable or no trap will be sent.
The variable number can be determined by viewing the Advanced Details Web
page, each line below “PrimaryValue” is a potential variable, numbered se-
quentially. For example, the DS18B20 has as the first item below
“PrimaryValue” the item “Temperature”, so this is number 0. The next item is
“UserByte1”, so this is item 1, after that is “UserByte2”, which is item 2, then
item 3 is “Resolution” and item 4 is “PowerSource”.
DS18B20
0 –Temperature
1 –User byte 1
2 –User byte 2
3 –Resolution
4 –Power source
oThe items dTrapDeviceHighThreshold, dTrapDeviceLowThreshold and
dTrapDeviceHysteresis work together to define 3 windows.
The variable is in the high window when it is greater than the high
threshold