Command Terminal Configuration Guide

Transcription

1 Command Terminal Configuration Guide

2 2003, Andover Controls Corporation All Rights Reserved No part of this publication may be reproduced, read or stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without prior written permission of Andover Controls Corporation. Produced in the United States of America. Infinity, Continuum and CyberStation are trademarks of Andover Controls Corporation. All other trademarks are the property of their respective owners. Command Terminal Configuration Guide for Version: B January, 2003 Andover Controls part number: The information in this book is furnished for informational purposes only, is subject to change without notice, and should not be construed as a commitment by Andover Controls Corporation. Andover Controls Corporation, assumes no liability for any errors or inaccuracies that may appear in this document. Andover Controls Corporation 300 Brickstone Square Andover, MA (978) fax: (978) Andover Controls Corporation

3 Contents What is the Command Terminal Interface?... 3 Basic Command Terminal Usage... 4 Accessing the Command Terminal... 4 Commissioning the Controller... 6 Communicating with the Controller... 6 HyperTerminal Setup... 6 Logging on... 8 Using the Menus Connecting to a Controller Logging Off Advanced Command Terminal Usage Using the Command Window PRINT Command Line Setting the Date and Time Making Changes Inside the Window Controller Window Features Setting up the Controller CommPort NetController LBus Configuration Creating and Configuring Points Setting Up Point Logs Saving and Reloading Controllers Using the Program Editors Appendix Commissioning the Controller Command Terminal Configuration Guide iii

4 iv Andover Controls Corporation

5 Chapter 1 Basic Command Terminal Usage Command Terminal Configuration Guide 1

6 2 Andover Controls Corporation

7 What is the Command Terminal Interface? Continuum NetControllers include a firmware-based user interface through which commands may be passed to configure and control its actions. This interface requires a separate personal computer running a terminal emulator program or a dedicated ASCII terminal. Communications with the Command Terminal firmware are carried out over an RS232 link through any CX Comm port configured as AutoSet. The typical and recommended path for programming a NetController is through the use of a separate personal computer (Continuum workstation running the Andover Controls CyberStation application). However, if a CyberStation is not present, it is possible to program the NetController directly through the Command Terminal interface. The Command Terminal interface has the same capabilities of a Continuum CyberStation except for the following items: Alarms cannot create or edit alarms through the command terminal interface. Schedules cannot create or edit schedules through the command terminal interface. Area Objects cannot create area objects through the command terminal interface. Personnel Objects cannot create personnel objects through the command terminal interface. Particularly valuable as a site troubleshooting aid, using the Command Terminal interface makes it possible to write programs, create and access system points and to configure network parameters. This manual provides you with information about using the Command Terminal mode. Included are the procedures to: Commission the NetController Create and configure object types Create and configure points Save and reload controllers Use the program editors to create controller-resident Plain English programs Set up the optional SNMP alarming function of the NetController Command Terminal Configuration Guide 3

8 Basic Command Terminal Usage Basic command terminal usage includes the following topics: Accessing the Command terminal Commissioning the controller Communicating with the controller HypertTerminal setup Logging on Using the menus Connecting to a controller Logging off Accessing the Command Terminal This section discusses how to access the command terminal. What You ll Need Access to the Command Terminal of the NetController requires a laptop or other computer that is running an ASCII terminal emulator and a cable that connects the NetController to the computer. Terminal emulators are common programs that allow you to communicate simply with RS232 devices. One emulator program, HyperTerminal, is built into Windows and is available from the Accessories menu off of the Start menu. 4 Andover Controls Corporation

9 Connections You can connect to the NetController either directly or through a modem, using a device with a keyboard and display. These devices are often referred to as ASCII terminals, TTY replacements, or terminals. We call them Command Terminals. Your Command Terminal must be DEC VT100 or VT220 compatible, or your computer must be running a terminal emulation program that supports one of these configurations. Communications between the NetController and the command terminal is through the RS232 interface. Connect the NetController Commport 3 and the Command Terminal s Serial or Commport. Connections made through a modem are straightforward; however, refer to the modem manufacturer s guidelines before making the connection. Direct connection requires an RS232 Null Modem cable as shown below. The default operating state of the NetController s COMM3 port is for AutoSet and for connection via a modem. If a modem is installed and you are connecting directly to the controller via an RS232 null modem cable, press the MODEM RS232 OVERRIDE button once on the NetController s display panel. RS232-based communication operates at a number of speeds called Baud Rates. Both the NetController and the Command Terminal must be set to the same baud rate in order to communicate correctly. The following table shows the correct default settings for Command Terminal operation: RS232 Settings Baud rate 9600 Data bits 8 bits Parity None Stop bits One Flow control None Command Terminal Configuration Guide 5

10 Commissioning the Controller To prepare the NetController for operation on a Continuum network, the controller s network address information must be entered so the controller can communicate with and view other network objects. This operation is called commissioning. Instructions regarding the commissioning of the NetController can be found in the Appendix of this document and in the NetController Programming and Installation Guide. Communicating with the Controller The instructions on this and the following pages illustrate the setup and operation of HyperTerminal, a program that is included with your Windows operating system, for transforming an external personal computer into a Command Terminal capable of communicating with the NetController. HyperTerminal Setup The following is an example procedure for communicating with the NetController s Command Terminal firmware using the emulator program, HyperTerminal through COM1. To setup HyperTerminal, perform the following steps: 1. Open HyperTerminal by selecting Start Programs -- Accessories Communications -- HyperTerminal. The Connection Description dialog box appears. 6 Andover Controls Corporation

11 HyperTerminal Setup (continued) 2. For modem-based connections, enter a name for your connection, select an appropriate icon, and click OK. For direct connections, enter a name for your connection and click OK. The Connect To dialog box appears. 3. For modem connections, fill in the appropriate dial-up information, select the desired port and click OK. For direct connections, select the desired port and click OK. This port is the serial port of your personal computer that is connected to the NetController. 4. When the COM port Properties dialog box appears, configure your command terminal Port Settings as shown below and click OK: The setup of HyperTerminal is complete. The following pages instruct you in logging on to the controller and using the Command Terminal interface. Command Terminal Configuration Guide 7

12 Logging on Once the computer and the NetController are connected, powered up and the HyperTerminal setup is completed, the computer can log onto the NetController. To log on to the NetController, perform the following steps: 1. For modem access you must perform a dial-up connect sequence. When the controller access is established you are presented with the main terminal blank screen. When connecting directly, there is no dial-up sequence. You are presented with a blank screen. 2. In the blank screen at the command terminal type: window The characters do not echo to your display. If they were received properly, the command terminal interface window appears. Note: For security reasons, access to the NetController internal setup program is limited to people who need to use it, so you must log on the system. Your System Administrator should have been given a User ID and Password. The default User ID and Password are both ACC (not case sensitive). These defaults should be changed as soon as possible to prevent unauthorized users from entering Continuum. 8 Andover Controls Corporation

13 Logging on (continued) 3. Type your user name and press the TAB key. Type your password and press ENTER to log on to the controller. The Command Terminal Main Window appears displaying the following areas: Command Prompt Menu Bar Controller Path Status Bar Menu Bar Command Prompt Status Bar Controller Path There are four menus (View, Edit, Connect, and Logout). The current menu is highlighted. In the figure above, View is the current menu. Commands are entered at the R> prompt. ( R> indicates Ready. ) The status bar displays information about the status of the system. Shows what controller the command terminal is currently connected to. To enter commands at the Command Prompt, press the F4 key. To toggle between the Command Prompt and Menu Bar, press the F4 key again. Command Terminal Configuration Guide 9

14 Using the Menus Across the top of the main window is a thin bar called the Main menu bar. The menu consists of four words which each represent a menu. To move the cursor from menu to menu, press the right or left arrow keys. To select a menu, press the ENTER key while the menu name is highlighted. Quick Menu Selection To move the cursor to the menu and select the menu simultaneously, press the first letter of the menu name on the keyboard. For example, as shown below, pressing the E key selects the Edit menu. To select an item from a menu, use the up and down arrow keys to highlight the item, then press the ENTER key. Quick Item Selection To move the cursor to the item and select it simultaneously, press the key for the first highlighted letter in that menu item. (The first highlighted letter is not always the first letter of the word.) 10 Andover Controls Corporation

15 Menu Reference The descriptions for each of the selections in the menu bar are as follows: View Displays information about inputs, outputs, programs, controllers, etc. Edit Connect Logout Displays information about, and allows the creation/editing of inputs, outputs, programs, controllers, etc. Allows the user to determine which controller or Infinet controller to set the Controller Path to. Logs the user out of the command terminal. View Menu Descriptions The descriptions for each of the selections under the view menu are as follows: Editor Feature Messages Points Inputs Outputs Numerics Strings System Variables Date Times Files Programs Infinet Controllers Controllers Disabled Points Disabled System Variables Disabled Files Description Displays any error messages, transaction logs, etc., similar to the Message Window in CyberStation Displays all known Points created on the current controller. Displays all known Inputs created on the current controller. Displays all known Outputs created on the current controller. Displays all known Numerics created on the current controller. Displays all known Strings created on the current controller. Displays all known System Variables on the current controller. Displays all known Date Times on the current controller. Displays all known Programs and Functions stored on the current controller. Displays all known Programs stored on the current controller. Displays all known Infinet Controllers connected to the current controller. Displays all Ethernet level Controllers that have been taught to the current Controller. Displays all known disabled points for this controller. Displays all known disabled system variables for this controller. Displays all known disabled files for this controller. Command Terminal Configuration Guide 11

16 Edit Menu Descriptions The descriptions for each of the selections under the edit menu are as follows: Note: Pressing F2 after the selection dialog box has been shown displays a list of previously configured objects. Editor Feature Users Points Files Commports Infinet Controllers System Date & Time System Variables Doors IOU Modules Description Displays all Users known to this controller and allows for the editing, deletion and creation of new Users. Displays all known points created on the current controller & allows for the editing, deletion and creation of new points. Displays all known programs and functions stored on the current controller & allows for the editing, deletion and creation of new programs and functions. Displays all known Commports on the current controller & allows for the configuration of them. Displays all known Infinet Controllers on the current controller and allows for the editing, deletion and creation of new Infinet Controllers. Displays and allows for the editing of the System Date & Time on the current controller. Displays and allows for the editing of all known System Variables on the current controller. Displays and allows for the editing, deletion and creation of all doors stored on the current controller. Displays and allows for the editing, deletion and creation of all IOU Modules connected to the current controller. 12 Andover Controls Corporation

17 Connect Menu Description The Connect menu selection is for connecting to a specific controller. To connect to a controller, such as an Infinet Controller on one of the Commports, perform the following steps: 1. Select Connect from the main menu. The Open a Connection window appears. 2. Type in the controller name and press ENTER. Alternately you can press F2 to bring up a list of known controllers to connect to. If you are connecting to an Infinet Controller on one of the Commports, arrow down to the InfinetCtlr field and type in an Infinet Controller name or press F2 to bring up a list of Infinet Controllers that the NetController currently knows about. Press ENTER when the controller you want to connect to is highlighted in your list. Command Terminal Configuration Guide 13

18 Logout Menu Description The Logout menu selection is for logging out of the command terminal. To log off the command terminal, perform the following steps: 1. Move the cursor to the Logout menu and press ENTER. 2. A Logout warning screen will appear. Select YES and press the ENTER key to complete the logout. 14 Andover Controls Corporation

19 Chapter 2 Advanced Command Terminal Usage Command Terminal Configuration Guide 15

20 16 Andover Controls Corporation

21 Advanced Command Terminal Usage This section discusses advanced command terminal usage. Advanced command terminal usage includes the following topics: Using the Command Window Using the PRINT Command Setting the Date and Time Making Changes Inside the Window Controller Window Features Setting up the Controller Commport NetController LBus Configuration Creating and Configuring Points Setting up Point Logs Saving and Reloading Controllers Using the Program Editors Command Terminal Configuration Guide 17

22 Using the Command Window As soon as you have logged on to the controller, a window inside the main window appears. This is called the Command window. The cursor is on View at the far left selection on the Main menu bar. To move the cursor from the Main menu bar to the Command window, press the F4 key. To bring it back to the menu bar, press F4 again. In the Command window you can enter single-line instructions called command lines. Command lines tell the controller to do something now. You can use most keywords on the command line. In the Andover Controls Plain English Language Reference, each keyword has a section labeled Modes Available In. If command line is listed, the keyword can be used on the command line. Using the PRINT Command Plain English keywords are used to form command lines. You type command lines after the R> prompt. To display answers to commands from the NetController, a keyword called PRINT is used. An example of using PRINT to obtain an answer to a command would be to request the current date, type the following after the R> prompt and press the ENTER key: R> PRINT DATE Note: The date displayed is manually set at some point. If the date has not been set the answer will be incorrect. You can use the PRINT keyword to display the current value of the following predefined objects: DATE TOD (time of day) HOUR MINUTE SECOND The controller already defines each of the above. They are called system variables, because the controller system keeps track of their values. To display the time of day (TOD) enter this command line: PRINT TOD 18 Andover Controls Corporation

23 Using the PRINT Command (continued) To display the current hour, minute, or second, enter one of the following command lines: PRINT HOUR PRINT MINUTE PRINT SECOND To execute any previously typed command again, simply press the up arrow keys until the cursor lands on the command line you want to re-execute, then press the ENTER key. Setting the Date and Time Before you do anything else, you must set the date and time for your controller. (Later, when you set up other controllers, you can easily send them the same date and time. This way, you set the date and time only once.) Select Edit System Date & Time from the menu bar and press the ENTER key. The cursor is in the Date and Time text box. You enter both the date and time on that line. You can press the BACKSPACE/DELETE key to erase the date and time from the text box. The cursor should then be at the beginning of the box. You now enter the new date and time all in the same box. To delete only the time (the last few characters in the text box), arrow over to the first letter you want to remove and press the DELETE key. Characters to the right of the cursor erase. You can then type the new time. Note: More ways to move the cursor in this window and others are explained in the section called Making Changes Inside the Window, later in this chapter. You may enter the date using all numbers or spelling the month as either the full word or the three-letter abbreviation. You can separate the month, day, and year with spaces, slashes, dashes, periods, commas, or any combination of them. Setting the Day and Month If you enter , the controller automatically interprets it as March 2, 2003, rather than as February 3, However, to enter the day first you can do one of the following: Spell the month as a word (ex. 3-February-03). Use numbers for both month and day only if the day is greater than 12, since any number between 1 and 12 could be a month (ex becomes May 15, 2003.) Setting the Year You may enter the year as a two- or four-digit year. You may enter it before or after the day or month. Input Output 9 January 2003 January Mar March , July 6 July 6, Apr April /22/03 September Command Terminal Configuration Guide 19

24 Setting the Time You must keep hours, minutes, and seconds together when you enter the time, but you do not have to enter seconds. You can enter the time as 24-hour time or include AM or PM with the 12-hour time: Input Output 14:24:09 14:24:09 9:25 PM 21:25:00 10:30:22 AM 10:30:22 1:24:36 PM 13:24:36 You can enter AM or PM anywhere in the date-time. The controller translates 12-hour time into the 24-hour clock. For instance, 3:00 PM becomes 15:00:00. Sample Date and Time The following table shows you samples of how date and time are presented. Input Output 03, Aug 6 8:52:35 PM August 6, :52:35 9/22/03 6:6 PM September 22, :06:00 Completing the Date and Time To complete the date and time, perform the following steps: 1. Enter the complete date and time in the Date and Time text box. You must enter a complete and acceptable date and time before the controller lets you leave the Date and Time text box. 2. Press the TAB key to move to the OK button and press the ENTER key to execute the process. The date and time are stored in the controller s memory. The cursor returns to the menu bar. You can also press ENTER from the Date and Time text box at any time to save and close the window, just as you did in the User window. 3. Select Edit System Date & Time from the menu bar. Notice that the date and time have changed to the one you entered. The next section covers how to move around and erase/add text in the windows. 20 Andover Controls Corporation

25 Making Changes Inside the Window Below is how to make changes inside all the windows including the Open and Edit windows. Moving within the Text Box Press the LEFT ARROW key to move the cursor to the left within the text box without erasing the text. Press the RIGHT ARROW key to move the cursor to the right within the text box without erasing the text. Deleting Text Press the DELETE key once for each character to delete text in front of the cursor (to the right) one character at a time. Press the BACKSPACE key to delete text in back of the cursor (to the left) one character at a time. Inserting Text Press the INSERT key to insert additional characters in the text box without overwriting current ones. Saving Data When entering data in a window, you can save it by doing one of the following: Press the ENTER key. TAB over to the SAVE button and press the ENTER key. Press the F3 key. Exit Without Saving To exit the window without saving your data, perform any one of the following actions: TAB over to the CANCEL button and press the ENTER key. Press F4. Press the ESC button twice. Command Terminal Configuration Guide 21

26 Controller Window Features Descriptions of the text fields and buttons in the Controller window are provided in the following table. Field Name Description Serial Number Model Status Energy Net Id Probe Time Version Ethernet ID Description/Action Contains the name of the controller. The default name, which is INFINITYxxx, where xxx is the Energy Net ID of the controller. You can enter any name you wish in this field up to a maximum of 16 characters. Spaces between name segments are not permitted. Enter a description of the controller up to 32 characters in length (optional). After setup, this field automatically displays the serial number of the controller that is stamped on the internal PC board. You do not enter the serial number. After setup, this field automatically displays the controller model number. You do not enter the model number. Displays Offline or Online depending on whether or not the controller is communicating with the network. Identifies each controller by a unique number between 1 and 190 for the network. Each controller must have a unique ID on it s particular network. Displays the time in seconds between controller probes. Displays the version of the controller. If applicable, set to the ID number listed on the serial number tag found on the controller. Ethernet IDs consist of six groups of two hexadecimal digits: 00:40:11:8:BA:8C This unique number is made up of 00:40:11 plus the serial number encoded in Hex. 08BA8C = serial number Andover Controls Corporation

27 Controller Window Features (continued) Button Options Description/Action Displays the Controller Options screen. This screen identifies the various settings for your controller. Details Displays the Details screen. This screen displays what IOU Modules are installed in your system (Eclipse controllers only). Controls at the bottom of the window allow you to select alternate field bus protocols such as Lbus or LonMark. When neither of these items are selected, the default ACC_LON protocol (for normal Continuum I/O support) is active. For complete information on using Lbus protocol, refer to the section titled Configuring the Controller for Lbus found later in this manual. TCP/IP Make the appropriate entries and click SAVE or CANCEL as necessary. Refer to the following section for a description of this button. (See the Appendix for more detail about this selection) Command Terminal Configuration Guide 23

28 Controller Window Features (continued) Button SNMP Description/Action If this feature has been purchased, the SNMP button displays the SNMP Configuration form where you configure community strings, notification IP addresses, type and SNMP alarm parameters such as table size and alarm links. Important: This feature requires more configuration information than is appropriate for this document. For complete information on using this form, please refer to the Continuum SNMP Configuration Guide. This doument may be found on your Continuum CyberStation CD or on the Andover Controls website. Communities Configuration of the Get and Set community password strings. The Trap community string is read-only text. Notifications Configure up to two IP addresses that will receive SNMP alarms and their notification type (Trap or None). SNMP Alarms Configure SNMP Alarm Table Size, and SNMP Alarm Links. Save Cancel Delete Click SAVE or CANCEL as necessary. Save this session. Cancel this session. Delete the controller you are using. Click YES or NO as required. 24 Andover Controls Corporation

29 Controller Window Features (continued) Button View Teach Reset Description/Action View the controller command window of any of your system controllers. Distribute information about this controller to all other networked controllers. It also informs this controller about the other controllers on the network. Delete all user programs and points you are using. Click YES or NO as required. Command Terminal Configuration Guide 25

30 Setting up the Controller Commport When you create a controller using the CyberStation, it creates Commport objects for the controller automatically, but they may require configuration for use in the system. To set up the Controller Commports, perform the following steps: 1. At the main window, arrow over to select Edit. 2. Press ENTER or the arrow down key to display the Edit menu: 3. Arrow down and select Commports from the menu, then press ENTER or RETURN. The Open a Commport window displays. 4. At the Open a Commport window, type in the name of the Commport, OR follow these substeps: a. Press F2 to display a list of Commports, as shown in the figure below. b. Use the down arrow key to highlight the desired Commport. c. Press ENTER or RETURN to select the Commport name. 5. After entering or selecting the Commport name, press ENTER or RETURN to display the Commport configuration window: 26 Andover Controls Corporation

31 Setting up the Controller CommPort (continued) 6. Use the down arrow key to highlight the desired entry in the DefaultMode picklist. The modes are described in the following table: Mode Printer Window Command Infinet Lbus Autoset TankNet NotConfigured Xdriver LON Description For connecting a serial printer to a CommPort Use only with a VT100 or VT220 type terminal or terminal emulator to have the controller display windows and menus. When using a terminal to have the controller display the Command window rather than windows and menus. This selection is required for ASCII and teletype terminals and emulators. Command mode is often used with third-party front ends. Used to set up an Infinet port. This choice is valid only for Comm1 and Comm2. Used to communicate with one or more IOU boards on an Lbus. This choice is valid only for Comm1 and requires an LA-1 RS232 ro RS422 converter. Used to allow the port to switch automatically between window and command modes. In Autoset, the controller displays a blank screen with a blinking cursor. Type in Command or Window without pressing ENTER or RETURN to invoke the desired mode. Used to communicate with TankNet devices. Used to allow the port to be completely unused and to free up the memory required of any configuration. When using a customized external equipment driver. Used to allow the port to use the Lon Xdriver. Note: The following Commport configurations cannot be changed from the Command Terminal once they are configured. The only way to change them is to reset the controller: Infinet Lbus TankNet Xdriver Lon 7. After you highlight the desired default mode in the DefaultMode picklist, press the Space bar to select. After pressing the TAB key to move the cursor to the next field, the information to the right of this box displays information appropriate for the selected DefaultMode. Select the Save button and press the ENTER key. This will change the entries in the Commport configuration window to match the selected DefaultMode. See the next section for details. Command Terminal Configuration Guide 27

32 Selecting the Commport Configuration Default Mode Controller Commports can be configured to operate in a number of modes depending on the type of connection. The default mode selections are used in many systems. On CX series controllers for instance, Comm 2 is often set to Infinet mode to facilitate communication on the Infinet. Comm 3 is usually set to Autoset for communication with terminals, PCs with terminal emulation software and through modems. On CNCT controllers that you plan to use LBus with, you must use Comm 1 for LBus mode. The appearance of the Commport configuration window that displays depends on the Default Mode you select. The following sections show the windows that display, and explain how to use each. Configuring the Controller for Printer and TankNet Modes To configure the controller for Printer, Lbus and TankNet modes, perform the following actions at the Commport configuration window: 1. Enter an optional Description of the Commport of up to 32 characters. 2. Select a Baud (rate) to match the device you are connecting to: For TankNet, select Baud4800. For Printer, select the baud rate compatible with your printer. 3. Select Save and press the ENTER key. Note: The Mode field will display the commport mode currently saved in the controller. This field will not update to reflect a mode change until you SAVE. 28 Andover Controls Corporation

33 Configuring the Controller for Command, Window and Autoset Modes To configure the controller for Command, Window, and Autoset modes, perform the following actions at the Commport configuration window: 1. Select DirectConnect when the connected equipment is directly connected to the controller with less than 50 feet of RS232 cable. Do not select DirectConnect if you use a modem with the port. 2. Set the TerminalType to the type of the connected terminal or terminal emulator. The Wyse terminal type is not currently supported. 3. The CurrentUser is the user logged into the port. 4. Select Save to save all the settings. Configuring the Controller for Infinet Mode After you click the Save button with the Infinet DefaultMode selected, the Commport configuration window appears. Select LEARN to assign Infinet IDs to all Infinet controllers connected to this Commport. Command Terminal Configuration Guide 29

34 Configuring the controller for Infinet Mode (continued) A message displays saying the Learn process is active, then the View window displays the list of Infinet controllers connected to the Infinet: Infinet Controller Installation Tips In order for LEARN to work properly, observe the following during Infinet controller installation: 1. Make sure the Infinet controller is powered down before connection to the Infinet. 2. Apply power to the controller after Infinet connection. The exceptions to the above are the 780 series controllers. These controllers continue to operate on their backup batteries. To connect a 780 series: 1. Apply power to the controller before connecting the Infinet. 2. Press and hold the reset button while physically connecting to the Infinet. 3. Release the reset button. Simple Commissioning Commissioning the Infinet is simplest when none of the Infinet controllers have IDs or corresponding controller objects in the database. In the Infinet CommPort details window TAB over to the LEARN button and press Enter or Return to start the process. Learn can take several minutes. When the process is complete, TAB over to VIEW to see the newly commissioned Infinet controllers in the Infinet controller List View. Automatic Decommissioning If you add an Infinet controller to a network that already has a controller with the same Infinet ID, the new controller zeros out its own Infinet ID, effectively decommissioning itself. This makes it easy to commission the added controller using the LEARN function. The best way to ensure automatic decommissioning of Infinet controls is to use the powerdown connection sequence described above. If you add an Infinet controller to the Infinet without following the power down rule, the Infinet becomes unpredictable and unreliable. 30 Andover Controls Corporation

35 Replacing an Infinet Controller After removal of the unit to be replaced, follow this procedure: 1. Follow the power down connection procedure in Infinet Controller Installation Tips above. 2. Access the controller configuration window. 3. Change the serial number to the serial number of the new controller. Save the changes. 4. Reload the controller after Infinity commissions it. The Learn Process Learn assigns a unique Infinet ID number to each Infinet controller, based on its factoryassigned serial number. These numbers determine the order in which information passing occurs through the network. When you run Learn for a new Infinet, the controller reads the factory-assigned serial number on each Infinet controller on the Infinet. Running Learn either assigns the number specified in the database, if one exists. (The information in the database takes precedence over that on the network.); or assigns the next available Infinet ID to the controller. The process takes approximately 2 seconds per controller at 19.2 K baud. When you add an Infinet controller to Infinet, the Learn process looks for an existing Infinet ID number (a previously unused controller has an ID number of 0). That is, when a controller powers up, it listens to learn if any Infinet controller has the same ID. If a duplicate ID exists, the controller sets its own ID to zero. If a unique ID exists for the communications port, the controller uses the ID. If no ID exists, or an existing ID is not unique, Learn assigns the next available ID number. Changing the Name of a Learned Infinet Controller Once the Infinet controllers have been learned, you can access the editors for the Infinet controllers. To change the name of a learned Infinet controller, perform the following steps: 1. Navigate to the main menu screen. 2. Select Edit Infinet Controllers, and press Enter or Return: Command Terminal Configuration Guide 31

36 Changing the Name of a Learned Infinet Controller (continued) The Open an Infinet Controller window displays in the main window: 3. In the Name field, type in the name of the Infinet Controller, or press F2 to display a list of choices, and select the choice for the newly Learned Infinet Controller: The default naming convention is lc_sssssss_p where s = serial #, P = port. 4. Press Enter (or Return) twice to display the Infinet Controller configuration window. Use the arrow keys to put the cursor in the Name field, and then delete the entry and type in an applicable name. TAB or arrow over to the Save option and press Enter. 5. The new name will now be reflected next to the NetController name in the path on the main Command Window. NetController New InfinetController Name 32 Andover Controls Corporation

37 Configuring the Controller for Xdrivers For the following procedure to complete successfully, the Controller must be Xdriver enabled. After you Save with the Xdriver DefaultMode selected, the Commport configuration window appears with a Details button, shown here: Selecting Details displays the Xdriver details window. XdriverStatus XdriverError XdriverErrTime XdriverErrCount Shows whether an Xdriver is installed and operating. Shows the last Xdriver error. Shows the time of the last Xdriver error. Shows the number of Xdriver errors that have occurred, up to 255. You can clear this field by selecting the error number and typing in 0. Select Save to save and close the current window or select Cancel to close the window without saving. Command Terminal Configuration Guide 33

38 Configuring the Controller for LBus The NetController can only use one type of I/O system (LBus, ACC LON or LONMark). Enabling the NetController to use LBus I/O disables Continuum I/O module (i.e., UI-8, DO-4, AC-1, etc.) operation. To configure the NetController for LBus, perform the following procedure. Note: The physical connection between the NetController and the LBus requires an adapter such as the LA-1. Refer to the NetController Reference manual for more information. 1. Navigate to the Controller Details configuration screen Enable this control 2. Select and enable the control marked: Use L-BUS IO Instead of ACC_LON 3. Save the Configuration by selecting Exit, then selecting Save. 4. If you are using CyberStation, skip to step 5. If you are not using CyberStation, proceed as follows: a. Log onto the command terminal b. Open COMM1 and change the DefaultMode to LBus c. TAB over to SAVE and press the ENTER key to save the changes. Note: At this point, COMM1 of the NetController is properly configured for LBus. Do not perform step 5 unless you are using CyberStation. 34 Andover Controls Corporation

39 Configuring the Controller for LBus (continued) 5. If you are using CyberStation, proceed as follows: a. Disconnect the command terminal b. Reboot the NetController and log onto the command terminal c. Place the CyberStation into offline-edit mode and configure the COMM1 object in the NetController to Lbus. Make sure the baud rate of COMM1 matches that of the LBus device. d. Return the CyberStation to online-edit mode and reload the controller. Note: If there are programs resident in the NetController that you do not wish to reload, follow the alternate procedure described in the Andover Controls Tech Bulletin #953. e. Verify that the Lbus I/O driver has been successfully installed by opening the controller object (from the CyberStation). Select the Options window and see that it lists the Lbus as the selected I/O method. Command Terminal Configuration Guide 35

40 Creating and Configuring Points Inputs, outputs, numerics, strings and datetimes are called points in the system. These five types of points are described in the table below. Point Types Input Description Input points are the actual connection points your controller or sub-controller uses to monitor your facility. Input point objects exist on any controller that has physical inputs. Output Output points are the actual connection points your controller or sub-controller uses to control your facility. Output point objects exist on any controller that has physical outputs. Note: Workstations and some other Andover Controls controllers contain points that are not physical I/O points (such as Input and Output points), but instead contain virtual points stored within the memory of the controller, such as Numeric, DateTime, and String points, described as follows: Numeric DateTime String Numeric points are storage locations within the memory of the controller where numeric information may be temporarily stored for use during control. This includes the values ON, OFF and ON. A typical example of the use of a Numeric point would be to store a temperature setpoint. Another example would be to use a Numeric point to indicate whether a building is occupied: ON indicates occupied, OFF signals that the building is empty. DateTime points are storage locations where date and time information is stored for use during control. These points are used in schedules and to record TimeStamps such as FanStartTime. String points are storage locations where plain text messages can be stored. This can include logical paths to physical devices such as printers, or simply as a message to an operator that is displayed when a setpoint is reached. Point Names The name given to a point can be a maximum of 16 alphanumeric characters, and must start with a letter. Letters can be upper- or lower-case. You can also use period (.) and underscore (_) characters, but no spaces or hyphens are allowed. Make sure the name you choose is not a reserved keyword used in Plain English programs. 36 Andover Controls Corporation

41 Creating an Input Point To create an Input point, or edit an existing point, perform the following steps: Note: When creating a new point, make sure the displayed Path field shows the correct controller. If you opened the Create Object window from the correct controller on the Object Tree, then Path will be correct in the Create Object window. 1. Use the Connect command to connect to the device where you'll be defining the Input point. Select Points from the Edit menu and press Enter or Return. The Open a Point window displays: 2. Every object in the system must be named. Enter the name of the controller, the Infinet controller, and the point name. (Press F2 in any of these boxes to view a list of existing controllers or points.) Command Terminal Configuration Guide 37

42 Creating an Input Point (continued) 3. After typing in the point name, press Enter or Return. The Point configuration window displays: 4. Select Input from the Type field. Select Enabled or Disabled from the State field. Note: When an input point is enabled, the controller reads the value from the environment and sets the point value. When a point is disabled, the controller does not set its value. You may need to disable a point when testing or repairing the system. Also, when a point is disabled you can set its value manually in the Value text box in this window or from the command line. 5. Enter an optional Value in the field to the right of the equal sign after the name. Value is the reading of the sensor (Input) reported or the value set by the controller. Value is initially set to NotSet. When the controller is running, extremely high or low input values displayed here often indicate a fault with the sensor or the wiring. The controller reports new input values only when the actual value has changed by the threshold amount. The threshold is set later in the configuration process. 6. Enter an optional Units description (to the right of the Value field) with a maximum of 12 characters, including spaces. For example, Deg. F, or CFM. The double quotation mark is not allowed. 7. Set the Channel Number. Input and Output points are hardware points. These points must have a device or sensor connected to one of the terminal connections on the controller. The numbered position on the controller s terminal block is called the channel number. Refer to the controller hardware to select the Channel. Type in the number of the point as marked on the controller. For Input and Output points you must enter a channel value. 38 Andover Controls Corporation

43 Creating an Input Point (continued) 8. Enter an Electrical Type for the type of input sensor attached to the input or press F2 to display a list of available electrical types shown below: Arrow down to the desired input type and press Enter or Return. Input types are: Input Types * Voltage (if the input is a voltage or current sensor) Counter (for a pulse counting input) Digital ACC Temp (in either Fahrenheit or Celsius for Andover Controls thermistor type temperature sensors, and for the EMX 170/SP 100 temperature sensor modules) Supervised RTD Temp (in either Fahrenheit or Celsius) for Andover Controls 1K RTD resistive type temperature sensors) Description The controller always gives a voltage reading for this type of sensor, so you have to enter a conversion for current types. The counter triggers on the falling edge of the input waveform. This is an ON or OFF contact closure. This input type performs the conversion from voltage to temperature. Supervised inputs are normally part of the door object, so you do not have to set them up as Input points unless you want to use them in programs or associate them with alarms. When you select Supervised, you must make additional settings in the window that displays when you choose Details. These settings are described in the section, Setting Details for a Supervised Input Point. These sensors must be wired to two consecutive input points where the first channel number is an odd. Assign the odd number as the channel. This input type automatically performs the conversion from resistance to temperature. *Controllers and other devices support a variety of input types. Consult your product documentation to determine which of these types it supports. 9. Select one of the following: Details or Details1 to continue the configuration Save to save the point object under its current name Save as to save the point object under a new name Command Terminal Configuration Guide 39

44 Setting Details for an Input Point If you selected Details in the point configuration window, the following window displays: 1. Enter an optional Description of up to 32 characters. The description appears in the input point list view along with the name. 2. Enter a Display Format for the point. The display format determines how the point s value displays in places like the active alarm view list, or a program or command line print statement. The default display format for voltage inputs shows three decimal places to the left and right of the decimal point. If the value has more digits before the decimal point than the display format shows, the full value displays. If the value has less digits, the leading zeros are suppressed. The maximum display format is 12 characters, including the decimal point. As above, use the $### display format for digital points (the default) to make the value print as ON (for values greater than or less than zero) and OFF (equal to zero). 3. For Digital Input points, you can select Invert On/Off to invert the meanings of On and Off. (This changes the point s Polarity attribute.) 4. The controller sets the Exported attribute if the point s value is used in a program or report on another controller. The point is also exported if it is used as an alarm reference point or access control schedule point on another controller or the point itself has an alarm attached. 40 Andover Controls Corporation

45 Setting Details for an Input Point (continued) 5. If the units do not automatically convert from electrical to engineering units (the way that the controller converts thermistor values into degrees), use this box for the conversion expression. Even if the units do automatically convert, you can use this box to limit or bias the converted value. You also use this box for any non-linear conversions. When using the conversion box do not type in value = : this part of the expression is implied. See the section Typical Conversions near the end of this chapter. For point types that allow linear conversion, like Voltage, the Auto Conversion grid appears. Enter the bottom and top of scale values for both engineering units and electrical units. The engineering units are the left boxes, while the electrical units, volts in this case, are the right boxes. Conversions take precedence over auto conversions, but the input limiting function of the auto conversion grid still takes effect. 6. Enter the Threshold value, the amount of change in engineering units that must occur before the point updates and triggers an attached alarm or a program. For example, for a temperature point you could set the threshold to 1 to have the point update every time the temperature changes a whole degree. Set the threshold to.1 to have the point update every tenth of a degree. Note: Logs and Triggers will be described in detail later in this chapter. Command Terminal Configuration Guide 41

46 Creating an Output Point To create an output point, or edit an existing point, perform the following steps: Note: When creating a new point, make sure the displayed Path field shows the correct controller. If you opened the Create Object window from the correct controller on the Object Tree, then Path will be correct in the Create Object window. 1. Use the Connect command to connect to the device where you ll be defining the Output point. Select Points from the Edit menu and press ENTER or RETURN. The Open a Point window displays: 2. Every object in the system must be named. Enter the name of the controller, the Infinet controller, and the point name. (Press F2 in any of these boxes to view a list of existing controllers or points.) 3. After typing in the point name, press ENTER or RETURN. The Point configuration window displays: 42 Andover Controls Corporation

47 Creating an Output Point (continued) 4. Select Output from the Type field. Select Enabled or Disabled from the State field. 5. From the State field, select Enabled or Disabled as required. 6. From the Electrical Type field, select the appropriate electrical type as listed below: Output Types * Voltage Digital Current Tristate ACC_Pneumatic ReaderDoor Action/Description Select if the output is a voltage type. Select if the point requires Form A or Form C output. Digital outputs set equipment either ON or OFF. In access control, some outputs can be set as both Door and Digital. See the controller installation guide for more information. Select if the output is a current type. Select if the output is a tristate type (ON, OFF, ON). Select for pneumatic outputs. Pneumatic is applicable only if the controller is an Infinet controller and the point is on an EMX 140 or POM 200 expansion module. If you have an EMX 141 or an EMX 143 or a POM module with only one output, you must skip a channel for the missing one. ReaderDoor applies only if the controller is an Infinet controller other than a 700 series and the point is a door with a card reader, either on an EMX 190 or a CRM 100 module. HiResVoltage HiResCurrent PanelMaster HiResVoltage applies if the controller is an Infinet controller and the point is a voltage output on an EMX 151 or an AOM 500. HiResCurrent applies if the controller is an Infinet controller and the point is a current output on an EMX 151 or an AOM 500. PanelMaster applies when you are setting up an output point for an LS-8 sevensegment display board IOU Module. This type allows a Plain English program to assign a numeric value to the display without doing a string conversion. NotSet This is the default setting. It indicates the need to set the electrical type before saving the point. *Controllers and other devices support a variety of input types. Consult your product documentation to determine which of these types it supports. 7. Tab to Details and press Enter or Return. Depending on the Electrical Type of the point, one of the following Details windows appears: Electrical Type Voltage, Current, ACC_Pneumatic, HiResVoltage, HiResCurrent, PanelMeter Command Terminal Configuration Guide 43

48 Creating an Output Point (continued) Electrical Type Digital TriState For Digital Input points, you can select Invert On/Off to invert the meanings of On and Off. (This changes the point s Polarity attribute.) 8. Enter an optional Description (up to 32 characters) of the point. This description appears in the point list view along with the name. If you need to convert electrical units to engineering units you enter a Conversion. For point types that allow linear conversion, like voltage, the Auto Conversion grid appears. 9. Enter the bottom and top of scale values for both engineering units and electrical units. The engineering units are the left boxes, while the electrical units, volts in this case, are the right boxes. Conversion takes precedence over auto conversions. However, the input limiting function of the auto conversion grid still takes effect. 10. Tab to Save and press ENTER or RETURN to save and close the Details window. Tab to Save in the initial window, then press ENTER or RETURN to create the point. 44 Andover Controls Corporation

49 Creating a String Point 1. Choose the Points item from the Edit menu. The Open a Point window displays, with the cursor flashing in the Name field. Type in a name for your point (String1 used here in this example) and press the ENTER key: 2. The Point configuration window displays. Notice that the window has additional entries: The Type field now has a String choice. An Iou Number field appears before the Channel Number field. A Details1 button follows the Details button. Choose the Type of point (String is the example used here) and fill out the other entries. Command Terminal Configuration Guide 45

50 Creating a String Point 3. Select the Details1 button to display the Details1 window: This window only pertains to Xdriver points. 4. Enter the port number information, then a series of Save commands to save and close all the windows that create the point. 46 Andover Controls Corporation

51 Using Numerics, Strings and DateTime Points as Setpoints You can define Numerics, Strings and DateTime points as setpoints by selecting the SetPoint check box in the Details window. (The checkpoint does not appear for Input or Output points.) Once the setpoint attribute is ON, the controller will dump the current value and the values of any manual array elements when a Save command is issued. If the setpoint attribute is OFF then the value of the object will not be restored on a reload. Setting String Size of a String Point For String points, you can set the length of the string in the String Size text box. The software automatically sets it to 132 characters. You can change it to the number of characters you want in the string. This can save valuable controller memory. Command Terminal Configuration Guide 47

52 Setting Up Point Logs You may want the controller to periodically (example: every hour) store information based on a point's value. To do this, you use logs. Logs are parts of points that automatically record and store the readings from the environment. Logs adjust for daylight savings time changes. Logs adjust for any time corrections. Visualizing Logs When you create a log, the controller allocates memory for it. An easy way to visualize the memory is to picture a single column of a spreadsheet like the Logged Data column in the following figure. Logs can be used for Input, Output, Numeric, String, or DateTime points. The example used here is for an Input point. The value of n is the number of entries in the log window Number Entry Logged Data !!!!!! n 78.2 Old entries drop off the end of the log Latest entry recorded 48 Andover Controls Corporation

53 Displaying Log Entries In a log on a point SupplyAir, you can access the last (most recent) value recorded by retrieving the value from the first position: PRINT SupplyAir[1] The above statement prints 76.3, the value held in the first position in the sample log. The second to the last value recorded is in the second position: PRINT SupplyAir[2] The above statement prints The third to the last value is in the third position, the fourth in the fourth position, etc. Setting up Automatic Point Logs To configure an automatic point log in the Log Configuration Window, perform the following steps: 1. Open the point that the automatic log will be based on (example shown below), and select DETAILS. Command Terminal Configuration Guide 49

54 Setting up Automatic Point Logs (continued) 2. The DETAILS screen appears. Select LOGS to bring up the configuration screen. Field Number of Entries Description/Action Set to the number of entries (elements) in the log. 50 Andover Controls Corporation

55 Setting up Automatic Point Logs (continued) Field Log Type Entry Type Description/Action, continued Automatic The control system automatically logs the data every Interval, with the most current information in log element 1. All other entries are pushed down one element (2 becomes 3, 3 becomes 4, and so on). The control system maintains only as many entries as specified in Number of Entries field, so the oldest information drops off the bottom of the log. Automatic log entries are stored in the controller that contains the point. You must also set the Interval field. Manual Manual Array logs are not set by the control system, you set them from the Command line, a report, or in a Plain English program. (You can learn more about arrays in the Plain English Programming courses.) LogInstantaneous When you set the Entry Type to LogInstantaneous, the control system stores the current value of this point at the beginning of every interval. The control system stores the new value in the [0] log element and moves the entry that WAS originally there to the [1] element, and moves the entry that was there originally to the [2] element, and so on throughout the entire log. LogAverage When you set the Entry Type to LogAverage, the control system calculates the average over every interval, using a weighted average algorithm. At the end of each interval, the control system stores the average for the interval. LogMinimum When you set the Entry Type to LogMinimum, the control system compares all values over an interval and finds the minimum value. At the end of every interval the control system stores the minimum value that occurred during that interval. LogMaximum When you set the Entry Type to LogMaximum, the control system compares all values over an interval and finds the maximum value. At the end of each interval the control system stores the maximum value that occurred during the interval. Command Terminal Configuration Guide 51

56 Setting up Automatic Point Logs (continued) Field Interval Description/Action, continued The Interval determines how often the control system stores data in an automatic log. Interval times are added: Interval = Days + Hours + Minutes + Seconds For example, if your needed interval is every 90 minutes, set Hours = 1 and Minutes = 30. If the interval is shorter than the scan rate, logging still occurs at every interval. The maximum values for the Interval components are: Component Maximum Days 365 Hours 23 Minutes 59 Seconds 59 To create a log that updates only when the point value changes, set the Interval to 0. You learn more about these "semi-automatic" logs in the Plain English Programming Student Guide. In order to have a log of point values that occur at the same point in the hour (every quarter hour, or half hour, for example), the Interval you use for the log should be evenly divisible into one hour. If you choose 17 minutes as your log interval, the log time points for the first hour are at 17, 34, and 51 minutes past the hour. The log time points for the second hour are at 8, 25, 42 and 59 minutes past the hour and so on. 3. Select SAVE, then SAVE again to save the changes made. 52 Andover Controls Corporation

57 Saving and Reloading Controllers Information on controllers can be saved to and loaded from ASCII text files which can be archived onto removable media. Saving and reloading controllers provides a method of recovering lost controller configuration and programming. Saving and Reloading Concerns When using the Command Terminal interface, it is important to keep in mind that there may be two databases on a project. One database resides in the physical memory of the controller itself and the other resides on the Continuum file server (MSDE or SQL). It is always critical to keep these two databases synchronized. If a project that includes a file server, a CyberStation workstation and also uses the Command Terminal interface to change configuration out at the site, then frequent saves to database should be accomplished. (See the Continuum Configuration guide for information on saving to the database.) When saving a controller, remember that the source will always overwrite the target. If you have made changes via the Command Terminal interface and you accomplish a "save to the database", then the controller information in the Continuum database will be replaced by what was in the controller. However, if someone accomplishes a "Reload to Controller" before a save is made, then the changes made from the Command Terminal interface will be lost and the controller information will be reloaded with what was in the Continuum database. Command Terminal Configuration Guide 53

58 Saving Controllers from a Command Terminal The save operation dumps the data as ASCII text to your terminal window. You must set up your terminal or terminal emulator application (i.e., HyperTerminal) to capture the information as it is received so that you can save it as an ASCII file on your PC. This file would then be used to reload the controller as necessary. Saving a Single Object or Controller To save a single object or controller, perform the following steps. 1. At the command terminal main screen, press F4 to access the command window R> prompt. 2. To enable the save feature, type save all and press Enter or Return. The screen displays the following: The system allows you 60 seconds from this point to enable your terminal emulator or terminal to capture the file being saved. (Most emulators have the ability to save data transferred to a file.) 54 Andover Controls Corporation

59 Saving a Single Object or Controller (continued) 3. After enabling the capture or save feature, press any key. The controller shown, Floor1, is an Ethernet controller. The SAVE ALL command saves every item in the connected controller. During the save, the controller information scrolls across the screen as it is saved to the file. Saving Multiple Controllers You can save multiple Infinet controllers by using one of the following save options in the command window: SAVE list Saves the items specified. Replace list with the name(s) of the object(s) to save. SAVE ENERGYNET Saves all objects from all controllers connected to the EnergyNet. SAVE INFINET Saves the connected controller and all Infinet controllers connected to it. SAVE SITE Saves all controllers in the site. SAVE ALARM Saves CyberStation alarm objects. This is needed if alarms are involved. Otherwise, all alarms are lost on a reload. Note: Refer to the Plain English Language Reference under SAVE for more information. Command Terminal Configuration Guide 55

60 Reloading Controllers from a Command Terminal To reload from a command terminal, you must have a file from a recent SAVE. Note: Reloading using a command terminal does not reset the controller, and does not set the date and time. Reset the controller to ensure that what's in your database is the only thing on the controller. For a NetController, reset it, and then set the date and time. 1. At the command terminal main screen, press F4 to access the command window R> prompt. 2. To enable the reload feature, type reload o m, then press Enter or Return. The o option overwrites existing objects, and m sends error messages to the message window of the controller to which you are physically connected. The screen displays the following: The system now allows you 60 seconds to enable your terminal emulator or terminal to reload the file. (Most emulators have the ability to reload data transferred to a file.) 3. After enabling the upload feature, press any key. During the reload, the controller information being restored passes across the screen. 56 Andover Controls Corporation

61 Using the Program Editors This section shows how to use the program editors on the command terminal. Creating a Program File To create a program file, perform the following steps: 1. From the main menu screen, select Edit, then Files and press the ENTER key. 2. Type in a name for the program file and press the ENTER key. Command Terminal Configuration Guide 57

62 Creating a Program File (continued) 3. This will take you to the program configuration screen. The configuration screen has the following features: Feature Filename Type State FlowType Autostart Command Line Save Cancel Delete Details Description The name of the current file. The type of file: Program Plain English Program file Function Plain English Function file Displays the current state of the file, either Enabled or Disabled. For Programs, you can select Looping or FallThru For Programs, check this box to start automatically. Uncheck this box to require the program to be manually executed. For programs, check this box to allow the program to be executed from the Command Line. To save the program. To cancel the creation of this program. To delete this program. To display further details about the file (shown on next page) 58 Andover Controls Corporation

63 Creating a Program File (continued) 4. The Details window shows you additional information about the program such as: The default comm port When the program was last changed The current program line The date & time stamp marking when the current program line started The file size (in bytes) The status of the program (active or inactive) Once you have saved the file configuration, the editor appears where you can write your Plain English code. Command Terminal Configuration Guide 59

64 Entering Text from the Command Terminal Enter your Plain English program text by typing it in the program editor as shown: Program Editor Menu Bar The Command Terminal Edit Menu To use the command terminal Edit menu features, follow the procedure below. Feature Cut Copy Paste Clear Select Description Cuts the highlighted text to the clipboard Copies the highlighted text to the clipboard Pastes text from the clipboard to the cursor location Clears highlighted text without saving it to the clipboard (Use with caution you cannot retrieve Cleared text) Selects the starting point for Cut, Copy, and Clear commands 1. Place the cursor at either end of the selection to be edited. 2. Choose Select from the Edit Menu. Cut Copy Paste Clear Select 3. Move the cursor to the other end of the selection to be edited and select one of the other options from the Edit menu. 60 Andover Controls Corporation

65 Finding and Changing Text from a Command Terminal To use the terminal interface search and replace features select the Search menu: Feature Find Find Next Replace Next Error Previous Error Description Opens the Find box to begin a search. Finds the next occurrence of the previous search criteria. Opens the Replace box to begin a search and replace operation. Finds the next program syntax error. Finds the previous program syntax error. Using the Program Editor Tools Select the Tools from the program editor menu. Each selection from the Program Editor menu is shown below. Tools - Point Summary Displays a list containing brief information for each configured point. In the window, the column labeled I represents IOU number and the one labeled C represents the Channel. Command Terminal Configuration Guide 61

66 Tools - File Summary Displays a list of the current status of each file. Light_Manager Tools - Program Summary Displays a list of the current status of each program. LIGHT_ON The Current Line displays the name or number of the line that is executing at this moment. Usually the current line is labeled so that it is meaningful to you. Elapsed time displays the time it takes to run the current line from the beginning: TD Time in days that has elapsed. TH Time in hours that has elapsed. TM Time in minutes that has elapsed. TS Time in seconds that has elapsed. In the figure above, 191 seconds have elapsed. State displays both the state and the status of the program. The first letter is the state, either E for enabled or D for disabled. If it is disabled, the current line is not shown. The second letter is the status, A for active or I for inactive. 62 Andover Controls Corporation

67 Tools - System Variable Summary Displays a list of the current value and status of each system variable. Tools - Edit a Point Brings up the Open a Point window allowing you to actually edit the configuration of the point. Note: To see a list of existing points, press F2. Tools - Edit a System Variable Allows you to edit those System Variables that are available to be edited. Command Terminal Configuration Guide 63

68 Tools - Command Window Splits the screen into two windows, with the Command Window displayed above the Program Editor window. Tools - Messages Displays messages collected in the Message Window. Using Keystrokes in the Program Editor The following sections show the keys and key combinations to use for editing text in the program editor. 64 Andover Controls Corporation

69 Moving the Cursor Refer to the following table for ways to move the cursor. Key or Keys Arrow CTRL right arrow CTRL left arrow Home End CTRL Home CTRL End PgUp PgDn Description Moves the cursor one space in the direction of the arrow left, right, up, or down. Moves the cursor to the beginning of next word. Moves the cursor to the beginning of the previous word. Moves the cursor to the beginning of the line it is on. Moves the cursor to the end of the line it is on. Moves the cursor to the beginning of the first line in file. Moves the cursor to the end of the last line in file. Scrolls the text up the number of lines in a window. Scrolls the text down the number of lines in a window. Selecting Text Refer to the following table for ways to select text. Key or Keys Shift arrow Shift Home Shift End Shift CTRL right arrow Shift CTRL left arrow Shift CTRL Home Shift CTRL End Description Selects text one character at a time in the direction of the arrow. Selects text from the cursor position to the beginning of the line. Selects text from the cursor position to the end of the line. Selects text from the cursor position to the beginning of the next word. Selects text from the cursor position to the beginning of the previous word. Selects text from the cursor position to the beginning of the file. Selects text from the cursor position to the end of the file. Changing and Moving Text Refer to the following table for ways to change and move text. Key or Keys Backspace CTRL F CTRL Ins DELETE ENTER Insert Shift Del Shift Ins Description Deletes text you have selected. Otherwise, deletes one character to left of the cursor. If the cursor is at the beginning of a line, joins the line with the previous one. Opens the Find & Replace window. Copies selected text and stores the text in a temporary storage area. You can then put it somewhere else with Shift Ins. Deletes text you have selected. Otherwise, deletes one character to the right of the cursor. If the cursor is at the end of a line, connects the line to the next one. Ends a line and starts a new one. Toggles between two modes: Inserting text into current text. Typing over current text. Cuts selected text and stores it in a temporary storage area. You can then paste it with Shift Ins. Puts or pastes text you last copied or cut at the cursor position in the file. Replaces any selected text with text you last cut or copied from the file. Command Terminal Configuration Guide 65

70 Entering and Manipulating Text with Terminal Keystrokes Some keystrokes require two key presses, like ESC i or CTRL+B. There is an important difference between these key sequences. ESC i requires you to press and release the ESC key, then press and release the i key. CTRL+B, on the other hand, requires that you press and hold the control key while pressing the B key. Note that the escape sequences are case sensitive, that is, E is different than e. The following table lists the named terminal interface keystrokes with their ASCII terminal equivalents. The left-hand column uses the terms found elsewhere in this guide. If you are using a terminal emulator consult the documentation to find how the emulator maps the terminal s keys to the keyboard you are using. Terminal Keystrokes Key Name VT100 Keys VT220 Keys Arrow Keys Arrow Keys Arrow Keys Backspace Backspace Backspace Begin ESC U ESC U Bottom Screen ESC 9 F9 Cancel Window PF4 PF4 Delete Line/Text ESC 6 F6 Delete Text Delete Remove Delete to Right ESC 7 F7 Delete Word PF2 PF2 END ESC e Select Execute Return Enter Insert Line ESC 5 ESC 5 Insert Text ESC i Insert Here Left Side ESC h Find Mark Block CTRL+B CTRL+B Menu Bar ESC ESC ESC ESC Next Attribute Tab Tab Next Word CTRL+R CTRL+R Page Down CTRL+D Next Screen Page Up CTRL+U Prev Screen Previous Attribute ESC Tab ESC Tab Previous Word CTRL+L CTRL+L Quick Button PF1 PF1 Quick Command PF3 PF3 Refresh CTRL+Z CTRL+Z Restore Text ESC 5 ESC 5 Right Side ESC E Select Save PF3 PF3 Show List PF2 PF2 Top Screen ESC 8 F8 66 Andover Controls Corporation

71 Navigating the Menu Bar Use the following keys to navigate the menu bar. Key Arrow Keys Cancel Window Execute Left Side Menu Bar Page Down Page Up Right Side Save Description Move the cursor up and down the menu selections. Return the cursor to the window bar. Open the menu or activate the menu selection. Move the cursor to the leftmost menu selection. Return the cursor to the menu bar. Move the cursor down to the next menu selection. Move the cursor up to the next menu selection. Move the cursor to the rightmost menu selection. Return the cursor to the menu bar. Working in the Configuration Window When you make a selection from the Edit menu, you will open a configuration window. Use the following keys while working in a configuration window. Key Arrow Keys Backspace Cancel Window Delete Line/Text Delete Text Delete to Right Execute Insert Text Left Side Menu Bar Next Attribute Previous Attribute Restore Text Right Side Save Description Move the cursor to the left and right in text, or up and down a list. Erases the single character before the cursor (erases backward). Closes the window without saving any changes, and then returns the cursor to the menu bar. Erases all text in the box where the cursor is. Erases the single character after the cursor (erases forward). Deletes all text to the right of the cursor. Saves all attributes. Execute saves if not on a button that directs another action. Inserts text where the cursor is. Move the cursor to the left side of the text box. Closes the window without saving any changes, and then returns the cursor to the menu bar. Moves the cursor forward one attribute. Moves the cursor back one attribute. Returns text in a box to what it was before the last change. Move the cursor to the right side of the text box. Saves all attributes. Command Terminal Configuration Guide 67

72 Show List Keystrokes When you open a list of choices with the Show List command, use the following keys to work in the list. Key Arrow Keys Cancel Window Execute Menu Bar Page Down Page Up Save Description Move the cursor up and down the choice list selections. Return the cursor to the window bar. Select the highlighted name from the choice list. Return the cursor to the menu bar. Move the cursor down to the next choice list selection. Move the cursor up to the next choice list selection. Return the cursor to the menu bar. File Editor Keystrokes Use the following keys while using the file editor. Key Arrow Keys Backspace Begin Bottom Screen Cancel Window Delete Line Delete Text Delete to Right Execute Insert Line Insert Text Left Side Mark Block Next Word Page Up Page Down Previous Word Right Side Top Screen Description Move the cursor anywhere on the screen. Erases the single character before the cursor (erases backward). Moves the cursor to the top of the file. Moves the cursor to the bottom of the visible screen. Switches the cursor from the editor to the menu bar and back. Deletes the line where the cursor is. Erases the single character after the cursor (erases forward). Deletes all text to the right of the cursor through the end of the line. Ends a line of text and moves the cursor to the beginning of the next line. Inserts a blank line below the one the cursor is on. Inserts text where the cursor is. Move the cursor to the left side of the line. Marks the beginning of a text block. Next move the cursor to the end of the desired block and make a selection from the edit menu. Moves the cursor to the right one word. Moves the cursor up to the previous screen. Moves the cursor down to the next screen. Moves the cursor to the left one word. Move the cursor to the right side of the current line. Moves the cursor to the top of the visible screen. 68 Andover Controls Corporation

73 Appendix Commissioning the Controller Command Terminal Configuration Guide 69

74 70 Andover Controls Corporation

75 Commissioning the Controller To prepare the NetController for operation on a Continuum network, the controller s network address information must be entered so the Continuum workstation can communicate with the controller and so the controller itself can view other network objects. This operation is called commissioning. Setting the NetController Ethernet Address Information To set NetController Ethernet address information, perform the following procedure. 1. Select Edit from the Menu Bar. Using the arrow keys, move the curser down to highlight Controllers and press Enter. Command Terminal Configuration Guide 71

76 Setting the NetController Ethernet Address Information (continued) 2. After the Open a Controller window appears, an un-commissioned controller is pre-named INFINITYxxx, where xxx is the Energy Net ID of the controller.. Press Enter to continue. 3. The Ethernet setup form contains all the address information. Enter the requested information supplied by your Network Administrator. 72 Andover Controls Corporation

77 Setting the NetController Ethernet Address Information (continued) Descriptions of the fields in this window are provided in the following table. Field Name Description Serial Number Model Status Energy Net Id Probe Time Version Ethernet ID Description/Action Contains the name of the controller. The default name, which is INFINITYxxx, where xxx is the Energy Net ID of the controller. You can enter any name you wish in this field up to a maximum of 16 characters. Spaces between name segments are not permitted. Enter a description of the controller up to 32 characters in length. (optional) After setup, this field automatically displays the serial number of the controller. You do not enter the serial number. After setup, this field automatically displays the controller model number. You do not enter the model number. Displays Offline or Online depending on whether or not the controller is communicating with the network. Identifies each controller by a unique number between 1 and 190 for the network. Each controller must have a unique ID. Displays the time in seconds between controller probes. Displays the version of the controller. If applicable, set to the ID number listed on the serial number tag found on the controller. Ethernet IDs consist of six groups of two hexadecimal digits: 00:40:11:8:BA:8C This unique number is made up of 00:40:11 plus the serial number encoded in Hex. 08BA8C = serial number Note: After you change the name in the Name field, it will change the name within the Controller window once you move out of that field. However, it will not change the name within the Command Window until you tab over to SAVE and press ENTER. New name entered in the Name field. Previous name in Name field. Command Terminal Configuration Guide 73

78 Setting the NetController Ethernet Address Information (continued) 4. After the information is entered, select the TCP/IP button and press Enter. (Descriptions of the rest of the buttons are listed in the next section.) Enter the appropriate information when the TCP/IP window appears. Use the arrow keys or press TAB to move around in the window. Field Accept or enter the IP Address Internet Address of the controller. Subnet Mask Subnet Address of the controller. Default Router Router ID number on your LAN. PPP IP Address Point-to-Point Protocol Address of the controller. Web Server Port Web server port number (defaults to 80). Max Response Time Number of seconds the system is to wait for a response to a command before it is determined that communications are lost. Note: When the Send ACC Modem Initialization String Upon Reset is set, the following default command strings are sent to initialize the ACC modem: AT&F\015 ATE\015 ATV&C1&D2&S1S0=1\\N3\\A3%%E1%%C1X3&W\ After entering the particulars, press the TAB key until the SAVE or CANCEL button as required and press Enter. 6. Back at the main form, TAB to the Save button and press Enter. You must reset the controller before the saved changes take effect. Commissioning is now complete from the controller end. If you intend to use a CyberStation workstation, you will still have to create a new controller object and fill in many of these numbers at the workstation to complete the process. 74 Andover Controls Corporation

79 Command Terminal Configuration Guide

80 Command Terminal Configuration Guide