(8.15)--SDC-AN018-CPTtoolsUserGuide建筑电气与智能化专业实训.pdf
Ap Sedopplicaona Raation SyxTopTel:www ange Note xthSense Ltd.3 Topsham.Exeter.De 0844 840 3100 Cont CPTopsham Units.Daevon.EX3 0QH.U Fax:0844 840 3m rollersT Tooart Business Park.United Kingdom.3200 s ol Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 2 Copyright Notice This document has been prepared by SyxthSense Limited using(i)its own proprietary information and(ii)proprietary information owned and controlled by other third parties(for which SyxthSense Limited has a right to use).The contents are copyrighted and must not be communicated in whole or in part to any other party without the prior written approval of SyxthSense Limited.The following notice applies to this document and shall be reproduced on any permitted copies:2014 SyxthSense Limited.All rights reserved.Any request for further information concerning this document should be addressed to:SyxthSense Limited 3 Topsham Units Dart Business Park Topsham Exeter EX3 0QH United Kingdom Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 3 CONTENTS 1INTRODUCTION.42CPT TOOL OVERVIEW.43KIT MANAGEMENT.114BACKUP AND RESTORE.141.DOWNLOAD AND UPLOAD.152.BACKUP AND RESTORE.175CONSTRUCTING SEDONA CONTROL PROGRAMS.206CONSTRUCTING GRAPHICS PAGES FOR WEB BROWSER.257BACKUP AND RESTORE VIA WEB.388DISCLAIMER.409DOCUMENT CONTROL.40 Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 4 1 Introduction This user guide will help you to program any SyxthSense Sedona controller in a fast and efficient manner.This User Guide is compatible with both the SDC-30G and the SDC-xG Graphics Series controllers.Only the SDC-xG Graphics series will utilize or deploy any of the Web Browser Graphics functions.This user guide covers the programming and Graphics in an SDC-xG Controller utilizing the CPT Tool built by Online Tools Inc.Sedona is an Open Source product and a developing industry ecosystem is beginning to provide third party configuration and management tools for the Sedona environment.The Online Tools Incorporated CPT Tool is one such tool that is presently available.2 CPT Tool Overview A Sedona Controller consists of two parts.See image below.The image used above is from Sedona Workbench and is used as a reference to clarify the topics discussed below.CPT Tool is an executable file and does not require installation.The package is supplied as a zip file.Extracting the zipped file will create the file structure indicated below.All the files need to be located in the same folder in order for CPT to run correctly.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 5 Step 1 To launch the application,just double click the cpt.exe file.Step 2 To connect to a Sedona controller,go to FileOpen or use the shortcut in the middle of the screen.Enter the IP address of the device you are connecting to.Default IP address for SDC-30 controller is IP address :192.168.10.10 Subnet Mask :255.255.255.0 Default IP address for SDC-20G/32G Graphics Series IP address :192.168.10.11 Subnet Mask :255.255.255.0 For all these Sedona controller models,the Sedona login Username is“admin”and Password is left blank(do not enter a password).Step 3 On successful connection to the controller,you will see a controller in the Navigation(Nav)tree on the left of the screen,as shown below.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 6 Step 4 To help describe the CPT Tools environment,the toolbars and shortcut buttons are highlighted in the numbered red frames and explained further below.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 7 Tool Bar(1)This tool bar contains all the shortcuts for the application.Navigation(2)Navigation is possible via the side bar view of a connected Sedona Controller.The Navigation view shows the application content in a folder tree structure.A User can shortcut directly to the Sedona controller Kit Manager via double clicking the easyio-fg topline descriptor at the top of the sidebar menu.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 8 If multiple controllers are connected simultaneously,the navigation window will show multiple IP address tabs.Right clicking the“SDC-20G”station icon displays additional shortcuts and actions.Library(3)The Library side bar displays the Sedona kits installed in the connected Sedona controller.The kits are expandable and collapsible showing the content of the kit.If a required kit is not shown in the view it indicates that the kit is not installed in the Sedona Controller.Refer to next chapter for the kit installation steps.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 9 Workspace(4)The Workspace is the location for developing application programs.The Workspace sheet size is not resizable.There is a view finder in the top right corner of the Workspace sheet.The view finder enables simple object location and worksheet navigation within the workspace.A right click on the Workspace sheet displays a dropdown menu.This menu employs shortcuts to help speed up programming tasks.Objects can be added to the Workspace from this menu.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 10 Properties(5)On the right of the screen is the Properties side bar.This view shows the selected object(s)properties.This view is capable of displaying the properties of multiple objects.Objects properties can be edited directly from the sidebar view.Renaming of objects and/or folders can also be completed in the Properties side bar.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 11 3 Kit Management Kit Management in the CPT Tool is used to manage the Sedona kits in a Sedona Controller.To open the Kit Manager double click the icon or the shortcut icon,shown on the tool bar.The Kit Manager will be displayed as indicated below.The Kit Manager will display all the kits that are installed in the CPT Tool Sedona folder or in the Sedona folder selected.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.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 12 Following is a description of the kit install/uninstall procedures.Step 1 Connect to the Sedona Controller.Once connected access the Kit Management windows via one of following methods;Open the Kit Manager via a the shortcut icon,shown on the tool bar or double-clicking the first menu Navigation menu line.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.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 13 If the kit to be installed has a dependency of other kits,and these kits are not installed,the CPT Tool will automatically prompt the user for installation of the dependent kit.Hit“YES”to accept it.*Note*DO NOT attempt to install non SyxthSense or EasyIO kits that are not Sedona Framework version 1.0.45.Only Non SyxthSense and Easy IO kits that are Sedona Framework 1.0.45 should be installed.Non SyxthSense kits do not use word“sixth”as a kit name prefix and 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“sixth”or“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.SyxthSense 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 SyxthSense Sedona controllers please ignore them.Step 3 If you are satisfied with the kits selected for installation,click Apply.The CPT Tool will begin to install the selected kits into the controller.A progress bar shows the status of the kits installation.Step 4 On completion of the kit installation,the controller will automatically reboot and disconnect.You will need to manually reconnect to the controller again.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 14 4 Backup and Restore The CPT Tools platform provides a feature to backup and restore a Sedona application(app).These functions are available from the Kit Management window.The menu button selections are at the bottom of the page and operate as follows:All backup files are stored in a folder named“files”in the CPT Tool installation directory.The files are stored with a predefined name determined by the IP address of the device.Below is an example of the folder contents for a“Backup”of a Sedona controller with an IP address of 192.168.10.11.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 15 4.1 Download and Upload To avoid confusion please note that the Download action means to retrieve a file from a Sedona device,and the Upload action means to send a file to a Sedona device.To download a Sedona App from a Sedona controller to the PC follow the instructions below.Step 1 Connect to a Sedona controller using the CPT Tool.Click Kit Management shortcut icon on the tool bar to access the Kit Management window.Step 2 Click Download at the bottom of the window.This function performs a get application request from the controller.After clicking this button,another window(shown in Step 3 below)will be displayed.Step 3 Give the backup application a name.By default CPT Tool will assign the App with the date and time the get function was performed as the filename.You can replace this with a name of your choice as the filename.The“.sab”extension must remain unchanged.By default the Sedona app file will be saved in the file path/directory shown below Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 16 Step 4 To upload an app to a Sedona controller from the PC,click Upload App in the Kit Manager window and CPT Tool will prompt for the user for an app selection to upload.Choose the xxx.sab file to upload to the controller(where xxx represents the filename you want to upload from the location where your files is stored)and click“Open”.Step 5 The CPT Tool will prompt you to install kits that are required for the app.The CPT Tool will automatically select the required kits based on the application contents.Hit“Apply”to proceed.Step 6 The CPT Tool will begin the upload process and on completion will restart the controllers Sedona VM(Virtual Machine),reconnection to the device will be required.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 17 4.2 Backup and Restore Unlike the“Upload”and“Download”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.The“Upload”and“Download”functions provide storage and restoration files of the app.sab files only.The kits files will need to be reinstalled manually as required by the App.During the“Restore”process,the user will not be prompted for kits management by the CPT Tool.Kit Management is provided automatically along with the app Restore.To Backup and Restore a Sedona app from a Sedona controller follow the instructions below.Step 1 Connect to the Sedona controller via CPT Tool.Click Kit Management shortcut icon on the tool bar to access the Kit Management window.Step 2 Click Backup at the bottom of the window.This function performs a backup request from the controller for both the app.sab and the kit.scode.After clicking this button,another window(shown in Step 3 below)will be displayed.Step 3 The backup will reside in a folder named with the IP address of the connected controller.Select that folder.You can also create new windows folders with different names.By default the Sedona backup file will be saved in the file path/directory shown below i.e.in the folder named as IP address of the controller in the/files/sub-folder of the CPT tool.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 18 Step 4 To“Restore”a backup to a Sedona controller from the PC,click Restore in the Kit Manager window and CPT Tool will prompt for the user for the backup selection to restore.Choose the folder file to restore to the controller and click“Select Folder”.Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 19 Step 5 The CPT Tool will start to install the apps and kits.The progress of the restoring process will be shown as below image Online Store: Copyright 2014 SyxthSense Ltd.-Ver 0.2 Enquiries:T:0844 840 3100 F:0844 840 3200 SDC-AN18 CPT Tool User Guide 20 5 Constructing Sedona Control Programs To build your Sedona programming application in the Sedona Controller,you will begin in the application tree.Step 1 By default the application tree is populated with 2 default folders;a Service folder and an SDCG folder.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 A pps.We DO recommend dropping all service objects in to the“service”folder.All other control logic should be dropped in the“SDCG”folder or any other newly created folder(s)that identify the application or process involved.The example below shows the app tree in the CPT Tool view.There are 2 additional folders created,namely“Boiler”and“VT”in which the associated application logic would be created.Step 2 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 Boolea True output.Open the SDCG Folder by double clicking on the folder icon in the Navigation side bar.The Workspace for“SDCG”will