manualshive.com logo in svg

ProSoft Technology MVI56E-LDM-MQTT, Quick Start Manual

Share
Download
ProSoft Technology MVI56E-LDM-MQTT Quick Start Manual Download Page 53

MVI56E-LDM-MQTT ♦ MQ Telemetry Transport 

Visual Studio 2017 Project 

ControlLogix® Platform  

Quick Start Guide 

ProSoft Technology, Inc. 

Page 53 of 55 

12  Visual Studio 2017 Project 

You can use Visual Studio 2017 to build the sample application. Ensure the 
Prerequisites and Development Environment Setup is completed first. 

12.1  Visual Studio Build 

The Visual Studio 2017 solution file, located at:  

C:\Workspace\mqtt-ldm-sample-app-mvi56e\mqtt-ldm-mvi56e.sln

  

 

has two projects:  

 

mqtt-ldm--lib

  

 

mqtt-ldm-sample-app-mvi56e

. 

 

1 

In the 

Solution Explorer

, click on 

mqtt-ldm-sample-app-mvi56e

, right-click and 

choose 

P

ROPERTIES

. 

 

 

 

Figure 49:

 Solution Explorer 

Summary of Contents for MVI56E-LDM-MQTT

Page 1: ...MVI56E LDM MQTT MQ Telemetry Transport ControlLogix Platform August 3 2020 QUICK START GUIDE...

Page 2: ...document including illustrations specifications and dimensions may contain technical inaccuracies or typographical errors ProSoft Technology makes no warranty or representation as to its accuracy and...

Page 3: ...the Canadian Electrical Code for installations in Canada and in accordance with the authority having jurisdiction The following warnings must be heeded WARNING EXPLOSION HAZARD SUBSTITUTION OF COMPONE...

Page 4: ...M s EtherNet IP Address 14 4 MQTT Generic Type Sample Application 15 4 1 Configuring the Sample Applications 15 4 1 1 MQTT Generic config json File 15 4 1 2 SparkplugB config json File 16 4 2 Un encry...

Page 5: ...tatus Print Interval 45 9 1 5 Tags 45 9 2 Configuring Generic MQTT Brokers 46 9 2 1 Generic MQTT Broker 46 9 2 2 Online MQTT Brokers 46 9 2 3 Install MQTT Locally 47 9 3 Running the Sample Application...

Page 6: ...y step information on how to enable communication between Rockwell Automation s ControlLogix PLC and a simple MQTT Broker using MQTT Explorer The goal is to read data from the PLC and publish to topic...

Page 7: ...n up to date installation of three files from Cirrus link Solutions It provides Sparkplug B based MQTT software modules that perform the service of MQTT Distributor Broker the MQTT Engine Subscribing...

Page 8: ...writes Video 10 Primary Host ID Setting https inductiveautomation com resources video primary host id setting Video 11 How to Set Up Transport Layer Security https inductiveautomation com resources v...

Page 9: ...LDM Library root folder build Location where target binaries are created during build docker Toolchain to build source code and Docker configuration files to start container with build environment mq...

Page 10: ...om and download MQTT Explorer to a Windows 10 PC You do not need to perform this step if implementing SparkplugB Note The MQTT Explorer Windows installer version had issues with storing connection set...

Page 11: ...e MVI56E LDM in the ControlLogix rack connect the top Ethernet port to your local network and connect to the Windows 10 PC 2 Use the middle Ethernet port to connect to the network where MQTT Broker is...

Page 12: ...gy 3 2 Configuring the ControlLogix PLC 1 Open the LDM_MQTT ACD program and change the appropriate ControlLogix chassis type to match your hardware and firmware 2 Download LDM_MQTT ACD file to the Con...

Page 13: ...or that was built in the Creating a Build section in this document 2 Download the firmware file to the module via the module s webpage Refer to the MVI56E LDM Developer Manual for details Figure 3 Fi...

Page 14: ...r detailed information about the interfaces file Use an FTP client such as WinSCPTM to edit the eth0 and eth1 sections of the Interfaces file Interfaces file Parameters Values We always want the loopb...

Page 15: ...for Un Encrypted messaging column indicated in the following table Parameters Values for un encrypted messaging Vales for encrypted messaging MqttServer Type Generic Generic Host 137 135 83 217 137 1...

Page 16: ...o org current IP 5 196 95 208 Subject to change 2 mqtt eclipse org current IP 137 135 83 217 Subject to change For this sample configuration mqtt eclipse org is accessed remotely and used as the broke...

Page 17: ...roker Home Page Rather than verifying the MVI56E LDM module s communication on the eclipse site the communication with the remote Broker can be verified by reviewing the log messages on the module To...

Page 18: ...er Activating an installed unconfigured MQTT Explorer displays the following pop up By default it has 2 pre configured settings in the Connections panel 1 Select mqtt eclipse org and ensure that the s...

Page 19: ...TT Clients currently connected to the mqtt eclipse org broker Note that published brokers have connections from many clients and the client will receive several published messages Figure 10 MQTT Explo...

Page 20: ...s indicated in the following screen capture Figure 12 Selecting String Type 7 Expand the Publish section in the center panel and add Set to end the topic name so it will be equal to the value of the S...

Page 21: ...he PSFT SteamSensor String Set field indicated in the following figure Figure 15 Typing in the desired string values 10 Click on the PUBLISH button 11 Go back to the PLC program and observe that the m...

Page 22: ...Encrypted messaging column indicated in the table on page 15 MQTT Generic config json File 2 Reboot the MVI56E LDM module 3 Edit the MQTT Explorer by activating the Encryption and set Port to 8883 Fig...

Page 23: ...Soft Technology Inc Page 23 of 55 7 Select the STRING variable as shown in the following figure Figure 19 String Type Selected 8 Type Set at the end of the Topic field Figure 20 Publishing Keyword Set...

Page 24: ...2 s in the field shown in the previous figure Figure 21 New text written into String type to be published 11 Click the PUBLISH button 12 Return to the PLC program and observe that the multiple 2 s ar...

Page 25: ...192 168 4 200 192 168 4 200 Port 1883 8883 Timeout 5000 5000 DoNotUseTls 1 0 DisableCertificateValidation 1 0 RootCaFileName root ca cer root ca cer ClientCertPublicFileName client_cert_public_ key ce...

Page 26: ...e 24 Sparkplug B Configuration 5 2 Configuring the ControlLogix PLC 1 Open the MVI56E_LDM_MQTT_SparkplugB_Sample_Ladder ACD program and change the appropriate chassis type to match your hardware and f...

Page 27: ...on com downloads third party modules 8 0 11 download the following Cirrus Link Solutions MQTT Modules for Ignition MQTT Distributor Module 30 5 MB https files inductiveautomation com third party cirru...

Page 28: ...ProSoft Technology Inc Page 28 of 55 5 4 Configuring the Un Encrypted Sparkplug Data Exchange This section configures Ignition to communicate with the PLC 1 Sign into the Ignition web GUI http localho...

Page 29: ...he MQTT Broker Distributor within Ignition This section covers the basic configuration for the MQTT Distributor file that behaves as the MQTT broker within the Ignition application 1 Click on the CONF...

Page 30: ...on the Users tab and then click on the CREATE NEW MQTT USERS option 4 Enter the parameter values as indicated in the following screen capture Figure 29 New User 5 Click on the CREATE NEW MQTT USERS b...

Page 31: ...TT Engine Within Ignition This section covers the basic configuration for the MQTT Engine file that behaves as the MQTT Subscribing Client within the Ignition application 1 Click on the CONFIG MQTT EN...

Page 32: ...This section covers the basic configuration for the MQTT Transmission file that behaves as the MQTT Publishing Client within the Ignition application 1 Click on the CONFIG MQTT TRANSMISSION SETTINGS...

Page 33: ...rolLogix Platform Quick Start Guide ProSoft Technology Inc Page 33 of 55 4 Use the same values as entered in Step 2 to substitute the Group ID Edge Node ID and Device ID values in the following code F...

Page 34: ...Ignition to PLC Communication In the Ignition application navigate to Status Systems Tags MQTT Engine Edge Nodes ProSoft MVI56E 1 SteamSensor Verify that LDM_MQTT is successfully reading data from th...

Page 35: ...ProSoft Technology Inc Page 35 of 55 5 5 Installing the Ignition Designer Software 1 Navigate to the Ignition website and click on the GET DESIGNER button Figure 35 Get Designer Button 2 Once downloa...

Page 36: ...C This section covers the configuration of the Ignition Designer tool and sending data to the PLC It will show the data exchange with the PLC using the MVI56E LDM_MQTT in un secured mode 1 Run the Ign...

Page 37: ...ide ProSoft Technology Inc Page 37 of 55 3 Click on the LAUNCH button to activate the Ignition Designer Figure 38 Designer Login 4 Use the same credentials as when the ignition was initially installed...

Page 38: ...Inc Page 38 of 55 6 In the Open dialog select the Prosoft_LDM_MQTT_Ignition_Designer_SparkPlug_Demo zip file This file can be downloaded from www prosoft technology com Figure 40 Locate Demo Project 7...

Page 39: ...tform Quick Start Guide ProSoft Technology Inc Page 39 of 55 9 The project is loaded into Ignition Designer Figure 42 Import the Project 10 Click on the OPEN button Figure 43 Open button 11 The Igniti...

Page 40: ...link 13 In the menu bar select the PROJECT PREVIEW MODE option to activate the live updates of the designer In the PLC tags pane click on the CLICK TO SUBSCRIBE button to see the PLC tags change value...

Page 41: ...up a Linux Debian 6 Virtual Machine For MQTT this guide steps you through using a Docker container on a Windows 10 PC Docker Desktop for Windows is required to run the toolchain from a container runni...

Page 42: ...er of source code files C Workspace needs to be shared in order to access it from the build container In order to access this shared folder from Docker container psft Windows user credentials are requ...

Page 43: ...hown above 192 168 1 73 with the PC s IP address Replace the user ID shown above bfluser with your userid from section Config json Configuration Requirements on page 25 Replace the password shown abov...

Page 44: ...ic namespace Type Type of the MQTT Broker to connect to Generic Any MQTT Broker such as open source broker Eclipse Mosquitto SparkPlug MQTT Broker supporting Sparkplug B protocol Host IP address of th...

Page 45: ...escription Tag Name of the tag in PLC Defined for MVI56E LDM only DataType Data Type of the tag in the PLC Possible values are BOOL SINT INT DINT LINT USINT UINT UDINT ULINT REAL LREAL BYTE WORD DWORD...

Page 46: ...aining to Client ID Topic Namespace or other settings The node MqttServer of the configuration file has following default values Parameter Description Type Set to Generic HostName Set to 192 168 0 254...

Page 47: ...o Broker and is ready to accept connections at port 1883 In the configuration file if the MqttServer HostName field is set to the IP address of the MQTT broker values for the PLC should be published i...

Page 48: ...LDM Library This chapter pertains to developers building custom applications using the library It describes high level design of the library and main API functions required to use it from customer app...

Page 49: ...rns 0 int mqtt_ldm_disconnect void This function disconnects from the MQTT Broker int mqtt_ldm_is_connected void Returns a non zero value if a connection to the MQTT Broker is established int mqtt_ldm...

Page 50: ...written to the PLC The input argument value is the value to be written to the PLC tag New values are received from MQTT Broker by subscribing to specified subscription topics in the configuration file...

Page 51: ...192 168 0 250 log messages txt 0 10 4 Data Flow for Reading Tag Values Refer to the Component Diagram on page 48 The orange lines in the diagram illustrate data flow In order to read data from the PL...

Page 52: ...structure is described in detail in section Configuration File Details starting on page 44 3 C Workspace mqtt ldm sample app mvi56e root_ca cer psft sample mqtt Root CA certificate of the server s SSL...

Page 53: ...he sample application Ensure the Prerequisites and Development Environment Setup is completed first 12 1 Visual Studio Build The Visual Studio 2017 solution file located at C Workspace mqtt ldm sample...

Page 54: ...the PowerShell script build ps1 is executed Your PC security policies might prevent it from running To run this script open a command prompt as Administrator and enter the following commands Powershe...

Page 55: ...down issues North America Corporate Location Europe Middle East Africa Regional Office Phone 1 661 716 5100 info prosoft technology com Languages spoken English Spanish REGIONAL TECH SUPPORT support...

Reviews:

No comments

Brands by name

Popular brands

Load more brands