Danfoss MCXWeb User guide

Download

User Guide

Easy and fast

Apply the MCXWeb tool with your MCX

To ensure that you correctly install your MCXWeb please follow this user guide

www.danfoss.com/mcx

User Guide | MCXWeb

Table of Contents

1. Introduction ........................................................................................... 3

2. MCXWeb components ....................................................................... 3

3. MCXWeb connections ........................................................................ 5

4. Web Server and MCX Update...........................................................6

4.1 Web server ﬁrmware update (xport) .................................. 6

4.2 Web Server software interface update (Web pages) ..... 6

4.3 MCX061V-MCX152V BIOS Update ...................................... 7

4.4 MCX061V-MCX152V Software Application Update ....... 7

5. Web Server User Guide ....................................................................... 8

5.1 Login ............................................................................................... 8

5.2 Main buttons ............................................................................... 9

5.3 Network Overview (home page) ........................................ 10

5.4 History .......................................................................................... 10

5.5 Alarms ..........................................................................................11

5.6 Conﬁguration ............................................................................11

5.6.1 Conﬁguration network ................................................12

5.6.2 Conﬁguration Template & Files ................................13

5.6.2.1 Create the application template

with MCXShape ............................................................ 14

5.6.3 Conﬁguration Users .....................................................15

5.6.4 Conﬁguration System ..................................................15

5.6.4.1 Network .............................................................. 15

5.6.4.2 NTP ....................................................................... 16

5.6.4.3 Site ........................................................................ 16

5.6.4.4 Reboot ................................................................17

5.6.5 Conﬁguration Update ................................................18

5.6.5.1 Application Update ........................................18

5.6.5.2 BIOS Update ...................................................... 18

5.6.6 Conﬁguration History .................................................. 19

5.7 Device pages..............................................................................20

5.7.1 Device Overview ........................................................... 20

5.7.1.1 Customization of the Overview page ...... 21

5.7.2 Device Details ................................................................. 22

5.7.3 Device Alarms .................................................................23

5.7.4 Device Graphs ................................................................ 23

5.7.5 Device Back-up ..............................................................24

5.7.6 Device Restore ...............................................................24

5.7.7 Device Info ....................................................................... 25

6. MCXWeb Simulator ...........................................................................26

7. Appendix - Application template XML structure ....................28

User Guide | MCXWeb

1. Introduction

2. MCXWeb components

MCXWeb is the online tool used to monitor software applications running into one or more MCX devices connected in a CANbus network. To monitor MCX devices using the MCXWeb you will need to have at least one MCX061V or MCX152V device in the CANbus network, as these are the MCX models that supports Web Server and an Ethernet connection.

The MCXWeb tool can also be used as a simulator for MCX software applications running on a PC for testing and debugging.

IMPORTANT NOTE. You can use MCXWeb with popular browsers like Chrome, Firefox, and Safari. Using it with Internet Explorer is not recommended.

This manual refers to the following ﬁrmware version or later: Web Server interface: 2v08 Web Server ﬁrmware: 2v23 MCX061V-MCX152V BIOS: 2v22

1. MCX061V and MCX152V are the MCX models with Web Server included. Like all other MCX models, MCX061V and MCX152V are ﬁtted with a BIOS and can run application software.

2. Web Server is the software tool included with MCX061V and MCX152V, providing the user with web pages that are displayed on a browser on remote PCs (6). This service needs the following two software elements: Web Server ﬁrmware (xport BIOS) and software interface (web pages).

- The Web Server ﬁrmware is the ﬁle xport_pro.romz

MCX061V and MCX152V are provided with Web Server’s ﬁrmware already installed and should be upgraded only in case of special needs (see Paragraph 4.1 Web Server ﬁrmware update). The ﬁles needed to upgrade Web Server’s ﬁrmware (BIOS) are included in the MCXWeb update pack available at http://www.danfoss.com/mcx

DKRCC.PS.RI0.Z1.02 | 3

User Guide | MCXWeb

- The software interface is the set of the ﬁles in the following folders present in the root of the server:

The MCX061V and MCX152V are provided with the Web Server software interface already installed and should be upgraded only in case of special needs (see paragraph

4.2 Web Server software interface update). All the ﬁles needed to upgrade Web Server’s software interface are included in MCXWeb update pack available at http://www.danfoss.com/mcx

The Web Server software interface includes the folders containing web pages and additional ﬁles, for example, the software applications and templates used to conﬁgure the MCX present in the MCX CANbus network. The conﬁguration ﬁles should be added or upgraded every time a new MCX device is added to the CANbus network or when there is an upgrade in the MCX ﬁrmware or software (see Paragraph 5.6.1, Conﬁguration Network).

3. A memory card is a hardware component used to upgrade the ﬁrmware and software of Web Server and of the MCX, and to store log data.

4. MCX devices can be connected via CANbus to the MCX061V and MCX152V, which can

be used as web interfaces for all the MCX present in the CANbus network. Each MCX is provided with its ﬁrmware (BIOS) and software application. MCX061V and MCX152V must be conﬁgured with a template ﬁle for each MCX connected, representing the list of variables involved in the communication.

5. A router is a device that connects MCX Web Server to the Internet

6. Remote PCs are the computers where MCXWeb pages are displayed through popular

browsers like Chrome, Firefox, and Safari. Using Internet Explorer is not recommended.

User Guide | MCXWeb

3. MCXWeb connections

To start using MCXWeb, the ﬁrst step is identifying the MCX061V or MCX152V in the local network supporting the web server. There are two alternative options.

1) Enter in the BIOS menu of MCX061V or MCX152V by pressing and releasing the X and ENTER key at power up. Conﬁgure the TCP/IP settings by navigating to the “GEN SETTINGS” – “TCP/IP” screen. You can manually assign the IP address or get it dynamically from the network via DHCP.

2) Realize a small local network as in Figure

LAN

MCX061V/MCX152V

IP = Auto

(DHCP enabled by factory default)

Ethernet Router

Server DHCP=ON

LAN

IP = Auto

(DHCP)

Run the Gateway Finder program available at http://www.danfoss.com/mcx to ﬁnd the IP address of your MCX061V or MCX152V:

Using the Gateway Finder you get the IP address and MAC addresses of any MCX061V or MCX152V connected to the LAN.

You can then establish a connection with MCX Web Server through a web browser or an FTP client. For the description of the web pages accessible through the web browser, see Paragraph 5, Web Server User Guide. The FTP client is used to update the web server elements when needed. See Paragraph 4, Web Server and MCX Update.

DKRCC.PS.RI0.Z1.02 | 5

User Guide | MCXWeb

4. Web Server and MCX Update

To update Web Server’s elements, use a FTP client. We suggest using FileZilla. See Paragraph 3, MCXWeb Connection on how to establish a connection. The parameters to conﬁgure the FTP client are as follows:

Host: MCX IP Address (e.g. 192.168.1.xxx) Username: admin (Username is case sensitive) Password: PASS (Password is case sensitive)

4.1 Web Server Firmware Update (xport)

4.2 Web Server Software Interface Update (web pages)

Establish the FTP connection with MCX Web Server as described in Paragraph 3, MCXWeb connection.

To update MCX Web Server’s ﬁrmware, copy the ﬁle xport_pro.romz in the root of MCX Web Server. The update procedure starts automatically after copying the ﬁles. NOTE. The ﬁle will be automatically removed during the process.

WARNING: DO NOT power oﬀ the MCX061V/MCX152V for 2 minutes after the update.

If you have executed the Web Server ﬁrmware update as described in the previous paragraph, wait two minutes from the start of that procedure before proceeding with the Web Server software interface update.

To update the Web Server software interface, you will need the MCXWeb update pack available at http://www.danfoss.com/mcx.

- Establish the FTP connection with MCX Web Server as described in Paragraph 3, MCXWeb connection.

- Remove all the ﬁles and folders present on MCX Web Server

- Copy all the following folders, which the software interface is made of, in the root of MCX Web Server.

WARNING: do not copy the Web Server ﬁrmware (romz ﬁle) with the software interface ﬁles, otherwise the ﬁrmware update process will start (see the previous paragraph) and the web pages will not be updated. If this happens, you must copy the folder of the wep pages in the root of the MCX Web Server again two minutes after copying the ﬁrmware update.

WARNING: after an update operation, MCX Web Server may automatically run a defrag operation to optimize space and performance; this operation makes the MCX Web Server inaccessible for few minutes without any visible signal.

User Guide | MCXWeb

4.3 MCX061V-MCX152V BIOS Update

4.4 MCX061V-MCX152V Software Application Update

The update for the MCX061V-MCX152V BIOS follows the same procedure of all the other MCX models. You can update via the CANbus using the MMYMYK or via serial communication using a PC and a USB/485 converter. In addition to the usual options, with MCX061V and MCX152V it is also possible to update the BIOS via memory card and via web pages.

To update the BIOS via memory card, the procedure is as follows:

- copy the ﬁle mcx061v.bin or mcx152v.bin (the name is case sensitive) in the root of a memory card

- switch oﬀ the MCX061V or MCX152V

- insert the memory card into the MCX slot

- switch on the MCX

The BIOS updating procedure will start automatically and the MCX display will show the BIOS splash screen.

To update the BIOS via the web, follow the instructions in Paragraph 5.6.5.2, BIOS Update. You can also update the BIOS of the MCX connected through CANbus to the MCX061VMCX152V using web pages.

The ﬁle needed to upgrade the BIOS is available in the BIOS pack at http://www.danfoss.com/mcx

Updates to the application software running on MCX061V or MCX152V follow the same procedure as all other MCX models.

You can update via the CANbus using the MMYMYK or via serial communication using a PC and a USB/485 converter. In addition to the standard update methods, MCX061V and MCX152V can also be updated using an application, a memory card and web pages.

To update the application software via memory card, the procedure is as follows:

- copy the ﬁle app.pk (the name is case sensitive) in the root of a memory card

- switch oﬀ the MCX

- insert the memory card into the MCX slot

- power on the MCX.

The application will be automatically copied from memory to the MCX061V or MCX152V and executed.

To update the application software using the web pages, follow the instructions in Paragraph

5.6.5.1, Application Update. When updating with web pages, you can also update the MCX’s

application software connected through the CANbus to the MCX061V-MCX152V.

DKRCC.PS.RI0.Z1.02 | 7

User Guide | MCXWeb

5. Web Server User Guide

5.1 Login

Launch an internet browser from the PC connected to the local network and type the IP of the MCX061V or MCX152V (see Paragraph 3, MCXWeb Connection) in the address bar.

WARNING. You can use popular browsers like Chrome, Firefox, and Safari. Using Internet Explorer is not recommended.

Enter your user name and password to log in to the MCXWeb interface User name and password are deﬁned in Conﬁguration > Users. By default, they are admin and PASS.

If you are using a virtual keyboard (e.g. for touch screens) check the box beside the keyboard icon under the password ﬁeld

User Guide | MCXWeb

5.2 Main Buttons

The main buttons can be found at the top right of all the MCXWeb pages after login.

They are used for:

Back to home page (Network Overview)

Back to login page

Site information:

Version of the MCXWeb software interface Version of the Web Server ﬁrmware in the MCX061V – MCX152V Version of MCX061V-MCX152V BIOS Serial number of the MCX061V – MCX152V MAC address of the MCX061V – MCX152V License information

DKRCC.PS.RI0.Z1.02 | 9

User Guide | MCXWeb

5.3 Network Overview (home page)

The Network overview is used to list all the devices connected in the CANbus Network to the MCX061V-MCX152V. For each MCX device detected on the network, the following information is displayed:

• “Device Name” is the name deﬁned in Conﬁguration > Network

• “Node ID” is the CANbus address deﬁned in the BIOS of the MCX device

• “Active” displays the device status: A green dot means that the device is active (conﬁgured and connected) A yellow dot means that the device is not conﬁgured: the template (tem) ﬁle has not been associated with this device (see Paragraph 5.6.1, Conﬁguration Network). A grey dot means that the device is inactive and not connected.

If you click the line with the device you are interested in, you will enter the device speciﬁc pages. If the device is active, you will see the pages populated with live values (see Paragraph 5.7, Device Pages).

5.4 History

On this page you can graph historic data. Select the variables you want to display as a graph, the date and period and then select Draw.

You can use the mouse wheel to zoom in and out of the graph and the arrows on the bottom right corner to move the graph’s time period back and forward. The graph may also display events (yellow ﬂags); use the mouse to click a ﬂag to view additional information on the relevant event.

Press Export to export history data in CSV format.

User Guide | MCXWeb

5.5 Alarms

5.6 Conﬁguration

This page displays the list of the alarms active in all the devices connected to the CANbus network.

The Conﬁguration menu is used to conﬁgure items under the following headers: Network, Template, Users, System, History. Is also used to update the software (application) and ﬁrmware (BIOS) of the devices. The conﬁguration menu is visible only to users with service or admin access levels.

DKRCC.PS.RI0.Z1.02 | 11

User Guide | MCXWeb

5.6.1 Conﬁguration Network

This page shows which devices are connected in the CANbus network. You can also manually add new devices by pressing the Add button and setting the ID (CANbus address) of the device to be added. For each device in the list you must specify the description (free text) and the application template. The application template is a ﬁle with a tem extension containing the description of variables and parameters of the software application running in the MCX device. Templates must be 1) created, 2) loaded and 3) associated

The template is associated to the device through the combo menu in the Application column. This combo menu is populated with all the tem ﬁles created with MCXShape and transferred into the MCX061V-MCX152V following the instruction in the next paragraph. Use the special entry “HIDDEN NODE” if you want to hide some nodes in the network overview or if they do not have a template. This is typically used for nodes such as User Interfaces (e.g. MMIGRS) or Accessories (e.g. MMIMYK) Press Save to save the changes.

After the tem association, in the “Network Overview” page the device status changes from Unconﬁgured to Active.

User Guide | MCXWeb

5.6.2 Conﬁguration Template & Files This page is used to load the templates of the software applications running on the MCX061V-MCX152V and other MCX connected to it into the MCX061V-MCX152V. See the next paragraph for how to create a template.

The templates are loaded in the “apps” folder in the MCX. You can also load them here via FTP:

Then the template must be associated to the MCX where the application software described by that template is running (see the previous paragraph).

DKRCC.PS.RI0.Z1.02 | 13

User Guide | MCXWeb

5.6.2.1 Create the application template with MCXShape

Before creating the template, use MCXShape to conﬁgure the MCX software application according to your needs. Then enable the generation of the template ﬁle from MCXShape. Go into the Tools-Gateway Conﬁguration menu in MCXShape and select the “Enable Saving Web File” check box.

The template ﬁle of the MCX software application has the tem extension and it is created during the “Generate and Compile” procedure. The tem ﬁle is saved in the folder “MCXWeb\apps\” in the root of the software application.

User Guide | MCXWeb

5.6.3 Conﬁguration Users This lists all the users that can access to the MCXWeb interface. There are four possible levels of access: guest, maintenance, service and admin. These levels correspond to the levels assigned in the device template by the MCXShape tool. Note that you can see only the users with the level equal or lower than the one you logged in.

Select the "Mail Alarm" and "Mail Warning" check boxes to send notiﬁcation emails to the speciﬁed addresses when alarms and warnings occurs in any device present in the CANbus network. The destination email address is set in the Email column. See Paragraph 5.6.4.3, Site, on how to set the SMTP mail server.

5.6.4 Conﬁguration System

5.6.4.1 Network This page is used to conﬁgure the MCXweb inside the local network to which it belongs.

You can manually assign a static IP address (DHCP disabled) or a dynamic address via the dynamic host conﬁguration protocol. If DHCP is enabled, the IP address of the MCXweb device will be automatically assigned by the DHCP server. If the DHCP is not enabled, the network setting (IP Default Gateway, Primary DNS and Secondary DNS) must be manually conﬁgured

You can also set the HTTP port.

DKRCC.PS.RI0.Z1.02 | 15

User Guide | MCXWeb

5.6.4.2 NTP Conﬁgure the NTP (network time protocol)

Set the NTP server you wish to syncronize with. The MCX061V or MCX152V real time clock will then be synchronized and set according to the deﬁned timezone and daylight saving time. Daylight Saving Time:

- OFF: deactivated

- ON: activated

- EU: Start=2nd Sunday of March – End=1st Sunday of November

- US: Start=Last Sunday of March – End=Last Sunday of October

WARNING. The time synchronization of the MCX connected via CANbus to the MCXWeb is not automatic and must be performed by the application software.

5.6.4.3 Site Set the Site Conﬁguration used when users are notiﬁed of alarms and warnings by email. The destination email address is speciﬁed when conﬁguring the Users.

Site Name is name of the site used in the alarm email message. Email Domain is the name of the simple mail transfer protocol (SMTP) server that you want to use. Email Address is the email address of the sender. For the Email Port and Mode, refer to the conﬁguration of the SMPT Server. Unauthenticated and SSL or TLS connections are managed. For each mode, the usual port is automatically proposed but you can manually change it afterwards.

Example of email sent by MCXWeb:

User Guide | MCXWeb

The Test Email Address is the address to which an email can be sent to test your settings. In the event of a problem you will receive one of the following error codes:

ERROR CODE

50 MAIL_FAIL_LOADING_CA_ROOT_CERTIFICATE Contact Danfoss Product Support

51 MAIL_FAIL_LOADING_CLIENT_CERTIFICATE Contact Danfoss Product Support

52 MAIL_FAIL_PARSING_KEY Contact Danfoss Product Support

53 MAIL_FAIL_CONNECTING_SERVER There is no connection with the mail

54 MAIL_FAIL_SSL_CONFIG_DEFAULT Contact Danfoss Product Support

55 MAIL_FAIL_SSL_CONF_OWN_CERT Contact Danfoss Product Support

56 MAIL_FAIL_SSL_SETUP Contact Danfoss Product Support

57 MAIL_FAIL_SSL_SET_HOSTNAME Contact Danfoss Product Support

58 MAIL_FAIL_HANDSHAKE Contact Danfoss Product Support

59 MAIL_FAIL_GET_HEADER_FROM_SERVER Contact Danfoss Product Support

60 MAIL_FAIL_EHLO Contact Danfoss Product Support

61 MAIL_FAIL_START_TLS TLS mode is not supported by the

62 MAIL_FAIL_AUTHENTICATION Authentication failed.

63 MAIL_FAIL_WRITING Authentication was successful, but

DESCRIPTION ACTION

server. Check the Email Domain and Email Port settings. Also check Network Settings and the physical connection

mail server. Check the Email Mode setting.

Check the Email Address and Email Password settings

something went wrong later. Retry. If the problem persists, contact Danfoss Product Support

5.6.4.4 Reboot Pressing the reboot button restarts the system. This button is normally used after applications (software) and BIOS (ﬁrmware) update.

DKRCC.PS.RI0.Z1.02 | 17

User Guide | MCXWeb

5.6.5 Conﬁguration Update

5.6.5.1 Application Update Copy the software application ﬁle, created with the MCXShape with the pk extension, into

The page is used to upgrade applications (software) and BIOS (ﬁrmware) The application is the ﬁle produced by the MCXShape tool with the pk extension; it is executed by the MCX and contains the control strategy and the user interface. The BIOS is the ﬁrmware pre-installed in the MCX control, so it is the ﬁrst code run at power on. To proceed with the application and BIOS update, follow these steps:

the MCX061V/MCX152V in one of these two ways (used in alternative):

1) From the Conﬁguration->Template & Files menu select the application ﬁle and upload it

2) Establish the FTP connection with the MCX Web Server as described in paragraph 3 MCXWeb connection. Copy the application ﬁle into the folder “apps”

After the ﬁle upload, press F5 to refresh the web pages. From the Conﬁguration->Update page, select the Application tab and click with the mouse on the line of the device you want to update. Select from the combo menu which is showing all the pk ﬁles that you have loaded, the application to download into the device. Conﬁrm the update by pressing the Update button.

5.6.5.2 BIOS Update Copy the BIOS ﬁle with the bin extension into the MCX061V/MCX152V in one of these two ways (used in alternative):

1) From the Conﬁguration->Template & Files menu select the BIOS ﬁle and upload it

2) Establish the FTP connection with the MCX Web Server as described in paragraph 3

MCXWeb connection. Copy the BIOS ﬁle into the folder “apps” After the ﬁle upload, press F5 to refresh the web pages. Select the BIOS tab from the Conﬁguration > Update menu and click the line of the device you want to update.

Select the BIOS to be downloaded into the device from the combo menu. Conﬁrm the update by pressing the Update button. If there is the appropriated BIOS (bin ﬁle) for the MCX model selected in the MCXWeb server app folder, the BIOS update procedure is started, otherwise the “File not found” message will be displayed.

User Guide | MCXWeb

5.6.6 Conﬁguration History

Deﬁne the variables to be shown in a graph (max 32) in the History pages. You must deﬁne:

• Node to which the variable belongs. WARNING. It is possible to plot a graph of data only from the MCX061V or MCX152V where the web server is running, therefore you must select only this node.

• Parameter: variable to view in the History page. All the variables deﬁned in the application software are listed but only the variables saved by application software must be selected. Please refer to the documentation of the speciﬁc application software.

• Color: deﬁnes the line color (hex code) in the graph in the History page.

• File: deﬁnes the ﬁle from which the variable value is taken, whether it is stored in the internal memory (0:/) or external memory card (1:/). Please refer to the documentation of the speciﬁc application software.

• Position: the position (column) of the variable in the ﬁle. Please refer to the documentation of the speciﬁc application software.

Example of software developed with MCXDesign:

DKRCC.PS.RI0.Z1.02 | 19

User Guide | MCXWeb

5.7 Device Pages

5.7.1 Device Overview The overview page is typically used to show the main application data.

From the home page, if you click on a speciﬁc device you will enter the device-speciﬁc pages.

The default page is empty.

By pressing the Manage button you can select the main parameters to display in this page.

When you have selected all the variables you need, press Save and you will see them on the Overview page

User Guide | MCXWeb

5.7.1.1 Customization of the Overview Page

This page can be customized with images and command buttons, by deﬁning the HTML page to be used as interface. The customized HTML page is placed in the /http folder of the MCX061V-MCX152V server. The name is DeviceOverview_applicationname.html where applicationname is the name of the application deﬁned in the MCXShape tool.

DKRCC.PS.RI0.Z1.02 | 21

User Guide | MCXWeb

5.7.2 Device Details This page gives you access to the diﬀerent parameters and variable values by navigating the menu tree.

When the parameters are displayed, you can check the current value, the unit of measurement and the minimum and maximum values for each of them. To change the current value of the parameter, click on it.

User Guide | MCXWeb

5.7.3 Device Alarms This page displays all the alarms active in the device.

5.7.4 Device Graphs This page lets you select the variables to populate the real-time graph.

Press “Change Selected”, navigate the menu tree and select the variable you want to display in a graph.

The period to display in the graph window can be conﬁgured in the range of 1 to 24 hours. Once variables and period have been selected, press the Draw button to start plotting the graph using the real-time variables value.

DKRCC.PS.RI0.Z1.02 | 23

User Guide | MCXWeb

5.7.5 Device Backup This page is used to save the current value of the parameters. It allows you to make a backup of your conﬁguration and to replicate the same conﬁguration in a diﬀerent device where the same software application is running. The parameters selected in this page (all by default) will be saved into the ﬁle speciﬁed in a dialog box.

5.7.6 Device Restore

By default, the ﬁle name is ID_Applicationname.bak, where ID is the address in the CANbus network and Applicationname is the name of the application running in the device. The backup ﬁle is saved in the /user folder in the MCX061V-MCX152V server.

This page contains all the backup ﬁles in the \user folder in the MCX061V-MCX152V server. Only the backup ﬁle created with the same application running in the current device will be accepted upon restoring. To start the restore process of the saved parameters, click the selected backup ﬁle.

If you select a backup ﬁle that is not compatible with the application running in the current device, you will stay in the previous page. Otherwise the following page will appear

User Guide | MCXWeb

Then deselect the parameters you do not want to restore and press “Restore conﬁguration” to start the process. A pop up window will show you the progress and ﬁnally a status report.

5.7.7 Device Info This page displays the following information relating to the current device: Application name and version BIOS version Serial number of the hardware

DKRCC.PS.RI0.Z1.02 | 25

User Guide | MCXWeb

6. MCXWeb Simulator

You can simulate the web interface of MCX061V-MCX152V with the Simulator in your MCXShape-based software application in the following way:

• Ensure you have the latest MCXWeb folder in the root of your application software:

• Enable the generation of the template ﬁle from MCXShape. Go into the Tools-Gateway Conﬁguration menu in MCXShape and select the “Enable Saving Web File” check box.

• Generate and compile

• Run the Simulator and press the Conﬁguration button: enable the MCXWeb simulation if not done already.

User Guide | MCXWeb

• A Web button will be displayed in the MCXSimulator to start the MCXWeb simulation.

• Press the Web button and the MCXWeb login page will be opened in your default web browser. Insert login (admin) and password (PASS) and you are ready to start. Pages will be populated with data from the simulator.

DKRCC.PS.RI0.Z1.02 | 27

User Guide | MCXWeb

7. 7 Appendix Application template XML structure

File name: /app/application_template_name.xml

XML structure:

<?xml version="1.0" encoding="UTF-8"?> <Template> <VarInfo> <AppName></AppName> <AppDescr></AppDescr> <AppCode></AppCode> <AppID></AppID> <AppVer></AppVer> <TemplateVer></TemplateVer> </VarInfo> <VarList> <Var> <VarCat></VarCat> <VarName></VarName> <VarAddr></VarAddr> <VarType></VarType> <VarLabel></VarLabel> <VarDescr></VarDescr> <VarBitMask></VarBitMask> <VarShift></VarShift> <VarScale></VarScale> <VarOﬀset></VarOﬀset> <VarDecimal></VarDecimal> <VarMax></VarMax> <VarMin></VarMin> <VarDefault></VarDefault> <VarAccess></VarAccess> <VarRW></VarRW> <VarVisibility></VarVisibility> <VarConstant></VarConstant> <VarEnumList><VarEnum> </VarEnum></VarEnumList> <VarGroupList> <VarGroup></VarGroup> </VarGroupList> <VarAlarmGroup></VarAlarmGroup> </Var> …. </VarList> <Template>

* <Var></Var> tag MUST be written in a single row with “\r\n” terminator.

User Guide | MCXWeb

Var tag structure:

Tag Description Notes

VarCat Var category 0 undeﬁned

1 parameter 2 DI /DO 3 alarms 4 status var

VarName Var identiﬁcation

VarAddr Modbus address Decimal representation

VarType Var type s16

u16 s32 u32

VarLabel Var label

VarDescr Var description Max 60 chars

VarBitMask Bitmark ﬁlter ( used for packed

alarms )

VarShift Number of right shift to applied

after VarBitMask's ﬁlter.

VarScale Scale to be applied to the value

returned from read var request

VarOﬀset Oﬀset to be applied to the value

returned from read var request

VarDecimal Number of decimals to be applied

to the value returned from read var request

VarMax Maximum value

VarMin Minimum value

VarDefault Default value

VarRW Read Only / Read-Write 0 read only

VarVisibility Is visible 0 hidde

VarConstant Is constant 0 editable

VarEnumList List of VarEnum tag VarEnum tags represents the list

VarGroupList List of VarGroup tag VarGroup tag sequence rep-

VarAlarmGroup

Alarms group Identiﬁer of alarms group.

32 bits bitmask

1 read write

1 visible

1 constant

of descriptions to be applied to the value returned from read var request.

resents the tree structure of groups.

The value is considered as bitmask of 32 alarms.

DKRCC.PS.RI0.Z1.02 | 29

DKRCC.PS.RI0.Z1.02 | MCXWeb| 30

Danfoss MCXWeb User guide

Specifications and Main Features

Frequently Asked Questions

User Manual

2. MCXWeb components

3. MCXWeb connections

4. Web Server and MCX Update

4.1 Web Server Firmware Update (xport)

4.3 MCX061V-MCX152V BIOS Update

4.4 MCX061V-MCX152V Software Application Update

5. Web Server User Guide

5.1 Login

5.2 Main Buttons

5.3 Network Overview (home page)

5.4 History

5.5 Alarms

5.6.2.1 Create the application template with MCXShape

5.6.4.1 Network This page is used to conﬁgure the MCXweb inside the local network to which it belongs.

5.6.4.2 NTP Conﬁgure the NTP (network time protocol)

5.6.4.3 Site Set the Site Conﬁguration used when users are notiﬁed of alarms and warnings by email. The destination email address is speciﬁed when conﬁguring the Users.

5.6.4.4 Reboot Pressing the reboot button restarts the system. This button is normally used after applications (software) and BIOS (ﬁrmware) update.

5.6.5.1 Application Update Copy the software application ﬁle, created with the MCXShape with the pk extension, into

5.6.5.2 BIOS Update Copy the BIOS ﬁle with the bin extension into the MCX061V/MCX152V in one of these two ways (used in alternative):

5.7 Device Pages

5.7.1 Device Overview The overview page is typically used to show the main application data.

5.7.1.1 Customization of the Overview Page

5.7.2 Device Details This page gives you access to the diﬀerent parameters and variable values by navigating the menu tree.

5.7.3 Device Alarms This page displays all the alarms active in the device.

5.7.4 Device Graphs This page lets you select the variables to populate the real-time graph.

5.7.6 Device Restore

5.7.7 Device Info This page displays the following information relating to the current device: Application name and version BIOS version Serial number of the hardware

6. MCXWeb Simulator