GE

Digital Energy

LogicLinx IEC 61131-3 Soft Logic

Getting Started

SWM0018
Version 3.00 Revision 4
Associated Software Release: Editor - Version 2.00-6.3
Executor – Version 3.00

GE Information
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

NOTICE OF COPYRIGHT & PROPRIETARY RIGHTS

© 2000-2015, General Electric Canada. All rights reserved.
The contents of this manual are the property of General Electric Canada. No part of this work may be reproduced or transmitted in
any form or by any means, except as permitted in written license agreement with General Electric Canada. The information contained
in this document is subject to change without notice.
Any attached hardware schematics and technical descriptions, or software listings that disclose source code, are for information
purposes only. Reproduction in whole or in part to create working hardware or software for other than General Electric Canada
products is strictly prohibited, except as permitted by written license agreement with General Electric Canada.

TRADEMARK NOTICES

GE and are trademarks and service marks of General Electric Company.

Windows®, Windows 7®, and Windows XP® are claimed as registered trademarks of Microsoft Corporation.
Other company or product names mentioned in this document may be trademarks or registered trademarks of their respective
companies.

2 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Contents

About this Document .....................................................................................................................6

Purpose........................................................................................................................................ 6
Who Should Use this Document? ............................................................................................... 6
Additional Documentation .......................................................................................................... 6
Training Tool .............................................................................................................................. 6

Product Support .............................................................................................................................7

GE Digital Energy Web Site....................................................................................................... 7

GE Technical Support Library.................................................................................................... 7
Contact Technical Support.......................................................................................................... 7

1. Document Overview...................................................................................................................8

1.1 Overview ............................................................................................................................. 8

1.2 Tips for First-Time Reader ................................................................................................. 9
1.3 Differences Between the 16-bit and the 32-bit Versions of the LogicLinx Editor ........... 11

2. Product Description .................................................................................................................13

2.1 Overview ........................................................................................................................... 13

2.2 Soft Logic Real-time Program Cycle ................................................................................ 14
2.3 What is LogicLinx?........................................................................................................... 15
2.4 The LogicLinx Editor ....................................................................................................... 16
2.5 Additional Features ........................................................................................................... 18

3. The IEC 61131-3 Standard .....................................................................................................19

3.1 Overview ........................................................................................................................... 19

3.2 What is IEC 61131-3? ....................................................................................................... 20
3.3 Choosing a Language ........................................................................................................ 21

4. Project Planning .......................................................................................................................23

4.1 Overview ........................................................................................................................... 23

4.2 LogicLinx Performance .................................................................................................... 24
4.3 Planning a Soft Logic Project ........................................................................................... 25
4.4 Detailed Plan ..................................................................................................................... 26

5. Installing LogicLinx .................................................................................................................28

GE Information SWM0018-3.00-4 3
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

5.1 Overview ........................................................................................................................... 28

5.2 Editor Platform Requirements .......................................................................................... 29
5.3 Installing the Editor........................................................................................................... 30

6. Before Configuring The LogicLinx DTA (Executor) ...........................................................34

6.1 Overview ........................................................................................................................... 34

6.2 Understanding the Operation of the Executor .................................................................. 35
6.3 DTA Configuration Prerequisites ..................................................................................... 37
6.4 LogicLinx DTA Configuration Basics.............................................................................. 38
6.5 Enabling the LogicLinx Application ................................................................................ 39

7. Setting-up the Executor in WIN .............................................................................................41

7.1 Overview ........................................................................................................................... 41

7.2 The System Point Database: WIN+ .................................................................................. 42
7.3 Conversion Points ............................................................................................................. 43
7.4 Point Descriptors ............................................................................................................... 46

8. The LogicLinx DTA: The Executor .......................................................................................48

8.1 Overview ........................................................................................................................... 48

8.2 Editing LogicLinx Executor Tables .................................................................................. 49
8.3 The Point Mapping Tables ................................................................................................ 50
8.4 The Internal Transition Counters Table ............................................................................ 52
8.5 Initialization and Control Type Tables ............................................................................. 54
8.6 The Executor’s Communications Parameters ................................................................... 62
8.7 Conversion Point Tag Tables ............................................................................................ 66

9. Using the LogicLinx Editor .....................................................................................................67

9.1 Overview ........................................................................................................................... 67

9.2 Tour of the Editor.............................................................................................................. 68
9.3 Tips for the Advanced User .............................................................................................. 69
9.4 Project Groups (16-bit version only) ................................................................................ 71
9.5 Creating an Example Project File ..................................................................................... 72
9.6 Verifying the Soft Logic Program .................................................................................... 81
9.7 Simulation Testing a Soft Logic Program ........................................................................ 83
9.8 Changes to Cycle and Communications Times ................................................................ 86

10. The Editor / Executor Link ...................................................................................................88

10.1 Overview ........................................................................................................................... 88

10.2 Choices of Editor/Executor Link ...................................................................................... 89
10.3 Using the Editor / Executor Link: the Debug Menu ......................................................... 98
10.4 Run-Time Adjustments ................................................................................................... 101
10.5 Permanent Changes to Cycle and Communications Times ............................................ 103
10.6 Testing With Debug ........................................................................................................ 105

4 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.7 LogicLinx Project Maintenance (16-bit version only).................................................... 107

10.8 Embedding LogicLinx and SGConfig Configuration Files ............................................ 108

A. Troubleshooting ....................................................................................................................111

A.1 Error and Warning Codes ............................................................................................... 111

GE Information SWM0018-3.00-4 5
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

About this Document

Purpose
This document gives a system level description of LogicLinx explaining how it interacts with GE
Digital Energy automation equipment. As well, it provides background information and
exercises that illustrate some of the basics of configuring the LogicLinx Editor and LogicLinx
Executor (DTA).
By following the exercises in this document, a simple soft logic program will be created, tested,
and run on an actual device.

Who Should Use this Document?

This guide will assist new users of LogicLinx to become acquainted with the program
environment and functionality. This document is not intended to be a programmer’s guide for the
IEC 61131-3 programming languages. It also does not describe how to use all of the available
LogicLinx features. For more information on programming, refer to the guides listed under
Additional Documentation.

Additional Documentation
For further information about LogicLinx, refer to the following documents:
• On-line help included with LogicLinx Editor
• SWM0019 – The LogicLinx User’s Guide
• IEC 61131-3 standard documents that can be used as a programmer’s guide.

Training Tool
This document will be used as part of the Student documentation set for any formal GE Digital
Energy LogicLinx training program.

6 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Product Support
If you need help with any aspect of your GE Digital Energy product, you can:
•Access the GE Digital Energy Web site
•Search the GE Technical Support library
•Contact Technical Support

GE Digital Energy Web Site

The GE Digital Energy Web site provides fast access to technical information, such as manuals,
release notes and knowledge base topics.
Visit us on the Web at: http://www.gedigitalenergy.com/

GE Technical Support Library

This site serves as a document repository for post-sales requests. To get access to the Technical
Support Web site, go to:
http://site.ge-
energy.com/prod_serv/products/substation_automation/en/tech_support_login.htm

Contact Technical Support

GE Digital Energy Technical Support is open 24 hours a day, seven days a week for you to talk
directly to a GE representative.
In the U.S. and Canada, call toll-free: 1 800 547 8629.
International customers call: +1 905 927 7070
Or send an e-mail to: [email protected]

GE Information SWM0018-3.00-4 7
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

1. Document Overview

1.1 Overview

This section of the document is designed to help readers understand the role that the
Introduction following chapters will have in their understanding and use of the GE Digital Energy
LogicLinx product.
Information is also provided to assist the reader in interpreting the format of the
document.

This chapter contains the following topics

In this
chapter

Topic See Page

Tips for First-Time Reader 9

8 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

1.2 Tips for First-Time Reader

Background For accurate, reliable and efficient operation of LogicLinx, it is imperative that the
practices and recommendations listed below be adhered to at all times.
Some of these practices and recommendations are repeated elsewhere in the LogicLinx
documentation. They are included here to highlight the most probable cause of problems.
If you have any doubts regarding the following practices and recommendations, contact
GE Digital Energy for clarification.

List of Tips Below is a list of tips that will help the first-time user to start using the LogicLinx
system smoothly.

Tip Description
1 Do not attempt to use LogicLinx for project development unless you have
read and understand all of the documentation.
You should read the documents in the following order:
• SWM0018 – LogicLinx Getting Started, and then
• SWM0019 - The LogicLinx User’s Guide.
The on-line documentation should be used as a supplement during
development.
We recommend you spend a few hours navigating around the sample
programs to get a feel of the features prior to immersing yourself in the
documentation.
2 LogicLinx supports on-line modifications without affecting program
execution.
Never attempt on-line modifications unless you have read and understand
the associated documentation.
3 Do not misplace your dongle (for version 1.x.) If you do you will have to
purchase another one (no exceptions).
4 Never forget any passwords you have implemented in a project.
5 Do not attempt to use LogicLinx for project development unless you have at
least a working knowledge of GE Digital Energy equipment, configuration
tools and system applications.

Continued on next page

GE Information SWM0018-3.00-4 9
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Tips for First-Time Reader, Continued

Tip Description
6 Never commission a system with active LogicLinx programs unless the
programs have been verified in a system context.
7 Do not attempt to use features that are not currently supported.
8 Changes to any I/O device may impact LogicLinx program operation.
Always re-test your LogicLinx programs after changing any system device
configurations.

10 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

1.3 Differences Between the 16-bit and the 32-bit Versions

of the LogicLinx Editor

Difference Description
1 The 16-bit version only runs on 32-bit versions of the Windows operating system while the
32-bit version runs on both 32-bit and 64-bit versions of the Windows operating system.
2 The 16-bit version requires users to run as administrators while the 32-bit version does not
have this constraint.
3 The 32-bit version allows users to compare LogicLinx programs in two different devices.
4 Sequential function chart (SFC) programs cannot be created or modified in 32-bit version.
Existing programs can be compiled and full support for these programs will be restored in
a future release.
5 Instruction language (IL) programs cannot be created or modified in the 32-bit version.
Existing programs can be compiled and modified using a text editor.
6 Function chart (FC) programs cannot be created or modified in 32-bit version. Existing
programs can be compiled.
7 Most programs created and modified in the 32-bit version can be opened in the 16-bit
version provided they do not exceed the maximum numbers for names, descriptions and
other artefacts of the 16-bit version.
8 The user-interface in the 32-bit version is based on Visual Studio 2010. Most of the
functions previously available through the toolbar and menus in the 16-bit version are now
available using a combination of the Solution Explorer and Properties windows of the 32-
bit version.
9 The Dictionary in the 16-bit version is now called Global Variables in the 32-bit version.
10 Compile and Make operations in the 16-bit version are called Build in the 32-bit version.
11 In order to set the target in the 32-bit version, you need to click on the drop-down in the
Solution Explorer.
12 The Link setup and connection parameters needs to be entered in the Properties window
after selecting Main -> Main from the Solution Explorer Window in the 32-bit version.
13 The debugger toolbar does not indicate the current, maximum and overflow cycle timings
in the 32-bit version.
14 In order to do simulation in the 32-bit version, you need to explicitly select the Simulate
target for a program, build it and then switch to Online mode.
15 You need to choose ‘Online’ mode in order to start real-time debugging in the 32-bit
version.

GE Information SWM0018-3.00-4 11
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

2. Product Description

2.1 Overview

Introduction LogicLinx is an automation tool.

LogicLinx enables you to create automation applications that have traditionally been too
costly or difficult - without the need for hard-wiring.
Using any or all of the IEC 61131-3 programming languages, you can create automation
routines that run on your GE Digital EnergyAutomation Platform.

In this This chapter contains the following topics

chapter

Topic See Page

Soft Logic Real-time Program Cycle 14
What is LogicLinx? 15
The LogicLinx Editor 16
The LogicLinx Executor 17
Additional Features 18

GE Information SWM0018-3.00-4 13
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

2.2 Soft Logic Real-time Program Cycle

In general, there are two main types of real-time systems in use:

Real-time • Time-driven, and
system
• Event Driven

consists of periodically observing the global state of the system, instead of reacting to a
Time-driven single event.
The result is that the time interval between global observations is the quantity that drives
the control execution. i.e., time driven.
Comment: most PLC-type control systems use the time-driven approach

Advantages Disadvantages
Simplicity of operating systems Cyclicity; the cycle timing is inherently imposed
(programs) on all input events
Predictability of maximum Uniformity; all events are detected at the same
response time interval, neglecting their own repetitive intervals

consists of responding to each event as it happens.

Event-driven
In reality, all system events are put into a queue, and the program determines the correct
reaction.
The system must strive to process each event immediately, even if other events are being
processed at that time.

Advantages Disadvantages
Flexibility; the programmer has a Complexity; it is very difficult to program for
powerful tool where events can be simultaneous events, and what-if situations
processed based on their nature
and importance
Requires a more complex operating system
Typically will require a more powerful (faster)
platform.
Unpredictable; events with higher priorities will
pre-empt other low priority events.

Primarily due to the disadvantages outnumbering the advantages, event-driven systems

Conclusions are reserved to a few specialized applications.
The majority of PLC systems, including LogicLinx, use the time-driven approach.

Because the LogicLinx Executor is time-driven, the response time of a LogicLinx

Note program can therefore never be greater than the program’s actual cycle time.

14 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

2.3 What is LogicLinx?

The LogicLinx Executor:

The Two • The LogicLinx Target Executor subsystem provides programmable logic
Components control (soft logic) functionality within a GE Digital Energy device (e.g., D25,
of LogicLinx D20 ME, D20MX etc.).
• The Executor is responsible for executing soft logic programs written using the
Windows PC-based LogicLinx soft logic Editor.

The LogicLinx Editor:

• The Editor is an IEC 61131-3 compliant tool for creating, editing, compiling,
debugging, downloading and monitoring LogicLinx soft logic programs.

GE Information SWM0018-3.00-4 15
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

2.4 The LogicLinx Editor

The LogicLinx Editor provides the tools necessary for a user to create, compile,
Overview simulate, download, debug, manage, document, archive, monitor and on-line modify
LogicLinx programs.
Unless otherwise indicated, the term Editor refers to both the 16-bit and the 32-bit
versions.
The Editor employs all of the IEC 61131-3 programming languages, providing
flexibility programming (with certain limitations in the case of the 32-bit version).

The 16-bit version of the Editor is available in sizes that are scaled to your requirements.
Editor
The 32-bit version of the Editor does not have any size limitation.
Options

IEC 61131-3 is a standard published by the International Electrotechnical Commission.

IEC 61131-3
The introduction of standard languages is an important step towards portability,
interoperability and information exchange across multi-vendor platforms.
The standard can be purchased from www.iec.ch.
More information on the standard is available from http://www.plcopen.org/tc1.htm.

This standard is devoted to five basic programming languages:

The IEC’s 5
• Sequential Function Chart (SFC) (not currently supported in the 32-bit version),
Programming
Languages • Instruction List (IL) (not supported in the 32-bit version),
• Structured Text (ST),
• Ladder Diagram (LD) and
• Function Block Diagram (FBD).

16 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

2.4.1 The LogicLinx Executor

The Executor is an application that can be loaded into a GE Digital Energy target
The platform. It performs all program execution independently of the Editor, although the
LogicLinx Editor can modify execution.
Executor The core of the Executor is a software module that is designed to be ported to various
DTA operating systems and platforms, ensuring compatibility with future GE Digital Energy
products.

The Executor is available in versions that reflect the type of communications that will be
2 Versions used in the customer’s soft logic applications. B082-0 (WARP) provides Ethernet, serial,
and WESMAINT communications while B082-1 (MACH) provides serial and
WESMAINT communications.

The LogicLinx Executor can currently be installed into GE Digital Energy D25
Dependen- systems, and CCU base systems running on D20 ME and D20M++ platforms as well as
cies the D20MX platform.
Specifically, LogicLinx requires the use of the 68K File System in addition to the
standard 68K Base System for D20 and D200 platforms.
The Base System is responsible for all system data acquisition and distribution, primarily
via the WESDAC Interface Node (WIN+).
Ethernet communications, using the B082-0 variant (WARP version), requires the use of
the GE Digital Energy iSCS Internet Software package.

GE Information SWM0018-3.00-4 17
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

2.5 Additional Features

There are two ways to operate output controls:

Control • The first is to use the OPERATE function block, which specifies the type (e.g.
Operation TRIP, CLOSE, etc.) and the duration of the control operation.
Options • The other is by assigning a binary value to a digital output. In this case, the type of
operation to be performed must be configured by the user in the Digital Output Type
Configuration table in SGConfig.

LogicLinx (16-bit version only) features several different visual simulation tools:
Visual • Board Simulator • DDE Exchange
Simulation • SpyList • SpotLight
Tools • Cycle Profiler • Simulation Scripts
Bonus: Opening a program in its editor while in Debug mode will provide a visual
indication of the program operation.

Board Visually displays input/output states. You can, for example, activate digital inputs by
actuating pushbuttons while watching corresponding digital outputs with LEDs.
Simulator

Lets you build non-contiguous lists of variables that are refreshed with their current
SpyList values.
They allow you to watch the changes of a limited part of the controlled process
independent of the corresponding source code in the applications.

is a diagnostic tool that shows how cycle time is distributed between various applications
Cycle within your project.
Profiler Cycle Profiler gives you a quick diagnostic on each application’s performance and leads
you to the parts of the code that may need optimizing.

Simulation Allows you to create input files to automate the verification testing.
Scripting

Allows you to install an advice loop between LogicLinx’s debugger and other Windows
DDE applications such as MS Excel, MS Word and other “off the shelf” software.
Exchange Using Visual C++ or Visual Basic, you can create your own Windows programs to make
summary displays, alarm lists, overviews or to present dynamic data on a graphic display
window.

Allows you to build graphical displays such as one-line diagrams and mimic panels.
Spotlight
Backgrounds can be imported as bitmap files, and object animations can be imported as
icon files. Any icon building tool can be used.
A tool is available from www.easyapps.com.

18 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

3. The IEC 61131-3 Standard

3.1 Overview

This chapter provides an overview of the IEC 61131-3 standard as it relates to the
Introduction LogicLinx product.

This chapter contains the following topics

In this
chapter

Topic See Page

What is IEC 61131-3? 20
Choosing a Language 21

GE Information SWM0018-3.00-4 19
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

3.2 What is IEC 61131-3?

Developed with the input of vendors, end-users and academics, the IEC 61131-3 consists
5 Parts of five parts:
• General Information
• Equipment and test requirements
• PLC programming languages
• User guidelines
• Communications

IEC 61131-3 is the international standard for programmable controller programming

International languages.
Standard It specifies the syntax, semantics and displays for these PLC programming languages:

Language Abbreviation
• Ladder Diagram LD
• Sequential Function Charts SFC
• Function Block Diagram FBD
• Structured Text ST
• Instruction List IL
LogicLinx Specific “Language”
• Flow Chart FC

The primary benefit of the standard is that it allows one or more of the languages to be
Primary used within the same project.
Benefit The programming language used would be selected based on which one is best suited for
a specific task

20 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

3.3 Choosing a Language

Each of the IEC 61131-3 languages is best suited for certain types of programming.
Suitability of
Language

Language Best Use

Ladder Diagram For users who understand relay controls, LD is the easiest to use
as a programming language.
Sequential Function SFC programming offers a graphical method of organizing a
Chart program.
The three main components of an SFC are steps, actions and
transitions.
• Steps are units of programming logic that accomplishes a
particular control task.
• Actions are the individual aspects of that task.
• Transitions are the mechanisms used to move from one task
to another.
Control logic for each Step, Action and Transition can be
programmed in one of the other languages, such as Ladder
Diagram or Structured Text.
Function Block FBD is a graphical language that allows programming in other
Diagram languages (ladder, instruction list, or structured text) to be nested
within the FBD.
Program elements appear as blocks that are "wired" together in a
manner resembling a circuit diagram.
FBD is most often used in applications that involve a high degree
of information/data flow between control components, such as
process control
Structured Text Because this programming language is similar in structure to
Pascal or Basic, users trained in computer programming often
find it the easiest language to use for programming control logic.
• Using symbolic addressing, ST programs resemble
sentences, making them easily understood by novice users.
• ST is good for tasks requiring complex calculations,
algorithms or decision-making.
• Programs can be created in any text Editor
• Runs as fast as ladder logic

Continued on next page

GE Information SWM0018-3.00-4 21
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Choosing a Language, Continued

Suitability of Language (continued)

Language Best Use

Instruction List This language, similar to Assembly language, is useful in cases
where routines are repeated many times.
Although it is powerful, it is considered to be difficult to learn.
LogicLinx Specific Language
Flow Chart Is a graphic language used to describe sequential operations.
A Flow Chart diagram is composed of Actions and Tests.
Between Actions and test are oriented links representing data
flow. Multiple connection links are used to represents
divergences and convergences.
Actions and Tests can be described with ST, LD or IL languages.
Functions and Function blocks of any language (except SFC) can
be called from actions and tests.

22 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

4. Project Planning

4.1 Overview

This chapter provides information that will help the programmer:

Introduction • set realistic performance expectations for a soft logic program
• effectively plan a soft logic project

This chapter contains the following topics

In this
chapter

Topic See Page

LogicLinx Performance 24
Planning a Soft Logic Project 25
Detailed Plan 26

GE Information SWM0018-3.00-4 23
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

4.2 LogicLinx Performance

The LogicLinx Executor is intended for use in real time, multi-tasking operating systems.
Background
Program memory usage and performance is therefore extremely application-dependent.
Prior to implementation, assess the capabilities of target devices to ensure that adequate
resources are available for the intended programs.

The amount of memory required on the target system will be defined by:
System • the size of the program being downloaded, and
Loading
• the amount of system I/O mapped into the program

The Executor will also be constrained by whatever limits are present in the existing
target system software. Some of these limits are:
• Number of applications, in addition to LogicLinx, that are concurrently running.
• Communications activity, LAN, VME and/or serial.

Soft logic program execution time will be dependent on the following:

Soft Logic • the number of instructions in the program;
Program
• the complexity of the instructions in the program;
Performance
• system activity;
• the amount of I/O data which must be updated at the start of the cycle, and operated
a the end of the execution cycle.

24 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

4.3 Planning a Soft Logic Project

Before embarking on a soft logic project, a detailed plan should be developed

Project
Planning

LogicLinx Programmer checks target device

Configuration for correct operation
Process Block Operating OK? Not operating
Diagram
Programmer configures and
tests devices without Executor

Engineering team plans SoftLogic

project

Programmer identifies I/O points to

be used in program

Programmer uses SGConfig to

enable and configure Executor

Programmer uses LogicLinx Editor

to edit/create SoftLogic program

Programmer uses LogicLinx Editor

Tools to test and/or debug program

Programmer downloads Softlogic

program to device

Programmer checks target device

for correct operation

Operating OK? Not operating

Engineering team accepts Softlogic

project

GE Information SWM0018-3.00-4 25
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

4.4 Detailed Plan

Below is a more detailed outline of a soft logic project plan.

Planning
Process

Stage Function Description

1. Programmer Checks It is highly recommended that the target device be
Device Operation fully configured and tested as a standard (i.e., no
soft logic program running) device before enabling
the LogicLinx DTA.
2. Engineering Team A typical project will evolve as a result of
plans soft logic Project requirements identified by a team.
This team will:
• set performance goals for project
• plan the “what-if” situations and safeguards
• outline testing procedures for the project
3. Programmer identifies As mentioned in the earlier section System Loading,
I/O points to be used in it is important to map into the DTA tables only the
program I/O points required for the project.
Careful planning at this stage will result in a more
optimized program.
4. Programmer enables Based on the plan now in place, the Executor tables
and configures the can now be configured in SGConfig.
LogicLinx DTA
Because SGConfig generates the information
(Executor)
required by the LogicLinx Editor, this stage must
be completed, and the configuration generated
before any soft logic programming can be started
5. Programmer uses
LogicLinx Editor to
edit/create a soft logic
program

Continued on next page

26 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Detailed Plan, Continued

Stage Function Description

1. Programmer uses The Editor is equipped with a variety of simulation
Editor tools to test and testing tools which help the programmer check
and/or debug program a program before downloading it to the device
2. Programmer Test tools available in:
downloads soft logic • WESMAINT
program to device
• LogicLinx Editor
• External simulation equipment
can be used to test project as outlined by
engineering team.
3. Programmer checks
device for correct
operation
4. Engineering team Project commissioned.
accepts soft logic
project

GE Information SWM0018-3.00-4 27
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

5. Installing LogicLinx

5.1 Overview

This chapter defines the system requirements and procedures for installing the
Introduction LogicLinx Editor.

This chapter contains the following topics

In this
chapter

Topic See Page

Editor Platform Requirements 29
Installing the Editor 30
Lab #1 - Installing the LogicLinx Editor 30

28 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

5.2 Editor Platform Requirements

It is highly recommended that the LogicLinx Editor be installed to the same PC that
Background SGConfig is installed.
This is suggested because the Executor (DTA) configuration files must be available to
the Editor so that you can map input and output points.

The LogicLinx Editor can be used on any PC that is currently running SGConfig.
The PC
Refer to SGConfig on-line documents or on-line help for detailed requirements.

Do not attempt to install the LogicLinx Editor or the LogicLinx Executor on platforms
! that are not supported by GE Digital Energy.

The Platform PC Must have a parallel port (LPT1) where the protection key (dongle) can
! be installed (LogicLinx Editor version 1.0, 1.1, or 1.2 only.)

GE Information SWM0018-3.00-4 29
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

5.3 Installing the Editor

Background While it is possible to install the Editor without loading SGConfig onto the same PC,
GE Digital Energy does not recommend this practice.
As you will see in the exercises to follow, files are created during the SGConfig
procedures that will subsequently be used by the LogicLinx Editor.

LogicLinx If you have already have the LogicLinx Editor Demo version installed on this PC, GE
Demo Digital Energy recommends that you remove or overwrite it to prevent conflict.

What is During installation of the 16-bit version, a dialog box will ask which of these options will
be loaded:
Installed?
• programs
• sample applications
• standard libraries
• help files
It is recommended that a first-time installation include all four options.
If you choose to install only part of the list, the other options can be installed later simply
by repeating the installation process.

5.3.1 LogicLinx Editor 1.x

Copy The Editor is fully enabled through the use of a security key, or “dongle”, that is
Protected connected to the parallel port of the host PC.

Sentinel In order for the security key to be recognized, a driver must be loaded into the PC’s
operating environment.
Driver
During installation, a prompt will ask you which type of Windows is running on the PC.
Once selected, and installed, you must re-start the PC to enable the driver.

5.3.2 LogixLinx Editor 2.x

Software The LogicLinx Editor version 2.0 and up is fully enabled through a software license.
Unlicensed Editors are only operable for 30 days. Projects created by unlicensed Editors
License are only accessible by the Editor that created it (before the 30 day trial period has ended)
or by a licensed Editor.

5.3.3 LogixLinx Editor 6.x

Software The LogicLinx Editor version 6.0 and up is fully enabled through a software license.
Unlicensed Editors are only operable for 60 days. Projects created by unlicensed Editors
License are accessible on any system.

30 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #1 - Installing the LogicLinx Editor

The following procedure shows the steps to install LogicLinx Editor version 1.x for the
Installation first time.
Procedure –
Version 1.x

Step Action
Install the Sentinel Driver
1 Insert the ConfigPro CD-ROM into the target PC.
2 If the installation dialog does not start itself automatically, use My
Computer or Windows Explorer to locate the HSETUP.EXE file on the
root folder of the CD-ROM.
Double-click the HSETUP.EXE file.
3 Click the LogicLinx tab.
4 Click the appropriate Sentinel driver option for your target PC.
5 Click Functions > Install Sentinel Driver from the menu bar.
Results: A dialog box will appear showing the path where the files will be
copied from.

6 Do Not change the path. Click OK.

7 Close all windows, and re-start the PC, as requested.
Installing the Editor
8 Repeat steps 1 to 3 after PC has been re-started.
9 Click the LogicLinx Editor icon.
10 Fully read the terms of the Software Site License.
If in agreement, click the Accept button at the bottom of the dialog box.
Results: a new dialog box will appear

11 Type the drive and path name where you wish to install the editor, and click
Install

Note: If a drive other than C:\ is chosen, the sample program

simulations will not work

12 Select or Clear the desired options from this dialog box, and click Install.

Results: When the installation is complete, a new program group will be

displayed showing all of the LogicLinx program icons.

Continued on next page

GE Information SWM0018-3.00-4 31
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #1 - Installing the LogicLinx Editor, Continued

The following procedure shows the steps to install LogicLinx Editor version 2.x for the
Installation first time.
Procedure –
Version 2.x

Step Action
Installing the Editor
1 Insert the ConfigPro CD-ROM into the target PC.
2 If the installation dialog does not start itself automatically, use My
Computer or Windows Explorer to locate the HSETUP.EXE file on the
root folder of the CD-ROM.
Double-click the HSETUP.EXE file.
3 Click the LogicLinx tab.
4 Click the LogicLinx Editor icon.

Continued on next page

32 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #1 - Installing the LogicLinx Editor, Continued

5 Fully read the terms of the Software Site License.

If in agreement, click the Accept button at the bottom of the dialog box.
Results: a new dialog box will appear

6 Type the drive and path name where you wish to install the editor, and click
Install

Note: If a drive other than C:\ is chosen, the sample program

simulations will not work

7 Select or Clear the desired options from this dialog box, and click Install.

Results: When the installation is complete, a new program group will be

displayed showing all of the LogicLinx program icons.

If you have purchased a license

1 Click Start > Programs > LogixLinx 2.x and select Licensing.
2 Follow the instructions to select a software license for the point count you
have purchased.
3 The tool will prepare an email to request your registration keys. In the field
labeled Your PO Number, type GE- followed by the serial number on your
license.
4 You will receive your registration keys by email. Launch the licensing tool
and enter the keys as instructed.

The following procedure shows the steps to install LogicLinx Editor version 6.x for the
Installation first time.
Procedure – Step Action
Version 6.x
Installing the Editor
1 Run the SGConfig 8.5 or higher installer and when prompted, select the
Custom installation type.
2 Select the LogicLinx Editor (32-bit) (trial version) in the Select Modules
page of the installation wizard.
3 Follow the prompts for the rest of the installer.
4 Do not select the option to install AnkhSVN when installing the editor
unless you have access to a Subversion server.

GE Information SWM0018-3.00-4 33
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

6. Before Configuring The LogicLinx DTA

(Executor)

6.1 Overview

If the soft logic plan has been completed thoroughly, the LogicLinx Executor
Introduction configuration data typically will only be created and loaded into the target device once.
This configuration data defines the quantity and type of system points that will be
available as inputs and outputs for the LogicLinx Editor to use in its program.
The configuration data will be translated into both the software configuration for the
Executor and into database files for the Editor.

This chapter contains the following topics

In this
chapter

Topic See Page

Understanding the Operation of the Executor 35
DTA Configuration Prerequisites 37
LogicLinx DTA Configuration Basics 38
Enabling the LogicLinx Application 39
Lab #3 - Enabling the Executor Application 40

34 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

6.2 Understanding the Operation of the Executor

The LogicLinx DTA, or Executor, is an application running in the GE Digital Energy

Background target device.
The program executes on a cyclic basis as defined by the Executor configuration.
It performs all program execution independently of the Editor, although the Editor can
modify execution on-line.

Program
Cycle Current values
Executor
of points are stored
scans system points
internally for use in
in I/O tables
program

LogicLinx
Start
Cycle
Program
Cycle
If output points of
Executor
appl's change, Executor
runs through
generates output
all programs
requests

Executing the program instructions is only part of what the Executor does.
Start of
At the start of each program cycle,
Cycle
• the devices’ system input and output data tables are scanned
• current values stored internally for use by the program.

At the end of the program cycle:

End of Cycle • all output variables changed during the course of the program execution are queued
for operation
• each updated output has an appropriate output request generated and sent to the
system for processing
• requested values are determined from the result of all operations performed on an
output during program execution..

Continued on next page

GE Information SWM0018-3.00-4 35
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Understanding the Operation of the Executor, Continued

LogicLinx programs will run concurrently with other protocols and applications running
Concurrent on the same device.
Operation

LogicLinx programs and operational parameters are stored in non-volatile memory

Non-Volatile (NVRAM) so that they can be restarted after a system reset without having to re-
download the program.

Any change to the device’s configuration, requiring a download from SGConfig, will
delete all LogicLinx program files from the target device’s NVRAM.
! The LogicLinx project Must be downloaded to the target device after any SGConfig
configuration updates.
Important
Refer to: 10.8 Embedding LogicLinx and SGConfig Configuration Files for more
information about configuration changes after embedding LogicLinx programs
into SGConfig downloadable files.

The LogicLinx Executor will not start executing any user programs until all enabled
All Other Data Collection Applications (DCAs) in the system are running.
DCAs Must As mentioned in section 4.3 Planning a Soft Logic Project, it is highly recommended that
Be Running the target device be fully configured and running before implementing a soft logic
application. If any of the DCAs are not running, the LogicLinx Executor will not be able
to communicate with the Editor.
If you find yourself unable to communicate with the Executor and are certain that your
communications are configured correctly, verify that no DCAs in the system have failed
or otherwise ceased processing.

36 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

6.3 DTA Configuration Prerequisites

The typical user will be a technician or engineer with system-level knowledge, who is
Knowledge responsible for implementing substation automation programs.
and • A working knowledge of GE Digital Energy products is imperative.
Responsibil- • Familiarity with the SGConfig 8.5 and later configuration utility is necessary, as it
ities will be used exclusively to edit the LogicLinx DTA parameters.

GE Information SWM0018-3.00-4 37
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

6.4 LogicLinx DTA Configuration Basics

The LogicLinx DTA configuration falls into five basic categories:

Overview • Enabling the B082 LogicLinx DTA application in the target device configuration.
• Configuring the System Point Database (WIN+)
• DCA Configuration Parameters;
• Communication Parameters;
• System Point Mapping Tables.
The configuration tables are used to generate data files used by the Editor as well, so
that all the configured variables appear in the Editor as they are configured in the
Executor.

Enabling the Executor signals the target device to add the application to its list of
Enabling programs to run upon startup.
B082 Once enabled, the application will be visible in the System Point Database manager,
referred to as WIN+.

Configuring WIN+ for the DCA consists of allocating system points to the DCA and
Configuring giving each one a point descriptor.
WIN+

The DCA Configuration Parameters include configuring WIN+ for the DCA part of the
DCA LogicLinx DTA and providing initialization parameters for DCA points.
Configuration
Parameters

The Communications Parameters specify the communications method to be used by the

Communica- Executor when connecting to the Editor, and any parameters required by that method.
tion
Parameters

The System Point Mapping Tables are used to define the system points that can be
Point accessed by the subsystem.
Mapping
Tables

38 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

6.5 Enabling the LogicLinx Application

Before any soft logic program can be created or configured, the B082 LogicLinx DTA
The First application must be present and enabled in the target device’s SGConfig configuration.
Step Enabling the application does three important things:
• Includes the application in the list of applications that the device will run upon
startup
• Allows you to configure all of the associated tables in SGConfig
• Allows you to define the operating parameters and the environmental variables that
the soft logic program will use as it runs in the Executor.

GE Information SWM0018-3.00-4 39
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

6.5.1 Lab #3 - Enabling the Executor Application

Before any configuration of the LogicLinx Executor tables can start, the application
Background must be enabled.

This Lab assumes that:

Assumptions
• The target device configuration files, including application definition files, are
loaded onto the PC
• The target device must have the B082 LogicLinx Executor application resident in
its firmware before any configuration can take place.
• If in doubt, check with GE Digital Energy representatives to verify that your device
is capable of running LogicLinx applications.

The following procedure shows the steps to enable the B082 application
Procedure

Step Action

1 Using SGConfig, open the Project that contains the target device.

2 Select the target device

3 Open the Application List dialog from the ribbon or by double-clicking on

the target device icon.

4 • If the LogicLinx application is disabled, the Enabled column will

indicate this.
• If the application is already enabled. The remaining steps of this
procedure can be skipped.
Right-click the LogicLinx application and click Enable Application(s) or
click on Enable Applications in the tool bar.

Results: The Enabled column will indicate that the application is now
enabled.

40 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

7. Setting-up the Executor in WIN

7.1 Overview

This chapter provides information to assist you in understanding the role of WIN in the
Introduction system, and how we will program WIN will be programmed for the LogicLinx
Executor.

This chapter contains the following topics

In this
chapter

Topic See Page

The System Point Database 42
Conversion Points 43
Point Descriptors 46
Lab #4 - Assigning System Points in WIN 47

GE Information SWM0018-3.00-4 41
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

7.2 The System Point Database: WIN+

LogicLinx can use any system points that are available in the device’s database as
Background input/output elements in a soft logic program.
Typically, these points are “owned” by other DTAs and DCAs running in the device.

Always configure the target platform’s System Point Database (WIN) prior to
Important implementing the LogicLinx project.
Failure to do so may result in significant re-work.

A LogicLinx program cannot:

A Rule • output to input points owned by other applications.
• read (the state of) output points owned by other applications

It must be assigned points that it can “own” so that it can output information for
transmission to a Master Station, or for other applications to use.

The LogicLinx DCA can “own” up to 32767 of each of these five point types:
Point Types • binary inputs
• binary outputs
• analog inputs
• analog outputs
• 32 bit transition accumulators

42 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

7.3 Conversion Points

Each of the five LogicLinx owned point types appear in the LogicLinx Editor with the
Opposite opposite data flow:
Flow I.e., outputs appear as inputs and vice versa.
This is done since the points owned by the LogicLinx DCA are used as user-driven
external inputs into soft logic programs being executed by the application, and as
indications or readouts provided by a soft logic program.
These "reflections" of the system points owned by LogicLinx are known as "conversion"
points.

There are five types of conversion points:

Conversion
Point Types

Point Type Function

DIC Digital Input Conversion:
Boolean output variables in the Editor directly related to WESDAC
database digital inputs owned by the Executor.
DOC Digital Output Conversion:
Boolean input variables in the Editor directly related to WESDAC
database digital outputs owned by the Executor.
AIC Analog Input Conversion:
Analog output variables in the Editor directly related to WESDAC
database analog inputs owned by the Executor.
AOC Analog Output Conversion:
Analog input variables in the Editor directly related to WESDAC
database analog outputs owned by the Executor.
CNC Transition Counter Conversion:
Analog output variables in the Editor directly related to WESDAC
database transition counter inputs owned by the Executor

Continued on next page

GE Information SWM0018-3.00-4 43
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Conversion Points, Continued

• are a complementary access to a system point.

Conversion • They exist Only in the Editor and are not represented in the System Point Database
Points • Do Not have to be mapped into the Executor mapping tables

• When you want to output to a LogicLinx “Owned” input point, they write to the
How are Conversion Point for that point (DIC, AIC or CNC).
Input • If you want to read the state of the LogicLinx point, read the standard input point
Conversion (DI, AI or CN).
Points
Used? As an example:

LogicLinx Editor LogicLinx Executor

Read
Mapped LogicLinx From
DI #1 Database

LogicLinx
DI #1
in WIN Database

DIC for LogicLinx Write

DI #1 to
Database

If you want a soft logic program to provide indications of its progress or to display
Soft Logic analog values created by the program, then the DCA’s owned inputs could be used as
Program outputs in the program.
Status or The program can write values to these points, which are then available to other
Value applications as binary and analog inputs.
Outputs

Continued on next page

44 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Conversion Points, Continued

• When you want to output to a LogicLinx “Owned” output point, write to the
How are standard output (DO or AO) point.
Output • If you want to read the state of the LogicLinx output point, read the Conversion
Conversion Point (DOC or AOC) for the point.
Points As an example:
Used?

LogicLinx Editor LogicLinx Executor

Write
to
Mapped LogicLinx
Database
DO #1

LogicLinx
DO #1
in WIN Database

DOC for LogicLinx Read

DO #1 From
Database

Binary and analog outputs may be operated by applications external to LogicLinx,

Inputs to thereby changing the value of an input into the soft logic program.
Soft Logic This can be done to:
Program
• change operational parameters (analog outputs) or ,
• to create "push buttons" (binary outputs)
As an example:
These output points could be used to enable or disable the operation of all or certain parts
of a soft logic program.

LogicLinx pseudo, or owned, points are available also as their declared data type, and
Note that not just as their opposite.
• These points can also be mapped into the application as standard inputs and outputs.
• This can enable a soft logic program to control values which it then reads elsewhere
in its execution
For example:
you can write a value to an analog input conversion point (AIC), then read it back as a
real input elsewhere in the program.

GE Information SWM0018-3.00-4 45
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

7.4 Point Descriptors

The standard system point descriptors used in WIN are text strings that are used to name
WIN Point system points, as they appear in WESMAINT.
Descriptions • These strings can be any length up to 40 characters.
• Can use almost any printable character

Actual (WIN) point descriptors appear in the "comment" field for variables in the
LogicLinx LogicLinx Editor, and a "tag name" is used to reference the variable in the Editor.
Editor The LogicLinx Editor has restrictions of:
Descriptors
• 16 characters maximum (16-bit version only)
• must have unique point names
• should include only letters, numbers and the underscore, and
• names must start with a letter, not a number.

Note: This tag name can be configured by the user, or left to SGConfig to generate
a default name.

Below is an example of the Boolean section of the Dictionary (Global Variables) for a
As They project. It shows the point descriptors and Tag names as defined in SGConfig.
Appear in
LogicLinx
Editor’s User-Defined SGConfig
Dictionary Tag Name Point
Descriptor

Default Tag
Name SGConfig
Auto-created
Conversion
Point
Descriptor
Conversion
Point Tag
Name

46 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

7.4.1 Lab #4 - Assigning System Points in WIN

This procedure outlines the configuration of the System Point Database to create data
Procedure points that will be owned by the LogicLinx application.

Step Action

1 Open the Project and the target Device in SGConfig

2 Open the Application List dialog.

3 Select the System Point Database and open it.

Results: A dialog box like the one below will appear:

4 Click (once) on the row displaying the LogicLinx data points

5 Click the Points button to display a dialog box where the quantity of points
of each type can be defined.
6 Type into each field the number of points of each type that the program will
own, and click OK when completed.
Note: It is not necessary to map all of the point types. If a point type is
not required, it can be left at 0.

7 Click the Descriptors button to display tables for each point type.

8 Edit the default point descriptors of all point types to reflect the
functionality of each point, and click OK to close this dialog box.
9 Click OK to complete the procedure

GE Information SWM0018-3.00-4 47
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8. The LogicLinx DTA: The Executor

8.1 Overview

This chapter assists the programmer in the configuration of the LogicLinx Executor.
Introduction

This chapter contains the following topics

In this
chapter

Topic See Page

Editing LogicLinx Executor Tables 49
The Point Mapping Tables 50
The Internal Transition Counters Table 52
Lab #5 - Configuring the Point Map Tables 53
Initialization and Control Type Tables 54
Digital Output Initial Values Table 55
Analog Output Initial Values Table (B082AOIN) 56
Control Type Table 57
Lab #6 - Configuring the Initialization Parameter Tables 59
The Executor’s Communications Parameters 62
Lab #7 - Configuring the Communications Table 65

48 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.2 Editing LogicLinx Executor Tables

The diagram below shows the 16 tables of the B082 LogicLinx Executor DTA
Background application.

The tables can be grouped into four logical groups:

• Point Mapping tables:
• Initialization parameter tables:
• Communication Parameter table
• Conversion Point Tags tables

GE Information SWM0018-3.00-4 49
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.3 The Point Mapping Tables

System point mapping tables are used to indicate which system points can be used or
Overview monitored by the LogicLinx subsystem.
There is a map table for all of the five standard system points, plus one that is used to
count selected digital input point state changes that occur between program cycles.

There are six mapping tables; each used to map system points for use in LogicLinx.
6 Map Tables They are:
• B082_DI Digital Input Mapping Table
• B082_DO Digital Output Mapping Table
• B082_CN Transition Counter Mapping Table
• B082_AI Analog Input Mapping Table
• B082_AO Analog Output Mapping Table
• B082_ITC Internal Transition Counters Table

All of these tables are optional.

! If your soft logic program does not use points of a certain type, then that point type's
mapping table can be disabled in SGConfig without causing any LogicLinx error.

Points are mapped into the application individually.

Mapping • SGConfig groups the points into blocks of 128 points, maximum. A maximum of
Guidelines 255 blocks of all point types (32640 points) is allowed (in the Pro version of the
Editor).
− The Basic version is limited to 256 points.
• In order to optimize the memory usage of the LogicLinx Executor, where possible,
try to keep the number of mapped points to a minimum.
− Mapping unused points wastes memory, and slows program execution.
− Having a few large blocks of points is better than having many blocks with a
small number of points each. Refer to Contiguous Point Grouping on page 51
for more detail on mapping.

Note: Conversion points are not mapped, but do count towards I/O limits.

Version 1.40 of the B082 LogicLinx DTA has removed the limit (previously set at 128)
Point on the number of points of each type. It is now possible to map 32767 points of each
Mapping type.
Limits
Continued on next page

50 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

The Point Mapping Tables, Continued

As shown above the maximum total number of points that can be mapped is limited by
Practical the LogicLinx Editor to 32640, not 32767 multiplied by the number of point types.
Limits Realistically, if either of these limits is approached the execution of the program will
load the system excessively.

When mapping points into your LogicLinx configuration, be aware that LogicLinx
Contiguous groups its data points together into contiguous blocks, and that a maximum of 256
Point contiguous blocks are allowed in the system.
Grouping If SGConfig reports that you have too many points mapped, it may be that you have
exceeded this limit. To compensate for this limitation, you can include unused points in
your point mapping to bridge the gap between contiguous blocks. This also saves on
system memory and improves LogicLinx performance.
Example:
A LogicLinx program is going to need binary input points 1 through 10, 12
through 21, and 23 through 30. If these points are configured as listed above,
LogicLinx will have 3 contiguous blocks defined. However, if the user also
mapped points 11 and 22, there would only be one block of 30 points.

All six mapping tables have the same structure. Each row in these tables has these fields:
Table
Structure

Field Name Description

Point Number The System Point Database point number of the point to be
mapped.
LogicLinx-owned points can be used, as well as points owned
by other DCAs.
Tag Name A user-defined tag name for the point, which determines how the
point will be referenced in the LogicLinx Editor.
If this field is left blank, SGConfig will generate a default tag
name.

The Tag Names assigned to a point are in 16-character unique strings, independent from
More about the Point Descriptions assigned to points in the System Point Database.
Tag Names Tag names are labels that will appear on points that are used as variables in a soft logic
program.
When choosing Tag Names for points, select names that reflect the functionality of the
point, to aid in programming with the LogicLinx Editor.

GE Information SWM0018-3.00-4 51
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.4 The Internal Transition Counters Table

An Internal Transition Counter (ITC) is used to count the state changes that occur on a
Overview digital input during one cycle of a soft logic program. This is done in order to catch (and
count) multiple changes of a digital input between program cycles.
During operation, an ITC counts the state changes of the digital input it is associated
with.
When the program enters its input update phase, the current count is transferred as the
value of the ITC for that cycle, and then the current count is zeroed, ready for the next
cycle.

When configuring the B082_ITC table, it is not necessary to map all of the points that
! are mapped in the B082_DI table.
For example:
If your program only needs to detect momentary changes of a specific digital input, but
the actual state of the DI is not required, the point only needs to be mapped into the ITC
table.

52 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.4.1 Lab #5 - Configuring the Point Map Tables

All six of the Point Map tables have the same structure. Each row of these tables has:
Background • a field identifying the selected system point
• a field where an identifying tag name can be entered

Point Tag Names:

Rules for • must be 16 characters or less
Creating Tag
• must Not begin with a number
Names
• must Not contain punctuation (except underscore) or spaces
• must be unique
• are case-sensitive
• Are optional. SGConfig will assign a default name if the field is left blank

GE Information SWM0018-3.00-4 53
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.5 Initialization and Control Type Tables

A Data Translation Application, or DTA is actually made up of components of a Data

Background Collection Application (DCA) and a Data Processing Application (DPA).
The references to a LogicLinx DCA are to illustrate the aspects of configuration of the
DCA component of the LogicLinx DTA

There are three tables which are used to further customize the operation of the
3 DCA LogicLinx DCA:
Tables • DCA Index Table (B082_DCA)
• Digital Output Initial Values Table (B082DOIN)
• Analog Output Initial Values Table (B082AOIN)

One configuration table is part of the DPA component of the application:

1 DPA Table • Digital Output Control Type Table (B082DOTY)

This is a read-only table that displays the index of the DCA, as it was defined by
DCA Index SGConfig when the device’s System Point Database was configured
Table
(B082_DCA)

54 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.5.1 Digital Output Initial Values Table

This table is used to optionally configure the initial state (ON or OFF) of the digital
Digital outputs owned by the LogicLinx DCA.
Output Initial • The default state is OFF for all digital outputs, so this table is used to configure those
Values Table points that will be ON at startup.
(B082DOIN) • Only the points that are to have an ON state at startup need to be configured - those
that are OFF at startup can be left out.
• If all points are to be OFF at startup, then this table can be disabled in SGConfig.

This table defines the structure of the B082DOIN Digital Output Initial Values Table.
Table
Structure

Field Name Description Options

System Point The system point number that is to be affected. any valid point
Number • Only digital output points owned by the number
LogicLinx DCA are allowed.
• SGConfig enforces this restriction.
Initial Value Defines the initial value of the digital output. either:
• It is NOT required that all outputs owned by the 0 (= OFF) or
DCA be given a configured initial state - only 1 (= ON).
those with an initial state of ON must be
configured.
• As the default state of all digital outputs is OFF,
it is redundant but harmless to configure any
outputs with an initial state of OFF.
Latch Defines whether or not to latch changes to the output either:
in this table. 0 (= OFF) or
• If this element is set to 0, then the variable will 1 (= ON).
be set to the initial value when the program is
started.
• If set to 1, then every time a data change occurs
to this point, the new value will be written to the
Initial Value field for this point so that the
variable is always set to its last recorded value
when the program is started.

GE Information SWM0018-3.00-4 55
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.5.2 Analog Output Initial Values Table

This table is used to optionally configure the initial value of the analog outputs owned by
Analog the LogicLinx DCA.
Output Initial The default value is zero for all analog outputs, so this table is used to configure those
Values Table points which will be non-zero at startup.
(B082AOIN)
Those which are zero at startup can be left out.
If all points are to be zero at startup, then this table can be disabled in SGConfig.

This table defines the structure of the B082AOIN Analog Output Initial Values Table.
Table
Structure

Field Name Description Options

System Point The system point number that is to be affected. any valid point
Number • Only analog output points owned by the number
LogicLinx DCA are allowed.
• SGConfig enforces this restriction.
Initial Value The initial value of the analog output, which can be signed 16-bit
any signed 16-bit value. integer:
• Is it NOT required that all outputs owned by the -32768 to
DCA be given a configured initial value – only +32767
those with a non-zero initial value must be
configured.
• As the default value of all analog outputs is zero,
it is redundant but harmless to configure any
outputs with an initial value of zero.
Latch Whether or not to latch changes to the output in this either:
table. 0 (= OFF) or
• If this element is set to 0 then the variable will be 1 (= ON).
set to the initial value when the program is
started.
• If set to 1, then every time a data change occurs
to this point, the new value will be written to the
Initial Value field for this point so that the
variable is always set to its last recorded value
when the program is started.

56 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.5.3 Control Type Table

Directly outputting to a mapped Digital Output point will result in an error unless the
Digital operation type is defined, because the target device will not know what type of control
Output Type output is desired.
Table The Control Type table allows the programmer to specify the following parameters.
(B082DOTY)
Field Name Description Options
Mapped DO The digital output point to any DO point in the BO82_DO table
be “typed”
Control Type Defines what type of • Latching
control will be generated − Output follows input state
when DO state changes
− Does Not use Control Duration
parameter
− Control request not generated if
point is in the requested state.
• Trip/Close Immediate
− 0 state = Trip
− 1 state = Close
• Trip/Close Paired
− Same as immediate, but control
only issued if previous trip/close
operation was the opposite
operation (i.e. trip can only follow
close and vice versa).
• Pulse
− 1 state = Pulse
• Latching, no state checking
− Same as latching, but bypasses
output state checking.
− Used if digital output owner does
not update point states fast enough
for the program cycle.
− Can result in excessive CPU
loading if your program does not
contain decision logic to prevent
the control operation from being
issued every cycle.

Continued on next page

GE Information SWM0018-3.00-4 57
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Control Type Table, Continued

Control Time in milliseconds that 1 – 1000000 milliseconds
Duration the control will continue
to operate after DO
changes state.

This table Must be configured if you use the LD Ladder Logic tools.
! Other types of program editing tools may be able to use the Operate Function Block
designed for the same purpose.
• The Operate Function Block will override any settings in the Control Type table.
• We recommend you configure the B082DOTY table to give yourself more flexibility
when programming.

58 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.5.3.1 Lab #6 - Configuring the Initialization Parameter Tables

There are three tables which are used to further customize the operation of the LogicLinx
Background DCA:
• Digital Output Initial Values Table (B082DOIN)
• Analog Output Initial Values Table (B082AOIN)
• Digital Output Type Table (B082DOTY)

• The configuration of either of the Initial Values tables is Not necessary if the desired
Notes: initial value for these points is zero.
• The Initial Values tables can be left empty, or disabled, with no negative affect on
the operation of the Executor

Follow this procedure to configure the Digital Output Initial Values Table.
Procedure

Step Action

1 Double-click the Digital Output Initial Values Table

2 If this is the first time that this table has been opened, the table will be
empty. Follow this step if this is the case.
• Click after positioning cursor over the first row below the gray title bar
containing the word Digital Output.
• If nothing appears, press ENTER
3 Press SPACEBAR
Results: A window displaying the list of points “owned” by the DTA will
appear.

4 Click on the row displaying the first point you wish to assign an initial
value, and click OK
5 Move cursor to field below Initial Value, and press SPACEBAR

6 Click desired option (or use arrows to select) and press SPACEBAR

7 Repeat steps 1 to 6 for all desired points.

Continued on next page

GE Information SWM0018-3.00-4 59
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #6 - Configuring the Initialization Parameter Tables, Continued

Follow this procedure to configure the Analog Output Initial Values Table.
Procedure

Step Action

1 Double-click the Analog Output Initial Values Table (B082AOIN)

2 If this is the first time that this table has been opened, the table will be
empty. Follow this step if this is the case.
• Click after positioning cursor over the first row below the gray title bar
containing the word Analog Output.
• If nothing appears, press ENTER
3 Press SPACEBAR
Results: A window displaying the list of points “owned” by the DTA will
appear.

4 Click on the row displaying the first point you wish to assign an initial
value, and click OK
5 Move cursor to field below Initial Value.

6 Type the desired initial value for this analog point.

Note: The value must be in the range of +32767 to -32768

7 Repeat steps 1 to 6 for all desired points.

Continued on next page

60 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #6 - Configuring the Initialization Parameter Tables, Continued

Follow this procedure to configure the Digital Output Type Table.

Procedure

Step Action

1 Double-click the Digital Output Type Table (B082DOTY)

2 If this is the first time that this table has been opened, the table will be
empty. Follow this step if this is the case.
• Click after positioning cursor over the first row below the gray title bar.
• If nothing appears, press ENTER
3 Click on the field just below Mapped DO in the gray title bar, and then
press SPACEBAR
Results: A window displaying the list of points previously mapped by the
DTA will appear.

4 Click on the row displaying the point you wish to define, and click OK

5 Move cursor to the field below the Control Type heading, and the press
SPACEBAR

6 Click on the control type option you desire, and press SPACEBAR again.

7 Move cursor to the field below the Control Duration heading. Type in the
“On” duration in milliseconds.
Note: This value is used only for Trip/Close and Pulse control types.

8 Repeat steps 1 to 7 for all digital output points.

GE Information SWM0018-3.00-4 61
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.6 The Executor’s Communications Parameters

The communication parameters indicate to the Executor the method that it will use to
Overview communicate with the Editor.

If you will use the front-panel WESMAINT port as the interface between the LogicLinx
! Editor and Executor, the values entered in the following table may be overridden by the
values assigned to the WESMAINT interface.

Note that only the available options are displayed in SGConfig (such as all available
Table parity types).
Structure

Field Name Description Options

Communication The type of communications available to link the
Type Editor to the Executor. This field can have one of
three values:

Serial Communications: 1
• The Executor will communicate with the Editor
via a single dedicated serial port.

WESMAINT Communications: 2
• The Executor will communicate with the Editor
by any available WESMAINT connection,
including direct serial, dial-up modem, or
TELNET.
Ethernet Communications: 3
• The Executor will communicate with the Editor
via a direct Ethernet connection.

Port Number The name or number of the communications port used

to link the Executor to the Editor.
The required information depends on the type of
communications specified in the previous field:
Direct Serial Communications: COM1 to
COMn
WESMAINT Communications: N/R
Ethernet Communications: 1100
• The required number must agree with the Ethernet
port number of the LogicLinx Editor.
• The default port number of the Editor is 1100.
Continued on next page

62 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

The Executor’s Communications Parameters, Continued

Table Structure (continued)

Field Name Description Options

Baud Rate The desired serial data rate; is only used for • 600
serial and WESMAINT communications. • 1200
Speeds supported by the LogicLinx Editor: • 2400
• 4800
• 9600
• 19200.
Data Bits The number of data bits per transmitted byte. • 5 bits /char.
• This is only used for serial and • 6 bits /char.
WESMAINT communications. • 7 bits /char.
• The available values are: • 8 bits /char.
Stop Bits The number of stop bits per transmitted byte. • 1 stop bit
• This is only used for serial and • 2 stop bits
WESMAINT communications.
• The available values are:
Flags The desired serial communications flow • Enable
control options. XON/XOFF
flow control
• This is only used for serial COMn
communications. • Enable RTS
• Not supported by direct COM0 serial • Enable CTS
WESMAINT access. • Enable DCD
• Any combination of these available flags
may be set.
Inter-character The timeout between received bytes, in
Timeout milliseconds.
This is only used for serial and WESMAINT
communications.

Continued on next page

GE Information SWM0018-3.00-4 63
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

The Executor’s Communications Parameters, Continued

Table Structure (continued)

Field Name Description Options

RTS ON Delay The time delay, in milliseconds, between the
assertion of RTS and the transmitter being
enabled to send data.
• Only required if communications is
serial, and half-duplex as communication
hardware dictates
• Not supported by direct COM0 serial
WESMAINT access.
• This value must be configured if the
serial port is defined as RS-485.
RTS OFF Delay The duration, in milliseconds, which the
transmitter must be idle before RTS is
dropped.
• Only required if communications is
serial, and half-duplex as communication
hardware dictates
• Not supported by direct COM0 serial
WESMAINT access.
• This value must be configured if the
serial port is defined as RS-485.
DCD ON Delay The time delay, in milliseconds, between the
assertion of DCD and the receiver being
enabled.
• Only required if communications is
serial, and half-duplex as communication
hardware dictates
• Not supported by direct COM0 serial
WESMAINT access.
Note: The receiver is disabled as soon as
DCD is dropped.

64 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

8.6.1 Lab #7 - Configuring the Communications Table

The Communications Table is used to define the method to be used to link the Editor
Background to the Executor for downloading configuration files and maintaining the soft logic
program.
The choices are:
• Serial, where a dedicated communication port on the target device will be used for
the link, or
• WESMAINT, where a user can first establish a connection to the WESMAINT
maintenance facility of the device, and then navigate to a menu where the
Editor/Executor link can be made.
• Ethernet will be discussed in a future version of this document.

The following steps define the B081_COM parameters:

Procedure

Step Action

1 Double-click the B082_COM table icon.

Results: A table similar to this one will appear:

2 Click on the field below the heading Communication Type, and press
SPACEBAR.

3 Click either Serial or WESMAINT as appropriate for your system, and

press SPACEBAR again.
4 • If Serial is chosen, move the cursor to the field below Port Number
and select the serial port to be used for the Editor/Executor link.
• If WESMAINT is chosen, the Port Number option will be disabled.
5 • If Serial is chosen, configure all other fields to match the settings of the
PC running the Editor.
• If WESMAINT is chosen, other fields will be used or ignored, based
on the communications method used to access WESMAINT.

When using a serial WESMAINT connection, if the speed of the LogicLinx

Note: communications is configured differently than that of WESMAINT, the
communications speed will change as configured.

GE Information SWM0018-3.00-4 65
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

8.7 Conversion Point Tag Tables

There are five additional tables used to name the LogicLinx variables associated with the
Background DCA conversion points owned by LogicLinx.
• All of these tables are optional.
If your soft logic program does not use any points of a certain type, then that type's
associated mapping table can be disabled in SGConfig without causing any error in
LogicLinx.

They are:
Five Tables • Analog input conversion point tag name table (AIC_TAGS)
• Analog output conversion point tag name table (AOC_TAGS)
• Transition counter conversion point tag name table (CNC_TAGS)
• Digital input conversion point tag name table (DIC_TAGS)
• Digital output conversion point tag name table (DOC_TAGS)

The conversion point tag name tables are not used to actually map the conversion points
Naming of into LogicLinx - this is done automatically.
Variables Instead, they provide you with a method of naming the LogicLinx Editor variables that
will be associated with the conversion points.
Note: Conversion points will always be mapped into the LogicLinx Editor.

66 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9. Using the LogicLinx Editor

9.1 Overview

This chapter introduces you to the Editor and provides information and exercises to
Introduction guide you in creating and running a simple soft logic Program.

This chapter contains the following topics

In this
chapter

Topic See Page

Tour of the Editor 68
Tips for the Advanced User 69
Lab #8 - Starting the LogicLinx Editor 70
Project Groups 71
Creating an Example Project File 72
Lab #9 - Creating an Example Project File 74
Verifying the Soft Logic Program 81
Simulation Testing a Soft Logic Program 83
Lab #10 - Verifying the Program 82
Simulation Testing a Soft Logic Program 83
Lab #11 - Simulating a Program’s Operation 84
Lab #12 – Define Run-time Options 87

GE Information SWM0018-3.00-4 67
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.2 Tour of the Editor

Once installed, the LogicLinx Editor can be started in two ways:

Starting the • By clicking on the Programs > LogicLinx > Projects icon from the Start menu of
Editor Windows
• By selecting the LogicLinx application in the Application List dialog in SGConfig,
and selecting the appropriate option from the toolbar.

If both the LogicLinx Editor and SGConfig have been installed onto the same PC, and
Which to their Properties have been setup correctly, it will be much easier to start LogicLinx
Use? from SGConfig.
• This is mainly due to the fact that SGConfig generates a list of variables that will be
available to the Editor when creating or editing programs. When the Editor is
started from a SGConfig Device icon, the link between the Editor and that device’s
list (dictionary) of variables will be automatically established.
• If the Editor is started independently of SGConfig, the user will have to search for
the Project manually.

68 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9.3 Tips for the Advanced User

Users that are becoming more familiar with the use of the Editor may find the following
Advanced tips helpful.
Tips

Tip Description
1 Do not attempt to create user-defined functions and function blocks using
standard function blocks.
The standard function blocks are described in the on-line documentation.
2 Do not attempt to create user-defined functions and function blocks using
other user-defined function blocks.
3 Never edit LogicLinx’s I/O Connection Editor for real I/O.
Real I/O is automatically made available using the target platform’s
SGConfig configuration tool.

GE Information SWM0018-3.00-4 69
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.3.1 Lab #8 - Starting the LogicLinx Editor

The following steps show two ways to start the LogicLinx Editor.
Procedure

Step Action
Start Via SGConfig (Recommended)

1 Start SGConfig, and navigate to the Device icon that will be used for the
LogicLinx application
2 Open the Application List dialog.

3 Right-click the LogicLinx application.

4 Select LogicLinx Editor from the menu.

Start Via Windows

1 Click the Windows Start button

2 Click Programs

3 Click the LogicLinx menu item

4 Click the Projects icon (16-bit version only)

70 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9.4 Project Groups (16-bit version only)

A Project Group corresponds to one set of soft logic Projects that run on a specific
The “Project target device.
Group” • each Program of a Project can be created with a different programming tool, or
Defined language.
• The Programs work together to provide the functionality of the soft logic Project.

There are at least two Project Groups installed when LogicLinx is installed:
Project • Default, and
Groups
• Sample

Other groups will be present as you create new applications.

will Not be used by SGConfig, but can be used for tests, prototypes, etc.
Default
Group

Contains a list of example programs that are referred to in the LogicLinx User’s Guide as
Sample a training aid.
Project
Group

The Editor allows for the removal of individual programs from Project Groups, but
Deleting does Not allow for the removal of the groups themselves from the Editor menus.
Project • If the LogicLinx files are stored in the SGConfig device directories, the Project
Groups Groups will be deleted if a SGConfig Device is deleted.
• If you want to remove any other unused Project Groups from the menus, simply
edit the Groups section of the ISA.INI file located in the C:\LGCLNX\EXE
directory.

Each of the five Editor languages supports different operators and operands.
Supported
Refer to the LogicLinx User’s Guide for detailed information.
Operands &
Operators

GE Information SWM0018-3.00-4 71
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.5 Creating an Example Project File

This part of the chapter will outline the process used to create an example of a soft logic
Overview application.
It is assumed that the planning steps outlined in 4.3 Planning a Soft Logic Project have
been completed up to and including, Enabling and Configuring the Executor.
Programmer checks Target
Device

Operating OK? Not Operating

Programmer configures and

Tests Device w/out Executor

Engineering Team Plans

SoftLogic Project

Programmer identifies I/O Points

to be used in Program

Programmer uses ConfigPro to

enable and configure Executor

Programmer uses LogicLinx Editor

to Edit/create SoftLogic program

Programmer uses Editor Tools to

test and/or debug program

Programmer downloads SoftLogic

Program to device

Programmer checks device for

correct operation

Operating OK? Not Operating

Engineering Team accepts

SoftLogic Project

Merge LogicLinx and ConfigPro

Configuration Files

Before starting the LogicLinx Editor, verify that the SGConfig device has been
Before generated, verifying that there are no logical errors in the device configuration.
Proceeding This step will generate the lists of variables that will be available to the Editor when
programming begins.

Failure to generate the SGConfig Device will prevent the Editor from starting from
Note: within the SGConfig device menus.

Continued on next page

72 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Creating an Example Project File, Continued

Refer to the procedure outlined in the document: following Lab #9 to start up the Editor.
Stating the
Once running, the following dialog box will be displayed:
Editor

Project Program
Name Group

Part Function
Project Name: Project Name is automatically created by SGConfig when
MAIN device was generated.
• The name MAIN indicates a single-node device, such as a
D25 or D20
Program Group: The Program Group, D25_LL, is the same as the device name
D25_LL assigned in SGConfig

Opening the Project > MAIN will reveal a list of the Programs that have been created
Opening the to run on this device. It also allows the programmer to edit, delete or create new
Project programs.

GE Information SWM0018-3.00-4 73
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.5.1 Lab #9 - Creating an Example Project File

The following procedure outlines the steps that can be used to create a simple program
Objectives that will:
• compare two analog values, and
• toggle a digital output depending on which analog is greater in value.

Follow these steps to create a sample soft logic project.

Procedure

Step Action
This Procedure continues from previous steps

1 This dialog box should still be displayed on screen:

Double-click the MAIN icon to open the Project

2 If this is as a new project, the dialog box that appears should be empty, with
no Programs listed.
Click the New Program icon, shown by the arrow.

New Program Icon

Results: The New Program dialog box will appear.

Continued on next page

74 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action

3 Type a logical Program Name into the Name field.

4 Select FBD: Function Block Diagram as the editor Language to use for
this program. Click OK.
Results: The Program Group dialog box will now have an icon
representing the new Program.
Create the Program

5 Double-click the Program icon to start the FBD/LD editor

Continued on next page

GE Information SWM0018-3.00-4 75
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action

6 Click the icon shown by the arrow to switch the editor window from the
default LD (ladder) mode to the FBD (Function Block Diagram) mode.

Display
Toolbar

Results: The FBD Toolbar will now be visible

7 Click the Function Block selection box shown by the arrow to display the
choice of blocks that are available.
Step 7

Step 9

8 Select the Less Than function block

9 Click the Insert Function Block icon once

10 Position the cursor over the workspace and click the mouse button once.
Results: You will see a display similar to the one show below.

Continued on next page

76 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action

11 Click the Toolbar Switch button as in Step 6, above.

Results display the LD editing tools.

Add Input Variables

12 Click the Insert Variable button once, as shown by the arrow.

Insert
Variable

13 Position the cursor well to the left of the function block and click the mouse
button once.
Notice: if the cursor is too close to the function block when the mouse is
clicked, a warning message will tell you that you cannot overlap
graphic symbols
Results: The Select Variable dialog box should now be on screen,
displaying all of the Boolean (binary) variables that are available
to the editor:

Continued on next page

GE Information SWM0018-3.00-4 77
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action

14 Click the button indicated by the arrow to display the Integer/Real

variables.

Integer /
Real

15 Select a variable that begins with AI, and is “owned” by the LogicLinx
executor.
16 Repeat steps 13 to 16 once more, using a different analog input variable,
positioning both analog input variables to the left of the function block.
The editor window should now look something like this:

Continued on next page

78 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action
Link Input Variables to Function Block

17 Click once on the Draw Connection Line button, as shown by the arrow.

Draw
Connection Line

18 Draw connector lines from the right side of the input variables to the IN1
and IN2 points on the left of the function block.
Note: You do not have to click the button between drawing successive
connector lines.

Add Digital Output

19 Click once on the Insert Direct Coil icon as shown by arrow, below:

Insert Direct
Coil

Continued on next page

GE Information SWM0018-3.00-4 79
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #9 - Creating an Example Project File, Continued

Procedure (continued)

Step Action

20 Click once to the right of the function block

21 Draw connector line, as in Step 19, to link the Q of the function block with
the output coil.
Results: The program should now look similar to the diagram in Step 19.

22 Double-click the output coil to bring up a dialog box.

23 Click Browse to select the variables available in the dictionary.

24 Click Boolean if it is not selected already

25 Click on a DO point that represents a physical output control relay.

Results: The program should now look something like the one below:

Note: The point numbers shown in the examples in this document will
not be the same as the numbers you will see in your exercise

80 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9.6 Verifying the Soft Logic Program

Once a program is completed, the next step is to Verify the program. The process of
Overview of verification:
Verifying • checks the program for logical errors
• generates the downloadable file (for this program)
• readies the program for the next steps: the simulation procedure

When a program is verified, it can create output files in several formats. The two file
Output file types that should be used for this system are:
formats • SIMULATE: Workbench Simulator
− This file type is used by the Editor during program simulation
• ISA68M: TIC code for Motorola
− This file type conforms to the type required by the 68XXX series Motorola
microprocessors used in GE Digital Energy products

Verifying is used to check only the Program that is being displayed during the
Verifying vs. verification
Making Making is used when a Project contains more that one Program.
• Making will check that all programs are verified, then it will check them for
operation as an integrated system of programs.
• If a Project has only one Program, then there is very little difference between the
two processes.

LogicLinx programs can be extracted, or uploaded, from the target platform only if you
Uploading have selected this option during making of the application.
Programs

If a project compiles without errors but does not function in the manner you intended, in
Important all likelihood a programming error was made.
The available simulation tools can help you identify the error(s).

The User’s Guide includes a complete set of error codes. These error codes will point
Error Codes you to the nature of the problem.

GE Information SWM0018-3.00-4 81
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.6.1 Lab #10 - Verifying the Program

The following procedure can only be performed as a continuation of a programming

Prerequisites procedure like the one on the previous page.

The following procedure outlines the verification of a program.

Procedure

Step Action

1 Click Make > Compiler Options from the Programs window.

Results: The Compiler Options dialog box will open.

2 Click the ISA86M: TIC code for Motorola and click Select.

3 Click the Verify Program icon from the LogicLinx Editor’ Program
window.

Verify
Program

Results: A dialog box will open, showing the progress of the verification
process.

4 If the verification is successful, click Exit when prompted to Exit the Code
Generator?
If the verification is Not successful, go back to the program editor and repair
the program.

82 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9.7 Simulation Testing a Soft Logic Program

Once a program is successfully verified, the program operation can be simulated before
Background the program is downloaded and put into real operation.

It is important to remember that while simulation is a useful tool to use in developing a

About program, it does not provide:
Simulating • information on how system loading will affect a program
• feedback on how physical hardware influences will affect the program.

Simulation scripts and Spotlight animations can be moved from one project to another
Simulation using standard Windows file management tools.
Tip

LogicLinx’s simulation tools simulate the functionality of the LogicLinx Executor but
Limitations do not simulate the Executor’s performance on the target platform.
of Simulation is therefore not a replacement for thorough debugging on the target platform.
Simulating
Note: The LogicLinx simulator cannot simulate programs larger than 64K in size.

The procedure found in the following section assumes that the programmer has
Procedure completed the preceding procedures, or equivalent, and the LogicLinx Editor still
displays the Program window.

GE Information SWM0018-3.00-4 83
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.7.1 Lab #11 - Simulating a Program’s Operation

The following is an example of a procedure that can be used to simulate the operation of
Procedure a program.
Remember: The variable names used in these examples will Not be the same as you
will see in your program.

Step Action

1 Click the Simulate Program icon from the LogicLinx Editor’ Program
window.

Simulate
Program

Results: Two new windows will open:

- the MAIN window shows a graphical representation of the
states of the points available to the programmer, as well as
buttons that can artificially change the values and states of the
points.
- the Debugger window provides tools to change the operational
parameters of the program.
- the Program window will change to show the program
components in different colors.

2 Re-size the new windows to best display the information required for your
testing.
Results: The Program, Debugger and Main windows will be visible, as
shown below.

Continued on next page

84 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #11 - Simulating a Program’s Operation, Continued

Procedure (continued)

Step Action

3 Click the down control beside the AI3577 symbol on the main window,
until a negative value shows in the field beside it.
Force
DO243 AI3577 to a
is ON Neg. Value

DO243 is
RED =
ON

Results: When the input value in IN1 is less than that on IN2, the DO243
will change state, as represented by:

- the LED simulation on the main window, and

- the DO243 graphic symbol on the Program window will
change to red.

4 If the simulation operates successfully, close the Debugger window.

Results: Simulation windows will close, and the Editor will revert back to
programming mode.

GE Information SWM0018-3.00-4 85
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

9.8 Changes to Cycle and Communications Times

The program applications running in the device must share the resources of the
Background microprocessor system. It is important that the LogicLinx Executor does not take too
much of these resources, or it may actually cause other applications to time-out and fail.
If this happens, the device will restart repeatedly, never coming into service.
In order to prevent this situation, it is suggested that a delay be inserted between each
cycle of the soft logic program.
Once the optimum run-time Program Cycle and Communications time-out times have
been determined, they should be permanently defined into the Project files.

There is no fool-proof way to estimate the cycle time of a LogicLinx Program, so it is

Estimating best to make a guess that is purposely larger necessary, and then “tune” it down after the
the Cycle program is actually running.
Time The Lab #18 – Adjusting Run-time Options: Program Running outlines how to optimize
the cycle times.
Suggested initial cycle time settings:
• 100 ms for a small program
• 500 ms for a very large program.

• Changes to any LogicLinx Program may affect the time it takes to run a complete
Note: Project.
• Changes to any other application in the device may affect the time that the
LogicLinx Project takes to run.
After any changes such as these, check that the LogicLinx run-time options are
optimally set.

86 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

9.8.1 Lab #12 – Define Run-time Options

Follow this procedure to initially define the Run-time options.

Procedure

Step Action

1 Open the Project Group to display the (list of) Programs for this Project.

2 Click Make > Application Run-time Options.

Results: the dialog box shown below is opened.

3 Select Trigger cycles, if not selected by default.

4 Type an approximate value into the Cycle Timing (ms) field

5 Select Real time option in the Starting Mode section to ensure that the
program runs continuously when started.
6 Select the Run time errors options as desired, if error logging is required.

7 Click OK to close dialog box.

8 Click Make > Make application to verify and compile Project files.

GE Information SWM0018-3.00-4 87
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10. The Editor / Executor Link

10.1 Overview

There are two primary ways to link the Editor to the Executor to perform downloading
Introduction and project maintenance duties:
• Via a dedicated communications link, either serial or Ethernet
• Through a WESMAINT connection, either locally (serial) or through a LAN
TELNET session.
It is also possible to establish a link using the Virtual Terminal facility, but operation of
Virtual Terminal will not be discussed in this document.

This chapter contains the following topics

In this
chapter

Topic See Page

Choices of Editor/Executor Link 89
Lab #13 - Configuring for a Direct Serial Editor/Executor Link 91
Lab #14 - Connecting the Editor to the Executor: Serial 92
Lab #15 - Configuring an Editor/Executor Link via 94
Lab #16 - Connecting the Editor to the Executor: 96
Using the Editor / Executor Link: the Debug Menu 98
Lab #17 - Downloading and Running LogicLinx Project Files 99
Run-Time Adjustments 101
Lab #18 – Adjusting Run-time Options: Program Running 102
Permanent Changes to Cycle and Communications Times 103
Lab #19 – Permanently Define Run-time Options 104
Testing With Debug 105
Lab #20 - Returning to WESMAINT from a LogicLinx Session 106
LogicLinx Project Maintenance 107
Embedding LogicLinx and SGConfig Configuration Files 108
Lab #21 – Embedding Configuration Files 109

88 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.2 Choices of Editor/Executor Link

There are three main choices in ways to link the LogicLinx Editor to the LogicLinx
Three Main Executor:
Options • Directly from the Editor’s PC serial (RS232) communication port to an unused
communication port on the target device
• Via a WESMAINT session, which provides for three other options:
− Local serial, directly interfaced with the device’s front panel WESMAINT
interface.
− Remotely, via a serial (dial-up or dedicated) modem connection, or
− Remotely, via an Ethernet LAN/TCP/IP link using TELNET
• Direct Ethernet LAN/TCP/IP link, using WINSOCK of the PC. will be discussed
elsewhere.

The following table outlines some advantages and disadvantages of each option.
Advantages /
Disadvant-
ages

Connection Advantages Disadvantages

Type
Direct Serial WESMAINT is still available as Very difficult to setup for remote
a testing / monitoring interface access.
while the Editor and Executor
Requires two interface cables
are linked

Via Single connection cable or link Switching between Editor /

WESMAINT Executor link and WESMAINT is
Easier to setup as a remote
cumbersome
access facility

When you specify WESMAINT as the communications link for LogicLinx, you make
Connecting LogicLinx available over all WESMAINT communications links which have been
Via configured for that application.
WESMAINT This means that other standard (i.e. non-WESMAINT) serial ports, dial-up ports, and
TELNET ports are all available to be used for other applications.

Connection from the LogicLinx Editor to the Executor can only be made via one of
Note: these links at a time.

Continued on next page

GE Information SWM0018-3.00-4 89
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Choices of Editor/Executor Link, Continued

Before a project can be downloaded to a target device, the communication parameters

The Commu- of the Editor must be setup to match the configuration of the device’s interface.
nication • Communication parameters (baud rate, parity...) must be set from the Debug >
Parameters Link Setup menu of the LogicLinx Project window.
• There is also a Link Setup icon on the tool bar.

The Editor’s communication parameters cannot be defined if the project is in Simulate

Note: mode.

The following table describes the options available to the LogicLinx Editor.
Communica-
tion Options

Parameter Function Options

Target Slave can be from 1 to 255 (except 13) Must be set to 1
Number
Communication Selects the PC interface to be used to COM1 to COM4, and
Port establish the Editor to Executor link Ethernet
Time-out the maximum time in seconds for the default = 2
debugger to respond to a question
Retries the number of automatic trials the default = 1
debugger executes before signaling a
communication error.
Setup (in serial A dialog opens where these parameters can be defined:
mode) • Baud rate 600 to 19,200 Bps
• Parity None, Even, or Odd
• Format 7 or 8 Bits,
1 or 2 Stop Bits
• Flow Control None or Hardware
Setup (in Ethernet A dialog opens where these parameters can be defined:
mode) • Internet Address any valid IP address
• Port number 1100, = port number
of Executor

90 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.2.1 Lab #13 - Configuring for a Direct Serial Editor/Executor Link

A direct serial link can only be established if the device has an unused communication
Background port.
The cable required for this link would be a standard DTE to DTE RS232 cable. This
type of cable may also be referred to as a null-modem or crossover cable.

The following procedure outlines the steps used to configure a direct serial Editor
Procedure (Windows PC) to Executor (device) link.

Step Action

1 Follow the steps outline in Chapter 2: Configuring the Communications

Table for defining the target device for a serial connection.
2 Physically connect a cable, as described in Background above, from the
designated communication port on the device to an available
communication port on the PC.
3 Click Debug > Link Setup from the Programs window menu bar.

Results: A PC-PLC Link Parameters dialog box will appear.

4 Select the appropriate communication port for your PC.

5 Click Setup
Results: A Serial Link Parameters dialog box will open.

6 Set communications parameters to match those defined in Step 1 of this

procedure, and click OK.
7 Click OK again to close the Setup windows.

GE Information SWM0018-3.00-4 91
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.2.2 Lab #14 - Connecting the Editor to the Executor: Serial

The following procedure outlines the steps in establishing a direct serial Editor
Procedure (Windows PC) to Executor (device) link.

Step Select Action

Start LogicLinx Editor

1 Double-click the Device icon that will be used for the LogicLinx
application
2 Right-click the LogicLinx application

3 Select LogicLinx Editor (Debug) from the menu.

4 Double-click the MAIN project icon

5 If there is more than one program, click once on the desired program.

Continued on next page

92 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #14 - Connecting the Editor to the Executor: Serial, Continued

Procedure (continued)

Step Action

6 Click Debug > Debug from the Programs window menu bar.

Results: the Debugger dialog box will appear. The display will tell you if
communications is successful, and if a program is running, or not
present.

Now that the connection is established, proceed to the section: Lab #17 - Downloading
Using Debug and Running LogicLinx Project Files

GE Information SWM0018-3.00-4 93
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.2.3 Lab #15 - Configuring an Editor/Executor Link via WESMAINT

A link can be established for any user that has rights to access the LogicLinx
Background Application menu in WESMAINT.
Access to WESMAINT can be direct, i.e., via the front panel WESMAINT DB-9
interface, or through any other indirect means, such as dial-up or Ethernet LAN.
The cable required for the direct link will be a standard WESMAINT serial cable.

The following procedure outlines the steps in configuring and accessing the Editor
Procedure (Windows PC) to Executor (device) link via WESMAINT.

Step Action
Configure the Device’s B082 Tables

1 Follow the steps outlined in 8.6.1 Lab #7 - Configuring the Communications

Table for defining the target device for a WESMAINT connection.
Setup the LogicLinx Editor Communication Parameters

2 Click Debug > Link Setup from the Programs window menu bar.

Results: A PC-PLC Link Parameters dialog box will appear.

3 Select the same communication port that will be used by the WESMAINT
connection from your PC.
4 Click Setup
Results: A Serial Link Parameters dialog box will open.

5 Set communications parameters to match those defined in Step 1 of this

procedure, and click OK.
6 Click OK again to close the Setup windows.
Configure the Device’s B014 WESMAINT Tables

7 Open the target Project > Device using SGConfig.

Continued on next page

94 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #15 - Configuring an Editor/Executor Link via WESMAINT, Continued

Procedure (continued)

Step Action

8 Open the Application List dialog.

9 Double-click the WESMAINT application, and open the User

Configuration Table.
10 Move across the table until the Application Control field is highlighted,
and press SPACEBAR
Results: The Access Flags table will be opened

11 Type 32082 into one of the unused fields under the Application Number
heading, and click OK

Note: all fields in the row to the right of the application number must be
set to Enable.

12 Click the Close Window button to close the WESMAINT application

dialog boxes.
13 Click the Generate button to create the downloadable file.

14 Go on-line with the device’ WESMAINT facility, and download the new
configuration file.
15 Restart the device, and verify correct operation.

GE Information SWM0018-3.00-4 95
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.2.4 Lab #16 - Connecting the Editor to the Executor: WESMAINT

There are several different ways and sequences that will work equally well in
Background establishing the communication between the LogicLinx Editor and the Executor
running in the device.
The one outlined here will start by assuming that the Editor is Not running during the
first steps of the procedure.

The following procedure shows steps that will establish the LogicLinx Editor to
Procedure Executor connection, via WESMAINT.

Step Action
Access B082 in WESMAINT Applications Menu

1 Log into WESMAINT and navigate to the Applications menu.

Results: An option labeled B082 LogicLinx Comms will be displayed.

2 Move the cursor to the B082 LogicLinx Comms entry and press ENTER.
Results: The display will go blank, and will not respond to the typing of
normal keyboard characters

3 If the WESMAINT connection is serial, click the Close Window button on

the SGConfig Tool Bar
Important: Failure to close the window will result in a communications
port conflict in the PC, preventing the LogicLinx Editor from
communicating.
4 If the WESMAINT connection is via TELNET, Do Not disconnect (close)
the WESMAINT window.
Important The communications link, or TELNET session, is maintained by
WESMAINT. Closing the window will disconnect the Editor
as well.

Start LogicLinx Editor

5 Double-click the Device icon that will be used for the LogicLinx
application
6 Right-click the LogicLinx application

Continued on next page

96 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Lab #16 - Connecting the Editor to the Executor: WESMAINT, Continued

Procedure (continued)

Step Action

7 Select LogicLinx Editor (Debug) from the menu.

8 Double-click the MAIN project icon

9 If there is more than one program, click once on the desired program.

10 Click Debug > Debug from the Programs window menu bar.

Results: the Debugger dialog box will appear. The display will tell you if
communications is successful, and if a program is running, or not
present.

GE Information SWM0018-3.00-4 97
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.3 Using the Editor / Executor Link: the Debug Menu

Once connected, the Editor / Executor link has two primary functions:
Two Uses • provides a means where the Editor’s program output file can be transferred to the
NVRAM of the target device.
• gives programmer an interface where running programs can be monitored, tested and
have run-time options adjusted.

Downloading of LogicLinx soft logic programs will have to performed for several
When to reasons:
Download • A new soft logic program has been created, and it needs to be installed into the
device’s memory.
• An existing program has been modified.
• A configuration change to other applications in the device demanded that a new
SGConfig configuration file be downloaded.

Any time a device has a configuration file change, the LogicLinx project files will have
! to be updated by performing a LogicLinx project download.
Another alternative is to perform an embed procedure following the configuration
change. See Lab #21 – Embedding Configuration Files for more details
Important This is due to the fact that any SGConfig configuration file download process starts by
erasing the entire non-volatile memory (NVRAM) of the target device. Because
LogicLinx project files are also maintained in NVRAM, they are erased as well.
Any changes to SGConfig point mapping should prompt a re-compile of LogicLinx
programs prior to download.

98 SWM0018-3.00-4 GE Information
 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.3.1 Lab #17 - Downloading and Running LogicLinx Project Files

Before a download can be started, communication between the LogicLinx Editor and
Background Executor must be established.
If you have not yet done so, refer to previous sections of this chapter to find procedures
that will guide you to establishing this connection.

The download procedure can be started once communication between the Editor and
Procedure Executor has been established. Refer to previous procedures for help in establishing this
link.
Start this procedure from the open Debugger window.

Step Action
1 If a program is already running, as shown in the example below, click the
Stop Application button, and acknowledge by clicking Yes.

Download

Stop
Application

Results: The Debugger window will display No Application indicating

that it is no longer executing.

2 Click the Download button to start downloading a new soft logic program.
Results: A dialog box appears prompting you to select the file type to
download.

3 Click ISA68M: TIC Code for Motorola, and click Download.

Results: a progress display shows the download taking place. When
complete, the program should automatically start, as shown by
RUN in the Debugger window.

Continued on next page

GE Information SWM0018-3.00-4 99
LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #17 - Downloading and Running LogicLinx Project Files, Continued

Procedure (continued)

Step Action
Viewing the Program in Operation
4 Double-click the program icon from the Debug Programs dialog.

Results: The FDB/LD Program window will open, showing the elements
in color to represent their states

100 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.4 Run-Time Adjustments

After a new or replaced project has been downloaded, it may be necessary to adjust some
After of the runtime parameters, as well as some of the communication parameters to control
Downloading how the Editor is updated while on-line with the Executor.

The Cycle time of a program may be adjusted for several reasons. These may include:
Program • Provide enough time between LogicLinx program cycles for other device
Cycle Time applications to run.
• Reduce the processing load on the device
• Use the cycle time as part of the processing interval of a program.

• Set the minimum time to at least 10 ms more than the maximum time shown in the
Rules for Debugger window
Setting • If the overflow count (in the Debugger window) increments at all, during run-time,
Cycle Time increase the cycle time by at least 10 ms
• If the cycle time is set to a value >500 ms, check the Debugger > Options >
Parameters settings.

Overflow count is actually the number of times that an overflow has occurred since the
More on count has been reset.
Overflow At startup, it is normal for a small number of overflows to occur while other applications
Count are initializing.
If the count is continually incrementing (overflowing) during run-time, increase the cycle
time as mentioned above.

If the Debugger > Options > Parameters settings for Cyclic Refresh Duration are set
Rules for too small, the Editor may think that the Executor has stopped operating in systems
Communica- using a large cycle time.
tions Time- Rules: Always set the Cyclic Refresh Duration to a value that is greater than the
out Options Cycle Time.

Set the Communications Time-out to a value at least 2 X the Cycle Refresh

Duration.

GE Information SWM0018-3.00-4 101

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.4.1 Lab #18 – Adjusting Run-time Options: Program Running

Follow this procedure to adjust the LogicLinx Program cycle time while program is
Procedure running.
Note: This procedure starts with a running application, like the state it would be in at
the end of Lab #16

Step Action
1 Click Control > Change Cycle Timing from the Debugger window tool
bar.
2 Type a Cycle timing value into the field that is about 10 ms larger that the
Maximum value that is displayed in the Debugger window, and click OK

Result: The value in the Allowed = field will reflect the change

Warning: Setting this value too small may result in other applications not
being allowed time to run properly, possibly causing system re-
starts.

3 If the Cycle time is set to a very large (>500 ms) interval, click Options >
Parameters and set the Cyclic refresh duration to a value larger than the
cycle time.

Warning: failure to do this step will cause communication drop-out between

program cycles.

102 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.5 Permanent Changes to Cycle and Communications Times

Once the optimum run-time Program Cycle and Communications time-out times have
Make been determined, they should be permanently defined into the Project files.
Changes This means that the device would not require further adjustment after any future
Permanent download of a LogicLinx Project.

• Changes to any LogicLinx Program may affect the time it takes to run a complete
Remember: Project.
• Changes to any other application in the device may affect the time that the
LogicLinx Project takes to run.
After any changes such as these, check that the LogicLinx run-time options are
optimally set.

GE Information SWM0018-3.00-4 103

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.5.1 Lab #19 – Permanently Define Run-time Options

Follow this procedure to permanently define the Run-time options.

Procedure

Step Action

1 Repeat Lab #12 – Define Run-time Options up to Step 4

2 Use the values determined in Lab #18 – Adjusting Run-time Options:

Program Running to set the run-time option variables.
3 Verify and download the updated configuration.

104 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.6 Testing With Debug

The LogicLinx Editor has several utilities that can be employed to monitor and control a
General program while it is running:
• the Debug > Tools > Spy Lists can be used to create a custom list of the input and
output variables used in a program.
• the Debug > Tools > Spotlight can be used to create graphic displays showing the
states of the program variables
• the Project > I/O Connection lists all of the variables, and their states, used in a
project
− For all of these utilities, the states of the (input) variables can be forced to test
program operation

It is possible to maintain the Editor / Executor link indefinitely, depending on the

Disconnec- communications technique used.
ting the There may be a few reasons why this may Not be desirable:
Editor /
• The activity on the link does present a small but noticeable load on the device
Executor
processor, slowing other applications slightly.
Link
• Leaving the link running while unattended may pose a security problem.

If the Editor/Executor link is a direct serial connection, disconnect simply by closing

Disconnect the LogicLinx Editor application.
Procedure Users of LogicLinx Editor/Executor via WESMAINT connections can follow a
procedure as outlined in the following Lab.

GE Information SWM0018-3.00-4 105

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.6.1 Lab #20 - Returning to WESMAINT from a LogicLinx Session

This following procedure is only required if the LogicLinx Editor/Executor connection

Note: was established using the WESMAINT Application menus.
If the Editor/Executor connection is a direct serial link, they are totally independent and
can be started and stopped separately.

Follow this procedure to return to WESMAINT from a LogicLinx session.

Procedure

Step Action

1 Close all LogicLinx > Debug windows to release the communications port

2 If the connection was a local serial link, switch Windows applications back
to SGConfig and re-establish communication with WESMAINT.
If the connection was a TELNET link, the WESMAINT connection will
still be active.
3 Press the ESC key or CTRL+R to return to the WESMAINT > Application
menus.

106 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.7 LogicLinx Project Maintenance (16-bit version only)

The LogicLinx archive utility enables the user to save the LogicLinx projects and
Archiving libraries on diskettes or backup directory.
projects The LogicLinx archive manager is a dialog box that can be called from LogicLinx
Project Management or Library Management windows.
• For more on archiving and restoring, refer to SWM0019 – LogicLinx User’s Guide.

To create and maintain reliable archives, it is suggested that the following guidelines be
Archiving used:
Guidelines • Write the name and description of the saved object on the disk sticker
• Do not save projects and libraries on the same diskette
• Do not save different projects on the same diskette

When the Compression option is set, all the archive files created during a Backup
Archive procedure are compressed.
Compress- This option is very useful to reduce the size of a large project archive file, and save it on
ion only one diskette. (The archiver cannot save across multiple diskettes.)

The LogicLinx Document Generator allows you to build and print a complete
Creating document for the selected project.
Project It can be called by the Project > Print commands of the Project Management or the
Documenta- Program windows to print a complete document.
tion
The Document Generator is also run by the Print command of all other LogicLinx
editors to print the contents of a single LogicLinx document.

GE Information SWM0018-3.00-4 107

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

10.8 Embedding LogicLinx and SGConfig Configuration Files

SGConfig offers you the option of embedding, or merging, a compiled LogicLinx

Embedding a program into a generated device configuration.
Program in a
Configura-
tion

• The LogicLinx Executor DTA, B082, running in the target device must be version
Rules About 1.30, or higher.
Embedding − Versions prior to this do not recognize the presence of a merged program.
− SGConfig checks the version of the B082 application definition before
performing an embed procedure.
• Generating a SGConfig device configuration will not erase a LogicLinx program
previously embedded into the configuration.
− Removing an embedded program file is done by un-checking the option in the
LogicLinx DTA’s Properties dialog box, and re-generating the configuration.
Refer to: Lab #21 – Embedding Configuration Files for the procedure.

Embedding LogicLinx programs into SGConfig configuration files is typically

When to performed after completing all debugging, fine-tuning, and on line configuration
Embed procedures.

Reason: Embedding a LogicLinx program into a SGConfig file effectively “fixes” the
size of the LogicLinx program in the target device’s NVRAM. Attempting an
on-line change may cause the LogicLinx program to increase in size, making
the program too big for the memory space allocated to it.

If this happens, the new LogicLinx program may run from RAM, but will not
be saved to NVRAM. Any restart of the device will cause the previously
saved program (still in NVRAM) to overwrite the new program and start
running.

108 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

10.8.1 Lab #21 – Embedding Configuration Files

To embed a LogicLinx program into a device configuration:

Embedding
Procedure

Step Action
1 Double-click the Device icon that is used for your LogicLinx application.
2 Select the LogicLinx application
3 Select Properties from the drop-down list.
Results: This new dialog box will open.

4 Select the Embed LogicLinx program when device is generated.

checkbox.
Results: A warning message appears:
Warning: Embedding your LogicLinx program in the configuration will permanently fix
the size of the program. This may result in the failure of any attempt to make updates
to your LogicLinx program without downloading the entire configuration. You should
not attempt to use the On-line Modification features of LogicLinx if you are embedding
the program in your configuration. Are you sure you wish to proceed?

Continued on next page

GE Information SWM0018-3.00-4 109

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Lab #21 – Embedding Configuration Files, Continued

Embedding Procedure (continued)

Step Action
5 Click OK, if you wish to proceed.
Results: The Properties dialog will close.

6 Close all device dialogs and tables, and click the Generate button on the
menu bar.
Results: All LogicLinx files processed are listed in the device log
including the name, path, date, and time of each LogicLinx file
embedded.
Note: When the required LogicLinx files are not found, you will be
notified though a warning dialog, and an entry will appear in the
device log, detailing the path and name of the missing file.

The merged configuration files are now ready for downloading to a target device.
Procedure
Use standard SGConfig procedures for downloading configuration files.
Complete

Do not download a new LogicLinx program file directly from the editor while a merged
Going Back configuration is running.
to Direct
Download Why: Embedding a LogicLinx program into a SGConfig file effectively “fixes” the
size of the LogicLinx program in the target device’s NVRAM. If you
download a new program that is larger than the memory space allocated to the
previous program, it may run from RAM, but the new program cannot be
saved to NVRAM. If this happens, the new LogicLinx program will be
overwritten by the previous program (that is still in NVRAM) when the device
is restarted
To return to a separate download process, perform the previous procedure, except that
you should clear the checkbox in step 5. Next, regenerate the SGConfig configuration
(to clear the merged LogicLinx program), and then download it to the device. You can
then proceed with the LogicLinx download.

110 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

A. Troubleshooting

A.1 Error and Warning Codes

The following is a list of all possible WESMAINT error messages logged during
Introduction execution of a soft logic program in LogicLinx. The various error codes are intended for
use when determining the cause of a failure, and should be included in the description of
any reported fault.
Additional error codes are defined in the LogicLinx User’s Guide.

• FATAL: errors will cause LogicLinx to cease all operation.

Notes: • The hexadecimal error codes will be reported as the <n> variable in the logged
message.

Error Message Description

FATAL: Unable to allocate global LogicLinx was unable to allocate memory
structure! for its global structure.
FATAL: Cannot find <name>! The required database table indicated by
<name> could not be located in the system
database.
FATAL: DPA unable to open WIN+ = LogicLinx was unable to open
0x<n> communications to WIN+ as a DPA.
FATAL: WESDAC <n> not found! LogicLinx has points mapped for data type
WESDAC <n> but the supporting system
point database could not be found.
The possible values for <n> are:
1 Digital Input
2 Digital Output
3 Transition Counter
4 Analog Input
5 Analog Output
FATAL: DI report enable fail = 0x<n> LogicLinx failed to enable digital input
event recording.
FATAL: CN report enable fail = 0x<n> LogicLinx failed to enable transition
counter event recording.
FATAL: AI report enable fail = 0x<n> LogicLinx failed to enable analog input
event recording.
FATAL: DPA Ready fail = 0x<n> LogicLinx failed to send a DPA ready
command to WIN+.

GE Information SWM0018-3.00-4 111

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Error Message Description

FATAL: Spawn DCA proc fail = 0x<n> LogicLinx failed to spawn the DCA
process.
FATAL: Activate DCA proc fail = 0x<n> LogicLinx failed to activate the DCA
process.
FATAL: Spawn kernel proc fail = 0x<n> LogicLinx failed to spawn the kernel
process.
FATAL: Activate kernel proc fail = 0x<n> LogicLinx failed to activate the kernel
process.
FATAL: Spawn comm proc fail = 0x<n> LogicLinx failed to spawn the
communications process.
FATAL: Activate comm proc fail = 0x<n> LogicLinx failed to activate the
communications process.
FATAL: DPA WIN+ read fail = 0x<n> LogicLinx failed to read a DPA
acknowledgement from WIN+.
Write open <name> failed = <n> The Executor failed to open the file
specified by <name> in order to write data
to the file.
This type of error indicates a memory
problem that has prevented the application
from saving program data into NVRAM.
Comm port <name> open failed = <n> The Executor was unable to open the serial
port specified by <name>, and thus will
not be able to communicate with the
Editor.
Executor termination code <n> An internal error caused the Executor to
terminate execution.
Failed to allocate output request block LogicLinx failed to allocate a block of
memory for an output request, and thus
could not make the request.
This error will cause LogicLinx to cease
all operation.
Failed to send SOE = 0x<n> LogicLinx failed to send a time-tagged
event for a digital input change.
Failed to send COS = 0x<n> LogicLinx failed to send a non-time-
tagged event for a digital input change.
Failed to send AI SOE = 0x<n> LogicLinx failed to send a time-tagged
event for an analog input change.
Failed to send AI COS = 0x<n> LogicLinx failed to send a non-time-
tagged event for an analog input change.
Output req 0x<e> failed = 0x<n> LogicLinx failed to send an output request
to WIN+.
The hexadecimal request type was <e>.

112 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Error Message Description

FATAL: WM COMM sm_create failed LogicLinx failed to create a semaphore to
manage WESMAINT communications.
LogicLinx will be unable to communicate
with the Editor.
Failed to add menu, status = <n> LogicLinx failed to add its menu to
WESMAINT for communications and has
entered a retry loop to register the menu.
Subsequent failed retries are not reported.
Menu added after <n> retries LogicLinx has succeeded in installing the
menu item for WESMAINT
communications after <n> retries.
This message follows a "Failed to add
menu" error once the menu has been
successfully added.
Comm task termination code <n> The LogicLinx communications task has
terminated due to an internal error.
Communications with the Editor have been
permanently severed.
wm_raw_open fail = <n> LogicLinx failed to open raw mode
WESMAINT communications.
Communications with the Editor are
severed and WESMAINT is re-activated.
FATAL: DCA unable to open WIN+ = LogicLinx was unable to open
0x<n> communications to WIN+ as a DCA.
FATAL: DI point init error : 0x<n> LogicLinx failed to initialize its digital
input points in WIN+.
FATAL: DI restored comm error : 0x<n> LogicLinx failed to restore
communications with its digital input
points in WIN+.
FATAL: DI on line error : 0x<n> LogicLinx failed to turn its digital input
points on line in WIN+.
FATAL: DO point init error : 0x<n> LogicLinx failed to initialize its digital
output points in WIN+.
FATAL: DO restored comm error : 0x<n> LogicLinx failed to restore
communications with its digital output
points in WIN+.
FATAL: DO on line error : 0x<n> LogicLinx failed to turn its digital output
points on line in WIN+.
FATAL: AI point init error : 0x<n> LogicLinx failed to initialize its analog
input points in WIN+.

GE Information SWM0018-3.00-4 113

LogicLinx IEC 61131-3 Soft Logic
Getting Started
GE Digital Energy

Error Message Description

FATAL: AI restored comm error : 0x<n> LogicLinx failed to restore
communications with its analog input
points in WIN+.
FATAL: AI on line error : 0x<n> LogicLinx failed to turn its analog input
points on line in WIN+.
FATAL: AO point init error : 0x<n> LogicLinx failed to initialize its analog
output points in WIN+.
FATAL: AO restored comm error : 0x<n> LogicLinx failed to restore
communications with its analog output
points in WIN+.
FATAL: AO on line error : 0x<n> LogicLinx failed to turn its analog output
points on line in WIN+.
FATAL: data update error : 0x<n> LogicLinx failed to update its points with
WIN+.
FATAL: DCA WIN+ read fail = 0x<n> LogicLinx failed to read a DCA command
from WIN+.
Failed to change DO value = 0x<n> LogicLinx failed to send a digital output
data change event to WIN+.
This error will cause LogicLinx to NACK
an output request.
Failed to send DO ACK = 0x<n> LogicLinx failed to send a digital output
request acknowledgement to WIN+.
Failed to send DO NACK = 0x<n> LogicLinx failed to send a digital output
request negative acknowledgement to
WIN+.
Failed to change AO value = 0x<n> LogicLinx failed to send an analog output
data change event to WIN+.
This error will cause LogicLinx to NACK
an output request.
Failed to send AO ACK = 0x<n> LogicLinx failed to send an analog output
request acknowledgement to WIN+.
Failed to send AO NACK = 0x<n> LogicLinx failed to send an analog output
request negative acknowledgement to
WIN+.
Failed to NACK unsupported request = LogicLinx failed to send a negative
0x<n> acknowledgement to WIN+ for a
command request it doesn't support.
Force req 0x<x> pnt <n> failed = 0x<err> LogicLinx failed to force a point state as
directed by the user from the debugger.
The code <x> indicates the point type
being forced. The point number to be
forced was <n>, and the hexadecimal error
code returned was <err>.

114 SWM0018-3.00-4 GE Information

 LogicLinx IEC 61131-3 Soft Logic
GE Digital Energy Getting Started

Error Message Description

Warning: no operation for mapped DO Operation of digital output <n> by writing
<n> a value to the output (as opposed to using
the OPERATE or CONTROL functions)
has failed due to the fact that the digital
output has no operation type assigned to it
in the Digital Output Type Table
(B082DOTY).
Insufficient space in table to store new An attempt to use the debugger to update a
program. program that was downloaded as part of
the device configuration has failed since
New program NOT stored in memory.
the new program is larger than the original.
The new program is executing out of
RAM, but has not been copied to non-
volatile memory. LogicLinx will revert to
the previously stored program when the
device is restarted.
FATAL: Save drive is not available The “PERM” file system drive is not
present in the device, either because the
FATAL: PERM drive is not available
Generic Device File System Driver (B081-
0) has not been included in the device
firmware or because the driver has
encountered an error during startup. If the
driver is in your firmware, check the
WESMAINT and kernel error logs for any
errors issued by the driver. The LogicLinx
Executor will suspend itself.
Warning: Write open <name> failed = <n> LogicLinx failed to open the named file for
writing. The error code returned was <n>.
No LogicLinx project was found in No project data has been downloaded to
memory. the target device. LogicLinx is waiting for
a program to be downloaded via the
LogicLinx is awaiting project download…
debugger.

GE Information SWM0018-3.00-4 115

MODIFICATION RECORD

Version Revision Date Author Change Description

1.00 1 03 February 2000 RN Created
2 04 May 2000 RN Added new Conversion Point Tag Table configuration details,
modified cycle-time settings lab procedures
3 21 June 2001 RN Chapter 6: Added warning re: all DCAs must be running for
Executor to run
Chapter 8: Added block re: contiguous point mapping
1.30 1 24 October 2001 RN Chapter 9: Added information and procedure re: B082 V1.30
config. Embed feature
2 29 January 2002 RN Updated document format to GE Energy Services standard
1.40 1 27 February 2002 RN Chapter 7, 8: 128 point restriction removed from ppint map
tables. Now at 32767 points
2 25 April 2002 RN Chapter 9: Added limitation information re: simulator program
size
2.00 1 5 March 2004 MAR Updated error messages and configuration options in digital
output type table
2 18 March 2004 AV Formatted to GE Energy standard. Redraw diagram in Visio
3.00 1 15 June 2005 M Haska Formatted to GE Inspira standard, Release
2 19 January 2015 R. Rees Updated Technical Support contact information and branding.
3 17 April 2015 M. Koker Updated content throughout to add the 32-bit and version of
LogicLinx.
4 8 June 2015 R. Rees Fixed an error in Chapter 5 introduction.