EasyIO Tcom Service v1.

EasyIO Sedona Controllers withTcom Service

Version 1.2

EasyIO Tcom Service v1.2

Document Change Log

15thMay 2012
Document created.
3rd Oct 2013
Added in niagara integration guide with tcom.jar
Tcom.jar is by Maxline solution.
13th March 2014
Minor changes in the structure.

EasyIO Tcom Service v1.2

Disclaimer
EasyIO FG Series is a product by EasyIO HoldingsPte Ltd
The EasyIO FG Series was built on the Sedona Framework .
EasyIO 30P is a product by EasyIO HoldingsPte Ltd
The EasyIO 30P was built on the Sedona Framework .
Sedona Framework is a trademark of Tridium, Inc.
Tcom Niagara driver is a driver develops by Maxline Solution.
Niagara AX Framework is a trademark of Tridium, Inc.

EasyIO Tcom Service v1.2

Contents
Introduction ............................................................................................................................................ 5
EasyioTcom ............................................................................................................................................. 6
TcomService ........................................................................................................................................ 6
Configuring Tcom service in Sedona apps. ............................................................................................. 7
Override writable points via Tcom driver in Niagara station. ................................................................. 9
EasyIO 30P......................................................................................................................................... 10
EasyIO FG Series ................................................................................................................................ 12
Technical Support ................................................................................................................................. 14

EasyIO Tcom Service v1.2

Introduction
Tcom niagara driver is used with any Sedona controller. Tcom driver is by Maxline Solution.
Tcom.jar utilizesport UDP 5021.
Below are the TcomNiagara driver features:
Add on the capability to discover the Sedona devices, in order to use this capability, the
Tcom.kit 1.0.45.1 or higher must be installed in the Sedona Controller. The JACE also has to
be installed with the Tcom.jar
Added the clock synchronization from JACE to the Sedona Controller. Theupdate interval can
be user defined by daily, internal or manual. This can also be executed from the action
command.
Solved the issue of points change of value (COV) subscribe automatically when the device is
up from down, lost connection or etc.
Solved the issue of COV not updating.
Device COV policy been updated and enhanced.
Error will occur if there is a duplication of COV subscription.
Solved the issue missing manifest file, the driver will automatically download
fromhttp://sedonadev.org and http://www.easyio.com; this only can work when the JACE
or PC has the connection to the internet.
Fixed the issue for multiple Sox session connections to the Sedona controller. So it will be
only one (1) session connection to process discover, read, write, COV and history import.
Reliable history polling from the EasyIO Sedona controller into JACE.
Added Tcom driver communication monitoring.

EasyIO Tcom Service v1.2

EasyioTcom
This kit contains 1 object. The objects are to be used for engineer the Sedona apps. This tcom service
is for Sedona protocol integration with Tcom Driver.
To use these objects just drag and drop into the wire sheet.

TcomService
TomServiceis an object use to integrate a Sedona controller with Niagara station via Sedona
protocol with Infocon Tcom driver.
The property sheet of the object is shown below

Port
Port that uses to communicate between Niagara Station and a sedona controller.
By default is 5021. It is user editable.
DO NOT use 1876 as this is occupied by the sox protocol.
Events Per Sec
A read only property. It will only handle 30 events per second and it is queue if
there are more events. This will minimize the Tcom driver load and controller
load during the integration.
Client Connected
A read only property.
Show total number of client connected to the Sedona controller.
Comm lost state
This property is a Boolean property where it monitors the Tcom protocol time
out.
This property can be used as comm. monitoring where user can switch to local
standalone schedule whenever the Sedona controller comm. time out.
Com Lost Interval
This is the comm. monitoring interval check.
By default is 60 seconds.

EasyIO Tcom Service v1.2

Configuring Tcom service in Sedona apps.

Below are the steps to configure Tcom service
Step 1
Connect to the controller with Sedona Workbench.
Default login credentials are as below;
EasyIO 30P
IP address: 192.168.10.10
Username: admin
Password:<no password>
EasyIO FG Series
IP address : 192.168.10.11
Username : admin
Password :<no password>
For later version of FG Series firmware, tcom service is preinstalled (V2.2.2.0.05 and above).
Manage kits to install easyioTcom into your controller

Step 2
Choose easyioTcom from Sedona Palette
Drag & drop TcomServ into your App. Tcom Service object must be under the Service folder.

EasyIO Tcom Service v1.2

Step 3
You are now ready for Tcom driver integration.

EasyIO Tcom Service v1.2

Override writable points via Tcom driver in Niagara station.

This user guide only shows overriding a writable point with the build in actions.
The build in actions are our collaboration with Maxline Solution the Tcom driver developer.
The actions in Niagara station are tie to the Sedona object 16 priority inputs.
The below explain both the EasyIO 30P and EasyIO FG Series approach.
EasyIO 30P and EasyIO FG Series have different approach.

Niagara Writable Action slots

Set @ relinquish default
Manual Override @ level 8
Emergency Override @ level 1

EasyIO Sedona objects that comes with 16

priority level
In Slot relinquish default
In Slot level 8
In Slot level 1

The actions that are available in a Niagara

station

Partial property sheet of a Digital Output object

from easyio30P kit.

Partial property sheet of priorityBoolean object

from easyioFG kit.

EasyIO Tcom Service v1.2

For basic get started and driver installation into a Niagara station, please refer to User Guide by
Maxline Solution.

EasyIO 30P
Step 1
In Tcom driver, the approach of adding points into a Niagara station is different from other protocols
drivers available in Niagara.
It uses a slot as points. Example in.slot or out slot.
These slots are individually added into a Niagara station. Tcom does not support the entire point
(in.slot and out.slot) as a single point.
By right overriding a writable point in Sedona is by commanding a higher priority in.slot.
Example of the DO object in Sedona apps (EasyIO 30P).

The DO1 object is drive by an external logic in the Sedona apps. DO1 will turn ON and OFF base on
the internal logic. The Digital Output object from easyio30P Sedona palette comes with 16 priority
inputs and a relinquish default.

EasyIO Tcom Service v1.2

This is the discovered points in the tcom driver. Under the DO1 object, there are slots. Drag the
DO1.out.slot. By default the out.slot is a read only point in Sedona.

Step 2
Drag the DO1.out.slot in to the driver point manager.

Step 3
The point DO1.out is actually a read-only point. With the collaboration with Maxline Solution, they
included the actions slots in Niagara that will reflects the writable point, in this case a Digital Output
object from the EasyIO 30P controller.

This provides the ease of overriding the writable point.

EasyIO Tcom Service v1.2

EasyIO FG Series
Step1
Below is an example of priority object in Sedona.
FG series physical IO does not comes with priority levels as EasyIO 30P.
The idea here is to keep it simple and flexible for customers to customize it.
Repeat the steps above to discover the priority object in the Sedona apps.
Example of a priority object in Sedona apps (EasyIO FG Series).

The PriorityBool object is driven by an external logic in the Sedona apps. PriorityBool will turn ON and
OFF base on the internal logic. The PriorityBool object from easyioFG Sedona palette comes with 16
priority inputs and a fallback value.
The out.slot of the PriorityBool is then link to the DO object.

This is the discovered points in the Tcom driver. Under the Priorit object, there are slots. Drag the
Priorit.out.slot. By default the out.slot is a read only point in Sedona.

Step 2
Drag the Priorit.out.slot in to the driver point manager.

EasyIO Tcom Service v1.2

Step 3
The point DO1.out is actually a read-only point. With the collaboration with Maxline Solution, they
included the actions slots in Niagara that will reflects the writable point, in this case a Digital Output
object from the EasyIO 30P controller.

This provides the ease of overriding the writable point.

EasyIO Tcom Service v1.2

Technical Support
For technical issue, please contact
Email :support@easyio.com
-