Download as pdf or txt
Download as pdf or txt
You are on page 1of 256

EasyIO FG Series Sedona Kits User Guide v1.

EasyIO Sedona kits for FG series


User Guide

Version 1.3
25th June 2015

1
EasyIO FG Series Sedona Kits User Guide v1.3

Document Change Log

18th April 2014


Document created.
This document only applicable to EasyIO FG Series

25th Dec 2014


Document updated.

25th June 2015


Document updated.

2
EasyIO FG Series Sedona Kits User Guide v1.3

Disclaimer

EasyIO 30P is a product by EasyIO Holdings Pte Ltd

The EasyIO 30P was built on the Sedona Framework ®.

EasyIO FG-32 is a product by EasyIO Holdings Pte Ltd

The EasyIO FG-32 was built on the Sedona Framework ®.

Sedona Framework is a trademark of Tridium, Inc.

CPT Tool is by Online Tools Inc.

3
EasyIO FG Series Sedona Kits User Guide v1.3

Table of Contents
Table of Contents .....................................................................................................................................4
Introduction ...........................................................................................................................................10
DateTimeStd...........................................................................................................................................11
DateTimeStd ......................................................................................................................................11
EasyioControl .........................................................................................................................................14
AnalogFilter ........................................................................................................................................14
BooleanCommandFailure ..................................................................................................................15
BooleanSelect ....................................................................................................................................16
DiscreteTotalizer ................................................................................................................................17
FloatCommandFailure........................................................................................................................18
FloatTotalizer .....................................................................................................................................20
FloatVal ..............................................................................................................................................21
Generic Table .....................................................................................................................................22
Generic Table32 .................................................................................................................................23
MinOnOff ...........................................................................................................................................24
Push Button .......................................................................................................................................24
rebootApp ..........................................................................................................................................25
restrtApp ............................................................................................................................................25
SaveApp .............................................................................................................................................26
EasyioCpt ................................................................................................................................................27
CptService ..........................................................................................................................................27
EasyioEnergy ..........................................................................................................................................28
Degree Days .......................................................................................................................................28
Optimized Start Stop..........................................................................................................................30
OssHolidayCalendar ...........................................................................................................................36
OssSchedule .......................................................................................................................................36
PID Loop .............................................................................................................................................37
Psychometric......................................................................................................................................39
WeatherYahoo ...................................................................................................................................41
EasyioFG .................................................................................................................................................43
Benchmark .........................................................................................................................................43
DO ......................................................................................................................................................44
EasyIOPlatform ..................................................................................................................................44
IPConfig ..............................................................................................................................................47
P_And2 ...............................................................................................................................................48
P_BSwitch ..........................................................................................................................................48
4
EasyIO FG Series Sedona Kits User Guide v1.3

P_CmprF.............................................................................................................................................49
P_CmprI .............................................................................................................................................49
P_FSwitch...........................................................................................................................................50
P_ISwitch............................................................................................................................................50
P_Not .................................................................................................................................................51
P_Or2 .................................................................................................................................................51
P_Xor..................................................................................................................................................51
PriorityBool ........................................................................................................................................52
PriorityFloat .......................................................................................................................................53
UI ........................................................................................................................................................54
UO ......................................................................................................................................................56
EasyioFGDDC ..........................................................................................................................................58
EasyioFGBacnet ......................................................................................................................................59
BACnetService....................................................................................................................................59
BACServerNetwork ............................................................................................................................62
BACServerAV ......................................................................................................................................63
BACServerBV ......................................................................................................................................64
BACnetClientNETwork .......................................................................................................................65
BACnetClientDevice ...........................................................................................................................67
BACnetClientAI...................................................................................................................................69
BACnetClientAO .................................................................................................................................70
BACnetClientAV .................................................................................................................................72
BACnetClientBI ...................................................................................................................................74
BACnetClientBO .................................................................................................................................75
BACnetClientBV..................................................................................................................................77
BACnetClientMI..................................................................................................................................78
BACnetClientMSO ..............................................................................................................................79
BACnetClientMSV ..............................................................................................................................81
EasyioFGBACClient .................................................................................................................................83
EasyioFGBACSvr .....................................................................................................................................83
EasyioFGDriver .......................................................................................................................................83
EasyioFGLcd kit.......................................................................................................................................84
FGLcdServerService............................................................................................................................85
LcdBool...............................................................................................................................................86
LcdBoolOneShot.................................................................................................................................88
LcdBoolOverwrite ..............................................................................................................................91
LcdDT .................................................................................................................................................93

5
EasyIO FG Series Sedona Kits User Guide v1.3

LcdFloat..............................................................................................................................................93
LcdFloatOneShot ................................................................................................................................96
LcdFloatOverwrite..............................................................................................................................98
LcdInt .................................................................................................................................................99
LcdSchedule .....................................................................................................................................103
Page .................................................................................................................................................103
writeDt .............................................................................................................................................104
EasyioFGLicense ...................................................................................................................................106
License .............................................................................................................................................106
EasyioFGMail ........................................................................................................................................107
BoolAlarm ........................................................................................................................................107
DnsService........................................................................................................................................109
FloatAlarm........................................................................................................................................111
FloatAlarmEd ...................................................................................................................................113
SmtpService .....................................................................................................................................116
EasyioFGMathConversion ....................................................................................................................119
ArcCosine .........................................................................................................................................119
ArcSine .............................................................................................................................................120
Arc Tangent ......................................................................................................................................120
Arc Tangent 2 ...................................................................................................................................120
Ceiling ..............................................................................................................................................121
Cosine...............................................................................................................................................121
Cosine Hyperbolic ............................................................................................................................121
Exponential ......................................................................................................................................122
Float Absolute ..................................................................................................................................122
Floor .................................................................................................................................................122
FMod ................................................................................................................................................123
Frexp ................................................................................................................................................123
Ldexp................................................................................................................................................123
Log....................................................................................................................................................124
Log 10...............................................................................................................................................124
ModF ................................................................................................................................................124
Power ...............................................................................................................................................124
Sine ..................................................................................................................................................125
Sine Hyperbolic ................................................................................................................................125
Square Root .....................................................................................................................................125
Tangent ............................................................................................................................................126

6
EasyIO FG Series Sedona Kits User Guide v1.3

Tangent Hyperbolic ..........................................................................................................................126


EasyioFGMbSlave .................................................................................................................................127
ModbusSlaveSerialNetwork.............................................................................................................128
ModbusSlaveTCPNetwork ...............................................................................................................129
ModbusSvrCoilPoint ........................................................................................................................131
ModbusSvrDiscretePoint .................................................................................................................132
ModbusSvrHoldingPoint ..................................................................................................................134
ModbusSvrInputPoint ......................................................................................................................137
EasyioFGModbus..................................................................................................................................139
ModbusSerialNetwork .....................................................................................................................139
ModbusSerialDevice ........................................................................................................................142
ModbusTCPNetwork ........................................................................................................................144
ModbusTCPDevice ...........................................................................................................................146
ModbusTCPGateway........................................................................................................................148
ModbusTCPGatewayDevice .............................................................................................................149
ModbusCoilPoint .............................................................................................................................152
ModbusDiscretePoint ......................................................................................................................153
ModbusHoldingBit ...........................................................................................................................155
ModbusHoldingPoint .......................................................................................................................156
ModbusInputBit ...............................................................................................................................158
ModbusInputPoint ...........................................................................................................................160
EasyioFGNtp .........................................................................................................................................162
NtpService........................................................................................................................................162
EasyioFGP2P .........................................................................................................................................165
P2PService........................................................................................................................................165
P2PBoolPoint ...................................................................................................................................166
P2PFloatPoint...................................................................................................................................167
P2PIntPoint ......................................................................................................................................168
EasyioFGSerial ......................................................................................................................................170
SerialService .....................................................................................................................................170
EasyioFGSql ..........................................................................................................................................171
SqlLite3Service .................................................................................................................................171
SqlTable............................................................................................................................................172
SqlBool .............................................................................................................................................173
SqlFloat ............................................................................................................................................174
SqlInt ................................................................................................................................................175
SqlFunc .............................................................................................................................................175

7
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioHistory ........................................................................................................................................179
EasyioHvac ...........................................................................................................................................180
Analog FIlter .....................................................................................................................................180
Analog FIlterV2 ................................................................................................................................181
Drive .................................................................................................................................................183
Fan Control.......................................................................................................................................184
LeadLagCycles ..................................................................................................................................186
LeadLagCycles_3o1s ........................................................................................................................187
LeadLagRuntime ..............................................................................................................................188
Sequence Loop.................................................................................................................................190
Sequencer ........................................................................................................................................195
Single Loop .......................................................................................................................................195
EasyioLastWrite....................................................................................................................................200
LastWriteBool ..................................................................................................................................200
LastWriteFloat..................................................................................................................................202
LastWriteInt .....................................................................................................................................203
EasyioLib...............................................................................................................................................205
AnalogFilter ......................................................................................................................................205
AnalogLimit ......................................................................................................................................206
DigitalState.......................................................................................................................................207
HighLowSelect..................................................................................................................................209
AnalogFilter ......................................................................................................................................210
EasyioLimkit .........................................................................................................................................212
B2L ...................................................................................................................................................213
B2S ...................................................................................................................................................214
B2W..................................................................................................................................................215
FLAtch ..............................................................................................................................................216
IntDecoder .......................................................................................................................................217
L2B ...................................................................................................................................................219
Limit .................................................................................................................................................220
Mb4Regs ..........................................................................................................................................221
MinMaxAvg ......................................................................................................................................222
NCmpr ..............................................................................................................................................224
Offset ...............................................................................................................................................224
PFloatSelect .....................................................................................................................................224
R134A ...............................................................................................................................................227
RateLimit ..........................................................................................................................................227

8
EasyIO FG Series Sedona Kits User Guide v1.3

S2B ...................................................................................................................................................228
S2Time .............................................................................................................................................229
Time2S .............................................................................................................................................230
W2B..................................................................................................................................................231
EasyioP2P .............................................................................................................................................232
P2P Client Service ............................................................................................................................232
P2P Server Service ...........................................................................................................................234
EasyioSchedule.....................................................................................................................................235
Holiday Calendar ..............................................................................................................................236
NumericSchedule .............................................................................................................................239
Schedule...........................................................................................................................................240
EasyioSensor ........................................................................................................................................246
PresetTemp Table ............................................................................................................................246
Temp Table ......................................................................................................................................247
VoltCurrentTable .............................................................................................................................248
EasyioSub .............................................................................................................................................250
Count................................................................................................................................................251
Loop Point ........................................................................................................................................252
MinMax ............................................................................................................................................253
TimeAverage ....................................................................................................................................254
Timer ................................................................................................................................................254
Tcom.....................................................................................................................................................255
TcomService .....................................................................................................................................256

9
EasyIO FG Series Sedona Kits User Guide v1.3

Introduction
This document describe about the EasyIO Sedona kits and functionality. All the EasyIO Sedona kits
can only be used with EasyIO Sedona controllers. No other controllers can be used.

10
EasyIO FG Series Sedona Kits User Guide v1.3

DateTimeStd
This kit contains 1 object. The object is to be used for configuring the Daylight Saving which applies to
some countries.
This object extends the kit DateTimeStd to enhance with Day Light Saving feature.

To use any of the objects simply drag and drop from the library into the wire sheet. .
The object is preferably located in the service folder.
By default the object is preinstalled.

DateTimeStd
DateTimeStd object is an extended object from Sedona kit that has Daylight Saving Feature
(DST). User can set the Start of DST and End of DST for the fiscal year.

Users need to renew the settings every year or else it will occur at the same time same date as
the previous configurations. There is no automatic mechanism to update the start and end of the
DST.

The extended property sheet of the object is shown below

 Enable
This property is to enable or disable the DST service

 Is DST
Show the status of the DST object.
11
EasyIO FG Series Sedona Kits User Guide v1.3

If Enable = True, is DST will show Daylight Saving Time


IfEnable = False, is DST will show Standard Time

 Next DST
Shows the next DST time if Enable is true.

 DST Offset
This is the offset for the DST, default is set to 1 hours forward.
Value is in seconds.

 DST Start Time Format


The Start DST time format.

If set to UTC, DST will active according to UTC time, GMT +0.
If set to Standard, DST will active according to the time zone configure.
If set to Wall, DST will active according to the current time at the controller.

 DST Start On
This is the start day format.

If set to First, DST will start according to the day specific configure at “DST Start
DOW (Day Of Week)” property.
If set to Last, DST will start according to the day specific configure at “DST Start
DOW (Day Of Week)” property.
If set to “On Exact Date”, DST will start on the exact date configure.

 DST Start DOW (Day Of Week)


Day of the week to start DST if “DST On” property is set to First or Last.
If “DST Start On” set to “OnExactDate” this property is ignored.

 DST Start Month


Month of the DST to start

 DST Start Day


Day of the DST to start

 DST Start Hour


Time in hour for the DST to start.
24 hours format.

 DST Start Minute


Time in minute for the DST to start.

 DST End Time Format


The Start DST time format.

If set to UTC, DST will ends according to UTC time, GMT +0.
If set to Standard, DST will ends according to the time zone configure.
If set to Wall, DST will Ends according to the current time at the controller.

12
EasyIO FG Series Sedona Kits User Guide v1.3

 DST End On
This is the start day format.

If set to First, DST will start according to the day specific configure at “DST Start
DOW (Day Of Week)” property.
If set to Last, DST will start according to the day specific configure at “DST Start
DOW (Day Of Week)” property.
If set to “On Exact Date”, DST will start on the exact date configure.

 DST End DOW (Day Of Week)


Day of the week to start DST if “DST On” property is set to First or Last.
If “DST Start On” set to “OnExactDate” this property is ignored.

 DST End Month


Month of the DST to start

 DST End Day


Day of the DST to start

 DST End Hour


Time in hour for the DST to start.24 hours format.

 DST End Minute


Time in minute for the DST to start.

13
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioControl
This kit contains 15 objects. All the objects are to be used for engineer the Sedona apps.
To use any of the objects simply drag and drop from the library into the wire sheet.

AnalogFilter
AnalogFilter object is use to limit a float value within a range. This is good for controlling a
fluctuating float value where it always keeps hunting.

There is a better damping factor object which is in easyioHvac kit.

The property sheet of the object is shown below

 Dif
User define offset value or cut off value.

 Dif Value
This is a read property where it represents calculate different base on previous
input.

 In

14
EasyIO FG Series Sedona Kits User Guide v1.3

Input float value to the object

 Pre Val
Last float value object received

 Out Val
Output value after filtration

 Cycle Time
Time period for the object to calculate and process the output.

Example of using the analog filter to slow down the poll rate of an 1.5K Platinum Temperature
Sensor.

Example of property sheet for the Analog Filter object

BooleanCommandFailure
This object provides status feedback for a command. It gives you status of the command with a
user define time period.
The property sheet of the object is shown below

15
EasyIO FG Series Sedona Kits User Guide v1.3

 Enable
Enable or disable the object.

True = enable
False = disable

 Out
Error message output. The output is a Boolean

True = Command Failure


False = Command Success

 Feedback
Status feedback of a command. This property is use to determine the command
failure.
Usually a Boolean status is linked to this property.

 Command
This is the command input. Usually a Fan Command point is linked to this
property.

 Delay Compare Time


Time period to compare or time period to delay the determination of command
failure.

 Delay Count Down Time


Count down timer according to the Delay Compare Time set.

BooleanSelect
BSlect is an object to select between 2 Boolean inputs for the output value. The output value is
also Boolean.

The property sheet of the object is shown below

16
EasyIO FG Series Sedona Kits User Guide v1.3

 In A
User define Input.

 In B
User define Input

 InSel
Selection of the Input.

IF InSel = true
Out = In B

IF InSel = false
Out = In A

 Out
Current output depend to InSel property.

DiscreteTotalizer
DiscTotalizer is an object compute a Boolean value runtime.

The property sheet of the object is shown below

 Dur Runtime
Duration runtime is the current runtime. The runtime will reset to zero there on
every change in the input.

 Dur Cumulated Runtime


Duration cumulated runtime is the total runtime.
17
EasyIO FG Series Sedona Kits User Guide v1.3

 Runtime
Current runtime is a float value format in minute.

 Cumulated Runtime
Duration cumulated runtime in float value format in minute.

 In
Input for the Disctotalizer

 Reset
Toggle to reset the cumulated runtime to zero.

Example of the object while calculate the Runtime

Example of the object in the wire sheet.

FloatCommandFailure
This object provides a status feedback for a float command.
The property sheet of the object is shown below

18
EasyIO FG Series Sedona Kits User Guide v1.3

 Enable
Enable or disable the object.

True = enable
False = disable

 Out
The error message output. The output is a Boolean

True = Command Failure


False = Command Success

 Feedback
Status feedback of the command. This property is use to determine the
command failure.
Usually a float value is linked to this property.

 Command
This is the command input. Usually a set point value is linked to this property.

 Delay Compare Time


Time period to compare or time period to delay the determination of command
failure.

 Delay Count Down Time


Count down timer according to the Delay Compare Time set.

 Command High Limit


This property set the upper tolerance limit in percentage

19
EasyIO FG Series Sedona Kits User Guide v1.3

 Command High Limit Value


This read-only property shows the actual high tolerance limit as define in the
command high limit.

 Command Low Limit


This property set the upper tolerance limit in percentage

 Command Low Limit Value


This read-only property shows the actual high tolerance limit as define in the
command high limit.

Example view of the Float CommandFailure object.


The command input = 45 ,
Command High Limit = 5% ,
Upper Value = Command + 5% = 47.25.

Command is still successful as the feedback is within the lower limit and upper
limit.

FloatTotalizer
FloatTotalizer is a tantalizer object. It totalizes either secondly, minutely or hourly.
The total value will reset to zero if the reset Boolean property is toggle.

The property sheet of the object is shown below

20
EasyIO FG Series Sedona Kits User Guide v1.3

 Total Out
Totalize output value base on time selection.

 In
Object real time input.

 Timebase
Time base option. 3 options available secondly, minutely or hourly.

 Reset
A Boolean property to reset the total out value to zero.

FloatVal
FloatVal is an object providing output as pulse depends on the input and set point.

The property sheet of the object is shown below

 In
The input

 Sp
Setpoint for the input

 Target Time
Time period for the output “Open” or “Close” to be activated.

 Pulse Per Sec


Pulse time period in seconds.

 Open
Open Output

 Close
Close output.

21
EasyIO FG Series Sedona Kits User Guide v1.3

Generic Table
Generic Table is an object where it acts like a curve fit. It can be used to tabulate a non-linear
input.

The property sheet of the object is shown below

 In
Input value for the generic table.

 Out
Calculate value as per the table values key in.

 In1 – In10
Input value 1 for the generic table.

 Value1 – Value 10
Output Value base on the input 1 value.

22
EasyIO FG Series Sedona Kits User Guide v1.3

Generic Table32
Generic Table32 is an object where it acts like a curve fit. It can be used to tabulate a non-linear
input. It gives you 32 input lines as compare the GenericTable provides only 10 lines.
This object is good for scaling a temperature sensor.

The property sheet of the object is shown below

 In
Input value for the generic table.

 Out
Calculate value as per the table values key in.

 In1 – In32
Input value 1 for the generic table.

 Value1 – Value 32
Output Value base on the input value.

Example of a genericTable32 object used reading a raw value from FG series and output the temp
value.

23
EasyIO FG Series Sedona Kits User Guide v1.3

MinOnOff
MinOnOff will hold the output value according to the minimum on and minimum off time.

The property sheet of the object is shown below

 Out
Output state.
 In
Input state
 Timer
Real time countdown timer.
 Min On Time
Minimum On time in seconds.
 Min Off Time
Minimum Off time in seconds.

Push Button
Push Button is an object which acts like a momentary push button or a Boolean toggle button.
It comes with an action slot for which acts like a toggle button. A trigger at the action will set the
out slot to true and will remain the true state until the define time period is over.

While the out slot is still true and the countdown timer has not expired a second trigger will
switch the true state to false state. The second trigger act as cancelation trigger.

The property sheet of the object is shown below

 Out
24
EasyIO FG Series Sedona Kits User Guide v1.3

Current Output value

 In
In Value.

 Trigger Period
Countdown timer before the output returns to false after a trigger or change in
the In Slot.

rebootApp
rebootApp is an object which will reboot the Sedona VM if a true Boolean input is received.
It has a HoldTime to make sure the Boolean state received is not a false alarm.

The property sheet of the object is shown below

 In
Boolean Input to trigger the object.

 HoldTime
Amount of time to hold before the object trigger the action.

restrtApp
restrtApp is an object which will restart the Sedona VM if a true Boolean input is received.
It has a HoldTime to make sure the Boolean state received is not a false alarm.

The property sheet of the object is shown below

 In
Boolean Input to trigger the object.

 HoldTime
Amount of time to hold before the object trigger the action.

25
EasyIO FG Series Sedona Kits User Guide v1.3

SaveApp
SaveApp is an object where it can used to automatically save the Sedona apps with a user pre-
define period.
Please do not set the frequency to be too low as there is a limited write cycle in the Flash
Memory.

The property sheet of the object is shown below

 Save Frequency
Time period defines by user to activate the automatic save apps. Default is 6
minutes.

26
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioCpt
This kit contains 1 object. This object is used for EasyIO FG series web graphics.
By default the kit is installed and object is in the service folder.

CptService
CptService object is preinstalled in the every default apps and this object enables the
CPT web graphics.
The property sheet of the object is shown below

 Enable
Enable or disable the service.

 Status
Display the status of the service.

 Last Client Address


Display the last client address that is accessed the CPT Service.

 Port
TCP port that the CPT service is running.
At the moment the port is fixed and not editable.

27
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioEnergy
This kit contains 7 objects. These objects are used for energy control optimizations.
To use any of the objects simply drag and drop from the library into the wire sheet.

Degree Days
Degree Days is a component duplicate from Tridium Niagara AX kitControl object.

The property sheet of the object is shown below

 Status
This property shows the status f the object.

 Unit
Selection of Celsius or Fahrenheit.

 Base Temp
Specify the base temperature used in the degree-day calculation

28
EasyIO FG Series Sedona Kits User Guide v1.3

 In
This is the input for the outside air temperature used in the degree-day
calculation.
Note: If this input value is not valid the no calculation will be done.

 Min Temp
The minimum temperature recorded for the current day. Tested and set on
each calculation.

 Max Temp
The maximum temperature recorded for the current day. Tested and set on
each calculation.

 Mean Temp
The mean temperature recorded for the previous day. Calculated when the day
changes.

Mean Temp = (Max Temp - Min Temp) / 2.0

 Cooling Deg Days


This is the cooling degree-day calculated for the previous day. Calculated when
the day changes.

If (Mean Temp - Base Temperature) > 0


Clg Deg Days = Mean Temp - Base Temperature
Else
Clg Deg Days = 0.0

 Cooling Deg Days Total


This is the totalized cooling degree-days since last Reset Totals action was
invoked. Calculated when Cooling Deg Days changes.

 Heating Deg Days


This is the heating degree-day calculated for the previous day. Calculated when
the day changes.

If (Mean Temp - Base Temperature) < 0


Heating Deg Days = Base Temperature - Mean Temp
Else
Heating Deg Days = 0.0

 Heating Deg Days Total


This is the totalized heating degree-days since last Reset Totals action was
invoked.
Calculated when Heating Deg Days changes.

 Reset Action
This action will reset the Cooling and Heating Deg Days total.

29
EasyIO FG Series Sedona Kits User Guide v1.3

Optimized Start Stop


Optimized Start Stop is a component duplicate from Tridium Niagara AX kitControl object.

The OptimizedStartStop component allows you to use Start Time Optimization and Stop Time
Optimization to save energy. This component uses a space temperature input and area
characteristics to calculate an optimal amount of lead-time before a scheduled event. It can
analyze area temperature changes and adjust the optimization parameters based on the actual
temperature change rates after an optimized start or stop.

The two basic optimization types are described, as follows:


Start time optimization
This type of optimization reduces energy consumption by turning on equipment at the latest
possible time that still allows for providing a comfortable temperature by occupancy time.
Stop time optimization
This type of optimization turns equipment off at the earliest possible time that allows the
building to “drift” and stay within a temperature comfort range until the end of occupancy time.

OptimizedStartStop operation
The OptimizedStartStop calculation is performed at 15 seconds after the beginning of every
minute, when the appropriate Start Enable or Stop Enable properties are set to true, a valid
schedule event is linked to the component, and the next scheduled event value is not already set.

Start time and stop time operations are described below:

Calculated Start Time


Only one optimized start sequence is performed per day. The following factors affect the
Calculated Start Time calculation.

Temperature differential
If the space temperature is outside the range defined by the lower and upper comfort limits, the
difference between the space temperature and the closer limit represents the number of
degrees the mechanical equipment must make up during the prestart (“optimized”) period.

Run-time minutes
The run-time heating or cooling factors (depending on the direction the space temperature
must move) are multiplied by the temperature differential to determine the number of run-time
minutes required to achieve the comfort limit at occupancy time, as defined by the schedule's
start time.

Optimum start time


When the system's time is later than the schedule's time offset by the calculated lead time, the
optimum start outputs are Enable.
Note: If the calculated lead time is so large that an optimum start time prior to midnight is the
result, the optimum start occurs at midnight. An optimum start is performed only for the first
scheduled start for the day.

Calculated Stop Time


You can perform multiple stop operations but no optimized stop can occur before the time
specified by the Earliest Stop Time property.

Temperature differential
If the space temperature is inside the range defined by the lower and upper comfort limits and
the schedule’s status is active, the difference between the space temperature and one of the

30
EasyIO FG Series Sedona Kits User Guide v1.3

limits(depending on the mode) represents the number of degrees the temperature can drift
between the time the mechanical equipment is stopped and the schedule’s inactive event time.

Drift time
The drift (lead-time) calculation is similar to the one for Start Time but using the drift-time
heating and cooling factors.

Optimum stop time


Optimum stop time is invoked for each of the schedule’s inactive events and is based on the drift
time and Next Event Time value.

The property sheet of the object is shown below

31
EasyIO FG Series Sedona Kits User Guide v1.3

 Heat Cool Mode


This boolean property allows you to enable either the heat Mode or the cool
Mode. The selected option applies only to optimized stop calculations which
means that optimized stop calculations are performed only for the selected
mode. Optimized start calculations are performed for both heat and cool
modes, regardless of this property value.

 Parameter Reset Time


This property displays the time when any of the four runtime or drift time
properties change to the User Defined values. The OSS component copies the
user defined drift time and runtime property values to the corresponding actual
drift time and runtime property values.

 Start Enable
This property allows you to manually or automatically enable or disable the
Optimized start function.

 Stop Enable
This property allows you to manually or automatically enable or disable the
optimized stop function.

 Schedule Status
This boolean property monitors and displays the status of the schedule that is
linked to it.
 Next Event Time
This property is linked to a schedule for the time of the next scheduled event.

 Next Event Seconds


This property is linked to a schedule and reflects the value of the action for next
scheduled event.

 Next Event Value


This property is linked to a schedule and reflects the value of the action for next
scheduled event.

 Outside Temp

32
EasyIO FG Series Sedona Kits User Guide v1.3

This property is linked to outside temperature and displays the value for
information only.

 Space Temp
This property is linked to a space temperature output and displays the
temperature of the area affected by equipment associated with the OSS
component.

 Start Time Command


This boolean property is an output that you link to a control for invoking an
equipment start command.

For example, it can be linked to a prioritized input of a boolean writable - or


directly to the equipment Start control.

 Stop Time Command


This boolean property is an output that you link to a control for invoking an
equipment stop command.
For example, it can be linked to a prioritized input of a boolean writable - or
directly to the equipment Stop control.

 Message
This field provides information that indicates the results of the latest start or
stop command, the status of an optimized start analysis, or other possible
messages. For example, the following message is displayed to indicate that an
optimized stop has occurred: “Optimized stop for 14-Jun-075:18 PM EDT
schedule time. Space temp is 75.0.”

 Upper Comfort Limit


This property value is the Cooling mode target temperature.

 Lower Comfort Limit


This property value is the Heating mode target temperature.

 Dynamic Parameter Adjust


This controls whether or not calculation parameters are programmatically
adjusted after an execution.
After the OSS component completes a start or stop control, if this property
value is set to true, the component evaluates the actual recovery rate
(degrees/hour) and automatically adjusts the Runtime and Drifttime properties
values so that they are influenced by actual drift time and runtime.

 Old Parameter Multiplier


This property is used to weight the dynamic parameter adjustment calculation.
The value that you specify in this field affects how much weighting you assign to
the previous runtime property value then it is used in the dynamic parameter
adjustment calculation. A larger value increases the amount of weighting given
to the previous runtime and a smaller value decreases the weighting.

 Earliest Start Time


This property allows you to specify a time, before which, no optimized start
command may be issued.
If this value is set earlier than the Calculated Command Time, the Calculated
Command Time is adjusted to equal this time.

33
EasyIO FG Series Sedona Kits User Guide v1.3

 Earliest Stop Time


This property allows you to specify a time, before which, no stop command may
be issued. If this value is set earlier than the Calculated Command Time, the
Calculated Command Time is adjusted to equal this time.

 Drift time Per degree Cooling User Defined


This property allows you to set a default value for calculating the rate of drift in
cooling mode. When you save a value to this field, the value is copied to the
Drift time Per Degree Cooling field.

 Drift time Per degree Heating User Defined


This property allows you to set a default value for calculating the rate of drift in
heating mode. When you save a value to this field, the value is copied to the
Drift time Per Degree Heating field.

 Runtime Per degree Cooling User Defined


This property allows you to set a default value for calculating the runtime value
in cooling mode.
When you save a value to this field, the value is copied to the Runtime Per
degree Cooling field.

 Runtime Per degree Heating User Defined


This property allows you to set a default value for calculating the runtime value
in heating mode.
When you save a value to this field, the value is copied to the Runtime Per
Degree Heating field.

 Drifttime Per degree Cooling


This property displays the actual value that is used for calculating an optimized
stop time when the equipment is in cooling mode. This value is adjusted
automatically if the Dynamic Parameter Adjust value is set to true.

 Drifttime Per degree Heating


This property displays the actual value that is used for calculating an optimized
stop time when the equipment is in heating mode. This value is adjusted
automatically if the Dynamic Parameter Adjust value is set to true.

 Runtime Per degree Cooling


This property displays the actual value that is used for calculating an optimized
start time when the equipment is in cooling mode. This value is adjusted
automatically if the Dynamic Parameter Adjust value is set to true.

 Runtime Per degree Heating


This property displays the actual value that is used for calculating an optimized
start time when the equipment is in heating mode. This value is adjusted
automatically if the Dynamic Parameter Adjust value is set to true.

 Last Start Time


This is a record of the last Start Time that was used for calculating an optimized
start time. Since only one optimized start per day is allowed, this value does not
display Start Times (restarts) that are subsequent to the initial Start Time for a
day.

34
EasyIO FG Series Sedona Kits User Guide v1.3

 Last Stop Time


This is a record of the last Stop Time that was used for calculating an optimized
stop time. Since multiple Optimized Stops are allowed in a day, this value
changes to reflect the latest Optimized Stop time.

 Outside Temp At Beginning


This is a record of what the outside air temperature was at the time of the last
start or stop command.
This is the temperature that was used in calculations for dynamic parameter
adjustment.

 Space Temp At Beginning


This is a record of what the space temperature was at the time of the last start
or stop command.
This is the temperature that was used in calculations for dynamic parameter
adjustment.

 Calculated Command Time


This field shows the calculated time for the next command. This could be a start
or a stop command.

 Program Mode
As part of the logic that the OSS component uses, there are five “program
mode” states. These states serve primarily in logic control; however, they may
be informative to the system engineer, as well.
The Program Mode value displays the current heating or cooling state for
optimized start or stop. The following list describes the possible display values
and meanings.

In order to use this object, it has to be pair with OSSSchedule and also OSSHolidayCalendar. Schedule
and HolidayCalendar from easyIO Schedule kit cannot be use.

The OSS schedule and also OSS Holiday Calendar comes with a “Next Schedule Seconds” for the OSS
Start Stop object.
Below is a sample of the object configurations.

35
EasyIO FG Series Sedona Kits User Guide v1.3

OssHolidayCalendar
OssHolidayCalendar is a same object that is available from “easyioSchedule” kit
(HolidayCalendar). The different is just that this object contain 2 more property. These 2
properties are only use in conjunction with the Optimized Start Stop object.
The control philosophy and behavior is exactly the same.

This image shows the extra 2 property as compare to image below does not have it.

This image shows schedule object from the easyioSchedule kit. Note that it does not have the 2
extras property as shown in above image

OssSchedule
OssSchedule is a same object that is available from “easyioSchedule” kit (Schedule). The
different is just that this object contain 2 more property. These 2 properties are only use in
conjunction with the Optimized Start Stop object.
The control philosophy and behavior is exactly the same.

This image shows the extra 2 property as compare to image below does not have it.

This image shows schedule object from the easyioSchedule kit. Note that it does not have the 2
extras property as shown in above image

36
EasyIO FG Series Sedona Kits User Guide v1.3

PID Loop
PID loop is a component duplicate from Tridium Niagara AX kitControl object “Loop Point”.
The control philosophy and behavior is exactly the same as the Niagara object.

The property sheet of the object is shown below

 Enable
Enable and disable the PID loop

 Out
The calculated output base on P, I and D.

 In
Process variable input

 Setpoint
Setpoint input

 Execute Frequency
PID loop execution time. Higher value will make the loop slower.

 Ramp Time
Ramp time for the PID loop first start or from disable state to enable state.

 Direct Loop
PID loop algorithm.

Direct = Cooling Mode


Reverse = Heating mode

37
EasyIO FG Series Sedona Kits User Guide v1.3

 On Disable
On disable, what the PID loop will do.
4 options available

When enable = false;


Max = output value will hold at minimum value define at “Min Out” property
Min = output value will hold at minimum value define at “Max Out” property
Hold =output value will hold at the last value the PID loop calculated.
Zero = output value will be force to zero

 Max Out
Max output the PID loop will go.

 Min Out
Max output the PID loop will go.

 Proportional Gain
Defines the value of the proportional gain parameter used by the loop
algorithm. Used to set theoverall gain for the loop.
A starting point for this value is found by output range/throttling range.

 Integral Gain
Defines the integral gain parameter, in repeats per minute, used by the loop
algorithm. Also called reset rate. Acts on magnitude of the setpoint error. A
typical starting point is 0.5.
The lower the value, the slower the loop will acts.

 Derivative Gain
Defines the derivative gain parameter, in seconds, used by the loop
algorithm.Acts on the rate of change of the setpoint error.

Good starting point of setting up the PID loop with only P and I.

38
EasyIO FG Series Sedona Kits User Guide v1.3

Psychometric
Psychometric is a component calculating the psychometric values with the input of a
Temperature and a Relative Humidity Value.
This component is a component duplicated from Tridium Niagara AX kitControl object
“Psychometric”.
The control philosophy and behavior is exactly the same as the Niagara AX object.

The property sheet of the object is shown below

 Calculate On
Selection of calculation mode. If a COV is selected, Interval time period is no
longer used.

 Interval
Interval time period for the object to re-calculate. Only applicable if the
Calculate On selection is selected to Interval.

 Unit Select
Unit selection. Metric or English SI Units.

 In Temp Unit
Input Temperature SI Unit

39
EasyIO FG Series Sedona Kits User Guide v1.3

 In Temp
Input Temperature Value

 In Humidity Unit
Input Relative Humidity SI Unit

 In Humidity
Input Relative Humidity Value

 Out Dew Point Unit


Dew Point SI Unit. Read Only. Unit is reflection by the selection of the Unit
Select Parameter

 Out Dew Point


Calculated Dew Point Value.

 Out Enthalpy Unit


Enthalpy SI Unit. Read Only. Unit is reflection by the selection of the Unit Select
Parameter

 Out Enthalpy
Calculated Enthalpy Value.

 Out Saturation Pressure Unit


Saturation Pressure SI Unit.Read Only. Unit is reflection by the selection of the
Unit Select Parameter

 Out Saturation Pressure


Calculated Satturation Pressure Value.

 Out Vaporize Pressure Unit


Vaporize Pressure SI Unit. Read Only. Unit is reflection by the selection of the
Unit Select Parameter

 Out Vaporize Pressure


Calculated Vaporize Pressure Value

 Out Wet Bulb Unit


Wet Bulb SI Unit. Read Only. Unit is reflection by the selection of theUnit Select
Parameter

 Out Wet Bulb


Calculated Wet Bulb Value.

40
EasyIO FG Series Sedona Kits User Guide v1.3

WeatherYahoo
WeatherYahoo object provides a real time weather forecast base on http request from
https://weather.yahoo.com.
All WOEID for Yahoo weather can be search at this website, http://woeid.rosselliot.co.nz
The property sheet of the object is shown below

41
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Display the object status

 Last Update
Display the last update timestamp.

 Enable
Enable or disable the object.

 DNS Fault Casue


Display the DNS fault is any.

 Host Name Query Freq


URL query frequency.

 Host Name
Yahoo Weather URL.

 Prefer DNS
Prefer DNS.
By default the DNS is referring to Google DNS.

 Alter DNS
Alternate DNS.
By default the alternate DNS is referring to Google DNS.

 IP
Resolved IP address for yahoo weather URL.

 WOEID
Location ID represents the

 Unit
Selection of Celsius or Fahrenheit.

 Update Interval
Object update time interval.

 Retry Interval
Retry interval period if update fail.

 Response Time Out


Time period to wait before a time out error is prompt.

42
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFG
This kit only applicable for EasyIO FG32 controller.

This kit contains 7 objects as show below.

To use any of the objects simply drag and drop from the library into the wire sheet.
By default the “EasyIOPlatform” and “IPConfig” object are pre-installed in the FG controller.

Benchmark
Benchmark object is an object where is shows the CPU loads which display a value that
represents cycle per second.
This object can only be used for EasyIO FG Series controller.

EasyIO component performance measurement, used to measure the single component n cycle
per second. The execution time is distributed equally to every installed component, and hence
putting one Benchmark component is good enough to benchmark the component execution
cycle. The value represents each component execution cycle per second.
The property sheet of the object is shown below.

 Cycle Per Second


Number of execution cycles per component per second, read-only. This value is not
a linear curve versus total number of components.

43
EasyIO FG Series Sedona Kits User Guide v1.3

The value 138 means each component get executed 138 times every second.

DO
DO, Digital Output is an object to configure the Digital Output for the EasyIO FG32 controller.
There are eight Digital Output channel for the EasyIO FG32.

The property sheet of the object is shown below

 Channel
The output channel selection. Channel DO1 – DO16

DO1 – DO8 = Digital Output, Relay Contact output.


DO9 – DO16 = Universal Output/ Open Collector
Universal Output can be configured as open collector output.

To use UO as DO, the jumper on board has to be selected at Digital.

 Out
Output of the digital output

 In
Input of the digital output

EasyIOPlatform
EasyIOPlatform object is an object where it gets the platform identifier which defines how
the Sedona device should be provisioned.

The property sheet of the object is shown below.

44
EasyIO FG Series Sedona Kits User Guide v1.3

 Platform ID
It is a platform identifier which defines how the Sedona device should be
provisioned.

 Mem Available
Display available memory of the controller.

 Mac Address
Display the MAC address of the controller.

 Serial NO
Display the serial number of the controller

 Host ID
Display the host ID of the controller which will be use for special kit licensing.
Sedona developer can utilize this HOST ID as licensing criteria.

 Version
Display firmware version that is currently running in the hardware.

Older firmware version : V2.x.2.x


Newer firmware version for FG : v1.4bxx , where bxx = build number.
Firmware version for FG+ : v2.0bxx , where bxx = build number.

 Power Failure Save


In case a power failure this feature will perform an auto saves of the running
apps. This is to prevent apps corruption when a power restore.

 Auto Save Interval


Auto save interval saves the apps interval.
If the value is zero the auto save is disable.

45
EasyIO FG Series Sedona Kits User Guide v1.3

 Recovery Mode
In firmware V1.5b42 and later for FG or firmware v2.0b42 and later for FG+,
recovery mode property is introduced.

It has 4 options and by default is restore last saved apps.

Recovery Mode Action performed Remarks


Do Nothing Controller will not perform any action same as
watchdog jumper is in OFF mode.
It is sort of software watchdog.

Restore Last Saved Apps The controller will restore the last saved apps. Default Selection

On every action save performed, controller will get a


copy of the current apps and saves it to the flash
memory.

In case the controller could not able to run the current


application, it will then use the backup copy.

Restore Default Apps The controller will restore the default apps.
Default app is an empty app.

Debugging Mode This mode is for developer debugging mode.

46
EasyIO FG Series Sedona Kits User Guide v1.3

IPConfig
IPConfig is an object where it shows the current IP address of the controller. This object as well is
use to change the current IP address to a user define IP address.
A save and reboot of the controller is needed if any changes is made to this object.
The property sheet of the object is shown below.

 Status
It display the status of the IP address.

 Current Ip Address
Display the current IP address that been set.
This is a read-only slot.

 Current Subnet Mask


Display the current subnet mask that been set.
This is a read-only slot.

 Current Gateway
Display the current gateway that been set.
This is a read-only slot.

 New Ip Address
This field provides the user to key in the new desire IP address.

 New Subnet Mask


This field provides the user to key in the new desire subnet mask.

 New Gateway
This field provides the user to key in the new desire gateway.

47
EasyIO FG Series Sedona Kits User Guide v1.3

P_And2
P_And2 is an AND gate logic object. There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.
The property sheet of the object is shown below.

In1 and In2 will determine the output value as a normal AND gate logic.
If the Inputs conditions are satisfy, the Out value will then refer to the Null On property to
determine the actual output value.

P_BSwitch
P_BSwitch is a Boolean switching object between 2 inputs.
This output selection of this object is determined by S1 state.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.
The property sheet of the object is shown below.

If S1 = false, Out = In1


If S1 = true, Out = In2
However the actual output value is determine by the Null On property.

48
EasyIO FG Series Sedona Kits User Guide v1.3

P_CmprF
P_CmprF is a simple mathematic float value comparison object. It compares 2 float values.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.
The property sheet of the object is shown below.

If X > Y , Xgy = true , where Xgy = X greater than Y


If X = Y , Xey = true , where Xey = X equal Y
If X < Y , Xly = true , where Xly = X less than Y
However the actual output value is determine by the Null On property for each Xgy, Xey and Ely.

P_CmprI
P_CmprI is a simple mathematic integer value comparison object. It compares 2 integers
values.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.
The property sheet of the object is shown below.

If X > Y , Xgy = true , where Xgy = X greater than Y


If X = Y , Xey = true , where Xey = X equal Y
If X < Y , Xly = true , where Xly = X less than Y
However the actual output value is determine by the Null On property for each Xgy, Xey and Ely.

49
EasyIO FG Series Sedona Kits User Guide v1.3

P_FSwitch
P_FSwitch is an Float switching object between 2 float inputs.
This output selection of this object is determined by S1 state.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.

If S1 = false, Out = In1 however if In1 < Null Min or In1 > Null Max, Out = Null Value.
If S1 = true, Out = In2 however if In2 < Null Min or In2 > Null Max, Out = Null Value.

P_ISwitch
P_ISwitch is an Integer switching object between 2 integer inputs.
This output selection of this object is determined by S1 state.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.

If S1 = false, Out = In1 however if In1 < Null Min or In1 > Null Max, Out = Null Value.
If S1 = true, Out = In2 however if In2 < Null Min or In2 > Null Max, Out = Null Value.

50
EasyIO FG Series Sedona Kits User Guide v1.3

P_Not
P_Not reverse object for a Boolean input.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.

Out = however the actual output value is determine by the Null On property.

P_Or2
P_Or2 is an object implements OR gate logic of 2 Boolean inputs.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.

Out = In1|In2 however the actual output will be determine by the Null On property.

P_Xor
P_Xor is a two input exclusive OR logic gate.
There is an option for the output value to be null.
The “Null On” property will only filter the output value regardless of input values.

Out is determine by the Exclusive OR logic however the actual output will be determine by the Null On
property.

51
EasyIO FG Series Sedona Kits User Guide v1.3

PriorityBool
PriorityBool is a component provides a means priority level controls it comes with a standard 16
priority levels and a fallback value.
The output is a Boolean value. The object comes with an On Delay and Off Delay.
The property sheet of the object is shown below

 Out
Current output value.

 In1 ~ In16
16 priority levels are available. In1 being the highest priority and In16 the
lowest.

 Delay On
The amount of time delay specifies by user to delay the On value since last Off
occurred.

 Delay Off
The amount of time delay specifies by user to delay the Off value since last On
occurred.

52
EasyIO FG Series Sedona Kits User Guide v1.3

PriorityFloat
PriorityFloat is a component provides a means priority level controls it comes with a standard 16
priority levels and a fallback value.
The output is a Float value

The property sheet of the object is shown below

 Out
Out value the value determine by the level or priority.

 In1 ~ In16
16 priority levels are available. In1 being the highest priority and In16 the
lowest.

 Delay
The amount of time delay specifies by user to delay the edited value since the
last value occurred.

53
EasyIO FG Series Sedona Kits User Guide v1.3

UI
UI , Universal Input component provides a means of reading the analog value connected to one
of the physical analog type points on a controller.
There are sixteen universal input points on EasyIO FG32 controller that support voltage, current,
resistance and temperature sensors.

The input type is selectable via UI configuration object in Sedona workbench and hardware on
board jumpers.
All sixteen channels are capable as universal input. Out value is in raw value and not scaled value.
You will need to use another object to scale the input value.

The property sheet of the object is shown below

 Channel
The input selection channel. Channel 1 ~ Channel 16

 Input Type
Defines the sensor type connected to the physical point and determines the
conversion algorithm.

Voltage, 0-10V
Current, 0-20mA
Resistance, up to 1 Mega Ohm

For temperature sensor connection, choose Resistance input type.


Link the out slot to a TempTable from the easyioSensor kit.
This output of the GenericTable32 object will give the temperature value
according to the input.

 Out
The output value of the input channel depending to the input type selection.

 Digital Out
The digital input value universal input is connected as a digital input.

54
EasyIO FG Series Sedona Kits User Guide v1.3

Temperature sensor option 1:


Example of UI, Universal Input as a temperature sensor input.
Choose the input type to Resistance; link the out of the UI to a genericTable32 object.
Configure the GenericTable32 according to the sensor resistance versus temp value table.

Temperature option 2:
Example of UI, Universal Input as a temperature sensor input.
Choose the input type to Resistance; link the out of the UI to a PresetTempTable object.
Configure the PresetTempTable according to the sensor type.

Example of UI, Universal Input with a voltage input


Choose the input type to voltage0to10; link the out of the UI to a reset object.(Reset object is
available from Tridium control kit)
Configure the ResetIn Min, In Max, Out Min and Out Max. It will automatically scale the output.

55
EasyIO FG Series Sedona Kits User Guide v1.3

Example of UI, Universal Input with a current input


Choose the input type to current0to20; link the out of the UI to a reset object.(Reset object is available
from Tridium control kit)
Configure the ResetIn Min, In Max, Out Min and Out Max. It will automatically scale the output.

UO
UO ,UniversalOutput component provides component provides an interface to the physical
analogue output point that can source/drive a 0 to 20mA current or0 to 10V voltage signal.

The output type is selectable via UO configuration object in Sedona workbench and hardware on
board jumpers.

There are eight universal output points on EasyIO FG32 controller that support voltage and
current.

The property sheet of the object is shown below

 Channel
The input selection channel. Channel 1 – Channel 8

 Output Type
Defines the output type

Voltage , 0 – 10 Vdc
Current , 0 – 20mA Vdc
Percentage, 0-10Vdc
Percentage, 0-20 mA Vdc
Percentage, 4-20mA Vdc

 Out
Output of the channel in raw value according output type selection.

56
EasyIO FG Series Sedona Kits User Guide v1.3

If percentage is selected, the output value is automatically scale according to


input. Output will display 0-100% instead of raw value.

 In
Input in raw value according to the output type of the Universal Output
channel.

57
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGDDC
**This kit is no longer being used as it is superseded by easyioFG kit. The easyioFGDDC
kit is merged into easyioFG kit in version 2.0.2.0.01 onwards. **

However this kit is backward and forward compatible.


For new deployment, DO NOT use this kit.

58
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGBacnet
This kit only applicable to EasyIO FG32 controller.
This kit contains 15 objects as show below. Both BACnet Server and BACnet Client drivers utilize
this kit.
To use any of the objects simply drag and drop from the library into the wire sheet.

BACnetService
BACnetService is an object that represents the EasyIO FG Series BACnet Driver stack.
The object can be drop anywhere in within the Sedona apps. It is advisable to create a folder for
BACnet service. Refer to BACnet user guide for further details.
The property sheet of the object is shown below.

59
EasyIO FG Series Sedona Kits User Guide v1.3

 IP Enable
Enable or disable the BACnet IP stack.

True = Enable
False = Disable

 IP Status
Display status of the IP port.

 IP Fault Cause
This property displays the IP port error.
It will display error message if the IP port not configured properly.

 IP
The property will display the IP address of the connected controller.
This is a read only property as the IP address is configured in the IP object under
the service folder.

 IP Mac
The property will display the MAC address of the connected controller.

 IP Port
BACnet IP UDP port.
User can change the default BACnet port 47808 to a valid port number.

60
EasyIO FG Series Sedona Kits User Guide v1.3

 IP Max APDU
Read property only.
Display the APDU value.

 IP Seg Support.
Display the APDU segmentation status for BACnet IP.

0 = not supported
1 = supported

 MSTP Enable
Enable or disable the MSTP stack.

True = Enable
False = Disable

 MSTP Status
Displays status of the MSTP port.

 MSTP Fault Cause


This property displays the MSTP port error.
It will display error message if the MSTP port not configured properly.

 MSTP COM Port


Read Only property.
Only port 1 is enable for Bacnet MSTP.

 MSTP Baud Rate


MSTP Baud Rate configuration.

 MSTP MAC
MSTP Mac address.

 MSTP Max APDU


Read property only.
Display the APDU value.

 MSTP Seg Support.


Display the APDU segmentation status for BACnet MSTP.

0 = not supported
1 = supported

61
EasyIO FG Series Sedona Kits User Guide v1.3

BACServerNetwork
BACServerNetwork is a Network object that enables the EasyIO FG series to run as BACnet Server
device.

BACnetServerNETwork must be a child component of BACnetService.

The property sheet of the object is shown below.

 Status
Status of the network.

 Fault Cause
Display the BACnet Server service version.
 Enable
Display the BACnet Server service version.
 Object ID
This is the Device Instance ID. By default it is 11.
 Server Name
Property to define the device name.
The name will display as per setup in any bacnet client software.

 Firmware Revision
Displays the bacnet protocol firmware revision.
62
EasyIO FG Series Sedona Kits User Guide v1.3

 Protocol Revision
Displays the bacnet protocol revision.

 Application Revision
Displays the bacnet protocol application revision.

 IP service status
This property displays the IP stack availability as a server.
If the IP stack is Enable, this property will display as OK.

 MSTP service status


This property displays the MSTP stack availability as a server.
If the MSTP stack is Enable, this property will display as OK.

BACServerAV
BACServerAV is a standard BACnet Analog object.
This object is used to broadcast to a BACnet Client as a standard BACnet Analog Value.
The property sheet of the object is shown below

 Status
Status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the broadcast.
 Instance Number
Assign an instance number for the BACnet AV export.
At the time of the document range is 0 – 127.

 Object Name
63
EasyIO FG Series Sedona Kits User Guide v1.3

By default the name for each Analog Value is Analog Value XX where XX
represent the instance number.
A user define description can be substitute. Max length is 16 characters.
 Out
Output value of the object.

 In1 ~ In16
Input value to the object.
16 priority level available.

 Relinquish Default
Relinquish default value if all input properties are “nan” value.

BACServerBV
BACServerBV is a standard BACnet Binary object.
This object is used to broadcast to a BACnet Client as a standard BACnet Binary Value.
The property sheet of the object is shown below

 Status
Status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the broadcast.
 Instance Number
Assign an instance number for the BACnet BV export.
At the time of the document range is 0 – 127.

64
EasyIO FG Series Sedona Kits User Guide v1.3

 Object Name
By default the name for each Analog Value is Binary Value XX where XX
represent the instance number.
A user define description can be substitute. Max length is 16 characters.
 Out
Output value of the object.

 In1 ~ In16
Input value to the object.
16 priority level available.

 Relinquish Default
Relinquish default value if all input properties are “nan” value.

BACnetClientNETwork
BACnetClientNETwork is an object that represents the EasyIO FG Series BACnet Client driver.

**Note: BACnetClientNetwork is a child component of BACnetService.

The property sheet of the object is shown below

65
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Displays status of the BACnet Client network.

 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the network.
 IP Net Num
Property to define the IP stack network number.
 MSTP Net Num
Property to define the MSTP stack network number.
 IP Service Status
This property displays the IP stack availability as a BACnet Client.
If the IP stack is enabled, this property will as OK.

 MSTP Service Status


This property displays the MSTP stack availability as a BACnet Client.
If the MSTP stack is enabled, this property will as OK.

 Write On Start
Perform a write whenever the apps start.

 Write On Up
Perform a write whenever the device transition from down to online.

66
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientDevice
BACnetClientDevice must be child of BACnetClientNetwork.
This user guide is base on Sedona Framework. BACnet device has to be manually added into the
client network.

If CPT Tool is used instead, the custom BACnet device discovery pane will display.
This pane enable user to perform BACnet device discovery.

Image below display the CPT BACnet device discovery user interface.

**Note: BACnetClientDevice is a child component of BACnetClientNetwork.

BACnetClientDevice is a child of BACnetClientNetwork.

67
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Status of the bacnet device.

 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the device polling.
 Datalink
Data link for the subscribed BACnet device.
Either MSTP or IP.
 Device ID
Subscribed BACnet Device ID.
 Device Name
Subscribed BACnet Device Name.
In this example, EasyIO FC 20 controller is used.

 MAC address
Subscribed BACnet Device MAC address.

 Min Write Time


Min write time is a property where the driver will wait for a period define by
user before it sent a rewrite.

0 = min write time disable. Changes in value are written immediately.


>1 = write will be perform after the timer is expired.

68
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientAI
BACnetClientAI is an object that represents a BACnet Analog Input object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.

BACnetClientPoint is a child of BACnetClientDevice.

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.

69
EasyIO FG Series Sedona Kits User Guide v1.3

 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Present Value
Present Value of the subscribed point.

BACnetClientAO
BACnetClientAO is an object that represents a BACnet Analog Output object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.

70
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

71
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientAV
BACnetClientAV is an object that represents a BACnet Analog Value object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.

72
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

73
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientBI
BACnetClientBI is an object that represents a BACnet Binary Input object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.

BACnetClientPoint is a child of BACnetClientDevice.

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.

74
EasyIO FG Series Sedona Kits User Guide v1.3

 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Present Value
Present Value of the subscribed point.

BACnetClientBO
BACnetClientBO is an object that represents a BACnet Binary Output object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.

75
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

76
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientBV
BACnetClientBV is an object that represents a BACnet Binary Value object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.

The property sheet of the object is shown below

77
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

BACnetClientMI
BACnetClientMI is an object that represents a BACnet Multi State Input object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.

BACnetClientPoint is a child of BACnetClientDevice.


78
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Present Value
Present Value of the subscribed point.

BACnetClientMSO
BACnetClientMSO is an object that represents a BACnet Multi State Output object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.


79
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

80
EasyIO FG Series Sedona Kits User Guide v1.3

BACnetClientMSV
BACnetClientMSV is an object that represents a BACnet Multi State Value object.

**Note: BACnetClientPoint object is a child component of BACnetClientDevice.**

BACnetClientPoint is a child of BACnetClientDevice.

81
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Property displays the status of the point.
 Fault Cause
Property displays fault error message.
 Enable
Enable or disable the BACnet point polling.
 Object ID
BACnet point ID.
 Point Name
Subscribed BACnet point name.
 Write Fault Cause
Displays the write fault cause if there is an error writing a value to the
subscribed point.
 Present Value
Present Value of the subscribed point.
 In1 ~ In16
Input value for the object.
Total number of 16 priority level available.

 Read Write
Property to enable/disable the ReadWrite access.
If read write is disabled, writing a value into any priority level is ignored.

82
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGBACClient

**This kit is no longer being used as it is superseded by easyioFGBacnet kit. The


easyioFGBACClient kit is merged into the easyioFGBacnet kit in version 1.0.45.33.0
onwards. **

However this kit is backward and forward compatible.


For new deployment, DO NOT use this kit.

EasyioFGBACSvr
**This kit is no longer being used as it is superseded by easyioFGBacnet kit. The
easyioFGBACClient kit is merged into the easyioFGBacnet kit in version 1.0.45.33.0
onwards. **

However this kit is backward and forward compatible.


For new deployment, DO NOT use this kit.

EasyioFGDriver
This kit contains 3 objects as show below.
This is an internal kit. This is use for 3rd party driver development as the base driver.
Dropping/adding these objects into the Sedona apps does nothing.

83
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGLcd kit
This kit contains 15 objects as show below.
To use any of the objects simply drag and drop from the library into the wire sheet.

The hierarchy of the LCD service is as below.

FGLcd Service object is a child of Service folder


Page object is a child of the FGLcd Service object
Line object is a child of the Pagex object.

84
EasyIO FG Series Sedona Kits User Guide v1.3

Line objects are are objects as image below.

FGLcdServerService
FGLcdServerService is service object that drop in to the service folder wire sheet in order for the
LCD to display values.

It is not necessary to drop the LCDService under the service folder. It can be anywhere in the
apps.

The property sheet of the object is shown below

 Enable
FGLcd service can be enable or disable with this parameter.

 Title
This slot will be the display name of the controller when view at the LCD. It
support max 13 characters.

 Status
Status of the FGLcd Service object. It will show error when the LCD device might
be having same port with other application. It will show “cannot bind to port.”

 Last Client Address


Shows the latest client connected to the server object. Client is the EasyIO LCD
device.

 Port
By default the server port is 59905. However it is not supported with other port
number at the moment.

85
EasyIO FG Series Sedona Kits User Guide v1.3

LcdBool
LcdBool is a Boolean object and child object that sits under the “page” object. It is used to
display Boolean point in the LCD display.

It can be either read-only object or writable object.

The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 Access Right
Selection between Read-only or Writable.
If writable is selected , title will be in Bold is view from the LCD

 True Text
True text to be shown in the LCD display

 False Text
True text to be shown in the LCD display

 In
Input value of the object. When the object configured as read-only , input is link
from another object within the Sedona apps.

 Out
Output value of the object. When the object configured as writable, output is
link to another object within the Sedona apps for control.

86
EasyIO FG Series Sedona Kits User Guide v1.3

Example of configuring LcdBool as a writable point. Make sure you link to an object in the sedona
apps that would be control by the LCD writable point.

Example of configuring LcdBool as a read-only point. Make sure you link from an object in the sedona
apps that would be monitor by the LCD read-only point.
3
87
EasyIO FG Series Sedona Kits User Guide v1.3

LcdBoolOneShot
LcdBoolOneShot is a Boolean object and child object that sits under the “page” object. It is used
to control Boolean point from the LCD display for a define time period.
It is a writable object.
The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 True Text
True text to be shown in the LCD display

 False Text
True text to be shown in the LCD display

 Retrigger Enable
This property can be set to enable is re-trigger is required.

 Trigger period
Period of the trigger period in seconds.

 Trigger Value
Output Value when object is triggered.

 In
Input Constant value.

 Out
Current Output Value. The control algorithm is a below.

If the input is set to true , trigger value set to false , when a trigger fire
Output = false according to the period time.

If the input is set to false , trigger value set to true , when trigger is fire
Output = true according to the period time.

88
EasyIO FG Series Sedona Kits User Guide v1.3

Example 01 of LcdBoolOneShoot,

In = true
Trigger value = false
Out = In ,
When object is trigger output = false for 5secs.

89
EasyIO FG Series Sedona Kits User Guide v1.3

Example 02 of LcdBoolOneShoot,

In = false
Trigger value = true
Out = In ,
When object is trigger output =true for 5secs.

90
EasyIO FG Series Sedona Kits User Guide v1.3

LcdBoolOverwrite
LcdBoolOverwerite is a Boolean object and child object that sits under the “page” object. It is
used to control/overwrite Boolean point from the LCD display. It is a permanent overwrite until
the overwrite is released.
It is a writable object from the LCD display.

It has 3 Selection ;

1. Auto , null value


2. Overwrite On
3. Overwrite Off

The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 Mode
Selection of mode available. This selection is available in the LCD display.

Auto , null value output. When this mode is selected , Out = In


Overwrite On. When this mode is selected , Out = Overwrite On Value
Overwrite Off.When this mode is selected , Out = Overwrite On Value

 Overwrite On Value
User define output value when mode selection is Overwrite On.

 Overwrite Off Value


User define output value when mode selection is Overwrite Off.
 In
Input constant value.

 Out
Current Output Value. The control algorithm is a below.

If the input is set to true , overwrite value On set to true , overwrite value Off set
to false ,
Mode = Auto
91
EasyIO FG Series Sedona Kits User Guide v1.3

Output = Input

If the input is set to true , overwrite value On set to true , overwrite value Off set
to false ,
Mode = Overwrite On
Output = Overwrite Value On = true

If the input is set to true , overwrite value On set to true , overwrite value Off set
to false ,
Mode = Overwrite Off
Output = Overwrite Value Off = false

Example of using the LcdBoolOverwrite object

92
EasyIO FG Series Sedona Kits User Guide v1.3

LcdDT
LcdDT is an object that displays the controller Real Time Clock in the page.
It also provides the capability to set the controller Real Time Clock from the page.
This object is drop under the page object.

The property sheet of the object is shown below.

 Title
Title to be display at the LCD screen.
Max 15 characters allowed.

 Out
Property displays the date and time.
This value will be display in the LCD screen.

LcdFloat
LcdFloat is a Float object and child object that sits under the “page” object. It is used to display
Float point in the LCD display.

It can be either read-only object or writable object.

The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.
 Access Right
Selection between Read-only or Writable.
If writable is selected, title will be in Bold is view from the LCD

93
EasyIO FG Series Sedona Kits User Guide v1.3

 Min
Min value that the LCD Float can display

 Max
Min value that the LCD Float can display

 Precision
The number of precision value that the float value will display in the LCD screen

 Unit
Engineering Unit that will be display next to the Float Value. This is a string value
and max of 15 characters supported.
 In
Input constant value

 Out
Output value to the LCD display

2
3
Example of configuring LcFloatl as a read-only point.

94
EasyIO FG Series Sedona Kits User Guide v1.3

Example of configuring LcdFloat as a writable point. The LcdFloat object is writing to a Setpoint
Object.

95
EasyIO FG Series Sedona Kits User Guide v1.3

LcdFloatOneShot
LcdFloatOneShot is a Float object and child object that sits under the “page” object. It is used to
control Float point from the LCD display for a define time period.
It is a writable object.
The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 Retrigger Enable
This property can be set to enable is re-trigger is required.

 Trigger period
Period of the trigger period in miliseconds.

 Trigger Value
Output Value when object is triggered.

 Precision
The number of precision value that the float value will display in the LCD screen

 Unit
Engineering Unit that will be display next to the Float Value. This is a string value
and max of 15 characters supported.

 In
Input Constant value.

 Out
Current Output Value. The control algorithm is a below.

If the input is set to X , trigger value set toY , when a trigger fire
Output = Y according to the period time.

96
EasyIO FG Series Sedona Kits User Guide v1.3

Example of LcdFloatOneShoot,

In = 24.00
Trigger value = 23.00
Out = Trigger Valuefor 5seconds when object is trigger from the LCD

Out = In after trigger period 5 second ends.

97
EasyIO FG Series Sedona Kits User Guide v1.3

LcdFloatOverwrite
LcdFloatOverwerite is a Float object and child object that sits under the “page” object. It is used
to control/overwrite Float point from the LCD display. It is a permanent overwrite until the
override is released.

It is a writable object from the LCD display.

It has 3 Selection;

4. Auto , null value


5. Overwrite On
6. Overwrite Off

The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 Mode
Selection of mode available. This selection is available in the LCD display.

Auto , null value output. When this mode is selected , Out = In


Overwrite On. When this mode is selected , Out = Overwrite On Value
Overwrite Off.When this mode is selected , Out = Overwrite On Value

 Overwrite On Value
User define output value when mode selection is Overwrite On.

 Overwrite Off Value


User define output value when mode selection is Overwrite Off.

 In
Input constant value.

98
EasyIO FG Series Sedona Kits User Guide v1.3

 Out
Current Output Value. The control algorithm is a below.

If the input is set to X , overwrite value On = Y , overwrite value Off = Z ,


Mode = Auto
Output = X

If the input is set toX , overwrite value On = Y , overwrite value Off = Z ,


Mode = Overwrite On
Output = Overwrite Value On = Y

If the input is set toX , overwrite value On = Y , overwrite value Off = Z ,


Mode = Overwrite Off
Output = Overwrite Value On = Z

Example of using the LcFloatlOverwrite object

LcdInt
LcdInt is an Integer object and child object that sits under the “page” object. It is used to display
Float point in the LCD display.

It can be either read-only object or writable object.

The property sheet of the object is shown below

99
EasyIO FG Series Sedona Kits User Guide v1.3

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 Access Right
Selection between Read-only or Writable.
If writable is selected, title will be in Bold is view from the LCD

 Min
Min value that the LCD Integer can display

 Max
Min value that the LCD Integer can display

 Precision
The number of precision value that the float value will display in the LCD screen

 Unit
Engineering Unit that will be display next to the Float Value. This is a string value
and max of 15 characters supported.
 In
Input constant value

 Out
Output value to the LCD display

100
EasyIO FG Series Sedona Kits User Guide v1.3

2
3

Example of configuring LcFloatl as a read-only point.

101
EasyIO FG Series Sedona Kits User Guide v1.3

Example of configuring LcdInt as a writable point. The LcdInt object is writing to a object.

102
EasyIO FG Series Sedona Kits User Guide v1.3

LcdSchedule
LcdSchedule is a Integer object and child object that sits under the “page” object. It is used to
display EasyIO schedule object in the LCD display.

This object will replicate the EasyIO schedule in the Sedona apps and display it in the LCD display.
User can edit the schedule from the LCD display with the same format as EasyIO schedule object.
Please refer to EasyIO Sedona kits, easyioSchedule for schedule editing format.
The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen.
Max 15 characters.

 True text
Text that will appear in the LCD display next to the title

 True text
Text that will appear in the LCD display next to the title

 In
Input constant value.
This slot has to be link from a easyioSchedule kit object.

 Out
Output value to other objects to be control.

Example of using the LcdSchedule object in the sedona apps.

Page
Page is a child object for easyioLcdService. It must be a child of the LCD service. This object will
determine the page that will display in the LCD display.

Max number of pages allowed per controller at the moment is 99 pages.


103
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Title
Title for the point to be shown in the LCD screen page view. This title will appear
on top of the page.
Max 15 characters are allowed.

Title is not used for hpage.

writeDt
WriteDt is an object for setting/writing the time in to the EasyIO Sedona controller Real Time
Clock.
This object enable user to set the Real Time Clock from the LCD screen.

 Year
Year, range 2000-2099

 Month
Month, range 1-12

 Day
Day, range 1-31

 Hour
Hour, range 0-23
24 hours format.

 Minute
Minute, range 0-59

 Seconds
Seconds, range 0-59

104
EasyIO FG Series Sedona Kits User Guide v1.3

Example of setting the time of a Sedona controller.


The out lost of the line object is lined to the writeDt object, this will write to the Sedona dateTime
service.

The In slot in then link from the dateTime service to view the current time. This creates a mean of
time sync/set time for a Sedona controller.

105
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGLicense
This kit contains 1 object as show below.
To use any of the objects simply drag and drop from the library into the wire sheet.
Recommend to drop the object into the service folder.

License
License object is for future kits development use.

 Fault Cause
Shows the fault cause of the object.

 Host ID
Host ID use to generate Unlock Code.

 Unlock Code
Unlock Code field.

 Expired Date
Expiry date is applicable.

106
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGMail
This kit contains 5 objects as show below.
To use any of the objects simply drag and drop from the library into the wire sheet.
Recommend to drop the service object in to the service folder.

BoolAlarm
BoolAlarm is an object to monitor Boolean type of data, which will trigger the alarm once the
Boolean value changed from false to true.

The property sheet of the object is shown below

107
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
To show current status of the BoolAlarm, indicated by either “Alarm” or
“Normal”.

 In
Input point with Boolean type. Alarm will be triggered once it changed from
false to true (normal to off normal).

 Escalation Level1 Enable


Enable or disable the level1 alarm escalation.

 Escalation Time1
Delay time of the alarm escalation, in minute (min). 1 min means escalation
alarm will occur 1 min after the first alarm. Default to its minimum value, 1 min.

 Escalation Level2 Enable


Enable or disable the level2 of alarm escalation.

 Escalation Time2
Delay time of the alarm escalation, in minute (min). 2 min means escalation
alarm will occur 2 min after the first alarm. Default to its minimum value, 2 min.

 Escalation Level3 Enable


Enable or disable the level3 of alarm escalation.

 Escalation Time3
Delay time of the alarm escalation, in minute (min). 3 min means escalation
alarm will occur 3 min after the first alarm. Default to its minimum value, 3 min.

 Use Alarm Test as Subject


This property allow users to select the email subject.

True = alarm message will the subject of the email instead of subject set in
the SMTP service object.
False = subject of the email is the subject set in the SMTP service object.

 To Off normal Text


The text message to be sent as the information for recipients, as the Boolean
input changed from normal to off normal.

 To Normal Text
The text message to be sent as the information for recipients, as the Boolean
input changed from off normal to normal.

 Alarm Inhibit
Inhibit the email alarm sending. Only email will not be send.
Alarm status will display as normal.

108
EasyIO FG Series Sedona Kits User Guide v1.3

Example of configuring the Boolean point for Alarm Email

DnsService
DnsService is used to retrieve the IP address, corresponding to a given hostname.

For example:
Hostname: www.google.com
IP address: 209.85.175.104

User will be needed to provide the hostname, and DnsService will return with the
corresponding IP address.

**Note: DnsService must be drop inside Service folder (Sedona -> App -> Service).

The property sheet of the object is shown below

 Prefer Dns
109
EasyIO FG Series Sedona Kits User Guide v1.3

IP address of Preferred DNS server used to lookup the IP address of the given
hostname.

 Alter Dns
IP address of Alternate DNS server, as a backup in the case that Prefer Dns not
working.

 Timeout
User defined time length to wait, before the DNS server giving a response, in
milliseconds (ms). Default to its minimum value, 2000ms.

 Last Query
The last query (hostname) sent to DNS server.

 Last Result
The last response (corresponding to Last Query) receives from the DNS server.

 Retrieve
Is use to test the internet connection. Any URL address will do.

Text input area allowed users to insert the hostname, which the IP address
corresponding to this hostname will be retrieved through DNS server’s response

110
EasyIO FG Series Sedona Kits User Guide v1.3

FloatAlarm
FloatAlarm is an object to monitor Float type of data, which will trigger the alarm once the Float
value is out of its preset High or Low limit.

The property sheet of the object is shown below

 Status
To show current status of the BoolAlarm, indicated by either “Alarm” or
“Normal”.

 In
Input point with Float type. Alarm will be triggered when its value out of either
the preset High or Low limit.

 Escalation Level1 Enable


Enable or disable the level1 of alarm escalation.

111
EasyIO FG Series Sedona Kits User Guide v1.3

 Escalation Time1
Delay time of the alarm escalation, in minute (min). 1 min means escalation
alarm will occur 1 min after the first alarm. Default to its minimum value, 1 min.

 Escalation Level2 Enable


Enable or disable the level2 of alarm escalation.

 Escalation Time2
Delay time of the alarm escalation, in minute (min). 2 min means escalation
alarm will occur 2 min after the first alarm. Default to its minimum value, 2 min.

 Escalation Level3 Enable


Enable or disable the level3 of alarm escalation.

 Escalation Time3
Delay time of the alarm escalation, in minute (min). 3 min means escalation
alarm will occur 3 min after the first alarm. Default to its minimum value, 3 min.

 Use Alarm Test as Subject


This property allow users to select the email subject.

True = alarm message will the subject of the email instead of subject set in
the SMTP service object.
False = subject of the email is the subject set in the SMTP service object.

 High Limit Text


The text message to be sent as the information for recipients, as the Float input
exceeds the High Limit.

 Low Limit Text


The text message to be sent as the information for recipients, as the Float input
less than the Low Limit.

 To Normal Text
The text message to be sent as the information for recipients, as the Float input
fall between High and Low limit.

 High Limit
Upper limit for the Float type input.

 Low Limit
Low limit for the Float type input.

 Deadband
High alarm = High Limit + Deadband
Low alarm = Low Limit – Deadband

 Alarm Inhibit
Inhibit the email alarm sending. Only email will not be send.
Alarm status will display as normal.

112
EasyIO FG Series Sedona Kits User Guide v1.3

Example of configuring the Float point for Alarm Email

FloatAlarmEd
FloatAlarmEd is a same object as FloatAlarm but with a delay of sending emails.
All the properties are the same.

The property sheet of the object is shown below

113
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
To show current status of the BoolAlarm, indicated by either “Alarm” or
“Normal”.

 In
Input point with Float type. Alarm will be triggered when its value out of either
the preset High or Low limit.

 Delay Enable
Enable the email sending delay.

True = enable delay


False = disable delay

 Delay time
Time period to delay the email sending.

 Escalation Level1 Enable


Enable or disable the level1 of alarm escalation.

 Escalation Time1
Delay time of the alarm escalation, in minute (min). 1 min means escalation
alarm will occur 1 min after the first alarm. Default to its minimum value, 1 min.

 Escalation Level2 Enable


Enable or disable the level1 of alarm escalation.

 Escalation Time2
Delay time of the alarm escalation, in minute (min). 2 min means escalation
alarm will occur 2 min after the first alarm. Default to its minimum value, 2 min.

 Escalation Level3 Enable


Enable or disable the level3 of alarm escalation.

 Escalation Time3
Delay time of the alarm escalation, in minute (min). 3 min means escalation
alarm will occur 3 min after the first alarm. Default to its minimum value, 3 min.

 Use Alarm Test as Subject


This property allow users to select the email subject.

True = alarm message will the subject of the email instead of subject set in
the SMTP service object.
False = subject of the email is the subject set in the SMTP service object.

 High Limit Text


The text message to be sent as the information for recipients, as the Float input
exceeds the High Limit.

 Low Limit Text


The text message to be sent as the information for recipients, as the Float input
less than the Low Limit.

 To Normal Text

114
EasyIO FG Series Sedona Kits User Guide v1.3

The text message to be sent as the information for recipients, as the Float input
fall between High and Low limit.

 High Limit
Upper limit for the Float type input.

 Low Limit
Low limit for the Float type input.

 Deadband
High alarm = High Limit + Deadband
Low alarm = Low Limit – Deadband

 Alarm Inhibit
Inhibit the email alarm sending. Only email will not be send.
Alarm status will display as normal.

Example of configuring the Float point for Alarm Email

115
EasyIO FG Series Sedona Kits User Guide v1.3

SmtpService
SmtpService is an object to provide the email service for the Alarm objects (BoolAlarm and
FloatAlarm) mentioned above. When an alarm is triggered, SmtpService will send the message as
configured, to the recipients.

**Only non-SSL smtp server is supported at the moment. **

**Note: SmtpServicemust be drop inside Service folder (Sedona -> App -> Service).

The property sheet of the object is shown below

 Enable
Enable or disable the SmtpService.

 Fault Cause
To show cause of the error, when there was SmtpServicefailure.

 Host Name
The email server host name, for the SmtpService to send the email to recipients.

 Host Ip
The IP address corresponding to the Host Name.

116
EasyIO FG Series Sedona Kits User Guide v1.3

 Port
The port number that used by SmtpService to send email.

 Socket Timeout
User defined time length to wait, before the TCP Socket for communication is
closed. Default to its minimum value, 5000ms.

 Request Timeout
User defined time length to wait, before the SmtpService getting a response, in
milliseconds (ms). Default to its minimum value, 5000ms.

 State
State of the socket, whether Open or Close.

 To Offnormal
To be set by user, whether true or false. If true, email will be sent when
BoolAlarm/FloatAlarm changed from normal to offnormal, vice versa when set
to false.

 To Normal
To be set by user, whether true or false. If true, email will be sent when
BoolAlarm/FloatAlarm changed from offnormal to normal, vice versa when set
to false.

 Account
Email account that will be used to send the email.

 Password
Password of the email’s Account.

 Subject
Email’s subject.

 Recipient
Recipient(s) email address. Support multiple recipients by using semicolon (;) or
comma (,).
Example: abc@easyio.com;def@easyio.com
abc@easyio.com,def@easyio.com

 Greeting
The greeting words at the beginning of the email. User may customize the
getting message to provide information such as device name and location.
Example of email sent:

117
EasyIO FG Series Sedona Kits User Guide v1.3

 Email Text
The contents of last email sent, by SmtpService.

 Test

Text input area allowed users to enter email contents, to test the functionality of
SmtpService. All properties of SmtpService have to be properly set before
invoke this action.

118
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGMathConversion
This kit contains 22 objects. All the objects are to be used for mathematics calculations.

All the objects are derive from the C++ reference library. For details explainaton , refer to
http://www.cplusplus.com/reference/clibrary/cmath/sin/

This kit is hardware dependent. It requires an EasyIO FG series controller to be able to use it.

To use any of the objects simply drag and drop from the library into the wire sheet. .

ArcCosine
Arccos or ArcCosine object.

The property sheet of the object is shown below

119
EasyIO FG Series Sedona Kits User Guide v1.3

ArcSine
Arcsin or ArcSine object

The property sheet of the object is shown below

Arc Tangent
Arctan or ArcTangent object

The property sheet of the object is shown below

Arc Tangent 2
Arctan2 or Arc Tangent with 2 parameters

The property sheet of the object is shown below

120
EasyIO FG Series Sedona Kits User Guide v1.3

Ceiling
Ceil or Round Up Value object
Returns the smallest integral value that is not less than x.
The property sheet of the object is shown below

Cosine
Cos or Cosine object

The property sheet of the object is shown below

Cosine Hyperbolic
Cosh or hyperbolic cosine Object

The property sheet of the object is shown below

121
EasyIO FG Series Sedona Kits User Guide v1.3

Exponential
Exp or Exponential Object

The property sheet of the object is shown below

Float Absolute
Fabs or Absolute value of input

The property sheet of the object is shown below

Floor
Floor or Round Down Value object

The property sheet of the object is shown below

122
EasyIO FG Series Sedona Kits User Guide v1.3

FMod
Fmod or Remainder of the Division of input

The property sheet of the object is shown below

Frexp
Frexp or Get significand and exponent

The property sheet of the object is shown below

Ldexp
Ldexp or Generate number from significant and exponent object

The property sheet of the object is shown below

123
EasyIO FG Series Sedona Kits User Guide v1.3

Log
Log or compute natural logarithm

The property sheet of the object is shown below

Log 10
Log10 or compute common logarithm of input object

The property sheet of the object is shown below

ModF
Modf or break in fractional and integral parts of the input.

Power
Pow or raise to power object

The property sheet of the object is shown below

124
EasyIO FG Series Sedona Kits User Guide v1.3

Sine
Sin or compute sin object

The property sheet of the object is shown below

Sine Hyperbolic
Sinh or hyperbolic sine object

The property sheet of the object is shown below

Square Root
Sqrt or compute square root object

The property sheet of the object is shown below

125
EasyIO FG Series Sedona Kits User Guide v1.3

Tangent
Tan or compute Tangent object

The property sheet of the object is shown below

Tangent Hyperbolic
Tanh or compute hyperbolic tangent object

The property sheet of the object is shown below

126
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGMbSlave
This kit contains 6 objects. All the objects are to be used for Modbus Slave configuration only.

Only COM2 is available for Modbus Master Driver.

For details of each object refer to the Sedona kit user guide.
To use any of the objects simply drag and drop from the library into the wire sheet. .

127
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusSlaveSerialNetwork
ModbusSlaveSerialNetwork uses the built in Modbus driver to broadcast Modbus register to
3rd party Modbus Master Device via the RS-485 port 2.
Only port 2 is available for Modbus driver use.

The object can be anywhere within the Sedona apps. It can also be drop in to separate folder for
easy management purpose.

The property sheet of the object is shown below

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Version
Shows the version of the driver.

 Long Byte Order


Selection for Long Data type registers byte order.

 Float Byte Order


Selection for Float Data type registers byte order.

128
EasyIO FG Series Sedona Kits User Guide v1.3

 Use last Value on Start


On start of the controller, the last saved value will be used.

 Com Lost State


Property displays the Modbus Com connection state to a Modbus Master.

true : Modbus com between EasyIO FG and Modbus Master is down


false :Modbus com between EasyIO FG and Modbus Master is online

 Com Lost Interval


Com lost interval time polling.

 Port
On board RS-485 port number in use.

 Baud rate
Serial port baud rate, 1200 – 115200
Default baud rate is at 19.2K

EasyIO FG Series Modbus Serial default baud rate is at 19.2K

 Data bit
Serial port data bit, 7 or 8

 Stop bit
Serial port stop bit, 1 or 2

 Parity
Serial port parity.

0 = None
1 = Odd
2 = Even

 Serial ID
Serial ID for FG controller as Modbus Slave device.

ModbusSlaveTCPNetwork
ModbusSlaveTCPNetwork uses the built in Modbus driver to broadcast Modbus register to 3rd
party Modbus Master Device via the TCP port.

The object can be anywhere within the Sedona apps. It can also be drop in to separate folder for
easy management purpose.

The property sheet of the object is shown below

129
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Version
Shows the version of the driver.

 Long Byte Order


Selection for Long Data type registers byte order.

 Float Byte Order


Selection for Float Data type registers byte order.

 Use last Value on Start


On start of the controller, the last saved value will be used.

 Com Lost State


Property displays the Modbus Com connection state to a Modbus Master.

true : Modbus com between EasyIO FG and Modbus Master is down


false :Modbus com between EasyIO FG and Modbus Master is online

 Com Lost Interval


Com lost interval time polling.
 TCP Port
Modbus TCP port.
Default is 502.
130
EasyIO FG Series Sedona Kits User Guide v1.3

 Socket Timeout
TCP socket connection time out period.
Default is 60000ms.

 Max Connection
Maximum Modbus TCP connection allowed.
Default is 4.

 Client Connected
Displays the total number of Modbus Master device connection number.

ModbusSvrCoilPoint
ModbusSvrCoilPoint maximum 200 Coil Output registers can be defined (ID: 0 - 119).
It has to be under any network type.
It only support “decimal” address format.

The property sheet of the object is shown below

131
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Address
Register address
0 – 199

 Out
Output value.

 In
Input value.

Example of a Modbus coil point driving a Boolean Writable object.

ModbusSvrDiscretePoint
ModbusSvrDiscretePoint maximum 200 Discrete Input registers can be defined (ID: 0 - 119).
It has to be under any network type.
It only support “decimal” address format.

The property sheet of the object is shown below

132
EasyIO FG Series Sedona Kits User Guide v1.3

133
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Register status. Readonly
true = valid
Fale = invalid

 Enable
Enable or disable the point broadcast.

 Address
Register address
0 – 199

 Out
Coil Output output value.

Example of a modbus coil point driving a Boolean Writable object.

ModbusSvrHoldingPoint
ModbusSvrHoldingPoint maximum 200 Holding Register can be defined (ID: 0 - 199). 200
Holding Register included floating point, 32-bit data type. Floating Point, 32-bit data occupy 2
register addresses where Integer Point, 16-bit occupies 1 register address. All addresses are
based-1.

For Holding Float and Holding Long register byte implement is according to big endian (byte
order = 3210).

Example:

Address Name Register Type


------- -------------------- --------------
0 SetPoint floating point (2 registers)
2 Duration 32-bit data (2 registers)
4 Count 16-bit data (1 register)
5 Delay 16-bit data (1 register)

The object has to be under a network.

134
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Register status. Readonly
true = valid
Fale = invalid

 Enable
Enable or disable the point broadcast.

 Address
Register address
0 – 199

 Data type
Selection of data type
Word : 16 bit register
Float : 32 bit register
Long : 32 bit register

 Scale
Scaling factor.

 Offset
Offset property to offset the actual value.

135
EasyIO FG Series Sedona Kits User Guide v1.3

 Out
Holding register output value.

Example of a ModbusSvrHoldingPoint writing another object.

136
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusSvrInputPoint
ModbusSvrInputPoint maximum 200 Input Register can be defined (ID: 0 - 199). 200 Input
Register included floating point, 32-bit data type. Floating Point, 32-bit data occupy 2 register
addresses where Integer Point, 16-bit occupies 1 register address. All addresses are based-1.

For Input Float and Holding Long register byte implement is according to big endian (byte order =
3210).

Example:

Address Name Register Type


------- -------------------- --------------
0 SetPoint floating point (2 registers)
2 Duration 32-bit data (2 registers)
4 Count 16-bit data (1 register)
5 Delay 16-bit data (1 register)

The object has to be under a network.

The property sheet of the object is shown below

 Status
Register status. Readonly
true = valid
Fale = invalid

 Enable
Enable or disable the point broadcast.
137
EasyIO FG Series Sedona Kits User Guide v1.3

 Address
Register address
0 – 199

 Data type
Selection of data type
Word : 16 bit register
Float : 32 bit register
Long : 32 bit register

 Scale
Scaling factor.

 Offset
Offset property to offset the actual value.

 In
Input register input value.

Example of a ModbusSvrInputPoint receiving value from another object.

138
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGModbus
This kit contains 12 objects. All the objects are to be used for Modbus Master Slave configuration
only.
Modbus Master and Slave configuration is a unique configuration where , the EasyIO FG Series
Sedona controller as a Modbus Master Controller and Modbus Slave controller connecting to the RS-
485 com port.
Only COM2 is available for Modbus Master Driver.

For details of each object refer to the Sedona kit user guide.

To use any of the objects simply drag and drop from the library into the wire sheet. .

ModbusSerialNetwork
ModbusSerialNetwork uses the built in Modbus driver to connect to Modbus Serial Slave
devices.
Only port number 2 is available for this driver.

The object can be anywhere within the Sedona apps. It can also be drop in to separate folder for
easy management purpose.

The property sheet of the object is shown below

139
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Version
Displays the version of the driver.

 Trace
Debug mode for the driver.
Debug mode can only be view with special debug cable.

True : enable
False : disable

140
EasyIO FG Series Sedona Kits User Guide v1.3

 Max Write Time


Max write time is a property where the driver will perform a rewrite after the
time period is expired.

0 = max write time disable


>1 = rewrite will be perform after the timer is expired.

 Write on Start
Perform a write whenever the COM/Device has started the driver.
True= enable
False = disable

 Write on Up
Perform a write whenever the COM/Device is up.
True= enable
False = disable

 Ping Frequency
Time period for the driver to check the slave device health.

 Retry Count
Total number of retry before the driver stops data polling.

 Fast Poll
Defines the fast polling policy interval.
Default value is 100ms

 Normal Poll
Defines the fast polling policy interval.
Default value is 500ms

 Slow Poll
Defines the slow polling policy interval.
Default value is 3000ms

 Time Per Cycle


Time period in ms for each complete poll cycle.

 Inter Message Delay


Defines the number of character to pause before next poll.

 Request timeout
Time period for waiting before a retry.
Default is 500ms.

 Port
RS -485 port for the driver to poll data.
Only port 2 is available.

 Baudrate
Serial port baudrate, 1200 – 115200
Default baud rate set is at 19.2K

EasyIO FG Series Modbus Serial default baud rate is at 19.2K


141
EasyIO FG Series Sedona Kits User Guide v1.3

 Databit
Serial port data bit, 7 or 8

 Stopbit
Serial port stop bit, 1 or 2

 Parity
Serial port parity.

0 = None
1 = Odd
2 = Even

ModbusSerialDevice
ModbusSerialDevice is a child component of ModbusSerialNetwork. It has to be under the
Network object.
**Note: ModbusSlaveDevice can only be a child of ModbusSlaveNetwork

Example below show the ModbusSlaveDevice is in a child oof the network.

The property sheet of the object is shown below

142
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Current status. Readonly

 Enable
Enable device.

 Address
Device Address in decimal

 Long Byte Order3210


Long type data (32-bit) byte order.
True = 3210
False = 1032

 Float Byte Order3210


Floating point type data byte order
True = 3210
False = 1032

 Force Multiple Coil


Property to enable Modbus Function Code 15.
If device supports Function Code 15, this property can be Enable.

 Force Multiple Register


Property to enable Modbus Function Code 16.
If device supports Function Code 16, this property can be Enable.

 Ping address
Addrees used to ping the device.
Some device need to ping a valid register address to able to received the ping
response.

 Ping Register Type


Address type used to ping.
143
EasyIO FG Series Sedona Kits User Guide v1.3

 Ping Data Type


Address data type used to ping.

ModbusTCPNetwork
ModbusTCPNetwork uses the built in Modbus driver to connect to Modbus TCP Slave devices.

The object can be anywhere within the Sedona apps. It can also be drop in to separate folder for
easy management purpose.

The property sheet of the object is shown below

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Version
Shows the version of the driver.

 Trace
Debug mode for the driver.
Debug mode can only be view with special debug cable.
144
EasyIO FG Series Sedona Kits User Guide v1.3

True : enable
False : disable

 Max Write Time


Max write time is a property where the driver will perform a rewrite after the
time period is expired.

0 = max write time disable


>1 = rewrite will be perform after the timer is expired.

 Write on Start
Perform a write whenever the COM/Device has started the driver.
True= enable
False = disable

 Write on Up
Perform a write whenever the COM/Device is up.
True= enable
False = disable

 Ping Frequency
Time period for the driver to check the slave device health.

 Retry Count
Total number of retry before the driver stops data polling.

 Fast Poll
Defines the fast polling policy interval.
Default value is 100ms

 Normal Poll
Defines the fast polling policy interval.
Default value is 500ms

 Slow Poll
Defines the slow polling policy interval.
Default value is 3000ms

 Time Per Cycle


Time period in ms for each complete poll cycle.

 Inter Message Delay


Defines the number of character to pause before next poll.

 Request timeout
Time period for waiting before a retry.
Default value is 2000ms.

145
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusTCPDevice
ModbusTCPDevice is a child component of ModbusTCPNetwork. It has to be under the Network
object.
**Note: ModbusTCPDevice can only be a child of ModbusTCPNetwork
Example below show the ModbusTCPDevice is in a child of the network

The property sheet of the object is shown below

146
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the device.

 Enable
Enable device.

 Address
Device Address in decimal

 Long Byte Order3210


Long type data (32-bit) byte order.
True = 3210
False = 1032

 Float Byte Order3210


Floating point type data byte order
True = 3210
False = 1032

 Force Multiple Coil


Property to enable Modbus Function Code 15.
If device supports Function Code 15, this property can be Enable.

 Force Multiple Register


Property to enable Modbus Function Code 16.
If device supports Function Code 16, this property can be Enable.

 Ping address
Register Address to send during device ping.

 Ping Register Type


Register Type to send during the device ping request.

 Ping Data Type


Register Data Type to send during device ping request.

 IP address
Ip address for the TCP slave device.

 Port
Modbus TCP communication port.
Default is 502.

147
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusTCPGateway
ModbusTCPGateway uses the built in Modbus driver to connect to Modbus TCP Gateway
device.
The object can be anywhere within the Sedona apps. It can also be drop in to separate folder for
easy management purpose.
The property sheet of the object is shown below

 Status
Status of the Modbus serial network

 Fault Cause
Displays the fault cause for the driver.

 Enable
Enable the serial port for Modbus serial data polling.

 Version
Shows the version of the driver.

 Trace
Debug mode for the driver.
Debug mode can only be view with special debug cable.
True : enable
False : disable
 Write on Start
Perform a write whenever the COM/Device has started the driver.
148
EasyIO FG Series Sedona Kits User Guide v1.3

True= enable
False = disable

 Max Write Time


Max write time is a property where the driver will perform a rewrite after the
time period is expired.

0 = max write time disable


>1 = rewrite will be perform after the timer is expired.

 Write on Up
Perform a write whenever the COM/Device is up.

True= enable
False = disable

 Ping Frequency
Time period for the driver to check the slave device health.

 Fast Poll
Defines the fast polling policy interval.
Default value is 100ms

 Normal Poll
Defines the fast polling policy interval.
Default value is 500ms

 Slow Poll
Defines the slow polling policy interval.
Default value is 3000ms

 Time Per Cycle


Time period in ms for each complete poll cycle.

 Inter Message Delay


Defines the number of character to pause before next poll.

 Request timeout
Time period for waiting before a retry.

 IP address
IP address of the Modbus TCP Gateway device connected.

 Port
Modbus communication port.
Default is 502.

ModbusTCPGatewayDevice
ModbusTCPGatewayDevice is a child component of ModbusTCPNetwork. It has to be under the
Network object.
149
EasyIO FG Series Sedona Kits User Guide v1.3

**Note: ModbusTCPDevice can only be a child of ModbusTCPGatewayNetwork


Example below show the ModbusTCPGatewayDevice is in a child of the network

The property sheet of the object is shown below

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the device.

 Enable
Enable device.

 Address
Device Address in decimal

 Long Byte Order3210


Long type data (32-bit) byte order.
True = 3210
False = 1032

150
EasyIO FG Series Sedona Kits User Guide v1.3

 Float Byte Order3210


Floating point type data byte order
True = 3210
False = 1032

 Force Multiple Coil


Property to enable Modbus Function Code 15.
If device supports Function Code 15, this property can be Enable.

 Force Multiple Register


Property to enable Modbus Function Code 16.
If device supports Function Code 16, this property can be Enable.

 Ping address
Register Address to send during device ping.

 Ping Register Type


Register Type to send during the device ping request.

 Ping Data Type


Register Data Type to send during device ping request.

151
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusCoilPoint
ModbusCoilPoint is a child component of any Modbus device. It has to be under any network
type.
It only support “decimal” address format.

The property sheet of the object is shown below

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message
152
EasyIO FG Series Sedona Kits User Guide v1.3

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Out
Point out value.

 Read Write
Enable read write.

True = read write


False = read only

 In
Point In value.
This is use if Read Write is Enable.
If read write is disable, this is ignored.

ModbusDiscretePoint
ModbusDiscretePoint is a child component of any Modbus device. It has to be under any
network type.
It only support “decimal” address format.

The property sheet of the object is shown below

153
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Out
Point out value.

154
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusHoldingBit
ModbusHoldingBit is a child component of any Modbus device. It has to be under any network
type.
It only support “decimal” address format.

The property sheet of the object is shown below

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message
155
EasyIO FG Series Sedona Kits User Guide v1.3

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Bit 1 ~ 15 Out
Output value for each bit.

 Read Write
Enable read write.

True = read write


False = read only

 Bit 1 ~ 15 In
Input value to bit.
Writable.

ModbusHoldingPoint
ModbusHoldingPoint is a child component of any Modbus device. It has to be under any
network type.
It only support “decimal” address format.

156
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Data Type
Modbus Register data type.

Integer : 16 Bit
Long : 32 Bit
Float : 32 Bit
157
EasyIO FG Series Sedona Kits User Guide v1.3

Unsigned Int : 16bit


UnInt64 (Unsigned Integer 64bit) : 64bit
Mod10 (Modulus 10 64 bit) : 64bit

In some Modbus device Integer is also called as Word.

 Scale
Provide scaling factor.

 Offset
Offset value if there is any.

 Out
Output value.

 Read Write
Enable or disable read write.

True = read write


False = read only

 In
Input value.
This is use if Read Write is Enable.
If read write is disable, this is ignored.

ModbusInputBit
ModbusInputBit is a child component of any Modbus device. It has to be under any network
type.
It only support “decimal” address format.

The property sheet of the object is shown below

158
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Bit 0 ~ 15 Out
Output value for each bit.

159
EasyIO FG Series Sedona Kits User Guide v1.3

ModbusInputPoint
ModbusInputPoint is a child component of any Modbus device. It has to be under any network
type.
It only support “decimal” address format.

The property sheet of the object is shown below

160
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Current status. Readonly

 Fault Cause
Displays the fault cause for the point.

 Enable
Enable or disable the point poll.

 Read Exception
Point read exception error message.

 Write Exception
Point write exception error message

 Policy
Polling policy for the point.

Slow
Normal (Default)
High

 Address
Modbus Register address.
Only “decimal” format supported.

 Data Type
Modbus Register data type.

Integer : 16 Bit
Long : 32 Bit
Float : 32 Bit
Unsigned Int : 16bit
UnInt64 (Unsigned Integer 64bit) : 64bit
Mod10 (Modulus 10 64 bit) : 64bit

In some Modbus Slave device Integer is also called as Word.

 Scale
Provide scaling factor.

 Offset
Offset value if there is any.

 Out
Point out value.

161
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGNtp
This kit provides the capability of time synchronize to a NTP server. It supports internet NTP server as
well as local time server.
To use any of the objects simply drag and drop from the library into the wire sheet. .

NtpService
NtpService is a service that provides the device with the time synchronization service. This
service is build by reference on Network Time Protocol (NTP) version 3 documentation (rfc1305).

**Note: NtpService must be drop inside Service folder (Sedona -> App -> Service).

The property sheet of the object is shown below

 Enable
Enable or disable the NtpService.
162
EasyIO FG Series Sedona Kits User Guide v1.3

 Fault Cause
Displays the fault cause for the NTP service.

 Host Name
The Time Server Host, which will provide the time information for time
synchronization. Example: time.windows.com

 Host Address
The IP address corresponding to the Host Name; as a result return by
DnsService.

 Last Update
This parameter will show the last successful update time.

 Update Freq
The NtpService update frequency, in the unit of Hour (hr). Default to its
minimum value, 1 hr. Value of 1 hr means request will be sent every 1 hr.

 Reupdate Freq
The NtpService re-update frequency when the first attempt of update is failed,
in the unit of milliseconds (ms). Default to 60000ms, range from 30000ms to
600000ms.

 Timeout
User defined time length to wait, before the NtpService getting a response, in
milliseconds (ms). Default to its minimum value, 2000ms.

 Origin Nanos
The time in the unit of nanoseconds (ns), when the NtpService request sending
to time server (Host Address).

 Receive Nanos
The time in the unit of nanoseconds (ns), when the time server is received the
request.

 Transmit Nanos
The time in the unit of nanoseconds (ns), when the time server response is
sending back to the device (send the request).

 Destination Nanos
The time in the unit of nanoseconds (ns), when the NtpService is received the
response from time server.

 Offset
Offset is time difference between the device and the time server, which is also
the time to be adjusted by device. Value can be either positive or negative.

Offset = ( (Receive Nanos-Origin Nanos) + (Transmit Nanos-Destination Nanos) ) / 2

 Round Trip Delay


The total length of time it takes for the request to be sent and the response to
be received from time server.

163
EasyIO FG Series Sedona Kits User Guide v1.3

Round Trip Delay =


(Destination Nanos-Origin Nanos) - (Transmit Nanos-Receive Nanos)

 Force Update

Force the NtpService to send the update request to time server instead of waiting for auto update.

164
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGP2P
This kit provides capability to share points between EasyIO FG series controllers.
To use any of the objects simply drag and drop from the library into the wire sheet.

P2PService
P2PService provides a peer to peer service among EasyIO FG Series controllers. It enables FG
controllers to share value among FGs’. The service creates a virtual group for points sharing.

 Status
Display the status of the service.

 Fault Cause
Displays the fault cause for the service.

 Enable
Enable or disable the service.

true = enable
false =disable

 Version
Display P2P service program version.

 Min Update Time


This property defines the update period of each poll.

165
EasyIO FG Series Sedona Kits User Guide v1.3

 Max Update Time


Apply to controller that has write enable points.
This property defines the rewrite period if the value has no changes.
If more than 1 controller has write enable for a single point

This property makes sure that slave’s controller re subscribed to the service in
case a short power down.

 UDP Port
P2P service utilizes UDP port 6061.

 Broadcast Status
Display error if there is no update from a master controller after a predefined
time period at the master controller.
This status should be “Alive” is the P2P connection is connected.

P2PBoolPoint
P2PBoolPoint is a Boolean data type child component for FGP2P service.
It utilizes Register bit to maximize a single 32 bit register.

The property sheet of the object is shown below

 Status
Display the status of the point.

 Fault Cause
Display the fault cause for P2P object.

 Enable
Enable or disable the Boolean P2P object.

true = enable
false =disable

 Read Write

166
EasyIO FG Series Sedona Kits User Guide v1.3

If the object is a writable object, this property has to be Enable.

true = enable
false =disable

 Address
Object address.
Valid address range is from 0 to 255.

 Bit
Bit number of the 32 bit register.
Valid bit range is from 0 to 31.

 In
If the object is a writable object, a valid value is linked to the input.

 Out
The output value either from a poll or its own value.

 Default Value
The default value if the controller is rebooted.

P2PFloatPoint
P2PFloatPoint is a float data type child component for FGP2P service.

The property sheet of the object is shown below

167
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Display the status of the point.

 Fault Cause
Display the fault cause.

 Enable
Enable or disable the Boolean P2P object.

true = enable
false =disable

 Read Write
If the object is a writable object, this property has to be Enable.

true = enable
false =disable

 Address
Object address.
Valid address range is from 0 to 255.

 In
If the object is a writable object, a valid value is linked to the input.

 Out
The output value either from a poll or its own value.

 Default Value
The default value if the controller is rebooted.

P2PIntPoint
P2PIntPoint is a integer data type child component for FGP2P service.

The property sheet of the object is shown below

168
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Display the status of the point.

 Fault Cause
Display the fault cause.

 Enable
Enable or disable the Boolean P2P object.

true = enable
false =disable

 Read Write
If the object is a writable object, this property has to be Enable.

true = enable
false =disable

 Address
Object address.
Valid address range is from 0 to 255.

 In
If the object is a writable object, a valid value is linked to the input.

 Out
The output value either from a poll or its own value.

 Default Value
The default value if the controller is rebooted.

169
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGSerial
The object in this kit monitors the on board RS 485 port 2 availability.

To use any of the objects simply drag and drop from the library into the wire sheet. .

SerialService
SerialService is a service that monitors the FG series RS-485 port 2.
This object will display the service that is currently occupying the RS-485 port 2.
The object is included in the Sedona apps by default if the EasyIO FG Series controller firmware is
V2.2.2.0.05 and above.
Current firmware version is v1.5b42 for EasyIO FG.
Current firmware version is v2.0b42 for EasyIO FG+.

The property sheet of the object is shown below

 Description
Simple description of the object

 Status
Status of RS 485 port 2 only.

Close = unoccupied or not use


Open = occupied or used

 Owner
Service that is currently occupying the RS 485 port 2.

170
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioFGSql
This kit objects are use to configure history trending. The history trending will be stored in a SQL Lite
database running in the EasyIO FG Series controller.

The hierarchy of the LCD service is as below.

SQL Service is the parent object.


Table object has to be under the service object. Multiple tables are allowed.
SQL object (sqlBool, sqlFloa and sqlInt) has to be under the table object.

To use any of the objects simply drag and drop from the library into the wire sheet. .

SqlLite3Service
SqlLite3Service service enable user to configure history trending.

The property sheet of the object is shown below

 Status
Display status of the service
171
EasyIO FG Series Sedona Kits User Guide v1.3

 DbFile Name
The database name that will be used for SQL service.
It is automatically created and it is not editable at the time of the
document.

SqlTable
SqlTable enable user to create table/tables under the SQL service object.

The property sheet of the object is shown below

 Status
Display SQL table status.

 Enable
Enable or disable the SQL table.

 Is ready
Ready status for table data collection

True : table ready for data collection


False : table not ready for data collection

 Record Type
Selection for data collection type

COV : change of value


Interval : interval, interval time period is calculate at
the enable time
Interval on the hour : interval on the hour, time period is round up
to hour
172
EasyIO FG Series Sedona Kits User Guide v1.3

 Record Interval
If record type is interval, this property set the interval period of data
collection.

 Max Record
Default is 10,000 records.
Maximum value is 100,000 records.

 Current Record
Total data recorded in the table.

 Queue Size
Queue for data collection.

 Table Name
Read only property display table name.

 Table Name Buf


Property to create table name

SqlBool
SqlBool represents the column under sqlTable. Multiple sqlBool object can drop under table
object. This object only support Boolean data.

The property sheet of the object is shown below

 Status
Display SQL object status.

 Column Ready
Display column ready status.

 Column Name
User define column name.

 In
Data input for collection.

173
EasyIO FG Series Sedona Kits User Guide v1.3

A valid Boolean value is needed for the SqlBool to record trending

SqlFloat
SqlFloat represents the column under sqlTable. Multiple sqlFloat object can drop under table
object. This object only support float data.

The property sheet of the object is shown below

 Status
Display SQL object status.

 Column Ready
Display column ready status.

 Column Name
User define column name.

 In
Data input for collection.

 Cov Diff
Minimum value change compare to previous value in order for data collection.
If table record type is COV, data will be recorded if changes if larger than Cov
Diff.
If table record type is Interval or Interval on Hour property is disable.

A valid float value is needed for the SqlFloat to record trending

174
EasyIO FG Series Sedona Kits User Guide v1.3

SqlInt
SqlInt represents the column under sqlTable. Multiple sqlInt objects can drop under table object.
This object only support float data.

The property sheet of the object is shown below

 Status
Display SQL object status.

 Column Ready
Display column ready status.

 Column Name
User define column name.

 In
Data input for collection.

 Cov Diff
Minimum value change compare to previous value in order for data collection.
If table record type is COV, data will be recorded if changes if larger than Cov
Diff.
If table record type is Interval or Interval on Hour property is disable.

A valid Integer value is needed for the SqlInt to record trending

SqlFunc
SqlFunc is data retrieval with specific simple math functions according to time range specify.

The property sheet of the object is shown below

175
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
Display status of Sql function object.

 Enable
Disable or enable the execution of Sql Function object.

 IsReady
Status of Sql Function object ready.

True : ready for function execution


False : not ready for function execution

 Table Name
Table name for the Sql Function object to access.

 Column Name
Column name for the Sql Function object to access.

 Last read
Display last execution time.

 Interval
Interval time period for object each execution.

 Time Range
Time range selection for data retrieval.

Time range Description


Custom Custom time range. Define using Start and End date time.
Today Current day data records.
Yesterday Yesterday data records.
Last24Hr Last 24 hours data from current time.
176
EasyIO FG Series Sedona Kits User Guide v1.3

Week to Date First day of the week to current data.


Last Week Full cycle last week data.
Last year this Week Full cycle last year this week.
Month to Date First day of the month to current time data.
Last Month Start from calendar .
Year to Date Starts from current calendar year to current time.
Last Year Full cycle calendar for last year data.

 Week Start Day


Selection week start day.
Choices of Monday or Sunday.

 Start Day Str


Starting date in string format.
Date format is DD/MM/YY

 Start Time Str


Starting time in string format.
Time format 24 hours.

 End Day Str


End date in string format.
Date format is DD/MM/YY

 End Time Str


End time in string format.
Time format 24 hours.

 Out
Calculated value base on function selected.

 Func
Calculation function available.

Function Description
Total Summation computation from selected data
Average Average computation from selected data
Count Total record count from selected time range
Min Min value within the selected time range
Max Max value within the selected time range
Delta Difference between the first value and the last value within the selected
time range

177
EasyIO FG Series Sedona Kits User Guide v1.3

The sqlTable object has to be a child component of the SQL service. It cannot reside in elsewhere.

178
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioHistory
This kit contains 3 objects. All the objects extend the Tridium history kit for Interval history logs.

These object eliminates the daily transition error where it will create 20 lines per second where by
the interval is set to minutely.

Objects available in the PStore Service property sheet.

Below is some example of the tridium Interval history error. Every second has 20 lines.

179
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioHvac
This kit contain 10 objects.
To use any of the objects simply drag and drop from the library into the wire sheet.

Analog FIlter
Analog Filter, this object is an improved analog value filtering object as compare to the
analogFilter from the easyioControl kit.

It will compute an average from the input value base on the Sample per Second rate.
The output of the average will then be average again with the last value.
This helps in tuning the PID loop for slower response.

The property sheet of the object is shown below

 Out
Computed average value.

 In
Input process value.

 Sample Per Second


Total of sampling value to be taken for the average calculation.

180
EasyIO FG Series Sedona Kits User Guide v1.3

Example of using the analog filter to slow down the ramping effect of a 1.5K platinum sensor
which has a narrow band temperature table.

Analog FIlterV2
AnalogFilterV2, this object is an improved analog value filtering object compare to AnalogFilter
in easyioHvac kit.

The property sheet of the object is shown below

This function digitally filters the input.


Ynew = Yold + (X -Yold)*(1-exp(-t/Tau))
Where, t = 1 second and Tau is in the range 0 to 65535 seconds.

The output can be initialized to zero (zeroInit=TRUE) or the first valid input value (zeroInit=FALSE).

From iteration to iteration, the Function Block keeps track of the tau multiplier (1-exp(-t/Tau). On
power up/reset, this is recalculated.

 Out
Processed Out value.

 Out
Processed Out value.

 In
Processed In value.

 Zero Init
Output value zero initialization during power up or start or program.

True = initialize filter value to first valid value


False =initialize filter to zero.

 Tau Multiplier
181
EasyIO FG Series Sedona Kits User Guide v1.3

This property defines the Tau multiplier.


The larger the value the slower the process will be.

 Sampling Rate
This property define the sampling rate of the object.
If the sampling rate is at 1 second means that sample is taken every second.
If sampling rate is 5 seconds, sample will be taken every 5 seconds.

 Min In
Property defines the minimum value the input takes.
If the input value is less than the Min In, input is equal to Min In.

 Max In
Property defines the maximum value the input takes.
If the input value is less than the Max In, input is equal to Max In.

Some examples of the calculation.

Example 1:
Set In1 (X) = 4, tau = 2.0, Set ZeroInit = 1 (initializes filter to 0.0)
Ynew = Yold +(X -Yold)*(1-exp(-t/Tau))
In the first iteration,
Yold = 0; Ynew = Yold + ( X - Yold) * (1 – exp (-t/tau))
Ynew = 0 + (4 - 0) * (1 – 2.718(-1/2))
Ynew = 0 + 4 * (0.393)
Ynew = 1.572

In the second iteration,


Yold = 1.572; X = 4; Ynew = 1.57 + (4 – 1.57) * (0.393)
Ynew = 2.52
In the third iteration,
Ynew = 2.52 + (4 – 2.52) * (0.393)
Ynew = 3.107
The iterations continue until the input is reached.

Example 2:

Set In1 (X) = 4, tau = 2.0, Set ZeroInit = 0 (initializes filter to first valid value)
Ynew = Yold + (X -Yold) * (1-exp(-t/Tau))
In the first iteration,
Ynew = X
Ynew = 4

In the second iteration, if X = 6


Ynew = Yold + ( X - Yold) * (1 – exp (-t/tau))
Ynew = 4 + (6 - 4) * (0.393)
Ynew = 4 + 0.786
Ynew = 4.786

In the third iteration, if X = 6


Ynew = Yold + ( X - Yold) * (1 – exp (-t/tau))
Ynew = 4.786 + (6 – 4.786) * (0.393)
Ynew = 5.263

182
EasyIO FG Series Sedona Kits User Guide v1.3

The iterations continue until the input is reached.

Drive
Drive component provides the mechanism to drive a floating type actuator by using two outputs
(Open and Close control). A single input with scale factor determines the desired position which
controls the hardware output.
The open and close operation time is based on the full stroke travel time, TravelTime. When the
calculated position hits the minimum (0%) or maximum (100%), the open or close output will
continue run for the Drive Travel Time to make sure the actuator position is in place.
The property sheet of the object is shown below

 Open
Readonly. Indicate Drive current open state.
True = run
False = stop

 Close
Readonly. Indicate Drive current close state.
True = run
False = stop

 Current Position
Current calculated position based on the Drive time.

 In
This parameter specifies the desired drive position. The input is scale to a range
from 0% to 100% using the Drive HighScale and Drive LowScale parameters.

 Low Scale
Defines the lowest value of Drive input value, which is equals to 0%.
Default = 0.00.

 High Scale
Defines the highest value of Drive input value, which is equals to 100%.
Default = 100.00.

 Hysteresis
183
EasyIO FG Series Sedona Kits User Guide v1.3

Defines the minimum changes of the input value to activate the open and close
operation. When the difference between input value and the calculated value is
exceeding this limit, the Drive Open and Drive Close outputs will be activated to
nullify the difference. Default = 5.00.

 Travel Time
Drive full stroke travel time in seconds (s). Default value = 30s.

Example of using the Drive object controlling 2 Digital Output or a floating actuator

Fan Control
FanControl component is able to drive a point-type output for sequenced control of up to three
digital outputs to support one, two or three fan speed motor. The Fan Control also provides
other control sequences such as minimum speed, minimum on time, kick time and hysteresis for
a better fan operation.

The property sheet of the object is shown below

 High

184
EasyIO FG Series Sedona Kits User Guide v1.3

Readonly. Indicate the Fan Control digital high speed output state.
True = ON,
False = OFF

 Medium
Readonly. Indicate the Fan Control digital medium speed output state.
True = ON,
False = OFF

 Low
Readonly. Indicate the Fan Control digital low speed output state.
True = ON,
False = OFF

 Enable
Enable/disable the Fan Control function. If the Fan Control is disabled, all digital
outputs will be set to off and all timers are reset.
True = Enable,
False = Disabled

 Set Speed
The desired speed in percentage (0 - 100%) used by the Fan Control to
determine the output.

 No Of Speed
To defines the Fan Control output type.
1 = One Fan Speed (use Low Speed Output)
2 = Two Fan Speed (use High and Low Speed Output)
3 = Three Fan Speed (use High, Medium and Low Speed Output)

The Fan Control output speed response to NoOfSpeed when SetSpeed changes as
shown below:

 Min On Time
Defines the time period in seconds the fan control should run before it can be
turned off. Default = 0s.

 Kick Time
Defines the time period in seconds the fan control should run at highest speed
when it starts to run from off state before it can be switched to the desired
lower speed.

185
EasyIO FG Series Sedona Kits User Guide v1.3

 Hysteresis
The Hysteresis prevents the Fan Control point-type output to be changed too
frequently, when the SetSpeed is swing at the margin value.

Example: When the SetSpeed value at range 66.60% to 66.70%, the output will
be switched in between High and Medium.

Fan Control output speed response when Hysteresis is applied:

Example of using the FanControl object controlby a PID loop. The outputs can be link to Digital Output
or virtual objects.

LeadLagCycles
LeadLagCycles comes with 3 output for equipment command. The output is fixed at 3. The lead
lag will rotate base on this 3 outputs.
The control philosophy is 2 run 1 standby.
If any of the equipment fails, the standby will take over.

On startup, there will be no delay for the outputs.


However there is a delay for fault status (run status and trip status) feedback.

The property sheet of the object is shown below

186
EasyIO FG Series Sedona Kits User Guide v1.3

 In
This is the object enable. Usually is link from a Schedule object.

 Status feedback delay


Delay time for the fault checking.

 Out1 , Out2 , Out3


Output of the lead lag cycle object.

 Status1 , Status2 , Status3


Status feedback from equipment.

 Trip1 , Trip 2 , Trip 3


Trip Status feedback from equipment.

LeadLagCycles_3o1s
LeadLagCycles_3o1s object is very similar to the LeadLadCycle object. The different is there is a
selection for total number of outputs. Whatever total number of output selected, the active
output will be only 1. The others will standby.

There is also a separate trip status delay property as compare to the leadlagCycle.
The property sheet of the object is shown below

187
EasyIO FG Series Sedona Kits User Guide v1.3

 In
This is the object enable. Usually is link from a Schedule object.

 Num of Out
Selectable number of output.

If 3 = 1 run , 2 standby
If 2 = 1 run , 1 standby

 Status feedback delay


Delay time for the status feedback checking.

 Trip Delay
Delay time for the trip status checking.

 Out1 , Out2 , Out3


Output of the lead lag cycle object.

 Status1 , Status2 , Status3


Status feedback from equipment.

 Trip1 , Trip 2 , Trip 3


Trip Status feedback from equipment.

LeadLagRuntime
LeadLagRuntime object provides a 2 output object which will switch the lead lag cycle base on
runtime. The lowest accumulated runtime will start first in the next cycle enable.
The lead lag cycle will then change after the specific runtime is archive according to the rotation
time set.
188
EasyIO FG Series Sedona Kits User Guide v1.3

The object will switch over to the standby pump if the current running pump is detected to be in
fault mode.

The property sheet of the object is shown below

 Pump Enable
Enable the object logic.

 Pressure Diff
Not Use.

 Fault Reset
To reset the fault status.

 Pump1 Trip,Pump2 Trip


Pump Input Trip monitoring.

 Pump1 Out, Pump2 Out


Pump Output.

 Fault Out
Fault Status , read only.

 Rotation Time
Time period until the next pump rotation

 Dps Delay
Not Use

 Trip Hold Time


Time period to hold to prevent false trip alarm

189
EasyIO FG Series Sedona Kits User Guide v1.3

 Mins Run1 , Mins Run 2


Runtime for each pump, read only

 Current Mins
Current running pump runtime since it started.

 Active Pump
Current running pump number.

Sequence Loop
SequenceLoop is a component that provides proportional, integral and derivative (PID) control
action of outputs based on the process value (input) and set point value. It monitors the process
value, compare the process value to the set point, and calculate the output to reduce error
(difference) between the set point and process value. The output is the result of proportional,
integral and derivative calculation. This Sequence Loop consists of a single PID loop operation
with two set points (Set Point and Aux Set Point) and two outputs (Output and Reverse/Aux
Output).

Typical sequence loop operation without the integral tuning and derivative tuning factor:

If loop control is disabled (Enable = 0), the loop control Out and ReverseOut will be set
to 0. The Sequence Loop configuration operates the direct and reverse (cooling and
heating) at the same time. They share the PID control algorithm and parameters except
the set point and throttling range. This can be referred as auto mode since the loop
control regulates the output by switching between the cooling and heating cycle. The
SetPoint and ThrottlingRange are used for the cooling control and the Out as the output
control. The AuxSetPoint and AuxThrottlingRange are used for the heating control and
the ReverseOut as the output control. Under unoccupied setting (where Occupied is set
to 0), cooling and heating operation are using the unoccupied set point and hysteresis
setting.

190
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

Out
Readonly. Current calculated output value of the loop algorithm, in percentage.

Reverse Out
Readonly. Current calculated reverse output value of the loop algorithm in percentage.

Process Value

191
EasyIO FG Series Sedona Kits User Guide v1.3

The loop control input value, normally derived from the analog input. This value will be used to
compare with the Set Point value to determine Output/Reverse Out value.

Accumulated Integral
Readonly. This is the accumulated integral value over the loop process period if the Integral
parameter is not zero.

 Enable
Enable the loop control operation.

 Occupied
This parameter sets the occupied condition for loop control operation. Loop
control uses different loop algorithm under occupied and unoccupied mode.
False = Unoccupied, True = Occupied

 Set Point
The control reference or the desired value used by loop algorithm.

 Throttling Range
Defines the amount of input change required for loop control output to
proportionally change from 0% to 100%.

 Aux Set Point


The loop control secondary set point.

 Aux Throttling Range


The loop control secondary throttling range.

 Deadband
To Defines the minimum changes of Process Value for the loop control to take
action.

 Integral
Defines the loop integral gain parameter used in loop algorithm (Integral Tuning
Parameter, I).

 Differential
Defines the loop derivative gain parameter used in loop algorithm (Derivative
Tuning Parameter, D).

 Unoccupied Heat Set Point


The Heating operation set point for loop control during unoccupied mode.

192
EasyIO FG Series Sedona Kits User Guide v1.3

 Unoccupied Cool Set Point


The Cooling operation set point for loop control during unoccupied mode.

 Unoccupied Hysterisis
The hysteresis control value of the Cooling and Heating operation during
unoccupied mode.

 Scan Time
Defines the interval at which the process variable is sampled or the loop
algorithm is executed in seconds (s).

 Ramp Time
Defines the minimum interval at which the loop output may increase from 0%
to 100% in seconds (s). This Ramp Time is only applied during the first start of
loop operation and will be inhibiting when the output value reaching the
desired output value.

 Reset Integral
Manually reset the accumulated integral value (accumulated error value).

193
EasyIO FG Series Sedona Kits User Guide v1.3

Example of using the Sequence Loop object.

194
EasyIO FG Series Sedona Kits User Guide v1.3

Sequencer
Sequencer is an object duplicate from a Johnson Control Sequencer Object. This objects comes
with multiple staging control and sequence.
The Sequencer object provides the control of 1-4 outputs as a function of the value of INPUT and
the state of four logic (STAGENDISABLE) inputs. This object is used to control multi-stage
equipment, maintaining minimum ON/OFF times, inter-stage delays and sequencing loads. The
output stages are controlled in sequence according to different strategies as Step Mode (FILO),
Sequential Mode (FIFO), Equal Run-Time or Equal Start-Up. Variations are also available for
compressor circuit with Single Oil Pump or for Pump Down. It can also perform Vernier Control
providing full adjustment between steps.

For further details, request a copy of the Johnson Control Sequencer User guide from EasyIO
Technical Support at support@easyio.com.

Single Loop
SingleLoop is a component provides proportional, integral and derivative (PID) control action of
outputs based on the process value (input) and set point value. It monitors the process value,
compare the process value to the set point, and calculate the output to reduce error (difference)
between the set point and process value. The output is the result of proportional, integral and
derivative calculation. This single loop operation comes with single output and the output can be
configured as either direct (cooling) or reverse acting. If only throttling range is applied to single
loop operation (without integral and derivative tuning), the output is 50% when the input
(Process Value) is equal to Set Point.

Typical cooling operation without the integral tuning and derivative tuning factor:

Typical heating operation without the integral tuning and derivative tuning
factor:

195
EasyIO FG Series Sedona Kits User Guide v1.3

If loop control is disabled (Enable = 0), the Out will be set to 0. Under unoccupied setting
(where Occupied is set to 0), cooling and heating operation are using the unoccupied set
point and hysteresis setting. If the single loop is set for cooling under unoccupied mode,
the output is set to 100% when the input is higher than the unoccupied cool set point.
The output is set to 0% when the input is lower than the unoccupied cool set point
minus hysteresis.

196
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Out
Readonly. Current calculated output value of the loop algorithm, in percentage.

 Process Value
The loop control input value, normally derived from the analog input. This value
will be used to compare with the SetPoint value to determine Output value.

 Accumulated Integral
Readonly. This is the accumulated integral value over the loop process period if
the Integral parameter is not zero.

 Enable
Enable the loop control operation.

 Occupied
This parameter sets the occupied condition for loop control operation. Loop
control uses different loop algorithm under occupied and unoccupied mode.
False = Unoccupied, True = Occupied

197
EasyIO FG Series Sedona Kits User Guide v1.3

 Is Heating
This parameter defines the output action of Single Loop configuration, either
cooling or heating.
False = Cooling, True = Heating

 Set Point
The control reference or the desired value used by loop algorithm.

 Deadband
To defines the minimum change of Process Value for the loop control to take
action.

 Throttling Range
Defines the amount of input change required for loop control output to
proportionally change from 0% to 100%.

 Integral
Defines the loop integral gain parameter used in loop algorithm (Integral Tuning
Parameter, I).

 Differential
Defines the loop derivative gain parameter used in loop algorithm (Derivative
Tuning Parameter, D).

 Unoccupied Heat Set Point


The Heating operation set point for loop control during unoccupied mode.

 Unoccupied Cool Set Point


The Cooling operation set point for loop control during unoccupied mode.

 Unoccupied Hysterisis
The hysteresis control value of the Cooling and Heating operation during
unoccupied mode.

 Scan Time
Defines the interval at which the process variable is sampled or the loop
algorithm is executed in seconds.

 Ramp Time
Defines the minimum interval at which the loop output may increase from 0%
to 100% in seconds. This RampTime is only applied during the first start of loop
operation and will be inhibit when the output value reaching the desired output
value.

198
EasyIO FG Series Sedona Kits User Guide v1.3

 Reset Integral
Manually reset the accumulated integral value (accumulated error value).

Example of using the Single Loop object.

199
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioLastWrite
This kit contain 3 objects. Support 3 data types, boolean , float and integer. Basically these objects
performed the task where the last value write to this block will be the output.
In other words, last In wins.

To use any of the objects simply drag and drop from the library into the wire sheet.

LastWriteBool
LastWriteBool is an object that accepts 3 inputs and chooses the last value to be passed to the
output. Data type is Boolean.
The property sheet of the object is shown below

200
EasyIO FG Series Sedona Kits User Guide v1.3

 On Start Delay
This property delays the object to compute on program start.

 Out
Output value is the current value.

 In1
Input 1 value.

 Src In1
Input 1 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In2
Input 2 value.

 Src In2
Input 2 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In3
Input 3 value.

 Src In3
Input 3 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

If Bool1 is true, the Last Write object will update the Bool2 to true.
If Bool2 is false, the last write object will update the Bool1 to false.

201
EasyIO FG Series Sedona Kits User Guide v1.3

LastWriteFloat
LastWriteFloat is an object that accepts 3 inputs and chooses the last value to be passed to the
output. Data type is Float.
The property sheet of the object is shown below

 On Start Delay
This property delays the object to compute on program start.

 Out
Output value is the current value.

 In1
Input 1 value.

 Src In1
Input 1 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In2
Input 2 value.

 Src In2
Input 2 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In3
Input 3 value.

 Src In3
Input 3 source.
The last write object will write to the input source if there is any change at any
input.
All the other inputs will sync regardless of any input changes.

202
EasyIO FG Series Sedona Kits User Guide v1.3

If Float1 writes 24.0, the Last Write object will update the Float2 to 24.0.
If Float2 writes 25.0, the last write object will update the Float1 to 25.0.

LastWriteInt
LastWriteInt is an object that accepts 3 inputs and chooses the last value to be passed to the
output. Data type is Integer.
The property sheet of the object is shown below

 On Start Delay
This property delays the object to compute on program start.

 Out
Output value is the current value.

 In1
Input 1 value.

 Src In1
Input 1 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In2
Input 2 value.

203
EasyIO FG Series Sedona Kits User Guide v1.3

 Src In2
Input 2 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

 In3
Input 3 value.

 Src In3
Input 3 source.
The last write object will write to the input source if there is any change at any
input.
All the other input will sync regardless of any input changes.

If Int1writes 4, the Last Write object will update the Int2 to 4.


If Int2 writes 25.0, the last write object will update the Int1 to 4.

204
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioLib
This kit contains 5 objects. All the objects can be used for the controller logic programming.

To use these objects, simply just drag and drop into the wire sheet.

AnalogFilter
AnalogInvert component invert the input based on scale factor.

if In < Min then Out = Max


else if In > Max then Out = Min
else Out = Max + Min – In

The property sheet of the object is shown below

 Out
Current output value. Readonly

 In
Current input value.

 Min
Minimum input value, scale low factor.

 Max
205
EasyIO FG Series Sedona Kits User Guide v1.3

Maximum input value, scale high factor.

Example of AnalogInvert object used

AnalogLimit
AnalogLimit component restricts an analog value to a specific range. When the input value is
within the limit range, it will be passed direct to the output.

if In < LowLimit then Out = LowLimit


else if In > HighLimit then Out = HighLimit
else Out = In

206
EasyIO FG Series Sedona Kits User Guide v1.3

The property sheet of the object is shown below

 Out
Current output value. Readonly

 In
Current input value.

 Low Limit
Lowest allowed value.

 High Limit
Maximum allowed value.

Example of AnalogLimit used to limit the value of the Input. Min Limit is set
to 20 and Max Value is set to 30. This application can be used to limit the
temperature setpoint.

DigitalState
DigitalState component monitors the digital state transition from On to Off state and Off to On
state (On/Off) latch and monitors the digital state On to Off transition and Off to On transition
count.

The property sheet of the object is shown below

207
EasyIO FG Series Sedona Kits User Guide v1.3

 On Latch
OnCounter provides a means to count OFF to ON digital transition on the Out
state. This output increments by one on each In state OFF to ON transition.
Readonly

 Off Latch
OffLatch is the ON to OFF transition capture at the In state. This output remains
in ON state following the first ON to OFF transition unless reset by
ResetOffLatch action. Readonly
true = At least one ON to OFF transition
false = No ON to OFF transition occurred or reset by ResetOffLatch action.

 On Counter
OnLatch is the OFF to ON transition capture at the In state. This output remains
in ON state following the first OFF to ON transition unless reset by ResetOnLatch
action. Readonly
true = At least one OFF to ON transition
false = No OFF to ON transition occurred or reset by ResetOnLatch action.

 Off Counter
OffCounter provides a means to count ON to OFF digital transition on the Out
state. This output increments by one on each In state ON to OFF transition.
Readonly

 In
Current input state.

208
EasyIO FG Series Sedona Kits User Guide v1.3

HighLowSelect
HighLowSelect component output highest and lowest value out of 3 input values.

The property sheet of the object is shown below

 High
The highest value of all inputs. Readonly

 Low
The lowest value of all inputs. Readonly

 In1
Input value 1.

 In2
Input value 2.

 In3
Input value 3.

Example of a highlow object with 3 inputs

209
EasyIO FG Series Sedona Kits User Guide v1.3

AnalogFilter
Thermostat component provides the output control based on the input (process) and the set
point value.

Thermostat in cooling operation:

Thermostat in heating operation:

The property sheet of the object is shown below

210
EasyIO FG Series Sedona Kits User Guide v1.3

 Out
Output state, ON or OFF as the comparison result of ProcessValue and SetPoint.
Readonly

 Enable
Enable or disable the thermostat function.

 Set Point
Desired/target value.

 Process Value
Thermostat input value. Thermostat function block compares the SetPoint and the
ProcessValue to determine the output state.

 Cut In Offset
Defines the differential value between ProcessValue and SetPoint to determine the
Thermostat output on state. A positive CutInOffset value means greater than
SetPoint, and a negative CutInOffset value means lower than SetPoint during
comparison. For cooling control, uses positive value and negative value for heating
control.

 Cut Out Offset


Defines the differential value between ProcessValue and SetPoint to determine the
Thermostat output off state. A positive CutOutOffset value means greater than
SetPoint, and a negative CutOutOffset value means lower than SetPoint during
comparison. For cooling control, uses negative value and positive value for heating
control.

Example of thermostat object use

211
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioLimkit
This kit contains 13 objects. These objects are fundamentally for conversions.

To use any of the objects simply drag and drop from the library into the wire sheet. .

212
EasyIO FG Series Sedona Kits User Guide v1.3

B2L
B2L or Bit to Long conversion object. The output data type is “long”

The property sheet of the object is shown below

 Out
Output of the conversion base on the binary.
The output data type is “long”

 Count
This slot shows the total number of bit count. It will count total number of bit
between bit1 to bit32 which the value is “true”.

 In1, In2, In3 ……. In32


There are total 32 input for the object to calculate the binary format.

In1 = LSB (Least Significant Bit)


In32 = MSB (Most Significant Bit)

213
EasyIO FG Series Sedona Kits User Guide v1.3

Example of B2L object use

Out = In1 + In2 + In3


Out = 20 + 21 + 22
Out = 7

B2S
B2S or Bit to Short conversion object. The output data type is “short”

The property sheet of the object is shown below

 Out
Output of the conversion base on the binary
The output data type is “word”

 Count
This slot shows the total number of bit count. It will count total number of bit
between bit1 to bit16 which the value is “true”.
 In1, In2, In3 ……. In16
There are total 16 input for the object to calculate the binary format.

In1 = LSB (Least Significant Bit)

214
EasyIO FG Series Sedona Kits User Guide v1.3

In32 = MSB (Most Significant Bit)

Example of B2S object use

Out = In1 + In2 + In3


Out = 20 + 21 + 22
Out = 7

B2W
B2W or Bit to Word conversion object. The output data type is “word”

The property sheet of the object is shown below

 Out
Output of the conversion base on the binary
The output data type is “word”

215
EasyIO FG Series Sedona Kits User Guide v1.3

 Count
This slot shows the total number of bit count. It will count total number of bit
between bit1 to bit16 which the value is “true”.

 In1, In2, In3 ……. In16


There are total 16 input for the object to calculate the binary format.

In1 = LSB (Least Significant Bit)


In32 = MSB (Most Significant Bit)

Example of B2W object use

Out = In1 + In2 + In3


Out = 20 + 21 + 22
Out = 7

FLAtch
FLatch is a latching object where it can latch a float input value.

The property sheet of the object is shown below

 Out
Output value when the latch is triggered

216
EasyIO FG Series Sedona Kits User Guide v1.3

 In
Input variable for the latching process

 Latch
This slot is link to a Boolean to trigger the latch. The output value will be latch
until the next latch slot true.

Example of FLatch object use

IntDecoder
IntDecoder is an object where it converts an integer value and triggers a Boolean according to
the input value.

The property sheet of the object is shown below

 In
Input value. An integer format value.

 Out

217
EasyIO FG Series Sedona Kits User Guide v1.3

16 boolean outputs.

If In = 0
All Out = false

If In = 1
Out1 = true
Out 2, Out3…Out16 = false

If In = 4
Out 1, Out2, Out3, Out4 = true
Out5, Out6, Out7….Out16 = false

Example of IntDecoder object use

218
EasyIO FG Series Sedona Kits User Guide v1.3

L2B
L2B or Long to Bit conversion object. The output data type is Boolean. 32 outputs are available.

The property sheet of the object is shown below

 In
Input of the conversion base on the long data type input.
The output data type is “boolean”

 Out1, Out2, Out3 ……. Out32


There are total 32outputs for the object which supports up to a 32bit value.

Out1 = LSB (Least Significant Bit)


Out32 = MSB (Most Significant Bit)

Example of L2B object use

In = 7
Out1 = true
Out2 = true
219
EasyIO FG Series Sedona Kits User Guide v1.3

Out3 = true
Out4 to Out 32 = false

Limit
Limit is an object to limit an analog value.
A high limit and low limit value property determine the output value base on computation.

The property sheet of the object is shown below

 Out
Calculated Output Value.

 In
Input value.

 In Min
Input Low range.

 In Max
Input High range.

 Out Min
Output low range.

 Out Max
Output high range.

 Reverse
Reverse the computation.

True = reverse computation


False = normal computation

 Low Clamp Enable


220
EasyIO FG Series Sedona Kits User Guide v1.3

Low limit clamping.

True = clamping enable


False = clamping disable

 Low Limit
Low limit clamping value.

If Out < Low Limit,


Out = Low Limit,

If Out > Low limit,


Out = Out

If Out > Low Limit and < High Limit,


Out = Out

 High Clamp Enable


High limit clamping.

True = clamping enable


False = clamping disable

 High Limit
High limit clamping value.

If Out > High Limit,


Out = High Limit,

If Out <High limit,


Out = Out

If Out > Low Limit and < High Limit,


Out = Out

Mb4Regs
Mb4Regs is an that will combine 2 32 bit integer register to compute a 64bit value.

The property sheet of the object is shown below

 Out64
Computed 64 bit value.

221
EasyIO FG Series Sedona Kits User Guide v1.3

 In Big Endian
Byte order for each input.
 In High
High 32bit register value.
 In Low
Low 32bit register value.

MinMaxAvg
MinMaxAvg is an object that will calculate the Min, Max, Summation and Average of the inputs.
It supports up to 8 inputs.

The property sheet of the object is shown below

 Min
Minimum value base on 8 inputs.

 Max
Maximum value base on 8 inputs.

 Avg
Calculated average value base on Count specify in the count property.

 Sum
Calculated summation value base on Count specify in the count property.

 In1, In2…..In8
Input variable. Up to 8 inputs can be use.

222
EasyIO FG Series Sedona Kits User Guide v1.3

 Count
Property to enable total number of inputs that to be use for calculation.

Example of MinMaxAvg object use


In this example, it only computes 3 inputs as the count is specify to 3.

223
EasyIO FG Series Sedona Kits User Guide v1.3

NCmpr
NCmpr is Numerical Compare object provides a Boolean output.
The property sheet of the object is shown below

 In
Input value.

 Setpoint
Setpoint for the object computation.

The object computation algorithm is as below.

If In >= (setpoint - CutInOffset) && (in <= (setpoint + CutOutOffset)


Out = True

If In <= (setpoint - CutInOffset) && (in >= (setpoint + CutOutOffset)


Out = False

Offset

PFloatSelect
PFSelect is Priority Select. It only supports float value. There are 4 inputs floats value and 4 input
Enable.

The property sheet of the object is shown below

224
EasyIO FG Series Sedona Kits User Guide v1.3

 Out
Output value as per Enable selection

 In1, In2, In3 and In4


User define input float value.

 En1, En2, En3 and En4


Value enable for respective inputs.

En1 = true , Out = In1


En2 = true , Out = In2
En3 = true , Out = In3
En4 = true , Out = In4

Only 1 enable can be true in any condition. If 2 Enable are true, output will be
the higher priority value that enable.

 In1 Default
If set to true, default value is In1 if all enable are false. This is to eliminate
output to be zero in case the entire enable are false.

If set to false, out value will be zero if all enable are false.

225
EasyIO FG Series Sedona Kits User Guide v1.3

Example of PFSelect object use

226
EasyIO FG Series Sedona Kits User Guide v1.3

R134A
RateLimit
RateLimitis an object to reduce the update rate for a float value. In some cases, where a fast
value change will caused a fast ramp in the equipment. This object can slow down the value
change by ramping the value slowly.

The property sheet of the object is shown below

 Out
Output value after the a rate up or rate down process

 In
Input value for the ramp limit object.

 Disable
To disable the rate limiter.

 Rate Up
Rate of increasing the value if there is any change in the In slot.
Zero = disable.
Higher the value the slower the change of the Out value will be.

 Rate Down
Rate of decreasing the value if there is any change in the In slot.
Zero = disable
Higher the value the slower the change of the Out value will be.

The algorithm of the rate up and rate down is as below.


If the Diff > 0.0
Out =(Diff) / (rateUp * 1sec)

If the Diff < 0.0


Out =(Diff) / (rateUp * 1sec)
Where Diff = Input Last Value – Input Current Value

227
EasyIO FG Series Sedona Kits User Guide v1.3

S2B
S2B or Short to Bit conversion object. The output data type is Boolean. 16 outputs available.

The property sheet of the object is shown below

 In
Input of the conversion base on the short data type input.
The output data type is “boolean”

 Out1, Out2, Out3 ……. Out16


There are total 16 outputs for the object which supports up to a 16bit value.

Out1 = LSB (Least Significant Bit)


Out32 = MSB (Most Significant Bit)

Example of S2B object use

In = 3
Out1 = true
Out2 = true
Out3 to Out16 = false

228
EasyIO FG Series Sedona Kits User Guide v1.3

S2Time
S2Time or Short to Time conversion object. The output of this object is a time range in 24 hours
format. This output can be used for the EasyIO Boolean schedule time input string.
The property sheet of the object is shown below

 Out
Output of the conversion is time range, 24 hours format.
The output data type is a string data type

 In Start
The start time. Format is in 24 hours format.

0000 = 12.00AM
2399 = 11.59PM

 In Stop
The stop time. Format is in 24 hours format.

0000 = 12.00AM
2399 = 11.59PM

Example of S2Time object use.


The time range period is 8.00AM to 12.00PM is the on time.
User then can link this to the easyIO schedule.

229
EasyIO FG Series Sedona Kits User Guide v1.3

Time2S
Time2S or Time to Short conversion object. The output of this object is a absolute time in 24
hours format.
The property sheet of the object is shown below

 Out Start
Output of the conversion is absolute time, 24 hours format.
The output data type is a short data type

 Out Stop
Output of the conversion is absolute time, 24 hours format.
The output data type is a short data type

 In
This is the input time range of a string data type.
The time format is in 24 hours format.
Every segment must have 4 digits.
Example 8.00AM = 0800
12.00PM = 1200
Failure to comply to the above , may cause wrong conversion.

Example of S2Time object use.

Example of S2Time object with incorrect time settings.

230
EasyIO FG Series Sedona Kits User Guide v1.3

W2B
W2B or Word to Bit conversion object. The output data type is Boolean. 16 outputs available.

The property sheet of the object is shown below

 In
Input of the conversion base on the integer data type input.
The output data type is “boolean”

 Out1, Out2, Out3 ……. Out16


There are total 16 outputs for the object which supports up to a 32bit value.

Out1 = LSB (Least Significant Bit)


Out32 = MSB (Most Significant Bit)

Example of W2B object use

In =2
Out2 = true
Out1 = false
Out3 to Out16 = false

vice to send the update request to time server instead of waiting for auto update.

231
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioP2P
This kit contains 2 objects as show below.
By default an EasyIO Sedona controller comes pre-installed with this kit. To use any of the objects
simply drag and drop from the library into the wire sheet.

P2P Client Service


P2PClientService is an object where it sits in the client controller polling values from a P2PServer
controller.

This object contain 8 boolean output , 8 float output and 8 enum output. These outputs are used
to poll value from the user define server controller.

The property sheet of the object is shown below

 Status
This parameter will show the connection between the client and server .

 Status Output

232
EasyIO FG Series Sedona Kits User Guide v1.3

This parameter will show the connection between the client and server.
It gives user an Boolean output.

Online = P2P link good


Down = P2P link no good

 Enable
P2P client polling can be enable or disable with this parameter.

 Host Address
This is the server IP address.

 Port
By default the server port is 2011. However it can be change to other port if it is
occupy by other system.

 Poll Freq
By default polling frequency is set to 5 seconds.
Min poll frequency is 2sec and max is unlimited.

 Timeout
Time period to wait for a response from the server before it time out.

233
EasyIO FG Series Sedona Kits User Guide v1.3

P2P Server Service


P2PServerService is an object where it sits in the client controller polling values from a P2PServer
controller.

This object contain 8 boolean output , 8 float output and 8 enum output. These outputs are used
to poll value from the user define server controller.

The property sheet of the object is shown below

 Enable
P2P server sending can be enable or disable with this parameter.

 Status
Status of the server object. It will show error when another server object is
created with the same port. It will show “cannot binid to port.”

 Last Client Address


Shows the latest client connected to the server object.

 Port
By default the server port is 2011. However it can be change to other port if it is
occupy by other system.

234
EasyIO FG Series Sedona Kits User Guide v1.3

EasyioSchedule
EasyioScedule kit is built to provide the feature of scheduler. User may customize their schedule for a
total 7 weekdays and 2 holidays, while each day having 2 sessions.
EasyioSchedule contains 3 components:

The basic structure of implementing EasyioSchedule as below:

235
EasyIO FG Series Sedona Kits User Guide v1.3

Holiday Calendar
HolidayCalendar is used to specify up to 16 holiday dates. It allowed input date in the format either
“dd/mm/yy” or “mm/dd/yy”. It’s normally implement by link its output to Schedule property, either
Holiday1Enableor Holiday2Enable.
The property sheet of the object is shown below

 Status
To show current status of the HolidayCalendar, either indicate with “Ok” or relevant
error messages.
If any error message shown, all Boolean outputs will always set to false, until all
error is corrected by user.

 Out
HolidayCalendar’s output. True when current date matched with any of the 16
dates.

 Date Format
Date format that is currently in used, for user to enter the date and for component
to read the date entered.
Two date format allowed: “dd/mm/yy” or “mm/dd/yy”.
dd = day, mm = month, yy = year

236
EasyIO FG Series Sedona Kits User Guide v1.3

 Date1
Date setting for Holiday 1. Support Date range as well. Refer to example below.

 Date2
Date setting for Holiday 2.Support Date range as well. Refer to example below.

 Date3
Date setting for Holiday 3.Support Date range as well. Refer to example below.

 Date4
Date setting for Holiday 4.Support Date range as well. Refer to example below.

 Date5
Date setting for Holiday 5.Support Date range as well. Refer to example below.

 Date6
Date setting for Holiday 6.Support Date range as well. Refer to example below.

 Date7
Date setting for Holiday 7.Support Date range as well. Refer to example below.

 Date8
Date setting for Holiday 8.Support Date range as well. Refer to example below.

 Date9
Date setting for Holiday 9.Support Date range as well. Refer to example below.

 Date10
Date setting for Holiday 10.Support Date range as well. Refer to example below.

 Date11
Date setting for Holiday 11.Support Date range as well. Refer to example below.

 Date12
Date setting for Holiday 12.Support Date range as well. Refer to example below.

 Date13
Date setting for Holiday 13.Support Date range as well. Refer to example below.

 Date14
Date setting for Holiday 14.Support Date range as well. Refer to example below.

 Date15
Date setting for Holiday 15.Support Date range as well. Refer to example below.

 Date16
Date setting for Holiday 16.Support Date range as well. Refer to example below.

237
EasyIO FG Series Sedona Kits User Guide v1.3

Example of setting the Holiday Schedule.

Date 1 :Example of setting a single date that will occur every year. Noticed that year is set to wild card.

Date 2: Example of setting a date range. Holiday will occur from 7th Sept 2011 till 15th Sept 2011. This is
very useful for school holidays. This date range will only occur once.

Date 3: Example of setting a date range with wild card , every year from 7th August till 7th Sept will be a
holiday.

Holiday Schedule wild card applicable to date range and single date, but is limited as follow.

Single Date wild card : applicable to dd/mm/yy


Date range wild card : applicable to only mm/yy

238
EasyIO FG Series Sedona Kits User Guide v1.3

NumericSchedule
NumericSchedule is used to produce a numeric value scheduler output. The Schedule can be
configured up to 7 weekdays (Monday to Sunday) and 2 holidays, while each day having 4 sessions.
The property sheet of the object is shown below

In the example above there are 4 set points respectively 1.0, 2.0, 3.0 and 4.0.
The output value will be 1.0 from 8.00AM to 1159AM.
The output will change to 2.0 from 12.00PM to 1359PM and so on.

 Status
To show current status of the Schedule, either indicate with “Ok” or relevant error
messages.
If any error message shown, all Boolean outputs will always set to false, until all
error is corrected by user.

 Out Source
To indicate the source property, which provide the schedule output, Out.

 Out
Schedule’s output. A numeric value.

 Set Point 1
Output value number 1.

 Set Point 2
Output value number 2.

 Set Point 3
Output value number 3.

 Set Point 4
Output value number 4.

 Monday (Tuesday - Sunday)

239
EasyIO FG Series Sedona Kits User Guide v1.3

The current output value for the weekday Monday.

 Monday Start Point 1 (Tuesday - Sunday)


Start time of the day in 24 hours format for output = Set point 1.
Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Monday Start Point 2 (Tuesday - Sunday)


Start time of the day in 24 hours format for output = Set point 2.
Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Monday Start Point 3 (Tuesday - Sunday)


Start time of the day in 24 hours format for output = Set point 3.
Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Monday Start Point 4 (Tuesday - Sunday)


Start time of the day in 24 hours format for output = Set point 4.
Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

Schedule
Schedule is used to produce a boolean scheduler output, according to the scheduled time setting.
Schedule can be configured up to 7 weekdays (Monday to Sunday) and 2 holidays, while each day
having 2 sessions.
The property sheet of the object is shown below

240
EasyIO FG Series Sedona Kits User Guide v1.3

241
EasyIO FG Series Sedona Kits User Guide v1.3

 Status
To show current status of the Schedule, either indicate with “Ok” or relevant error
messages.
If any error message shown, all Boolean outputs will always set to false, until all
error is corrected by user.

 Out Source
To indicate the source property, which provide the schedule output, Out.

 Out
Schedule’s output, indicate either true or false.

 Monday
Monday scheduled output. If current day of week is Monday, Out will read this as its
value. Always set to False if day of week doesn’t match.

 Mon Schedule 1
Monday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Mon Schedule 2
Monday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Tuesday
Tuesday scheduled output. If current day of week is Tuesday, Out will read this as its
value. Always set to False if day of week doesn’t match.

 Tues Schedule 1
Tuesday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Tues Schedule 2
Tuesday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Wednesday
Wednesday scheduled output. If current day of week is Wednesday, Out will read
this as its value. Always set to False if day of week doesn’t match.

 Wed Schedule 1
Wednesday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Wed Schedule 2
Wednesday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

242
EasyIO 30P Sedona Kits User Guide v1.4

 Thursday
Thursday scheduled output. If current day of week is Thursday, Out will read this as
its value. Always show False if day of week doesn’t match.

 Thur Schedule 1
Thursday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Thur Schedule 2
Thursday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Friday
Friday scheduled output. If current day of week is Friday, Out will read this as its
value. Always show False if day of week doesn’t match.

 Fri Schedule 1
Friday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Thur Schedule 2
Friday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Saturday
Saturday scheduled output. If current day of week is Saturday, Out will read this as
its value. Always show False if day of week doesn’t match.

 Sat Schedule 1
Saturday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Sat Schedule 2
Saturday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Sunday
Sunday scheduled output. If current day of week is Sunday, Out will read this as its
value. Always show False if day of week doesn’t match.

 Sun Schedule 1
Sunday’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Sun Schedule 2
Sunday’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Holiday1 Enable

243
EasyIO 30P Sedona Kits User Guide v1.4

When set to true, it’s in holiday state, and override output from weekdays (Monday
to Sunday) and Holiday2. It has the highest priority.
Usually linked from HolidayCalendar’s Outproperty.

 Holiday1
Holiday1 scheduled output. If Holiday1 Enable is ON, Out property will read this as
its value. Always show False if Holiday1 Enable is OFF.

 Hol1 Schedule 1
Holiday1’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Hol1 Schedule 2
Holiday1’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Holiday2 Enable
When set to true, it’s in holiday state, and override output from weekdays (Monday
to Sunday). It has the higher priority than weekdays but lower priority than
Holiday1.
Usually linked from HolidayCalendar’s Outproperty.

 Holiday2
Holiday2 scheduled output. If Holiday2 Enable is ON, Outproperty will read this as
its value. Always show False if Holiday2 Enable is OFF.

 Hol2 Schedule 1
Holiday2’s first session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

 Hol2 Schedule 2
Holiday2’s second session time setting. Format: “HHMM-HHMM”.
HH = 0 – 23, MM = 0 – 59

Example of setting the schedule object.


Time On : 0800-1200
244
EasyIO 30P Sedona Kits User Guide v1.4

Time Off : 1201-1259


Time On : 1300-1800
Time Off : 1801-2399

245
EasyIO 30P Sedona Kits User Guide v1.4

EasyioSensor
This kit contains3 objects. All the objects are to be used to convert a raw input value to a logical value.
This kit is very useful when programming an EasyIO FG series controller.

To use any of the objects simply drag and drop from the library into the wire sheet. .

PresetTemp Table
Preset Temp Table is an object to scale the resistance versus temp value. The table is all preset to the
most commonly use sensor in the market.
This object cannot be edited.

The property sheet of the object is shown below

 Unit
Deg C or Deg F. this will automatically populate the table according to the selected
temperature unit.

246
EasyIO 30P Sedona Kits User Guide v1.4

 Table Type
Selection of preset table type.
Selection available is as below.
Honeywell 20K
Honeywell/Johnson Pt100
Invensys 10K with 11K Shunt
Invensys/Andover 10K Type 3
Invensys/Johnson 1K Platinum
Invensys/TAC 10K Type 2
Johnson NIkel 1K
Sauter Nikel 1K
Siemen/Landis Nikel 1K

 Out
Converted temperature value according to the table type chooses.

 In
Raw value input in resistance value.

Example of using the PresetTempTable object to scale a Platinum 1K temperature


sensor.

Temp Table
Temp Table is an object to scale the resistance versus temp value. This object enable user to define
the temp table according to their like.
It comes with 32 lines for custom temp table.

The property sheet of the object is shown below

 Out
Converted temperature value according to the table type chooses.

 In
Raw value input in resistance value.
 Temperature 1 ~ Temperature 32
User input temperature value.

247
EasyIO 30P Sedona Kits User Guide v1.4

 Resistance 1 ~ Resistance 32
User input resistance value.

Example of using the TempTable object to scale a Platinum 1K temperature


sensor with custom temperature table.

VoltCurrentTable
Volt Current Table is an object to scale input sensors for Voltage and Current type.
It comes with predefine linear table.
This object can be customized if the sensor used is not a linear curve sensor.
It comes with 11lines for custom table.

If a commonly use Voltage and Current sensor with linear curve, a reset block from the “control” kit
can be substitute. The reset block is a simple object.

The property sheet of the object is shown below

 In
Raw input value either in voltage (0-10V) or current (4.20mA , 0-20mA).

 Out
Calculated output value base on the custom table.

 In 1 ~ In 32
User input raw value.

 Out 1 ~ Out 32
User input calculated value.

248
EasyIO 30P Sedona Kits User Guide v1.4

Example of using the VoltCurrent Table object to scale a pressure sensor.

249
EasyIO 30P Sedona Kits User Guide v1.4

EasyioSub
This kit contains 5 objects. All the objects are to be used for engineer the Sedona apps.

Objects are originally from Tridium. These 5 objects are additional objects derived from Sedona
Workbench 1.0.47 control.kit. It is not available in Sedona Workbench 1.0.45.

To use any of the objects simply drag and drop from the library into the wire sheet. .

250
EasyIO 30P Sedona Kits User Guide v1.4

Count
Count is an object to count a Boolean value. It can be count “UP” or “DOWN”.

The property sheet of the object is shown below

 Out
Number of times "in" property has transitioned from 0 to 1

 Preset
Presets the counter to a specific value, defaults to 0

 Dir
Configure the direction. True = "up", False = "down"

 Enable
To enable input

 R
if r is true, out = preset and no counting takes place
It act as a reset switch

An example of Count object counting transition from a Tick Tock object

251
EasyIO 30P Sedona Kits User Guide v1.4

Loop Point
LP, PID loop object, this is an updated Loop Point, this fixes the output turn to “nan” when an invalid
Process Value is detected.

The property sheet of the object is shown below

 Enable
To enable the LP object

 Sp
Setpoint for the LP object

 Cv
Control Variable for the LP object

 Out
The output of the LP object

 Kp
Proportional gain for LP object

 Ki
Integral Gain for LP object

 Kd
Derivative Gain for the LP object

 Max
Scale Max for the LP output

252
EasyIO 30P Sedona Kits User Guide v1.4

 Min
Scale Max for the LP output

 Bias

 Direct
This parameter defines the output action.
True = cooling
False = heating

 Ex Time
Defines the interval at which the process variable is sampled or the loop algorithm is
executed in seconds.

MinMax
MinMax is an object that will show the Min and Max value of a float input value. It computes min
and max of an input value every execute cycle

 Min Out
The Min value for the input

 Max Out
The Max value for the input

 In
Input value which is to track

 R
Reset input.
If R = true, then minOut and maxOut are forced to "in" value.

An example of MinMax object computing the Min Value and Max Value from Ramp
object

253
EasyIO 30P Sedona Kits User Guide v1.4

TimeAverage
TimeAvg object averages "in" over the configured time. The actual time is marked in a resolution of
scan period such that number of samples

Averaged = time/Sys.app.scanPeriod

Note that this is NOT a running average - this object caches the average over the previous time
as the out value, and updates out every "time" ms.

Until a full time cycle has elapsed, the out is set to the average off all samples collected up until
that point.

The average may be reset/restarted at any time using the "reset" action.

The property sheet of the object is shown below

 Out
Value averaged over last "time" period

 In
The input value to average

 Time
The time period over which to average the in value to get the out value

An example of TimeAvg object computing the average from Carbon Dioxide Value
over period of every 1000ms.

Timer
Timer outputs a pulse for the configured amount of time "in" is used to fire the timer:
- if low, out is forced to false
- if high, out = 1 until timer reaches "time" seconds

254
EasyIO 30P Sedona Kits User Guide v1.4

Alternatively, the pulse can be fired from the "Start Timer" action if in is not linked.

The property sheet of the object is shown below

 Out
A timed pulse output.

 Run
Used to fire the timer on transition from false -> true

 Time
Desire duration of the output pulse.

 Left
Remaining time before the output transition from true -> false

An example of Timer object hold the out value to true until the timer time count
down to zero.

Tcom
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 Maxline Tcom Driver.
TCom kit is by Maxline.

To use any of the objects simply drag and drop from the library into the wire sheet. .

255
EasyIO 30P Sedona Kits User Guide v1.4

TcomService
TomService is an object use to integrate a Sedona controller with Niagara station via Sedona
protocol with Maxline Tcom driver.

The property sheet of the object is shown below

 Port
The port that been used to communicate between Niagara Station and a Sedona
controller.
By default is “5021”.

 Events Per Sec


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
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.

256

You might also like