EDS OW-SERVER-ENET-2 User manual

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Embedded Data Systems
OW-SERVER-ENET-2
OW-SERVER-ENET-2 Operation Manual
Rev 2.0

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Table of Contents
OW-SERVER-ENET-2 Operation Manual .................................................................................................. 1!
Table of Contents.................................................................................................................................... 2!
Introduction ............................................................................................................................................. 3!
QUICK START GUIDE ............................................................................................................................... 4!
INTERFACE................................................................................................................................................ 5!
Physical................................................................................................................................................... 5!
USB......................................................................................................................................................... 5!
Web......................................................................................................................................................... 5!
Programmatic.......................................................................................................................................... 6!
CONFIGURATION...................................................................................................................................... 8!
Network Configuration ............................................................................................................................ 8!
POST Client Configuration.................................................................................................................... 10!
1-Wire Configuration ............................................................................................................................. 10!
USB....................................................................................................................................................... 11!
WEB ACCESS TO DATA ......................................................................................................................... 12!
Home Page ........................................................................................................................................... 12!
Individual Sensor Selection................................................................................................................... 14!
1-Wire Device Details ........................................................................................................................... 15!
Communications.................................................................................................................. 16!
Interface............................................................................................................................... 16!
INTEGRATION ......................................................................................................................................... 18!
HTTP..................................................................................................................................................... 18!
Retrieving XML File ............................................................................................................. 18!
Writing Data to 1-Wire Devices ........................................................................................... 19!
Firmware Upgrading ............................................................................................................ 20!
SNMP (Simple Network Management Protocol)................................................................................... 20!
edsEnterprise Branch .......................................................................................................... 20!
dTrap Branch....................................................................................................................... 20!
Telnet................................................................................................................................... 23!
UDP ...................................................................................................................................................... 24!
Low Level 1-Wire Interface ................................................................................................................... 26!
POST Client .......................................................................................................................................... 26!
MAINTENANCE........................................................................................................................................ 27!
Firmware and Support Files Upgrade................................................................................................... 27!
Factory Reset........................................................................................................................................ 29!
ADDITIONAL RESOURCES .................................................................................................................... 30!
Supported 1-Wire Devices .................................................................................................................... 30!
OW-SERVER-ENET-2 Form Factor ..................................................................................................... 31!
Power Supply Requirements ................................................................................................................ 31!
Ethernet Interface ................................................................................................................................. 31!
1-Wire Interface .................................................................................................................................... 31!
Power Supply Schematic ...................................................................................................................... 32!
1-Wire Interface Schematic................................................................................................................... 33!
Specifications........................................................................................................................................ 33!
EDS Appliance Scanner Software ........................................................................................................ 33!
Support ................................................................................................................................................. 33!
REGULATORY COMPLIANCE ................................................................................................................ 34!
ACKNOWLEDGEMENTS ......................................................................................................................... 34!
APPENDIX A ............................................................................................................................................ 35!
Low Level 1-Wire Communication Protocol.......................................................................................... 35!

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Introduction
Thank you for purchasing the Embedded Data Systems OW-SERVER-ENET-2. The OW-
SERVER-ENET-2 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 facili-
ties.
The Embedded Data Systems OW-SERVER-ENET-2 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 OW-SERVER-ENET-2
•Interface—this section describes the three interfaces (physical, web, and programmatic)
to the OW-SERVER-ENET-2
•Configuration—this section provides information on how to setup a OW-SERVER-
ENET-2 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 OW-SERVER-ENET-2
with existing systems and applications. This section is aimed at software programmers
and engineers who want to interface directly to the OW-SERVER-ENET-2
•Maintenance—this section covers various activities related to maintaining or upgrading
the OW-SERVER-ENET-2
•Additional Resources—this section provides links to other resources, how to get sup-
port, and frequently asked questions

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
QUICK START GUIDE
Getting started with the OW-SERVER-ENET-2 is simple. Just follow a few easy steps:
1. Apply power to the OW-SERVER-
ENET-2. The green PWR/ACT LED
will begin to flash at one-second in-
tervals, indicating that the product is
operating normally. Power must be 5
volts at 400 milliamp (minimum).
2. Connect it to your Network. Con-
nect a live network cable to the
Ethernet Port on the device. The green LED on the Ethernet connector will illuminate, in-
dicating a valid network connection. The yellow LED on the Ethernet connector blinks on-
ly 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 OW-SERVER-ENET-2 by checking your DHCP server
logs or using EDS Appliance Scanner Software1available from the EDS website. If the
OW-SERVER-ENET-2 does not find a DHCP server running on your network, it will de-
fault to the following IP address: 169.254.1.1.
5. Configure your device. Type the IP address of the OW-SERVER-ENET-2 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 requested, enter “admin” for the name and “eds” for
the password. A Web page similar to the one shown to the right will enable you to config-
ure and monitor various aspects of
your OW-SERVER-ENET-2.
CONGRATULATIONS! You have
successfully installed your Embed-
ded Data Systems’ OW-SERVER-
ENET-2. Please refer to the Web
Access section of the Operation
Manual to obtain an understanding
of the function of each of the Web
pages served by the OW-SERVER-
ENET-2.
Some things to keep in mind:
•The OW-SERVER-ENET-2 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.
•See section Additional Resources or EDSPRODUCTS.COM for a list of supported 1-Wire devices.
•No support is provided for OW-SERVER-ENET-2 IP address identification when utilizing any method other
than the EDS Appliance Scanner Software. Please consult your network administrator if you cannot locate
the DHCP address.
1http://short.eds.bz/apps-scanner

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
INTERFACE
The OW-SERVER-ENET-2 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 OW-SERVER-ENET-2 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 network settings. See section
Configuration/USB
•Ethernet: connects the device to an ex-
isting 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 OW-SERVER-ENET-2 includes an integrated Web-server that provides access to moni-
tored data from any Internet connected device such as a Web browser on your PC, smartphone,
or even an iPad®!
The Web interface provides you an easy way to configure the network setting for the OW-
SERVER-ENET-2 and is accessible by navigating to its IP address. When you connect the OW-
SERVER-ENET-2 to your network it will automatically 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 configuration section below.
Simply open a Web browser and enter that IP
address to access the Web monitoring appli-
cation.
The Web interface provides the following
menu items:
•Home—the default, opening screen
that provides a snapshot of all connect-
ed devices, graphing of one value for
all connected devices and OW-
SERVER-ENET-2 basic information

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
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 OW-SERVER- ENET 2
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 OW-SERVER-ENET-2 by your
network, simply access your DHCP’s assignment or download the EDS Appliance Scanner
Software that will automatically find and display the IP address for any OW-SERVER-ENET-2 on
the network. For more information about the EDS Application Scanner software, see section Ad-
ditional Resources.
Note: If your network does not have a DHCP server, the OW-SERVER-ENET-2 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 OW-SERVER-
ENET-2 in order to talk to the device for the first time. Only when the OW-SERVER-ENET-2 is in
the same address space as your other computers can you access it using a eb browser.
Programmatic
Through a number of different channels, you can access the OW-SERVER-ENET-2 program-
matically 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 OW-SERVER-
ENET-2 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 any
OW-SERVER-ENET-2 that exists on the same network. For assistance in determining
the units IP address, see the section Additional Resources regarding EDS Appliance
Scanner Software
•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

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
•POST Client—provides a method of pushing XML data about connected 1-Wire devices
to a server; ideal for circumventing firewall issues

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
CONFIGURATION
Any configuration of your OW-SERVER-ENET-2 (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 at-
tached supported 1-Wire devices. The USB port provides a way to configure the network set-
tings.
To access the configuration elements,
•Navigate to the IP Ad-
dress your network has
assigned to the OW-
SERVER-ENET-2. This
will open the Web inter-
face.
From the default Home screen,
you can access the System Con-
figuration 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 OW-SERVER-
ENET-2 operations within your network.
Note: In order to access this portion
of the Web tool, you will need a
username and password. The facto-
ry default settings are: user name =
“admin”, and password = “eds” (all in
lower case.)
You can configure the following as-
pects of the OW-SERVER-ENET-2:
•Device name—the factory
default is OWServer_v2-Enet.
However this is a user defin-
able name, maximum 24
characters. 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.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
•User name—this is the user name, case-sensitive maximum 12 characters, used to ac-
cess the configuration sections of the on-board Web tool and the Telnet interface. Upper-
case and lowercase Alphanumeric Characters permitted. The factory default is "admin".
•Password—this is the password used to access the configuration sections of the on-
board Web tool and the Telnet interface. Uppercase and lowercase Alphanumeric Char-
acters permitted. The factory default is "eds".
•Password—confirm the password entered in the previous password field.
•Host Name—the factory default name for the OW-SERVER-ENET-2 is EDSOWSERV-
ER2. You can change the name but it is limited to 16 UPPERCASE characters. This field
is also included in the XML file.
•Enable DHCP—check this box to automatically enable the OW-SERVER-ENET-2 to re-
ceive 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 set-
ting of the device. If you elect NOT to enable DHCP, you must manually provide network
adapter settings 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 op-
tional
oHTTP Port—the port through which the OW-SERVER-ENET-2 will listen for in-
coming 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:
•IP Address: 169.254.1.1
•Gateway: 169.254.1.1
•Subnet Mask: 255.255.0.0
•DNS: 169.254.1.1

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
POST Client Configuration
The POST Client Configuration page of the Web tool allows you to configure the POST Client
and Proxy features of the OW-SERVER-ENET-2.
To configure POST Client
•Enable the feature by click-
ing the check box
•Select the URL of the
HTTP POST server. This
field requires a fully quali-
fied URL and may include
an alternate port number.
This example sets the port to 12391:
“http://www.embeddeddatasystems.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 al-
lows you to configure the 1-
Wire interface on the OW-
SERVER-ENET-2.
At this time, the only configu-
ration setting allowed is to enable direct TCP communication with the 1-Wire bus. This allows
you to send commands directly to 1-Wire devices connected to the system. It is ideal for solu-
tions developers looking to integrate the OW-SERVER-ENET-2 with 1-Wire devices not current-
ly 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

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
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 OW-SERVER-ENET-2 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 OW-SERVER-ENET-2 from the computer's USB
port. Apply power using the wall transformer and the OW-
SERVER-ENET-2 will power up with the new network set-
tings.
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.
Note: The USB port cannot be
used to determine the current
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 desired IP address.)

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
WEB ACCESS TO DATA
The OW-SERVER-ENET-2 provides a robust, on-board, Web-based tool to access connected
1-Wire devices from any Web browser—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 OW-
SERVER-ENET-2. This will open
the Web interface.
Home Page
From the default Home page you can:
•View OW-SERVER-ENET-2
Summary data
•View basic 1-Wire Device infor-
mation
•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 OW-SERVER-
ENET-2
•Loop time—the time, in seconds, it takes for the OW-SERVER-ENET-2 to cycle through
polling all of the devices and receive a response. As more devices are added, each indi-
vidual device 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 OW-SERVER-ENET-2 has polled 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)
•Supply Voltage—the voltage being supplied to the OW-SERVER-ENET-2
•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

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
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 OW-SERVER-ENET-2 automatically scans the 1-Wire bus in the
following order:
•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 OW-
SERVER-ENET-2 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 OW-SERVER-ENET-2.
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.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Download
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 associat-
ed with the sensing device. Sensors with many variables will have some hidden, so the More
button may be used to view the extended list of variables.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Device Data
The top part of the screen displays information about each connected device. Sliding the cursor
over and selecting a programmable value allows users to assign a limit, change a function or
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 man-
ual.
Graph
The opening screen of the Individual Sensor Selec-
tion will begin graphing the value Temperature automatically with 15-minute display duration.
Two additional values may be graphed, but the user must use the Begin button to start the modi-
fied 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 OW-SERVER-ENET-2.
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.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
Communications
Interface
The top of the screen shows information about the communication status between the OW-
SERVER-ENET-2, the 1-Wire devices as a group, and the Web browser:
•Firmware Version—the version of firmware currently operating in the OW-SERVER-
ENET-2
•Devices Connected—the
total number of devices
communicating with the
OW-SERVER-ENET-2
•Device poll count—the
number of times the OW-
SERVER-ENET-2 has cy-
cled 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 OW-SERVER-ENET-2 to cycle through
polling all of the devices and receive a response. As more devices are added, each indi-
vidual device 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 OW-SERVER-ENET-2 to distin-
guish one OW-SERVER-ENET-2 from another.
•Host Name—the name used by NBNS
•MAC Address—This is the globally unique MAC address of the OW-SERVER-ENET-2
•Connection status—the connection status between the OW-SERVER-ENET-2 and the
Web browser that is accessing the OW-SERVER-ENET-2 Network configuration page. If
a connection error 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 OW-SERVER-ENET-2. 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 OW-SERVER-ENET-2. Uncheck the box if you would like
to pause the automatic refresh between browser and the OW-SERVER-ENET-2 to ana-
lyze information on the screen. Note: if you leave this box unchecked, the Web page will
not update with new values automatically but the OW-SERVER-ENET-2 will continue to
poll attached 1-Wire devices.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
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.
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.

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
INTEGRATION
The OW-SERVER-ENET-2 provides a powerful set of tools to enable developers and network
administrators 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 sup-
ported by OW-SERVER-ENET-2, 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 OW-SERVER-ENET-2’s commu-
nication activities 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
OW-SERVER-ENET-2s that exist on the same network.
•1-Wire Interface—service provides a TCP client that implements a command / re-
sponse 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 OW-SERVER-ENET-2 provides the following XML file for data retrieval:
•Details.xml—this file provides detailed information on the OW-SERVER-ENET-2 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.
Java based examples are available online at http://short.eds.bz/javacode.
Details.xml
The following is an example of the details.xml file:
<Devices-Detail-Response xmlns="http://www.embeddeddatasystems.com/schema/owserver"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<PollCount>85</PollCount>
<DevicesConnected>1</DevicesConnected>
<LoopTime>1.046</LoopTime>

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
<DevicesConnectedChannel1>0</DevicesConnectedChannel1>
<DevicesConnectedChannel2>0</DevicesConnectedChannel2>
<DevicesConnectedChannel3>1</DevicesConnectedChannel3>
<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>EDSOWSERVER2</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., <Us-
erByte....)
•value—the new decimal value to write to the 1-Wire device

Embedded Data Systems, LLC; 2019 Fortune Dr., Lawrenceburg, KY 40342; Phone/Fax [phone] / 37
EN-USERMAN OW-SERVER-ENET-2 V2.0 12.20.12
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.
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 In-
formation Base file); Using an SNMP application, network administrators can monitor and inter-
act with equipment throughout the network.
The OW-SERVER-ENET-2-MIB file can be loaded into your SNMP program, making it available
for management and machine-to-machine communication. This file is available from the EDS
OW-SERVER-ENET-2 product page under the DOWNLOADS tab. It defines all available SNMP
nodes available, 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 OW-
SERVER-ENET-2 .mib file loaded
into the SNMP interface and ex-
panded 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 dTrapDevice-
Table. The dTrapTable contains
information about where to send
the trap, the dTrapDeviceTable de-
fines when to send the trap. The 2
tables are depicted 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 Embedded Data Systems and the creator of iReasoning.