Date post: | 07-Aug-2018 |
Category: |
Documents |
Upload: | pedro-henrique |
View: | 384 times |
Download: | 4 times |
of 288
8/21/2019 Andover Plain English Language Reference
1/738
Andover Plain English™ Language Reference
8/21/2019 Andover Plain English Language Reference
2/738
© 2010, Schneider Electric
All Rights Reserved
No part of this publication may be reproduced, read or stored in a retrieval system, ortransmitted, in any form or by any means, electronic, mechanical, photocopying,
recording, or otherwise, without prior written permission of Schneider Electric.This document is produced in the United States of America.
Andover Plain Engl ish™ is a trademark of Schneider Electric.
Andover Inf inet™ is a trademark of Schneider Electric.
All other trademarks are the property of their respective owners.
Andover Plain Engl ish™ Language Reference August, 2010
Rev. F
Schneider Electric part number: 30-3001-872
CyberStation Version 1.9
The information in this document is furnished for informational purposes only, is subjectto change without notice, and should not be construed as a commitment by SchneiderElectric. Schneider Electric assumes no liability for any errors or inaccuracies that mayappear in this document.
Schneider ElectricOne High StreetNorth Andover, MA 01845(978) 975-9600Fax: (978) 975-9782http://www.schneider-electric.com/buildings
Schneider Electricii
8/21/2019 Andover Plain English Language Reference
3/738
Plain English Language Reference iii
Table of Contents
Chapter 1 Fundamentals
Introduction .......................................................................................................................1-Continuum Products..................................................................................................1-
Continuum System Architecture .....................................................................................1-Simple Continuum System ........................................................................................1-Moderate Continuum System....................................................................................1-System Components.................................................................................................1-
Network Controllers................................................................................................1-Infinet Controllers ...................................................................................................1-MS/TP Controllers..................................................................................................1-I/O Modules............................................................................................................1-Workstations ..........................................................................................................1-CyberStation Software ...........................................................................................1-Database................................................................................................................1-Infinet......................................................................................................................1-LBUS......................................................................................................................1-MS/TP ....................................................................................................................1-
Objects and Classes .........................................................................................................1-Objects ......................................................................................................................1-
Object Naming Convention ....................................................................................1- Alias Naming Convention.......................................................................................1-
Classes......................................................................................................................1-BACnet Objects vs. Continuum Objects ...................................................................1-
At tr ibutes .........................................................................................................................1-1How to View Attributes ............................................................................................1-1Basic Attribute Listing..............................................................................................1-1 Accessibility.............................................................................................................1-1
Object Ownership ...........................................................................................................1-1Hierarchical View of System Objects ......................................................................1-1Network Paths .........................................................................................................1-1
8/21/2019 Andover Plain English Language Reference
4/738
Schneider Electric iv
Chapter 2 The Plain English Integrated Development Environment
Opening the Plain English IDE ........................................................................................2-From the Continuum Main Menu...............................................................................2-From the Continuum Explorer ...................................................................................2-From the Start Menu .................................................................................................2-Creating the Program File .........................................................................................2-
Plain English IDE Features...............................................................................................2-
IDE Tools Overview...................................................................................................2-Title Bar .....................................................................................................................2-
The Menu Bar ....................................................................................................................2-File Menu...................................................................................................................2-Edit Menu ..................................................................................................................2-View Menu.................................................................................................................2-Build Menu.................................................................................................................2-Tools Menu................................................................................................................2-Window Menu............................................................................................................2-Help Menu .................................................................................................................2-
The Main and Find Toolbars ..........................................................................................2-1
The Main Toolbar ....................................................................................................2-1The Find Toolbar .....................................................................................................2-1
The Check Toolbar and Command Line .......................................................................2-1The Check Toolbar..................................................................................................2-1The Command Line.................................................................................................2-1
The IDE Explorer .............................................................................................................2-1Popup Shortcut Menu..............................................................................................2-1
The IDE Editor .................................................................................................................2-1Displaying Multiple Programs..................................................................................2-1
The IDE Assistant............................................................................................................2-1Selecting and Placing Objects.................................................................................2-1
The IDE Watch Bar ..........................................................................................................2-1Rearranging IDE Toolbars and Windows................................................................2-1
Docking and Floating......................................................................................................2-1Using the Docking and Floating Options.................................................................2-1
Configuring a Plain English Program File....................................................................2-1Configuring the Program File ..................................................................................2-1
Using the Editor ..............................................................................................................2-2Text Entry ................................................................................................................2-2The Editor Shortcut Menu .......................................................................................2-2Finding Text.............................................................................................................2-2Replacing Text ........................................................................................................2-2
Going to a Labeled Program Line ...........................................................................2-2Importing Programs.................................................................................................2-2Exporting Programs.................................................................................................2-2Saving the Program.................................................................................................2-2Opening the Program..............................................................................................2-2Running the Program from the Command Line ......................................................2-2Monitoring the Program File Status.........................................................................2-2Stopping the Program .............................................................................................2-2
8/21/2019 Andover Plain English Language Reference
5/738
Plain English Language Reference v
Using the Plain English Wizard .....................................................................................2-3Opening the Plain English Wizard...........................................................................2-3The Wizard File Selection Menu .............................................................................2-3Selecting and Configuring a Wizard Program.........................................................2-3The Object References Screen...............................................................................2-3The Final Wizard Screen.........................................................................................2-3
Chapter 3 Programs, Files and the Scanning ProcessPlain English Language Programs..................................................................................3-
Instructions and Statements......................................................................................3-Names and Case Sensitivity .....................................................................................3-Use of "The" ..............................................................................................................3-Lines and Line Labels ...............................................................................................3-Comments .................................................................................................................3-Expressions...............................................................................................................3-
Numeric Expressions .............................................................................................3-String Expressions .................................................................................................3-
Keywords ...........................................................................................................................3-
Other Words ..............................................................................................................3-Command Line ..........................................................................................................3-
Program Flow ....................................................................................................................3-Looping vs. FallThru...............................................................................................3-
Triggers .....................................................................................................................3-Construct ing Program Statements .................................................................................3-
Conditional and Unconditional Instructions ...............................................................3-IF…THEN..................................................................................................................3-
Program Files ..................................................................................................................3-1Keep Control in a Single Program File ....................................................................3-1
The Scanning Process....................................................................................................3-1Scan Action List.......................................................................................................3-1Other Actions...........................................................................................................3-1The Basic Stages ....................................................................................................3-1Stage 1. Updating System Variables ......................................................................3-1Stage 2. Updating Schedules..................................................................................3-1Stage 3. Updating Input Points ...............................................................................3-1Stage 4. Running Programs and Executing Commands ........................................3-1Stage 5. Updating Output Points.............................................................................3-1Stage 6. Evaluating Alarms .....................................................................................3-1
Other Scanning Issues ...................................................................................................3-1Numeric, String, and DateTime Points....................................................................3-1Updating Point Logs ................................................................................................3-1Triggering Programs from Points ............................................................................3-1Exported Points .......................................................................................................3-1Power Failure Conditions and the Firing Order.......................................................3-1
8/21/2019 Andover Plain English Language Reference
6/738
Schneider Electric vi
Chapter 4 Points, Constants and Variables
Points .................................................................................................................................4-Hardware Points........................................................................................................4-Input Points................................................................................................................4-Output Points.............................................................................................................4-Software Points .........................................................................................................4-Numeric Points ..........................................................................................................4-
Multi-State Value Points ............................................................................................4-String Points ..............................................................................................................4-DateTime Points........................................................................................................4-Controller vs. Workstation Points ..............................................................................4-
Constants...........................................................................................................................4-Numeric Constant......................................................................................................4-
Integer Numbers ....................................................................................................4-Floating Point Numbers..........................................................................................4-Examples of Numeric Constants............................................................................4-
How the Controller Interprets Numbers.....................................................................4-String Constants........................................................................................................4-
Rules for String Constants .....................................................................................4-System Defined Constants........................................................................................4-
Variables ............................................................................................................................4-Numeric Variables.....................................................................................................4-String Variables .........................................................................................................4-DateTime Variables...................................................................................................4-
Local Variables ..................................................................................................................4-Numeric Keyword...................................................................................................4-String Keyword.......................................................................................................4-DateTime Keyword.................................................................................................4-
System Variables ............................................................................................................4-1
Programmable System Variables............................................................................4-1System Variable Listing...........................................................................................4-1STATUS# System Variables ...................................................................................4-1PowerFail and other Power related System Variables............................................4-1
Chapter 5 Operators and Expressions
Order of Act ion ..................................................................................................................5-Plus Sign, Minus Sign, Negation, BITNOT, and Percentage.........................................5-Fundamental Operators....................................................................................................5-
Comparative Operators ....................................................................................................5-Comparing String Values ..........................................................................................5-Type Conversion .......................................................................................................5-
List and Range Operators ................................................................................................5-Bit Operators .....................................................................................................................5-
Truth Table ................................................................................................................5- AND/OR and String Join ing Operators .........................................................................5-1
8/21/2019 Andover Plain English Language Reference
7/738
Plain English Language Reference vii
Chapter 6 Funct ions, Arrays, and Logs
Funct ions ...........................................................................................................................6-Calling a Function......................................................................................................6-Calling a Function without Arguments.......................................................................6-Calling a Function with Arguments............................................................................6-Functions that Return a Value...................................................................................6-
Arrays .................................................................................................................................6-
Setting Up an Array of Variables ...............................................................................6-Logs....................................................................................................................................6-
How a Log Updates...................................................................................................6-How to Retrieve Log Values......................................................................................6-Log Update Intervals .................................................................................................6-Log Types..................................................................................................................6-Setting Up a Log........................................................................................................6-Using Arrays or Logs in Functions ............................................................................6-
Chapter 7 Keywords
Section 1 Format Conventions ..........................................................................7-Keyword Formatting Standard ........................................................................................7-
Identical Format for All Keywords .............................................................................7-Format .......................................................................................................................7-Purpose .....................................................................................................................7-Remarks ....................................................................................................................7-Example.....................................................................................................................7-Related Keywords .....................................................................................................7- Alias...........................................................................................................................7-Products Supported...................................................................................................7-Modes Available ........................................................................................................7-
Text and Symbols Used in the Format Heading ............................................................7-Format Heading Information......................................................................................7-Capital Letters ...........................................................................................................7-Bold Italics .................................................................................................................7-Parentheses ( ) ..........................................................................................................7-Italics .........................................................................................................................7-Comma (,) and Colon (:)............................................................................................7-Period (.)....................................................................................................................7-
Format Terms in Bold Italics ...........................................................................................7-Replacement of Terms..............................................................................................7-Number......................................................................................................................7-Integer .......................................................................................................................7-String .........................................................................................................................7-Name.........................................................................................................................7-List .............................................................................................................................7-
8/21/2019 Andover Plain English Language Reference
8/738
Schneider Electric viii
Section 2 Keyword Groups ................................................................................7-Logical Keyword Groups..................................................................................................7-
Logical Keyword Groups Listing................................................................................7-Restricted Keywords ...............................................................................................7-1250 Display Unit Keywords .....................................................................................7-1
Section 3 Keywords A through C ....................................................................7-1 ABS Function ..........................................................................................................7-1
AccessLog System variable...................................................................................7-1 AccessServer System variable..............................................................................7-1 ACOS Function .......................................................................................................7-1 Alarms System variable..........................................................................................7-1 AND Operator .........................................................................................................7-2 ARG System variable..............................................................................................7-2 ASC Function ..........................................................................................................7-2 ASIN Function .........................................................................................................7-2 ASK Function ..........................................................................................................7-2 ATAN Function........................................................................................................7-3 ATAN2 Function......................................................................................................7-3
AUDIOBELL System variable.................................................................................7-3 AvailRecords System variable...............................................................................7-3 AVERAGE Function................................................................................................7-3BACKLIGHT System variable.................................................................................7-3BASEDON..GOTO Statement ................................................................................7-3BEGINPOLYLINE Function ....................................................................................7-4BITAND Operator....................................................................................................7-4BITNOT Operator....................................................................................................7-4BITOR Operator ......................................................................................................7-4BITXOR Operator....................................................................................................7-4BLUE Constant .......................................................................................................7-4
BREAK Statement ..................................................................................................7-4CabinetTamper System variable ...........................................................................7-4CD Statement..........................................................................................................7-5CEILING Function...................................................................................................7-5CHR Function..........................................................................................................7-5CLEARSCREEN Function ......................................................................................7-5CLOSE Function .....................................................................................................7-5CloseFile Function..................................................................................................7-6CloseList Function .................................................................................................7-6CloseWindow Function..........................................................................................7-6CONTINUE Statement ............................................................................................7-6
CONTROL Function................................................................................................7-6COS Function..........................................................................................................7-7CPUPower System variable (programmable).........................................................7-7CurUser Function ...................................................................................................7-7CurWorkstation Function.......................................................................................7-7
8/21/2019 Andover Plain English Language Reference
9/738
Plain English Language Reference ix
Section 4 Keywords D through G....................................................................7-7DATE System variable............................................................................................7-7DATETIME Statement.............................................................................................7-7DAYOFMONTH System variable............................................................................7-7DAYOFYEAR System variable ...............................................................................7-8DeleteExtLog Function...........................................................................................7-8Dial Function ...........................................................................................................7-8DIFFTIME Function .................................................................................................7-9DISABLE Statement ...............................................................................................7-9DIVIDED BY Operator.............................................................................................7-9DRAWELLIPSE Function .....................................................................................7-10DRAWLINE Function ............................................................................................7-10DRAWRECTANGLE Function..............................................................................7-10ENABLE Statement ..............................................................................................7-10ENDPOLYLINE Function......................................................................................7-11EOF Constant........................................................................................................7-11EQUALS Operator ................................................................................................7-11ERRORS System variable ....................................................................................7-11EventLogSize System variable ............................................................................7-11EXPONENTIAL Function......................................................................................7-11FACTORIAL Function...........................................................................................7-12FAILURE Constant ...............................................................................................7-12File Statement.......................................................................................................7-12FILL Constant .......................................................................................................7-12FLOOR Function ...................................................................................................7-12FOR..NEXTStatement...........................................................................................7-12FREEMEM System variable..................................................................................7-13GetExtLog Function .............................................................................................7-13GETNAME Function..............................................................................................7-13
GetObject Function ..............................................................................................7-14GOTO Function .....................................................................................................7-14
Section 5 Keywords H through N ..................................................................7-14HangUp Function..................................................................................................7-14HOD System variable............................................................................................7-15HOUR System variable .........................................................................................7-15IF..THEN..ELSE Statement...................................................................................7-15INFINET#COUNT System variable.......................................................................7-16InitModem Function..............................................................................................7-16IOUCommFlt# System variable............................................................................7-16IS… Operator ........................................................................................................7-16
LCDPassword System variable ...........................................................................7-17LEFT Function.......................................................................................................7-17LENGTH Function.................................................................................................7-17LINE Statement.....................................................................................................7-17LINEPOINT Function ............................................................................................7-18LN Function...........................................................................................................7-18LOAD Statement on controller ..............................................................................7-18LOAD Statement on workstation ..........................................................................7-19
8/21/2019 Andover Plain English Language Reference
10/738
Schneider Electric x
LOCATE Function.................................................................................................7-19LOG Function........................................................................................................7-20MAXIMUM Function ..............................................................................................7-20MAXITEM Function...............................................................................................7-20MessageWindow Constant..................................................................................7-20MicroPower System variable ...............................................................................7-20MID Function .........................................................................................................7-20MINIMUM Function ...............................................................................................7-20MINITEM Function ................................................................................................7-21MINUS Operator....................................................................................................7-21MINUTE System variable ......................................................................................7-21MOD Operator.......................................................................................................7-21ModemPower System variable (programmable)..................................................7-21MONTH System variable.......................................................................................7-21MOVE Statement ..................................................................................................7-22NewAlarmCount System variable........................................................................7-22NOFILL Constant ..................................................................................................7-22NOT Operator........................................................................................................7-22NUMERIC Statement ............................................................................................7-22NUMTOSTR Function ...........................................................................................7-22
Section 6 Keywords O through R..................................................................7-23OBJECT Statement ..............................................................................................7-23OFF Constant........................................................................................................7-23ON Constant..........................................................................................................7-23-ON Constant ........................................................................................................7-23OPEN Function (comm port) .................................................................................7-23OpenFile Function ................................................................................................7-23OpenList Function ................................................................................................7-24OR Operator..........................................................................................................7-25
P Statement...........................................................................................................7-25PASSED Function.................................................................................................7-25PlayAudio Statement ...........................................................................................7-25PLUS Operator......................................................................................................7-26PositionFile Function ...........................................................................................7-26PowerFail System variable...................................................................................7-26PowerUpTime System variable............................................................................7-26RANDOM Function ...............................................................................................7-27READ Function (comm port) .................................................................................7-27ReadFile Function.................................................................................................7-28ReadProperty Function ........................................................................................7-28
ReaderPower System variable.............................................................................7-28Relinquish Function .............................................................................................7-28REPEAT..UNTIL Statement..................................................................................7-29RETURN Statement..............................................................................................7-29RIGHT Function ....................................................................................................7-29ROTATE Statement ..............................................................................................7-29ROUND Function ..................................................................................................7-29RUN Statement .....................................................................................................7-29
8/21/2019 Andover Plain English Language Reference
11/738
Plain English Language Reference xi
Section 7 Keywords S through Z...................................................................7-30SAVE Statement (on controller) ............................................................................7-30SAVE Statement on workstation ...........................................................................7-30SCAN System variable..........................................................................................7-31SEARCH Function ................................................................................................7-31SECOND System variable ....................................................................................7-31SELECT (CASE) Statement .................................................................................7-31SendEmail Function .............................................................................................7-32SET Statement ......................................................................................................7-32SETDISPLAY Function.........................................................................................7-32Shell Statement ....................................................................................................7-32Show Statement ...................................................................................................7-33SHOWREPORT Statement...................................................................................7-33SIN Function..........................................................................................................7-33SQRT Function......................................................................................................7-33StandardDeviation Function................................................................................7-34STATUS# System variable (programmable).........................................................7-34STOP Statement ...................................................................................................7-34STRING Statement ...............................................................................................7-34STRINGFILL Function ..........................................................................................7-34STRTODATE Function..........................................................................................7-35STRTONUM Function ...........................................................................................7-35SUCCESS Constant..............................................................................................7-35SUM Function........................................................................................................7-35SystemStatus System variable............................................................................7-35TAB Function ........................................................................................................7-36TAN Function ........................................................................................................7-36TD Local variable ..................................................................................................7-36TH Local variable ..................................................................................................7-36
THE Statement......................................................................................................7-36TIMEPIECE Function ............................................................................................7-36TIMES Operator ....................................................................................................7-36TM Local variable.................................................................................................7-36TOD System variable ............................................................................................7-36TOUCHEDCELL System variable ........................................................................7-37TRUNCATE Function............................................................................................7-37TS Local variable...................................................................................................7-37TURN Statement ...................................................................................................7-37UniquePIN System variable..................................................................................7-37UPDATE Function.................................................................................................7-37
UpdateExtLog Function .......................................................................................7-38VERSION System variable....................................................................................7-39WEEKDAY System variable .................................................................................7-39WHILE Statement .................................................................................................7-39WHITE Constant ...................................................................................................7-39WriteFile Function ................................................................................................7-39WriteProperty Function........................................................................................7-40YEAR System variable..........................................................................................7-40
8/21/2019 Andover Plain English Language Reference
12/738
Schneider Electric xii
Appendix A ASCII Codes ....................................................................... A-
Appendix B Reserved Words ................................................................ B-
Appendix C At tributes ........................................................................... C-
Appendix D Programming the DCX 250 Display Uni t.......................... D-
Understanding Pre-designed Graphic Controls ...........................................................D-
Predrawn Control Graphics......................................................................................D-Placing a Pre-designed Graphic Control on the 250 Screen.......................................D-
Preliminary Steps .....................................................................................................D-Basic Considerations................................................................................................D- Additional Considerations.........................................................................................D-The CONTROL Keyword.......................................................................................... D-The Arguments.........................................................................................................D-CONTROL Keyword Example.................................................................................. D-Setting Up the Software ........................................................................................... D-Format ...................................................................................................................... D- Argument Descriptions............................................................................................. D-
Steps and Tick Marks............................................................................................. D-1Positioning the Control ........................................................................................... D-1
Sett ing the Control Size.................................................................................................D-1Switches and Knobs Cannot be Resized............................................................... D-1Gauge Controls Retain Their Shape...................................................................... D-1Minimum Control Size ............................................................................................ D-1If the Control Doesn't Appear .................................................................................D-1
Graphic Control Style 1 Specifications........................................................................D-1Graphic Control Style 2 Specifications........................................................................D-1Graphic Control Style 3 Specifications........................................................................D-1Graphic Control Style 4 Specifications........................................................................D-1Graphic Control Style 5 Specifications........................................................................D-1Graphic Control Style 6 Specifications........................................................................D-1Graphic Control Style 7 Specifications........................................................................D-2Graphic Control Style 8 Specifications........................................................................D-2Graphic Control Style 9 Specifications........................................................................D-2Graphic Control Style 10 Specif ications......................................................................D-2Graphic Control Style 11 Specif ications......................................................................D-2Graphic Control Style 12 Specif ications......................................................................D-3Graphic Control Style 13 Specif ications......................................................................D-3
Appendix E BACnet Propert ies and Plain Engl ish ..............................E- Appendix F Alarm Functions ................................................................F-
Appendix G Area LockDown Features ................................................. G-
8/21/2019 Andover Plain English Language Reference
13/738
1Fundamentals
This chapter provides basic introductory concepts covering the architecture of the Andover Continuum building automation system that are essential to developing accurateprograms in the Andover Plain English™ Language. Since Andover ContinuumCyberStation is an object-oriented system, this chapter explains the concept of objects,aliases, and classes. In addition, the chapter focuses on object attributes, theirassociation to objects, and then ends with the discussion of hierarchical arrangementwithin a physical network.
The Fundamentals chapter discusses the following topics:
• Introduction
• Continuum Structure Architecture
• Objects and Classes
• Attributes
• Object Ownership
8/21/2019 Andover Plain English Language Reference
14/738
Schneider Electric 1-2
Introduction
The Andover Plain English™ language (PE) was developed by Schneider Electric toprovide our customers with the ability to customize their building automation systems inaccordance with specific site requirements. Similar to BASIC, PE is based on keywordsthat provide a simple straightforward approach to developing programming statements
and requires minimal programming experience.
Andover Plain English™ is included as part of Andover Continuum's Plain EnglishIntegrated Development Environment (IDE), a complete suite of highly integrated tools forwriting, editing and debugging PE programs. The Plain English IDE is described inChapter 2 of this document.
The programs developed with PE support the Andover Continuum line of BACnet andInfinity controllers and workstations.
Andover Continuum Products
The Andover Continuum product line encompasses a wide variety of componentsincluding Infinity CX 9xxx series controllers, CX 9680 and CX 9681 NetController IIcontrollers, CX 99xx NetControllers, Andover Infinet™ controllers, i2 Series controllers,BACnet series controllers, input/output IOU modules, display modules and smartsensors. These components are interconnected through various networkingarrangements to create a total building automation system.
Depending upon the complexity of the site architecture, a system can range from a singlecontroller with or without a workstation to a large configuration consisting of a network ofmultiple workstations, a database server, and numerous controllers.
From a programming perspective it is important that you have an understanding of howContinuum products are interconnected. A brief introduction of these arrangements andthe products is provided on the following pages.
8/21/2019 Andover Plain English Language Reference
15/738
Andover Continuum System Architecture
The following is an explanation of the different configurations and the systemcomponents of the Andover Continuum system.
Simple Andover Continuum SystemIn a simple single-workstation configuration, an Andover Continuum site might consist ofa single NetController, with some input/output (I/O) modules and the workstation PCrunning CyberStation software. In BACnet solutions, the bCX1 Router might be presentalong with several MS/TP sub-controllers. The NetController and the bCX1 use EthernetIP protocol to communicate with the workstation. The stand-alone version ofCyberStation is resident on the workstation PC along with the database containing theconfiguration data for the entire system.
Ethernet IP Network
Andover Plain English™ Language Reference 1-3
Example of a Continuum/BACnet Single Workstation Network
Moderate Andover Continuum System
The Andover Continuum system design is based on scalability, so expansion to a multi-workstation, larger network configuration can be accomplished easily. The illustration onthe following page shows such a setup. In this configuration, the Ethernet LAN has beenexpanded to include another workstation, a database server, an Infinity CX 9xxx seriesnetwork controller and a BACnet bCX1 controller. In addition, two Infinet controllers have
been added to the original NetController (from the figure above) via its Infinet port.Like the simple system shown above, this is a Continuum/BACnet-compliant system. Itprovides interoperability between existing Infinity/Infinet and BACnet devices over acommon Ethernet backbone. The CX controller feeds two Infinet application controllersfrom its Infinet port. The bCX1 controller serves as a gateway between the BACnetMS/TP RS-485 subnet and the Andover Continuum Infinet subnets hosted by the InfinityCX and NetController. This entire network can be viewed and controlled on aCyberStation/B-OWS workstation. A single server running MS SQL server softwarecontains the Continuum database.
NetController
ACC I/O Bus
Local field wiring
bCX1BACnetRouter Network
Path
PC WindowsWorkstation runningCyberStation withDatabase
IOU ModulesBACnetMS/TPRS-485
8/21/2019 Andover Plain English Language Reference
16/738
Ethernet IP Network
Schneider Electric 1-4
InfinetController
IOU Modules
Local field wiring
Local fielwiring
Local fieldwiring
bCX1BACnetController
PC WindowsWorkstationsrunningCyberStation
SQLDatabaseServer
Infinet
b3xxx
Third PartyBACnetDevice
BACnetMS/TPRS-485
NetController
Local fieldwiring
BACnetControllers
InfinityCX 9xxxController
b3xxx
Local field
wiring
Local fieldwiring
InfinetControllers
Infinet
LBUS
IOU Modules
Router
Local fieldwiring
Example of a Multi-Workstation Continuum/BACnet Network
System Components
The following paragraphs define the specific components that make up the AndoverContinuum system, varying from the types of controllers to the different connections. Thesystem components are as follows:
• Network Controllers • CyberStation Software
• Infinet Controllers • Database
• MS/TP Controllers • Infinet
• I/O Modules • LBUS
• Workstations • MS/TP
8/21/2019 Andover Plain English Language Reference
17/738
Andover Plain English™ Language Reference 1-5
Network Controllers
There are four types of Andover Continuum network controllers:
• Infinity CX 9000 series
• CX 9680 and CX 9681 NetController II
• CX 99xx NetController
• bCX1 BACnet Controller/Router• ACX series ⎯ Access Control
All are IP compatible and each contains at least one port to allow communication withapplication controllers.
Andover Infinet™ Controllers
These controllers include combinations of inputs and outputs for the monitoring andcontrol of local sensors and devices. There is a wide variety of Infinet controllers. Eachdevice is designed for a specific purpose:
• DCX 250 ⎯ Display Control
• LCX800 series ⎯ Local Control
• LCX89X series ⎯ Lighting Control
• SCX series ⎯ System Control
• TCX series ⎯ Terminal Control (HVAC, VAV, smoke detection)
• i2 series (also referred to as Infinet II) ⎯ Updates and replaces many of the olderInfinet controllers. The i2 series controllers have flash memory for firmware andobject storage.
Infinet controllers are connected to network controllers via the Infinet network.
MS/TP Contro llers
Schneider Electric offers a complete line of MS/TP BACnet-compatible sub controllers(b3 series) that are functionally equivalent to the entire i2 product line.
I/O Modules
Continuum I/O modules are specialized units that receive sensor inputs and activateequipment (valves, fans, and so on) and perform access control functions. They connectdirectly to the NetController II or the CX99xx NetController. Available I/O modules include
input, output, mixed I/O, and display configurations.
8/21/2019 Andover Plain English Language Reference
18/738
Schneider Electric 1-6
Workstations
A personal computer (PC) connected to the Andover Continuum Ethernet network servesas an operator workstation. The system can contain a single workstation or multipleworkstations, depending on the site configuration.
CyberStation Software
CyberStation is a Windows-based application program that runs on a PC workstation andinteracts with the control system. It provides a graphic user interface (GUI) that candisplay and manipulate data that allows the entire site management of adjustingschedules and setpoints, acknowledging alarms, controlling doors, tracking personnel,etc.
Database
The Database stores all the vital information pertaining to the building automation controlsystem. The database engine is either Microsoft SQL server or SQL Desktop Edition.
Andover Infinet™
The Andover Infinet is a high performance, token-passing LAN that allows Infinet application controllers to communicate with each other and to a single CX orNetController. Using InfiLink repeaters, it is possible to have 127 Infinet controllers onone Infinet. Data transmits over the Infinet at a rate of 19.2 Kb/sec.
LBUS
The LBUS is an RS-485-based protocol that is used by the system AC256 tocommunicate with older IOU modules. The NetController can communicate to these IOU
modules using the LA-1 converter. Only one LBUS can be connected to a CX controller.Each LBUS can handle up to 16 IOUs.
MS/TP
MS/TP is an RS-485 based network that connects Andover Continuum and third-partyBACnet devices to the bCX1 controller.
8/21/2019 Andover Plain English Language Reference
19/738
Andover Plain English™ Language Reference 1-7
Objects and Classes
CyberStation is based on object-oriented programming principles. Objects and classes are the basic building blocks of the system. Each item appearing on a CyberStationworkstation screen represents an object. There are hardware-based objects (controllers,workstations, I/O points) and software-based objects (system variables, attributes).
Furthermore, the objects can be grouped into classes.
Objects and their aliases follow distinct naming conventions that are described in thefollowing paragraphs.
Objects
Objects are the basic building blocks of Schneider Electric's Andover Continuum controlsystems. All the items that make up the system, both hardware and software areidentified as objects. Each item appearing on a CyberStation workstation screenrepresents an object. For example, objects contained within the controller class include:
• CommPort
• Input
• Output
• User
• Group
Graphical icons, displayed in the Continuum Explorer, represent both hardware objectsand software objects.
Object Naming Convention
When you create a name for an object in CyberStation, the system automatically createsa second object identifier called an Alias. The object name can be lengthy and descriptivewhereas the object alias must conform to a stricter naming convention (see "AliasNaming Convention" on the next page).
The object name is stored in the Continuum database, not in the controller.
8/21/2019 Andover Plain English Language Reference
20/738
Schneider Electric 1-8
The set of characters allowed in object names, called the "Naming Character Set”, isdescribed below.
The Naming Character Set
Character Description
A-Z anda-z
Alphabetic characters. Upper- and lowercase areinterchangeable.
0-9 Numeric characters.
_ Underscore character.
. Period character
/ Slash character
Dash character
Space character
Object names can be up to 64 characters long and may consist of any combination of the
naming character set.
Ideally, the object name should be as descriptive as possible to help identify the object itrepresents. For example, an output point for an operating fan could be named FanStart/Stop.
Al ias Naming Convention
The alias is the object reference used in programs and functions. CyberStation createsthe alias version of the object name whenever a new object is created.
The alias name is saved to both the controller and the Continuum database.
The rules for the alias naming character set are as follows:• The length of the alias name cannot exceed 16 characters
• Must start with a letter, not a number
• Alphanumeric characters
• Period and underscores are the only punctuation characters allowed
• No spaces
• No reserved words, keywords or symbols (+, -, /, *, etc.)
8/21/2019 Andover Plain English Language Reference
21/738
Andover Plain English™ Language Reference 1-9
Classes
Objects are categorized into classes, which are groups of related objects. Examples ofclasses:
• Area
• Device
• ScheduleIf you open a class folder in the Continuum Explorer, you see a list of objects for thatclass. For example, the SystemVariable folder displays a list of system variables.
BACnet Objects vs. Andover Continuum Objects
All information in a BACnet system is also represented in terms of “objects”. Objects mayrepresent a single physical “point” or logical groupings of points that perform a specificfunction. The information contained within a BACnet object is presented as a set ofproperties. In CyberStation, BACnet object properties are similar to Andover Continuumobject attributes.
8/21/2019 Andover Plain English Language Reference
22/738
Attributes
An attribute is a characteristic of an object. An example attribute of an input object wouldbe its Value. All objects have attributes associated with them. In most cases, there areseveral attributes that describe an object. In BACnet, attributes are called “properties”.
How to View Attributes
The attributes for any object in CyberStation can be viewed by double clicking the objecticon in Continuum Explorer's viewing pane. The General tab of the object editor displayssome attributes for the selected object. An example is shown below:
The attributes that appear on the object's General tab varies depending on the selectedobject.
Schneider Electric 1-10
8/21/2019 Andover Plain English Language Reference
23/738
Andover Plain English™ Language Reference 1-
11
Basic Attribute Listing
The following table provides a summary of the attributes appearing in the previousexample of a General tab.
Attribute Description
Description A description of the object
Value Describes the value of the object. Examples include: On or Off, Trueor False, Success or Failure, Set or NotSet.
Units Units of measurement, such as Degrees Fahrenheit or Centigradecan be assigned to temperature measurements.
State The state of an object that can exist in either an Enabled or Disabledstate.
Alarms Indicates the alarms that are active for an object.
Exported Indicates if the point is referenced by another controller. Thisattribute is read-only and is set by the Continuum System.
Accessibility
The attributes for all objects used in PE programs are accessible from any CyberStationworkstation. Most object attributes can be altered from the Command Line window of theworkstation. (Refer to Chapter 3 for a detailed description of how to view object attributesusing the Command Line.)
Appendix C contains a complete list of attributes for each object contained inCyberStation.
8/21/2019 Andover Plain English Language Reference
24/738
Object Ownership
Object ownership is a term that describes the relationships between objects inCyberStation.
Objects in CyberStation are arranged in a hierarchy. The Root object is always the prime
object at the top of the hierarchy. Objects at the top of the hierarchy contain, or own theobjects below them. This ownership refers to the physical network connection betweendevices and to where the objects are stored within the network.
Hierarchical View of System Objects
Network and Controller views that are selectable on the CyberSTation workstation screenrepresent the hierarchy of the physical components in the system. For example, an inputpoint called Rm_Temp1, attached to a NetController named CX1 that is connected to anetwork called Bldg1, would be described using the following object hierarchy:
The network object (Bldg1) owns the attached device object (controller CX1) which ownsthe input point object (Rm_Temp1). These relationships are shown graphically below.
This hierarchical relationship is an important concept that is applied to network pathnames in PE programming statements.
Network
Bldg1
Root
Input Point
Rm_Temp1
Controller
CX1
Example of Object Hierarchical Relationships
Schneider Electric 1-12
8/21/2019 Andover Plain English Language Reference
25/738
Network Paths
A path is the route you follow along the network to get from one object to another. Theobject could be any of the following:
• Controller
• Workstation
• Printer
• Point
• Some other object on the network
The network path and object relationships are important concepts when creatingstatements in PE.
For example, based on the graphical representation in the previous section, if you needto take action when the room temperature in Building 1 (BLDG1) exceeds 74 degrees,the following statement might be entered into the program:
IF BLDG1 CX1 RM_TEMP1 > 74 THEN...
Network
In this statement, the correct path from the network and controller (BLDG1, CX1) to theinput point (RM_TEMP1) must be specified in order to run the program.
Andover Plain English™ Language Reference 1-
13
8/21/2019 Andover Plain English Language Reference
26/738
Schneider Electric 1-14
8/21/2019 Andover Plain English Language Reference
27/738
2The Plain English IntegratedDevelopment Environment
This chapter provides an overview of the Plain English Integrated DevelopmentEnvironment (IDE) and explains how it enhances the production of writing and editingPlain English programs. The discussion in this chapter is not intended to be a completetutorial on the use of the IDE, but rather to present an overall picture of its componentsand to touch briefly on each of its features.
This chapter discusses the following topics:
Opening the Plain English IDE The IDE Assistant
Plain English IDE Features The IDE Watch Bar
The Menu Bar Docking and Floating
The Main and Find Toolbars Configuring a Plain English Program F
The Check Toolbar and the CommandLine
Using the Editor
rThe IDE Explore
The IDE Editor
Using the Plain English Wizard
8/21/2019 Andover Plain English Language Reference
28/738
Opening the Plain Engl ish IDE
There are three ways to open the IDE when you wish to create a new program file:
From the System & Status button on CyberStation’s main menu
From the Continuum Explorer
Selecting Programs – Continuum – PlainEnglish from the Windows Start menu
These methods are described below.
From the CyberStation Main Menu
If you click the hot spot on the left-hand side of the ContinuumMain Menu, the System & Status menu page appears.
System & Status menu page
Click the hot spot to start the Plain English IDE.
Schneider Electric 2-2
8/21/2019 Andover Plain English Language Reference
29/738
From the Continuum Explorer
From any view of the Continuum Explorer, right click the controller or workstation whereyou want the program to reside. Then select New and InfinityProgram for controller-based programs or simply Program for workstation-resident programs from the popupmenus that appear. BACnet programs are created as Infinity programs.
Selecting a New Infinity Program
From the Start Menu
From the Windows explorer, click Start. Select Programs -> Continuum -> Plain
English.
Note: Continuum must be running.
Andover Plain English™ Language Reference 2-3
8/21/2019 Andover Plain English Language Reference
30/738
The New create dialog box appears when you select New InfinityProgram from the fileoption on the menu bar. Otherwise, selecting New from the File menu or clicking the newfile quick pick button displays the dialog box shown below:
The New Dialog Box
Creating the Program File
Type the program name in the Object name text box and click the Create button. Next,the Editor screen appears in the IDE main window.
Schneider Electric 2-4
8/21/2019 Andover Plain English Language Reference
31/738
Plain English IDE Features
The following paragraphs explain the various features and components of the IntegratedDevelopment Environment (IDE).
IDE Tools OverviewIDE consists of a variety of color-enhanced windows, menus and toolbars to simplify thewriting, editing and debugging of Plain English (PE) programs.
The IDE main screen includes standard Windows features (title bar, menu bar, varioustoolbars, main window and status bar) along with specialized editor function windows.
Andover Plain English™ Language Reference 2-5
Plain English IDE Main Screen
Editor
Assistant Watch Bar
IDE Explorer
Status Bar
Title Bar
Menu Bar
MainToolbar
CommandLine
FindToolbar
CheckToolbar
Class ofObjectsDisplayedIn IDEExplorer
8/21/2019 Andover Plain English Language Reference
32/738
The following topics describe the different components of the Plain English IDE:
The Title Bar – Indicates the directory path to the current PE program file.
The Menu Bar – Provides a series of menus and options for creating and editing PEprogram files.
The Main Toolbar – Provides shortcuts for the items in the Edit Menu.
The Find Toolbar - Provides a shortcut for locating specific words, symbols, orphrases in a PE program file
Check Toolbar – Works in conjunction with the Assistant to compile programs andreport errors.
IDE Explorer – Provides a graphical display of your system.
Schneider Electric 2-6
nglish
Watch Bar - Allows you to monitor your program's effect on other objects.
u changeprograms in the PE Editor, the Title bar will change to reflect the new path.
Editor – Provides an area for users to write and edit programs.
Assistant - Provides additional support in the writing and editing of Plain Eprograms by supplying features that help to simplify the coding process.
Title Bar
The Title bar indicates the directory path to the current PE program file. If yo
8/21/2019 Andover Plain English Language Reference
33/738
The Menu Bar
The menu bar provides seven dropdown menus within the IDE. The seven menus aredescribed in detail in the following sections.
File Menu
The File Menu offers the following options:
Option Description
New Opens a new program file.
Open Opens an existing program file.
Close Closes the current active program file.
Delete Deletes the current active program file.
Save Checks and saves the active program file.
Save As Checks and saves the active program file under a new name.
Save All Checks and saves all open program files.
Close All Closes all open program files.
Import Inserts the contents of a text file into the active program file.
Export Saves the active program file to a text file.
Configuration Displays the Infinity Program, or the Function Configuration Dialog.
Firing Order Displays and allows editing of the current firing order.
Print Prints the active program file.
Exit Exits the Plain English editor.
Andover Plain English™ Language Reference 2-7
8/21/2019 Andover Plain English Language Reference
34/738
Schneider Electric 2-8
Edit Menu
The Edit Menu offers the following options:
Option Description
Undo Reverts to the previous action.
Redo Performs the last action that was undone by Undo.Cut Removes selected text from the program and places it in
the Clipboard.
Copy Copies selected text from the program and places it inthe clipboard.
Paste Inserts contents of the clipboard at the cursor position.
Select All Selects the entire program.
Find From the cursor position, finds the next or previous instance ofspecified text.
Find Next From the cursor position, finds the next instance of the text for
which you last searched.
Find Previous From the cursor position, finds the previous instance of the text forwhich you last searched.
Replace Finds specified text, and replaces it with a different specified text.
Goto Places your cursor at the specified line number or line definition.
View Menu
The View Menu offers the following options:
Option Description
Toolbars When checked ( ), adds the selected toolbar to the IDE screen.When not checked, removes the selected toolbar from the IDEscreen. The toolbars are Main, Find, Check, Assistant, Explorer,Command Line and Watch.
Set Font Displays the Font dialog box, allowing you to change the font forthe active program file.
Refresh Checks and saves the active program file, and refreshesthe screen.
Folder View Changes the IDE Explorer to folder view. In this view, the Root andall folders appear in the navigation pane.
Network View Changes the IDE Explorer to network view. In this view, thenetwork you set up appears in the navigation pane.
8/21/2019 Andover Plain English Language Reference
35/738
Andover Plain English™ Language Reference 2-9
Build Menu
The Build Menu offers the following options:
Option Description
Check Compiles the currently active program file. Reports errors in theCheck page of the Assistant
Check All Compiles all open program files. Reports errors in the Check pageof the Assistant.
Stop Stops compiling.
Tools Menu
The Tools Menu offers the following options:
Option Description
Wizard Opens the Plain English Wizard.
Calculator Displays the Calculator.
Options Displays the Options dialog.
Window Menu
The Window Menu offers the following options:
Option Description
Cascade Displays program windows overlapping diagonally.
Tile Horizontally Displays program windows in equal horizontal portions ofthe editor.
Tile Vertically Displays program windows in equal vertical portions of the editor.
Arrange Icons This feature is not supported in this release
Note: A list of currently open windows appears at the bottom of the Window menu.Clicking any window in the list will make it the active window.
Help Menu
The Help Menu offers the following options:
Option Description
Help Topics Displays Plain English online help topics.
About IDE Displays the copyright and version number for the PE editor.
8/21/2019 Andover Plain English Language Reference
36/738
The Main and Find Toolbars
The following displays and describes the items on the Main and Find Toolbars.
The Main Toolbar
The Main toolbar contains shortcuts to many of the items found in the Edit menu.
Main Toolbar Selections
Action Icon
Open a new program
Open an existing program
Save the currently active program
Save all open programs
Cut text
Copy text
Paste text
Undo the last action you performed
Redo the last action you performed
Find a particular word in the current program
Print the current program
Schneider Electric 2-10
8/21/2019 Andover Plain English Language Reference
37/738
The Find Toolbar
The Find toolbar is a shortcut search tool. It contains an input field and buttons to helpyou look for specific words, symbols, and phrases in the program or function that you arewriting or editing.
If the Find toolbar is hidden, go to Toolbars in the View menu to add it.
Using the Find Toolbar
Step Action
1 Type the text that you want to find, or use the pull-down list to selectpreviously searched text.
2 To search from the cursor position to the end of the program,
click
3 To search from the cursor position to the beginning of the program,
click
Andover Plain English™ Language Reference 2-
11
8/21/2019 Andover Plain English Language Reference
38/738
The Check Toolbar and Command Line
The following displays and defines the features that appear on the Check Toolbar and theCommand Line.
The Check ToolbarThe Check toolbar is used in conjunction with the Assistant to compile programs andreport errors. Each of the icon buttons appearing on the Check toolbar is listed below. Ifthe Check toolbar is hidden, go to Toolbars in the View menu to add it.
IDE Check Toolbar Buttons
Button Action
Compiles the active program in the Editor
Complies all programs in the Editor
Stops compilation
Save the program and refreshes the windows
Displays the program Configuration dialog box
Starts the Plain English Wizard. (See "Using the Plain English
Wizard" in this chapter.)
Displays a pop-up calculator
The Command Line
The Command Line is where you enter and execute Plain English commands. If theCommand Line is hidden, go to Toolbars in the View menu to add it. Its features include:
Browse Button ⎯ opens a drop down explorer tree.
Command Line ⎯ where you enter Plain English commands.
Response Line ⎯ where messages and print requests appear.
Schneider Electric 2-12
Browse Command Line Response Line Button
8/21/2019 Andover Plain English Language Reference
39/738
The IDE Explorer
The IDE Explorer is a small, more limited version of the Continuum Explorer. It helps younavigate through the folders and devices on your system to find and select objects to addto your programs. If the IDE Explorer is hidden, go to Toolbars in the View menu to addit.
The basic parts of the IDE Explorer include:
Explorer Drop-Down List Box ⎯ Displays the object tree of the current folder ordevice directory.
Class Drop-Down List Box ⎯ Displays the classes of the folder or device objectselected from the Explorer Drop-Down List Box.
Back Up One Level Button ⎯ Changes the Explorer Drop-Down List Box to the nexthigher directory.
Copy Objects Button ⎯ Copies selected object on the Class Drop-Down List to the
IDE Assistant.
Andover Plain English™ Language Reference 2-
13
Current Device
IDE Explorer Drop-Down List Box
Back UpOne LevelButton
IDE Explorer
Current Class
Class Drop-
Down List Box
Copy ObjectsButton
List of ObjectsMatchingSelected CurrentClass
8/21/2019 Andover Plain English Language Reference
40/738
Popup Shortcut Menu
In addition to the above features, the IDE Explorer provides several options by means ofa popup shortcut menu, which is activated whenever, you right-click an object in the drop-down list box.
IDE Explorer Popup Shortcut Menu Features
Menu Item Action
Open Opens programs in the IDE. For other classes, opens the appropriatedialog box.
Edit Starts another IDE session for the selected program. For otherclasses, opens the appropriate application.
Put in Service Opens a dialog box to confirm the state of the object’s attribute is“Enabled” [NOT SHOWN FOR INFINITYPROGRAM]
Take out ofService
Opens a dialog box to confirm the state of the object’s attribute is“Disabled” [NOT SHOWN FOR INFINITYPROGRAM]
Enable Opens a dialog box to confirm the state of the program’s attribute is“Enabled” [ONLY SHOWN FOR INFINITYPROGRAM]
Disable Opens a dialog box to confirm the state of the program’s attribute is“Disabled” [ONLY SHOWN FOR INFINITYPROGRAM]
Send To Offers a selection of "Controller, Database, Text File or Printer".
Delete Deletes the selected object.
Rename Opens a dialog box for renaming the object.
Page Setup Opens a dialog box to select the page setup of the object to be
printed.Print Selected Opens a dialog box to select the printer.
Go To Offers a selection of “Owner or Device.”
Properties Opens the Properties dialog box.
Schneider Electric 2-14
8/21/2019 Andover Plain English Language Reference
41/738
The IDE Editor
The IDE program Editor is a window that appears in the Main Window area of the IDEscreen when you open a new or existing Plain English program. The Editor is the tool youuse to write and edit programs. Its main features are:
Each program displays in its own Editor window. More than one program can be open at the same time, each with its own resizable
Editor window.
When multiple programs are open, a tab appears at the bottom of the Editor windowfor each program and the active program tab overlays the other tabs.
In multiple Editor window displays, clicking a program tab activates that program.
Only one program at a time can be the active or current Editor window.
When a program becomes too large for its window, scroll bars appear.
Color is used for distinguishing progra m elements. Blue is for keywords, red for linedefinitions and green for comments.
s allows you to copy code from one
the active windowsince its tab (see bottom of screen) overlays the other program tabs.
Displaying Multiple Programs
The Editor's ability to display multiple programprogram to another thus saving typing time.
In the figure below, four programs occupy the Editor window. Prog4 is
IDE Editor Window
Andover Plain English™ Language Reference 2-
15
8/21/2019 Andover Plain English Language Reference
42/738
The IDE Assistant
The IDE Assistant provides additional support in the writing and editing of Plain Englishprograms. Six tabs located at the bottom of the Assistant window provide features thathelp to simplify the coding process. When selected, each tab becomes a separate pagein the Assistant window.
IDE Assistant Page Features
Menu Item Action
Objects Provides a temporary storage pla