Beruflich Dokumente
Kultur Dokumente
25thNov 2013
Document created.
27thDec 2013
Real time chart and collection table view.
7thJan 2014
User guide updated base on CPT Tool Built 2014-01-03.
Disclaimer
EasyIO 30P is a product by EasyIO Holdings Pte Ltd
The EasyIO 30P was built on the Sedona Framework .
EasyIO FG-32 is a product by EasyIO Holdings Pte Ltd
The EasyIO FG-32 was built on the Sedona Framework .
Sedona Framework is a trademark of Tridium, Inc.
CPT Tool is by Online Tools Inc.
Table of Contents
Introduction ............................................................................................................................................ 5
Prerequisite ............................................................................................................................................. 5
Connecting to the Sedona Controller ..................................................................................................... 6
Sync the Controller Time......................................................................................................................... 8
Build a simple logic in the Sedona App ................................................................................................... 9
Create New Folder / Rename Folder .................................................................................................. 9
CreateSedona Program in Sch Folder ............................................................................................... 11
CreateSedonaProgram in Cool Folder ............................................................................................... 14
Create Sedona Program in Vent Folder ............................................................................................ 17
Build Graphics Pages (Gr Page) ............................................................................................................. 20
Create New Gr Page/Rename Page .................................................................................................. 20
Build Air Handling Unit Gr Page Part 1.............................................................................................. 22
Build Air Handling Unit Gr Page Part 2.............................................................................................. 29
Build Schedule Unit Gr Page ............................................................................................................. 34
Build Live Chart Gr Page .................................................................................................................... 37
Deploying Graphics ............................................................................................................................... 41
View Graphics in Web Browser............................................................................................................. 44
Create User Define Library .................................................................................................................... 49
Create Sedona objects library ........................................................................................................... 49
Create Gr widget library.................................................................................................................... 52
FG Series Bacnet Server ........................................................................................................................ 54
Create Bacnet Server Network ......................................................................................................... 54
Create Bacnet Server Binary Point .................................................................................................... 55
Create Bacnet Server Analog Point ................................................................................................... 57
Test FG Series Bacnet IP Server ........................................................................................................ 57
Test Lab Submission .............................................................................................................................. 58
Introduction
Thank you for attending our EasyIO Sedona Training Program.
In this lab exercise, you will be guided in building simple Sedona Application into the EasyIO FG
Series Sedona Controller provided to you.
The exercise as well will guide you to build simple Graphics Page using the Sedona program built in
the Sedona Controller.
Prerequisite
1. Computer (PC). Preferably Windows OS.
2. Sedona programming tool; the CPT Tool by Online Tools Inc(Minimum version : 27 Dec 2013)
3. Network cable to connect to an EasyIO FG Series controller. (optionally a network switch can be
used to connect between both PC and an EasyIO FG Series controller)
4. EasyIO Sedona Controller; EasyIO FG Series, minimum firmware V2.2.2.0.05
5. 24 VAc power supply to power up the EasyIO FG Series.
6. Micro SD memory card. Capacity range from 1GB to 16GB.
Step 1
Manually change the computer IP address to be same subnet as the EasyIO FG series.
Default IP address for EasyIO FG Series controller is 192.168.10.11.
You will need to assign an IP address for the computer ranging from 192.168.10.1 to 192.168.10.254
(excluding 192.168.10.11 as this is the EasyIO Controller IP address).
Step 2
Locate the CPT tool executable file and launch the program by double clicking the CPT Tool icon
.
Step 3
Connect to the EasyIO FG Sedona Controller with the credentials below.
The EasyIO FG controller IP address is at default which is as below.
IP Address
Subnet Mask
Username
Password
: 192.168.10.11
: 255.255.255.0
: admin
: <blank>, do not put in any password
Step 4
The CPT Tool should display the navigation tree on the left side bar with the IP address as the header
(title).
To install a kit tick at the check box next to the kit name.
Kits that are preinstalled and do not need further action are:
1. Sys
2. Control
3. dateTime
4. dateTimeStd
5. easyioFG
6. inet
7. sox
8. tcom
Additional kits that need to be installed are:
1. easyioControl
2. easyioCpt
3. easyioHvac
4. easyioLimKit
5. easyioSchedule
Hit Apply
Step 6
CPT will proceed with kits installation and will reboot the EasyIO FG controller.
A manual reconnection to the EasyIO FG controller is required.
Step 3
Hit Save at the New Date Time option. The controller RTC should now sync with the computer. This
can be verified by checking the Sedona Date Time option.
Step 4
Save the Sedona app by invoking the Save action.
Step 2
Create 2 more folders under apps and named it Cool and Vent respectively.
Creating folders is by right click at
10
Step 2
Drag and drop a DO object from easyioFG library and rename it as Occupy
This object will replicate a Digital Output.
Step 3
In the same Occupy object set the channel property to DO1.
Step 4
Create link between both objects using the draw method by moving the mouse pointer over the
value slot you require.
A thumbnail will show, Click and hold on it the required point.
Drag the link (almost like a connection wire or line) from the source or output to the destination slot,
connection point or input you require, then release the mouse button when the required input is
reached (line connects the two points). The link will automatically be made.
Source in this exercise is the Enable object outSlot and the destination is Occupy inSlot.
11
Step 5
Drag and drop an S2Time object from easyioLimKit library in to the same workspace.
This object is convert 2 Integer value to a string output.
Step 7
Drag and drop 2 WriteInt from the control library and named as OnTime and OffTime
respectively.
Right click on the object choose Action > Set. Set the output value to 800 and 1800 respectively.
0800 represents 8.00AM and 1800 represents 6.00PM.
Step 8
Complete the program by linking between objects as display below. In the logic below the OnTime
and OffTime object is used to represents Monday, Tuesday, Wednesday, Thursday and Friday
schedule.
Optionally you can create the combination of these OnTime, OffTime and S2Time object for each
day.
12
13
Step 2
Drag and drop a second WriteFloat object into the same workspace. Rename it as SetPt
Set the output value to 24.50oC (75.00 oF)
Step 3
Drag and drop a third object singleLoop from easyioHvac kit, Rename it as PID.
Click on the object and set the property at the right side bar with the given value below and leave
the others as default if not mention.
Throttling Range
Integral Gain
Scan Time
Ramp Time
: 6.00
: 0.10
: 5 seconds
: 5 seconds
Step 4
Drag and drop UO object from the easyioFG kit, named it Valve
Select Percentage 0-10V in the output Type property and Channel UO1 in the channel property.
Create links between the objects in this workspace as display below using the steps discussed earlier.
The completed logic including links should same as below.
14
15
A completed program for Cool folder will display as below. Note that there are 2 pins at the
singleLoop object.
Pin/Pins represent a link from external source (another folder) within the Sedona apps.
In this exercise the external links came from the Occupy object in the Sch folder
Step 7
Save the Sedona app by invoking the Save action.
AT THIS POINT YOU HAVE COMPLETED THIS PART OF THE EXERCISE
16
Step 1
Double click Vent (Ventilation) folder to display the workspace.
Drag and drop a Ramp from control library and rename it as CO2.
Click on the object and set the property as below and leave the rest as default if not mention.
Min
Max
Delta
: 500.0
: 2000.0
: 1.00
Step2
Drag and drop WriteFloat object into the same workspace. The WriteFloat is available from
control library. Rename it as SetPt.
Set the output value to 900.00.
Step 3
Drag and drop a third object Cmpr (compare) from Control library. Make the links between the
objects to complete the logic as display below.
Step 4
Drag and drop WriteBool object from control library and rename it as Fan_En
Drag and drop And2object from the control library.
Link Fan_En object outSlot to And2 object in1Slot.
17
Step 5
Drag and drop 2 DO object from easyioFG library and name it respectively ExFan01 and ExFan02.
In the property sheet of each object select DO2 and DO3.
Link the ExFan01 and ExFan02 to the And2 object outSlot.
Step 6
Complete the logic by linking the Cmpr object xgy slot to And2 object in2Slot.
The completed logic is as below.
18
Step 5
Save the Sedona app by invoking the Save action.
19
Step 1
Locate graphic icon
on the left side bar, right clicking it will bring the selection menu.
Choose New Graphic. Give the Gr page a name, in this example it is named as AHU.
20
Step 2
Set the AHU Gr page as home page by right click on the AHU Gr page and choose Set as Home.
If this step is done correctly, the icon for the Gr page will change and a small home image can be
seen in the icon.
Step 3
Renaming Gr page can be done at a later stage by right clicking at the Gr page and choose Rename
Graphic.
This Gr page name will appear in the web browser later.
Step 5
Save the Sedona app by invoking the Save or action keyboard shortcut key CtrL + S.
21
Step 2
Drag and drop the Duct A image from the ducts library.
This step demonstrates creating a static image/widget into a Gr page.
A single click on the image dropped in the workspace will display the image properties at the right
side bar.
22
Font properties
Font text colour properties
23
The two sensor images are dragged and dropped into the Gr page as static image. The
tempSensorTop object.
The arrows images are dragged and dropped into the Gr page as static image. The arrows
object are from Gr misc library.
24
A selection window allows you to select the slot for the point and also the widget to use from the
library.
Choose the Occupy out Slot on the left and equipment library, fanRight on the right.
Hit OK.
This widget will represent Blower Fan. Place the widget to the left of the Coil image.
25
Step 6
Create 2 more Fan widgets by using the ExFan01 and ExFan02point from the Vent folder.
This time use the fanLeft from the equipment library.
26
Step 7
Create 3 text labels to represents the fan images as display below. Text label are available in the
general library.
Top right fan image label: Exhaust Fan 01
Top left fan image label: Exhaust Fan 02
Bottom fan image label: Blower Fan
27
Step 8
Save the Sedona app by invoking the Save or action keyboard shortcut key CtrL + S.
AT THIS POINT YOU HAVE COMPLETED THIS PART OF THE EXERCISE
28
In the selection window choose Out slot and Label widget from General library.
Dragging a point from the Sedona apps into a Gr page and choosing the label as the widget will
automatically create a label with binding to the Sedona point.
This label will display real time value of the point.
Step 2
By default every text label binding format string will shows %s in the Gr workspace.
This is the default formatting. The web browser will display numerical value with 4 precision places
as25.1234.
The text label binding supports multiple formatting. In order view the supported formats, click on
the text label binding and choose the text property
right side bar.
on the
In the pop up window move the mouse pointer to the format string field. The text label formatting
tips will be shown.
Step 3
In this example for the temp value binding Temperature is %.2f Deg C is being used with %.2f format
displaying the real time value with 2 precision places.
This formatting will return Temperature is 25.00 Deg C with 25.00 point value as the value.
29
The colour chooser will prompt for colour selection. Change the colour to other than black.
In this example a dark blue with the colour RGB code as below.
Step 8
Create the Cooling Valve text label bindings. Use the Valve widget from the Cool folder.
Step 9
Change the formatting for this object to be as Cooling load is at %.2f %%.
The formatting will return Cooling load is at 50.00 % with 50.00 point value as the value.
The two %% character will format a percentage (%) symbol.
30
Step 10
Place the cooling valve text value bindings below cooling valve image.
Step 11
Create 2 more text label bindings. This time use the CO2 object and the SetPt object from the Vent
folder.
For both texts label bindings use the formatting as below.
CO2
SetPt
Step 12
Place both text value bindings above Temp sensor object at the top duct near the filter image.
Both text bindings are writable.
31
The colour chooser will prompt for colour selection. Change the colour to other than black.
In this example a dark blue with the colour RGB code as below.
The colour chooser will prompt for colour selection. Change the colour to other than black.
In this example a dark blue with the colour RGB code as below.
Step 16
Place text value bindings above the two Exhaust image.
A completed AHU Gr Page is as display below.
Step 17
Save the Sedona app by invoking the Save or action keyboard shortcut key CtrL + S.
32
Step 2
Using the same instructions above, create text labels with black bold font for the text display below.
34
Place the On Time and Off Time according to the weekday On Time and Off Time.
In this example the On Time and Off Time for Monday to Friday comes from the same object.
Step 4
Change the text binding colour to by choosing the text colour property.
The colour chooser will prompt for colour selection. Change the colour to other than black.
In this example a dark blue with the colour RGB code as below.
35
Step 2
Using the same instructions create the page title for the Gr page. Give the title Live History Chart.
Step 3
Drag and drop the CO2 object from the Vent folder.
In the pop up folder choose the Out slot and Table from General Library. Click OK.
37
Step 5
Drag and drop the CO2 object again into the Gr page workspace.
Select Out slot and LineChart from Chart library in the pop up.
Step 6
Position the chart under the collection table.
Choose the property
and put in CO2 , ppm.
The text entered here will be the legend for the live chart at the right side of the chart.
Step 7
Choose the maxOfYAxis property and set it to 2000.00.
Choose the minOfYAxis property and set it to 450.00.
Optionally you can change the line stroke colour.
38
Step 8
Right click the line2 property
Step 9
In the pop up window select SetPt from the Vent folder.
Leave the Events binding as default.
39
Step 10
Save the Sedona app by invoking the Save or action keyboard shortcut key CtrL + S.
40
Deploying Graphics
In this exercise, we will deploy the created graphics into the EasyIO FG controller.
The EasyIO FG series controller must preinstalled with a micro SD memory card.
To install the micro SD card;
1. Power off the controller
2. Open the top cover by unscrew the 2 mounting screws.
3. Slide the micro SD card holder toward the centre of the controller.
4. Carefully lift up the metal cage.
5. Insert the micro SD card and carefully lower down the metal cage.
6. Slide the metal cage outwards. You will hear a click when the metal cage is fastened.
7. Power On the controller.
Step 1
Go to CPT shortcut menu bar. Locate the deploy shortcut icon
Click on the triangle to show other option.
Step 2
Choose Full Deploy.
A full deploy is needed when deploying graphics pages for the first time into a new EasyIO FG
controller.
The CPT will transfer all necessary files into the micro SD card.
Step 3
Put in the username and password as follow.
Username
Password
: webuser
: 123456
Optionally the password for deploying the Gr pages can be changed to a preset password to avoid
reentry each time of deploying graphics.
The password for deploying graphics is fixed and is not editable or creatable.
Go to CPT Tool drop down menu Tools > Option and select Graphics option.
41
Keyin the default password which is 123456 into the Default password field.
Step 4
The CPT Tools will show the progress bar. Progress bar will close down when deploying graphics is
done.
Any subsequent changes to the current graphics pages, a normal deploy are sufficient.
Step 5
To view the graphics, click on the preview button
and EasyIO FG login page will be visible.
42
43
Step 1
To view the graphics, click on the preview button
and EasyIO FG login page will be visible.
Optionally copy this URL link in to the web browser address bar.
URL link:
http://192.168.10.11/sdcard/cpt/app/signin.php, where 192.168.10.11 represents the EasyIO FG
controller IP address.
Step 2
The web browser will bring you to the login page.
Login with the below credentials to view the graphics.
Username
Password
: admin
: hellocpt
Step 3
Successful login will display the home page you had chosen in the earlier stage.
On the left of the web browser will display all the Gr pages you created in the exercise earlier.
You can navigate between pages by clicking on each hyperlink here.
44
Text Label
45
Legend
Writable Points
Text Label
46
Legend
All Images are read only widgets.
47
Step 5
In the backup pop up window give the backup a name ie; TestLab_Foo.
Replace Foo with your name and hit backup button
48
Step 2
In the Sedona workspace, select 3 objects by holding down the mouse while you drag.
The objects selections are CO2, SetPt and Cmpr
49
Step 4
It will create a single object by merging them together.
Give a name to the custom object created.
Name MUST NOT contain special character such as , * and etc.
Use underscore (_) instead of space.
In the example, the custom object is named CO2_Control.
Optionally a new Category can be created by manually key in the category name in the Category
field.
50
51
Step 2
In the Sedona workspace, select 2 objects by holding down the mouse while you drag.
The objects selections are the Coil and Valve widget.
Step 3
Drag the selected objects to the widget object user_lib side bar and release.
52
Optionally a new Category can be created by manually type in the category name in the Category
field.
Step 4
To reuse the custom object, drag and drop into the workspace.
The properties of each saved object are remain when you drop the custom object in to the
workspace.
Step 3
Double click Bacnet folder to display the workspace.
Drag and drop a BACSvrNetwork object from easyioFGBACSvr library in the Bacnet folder
workspace.
54
55
56
Step 2
The backup will reside in a folder named with the IP address of the connected controller. Select that
folder. Ensure the folder with the IP address is selected.
By default the Sedona backup file will be saved in the file path/directory shown below.
Step 3
Navigate to the file folder via window explorer. Zipped the IP address folder
58
Step 4
Email the zipped package to;
To : Skfoo@easyio.com
Subject : Test Lab
The result of the text lab will be email individually.
59
Good Luck
Thank you for your time
60