andover plain english language reference

8/21/2019 Andover Plain English Language Reference

1/738

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


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


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


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


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


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


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


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


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


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-


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


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.


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


16/738

Ethernet IP Network


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


17/738


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.


18/738


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.


19/738


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.


20/738


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


21/738


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.


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.



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.


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



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.


13


26/738



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


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.



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.



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.



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.


Plain English IDE Main Screen

Editor

Assistant Watch Bar

IDE Explorer

Status Bar

Title Bar

Menu Bar

MainToolbar

CommandLine

FindToolbar

CheckToolbar

Class ofObjectsDisplayedIn IDEExplorer


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.


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


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.



34/738


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.


35/738


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.


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



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


11


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.


Browse Command Line Response Line Button


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.


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


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.



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


15


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

andover plain english language reference

Documents