Escolar Documentos
Profissional Documentos
Cultura Documentos
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: 30-3001-843 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 01810 (978) 470-0555 fax: (978) 470-0946
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 ........................................................................................................ 12 Connecting to a Controller .......................................................................................... 13 Logging Off ................................................................................................................ 14 Advanced Command Terminal Usage ........................................................................ 15 Using the Command Window ..................................................................................... 18 PRINT Command Line ............................................................................................... 18 Setting the Date and Time.......................................................................................... 19 Making Changes Inside the Window........................................................................... 21 Controller Window Features ....................................................................................... 22 Setting up the Controller CommPort ........................................................................... 26 NetController LBus Configuration ............................................................................... 34 Creating and Configuring Points ................................................................................. 36 Setting Up Point Logs................................................................................................. 48 Saving and Reloading Controllers............................................................................... 53 Using the Program Editors.......................................................................................... 57 Appendix Commissioning the Controller
iii
iv
Chapter 1
Basic Command Terminal Usage
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
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 Terminals Serial or Commport. Connections made through a modem are straightforward; however, refer to the modem manufacturers guidelines before making the connection. Direct connection requires an RS232 Null Modem cable as shown below.
The default operating state of the NetControllers 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 NetControllers 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
HyperTerminal Setup
The following is an example procedure for communicating with the NetControllers 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.
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
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.
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:
Menu Bar
Status Bar
Menu Bar
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.
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
Menu Reference
The descriptions for each of the selections in the menu bar are as follows: View Edit Connect Logout Displays information about inputs, outputs, programs, controllers, etc. 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.
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
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
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
Chapter 2
Advanced Command Terminal Usage
16
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
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.
20
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.
TAB over to the CANCEL button and press the ENTER key. Press F4. Press the ESC button twice.
Field Name
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 its 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 572044
Description Serial Number Model Status Energy Net Id Probe Time Version Ethernet ID
22
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)
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. Click SAVE or CANCEL as necessary. Save Cancel Delete Save this session. Cancel this session. Delete the controller you are using. Click YES or NO as required.
24
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
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.
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
3. The CurrentUser is the user logged into the port. 4. Select Save to save all the settings.
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
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. 2. Navigate to the main menu screen. Select EditInfinet Controllers, and press Enter or Return:
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
32
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.
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
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
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 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.
DateTime
String
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
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.)
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 controllers 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
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 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.
RTD Temp (in either Fahrenheit or Celsius) for Andover Controls 1K RTD resistive type temperature sensors)
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
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 points 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 points Polarity attribute.) 4. The controller sets the Exported attribute if the points 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
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.
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
ReaderDoor
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. NotSet
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
For Digital Input points, you can select Invert On/Off to invert the meanings of On and Off. (This changes the points Polarity attribute.) TriState
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
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.
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
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.
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.
Number Entry 1 2 3 ! ! ! n
48
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 78.1. 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.
Description/Action
50
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.
52
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
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 SAVE ENERGYNET SAVE INFINET SAVE SITE SAVE ALARM Saves the items specified. Replace list with the name(s) of the object(s) to save. Saves all objects from all controllers connected to the EnergyNet. Saves the connected controller and all Infinet controllers connected to it. Saves all controllers in the site. 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.
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
2. Type in a name for the program file and press the ENTER key.
58
Once you have saved the file configuration, the editor appears where you can write your Plain English code.
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
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.
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.
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: TDTime in days that has elapsed. THTime in hours that has elapsed. TMTime in minutes that has elapsed. TSTime 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
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.
Tools - Command Window Splits the screen into two windows, with the Command Window displayed above the Program Editor 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
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 arrowleft, 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 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. Shift Del Shift Ins 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.
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 terminals keys to the keyboard you are using.
Terminal Keystrokes Key Name Arrow Keys Backspace Begin Bottom Screen Cancel Window Delete Line/Text Delete Text Delete to Right Delete Word END Execute Insert Line Insert Text Left Side Mark Block Menu Bar Next Attribute Next Word Page Down Page Up Previous Attribute Previous Word Quick Button Quick Command Refresh Restore Text Right Side Save Show List Top Screen VT100 Keys Arrow Keys Backspace ESC U ESC 9 PF4 ESC 6 Delete ESC 7 PF2 ESC e Return ESC 5 ESC i ESC h CTRL+B ESC ESC Tab CTRL+R CTRL+D CTRL+U ESC Tab CTRL+L PF1 PF3 CTRL+Z ESC 5 ESC E PF3 PF2 ESC 8 VT220 Keys Arrow Keys Backspace ESC U F9 PF4 F6 Remove F7 PF2 Select Enter ESC 5 Insert Here Find CTRL+B ESC ESC Tab CTRL+R Next Screen Prev Screen ESC Tab CTRL+L PF1 PF3 CTRL+Z ESC 5 Select PF3 PF2 F8
66
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.
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
Appendix
Commissioning the Controller
70
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
Setting the NetController Ethernet Address Information (continued) Descriptions of the fields in this window are provided in the following table.
Field Name 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 572044
Description Serial Number Model Status Energy Net Id Probe Time Version Ethernet ID
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.
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 IP Address Subnet Mask Default Router PPP IP Address Web Server Port Max Response Time
Accept or enter the Internet Address of the controller. Subnet Address of the controller. Router ID number on your LAN. Point-to-Point Protocol Address of the controller. Web server port number (defaults to 80). 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\015
5. 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
30-3001-843