EasyIO Sedona Quick Start Manual

EasyIO Quick Start 01 - Sedona
EasyIO Quick Start 01 - Sedona
25th Nov 2013
1
EasyIO Quick Start 01 - Sedona
Document Change Log
25thNov 2013
Document created.
2
EasyIO Quick Start 01 - Sedona
Disclaimer
EasyIO 30P is a product by EasyIO Holdings Pte Ltd
The EasyIO 30P was built on the Sedona Framework ®.
EasyIO FG-32 is a product by EasyIO Holdings Pte Ltd
The EasyIO FG-32 was built on the Sedona Framework ®.
Sedona Framework is a trademark of Tridium, Inc.
CPT Tool is by Online Tools Inc.
3
EasyIO Quick Start 01 - Sedona
Table of Contents
Introduction ....................................................................................................................................................5
Prerequisite.....................................................................................................................................................5
Sedona Programming Tool. ............................................................................................................................6
Sedona Workbench.........................................................................................................................................7
CPT Tool ........................................................................................................................................................11
Troubleshoot.................................................................................................................................................15
Technical Support .........................................................................................................................................16
4
EasyIO Quick Start 01 - Sedona
Introduction
Thank you for purchasing our EasyIO products.
This user guide will get you started to program an EasyIO Sedona controller in no time especially for
“I just received my new EasyIO Controller, but I have not used one before, what do I do next? “
So, whether you are an existing user of Niagara Workbench or not, we will answer these questions in
the next three simple user Guides. The location (and contents) of the Sedona Folder on your PC is of the
utmost importance, we cannot stress this enough.
This User Guide is compatible with EasyIO 30P and also EasyIO FG Series controllers.
Prerequisite
1.
2.
3.
4.
EasyIO Sedona Controller; either an EasyIO 30P or the EasyIO FG Series.
Sedona programming tool; either Sedona Workbench or CPT Tool.
Network Cable or Network Switch
Even though you have installed Sedona Workbench or CPT tool, you might still need the latest
Sedona kits and platform in order to connect to certain version of controller.
5
EasyIO Quick Start 01 - Sedona
Sedona Programming Tool.
You will have 2 choices for Sedona programming tool.
1. Sedona Workbench; be it a standalone Sedona workbench or Sedona Workbench embedded in
Niagara Workbench. Both of these are by Tridium.
2. CPT Tool. CPT Tool is byOnline Tools Inc. CPT Tool is another option for programming Sedona
Controllers.
The importance of these both tools is mainly relying to the Sedona kits and Sedona platform files.
Most of the cases where a new user is struggling are NOT able to connect to a Sedona Controller.
All the cases are due to missing kits or platform files. These files are to be obtain from the Sedona
Controller Vendor.
Sedona Workbench
If you have a Niagara Workbench installed in your PC then this is the easiest way of installing a Sedona
workbench.
For details of Sedona workbench installation please refer to EasyIO Sedona Workbench Installation doc.
The doc can be obtain from EasyIO FTP server as below.
URL : ftp://www.easyio.com
Username : easyioftp
Password : User!1234
Case sensitive. Look under EasyIO Docs.
CPT Tool
Due to Sedona Framework being Open Source, an industry ecosystem is developing where third party
tools are coming available and CPT Tool is one of them
CPT Tool is by Online Tools Inc.
This tool does not require installation as it is an executable program file.
To obtain the CPT program, email [email protected] for the latest copy.
The tool at the moment is still under development stage and is beta testing copy.
A new version will be release every Friday.
When a new release if out, you just need to unzip the package and drop all the files into the existing CPT
Tool folder.
You can merge them and overwrite them.
DO NOT create another folder as it you will tend to get lost later on.
6
EasyIO Quick Start 01 - Sedona
Sedona Workbench
Assuming you have successfully installed the Sedona workbench into the Niagara workbench, you can
now get started to connect to a Sedona controller.
In this user guide, Niagara Ax 3.7.106 is used. Sedona workbench installed is Sedona Bundle 1.2.28.4.
Step 1
To connect to a Sedona controller, go to File>Open>Open Device.
Put in the IP address of the device you are connecting.
Default IP address for EasyIO 30P
IP address
: 192.168.10.10
Subnet Mask
: 255.255.255.0
Default IP address for EasyIO FG Series
IP address
: 192.168.10.11
Subnet Mask
: 255.255.255.0
For both models, username is “admin” and password is “blank” (no password)
7
EasyIO Quick Start 01 - Sedona
Step 2
A successful connection will bring you to here. You should see the Sedona Tools and Apps.
Step 3
Sedona Tools consist of few items, refer to table below.
Sedona Tools
Kit Manager
Functions
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.
This is to backup and restore a Sedona app. It will
only backup app.sax.
This function is to backup and restore a Sedona
backup. A backup using this function consist of
app.sab and also kit.scode.
Application Manager
Backup/Restore Tool
App is the environment for Sedona programming. All logic and programs have to be in here.
Step 4
If you are unable to get to Step 2, most probably you do not have the kits.
For Sedona workbench 1.2.28.4 it shows the error messages or fault cause.
Below is an example of the error in connection. In the example below, it shows that only one kit is
missing in the Sedona folder which is easyioFG.kit with the checksum 5706070d.
If you are not able to see the error messages, please click on the
details. This applies to users with workbench bench 3.5 and 3.6.
8
button to expand the error
EasyIO Quick Start 01 - Sedona
Step 5
All the kits and platform files are in a directory in the Niagara installation which is called “sedona”.
All missing kits and platform files need to be copy and paste in this directory.
All kits and platform files obtained from EasyIO support has to be paste into here.
The kits folder should display as below. Each folder represents a kit in the Sedona Workbench. Each kit
has either one of more revision. That is not an issue.
9
EasyIO Quick Start 01 - Sedona
The kits folder should display as below. Each folder represents a Sedona hardware platform supported in
the Sedona workbench.
Step 6
If you are able to connect then you can start programming the controller.
For further user guide, refer to EasyIO Sedona Getting Started Guide 02.
10
EasyIO Quick Start 01 - Sedona
CPT Tool
As mentioned earlier, the CPT Tool is another option for programming Sedona Controllers.
The program is an executable file .exe.
Below are the steps to be taken in order to start using the CPT Tool as a Sedona Programming Tool.
Step 1
To obtain the file email to [email protected] .The package is a zip file.
You will need to unzip
to a location you prefer.
In this user guide, it is unzipped to D: hard drive.
Step 2
The unzipped package contains files that required for the program to run.
11
EasyIO Quick Start 01 - Sedona
Step 3
Launch the cpt.exe
Step 4
To connect to a Sedona controller, go to File>Open or use the shortcut in the middle of the screen.
Put in the IP address of the device you are connecting.
Default IP address for EasyIO 30P
IP address
: 192.168.10.10
Subnet Mask
: 255.255.255.0
Default IP address for EasyIO FG Series
IP address
: 192.168.10.11
Subnet Mask
: 255.255.255.0
For both models, Sedona login username is “admin” and password is “blank” (no password)
Step 5
A successful connection will bring you to here. You should see as below.
12
EasyIO Quick Start 01 - Sedona
Step 6
If you are unable to get to Step 5, most probably you do not have the kits installed in the CPT tool folder.
Below is an example of the error in connection. In the example below, it shows that only one kit is
missing in the Sedona folder which is easyioFG.kit with the checksum 5706070d.
Step7
All the kits and platform files are in a directory in the CPT installation folder which is called “sedona”.
All missing kits and platform files need to be copy and paste in this directory.
All kits and platform files obtained from EasyIO support has to be paste into here.
13
EasyIO Quick Start 01 - Sedona
The kits folder should display as below. Each folder represents a kit in the CPT Tool Sedona folder. Each
kit has either one of more revision. That is not an issue.
The kits folder should display as below. Each folder represents a Sedona hardware platform supported in
the Sedona workbench.
Step 8
If you are able to connect then you can start programming the controller.
For further user guide, refer to EasyIO Sedona Getting Started Guide 03.
14
EasyIO Quick Start 01 - Sedona
Troubleshoot
Missing kits
If you encounter error of cannot connect to a Sedona controller, most probably is some missing kits. Look
at the error messages carefully and you should be able to identify the missing kit.
To obtain the latest kits and platform files, please email [email protected].
For users that have received a Dropbox invitation, you could find the latest kits and platform files in
there.
I have got the kits, where show I drop it in?
Any kits email to you or you get it from other, you need to drop it into the kits folder.
The kits folder hierarchy is as below.
The folder AdvLib is a particular kit folder. in this folder it only contain the kit with the named “AdvLib”.
In any kit folder, it can contain one or more kit file but it has to be the same kit.
It cannot have different kit in a same folder.
15
EasyIO Quick Start 01 - Sedona
Technical Support
For technical issue, please contact
Email:[email protected]
16