EIKON® v6.

0
User Manual

1150 Roberts Boulevard, Kennesaw, Georgia 30144

770-429-3000 Fax 770-429-3001 | www.automatedlogic.com

Rev. 5/5/2015
ALC Proprietary & Confidential • All rights reserved
This document does not contain technical data controlled by the EAR or ITAR.
 Verify that you have the most current version of this document. Go to
https://accounts.automatedlogic.com, then select Support > Download > Documents > Software
Documents.
Important changes are listed in Document revision history at the end of this document.

© 2015 Automated Logic Corporation. All rights reserved throughout the world.
The contents of this guide and the associated Automated Logic software are property of Automated Logic
Corporation and its respective licensors, and are protected by copyright. For more information on the
software and licensing, see the About section in the software's Help menu.
Automated Logic, WebCTRL, EIKON, Eco-Screen, and BACview are registered trademarks of Automated Logic
Corporation. EnergyReports and Environmental Index are trademarks of Automated Logic Corporation.
BACnet is a registered trademark of ASHRAE. All other trademarks are the property of their respective
owners.
The content of this guide is furnished for informational use only and is subject to change without notice.
Automated Logic Corporation assumes no responsibility or liability for any errors or inaccuracies that may
appear in the informational content contained in this guide.
Contents
What is the EIKON® application? ............................................................................................................. 1
What's new in the EIKON® v6.0 application .............................................................................................. 2
Getting to know the EIKON® workspace .................................................................................................... 3
Determining the control program type ....................................................................................................... 4
Normal for all controllers except U line, ZN line, or PSM ................................................................ 4
UNI for U line controllers .............................................................................................................. 5
ZN for ZN line controllers ............................................................................................................. 6
PSM controllers........................................................................................................................... 7
Developing the logic ................................................................................................................................ 7
To begin a control program .......................................................................................................... 7
To place microblocks ................................................................................................................... 8
To draw wires and labels .............................................................................................................. 9
To view errors ............................................................................................................................ 10
To add text ................................................................................................................................ 10
To add lines and shapes ............................................................................................................ 11
To add an image ........................................................................................................................ 12
To create a custom microblock .................................................................................................. 13
Preparing logic for the WebCTRL® interface ............................................................................................ 14
Formatting Properties pages ...................................................................................................... 14
To reorder items on the Properties page ...................................................................... 14
To use the Text microblock to format text ..................................................................... 15
Editing Properties page text using special characters .................................................. 17
Formatting a microblock property ............................................................................... 18
To use custom alarm and schedule categories............................................................................ 22
Simulating a control program ................................................................................................................. 23
EIKON® productivity tools ..................................................................................................................... 24
To create and use symbols ......................................................................................................... 24
To view or edit microblock common properties ........................................................................... 25
To find a microblock or label ...................................................................................................... 26
To find identical labels .............................................................................................................. 26
To show a logical path ............................................................................................................... 26
To show a wire's source microblock ........................................................................................... 26
Defining display options for ZS sensors ................................................................................................... 27
To set the order of information displayed on a sensor ................................................................. 27
To create custom Rnet tags ........................................................................................................ 27
Omitting _# in BACnet object names in SiteBuilder .................................................................................. 28
To select properties for ViewBuilder graphics ........................................................................................... 28
Miscellaneous EIKON® menu commands and features ............................................................................ 29
Working with control programs created in the EIKON® for WebCTRL application ......................................... 31
Working with control programs for non-English systems ............................................................................ 32
Creating control programs and translation files for a non-English system .................................... 32
To enter a key term in the EIKON® application ............................................................ 32
Translation files.......................................................................................................... 33
To create and implement a translation file................................................................... 33
Editing translation files, control programs, or graphics for a non-English system ......................... 34
To edit a bundled resource.......................................................................................... 35
Editing an EIKON® for WebCTRL control program in the EIKON® application .............. 35
Copying translation files to another system ................................................................. 35
Document revision history ...................................................................................................................... 36
Index ................................................................................................................................................... 37
What is the EIKON® application?
Use the EIKON® application to create control programs to control equipment, from single pieces of
equipment to complex energy management functions.
You build control programs using individual blocks of programming code called microblocks. You
determine the properties for each microblock and connect the microblocks with graphical wires to
create a sequence of operation.
A control program is assigned to a piece of equipment in the SiteBuilder application, then the
WebCTRL® application downloads it into the controller that will directly control and monitor the
equipment. You can change editable properties and view non-editable properties of control programs in
the WebCTRL® interface.

The typical procedure for creating a control program includes the following steps:
1 Determine the control program type (page 4).
2 Develop the logic (page 7).
3 Format Properties pages (page 14).
4 Simulate the control program (page 23).

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
1
What's new in the EIKON® v6.0 application

Feature Improvement
PSM Adds a new equipment classification to support the PSM (Plant System
Manager) controller. This classification provides additional microblocks
not previously supported in EIKON®.
Name change EIKON® LogicBuilder is now just EIKON®.
COV trending setup in the COV can now be set at design time in microblocks and in the Microblock
EIKON® application Common Properties Editor.
Trend historian notification Historian notification thresholds can now be set at design time in
setup in the EIKON® microblocks with trend objects and in the Edit Common Properties
application dialog box.
Revised ZN rules (page 6) Most of the previous ZN rules have been eliminated.
Microblock Common To improve this feature's performance, selecting a point in this window
Properties Editor (page 25) no longer automatically selects the microblock in the control program.
You now select the point and then choose the Select Microblock on
Canvas option to locate the microblock.
Updates The Help > Apply Update menu now lets you update all drivers, graphic
libraries, and Help in addition to patches and service packs.
Help You no longer have to specify a web browser to view Help. Help now
opens in your default browser.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
2
Getting to know the EIKON® workspace

TIPS
• If the Property Editor is not visible, double-click an object in the workspace.
• You can use the Property Editor as a free-standing window, or you can select Options > Dock
Property Editor to dock it in the EIKON® workspace.
• Keyboard shortcuts are shown beside their corresponding commands in the menus.
• Press Ctrl + an arrow key to nudge selected objects. Press Shift+Ctrl while using the arrow keys to
increase the size of the nudge.
• Click to undo 1 action, or click the drop-down arrow next to it to undo multiple actions at one
time. Click or its drop-down arrow to redo actions. The number of actions you can undo or
redo depends on the size of your computer's memory.
• The workspace size has no limit.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
3
 • Press Home to position the upper left corner of the workspace in the upper left corner of the
window.
• Press End to jump to the bottom of the control program.
• Use the arrow keys or your mouse's scroll wheel to scroll through the workspace.
• From the Options menu you can:
○ Hide or show the workspace grid
○ Enable Snap Figures and Text to Grid to constrain movement to 8 pixels for quick alignment;
disable this feature for 1-pixel movement
○ Zoom the view to 50, 100, or 200%

Determining the control program type

Before you create a control program, first determine the control program type (Normal, UNI, ZN, or
PSM), and then follow the appropriate rules below.

Normal for all controllers except U line, ZN line, or PSM

• Make sure a control program broadcasts a single color by using one of the following:
○ 1 Setpoint microblock
○ 1 Set Color microblock
○ 1 or more Set Color If True microblocks
• Each Time Clock microblock in a control program must have a unique schedule category.
• To use one or more ZS Sensors, the control program must have one Sensor Binder microblock and
one BACnet Analog Sensed Value microblock for each value type, such as temperature or
humidity, that will be read from the sensor network.
• To use an RS sensor, the control program must have an RS Zone Sensor microblock.
• To use a basic LogiStat or LogiStat Plus sensor with an SE line controller, the control program
must have a LogiStat Zone Sensor microblock or an RS Zone Sensor microblock

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
4
UNI for U line controllers

Required microblocks Microblocks not supported

• BACnet Time Clock • Pulse to Analog • BACnet Setpoint
• Zone Setpoint with a direct • Setpoint Optimization • BACnet Time Clock with TLO and
input named ZONE TEMP • Set Color or Set Color Override Status
from one of the following if True
microblocks: The following are not supported if
• Dewpoint Temp Calculator
○ BACnet Analog Input the microblock's Rnet functionality
○ LogiStat Zone Sensor • Wet Bulb Temp Calculator is enabled:
(ExecB) • Toggle • BACnet Binary Value Parameter
• Lead/Standby • BACnet Analog Value Parameter
• Integrator • BACnet Multi-State Value
• RS Zone Sensor Parameter
• RS Zone Sensor with Fan • BACnet Binary Value Status
Control • BACnet Analog Value Status
• Sensor Binder • BACnet Multi-State Value Status
• BACnet Analog Sensed
Value
• BACnet Binary Sensed
Value

NOTES
• Each Time Clock microblock in a control program must have a unique schedule category.
• The setpoint microblock's cooling setpoint must be wired to a PID Direct Acting microblock.
• The setpoint microblock's heating setpoint must be wired to a PID Reverse Acting microblock.
• Set time delay functions and trend intervals to at least 1 minute because U line controllers do not
support time-critical applications.
• To use a LogiStat sensor, the control program must have a LogiStat Zone Sensor microblock.
NOTE The U220 does not support any LogiStat sensor.
• For the actuator in a v+ controller to be protected by the controller warranty, the control program
must contain the following microblocks:
○ Zone Controller
○ U-line Airflow Control
• The U220 is designed to handle miscellaneous pieces of equipment such as exhaust fans and
room lighting. In many cases, these applications will not meet the unitary control criteria required
to enable the UNI option. You may use any of the standard U220 zone control programs in the
EquipmentBuilder Library.
• You can download ZN control programs into a UNI. If your control program does not meet UNI rules,
try saving it as a ZN control program.
• If your control program does not meet UNI or ZN rules but is appropriate for a zone control
application, you can get the control program tagged by Automated Logic®. Review Automated
Logic®'s tagging policy
(http://accounts.automatedlogic.com/sales/policy.nsf/7efc5bb11196e87185256b3c00785ad2
/eaffdfa1ccd769d88525735b004e7864!OpenDocument) on the accounts.automatedlogic.com
website, then follow the instructions under "How do I get a control program tagged?".

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
5
ZN for ZN line controllers
ZN controllers are designed for zone-level comfort control applications. They are not designed for air
handlers, central plants, or other applications that do not control the temperature in a single area. ZN
controllers can also be used for miscellaneous monitoring and on/off control applications in or near a
building’s zones, such as controlling toilet exhaust fans or monitoring a cooler. The ZN220 is
specifically designed for these miscellaneous applications, and a library of ZN220 control programs is
included in EquipmentBuilder.
NOTES
• Each Time Clock microblock in a control program must have a unique schedule category.
• To indicate an alarm condition in a zone (for example, to turn the zone coral due to an equipment
failure) you may use 1 Set Color if True microblock in addition to a Setpoint microblock. When true,
the Set Color if True microblock determines the equipment color but does not overwrite the
Setpoint microblock's color output.
• To use one or more ZS Sensors, the control program must have one Sensor Binder microblock and
one BACnet Analog Sensed Value microblock for each value type, such as temperature or
humidity, that will be read from the sensor network.
• To use an RS sensor, the control program must have an RS Zone Sensor microblock.
• To use a basic LogiStat or LogiStat Plus sensor, the control program must have a LogiStat Zone
Sensor microblock or an RS Zone Sensor microblock.
NOTE The ZN220 does not support any LogiStat sensor. Other ZN's do not support the LogiStat
Pro.
• A ZN control program can have a maximum of 400 microblocks (excluding labels, text, and status
microblocks).
• For the actuator in a v+ controller to be protected by the controller warranty, the control program
must contain the following microblocks:
○ Zone Controller
○ Airflow Control
• Tagging:
○ A control program that does not meet the above ZN criteria but is appropriate for a zone
control or miscellaneous monitoring application can be tagged by Automated Logic® as a ZN
control program.
○ Only tagged OCL microblocks can be used in a ZN control program. Get a tagged OCL
microblock from http://accounts.automatedlogic.com (http://accounts.automatedlogic.com).
Select Engineering > StdAppLibrary > Standard Application Library > WebCTRL > ZN551 &
ZN253 Zone Applications & OCL Microblocks. Or, get Automated Logic® to tag your own OCL
microblock.
○ Each microblock inside an untagged custom microblock counts against the ZN
400-microblock limit. However, a tagged custom microblock counts as only 1 microblock. You
can use tagged custom microblocks available in some applications in EquipmentBuilder. Or,
get Automated Logic® to tag your own custom microblock.
○ To get a control program, OCL microblock, or custom microblock tagged, review Automated
Logic®'s tagging policy
(http://accounts.automatedlogic.com/sales/policy.nsf/7efc5bb11196e87185256b3c00785
ad2/eaffdfa1ccd769d88525735b004e7864!OpenDocument) on the
accounts.automatedlogic.com website, then follow the instructions under "How do I get a
control program tagged?".
○ Tagging a control program locks it. If you need to edit a tagged control program, open the it in
EIKON®, then select Control Program > Unlock Control Program. After making edits, you will
need to get the control program tagged again.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
6
PSM controllers
The provides full and advanced chiller plant management using an EquipmentBuilder library of
validated algorithms and optimization strategies. You can apply the algorithms as designed or
customize them in the EIKON® application. You can alsointegrate the with third partyequipment
using open protocols.
NOTE A PSM control program from EquipmentBuilder may contain custom microblocks that are locked
and cannot be edited. These blue microblocks are outlined in red with a line drawn through them.

Developing the logic

Use the following procedures to develop your control program.

To begin a control program

The EIKON® application creates a .equipment file that is the control program that you download into a
controller.
1 In the application, select 1 of the following in the Control Program menu. See Determining the
control program type (page 4) for more information.
○ Normal for downloading into ME, M, SE, S, and LGR line controllers or an Equipment Portal
○ UNI for downloading into UNI controllers
○ ZN for downloading into ZN line controllers or a Room Controller
○ PSM for downloading into a PSM controller
2 Select File > Save As.
3 Browse to the WebCTRLx.x\webroot\<system_name>\programs folder.
4 Name the .equipment file. The name must:
○ Begin with a letter.
○ Not contain spaces or periods.
○ Be unique throughout a WebCTRL® system.
5 Click Save.

NOTES
• For a Normal, UNI, or PSM control program, you can select Control Program > Suppress Logic
Page so that it cannot be seen in the WebCTRL® interface.
• Select File > Info to view the file's name, location and dates. You can also select a Custom Icon
that the WebCTRL® navigation tree will show for the equipment.
• To use °C for setpoint microblocks, select Control Program > Metric. If you change the Metric
option for an existing control program, you must delete and reinsert all setpoint microblocks.
To enable Metric for all future control programs, select Options > Preferences, then check Create
new control programs as metric.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
7
To place microblocks
1 Right-click the microblock palette.

2 Click the icon of the microblock you want to use.

3 Move the cursor into the workspace.
NOTE Press and hold Shift if you want to place 2 or more of the selected microblock.
4 Click to place the microblock.
5 Edit the microblock's properties in the Property Editor.
NOTES
○ If the Property Editor is not open, double-click the microblock.
○ Red text in a field indicates an invalid value.
○ You can right-click some properties and select Make Editable or Make Read-Only to
determine that property's functionality in the WebCTRL® interface.

TIPS
• Place all input microblocks on the left side of the workspace and all output microblocks on the
right.
• Arrange microblocks so that logic flows from left to right and the sequence of operation can be
easily followed.
• Hold Ctrl as you move a microblock to detach it from its wire.
• Use the Microblock Common Properties Editor (page 25) to view, compare, and edit common
properties of I/O microblocks.
• The order of items on a WebCTRL® Properties page is determined by the order in which
microblocks are placed when developing the control program in the EIKON® application. To
change the order, see To reorder items on the Properties page (page 14).

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
8
To draw wires and labels
Wires are special lines in a control program that transmit values from one microblock to another. Solid
wires transmit analog data; dashed wires transmit binary data. Wires connect microblock inputs and
outputs. They can also connect to other wires.
Output and input labels connect items just as wires do. Use labels when a value is needed in several
places within a control program or when wires would clutter or complicate the control program.

To draw wires
1 Hold your cursor over a microblock nib until the cursor changes to crosshairs, then click and drag
in the direction you want the wire to go.
NOTE A wire automatically makes a 90° turn if you drag away from a straight line. To create
additional 90° turns, right-click while continuing to hold down the left mouse button.
2 Release the left mouse button to end the wire.
NOTES
○ The red error indicator at the microblock's nib disappears if the wire connected properly.
○ When drawing wires between closely placed microblocks, you can temporarily disable the
snap-to feature by pressing Ctrl while drawing a wire.

To change an existing wire

NOTE If you move a microblock, connected wires move with it.
1 Right-click the wire, then select Edit Shape.
2 Do one of the following:
○ Click and drag any wire segment in the direction of the move icon.
○ Right-click where you want to add a joint on a wire, then select Add Joint.
○ Right-click a green wire joint, then select Remove Joint.
○ Click a wire, then select a different wire from the Type drop-down list.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
9
 To add labels
1 Select the Label tool.

2 Move the cursor to the nib of a microblock or to the end of a wire, then click the workspace.

TIP To quickly change the label's direction, press I (for Input label) or O (for Output label) while
moving the label.
3 Type a name in the Label Text field of the Property Editor.
NOTE If the Property Editor is not open, double-click the label.
4 Optional: Change the Direction of the label in the Property Editor.

To change a label's text

1 Select the label.
NOTE To locate the label, see To find a microblock or label (page 26).
2 Edit the Label Text field.
NOTE If the Property Editor is not open, double-click the label.
3 Optional: Click Rename all labels named '__' to change all labels that have the same label text.

To view errors
The EIKON® application checks for errors as you build your control program and indicates errors with
red dots, wires, and boxes.
1 Click in the lower right corner or select Control Program > Errors on the menu bar to view the
errors.
2 Click an error in the list to highlight its location in the workspace.

NOTE You cannot download a program that has errors.

To add text
Use the Text tool to add descriptive text to the control program.
1 Select the Text tool.

2 Click in the workspace where you want the text to begin.

3 Edit the text and its properties in the Property Editor. See table below.
NOTE If the Property Editor is not open, double-click the text.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
10
 Field Notes
Text Type the comment you want to add to the control program.
Font Select a font. Be sure that all system computers have the font installed.
Size Choose a point size from the drop-down list.
Style Check Bold, Italics, or both.
Foreground Click the color swatch to select the color of the text.
Transparent Check to remove the background color and pattern.
Background
Background Click the color swatch to select the color of the box behind the text.

NOTE To change the default settings for all text that you will add to the control program, select Options
> Palette. Change the settings on the Font tab.

To arrange text blocks

1 Select 1 or more text blocks.
2 Right-click one of the text blocks, then select 1 of the following:
○ Bring Forward
○ Bring to Front
○ Send Backward
○ Send to Back

To add lines and shapes

Use lines and shapes to organize and clarify the control program.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
11
 To draw a line or polygon
1 Select the line or polygon tool.
NOTE To draw multiple similar figures, press and hold Shift as you draw them.
2 To begin drawing the figure in the workspace, click and hold the left mouse button as you move
the mouse.
3 While holding down the left mouse button, right-click to add angles.
4 Release the left mouse button to complete the line or polygon.

NOTE To change the shape of an existing figure, right-click the figure, then select Edit Shape. Click and
drag a green point to move it.

To draw a rectangle or ellipse

1 Select the rectangle or circle tool.
NOTE To draw multiple similar figures, press and hold Shift as you draw them.
2 Click and drag in the workspace to begin drawing the figure.
3 Release the mouse to complete the rectangle or ellipse.

NOTE Hold Ctrl while you drag to draw a square or a circle.

To change the color or pattern of figures

To change:
• The color or pattern of a selected figure, click the appropriate rectangle in the Property Editor, and
then make your selection. If the Property Editor is not open, double-click the figure.
NOTE Select the red cross-hatch pattern for no fill.
• The color or pattern of multiple selected figures, select Options > Palette.
NOTE Select the red cross-hatch pattern for no fill.
• The default color or pattern for all figures that you will draw, select Options > Palette.

To arrange figures
1 Select 1 or more figures.
2 Right-click 1 of the figures, then select 1 of the following:
○ Bring Forward
○ Bring to Front
○ Send Backward
○ Send to Back

To add an image
Select Edit > Insert Image to add a .gif, .png, .jpg, or .bmp image to your control program.
NOTE Your image must be created with a standard 256 color palette. Anything greater will be reduced
to 256 colors and may not display correctly in WebCTRL®.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
12
To create a custom microblock
If you want simple, easy-to-troubleshoot Logic pages, put complicated calculations in a custom
microblock.
NOTES
• You cannot view or change a custom microblock's logic in the WebCTRL® interface.
• You can put custom microblocks inside other custom microblocks.

To create a custom microblock

1 Select Custom Microblocks > Add New Custom Microblock.
2 Right-click the custom microblock, then select Step Inside Custom Microblock.
3 In the custom microblock window, place custom I/O microblocks to create nibs on the custom
microblock.
NOTE The order of the microblocks in the custom microblock window determines the location of
the nibs on the custom microblock.
4 Place other microblocks, wires, and labels to create the custom microblock's logic.
5 To return to the main workspace, click Control Program at the top of the custom microblock
window.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
13
Preparing logic for the WebCTRL® interface

Formatting Properties pages

Making a control program automatically creates a WebCTRL® Properties page. The initial properties
displayed on a Properties > Control Program tab are defined in the EIKON® Property Editor.
To preview Properties pages in the WebCTRL® interface without connecting to the controllers, run
WebCTRL Design Server instead of WebCTRL Server.

In the EIKON®, you can use a Text microblock or edit a microblock's Property Page Text field in the
Property Editor to change the way text appears on the Properties page.

NOTE If you change a control program after downloading it to the controller, you must:
1 Save the .equipment file.
2 Reload the control program. See "Working with control programs" in WebCTRL® Help.
3 Download the control program. See "Downloading to controllers" in WebCTRL® Help.

To reorder items on the Properties page

1 Select Reorder > Edit Order.
2 Select the microblock(s) you want to move. Ctrl+click or Shift+click to select and move multiple
microblocks.
3 Use the buttons at the right to move, cut, or paste microblocks.
4 Click OK.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
14
 NOTES
• To find a single microblock in the Edit Order dialog box, do one of the following:
○ Right-click the microblock in the workspace, then select Show in Edit Order.
○ In the Edit Order dialog box, click .

• To edit a microblock's Property Page Text from the Edit Order dialog box, do one of the following:
○ Double-click the microblock.

○ Select it and then click .

To use the Text microblock to format text

The Text microblock allows you to format text, add horizontal lines, and arrange items on the
Properties page. Text microblocks placed in a control program in the EIKON® application are not
visible on the WebCTRL® Logic page.
1 Place a Text microblock in the workspace to the right of the microblock logic.
2 In the Property Editor, select a format option from the Type drop-down list. See table below.
NOTE If the Property Editor is not open, double-click the microblock.
3 Type text in the Property Page Text field.

Text Type Notes

Plain For creating plain text.
Separator To create a horizontal line on the Properties page, often used to offset or
group information, choose Separator as the Text Type. If you would like text
to appear on the separator line, type the text in the Property Page Text
field.
Bold For creating bold text.
Expand Begin Closed To format a section using expanded formatting, first insert a Text
Expand Begin Opened microblock with the Text Type set as Expand Begin Closed or Expand Begin
Opened, depending on how you want the area to display when first viewed.
Expand End
If you would like text to appear on your expandable line, type the text in the
Property Page Text field.

You must also insert a Text microblock with the Text Type set as Expand
End at the end of the section you wish to group together.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
15
 Text Type Notes
Table Begin To align data in a table, insert a Text microblock with the Text Type set as
Table End Table Begin. To complete the table, insert a Text microblock with the Text
Type set as Table End after the last item you want to include in the table.

NOTE When working with a table within an expanded section, make sure
the table begins after the Expand Begin and ends before the Expand End.
Conditional Hide Begin You can hide part of the Properties page based on a value from a specific
Conditional Hide End microblock. For example, you can specify that the Properties page text from
an Analog Input microblock will only appear on the Properties page if the
value is above 85. The expression is evaluated relative to the entire control
program, not at that particular microblock.
Place a Text microblock with the Text Type set as Conditional Hide Begin
before the microblock to be evaluated and another set to Conditional Hide
End after it. Type a conditional expression in the Properties Page Text field
of the Text microblock. Microblock properties may be referenced between
the dollar signs ($), and the expression must be Boolean. For example, to
show the microblock Properties page text only when the present value of
the point named Zone Temp is greater than 85, the expression would be
"$Zone_Temp/present_value$ >85".
NOTES
• When referring to the name of a point, use the RefName rather than the
Display Name.
• Technical Support does not provide assistance with writing and editing
Javascript. See Javascript textbooks, available in most bookstores, for
help with Javascript.

TIP If you are adding the Conditional Hide formatting after the control
program has been designed or would prefer to group all of the Text
microblocks within the control program, use the Reorder menu to correctly
place the Text microblocks.
Important Begin These options are currently not used.
Important End

To correctly order Begin/End Text microblocks

When adding Text microblocks in the EIKON® application that have a Begin or End text type, you must
define the correct order for the microblocks so that the text appears correctly on a Properties page. Each
Begin microblock must be followed by an End microblock, and you can have a set of Begin/End
microblocks inside of another set of Begin/End microblocks. The initial order of the Properties page text
is the order in which you add microblocks to the workspace. Moving the microblocks will not correct the
Properties page order. If the microblocks are outlined in yellow, your Begin/End micro- blocks are out of
order. In the example below, the order of the first and fourth microblocks are reversed.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
16
 To correct the order, you can either change the microblocks' Type selection in the Property Editor, or
select Reorder > Edit Order. See To reorder items on the Properties page (page 14).

Editing Properties page text using special characters

For many microblocks, you can edit or format Properties page text in the microblock's Property Page
Text field using special characters described below.

To... In the Property Page Text field, Example

type...
Display The microblock property between The value is $Present_Value$
a microblock 2 dollar signs Displays:
property See Microblock Reference Help The value is 69.
for property reference names.
See Formatting a microblock
property (page 18).
Make a { to begin a table, then } to end {[|History Recorder: |Current cycle =
column-aligned the table |$Current/Latched_Value$| on
table |$Current/Latched_Time$|$Current/
[ to begin a row, then ]^$ to Latched_Date$
end a row. |since|$Current/Reset_Time$|$Current/
Reset_Date$]^$
Exception: Type ] to end last row
in table.
[||Previous cycle =
|$Previous/Latched_Value$| on
| (a pipe) to align cells |$Previous/Latched_Time$|$Previous/
Latched_Date$
|since|$Previous/Reset_Time$|$Previous/
Reset_Date$]}
Displays:

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
17
To... In the Property Page Text field, Example
type...
Hide default text ^## if Property Page Text field is
empty.
If the Property Page Text field
shows the default text, delete
the text.
Display two ^$ at the end of the text for the MB#1: Enable when Supply Temp is more
microblock first microblock than $Constant$ (F) ^$
properties on the MB#2: Disable when $Hyst$ (F) below Zone
same line Temp.
Displays:

Begin a new line of ^\ where you want a new line to Time for daily trend report:^\ ___ hh:mm
text begin 24 hr
Displays:
Time for daily trend report:
02:00 hh:mm 24 hr
Bold text !{text!} !{NOTE!} Must be enabled for...
Displays:
NOTE Must be enabled for...
Make a line of text ^( at the beginning of the text
not wrap in the and ^) at the end
action pane
Display one of the \x, where x is the character you Do not change \!
following want to display Displays:
characters:
Do not change!
^\${}[]|!

Formatting a microblock property

To add a microblock property in a microblock's Properties Page Text field, type the property between 2
dollar signs. For example, $current_Value$. This is called an expression.
Each microblock property has default formatting that determines how it looks on the Properties page.
You can change the way it looks by adding a control and one or more parameters to the expression.
EXAMPLES
• To display the present value of Duty cycle in a time format that shows minutes and seconds, type
$Present_Value:control=”minsec”$
• To display the Period microblock property in a time format that shows minutes and seconds and
make it editable, type $Period:control="minsec" editable="true"$.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
18
 Breakdown of an expression

The entire expression is between 2 dollar signs.

A microblock property Example: Period

A colon
Type a colon after the microblock property to add a control.

control=
A control determines how a property is displayed on the Properties page. Include a control= statement
in the expression only if you want to use a control other than the default. Type control=, followed by
the control name .

A control Example: "minsec"

Type the control between quotation marks. See table below.

A space
Type a space after a control statement or a parameter statement.

A parameter Example: editable=

You can add one or more parameters to the expression. To specify a control, type the name of the
parameter (see table below), an equal sign, and then a value .

A parameter value Example: "true"

See table below.

Controls and parameters

A microblock property data type determines the type of control that can be used.

To display a... Data must be..

Control Parameter Parameter value
Checkbox Boolean button type WidgetImageButton.TOGGLE
Example: A binary
parameter's present editable true or false
value (Default value is true.)
truewhendown true or false
Check mark appears when (Default value is true.)
the value is false instead of
true.

Radio button Boolean button type WidgetImageButton.RADIO

Example: A binary
parameter's present editable true or false
(Default value is true.)

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
19
To display a... Data must be..
Control Parameter Parameter value
value truewhendown true or false
or Button is selected when the (Default value is true.)
value is false instead of
Integer true.
Example: An analog
parameter's present index any integer
value For integer or enumerated (Default value is null.)
values, index is the number
or of the state the radio
button is to represent.
Enumerated
Example: A binary,
analog, or multi-state
parameter's present
value

Text Character string charstring editable true or false

Example: A point's (Default value is true.)
display name

Date Date date editable true or false

Example: A wire lock's (Default value is true.)
begin date/end date
hasdayofweek true or false
Displays the day of the (Default value is true.)
week with the date.

Number Integer number editable true or false

(no decimal) (Default value is true.)
Example: An analog
parameter's present digits_right_of_decimal number of digits
value (real number only) (Default value is null.)
or digits_left_of_decimal number of digits
(Default value is null.)
Real
showplussign true or false
(has decimal)
(Default value is false.)
Example: An analog
parameter's present scalingfactor any floating point number
value Multiplies the actual value except 0
or by the scalingfactor value. (Default value is 1.)
Example, to convert watts
Unsigned to kilowatts, use .001 as
Example: Any point's the scaling factor value.
expander number

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
20
To display a... Data must be..
Control Parameter Parameter value
Droplist Enumerated droplist editable true or false
Example: A binary, (Default value is true.)
analog, or multi-state
parameter's present
value

Time Time time editable true or false

Example: A wire lock's (Default value is true.)
begin time/end time
displaywhat One of the following:
ControlTimeInput.HMSD
ControlTimeInput.HMS
ControlTimeInput.MSD
ControlTimeInput.HM
ControlTimeInput.SD
ControlTimeInput.MS
ControlTimeInput.H
ControlTimeInput.M
ControlTimeInput.S
ControlTimeInput.D
where H=hour, M=minutes,
S=seconds, D=milliseconds
(Default value is
ControlTimeInput. HMSD.)

Timer Unsigned numbers minsec editable true or false

used as a timer (Default value is true.)
Example: A duty
cycle's time scalingfactor any floating point number
Multiplies the actual value except 0
by the scalingfactor value. (Default value is 1.)
Example: To convert watts
to kilowatts, use .001 as
the scalingfactor value.
showhours true or false
(Default value is false.)
showseconds true or false
(Default value is true.)

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
21
To use custom alarm and schedule categories
A WebCTRL® system has pre-defined alarm and schedule categories. But, you can add custom
categories in the EIKON® application, then add the same custom category in the WebCTRL® interface.
See "Using schedule categories" and "Customizing alarms" in WebCTRL® Help.

To add a custom category in the EIKON® application

1 Select Options > Preferences.
2 On the Alarm/Schedule Categories tab, select the Alarm Category tab or one of the following
Sched. Category tabs.

To create a schedule category Select this tab

for this type of microblock...
BACnet Time Clock with TLO and Override Time Clock Sched. Category
Status
BACnet Multi-state Time Clock Multi-state Time Clock Sched. Category
BACnet Modeled Schedule Modeled Schedule Sched. Category

3 Click .
4 Type the category name.
NOTES
○ This name must be identical to the reference name that you give the category when you add it
in the WebCTRL® interface.
○ Do not use occupancy as the category name.
○ The name can contain lowercase letters, numbers, hyphens, and underscores (no spaces); it
cannot begin with a number.
5 Click OK twice.
The new category will now appear in a microblock's Category droplist.

NOTES
• Do not delete the existing categories on the Sched. Category tabs if your system uses any control
programs created in the EIKON® for WebCTRL application. See Working with control programs
created in the EIKON® for WebCTRL application (page 31).
• To copy all custom category information to another computer, click Export below the category tabs,
then save the file. On the other computer, click Import, then select the exported file.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
22
Simulating a control program
In simulation mode, you can specify microblock properties and define an operating environment to see
how a control program will operate.
To simulate a control program:
1 Select Control Program > Simulate.
2 In the Simulator window, select Options > Setup.
3 Define the simulation conditions. See table below.
4 Do one of the following:

○ Click to run the simulation continuously until you click to stop it. Set the Time
Increment fields (see table below) to define how fast the simulation will run.
○ Click to run the simulation one step at a time.
○ Click to run the simulation as fast as possible.
5 Click a microblock, then select its Simulation tab to enter values that will help you check the
programming. See NOTES below.
6 Verify that the logic performs the desired sequence of operation.
7 Close the simulation window to return to the workspace.

Field Notes
Calendar Enter the starting Time and Date for the simulation.
Communications Check Communications Ok to simulate normal communication. Uncheck this
field to simulate lost communication.
Time Increment The Step Every value determines how often the simulation recalculates values
in real time.
The One Step = value determines how much simulation time passes between
each step.
For example, to see 30 minutes of simulation in 1 second of real time, use the
following settings:
○ Step Every 00:01 (mm:ss)
○ One Step = 30:00 (mm:ss)

TIP Set your One Step = shorter than the shortest delay in your control
program to avoid stepping over the delay in the simulation.

NOTES
• For simulation only, decimal values smaller than hundredths are rounded to the nearest
hundredth. For example .025 is rounded to .03.
• The Simulator has the same options as the main EIKON® workspace for locating items in the
control program. See:
To find a microblock or label (page 26)
To find identical labels (page 26)
To show a logical path (page 26)
To show a wire's source microblock (page 26)

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
23
 • Hold the cursor over a wire or label to see its value.

EIKON® productivity tools

Use the following features to work efficiently.

To create and use symbols

You can reuse a sequence of programming by exporting it to a .logicsymbol file that you can import into
other control programs.
You can add frequently-used symbols to your Favorites list and organize them for ease of use.

To export a symbol
1 Select the items in a control program that you want in the symbol.
2 Select Edit > Export Symbol.
3 Type a File Name. The application will automatically add the .logicsymbol file extension.
4 Check Selected Items Only.
5 Click Save.

To import a symbol
1 Open the control program you want to paste a symbol into.
2 Select Edit > Import Symbol.
3 Browse to the symbol, then double-click it.
4 Click in the workspace to place the symbol.

NOTE You can drag a .logicsymbol from Windows Explorer to the EIKON® workspace. Select multiple
items to drag them simultaneously. Hold down Ctrl as you drag and drop the .logicsymbol into the
workspace to have it open as a separate file.

To add symbols to your Favorites list

1 Select the items in a control program that you want in the symbol.
2 Right-click one of the items, then select Add to Favorites.
3 Type a Name and a Description.
4 Click Ok.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
24
 To put a Favorites item in a control program
1 Click Favorites.
2 Select the name of the symbol.
3 Click in the workspace to place the symbol.

To organize favorites
1 Select Favorites > Organize.
2 Use the buttons on the right to:
○ Add new favorite
○ Remove favorite
○ Edit favorite's name or description
○ Move up
○ Move down
○ Open selected favorite in main view for editing

To view or edit microblock common properties

The Microblock Common Properties Editor lets you view or edit common properties for the I/O,
Network, Display, and BACnet microblocks in a control program.
1 To see the common properties of:

○ All I/O, Network, Display, and BACnet microblocks in the control program, click on the
toolbar.
○ Selected microblocks, shift+click the microblocks, click , then click Selected Microblocks.
2 Select the tab for the properties you want to see.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
25
 NOTES
• Select File > Export to write the data to a CSV (Comma Separated Values) text file so that you can
edit the file in a spreadsheet program. Click File > Import to import the CSV file back into the
Microblock Common Properties Editor.

CAUTION Do not change any column header name or microblock reference name in the
spreadsheet program.

• To undo changes made in the Editor, close the Editor, then use the Undo feature .
• See Microblock Reference Help for a description of each property.

To find a microblock or label

1 Select Edit > Find.
2 Enter the text you are looking for in the Find What field.
3 Select Case Sensitive if you want to find items that exactly match the uppercase or lowercase text
you typed in step 2.
4 Select the type of items you want to find in the Search box.
5 Click Find.
6 Select an item in the Found Items list. That item is highlighted.
7 Click Close.

To find identical labels

1 Right-click a label.
2 Select Find Label Usages.
3 Click an item in the list. That label is highlighted in the workspace.
4 Click Close.

To show a logical path

Right-click a wire, then select Highlight Connections.
If you leave the Highlight Connection box open while you highlight additional wires, each wire is
highlighted with a different color. Click Change Color to select a different color for the highlight.
Click Clear Highlight to turn off the highlighting.

To show a wire's source microblock

1 Right-click a wire.
2 Select Go To Source.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
26
Defining display options for ZS sensors

To set the order of information displayed on a sensor

If the control program contains multiple microblocks whose values will appear on a ZS sensor screen,
you can define the order in which the values will appear.
EXAMPLES
• If you assigned 3 microblocks to the Home screen, you can set the order that they will cycle
through when no user is interacting with the sensor.
• If you assigned 3 microblocks to the Info screen, you can set the order that they will appear in
when a user presses the sensor's button.

To set the order:

1 Select Reorder > Sensor Display Order.
2 Select the microblock(s) you want to move, then click or .
NOTES
○ Use Ctrl+click, Shift+click, or both to select multiple items.
○ The first microblock in the list must be the first microblock that will appear on the Home
screen.
○ To highlight just the microblocks assigned to a particular screen or defined as Maintenance or
Alarm, select an option in the Highlight list.
3 Optional: If you assigned multiple microblocks to the Home screen, the sensor will display the first
microblock for 10 seconds by default. To shorten the time, select 3 seconds at the bottom of the
window.
4 Click OK.

To create custom Rnet tags

Rnet tags are descriptions and numbers that identify types of system values, and determine how a ZS
sensor will display the value. For example:
• If a BACnet Binary Value Status microblock has the Rnet tag Fan Status (100), the sensor will
display a fan icon when the microblock is active.
• If a BACnet Multi-State Value Status microblock has the Rnet tag Demand Level (502), the sensor
will display the demand level along with the number 502 to identify the value.
The EIKON® application has pre-defined Rnet tags like those described above, but you can add
custom tags if needed.
1 Select Options > Preferences.
2 On the Rnet Tags tab, select the tab (Binary, Analog, or Multi-state) for the type of microblock for
which you are adding the tag.
3 Click .
4 Type a descriptive Display Name for of the Rnet tag.
5 Optional: The Rnet Tag Number field is prefilled with the next available tag number for the type of
tag you are adding. (Binary tags are in the 1100's, Analog tags are in the 1300's, and Multi-State
tags are in the 1500's.) You can change this number if needed.
6 Click OK twice.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
27
 The new Rnet tag will appear in a microblock's Rnet Tag droplist.

CAUTION If you create a control program with a custom Rnet tag and then open the program in
another instance of the EIKON® application that has the same tag number defined for a different
value, the EIKON® application will replace its tag name with the tag name from the control program.
NOTES
• To delete a custom Rnet tag, select it, and then click .
• To copy all custom Rnet tags to another computer, click Export, then save the file. On the other
computer, click Import, then select the exported file.

Omitting _# in BACnet object names in SiteBuilder

BACnet object names are used in Network microblock addresses or by third-party equipment. To
prevent duplicate object names in a controller with multiple control programs, SiteBuilder
automatically adds an instance number to the end of every object name (Example: lstat_5). The
instance number added to every object in a control program is unique to that control program.
A controller with only one control program does not have duplicate objects, so it does not need
instance numbers. In this case, you can keep SiteBuilder from adding instance numbers by selecting
Control Program > Use Unitary Naming.
NOTE If you select this option for a control program that will be downloaded into a multi-equipment
device, all reference names in all of the device's control programs must be unique.

To select properties for ViewBuilder graphics

The EIKON® application lets you select the microblock property values that you want to appear on a
WebCTRL® graphic. This allows the graphics creator to see the property values and quickly obtain their
paths in ViewBuilder. These microblock property selections are saved when you save the control
program.

To select properties for graphics:

1 Right-click a microblock in the workspace, then choose Select Properties For Graphics.
2 Check any property whose value you want to display on a graphic.
NOTE To see all properties, uncheck Show properties typically shown on graphics.
3 Optional: To add a comment for a property such as "Do not include units", check the property and

then click , or you can double-click the property.

NOTE Select Control Program > Properties For Graphics to see all the properties that you selected in
the control program. In the Comments box, you can type a comment that is not for a specific property.
To delete a property, select it and then click .

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
28
Miscellaneous EIKON® menu commands and features

Menu command Notes

Edit > Third Party BACnet Use to edit control programs generated by the Third-Party BACnet
Addresses Utility. See the BACnet Integration Guide
(http://accounts.automatedlogic.com) for instructions on using
this feature.
Control Program > Bundled When making a control program for use in a non-English system,
Resources use this command to embed the translation files in the control
program, omitting the need to maintain separate files. See
“Setting up your system for non-English languages” in WebCTRL®
Help.
Options > Preferences These apply to the EIKON® application, not just the current file.
On this tab... You can...
General • Define the file format that will be the
default when you select File > Save As.
See To begin a control program (page 7)
for more information.
• Set the metric option as the default for all
future control programs. See To begin a
control program (page 7).
• Guarantee that all control program file
names do not contain spaces.
Alarm/Schedule • Add custom alarm or schedule categories.
Categories See To use custom alarm and schedule
categories (page 22).
• Import custom alarm templates, alarm
categories, or schedule categories from
the ems.ini file used by control programs
created in the EIKON® for WebCTRL
application. See Working with control
programs created in the EIKON® for
WebCTRL application (page 31).
Rnet Tags • Add custom Rnet tags. See To create
custom Rnet tags (page 27).
• Export custom tags from one computer
and import them on another.
Droplist Options Customize the following droplists in certain
microblocks:
• BACnet Engineering Units (Airflow, AO, AI)
• Output types (AO)
• Actuator types (AO)
• Input types (AI)
• Sensor types (AI)

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
29
 Menu command Notes
Tools > Configure Tools Click Add, then select a file(s) to add the following to the Tools
menu.
Click this option... To...
Convert EIKON® Convert EIKON® for WebCTRL .equipment
for WebCTRL files to EIKON® .equipment files. See Working
Equipment with control programs created in the EIKON®
for WebCTRL application (page 31).
Remove all Uncheck the Show Property Page Text field
Property Page for all microblocks in the current control
Text program.
Statistics See information about the current control
program. For example, the number of
microblocks, number of ZN-counted
microblocks, etc.
Add Retired Add retired microblocks back to the
Microblocks microblock menu.
Window Select another currently open file to view or edit.
Help > Tip of the Day Uncheck Show tips on startup if you don't want to see the tips
when you start the application.
Help > Apply Update Use this command to install WebCTRL® service packs or patches,
or to update all drivers, graphic libraries, or Help.
Help > About Technical support may ask you for this version, license, or Java
VM information.

Restricted files
If you received a .equipment file and a permissions key created by an original equipment
manufacturer (OEM), you must install the key on the WebCTRL® System Settings > Security tab.
When you open the .equipment file in the EIKON® application, appears on the status bar
at the bottom of the window. If you click on Restricted, the Permissions dialog box will show you what
you are allowed to do with the file.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
30
Working with control programs created in the EIKON® for WebCTRL
application
The tool that you use to create control programs has changed throughout the history of WebCTRL®.
WebCTRL v1.0 through v3 had EIKON® for WebCTRL.
WebCTRL v4 through v5.5 had EIKON® LogicBuilder.
WebCTRL v6 has EIKON®.
Some functionality of a WebCTRL® Logic page (for example, jumping to labels) requires that the
control programs created in EIKON® for WebCTRL be converted to an EIKON® .equipment file. Follow
the appropriate instructions below.

IMPORTANT If you used custom schedule categories, alarm categories, or alarm templates in the
EIKON® for WebCTRL application, you must import them into the EIKON® application before you
upgrade or edit the EIKON® for WebCTRL files.

Converting EIKON® for WebCTRL .equipment files

To quickly convert multiple EIKON® for WebCTRL .equipment files to EIKON® files:
1 In the EIKON® application, select Tools > Convert EIKON for WebCTRL Equipment.
2 Browse to the folder containing the EIKON® for WebCTRL .equipment files, then click Open.
NOTE Before the conversion takes place, all the control programs in the selected folder are copied to
a new backup folder.

Editing EIKON® for WebCTRL control programs

To edit an EIKON® for WebCTRL control program in the EIKON® application, you can open the
.equipment file or import the .eiw file. After editing, you will save the control program only as a
.equipment file; the EIKON® application does not use a .eiw file.
To import a .eiw file:
1 Select File > Import from EIKON for WebCTRL.
2 Select the file you want to import, then click Open.
NOTE After you edit a .eiw file, consider doing one of the following to prevent using it as the starting
point for future control program edits.
• Move the .eiw file to a folder named Obsolete.
• Add -obsolete to the .eiw file name.

To import custom categories and templates from the EIKON® for WebCTRL application
If you used custom schedule categories, alarm categories, or alarm templates in the EIKON® for
WebCTRL application, you must import those custom items from the ems.ini file.

CAUTION Importing deletes any custom categories or templates that you may have defined in the
EIKON® application.
To import from the ems.ini file:
1 Select Options > Preferences.
2 On the Alarm/Schedule Categories tab, click Import from INI.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
31
 3 Open the ems.ini file located in your previous system's Eikon folder.
4 Click OK.
NOTE If needed for v2.0 or earlier alarms, you can add templates on the Alarm Template tab. V2.5 or
later alarms use the Universal template.

Working with control programs for non-English systems

Creating control programs and translation files for a non-English system

To have the WebCTRL® interface display a control program’s user-defined text (such as microblock
names and property text) in a non-English language, you must:
1 Create the control program using key terms instead of the text.
2 Create translation files of key terms and their language-specific equivalents.
In the WebCTRL® interface, the key term is replaced with its equivalent in the translation file for the
current operator language. If a WebCTRL® Properties page, Logic page, or graphic shows ??key
term??, the key term is missing from the translation file.

NOTES
• You also use key terms and translation files with graphics that you created with WebCTRL®
extensions for FrontPage.
• To edit existing control programs or translation files, see Editing translation files, control
programs, or graphics (page 34).

To enter a key term in the EIKON® application

In the EIKON® Property Editor, type @ before each key term.

NOTES
• Type only the key term in the EIKON® application. Expressions such as $present_value$ are put in
the translation file as part of the translated text. See EXAMPLES in "Translation files" below.
• Key terms can contain only alphanumeric characters and underscores (no spaces) and cannot
start with a number.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
32
Translation files
Translation files are used to translate key terms in control programs and graphics created with
WebCTRL® extensions for FrontPage. A translation file contains key terms and their language-specific
equivalents.
For a non-English system, you must create an English translation file and a non-English translation
file* for each of the following:
• Each control program
• Key terms used in multiple control programs
• Each graphic created with WebCTRL® Extensions for FrontPage
• Key terms used in multiple graphics

EXAMPLES
Translation files Key term=Language-specific equivalent
English This_value=This value is $present_value$
Zone_temp=Zone temperature
Spanish This_value=Este valor es $present_value$
Zone_temp=Temperatura de zona
*If the WebCTRL® interface will display multiple non-English languages, create a translation file for
each language.

To create and implement a translation file

Create your translation file in a text editor, such as Microsoft® Word, that supports the character
encoding you need.
1 Type one key term and language equivalent per line, left justified, starting in column 1. Do not put
spaces on either side of the equal sign.
2 Save the file using the appropriate file name and location in the table below.

If key terms are used the file name is... File location
in...
A single control program <any_name>_xx.native* Any location
Multiple control equipment_xx.native* WebCTRL\webroot\
programs <system_name>\resources
A single <graphic_name>_xx.native* WebCTRL\webroot\
graphic <system_name>\graphics\lvl5
Multiple translations_xx.native* WebCTRL\webroot\
graphics <system_name>\resources
* xx = the language extension code. See "Extension codes and encoding" below.

If you are using:

○ the English character set, save the file as Text only.
○ a non-English character set, save the file as Encoded text . (See your application’s help for
information on saving files as encoded text.) When prompted for the language and encoding,
see “Extension codes and encoding” below.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
33
 3 Open the control program in the EIKON® application, then select Control Program > Bundled
Resources.
4 Click , locate and select the translation file(s) for this control program, then click Open.
NOTES
○ Do not add equipment_xx.native files that you created for multiple control programs.
○ You can use Ctrl+click or Shift+click to select multiple files.
5 Save the control program. The translation files are embedded in the control program; the original
files are no longer necessary.

Extension codes and encoding

Language Extension codes Encoding*
English _en ISO-8859-1

French _fr_FR ISO-8859-1

German _de ISO-8859-1

Japanese _ja EUC-JP

Korean _ko EUC-KR

Russian _ru KOI8_R

Spanish _es ISO-8859-1

Swedish _sv ISO-8859-1

Simplified Chinese _zh GB2312

Traditional Chinese _zh_TW Big5

Thai _th TIS620

Vietnamese _vi Cp1258

* Encoding is used when you create the translation file.

Editing translation files, control programs, or graphics for a non-English

system
If you add or edit a key term in a control program or graphic, be sure to make the same change in the
translation file. See Creating control programs and translation files (page 32).
If you make changes after attaching a control program or graphic in SiteBuilder, do one of the
following:
• If you changed text only in a control program or its translation file, right-click the control program
on the Geographic tree, then select Rebuild Equipment Pages.
• If you changed logic in the control program, right-click the control program on the Geographic tree,
then select Reload Control Program.
• If you changed a translation file located in WebCTRL\webroot\<system_name>\resources,
right-click each applicable graphic on the Geographic tree, then select Rebuild Graphic Resources.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
34
To edit a bundled resource
The EIKON® application bundles (embeds) the translation file(s) for a control program into the
.equipment file. See steps 3 through 5 in To create and implement a translation file (page 33). To edit
a bundled translation file:
1 Open the control program in the EIKON® application.
2 Select Control Program > Bundled Resources.
3 Select the file, then click to save it to your hard drive.
4 Edit the translation file.
5 In the Bundled Resources dialog box in the EIKON® application, click and select the edited
file.
6 Click OK to overwrite the existing file.

Editing an EIKON® for WebCTRL control program in the EIKON® application

To edit a non-English control program that you created in the EIKON® for WebCTRL application:
1 Open the .eiw or .equipment file in the EIKON® application, then make your edits.
2 Select Control Program > Bundled Resources.
3 Verify that the list shows all translation files specifically for the control program. Use the plus or
minus button to add or delete translation files.
NOTE This list shows the translation files in the WebCTRL\webroot\<system_name>\programs
folder. This list should not include translation files for multiple control programs or graphics.
4 Click OK.
5 Save the control program. The translation files are bundled with the control program; the original
files are no longer necessary.

NOTE If you need to change a translation file after you save the control program, see To edit a bundled
resource (page 35).

Copying translation files to another system

To copy most translation files from one system to another, you copy the files in the source system and
paste them into the same folders in the destination system.
However, if your source system and destination system have translation files with the same name,
copying and pasting would overwrite the file(s) in the destination system. In this case:
1 Open the source system’s translation file in a text editor, then copy the key terms and translations.
2 Open the destination system’s translation file in a text editor, then paste into it the key terms that
you copied. Remove any duplicate key terms.

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
35
Document revision history

Important changes to this document are listed below. Minor changes such as typographical or formatting
errors are not listed.

Date Topic Change description Code*

5/5/15 Entire document New look, no content changes A-D
1/7/15 Cover page Added export control statement at bottom, "This document X-O-CY-E-CY
does not contain technical data controlled by the EAR or
ITAR."

* For internal use only

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
36
Index K
keyboard shortcuts • 3
A L
alarm categories • 22, 31 labels • 9, 26
alarm templates • 31 Logic pages • 3, 7
apply update • 2, 29
M
B
metric • 3, 7
background color • 7 microblock common properties • 2, 25
bundled resources • 22, 29 microblock properties • 28
C microblocks • 1, 3, 4, 7, 14, 24
retired • 29
category
alarm • 22, 29 N
schedule • 4, 22, 29 Normal control program • 4, 7
control programs • 1, 4, 7
Normal • 4, 7 P
PSM • 7
simulating • 23 properties • 1, 8, 14, 28
UNI • 5, 7 Properties pages • 8, 14, 29
ZN • 7 Property Editor • 3, 8
controllers • 4 PSM control program • 7
custom icon • 7
R
custom microblock • 13
reorder items • 14
D Rnet tags • 27, 29
download • 1
S
drawing lines/shapes • 11
schedule
E categories • 4, 22, 31
EIKON for WebCTRL • 31 service packs and patches • 29
expressions • 14 shortcuts, mouse and keyboard • 3
extensions for FrontPage • 32 simulate a control program • 23
symbols • 24
F
T
font • 10
text • 15, 17
G third-party BACnet addresses • 22, 29
translation file • 32, 34
graphics • 28 trends • 2
H enabling historian • 2

highlight connections • 26 U
I UNI control program • 5, 7

images in graphics files • 12 W

J WebCTRL® extensions for FrontPage • 32
wires • 9
joints • 7 workspace options • 3

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
37
 Z
ZN control program • 2, 7
ZS sensor • 27

EIKON® v6.0 ALC Proprietary and Confidential © 2015 Automated Logic Corporation
Rev. 5/5/2015 All rights reserved
38