Apps Tool v2.

Apps Tool
Offline Controller Simulator for
FG+, FS and FW series

1
Apps Tool v2.0

Document Change Log

30thSept 2013
Document created.

06thDec 2013
Grammar correction and minor changes.

06th Oct 2015

Updates for SVM.
Included Prerequisite

th
17 Dec 2018
Rename the document from Emulator to Apps Tools.
Remove Niagara Workbench Sedona files installation as N4 no longer supports Sedona framework.
Updated disclaimer and support channel emails addresses
Updated Apps Tool offline profiles – supporting FS and FW.

2
Apps Tool v2.0

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

Worldwide and Asia Pacific Support : [email protected]

Americas Support : [email protected]
Europe Support : [email protected]

3
Apps Tool v2.0

Federal Communication Commission Interference Statement

This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant
to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may cause harmful interference
to radio communications. However, there is no guarantee that interference will not occur in a particular
installation. If this equipment does cause harmful interference to radio or television reception, which can
be determined by turning the equipment off and on, the user is encouraged to try to correct the
interference by one or more of the following measures:
• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
• Consult the dealer or an experienced radio/TV technician for help.
Caution: Any changes or modifications not expressly approved by the party responsible for compliance
could void the user's authority to operate this equipment.

FCC Caution
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
(1) This device may not cause harmful interference, and (2) this device must accept any interference
received, including interference that may cause undesired operation.

FCC Radiation Exposure Statement

This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment.
This equipment should be installed and operated with minimum distance 20cm between the radiator &
your body.
RF Exposure: A distance of 20 cm shall be maintained between the antenna and users, and the
transmitter module may not be co-located with any other transmitter or antenna.

4
Apps Tool v2.0

Table of Contents
Introduction ....................................................................................................................................................6
Prerequisites ...................................................................................................................................................6
Compatibility ...................................................................................................................................................6
Create a new virtual Sedona Application........................................................................................................7
Notes .............................................................................................................................................................10
Technical Support .........................................................................................................................................10

5
Apps Tool v2.0

Introduction
One issue customers noted about programming Sedona Controllers was the in ability of controllers to be
programmed “offline”. Pre-programming of Sedona devices required that a customer connect to a real
controller, “offline programming” was not possible.

Understanding customer requirements for efficiency improvements, EasyIO have created a very useful
and time effective program called the “Apps Tool”, (previously known as The Sedona Manager).

This tool has been created for EasyIO users to enable creation, editing and testing of FG Series
applications offline, using a Windows based, Sedona Virtual Machine (SVM) environment on your PC.

When running, the “Apps Tool” emulates the EasyIO FG Series controller in an SVM environment on your
computer, thus eliminating the need for FG Series hardware connections for Sedona application
development.
This tool supports newer hardware as well such as FS Series and FW Series.

Using the Apps Tool means that development of Sedona applications can now be achieved anywhere
and at anytime in an “offline” environment.

Prerequisites
1. CPT Tool dated 10th Oct 2018 or later. Latest CPT at the time of the document is 17th Dec 2018.
2. Apps Tool v1.15 preferable with latest SVM. Latest SVM at the time of document
Latest template at the time of document is as below.

FG Series : V1.0b50a
FG+ Series : V2.0b50a
FS Series : V3.0b50
FW Series : V1.0b12d

3. A Computer running Windows Operating System.

4. Microsoft .Net Framework. Minimum Version 3.0 – usually preinstalled by Microsoft in Win7 and
Win10.

Compatibility
The Apps Tool is compatible and work perfectly with the CPT Tool
Legacy Sedona Workbench such as Niagara Workbench AX 3.5, Niagara Workbench AX 3.6, Niagara
Workbench AX 3.7 is also supported.
Newer Niagara Workbench N4 is not supported.
Please use CPT Tools from EasyIO.

The Apps Tool will compatible with Windows OS 32bit and Windows OS 64bit environments.

**Note**
This tool only supports the EasyIO FG, FS and FW series. It does not support the older EasyIO 30P or the
EasyIO FC series (FC has a separate simulator tool for offline programming).

EasyIO 30P DO NOT have any simulator program.

EasyIO FC series simulator program is called FC Virtual Device.
6
Apps Tool v2.0

Create a new virtual Sedona Application

Step 1

Make you always have the latest version of the Apps Tool installed.
Latest Apps tool comes with latest templates.
At time of document the latest Apps Tool version is Apps Tool 1.16. Information regarding the latest
version of Apps Tool is available from respective support channel.

Step 2
Copy the entire folder provided by EasyIO support.
The files within the folder cannot be removed from the folder or placed in another location.

Step 3
Launch via double clicking the Apps Tool.exe icon.
or Windows 7 ensure you run the application using “administrator” privilege levels as shown below.

7
Apps Tool v2.0

Step 4
The default Sedona folder for Apps Tool is reference to its local Sedona folder.

If a custom Sedona folder is prefer manually reference the Sedona folder to the preferred location.

Step 5
Click the “Create” button to create a new app.

Step 6
A “New Sedona Application” pop up window will appear after the create button has been clicked. In the
“Application Name” box, type a name of your choice for the newly created app.
In the “SVM Version” drop down menu, choose the easyioFG_V1.5b50a for FG Series
(just an example, make sure template selected according to respective hardware intended to run the
application)
(This file version may differ depending on the latest update of the Apps Tool, always select the latest
SVM version. )

Refer to the image below as an example.

In the example below the Apps Tool will create an app for FG series controller with the latest available
kits pre-defined automatically in the file.
If required Sedona Kits in the app can be updated at a later stage in CPT Tools.

8
Apps Tool v2.0

Step 8
Once the App has been successfully created, select the App from the drop down list. In the example
below, the “Application Options” drop down list shows the “FG_virtual_test_apps” which is the name of
the App created in the previous steps. Make sure your newly created App is selected.

Run the Sedona App by clicking the “start” button.

Step 9
The App debug messages are displayed in the debug window or Application Console as shown below.
Messages regarding the status of running apps are shown in the console as indicated below.

After starting the App via the start button a message reading “MESSAGE [sys::App] running” displays,
indicating that the App has successfully started and is running in the SVM environment.

Step 10
To connect to the Sedona App running in the SVM environment using either the Niagara Workbench or
CPT Tools enter the following connection details into the appropriate areas required for the tool being
used.
9
Apps Tool v2.0

Host IP : localhost (as the App is in running in the SVM environment on the PC)
Username : admin
Password : <no password> or blank

Notes
Once the Sedona App has been successfully created and started, the Sedona App will be actually running
in the Windows environment, and emulating the EasyIO FG series controller.
All the Sedona functions are operational.

Kits can be manage/installed as required.

It is not possible for the Apps Tool to create the necessary connections to the PC COM port to emulate
the COM2 port on an FG Series controller. Therefore it is not possible to connect Modbus slave devices
to the PC for testing during emulation. Full configuration of the Modbus devices is possible during
emulation.

Technical Support

For technical issue, please contact respective region support channel.

Worldwide and Asia Pacific Support : [email protected]

Americas Support : [email protected]
Europe Support : [email protected]

10