Page 1
Start-up Guide EZ Gateway KNX to BACnet FS-EZX-KNX-BAC APPLICABILITY & EFFECTIVITY Effective for all systems manufactured after January 2021. FS-QS-1011/12X0/12X1/1X50/1X51 Document Revision: 8.A T18605 EZ Gateway Start-up Guide MSAsafety.com...
Page 2
MSA Safety 1991 Tarob Court Milpitas, CA 95035 Website: www.MSAsafety.com U.S. Support Information: +1 408 964-4443 +1 800 727-4377 Email: smc-support@msasafety.com EMEA Support Information: +31 33 808 0590 Email: smc-support.emea@msasafety.com EZ Gateway Start-up Guide...
Check the MSA Safety website for technical support resources and documentation that may be of assistance. The EZ Gateway is cloud ready and connects with MSA Safety’s SMC Cloud. See Section 6.10.1 for further information.
FieldServer is removed from the DIN rail, use the original screws to reattach. Only screws supplied by MSA Safety should be used in the holes found on the back of the unit when attaching the optional DIN Rail bracket. USE OF ANY OTHER SCREWS MAY DAMAGE THE UNIT.
Installation Installing the EZ Gateway 3.1.1 KNX Connection R2 Port Connect to the 3 pins on the left side of the 6-pin connector as shown (pins labelled 6-4). Pin Connection Frame ground - Power + Power No connection KNX - KNX+ Figure 3: R2 Port Connection 3.1.2...
Installation R1 Port Small DIP Switches Gently remove the FieldServer enclosure to access the small DIP switches for the R1 Port. Bias Resistor Switch End of Line Switch Figure 5: Bias Resistor DIP Switches & EOL • If more than one RS-485 device is connected to the network, then the field bias resistor switch needs to be enabled to ensure proper communication.
Operation Operation Power Up the Device Apply power to the device. Ensure that the power supply used complies with the specifications provided. Ensure that the cable is grounded using the “Frame GND” terminal. The EZ Gateway is factory set for 9-30V DC or 12-24V AC.
Using the FieldServer Toolbox to Discover and Connect to the EZ Gateway • Install the Toolbox application from the USB drive or download it from the MSA Safety website. • Use the FS Toolbox application to find the EZ Gateway and launch the FS-GUI.
Setup Web Server Security Setup Web Server Security Login to the FieldServer The first time the FieldServer GUI is opened in a browser, the IP Address for the gateway will appear as untrusted. This will cause the following pop-up windows to appear. •...
Setup Web Server Security • Additional text will expand below the warning, click the underlined text to go to the IP Address. In Figure 10 example this text is “Proceed to 10.40.50.94 (unsafe)”. Figure 10: Warning Expanded Text • When the login screen appears, put in the Username (default is “admin”) and the Password (found on the label of the FieldServer).
Setup Web Server Security Select the Security Mode On the first login to the FieldServer, the following screen will appear that allows the user to select which mode the FieldServer should use. Figure 12: Security Mode Selection Screen NOTE: Cookies are used for authentication. NOTE: To change the web server security mode after initial setup, go to Section 8.1.
Setup Web Server Security 5.2.1 HTTPS with Own Trusted TLS Certificate This is the recommended selection and the most secure. Please contact your IT department to find out if you can obtain a TLS certificate from your company before proceeding with the Own Trusted TLS Certificate option.
Figure 14) allows users to connect to the SMC Cloud, MSA Safety’s device cloud solution for IIoT. The SMC Cloud enables secure remote connection to field devices through a FieldServer and its local applications for configuration, management, maintenance. For more information about the SMC Cloud,...
Configuring the Gateway EZ Gateway Connection Setup • Open the KNX EZ Gateway Web Configurator GUI in a local web browser (Section 4.3.2). NOTE: The browser should open in the “Gateway” tab, as shown on the left side of the page (Figure 15).
Configuring the Gateway BACnet Connection Setup • Click on the Enable checkbox under the ‘BACnet/IP or BACnet MS/TP Connection’ heading to configure the BACnet connections. The gateway has a BACnet MS/TP (R1) and BACnet/IP connection (N1). Figure 16: BACnet Connection Settings •...
Configuring the Gateway 6.3.2 BACnet/IP Connection Settings IP Port – The BACnet/IP default is 47808 (0xBAC0), but a different port may be specified. Enable BBMD – Select this checkbox to enable the EZ Gateway to act as a BBMD. Public IP Address and Port – If the BBMD is being accessed across a NAT Router, then these values must be configured with the public IP address and Port by which the BBMD can be reached from across the NAT Router.
Configuring the Gateway BACnet Device Setup • Click on the DeviceProxy™ section to configure the BACnet virtual nodes. Figure 17: BACnet Device Settings • Click the “Add Entries” button to reach the Add Node Map Entries window. • Choose the number of devices to add and click the checkmark. This will generate the requisite field inputs for each device •...
Configuring the Gateway KNX Network Mapping There are two methods of mapping KNX Network to BACnet. ETS4 has the ability to export group addresses, which can then be imported into the KNX EZ Gateway (Section 6.5.1). The KNX mapping can also be set up manually in the Web Configurator GUI (Section 6.5.2). 6.5.1 KNX Mapping Method 1: Import Group Addresses NOTE: This document assumes that a qualified ETS4 Operator will create the KNX Network in the...
Page 23
Configuring the Gateway • Choose the location and name of the file then click Save. XML File Export: • In ETS, select the Group Address window and navigate to the desired main group (at the highest level) to export all addresses contained within. EZ Gateway Start-up Guide...
Configuring the Gateway • Right-click on the main group and select “Export Group Addresses”. • Select XML as the Output format type, enter the desired file location as well as file name in the Export file name field and save the file by clicking the “OK” button. Figure 18: ETS4 Export Window EZ Gateway Start-up Guide...
Configuring the Gateway Import to EZ Gateway: • Back on the Web Configurator GUI; click the “Data Map” section to configure the KNX to BACnet data point mapping. • Click the “Import File” button to load the previously saved XML file. Figure 19: Data Map Page •...
Page 26
Configuring the Gateway If there are problems with the import, one of two situations can occur. Resolve Import Conflicts Window: If there are entries with the same group address on both the imported data and the existing data map the “Resolve Import Conflicts” window will appear Decide the appropriate action;...
Page 27
Configuring the Gateway Unsupported or Uncertain eib Data Types Warning: If one or both of these warning pop-up messages appear after importing data, click the bolded “Show” text below the message The Unsupported ESF Entries Window lists which group addresses were not imported because the data type was not supported NOTE: To fix an unsupported data type, the data type would have to be changed to a supported data type before exporting the KNX address data.
Configuring the Gateway • After the import is complete the EZ Gateway will generate BACnet mapping data automatically, but if there are missing fields they must be defined for proper mapping (see Section 6.5.2 and Section for additional information about KNX and BACnet fields). Figure 20: KNX Import Missing Fields EZ Gateway Start-up Guide...
Configuring the Gateway 6.5.2 KNX Mapping Method 2: Setup on Web Configurator GUI • In the Web Configurator GUI, click the “Data Map” section to configure the KNX data point mapping. Figure 21: Mapping BACnet Addresses to the KNX Registers •...
Configuring the Gateway BACnet Network Mapping For every row of KNX parameters in the data map, a corresponding set of BACnet parameters must also be defined. NOTE: Click Toggle Advanced button to see all BACnet fields. Otherwise some fields are hidden. Figure 23: Mapping BACnet Fields •...
Configuring the Gateway Alarm Settings • Click the “Notification Classes” button to the upper right of the Data Map Table to enter the Notification Classes window. • Fill in all fields. Figure 24: Defining Parameters of Notification Class NOTE: Click the next to the Notification Classes heading to see a list of all keyboard functions and shortcuts.
Configuring the Gateway State Tables • To setup state tables click the “State Tables” button in the upper right corner of the Data Map. • Once the State Tables window is open, click the “Add Table” button. • Name the table and click the check mark. •...
Configuring the Gateway Save KNX to BACnet Mapping • Once the mappings and settings are defined, click Save to record information for later use. • Click Restart to load the new configuration. Figure 26: Saved Data Map NOTE: Saving is prevented until all required fields in the table are validated. Highlighted fields go through validation and go from red to clear once a valid answer is entered.
Figure 27) allows users to connect to the SMC Cloud, MSA Safety’s device cloud solution for IIoT. The SMC Cloud enables secure remote connection to field devices through a FieldServer and its local applications for configuration, management, maintenance. For more information about the SMC Cloud, refer to the SMC Cloud Start-up Guide.
Troubleshooting Troubleshooting Communicating with the EZ Gateway Over the Network • Confirm that the network cabling is correct. • Confirm that the computer network card is operational and correctly configured. • Confirm that there is an Ethernet adapter installed in the PC’s Device Manager List, and that it is configured to run the TCP/IP protocol.
Troubleshooting Taking a FieldServer Diagnostic Capture When there is a problem on-site that cannot easily be resolved, perform a Diagnostic Capture before contacting support. Once the Diagnostic Capture is complete, email it to technical support. The Diagnostic Capture will accelerate diagnosis of the problem. If the FieldServer bios is updated/released on November 2017 or later then the Diagnostic Capture is performed via the gateway’s on-board system.
Newer versions may be available on the MSA Safety website. • Ensure that FieldServer Toolbox is loaded onto the local PC. Otherwise, download the FieldServer-Toolbox.zip via the MSA Safety website. • Extract the executable file and complete the installation. Ethernet Port Figure 28: Ethernet Port Location •...
Page 38
Troubleshooting Select “Full Diagnostic" from the drop down menu NOTE: If desired, the default capture period can be changed. Click on the Start Diagnostic button Wait for the capture period to finish and the Diagnostic Test Complete window will appear •...
Troubleshooting Notes Regarding Subnets and Subnet Masks RFC standards allocate the IP Address range of 192.0.0.0 through to 223.255.255.255 to be used in Class- C subnetting (subnets listed as 255.255.255.xxx, where xxx can vary based on filtering required). Consequently, the IP stack for this product will not allow any IP Addresses in this range to be allocated a subnet that does not fall within the Class C range.
Troubleshooting KNX Commissioning Figure 30: KNX Port Location The KNX Administrator will request that the installer hit the service pin at the correct step of the commissioning process. Insert a small screwdriver or other device into the KNX port to activate the service pin when prompted.
Additional Information Additional Information Change Web Server Security Settings After Initial Setup NOTE: Any changes will require a FieldServer reboot to take effect. • Navigate from the EZ Gateway landing page to the FS-GUI by clicking the blue “Diagnostics” text on the bottom of the screen.
Additional Information 8.1.1 Change Security Mode • Click Security in the Navigation panel. Figure 33: FS-GUI Security Setup • Click the Mode desired. If HTTPS with own trusted TLS certificate is selected, follow instructions in Section 5.2.1 • Click the Save button. EZ Gateway Start-up Guide...
Additional Information 8.1.2 Edit the Certificate Loaded onto the FieldServer NOTE: A loaded certificate will only be available if the security mode was previously setup as HTTPS with own trusted TLS certificate. • Click Security in the Navigation panel. Figure 34: FS-GUI Security Setup – Certificate Loaded •...
Additional Information Change User Management Settings • From the FS-GUI page, click Setup in the Navigation panel. • Click User Management in the navigation panel. NOTE: If the passwords are lost, the unit can be reset to factory settings to reinstate the default unique password on the label.
Additional Information 8.2.1 Create Users • Click the Create User button. Figure 36: Create User Window • Enter the new User fields: Name, Security Group and Password. User details are hashed and salted NOTE: The password must meet the minimum complexity requirements. An algorithm automatically checks the password entered and notes the level of strength on the top right of the Password text field.
Additional Information 8.2.2 Edit Users • Click the pencil icon next to the desired user to open the User Edit window. Figure 37: Setup Users • Once the User Edit window opens, change the User Security Group and Password as needed. Figure 38: Edit User Window •...
Additional Information 8.2.3 Delete Users • Click the trash can icon next to the desired user to delete the entry. Figure 39: Setup Users • When the warning message appears, click Confirm. Figure 40: User Delete Warning EZ Gateway Start-up Guide...
Additional Information 8.2.4 Change FieldServer Password • Click the Password tab. Figure 41: FieldServer Password Update via FS-GUI • Change the general login password for the FieldServer as needed. NOTE: The password must meet the minimum complexity requirements. An algorithm automatically checks the password entered and notes the level of strength on the top right of the Password text field.
Additional Information Specifications FS-EZX-KNX-BAC One 6-pin Phoenix connector with: KNX port (+ / - / No Connection) Power port (+ / - / Frame-gnd) Electrical Connections One 3-pin Phoenix connector with: RS-485 port (+ / - / gnd) One Ethernet 10/100 BaseT port...
Additional Information Compliance with UL Regulations For UL compliance, the following instructions must be met when operating EZ Gateway. • The units shall be powered by listed LPS or Class 2 power supply suited to the expected operating temperature range. •...
MSA Safety warrants its products to be free from defects in workmanship or material under normal use and service for two years after date of shipment. MSA Safety will repair or replace any equipment found to be defective during the warranty period. Final determination of the nature and responsibility for defective or damaged equipment will be made by MSA Safety personnel.
Need help?
Do you have a question about the FS-EZX-KNX-BAC and is the answer not in the manual?
Questions and answers