Point Six Link Manager 4010-43 User manual

Point Six, Inc. |161 Prosperous Place |Suite 200 |Lexington, KY 40509
[phone] |[email protected] |[email protected] |www.pointsix.com
© 2014 Point Six, Inc. All rights reserved.
Version 1.5 – 12/5/2014
LINK MANAGERTM
Manual

Link Manager Manual Contents i
Contents
Introduction 5
Overview .............................................................................................................................5
Over the Air Sensor Data Collection .....................................................................................5
Link Manager Sensor Virtualization......................................................................................5
Link Manager Notes.............................................................................................................6
Quick Start Setup 8
Steps....................................................................................................................................8
Set Up Your Sensor Using the Point Sensor Utility..................................................8
Connecting the Link Manager.................................................................................9
Set Up Your Link Manager.....................................................................................9
Connecting the Link Manager 11
Overview: Connecting........................................................................................................11
Ethernet –TCP/IP ..............................................................................................................12
LAN Connection...................................................................................................12
Direct to PC..........................................................................................................13
Browser................................................................................................................13
Serial Port ..........................................................................................................................14
RS-485 Port........................................................................................................................14
Point Sensor Utility 15
Overview ...........................................................................................................................15
Set Up Point Sensor Utility.................................................................................................15
Point Sensor Utility Usage..................................................................................................16
Advanced Setup .................................................................................................................16
User Interface 18
Overview ...........................................................................................................................18
Main Menu.........................................................................................................................18
I/O Status...........................................................................................................................19
Sensor Setup ......................................................................................................................20
Setup Menu........................................................................................................................20
Manager Setup ...................................................................................................................21
Communications Setup.......................................................................................................22
Set Manager’s Clock ..........................................................................................................23
Automatic Time Update......................................................................................................23
Passwords Setup.................................................................................................................24
Activity Log.......................................................................................................................25
Usage Notes 26

ii Contents Link Manager Manual
Notes..................................................................................................................................26
Development Notes 28
Overview ...........................................................................................................................28
“I Am Here Packet”............................................................................................................28
Common Software Tools 30
Software.............................................................................................................................30
Discover Utility....................................................................................................30
PC Utilities and Tools...........................................................................................30
Link Manager Advanced Functions 31
Current I/O Readings..........................................................................................................31
Pass-Thru Mode .................................................................................................................31
Repeater Mode...................................................................................................................35
Support Functions ..............................................................................................................36
Discovery.............................................................................................................36
DHCP...................................................................................................................36
Factory Reset........................................................................................................36
Communicating with the Link Manager 38
Link Manager Protocol.......................................................................................................38
CRC16 Algorithm.................................................................................................39
Example C function..............................................................................................40
General information............................................................................................................41
Sensors.................................................................................................................41
Command Overview...........................................................................................................43
Command Syntax .................................................................................................43
Time representations.............................................................................................43
Future Compatibility.............................................................................................44
Command Outline..............................................................................................................45
Commands 47
A’ - Auto Add Mode command..........................................................................................47
‘C’ –Notify Setup..............................................................................................................51
‘CC’ –Configure/Read Clock.............................................................................................52
‘CCN’ – Configure Automatic Time Update.......................................................................54
‘CD’ – Configure/Read Link Manager Identification Label .................................................55
‘CI’- Configure/Read Link Manager Static IP Address........................................................56
‘CID’- Configure DHCP.....................................................................................................58
‘CIP’- Configure TCP/IP Ports ...........................................................................................59
‘CPD’ & ‘CPC’ – Configure Login Passwords....................................................................60
‘CR’ - Configure Radio .....................................................................................................61
‘CS’ - Configure/Read Sensor Setup..................................................................................63
Sensor I/O Point Setup..........................................................................................64
‘CT’ – Configure Media Ports.............................................................................................69
‘CTB’ – Set Simple Protocol ..............................................................................................70
‘CTC’ – Enable Command Processor..................................................................................71
‘CTF’ – Set CRC16 Protocol ..............................................................................................72
‘CTP’ – Set CRC16 Protocol Direct....................................................................................73
‘CV’ – Configure/Read Enumerated Engineering Unit Table...............................................75
‘CX’ - Set Media Repeater Modes .....................................................................................77

Link Manager Manual Contents iii
‘CYD’ – Configure UPD Pass-Thru Destinations................................................................79
‘CYP’ – Configure UDP Pass-Thru Parameters and Discovery............................................81
‘D’ - Get Last Data command............................................................................................83
‘EC’ – Clear Activity Log...................................................................................................86
‘ER’ – Read an Activity Log Record...................................................................................87
‘EU’ – Activity Log Usage.................................................................................................92
‘IC’ –Information Counts ..................................................................................................93
‘IIU’ – Information UDP Pass-Thru Destination .................................................................94
‘ILR’ – Current Sensor Log State........................................................................................95
‘ILT’ – Destination Sensor Table List.................................................................................96
‘IM’ – Media Information...................................................................................................97
‘IP’ – IP Address Settings...................................................................................................98
‘IPS’ – DHCP State Information.........................................................................................99
‘IT’ –Time Zone Information........................................................................................... 100
‘ITD’ – Daylight Savings Schedule................................................................................... 101
‘IU’ – Information Pass-Thru............................................................................................ 103
‘IV’ – Version Information............................................................................................... 104
‘IY’ – Information Synchronize the Clock......................................................................... 105
‘L’ – Login/Logout Commands......................................................................................... 106
‘PY’ – Attempt Automatic Time Update........................................................................... 107
‘S’ - Get Status Data Command....................................................................................... 108
‘U’ - Set Pass-Thru Mode................................................................................................ 109
‘UM’ - Set Pass-Thru Mode Direct .................................................................................. 111
‘V’ – Verbose................................................................................................................... 113
Error Codes 115
Overview ......................................................................................................................... 115
Error Code List................................................................................................................. 115
Appendix 117
Models............................................................................................................................. 117
Troubleshooting ............................................................................................................... 117
Sensor Issues...................................................................................................... 117
Delivery Issues to the Host Application............................................................... 118
Connection Issues............................................................................................... 118
UDP Packet Formats ........................................................................................................ 119
UDP Discovery Request ..................................................................................... 119
UDP Discovery Response................................................................................... 119
UDP PassThru & Wifi Sensor UDP Packet......................................................... 120
UDP Host Acknowledgement ............................................................................. 121
UDP Set Destination........................................................................................... 121
Reset Password ................................................................................................................ 122
Ethernet Firmware Download........................................................................................... 123
Overview............................................................................................................ 123
Preparation ......................................................................................................... 123
Procedure ........................................................................................................... 123
Specifications................................................................................................................... 125
Acknowledgements 126
Trademarks...................................................................................................................... 126
Glossary of Terms 127

4Introduction Link Manager Manual

Link Manager Manual Introduction 5
Introduction
Overview
The Link Manager is a data server designed to bridge 900 Mhz Point Sensors and a
host application listening on a TCP/IP network using the Extended Point Sensor
Protocol using UDP. The Link Manager collects data from the 900 Mhz Point
Sensors, both the beacon, configuration and the logged data, and maintains an image
of the beacon, configuration and logged data. The Link Manager then makes contact
with a host application using the same UDP protocol as used for the Wifi Point
Sensors and responds to host commands. The Link Manager at this point looks like
a Wifi Point Sensor. The Link Manager can support up to sixty (60) 900 Mhz Point
Sensors.
Over the Air Sensor Data Collection
The Link Manager communicates with the Point Sensor when the sensor sends a
beacon packet. The Link Manager then responds with additional commands
depending on if data log records need to be collected or setup information from the
sensor needs to be gathered. The Link Manager only collects new log records from
the sensor per conversation. The Link Manager collects the setup information when
the sensor indicates its setup has been changed locally (through the Point Sensor
Utility). The Link Manager conversation frequency is dictated by how often the
sensor sends the beacon packet (transmit period). If the Link Manager is holding
setup information sent from the host, the Link Manager will send the setup
information when the next packet is received from the sensor.
Link Manager Sensor Virtualization
The Link Manager will hold the log data and setup information for up to 60 sensors.
When communicating to a host, the Link Manager emulates a Wifi Point Sensor.
The Link Manager will send a sensor beacon packet to the host that starts the
conversation with the host. The Link Manager then responds to requests from the
host. To the host the Link Manager virtualized sensor appears like a Wifi Point
Sensor. The host can send setup information to the Link Manager which will be later
be forwarded to the 900 Mhz sensor.

6Introduction Link Manager Manual
The Link Manager will send a beacon packet to the host when the conversation with
the sensor has been completed. The Link Manager will continue to send a beacon
packet at a regular interval to the host until an acknowledgement response is received
from the host.
Link Manager Notes
Collects data log records and setup information from 900 Mhz Point
Sensors.
Holds data log records and setup information for up to 60 sensors.
Emulates sensors to the host application. Appears to the host application
like up to 60 Wifi Point Sensors.
The sensor needs to be registered with the Link Manager. (Like how
sensors are registered with Point Managers).
New setup information can be obtained from the sensor (when the setup has
been changed through the Point Sensor Utility).
The host can send setup information to the Link Manager. The Link
Manager will forward the setup information to the sensor when the next
beacon packet is sent from the sensor.
Conversations with the host are initiated when the Link Manager’s
conversation with the sensor is finished.
The Link Manager is fully configurable through a web browser. Use the
Discover tool to locate the Link Manager and then use your web browser to
configure the Link Manager and register sensors.
Each sensor has its own radio address based on the serial number. The
Point Sensor Utility is used to set this radio address.
Programmers can use the Link Manager’s command interface to change the
setup and check status.
Link Manager has additional functions link sensor packet PassThru and
radio repeater function.

Link Manager Manual 7

8Quick Start Setup Link Manager Manual
Quick Start Setup
Steps
Set Up Your Sensor Using the Point Sensor Utility.
1. Point Sensor Utility Setup:
a. Make sure the following line is set in the PointSensorUtility.INI
file in the section called [Settings]:
“XSCSerializeAddressEnable=1”.
b. In the Advanced Options (from the main menu select the Options /
Advanced Options), make sure the “Set radio address from serial
number” is checked.

Link Manager Manual Quick Start Setup 9
c. Set Up the Sensor:
i. Connect the USB Programmer interface to the sensor and
then click the Retrieve button in the Setup tab.
ii. From the Setup tab, set the Transmit Time (ex. 5
minutes), Tries (ex 4) and Log Period (ex 2 minutes).
iii. Click the Update button in the Setup tab to transfer the
settings to the sensor. Remove the USB Programmer
interface from the sensor when finished.
Connecting the Link Manager
1. Connect Antenna. Depending on your specific unit, thread the supplied
antenna(s) to the antenna connector(s) to the Link Manager
2. Connect Ethernet Cable. Connect an RJ-45 cable to the Link Manager and
to your network. Your network must have a DHCP Server that will assign
an IP address to the Link Manager. See the section “Ethernet – TCP/IP”, if
your network does not have a DHCP Server. The green light will light if
there is an active Ethernet connection.
3. Connect the Power Supply. Connect the provided power supply to the Link
Manager. When power is applied, the Link Manager will turn on the red
power light. The red light indicates that the Link Manager is functioning.
It may take a few seconds before the power light is turned on. The Link
Manager also uses the red power light to indicate reception of a packet from
a Point sensor. The Link Manager will blink the red light momentarily
indicating a packet has been received and processed.
4. Run the Discover program to find the Link Manager on your network. Run
the Discover program from a computer that is on the same subnet as the
Link Manager.
5. From the Discover program, double click the Link Manager entry to bring
up the Link Manager web page.
Set Up Your Link Manager.
1. At the Link Manager’s web page, select the Setup menu option and then
select the Manager Setup menu option.
2. Enter a name for a Link Manager.
3. In the Add Sensors field, select “Service Mode for 20 minutes”.
4. Enter a Destination Address. This is the address of the computer running
the host application. The address can be an IP address or a hostname.
5. Click the Submit button to save and apply the settings.
Register the Sensors With the Link Manager.
1. Navigate to the Link Manager I/O Status page.
2. Press the service button (or use magnet) on the Sensor.
3. Wait up to 15 seconds or press Refresh on you browser. The Sensor will be
listed in the I/O Status page. If you click on the default name of the sensor,

10 Quick Start Setup Link Manager Manual
the Link Manager will present you a screen to change the sensor name. The
Link Manager will start collecting the sensor’s log data. This may take up
to 2 minutes to complete. Additional sensors can be registered after the
sensor’s log data is collected.
4. Press the service button on the sensor and examine the host application to
determine the Link Manager is sending sensor data to the host application.
If the sensor’s log buffer is full, it will take a few minutes for the Link
Manager to collect all the sensor data before sending to the host application.
You view the progress of the collection from the I/O Status page.

Link Manager Manual Connecting the Link Manager 11
Connecting the Link Manager
Overview: Connecting
The Link Manager has four communication ports: Ethernet-TCP/IP, built-in 900/2.4
Mhz/Ghz Radio an RS232 serial port and an RS485 port. The Link Manager will
respond to commands or receive sensor packets on all ports Before using the Link
Manager, you should carefully evaluate the communication resources available at the
site where the Link Manager will be installed. Typically just the Ethernet and 900
Mhz ports are used.
Ethernet Link
Power & Activity

12 Connecting the Link Manager Link Manager Manual
Ethernet –TCP/IP
LAN Connection
Check with your network administer before connecting the Link Manager to a
LAN.
Dynamic IP Address
By default the Link Manager is capable of being assigned an IP address
automatically by the network if the network has a DHCP Server. Connect the Link
Manager using a straight through Ethernet cable to the LAN. Connect power to the
Link Manager. If the ‘Ethernet Link’ light is on, then the Link Manager is connected
physically and electrically to the LAN.
The next task is to obtain the IP address assigned to the Link Manager. Run the
Discover utility that came with your Link Manager (or obtain the utility from your
dealer). Using the Discover utility, note the IP address for this Link Manager. To
view the Link Manager's web page using the Discover tool, right click over the Link
Manager entry and then select "Browse" from the pop menu. The Discover utility
will start the browser and point it to the Link Manager's web page.
Another method to finding the IP address is to connect via the serial port with your
PC. Follow the instructions as described in the section that follows called "Serial
Ports" and issue the "IP" command.
Power Connection
Ethernet Port
Serial Port
Reset
418/433 Mhz Receiver
900 Mhz/2.4 Tranceiver
RS-485 Port

Link Manager Manual Connecting the Link Manager 13
Static IP Address
In order for the Link Manager to communicate TCP/IP, it needs an IP address,
network mask, and possibly a gateway address. You may need to consult with your
network administrator to determine these parameters. Chances are you will have to
change the Link Manager’s default IP address: IP address 192.168.1.55, network
mask 255.255.255.0, no gateway address and port 1000 and turn off dynamic IP
address mode. You can change these settings using the "CIDS" and “CIS”
commands through any of the communications ports. If you need to use the Ethernet
port to change these settings see the next section “Direct to PC”.
Example
Command: <^B>CIDSF,F<CR>
Response: <^B>CIDSF<CR>
Remarks: turn off dynamic IP mode.
Command: <^B>CIS192.168.1.46,255.255.255.0,192.168.1.200<CR>
Response: <^B>CIS192.168.1.46<CR>
Remarks: set IP address to “192.168.1.46”, subnet mask
to”255.255.255.0” and gateway to “192.168.1.200“.
<^B> is STX (02H). Press Ctrl and B using a terminal emulation program.
<CR> is 0DH. Press Enter using a terminal emulation program.
Connect your Link Manager through its Ethernet port to the LAN with a standard
(non-crossover) Ethernet cable. The ‘Ethernet Link’ light will turn on indicating a
valid Ethernet physical connection. To test if the connection is valid and the Link
Manager is set up properly, use the Ping utility on your computer and ping the Link
Manager’s IP address. Use your Internet browser to view the Link Manager web
page. You can also use the Discover tool to locate the Link Manager if you do not
know its IP address.
Direct to PC
The Link Manager can be connected directly to a computer through the Ethernet port
by a network cable. You may need to change the TCP/IP settings on your PC and/or
the settings in the Link Manager. If the Link Manager's address cannot be
automatically assigned, the Link Manager will default to address 192.168.1.55,
subnet mask of 255.255.255.0 and port 1000. You will need to set the computer’s
address to an address on the Link Manager’s subnet or change the Link Manager’s
address to match the computer’s subnet mask. To change the IP settings on a
computer running the Windows operating system, follow these steps: select the
following ‘Control Panel -> Network -> TCP/IP’; select the TCP/IP service for your
network card; choose ‘Properties->IP Address’; choose ‘Specify an IP Address’
(example: 192.168.1.40 255.255.255.0); and fill in the initial values for subnet
mask and IP address. View the LAN connection status or run IPCONFIG to verify
changes. When finished changing the IP address and connecting the computer to the
Link Manager, use the Ping utility on your computer and ping the Link Manager to
verify your settings and connection. Use your Internet browser to view the Link
Manager web page.
Note: If your Link Manager has been assigned a dynamic IP address on a previous
network and then is moved to a network that does not have a DHCP server, it will
remain at the last assigned IP address, not revert back to 192.168.1.55.
Browser
Once you have your Link Manager connected and configured for TCP/IP
communications, start the browser on your computer and enter the Link Manager’s
IP address where you would normally enter an URL (Ex. Address: 192.168.1.55). If

14 Connecting the Link Manager Link Manager Manual
you have successfully made the connection, your browser should show the title
“Link Manager” and a header row for the sensor table with no sensors.
Serial Port
The Link Manager has an external serial port so it can be connected to receiver or a
PC. The serial port can receive packet information from a receiver or receive
commands and send responses. The serial port is an RS232 DTE device and
requires a NULL modem cable to connect to a computer. Link Manager uses RS232
communication parameters of 19200 baud, 8 data bits, 1 stop bit and no parity.
The Link Manager does not use RS232 handshaking lines. If connecting to a PC
through a NULL modem, it is best to turn off handshaking mode in your
communication program.
RS-485 Port
The RS-485 Port is used to connect RS-485 wired sensors (2 wire). These sensors
can be multi-dropped (more than one sensor connected to the RS485 port). Link
Manager provides optional power through the RS485 connector. The
communication parameters for the port are 19200 baud, 8 data bits, 1 stop bit and
no parity. The following shows the connector pin out:
Pin
Description
RX+
+ communication signal
RX-
- communication signal
Gnd
Ground
PWR
Optional output power to power sensors.
9 Volts DC, 100 milliamps maximum
Commands can be sent and response received through the RS-485 port using the
CRC16 protocol.

Link Manager Manual Point Sensor Utility 15
Point Sensor Utility
Overview
The sensor must be configured in order to be used with the Link Manager. The Point
Sensor Utility is used to configure the sensor.
Set Up Point Sensor Utility
Point Sensors must use a special addressing mode for use with the Link Manager.
The Point Sensor Utility must be set up to configure the sensor to use the addressing
mode.
In the Point Sensor Utility’s setup file, add the following settings paramter to enable
the special addressing mode. In the Point Sensor Utility , go to the Help menu and
then select “Utility Folder Paths” and then “Explore Setup”. The utility will open a
text editor showing the Point Sensor Utility settings. Add the line
“XSCSerializeAddressEnable=1” to the [Settings] section. Here is an example:
[Settings]
QuickHelp=0
DebugLog=1
XmitPeriodOverride=0
DHCPCache=0
ARPCache=0
DNSCache=0
ConnectWindow=5.0
WLanRate=15
DestPortOverride=0
XSCSerializeAddressEnable=1
Save the changes and then restart the Point Sensor Utility.
Go to the Advanced Options Window (from the main menu select “Options” and
then “Advanced Options”) and check the box “Set radio address from serial number”
and click OK

16 Point Sensor Utility Link Manager Manual
Set the utility to use the Digi XBee 900 radio. From the main menu, select Options
and Radio Type. Select “Digi Xbee 900/2.4”.
Point Sensor Utility Usage
Connect the USB Programming interface into the sensor and then from the Setup tab
click on the Retrieve button to retrieve the sensor’s settings.
From the Setup tab, set the Transmit Period, Tries, Logging Period, Alarms and the
ID Info.
Click the Update button (in the Setup tab) to update the sensor with the latest settings
and also set the special addressing mode for the sensor radio.
Disconnect the USB Programming interface. The sensor is now ready to be used
with a Link Manager.
Advanced Setup
You may need to set the Point Sensor to use another radio Hop Table under the
following circumstances:
1. Having interference issues using the default Hop Table (3).
2. Have more than one Link Manager within radio range and want to isolate
the radio networks between Link Managers.
To change the Hop Table number, in the Point Sensor Utility , go to the Help menu
and then select “Utility Folder Paths” and then “Explore Setup”. The utility will
open a text editor showing the Point Sensor Utility settings. Add the line
“XSCSNHopTable=n” to the [Settings] section where “n” is a number from 0 to 6.
Here is an example:

Link Manager Manual Point Sensor Utility 17
[Settings]
QuickHelp=0
DebugLog=1
XmitPeriodOverride=0
DHCPCache=0
ARPCache=0
DNSCache=0
ConnectWindow=5.0
WLanRate=15
DestPortOverride=0
XSCSerializeAddress=1
XSCSerializeAddressEnable=1
XSCSNHopTable=6
Save the changes and then restart the Point Sensor Utility.
The Link Manager must be set to the same Hop Table.

18 User Interface Link Manager Manual
User Interface
Overview
From the Link Manager web pages, the Link Manager can be configured to manage
sensors and send data to the host application.
Main Menu
The main menu allows access to the I/O Status, Setup and Activity Log web pages.
The Link Manager also shows the name given to the Link Manager, the current time
of date set in the Link Manager’s clock along with the time zone offset. The Link
Manager also shows various states and conditions.
The Link Manager shows the current sensor and the number of log records being
collected.
The Link Manager shows how many seconds remain for adding sensors to the Link
Manager through the AutoAdd mechanism.