Professional Documents
Culture Documents
EIKON v8.5 User Manual
EIKON v8.5 User Manual
EIKON v8.5 User Manual
5
User Manual
Rev. 2/20/2023
Verify that you have the most current version of this document from the Automated Logic® Partner
Community website.
Important changes are listed in Document revision history at the end of this document.
A Carrier Company
© 2023 Carrier. All rights reserved.
The content of this guide is furnished for informational use only and is subject to change without notice.
Automated Logic 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
Getting to know the EIKON® workspace .................................................................................................... 2
Determining the control program type ....................................................................................................... 3
Normal for all controllers except U line, ZN line, or Automated Logic® PlantCTRL™ ....................... 3
UNI for U line controllers .............................................................................................................. 4
ZN for ZN line controllers ............................................................................................................. 5
PSM for Automated Logic® PlantCTRL™...................................................................................... 6
Developing the logic ................................................................................................................................ 6
To begin a control program .......................................................................................................... 6
To place microblocks ................................................................................................................... 7
To draw wires and labels .............................................................................................................. 8
To view errors .............................................................................................................................. 9
To add text .................................................................................................................................. 9
To add lines and shapes ............................................................................................................ 10
To add an image ........................................................................................................................ 11
To create a custom microblock .................................................................................................. 11
To select properties for ViewBuilder graphics ............................................................................. 12
To use permissions to restrict a file's use ................................................................................... 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
Operators................................................................................................................... 17
Editing Properties page text using special characters .................................................. 18
Formatting a microblock property ............................................................................... 20
To use custom alarm and schedule categories............................................................................ 23
Simulating a control program ................................................................................................................. 24
EIKON® productivity tools ..................................................................................................................... 25
To create and use symbols ......................................................................................................... 25
To view or edit microblock common properties ........................................................................... 26
To find a microblock, label, or text in the workspace ................................................................... 27
To find and replace text in a microblock, label, or text entry field ................................................. 28
To find identical labels .............................................................................................................. 28
To show a logical path ............................................................................................................... 28
To show a wire's source microblock ........................................................................................... 28
Defining options for sensors ................................................................................................................... 29
To set the order of information displayed on a ZS sensor ............................................................. 29
To create custom Rnet tags ........................................................................................................ 29
Omitting _# in BACnet object names in SiteBuilder .................................................................................. 30
Miscellaneous EIKON® menu commands and features ............................................................................ 30
Working with control programs created in the EIKON® for WebCTRL application ......................................... 32
Working with control programs for non-English systems ............................................................................ 33
Creating control programs and translation files for a non-English system .................................... 33
To enter a key term in the EIKON® application ............................................................ 34
Translation files .......................................................................................................... 34
To create and implement a translation file ................................................................... 34
Editing translation files, control programs, or graphics for a non-English system ......................... 36
To edit a bundled resource.......................................................................................... 36
Editing an EIKON® for WebCTRL control program in the EIKON® application .............. 36
Copying translation files to another system ................................................................. 37
Document revision history ...................................................................................................................... 38
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 3).
2 Develop the logic (page 6).
3 Format Properties pages (page 14).
4 Simulate the control program (page 24).
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
1
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.
• 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%
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
2
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
3
UNI for U line controllers
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 on the Automated Logic® Partner Community website, then follow the
instructions under "How do I get a control program tagged?".
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
4
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 or Wireless Sensors, the control program must have one Sensor Binder
microblock and one of the following microblocks for each value type that will be read from the
sensor network:
○ BACnet Analog Sensed Value Input microblock – For values such as temperature or humidity
○ BACnet Binary Sensed Value Input microblock – For values such as occupied/unoccupied
• 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 700 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.
○ An OCL microblock used in a ZN control program must be tagged. Get a tagged OCL microblock
from the Automated Logic® Partner Community website, 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 700-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 Automated Logic®
Partner Community 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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
5
PSM for Automated Logic® PlantCTRL™
The Automated Logic® PlantCTRL™ provides full and advanced chiller plant management using an
EquipmentBuilder library of validated algorithms and strategies that enhance operation. You can apply
the algorithms as designed or customize them in the EIKON® application. You can also integrate the
Automated Logic® PlantCTRL™ with third party equipment using open protocols.
NOTE This type of 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.®
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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
6
To place microblocks
1 Right-click the microblock palette.
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 26) 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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
7
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
8
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 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.
To add text
Use the Text tool to add descriptive text to the control program.
1 Select the Text tool.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
9
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.
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
10
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 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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
11
NOTES
• You cannot view or change a custom microblock's logic in the WebCTRL® interface.
• You can put custom microblocks inside other custom microblocks.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
12
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, clear the checkbox Show properties typically shown on graphics.
3 Optional: To add a comment for a property such as "Do not include units", select 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 .
NOTE To see if your system has this optional package, click , then select About. You have this package
if Enabled Features shows WebCTRL Superset.
The EIKON® application has a permissions feature that lets you restrict what someone with a different
WebCTRL® license can do with the .equipment file.
1 Select File > Permissions.
2 Select Enable Permissions.
3 Select or clear checkboxes as needed.
Permit Upload Upload the file from a controller to their database. Requires
version 4.02 or later drivers.
Permit Download Download the file to a controller.
Permit View Logic View the control program's Logic page in the WebCTRL®
interface.
Permit Edit Edit the .equipment file in the EIKON® application.
NOTES
• Control programs created with permissions enabled can be used only in a system that is version 5
or later. Control programs created with permissions disabled can be used by anyone and in any
system version. However, a control program is not backward compatible if it contains microblocks
that are restricted to v5 or later.
• Go to Options > Preferences > Default Permissions to change the default settings for all files that
will be created in the EIKON® application.
• The permissions feature also applies to .logicsymbol files. See To create and use symbols (page
25).
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
13
Preparing logic for the WebCTRL® interface
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 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 search for the microblock.
• 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 .
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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 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".
See Operators (page 17) for more information.
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
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 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).
Operators
An operator defines how each piece of an expression is to be handled. For example, an operator can
compare or perform an action between the value of a microblock property, a literal value, or the result
of an expression. The following table lists operators that can be used in expressions.
Path Operators
??path?? Check for presence Checks for the existence of the path. If it exists, the
expression is true. If it does not, the expression is false.
Operators that return true/false
< Less than Compares numeric data. Returns true if the value to the left
of the operator is smaller than the value to the right.
> Greater than Compares numeric data. Returns true if the value to the left
of the operator is larger than the value to the right.
<= Less than or equal to Compares numeric data. Returns true if the value to the left
of the operator is smaller than or equal to the value to the
right.
>= Greater than or equal to Compares numeric data. Returns true if the value to the left
of the operator is larger than or equal to the value to the right.
! Not Evaluates the expression and returns the opposite. Example:
!$zone_temp/locked$
If zone_temp/locked is true, the expression is false. If
zone_temp/locked is false, the expression is true.
== Equal to Compares data. Returns true if the value on both sides of the
operator are equal.
!= Not equal to Compares data. Returns true if the value to the left of the
operator does not match the value to the right.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
17
&& And Combines expressions. Returns true if the expressions on
both sides of && result in true. For example:
$zone_temp/locked$==false
&&$zone_temp/present_value$>75
?'#FF0000':'#FFF660'
|| Or Combines expressions. Returns true if the expression on
either side or both sides of the operator results in true.
Operators that return a numeric value
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
18
To... In the Property Page Text field, Example
type...
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$
|since|$Current/Reset_Time$|$Current/
end a row.
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:
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!
^\${}[]|!
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
19
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"$.
Breakdown of an expression
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
20
Controls and parameters
A microblock property data type determines the type of control that can be used.
Enumerated
Example: A
binary, analog, or
multi-state
parameter's
present value
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
21
To display a... Data must be.. Control Parameter Parameter value
Example: An digits_right_of_decimal number of digits
analog (real number only) (Default value is null.)
parameter's
present value digits_left_of_decimal number of digits
or (Default value is null.)
showplussign true or false
Real (Default value is false.)
(has decimal)
Example: An scalingfactor any floating point number except
analog Multiplies the actual value 0
parameter's by the scalingfactor value. (Default value is 1.)
present value Example, to convert watts to
kilowatts, use .001 as the
or
scaling factor value.
Unsigned
Example: Any
point's expander
number
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
22
To display a... Data must be.. Control Parameter Parameter value
a timer scalingfactor any floating point number except
Example: A duty Multiplies the actual value 0
cycle's time 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.)
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
23
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 32).
• 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.
Field Notes
Calendar Enter the starting Time and Date for the simulation.
TIP Set your One Step = shorter than the shortest delay in your control
program to avoid stepping over the delay in the simulation.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
24
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 27)
To find identical labels (page 28)
To show a logical path (page 28)
To show a wire's source microblock (page 28)
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
25
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.
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
○ 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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
26
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
27
To find and replace text in a microblock, label, or text entry field
Follow the steps below to find and replace text in Property Editor text fields.
NOTE This feature will not search:
• Date, time, or duration fields
• Multi-State text fields
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
28
Defining options for sensors
You can create control programs in EIKON® that work with various types of wireless or ZS sensors. For
each microblock that uses a sensor's value, you:
• Select an Rnet tag that defines what type of information the value is. If EIKON® does not have the
Rnet tag you need, you can create custom Rnet tags (page 29).
• Define how the value should be displayed if using a ZS sensor. EIKON® lets you set the order for
information to be displayed on a ZS sensor (page 29).
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
29
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.
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.
Edit > Third Party BACnet Use to edit control programs generated by the Third-Party BACnet
Addresses Utility. See the BACnet Integration Guide for instructions on using this
feature.
Control Program > Bundled When making a control program for use in a non-English system, use
Resources 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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
30
Menu command Notes
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
31
Menu command Notes
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 v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
32
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.
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 36).
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
33
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.
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
*If the WebCTRL® interface will display multiple non-English languages, create a translation file for
each language.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
34
If key terms are used the file name is... File location
in...
A single control program <any_name>_xx.native* Any location
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.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
35
Language Extension Codes Encoding
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
36
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 36).
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
37
Document revision history
Important changes to this document are listed below. Minor changes such as typographical or formatting
errors are not listed.
EIKON v8.5 Automated Logic Proprietary and Confidential A Carrier Company. © 2023 Carrier.
Rev. 2/20/2023 All rights reserved.
38