Point Six OneSix User manual

Users Guide
OneSix™ Server
Version 2.2
Copyright ©2004, Point Six, Inc.
Point Six, Inc
2333 Alumni Parkway
Suite 305
Lexington, KY 40517
USA
[phone]
http://www.pointsix.com

OneSix Server Help Contents xi
Contents
Overview 1
Quick Start .................................................................................................................................1
Description .................................................................................................................................2
Receivers....................................................................................................................................3
Device List .................................................................................................................................3
Polling ........................................................................................................................................4
Identification ..............................................................................................................................5
Filtering......................................................................................................................................5
What is DDE? ............................................................................................................................5
Using DDE with Microsoft® Excel ...........................................................................................6
Using DDE with Microsoft® Visual Basic ................................................................................6
Data Logging..............................................................................................................................7
Diagnostics.................................................................................................................................7
OneSix Main Window 8
Main Window.............................................................................................................................8
Setup ..........................................................................................................................................8
Change Port..................................................................................................................8
Add/Delete IP Connection ...........................................................................................9
View IP Connection Status ........................................................................................10
Outputs.......................................................................................................................11
Search and Add Devices ............................................................................................12
ReConfigure Net ........................................................................................................12
View DDE Variables................................................................................................................13
Errors........................................................................................................................................13
Tools ........................................................................................................................................13
Traffic ........................................................................................................................13
Quit ..........................................................................................................................................13
Help..........................................................................................................................................13
OneSix Server .INI File Format 14
onesix.ini ..................................................................................................................................14
SERVER ....................................................................................................................14
Logging......................................................................................................................15
IP Addesses................................................................................................................16
DIGITAL I/O.............................................................................................................16
TEMPERATURE Setup ............................................................................................17
HUMIDITY ...............................................................................................................18
DIGCOUNTER and Directional Counter ..................................................................19
CNTTEMP.................................................................................................................20
FASTCNTTEMP.......................................................................................................21
ALARMTEMP ..........................................................................................................22

ii xContents OneSix Server Help
Analog Input ............................................................................................................. 23
Access/Control Reader.............................................................................................. 24
Repeater .................................................................................................................... 24
Dual Discrete Output................................................................................................. 25
Wireless Analog Output ............................................................................................ 25
OneSix INI Backup ................................................................................................................. 27
OneSix Server DDE Variables 28
Using DDE Links .................................................................................................................... 28
Topic Names ........................................................................................................................... 29
Device Item Names ................................................................................................................. 30
Temperature .............................................................................................................. 30
Digital I/O: DIGITALn............................................................................................. 31
Humidity Probe: HUMIDITYn................................................................................. 32
DIGCOUNTER and Directional Counter: DIGCOUNTERnand DIRECTCNTn... 33
CNTTEMP: CNTTEMPn......................................................................................... 34
FASTCNTTEMP: FASTCNTTEMPn...................................................................... 34
ALARMTEMP: ALARMTEMPn............................................................................. 36
AnalogInput: AIn...................................................................................................... 37
Access/Control Reader: IDRn................................................................................... 38
Repeater: REPEATERn............................................................................................ 40
Dual Discrete Output: OUTPUTDISCn.................................................................... 41
Wireless Analog Output: OutputAnalogn................................................................. 42
Server Item Names .................................................................................................................. 43
OneSix Server Data Logging 45
Features ................................................................................................................................... 45
File Management..................................................................................................................... 45
File Format -Data Log ............................................................................................................ 46
File Format -Error Log ........................................................................................................... 47
TCP/IP Receivers 48
Overview of TCP/IP Receivers ............................................................................................... 48
Setting up to use TCP/IP Receivers......................................................................................... 48
Notes ....................................................................................................................................... 48
Using OneSix with Multiple Ports 50
Multiple Ports Overview ......................................................................................................... 50
Multiple Port Details ............................................................................................................... 50
Error Messages 51
Communication Errors ............................................................................................................ 51
No Devices Attached! ............................................................................................... 51
Error In Finding/Initializing Port. ............................................................................. 51
Cannot Open Communication Port; Already In Use. ................................................ 51
Cannot Find Receiver! .............................................................................................. 51
Cannot find and load lowlevel driver!....................................................................... 51
Runtime Errors ........................................................................................................................ 52
Communication Error: CRC16 or Time Out ............................................................. 52
Cannot Find Receiver................................................................................................ 52
OneSix Server Internal Error. ................................................................................... 52

OneSix Server Help Contents xiii
Corrections 52
Why Use Corrections ...............................................................................................................52
Correction IDs............................................................................................................52
Pre-defined Thermistor ..............................................................................................52
How to use Corrections ............................................................................................................53
Correction.INI file .....................................................................................................53
Predefined Corrections...............................................................................................54

OneSix Server Help Overview x1
Overview
Quick Start
When OneSix is run for the first time it displays this help screen. You may view this
help screen again by selecting "Help" from OneSix's main window.
OneSix is designed to gather data from sensors. OneSix makes available the data it
receives from each sensor through a DDE link.
The main OneSix™ Server window will show the total number of devices in the
startup list and how many of those that are online. The offline devices will be shown
in the list box at the bottom of the window.
OneSix™ can be a stand-alone data logger. When data logging is enabled, OneSix™
will store collected data in an ASCII file at a programmable interval. See section
"OneSix Server Data Logging".
This Help and all other Help topics may be accessed from the main window by
selecting Help or pressing F1.
Setup
xPlug the receiver into your serial port
xStart OneSix.
xIf necessary, tell OneSix what kind of Receiver you are using and what
COM port it is attached to.
xWhen the "Add Wireless Device" screen appears, press the service
mode button on your transmitter to transmit a packet that OneSix can
see.
xWhen a device appears in the window, you may click to select it and
then press the 'Edit' button to change its label name and transmit time.
xPress OK to add these sensors to the OneSix list and for OneSix to start
acquiring data.

2xOverview OneSix Server Help
If there is not an onesix.ini file or if [Server]NumberDevices 0 and when OneSix™
starts, it will automatically prompt for devices on the network and add them to its list
of devices to poll.
Description
OneSix™ is a data acquisition Dynamic Data Exchange (DDE) server that acquires
data from devices and passes this data using DDE to a client application. OneSix
waits for the device to transmit and then processes the transmission.
Any Windows® application that can use DDE can obtain this data from the
OneSix™ Server. Examples of such applications include Microsoft® Excel,
Wonderware® Intouch, National Instruments® LookOut and general development
applications like Microsoft® Visual Basic and Borland® Delphi.
OneSix™ can be a stand-alone data logger. When data logging is enabled, OneSix™
will also store collected data in an ASCII file at a programmable interval. Another
program such as a spreadsheet or a database manager can import the data. See
section "OneSix Server Data Logging".
OneSix Server can receive transmissions from wireless devices such as the wireless
temperature transmitter. Other devices include the wireless humidity sensor and
wireless analog input. OneSix uses a wireless receiver such as the Point Repeater,
Point Hostor PointView Receiver to receive transmissions from wireless sensors.
OneSix can also use multiple TCP/IP Receivers (Point Managers in Pass-Thru mode)
to receive data through TCP/IP connection.
On a wired network, OneSix repeatedly polls the devices on the network. On a
wireless network, OneSix waits for a transmission from the devices on the network.
When setting up a wireless network, OneSix passively waits for transmissions instead
of actively polling for devices. This can make the acquisition of sensors take a
longer time than for a wired network as OneSix must wait for the device to transmit.
You can speed up this process by pressing the service button on the device so that it
transmits while you are in the "Add Sensors" screen.
Each device has an entry in the device's INI file section. Each device has a
"repeateraddress" attribute. When running OneSix with a Point Repeater, the
Repeater ID is stored in the "repeateraddress" entry. The value in the
"repeateraddress" indicates which Point Repeater sent the sensor information With
all other wireless receivers, the "repeateraddress" is set to 0. OneSix must wait for a
transmission. Therefore, OneSix uses “polltime” to estimate how frequently a
transmission should come from a device. It also uses a multiples of this time to
determine if a device is offline. This multiples is configurable by the user.
If you are using a TCP/IP Receiver, please see the section TCP/IP Receivers for
more information on how to use this product.
Setup Described
OneSix will display the Setup screen when it starts for the first time. The setup
screen is the method by which OneSix acquires wireless devices. The default on the
setup screen is to accept only packets that are sent in service mode from the device
(the packet is sent by pressing the service button on the device.) To change this
default, uncheck the "Service Mode Only" checkbox. OneSix will then display all
the packets it receives. When OneSix receives a packet from a device new to it, it
names the device following the naming conventions detailed below, and it displays
the device's name and serial number in the window.

OneSix Server Help Overview x3
You have several options after the device has been displayed. The "Clear New"
button will clear all the devices that have just been received. The "Delete" button
will delete a single device. Click on a device to select it and click on "Delete" to
delete it. To edit a device click on the device to select it and click on "Edit" to edit
the device. There is also a "Stop" button. If you click that button, OneSix will stop
listing devices in the window. When you click on the "Stop" button it becomes a
"Receive" button. If you click on that, OneSix will start receiving packets and listing
devices again.
When you are ready, hit "OK", or "Cancel" to exit.
Edit Device
The Edit screen for a new RF device shows the device's serial number, which the
user cannot change, the device's current Label, which can be changed by the user,
and the Transmit Rate for the device. The Label cannot be the same as the label used
by any current device. The Transmit Rate is in seconds. The default value is 60.
OneSix uses the Transmit Rate to determine if a device has gone offline.
Receivers
The following is a list of the receivers that OneSix can use:
xPoint View Receiver
xPoint Host Receiver
xPoint Integrator Logger –select "Point Host Receiver" from the "Select
Communication Port" screen
xPoint Repeater and Repeater III –select "Point Host Receiver" and set
the TZR baud rate to 19,2000.
xTCP/IP Receiver (Point Manager in “Pass-Thru” mode)
Device List
OneSix™ Server interfaces to a large number of devices. New devices are
continually being created for Wireless network. Check with your distributor for the
latest.
The following is a list of devices supported by OneSix™ Server:
Point Sensor Temperature
Point Sensor Temp/Humidity
Point Sensor Analog 5V
Point Sensor Analog 10V
Point Sensor Analog 20mA
Point Probe
Point Sensor Pressure

4xOverview OneSix Server Help
Point Sensor DSCI
Point Sensor IR Counter
Point Sensor Thermistor
Point Sensor Counter Temperature
Point Sensor Fast Counter Temperature
Point Sensor Alarm Temperature
Point Access/Control Reader
Point Directional Counter
Point Dual Discrete Output
Point Analog Output
Polling
The polltime has a slightly different meaning for wireless sensors. OneSix does not
actively poll wireless devices. Rather, it waits to receive a packet from the devices.
Therefore, the polltime is how often OneSix expects to receive a packet from the
wireless devices.
The polltime for a wireless device is configurable during device setup. OneSix will
use this time to determine when to mark a device offline. OneSix has a INI file
parameter called "Tries" that sets how long a device has to transmit before it is
considered offline. For example, if the device has a polltime of 1 minute, and
OneSix has "tries" set to 3, then OneSix will consider the device offline if it does not
receive a packet from that device in 3 minutes ("tries" times "polltime").

OneSix Server Help Overview x5
Identification
OneSix™ identifies each device with a unique label name. A client application uses
this label (a DDE topic) to obtain data from the server.
Filtering
For both analog and temperature devices, OneSix™ allows the user to define a
deadband to control the amount of change that must occur before the server updates a
Client with new data. Deadband is useful to control the amount of information that is
passed through DDE to the client application. For analog devices, the deadband is
entered as the percentage of full scale of Engineering units. For temperature devices,
the deadband is entered in degrees C.
Also for both analog and temperature devices, One Six™ provides the means to filter
the data with either an Average, Median or combination Median Average filter
before either logging data or delivering data through DDE. In the One Six INI file,
you specify the filter type and the number of samples to filter.
What is DDE?
Dynamic Data Exchange (DDE) is a standard inter-application communication
protocol built into the Microsoft® Windows® operating system. It allows Windows®
programs that support DDE to exchange data between themselves. By simply
specifying an application, topic, and item, a client application can exchange data with
a server application. A DDE server is a program that has access to data and can
provide that data to other Windows® programs. A DDE client is a program that can
obtain data from a server.
To establish a link with a DDE server, there three pieces of information required:
Application: When you use a Microsoft® Windows® application to obtain data
from another Windows® application, you must provide the name of the application
you wish to respond to your data requests. Application names are sometimes called
service names.
Topic: Available Topics are determined by the Application. The application asking
for the data must choose an available topic or data exchange cannot take place.
Topics are general classifications with multiple data items.
Item: After the Application and Topic, the application must provide the specific
Item. The Item determines the data information related to an application topic.

6xOverview OneSix Server Help
Using DDE with Microsoft® Excel
Digital Input Example:
Application Name is: ONESIX
Topic is: Temp1
Item is: input
Example of what you would enter into an Excel® spreadsheet cell to read the
temperature OneSix™ Server.
ONESIX|Temp1!input
Analog Input Example:
Application Name is: ONESIX
Topic is: AI1
Item is: input
Example of what you would enter into an Excel® spreadsheet cell to read the value
of the analog input via OneSix™ Server.
ONESIX|AI1!INPUT
The easiest way to make a DDE Link in an Excel® cell is to use the Clipboard.
Click on the DDE Variables menu option in the main menu of OneSix DDE Server.
Select the information you want, press the Copy Link button and at Excel select the
cell you want the information to be displayed and then click on the Paste button.
Excel® will now show the linked data from the OneSix™ Server. See the section
"View DDE Variables" for more information.
Using DDE with Microsoft® Visual Basic
To create a link in Visual Basic to bring real time data from OneSix DDE Server into
a Visual Basic object, do the following: (The following example is used
'onesix|temp1!input'.)
1) Start the OneSix DDE Server and have it polling a device.
2) Place a Label, PictureBox, or TextBox on a Form.
3) Assign the LinkItem Property with the item name (ex: obj.LinkItem input)
4) Assign the LinkTopic Property with the application and topic names:
LinkTopic application|topic (ex: obj.LinkTopic onesix|temp1)
5) Assign the LinkMode Property to 1-Automatic (ex: obj.LinkMode 1)
The DDE link will be established and real time data should be displaying in the
display object.