Apps Tool v2.0

1

Apps Tool Offline Controller Simulator for

FS and FW series

Apps Tool v2.0

2

Document Change Log

30thSept 2013 Document created. 06thDec 2013 Grammar correction and minor changes.

06th Oct 2015 Updates for SVM. Included Prerequisite

17

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

Apps Tool v2.0

3

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 © 2019 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 : support@easyio.com Americas Support : support@easyio.pro Europe Support : support@easyio.eu

Apps Tool v2.0

4

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.

Apps Tool v2.0

5

Table of Contents Introduction .................................................................................................................................................... 6

Prerequisites ................................................................................................................................................... 6

Compatibility ................................................................................................................................................... 6

Create a new virtual Sedona Application ........................................................................................................ 7

Notes ............................................................................................................................................................. 10

Technical Support ......................................................................................................................................... 10

Apps Tool v2.0

6

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.16 preferable with latest SVM. Latest SVM at the time of document

Latest template at the time of document is as below. FS Series : V3.0b51b FW Series : V1.0b14d

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

Apps Tool v2.0

7

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.

Apps Tool v2.0

8

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.

Apps Tool v2.0

9

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.

Apps Tool v2.0

10

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 F 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 : support@easyio.com Americas Support : support@easyio.pro Europe Support : support@easyio.eu