EasyIO FC-20 Programming Guide

EasyIO FC-20 Programming Guide
EasyIO FC-20 Programming Guide v1.1
EasyIO FC-20 Programming Guide
Version 1.1
24th June 2013
EasyIO FC-20 Programming Guide v1.1
Document Change Log
15th May 2013
Document created.
10th July 2013
Added in kits descriptions.
24th July 2013
Final version of FC virtual tool release.
Changes in kits.
EasyIO FC-20 Programming Guide v1.1
Disclaimer
EasyIO FC-20 is a product by EasyIO Holdings Pte Ltd
The EasyIO FC-20 was built on the Sedona Framework ®.
Sedona Framework is a trademark of Tridium, Inc.
EasyIO FC-20 Programming Guide v1.1
Contents
Introduction ............................................................................................................................................ 5
Prerequisite ............................................................................................................................................. 6
VirtualDeviceFC20 ................................................................................................................................... 8
Create a project file............................................................................................................................. 9
Programming EasyIO FC-20 device ....................................................................................................... 12
FC Sedona Kits ....................................................................................................................................... 16
1.
easyioFC20 ................................................................................................................................ 16
2.
easyioFC20Control .................................................................................................................... 18
3.
easyioFC20HVAC ....................................................................................................................... 18
4.
easyioFC20Regs......................................................................................................................... 18
5.
easyioFC20TempTable .............................................................................................................. 19
Temperature table ................................................................................................................................ 20
Technical Support ................................................................................................................................. 22
EasyIO FC-20 Programming Guide v1.1
Introduction
EasyIO FC-20 series controller is a competitive controller. It can serves as a dumb IO module or it can
be program with limited standalone logic.
It is not a Sedona controller but it can be program via a Sedona workbench. The virtual device will
create a virtual Sedona running in the windows environment to replicate the Sedona VM.
No new software tool to learn.
No new programming concept to learn.
Reuse the Sedona workbench knowledge.
Same programming concept as EasyIO FG series.
Limited resources up to 150 objects or 5MB memory which ever come first.
The virtual device can then be connected to a hardware and download the program into the
controller.
The controller will have the program in the flash memory until it is been overwrite by another
program.
EasyIO FC-20 Programming Guide v1.1
Prerequisite
It is good to go through the EasyIO FC-20 – Firmware Flashing User Guide before proceed with this
user guide.
Below are files needed to be copied into the host PC.
Apart from the below files a USB to RS-485 converter is needed in order to proceed for program
downloading.
Any equivalent USB to RS-485 converter can be use.
No
1.
2.
Item
VirtualDeviceFC20
easyioFC Niagara module
3.
4.
Sedona kits for FC-20
Sedona platform files for FC-20
Description
This is the controller Emulator.
This module is for FC controller temp table
settings.
Sedona kits. These kits are fixed
Sedona platform files.
VirtualDeviceFC20
This is a program to emulate the FC device in the windows environment.
**Remarks
All the files above have to be in a same root folder.
easyioFC.jar
Java module for Niagara workbench to be able to view the temp table UI. It has to be drop into the
Niagara installation modules folders.
Different Sedona version needs different jar file.
Rename the jar files provided to easyioFC.jar or else it will not work.
easyioFC_1.1.jar
easyioFC_1.2.jar
Sedona 1.1 package
Sedona 1.2 package
EasyIO FC-20 Programming Guide v1.1
easyioFC Sedona kits
these are the kits that need to be in the Sedona kits folder. Copy these files and paste it into the
Sedona/kits folder.
easyioFC Sedona platform files
these sedona platform files that need to be in the Sedona platform folder. Copy these files and paste
it into the Sedona/platform/db/ folder.
EasyIO FC-20 Programming Guide v1.1
VirtualDeviceFC20
The virtual device UI is as below.
The virtual device is able to show the firmware version, serial number and also register version if an
EasyIO FC-20 device is connected. If the virtual device is not connected to any hardware, it will as
below.
The port drop down menu
that is use to connect to the EasyIO FC-20 device.
is for use to set the serial comm. settings
In this case, the settings are as below.
Serial Port
Serial settings
Serial port use selection
EasyIO FC-20 hardware pre-define settings.
This settings are done using the FC
FwTool.exe.
Device ID
EasyIO FC-20 devices ID to be connect. This is
set via the EasyIO FC-20 DIP switch.
.
EasyIO FC-20 Programming Guide v1.1
When connect button is press, the virtual device will obtain the hardware information from the
device.
Create a project file
Step 1
The virtual device is capable of creating and saving an apps for future use. To do this, go to drop
menu File and hit Project > New.
Step 2
Put in a project name and select the Project type as FC-20 HVAC then hit OK.
EasyIO FC-20 Programming Guide v1.1
Step 3
The virtual machine UI will looks as below.
Debugging messages window
FC-20 Hardware emulator
The virtual device Digital Output indicator.
The Box will turn Yellow when the DO is ON state and Green when OFF state.
EasyIO FC-20 Programming Guide v1.1
The virtual device Analog Output indicator.
The Analog box will show the output value of what is been commanded in the apps.
The virtual device Universal Input as Digital Input Status.
Toggle switch to activate the Digital Input.
When DI is toggle, the Universal Input will show value 51.00 when true and value 44.00 when value
is false.
Virtual Device Universal Input Indicator/Simulator
Enter a value in here and it will show in the Sedona workbench.
EasyIO FC-20 Programming Guide v1.1
Programming EasyIO FC-20 device
Step 1
Connect a USB to Rs-485 converter to the PC.
Step 2
Launch the Virtual Device FC-20.exe. Some anti-virus might block it to run.
Step 3
Configure the COM port settings use. To check the COM port please go to My Computer >
Properties > Device Manager (Windows 7).
Step 4
In order to program the EasyIO FC-20, the protocol has to set to Modbus. DIP switch 1 = Off.
Step 5
To test the connection between the Virtual Device and also the EasyIO FC-20 hardware, hit connect
at the virtual device program.
A successful connection will show the EasyIO FC-20 hardware details.
Step 6
Make sure the virtual device program is running in the PC or the host. The virtual device can be
running in a remote host. It is not necessary to run in the local host.
Step 7
Using the Sedona workbench or CPT tool, connect to the EasyIO FC-20 device via open Sedona
(Sedona workbench), open device (CPT tool).
EasyIO FC-20 Programming Guide v1.1
In this case, the virtual device is running in a local host.
Step 8
You will see the Sedona programming environment. Remember EasyIO FG-20 is not a Sedona
controller; it is just using the Sedona workbench or CPT tool to program it.
All objects/programming can only be done in the “FC20” folder. Dropping components/objects in to
other folder might cause issues later.
EasyIO FC-20 Programming Guide v1.1
Step 9
The program right now will reflect the virtual device. The virtual device will run as it is an EasyIO FG20. The virtual device is running real time. It will show real time values when engineering via Sedona
workbench or CPT tool.
Step 10
Once programming is done, the program can then be downloaded to the EasyIO FC-20 hardware via
the virtual device.
Just hit
and the program will be downloaded into the hardware.
The program will run right after the download process is done.
The project will also download the temp table set via the workbench or CPT tool.
Every download will overwrite the program in the EasyIO FC-20.
Step 11
The program done in workbench or CPT tool can be backup as it is a project created as mention is
the previous chapter. To save the project just go to File > Save (Save As).
The saved file extension is “.vd”.
EasyIO FC-20 Programming Guide v1.1
To reuse the backup, just open the project via Virtual Device and then connect Sedona via
workbench or CPT tool to modify.
When done, the apps can then be downloaded to the EasyIO FC-20 device.
EasyIO FC-20 Programming Guide v1.1
FC Sedona Kits
Each EasyIO FC controller comes with a set of predefine kits. These kits are not manageable.
No additional kits are allowed to install.
There are total of 5 kits are available to use. The 5 kits are as below.
Kits Name
easyioFC20
easyioFC20Control
easyioFC20Regs
easyioFC20HVAC
easyioFC20TempTable
Description
I/O objects for EasyIO FC-20
Control objects
Register Objects to export either Bacnet or Modbus points
HVAC objects such as PID loop, drive
TempTable Object to configure temp table
In order to engineer the EasyIO FC-20 controller, user will also need the below kits. Kits below need
to be at least 1.0.48.
Kits Name
Inet.kit
Sox.kit
Sys.kit
Minimum version
1.0.48
1.0.48
1.0.48
1. easyioFC20
This kit contains all I/Os objects. These objects can only be use one time.
Any duplication of the object will be discard.
4 Analog Output (AO) objects. Each represent respective channel.
12 Digital Input (DI) objects. Each represent respective channel.
**Note:f DI1 is use, then UI1 is no longer use as an analog input.
EasyIO FC-20 Programming Guide v1.1
4 Digital Output (DO) objects. Each represent respective channel.
12 Universal Input objects. Each represent respective channel.
**Note: if UI1 is use, then DI1 is no longer use as a digital input.
EasyIO FC-20 Programming Guide v1.1
2. easyioFC20Control
This kit contains all the control objects. The control objects are from Sedona control kit.
All source code are available from Sedona.
3. easyioFC20HVAC
This kit contains all the control objects for HVAC applications. The control objects are from
Sedona control kit.
All source codes are available from Sedona.
4. easyioFC20Regs
This kit contains register objects. Each type comes with max 16 register addresses.
Type
Register Type
Total Number of Register
Bool
Boolean Read Only
16
BoolWr
Boolean Writable
16
Float
Float Read Only
16 (combine/share with Long)
FloatWr
Float Writable
16 (combine/share with LongWr)
Long
Long Read Only
16 (combine/share with Float)
LongWr
Long Writable
16 (combine/share with FloatWr)
Short
Integer Read Only
16
ShortWr
Integer Writable
16
These register address will represents in Modbus or Bacnet automatically base on address and
name created. See example below. The register Bool with address 2000 for Modbus and BACnet.
As for BACnet, when doing points discovery, the name of the object will appear.
EasyIO FC-20 Programming Guide v1.1
Modbus Register
Address: 2000
Data Type : Discrete Input
Address Base : Zero Base
BACnet Object
Object ID : BV 21
Data Type : Binary Value
5. easyioFC20TempTable
This kit contains an object for configuring the temp table for the FC device. See next chapter for
details.
EasyIO FC-20 Programming Guide v1.1
Temperature table
EasyIO FC-20 comes with 16 temperature table.
These temperature table settings only available in Sedona workbench at the moment. It cannot be
done in CPT tool.
8 temperature tables are user defines and 8 temperature tables are read only.
Below are the 16 tables that by default come with the controller.
Table number
Table 01
Table 02
Table 03
Table 04
Table 05
Table 06
Table 07
Table 08
Table 09
Table 10
Table 11
Table 12
Table 13
Table 14
Table 15
Table 16
Sensor Type
NTC 10K Type 2
NTC 10K Type 2 Shunt 11K
NTC 10K Type 3
NTC 10K Type 3 Shunt 11K
NTC 3K
NTC 20K
RTD 1K Platinum
RTD 1K Balco
NTC 10K Type 2
NTC 10K Type 2 Shunt 11K
NTC 10K Type 3
NTC 10K Type 3 Shunt 11K
NTC 3K
NTC 20K
RTD 1K Platinum
RTD 1K Balco
Remarks
Editable
Editable
Editable
Editable
Editable
Editable
Editable
Editable
Read-only
Read-only
Read-only
Read-only
Read-only
Read-only
Read-only
Read-only
How to configure Temp Table
Step 1
Drop the TempTable object from the easyioFCTempTable into the FC20 folder.
*Make sure to drop the object in to the FC20 folder and not the service folder
EasyIO FC-20 Programming Guide v1.1
Step 2
Double click on the object to bring up the temperature user interface.
I
Only Table 1 to Table 8 is editable.
Table 9 to Table 16 is pre-define.
Default
Delete
Applicable to Table 1 to Table 8.
It will restore the default value according to the type stated above.
To add a row. Max of 30 rows.
If 30 rows are in the table, this button will be disable.
To delete a row
Edit
Save
To edit the row value.
Save the changes made to the flash memory
Add
EasyIO FC-20 Programming Guide v1.1
Technical Support
For technical issue, please contact
Email: support@easyio.com
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising