easyio sedona kits for fwseries user guide...easyio 30p sedona kits user guide v1.4 property will...

EasyIO 30P Sedona Kits User Guide v1.4

EasyIO Sedona kits for FWseries

User Guide


Document Change Log

26th Oct 2017 Document created.


Disclaimer Confidentiality Notice

The information contained in this document is confidential information of EasyIO Holdings Pte Ltd. Such information and the software described herein, is furnished under a license agreement and may be used only in accordance with that agreement. The information contained in this document is provided solely for use by EasyIO Holdings Pte Ltd employees, licensees, and system owners; and, except as permitted under the below copyright notice, is not to be released to, or reproduced for, anyone else. While every effort has been made to assure the accuracy of this document, EasyIO Holdings Pte Ltd is not responsible for damages of any kind, including without limitation consequential damages, arising from the application of the information contained herein. Information and specifications published here are current as of the date of this publication and are subject to change without notice. The latest product specifications can be found by contacting our corporate headquarters or support channel. Trademark Notice EasyIO logo are registered trademarks of EasyIO Holdings Pte Ltd. CPT Tool is by Online Tools Inc. BACnet and ASHRAE are registered trademarks of American Society of Heating, Refrigerating and Air- Conditioning Engineers. All other product names and services, mentioned in this publication, that are known to be trademarks, registered trademarks, or service marks are the property of their respective owners. Copyright and Patent Notice This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form without prior written consent from EasyIO Holdings Pte Ltd Copyright © 2017 EasyIO Holdings Pte Ltd. All rights reserved

Disclaimer

The material in this manual is for information purposes only. The contents and the product it describes are subject to change without notice. EasyIO Holdings Pte Ltd makes no representations or warranties with respect to this manual. In no event shall EasyIO Holdings Pte Ltd be liable for any damages, direct or incidental, arising out of or related to the use of this manual.

EasyIO Holdings Pte Ltd 101, Cecil Street #09-07 Tong Eng Building Singapore 069533 [email protected]

mailto:[email protected]


Table of Contents Table of Contents ............................................................................................................................................ 4

Introduction .................................................................................................................................................... 8

DateTimeStd .................................................................................................... Error! Bookmark not defined.

DateTimeStd ................................................................................................ Error! Bookmark not defined.

EasyioCpt ........................................................................................................................................................ 9

CptService .................................................................................................... Error! Bookmark not defined.

EasyioFR02 .................................................................................................................................................... 11

FR02_Float ................................................................................................... Error! Bookmark not defined.

FR02_Stager ................................................................................................. Error! Bookmark not defined.

EasyioFW ....................................................................................................................................................... 16

Benchmark ................................................................................................................................................ 16

DO ............................................................................................................................................................. 17

EasyIOPlatform ......................................................................................................................................... 17

IPConfig ..................................................................................................................................................... 17

PressureSensor ............................................................................................ Error! Bookmark not defined.

UI............................................................................................................................................................... 18

UO ............................................................................................................................................................. 20

EasyioFWBacnet............................................................................................................................................ 21

BACnetService........................................................................................................................................... 21

BACServerNetwork ................................................................................................................................... 22

BACServerAV ............................................................................................................................................. 23

BACServerBV ............................................................................................................................................. 24

BACnetClientNETwork ................................................................................. Error! Bookmark not defined.

BACnetClientDevice ..................................................................................... Error! Bookmark not defined.

BACnetClientAI ............................................................................................ Error! Bookmark not defined.

BACnetClientAO ........................................................................................... Error! Bookmark not defined.

BACnetClientAV ........................................................................................... Error! Bookmark not defined.

BACnetClientBI ............................................................................................. Error! Bookmark not defined.

BACnetClientBO ........................................................................................... Error! Bookmark not defined.

BACnetClientBV ........................................................................................... Error! Bookmark not defined.

BACnetClientMSI.......................................................................................... Error! Bookmark not defined.

BACnetClientMSO ........................................................................................ Error! Bookmark not defined.

BACnetClientMSV ........................................................................................ Error! Bookmark not defined.

EasyioFWControl ........................................................................................................................................... 26

BooleanCommandFailure ......................................................................................................................... 26

BooleanSelect ........................................................................................................................................... 27

DiscreteTotalizer ....................................................................................................................................... 27


FloatCommandFailure .............................................................................................................................. 28

FloatTotalizer ............................................................................................................................................ 29

MinOnOff .................................................................................................................................................. 30

Push Button .............................................................................................................................................. 30

PWM ......................................................................................................................................................... 31

rebootApp ................................................................................................................................................. 32

restrtApp ................................................................................................................................................... 32

SaveApp .................................................................................................................................................... 32

EasyioFWConversion..................................................................................................................................... 33

B2L ............................................................................................................................................................ 33

B2S ............................................................................................................................................................ 34

B2W .......................................................................................................................................................... 35

E2I ............................................................................................................................................................. 36

IntDecoder ................................................................................................................................................ 36

L2B ............................................................................................................................................................ 37

MinMaxAvg ............................................................................................................................................... 38

PFloatSelect .............................................................................................................................................. 39

S2B ............................................................................................................................................................ 40

S2Time ...................................................................................................................................................... 41

Time2S ...................................................................................................................................................... 42

W2B .......................................................................................................................................................... 43

EasyioFWEnergy ............................................................................................................................................ 44

Degree Days ................................................................................................. Error! Bookmark not defined.

Heat Index .................................................................................................... Error! Bookmark not defined.

OpenWeather ........................................................................................................................................... 44

Psychometric ............................................................................................... Error! Bookmark not defined.

PulseAccumulator ..................................................................................................................................... 46

R134A ........................................................................................................... Error! Bookmark not defined.

R410A ........................................................................................................... Error! Bookmark not defined.

EasyioFWHvac ............................................................................................................................................... 47

Analog FIlter .............................................................................................................................................. 47

Drive .......................................................................................................................................................... 49

Fan Control ............................................................................................................................................... 50

LeadLagCycles .............................................................................................. Error! Bookmark not defined.

LeadLagCycles_3o1s .................................................................................... Error! Bookmark not defined.

LeadLagRuntime .......................................................................................... Error! Bookmark not defined.

PID Loop .................................................................................................................................................... 52

Sequence Loop ............................................................................................ Error! Bookmark not defined.


Sequencer .................................................................................................... Error! Bookmark not defined.

Single Loop ................................................................................................... Error! Bookmark not defined.

Thermostat ............................................................................................................................................... 58

EasyioFWMath ................................................................................................. Error! Bookmark not defined.

ArcCosine ..................................................................................................... Error! Bookmark not defined.

ArcSine ......................................................................................................... Error! Bookmark not defined.

Arc Tangent .................................................................................................. Error! Bookmark not defined.

Arc Tangent 2 ............................................................................................... Error! Bookmark not defined.

Ceiling .......................................................................................................... Error! Bookmark not defined.

Cosine .......................................................................................................... Error! Bookmark not defined.

Cosine Hyperbolic ........................................................................................ Error! Bookmark not defined.

Exponential .................................................................................................. Error! Bookmark not defined.

Float Absolute .............................................................................................. Error! Bookmark not defined.

Floor ............................................................................................................. Error! Bookmark not defined.

FMod ............................................................................................................ Error! Bookmark not defined.

Frexp ............................................................................................................ Error! Bookmark not defined.

Ldexp............................................................................................................ Error! Bookmark not defined.

Log ............................................................................................................... Error! Bookmark not defined.

Log 10 .......................................................................................................... Error! Bookmark not defined.

ModF ............................................................................................................ Error! Bookmark not defined.

Power ........................................................................................................... Error! Bookmark not defined.

Sine .............................................................................................................. Error! Bookmark not defined.

Sine Hyperbolic ............................................................................................ Error! Bookmark not defined.

Square Root ................................................................................................. Error! Bookmark not defined.

Tangent ........................................................................................................ Error! Bookmark not defined.

Tangent Hyperbolic...................................................................................... Error! Bookmark not defined.

EasyioFWP2P................................................................................................................................................. 60

P2PService ................................................................................................................................................ 60

P2PBoolPoint ............................................................................................................................................ 61

P2PFloatPoint ........................................................................................................................................... 62

P2PIntPoint ............................................................................................................................................... 63

EasyioFWPriority ........................................................................................................................................... 64

P_And2......................................................................................................... Error! Bookmark not defined.

P_BSwitch .................................................................................................... Error! Bookmark not defined.

P_CmprF ...................................................................................................... Error! Bookmark not defined.

P_CmprI ....................................................................................................... Error! Bookmark not defined.

P_FSwitch..................................................................................................... Error! Bookmark not defined.

P_ISwitch ..................................................................................................... Error! Bookmark not defined.


P_Not ........................................................................................................... Error! Bookmark not defined.

P_Or2 ........................................................................................................... Error! Bookmark not defined.

P_Xor ........................................................................................................... Error! Bookmark not defined.

PriorityBool .................................................................................................. Error! Bookmark not defined.

PriorityFloat ................................................................................................. Error! Bookmark not defined.

EasyioFWSchedule ........................................................................................................................................ 65

Holiday Calendar .......................................................................................... Error! Bookmark not defined.

NumericSchedule ......................................................................................... Error! Bookmark not defined.

BooleanSchedule ......................................................................................... Error! Bookmark not defined.

Optimized Start Stop ................................................................................... Error! Bookmark not defined.

EasyioSensor ................................................................................................................................................. 80

PresetTemp Table ........................................................................................ Error! Bookmark not defined.

Temp Table .................................................................................................. Error! Bookmark not defined.

VoltCurrentTable ......................................................................................... Error! Bookmark not defined.

EasyioUnitary ................................................................................................................................................ 82

Balancer Command .................................................................................................................................. 82

Flow Balance ............................................................................................................................................. 83

LP .............................................................................................................................................................. 84

TimeAvg .................................................................................................................................................... 85

Tcom ............................................................................................................................................................. 87

TcomService .............................................................................................................................................. 87


Introduction This document describe about the EasyIO Sedona kits and functionality for the FW series controller.

Kits that has a prefix of “easyioFW” are hardware dependent and they can only be used with FW series controllers. All images are captured from CPT Tools.


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. DO NOT rename this object.

DateTimeStd DateTimeStd object is an extended object from Sedona kit that has Daylight Saving Feature (DST). The open source codes are modified to extend the Day Light Saving by EasyIO. Daylight Saving Calculation is based on a standard formula. The formula will return the exact date and time upon time zone selection which observe DST. The extended property sheet of the object is shown below

Enable This property is to enable or disable the DST service. Selecting a time zone that observe DST will automatically enable/disable this property. User can choose to disable or enable it manually.

Is DST Show the status of current date and time either it is DST or Standard Time. Property will only display information if enableDST is selected to true.

Next DST Display the next DST event.


Property will only display information if enableDST is selected to true.

DST Offset Time offset during DST, default value 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 follow 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 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.

Other properties Other properties not stated are automatically configure upon time zone selection according to DST calculation formula. However user can manually modified them in case there is a change.


EasyioCpt This kit is a common kit for and can be used in EasyIO FS, FW and FT series for web server services. 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 accessed the CPT Service.

Port TCP port that the CPT service is running. DO NOT change this port number.


EasyioFR02 This kit is a common kit for and can be used in EasyIO FS, FW and FT series. These object are used in conjunction with EasyIO FR-02 device. By default the kit is installed and object is in the service folder.

FR02_Float FR_02 Float is an object to control a floating actuator when paired with EasyIO FR-02 device. The object require an 0-100% input and it will automatically calculate the output base on DriveTime to drive the FR02 on board relays. The property sheet of the object is shown below

Status Display the status of the object.

Input Control input to the object. It accepts 0 -100 numerical value.

Output Output control to be connected to a analog output object or any internal logic.

Drive Time Drive time of the actual actuator used. Unit is in seconds

Drive TimeOffset This property is to offset the actuator calculated position.


Diagram below shows an example of FR02_Float object being used. A PID output is controlling the FR02 and the FR02 is giving a 0-10 output to a physical UO.

FR02_Stager FR02_Stager is a 2 stage staging object output when paired with EasyIO FR-02 device. The object require an 0-100% or a direct boolean input to drive the FR02 relays. The property sheet of the object is shown below

ControlMode

It has 2 control modes, direct or percentage. If Direct mode is selected PercentageIn property is not applicable. If Percentage mode is selected Relay1Command and Relay2Command is not applicable.

PercentageIn Available if ControlMode = percentage. Input is 0-100%.

Staging1SP Stage 1 enable set point. Value to activate Relay 1 output. If PercentageIn ≥ Staging1SP Relay1Status = True Output = 4.0 If Percentage ≤ (Staging1SP – StagingOffDiff) Relay1Status = False Output = 0.0


Staging2SP Stage 2 enable set point. Value to activate Relay 2 output. If PercentageIn ≥ Staging2SP Relay2Status = True Output = 10.0 If Percentage ≤ (Staging2SP – StagingOffDiff) Relay2Status = False Output = 0.0

StagingOffDiff SP offset value before stage output turn off.

Output Output control value. Value range from 0.0 to 10.0

RelayCommand1 & RelayCommand2 Available if ControlMode = Direct Input is a boolean data. If RelayCommand1 &RelayCommand2 = False Output = 0.0 If RelayCommand1 = True Output = 4.0 If RelayCommand2= True Output = 6.0 If RelayCommand1 &RelayCommand2 = True Output = 10.0

RelayStatus1 & RelayStatus2 Display of the relay status of each relay output. It is a software calculated status. It is not a actual feedback status.


Diagram below shows an example of FR02_Stage object being used. A PID output is controlling the FR02.

FR02_Stage object is selected as percentage control.

Diagram below shows an example of FR02_Stage object being used. Boolean object is controlling the FR02 directly. FR02_Stage object is selected as direct control.


EasyioFT This kit only applicable for EasyIO FT series controller. This kit contains 7 objects as show below. By default the “EasyIOFTPlatform” object are pre-installed in the FT controller.

Benchmark Benchmark object shows the CPU loading in which it display a value that represents cycle per second. EasyIO component performance measurement, used to measure individual component and its execution 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 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 linear versus total number of components. Recommended value is above 35.

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


DO DO, Digital Output is an object to configure the Digital Output for the EasyIO FT Series controller. It is applicable to FT-04B and FT-04D only. There are 1 Digital Output channel for EasyIO FT-04B. There are 2 Digital Output channel for EasyIO FT-04D.

The property sheet of the object is shown below

Channel The output channel selection. Channel DO1 ~ DO2

Out Output of the digital output

In Input of the digital output

EasyIOPlatform EasyIOPlatform object is an object where it display the platform identifier which defines how the Sedona device should be provisioned and other identifier. The property sheet of the object is shown below.

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. The firmware build number is define by V1.0bXX , where xx is the build number.

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

Run Time Hour Sedona application run time in hours since last restart.

Run Time Min Sedona application run time in minutes since last restart.

Recovery Mode 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. 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.

Default Selection

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.

AI AI, Analog Input component provides a means of reading the analog value connected to one of the physical analog type points on a controller. The universal input support voltage, resistance and dry contact. The input type is selectable via UI configuration object in Sedona workbench and hardware on board jumpers. 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


Out The output value of the input channel depending to the input type selection. Output value is raw value.

Channel The input selection channel. Channel 1 ~ Channel 2

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

Voltage, 0-10V Resistance, up to 50K Ohm

For temperature sensor connection, choose Resistance input type. Link the out slot to a TempTable from the easyioFTSensor kit with PresetTemp table object.

Scaling Input scale multiplier if input type is voltage. Not applicable to resistance and digital input type.

Offset Offset multiplier for out property. Out =( In * Scale ) + Offset

Example of AI, Analog 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 AI, Analog 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 control kit) OR use the built in scaling property to scale the value.

Configure the ResetIn Min, In Max, Out Min and Out Max. It will automatically scale the output.

AO AO ,AnalogOutput component provides component provides an interface to the physical analogue output point that can source/drive a 0 to 10V voltage signal. There are 2 analog output points on EasyIO FT-04 controller that support voltage.

The property sheet of the object is shown below.

Out Output of the channel in raw value according output type selection. Out is 0 ~ 10v

Channel The input selection channel. Ao1 ~ AO2.

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


EasyioFTBacnet This kit only applicable to EasyIO FT series controller.

BACnetService BACnetService is an object that represents the EasyIO FT 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.

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 This property will display the IP address of the controller IP port.

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

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

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

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.

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.

COM Lost BACnet server communication lost monitoring. If there is no BACnet data packet within the COM lost timeout period the property will display true.

COM Lost timeout BACnet server communication monitoring timeout period. Unit is in seconds.

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 – 15.

Object Name 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.

Out of service Out of service property.

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 – 15.

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.

Out of service Out of service property.


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

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

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.


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.

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

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

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.



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.

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


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 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 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.

PWM PWM is an object that trigger the boolean output periodically. The property sheet of the object is shown below

Enable Enable and disable the PWM object.

Duty Cycle Duty cycle in percentage over the period of time.

Period Period of time for each cycle.


rebootApp rebootApp is an object which will reboot the Sedona VM if a true Boolean input is received. It has a Hold Time 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.

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.


EasyioFTConversion These objects are fundamentally for conversions. To use any of the objects simply drag and drop from the library into the wire sheet.

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)

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”


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 ~ In6 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 B2S object use


Out = 20 + 21 + 22

Out = 7

B2W B2W or Bit to Word conversion object. The output data type is “word”


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 ~ 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 = 20 + 21 + 22

Out = 7

E2I E2I or Enum to Integer conversion object. It convert a enum value to an integer value. The property sheet of the object is shown below

IntDecoder IntDecoder is an object where it converts an integer value to a Boolean bit according to the input value. The property sheet of the object is shown below

In

Input value. An integer format value.

Out 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

L2B L2B or Long to 32 Bit conversion object


In Input of the conversion base on the long data type input. The output data type is “boolean”

Out1 ~ 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 Out3 = true

Out4 to Out 32 = false.

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 ~ In8 Input variable. Up to 8 inputs can be use.

Count Property to enable total number of inputs that to be use for calculation.


Example of MinMaxAvg object use

PFloatSelect PFSelect is Priority Float Select. There are 4 inputs floats value and 4 input Enable. The property sheet of the object is shown below

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.

Example of PFSelect object use

S2B S2B or Short to Bit conversion object. The output data type is Boolean. 16 outputs available.


In Input of the conversion base on the short data type input. The output data type is “boolean”

Out1 ~ 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

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.


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 Time2S object use.

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 ~ 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 =3

Out2 = true Out1 = true

Out3 to Out16 = false


EasyioFTEnergy 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.

OpenWeather OpenWeather object provides a real time weather forecast obtain from https://openweathermap.org/ The property sheet of the object is shown below

Status Display the object status

Last Update Display the last update timestamp.

Connection State Display the connection state.

Enable Enable or disable the object.

DNS Fault Casue Display the DNS fault is any.

Host Name Query Freq

https://openweathermap.org/


URL query frequency.

Host Name Open Weather http server address.

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 open weather URL.

API key An API key is required. Register at www.openweather.org for a free API key.

Query By Selection of query option. You can either choose by city name or ID.

Location ID Query ID or city name. Query ID can be obtain via URL of the city when browsing web browser.

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.

http://www.openweather.org/


PulseAccumulator PulseAccumulator is a component totalize pulse value. The property sheet of the object is shown below

Enable Enable Pulse Accumulator

Total Unit Pulse Accumulator current total unit The max pulse count is 4,294,967,295 (4.2 billion pulse count)

Total Cost Pulse Accumulator current total cost

Unit per Pulse The number of units represent by a pulse input.

Cost per Unit The cost per unit.


EasyioFTHvac These objects are for HVAC equipment control. To use any of the objects simply drag and drop from the library into the wire sheet.

Analog FIlter AnalogFilter, this object is an improved analog value filtering. 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


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 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 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.


High 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.

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:


PID Loop PID loop is a just another component for PID control. 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 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 set point error.

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

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:

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.


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

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.

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

Example of using the Single Loop object.


Thermostat Thermostat object provides the output control based on the input (process) and the set point value. Thermostat in cooling operation

Thermostat in heating operation:



Out Output state, ON or OFF as the comparison result of ProcessValue and SetPoint. Read only

Enable Enable 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.


EasyioFTP2P This kit provides capability to share points between EasyIO FG, FS, FT and FW 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. Make sure all the controllers that runs P2P service are running the same version.

Min Update Time This property defines the update period of each poll.

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. Not changeable.

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” when there are more than 1 device connected to the P2P service.

OnStartDataSync This property enable the controller to obtain all the latest data set before it broadcast its own set of dataset to the P2P service.

P2PBoolPoint P2PBoolPoint is a Boolean data type child component for FGP2P service. It utilizes Register bit to maximize a single 32 bit register. Each Boolean P2P represent 1 bit. 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.


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



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.

PointName A property of point name for reference.

Fallback Fallback value option in case of P2P service alive status is down.

EnableMaxWrite Enable Max write time for point. Max write time is a periodic rewrite polic. Max write time will periodically write to P2P address even no change of value occur.

P2PFloatPoint P2PFloatPoint is a float data type child component for FGP2P service. The property sheet of the object is shown below



Fault Cause Display the fault cause.









P2PIntPoint P2PIntPoint is a integer data type child component for FGP2P service. The property sheet of the object is shown below


Fault Cause Display the fault cause.










PointName A property of point name for reference.

Fallback Fallback value option in case of P2P service alive status is down.

EnableMaxWrite Enable Max write time for point. Max write time is a periodic rewrite polic. Max write time will periodically write to P2P address even no change of value occur.

RouteAddress RouteAddress is not in use at the moment. It is planned for future expansion of P2P service.


EasyioFTPriority Objects are priority objects. It is used for priority comparison.

P_And2 P_And2 is an AND gate logic object. There is an option to output null value. 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 to output null value. 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.


P_CmprF P_CmprF is a simple mathematic float value comparison object. It compares 2 float values. There is an option to output null value. 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 to output null value. 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_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 to output null value. 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 to output null value. 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_Not P_Not reverse object for a Boolean input. There is an option to output null value. 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 to output null value. 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 to output null value. 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.

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 This is a minimum ON ti me period for the state before it allow change of state.

Delay Off This is a minimum OFF time period for the state before it allow change of state.


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 This is a minimum time period for the value to stay before it allow change of a different value.


EasyioFTSchedule These objects are used for scheduling and energy control optimizations. To use any of the objects simply drag and drop from the library into the wire sheet.

BooleanSchedule 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 ON time period. The property sheet of the object is shown below

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 Indicate the source property, which provide the schedule output.

Out Schedule’s output, indicate either true or false.

NextScheduleSource Indicate the next schedule day source.

NextSchedule Indicate the next schedule date and time.

NextScheduleSeconds Indicate the next schedule date and time in nano seconds format.

NextScheduleValue Indicate the next schedule output value.

Out Schedule’s output, indicate either true or false.


Monday ~ Sunday 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 ~ Sunday Schedule 1 7 days first schedule event period time setting. Format: “HHMM-HHMM”. HH = 0 – 23, MM = 0 – 59

Mon Schedule 2 ~ Sunday Schedule 2 7 days second schedule event period time setting. Format: “HHMM-HHMM”. HH = 0 – 23, MM = 0 – 59

Holiday1 Enable When set to true, it’s in holiday state, and override weekdays output (Monday to Sunday) and Holiday2. It has the higher priority compare to Holiday 2. Usually linked from Holiday Calendar’s Out property.

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 compare to weekdays weekdays but lower priority compare to Holiday1. Usually linked from Holiday Calendar’s Out property.

Holiday2 Holiday2 scheduled output. If Holiday2 Enable is ON, Out property 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

Calendar Calendar is used to specify up to 16 holiday dates. It allowed input date in the format either “dd/mm/yy” or “mm/dd/yy”. 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 matches any of the 16 dates input.

Current ScheduleEnd Provides information of current schedule end date.

NextScheduleStart Provides information of next schedule start date.

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

Date1 ~ Date 16 Date setting for Holiday 1 to 16. Exact date and date range is supported. Wildcard is also supported for day, month and year by 2 * symbol.

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

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.





Monday (Tuesday - Sunday) 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




Optimized Start Stop Optimized Start Stop 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 options 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 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


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 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.

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.

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. Below is a sample of the object configurations.


EasyioFTSensor All the objects are to be used to scale a raw resistance input value to a temperature value. 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 to temperature value. The table is all preset to the most commonly use sensor in the market. 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.

Table Type Selection of preset table type. Selection available is as below.

Thermistor 20K Invensys 10K with 11K Shunt Thermistor 10K Type 3 Thermistor 10K Type 2

Out Scaled temperature value according to the table type chosen.

In Raw value input in resistance value.


Steinhart Steinhart is an object to scale the resistance to temperature value using the sensor coefficient value. This object allows user to use multiple type of sensor up to 20K Ohm with just providing coefficient value. The property sheet of the object is shown below.

Out Output scaled value.

nominalTemp The temperature value when at nominal resistance value.

nominalResistance The resistance value when at nominal temperature value.

BValue Sensing element coefficient value provided by a sensor manufacturer.

InRes Input of resistance value from Universal Object.


EasyioUnitary This kit contains 5 objects. Objects created in this kit is specifically to be used with FW series VAV application. The kit can also be used with any other series controller and any apps as well.

Balancer Command Balancer Command is an object use to override a damper command within FW series VAV application. It can perform Max Flow SP, Min Flow SP, Fully Open, Fully Close and Auto mode. The property sheet of the object is shown below

CfmSpOut Flow set point output. The output value is determine by the BalOvrd value.

PosOut Damper Position output. The output value is determine by the BalOvrd value.

CfmSpIn Calculated flow set point input.

PosIn Calculated damper Position input.

BalOvrd Balancer override.

Balancers Overrride

1= Auto

2=Min Flow

3=Max Flow

4=Full Close


5=Full Open

If BalOvrd = Auto (1) , CfmOut = CfmIn If BalOvrd = Min Flow (2) , CfmOut = MinFSp If BalOvrd = Max Flow (3) , CfmOut = MaxFSp If BalOvrd = Fully Close (4) , CfmOut = 0.0 and PosOut = 0.0 If BalOvrd = Fully Open (5) , CfmOut = CfmIn and PosOut = 100.0

MaxFSp Max Flow Set point.

MinFSp Min Flow Set point.

SafeReq if the balancer mode return to Auto Mode, the object will perform an save action.

Flow Balance Flow Balance is an object calculator to calculate the actual flow rate base on differential pressure input. It also act as a flow balancing calibration object.

CfmOut Calculated AirFlow. The formula of calculating the flow is a simple ratio calculation between ZeroCfm and MinFlow and then from MinFlow to MaxFlow and then from MaxFlow to Kfactor.

DpIn Differential Pressure Input.

ZroDp Zero pressure input value.

MinFlw Actual measured minimum flow during min flow calibration.

DpMaxUnit Differential Pressure Unit This selection will reflect the DpMax property.


DpMax Differential pressure max allowed value. This selection is reflected by DpMaxUnit selection. If DpMaxUnit = inch WC DpMax = 1.00 inch WC If DpMaxUnit = metric DpMx = 250 pascals

MaxFlw Actual measured maximum flow during max flow calibration.

kFactor K-factor value of the VAV box.

LP LP is an object PID object derived from the Sedona Framework open source object. It is modified to specifically suit EasyIO VAV application. It can also be used with other login control. The modification done in this object is where a deadBand is used to prevent hunting.

Enable Enable or disable the PID loop execution. If disable, out = startValue.

StartVal Output value if object is disable. Default is zero.

SP PID Setpoint

CV Constant variable


Out Calculated output value.

kP Proportional Constant

kI Integral Constant

kD Derivative Constant

Max Maximum output value allowed.

Min Minimum output value allowed

Bias Bias to output is integral is zero.

MaxDelta Max value change allowed in exTime (execution time)

Deadband Deadband for Constant Variable.

direct Direct acting or reverse acting of the PID loop formula.

exTime Execution time for the PID to execute every computation.

TimeAvg TimeAvg object averages "in" over the configured time. The actual time is marked in a resolution of scan period (see App.scanPeriod) such that number of samples averaged = time/Sys.app.scanPeriod Note that this is NOT a running or moving 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. Enable TCom


out Average output value.

In Input value

Time Time period over average the in value to get the out value


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.

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.


Appendix

Invensys 10K Thermistor type III Resistance Value (Ohm) Temp Value (Celcius) Temp Value (Fahrenheit)

239,800 -40.00 -40.00

78,910 -20.00 -4.00

47,540 -10.00 14.00

29,490 0.00 30.20

23,460 5.00 41.00

18,790 10.00 50.00

15,130 15.00 59.00

12,260 20.00 68.00

10,000 25.00 77.00

8,194 30.00 86.00

6,752 35.00 95.00

5,592 40..00 104.00

4,655 45.00 113.00

3,893 50.00 122.00

3,270 55.00 131.00

2,760 60.00 140.00

2,339 65.00 149.00

1,990 70.00 158.00

1,700 75.00 167.00

1,458 80.00 176.00

816.8 100.00 212.00

481.8 120.00 248.00

Invensys / TAC 10K Thermistor Type II Resistance Value (Ohm) Temp Value (Celcius) Temp Value (Fahrenheit)

337200 -40.00 -40.00

97130 -20.00 -4.00

55340 -10.00 14.00

32660 0.00 30.20

25400 5.00 41.00

19900 10.00 50.00

15710 15.00 59.00

12490 20.00 68.00

10000 25.00 77.00

8056 30.00 86.00

6531 35.00 95.00

5326 40..00 104.00

4368 45.00 113.00

3602 50.00 122.00

2987 55.00 131.00

2489 60.00 140.00

2084 65.00 149.00

1753 70.00 158.00

1482 75.00 167.00

1258 80.00 176.00

679.8 100.00 212.00

389.4 120.00 248.00


Invensys 10K Thermistor with 11K Shunt Resistance Value (Ohm) Temp Value (Celcius) Temp Value (Fahrenheit)

10,517.5 -40.00 -40.00

9,654.20 -20.00 -4.00

8,933.00 -10.00 14.00

8,011.60 0.00 30.20

7,488.70 5.00 41.00

6,938.20 10.00 50.00

6,369.30 15.00 59.00

5,797.90 20.00 68.00

5,238.10 25.00 77.00

4,695.90 30.00 86.00

4,183.90 35.00 95.00

3,707.30 40..00 104.00

3,270.80 45.00 113.00

2,875.40 50.00 122.00

2,520.70 55.00 131.00

2,206.40 60.00 140.00

1,928.90 65.00 149.00

1,685.10 70.00 158.00

1,472.40 75.00 167.00

1,287.40 80.00 176.00

760.30 100.00 212.00

461.60 120.00 248.00

Honeywell 20K Thermistor Resistance Value (Ohm) Temp Value (Celcius) Temp Value (Fahrenheit)

814,000 -40.00 -40.00

220,060 -20.00 -4.00

122,380 -10.00 14.00

70,200 0.00 30.20

53,800 5.00 41.00

41,560 10.00 50.00

32,340 15.00 59.00

25,340 20.00 68.00

20,000 25.00 77.00

15,884 30.00 86.00

12,696 35.00 95.00

10,210 40..00 104.00

8,258 45.00 113.00

6,718 50.00 122.00

5,494 55.00 131.00

4,518 60.00 140.00

3,734 65.00 149.00

3,100 70.00 158.00

2,586 75.00 167.00

2,168 80.00 176.00

1,113.8 100.00 212.00

609 120.00 248.00

easyio sedona kits for fwseries user guide...easyio 30p sedona kits user guide v1.4 property will...

Documents