EasyIO Sedona User manual

EasyIO Quick Start 02 –Sedona Workbench
1
EasyIO Quick Start 02–Sedona Workbench
27th Nov 2013

EasyIO Quick Start 02 –Sedona Workbench
2
Document Change Log
25th Nov 2013
Document created.
27th Nov 2013
Grammar Checked.

EasyIO Quick Start 02 –Sedona Workbench
3
Disclaimer
EasyIO 30P is a product by EasyIO Holdings Pte Ltd
The EasyIO 30P was built on the Sedona Framework ®.
EasyIO FG-32 is a product by EasyIO Holdings Pte Ltd
The EasyIO FG-32 was built on the Sedona Framework ®.
Sedona Framework is a trademark of Tridium, Inc.

EasyIO Quick Start 02 –Sedona Workbench
4
Table of Contents
Introduction ....................................................................................................................................................5
Sedona Workbench Overview ........................................................................................................................6
Sedona Tools...................................................................................................................................................8
Kits Manager...............................................................................................................................................8
Application Manager ................................................................................................................................11
Backup/Restore Tool ................................................................................................................................12
Sedona Apps .................................................................................................................................................15
Technical Support .........................................................................................................................................19

EasyIO Quick Start 02 –Sedona Workbench
5
Introduction
Thank you for purchasing EasyIO products.
This user guide will help in getting you programming an EasyIO Sedona controller in no time.
This User Guide is compatible with both the EasyIO 30P and the EasyIO FG Series controllers.
In this user guide Tridium Niagara Workbench 3.7.106 and Sedona Workbench version is 1.2.28.4 used.

EasyIO Quick Start 02 –Sedona Workbench
6
Sedona Workbench Overview
A Sedona Controller consists of two parts. See image below.
If you are not able to see this view, please refer to EasyIO Quick Start 01 to connect to the Sedona
Controller.
Sedona Tools is where you manage Sedona kits in a controller, getting backup and doing
apps restore. The Sedona Tools consists of 3 options as below.
Sedona Tools
Functions
Kit Manager
This is to manage kits. In other words installed kits.
Kits are library in Sedona.
If a particular kit is not installed, that kit is not
usable in the Sedona controller.
Application Manager
This is to backup and restore a Sedona app. It will
only backup app.sax.
Backup/Restore Tool
This function is to backup and restore a Sedona
backup. A backup using this function consist of
app.sab and also kit.scode.
App is the workspace for constructing Sedona control programs. All logic and programs are done
in here.
From the workbench navigation panel, you should see as below.
By default the application tree is populated with 2 default folders; a ‘Service’ folder and an ‘EasyIO’
folder.
The service folder is where all the services objects are placed. We DO recommend placing all the services
objects in this folder.
The EasyIO folder is for program logics and application objects.
You can add multiple folders to the app tree to assist in organizing your programs and
applications.
Tip! Good “housekeeping” for your Apps will make life easier when debugging, fault finding and servicing
your Apps. We DO recommend dropping all service objects in to the “service” folder.

EasyIO Quick Start 02 –Sedona Workbench
7
All other control logic should be dropped in the “EasyIO” folder or any other newly created folder(s) that
identify the application or process involved.
An example below shows multiple folders in the App folder.

EasyIO Quick Start 02 –Sedona Workbench
8
Sedona Tools
As mention in above, Sedona Tools consist of 3 options.
Kits Manager
Kit manager in Sedona workbench is used to Sedona manage kits in a Sedona Controller.
Kits that are installed in to a Sedona controller can be view in the Sedona Palette.
Only objects from the kits that are installed is useable.
Below are the steps to install kits.
Step 1
Connect to Sedona Controller.
Double click the Kit Manager icon in the Sedona Tools option. Kits Manager View
will be display as indicated below.

EasyIO Quick Start 02 –Sedona Workbench
9
Step 2
To install a required kit, check the square selection box beside the kit name.
To uninstall a kit, uncheck the selection box beside the kit name.
**Note **
DO NOT attempt to install non EasyIO kits that are not Sedona Framework version 1.0.45. Only Non Easy
IO kits that are Sedona Framework 1.0.45 should be installed. Non EasyIO kits do not use the word
“easyio” as a kit name prefix. Examples of non EasyIO kits are sys, sox, control, inet, dateTime and
dateTimeStd. These kits do not carry the “easyio” prefix. Ensure that if such kits are installed that they are
revision 1.0.45 kits ONLY.
Kits that carry a prefix with another vendors’ name are owned by that particular vendor. Please refer to
that vendor for any technical support issues regarding the kit.
EasyIO Sedona Products ONLY support Sedona Framework 1.0.45. This is not a system drawback; if kits
other than version 1.0.45 are offered for use in the EasyIO controller please ignore them.
Step 3
Some kits are hardware dependent, and therefore some selections may be either grayed out or indicated
as “not supported”. This is not an error. This occurs when the hardware platform does not support the
application kits.
Step 4
If the kit to be installed has a dependency of other kits, and these kits are not installed,
manually check the square at next to the dependent kit and you will be able to install the require kit.

EasyIO Quick Start 02 –Sedona Workbench
10
Image above is showing an error where the kit easyioNTP needs another kit which is easyioFGMail in
order for it to install correctly.
Install the easyioFGMail kit and the error will get resolved.
Step 5
If you are satisfied with the kits selected for installation, click Next and Finish
at the bottom of the window.
The Sedona workbench will begin to install the selected kits into the controller.
The Sedona Workbench prompt for a Sedona VM for a restart. Hit restart to
restart the Sedona VM.
Step 6
On completion of the Device Restart, the controller will automatically reboot and disconnect. You will
need to manually reconnect to the controller again.

EasyIO Quick Start 02 –Sedona Workbench
11
Application Manager
The Sedona Workbench provides an Application manager for getting and putting in a Sedona application
from and to a Sedona controller.
During backup process, it will only get the app.sax. It will not backup the kit.scode.
App.sax is a Sedona application where is house the entire program in it.
Kit.scode is kits information.
To get or put an app follow below instructions.
Step 1
Connect to Sedona Controller.
Double click at the application manager icon . The application Manager View will
display as below.
Step 2
Select “Get” and you will be prompt for further information at the bottom.
Give the application a name. The extension has to be “.sax”. In the example below, it is named “app-
EasyIOFG.sax”.
You can replace this with a name of your choice as the filename. The “.sab” extension must remain.
The Sedona app file will be saved in the file path/directory shown below. The path/directory is in the
niagara workbench Sedona folder.
The checkbox of “Save kit checksum in sax file” will save the kits used checksum into the app.sax.
Step 3
Click on the Next button to proceed. Then click on Finish to confirm.
The Sedona application xxx.sax is now saved in the selected path/directory.
To restore an app, see next step.
Step 4
To restore a save app, select the “Put” option in the Application Manager .
Step 5
Option as below will show if “Put” is selected.

EasyIO Quick Start 02 –Sedona Workbench
12
You can now select an app to restore to the controller.
You will be asked to install kits that are required for the app. The CPT Tool will automatically select the
required kits based on the application contents.
Step 6
If the required app is not visible, locate the app using the browse directory option or you can copy from
another directory in to this directory.
OR
Step 7
Click on the Next button to proceed. Manually install the kits required and then click on
Finish to confirm.
Step 8
The Sedona Workbench will begin the upload process and on completion will prompt to restart the
controllers’ Sedona VM (Virtual Machine), a manual reconnection is required.
.
Backup/Restore Tool
Unlike the “Get” and “Put” functions the “Backup” and “Restore” functions provide for storage and
restoration of both the app.sab and the kit.scode files to/from a Sedona Controller. This provides a full
controller back up.

EasyIO Quick Start 02 –Sedona Workbench
13
The “Get” and “Put” functions provide storage and restoration files of the app.sab files only. Kits will
need to be reinstalled manually as required.
.
The extension has to be .zip and no other extension is allowed.
To Backup or Restore a Sedona app follow below instructions.
Step 1
Connect to Sedona Controller.
Double click at the Backup/Restore Tool .
Step 2
Choose the backup option and give the backup a name for the backup.
Remember the extension has to be .zip.
By default the Sedona app file will be saved in the file path/directory shown below.
The default backup directory Is not changeable.
Step 3
Click on the Next button to proceed. Then click on Finish to confirm.
The backup is now saved in the default directory as mention above.
To restore a backup, follow next step.
Step 4
To restore a backup, use the restore option.
A list of backups will show at the bottom.
Step 5
Select the backup and click on the Next button to proceed then click on Finish
to confirm.
The restore option will bypass the kits installation as the backup contain all the kits information needed in
the apps. It will automatically install the required kits for the application into the controller.

EasyIO Quick Start 02 –Sedona Workbench
14
The Sedona Workbench will begin the upload process and on completion will prompt to restart the
controllers’ Sedona VM (Virtual Machine).
You will need to manually reconnect to the controller again.

EasyIO Quick Start 02 –Sedona Workbench
15
Sedona Apps
Assuming you understand all the Sedona Tools options functions and usage, the next guide will be a basic
simple guide to construct/program a Sedona controller.
Refer below for further steps. In this section of the user guide an EasyIO FG series controller is used in all
the examples.
Step 1
Connect to Sedona Controller.
Go to the Apps folder. In the Apps folder, it contains 2 sub folders namely “service” and “EasyIO”.
As mention, we DO recommend to drop all service objects in to the “service” folder and the rest of the
logics and stuff into the “EasyIO” folder or other newly created folder.
You can have as much folder as you need.
Step 2
To configure a Sedona controller, workbench needs the “Sedona Palette”.
To open this palette, go to the icon at the top tool bar and choose Sedona Palette.
Step 3
The Sedona palette will be visible at the left side bar in the workbench.
If the Sedona palette shows “unavailable” it means that you are not viewing at any Sedona Apps
programming environment. You will need to be in the Apps or any child component of Apps to be
able to view the Sedona palette.
Step 4
In the following example, we are going to build a simple piece of logic that compares 2 Numerical Values.
If one Numerical value is greater than the other Numerical value, it will provide a Boolean ‘True’ output.
Open the EasyIO Folder by double clicking on the Navigation tree. The Sedona wire sheet will be
displayed.
The wire sheet is where control objects from the kits are placed and connected to produce your App. In
following steps we will drop some objects into the wire sheet ready for connection.
At the Sedona Palette side bar, open Control kit.

EasyIO Quick Start 02 –Sedona Workbench
16
Locate the Ramp object select it with a single click and holding down the mouse button, ‘Drag’ the Ramp
object into the workspace. When it is placed in the desired location release the mouse button and ‘Drop’
the object in place.
Step 5
In the same control kit, locate the object named “Cmpr” object. Select the object via a single held mouse
click then Drag and Drop it in to the workspace with the Ramp object.
Additionally from the kit locate and select the “WriteFloat” object dragging and dropping it into the
Workspace with the other objects.
Step 6
The Workspace should now contain 3 objects as shown in the example below.
To create link/links between objects in the same wire sheet, simply move the mouse pointer over the
value slot you require.
An arrow pointing right 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.
In this example we will drag the Ramp ‘output’ slot from the output side of the control object to the ‘x’
input, on the input side of the Cmpr object. Starting from the Ramp object, click and hold on the output
side of the object selecting the Ramp output slot. Next drag the connection to the Cmpr object, locate
the slot marked ‘x’ and drag the connection over this slot.
Drag and Drop the
object into the wire
sheet.

EasyIO Quick Start 02 –Sedona Workbench
17
Once you are at the Cmpr destination slot ‘x’, release the mouse and the link will be made.
Connect the WriteFl object to the CMPR ‘y’ input in the same manner.
Step 7
Next, locate and expand the easyioFG in the Sedona Palette sidebar.
Locate, Drag and Drop a DO object from the easyioFG Library into the Workspace.
Using the method described in Step 6, link the output “Xgy” slot of “Cmpr” object to the “DO” input via
creating a link at the “Xgy” output slot and dragging the connection wire to “in” slot on the input side of
the “DO” object as shown below.
Step 8
The completed logic example should look like this;

EasyIO Quick Start 02 –Sedona Workbench
18
Step 9
Double click on the DO object to display the properties at the properties. In the properties view choose
the DO ‘channel’ required. The channel identifier relates to the physical digital output on the controller.
In this example, DO1 as the channel required.
Step 10
You should now notice that DO1 will start to toggle states (change from off state to on state) when the
logic condition is fulfilled (x is greater than zero).
Step 11
At this point in the programming process, your Sedona app programmed in the controller is not saved to
the flash memory. It is resident in the controller and running in the controller RAM.
To write the program to flash memory, a forced save or manual save of the application is required. If a
program save is not completed, any power cycle of the controller will lose all the programmed
applications as presently they have not been written to Flash memory only RAM.
In order to save the Sedona App, right click the App object and select ‘Actions’ and choose ‘save’.
Step 12
The Actions menu displays some other options. See the table below for a description of these selections
and the result of selecting these actions.
Tip! Please note that if the controller is power cycled or rebooted before a save is applied all work
programmed after the last controller save (if any) will be lost. A regular Action, save selection during the
programming process is advised to prevent inadvertent loss of work.
Action Functions
Description
Save
It saves the Sedona application into the flash memory.
Hibernate
EasyIO Sedona Controllers does not support this function
Quit
To disconnect from the Sedona Controller
Restart
It will restart the Sedona VM
Reboot
It will reboot the hardware including the Sedona VM

EasyIO Quick Start 02 –Sedona Workbench
19
Technical Support
For technical issue, please contact
Email:[e-mail]