Table of Contents. i-vu Open Link

Size: px

Start display at page:

Download "Table of Contents. i-vu Open Link"

Lora Allen
5 years ago
Views:

1 i-vu Open Link Modbus TCP/IP Integration Guide CARRIER CORPORATION 2011 A member of the United Technologies Corporation family Stock symbol UTX Catalog No /18/2011

2 Table of Contents Overview... 1 Before-you-begin checklist Create a control program in Snap... 3 To format a Modbus TCP/IP address... 3 To format an address using optional Modbus TCP/IP IP method... 5 To edit an integration point address Assign and download custom control programs and views to the i-vu Open Link... 6 To configure integration points Connect the i-vu Open Link to the third-party device Set up the Modbus TCP/IP driver properties Verify the i-vu Open Link is set up correctly To get a diagnostic capture using Wireshark Appendix Modbus TCP/IP Protocol Conformance Statement i-vu Open Link i

3 Overview Follow the steps in this document to integrate one or more third party Modbus TCP/IP controllers using an i- Vu Open Link. To install and network the i-vu Open Link, see the i-vu Open Link Installation and Start-up Guide. i-vu Open Link Modbus port E1 10/100 BaseT Ethernet Module driver Read/write capability Modbus: drv_ivuopenlink_<latest version>.driver * Can read from and write to the third-party equipment Integration points supported 500 Third party Supported equipment Network media type Quantity of devices you can physically connect to i-vu Open Link's Ethernet port Any device that supports the Modbus TCP/IP protocol Ethernet Up to 30 Modbus TCP/IP connections. Connections could be to a Modbus TCP/IP server device or to a Modbus TCP/IP server device that is acting as a Gateway to other Modbus serial devices. Each Modbus TCP/IP server gateway can have one serial modbus slave connected over EIA-232, or up to 247 modbus slaves connected over EIA * The i-vu Open Link driver supports Modbus devices connected to Port S2 and BACnet or Modbus devices connected on the Ethernet port simultaneously. The third-party point count for the i-vu Open Link is the total of the 2 ports. i-vu Open Link 1

4 Before-you-begin checklist Before-you-begin checklist You need the following items, information, and skills for the integration process: A points list for each Modbus TCP/IP device that includes register addresses and read/write capabilities. Points lists are usually available from the third-party manufacturer s representative or website. The IP addresses and unit ID's of the Modbus TCP/IP devices. Verification that all communication properties have been set on the Modbus TCP/IP devices Verification of communications through the port that the i-vu Open Link will connect to Experience creating custom control programs (.equipment files) with Snap Experience installing, wiring, setting up, and downloading custom control programs to the i-vu Open Link The latest version of Wireshark ( downloaded and installed. Use this network analysis tool for troubleshooting. See To get a diagnostic capture using Wireshark (page 10) for details. 2 i-vu Open Link

5 1 Create a control program in Snap When you create your control program, use a Network I/O microblock for each third-party point. To format a Modbus TCP/IP address Use the information below to format a valid address in each integration point that you use to read or write to a Modbus TCP/IP device. CAUTION! When integrating third-party devices into an i-vu/field Assistant system, most communication problems are caused by incorrect data or typos in the integration point's Address field. Example: mtcpip://uint/40128/3/ To... this kind of value... use this type of integration point... with this register type... and a Modbus register address in this range... 1 Read 0 to 65,535 Unsigned 16-bit integer Input register ANI Uint (not Unit) or to 4,294,967,296 Unsigned, 32-bit (long) integer 32,768 to +32,767 Signed 16-bit integer Input register -2,147,483,648 to 2,147,483,647 Signed, 32-bit (long) integer Value with decimal point Input register ANI Uint or ANI Sint or ANI Sint or ANI Float or i-vu Open Link 3

6 1 Create a control program in Snap To... this kind of value... use this type of integration point... with this register type... and a Modbus register address in this range or 1 Coil Discrete (binary) output 0 or 1 Discrete (binary) input BNI Do BNI Di or 1 Input register BNI BITn (where n is a value 0-15 defined or in points list) Write 0 to 65,535 ANO Uint (not Unit) Unsigned 16-bit integer 1 32,768 to +32,767 Signed 16-bit integer Value with decimal point 0 or 1 Coil Discrete (binary) output 0 or 1 ANO Sint ANO Float BNO Do BNO BITn (where n is a value 0-15 defined in points list) The Modbus register address must be a decimal value. If you see the letters A F in register addresses anywhere in a points list, use a scientific calculator to convert these hexadecimal values to decimal values. If the Modbus register address (sometimes called register, address, code, or parameter) is not in this range, take the number given, then add 1 to coils; add 10,001 to discrete inputs; add 30,001 to input registers (sometimes given as 3X); and add 40,001 to holding registers (sometimes given as 4X). In rare cases, the number given is not in the range shown above and is greater than Type a 4 (function code) at the beginning of an input register or a 3 at the beginning of a input register. For example, to read holding register number , type (Add 1 as described in the paragraph above.) 2 Each Float has 2 consecutive Modbus register addresses. Use the lower number in the integration point address. 4 i-vu Open Link

To format an address using optional Modbus TCP/IP IP method If the unit ID of every third-party device in the system is unique, you can save time by omitting the IP addresses from the individual

See Download the Modbus driver and control programs. 1 On i-vu/field Assistant's navigation tree, right-click third-party controller and select Driver Properties.

7 To format an address using optional Modbus TCP/IP IP method If the unit ID of every third-party device in the system is unique, you can save time by omitting the IP addresses from the individual microblock addresses and mapping the unit ID's to their IP address in i- Vu/Field Assistant. See example below. You can access the IP Addressing table after you download the controller's driver. See Download the Modbus driver and control programs. 1 On i-vu/field Assistant's navigation tree, right-click third-party controller and select Driver Properties. 2 Select Protocols > Modbus TCP/IP> > IP Addressing. To edit an integration point address You can edit an integration point address in the following places: In Snap In i-vu/field Assistant on the third party controller's Properties page > Equipment tab In i-vu/field Assistant on the third party controller's Properties page> Network Points tab i-vu Open Link 5

8 2 Assign and download custom control programs and views to the i-vu Open Link 2 Assign and download custom control programs and views to the i-vu Open Link 1 If using i-vu/field Assistant, go to Discovery page > Setup tab and select the i-vu Open Link in the navigation tree. 2 Click the Add Control Program button on the right. A dialog window appears. 3 Enter a Display Name. 4 Select the i-vu Open Link from drop-down list under Programmable Controller. 5 Click Add New under Control Programs. A second dialog window will appear. 6 Browse to the.equipment file that you created in Snap and click Continue. 7 When message appears File added successfully, click Close. 8 To upload a graphic, click Add New under Views and browse to your.view file. A second dialog window appears. 9 Browse to the.view file that you created in ViewBuilder and click Continue. 10 When message appears File added successfully, click Close. 11 Click OK. 12 Repeat steps 3-12 to add additional control programs and views. 13 Go the System level in the navigation tree, Discovery > Setup, and select the i-vu Open Link in the router list on the right. 14 Right-click and select Download Files. This loads the control programs and graphics into the i-vu Open Link. To edit your control program in Snap Follow these steps to edit an existing control program: 1 Log in to i-vu/field Assistant. 2 Double-click the third party controller in the navigation tree. A dialog window appears. 3 Click Edit Existing under Control Programs. A new dialog window appears. 4 Save file to a location of your choice. 5 Click Close. 6 Start Snap. 7 Select File > Open and open the.equipment file that you saved. 8 Edit the control program and save to your computer. 9 Start i-vu/field Assistant. 10 Double-click the third party controller in the navigation tree. A dialog window appears. 11 Click Add New button under Control Programs. A new dialog window appears. 12 Browse to your edited control program and click Continue. When message appears File added successfully, click Close. 13 Click OK. 6 i-vu Open Link

9 To configure integration points You can now configure the integration points. NOTE If you have already done this in Snap, skip this section. 1 In the navigation tree, select the desired third party controller. 2 Click Properties page > Equipment tab to see a list of all integration points. 3 Define the Modbus TCP/IP address string using the syntax for each point in the list, as described in To format a Modbus TCP/IP address (page 3) in this document. 4 Apply unit conversion and scaling in the remaining fields, if applicable. 5 After configuring each integration point, click OK to download the changes. i-vu Open Link 7

10 3 Connect the i-vu Open Link to the third-party device 3 Connect the i-vu Open Link to the third-party device Use one of the following CAT5 or higher Ethernet cables: A crossover cable to connect the i-vu Open Link directly to a Modbus TCP/IP server or gateway A straight-through cable to connect the i-vu Open Link to a hub or switch, and a second straight-through cable to connect the hub or switch to a Modbus TCP/IP server or gateway Maximum cable length: 328 feet (100 meters) 1 Turn off the i-vu Open Link's power. 2 Check the communications wiring for shorts and grounds. 3 Wire the i-vu Open Link's Port E1 to the third-party device. NOTE Port E1 will still be capable of BACnet communication. 4 Turn on the i-vu Open Link's power. 8 i-vu Open Link

11 4 Set up the Modbus TCP/IP driver properties 1 On i-vu/field Assistant's navigation tree, right-click on your custom equipment. 2 Select Driver Properties. 3 Expand Protocols and select Modbus TCP/IP. 4 Under Port Configuration, select Modbus TCP/IP as the communication type. 5 Set the fields under Timing Configuration. These settings can typically be left at their default values. 6 Set the fields under Protocol Configuration using information from the third-party manufacturer's representative. Select the Details checkbox for help. Click Apply to save changes. 7 On the navigation tree, click Protocols. 8 In the Protocol Status table, verify that Modbus TCP/IP shows Running on Port E1. If the status shows Not Running or the wrong port, repeat step 4. i-vu Open Link 9

12 5 Verify the i-vu Open Link is set up correctly 5 Verify the i-vu Open Link is set up correctly 1 On i-vu/field Assistant's navigation tree, select the third party controller. 2 Select the Properties page > Network Points tab. If... You see the point value you expect with no errors in the Error column All points show question marks instead of values The point name is red A value is incorrect Then... You have successfully established communication with the third-party device. i-vu/field Assistant is not communicating with the i-vu Open Link. Troubleshoot communications. See the i-vu Open Link Installation and Start-up Guide. Look in the Error column for one of the following error codes and descriptions. 1 - Communications Disabled for this Microblock Enable the integration point's Communications Enabled field on i-vu/field Assistant's Network Points tab. 3 - Address Error - Unknown Protocol Specified Select the correct port on the Modbus TCP/IP driver page in i-vu/field Assistant, verify that Address in the integration point is correct. Verify that: The Address in the integration point is correct. The retrieved value is scaled properly, if necessary. For example, scaled from Celsius to Fahrenheit. Refer to the third-party manufacturer's documentation for scaling information. If the above solutions do not resolve the problem, gather the following information for technical support: A diagnostic capture. See next topic. A screenshot of the Driver Properties - right-click on the custom equipment in the navigation tree> select Driver Properties > Protocols A screenshot of the custom equipments's Properties page > Network Points tab showing addresses and errors To get a diagnostic capture using Wireshark Use Wireshark, a network analysis tool, to capture the Ethernet communication between the i-vu Open Link and the Modbus TCP/IP device. Download the latest release of Wireshark and WinPcap from the Wireshark website ( Install WinPcap first, then Wireshark. Use the installation wizard's default settings. NOTE We recommend using a hub along with Wireshark to ensure that Wireshark captures all relevant messages. Disconnect the LAN cable from the i-vu router that you are monitoring and plug that into the Uplink port of the hub. Connect the computer, running Wireshark and the i-vu router into the hub. 10 i-vu Open Link

13 To run Wireshark and capture IP traffic 1 Click Start > All Programs > Wireshark. 2 From the menu bar, select Capture > Interface List. 3 Click the Start button next to the adapter that is connected to the network. This starts the IP capture. TIP Choose the adapter that shows the Packet value changing. This indicates the interface is active on the LAN. 4 Allow the capture to run long enough to ensure that there is sufficient data to allow a technician to review the problem. To save the Wireshark capture 1 On the menu bar, select Capture > Stop to stop the data capture. 2 Select File > Save and save the capture to a convenient location. Do not change Save as type default, which is Wireshark/tcpdump/ - libpcap (*.pcap, *.cap). 3 the capture file to Carrier Technical Support for further analysis. i-vu Open Link 11

14 Appendix Modbus TCP/IP Protocol Conformance Statement Appendix Modbus TCP/IP Protocol Conformance Statement The following Modbus TCP/IP features and commands are supported by the i-vu Open Link. See the Modbus TCP/IP website ( for complete Modbus TCP/IP protocol information. *Most commonly used value Function codes - command 01 - Read Coil Status Function code purpose Read discrete outputs 02 - Read Input Status Read discrete inputs 03 - Read Holding Registers Read holding registers 04 - Read Input Registers Read input registers 05 - Force Single Coil Write discrete outputs, one at a time 06 - Preset Single Register Write holding registers, one at a time 15 - Force Multiple Coils Write discrete outputs 16 - Preset Multiple Registers Write holding registers 12 i-vu Open Link

15 CARRIER CORPORATION 2011 A member of the United Technologies Corporation family Stock symbol UTX Catalog No /18/2011

Connecting UniOP to Modbus/TCP

Connecting UniOP to Modbus/TCP This Technical Note contains the information needed to connect UniOP to control devices using the Modbus/TCP protocol over Ethernet. Contents 1. Introduction... 1 1.1 Communication