Danfoss MCXShape User guide

User manual

MCXShape - The easiest way to get control

of your HVAC/R system

One software to conﬁgure and optimize any HVAC/R application

www.danfoss.com/mcx

User manual | MCXShape standard software

Index

1.0 General overview 4

2.0 Installation 5

3.0 File menu 6

4.0 View menu 10

5.0 Tools menu 11

5.1 Launch MyK Manager 11

5.2 Edit languages (advanded) 11

5.3 Import language ﬁle… 12

5.4 Export language ﬁle… 12

5.5 Export menu structure 13

5.6 Project Options 13

5.7 Gateway Conﬁguration 14

5.8 Edit EDF settings 15

5.9 Edit measurements units 16

5.10 Edit VR function (advanced) 16

5.11 Edit I/O types (advanced) 16

6.0 Application data 17

7.0 Tabs description 18

7.1 Compile & Upload 18

7.2 Menu & Parameters 19

7.3 Alarms: 27

7.4 Digital input 29

7.5 Analog input 30

7.6 Digital output 31

7.7 Analogue output 32

7.8 Application strings 33

7.9 Functionalities 33

7.10 Enum 33

8.0 EDF ﬁle generation for connection with SC355/SM850 34

8.1 Tools Menu 34

8.2 Edit XML Tags 36

8.3 Edit EDF menu 37

8.4 Find in the EDF menu 38

8.5 Edit parameter properties in EDF menu 38

8.6 Menu & Parameters tab 39

8.7 EDF generation 39

9.0 CDF ﬁle generation 39

7.2.1 Menu & Parameters – Tree View 19

7.2.2 Menu & Parameters – Grid View 24

DKRCC.PS.RJ0.E4.02 | 2

User manual | MCXShape standard software

Table of new contents:

Manual Version

V E2 V2.01

V E3 V3.06 All chapters have been changed for consistency with

E4 This version

MCXShape Software Version

V4.01 All chapters have been changed for consistency with

New Contents

MCXShape v3.0x.

MCXShape v4.0x Updated the EDF generation

DKRCC.PS.RJ0.E4.02| | 3

User manual | MCXShape standard software

1.0 General overview

MCXShape is the tool used to conﬁgure the software application for downloading in the MCX programmable control.

You can use this conﬁguration tool to deﬁne the model of MCX, the structure of the user interface menu, the default values for each parameter, the alarms set and actions, the I/O conﬁguration, the interface languages and much more.

Moreover, by using MCXShape you can compile the software application, execute the Simulator software and download the software application in the MCX controller via serial communication or by copying it to the MyK memory (see MMIMYK Programming module – 080G0073).

Note that when MCXShape is used within the MCXDesign environment, some functionalities may be hidden.

DKRCC.PS.RJ0.E4.02 | 4

User manual | MCXShape standard software

2.0 Installation

The name of the installation ﬁle is MCXShapeSetup.exe.

To install the program on your PC, execute the ﬁle, follow the installation instruction and select your preferred options.

At the end of the installation you can run the tool using the icon on the desktop or from the program menu.

DKRCC.PS.RJ0.E4.02| | 5

User manual | MCXShape standard software

3.0 File menu

New Project (advanced):

to start a new empty project. Active only in combination with MCXDesign

Open:

the function to load the conﬁguration ﬁle The conﬁguration ﬁle is located in the root of the software application. Its extension is MCXS.

NOTE: If the .MCXS ﬁle that you are opening has been created with an older version of MCXShape, the following panel will appear.

You can choose to convert this ﬁle to the new version 4.x of MCXShape or continue to work with the previous version

Remember that you cannot use an old version of MCXShape to open a ﬁle already imported into the new version.

If you do choose to convert the ﬁle to the new version, a backup ﬁle will be saved in the MCXShape old version format.

Save:

to save the conﬁguration in the original MCXS ﬁle

Save as:

to save the conﬁguration in a new MCXS ﬁle

Recent projects:

to easily access recent projects

DKRCC.PS.RJ0.E4.02 | 6

User manual | MCXShape standard software

Print:

to print all of the project data (Variable List), the parameters with or without the Modbus address, Input/Output conﬁguration, alarms, status variables, enumerations (an enumeration is a string associated with the value of a parameter, e.g. NO=0, YES=1)

Print Enum List: For an explanation of the Enumeration elements listed in the UNIT column of a Print Report, you can use the report generated by Print Enum List.

See, for example, E nu m 11 in the two images below where the ﬁrst has been generated with the Print Parameter List command.

DKRCC.PS.RJ0.E4.02| | 7

User manual | MCXShape standard software

Merge:

The merge function is useful for importing a parameter conﬁguration from an old MCXS ﬁle into a new one.

The merge function is most commonly used to import a conﬁguration already set for one application into the conﬁguration ﬁle of the newest version of the application.

The procedure for using the merge function is as follows:

• Open the new MCXS ﬁle.

• Verify the name ﬁled in the application data: it must be the same for both new and old ﬁles.

• Select the merge function from the File menu and set the appropriate merge options as necessary. Using the default basic options, the parameter values of the old ﬁle will overwrite the parameter values of the new ﬁle. Usually this is all that you need to do. However, in the Merge Options you can select other attributes for merging:

Level: to import the access level for menus and parameters from the old ﬁle

Enabled: to import the “enabled” attribute from the old ﬁle

Visibility: to import the visibility conditions from the old ﬁle

RW or Read Only: to import the R/W attribute from the old ﬁle

Modbus Address (in development): to import the Modbus addresses from the old ﬁle and maintain compatibility with other devices which refer to these addresses.

DKRCC.PS.RJ0.E4.02 | 8

User manual | MCXShape standard software

The descriptions of the parameters remain the same in the new ﬁle unless one of the advanced options is selected. These can be used to import the following from the old ﬁle: the menu dictionary, the parameters dictionary, the alarms dictionary, the strings dictionary and the I/O dictionary.

NOTE: Select these options only if you want to overwrite the descriptions in the new ﬁle with the descriptions from the old ﬁle (not recommended).

• Click on the “Load File…” button to select the old ﬁle and then click on the Apply button.:

Import external data … (advanced)

Reserved

DKRCC.PS.RJ0.E4.02| | 9

User manual | MCXShape standard software

4.0 View menu

The View menu is useful for customising the way data appears in MCXShape.

Show/Hide column..:

to select a column to display. This is enabled only when the Menu & Parameters tab is selected

Show multilanguage columns: to enable/disable the visualisation of the multilanguage columns on the right side of the workbench

Show unused params grayed out: to grey out parameters not used and simplify the visualisation. Parameters are not used when their visibility condition are not true or when the related functionality is not enabled.

Hide unused params: to hide parameters not used and simplify the visualisation. Parameters are not used when their visibility condition is not true or when the related functionality is not enabled.

Show locked parameters: to highlight special parameters

Show compile result: to show the report at the end of the compiling process. In this report you can ﬁnd the used and available value for each type of memory.

Enable developer mode: to enable the viusalization of advanced menu for developers (hereafter “advanced”).

Close MCXShape to get back to normal mode.

DKRCC.PS.RJ0.E4.02 | 10

User manual | MCXShape standard software

5.0 Tools menu

5.1 Launch MyK Manager

Launch MyK Manager to start the MyK Manager tool (see the MyKManager Manual).

5.2 Edit languages (advanded)

This is used to manage project languages. Here you can deﬁne the font for each language (advanced), change the order of the languages using the Up and Down buttons and add a new language or remove an existing one.

The available font ﬁles are in your project’s bin folder; for each font there are a couple of ﬁles with BIN and DEF extensions. The structure of the font ﬁle name is font_XX, where XX = WE for Western Europe, EE for Eastern Europe, RU for Russia etc.

For each language you must specify the name of the .BIN font ﬁle to be used. A .DEF ﬁle name can be omitted if equal to .BIN.

DKRCC.PS.RJ0.E4.02| | 11

User manual | MCXShape standard software

5.3 Import language ﬁle…

This is used to import the application vocabulary from the special Excel ﬁle used for the translation. The Excel ﬁle will have been created previously by the Export language ﬁle option.

5.4 Export language ﬁle…

This is used to export all the application vocabulary of the selected languages in an Excel ﬁle. This option is used to facilitate the translation of all the strings present in the user interface of the application.

A pop-up window allows you to select the language you want to export:

Here is an example of the .XLS ﬁle that is generated:

To the right of each language you can ﬁnd a number representing the number of characters still available before reaching the maximum number generally allowed by standard applications. This is only a guide, as the eﬀective number is deﬁned by the application and may change accordingly. The number is typically 21 characters (1 line on the MMIGRS2 user interface) for menus and 42 characters (2 lines) for parameters and alarms.

DKRCC.PS.RJ0.E4.02 | 12

+ 28 hidden pages