Danfoss PLUS 1® GUIDE User guide

Brand: Danfoss

Model: PLUS 1® GUIDE

Type: User guide

Danfoss PLUS 1® GUIDE is a software tool that provides easy access to the powerful functionalities of the PLUS+1® system. With the intuitive user interface and comprehensive documentation, you can quickly create, edit, and manage your PLUS+1® applications. You can also use the GUIDE to connect to PLUS+1® hardware, monitor and adjust parameters, and troubleshoot issues. Whether you're a seasoned professional or just starting out, the Danfoss PLUS 1® GUIDE is the perfect tool for developing and maintaining your PLUS+1® applications.

powersolutions.danfoss.com

MAKING MODERN LIVING POSSIBLE

User Manual

PLUS+1® License

Administration Tool

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 20132

Table of Revisions

Date Page Changed Rev

27 Jan, 2011 5-6, 7-8 Minor corrections; added subsection: Access Components;

Created table for License Information.

09 Dec, 2010 Replaces PLUS+1 License Administration Tool Manual.doc AA

Revisions

Revision History

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 3

Contents

Introduction About this document .............................................................................................................................................................. 4

Overview ...................................................................................................................................................................................... 4

PLUS+1 License Administration Tool ........................................................................................................................... 4

PLUS+1 License .................................................................................................................................................................... 4

PLUS+1 Traceability ............................................................................................................................................................ 4

Application Security

Strategy

PLUS+1 Security Features....................................................................................................................................................... 5

Toolkey .................................................................................................................................................................................... 5

Read/Write Control and Access Levels ........................................................................................................................ 5

File Download ...................................................................................................................................................................... 5

PLUS+1 GUIDE Access Components ............................................................................................................................ 6

License Start/Expiry Dates ............................................................................................................................................... 6

PLUS+1 Security Strategy ................................................................................................................................................. 6

PLUS+1 License Level Settings ....................................................................................................................................... 6

PLUS+1 License Terminology PLUS+1 License Administration Tool License ................................................................................................................. 7

License Information ................................................................................................................................................................. 7

Using the PLUS+1 License

Administration Tool

Installation ................................................................................................................................................................................... 9

Creating Licenses Overview .................................................................................................................................................. 9

Creating New License .............................................................................................................................................................. 9

Editing Existing License ........................................................................................................................................................ 10

Copying Existing License ..................................................................................................................................................... 10

Deactivating or Activating License .................................................................................................................................. 11

Finding User .............................................................................................................................................................................. 11

Importing 4.x Licenses .......................................................................................................................................................... 11

Exporting License Data ......................................................................................................................................................... 12

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 20134

Introduction

About this document This document assumes knowledge of the PLUS+1® concept and some understanding of the

operation of the PLUS+1 GUIDE and Service Tool.

This document provides:

y An overview of the use of the PLUS+1 License Administration Tool.

y An overview of the PLUS+1 License and how security can be used.

y Details of how to use the PLUS+1 License Administration Tool.

y Further PLUS+1 information can be found at:

http://www.danfoss.com/Products/MobileElectronics/index.htm

Overview PLUS+1 License Administration Tool

The PLUS+1 License Administration Tool allows licenses to be created and managed for the PLUS+1

Service Tool.

The PLUS+1 License Administration Tool is itself licensed. This license determines how many Service

Tool licenses to be created and managed in the License Administration Tool. It is possible to have

several PLUS+1 License Administration Tool licenses which extends the number of licenses that can

be created and managed.

PLUS+1 License

The PLUS+1 License is used to control security to PLUS+1 applications and provides traceability of

changes to applications. For example; the license can give the user diﬀerent access levels to control

what variable and parameters can be read or written to using the PLUS+1 Service Tool.

PLUS+1 Traceability

The public PLUS+1 Service Tool includes a license embedded in the installation that has the same ID

for all users. The PLUS+1 License Administration Tool allows unique ID to be assigned to each user

license.

With a unique license ID the History Log in the PLUS+1 hardware will record:

y Who The License ID

y When Date of action (from PC clock)

y What Performed action:

– Changes to an application.

– Compiling an application.

– Download to hardware

– Adjusting application parameters in hardware.

– Reading data from the hardware.

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 5

Application Security

Strategy

PLUS+1 Security Features

PLUS+1 allows many alternative methods for the control, deployment and life cycle management of

applications in support of IEC 61508. None of the features are required to be used. However, if they

have to be used, then it is helpful to develop a company wide strategy. This section describes the

PLUS+1 features that are available and some questions that should be considered.

Toolkey

It is possible to provide a prevent access to PLUS+1 applications unless a user has the correct

password or toolkey. The toolkey is a security code that is assigned to an application when it is created

in the PLUS+1 GUIDE.

To allow the PLUS+1 Service Tool access to an application, the toolkey must be known. The toolkey

security code can be provided to the PLUS+1 Service Tool in one of three methods:

y Embedded in the users PLUS+1 license.

y Embedded in the PLUS+1 Service Tool application (P1D) ﬁle.

y Entered manually by the user into the PLUS+1 Service Tool.

The ﬁrst two methods are preferred as the user does not need to know the toolkey. Therefore, toolkey

security code would not be shared with unauthorized persons. A PLUS+1 license may contain up to

three toolkeys.

The default state of the toolkey in an application is blank. Therefore, it is possible for anyone with a

PLUS+1 license to access an application and make changes to parameters and read signal values.

Once the toolkey has unlocked an application then the further access control mechanisms may be

used as described below.

Read/Write Control and Access Levels

Without the use of a toolkey in a PLUS+1 application any further restriction or security is meaningless.

Read/write access is controlled independently, and groups of access can be disabled globally. When a

group is enabled, access is then controlled by the access level.

A number between 0 and 9. 0 is the highest access level, 9 is the most restrictive. The application

developer will determine and program the access level for every signal and parameter in the PLUS+1

GUIDE.

The users access level is determined by the PLUS+1 license. For example, a user might have inclusive

access rights between 6 and 9, if the developer were to give a signal an access level of 5, the signal

would not be viewable by the user. If the user has inclusive access rights between 0 and 5, the signal

would be viewable by the user.

File Download

The PLUS+1 License can control if applications can be downloaded to PLUS+1 hardware.

Details regarding license information and security settings, see PLUS+1 License Terminology, page 7

through 8.

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 20136

PLUS+1 Security

Features

(continued)

PLUS+1 GUIDE Access Components

Access components used in a GUIDE application will override the access rights deﬁned in the license.

License Start/Expiry Dates

A PLUS+1 license can optionally be made to operate between the Start Date and the Expiry Date. Once

a license has expired it cannot be reactive, it must be reissued with a new expiry date.

It is possible for a PC to have several licenses loaded and available for use but only one PLUS+1 license

can be active at a time. It is possible to update a user for one speciﬁc day to allow an unusual task to

be conducted with a higher or diﬀerent access level, or perhaps a diﬀerent toolkey. After this time the

special license would be no longer valid and the user would return to their original license.

PLUS+1 Security Strategy

When developing a company wide security strategy for PLUS+1 applications consider:

y Is a security code required or should anybody, including competitors, be allowed to access

applications?

y Is a company wide toolkey, or a machine family or machine speciﬁc toolkey to be used?

y Is a speciﬁc toolkey being used for a released development project?

y Does everyone, including developers, production, service, distributors, and end users, require the

same access levels to an application to read and write parameters?

y Do diﬀerent groups of people with diﬀerent access levels need to be further divided into

subgroups, even on a temporary bases, such as, when using the expiry date feature?

PLUS+1 License Level Settings

Parameter

Full PLUS+1 GUIDE development /

Service Tool design PLUS+1 Service Tool only

Create Service P1D File Enabled Disabled

Read Access Enabled Enabled

Read Access Level 0 5

Write Access Enabled Enabled

Write Access Level 0 5

Download Application Enabled Enabled

Download Parameter File Enabled Enabled

Read ECU History Enabled Enabled

Application Log Access Enabled Disabled

App Log Statistics Access Level 0 N/A

App Log Errors Access Level 0 N/A

App Log Others Access Level 0 N/A

Danfoss reserves the right to change these settings at anytime without notice.

Application Security

Strategy

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 7

PLUS+1 License Terminology

PLUS+1 License

Administration Tool License

The PLUS+1 License Administration Tool license determines the number of licenses that can be

created using the license administration tool. It is possible to use multiple licenses with the tool so the

number of licenses managed can be extended at any time.

License Information

Callout Item Description

1 License ID This cannot be changed and is provided for information only.

ID is generated automatically by the license administration tool.

2 Sub ID This cannot be changed and is provided for information only.

ID is generated automatically by the license administration tool.

3 License Expires Start Date

This is the date from which the license will be active. The default is

today. Values can be set in the future so that a license will only

become active from the future date.

Expire Date

This is the date from which the PLUS+1 License will no longer work.

4 Download Application Files If this box is unchecked then the user will not be able to download an

application to any hardware.

If this box is checked then the user will be able download an

application to hardware.

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 20138

Callout Item Description

5 Download Read Only

Parameter Files

PLUS+1 Parameter Files are used to store Read Only parameter values

that are used by an application.

If this box is unchecked then the user will not be able to download a

parameter ﬁle to any hardware.

If this box is checked then the user will be able download a parameter

ﬁle to hardware.

6 Access Level The Access Level is a number between 0 and 9. The highest level of

access is zero and the most restrictive is 9. The application developer

determines the access level for every signal and parameter in the

PLUS+1 GUIDE.

If a signal is given an access level of 5 and the user has an access level

of 6, 7, 8 or 9 then the user will not be able to see the signal. If the user

has an access level between 0 and 5 then the signal can be viewed.

Read Access—Checkbox If this box is unchecked then the user will not be able to read any

signals or parameters from any hardware.

If this box is checked then the user can read signals given the relevant

access level.

Read Access—Level Sets the read access level for this license.

Write Access—Checkbox If this box is unchecked then the user will not be able to write any

parameters from any hardware.

If this box is checked then the user can write signals given the relevant

access level.

Write Access—Level Sets the write access level for this license.

7 ECU History Access If this box is unchecked then the user will not be able to read the ECU

history.

8 Application Log Access If this box is unchecked then the user will not be able to read any

Application Log ﬁles from any hardware.

Error Level Sets the application log error access level for this license.

Statistics Level Sets the application log error access level for this license.

Other Level Sets the application log error access level for this license.

9 Toolkey Clicking the Toolkey button opens the dialog where a toolkey

together with a text description may be added. Up to three toolkeys

can be added to the license.

See the Application Security Strategy, page 5 through 6, for further

details on the use of the toolkey and access levels.

Toolkey Only If this box is checked then the user will only be able to access

hardware running PLUS+1 applications with toolkey.

10 Activate/Deactivate Toolbar

Button

This is used to make a license active or inactive.

When licenses are no longer needed it is not desirable to delete them

from there database, as the trace information will be lost.

11 Optional User Information This optional user information can be used by the License

Administrator to ease the management of licenses. The information is

not included in the license key:

Company This is the name of the company the user belongs to.

The data is taken from the user ID ﬁle but it can be amended when

the license is created.

First Name/Last Name This is the name of the user.

The data is taken from the user ID ﬁle but it can be amended when

the license is created.

Street / City / State / ZIP /

Country

This is the address of the user.

E-mail This is the e-mail address of the user.

License Information

(continued)

PLUS+1 License Terminology

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 9

Using the PLUS+1 License

Administration Tool

Installation

2. A message box appears with the option to launch the License Manager.

3. The License Manager can also be launched from the Tools menu.

4. Click Help in the License Manager for information on how to install and activate your license.

Creating New License 1. Click the New button on the toolbar of License Manager.

Run the PLUS+1 License Administration Tool installation program.

1. Start the tool by clicking on the PLUS+1 License Administration Tool icon.

Creating Licenses Overview It is recommended that the PLUS+1 License Terminology, page 7 through 8 of this document be

reviewed before proceeding with the following lessons.

2. Amend the Start date and Expire date as required. Uncheck License Expires to make the license

perpetual.

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 201310

3. Set the security settings appropriately.

4. Enter optional user information.

5. If a toolkey has to be entered click the Toolkey button to open the dialog screen:

Creating New License

(continued)

6. Click the Add button to add a Key together with a Description to make the management of the

toolkeys easier. Then click OK.

7. Click the Save button on the toolbar to save the license ﬁle into the license database.

8. The license key is available in the license key ﬁeld. Click Copy To Clipboard to copy the license key

to the Windows clipboard.

Editing Existing License 1. Select the license to be edited in the License Manager list box.

2. Click the Edit button on the toolbar.

3. Make any necessary changes to the license.

4. When the changes are complete click the Save button on the toolbar.

5. The license key is available in the license key ﬁeld. Click Copy To Clipboard to copy the license key

to the Windows clipboard.

Copying Existing License 1. Select the license to be copied in the License Manager list box.

2. Click the Copy button on the toolbar.

3. Follow the procedure for Creating New PLUS+1 License, page 9 through 10.

Using the PLUS+1 License

Administration Tool

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 11

Deactivating or Activating

License

1. Select the License Manager list box.

2. Click the Deactivate/Activate button on the toolbar.

Finding User 1. Click the Find User button on the toolbar.

2. Enter ﬁlter information and the Search results will be updated automatically.

3. Select a license under Search results and click OK to jump to the license.

Importing 4.x Licenses 1. Select Tools/Import 4.x licenses… from the PLUS+1 License Administration Tool menu.

2. Make a backup of license database in the installation folder as needed and click OK to continue.

Using the PLUS+1 License

Administration Tool

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 201312

Importing 4.x Licenses

(continued)

3. Click Browse… and select the location of the 4.x License Administration Tool folder.

4. Check Import expire dates to import start and expire dates for 4.x Licenses. Leave this setting

unchecked to import the licenses without an expiry date.

5. Click OK to start the import.

Exporting License Data 1. Select Tools/Export License Data… in the menu to export license data to a CSV ﬁle.

2. Select which data ﬁelds to include in the export ﬁle.

3. Select the delimiter for the CSV ﬁle.

4. Click OK to continue.

5. Select a ﬁlename for the export ﬁle.

6. Click OK to start the export.

Using the PLUS+1 License

Administration Tool

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 13

Notes

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 201314

Notes

User Manual PLUS+1® License Administration Tool

L1028388 • Rev CA • Oct 2013 15

Notes

Comatrol

www.comatrol.com

Schwarzmüller-Inverter

www.schwarzmueller-

inverter.com

Turolla

www.turollaocg.com

Valmova

www.valmova.com

Hydro-Gear

www.hydro-gear.com

Daikin-Sauer-Danfoss

www.daikin-sauer-danfoss.com

Danfoss Power Solutions is a global manufacturer and supplier of high-quality hydraulic and

electronic components. We specialize in providing state-of-the-art technology and solutions that

excel in the harsh operating conditions of the mobile o -highway market. Building on our extensive

applications expertise, we work closely with our customers to ensure exceptional performance for a

broad range of o -highway vehicles.

We help OEMs around the world speed up system development, reduce costs and bring vehicles to

market faster.

Danfoss – Your Strongest Partner in Mobile Hydraulics.

Go to www.powersolutions.danfoss.com for further product information.

Wherever o -highway vehicles are at work, so is Danfoss.

We o er expert worldwide support for our customers, ensuring the best possible solutions for

outstanding performance. And with an extensive network of Global Service Partners, we also provide

comprehensive global service for all of our components.

Please contact the Danfoss Power Solution representative nearest you.

Products we o er:

 Bent Axis Motors

 Closed Circuit Axial Piston

Pumps and Motors

 Displays

 Electrohydraulic Power

Steering

 Electrohydraulics

 Hydraulic Power Steering

 Integrated Systems

 Joysticks and Control

Handles

 Microcontrollers and

Software

 Open Circuit Axial Piston

Pumps

 Orbital Motors

 PLUS+1® GUIDE

 Proportional Valves

 Sensors

 Steering

 Transit Mixer Drives

Local address:

Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed material. Danfoss reserves the right to alter its products without notice. This also applies to products

already on order provided that such alterations can be made without subsequential changes being necessary in speciﬁcations already agreed.

Danfoss

Power Solutions

22F, Block C, Yishan Rd

Shanghai 200233, China

Phone: +86 21 3418 5200

Danfoss

Power Solutions GmbH & Co. OHG

Krokamp 35

D-24539 Neumünster, Germany

Phone: +49 4321 871 0

Danfoss