Gateway Unit Type X-Gate

1. Introduction

X-Gate is the new Danfoss gateway, designed to support and make easy the “Integration” activity at field level.

X-Gate can manage mainly two kinds of integrations:

• At south-bound level: Capability to read from electronic devices with different protocols: Modbus RTU, Modbus TCP/IP, BACNet IP, BACNet MS/TP, CANBus and translate into another protocol suitable for the integration at monitoring system level. Typical Modbus RTU.
• At north-bound level: Capability to read the Open XML protocol from System Manager 800A and expose the normalized data-points on different protocols: Modbus RTU or TCP/IP, BACNet IP for an "on top" BMS.

DISCLAIMER: Professional Use Only

This product is not subject to the UK PSTI regulation, as it is for supply to and use only by professionals with the necessary expertise and qualifications. Any misuse or improper handling may result in unintended consequences. By purchasing or using this product, you acknowledge and accept the professional-use-only nature of its application. Danfoss does not assume any liability for damages, injuries, or adverse consequences ("damage") resulting from the incorrect or improper use of the product and you agree to indemnify Danfoss for any such damage resulting from your incorrect or improper use of the product.

Use Cases Scenarios

Following the typical use-cases scenarios where X-Gate can fit:

X-Gate can provide flexibility with focus on 3rd party device integration into System Manager and at the same time make easy for a BMS to integrate the desired data-points over standard protocols.

2. Installation

2.1 First time configuration

For the installation phase of X-Gate please refer to the standard “Installation Guide" provided inside the packaging.

X-Gate has a Web User Interface, that can be accessed using standard browser.

The X-Gate starts in DHCP mode to be easily connected to an existing network. To discover the IP address of X-Gate in the network, User can plug an USB pen-driver and perform the following steps:

On your PC:

• Insert a USB memory stick.
• Make sure the USB stick is formatted as FAT or FAT32.
• Create an empty file in the root named node_info.txt.
• Unmount and remove the USB memory stick from your PC.

On your X-Gate:

• Power-up the X-Gate
• Insert the USB stick into the USB connector of the X-Gate.
• Wait about 10 seconds (X-Gate will write the information in automatic mode into the txt file).
• Remove the USB stick and insert into your PC

3. System Access

3.1 Login

The file node_info.txt will contain the basic information about the X-Gate. Here is an example of the content:

[node_info]
ip=10.16.176.86
mac_address=02:50:41:00:00:01
sw_descr=X-Gate v.1.10 (180628.1713)

The file contains information on IP and MAC-ADDRESS of X-Gate.

After got the IP address of X-Gate in the network, User can connect using browser by typing the following URL: http://10.16.176.86

If you connect direct to X-Gate to PC via ethernet cable on ETH2, you will find the X-Gate at IP address 192.168.2.101.

To access to the main configuration section of X-Gate, a login is required with User & Password. Default account is "admin" with default password "PASS". For security reason, after 3 attempts to enter a wrong password, X-Gate will lock access for 10 minutes. The default login credentials must be changed in User Configuration menu.

3.2 Network Overview

After first login, we strongly suggest changing default password to prevent unauthorized access. After login into the system, User can access to the configuration options according to the user-profile.

"Network Overview" is the landing page after login. It contains the list of the devices (Node) connected to X-Gate, plus the X-Gate itself.

3.3 Network Alarm

Network Alarm page contains the real-time alarms list of the X-Gate device. It can be used to troubleshooting in case of problems in the installation.

If parameter "G17 Enable alarm history" is enabled, an history of cleared alarms and other events will be kept into X-Gate.

The following events are recorded:

• Alarm start/end.
• Alarm acknowledges.
• Power-up
• Change of parameter
• Firmware updates
• Time change
• Security threat

3.4 Event Log

The event page traces the events of the X-Gate. User can save the event log list into a csv format.

4. User Configuration

4.1 User List

Accounts list can be accessed from the User Configuration page. By default, 4 users are available in the system: admin, Manufacturer, Service and User.

All the Accounts has a dedicated profile to have different visibility inside the X-Gate configuration page. Profiles available are Maintenance and Service.

The User Configuration page provides the following features:

• "Add User" button: To add a new user to the system.
• Delete "--" button: to delete the single user.
• "Save" button: to commit of the modification done.

5. Network Configuration

5.1 Device List

Device (Node) list can be accessed from the Network Configuration page. The default Device present is the X-Gate itself with his own configuration.

To add a new device, "Add Node" button that provides the information needed:

• Node Id: the serial address of the device
• Description
• Application: the device profile with the list of the data-points to read
• Protocol address: in case of TCP/IP protocol like Modbus, it is the IP address of the device itself.

Every time the User add or remove a device, he must be saved with the "Save" button.

6. X-Gate set-up

Enter in the "Network Overview" and access to the X-Gate main menu page.

6.1 Supervisor

This page contains the main parameters to set up the communication over serial line.

SU2 & SU3 are the configuration parameters for the serial line at COM1. SU4 is used to set up the speed over CANBus serial line (there is dedicated port for CANBus built-in into X-Gate). S10 is used to define which protocol must be used on the COM1 serial port. In case of extra RS485 module, parameter G35 must put at YES. An extra set of parameters can be set up: SU5 & SU6 are the configuration parameters for the serial line at COME (COM Extension). S40 is used to define which protocol must be use on the COME (COM Extension) serial port.

6.2 Other

This page contains the main parameters to set up the LAN configuration both for the ethernet port 1 and port 2.

In case of STATIC IP management, set up parameters IP1 & IP21 to "Static". BBB parameter can be used in case of manual reboot of the X-Gate machine.

6.3 Services

Parameter NTP will enable X-Gate to synchronize the time with an online service. Parameter G54 will enable X-Gate as a NTP Server for another Client.

6.4 Client Fieldbus

This section allows to configure the "SOURCE of the DATA".

According to the protocol to read from the device on field, User must activate the right configuration.

• G14: To enable the communication with Modbus TCP/IP device using the RJ45 (LAN) cable.
• G58, G20, G29: To enable the communication with Modbus device over serial port (RS485).
• G31: To enable in case X-Gate must read over XML protocol on System Manager (via LAN cable).
• G36: To enable for a communication with a CANBus device.
• G41, G42: To enable in case of BACNet device with IP (LAN) or MSTP over serial RS485.

According to the enabled client fieldbus, extra configuration parameters will be displayed. Here the example in case of Modbus TCP/IP with the need to set up the IP address of the device.

6.5 Server Fieldbus

This section allows to configure the "DESTINATION of the DATA" read from the field.

According to the protocol to read from the device on field, User must activate the right configuration.

• G01, G59: To enable the data sharing via Modbus TCP/IP server.
• G11: To enable the data sharing in Modbus on RS45 port.
• G02: To enable data sharing over SNMP protocol over TCP/IP.
• G28, G30: To enable data sharing over BACNet in IP or MSTP according to setting.

According to the enabled server fieldbus, extra configuration parameters will be displayed.

G04 parameter provide capability to limit variable visibility according to the Level. From Level 1 to Level 3. Level is a characteristic of the variable coming from the CDF file (or CDF Editor).

7. CDF Editor

The Editor CDF is a feature that allows the user to edit or create from scratch a CDF file. To use it, click on the "Editor CDF" icon on the left-side of the menu tab.

The user can decide to load and eventually modify an existing CDF. If the desired CDF is stored inside the X-Gate, the "Select CDF from X-Gate" window must be opened.

8. Use Cases

8.1 Use Case 1: Source BACNET & Destination MODBUS

As a step 1, User must activate the "source of the data". It could be BACNet IP or MSTP from the Client Fieldbus configuration page. Main parameters to set up are: G41 or G42. G55 parameter is use as write priority property for BACNet protocol: Default is 16. G43 parameter is used as max number of units: Default is 127.

After this configuration done, X-Gate will start to automatically scan the network (IP or Serial as per configuration done) and automatically will create all the CDF files of the discovered devices (nodes) and create the related device in the Network Configuration page. User can modify the CDF file directly using the CDF Editor or use as it is.

As a step 2, User must activate the "Destination of the data", in this case Modbus TCP/IP. In the Server Fieldbus page, the main parameter is G01 and later the G48 as default port of the server at 502. With this configuration, X-Gate is reading BACNET and exposing over MODBUS TCP/IP.

In case of sharing data with a local BMS, the full list of variable/data-points can be downloaded as a CVS file with the utility in settings → download CSV file.

In case the destination of the data is the System Manager over Modbus RTU (serial RS485), G11 parameter must be on.

In this case, User must set up the communication port with the correct enabled feature. S10 parameter must have the correct set up "Modbus server" and the parameter SU2 and SU3 must be set up according.

Finally, User can download the file for the System Manager integration from the settings menu with the download of the ED3 / EPK files.

8.2 Use Case 2: Source CANBUS & Destination MODBUS

As a step 1, User must activate the "source of the data" with parameter G36.

Check the communication speed on the port with parameter SU4.

Import the CDF file or create/modify an existing one with the CDF Editor.

8.3 Use Case 3: Source MODBUS & Destination MODBUS

Create a new Device in the Network Configuration page.

As a step 2, User must activate the "Destination of the data", in this case Modbus TCP/IP. In this case the activities to be done are the same already described for the Use-Case 01 to set up the destination of the data.

As a step 1, User must activate the "source of the data". In this case X-Gate must have the additional expansion card with the extra RS485 port. G35 parameter to enable the use of the extra RS485. SU2 and SU3 for the serial line configuration of COM1. SUS and SU6 for the serial line configuration of COME (extended). S10 for COM1 as Client. S40 for COME as Server.

G20 ON to enable the source of the data via Modbus.

Import the CDF file or create/modify an existing one with the CDF Editor (as done for Use Case 2). Create a new Device in the Network Configuration page (as done for Use Case 2). As a step 2, User must activate the "Destination of the data", in this case Modbus TCP/IP. In this case the activities to be done are the same already described for the Use Case 1 to set up the destination of the data.

8.4 Use Case 4: Source XML Interface & Destination MODBUS

As a step 1, User must activate the "source of the data" with parameter G31 to on. G32 parameter with the System Manager IP address (please consider also to add the port number like IP:PORT). G33 parameter with a valid User defined into System Manager. G34 parameter with the password of the User.

After this configuration done, X-Gate will start to automatically collect data from the System Manager and automatically will create all the CDF files of the discovered devices (nodes) and create the related device in the Network Configuration page. As a step 2, User must activate the "Destination of the data", in this case Modbus TCP/IP. In this case the activities to be done are the same already described for the Use Case 1 to set up the destination of the data.

9. Update

9.1 X-Gate Software

User can update the X-Gate software using the feature available in the settings page. Software can be downloaded from the official Danfoss "Software ADAP-KOOL" website. The final "*.bin" file must be imported and used for the upgrade.

9.2 CDF Files

User can upload / delete available CDF files on the X-Gate using the Files menu.

10. Annexure

10.1 Supported BACNET features

• Who Is Router to Network
• I Am Router to Network
• Reject Message to Network
• Router Busy to Network
• Router Available to Network
• What Is Network Number
• Network Number Is
• Confirmed Request
• Unconfirmed Request
• Simple ACK
• Complex ACK
• Error PDU
• Reject PDU
• Abort PDU
• Read Property
• Write Property
• Read Property Multiple
• Write Property Multiple
• Subscribe COV
• COV Notification
• Who Is

10.2 Supported BACNET properties

• Object Identifier
• Object Type
• Object Name
• Description
• Present Value
• Event State
• Units

The X-Gate supports BACnet segmentation.