Medium-Voltage VFD ROBICON Perfect Harmony A1A902291V5.0_AB_ NXG Tool Suite User Manual 2010

Medium-Voltage VFD ROBICON Perfect Harmony A1A902291V5.0_AB_ NXG Tool Suite User Manual 2010

Medium-Voltage AC-Converter 

ROBICON Perfect Harmony 

NXG ToolSuite Software User Manual 

Function Manual • 11/2010 

ROBICON Perfect Harmony 

 --> 

https://www.robiconperfectharmony.com/

Medium-voltage AC-converter

ROBICON Perfect Harmony

NXG ToolSuite Software User

Function Manual

Version AB 11/2010

A5E03086439A

Safety Precautions and 

Warnings 1

NXG / NXGII / NXGIII ToolSuite 

Overview 2

NXG / NXGII Drive Tool 3

NXG Debug Tool 4

NXG SOP Utilities 5

NXG Configuration Update 

Utility Overview 6

Drive Server Setup/Status 

Utility 7

High Availability Drive Tool 8

Glossary A

Abbreviations B

Operators and Precedence C

Ethernet Connections D

Appendix E

Legal information

Warning notice system

This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent 

damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert 

symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are grad￾ed according to the degree of danger. 

If more than one degree of danger is present, the warning notice representing the highest degree of danger will be 

used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property 

damage. 

Qualified Personnel

The device/system may only be set up and used in conjunction with this documentation. Commissioning and oper￾ation of a device/system may only be performed by qualified personnel. Within the context of the safety notes in 

this documentation qualified persons are defined as persons who are authorized to commission, ground and label 

devices, systems and circuits in accordance with established safety practices and standards. 

Proper use of Siemens products

Note the following: 

Trademarks

All names identified by are registered trademarks of the Siemens AG. The remaining trademarks in this publication 

may be trademarks whose use by third parties for their own purposes could violate the rights of the owner. 

Disclaimer of Liability

We have reviewed the contents of this publication to ensure consistency with the hardware and software described. 

Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this 

publication is reviewed regularly and any necessary corrections are included in subsequent editions. 

indicates that death or severe personal injury will result if proper precautions are not taken.

indicates that death or severe personal injury may result if proper precautions are not taken.

with a safety alert symbol, indicates that minor personal injury can result if proper precautions are not taken.

CAUTION

without a safety alert symbol, indicates that property damage can result if proper precautions are not taken.

NOTICE

indicates that an unintended result or situation can occur if the corresponding information is not taken into account.

Siemens products may only be used for the applications described in the catalog and in the relevant technical doc￾umentation. If products and components from other manufacturers are used, these must be recommended or ap￾proved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance 

are required to ensure that the products operate safely and without any problems. The permissible ambient con￾ditions must be adhered to. The information in the relevant documentation must be observed.

Siemens AG

IIndustry Sector

Postfach 48 48

90026 NÜRNBERG

GERMANY

11/2010

Copyright Siemens AG 2010.

Technical data subject to change

DANGER

WARNING

CAUTION

WARNING

࿗ ࿕ ࿈

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 1

Table of Contents

1 Safety Precautions and Warnings .......................................................................................................5

2 NXG / NXGII ToolSuite Overview..........................................................................................................9

2.1 Overview..................................................................................................................................9

2.2 Installation Procedure............................................................................................................10

2.3 Starting ToolSuite ..................................................................................................................15

3 NXG / NXGII Drive Tool........................................................................................................................17

3.1 Drive Configuration Features.................................................................................................18

3.2 Drive Variable Graphing Features .........................................................................................19

3.3 Drive Status Features............................................................................................................25

3.4 Drive Control Features ..........................................................................................................25

3.4.1 Drive Tool Pull Down Menu Features....................................................................................26

3.5 Start and Configure the Drive Tool ........................................................................................31

3.6 Set Up Ethernet (TCP/IP) Communications ..........................................................................32

3.7 Operating the Drive Tool ......................................................................................................34

3.7.1 Fault or Alarm Displays .........................................................................................................34

3.7.2 Graphing Display ...................................................................................................................39

3.7.3 Time Scale Adjustment..........................................................................................................45

3.7.4 Freezing Graph on Fault........................................................................................................46

3.7.5 Freezing Graph on Trigger ....................................................................................................47

3.7.6 Post Processing of Data ........................................................................................................48

4 NXG Debug Tool..................................................................................................................................49

4.1 System Requirements ...........................................................................................................49

4.2 Start and Configure the Debug Tool......................................................................................49

4.3 Operating the Debug Tool .....................................................................................................54

5 NXG SOP Utilities................................................................................................................................57

5.1 Introduction............................................................................................................................57

5.2 SOP Utility Tool Overview .....................................................................................................57

5.3 Starting the SOP Utility Tool..................................................................................................59

5.4 SOP Development Process...................................................................................................61

5.5 Overview of the Compile Process .........................................................................................62

5.6 Input Source File ...................................................................................................................64

5.6.1 System Type Identification ....................................................................................................67

5.6.2 SOP Source File....................................................................................................................69

5.6.3 Input Flags.............................................................................................................................72

5.6.4 Output Flags ..........................................................................................................................72

5.6.5 Redefining Flag Names .........................................................................................................74

5.7 Compiler Operation ...............................................................................................................75

Table of Contents

2 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5.8 Output Hex File............................................................................................................76

5.9 Downloading a System Program (Hex File)..................................................................76

5.9.1 Siemens LD A SOP Upload/Download Utility Method..................................................77

5.9.2 Terminal Emulation Method.........................................................................................78

5.9.3 Termination..................................................................................................................79

5.10 Uploading a System Program (Hex File)......................................................................83

5.11 Reverse Compiler........................................................................................................83

5.12 Header.........................................................................................................................89

5.13 Combined Source / Hex File.........................................................................................92

6 NXG Configuration Update Utility Overview.........................................................................101

6.1 System Requirements...............................................................................................101

6.2 Start and Configure the Configuration Update Utility..................................................102

6.3 Features Overview.....................................................................................................103

6.3.1 Copy Setup Files to Another Directory.......................................................................103

6.3.2 Update Flash Disk Files.............................................................................................107

6.3.3 Bootable Default Disk Procedure...............................................................................110

6.3.4 Copy Flash Disk to PC...............................................................................................115

6.3.5 Make Bootable Copied Disk Procedure......................................................................119

6.3.6 Update ToolSuite Host Files on PC............................................................................124

7 Drive Server Setup/Status Utility............................................................................................127

7.1 Start and Configure the Configuration Update Utility..................................................127

7.1.1 Create a New Server Connection...............................................................................128

7.2 Setup / Status Application Operation..........................................................................132

7.2.1 Status Screen............................................................................................................132

7.2.2 Menu Functions - Setup Menu...................................................................................133

7.2.2.1 Select New Server Connection..................................................................................133

7.2.2.2 Server Connection Maintenance............................................................................... 133

7.2.2.3 Create New Server Connection.................................................................................134

7.2.2.4 Edit Server Connection Data..................................................................................... 134

7.2.2.5 Rename Server Connection...................................................................................... 135

7.2.2.6 Delete Server Connection......................................................................................... 135

7.2.3 Menu Functions - Server Maintenance......................................................................135

7.2.3.1 List Server Names..................................................................................................... 135

7.2.3.2 Create New Server.................................................................................................... 135

7.2.3.3 Rename Server......................................................................................................... 136

7.2.3.4 Delete Server.............................................................................................................136

7.2.4 Menu Functions - Config Menu................................................................................. 137

7.2.4.1 Select Server Controlled Data................................................................................... 137

7.2.4.2 Set Server as Configured.......................................................................................... 137

7.2.4.3 Set Operating Conditions.......................................................................................... 137

7.2.4.4 Configure Initial Parameters...................................................................................... 138

7.2.4.5 Change Drive Names/IP Addresses..........................................................................139

7.2.5 Menu Functions - Security Menu...............................................................................139

7.2.5.1 Enter Security Code.................................................................................................. 139

7.2.5.2 Security Clear............................................................................................................ 139

7.2.5.3 Run Menu.................................................................................................................. 140

7.2.5.4 Start Menu................................................................................................................. 140

7.2.5.5 Restart Menu............................................................................................................. 140

Table of Contents

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 3

8 High Availability Drive Tool.....................................................................................................141

8.1 Connection to Drive Tool........................................................................................... 141

8.2 Selecting Desired Control System.............................................................................144

A Glossary...................................................................................................................................147

B Abbreviations...........................................................................................................................161

C Operators and Precedence.....................................................................................................167

C.1 Operators and Precedence....................................................................................... 167

C.2 Ladder Logic Translation............................................................................................171

D Ethernet Connections.............................................................................................................173

D.1 Direct Connection...................................................................................................... 173

D.1.1 Required Items for a Single Ethernet Direct Connection...........................................173

D.1.2 Required Items for a Single PC Multiple Drive Ethernet Connection Support...........174

D.1.3 Configuring a PC to Work with a Direct Connection..................................................175

D.1.3.1 Windows® XP /2000..................................................................................................175

D.1.3.2 Windows® Vista........................................................................................................ 180

E Appendix..................................................................................................................................183

E.1 Notes ........................................................................................................................ 183

E.2 Reader Comments Form........................................................................................... 185

E.3 Startup/Warranty Registration and Service Solutions ................................................187

Table of Contents

4 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 5 1

Safety Precautions and Warnings 

Perfect Harmony drives are designed with considerable thought to personal safety. However, 

as with any piece of high power equipment, there are numerous internal connections that 

present potentially lethal voltages. In addition, some internal components are thermally hot to 

the touch. Follow the warnings below when working in or near the Perfect Harmony system.

Safety Precautions and Warnings

6 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Electrical Hazards!

• Always follow the proper lock-out/tag-out procedures before beginning any maintenance 

or troubleshooting work on the drive.

• Always follow standard safety precautions and local codes during installation of external 

wiring. Protective separation must be kept between extra low voltage (ELV) wiring and 

any other wiring as specified in IEC61800-5-1.

• Always work with one hand, wear insulated or rubber safety shoes, and wear safety 

glasses. Also, always work with another person present.

• Always use extreme caution when handling or measuring components that are inside 

the enclosure. Be careful to prevent meter leads from shorting together or from touching 

other terminals.

• Use only instrumentation (e.g., meters, oscilloscopes, etc.) intended for high voltage 

measurements (that is, isolation is provided inside the instrument, not provided by 

isolating the chassis ground of the instrument). 

• Never assume that switching off the input disconnect will remove all voltage from internal 

components. Voltage is still present on the terminals of the input disconnect. Also, there 

may be voltages present that are applied from other external sources.

• Never touch anything within the Perfect Harmony cabinets until verifying that it is neither 

thermally hot nor electrically alive.

• Never remove safety shields (marked with a HIGH VOLTAGE sign) or attempt to measure 

points beneath the shields.

• Never run the drive with cabinet doors open. The only exception is the control cabinet 

which contains extra low voltages (ELV).

• Never connect any grounded (i.e., non-isolated) meters or oscilloscopes to the Perfect 

Harmony system.

• Never connect or disconnect any meters, wiring, or printed circuit boards while the drive 

is energized.

• Never defeat the instrument’s grounding.

• Only qualified individuals should install, operate, troubleshoot, and maintain this drive. A 

qualified individual is “one familiar with the construction and operation of the equipment 

and the hazards involved.”

• Hazardous voltages may still exist within the Perfect Harmony cabinets even when the 

disconnect switch is open (off) and the supply power is shut off.

DANGER

Safety Precautions and Warnings

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 7 • Always comply with local codes and requirements if disposal of failed components is

necessary (for example, CPU battery, capacitors, etc.).

• Always ensure the use of an even and flat truck bed to transport the Perfect Harmony 

drive system. Before unloading, be sure that the concrete pad is level for storage and 

permanent positioning.

• Always confirm proper tonnage ratings of cranes, cables, and hooks when lifting the

drive system. Dropping the cabinet or lowering it too quickly could damage the unit.

• Never disconnect control power while medium voltage is energized. This could cause

severe system overheating and/or damage.

• Never store flammable material in, on, or near the drive enclosure. This includes

equipment drawings and manuals.

• Never use fork trucks to lift cabinets that are not equipped with lifting tubes. Be sure

that the fork truck tines fit the lifting tubes properly and are the appropriate length.

• During operation, the nominal weighted sound pressure level can possibly exceed 70 dB 

at a distance of 1 meter from the drive.

WARNING

Safety Precautions and Warnings

8 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Additional safety precautions and warnings appear throughout this manual. These important 

messages should be followed to reduce the risk of personal injury or equipment damage.

CAUTION

ESD Sensitive Equipment!

• Always be aware of electrostatic discharge (ESD) when working near or touching 

components inside the Perfect Harmony cabinet. The printed circuit boards contain 

components that are sensitive to static electricity. Handling and servicing of components 

that are sensitive to ESD should be done only by qualified personnel and only after 

reading and understanding proper ESD techniques. The following ESD guidelines should 

be followed. Following these rules can greatly reduce the possibility of ESD damage to 

PC board components.

• Always transport static sensitive equipment in antistatic bags.

• Always use a soldering iron that has a grounded tip. Also, use either a metallic 

vacuum-style plunger or copper braid when desoldering.

• Make certain that anyone handling the Perfect Harmony printed circuit boards is wearing 

a properly grounded static strap. The wrist strap should be connected to ground through 

a 1 megohm resistor. Grounding kits are available commercially through most electronic 

wholesalers.

• Static charge buildup can be removed from a conductive object by touching the object to 

a properly grounded piece of metal.

• When handling a PC board, always hold the card by its edges.

• Do not slide printed circuit boards across any surface (e.g., a table or work bench). If 

possible, perform PCB maintenance at a workstation that has a conductive covering that 

is grounded through a 1 megohm resistor. If a conductive tabletop cover is unavailable, a 

clean steel or aluminum tabletop is an excellent substitute.

• Avoid plastic, StyrofoamTM, vinyl and other non-conductive materials. They are excellent 

static generators and do not give up their charge easily.

• When returning components to Siemens LD A, always use static-safe packing. This limits 

any further component damage due to ESD.

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 9 2

NXG / NXGII ToolSuite Overview

2.1 Overview

The NXG / NXGII ToolSuite is a PC-based high-level Graphical User Interface (GUI) applica￾tion that integrates various software tools used for NXG / NXGII based drives. ToolSuite, 

equipped with the Microsoft® Windows Operating System, allows navigation through a drive’s 

features by using a PC and a mouse or by using a touch screen (instead of a keypad) – allow￾ing you to monitor and control that drive’s functions quickly and easily. The NXG Control and 

the PC running the NXG ToolSuite software, interface with one another using Ethernet and 

TCP/IP protocol.

ToolSuite contains the following 

tools: 

• Drive Tool (for non - High 

Availability VFDs)

• Debug Tool

• SOP Utilities

• Configuration Update Utility 

• Drive Server Setup / Status Utility 

(for High Availability VFDs)

• High Availability Drive Tool

IMPORTANT! 

Ensure that Version 2.0 of Microsoft‘s® .NET Framework is installed prior to 

installing ToolSuite. Non-Siemens personnel can obtain .NET Framework by 

visiting the Microsoft® website and downloading it from there. Siemens personnel 

can download this application from a designated Siemen’s server.

NXG / NXGII ToolSuite Overview

2.2 Installation Procedure

10 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

2.2 Installation Procedure

Perform the following steps to install ToolSuite.

1. Insert the Siemens NXG ToolSuite CD into your PC’s CD drive. Open Windows Explorer 

and select the CD drive.

2. Double Click on the file ToolSuite Setup vx.x.exe (vx.x will vary based on the latest 

software version).

3. The “ToolSuite Installation Wizard” dialog boxes should appear as shown above. Follow 

the instructions and select the “Next>” button.

Step 2.

NXG / NXGII ToolSuite Overview

2.2 Installation Procedure

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 11

4. This dialog box shows the version information for all of the ToolSuite software 

components. Select the “Next>” button.

NXG / NXGII ToolSuite Overview

2.2 Installation Procedure

12 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5. Select the “Next>” button to begin the installation.

6. After clicking “Next”, the Updating System window appears.

NXG / NXGII ToolSuite Overview

2.2 Installation Procedure

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 13

7. If the installation was successful, the following dialog box appears. Click “Finish” to exit the 

installation.

8. After clicking “Finish” a Installer Information pop-up displays on the PC’s monitor 

prompting you to re-start your computer. Choose “Yes” to complete configuration changes 

or “No” if you wish to manually restart your PC at a later time.

9. If the installation was interrupted or stopped by the user before the ToolSuite software fully 

installs, the following dialog box appears.

10.Click “OK” to proceed.

NXG / NXGII ToolSuite Overview

2.2 Installation Procedure

14 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

11.To re-run the installation, follow the steps as described in the previous pages. Upon 

selecting the ToolSuite Setup v5.1.0.exe file, the Application Maintenance window displays 

as indicated below.

12.Make the desired selection and proceed as prompted by the software.

NXG / NXGII ToolSuite Overview

2.3 Starting ToolSuite

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 15

2.3 Starting ToolSuite

The ToolSuite installation program places an icon on your PC’s desktop. 

1. Double click the icon to start the ToolSuite.

2. The ToolSuite Splash Screen appears.

NXG / NXGII ToolSuite Overview

2.3 Starting ToolSuite

16 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3. Once the ToolSuite is started, a window displays showing the Drive Tools, Debug Tool, and 

Utilities Tabs. At this point invoke one of the Tools listed below:

• Drive Tool - Refer to Chapter NXG / NXGII Drive Tool

• Debug Tool – Refer to Chapter NXG Debug Tool

• Utilities – Refer to Chapters NXG SOP Utilities, NXG Configuration Update Utility 

Overview, Drive Server Setup/Status Utility

• HA Drive Tool - Refer to Chapter High Availability Drive Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 17

3

NXG / NXGII Drive Tool

The NXG / NXGII Drive Tool is the main graphical interface to the non-HA Drive. Its purpose 

is to manage all of the drive features and provide the user with a user-friendly view of the 

drive. To read about the HA Drive Tool, refer to High Availability Drive Tool Chapter of this 

manual.

The Drive Tool’s main features are shown in the figure below:

1. Drive Configuration

2. Drive Variable Graphing

3. Drive Status

4. Drive Control

The sections that follow provide additional information about each of these features.

4

NXG / NXGII Drive Tool

3.1 Drive Configuration Features

18 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3.1 Drive Configuration Features

• Folders for each drive configuration category (matches the drive’s keypad Quick Keys)

• Icon colors: 

- If multiple configuration files option is NOT enabled then:

GREEN = default

RED = changed from default

- If multiple configuration files option IS enabled then:

GREEN = master config file parameter and default

RED = master config file parameter changed from default

LIGHT BLUE = secondary config file parameter and default

DARK BLUE = secondary config file parameter changed from default

• On screen help and ID identifier (matches the keypad IDs for Speed Menus)

• All parameters editing assisted by min, max limits, and defaults 

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 19

3.2 Drive Variable Graphing Features

These drive variable graphing features are accessible via the Main Toolbar options and their 

respective submenus. See the pictures below.

• Adjustable Time Scale

• Pick List Selectable Variables

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

20 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

• Graphing Capability Of Up To 10 Variables

• Individual Variable Offsets and Variable Scaling

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 21

• Customizable Graphics

• Fonts, Color, Styles

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

22 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

• Freeze Graphics, Freeze Graph On Fault

• Freeze On Settable Trigger

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 23

• Zoom Graph

• Printable Graphics

‘Zoomed In’ portion of graph selected using the ToolSuite Zoom Graph feature

Graph frozen - user-selected portion of graph

desired to view using the Zoom Graph feature

NXG / NXGII Drive Tool

3.2 Drive Variable Graphing Features

24 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

• Exportable Graphics

- Export: EMF, WMF, BMP, JPG, PNG, Text / Data

- Export Destination: ClipBoard, File, Printer

- Export Size: Pixels, or Millimeters, Inches, Points (Width / Pixels, DPI)

NXG / NXGII Drive Tool

3.3 Drive Status Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 25

3.3 Drive Status Features

• 7 Programmable Display Variables

• Pick List Selectable Variables

• First 4 Synchronized To Keypad

• Fault and Alarm Indicators (Traffic Lights Red = Fault, Yellow = Alarm, Display Flashes)

3.4 Drive Control Features

• Manual Start Button

• Auto Start Button

Traffic light indicators

Programmable display variables

NXG / NXGII Drive Tool

3.4 Drive Control Features

26 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

• Stop Button

• Fault Reset Button

• Show Active Fault / Alarm Log Button

3.4.1 Drive Tool Pull Down Menu Features

File:

• Load Configuration Files

• Reset To Factory Defaults

• Create Config File

• Save Data

• Save Data As

• Display Active Config File

• Drive Parameter Data

-Print Data

-Write Data To Text File

-Search by ID

-Search by Text

• Set Factory Defaults

• Options

• Enter manual speed: Ctrl+D1

• System Program

- Download New System Program

- Display System Program Name

1. When manually entering the drive speed, be aware that although the drive may be using speed limits 

set by Speed Limits set 1, Speed Limits set 2, or Speed Limits set 3, the Drive Tool limits the 

manually entered speed value to those values established by Speed Limit set 1 exclusively. 

Therefore, the maximum and minimum allowable values of entered speed will be limited to those 

values established by Speed Limits set 1. 

NXG / NXGII Drive Tool

3.4 Drive Control Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 27

- Upload System Program

• Network

- Make Network 2 same as Network 1

- View Network Module Types

View:

• Configuration Window

• Graphics Window

• Status Window

Security:

• Enter Security Code from Toolbar Menu or by:Ctrl+S

• Security Edit

• Change Security Code

• Security Level Clear

NXG / NXGII Drive Tool

3.4 Drive Control Features

28 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Status:

• Elapsed Time

- Preset

- Reset

- Display

• Input kW Hours Consumed

- Preset

- Reset

- Display

• Output kW HoursConsumed

- Preset

- Reset

- Display

• Cells

- Display Cell Status

- Display Bypass Status

- Reset Bypassed Cells

• Set Clock Time

NXG / NXGII Drive Tool

3.4 Drive Control Features

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 29

Logs:

• Fault Log

English

- Display Log

- Store Log in File

- Print Log

Drive Language

- Display Log*

- Store Log in File*

- Print Log*

Clear Log

• Historic Log

English

- Display Log

- Store Log in File

- Print Log

Drive Language

- Display Log*

- Store Log in File*

- Print Log*

Clear Log

• Event Log

English

- Display Log

- Store Log in File

- Print Log

Drive Language

- Display Log*

- Store Log in File*

NXG / NXGII Drive Tool

3.4 Drive Control Features

30 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

- Print Log*

Clear Log

Diagnostics

• Speed Test

- Start Speed Test

- Stop Speed Test

Calibration

• Auto-Tune

NOTICE

Items designated with an asterisk * are only available when ToolSuite is connected to a 

drive running NXG Version 5.0 or later software and the selected drive language is other 

than English.

NXG / NXGII Drive Tool

3.5 Start and Configure the Drive Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 31

3.5 Start and Configure the Drive Tool

If no configured Drives exist, it will be necessary to configure a new one. To do this, click the 

“New” button in the “Drive Configurator” area of the ToolSuite dialog box shown below. 

In the new dialog box shown below, select the “Use Default Values” Operation Type. Select 

“Harmony” from the Type Selection drop-down list and enter a drive name in the field pro￾vided directly under “Drive Name”. Click the “OK” button.

The ToolSuite dialog box will reappear, now showing the newly configured drive. Refer to 

Appendix B Ethernet Connections, which contains the information for a PC-to-drive communi￾cations setup.

Click “new”

Type the desired 

name of the 

drive in this field

NXG / NXGII Drive Tool

3.6 Set Up Ethernet (TCP/IP) Communications

32 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3.6 Set Up Ethernet (TCP/IP) Communications

Go to each drive and use that drive’s keypad to set the menu items of the “TCP/IP setup” 

menu (ID = 9300). The menu items below must be updated based on the settings unique to 

your network: 

Table 3-1: Network Settings

Next, set the TCP/IP address in the Drive Tool to the same value as the drive, so that it will 

communicate with the drive. The following figure shows the drive’s TCP/IP address high￾lighted. Change this value to match that of the drive to which you wish to communicate. Dou￾ble-click the “TCP/IP server name” text or its adjacent icon to edit its value.

If the PC on which the Drive Tool runs already has the correct network settings for the LAN, 

the Drive Tool will start communicating with the drive within a few seconds of the time that you 

make this change. If the settings are not correct, then enter new network settings by simply 

IMPORTANT! 

To use the Drive Tool to control drives through an existing network, assign a 

unique IP address to each drive. 

Menu Item Menu ID Default Setting Custom Setting (Write yours here)

IP Address 9310 172.17.20.16

Subnet Mask 9320 255.255.0.0

Gateway Mask 9330 172.17.1.1

Enter data

Double￾Click

NXG / NXGII Drive Tool

3.6 Set Up Ethernet (TCP/IP) Communications

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 33

right clicking the TCP/IP server name to display the “String Entry” pop-up window and enter 

the necessary information.

Afterwards, the Configuration window will display a tree of several folders, and the Graphics 

and Status windows will start displaying data similar to that shown in the following graphic.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

34 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3.7 Operating the Drive Tool 

Now that your Drive Tool is installed and operational, please take some time to become famil￾iar with its features, and how to use them.

3.7.1 Fault or Alarm Displays

When a fault or an alarm condition exists, the Drive Tool window flashes to annunciate the 

existence of a Fault/Alarm.

The Drive Tool also displays traffic lights in the lower right-corner of the display window. In 

addition, the word “Fault” will appear under Mode within the Status window.

To display the most recent Fault Alarms, go to the Menu Bar and Select “Fault Log Display 

Log...”

The ToolSuite software displays a pop-up window that informs the user that the Fault Log is 

currently being uploaded. Once the information is uploaded, a dialog box that lists the Fault 

Alarms in the order of their occurrence appears.

NOTICE

The Drive Tool flashing window feature can be disabled via the “Configuration  Options” 

pull down menu.

NOTICE

Red lights indicate Faults and yellow lights represent Alarms.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 35

If an alarm has reset itself, the reset time will be noted. If a fault condition no longer persists, 

you can reset the fault by clicking the “Reset” button in the Drive Tool window.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

36 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

If all faults have been reset, the Drive Tool window will appear as shown above, without flash￾ing. 

To change a drive parameter, select the desired parameter from within the configuration win￾dow and double click on it. This will cause a dialog box similar to the one below to appear. 

You can then type in the desired value (some parameters will be changed from a pick list). 

The limits, default value, and current value are displayed, along with a more complete param￾eter description than those shown in the configuration window. You can enter a comment as a 

NOTICE

The yellow traffic light indicates that an alarm condition still persists.

Perform Manual Reset

Yellow traffic light

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 37

record of the change if desired. The “Set to Default” button will restore the default value. The 

“Help” button is not currently supported.

Desired values may also be edited by selecting a directory (folder) or a specific variable 

parameter by right clicking the icon and selecting the appropriate submenu item as shown 

below. The submenu provides not only the means to change values, but to search for specific 

IDs as well. Parameters that are changed from the default value will appear as reddish icons 

and parameters set to their default values are displayed as greenish icons.

Click on DEMD parameter to 

display Select Item Window

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

38 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

NOTICE

To permanently change a drive parameter, select “Configuration”  “Save Data” from the 

pull down menu bar of the Drive Tool window.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 39

3.7.2 Graphing Display

A list of the variables that you can display in the ToolSuite is given in Table 3-2. A total of ten 

variables can be displayed at the same time. Select variables with the Graphing submenu 

(ID# 10). Each variable has a scale factor and an offset. The Y-axis display range is –1.0 to 

+1.0. All variables are required to be scaled within this range to be visible on the screen. The 

value shown on the screen is the actual value divided by the chosen scale factor. Unless oth￾erwise indicated, the variables are in per unit; hence the default Scale Factor of 1.0 is satis￾factory for most variables.

The offset parameter shifts the zero point of the variable up or down on the plot window. For 

most variables, the default offset of 0.0 is sufficient. 

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

40 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table 3-2: List of Variables Available for Display

Variable Name Description

Ids Measured motor magnetizing current

Iqs Measured motor torque current

Ids reference Motor magnetizing current command

Iqs reference Motor torque current command

Iqs reference filtered Filtered torque current command

Flux DS Estimated motor flux 

Flux QS Flux input to PLL for motor speed and flux angle estimation (typically 0.0)

Vds reference D-axis voltage command (or output of magnetizing current regulator)

Vqs reference Q-axis voltage command (or output of torque current regulator)

Output frequency Drive output frequency in rad/sec

Slip frequency Estimated motor slip frequency in rad/sec

Motor speed (frequency-slip) Estimated motor speed in rad/sec

Motor speed filtered Filtered motor speed in rad/sec

RLoss for braking Equivalent motor resistance during dual frequency braking

XLoss for braking Equivalent motor inductance during dual frequency braking

Field weakening limit Field weakening torque current limit

Dual Frequency Braking Limit Current limit during dual frequency braking

Maximum Current Limit Maximum torque limit (at output of speed regulator)

Minimum Current Limit Minimum torque limit (at output of speed regulator)

Iq gain Speed regulator enable signal

Ua reference Phase A output voltage command

Ub reference Phase B output voltage command

Uc reference Phase C output voltage command

Flux D loss filtered D-axis flux component at the loss inducing frequency

Flux Q loss filtered Q-axis flux component at the loss inducing frequency

Id loss filtered D-component of current at loss frequency 

Iq loss filtered Q-component of current at loss frequency 

W loss Loss inducing frequency in rad/sec

Ws filtered Filtered drive output frequency

Theta loss Flux angle of the loss inducing frequency in radians

Flux DS Filtered Filtered motor flux

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 41

Ids Filtered Filtered motor magnetizing current

Iqs Filtered Filtered motor torque current

Vd Loss Magnitude of loss inducing voltage

Ids No Load No-load motor current

Stator Resistance Stator resistance

Wp Reference Pulsation frequency in rad/sec

Output Vector Angle Motor flux angle in radians

Volt Second Phase A Measurements Measured phase A motor volt-seconds

Volt Second Phase B Measurements Measured phase B motor volt-seconds

Volt Second Phase C Measurements Measured phase C motor volt-seconds

Ia Current Measurements Measured phase A motor current

Ib Current Measurements Measured phase B motor current

Ic Current Measurements Measured phase C motor current

Ids Measured Current After Synch Filter 

(V/Hz)

Not used

Iqs Measured Current After Synch Filter 

(V/Hz)

Not used

Raw Speed Demand *

Raw speed demand in rad/sec

Auxiliary Demand Before Ramp *

Auxiliary demand before speed ramp in rad/sec

Auxiliary Demand After Ramp *

Auxiliary demand after speed ramp in rad/sec

Speed Demand *

Ran Speed demand & Aux demand before ramp 

Speed Profile Output *

Output of speed profile routine in rad/sec

Critical Speed Avoidance Output *

Critical speed avoidance output in rad/sec

Polarity Change Output *

Output of polarity change function in rad/sec

Minimum Demand Output *

Output of minimum limit routine in rad/sec

Ramp Output *

Output of speed ramp function in rad/sec

Speed Demand At Limit Input *

Input signal to speed (maximum) limit function in rad/sec

Speed Reference *

Motor speed reference in rad/sec

Raw Flux Demand Flux demand from menu

Flux Ramp Output Output of flux ramp controller

Energy Saver Output Output of energy saver controller

Variable Name Description

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

42 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Field Weakening Output Output of field weakening controller

Flux Reference Flux reference

Id Input Current Real component of input current

Iq Input Current Reactive component of input current

Phase A Input Current Phase A input current

Phase B Input Current Phase B input current

Phase C Input Current Phase C input current

Phase A Input Voltage Phase A input voltage

Phase B input voltage Phase B input voltage

Phase C Input Voltage Phase C input voltage

Zero Sequence Average RMS value of zero sequence component in input voltage

Negative Sequence D Voltage D-component of negative sequence in input voltage

Negative Sequence Q Voltage Q-component of negative sequence in input voltage

D Voltage Amplitude of voltage of line voltage (taking transformer tap setting into 

account)

Q Voltage Q-axis component voltage used to drive input PLL for frequency 

estimation. 

Input Frequency Input (line frequency) in rad/sec

Input Power Average (kilowatts) Input power

Input Power Factor Input side power factor

Ah Harmonic Coefficient Amplitude of A-component of harmonic chosen using menu setting

Bh Harmonic Coefficient Amplitude of B-component of harmonic chosen using menu setting

Transformer Thermal Level Output torque limit set by transformer thermal limit regulator

One Cycle Reactive Current Level Input one cycle reactive current trip level

Single Phasing Current Level Output torque limit set by input single-phasing regulator

Under Voltage level Output torque limit set by input undervoltage regulator

Input Side Flux Input voltage converter to flux for Up Transfer

Line Flux Vector Angle Angle of input voltage in radians

Output Neutral Voltage Input side neutral voltage

Sync Motor Field Current Field current command (for synchronous motor)

Encoder Speed Encoder speed output

Motor Voltage Motor voltage (or drive output voltage)

Output Power Average (kilowatts) Output Power 

Variable Name Description

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 43

Phase A Filter Current Filter current in A phase

Phase B Filter Current Filter current in B phase

Phase C Filter Current Clamped Filter current in C phase

Measured Phase A Volts Actual Drive voltage A phase (Does not work)

Measured Phase B Volts Actual Drive voltage B phase (Does not work)

Measured Phase C Volts Actual Drive voltage C phase (Does not work)

Measured Output Neutral Voltage Drive neutral voltage

Max Available Output Volts Max available output voltage

Input Reactive Power (kVAR) Input kVAR

Drive Efficiency Efficiency

Drive State Drive state

Up Transfer State Up transfer state variable

Down Transfer State Down transfer state variable

Drive Internal Losses Difference between output and input power

Excess Input Reactive Current Input to one-cycle algorithm, indicating the input reactive current

allowance before a trip condition exists

Speed Droop Amount of droop subtracted from the speed demand (rad/sec)

Precharge State Variable State machine value for precharge transitions

Precharge Voltage Input voltage during precharge

Input Real Current Filtered real component of input current

Input Reactive Current Filtered reactive component of input current

AFE Reactive Current Reference Desired input reactive current in AFE system

AFE Input Voltage Feed-forward Feed forward voltage term of AFE control

AFE Real Current Feed-forward Feed forward current term of AFE control

Input Id Unfiltered Real current before filtering

Input Iq Unfiltered Reactive current before filtering

AFE kVAR Input reactive power on AFE

AFE kW Input real power on AFE

Maximum Demand Output Clamped speed demand (at the maximum limit) at the ramp input

SMDC Mode State Variable SMDC startup state machine variable 

Disabled = 0

Transition = 1

Enabled = 2

Variable Name Description

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

44 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

*

 Refer to the Command Generator Diagram, DWG A1A459713, to see where these variables 

are used in the control code.

Drive Loss Fault Limit Threshold limit used by the Excessive Drive Loss Fault for tripping

Iqs Ref Ramp Torque ramp output

HS dlay ang High Speed delay angle

In V Fund Mag Input Voltage Fundamental Magnitude

Rlbk Disable Disable Rollback active

Total Current Total Output Current filtered

Ph A out V Phase A Output volts (rms)

Ph B out V Phase B Output volts (rms)

Ph C out V Phase C Output volts (rms)

Ph A out I Phase A Output current (rms)

Ph B out I Phase B Output current (rms)

Ph C out I Phase C Output current (rms)

Variable Name Description

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 45

3.7.3 Time Scale Adjustment

The total time span of the screen can be adjusted using the Time Scale parameter (ID # 

10000). The update rate of the screen depends on the traffic on the network. A small time 

scale of 20 seconds or less may result in broken traces. A time span of 30 seconds results in 

a uniform display with no gaps in the traces.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

46 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3.7.4 Freezing Graph on Fault

The screen can be set to automatically “freeze” whenever a fault occurs. This feature is 

enabled/disabled by clicking the right mouse button while the cursor is on the graphing win￾dow and selecting “Freeze On Fault.”

When this feature is enabled, the “Freeze On Fault” menu selection will display a check mark 

and the Graphics window title will show “Graphics – Freeze On Fault”. When this feature is 

enabled and all faults are cleared and a subsequent fault occurs, the graph will freeze five 

samples after the occurrence of the fault. 

There are 100 samples across the entire graphing time scale. 

NOTICE

The “Freeze on Trigger” function must be disabled to enable the “Freeze On Fault” menu 

selection.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 47

3.7.5 Freezing Graph on Trigger

The screen can be set to automatically ‘freeze’ whenever the value of a variable being 

graphed reaches a set trigger point condition. This feature is enabled/disabled by clicking the 

right mouse button while the cursor is on the graphing window and selecting “Freeze on Trig￾ger.” 

The trigger is set-up by clicking the right mouse button while the cursor is on the graphing 

window and “Set up trigger…” is selected. Select the variable on which the trigger will be 

based in addition to the type of trigger and the trigger point. The trigger point is based on the 

non-scaled non-offset variable value. Also, enter the number of samples which will be dis￾played after the trigger point is reached. There are 100 samples across the entire graphing 

time scale. 

When this feature is enabled, the “Freeze on Trigger” menu selection will display a check 

mark, and the graphics window title will show “Graphics – Trigger enabled.”

When this feature is enabled and the trigger conditions are satisfied, the graph will freeze 

after the number samples entered in the trigger set-up are subsequently graphed. The Graph￾ics window title will then show “Graphics – Graph triggered.”

NOTICE

The “Freeze on Fault” function must be disabled and the trigger must be properly set-up to 

enable the “Freeze on Trigger” menu selection.

NXG / NXGII Drive Tool

3.7 Operating the Drive Tool 

48 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3.7.6 Post Processing of Data

The screen can be manually “frozen” by placing the mouse over the plot window, clicking on 

the right mouse button and choosing the “Freeze/Unfreeze” command (or using CONTROL P 

on the keyboard), or by using either of the two automatic methods described in the preceding 

subsections of this chapter.

While the screen is frozen, the “Export” command (available using the right mouse button) 

can be used to save the plot as a Windows MetaFile, BitMap File, or in a tabular form in a 

Text File (that can be read by Excel or any Text Editor). Alternatively, the plot can be sent 

directly to a printer.

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 49

4

NXG Debug Tool

The NXG Debug Tool is PC-based application software that provides a remote graphical user 

interface for Siemens medium voltage Perfect Harmony NXG Series Drives. With the Debug 

Tool, you can examine drive variables using a PC and a mouse, allowing you to monitor that 

drive’s functions quickly and easily. The NXG Debug Tool is a high level GUI that runs on a 

PC equipped with the Microsoft® Windows Operating System. The NXG Drive Control and the 

PC running the NXG Debug Tool interface with each other using Ethernet and TCP/IP proto￾cols.

4.1 System Requirements

The NXG Debug Tool is a Microsoft® Windows application requiring the .NET 2.x Framework. 

It requires Windows® 98/NT4.0/2000/XP/Vista, at least 128 MB of RAM, and a minimum of 15 

MB of disk space.

4.2 Start and Configure the Debug Tool

If no configured drives exist, it will be necessary to configure a new one. To do this, click the 

“New” button in the “Drive configurator” area of the ToolSuite dialog box to display the New 

Debug Tool window as shown below. 

NXG Debug Tool

4.2 Start and Configure the Debug Tool

50 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

NXG Debug Tool

4.2 Start and Configure the Debug Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 51

In the new dialog box shown below, enter a drive name and the IP address of the drive in the 

space provided. Click the “OK” button.

The ToolSuite dialog box reappears, now showing the newly configured drive “New Drive.” 

NXG Debug Tool

4.2 Start and Configure the Debug Tool

52 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Double click the icon “New Drive” to start the Debug Tool. If the IP address is correct, the dis￾play should appear as shown below:

The following figures show examples of screens in the NXG Debug Tool:

Figure 4-1: Example of NXG Debug Tool Screen: SOPY Drive Misc Status Flags 2

NXG Debug Tool

4.2 Start and Configure the Debug Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 53

Figure 4-2: Example of NXG Debug Tool Screen: Status Y Synch Motor Misc

Figure 4-3: Example of NXG Debug Tool Screen: Status Y Modulator

NXG Debug Tool

4.3 Operating the Debug Tool

54 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

4.3 Operating the Debug Tool

The Debug Tool was designed to replace the local debug monitor and keyboard interface 

hardware previously used to provide internal debug information about the NXG Control. The 

tool uses pull down menus and contains the same screens as the previous debug monitor 

interface. To gain access to a feature of interest, simply click on the pull down menu to select 

that feature. Below is a list of available features:

Operation

• Change IP Address

• Exit 

Status

• General

• Advanced

• Synch Motor Misc

• Modulator

• Power Cell Status 1

• Power Cell Status 2

• AP Cell Status

- DSP State

- DSP Status

- Misc Status

- Cell Feedback

- Feedback by Rank

Rank 1

Rank 2

Rank 3

Rank 4

Rank 5

Rank 6

Rank 7

Rank 8

- Com Via TCP

• Wago

• Internal I/O 1

• Internal I/O 2

• Parallel Data 1

NOTICE

Available features are dependent upon the version of drive software to which the Debug Tool 

is connected. The full feature set is available on Version 5.0 or higher software.

NXG Debug Tool

4.3 Operating the Debug Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 55

• Parallel Data 2

SOP

• Command Generator Flags

• Comparators

• Counters

• Drive Misc Status Flags 1

• Drive Misc Status Flags 2

• Drive Misc Status Flags 3

• Loss of Signal Flags

• Serial Flags

• Static Flags

• Synch Transfer Flags

• Temp Flags

• User Interface

• Active Variables/Counters/Timers

• Timers

- Menu Based

- SOP Based

• Wago

- Digital Inputs

Inputs 1-8

Inputs 9-12

- Digital Outputs

Faults/Alarms

• Drive

- Word 1 bits 0-31

- Word 1 bits 32-63

- Word 2 bits 0-31

- Word 2 bits 32-63

- Word 4 bits 0-31

- Word 4 bits 32-63

• User 

- User Faults 1–32

- User Faults 33-64

NXG Debug Tool

4.3 Operating the Debug Tool

56 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Networks

• Status

• Network 1

- Input Flags

- Output Flags

- Fixed Registers

- Register Data

- Global Data

• Network 2

- Input Flags

- Output Flags

- Fixed Registers

- Register Data

- Global Data

• Internal Net

• TCPIP Net

• Hex

Files

• List

- Config Files

- SOP Source Files

- SOP Hex Files

• Upload

- Config Files

- Drctry File

- SOP Source Files

- SOP Hex Files

- System Files

 Language File

 MinMax File

 Modulator Look-up Table File

 Version History File

Logs

• Fault

• Historical

• Event Log File

About

• Current NXG Debug Tool version and connected NXG Drive Software version

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 57

5

NXG SOP Utilities

5.1 Introduction

Siemens ID Series of digital drives contain customized programmable logic functions that 

define many features and capabilities of the drives. These logic functions are combined into a

System Program that can be edited either at the factory or in the field. Examples of logic func￾tions include start/stop control logic, input and output control logic (e.g., annunciators, inter￾locks, etc.), drive-to-machinery coordination, and more. The System Program is stored on the 

system non-volatile memory, and runs in the drive under an interpreter, causing the intended 

logic statements to perform their functionality.

The System Program is the logic that maps the external I/O into the functionality of the drive. 

In its simplest form, it just maps internal states to external points. In more complex forms, 

additional complex logic, in the form of Boolean logic, as well as timers, counters, and com￾parators, express the system functionality to the drive. 

Generally, this type of logic takes the form of ladder logic diagrams. Sum-Of-Products nota￾tion is a shorthand method for expressing the ladder logic in textual form. In fact, there is a 

direct correlation between the two, which is covered in the section on ladder logic and Bool￾ean theory.

The SOP Utilities is a group of utilities under the ToolSuite umbrella program. It is launched 

much the same as the other tools. It performs most of the functionality on the PC running the 

ToolSuite, but has serial communications capability for uploading and downloading the Sys￾tem Program directly to the drive via an RS232 interface between the drive and the PC.

The purpose of the SOP Utilities Tool is to convert logic statements in the form of Sum-Of￾Products (SOP) notation into a form of machine-recognizable code that is run under the built￾in drive SOP interpreter. The mechanics of this operation are described in the drive manual 

and are not discussed in this context.

5.2 SOP Utility Tool Overview

To understand the use of this utility, we must look at the individual functions and describe the 

purpose of each. These functions are summarized in Table 5-1. 

NXG SOP Utilities

5.2 SOP Utility Tool Overview

58 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table 5-1: SOP Utility Terminology

Name Function

Source File The source file is an ASCII text file containing simple Boolean statements and 

operators. This file is edited on a PC using any standard ASCII text editor. This file is 

used as the input to the compiler program and is unreadable by the drive. The source 

file uses the .SOP file extension.

Hex File The hex file is a compiled version of the source file, and is in the format of an Intel 

ASCII Hex downloadable file. The hex file is a result or output of the compile process. 

This is the file that is sent from the PC to the drive over the communications cable, 

using the serial communications function of the Tool and software functions chosen 

from the drive menus. The hex file is viewable by a text editor, but is unreadable by the 

user. It must be reverse compiled to be viewed by the user. Optionally, during the 

compile process, the entire source file, with comments, may be appended to the hex 

file.

ASCII Text 

Editor

The ASCII text editor is a software program used to edit the source file of the system 

program. The default is Windows Notepad, but any text editor can be used, as long as 

no hidden, unprintable characters are used.

Compiler 

Function

The compiler function is built into and invoked from the SOP Tool. It is used to 

translate the ASCII text source file (.SOP) into hex. This program reads the input 

source file (.SOP), validates the statements for proper syntax and symbolic content, 

generates primitive logic functions that implement the higher level logic statements, 

and stores this information into an output file using Intel hex file format. The resulting 

.HEX file can be downloaded to the drive. With Version 2.4 NXG Drive software, the 

source file can be appended to the hex file for retrieval by the reverse compiler 

function.

Reverse 

Compiler 

Function

The reverse compiler program does the opposite of the compiler program. It uses the 

compiled hex file (with a .HEX extension) as the input, and produces an ASCII text 

output file (with a .DIS [for disassembly] extension) that can be read by the user via 

any standard text editor software. This program is useful if the original source file is 

lost, damaged, or unavailable. Note that any comments in the original source file will 

not be reverse compiled, since they are ignored by the compiler program when the hex 

file is created with Version 2.4 NXG Drive software. If the source file is appended to 

the hex file, a reverse compile will retrieve the source, complete with comments, rather 

than go through the reverse compile process.

Communications 

Function

The communications function is used to send the compiled version of the System 

Program from the PC to the drive or retrieve the file from the drive. The communication 

options must be configured for proper communications (i.e., baud rate, number of data 

bits, number of stop bits, and parity settings). 

Communications 

Cable

This is a serial communications cable over which data (e.g., the System Program) is 

transmitted between the drive and the PC. The exact specifications of this cable vary, 

based on the drive being used and the type of connector available on the serial 

communications port of the PC.

Product Type The supported product type is generally a Siemens ID-Series motor drive, Perfect 

Harmony, or other compatible drive. It uses the System Program that is stored in a 

nonvolatile portion of memory on the drive to evaluate logic statements in order to 

perform their functionality with the drive operation or I/O. Within its menu structure, the 

drive contains software functions used to enable uploading and downloading between 

the drive and the PC via RS232 serial communications. The settings of 

communications parameters in the drive must match the settings in the communication 

options in the Tool for proper communications during System Program transfers.

NXG SOP Utilities

5.3 Starting the SOP Utility Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 59

5.3 Starting the SOP Utility Tool

Start the SOP Utility Tool by selecting the Utilities Tab as shown in Figure 5-1.

Figure 5-1: SOP Utilities Start Window

NOTICE

Intel hex format is an ASCII representation of binary data. The hex file mentioned in the previ￾ous table uses various record types to set the download location and to detect errors. The 

source file, if included, is simply appended to the end of the Intel Hex file, and does not 

affect the operation of the SOP file. It is not loaded into memory, but simply stored for future 

reference or retrieval.

NXG SOP Utilities

5.3 Starting the SOP Utility Tool

60 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Once the SOP Utility Tool starts, the opening screen, as shown in Figure 5-2, will display.

Figure 5-2: SOP Utilities Opening Screen

Selecting the target source file also selects the target Directory (DRCTRY) file for mapping 

the valid Product flags and I/O, and automatically selects the Product type (see Figure 5-3). 

The source file can then be further edited by selecting the edit button. This will invoke the text 

editor – the default being the Windows Notepad. The default editor can be changed by select￾ing the “Change Default Editor” and then browsing to the desired text editor. A word processor 

can be used, but only if the output file is set for pure ASCII text, with no formatting characters 

embedded in the saved file.

NXG SOP Utilities

5.4 SOP Development Process

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 61

Figure 5-3: SOP Utilities Window

5.4 SOP Development Process

The SOP general process consists of:

• Creating a text document explaining, in prose, the operation of the system, including all 

fault handling processes.

• Creating a ladder logic diagram of the control logic that is to be implemented in the SOP, 

including a detail of the I/O interface as matches the system drawings.

• Converting the ladder logic into sum-of-products statements utilizing Boolean logic and 

DeMorgan’s Theorems.

• Creating a text document, the source file, with the appropriate statements and detailed 

comments as to the system use of the logic. This text file is given the extension of .sop, for 

sum-of-products notation source file.

The textual description is created in the SOP text templates. The templates are a series of 

spreadsheets that textually define the standardized TB2 designation, the WAGO assignment, 

the sequence of operation, etc. Templates are available for both air-cooled and water-cooled 

systems.

The standard logic diagrams and accompanying SOP function blocks are defined in Engi￾neering Reports and are useful for creating the standardized functions of the SOP – both in 

ladder logic and in sum-of-products notation. The Engineering Report provides a standard 

NXG SOP Utilities

5.5 Overview of the Compile Process

62 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

means to produce customer SOPs. The function blocks can be used as presented, or can 

serve as a template for customer requests not specifically addressed by the blocks.

The SOP input source file is composed in an ASCII text editor and compiled by a Siemens LD 

A compiler. SOP testing is performed at the Siemens LD A facility. 

The remainder of this chapter details the process of creating and compiling the SOP.

5.5 Overview of the Compile Process

Once the source file is completed, the next stage is compilation. This is necessary to trans￾form a human-readable document into a machine-readable program.

Compilation requires a directory file, which is determined by the type of target drive to be 

used. This is determined in one of two ways. Either the drive type is embedded as the first line 

of the source file, or if this statement is missing, the drive type must be explicitly determined 

by selecting from a picklist.

The directory file contains data critical to the compile process. It is an ASCII text file, which 

contains the variable names along with designators that the compiler uses. Comments are 

included to help understand the meaning and use of the variables. It is useful to view the 

directory file as the System Program is being developed, to obtain the correct spelling of the 

system flags and variables. It is for this reason that the file is readable text. However, it is crit￾ical to not edit the directory file without first-hand intimate knowledge of the data structures 

used within the file.

The compilation process reads each logic statement from left to right, creating data tables for 

the variables used, logic statements, operators, and output assignments. The result is read￾able by a special interpreter that resides within the product core code. The actual names are 

not used, but are substituted by the compile process, substituting and assigning special inter￾nal memory locations for each. This reinforces the need for proper spelling of variables as 

they appear in the directory file.

Selecting the Compile button begins the compile process, which then prompts the user to 

select whether to attach the source file to the generated hex file:

On successful completion of compilation, a dialog box will pop up stating this along with addi￾tional pertinent information on the size of the file, checksum of the SOP hex file, and number 

NXG SOP Utilities

5.5 Overview of the Compile Process

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 63

of counters and timers used, along with other information that is useful for debugging pur￾poses by factory personnel:

Should an error occur during compilation, an error dialog will appear:

Acknowledging the error reveals the source of the error by logic statement number, and by 

text file line number:

An output file is not generated until a successful compilation occurs. Should the name of the 

source file not conform to the 8.3 DOS naming convention, and the Product type be a Next￾Gen drive, an additional message will appear:

NXG SOP Utilities

5.6 Input Source File

64 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

For a list of other compile errors, see Table 5-6 in this chapter.

5.6 Input Source File

The input source file is the ASCII text version of the System Program that is edited by the 

user. Editing can be performed using any standard ASCII text editor on a PC. The file can 

contain both logic statements and explanatory comments to aid in documenting the content 

and intent of the logic statements. With the exception of simple true and false logic assign￾ments, the order of the statements in the source file is the order in which the statements will 

be executed by the drive’s run time software. True and false statements are placed first in the 

hex file at the time of compilation, and are executed only once after System Program initial￾ization. All other statements are executed in order from top to bottom in a continuous manner. 

Results of the evaluation of a logic statement are immediately available as inputs to state￾ments that follow.

The format for a System Program source statement is as follows:

output_symbol = {unary_operator} input_symbol { [ binary_operator {unary_operator} 

input_symbol ] ... };

where:

output_symbol represents an output symbol defined in the symbol 

directory file

= the assignment operator (only one per source statement)

input_symbol represents an input symbol defined in the symbol 

directory file

unary_operator Boolean NOT operator (/ character)

binary_operator Boolean operators OR and AND (+ and *, respectively)

{ } represents optional syntax

[ ] represents required syntax

... the previous operation may be repeated

; statement terminator

The statement can span multiple lines and can contain spaces as needed for readability. The 

output_symbol is a required field and can be any symbol that would be valid as an output vari￾able. The output_symbol is followed by one or more optional spaces and then the required 

assignment operator “=”. A source statement can contain only a single assignment operator.

NOTICE

This is not a limitation of the SOP compiler, but of the NXG operating system file system, so 

it only applies to this Product type.

NOTICE

Program statements may span multiple lines by breaking the line at a convenient operator. 

The single line length of 132 characters should not be exceeded.

NXG SOP Utilities

5.6 Input Source File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 65

The input side of the equation must equate a simple Boolean form (either true or false) after 

evaluation. It is formed from either a simple input symbol (possibly negated with a NOT unary 

operator) or a combination of input symbols on which binary operators operate. Input symbols 

and binary operators are evaluated left to right by the run time software. The precedence of 

operations is summarized in the next section. 

The execution flow of the run time software is as follows:

1. Comparator evaluations are performed and the resulting system flags are updated.

2. Input flags are scanned and their present state(s) are recorded.

3. Logic equations are executed based on the recorded input states.

4. The results of the logic statement(s) are output.

A sample input source file is illustrated at the end of this chapter. Although this sample source 

file may appear to be very complex, it contains only four basic types of statements:

• Logic statements that can continue to additional lines

• Comment lines for explanation of code operation and purpose, or to document I/O 

assignments

• Text labels for user-designated faults

• Assignments that substitute a user-defined label for an internal variable for easier 

understanding

Semi-colons serve a dual purpose in the source file. Every logic statement must be terminated 

by a semi-colon. Also, comments are any text that follows the semi-colon at any placement 

location on a line. All lines that begin with text instead of a semi-colon are interpreted by the 

compiler program as logic statement lines. Program source lines may continue to other lines 

and are finally terminated with a semi-colon. This technique can be used to make the logic 

more readable. Based on this, comments may not be added within the scope of a single, 

multi-line program statement, as the semi-colon will be interpreted as the end of the logic 

statement, and the next line without a semi-colon, as the next logic statement.

Logic operators separate variables used within logic statements. Every variable must have 

some logic operator following it in the logic statement. The logic operators supported in the 

SOP are the AND (*), OR (+), ASSIGNMENT (=), statement termination (;), and NOT (/). 

Comment lines provide additional information to the reader, but provide no additional informa￾tion for the compiler. It is strictly a tool for better understanding of the intended logic of the 

logic statements. As such, comments should not be added simply to be there, but must be 

structured to provide an overview of what the logic is trying to accomplish in the system. This 

NOTICE

• Each statement must be terminated with a semicolon.

• Symbol names are not case-sensitive to the compiler. The symbols symbol_1, 

Symbol_1, and SYMBOL_1 are all treated identically.

NOTICE

In the case of logic assignments, where the source state is a simple “true” or “false,” the 

assignment is made only once at runtime software initiation.

NXG SOP Utilities

5.6 Input Source File

66 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

information is vital to the maintenance of the SOP for future reference as to the intent of the 

logic, not only for the originator, but also for anyone who must maintain or change the code in 

the future. It is a tool for conveying information that is not intuitively apparent in the logic state￾ments themselves.

Substitution names also serve to clarify the intent of the logic statements. When a generic 

system flag, such as a timer, counter, I/O assignment, or temp flag, is used for a specific pur￾pose, consider using the substitution operator to define a label that better suits its functional￾ity. For example, if an output is used to switch on a pump or fan, then consider renaming the 

output “Pump_on”, or “Fan_on” instead of the generic “ExternalDigitalOutputxxx_O”.

NOTICE

• All source code comment lines are ignored by the System Program compiler. Only the 

program statements (with any optional comment suffixes omitted) are compiled into the 

binary (hex formatted) System Program that is downloaded to the drive. For this reason, 

the process of reverse compiling the System Program yields source code without 

comments. For more information on the process of reverse compilation, refer to Table 

5-1 and Table 5-7.

• Comment text cannot be added within the context of a multi-line logic statement, but 

must follow the semi-colon terminating the logic statement. Logic statements can extend 

to multiple lines for readability, but must be terminated by a semi-colon at the end of the 

statement.

• Logic statements must not exceed 132 characters in length. The compiler truncates any 

single line beyond that length and ignores anything further in the line. This length 

limitation is for a single line, and the count is reset when a new line is started. Therefore, 

continuing long logic statements to multiple lines is essential for proper compilation as 

well as better readability.

• Typically, logic statements are broken at the OR operator (+) in the sum-of-products 

notation.

• All statements must be in the form of sum-of-products notation. 

NXG SOP Utilities

5.6 Input Source File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 67

5.6.1 System Type Identification

Because the compiler and reverse compiler support a number of different end products, the 

compiler needs to know what the target system is, so that it can generate the proper code for 

that target system.

To identify the system type, include the system type identifier command as the first line in the 

System Program SOP file. The syntax of this command is shown below:

#system_type

The statement must be on the first line, a pound sign (#) character must appear in column 1, 

and the program line must end with a semicolon. For Perfect Harmony Drives, the proper for￾mat of this command is shown below:

#NEXTGEN;

The compiler also recognizes other system types. 

Table 5-2 shows the interface for the pull-down product type selector. Alternatively, if you have 

an SOP file that does not include the #system_type; identifier, then the Product Type selec￾tor pull-down is activated and a selection must be made before a directory file can be selected 

or before compilation is enabled (note that the Compile button is grayed out until after the selec￾tion is made).

NOTICE

A comment can follow the semicolon with the system type identification command.

NXG SOP Utilities

5.6 Input Source File

68 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table 5-2: Product Types Recognized by the System Compiler

Figure 5-4: SOP Utilities Compiler Showing Product Type Pull-Down

Target Product Type Identification Command

Perfect Harmony #HARMONY;

454 GT #ID_454GT;

ID-CSI #ID_CSI;

DC Harmony #HARMONY_DC;

ID-2010 #ID_2010;

NXG Control #NEXTGEN

Silcovert H #SILCOVERT_H

High Availability #HIGH_AVAIL

NXG SOP Utilities

5.6 Input Source File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 69

Table 5-3: Directory Filename Associations

5.6.2 SOP Source File

The SOP file, as mentioned previously, is written with a text editor or a word processor set for 

pure ASCII text (having a .TXT file extension) with no control or formatting codes, with the 

exception of horizontal tabs (ASCII code 09h) and carriage returns (0Dh). Only printable char￾acters and spaces (20h) can be used. The file consists of the format shown in Table 5-4.

Target System Type Directory File Name

Perfect Harmony DRCTRY.PWM

454 G T DRCTRY.IGB

ID-CSI DRCTRY.CSI

DC Harmony (e.g., torch supply) DRCTRY.HDC

ID-2010 DRCTRY.DC

NXG Control DRCTRY.NXG

Silcovert H DRCTRY.SIH

High Availability DRCTRY.HA

NXG SOP Utilities

5.6 Input Source File

70 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table 5-4: SOP Text File Format

Item Description

Drive type 

specifier

This must reside on the first line of the file prefixed with the pound sign (#) and followed 

with the name of the drive (in the case of Perfect Harmony this would be #NEXTGEN;).

Header A comment field containing the following information:

Title - Siemens LD A Perfect Harmony drive

Program part number

Customer name

Sales order number and Siemens drive part number

Drive description

Original SOP date

File name

Engineer name (Originator)

Revision history (date and change description).

Example:

; Siemens Perfect Harmony Step Pwm Ac Motor Drive

; System Operating Program - Standard Performance

; NXG Control

;

; Program Number: 18xxxxxx.SOP

; Customer: xxxxxxxxxxxxxxxxxxxxxx

; Siemens Sales Order: xxxxxxx

; Siemens Part Number: xxxxxx.xx

; Description: xxxxx HP, xx.x kVac in - x.x kVac out, Size xx

;

; Original mm-dd-yy : Original version.

;

; REVISIONS:

; Changed mm-dd-yy - : ECR number - Description of changes

Operators Comment field containing operators and symbols

Example:

; = equals * logical AND + logical OR / logical NOT

; ; comment line

NXG SOP Utilities

5.6 Input Source File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 71

I/O 

specifier

Comment field describing the system input and output flags as they relate to the external 

system. This would include any user faults and notes on menu settings, such as 

Comparator setups and XCL settings, as they apply to the System Program. These can 

(and should) be grouped logically to allow easy access to information and to make the 

SOP more understandable.

Example:

;--------------------------------

; Wago Digital Inputs (dedicated)

;--------------------------------

; RemoteStart_I EDi01-a - Remote start - Momentary close to start 

; RemoteStop_I EDi01-b - Remote stop - Momentary open to stop 

; RemoteFaultReset_I EDi01-c - Remote fault reset - Momentary close to reset drive faults

;-----------------

; Comparator Flags

;-----------------

; Values of “Fixed Percentage” is what is entered in the comparator menu.

; The percentage is entered as the desired percentage of signal full scale.

; Comparator1_I Coolant conductivity > 3 uS Process Alarm

; 1A - Analog input 3

; 1B - Fixed percentage = 30 %

; 1C - Magnitude comparison

User fault 

messages

Assigns the text to be displayed when this particular user fault is activated.

Example:

; UserText1 = “UPS On Inverter”;

; UserText2 = “UPS Alarm”;

Replaceme

nt variable 

assignment

Allows the user to redefine the label on common variables to make the SOP code easier 

to read. The compiler only uses this during compile. If any information is to be stored, it is 

recommended that the source file be attached.

Example:

$ManualControlOn = Counter01;

$ManualControlOff = CounterReset01;

Main logic 

section

All the equations and assignments for the configuration, annunciation, and operation of 

the drive. These should be logically arranged with careful consideration given to the order 

of evaluation of the equations.

Item Description

NXG SOP Utilities

5.6 Input Source File

72 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5.6.3 Input Flags

Input flags are identified by variable_I. Input flags are symbols that are encountered on the right￾hand side of a source statement (to the right of the equals sign) that express the state of an 

input to the system. They may reflect the state of a digital input (e.g., 

ExternalDigitalInput01a_I, ExternalDigitalInput01b_I) or switch (e.g., KeypadManualStart_I), 

the state of a system process (e.g., Cells_I, OverloadFault_I, OutputPhaseOpen_I), internal 

variable, Comparator flag 

(e.g., Comparator_1), or a simple literal (TRUE, FALSE). These input flags are combined using 

the unary and binary operators to form logic expressions.

Digital input flags generally represent the state of a discrete digital input signal into the sys￾tem. These may be a 24-volt logic input, a key switch or push-button in the system, or some 

form of a binary input. They also can be internal flags that indicate a state or condition of the 

drive, e.g., faults, warnings, limits, etc. The inputs are scanned at the beginning of each execu￾tion cycle, but may reflect older information in some cases.

System constants TRUE and FALSE are predefined and can be used as input terms to an 

expression.

There exists the capability to compare the value of certain system variables against preset 

thresholds in real time, and then use the results of the comparisons (TRUE or FALSE) in the 

System Program to control actions on the drive. The variable(s) to be compared and the 

thresholds are entered into the system using the keypad. The output of the comparisons 

(Comparator1_I ... Comparator16_I) are available for use in the System Program as input 

symbols.

5.6.4 Output Flags

The output flags all have “_O”, tagged to the end of the variable name (variable_O). The out￾put flags (the symbol placed on the left-hand side of the assignment “=” operator) direct the 

result of the input expression towards an output purpose. Output flags represent items such 

as digital outputs and system control switches. 

Table 5-5: Types of Output Flags

Types Examples

digital outputs ExternalDigitalOuptput01a_O

system control switches AutoDisplayMode_O, RampStop_O, , RunRequest_O

NOTICE

Digital output flags generally represent some form of discrete digital output bit(s) from the 

system. These may be a relay coil driving contacts (NO or NC), direct digital outputs, or lamp 

controls. The digital output signals are updated at the completion of each System Program

execution loop.

NXG SOP Utilities

5.6 Input Source File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 73

There is a set of Boolean temporary flags available to hold temporary or common expressions 

in the System Program. By using these temporary flags to hold common expressions, System 

Program execution times can be improved. The System Program compiler does not perform 

any optimization, it generates code closely matching the equations as written. If there are 

expressions that are repeatedly evaluated, set a temporary flag to the intermediate results, and 

then use the flag instead of the longer expression.

For example:

ExternalDigitalOutput01a_O = ExternalDigitalInput01_a + 

ExternalDigitalInput01b + RunRequest_O;

SetPoint1_O = ExternalDigitalInput01a_1 + 

ExternalDigitalInput01b +RunRequest_O;

SetPoint2_O = ExternalDigitalInput01a_1 + 

ExternalDigitalInput01b +RunRequest_O ;

could be replaced with:

TempFlag01 = ExternalDigitalInput01a_1 + 

ExternalDigitalInput01b _1 +

RunRequest_O;

ExternalDigitalOutput01a_O = TempFlag01;

SetPoint1_O = TempFlag01; SetPoint2_O = TempFlag01;

A time-out function may be implemented with System Program timers. These timers are 

enabled using logic statements and the output (based on the timer expiring) is available as an 

input to logic statements. The time period is set in seconds with the resolution. The unit speci￾fied in the logic statement is seconds (with a decimal fraction rounded to the nearest internal 

NOTICE

The Perfect Harmony series of drives (as well as all other ID series drives) have a set of pre￾defined symbols that describe control outputs or “switches” that can be controlled by the 

System Program. These switches can control functions such as the source of the speed ref￾erence, a selection for the system acceleration rate, and a multitude of others. In most 

cases, to cause the system to perform in the intended manner, the proper control switches 

must be set (and others cleared) by the System Program. The default state for all control 

switches is FALSE. Unless the System Program sets the switch to TRUE, it will be inactive 

(FALSE).

NOTICE

No variable_I, Input variable can appear on the left side of the “=” sign. Both variable_I and 

variable_O can appear on the right side of the “=” sign

NOTICE

Only one switch should be set at any one time from any functional grouping of switches 

(e.g., command generator input grouping).

NXG SOP Utilities

5.6 Input Source File

74 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

resolution). Time intervals are up to 16,383.5 seconds for the Next Gen version of Perfect 

Harmony.

The statement:

Timer01(20.0) = symbol_a;

enables timer 1 if symbol_a is true. The statement:

output_1 = Timer01;

sets the symbol output_1 true if the timer has expired (timed out). In the example above, if 

symbol_a is false, output_1 will be false. If symbol_a is set true, then 20 seconds later, 

output_1 will be set true (assuming symbol_a remains true).

Once the enabling logic goes FALSE, the entire time-out period must pass before the timer will 

time-out. Should it go FALSE before the time-out period, the timer count is reset to zero, and 

the timer must go the entire period before timing out.

Counters in a System Program can be used to count the number of FALSE to TRUE transitions 

of the counter input. A corresponding counter reset input is used to reset the counter value to 

zero. For example:

Counter01(13) = input_a; 

CounterReset01 = input_b; 

output_a = Counter01;

If input_b is set TRUE, Counter01 is set and held to zero. If input_b is FALSE, after 13 FALSE to 

TRUE transitions of input_a, the symbol Counter01 (and output_a) will be set TRUE. After 13 

transitions, Counter01 will remain TRUE until Counter01 is cleared by CounterReset01. The 

maximum count value is 32767. The count value must be an integer.

5.6.5 Redefining Flag Names

To make flag names more intuitive, you can redefine flag names so that your names may be 

substituted for the generic flag names thereafter. The definitions are made near the start of the 

program to ensure that they are defined when needed. The format for the definitions is:

$NewFlagName=nameInDirectoryFile

where NewFlagName is your new definition, and nameInDirectoryFile is the flag name 

found in the drty.ngn file.

For example, a typical SOP program might define flags as follows:

Counter01(30) = /ExternalDigitalInput01f_I*

ExternalDigitalInpout01e_I*Timer00;

CounterReset01 = ExternalDigitalInpout01e_I;

If you include the following at the start of the program:

$FireAlarmCircuitTimer = Counter01;

$FireAlarm_I = ExternalDigitalInput01f_I;

$FireAlarmPumpHasOverheated = ExternalDigitalInput01e_I; 

$FireAlarmWarningTimer = Timer00;

$ResestFireAlarmCircuitTimer01 = CounterReset01; 

NXG SOP Utilities

5.7 Compiler Operation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 75

then the lines in the program become:

FireAlarmCircuitTimer (30) = /FireAlarm_I*/ 

FireAlarmPumpHasOverheated_I *FireAlarmWarningTimer;

ResetFireAlarmCircuitTimer01 = FireAlarmPumpHasOverheated_I; 

5.7 Compiler Operation

As discussed earlier in this chapter, three files are accessed during the compilation process: 

the source (or SOP) file, the DRCTRY.NGN (directory) file, and the output hex file. When the 

compiler is invoked, it first opens the SOP file to determine if it contains a system_id definition 

line as the first line in the file. This line defines the target system type to the compiler. If the 

necessary files are not found in the default directory, you may search elsewhere using the stan￾dard Browse button.

Figure 5-5: Selecting the .SOP File Using the Browse Button

The System type information is used to search for a proper directory file to use during compi￾lation. The type information is placed into the hex file so that the System Program cannot be 

used in the wrong type of system (e.g., loading a Harmony System Program into a 454 GT 

drive).

NOTICE

If you use the Siemens LD A SOP Utilities program to compile an SOP file that does not 

include the #system_type; identifier, then the Product Type drop-down list is enabled, and you 

must select the appropriate product type. This selection will then be compiled into the 

resulting hex file.

NOTICE

The DRCTRY.NGN file must adhere to certain syntax and format rules. Refer to Appendix 

Operators and Precedence.

NXG SOP Utilities

5.8 Output Hex File

76 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

The compiler searches for the directory file in the current directory first. If it is not found there, 

the compiler provides a browse function for finding an appropriate file. In all cases, the opera￾tor can verify that the intended file was used.

5.8 Output Hex File

Any inconsistencies that occur during the compilation process are flagged and error mes￾sages are displayed in a pop-up window. These error messages indicate the problem and lead 

the user towards problem resolution. Error messages are listed in Table 5-6.5-6

After successful processing, the third and final file is created. This is the hex file and it is 

named the same as the source file with the extension changed to “.HEX.” The entire recom￾piled System Program and is summed up in a modulo 256 result that is inverted (2’s comple￾ment) and placed in the header of the compiled System Program. This is the System Program

checksum. The output is formatted in Intel 8086/8088 record format with a starting load offset of 

0000. Each record consists of 16 bytes of data. Zeroes are appended to the final record for 

padding.

When interpreted as an Intel hex file by the drive during the download process, a binary image 

of the logic functions results. These logic functions are stored and later executed by the drive. 

Each line of the hex file contains its own checksum. In addition, the compiler generates an 

overall System Program checksum. All of these checksums are validated during System Pro￾gram downloading and restart to ensure correctness prior to storing the statements inside the 

drive.

When downloaded into the drive, the System Program is structured into sections. The first sec￾tion is called the header and contains System Program location pointers, as well as the ver￾sion number and the System Program checksum.

The other sections concern the functionality of the System Program and are not covered here. 

5.9 Downloading a System Program (Hex File)

When the text for a System Program has been created, and the text file has been compiled 

into a hex file using the System Program compiler, the resulting hex file must be downloaded 

into the drive to become functional. Software embedded in the drive can be invoked to accept 

the properly formatted hex file into the drive using the RS232 serial port as the transfer 

medium. The program can be downloaded in one of two methods:

1. Using the Upload/Download component of the Siemens LD A SOP Utilities software. This 

method can be used by PCs that have at least Windows 2000 or later installed.

2. Using a terminal emulation program on the PC set up in ASCII file mode. This method can 

be used by PCs that do not run Windows or have a Windows version before Windows 95 

(using a DOSTM window). A native Windows terminal emulator can also be used.

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 77

5.9.1 Siemens LD A SOP Upload/Download Utility Method

The .HEX file must be downloaded using the Upload/Download component of the Siemens 

LD A SOP Utilities program.

Figure 5-6: Siemens LD A SOP Utilities - Upload/Download Component

1. Invoke the Siemens LD A SOP Utilities program.

2. Select the Upload/Download tab.

3. Enter the HEX file to be downloaded.

4. Select the Download radio button.

5. Set the baud rate from the drop down box to 9600 baud.

6. Connect the appropriate serial port of the host PC to the DB9 port of the drive using an 

appropriate serial cable (9-pin with appropriate connectors).

7. Select the “System Program Download” function menu (9120) of the drive. The drive will 

display download status information on the front panel (e.g., “Downloading from RS232”). 

The drive will indicate when it starts to receive data.

At the end of each hex line received, the drive will cause a bar in the last column of the key￾pad display to rotate to indicate that data is being received. Each data record that follows is 

then checked against its own checksum and loaded at the appropriate address in RAM. Errors 

in a data record result in a displayed error message and termination of the download process.

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

78 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5.9.2 Terminal Emulation Method

The .HEX file must be downloaded with a terminal emulation program on the PC set up in 

ASCII file mode.

1. Set the baud rate (the same as drive’s baud rate parameter), parity (none), data bits (8) 

and stop bits (1) of the communications software on the host PC, notebook, or laptop 

computer.

2. Connect the appropriate serial port of the host PC to the DB9 port of the drive using an 

appropriate serial cable (9-pin with appropriate connectors).

3. “Enable” the communications software (i.e., prepare the software to either send 

information to the drive or receive information from the drive). This basically puts the PC 

and communications software into a ready state. Typical communications software 

packages include Microsoft® Windows Terminal and 

Procomm-Plus (only Windows 95™-compatible, if running this operating system).

4. Use the “System Program Upload” or “System Program Download” function from the 

Serial Functions Menu (9110) of the drive to perform the desired function. The drive will 

display download status information on the front panel (e.g., “Downloading from RS232”).

The drive will indicate when it starts to receive data. At the end of each hex line received, the 

drive will cause a bar in the last column of the keypad display to rotate to indicate that data is 

being received. Each data record that follows is then checked against its own checksum and 

loaded at the appropriate address in RAM. Errors in a data record result in a displayed error 

message and termination of the download process.

NOTICE

Check the downloaded System Program file for the proper version number. If the user tries 

to download a System Program that was compiled with the wrong DRCTRY.NGN file (for 

example, an obsolete DRCTRY.DAT file), an error message will be displayed and the 

downloaded System Program will not be transferred to FLASH. Further, the system will not 

run a motor if, on power-up, the software detects a System Program checksum error or an 

out-of-range System Program version stored in the FLASH. To use an older System 

Program in a drive with newer software, the System Program must be recompiled with the 

newer DRCTRY.NGN file before it is downloaded.

NOTICE

Check the downloaded System Program file for the proper version number. If the user tries 

to download a System Program that was compiled with the wrong DRCTRY.NGN file (for 

example, an obsolete DRCTRY.DAT file), an error message will be displayed and the 

downloaded System Program will not be transferred to FLASH. Further, the system will not 

run a motor if, on power-up, the software detects a System Program checksum error or an 

out-of-range System Program version stored in the FLASH. To use an older System 

Program in a drive with newer software, the System Program must be recompiled with the 

newer DRCTRY.NGN file before it is downloaded.

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 79

5.9.3 Termination

Termination occurs when a valid “End Record” is received. If any error in transmission occurs, 

or if the user manually “CANCELs” the transmission, the original System Program will be cop￾ied back down from FLASH. If the new program is accepted and reaches normal termina￾tion, it is then transferred from temporary RAM into non-volatile FLASH storage, 

overwriting the original. The System Program is then re-initialized with the new information, 

and the System Program is restarted, executing the new statements.

Table 5-6: Compiler Error Messages

NOTICE

To cancel the download process during the System Program download, a 

[SHIFT]+[CANCEL] key sequence can be entered from the drive’s keypad to terminate the 

download process and restore the system to its original state.

Since the System Program execution must be stopped while downloading a new System 

Program, the drive cannot be running during the download process.

Error Message Description

DRCTRY Error

ERROR in line nnnn - << flag name>> is longer 

than 43 characters.

The error occurred in the Directory file.

While loading, the System Program flag found that the 

directory file is too long. The offending flag and its line 

number in the directory file are listed. The directory file is 

probably corrupted. Get the latest version and try again.

DRCTRY Error

ERROR in line nnnn - << flag name>> can'

t find 

system address.

While loading the directory file, the compiler can’t 

determine the system address. The flag name and error 

line number points to the source of the error. The directory 

is probably corrupted. Get the latest and try again.

DRCTRY Error

ERROR in line nnnn!! <> can’

t find 

bit address.

While loading the directory file, the bit address cannot be 

determined. The file is probably corrupt. The flag name and 

line number should show where the corruption occurs. 

Replace the directory file and try again.

DRCTRY Error

ERROR in line nnnn!! <> can'

t find 

type code.

While loading the directory file, the flag type cannot be 

determined. The file is probably corrupted. The flag name 

and line number should show where the corruption occurs. 

Replace the directory file and try again.

SOP Error

ERROR!! User Text text flag defined multiple 

times.

The user text assignment flag displayed has been used 

multiple times in the System Program. Find the 

occurrences and correct them, then recompile.

SOP Error

ERROR!! Expecting '\' found >> CR or LF <<

The compiler was expecting an end quotation mark and 

found an end of line instead. The error location will show in 

another popup window at the end. Edit the source program 

and try again.

SOP Error

ERROR!! User Text flag ID is longer than 24 

characters.

User Text must not exceed 24 characters - the limit on the 

keypad directory. Edit the source file and try again.

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

80 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

SOP Error

ERROR!! Expecting '\' found >> character <<.

The compiler was expecting an end quotation mark but 

found another character instead. Locate the error by the 

line number shown in an error popup window, edit the file, 

and try again.

SOP Error

ERROR!! Expecting '=' found >> flag name <<.

The compiler is looking for the assignment operator and 

found another flag. This is usually caused by improper use 

of the statement terminator, the semi-colon, or the 

comment indicator--also a semi-colon.

SOP Error

ERROR!! opcode>> token name << not 

supported.

The compiler has parsed the source code and found a 

“token” it interprets as an opcode, but is not an acceptable 

operator (“=”, “+”, “*”, “/”, or “;”). Check the file and try 

again.

SOP Error

ERROR! Timer enable flag name cannot be set 

false.

The timer flag shown was set to false. This will never do 

anything and is therefore displayed as an error.

SOP Error

ERROR! Counter reset flag name cannot be set 

true or false.

Setting the counter reset flag that is named prevents 

proper operation of the counter. The name of the reset flag 

is displayed to help find the error.

SOP Error

ERROR! Counter enable flag name cannot be set 

true or false.

Counters count transitions from low to high. Setting the 

counter to true or false renders the counter useless and is 

thus displayed as an error. The offending flag name is 

displayed.

SOP Error

ERROR!! input>> flag name << is not an input 

type.

The flag named is not defined as an input only flag and 

cannot be used as an input (on the right side of the equals 

sign).

SOP Error

ERROR!! Expecting ';' found >> flag name <<.

This error is usually displayed when the preceding logic 

statement is not properly terminated by a semi-colon.

SOP Error

ERROR!! input>> flag name << not in directory.

The input flag named is not found in the directory file. 

Check the spelling and try again.

SOP Error

ERROR!! Expecting '=' found >>flag name 

<<.

The compiler is expecting the assignment operator as it is 

parsing what it thinks is a new logic statement. Check the 

syntax in the preceding statement, edit the file, and try 

again.

SOP Error

ERROR!! attempt to redefine output >> flag name 

<<.

An output flag has a logic statement assigned to it (it is 

used on the left side of the assignment operator) more than 

once. Find and change the offending line and recompile.

SOP Error

ERROR!! output >> flag name <

type.

The flag named is not defined as an output only flag, and 

cannot be used as an output (on the left side of the equals 

sign).

SOP Error

ERROR!! output name>> flag name << not in 

directory.

The output flag on the left of the equals sign is not found. 

Check the spelling of the flag name shown and try again.

Error Message Description

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 81

SOP Error

ERROR!! Too Many Timers and Counters (Max 

128 combined).

There is a fixed number of timers and counters that can be 

used in any System Program. The limit is 128 for the total 

of both timers and counters. Try to reduce the number of 

either timers or counters and compile again.

SOP Error

ERROR!! Drty name <> used in alias 

not found in drty file

The flag named as an alias is not found in the directory file. 

This is an advanced feature of the new compiler being 

released with the version 2.5 drive software, but will work 

with version 2.4 software. Define statements that can be 

used for more user-friendly names of functions, and 

substituted for fixed names.

SOP Error

ERROR!! <> is longer than 43 

characters.

System Program flag names are limited to 43 characters, 

and are truncated to that number. A flag longer than this is 

probably caused by a typo. Find and fix the error and 

recompile.

SOP Error

ERROR! A timer or counter (flag name) must be 

defined as an output before being used as an 

input!

Timers and Counters are unique system flags. They 

require storage space for intermediate values for time or 

count, and additional space for storing their preset, enable 

logic state, reset, and output status flag. Therefore, the 

Timer or Counter must logically be assigned (on the left of 

the equals sign) before the status flag (the timer or counter 

name without the value) can be used as an input flag (to 

the left of the equals sign).

SOP Error

ERROR!! input scan table is full

The storage space for the number of inputs is limited to the 

assignment of unique inputs. The limit for NXG is 800 

entries. A flag is assigned only once even if used multiple 

times (as an input).

SOP Error

ERROR!! Counter reset () used 

without a defined counter.

A counter must be defined as an output first!

A reset flag is a unique flag used for resetting counters, but 

due to the storage situation as described above, a reset 

flag cannot appear in a System Program before the 

counter is defined as an output (to the left of the equals 

sign). If the logic for the reset must appear before the 

definition, the use of a temporary flag to define the logic 

state can appear before the Counter, with the reset flag 

assigned to the temporary flag.

Rewrite the logic and recompile.

SOP Error

ERROR!! output scan table is full

The output scan table can contain a maximum of 800 

unique entries. Timers and counters are created in the 

output scan table even if they are used as an input. These 

are the entries that map an I/O table location to the real 

world source (memory location, hardware output, etc.) And 

only one is required for each flag used. Bit flags take up 8 

spaces even if only one is used.

SOP Error

ERROR!! input scan table is full

The input scan table can contain a maximum of 800 unique 

entries. These are the entries that map an input flag from 

the real world source to the I/O table. Only one entry is 

required for each flag used. Bit flags take up 8 spaces even 

if only one is used.

Error Message Description

NXG SOP Utilities

5.9 Downloading a System Program (Hex File)

82 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

SOP Error

ERROR!! logic table is full.

The logic table can contain a maximum of 5000 total 

entries. The entries are created by logic statements as 

strings of inputs and outputs in sequential order separated 

by their operators. Each input, output, and operator used 

counts as an entry.

SOP Error

ERROR!! The maximum time for a single timer is 

16383.5 secs! (4.55 hours)

The amount of time assigned to a timer exceeded the max 

value allowed. This value applies for NXG software only.

SOP Error

ERROR!! expecting ) got>> name <<

Timers and counters, when they are defined, must have 

the flag name followed by a value enclosed in parentheses. 

The trailing parenthesis is missing

SOP Error

ERROR!! The maximum count for a counter is 

32767!

The number of low to high transitions required to activate 

the output of a counter has been exceeded. Reduce the 

number in the parentheses and recompile.

SOP Error

ERROR!! expecting (got>> name <<

Timers and counters, when they are defined, must have 

the flag name followed by a value enclosed in parentheses. 

The compiler expected a left parenthesis as the next 

character.

SOP Error

ERROR!! System Program size (nnnn bytes) is 

greater than allowed (8192 bytes)

The total storage size of the System Program, listed in 

bytes, exceeds the max allowed space. This is the actual 

bytes used and not the size of the Intel Hex file, which is an 

ASCII representation of the data within a header, load 

information, and checksum error checking.

SOP Error

WARNING...Unable to load complete directory!

Too many flags in directory (nnnn)

The size of the directory file has exceeded the allocated 

memory for storing that file. Check the version of the 

compiler to ensure you are using the latest. Also check the 

directory file.

SOP Error

WARNING!! flag name has been redefined as an 

output on statement: nnnn line:nnnn.

An output flag has a logic statement assigned to it (it is 

used on the left side of the assignment operator) more than 

once. Find and change the offending line and recompile. 

The second usage of the flag is located by the statement or 

line number.

No output file created. There is a warning 

message in the file. It need to be commented out 

or removed before recompiling. 

Edit and try again.

The error occurred in logic statement: nnn, line: 

nnnn

If a corrupted hex file is reverse compiled, or if the wrong 

directory file was used in that process, there are usually 

“UNDEFINED” flags in the source file. If this is the case, 

the program will have to be rewritten. It is ALWAYS 

advisable to use source files instead of reverse compiled 

files so that changes can be documented, and the logic is 

described via the comments in the original file. The location 

of the compiler error is shown as both the statement and 

line number.

This file was created by the reverse compiler from 

a corrupt HEX file or utilizing the wrong DRCTRY 

file. No output file created. Edit source file 

name and try again

The error occurred in logic statement: nnnn, 

line: nnnn

This is a special error that only occurs after a reverse 

compiled file is recompiled. The reverse compilation 

process inserted a warning message. This message needs 

to be reviewed before proceeding. Based on the message, 

it may be simply a matter of deleting the warning, or it 

could require rewriting portions of the System Program.

Error Message Description

NXG SOP Utilities

5.10 Uploading a System Program (Hex File)

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 83

5.10 Uploading a System Program (Hex File)

In a manner similar to downloading a System Program, the System Program can be uploaded 

from the drive to a receiving computer (binary format in the drive, hex format from the drive or 

compiler). This can permit archival of a functioning System Program. Also, the text state￾ments in a System Program can be re-created so that the program can be examined or modi￾fied as needed.

Using a similar method as described in the download section, invoke the serial communications 

upload function on the drive. If using the DOS-based upload utility, invoke the data capture 

process of the communications software prior to starting the data upload function in the drive. 

From the drive keypad, enter the “System Program Upload” function menu (9130). Once this 

function has been invoked, the keypad will indicate that the drive is uploading data. Most serial 

communications packages will display the ASCII hex data while it is being uploaded so that the 

upload process can be monitored. Once complete, the drive will indicate that it has finished 

and will return to the System Program upload menu (9130). At this point, the data capture pro￾cess in the PC is stopped and the resulting file is saved.

5.11 Reverse Compiler

Because the System Program embedded in the drive is in a non-readable form, a program to 

reverse compile the hex records of a System Program back into readable statements was 

created. A reverse compiled program can be examined for logic functions and even edited, 

recompiled, and re-downloaded into the drive to alter the System Program functionality as 

needed. Since the embedded hex file does not contain any symbolic information, a directory file 

within range is needed during the reverse compile process to convert from the binary address 

information back into symbolic readable form. 

The Siemens SOP Utilities program contains an integrated Reverse Compiler program. This 

component is similar to the compile component. A HEX file and DRCTRY file must be speci￾fied. If they do not exist in the default directory, locate the necessary files. When the appropri￾ate files are specified, press the reverse compilation. See Figure 5-7. Reverse Compiler errors 

are listed in Table 5-7.

NOTICE

As with the download, the upload process can be terminated from the drive side by entering 

a [SHIFT]+[CANCEL] key sequence.

NXG SOP Utilities

5.11 Reverse Compiler

84 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Figure 5-7: Reverse Compiler Options Window

NXG SOP Utilities

5.11 Reverse Compiler

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 85

Select hex file (contains valid source code):

Information on file (Information button):

Directory version button:

NXG SOP Utilities

5.11 Reverse Compiler

86 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Results of Rev Compile button when source code is embedded:

Loaded hex file with no source code (in this case with same Directory versions for compile 

and reverse compile):

NXG SOP Utilities

5.11 Reverse Compiler

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 87

Pushing Rev Compile to generate the reverse compiled (*.dis) file rather than simply extract￾ing the source.

Loaded hex file with no source code (in this case with differences in Directory versions also).

NXG SOP Utilities

5.11 Reverse Compiler

88 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Loaded hex file – information button (Hex File)

Version button (DRCTRY File)

Push Rev Compile button (hex file has no embedded source and contains errors):

Go back to Compiler option and load created reverse compiled program to look for errors.

NXG SOP Utilities

5.12 Header

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 89

Load file in editor – look at header and errors.

5.12 Header

#NEXTGEN;

!!!!!!!!!!!!!!!!!!!!!!!!!!!! Warning !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The version of DRCTRY.NGN used is DIFFERENT from the original DRCTRY

Probable errors will occur, check the output files

(You must comment these lines out before recompiling)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

; Siemens LD A

; ID Series System Program Reverse Compiler Windows Ver. 6.6.2 12/12/05

;

; REVCMP Directory File Name : C:\PROJECTS\NXG4.0\FLASH\DRCTRY.NGN

; REVCMP used DRCTRY.NGN ver : 4.28

; Hex File Name : Sop.hex

; System Program Name : NOWAGO.SOP

; System Program Date/Time : May 25 15:26:52 2000

; System Type : NEXTGEN

; Hex file used DRCTRY version : 1.00

NXG SOP Utilities

5.12 Header

90 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Errors in statements:

TempFlag01_O = TempFlag01_O * /UNDEFINED * /UNDEFINED * TempFlag02_O 

+

 UNDEFINED * TempFlag02_O + UNDEFINED * TempFlag02_O;

TempFlag02_O = TempFlag03_O * UNDEFINED;

Table 5-7: Reverse Compiler Error Messages

Error Message Description

Hex File Error

Too many input table entries (> 800)

Then number of distinct inputs in the scan table exceeds 

the maximum allowable 800 entries. The hex file is 

possibly corrupted or is of the wrong drive type.

Hex File Error

Too many output table entries (> 800)

Then number of distinct outputs in the scan table exceeds 

the maximum allowable 800 entries. The hex file is 

possibly corrupted or is of the wrong drive type.

Hex File Error

Too many logic table entries (> 5000)

The number of entries in the logic table exceeds the 

maximum allowable 5000 entries. The hex file is possibly 

corrupted or is of the wrong drive type.

Hex File Error

Too many counter/timer entries (> 128)

The hex file contains too many timers and counters (total 

sum of both) which cannot exceed 128 for NXG. The hex 

file is possibly corrupted or is of the wrong drive type.

DRCTRY Error

ERROR in line nnnn - << flag name>> is longer than 43 

characters.

The error occurred in directory file name.

The flag name shown is longer than the max allowable 43 

characters. Check the flag indicated and check for a 

corrupted hex file.

!!!!!!!!!!!!!!!!!!!!Warning!!!!!!!!!!!!!!!!!!!!!!!

This file is corrupted (bad System Program checksum). 

Carefully check all logic equations for invalid or 

undefined flags, erroneous timer or counter values, 

wrong use of flags, erroneous logic, etc. Edit these 

lines (and comment these warning lines), compile and 

use at your own risk.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

This error message is added to the top of a reverse 

compiled program when the stored System Program 

checksum does not compare with the calculated one. The 

file must be check for integrity, any errors corrected, and 

this comment removed before re-compiling. Since the 

checksum is invalid, the file may or may not work 

properly.

DRCTRY Version Error

The version of directory file name used is DIFFERENT 

from the original DRCTRY. Probable errors will occur, 

check the output files. (You must comment the warning 

lines out in the ‘

.DIS’

 file before recompiling).

This message will display if the version with which the 

System Program is reverse compiled is different from the 

version used to create the original hex file. A warning will 

be added to the file along with the statistics of the 

compiler version and directory version, along with other 

information on the file.

NXG SOP Utilities

5.12 Header

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 91

The output file will contain a source statement for each original statement in the System Pro￾gram. The statements will be ordered with the invariant statements first, followed by the depen￾dent statements. All of the statements in a section will be in the same order as the original file, 

with the exception of any true/false type statements which are moved to the front of the file.

!!!!!!!!!!!!!!!!!!!!!!!Warning !!!!!!!!!!!!!!!!!!!!!!!!!

The version of directory file name used is DIFFERENT 

from the original DRCTRY 

Probable errors will occur, check the output files (You 

must comment these lines out before recompiling)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

; Siemens LD A Group

; ID Series System Program Reverse Compiler version 

Number

; REVCMP Directory File Name : directory file name

; REVCMP used directory file name ver: n.nn

; Hex File Name : hex file name

; System Program Name : System Program name

; System Program Date/Time: time/date

; System Type : drive type

; Hex file used DRCTRY version : n.nn

This header is added to the top of the reverse compiler 

output file when the directory version error displays. The 

comments must be removed before the file can be 

recompiled successfully.

The file was reverse compiled successfully.

Original DRCTRY file version: n.nn.

Current DRCTRY file version: n.nn.

Number of counters and timers: nnn.

Number of in items: nnn.

Number of out items: nnn.

Number of logic items: nnnn.

Checksum: 0xNNNN.

Header continuation.

Hex File Error

The hex file is corrupted. nn UNDEFINED label(s) 

found.

Output file created anyway.

Check file for error(s).

The hex file used as the input to the reverse compiler was 

corrupted in some manner, creating UNDEFINED labels - 

labels that could not be found in the directory file. It may 

simply be that the directory file used to reverse compile 

did not contain the flags found. This error occurs anytime 

there is one or more “UNDEFINED” labels found.

Source Corrupt

This file is a dual source/hex file, but the source is 

corrupt.

Do you want to try to reverse compile using the older 

method?

This message occurs only with embedded source file 

information in the hex file. If the source file exists, the 

reverse compiler simply extracts the source text directly. 

If the end of file is not found within the source text, it is 

assumed corrupted and prompts the user to do an actual 

reverse compiler of the compiled code. All comments are 

lost.

No Errors

The SOP source has been successfully extracted from 

the hex file.

This message displays if the source text exists within the 

hex file and is successfully extracted.

Error Message Description

NXG SOP Utilities

5.13 Combined Source / Hex File

92 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5.13 Combined Source / Hex File

Beginning with NXG Software Version 2.4, the system is capable of accepting a combined 

source/hex file format. The older style compiled sop files. However, when reverse compiling, 

this new file format undergoes a pseudo reverse compiling process rather than the traditional 

reverse compiling process. In this pseudo reverse compiling process, all the original source 

comments and formatting is presented to the user as the reverse compiled output. This com￾bined file type must be created or reverse compiled with SOP Utilities version 5.0 or later. In all 

other respects, this type of compiled sop is the same as the older file version.

For example:

Original SOP File

#NEXTGEN; ;

----------------------------------------------------------------------------

; Siemens LD R NEXT GEN HARMONY AC MOTOR DRIVE

; SYSTEM OPERATING PROGRAM (TEST VERSION)

; Program Number: NoWago.sop Customer: Siemens

Siemens Sales Order: xxxx

Siemens Part Numbers: xxxx

; Description: none

; Engineer: JAB

;

; Original Version Date: 10/31/00

---------------------------------------------------------------------------

; ;SYMBOL DEFINITION

;---------------------------------------------------------------------------

; = equals * logical AND+ logical OR / logical NOT

; ; comment line

;---------------------------------------------------------------------------

; ;INITIALIZED FLAGS

;------------------------------------------------------------------------------

; Keypad Speed reference

RawDemandKeypad_O= TRUE;

; Speed profile

NOTICE

Comments from the original source file are not included in a compiled hex file and therefore 

cannot be reverse compiled. (See Section 5.13 on combined source and Hex files.)

A copy of the symbol directory file (e.g., DRCTRY.NGN) must exist within the working directory 

of the compiler and reverse compiler, or in the directory of the invoked executable program.

NXG SOP Utilities

5.13 Combined Source / Hex File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 93

SpeedProfile_O= FALSE;

RunRequest_O = TempFlag01_O * TempFlag02_O;

Ram pStop_O = TempFlag02_O;

;

; Fault Reset

;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

;======================================================================= 

;================================ END OF FILE=========================== 

;=======================================================================

Old Style .hex File Data

:020000020000FC

:1 000000046005F00800065008A0001 04AC009B464A :10001 0004E4F5741 

474F2E534F50000000000000F5 :100020000000000000000000204465632031 3920FA :1 

000300030393A34333A31 30203230303200000037 

:10004000A20006009E0024020300012502040001 14 :1000500041 

0007000F450008000F000000000000ED :100060000008010009030004040006020001040066 

:100070000605000107000208000606000100000056 :100080001 3000000012E000100014000020001 

5495 :10009000000500014900060001 000000000000000A 

:0C00A0009E0000000000000000009E001 8

:0000000 1FF

Old Style Reverse Compiled Output

#NEXTGEN;

; Siemens LD R Group

; ID Series System Program Reverse Compiler Windows Ver. 5.0.0 12/3/02

;

REVCMP Directory File Name : C:\PROGRAM FILES\Siemens\FLASH FILES\DRCTRY.NGN 

REVCMP used DRCTRY.NGN ver: 0401

; Hex File Name : nowago.hex

System Program Name : NOWAGO.SOP

System Program Date/Time : Dec 19 09:43:10 2002

; System Type : NEXTGEN

; Hex file used DRCTRY version : 0401

RawDemandKeypad_O = TRUE;

SpeedProfile_O= FALSE;

RunRequest_O= TempFlag01_O * TempFlag02_O;

RampStop_O= TempFlag02_O;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

NXG SOP Utilities

5.13 Combined Source / Hex File

94 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

New Style .hex File

:020000020000FC

:1 000000046005F00800065008A0001 04AC009B464A :10001 0004E4F5741 

474F2E534F50000000000000F5 :100020000000000000000000204465632031 3920FA :1 

000300030393A34333A31 30203230303200000037 

:10004000A20006009E0024020300012502040001 14 :1000500041 

0007000F450008000F000000000000ED :100060000008010009030004040006020001040066 

:100070000605000107000208000606000100000056 :100080001 3000000012E000100014000020001 

5495 :10009000000500014900060001 000000000000000A 

:0C00A0009E0000000000000000009E001 8

:00000001 FF

<1 ><2 1 6>Start-of-source

<2><1 29>#NEXTGEN;

<3><1 61>;------------------------------------------------------------

<4><23>;SIEMENS NEXT GEN HARMONY AC MOTOR DRIVE

<5><1 30>;SYSTEM OPERATING PROGRAM (TEST VERSION) <6><74>

<7><235>;Program Number: NoWago.sop

<8><157>;Customer: Siemens

<9><255>; Siemens Sales Order: xxxx

<10><94>; Siemens Part Numbers: xxxx

<11><115>;Description: none

<12><121>;Engineer: JAB

<13><69>;

<14><59>; Original Version Date: 10/31/00

<15><206>;--------------------------------------------------------------

<16><36>;SYMBOL DEFINITION

<17><206>;---------------------------------------------------------------

<18><69>;

<19><71>;= equals* logical AND+ logical OR / logical NOT

<20><251>; ; comment line

<21 ><69>; 

<22><14>;----------------------------------------------------------------

<23><8>;INITIALIZED FLAGS

<24><206>;---------------------------------------------------------------

<25><101>;

<26><163>; Keypad Speed reference

<27><65>RawDemandKeypad_O= TRUE;

<28><1 0>

NXG SOP Utilities

5.13 Combined Source / Hex File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 95

<29><103>; Speed profile

<30><157>SpeedProfile_O= FALSE;

<31><10>

<32><87>RunRequest_O = TempFlag01_O * TempFlag02_O;

<33><1 98>RampStop_O = TempFlag02_O;

<34><69>;

<35><132>; Fault Reset

<36><69>;

<37><30>DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

<38><1 0>

<39><219>;=================================================================

=========

<40><206>;================================ END OF FILE 

==============================

<41 ><21 

9>;========================================================================

==

<42><1 0>

<43><240>End-of-file

New Style Reverse Compiled Output

#NEXTGEN; 

;----------------------------------------------------------------------------------

; SIEMENS NEXT GEN HARMONY AC MOTOR DRIVE

; SYSTEM OPERATING PROGRAM (TEST VERSION)

; Program Number: NoWago.sop

; Customer: Siemens

Siemens Sales Order: xxxx

Siemens Part Numbers: xxxx

; Description: none

; Engineer: JAB

;

; Original Version Date: 10/31/00

;----------------------------------------------------------------------------------------- 

;SYMBOL DEFINITION

;----------------------------------------------------------------------------------------

= equals * logical AND+ logical OR / logical NOT

; ; comment line

;

NXG SOP Utilities

5.13 Combined Source / Hex File

96 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

;------------------------------------------------------------------------------- 

;INITIALIZED FLAGS

;------------------------------------------------------------------------------------------

;

; Keypad Speed reference RawDemandKeypad_O= TRUE;

; Speed profile

SpeedProfile_O= FALSE;

RunRequest_O = TempFlag01_O * TempFlag02_O;

RampStop_O = TempFlag02_O;

;

; Fault Reset

;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

;==========================================================================

==== ;================================ END OF FILE 

================================= 

;==========================================================================

====

Original SOP File

#NEXTGEN; 

;-------------------------------------------------------------------------------------

; Siemens LD R NEXT GEN HARMONY AC MOTOR DRIVE

; SYSTEM OPERATING PROGRAM (TEST VERSION)

; Program Number: NoWago.sop Customer: Siemens

Siemens Sales Order: xxxx

Siemens Part Numbers: xxxx

; Description: none

; Engineer: JAB

;

; Original Version Date: 10/31/00

;-------------------------------------------------------------------------------- 

;SYMBOL DEFINITION

;-------------------------------------------------------------------------------- 

;

; = equals * logical AND+ logical OR / logical NOT

NXG SOP Utilities

5.13 Combined Source / Hex File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 97

; ; comment line

;

;---------------------------------------------------------------------------------------- 

INITIALIZED FLAGS

;---------------------------------------------------------------------------------------- 

;

; Keypad Speed reference

RawDemandKeypad_O= TRUE;

; Speed profile

SpeedProfile_O= FALSE;

RunRequest_O = TempFlag01_O * TempFlag02_O;

RampStop_O = TempFlag02_O;

;

; Fault Reset

;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

;==========================================================================

;================================ END OF FILE============================= 

;=========================================================================

Old Style .hex File Data

:020000020000FC

:1 000000046005F00800065008A0001 04AC009B464A :10001 0004E4F5741 

474F2E534F50000000000000F5 :100020000000000000000000204465632031 3920FA :1 

000300030393A34333A31 30203230303200000037 

:10004000A20006009E0024020300012502040001 14 :1000500041 

0007000F450008000F000000000000ED :100060000008010009030004040006020001040066 

:100070000605000107000208000606000100000056 :100080001 3000000012E000100014000020001 

5495 :10009000000500014900060001 000000000000000A 

:0C00A0009E0000000000000000009E001 8

:0000000 1FF

Old Style Reverse Compiled Output

#NEXTGEN;

; Siemens LD A Group

; ID Series System Program Reverse Compiler Windows Ver. 5.0.0 12/3/02

;

REVCMP Directory File Name : C:\PROGRAM FILES\Siemens\FLASH FILES\DRCTRY.NGN 

REVCMP used DRCTRY.NGN ver: 0401

; Hex File Name : nowago.hex

NXG SOP Utilities

5.13 Combined Source / Hex File

98 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

System Program Name : NOWAGO.SOP

System Program Date/Time : Dec 19 09:43:10 2002

; System Type : NEXTGEN

; Hex file used DRCTRY version : 0401

RawDemandKeypad_O = TRUE;

SpeedProfile_O= FALSE;

RunRequest_O= TempFlag01_O * TempFlag02_O;

RampStop_O= TempFlag02_O;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

New Style .hex file

:020000020000FC

:1 000000046005F00800065008A0001 04AC009B464A :10001 0004E4F5741 

474F2E534F50000000000000F5 :100020000000000000000000204465632031 3920FA :1 

000300030393A34333A31 30203230303200000037 

:10004000A20006009E0024020300012502040001 14 :1000500041 

0007000F450008000F000000000000ED :100060000008010009030004040006020001040066 

:100070000605000107000208000606000100000056 :100080001 3000000012E000100014000020001 

5495 :10009000000500014900060001 000000000000000A 

:0C00A0009E0000000000000000009E001 8

:00000001 FF

<1 ><2 1 6>Start-of-source

<2><1 29>#NEXTGEN;

<3><1 61>;---------------------------------------------------------------------

<4><23>;SIEMENS NEXT GEN HARMONY AC MOTOR DRIVE

<5><1 30>;SYSTEM OPERATING PROGRAM (TEST VERSION) 

<6><74>

<7><235>;Program Number: NoWago.sop

<8><157>;Customer: Siemens

<9><255>; Siemens Sales Order: xxxx

<10><94>; Siemens Part Numbers: xxxx

<11><115>;Description: none

<12><121>;Engineer: JAB

<13><69>;

<14><59>; Original Version Date: 10/31/00

<15><206>;----------------------------------------------------------------

<16><36>;SYMBOL DEFINITION

<17><206>;----------------------------------------------------------------

<18><69>;

NXG SOP Utilities

5.13 Combined Source / Hex File

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 99

<19><71>;= equals* logical AND+ logical OR / logical NOT

<20><251>; ; comment line

<21 ><69>; 

<22><14>;------------------------------------------------------------------

<23><8>;INITIALIZED FLAGS

<24><206>;----------------------------------------------------------------

<25><101>;

<26><163>; Keypad Speed reference

<27><65>RawDemandKeypad_O= TRUE;

<28><1 0>

<29><103>; Speed profile

<30><157>SpeedProfile_O= FALSE;

<31><10>

<32><87>RunRequest_O = TempFlag01_O * TempFlag02_O;

<33><1 98>RampStop_O = TempFlag02_O;

<34><69>;

<35><132>; Fault Reset

<36><69>;

<37><30>DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

<38><1 0>

<39><219>;=================================================================

=======

<40><206>;================================ END OF FILE 

===========================

<41 

><219>;====================================================================

==== <42><1 0>

<43><240>End-of-file

New Style reverse Compiled Output

#NEXTGEN; 

;---------------------------------------------------------------------------------

; SIEMENS NEXT GEN HARMONY AC MOTOR DRIVE

; SYSTEM OPERATING PROGRAM (TEST VERSION)

; Program Number: NoWago.sop

; Customer: Siemens

Siemens Sales Order: xxxx

Siemens Part Numbers: xxxx

; Description: none

; Engineer: JAB

NXG SOP Utilities

5.13 Combined Source / Hex File

100 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

;

; Original Version Date: 10/31/00

;--------------------------------------------------------------------------------- 

;SYMBOL DEFINITION

;-------------------------------------------------------------------------

= equals * logical AND+ logical OR / logical NOT

; ; comment line

;

;---------------------------------------------------------------------------------- 

;INITIALIZED FLAGS

;----------------------------------------------------------------------------------

;

; Keypad Speed reference RawDemandKeypad_O= TRUE;

; Speed profile

SpeedProfile_O= FALSE;

RunRequest_O = TempFlag01_O * TempFlag02_O;

RampStop_O = TempFlag02_O;

;

; Fault Reset

;

DriveFaultReset_O = KeypadFaultReset_I + ToolFaultReset_I;

;========================================================================= 

;================================ END OF FILE ============================ 

;=========================================================================

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 101

6

NXG Configuration Update Utility Overview

The Configuration Update Utility allows updating and configuration of software for the NXG 

CompactFlash card and the NXG ToolSuite. 

The Configuration Update Utility is a Microsoft® Windows based application for creating or 

updating CompactFlash and ToolSuite software for the NXG Control. When purchased, a 

CompactFlash memory card needs to be configured and made “bootable” for the real-time 

operating system that the NXG Control uses. 

6.1 System Requirements

The NXG Configuration Update Utility is a Microsoft® Windows application requiring the .NET 

2.x Framework. It requires Windows 2000/XP/Vista, at least 128 MB of RAM, and a minimum 

of 15 MB of disk space.

NOTICE

This utility is intended for use by trained Siemens personnel only.

NXG Configuration Update Utility Overview 

6.2 Start and Configure the Configuration Update Utility

102 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

6.2 Start and Configure the Configuration Update Utility

Select  Utilities tab of the ToolSuite application and click  Configuration Update button 

(as shown in figure below):

The Configuration Update Utility screen should appear as shown below:

Configuration 

Update Button

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 103

6.3 Features Overview

The Configuration Update Utility screen features currently available are:

• Copy setup files to another directory

• Update flash disk files

• Make bootable default disk

• Copy files from flash disk to PC

• Make bootable copied disk

• Update ToolSuite Host files on PC

6.3.1 Copy Setup Files to Another Directory

This feature copies and overwrites the files from the source folder to the destination folder. 

The source folder can be a source, remote or local, to the PC being used. The typical output 

folder location is your local hard drive. This feature is mainly used by laptop users who want 

to load the latest software and files onto their laptops. 

Perform the steps as indicated below to copy setup files to another directory:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure). To change drive type, click Select Drive Type..., in the pull-down menu. Options 

available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

NOTICE

This feature will overwrite the existing destination files (i.e., on your local hard drive). Never

use this feature with the CompactFlash disk as the destination drive or folder.

NXG Configuration Update Utility Overview 

6.3 Features Overview

104 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

.

2. The Select Drive Type screen will appear (see figure below). Choose the desired drive 

type and then click  OK. The newly selected drive system will appear in the Drive Type 

text box located on the Configuration Update Utility screen (see figure above).

Drive Type Selected

Options Menu

Select Drive Type

Drive Type Selected

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 105

3. After selecting drive type, go to  Configuration Update Utility screenOperation Type, 

click  Copy setup files to another directory (see figure below).

4. Next click  Select Source Folder button (see figure above). The Select Source Folder 

screen will appear (see figure below).

5. Click  Browse button to locate the file name desired or manually type name of file into 

text box.

6. After choosing the Source Folder, click  Ok.

7. Return to the Configuration Update Utility Screen and press  Select Destination Folder 

button.

NOTICE

Never use this feature with the CompactFlash disk as the destination drive or folder.

Operation Type

Select Source Folder Button

Copy Setup Files to Another 

directory Radio Button

File Name Selecte

Ok Button

Browse Button

NXG Configuration Update Utility Overview 

6.3 Features Overview

106 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

8. The Select Destination Folder screen will appear (see figure below).

9. Typically, ‘Select Output Directory' should default to C:\Program Files\Robicon\Flash Copy. 

Click Flash Copy Folder button to manually select this location.

10.After selecting desired Output Directory, click  OK.

11.Next click Start button on the Configuration Update Utility screen.

12.A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click ‘Yes’ button.

13.Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

Select Destination 

Folder Button

File Name Selected

Flash Copy Folder Button

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 107

6.3.2 Update Flash Disk Files

This feature allows the user to update files from a source folder location (which contains 

newer versions of NXG software) to the CompactFlash. The source folder can be a remote or 

local source to the PC being used. The output folder location is the CompactFlash card used 

in the NXG Control. This feature updates the NXG software and configuration files, while 

maintaining the existing drive settings and system programs. 

Perform the steps as indicated below to update flash disk files:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure below). To change drive type, click Select Drive Type..., in the pull-down menu. 

Options available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

NOTICE

This feature can only be used on an existing CompactFlash or directory that already 

contains files that may be older than the current release. Be certain to back these files up 

before proceeding with this operation. 

Select Drive Type

Drive Type Selected

Options Menu

NXG Configuration Update Utility Overview 

6.3 Features Overview

108 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

2. The Select Drive Type screen will appear (see figure below). Choose the desired drive 

type, then click OK. The newly selected drive system will appear in the Drive Type text 

box on the Configuration Update Utility screen (see figure above).

3. After selecting drive type, go to the Configuration Update Utility screenOperation Type, 

click Update flash disk files (see figure below).

4. Next click  Select Source Folder button (see figure above). The Select Source Folder 

screen will appear (see figure below)

5. Click Browse button to locate a newer or older version of the file name than the one 

currently on the CompactFlash.

Drive Type Selected

Operation Type

Select Source Folder 

Button

Update Flash Disk 

Files Radio Button 

File Name Selected

Local Hard Drive 

Copy Button

Browse Button

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 109

6. Click Local Hard Drive Copy button, to identify the location of the drive type selection.

7. After choosing the Source Folder, click  OK.

8. Return to the Configuration Update Utility screen and press  Select Destination Drive 

(see figure below).

9. Typically, ‘Select Output Drive' will be the CompactFlash card.

10.The Select Destination Drive screen will appear (see figure below).

11.After selecting desired Output Drive, click  OK.

12.Next click Start button on the Configuration Update Utility screen.

13.A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click ‘Yes’ button.

NOTICE

For NXG Drives, the file name is C:\Program Files\Robicon\Flash Files.

Select Destination Drive Button

Select Output Drive

NXG Configuration Update Utility Overview 

6.3 Features Overview

110 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

14.Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

15.User can now insert the CompactFlash card into the CPU board.

6.3.3 Bootable Default Disk Procedure

This feature allows the user to make a “Bootable” CompactFlash disk that contains all of the 

software and configuration files necessary to run the drive (except for the system program). 

The source folder can be a source that is remote or local to the PC being used. The typical 

output drive is the CompactFlash card used in the NXG Control. This feature is necessary 

when a new CompactFlash disk is used for the first time. 

Perform the steps as indicated below to create a bootable default disk:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure below). To change drive type, click Select Drive Type..., in the pull-down menu. 

Options available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

NOTICE

This feature will completely reformat the entire CompactFlash and write all of the necessary 

files for NXG Control. If the CompactFlash contains files that are to be kept, then care 

should be taken to back these files up before proceeding with this operation.

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 111

2. The Select Drive Type dialog window will appear (see figure below). Choose the desired 

drive type and press  OK. The newly selected drive system will appear in the Drive Type 

text box on the Configuration Update Utility screen (see figure above).

Select Drive Type

Drive Type Selected

Options Menu

Drive Type Selected

NXG Configuration Update Utility Overview 

6.3 Features Overview

112 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

3. After selecting drive type, go to  Configuration Update Utility screenOperation Type, 

click Make bootable default disk (see figure below).

4. Next click  Select Source Folder button (see figure above). The Select Source Folder 

screen will appear (see figure below)

5. Click Browse button to locate a newer or older version of the file name than the one 

currently on the CompactFlash. Click Local Hard Drive Copy button, to identify the 

location of the drive type selection.

6. After choosing the Source Folder, click  OK.

NOTICE

For NXG / NXGII Drives, the file name is C:\Program Files\Robicon\Flash Files.

Operation Type

Select Source Folder 

Button

Make Bootable Default Disk

Radio Button 

File Name Selected

Browse Button

Local Hard Drive 

Copy Button

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 113

7. Return to the Configuration Update Utility screen and press  Select Destination Drive.

If there are no eligible drives found the following message will be displayed:

If one or more eligible drives are found the following selection box will be displayed:

8. Select the drive letter of the CompactFlash card, then click  OK.

Select Destination Drive Button

NXG Configuration Update Utility Overview 

6.3 Features Overview

114 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

9. Next click  Start button on the Configuration Update Utility screen.

If an error occurs with the CompactFlash card the following screen will be displayed:

If no errors occur, a warning is issued indicating the CompactFlash card will be overwritten. 

Click  Yes.

10.Return to the Configuration Update Utility screen and press OK. A screen will be 

displayed indicating system is processing.

11.Upon successful completion of process the following screen will appear asking if user 

wishes to eject the Flash Disk. Click Yes.

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 115

12.Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

13.User can now insert the CompactFlash card into the CPU board.

6.3.4 Copy Flash Disk to PC

This feature is for extracting a version of software from pre-programmed CompactFlash disks 

to use as a source for updating or making other CompactFlash disks. It copies all of the files 

from the CompactFlash disk and places them into the Destination Folder, typically on a PC. 

Perform the steps as indicated below to copy files from a flash disk to a PC:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure below). To change drive type, click Select Drive Type..., in the pull-down menu. 

Options available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

NXG Configuration Update Utility Overview 

6.3 Features Overview

116 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

2. The Select Drive Type dialog window will appear (see figure below). Choose the desired 

drive type, then click  OK. The newly selected drive system will appear in the Drive Type 

text box on the Configuration Update Utility screen (see figure above).

Select Drive Type

Drive Type Selected

Options Menu

Drive Type Selected

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 117

3. After selecting drive type, go to  Configuration Update Utility screenOperation Type, 

click Copy files from flash disk to PC (see figure below).

4. Next click  Select Source Drive button (see figure above). The Select Source Drive 

screen will appear (see figure below).

5. Select the drive letter of the CompactFlash card.

6. After choosing the Source Folder, press  Ok.

Operation Type

Select Source Drive Button

Copy files from flash disk to PC 

Radio Button

Select Source Drive of the 

CompactFlash Card

NXG Configuration Update Utility Overview 

6.3 Features Overview

118 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

7. Return to the Configuration Update Utility screen and press  Select Destination Folder.

8. The Select Destination Folder screen should appear (see figure below).

9. Select the location where Flash files are to be copied. Click Flash Copy Folder button 

to manually transfer files to C:\Program Files\Robicon\Flash Copy.

10.After choosing the Destination Folder, click Ok.

11.Next click Start button on the Configuration Update Utility screen.

12.A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click Yes.

Select Destination Folder Button

Flash Copy Folder Button

File Name Selected

IMPORTANT!

Ensure that the Destination Folder does not contain any files or sub-directories. 

Any content in the selected Destination Folder is overwritten upon clicking “Yes” 

as described in Step12 below.

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 119

13.Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

6.3.5 Make Bootable Copied Disk Procedure

This feature allows the user to duplicate Flash Disks. This feature formats and makes a 

“Bootable” CompactFlash disk that contains all of the software and configuration files neces￾sary to run the drive (including the system programs). The source folder can be a source that 

is remote or local to the PC being used. The standard source will be the Flash Copy folder. 

The default output drive is the CompactFlash card used in the NXG Control.

Perform the steps as indicated below to make a bootable copied disk:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure). To change drive type, click Select Drive Type..., in the pull-down menu. Options 

available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

NOTICE

This feature will completely reformat the entire CompactFlash and write all of the necessary 

files for NXG Control. If the CompactFlash contains files that are to be kept, then care 

should be taken to back these files up before proceeding with this operation.

NXG Configuration Update Utility Overview 

6.3 Features Overview

120 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

2. The Select Drive Type screen will appear (see figure below). Choose the desired drive 

type and then click  OK. The newly selected drive system will appear in the Drive Type 

text box on the Configuration Update Utility screen (see figure above).

Select Drive Type

Drive Type Selected

Options Menu

Drive Type Selected

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 121

3. After selecting drive type, go to  Configuration Update Utility screenOperation Type, 

click  Make bootable copied disk (see figure below).

4. Next click  Select Source Folder button (see figure above). The Select Source Folder 

screen will appear (see figure below)

5. Click Browse button to locate a newer or older version of the file name than the one 

currently on the CompactFlash.

6. Click Local Hard Drive Copy button, to identify the location of the drive type selection.

7. After choosing the Source Folder, click  OK.

8. Return to the Configuration Update Utility screen and press  Select Destination Drive.

NOTICE

For NXG Drives, the file name is C:\Program Files\Robicon\Flash Files.

Operation Type

Select Source Folder Button

Make bootable copied disk 

Radio Button

Local Hard Drive Copy Button

File Name Selected

Browse Button

NXG Configuration Update Utility Overview 

6.3 Features Overview

122 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

9. The Select Source Drive screen will appear (see figure below). Select the CompactFlash 

card drive.

10.After selecting the Destination Drive, click Ok.

11.Next click Start button on the Configuration Update Utility screen.

12.A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click ‘Yes’ button.

NOTICE

The files will be copied to the CompactFlash disk. A screen will be displayed indicating 

System is processing (see figure below).

Select Destination Drive Button

Select Destination Drive of the 

CompactFlash Card

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 123

13.Upon successful completion of process a screen will appear (not shown) asking if user 

wishes to eject the Flash Disk. Click Yes.

14.A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click ‘Yes’ button.

15.Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

16.User can now insert the CompactFlash disk into the CPU board.

NXG Configuration Update Utility Overview 

6.3 Features Overview

124 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

6.3.6 Update ToolSuite Host Files on PC

This feature updates the configuration files for all ToolSuite configured drives. The ToolSuite 

installation program updates configuration files automatically. As an option this section is pro￾vided for Siemens personnel, who wish to manually update ToolSuite configuration files.

Perform the steps as indicated below to update ToolSuite Host Files on PC:

1. Verify which drive type is active by checking the Drive Type text box located on the 

Configuration Update Utility screen. If the system indicated is not the drive type desired, 

click  Options menu located at the top of the Configuration Update Utility screen (see 

figure below). To change drive type, click Select Drive Type..., in the pull-down menu. 

Options available are “NXG Harmony”, “HA Harmony”, or “Silcovert H”.

2. The Select Drive Type screen will appear (see figure below). Choose the desired drive 

type and then click  OK. The newly selected drive system will appear in the Drive Type 

text box on the Configuration Update Utility screen (see figure above).

Select Drive Type

Drive Type Selected

Options Menu

Drive Type Selected

NXG Configuration Update Utility Overview

6.3 Features Overview

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 125

3. After selecting drive type, go to  Configuration Update Utility screenOperation Type, 

click  Update ToolSuite host files on PC (see figure below).

4. Next click  Select Source Folder button (see figure above). The Select Source Folder 

screen will appear (see figure below).

5. Click Browse button to locate source folder. Ensure that the source files are match 

selected Drive Type.

NOTICE

For NXG drives, the file name is C:\Program Files\Robicon\Flash Files.

Operation Type

Select Source Folder Button

Update ToolSuite host files on 

PC Radio Button

Local Hard Drive Copy Button

File Name Selected

Browse Button

NXG Configuration Update Utility Overview 

6.3 Features Overview

126 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

6. Next click Start button on the Configuration Update Utility screen.

7. A dialog window will appear confirming that you are about to overwrite existing files (not 

shown). Click ‘Yes’ button.

8. Successful completion of process is confirmed by a pop-up message “Operation 

completed successfully”. Press OK to finish.

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 127

7

Drive Server Setup/Status Utility

The Drive Server Setup/Status utility defines the setup requirements for computer-to-com￾puter communication, where one of the computers is hosting a Drive Server. Refer to the 

Drive Server Manual for information related to configuration of a system hosting a Drive 

Server. 

7.1 Start and Configure the Configuration Update Utility

Select  Utilities tab of the ToolSuite application and click  Drive Server Setup/Status but￾ton (as shown in figure below):

NOTICE

This utility is intended for use by trained Siemens personnel only.

NOTICE

This utility is used both on computers that host a Drive Server and also with computers that 

communicate to another computer hosting a Drive Server.

Configuration Update Button

Drive Server Setup/Status Utility

7.1 Start and Configure the Configuration Update Utility

128 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

If no existing drive server is configured, the first time the Drive Server is started the Drive 

Server Setup/Status screen will appear as shown below:

To begin using the Driver Server Utility, a new server connection must be established. Refer 

to the following Section Create a New Server Connection.

7.1.1 Create a New Server Connection

This feature allows the user to create a new server connection. If an error message displays 

on the Drive Server Setup/Status Utility screen, a new server connection must be created.

Perform the steps as indicated below to create a new server connection:

1. On the Drive Server Setup/Status Utility screen click  Security menu, select  Enter 

Security code (see figure below).

Error Message

Enter Security Code

Security Menu

Drive Server Setup/Status Utility

7.1 Start and Configure the Configuration Update Utility

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 129

2. The Security Code screen will appear (see figure below). Enter drsv in the text box, 

then click Ok.

3. The Valid Code screen will appear confirming correct security code was entered. Click 

Ok, then proceed to next step.

4. Return to the Drive Server Setup/Status Utility screen and click  Setup menu  click 

Server Connection Maintenance, next select  Create New Server Connection (see 

figure).

Enter ‘drsv’ in Text Box

Create New Server 

Connection

Setup Menu

Server Connection 

Maintenance Pull-down 

Menu

Drive Server Setup/Status Utility

7.1 Start and Configure the Configuration Update Utility

130 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5. When Connect screen appears the text box fields will be empty. Enter data as shown in 

figure below.

The data entered into the Connection Name text box is per the user’s choice. It is used to 

identify the connection by name. The data entered into the Actual Server Name text box is 

system dependent. The text shown in the example figure above is the Default Entry. If the 

Actual Server Name has been changed from the Default Entry, that new name must be 

entered in this field.

The data entered in the Machine’s Name or IP Address text box is also system dependent. 

The Machine Name on which the server resides should be used to achieve maximum func￾tionality.

The Machine Name and domain of the Remote PC can be determine by performing the fol￾lowing:

• Open desktop on Remote PC, move cursor to  ‘My Computer’ GUI, click right mouse 

button, click  ‘Properties’ (using left mouse button), click  ‘My Computer’ tab (using 

left mouse button). A dialog window should appear (see figure).

NOTICE

Use the Drive Server Setup/Status Utility to determine the actual name of the configured 

Drive Server.

NOTICE

If the server is running on the same machine as the Drive Server Setup/Status Utility, enter 

’LocalHost’ in the text box.

Default Entry (System Dependant)

Gives Connection IDENTITY

Remote PC name should be entered 

in text box (System Dependant)

Drive Server Setup/Status Utility

7.1 Start and Configure the Configuration Update Utility

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 131

The Machine Name has two benefits. First, it provides additional functionality through the 

Drive Server Setup/Status application. Secondly, the Machine Name does not require the PC 

that the Drive Server is executing from to have a static IP address.

Sometimes site specific network policies prohibit the PC which hosts the Drive Server and the 

remote PC from being on the same domain. In this case the IP address of the PC which hosts 

the Drive Server should be entered into the Machine Name or IP Address of the Connect 

screen.

NOTICE

The best setup is achieved when both PCs are located in the same domain.

NOTICE

A static IP Address must be entered so that the IP Address of the machine will remain 

constant.

Remote PC Domain

Actual Computer Name of Remote PC

Computer Name Tab

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

132 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

After all of the previous steps have been completed, the Drive Server Setup/Status Utility 

screen should now display the following data:

7.2 Setup / Status Application Operation

Features Overview

The Drive Server Setup/Status Utility screen features currently found are:

• Status Screen

• Menu Functions

7.2.1 Status Screen

The Status screen indicates the following system data:

• Server Name: Refers to the name of the Drive Server connected to the PC. Listed below 

are the variables found in this operation:

- Is server ok to operate: Indicates if Drive Server has/has not been successfully 

configured. If indication is ‘False’, refer to Drive Server’s event log to diagnose and fix 

error

- Is server connected to drives: This statement is ‘TRUE’ when: Drive Server is ready 

to operate, when Drive Server is connected to the minimum number of drives required 

for operation, and is connected to the Master Unit (HA Drive Systems)

- Is server configured: Confirms Drive Server has/ has not been properly configured 

and is/is not operational. (see Section Set Server as Configured).

- Is System duplicate type: ‘Yes’ indicates duplicate type systems (HA Drive Systems). 

No is indicated with Parallel Drive Systems. (see Section Set Operating Conditions).

- The controlling unit is: Indicates the current controlling unit (HA Drive Systems - 

Only)

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 133

- The number of units in cluster: This line item identifies the total number of Drives in 

system (see Section Set Operating Conditions).

- The number of units connected: The collective number of Drives communicating 

together

- Number of units to operate: This number represents the minimum number of Drives 

required to be connected in order for the system to run a motor (see Section Set 

Operating Conditions).

- Unit connect status: This line item provides the connection status of each Drive 

defined in the system

7.2.2 Menu Functions - Setup Menu

7.2.2.1 Select New Server Connection

This section allows the user to switch between Drive Server connections.

7.2.2.2 Server Connection Maintenance

This item is not enabled within the menus, unless a security password has been entered to 

grant ‘Restricted Access’. Without Restricted Access permissive, NO sub-menu items will be 

available.

NOTICE

If there are < 2 server connections defined, one of the following informational messages will 

be displayed on the Drive Server Setup/ Status Utility screen:

• There are no choices

• No alternative choices are available

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

134 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

7.2.2.3 Create New Server Connection

This menu item allows user to create a new Drive Server connection. To perform this opera￾tion, three variables must be entered into the text boxes on the Connect screen. First, the 

data entered into the Connection Name text box is per the user’s choice. It is used to identify 

the connection by name. Second, the data entered into the Actual Server Name text box is 

system dependent. The text must be the actual name used in the server definition..

Third, the data entered in the Machine’s Name or IP Address text box is also system depen￾dent. The Machine Name on which the server resides should be used to achieve maximum 

functionality.

The Machine Name and domain of the Remote PC can be determine by performing the fol￾lowing:

• Open desktop on Remote PC, move cursor to  ‘My Computer’ GUI, click right mouse 

button, click  ‘Properties’ (using left mouse button), click  ‘My Computer’ tab (using 

left mouse button). A dialog window should appear.

7.2.2.4 Edit Server Connection Data

This selection allows the user to edit the server information for a connection. This selection is 

valid only if there is a minimum of one connection defined. If two or more connections are 

defined, the user will be asked which connection will be desired for editing.

NOTICE

If the Actual Server Name has been changed from the Default Entry, that new name must be 

entered in this field.

NOTICE

If the server is running on the same machine as the Drive Server Setup/Status Utility, enter 

’LocalHost’ in the text box.

NOTICE

If the Drive Server is executing from a different domain, the Machine Name cannot be used. 

For this application the IP Address of the machine on which the server is executing should 

be entered. That machine should be setup with a static IP address.

NOTICE

Refer to Section Create New Server Connection to identify what data to enter in the Connect 

screen, Actual Server Name, and Machine Name/IP Address text boxes.

NOTICE

If data for the current connection being used has been edited, the Drive Server Setup/Status 

Utility will reconnect using the new information.

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 135

7.2.2.5 Rename Server Connection

This menu item allows the user to rename the server connection. This selection is valid only if 

there is a minimum of one connection defined. If two or more connections are defined, the 

user will be asked which connection will be desired for renaming.

7.2.2.6 Delete Server Connection

This selection allows the user to delete a server connection. This selection is only valid if 

there are a minimum of (2) connections defined.

7.2.3 Menu Functions - Server Maintenance

7.2.3.1 List Server Names

Clicking on this menu item provides the user with a list of the currently defined server names 

on the user’s PC.

7.2.3.2 Create New Server

Selecting this item allows the user to create a new server. Drive Servers can only be created 

on the machine on which the Drive Server Setup/Status Utility is currently running. To create a 

new server, first enter the new server’s name.

After entering name for new server, the user must now define the new server’s operating 

parameters.

Next enter the IP Addresses for each of the attached drives.

NOTICE

After completing this process, the connection name for any drive using the old connection 

name must be updated with the new name.

NOTICE

The server connection being used cannot be deleted.

NOTICE

If the name chosen already exists for another server, the user must select a different name.

NOTICE

See Section Set Operating Conditions.

NOTICE

The server will be stopped and then restarted during this process.

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

136 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

7.2.3.3 Rename Server

Selecting this item will allow the user to rename a server. Drive Servers can only be renamed 

on the machine on which the Drive Server Setup/Status utility is currently running. If there is 

more than one server defined the user will be asked to select the server to be renamed.

After completing this step all connections using the old server name must be updated with the 

new server name.

7.2.3.4 Delete Server

Choosing this feature allows the user to delete a server. Drive Servers can only be deleted on 

the machine on which the Drive Server Setup/ Status Utility is currently running. There must 

be a minimum of one server defined on a PC running the server software.

IMPORTANT! 

The new server is not enabled within the menus if restricted access has not been 

established by entering the security password or there is no server installed on the 

user’s PC.

NOTICE

The server will be stopped and then restarted during this process.

IMPORTANT! 

The new server is not enabled within the menus if restricted access has not been 

established by entering the security password or there is no server installed on the 

user’s PC.

NOTICE

If only one server is defined on the PC, the user will not be allowed to delete it.

NOTICE

The server will be stopped and then restarted during this process.

IMPORTANT! 

The new server is not enabled within the menus if restricted access has not been 

established by entering the security password or there is no server installed on the 

user’s PC.

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 137

7.2.4 Menu Functions - Config Menu

7.2.4.1 Select Server Controlled Data

This menu item allows the user to set the parameters that will be controlled by the server. The 

user must be connected to a Drive Server for this menu item to function. The controlled data 

set must be enabled for the server that is connected.

When this item is selected, a list of parameter IDs will be displayed with checkboxes. The 

user will identify the parameters to be controlled by the server, by clicking the associated 

checkboxes beside each of parameter. Only those parameters checked will be controlled by 

the server.

Once a parameter is configured to be controlled by a server, the same value will be main￾tained in all attached drives.

7.2.4.2 Set Server as Configured

A Drive Server that is operating has been configured. Therefore a server that is being setup 

for operation is unconfigured. An unconfigured server communicates with server, but parame￾ter control has not been enabled and drive tool communication with the drives through the 

server is not permitted. A Drive Server must be set as unconfigured to use the select server 

controlled data, set operating conditions, configure initial parameters or change drive Names/

IP Address menu items. The user must be connected to a server to perform this operation.

7.2.4.3 Set Operating Conditions

This menu item is for future functionality and is currently not available.

NOTICE

There are menu items provided to alternately check or uncheck all of the checkboxes.

IMPORTANT! 

The item is not enabled within the menus if restricted access has not been 

established by entering the security password or there is no server installed on the 

user’s PC.

NOTICE

See Section Set Server as Configured.

IMPORTANT! 

The item is not enabled within the menus if restricted access has not been 

established by entering the security password or there is not connected to server.

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

138 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

7.2.4.4 Configure Initial Parameters

This option applies only to Non-High Availability type systems. The menu item gives the user 

the ability to configure the initial parameters for the server. This procedure is used for first￾time set up of server parameters or to restore parameter settings that may have been altered 

due to an interruption with server. The user must be connected to a server to perform these 

commands.

This section of this chapter addresses loading server with proper parameter values prior to 

being set as Configured.

When a parameter value mismatch occurs a dialog window will be displayed. In the first col￾umn of the display the user will see a list of the Parameter IDs (Only Parameter IDs which are 

set as server controlled in the respective server controlled data procedure will be displayed). 

In the second column of the display the user will see a list of values currently in the server. 

The next column will display lists of data for each of the drives connected to the server.

If a parameter value conflict is identified, the user must resolve the error before proceeding. If one 

of the drives has the correct value the user must check the box next to the displayed value in that 

drive’s respective column (Only one column per row may contain a check mark). By double clicking 

on a column header, the user will be able to check all of the checkboxes in that column. Click 

Apply button to move the data from the checked items into the server, then view results. Press 

Refresh button to refresh the data from the drives. Some of the drives data may be listed as 

“Unknown”. This occurs when the server contains controllable parameters which are not used in 

the attached drive.

IMPORTANT! 

The server chosen must have initial parameters configured.

NOTICE

Once the server is set as ‘Configured’ any parameter value in a drive that does not agree 

with the server’s value, will be over written to match the value of the server.

NOTICE

Rows will be highlighted in Yellow for any drive having a parameter value that is different 

than the server’s value.

IMPORTANT! 

The item is not enabled within the menus if restricted access has not been 

established by entering the security password, the system is a High Availability 

type system, if there is no server connected or connected server is set As 

Configured (see Section Set Server as Configured).

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 139

7.2.4.5 Change Drive Names/IP Addresses

This menu item allows the user to se the IP addresses for each of the drives that are linked to 

the server. The user must be connected to a server to perform this operation (the server used 

for this operation will have its IP Address changed).

There should be (1) IP Address entry box for each drive identified in the set operating condi￾tions ‘Number of Drives’ field. The number of drives SHOULD be set prior to entering data.

7.2.5 Menu Functions - Security Menu

7.2.5.1 Enter Security Code

Selecting this menu item displays a dialog window containing a text box to enter a password. 

The password allows the user to access restricted features within the program.

7.2.5.2 Security Clear

NOTICE

For High Availability systems the first address must be reserved for the “A” control unit (this 

unit does not control the fiber optic switch).

IMPORTANT! 

This item is not enabled within the menus if restricted access has not been 

established by entering the security password or the connected server is set As 

Configured (see Section Set Server as Configured).

IMPORTANT! 

This item is not enabled within the menus if restricted access HAS BEEN 

GRANTED by entering the security password.

CAUTION! 

When enabling this menu option the user’s access to the restricted features within 

a program WILL BE REMOVED.

IMPORTANT! 

This item is not enabled within the menus if restricted access HAS NOT been 

granted by entering the security password.

Drive Server Setup/Status Utility

7.2 Setup / Status Application Operation

140 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

7.2.5.3 Run Menu

7.2.5.4 Start Menu

Clicking this menu command will start server.

Clicking this menu command will stop server.

7.2.5.5 Restart Menu

Clicking this menu command will stop, then restart the server. This feature allows user to rein￾itialize server if server’s drive information has been modified.

NOTICE

This menu item is not available if an IP Address is entered in the server connection data in 

place of a machine name (See Section Create New Server Connection).

IMPORTANT! 

This menu item is not enabled if restricted access HAS NOT been granted by 

entering the security password, no server is connected to, or the server is currently 

running.

IMPORTANT! 

This menu item is not enabled if restricted access HAS NOT been granted by 

entering the security password, no server is connected to, or the server is currently 

NOT running.

IMPORTANT! 

This menu item is not enabled if restricted access HAS NOT been granted by 

entering the security password, no server is connected to, or the server is currently 

NOT running.

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 141

8

High Availability Drive Tool

This section defines the features added to the Drive Tool, exclusive to High Availability 

systems only. 

8.1 Connection to Drive Tool

After defining the Drive Server connection on a PC (as outlined in the Drive Server Setup/Sta￾tus Utility Chapter, Section Start and Configure the Configuration Update Utility), that connec￾tion can be used for communication by the Drive Tool. 

In order for a drive to connect through it’s Drive Server, the Drive Server must first be set “As 

Configured” and must have “Ok to operate” and “Connected to drives” as its status. If these 

conditions are not met, the Drive Tool will not connect.

NOTICE

It is important to remember the server connection name being used on a PC, as this name 

must also be used to connect the drive with the Drive Tool from that PC.

8.1 Connection to Drive Tool

142 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

1. Create a new Drive Tool configuration (as outlined in the ToolSuite Manual). After creating 

new Drive Tool, start the new instance. A window similar to the one in the figure below will 

appear.

2. Double click the “TCP/IP server name” parameter in the menu tree. A dialog window will 

appear. In the ‘New Value’ text box, enter the name of the Drive Server connection 

(“Remote Drive Server” is used in the figure below).

If the Name entered is not recognized by the Drive Server, the following dialog will appear:

8.1 Connection to Drive Tool

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 143

If the Name entered is accepted by the Drive Server, the following dialog will appear:

8.2 Selecting Desired Control System

144 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

8.2 Selecting Desired Control System

To change the selected Control System perform the following steps:

1. Click on View menu, then click Drive in the pull-down menu (as shown in figure 

below).

2. Type ‘Control’ in the text box of the dialog window (see figure below).

8.2 Selecting Desired Control System

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 145

When the ‘Control’ feature is selected on the Drive Tool menu tree, only the parameters which 

are server controlled will be active. The controlling unit, either ‘A’ or ‘B’ will be identified in the 

list. When a selection is made for a specific Control System, the parameters in the tree will be 

those parameters on that control which are not server controlled. The Control System that is 

active will be displayed in the top line of the menu tree.

NOTICE

‘Control’ is the default setting and represents the Control System currently controlling the 

motor.

8.2 Selecting Desired Control System

146 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 147

A

Glossary

This appendix contains definitions of terms and abbreviations used throughout the Perfect 

Harmony series manuals.

AND

AND is a logical Boolean function whose output is true if all of the inputs are true in SOP nota￾tion, AND is represented as “” (e.g., C=AB), although sometimes it may be omitted between 

operands with the AND operation being implied (e.g., C=AB).

ASCII

ASCII is an acronym for American Standard Code for Information Interchange, a set of 8-bit 

computer codes used for the representation of text.

Automatic bypass operation

Automatic bypass operation is the same as bypass operation, but occurs automatically if a 

drive fault occurs and a pre-defined time has elapsed after the fault.

Automatic mode

Automatic mode is a control scheme in which the operator selects an input to be used as the 

desired velocity input. Speed profiling is used in automatic mode to allow the operator to scale 

the output based on a programmable input range.

Baud rate

Baud rate is a measure of the switching speed of a line, representing the number of changes 

of state of the line per second. The baud rate of the serial port of the Perfect Harmony is 

selected through the Baud Rate parameter in the Communications Menu [9].

Bit

Bit is an acronym for Binary digit. Typically, bits are used to indicate either a true (1) or false 

(0) state within the drive’s programming.

Glossary

148 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Boolean algebra

Developed by mathematician George Boole, Boolean algebra is a form of mathematical rules 

used in the design of digital and logic systems.

Bypass option

The Bypass option can be selected to provide optional line operation of the motor.

Carrier frequency

Carrier frequency is the set switching frequency of the power devices (IGBTs) in the power 

section of each cell. The carrier frequency is measured in cycles per second (Hz).

“Catch a spinning load” feature

“Catch a spinning load” is a feature that can be used with high-inertia loads (e.g., fans), in 

which the drive may attempt to turn on while the motor is already turning. This feature can be 

enabled via the NXG menu system.

CLVC

An acronym for Closed Loop Vector Control - which is one of six control modes in the NXG 

drive. This is flux vector control for an induction machine (IM), utilizing an encoder for speed 

feedback.

CMP

Refer to the glossary term SOP.

Comparator

A comparator is a device that compares two quantities and determines their equality. The 

comparator submenus allow the programmer to specify two variables to be compared. The 

results of the custom comparison operations can be used in the system program.

Compiler

A computer program (or set of programs) that translates high-level programming computer 

language (the source code) into a lower-level programmable language (assemble or machine 

language).

Configuration Update

see ToolSuite definition.

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 149

Converter

The converter is the component of the drive that changes AC voltage to DC voltage.

Critical speed avoidance

Critical speed avoidance is a feature that allows the operator to program up to 3 mechanical 

system frequencies that the drive will “skip over” during its operation.

CSMC

An acronym for Closed Loop Synchronous Machine (SM) Control. One of six control modes 

of the NXG drive. This is a flux vector control for a synchronous machine, utilizing an encoder 

for speed feedback and providing a field excitation command for use by an external field 

exciter.

DC link

The DC link is a large capacitor bank between the converter and inverter section of the drive. 

The DC link, along with the converter, establishes the voltage source for the inverter.

Debug Tool

see ToolSuite definition.

De Morgan’s Theorem

The duality principal of Boolean algebra used to convert system logic equations into sum-of￾products notation.

Downloading

Downloading is a process by which information is transmitted from a remote device (such as 

a PC) to the drive. The term “downloading” implies the transmission of an entire file of infor￾mation (e.g., the system program) rather than continued interactive communications between 

the two devices. The use of a PC for downloading requires special serial communications 

software to be available on the PC, which may link to the drive via RS232 or through the Host 

Simulator via an ethernet connection.

DRCTRY

Directory file for system tokens and flags used in the compilation of system programs. It pro￾vides a direct lookup table of ASCII names to internal ID numbers. It also identifies whether 

the flag is a word or bit-field, and also whether it can be used as an input or output only, or can 

be used for both.

Glossary

150 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Drive

The term “drive” refers to the power conversion equipment that converts utility power into 

power for a motor in a controlled manner.

ELV

ELV is an acronym for extra low voltage, and represents any voltage not exceeding a limit that 

is generally accepted to be 50 VAC and 120 VDC (ripple free).

EMC

EMC is an acronym for electromagnetic compatibility–the ability of equipment to function sat￾isfactorily in its electromagnetic environment without introducing intolerable electromagnetic 

disturbances to anything in that environment.

ESD

ESD is an acronym for electrostatic discharge. ESD is an undesirable electrical side effect 

that occurs when static charges build up on a surface and are discharged to another. When 

printed circuit boards are involved, impaired operation and component damage are possible 

side effects due to the static-sensitive nature of the PC board components. These side effects 

may manifest themselves as intermittent problems or total component failures. It is important 

to recognize that these effects are cumulative and may not be obvious.

Fault log

Fault messages are saved to memory so that the operator may view them at a later time. This 

memory location is called the fault log. The fault log lists both fault and alarm messages, the 

date and time that they occurred, and the time and date that they are reset. 

Faults

Faults are error conditions that have occurred in the Perfect Harmony system. The severity of 

faults vary. Likewise, the treatment or corrective action for a fault may vary from changing a 

parameter value to replacing a hardware component such as a fuse.

Flash Card

Non-volatile memory storage device for the NXG control. It stores the drive program, system 

program, logs, parameters, and other related drive files.

FPGA

Field Programmable Gate Array. An FPGA is an integrated circuit that contains thousands of 

logic gates.

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 151

Function

A function is one of four components found in the Perfect Harmony menu system. Functions 

are built-in programs that perform specific tasks. Examples of functions include System Pro￾gram Upload/Download and Display System Program Name.

Harmonics

Harmonics are undesirable AC currents or voltages at integer multiples of the fundamental 

frequency. The fundamental frequency is the lowest frequency in the wave form (generally the 

repetition frequency). Harmonics are present in any non-sinusoidal wave form and cannot 

transfer power on average.

Harmonics arise from non-linear loads in which current is not strictly proportional to voltage. 

Linear loads like resistors, capacitors, and inductors do not produce harmonics. However, 

non-linear devices such as diodes and silicon controlled rectifiers (SCRs) do generate har￾monic currents. Harmonics are also found in uninterruptable power supplies (UPSs), rectifi￾ers, transformers, ballasts, welders, arc furnaces, and personal computers.

Hexadecimal digits

Hexadecimal (or “hex”) digits are the “numerals” used to represent numbers in the base 16 

(hex) number system. Unlike the more familiar decimal system, which uses the numerals 0 

through 9 to make numbers in powers of 10, the base 16 number system uses the numerals 

0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, and F to make numbers in powers of 16. 

Historic log

The historic log is a troubleshooting/diagnostic tool of the Perfect Harmony NXG control. The 

historic log continuously logs drive status, including the drive state, internal fault words, and 

multiple user-selectable variables. This information is sampled every slow loop cycle of the 

NXG control (typically 450 to 900 times per second). If a fault occurs, the log is frozen a pre￾defined number of samples after the fault event, and data samples prior to and after the fault 

condition are recorded to allow post-fault analysis. The number of samples recorded are user￾selectable via the NXG control, as well as the option to record the historic log within the VFD 

event log.

Host Simulator

see ToolSuite definition.

I/O

I/O is an acronym for input/output. I/O refers to any and all inputs and outputs connected to a 

computer system. Both inputs and outputs can be classified as analog (e.g., input power, 

drive output, meter outputs, etc.) or digital (e.g., contact closures or switch inputs, relay out￾puts, etc.).

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 152

IGBT

IGBT is an acronym for Insulated Gate Bipolar Transistors. IGBTs are semiconductors that 

are used in the Perfect Harmony drives to provide reliable, high-speed switching, high-power 

capabilities, improved control accuracy, and reduced motor noise.

Induction motor

An induction motor is an AC motor that produces torque by the reaction between a varying 

magnetic field (generated in the stator) and the current induced in the coils of the rotor.

Intel hex

Intel hex refers to a file format in which records consist of ASCII format hexadecimal 

(base 16) numbers with load address information and error checking embedded.

Inverter

The inverter is a portion of the drive that changes DC voltage into AC voltage. The term 

“inverter” is sometimes used mistakenly to refer to the entire drive (the converter, DC link, and 

inverter sections).

Jerk rate

Jerk rate is the time it takes for the drive to go from one acceleration rate to another. The jerk 

rate is a programmable parameter used to limit the rate of change of the acceleration. Jerk 

rate has no effect if acceleration is constant. Jerk rate helps to prevent small overshoots and 

provides the “S-curve” (speed / timeplot) characteristic as the speed setpoint is reached.

Jog mode

Jog mode is an operational mode that uses a pre-programmed jog speed when a digital input 

(programmed as the jog mode input) is closed.

Jumpers

Jumper blocks are groups of pins that can control functions of the system, based on the state 

of the jumpers. Jumpers (small, removable connectors) are either installed (on) or not 

installed (off) to provide a hardware switch.

Ladder logic

(Also Ladder Diagram) A graphical representation of logic in which two vertical lines, repre￾senting power, flow from the source on the left and the sink on the right, with logic branches 

running between, resembling rungs of a ladder. Each branch consists of various labeled con￾tacts placed in series and connected to a single relay coil (or function block) on the right.

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 153

LED

LED is an acronym for light emitting diode. The Perfect Harmony uses three LEDs as diag￾nostic indicators on the keypad/display assembly.

Loss of signal feature

The loss of signal feature is a control scheme that gives the operator the ability to select one 

of three possible actions in the event that the signal from an external sensor, configured to 

specify the speed demand, is lost. Under this condition, the operator may program the drive 

(through the system program) to (1) revert to a fixed, pre-programmed speed, (2) maintain the 

current speed, or (3) perform a controlled (ramped) stop of the drive. By default, current 

speed is maintained.

LVD

LVD is an acronym for Low Voltage Directive, a safety directive in the EU. 

Lvl RH

This term refers the two security fields associated with each parameter of the system. These 

fields allow the operator to individually customize specific security features for each menu 

option (submenu, parameter, pick list, and function). These fields are shown in parameter 

dumps and have the following meanings. Lvl is the term for the security level. Setting R=1 

blocks parameter change, and setting H=1 hides the menu option from view until the appro￾priate access level has been activated. 

Manual mode

Manual mode is a control scheme of the Perfect Harmony in which the desired velocity of the 

drive is set manually by the operator. In local manual mode, the desired velocity is set using 

the up and down arrow keys on the front keypad of the drive. In remote manual mode, the 

desired velocity is set using a potentiometer input (located remotely from the drive) that is 

wired to the drive.

Memory

Memory is the working storage area for the Perfect Harmony drive that is a collection of RAM 

chips.

Microprocessor

A microprocessor is a central processing unit (CPU) that exists on a single silicon chip. The 

microprocessor board is the printed circuit board on which the microprocessor is mounted. 

The NXG drive employs a single-board computer with a Pentium® microprocessor.

Glossary

154 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

NEMA 1 and NEMA 12

NEMA 1 is an enclosure rating in which no openings allow penetration of a 0.25-inch diameter 

rod. NEMA 1 enclosures are intended for indoor use only. NEMA 12 is a more stringent 

NEMA rating in which the cabinet is said to be “dust tight” (although it is still not advisable to 

use NEMA 12 in conductive dust atmospheres). The approximate equivalent IEC rating is 

IP52.

Normally closed (NC)

Normally closed refers to the contact of a relay that is closed when the coil is de-energized.

Normally open (NO)

Normally open refers to the contact of a relay that is open when the coil is de-energized.

OLTM

An acronym for Open Loop Test Mode - One of six control modes of the NXG drive. 

OLVC

An acronym for Open Loop Vector Control, also known as Encoderless Vector Control. OLVC 

is a flux vector control that is one of six control modes of the NXG drive. The drive computes 

the rotational speed of the rotor and uses it for speed feedback. 

OOS

OOS is an abbreviation for out of saturation - a type of fault condition in which a voltage drop 

is detected across one of the IGBTs during conduction. This can indicate that the motor is 

drawing current too rapidly or in excess.

OR

OR is a logical Boolean function whose output is true if any of the inputs is true. In SOP nota￾tion, OR is represented as “+”.

Parameter

A parameter is one of four items found in the Perfect Harmony menu system. Parameters are 

system attributes that have corresponding values that can be monitored or, in some cases, 

changed by the user.

PED

PED is an acronym for pressure equipment directive, a directive of the EU relating to pressure 

vessels.

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 155

Pick list

A pick list is one of four items found in the Perfect Harmony menu system. Pick lists are 

parameters that have a finite list of pre-defined “values” from which to choose, rather than a 

value range used by parameters.

PID

PID is an acronym for proportional + integral + derivative, a control scheme used to control 

modulating equipment in such a way that the control output is based on (1) a proportional 

amount of the error between the desired setpoint and the actual feedback value, (2) the sum￾mation of this error over time, and (3) the change in error over time. Output contributions from 

each of these three components are combined to create a single output response. The 

amount of contribution from each component is programmable through gain parameters. By 

optimizing these gain parameters, the operator can “tune” the PID control loop for maximum 

efficiency, minimal overshoot, quick response time, and minimal cycling.

Qualified user

A qualified user is a properly trained individual who is familiar with the construction and oper￾ation of the equipment and the hazards involved.

Quick menu

Quick menu is a feature of the menu system that allows the operator to directly access any of 

the menus or parameters, rather than scrolling through menus to the appropriate item. This 

feature uses the [Shift] button in conjunction with the right arrow. The user is prompted to 

enter the four digit ID number associated with the desired menu or parameter.

RAM

RAM is an acronym for Random Access Memory, a temporary storage area for drive informa￾tion. The information in RAM is lost when power is no longer supplied to it. Therefore, it is 

referred to as volatile memory. 

Regeneration

Regeneration is the characteristic of an AC motor to act as a generator when the rotor’s 

mechanical frequency is greater than the applied electrical frequency.

Relay

A relay is an electrically controlled device that causes electrical contacts to change their sta￾tus. Open contacts will close and closed contacts will open when rated voltage is applied to 

the coil of a relay.

Glossary

156 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Resonance avoidance

Resonance avoidance is a feature that allows the operator to program up to 3 mechanical 

system frequencies that the drive will “skip over” during its operations.

RS232C

RS232C is a serial communications standard of the Electronics Industries Association (EIA). 

Setpoint

Setpoint is the desired or optimal speed of the VFD to maintain process levels (speed com￾mand).

Slip

Slip is the difference between the stator electrical frequency of the motor and the rotor 

mechanical frequency of the motor, normalized to the stator frequency as shown in the follow￾ing equation.:

Slip is the force that produces torque in an induction motor. Slip can also be defined as the 

shaft power of the motor divided by the stator input power.

Slip compensation

Slip compensation is a method of increasing the speed reference to the speed regulator cir￾cuit (based on the motor torque) to maintain motor speed as the load on the motor changes. 

The slip compensation circuit increases the frequency at which the inverter section is con￾trolled to compensate for decreased speed due to load droop. For example, a motor with a full 

load speed of 1760 rpm has a slip of 40 rpm. The no load rpm would be 1800 rpm. If the 

motor nameplate current is 100 A, the drive is sending a 60 Hz wave form to the motor (fully 

loaded); then the slip compensation circuit would cause the inverter to run 1.33 Hz faster to 

allow the motor to operate at 1800 rpm, which is the synchronous speed of the motor.

SMC

Is an acronym for Synchronous Motor Control - which is one of six control modes in the NXG 

drive.This mode computes the rotational speed similarly to open-loop vector control, and con￾trols the field reference or the synchronous motor as in closed-loop synchronous motor con￾trol.

6OLS ˶6ಥ˶5 ˶6

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 157

SOP

(1) SOP is an acronym for Sum Of Products. The term “sum-of-products” comes from the 

application of Boolean algebraic rules to produce a set of terms or conditions that are grouped 

in a fashion that represents parallel paths (ORing) of required conditions that all must be met 

(ANDing). This would be equivalent to branches of connected contacts on a relay logic ladder 

that connect to a common relay coil. In fact, the notation can be used as a shortcut to 

describe the ladder logic. (2) SOP, when used as a filename extension, refers to System 

Operating Program.

SOP Utilities

The program within the Siemens LD A ToolSuite used for converting between text and 

machine loadable code. It can also be used for uploading and downloading files over the 

RS232 connection. See also ToolSuite definition.

Stop mode

Stop mode is used to shut down the drive in a controlled manner, regardless of its current 

state. 

Submenus

A submenu is one of four components found in the Perfect Harmony menu system. Sub￾menus are nested menus (i.e., menus within other menus). Submenus are used to logically 

group menu items based on similar functionality or use.

Synchronous speed

Synchronous speed refers to the speed of an AC induction motor’s rotating magnetic field. It 

is determined by the frequency applied to the stator and the number of magnetic poles pres￾ent in each phase of the stator windings. Synchronous Speed equals 120 times the applied 

Frequency (in Hz) divided by the number of poles per phase.

System Operating Program

The functions of the programmable inputs and outputs are determined by the default system 

program. These functions can be changed by modifying the appropriate setup menus from 

the front keypad and display. I/O assignments can also be changed by editing the system pro￾gram (an ASCII text file with the extension .SOP), compiling it using the compiler program, 

and then downloading it to the controller through its serial port, all by utilizing the SOP Utility 

Program with the Siemens LD A ToolSuite.

Glossary

158 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

ToolSuite

Is the suite of programs developed by Siemens that allows easier access to the NXG drive for 

programming and monitoring. It is comprised of the following components:

ToolSuite Launcher

also referred to as ToolSuite; used for coordinating other tools.

SOP Utilities

used to launch an editor that compiles or reverse compiles a System Program. It also allows 

for serial connection to the drive for uploading and downloading System Programs.

Configuration Update

allows for backing-up, updating, and cloning drives via direct access to the Flash Disk.

Host Simulator

used for monitoring, programming, and controlling a drive remotely from a PC over the built-in 

ethernet port of the drive. Parameter changes, status display, and graphing of internal vari￾ables are its main functions.

Debug Tool

this tool is used to display the diagnostic screens of the drive for diagnosing drive problems or 

improving performance via the built-in ethernet port of the drive.

ToolSuite Launcher

see ToolSuite definition.

Torque

The force that produces (or attempts to produce) rotation, as in the case of a motor.

Uploading

Uploading is a process by which information is transmitted from the drive to a remote device 

such as a PC. The term uploading implies the transmission of an entire file of information 

(e.g., the system program) rather than continued interactive communications between the two 

devices. The use of a PC for uploading requires communications software to be available on 

the PC.

Variable frequency drive (VFD)

A VFD is a device that takes a fixed voltage and fixed frequency AC input source and con￾verts it to a variable voltage, variable frequency output that can control the speed of an AC 

motor.

Glossary

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 159

Vector control

Vector control is one of two available application modes of the Perfect Harmony drive. Vector 

control mode means that the control algorithm of the drive consists of a closed loop speed 

control component and a closed loop torque control component. Since vector control applica￾tions require (a) precisely controlled starting torques (0.1%), (b) precisely controlled speeds 

(0.1%), and/or (c) fast response, such applications use either an encoder or a magnetic 

pickup for direct speed control feedback. Typical vector control applications include centri￾fuges, extruders and test stands. Compare with standard control.

VHZ

Is an acronym for Volts per Hertz control, one of six control modes in the NXG drive. This 

mode is intended for multiple motors connected in parallel. Therefore, it disables spinning 

load and fast bypass. This is essentially open-loop vector control with de-tuned (smaller 

bandwidth obtained by reducing the gain) current regulators.

Glossary

160 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 161

B

Abbreviations

This appendix contains a list of symbols and abbreviations commonly used throughout the 

Perfect Harmony series of manuals. 

Abbreviation Meaning

 Boolean AND function

+ Addition or Boolean OR

 Summation

µ Microsecond

A Amp, Ampere

AC Alternating Current

accel Acceleration

A/D Analog to Digital Converter

ADC Analog to Digital Converter

AI Analog Input

alg Analog

avail Available

BIL Basic Impulse Level

BTU British thermal units

C Centigrade or Capacitor

cap Capacitor

CCB Cell Control Board

ccw Counter clockwise

CE Formerly European Conformity, now true definition

CFM Cubic feet per minute

CLVC Closed Loop Vector Control

cmd Command

com Common

conn Connector

CPS Control Power Supply

CPU Central Processing Unit

CSMC Closed Loop Synchronous Motor Control

CT Current Transformer

cu Cubic

Abbreviations

162 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

curr, I Current

cw Clockwise

D Derivative (PID), depth

D/A Digital-to-analog (converter)

db Decibel

DC Direct Current

DCR Digital Control Rack

DCS Distributed Control System

decel Deceleration

deg, ° Degrees

DHMS Down hole monitoring system

div Division

dmd Demand

e Error

EC Electrically Commutated

ELV Extra Low Voltage

EMC Electromagnetic Compatibility

EMF Electromotive Force

EMI Electromagnetic Interference

EPS Encoder Power Supply

ESD Electrostatic Discharge

ESP Electrical Submersible Pump

ESTOP, e-stop Emergency Stop

fb, fdbk Feedback

ffwd Feed Forward

FLC Full Load Current

freq Frequency

ft, ' Feet

fwd Forward

GenIIIe Generation IIIe

GenIV Generation IV

gnd Ground

GUI Graphical User Interface

H Height

H2O Water

hex Hexadecimal

hist Historic

hp Horsepower

hr Hour

HV High Voltage

HVAC Heating, Ventilation, Air Conditioning

Abbreviation Meaning

Abbreviations

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 163

HVF Harmonic Voltage Factor

Hz Hertz

I Integral (PID)

ID Identification

IEC International Electrotechnical Commission

IEEE Institute of Electrical and Electronic Engineers

IGBT Insulated Gate Bipolar Transistor

in Input

in, “ Inches

INH Inhibit

I/O Input(s)/Output(s)

IOB I/O Breakout Board

IOC Instantaneous Overcurrent

IP Input Protection

k 1,000 (e.g., Kohm)

kHz KiloHertz

kV Kilo Volts

kVA One Thousand Volt Amps

kW Kilowatt

L Inductor

LAN Local Area Network

lbs Pounds (weight)

LCD Liquid Crystal Display

ld Load

LED Light-emitting Diode

LFR Latch Fault Relay

lim Limit

LOS Loss Of Signal

lps Liters Per Second

mA Milliamperes

mag Magnetizing

max Maximum

MCC Motor Control Center

mg Milligram

min Minimum, Minute

msec Millisecond(S)

msl Mean Sea Level

MV Medium Voltage

mvlt Motor Voltage

MW Megawatt

NC Normally Closed

Abbreviation Meaning

Abbreviations

164 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

NEMA National Electrical Manufacturer’s Association

NMI Non-Maskable Interrupt

No Normally Open

NVRAM Non-Volatile Random Access Memory

NXG Next Generation Control

NXG II Next Generation Control II

oamp Output Current

OLVC Open Loop Vector Control

O-M Overmodulation

OOS Out of Saturation (IGBT)

overld Overload

P Proportional (PID)

Pa Pascals

pb Push Button

PC Personal Computer or Printed Circuit

PCB Printed Circuit Board

PID Proportional Integral Derivative

PLC Programmable Logic Controller

PLL Phase Locked Loop

pot Potentiometer

pp Peak-to-peak

ppm Parts per Million

PPR Pulses per Revolution

PQM Power Quality Meter

ProToPSTM Process Tolerant Protection Strategy

PSDBP Power Spectral Density Break Point

psi Pounds Per Square Inch

pt Point

PT Potential Transformer

PWM Pulse Width Modulation

Q1,Q2,Q3,Q4 Output Transistor Designations

rad Radians

RAM Random Access Memory

ref Reference

rev Reverse, Revolution(S)

RFI Radio Frequency Interference

RLBK Rollback

rms Root-mean-squared

RPM Revolutions Per Minute

RTD Resistance Temperature Detector

RTU Remote Terminal Unit

Abbreviation Meaning

Abbreviations

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 165

RX Receive (RS232 Communications)

s Second(s)

SCB Signal Conditioning Board

SCR Silicon Controlled Rectifier

sec Second(s)

ser Serial

SMC Synchronous Motor Control

SOP Sum of Products; System Operating Program

spd Speed

stab Stability

std Standard

sw Switch

T1, T2 Output Terminals TI and T2

TB Terminal Block

TBD To Be Determined

TCP/IP Transmission Control Protocol/Internet Protocol

THD Total Harmonic Distortion

TOL Thermal Overload

TP Test Point

trq,  Torque

TX Transmit (RS232 Communications)

UPS Uninterruptable Power Supply

V Voltage, Volts

VA Volt-Amperes

VAC Volts AC

var Variable

VDC Volts DC

vel Velocity

VFD Variable Frequency Drive

V/Hz Volts per Hertz

vlts Voltage(s), Volts

VSI Voltage Source Inverter

W Width, Watts

WAGO Expansion I/O System

WCIII Water Cooled III

xfmr, xformer Transformer

Abbreviation Meaning

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 166

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 167

C

Operators and Precedence

C.1 Operators and Precedence

There are two forms of operators that can be used in a source line of the system program. 

These forms are unary operators (requiring only a single operand) and binary operators.

There is a single unary operator: the negate operator. This operator takes the form of a slash 

character (“/”) which precedes a single input symbol. This operator forms the inverse logic 

equivalent of the symbol immediately following it for incorporation into the statement evalua￾tion. It has higher precedence than the binary operators, which means it is evaluated before 

the evaluation of any binary operations. 

For example, the expression:

/Zero_O

equates to:

NOT Zero_O.

If the input variable “Zero_O” were FALSE, then “/Zero_O” would equate to TRUE.

There are two binary operators: AND and OR. These operators take the form of an asterisk 

(“*”) and a plus sign (“+”), respectively. These operators correspond to the Boolean AND and 

OR functions. Unlike the unary NOT operator (which requires only a single variable), each of 

these operators requires two variables, which surround the operator.

The binary operators “+” and “*” serve to form the simple Boolean combination of the com￾bined expression preceding the operator and the symbol (possibly negated) immediately fol￾lowing the operator. Parentheses are not allowed to force expression evaluation. The 

expression must be formed with left to right precedence and must be expanded to simple 

form. 

Refer to the Boolean truth tables in Table C-1 for functional descriptions of the operators.

Table C-2 shows the precedence of operations. Table C-3 shows syntax examples. 

NOTICE

The “/” symbol must be followed by an input symbol.

Operators and Precedence

C.1 Operators and Precedence

168 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table C-1: Boolean Truth Table for the NOT, AND and OR Functions

Table C-2: Precedence of Operations

Table C-3: Syntax Examples

The term “sum-of-products” comes from the application of Boolean algebraic rules to produce 

a set of terms or conditions that are grouped in a fashion that represents parallel paths 

(ORing) of required conditions that all must be met (ANDing). This would be equivalent to 

branches of connected contacts on a relay logic ladder that connect to a common relay coil. In 

fact, the notation can be used as a shortcut to describe the ladder logic. 

First let us examine the rules of Boolean algebra. The set of rules that apply in this logical 

math are broken into three sets of laws: commutative, associative, and distributive. The oper￾ators are “AND” (abbreviated with the “·” character [or “*” character from the keyboard]), “OR” 

(abbreviated with the “+” character), and “NOT” (abbreviated with a line above the operand, 

e.g., A [or a preceding “/” character from the keyboard]). The commutative, associative, and 

distributive rules are shown in Table C-4.

NOT Function AND Function OR Function

A /A A B A*B A B A+B

False True False False False False False False

True False False True False False True True

True False False True False True

True True True True True True

Type of Operation Symbol Meaning Precedence

Unary Operation / Not High (performed first)

Binary Operation * And :

Binary Operation + Or Low (performed last)

Example Description

C = A + B; Correct, C equals A OR B

C = A * B + D; Correct, C equals (A AND B) OR D

C = A + B * D; Correct, C equals A OR (B AND D)

C = A * B + A * D; Correct, C equals (A AND B) OR (A AND D)

C = A * (B + D); Incorrect, parentheses not allowed

C = A + /B; Correct, C equals A OR (NOT B)

/C = A * B; Incorrect, negation not permitted on output side

Operators and Precedence

C.1 Operators and Precedence

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 169

Table C-4: Boolean Laws

Table C-5: General Rules of Boolean Math

Add to this DeMorgan's Theorem which states “the complement of the intersection (AND) of 

any number of sets equals the union (OR) of their complements” which, simply stated, means 

that if you invert a grouping of elements, you invert the individual elements and also change 

the logical relationship between them. So you can change from an OR to an AND function, for 

example: 

(A + B) = (A · B)

or from an AND to an OR function, for example:

(A · B) = (A + B)

By using these rules, any logical statement can be reduced to the sum (+) of products (·) or 

the ORing of ANDed terms as illustrated in the following example:

O = AB + BCD + CDF;

The SOP file, as mentioned above, is written with a text editor or a word processor set for 

pure ASCII text (having a .TXT file extension) with no control or formatting codes with the 

exception of horizontal tabs (ASCII code 09h) and carriage returns (0Dh). Only printable char￾acters and spaces (20h) can be used. The file consists of the following format:

Commutativea

a. The syntax “AB” implies (A · B)

Associativea Distributivea

A + B = B + A A + (B + C) = (A + B) + C A (B + C) = AB + AC

AB = BA A (BC) = (AB) C

General Rules General Rules General Rulesa

a. The syntax “AB” implies (A · B)

A · 0 = 0 A + 0 = A A + AB = A

A · 1 = A A + 1 = 1 A (A + B) = A

A · A = A A + A = A (A + B) (A + C) = A + BC

A · A = 0 A + A = 1 A + AB = A + B

= A = A

Operators and Precedence

C.1 Operators and Precedence

170 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Item Description

Drive type 

specifier

This must reside on the first line of the file prefixed with the pound sign (#) and 

followed with the name of the drive (in the case of Perfect Harmony, this would be 

#Harmony;)

Header A comment field containing the following information:

Title - Siemens LD A Perfect Harmony drive

Program part number

Customer name

Sales order number and Siemens drive part number

Drive description Original SOP date

File name

Engineer Name (Originator)

Revision history (date and change description)

Note: A comment is any text within the file, preceded by a semi-colon, which is used 

exclusively for informational purposes and is ignored by the compiler.

Operators Comment field containing operators and symbols

I/O 

specifier

Comment field describing the system input and output flags as they relate to the 

external system. This would include any user faults and notes on menu settings, such 

as Comparator setups and XCL settings, as they apply to the system program (more 

on this later). These can (and should) be grouped logically to allow easy access to 

information and to make the SOP more understandable.

User fault 

messages

Assigns the text to be displayed when this particular user fault is activated.

Main logic 

section

All the equations and assignments for the configuration, annunciation, and operation 

of the drive. These should be logically arranged with careful consideration given to the 

order of evaluation of the equations.

Operators and Precedence

C.2 Ladder Logic Translation

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 171

C.2 Ladder Logic Translation

It was mentioned above that the sum-of-products notation can represent ladder logic. In actu￾ality, it is very easy to directly translate between the two. For example, consider the equation 

or statement:

Z = ABC + DEF + FGH;

Translated into the notation of the limited ASCII characters available in a common text editor, 

the statement would read as follows (note that the components are separated at “ORs” and 

stacked for clarity). 

Z =/A*B*C 

+ D*/E*F 

+ F*G*H; 

This statement can be pictorially represented by breaking each statement down in the follow￾ing manner: 

1. First, the output variable (in this case Z) is represented by a coil to the right of the ladder.

2. Second, each product term (the variables separated by the asterisk) is represented by a 

single line of contacts connecting to the coil.

3. All the product terms that are summed (separated by the plus sign) are represented by 

parallel paths to the same coil.

4. All non-inverted contacts are represented by normally open (NO) contacts, while the 

inverted terms are represented by normally closed (NC) contacts.

The resulting ladder logic is illustrated in Figure C-1.

Figure C-1: Ladder Logic Representation of a Boolean Expression - Example 1

Conversely, if the ladder logic shown in Figure C-2 is desired, it could be converted into a 

sum-of-products statement. The procedure would be the inverse of the previous, and is enu￾merated below.

1. First place the label of the output relay coil to the left, with an equals sign following. 

2. Next, start in each path from left to the connection to the coil on the right, writing the label 

for each contact with the asterisk representing the AND or product operator in between. 

3. In front of each NC contact, place a forward slash representing the inversion or NOT 

operator (shown in the equations as a bar over the variable name). 

Operators and Precedence

C.2 Ladder Logic Translation

172 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

4. Repeat this for each parallel path using the OR (sum) operator (+) in between each 

grouping of product terms. 

5. Finally, the statement is terminated by a semicolon to represent the end of the statement. 

Figure C-2: Ladder Logic Representation of a Boolean Expression - Example 2

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 173

D

Ethernet Connections

D.1 Direct Connection

The direct connection is for either a single PC connected to the drive using a special Ethernet 

crossover cable, or a small network hub or switch connecting multiple drives to one or more 

PCs. 

D.1.1 Required Items for a Single Ethernet Direct Connection

• Crossover patch cable: this allows you to connect directly with the drive without a hub or 

server (requires a coupler, as shown below): 

Solutions4sure, http://www.solutions4sure.com/, 800.595.9333, supplier no. SOL4 

S878311 10/100 BT CAT5 XOVER PATCH 3’ ORG 88468

S104652 RJ45 MODULAR COUPLER STRT R6G050 

7RRO6XLWH3& 1;*'ULYH

&RQWURO

&URVVRYHU

FDEOHDQG

FRXSOHU

Ethernet Connections

D.1 Direct Connection

174 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

D.1.2 Required Items for a Single PC Multiple Drive Ethernet Connection Support

• EtherFast 10/100 5 port HUB

GLOBAL COMPUTER SUPPLIES, http://www.globalcomputer.com/eQZ25aqd/, 888.8GL.OBAL

302517Linksys EtherFast 10/100 5pt WKGP Hub EFAH05W 

• Ethernet Cat5 Cable 

GLOBAL COMPUTER SUPPLIES, http://www.globalcomputer.com/eQZ25aqd/, 888.8GL.OBAL

ZCC31805XX 25’ SNAG-PROOF Ethernet cable Cat5 RJ-45 (xx - choose color)

ToolSuite

 PC

HUB

or

 Switch

NXG

Drive

 Control

NXG

Drive

 Control

NOTICE

This configuration also allows for more than one PC.

Ethernet Connections

D.1 Direct Connection

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 175

D.1.3 Configuring a PC to Work with a Direct Connection

D.1.3.1 Windows® XP /2000

1. From the Start Menu, select “Settings” and click “Control Panel” as shown below:

NOTICE

Windows® NT/XP/2000 and Windows® Vista each have different procedures for the 

configuration of network parameters. 

Control Panel

Ethernet Connections

D.1 Direct Connection

176 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

2. Within the Control Panel, double click on the “Network and Internet Connections” icon.

3. Select “Network Connections”.

Double click

Select Network 

Connections Icon

Ethernet Connections

D.1 Direct Connection

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 177

4. The Network Connections dialog window displays. Highlight “Local Area Connection” and 

right-click to display a pop-up window containing a list of parameters. Select “Properties” 

to display the “Local Area Connections Properties” window.

Select properties

Ethernet Connections

D.1 Direct Connection

178 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

5. From the “Local Area Connection Properties” window select the “Internet Protocol TCP/IP” 

connection that your PC uses (there may be more than one).

6. Choose the “Use the following IP address” radio button.

Ethernet Connections

D.1 Direct Connection

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 179

Table D-1: Addresses of PC and Drive1 1Where a, b, m, n, x, and y can be integers between 0 and 255.

7. Set the IP addresses for both the drive and the PC. In a direct connection, you will need to 

set the IP addresses of both the PC running the ToolSuite, and for the drive as well. The 

addresses will not be completely arbitrary. Siemens recommends that the first number of 

both addresses be between 128 and 191 for class B network settings. You may select 

class A or C settings, if desired. The connection will function regardless of the class 

settings. The first two numbers (octets) of the drive’s IP address must be the same as the 

first two numbers of the PC’s IP address. For example, if you assign 172.16.20.15 as the 

drive’s IP address, the PC’s IP address must be 172.16.x.y, where the combination of x 

and y must be different than 20.15. 

8. Set the drive’s IP address using keypad parameter ID 9310.

9. Next, set the subnet mask for the PC and the drive. In the “Subnet Mask:” field of the IP 

Address page, enter a value of 255.255.0.0. This value is the default for a class B network. 

The subnet mask must be the same for both the PC and the drive. Set the drive’s subnet 

mask using keypad parameter ID 9320.

10.Set the gateway for the drive and the PC. Stay in the TCP/IP Properties dialog box and 

click on the “Gateway” tab. Assign a valid arbitrary address number to the PC’s gateway in 

the “New Gateway” field. This address can be arbitrary (i.e. 0.0.0.0) because a direct 

connection does not actually use a gateway. This virtual gateway that you are creating for 

the direct connection does not physically exist. It is only to satisfy the software. After 

entering the address in the “New Gateway” field, go to the keypad on the front of the drive, 

and enter the same gateway address in parameter ID 9330. 

Device IP Address

PC a.b.m.n

Drive a.b.x.y

Ethernet Connections

D.1 Direct Connection

180 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

11.Click “OK”. The “Connection Properties” window appears. 

12.Click “OK”. Windows may ask you if would like to restart your computer so that the 

changes can take effect. Click “Yes” to restart.

D.1.3.2 Windows® Vista

1. From the Start Menu, select “Network” and click “Open” to display the available network 

connections.

Ethernet Connections

D.1 Direct Connection

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 181

2. Click the “Local Area Connection” button to display the “Local Area Connections 

Properties” dialog window. From this window select Internet Protocol Version 4 (TCP/IPv4) 

to display its dialog box.

3. Select the “Use the following IP address” radio button.

Ethernet Connections

D.1 Direct Connection

182 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Table D-2: Addresses of PC and Drive1 1Where a, b, m, n, x, and y can be integers between 0 and 255.

4. Set the IP addresses for both the drive and the PC. In a direct connection, you will need to 

set the IP addresses of both the PC running the ToolSuite, and for the drive as well. The 

addresses will not be completely arbitrary. Siemens recommends that the first number of 

both addresses be between 128 and 191 for class B network settings. You may select 

class A or C settings, if desired. The connection will function regardless of the class 

settings. The first two numbers (octets) of the drive’s IP address must be the same as the 

first two numbers of the PC’s IP address. For example, if you assign 172.16.20.15 as the 

drive’s IP address, the PC’s IP address must be 172.16.x.y, where the combination of x 

and y must be different than 20.15. 

5. Set the drive’s IP address using keypad parameter ID 9310.

6. Next, set the subnet mask for the PC and the drive. In the “Subnet Mask:” field of the IP 

Address page, enter a value of 255.255.0.0. This value is the default for a class B network. 

The subnet mask must be the same for both the PC and the drive. Set the drive’s subnet 

mask using keypad parameter ID 9320.

7. Set the gateway for the drive and the PC. Assign a valid arbitrary address number to the 

PC’s gateway in the “Default gateway:” field. This address can be arbitrary (i.e. 0.0.0.0) 

because a direct connection does not actually use a gateway. This virtual gateway that 

you are creating for the direct connection does not physically exist. It is only to satisfy the 

software. After entering gateway address here, go to the keypad on the front of the drive, 

and enter the same gateway address in parameter ID 9330. Click “OK”. 

8. Click “OK” on the next window’s dialog box. Windows may ask you if would like to restart 

your computer so that the changes can take effect. Click “Yes” to restart.

Device IP Address

PC a.b.m.n

Drive a.b.x.y

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 183

E

Appendix

E.1 Notes 

Appendix

E.1 Notes

184 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Appendix

E.2 Reader Comments Form

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 185

E.2 Reader Comments Form

To provide quality documentation that meets the needs of its customers, Siemens LD A 

invites comments and criticisms of this manual. Please complete the attached form and pro￾vide your comments on this manual. After completing this form, please remove this page from 

the manual (or photocopy it) and either mail, E-mail or fax it back to the Documentation 

Department at Siemens LD A. These are mechanisms through which you can positively effect 

the documentation that you receive from Siemens. Thank you for your feedback. It isalways 

valued and appreciated 

What improvements would you like to see? (Please be specific and cite examples, if possi￾ble.) 

Did you find any technical inaccuracies or mistakes? If so, please indicate page number(s) 

and information that needs to be corrected. 

What feature of the manual did you find the most useful? The least useful? 

Did you find the manual well organized? Yes No

Was the information presented clearly? Yes No

Was the manual sufficiently illustrated? Yes No

Did you find the material adequate? Yes No

Would you prefer a more technical or less technical approach? More Less

Appendix

E.2 Reader Comments Form

186 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Additional Comments

Thank you for your comments. Please mail, fax or e-mail your comments to:

Attention: R&D Technical Writing Department

Siemens LD A

100 Sagamore Hill Road

Pittsburgh, PA 15239

USA

Phone: (724) 339-9500 Fax: (724) 339-9562 E-mail: [email protected]

Appendix

E.3 Startup/Warranty Registration and Service Solutions

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 187

E.3 Startup/Warranty Registration and Service Solutions

To assure timely technical updates on your equipment, please complete and return this form. 

This information is to be completed by the end user or equipment owner. For information on 

post sale service solutions, please check the appropriate boxes below before returning this 

form to Siemens Industry, Inc.

For additional information by phone, please complete the table above and check the appropri￾ate items below:

Return this information to Siemens at the address below, or fax it to (724) 339-9562, or call 

the Technical Support Department at (724) 339-9501. Please visit our web site at www.sie￾mens.com.

Company Name

Contact Name

Company Address 

Phone

Fax

E-mail 

Part Number (P/N) 

(see system door or system panel) 

Sales Order Number (SO #) 

(see system door or system panel) 

Start-up Date

Start-up Completed by

• Extended Warranty

• Full Service Agreement

• Preventative Maintenance Agreement

• In-House Training at Siemens

• On-Site Training at your Location

• Spare Parts Kits

Attention: Customer Service Operations

Siemens LD A

500 Hunt Valley Road

New Kensington, PA 15068

USA

188 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 189

Index

A

abbreviations 161

AND 157

B

binary operators 167

Boolean algebra 148, 157

Boolean theory 57

Bootable Default Disk Procedure 103, 107, 110, 115, 

119, 124

C

cabinets 6

cells damage due to overheating 7

Change Default Editor 60

CMP 148

compilation error 63

Compile Process 62

Compiler 148

Error Messages 79

Operation 75

Configuration Update Utility 102, 127, 141

features 103

Configuring Drive Tool 31

control power 7

warning on disconnecting 7

Copy Setup Files 103, 128

D

Debug Tool 49

Direct Connection 175

Directory Filename Associations 69

disconnect switch 6

Downloading System Program 76

Drive 

configuration 18

configurator 49

Control Features 25

name 51

Status Features 25

Tool Pull Down Menu 26

Variable Graphing Features 19

Drive-to-machinery coordination 57

E

electrostatic discharge 8

precautions 8

ELV 6

Error Message 90

Ethernet (TCP/IP) Communications 32

exposed connections 6

extra low voltage 6

F

Fault or Alarm Displays 34

Flag Names 74

Flash Disk Files 107

fork truck tines 7

Freeze on 

fault 46

trigger 47

G

glossary 147

Graphing Display 39

ground 6, 8, 162

Index

190 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

H

hazardous voltages 6

hazards

electrical 6

mechanical 7

Header 89

I

IGBTs 152

Input 

Control logic 57

Flags 72

Source File 64

installation 12, 14

IP address 51, 181

L

ladder logic 57

and Boolean theory 57

lethal voltages 5

lifting precautions 7

list of symbols 161

lock-out/tag-out

procedures 6

logic 57

functions 57

LVD 153

M

maintenance 6

qualified individuals 6

medium voltage warning about control power 7

Multiple Drive Ethernet Connection 174

N

New Drive 51

NXG Debug Tool 49

NXG Drive Tool 17

O

Operating Debug Tool 54

Operating Drive Tool 34

OR 154

Output 

Control logic 57

Flags 72

Hex File 76

overheating 7

P

PC and Drive Addresses 179, 182

PED 154

Post Processing of Data 48

Product type selector 67

Product types 68

Q

qualified individual (for troubleshooting and maintain￾ance) 6

R

resonance avoidance 156

Reverse Compiler 83

S

safety precautions and warnings 5

SOP 57

Development Process 61

Source File 69

Text File Format 70

Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB 191

Index

Utilities Tool 57, 59

Utility Terminology 58

Utility Tool, overview 57

sound pressure 7

start/stop control logic 57

Starting the Debug Tool 49

storage safety precautions 6

successful compilation 63

Sum-Of-Products (SOP) 57

notation 57

symbol 161

System Program 57, 73, 74, 107, 110, 119, 167, 170

timers 73 

System Requirements 49, 101, 127, 141

System Type Identification 67

T

target Directory 60

target source file 60

Terminal Emulation Method 78

Termination 79

thermally hot components 5

Time intervals 74

ToolSuite 

Host Files 124

installation 15

Setup 10

software components 11

transporting precautions 7

troubleshooting (qualified individuals only) 6

U

unary operators 167

Update Flash Disk Files 107

Upload/Download Utility Method 77

Uploading System Program 83

Utilities Tab 59

V

Variables 40

W

warning on disconnect

control power 7

Index

192 Function Manual, 1.0, ROBICON Perfect Harmony, A5E03086439A AB

 


Medium-Voltage VFD ROBICON Perfect Harmony A1A902291V5.0_AB_ NXG Tool Suite User Manual 2010
Medium-Voltage VFD ROBICON Perfect Harmony A1A902291V5.0_AB_ NXG Tool Suite User Manual 2010
Long press to look detail
Long by picture save/share

Medium-Voltage VFD ROBICON Perfect Harmony A1A902291V5.0_AB_ NXG Tool Suite User Manual 2010

INQUIRY

Inquiry MORE+
  • Email *

  • Submit

  • Security Code
    Refresh the code
    Cancel
    Confirm

Inquiry Content:


You have no items to require

Add Successfully

We are the world's leading supplier of spare parts for medium voltage drives of various brands

GET IN TOUCH

East Sun Industrial Centre, No 16 Shing Yip Street Kl, Hongkong

Call us : +852 5261 7322

SITEMAP

分类标题

BUSINESS HOURS

Monday to Friday : 9 am to 6 pm

Saturday : 9 am to 12 am

Sunday : Closed Support Hours in 24/7 Everyday

DISCLAIMER:

We are not an authorized distributor, reseller or representative of the following products presented on this website. All Product names and logos throughout this site are trademarks of their respective holders. Use of them DOES NOT imply any affiliation with or endorsement by them.

© 2020 robiconperfectharmony.com site . All rights reserved     Site Map

添加微信好友,详细了解产品
使用企业微信
“扫一扫”加入群聊
复制成功
添加微信好友,详细了解产品
我知道了