MSA fieldserver EZ Series, Operating Manual

Page 1: ...Operating Manual EZ Gateway Modbus to BACnet Start up Guide Revision 3 D Document No T18626 Print Spec 10000005389 F MSAsafety com ...

Page 2: ...urt Milpitas CA 95035 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 For your local MSA contacts please go to our website www MSAsafety com ...

Page 3: ...d TLS Certificate 17 6 2 2 HTTPS with Default Untrusted Self Signed TLS Certificate or HTTP with Built in Payload Encryption 17 7 Configuring the EZ Gateway 18 7 1 Controls Status and Log Functions 18 7 2 Setting up the Connections 19 7 3 Creating Device EZ Profiles 20 7 3 1 Using the Device Web Interface to Map BACnet Objects 21 7 3 2 Using Excel Profile Generator to Map BACnet Objects 23 7 3 3 C...

Page 4: ...pport 48 11 Additional Information 49 11 1 Change Web Server Security Settings After Initial Setup 49 11 1 1 Change Security Mode 50 11 1 2 Edit the Certificate Loaded onto the FieldServer 51 11 2 Change User Management Settings 52 11 2 1 Create Users 53 11 2 2 Edit Users 54 11 2 3 Delete Users 55 11 2 4 Change FieldServer Password 56 11 3 Specifications 57 11 4 Compliance with UL Regulations 58 1...

Page 5: ...t the product correctly implements the BACnet features claimed in the listing The mark is a symbol of a high quality BACnet product Go to www BACnetInternational net for more information about the BACnet Testing Laboratory Click here for the BACnet PIC Statement BACnet is a registered trademark of ASHRAE 1 2 Supplied Equipment FieldServer Gateway Preloaded with the Modbus and BACnet drivers All in...

Page 6: ...2 Equipment Setup 2 1 Mounting The gateway can be mounted using the DIN rail mounting bracket on the back of the unit 6 EZ Gateway Modbus to BACnet Start up Guide ...

Page 7: ...2 2 Physical Dimensions EZ Gateway Modbus to BACnet Start up Guide 7 ...

Page 8: ...the logic The bias resistor is 510 ohms which is in line with the BACnet spec It should only be enabled at one point on the bus for example on the field port were there are very weak bias resistors of 100k Since there are no jumpers many EZ Gateways can be put on the network without running into the bias resistor limit which is 500 ohms NOTE See the Termination and Bias Resistance Enote for additi...

Page 9: ...n shown in above Termination resistor is also used to reduce noise It pulls the two lines of an idle bus together However the resistor would override the effect of any bias resistors if connected NOTE The R1 and R2 DIP Switches apply settings to the respective serial port NOTE If the gateway is already powered on DIP switch settings will not take effect unless the unit is power cycled EZ Gateway M...

Page 10: ...Pin Assignment BMS RS 485 Wiring Gateway Pin Assignment RS 485 TX RS 232 TX RS 485 RX RS 232 RX GND GND GND GND NOTE Use standard grounding principles for GND 3 2 2 Supported RS 485 Baud Rates by Protocol The supported baud rates for either port is based on the protocol of the connected devices The following baud rates are supported for Modbus RTU 2400 4800 9600 19200 38400 57600 76800 115200 The ...

Page 11: ... the gateway via the Web App To connect the gateway either connect the PC to the router s Ethernet port or connect the router and PC to an Ethernet switch Use Cat 5 cables for the connection NOTE The Default IP Address of the gateway is 192 168 2 101 Subnet Mask is 255 255 255 0 EZ Gateway Modbus to BACnet Start up Guide 11 ...

Page 12: ...mA 125mA NOTE These values are nominal and a safety margin should be added to the power supply of the host system A safety margin of 25 is recommended Apply power to the EZ Gateway as shown below Ensure that the power supply used complies with the specifications provided in Section 11 3 Specifications The gateway accepts 9 30VDC or 24VAC on pins L and N Frame GND should be connected 12 EZ Gateway ...

Page 13: ...nd Internet and then click Network and Sharing Center Click Change adapter settings on the left side of the window Right click on Local Area Connection and select Properties from the dropdown menu Highlight and then click the Properties button Select and enter a static IP Address on the same subnet For example Click the Okay button to close the Internet Protocol window and the Close button to exit...

Page 14: ...untrusted This will cause the following pop up windows to appear When the Web Server Security Unconfigured window appears read the text and choose whether to move forward with HTTPS or HTTP When the warning that Your connection is not private appears click the advanced button on the bottom left corner of the screen 14 EZ Gateway Modbus to BACnet Start up Guide ...

Page 15: ...word found on the label of the FieldServer NOTE There is also a QR code in the top right corner of the FieldServer label that shows the default unique password when scanned NOTE A user has 5 attempts to login then there will be a 10 minute lockout There is no timeout on the FieldServer to enter a password NOTE To create individual user logins go to Section 11 2 Change User Management Settings EZ G...

Page 16: ... the FieldServer should use NOTE Cookies are used for authentication NOTE To change the web server security mode after initial setup go to Section 11 1 Change Web Server Security Settings After Initial Setup The sections that follow include instructions for assigning the different security modes 16 EZ Gateway Modbus to BACnet Start up Guide ...

Page 17: ...appear under the mode selection Copy and paste the Certificate and Private Key text into their respective fields If the Private Key is encrypted type in the associated Passphrase Click Save A Redirecting message will appear After a short time the FieldServer GUI will open 6 2 2 HTTPS with Default Untrusted Self Signed TLS Certificate or HTTP with Built in Payload Encryption Select one of these opt...

Page 18: ...about the FieldServer Manager refer to the MSA Grid FieldServer Manager Start up Guide 7 1 Controls Status and Log Functions Along the right side of every Web Configurator GUI page is a column of buttons and event generated messages Controls Panel Contains the following four buttons Reload Resets all settings to the last saved configuration Defaults Resets all settings to the default configuration...

Page 19: ... Open the Connections page to configure the connection ports and parameters Click the Save button in the Controls section once completed Then click Restart to implement the new settings EZ Gateway Modbus to BACnet Start up Guide 19 ...

Page 20: ...n 7 3 1 Using the Device Web Interface to Map BACnet Objects Create Modbus to BACnet mapping using Excel Profile Generator Section 7 3 2 Using Excel Profile Generator to Map BACnet Objects After saving the data map complete the profile setup by updating State Tables and Notification Classes as needed Section 7 3 3 Completing Device Profile Setup 20 EZ Gateway Modbus to BACnet Start up Guide ...

Page 21: ...il icon next to the name of the profile to map Enter the Modbus and BACnet parameters NOTE See Section 11 5 Address Types and Data Types for additional information on Address Type Click on the Data Map tab and add the first Modbus address range NOTE Check the Signed Value checkbox right of the data map entry if signed values are needed EZ Gateway Modbus to BACnet Start up Guide 21 ...

Page 22: ...OTE The Advanced button eye icon allows additional settings including Intrinsic Reporting Bit Extraction scaling and more Repeat for all of the Modbus registers Once all mappings are defined click the Save button in the bottom left corner of the window to record the Profile 22 EZ Gateway Modbus to BACnet Start up Guide ...

Page 23: ...curity warning is present simply click the Enable Content button found at the end of the warning Click the Data Map tab near the bottom of the Excel spreadsheet Edit or copy in Modbus registers as needed Once all the point mappings are complete switch back to the Generate Profile tab Click the Generate Profile button to create a new Excel csv file titled My Modbus Profile Go back to the EZ Gateway...

Page 24: ...gs tab to enter the Modbus and BACnet parameters NOTE See Section 11 5 Address Types and Data Types for additional information on Address Type If using a BACnet State Table click on the State Table tab to define the table and its variables NOTE The Table Name field must be 14 characters or less No commas allowed The State Text field must be 50 characters or less No commas allowed 24 EZ Gateway Mod...

Page 25: ... click the Save button 7 3 4 Export Profile for Backup or Future Use Back on the Device Profiles page the profile can be exported for backup or future use by hitting the Export Profile button hard drive icon The profile downloads to the local computer in the format Profile Name profile EZ Gateway Modbus to BACnet Start up Guide 25 ...

Page 26: ...et generated files Section 7 3 2 Using Excel Profile Generator to Map BACnet Objects or an exported profile Section 7 3 4 Export Profile for Backup or Future Use Files generated from the downloaded Excel Profile Generator only include Data Map information and must be completed by going through the steps found in Section 7 3 3 Completing Device Profile Setup after being loaded However exported prof...

Page 27: ...the appropriate connection and Node ID BACnet Device Instance for both the incoming Modbus device and the mapped BACnet output Click Add to include additional device profiles in the Configuration Repeat for all Modbus devices intended to connect to the EZ Gateway Click the Save button on the right side of the screen once all device EZ Profiles are added and then click the Restart button to reset t...

Page 28: ...figuration manual MSA Safety also offers a technical support on the MSA Safety website which contains a significant number of resources and documentation that may be of assistance 7 6 1 Accessing the FieldServer Manager NOTE The FieldServer Manager tab see image above allows users to connect to the Grid MSA Safety s device cloud solution for IIoT The FieldServer Manager enables secure remote conne...

Page 29: ...on BACnet without having to ask the BMS integrator to test the unit To access the embedded BACnet Explorer click the BACnet Explorer tab NOTE For BACnet IP click on the Connections tab to ensure the gateway is on the BACnet IP network subnet to configure BBMD EZ Gateway Modbus to BACnet Start up Guide 29 ...

Page 30: ...cted to the same subnet as the gateway by clicking the Discover button binocular icon This opens the Discover window click the checkboxes next to the desired settings and click Discover to start the search NOTE The Discover All Devices or Discover All Networks checkboxes must be unchecked to search for a specific device range or network 30 EZ Gateway Modbus to BACnet Start up Guide ...

Page 31: ...appear in the upper right corner of the browser to confirm that the action is complete 8 2 View Device Details and Explore Points Parameters To view the device details click the blue plus sign next to the desired device in the list This will show only some of the device properties for the selected aspect of a device EZ Gateway Modbus to BACnet Start up Guide 31 ...

Page 32: ...lick the Explore button that appears to the right of the highlighted device as a magnifying glass icon or double click the highlighted device Now additional device details are viewable however the device can be explored even further Click on one of the device details 32 EZ Gateway Modbus to BACnet Start up Guide ...

Page 33: ...ges are expected since the last explore simply press the Refresh button that appears to right of individual properties to refresh NOTE The Gateway Search Bar will find devices based on their Device ID NOTE The Gateway Discovery Tree has 3 levels that correspond to the following Network number Device Device object EZ Gateway Modbus to BACnet Start up Guide 33 ...

Page 34: ...itable such as object name object description etc however this is not recommended because the gateway is not a Building Management System BMS To edit the present value select it in the property listings Then click the Write button on the right of the property to bring up the Write Property window 34 EZ Gateway Modbus to BACnet Start up Guide ...

Page 35: ...er the appropriate change and click the Write button The window will close When the BACnet Explorer page appears the present value will be changed as specified EZ Gateway Modbus to BACnet Start up Guide 35 ...

Page 36: ...ver Manager Connection Warning Message to resolve the connection issue Either go through the FieldServer Manager setup to integrate cloud functionality to the FieldServer or opt out For FieldServer Manager setup continue with instructions in the following sections To opt out of the FieldServer Manager click on a tab other than the Grid FieldServer Manger tab click the checkbox next to Opt out of G...

Page 37: ...ort team Once an invitation has been requested follow the instructions below to set up login details The Welcome to the MSA Grid FieldServer Manager email will appear as shown below NOTE If no email was received check the spam junk folder for an email from notification fieldpop io Contact the manufacturer s support team if no email is found EZ Gateway Modbus to BACnet Start up Guide 37 ...

Page 38: ... the checkbox to agree to the privacy policy and terms of service NOTE If access to data logs using RESTful API is needed do not include in the password Click Save to save the user details Click OK when the Success message appears Record the email account used and password for future use 38 EZ Gateway Modbus to BACnet Start up Guide ...

Page 39: ...registered onto the server Click the FieldServer Manager tab NOTE If a warning message appears instead go to Section 11 6 FieldServer Manager Connection Warning Message to resolve the connection issue Click Get Started to view the FieldServer Manager registration page EZ Gateway Modbus to BACnet Start up Guide 39 ...

Page 40: ...s gateway details and FieldServer Manager account credentials Enter user details and click Next Enter the site details by entering the physical address fields or the latitude and longitude then click Next 40 EZ Gateway Modbus to BACnet Start up Guide ...

Page 41: ...elcome to MSA Grid FieldServer Manager invite to the email address entered Once the device has successfully been registered a confirmation window will appear Click the Close button and the following screen will appear listing the device details and additional information auto populated by the EZ Gateway EZ Gateway Modbus to BACnet Start up Guide 41 ...

Page 42: ...NOTE Update these details at any time by going to the FieldServer Manager tab and clicking the Update FieldServer Details button 42 EZ Gateway Modbus to BACnet Start up Guide ...

Page 43: ...tered go to www smccloud net and type in the appropriate login information as per registration credentials NOTE If the login password is lost see the MSA Grid FieldServer Manager Start up Guide for recovery instructions EZ Gateway Modbus to BACnet Start up Guide 43 ...

Page 44: ...NOTE For additional FieldServer Manager instructions see the MSA Grid FieldServer Manager Start up Guide 44 EZ Gateway Modbus to BACnet Start up Guide ...

Page 45: ...onfigured to run the TCP IP protocol Check that the IP netmask of the PC matches the EZ Gateway The Default IP Address of the EZ Gateway is 192 168 2 X Subnet Mask is 255 255 255 0 Go to Start Run Type in ipconfig The account settings should be displayed Ensure that the IP Address is 102 168 2 X and the netmask 255 255 255 0 Ensure that the PC and EZ Gateway are on the same IP Network or assign a ...

Page 46: ...igation panel Open the FieldServer Toolbox software and click the diagnose icon of the desired device Go to Full Diagnostic and select the capture period Click the Start button under the Full Diagnostic heading to start the capture When the capture period is finished a Download button will appear next to the Start button Click Download for the capture to be downloaded to the local PC Email the dia...

Page 47: ...10 3 LED Functions EZ Gateway Modbus to BACnet Start up Guide 47 ...

Page 48: ...ware Support The following web browsers are supported Chrome Rev 57 and higher Firefox Rev 35 and higher Microsoft Edge Rev 41 and higher Safari Rev 3 and higher NOTE Internet Explorer is no longer supported as recommended by Microsoft NOTE Computer and network firewalls must be opened for Port 80 to allow FieldServer GUI to function 48 EZ Gateway Modbus to BACnet Start up Guide ...

Page 49: ...formation 11 1 Change Web Server Security Settings After Initial Setup NOTE Any changes will require a FieldServer reboot to take effect Click Setup in the Navigation panel EZ Gateway Modbus to BACnet Start up Guide 49 ...

Page 50: ...in the Navigation panel Click the Mode desired If HTTPS with own trusted TLS certificate is selected follow instructions in Section 6 2 1 HTTPS with Own Trusted TLS Certificate Click the Save button 50 EZ Gateway Modbus to BACnet Start up Guide ...

Page 51: ...e if the security mode was previously setup as HTTPS with own trusted TLS certificate Click Security in the Navigation panel Click the Edit Certificate button to open the certificate and key fields Edit the loaded certificate or key text as needed Click Save EZ Gateway Modbus to BACnet Start up Guide 51 ...

Page 52: ...tructions see the FieldServer Next Gen Recovery document If the default unique password is lost then the unit must be mailed back to the factory NOTE Any changes will require a FieldServer reboot to take effect Check that the Users tab is selected User Types Admin Can modify and view any settings on the FieldServer Operator Can modify and view any data in the FieldServer array s Viewer Can only vi...

Page 53: ... 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 Click the Create button Once the Success message appears click OK EZ Gateway Modbus to BACnet Start up Guide 53 ...

Page 54: ...next to the desired user to open the User Edit window Once the User Edit window opens change the User Security Group and Password as needed Click Confirm Once the Success message appears click OK 54 EZ Gateway Modbus to BACnet Start up Guide ...

Page 55: ...11 2 3Delete Users Click the trash can icon next to the desired user to delete the entry When the warning message appears click Confirm EZ Gateway Modbus to BACnet Start up Guide 55 ...

Page 56: ...n 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 56 EZ Gateway Modbus to BACnet Start up Guide ...

Page 57: ...rence This device must accept any interference received including interference that may cause undesired operation NOTE This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment T...

Page 58: ...the expected operating temperature range Meet the current and voltage rating for the FieldServer Furthermore the interconnecting power cable shall Be of length not exceeding 3 05m 118 3 Be constructed of materials rated VW 1 FT 1 or better If the unit is to be installed in an operating environment with a temperature above 65 C it should be installed in a Restricted Access Area requiring a key or a...

Page 59: ...PDU Address range Data_Type Function Code Write Function Code Read 0 65535 Coil 15 1 0 65535 Discrete_Input n a 2 0 65535 Input_Register n a 4 0 65535 Holding_Register 16 3 For Address_Type Modicon_5digit When a Modbus address range is specified a particular Data Type is implied The defaults are shown below Address Range Data_Type Function Code Write Function Code Read 00001 09999 Coil 5 15 1 1000...

Page 60: ... clicking the Settings tab and then click the Network tab Check with the site s IT support that the DNS settings are setup correctly Ensure that the FieldServer is properly connected to the Internet NOTE If changes to the network settings are done remember to click the Save button Then power cycle the FieldServer by clicking on the Confirm button in the window and click on the bolded Restart text ...

Page 61: ...moved or altered This Limited Warranty also will not apply to interconnecting cables or wires consumables or to any damage resulting from battery leakage In all cases MSA Safety s responsibility and liability under this warranty shall be limited to the cost of the equipment The purchaser must obtain shipping instructions for the prepaid return of any item under this warranty provision and complian...