ProSoft Technology MVI56E-LDM Quick Start Manual Download Page 1

Page: 1 / 49

MVI56E-LDM

ControlLogix Platform

Linux Development Module

ThingWorx® Add-On

January 9, 2020

QUICK START GUIDE

Summary of Contents for MVI56E-LDM

Page 1: ...MVI56E LDM ControlLogix Platform Linux Development Module ThingWorx Add On January 9 2020 QUICK START GUIDE...

Page 2: ...rosoft technology com Copyright 2020 ProSoft Technology Inc All rights reserved MVI56E LDM ThingWorx Quick Start Guide January 9 2020 ProSoft Technology is a registered copyright of ProSoft Technology...

Page 3: ...Docker 12 3 Development Environment Setup 13 3 1 Create user 13 3 2 Share folder 13 3 3 Overwrite JSON files 14 4 Build 15 5 Connect to the MVI56E LDM 17 5 1 Physical Connections 17 5 2 Configuring th...

Page 4: ...8 2 2 Callback Function Declarations 37 8 3 Data Flow for Reading of Tag Values 38 8 4 Data Flow for Writing of Tag Values 39 9 Firmware Details 41 9 1 Firmware Contents 41 9 2 Running of Sample Appl...

Page 5: ...technology com to be used with a ThingWorx C SDK software library from PTC You can use these to create a sample application to allow communications between a ControlLogix PLC and a ThingWorx Server Th...

Page 6: ...plication and load it on the MVI56E LDM You will then configure it with a working sample 1 2 Development Environment The MVI56E LDM development tools run in Linux If you have experience with a previou...

Page 7: ...iles that come with the PTC C SDK library mvi56e ldm Source code of the sample application for MVI56E LDM and dependencies required to build it and scripts to build firmware upgrade file ThingWorx ldm...

Page 8: ...ile for the ThingWorx Platform from the PTC MarketplaceTM https marketplace ptc com apps 193540 c sdk overview Note At the time of this writing the C SDK version was 2 2 1 1321 2 Create a C Workspace...

Page 9: ...ProSoft Technology Inc Page 9 of 49 2 3 ThingWorx Hosted Evaluation Server Go to the ThingWorx Developer Portal and sign up for a free 30 day trial hosted Evaluation Server The Developer Portal can be...

Page 10: ...ATE SERVER button This will take a few minutes 3 The Server Status will move to Provisioning and then to Running 4 Notice that the Password has an option to Copy to clipboard 5 Click COPY TO CLIPBOARD...

Page 11: ...art Guide ProSoft Technology Inc Page 11 of 49 2 3 2 Get the AppKey Find the AppKey on the ThingWorx server s development page 1 From the main menu go to Browse Security Application Keys TWX AppKey 2...

Page 12: ...werShell is already enabled on your Windows 10 PC Ensure that it is enabled as it is necessary for running Docker commands Information on how to enable or install PowerShell can be found here https do...

Page 13: ...ate user Some Docker files will be stored in your Windows 10 User folder You can use your existing Windows login ID or create a new one Also the root folder of source code files C Workspace needs to b...

Page 14: ...ogy Inc 3 3 Overwrite JSON files 1 Navigate to C Workspace ThingWorx edge c sdk src thirdParty cJSON 2 Copy the 2 files from C Workspace cJSON and copy them over the files in C Workspace ThingWorx edg...

Page 15: ...R_USER bfluser SHARED_FOLDER_PASSWORD passwd Replace the IP address shown 192 168 1 73 with the PC s IP address Replace the user id shown bfluser with your user ID from step 3 1 Replace the password s...

Page 16: ...MVI56E LDM ControlLogix Platform Quick Start Guide ThingWorx Add On Page 16 of 49 ProSoft Technology Inc...

Page 17: ...e the 2nd Ethernet port to connect to the Internet 3 Connect the PC via USB to a 1756 EN2T module 4 Optionally connect the 3rd port serial on the module to the PC This is for debugging purposes using...

Page 18: ...MVI56E LDM ControlLogix Platform Quick Start Guide ThingWorx Add On Page 18 of 49 ProSoft Technology Inc...

Page 19: ...ication 6 1 Check the Certificate Dates In C Workspace ThingWorx ldm sample app mvi56e double click on the root_ca cer file and confirm that the current date is valid If the hosted ThingWorx CA certif...

Page 20: ...re proceeding 1 Download the firmware file that was just built to the module via the module s webpage Refer to MVI56E LDM Developer Manual for details 2 At the end of the Firmware Update process the m...

Page 21: ...Start Guide ProSoft Technology Inc Page 21 of 49 6 3 Set the MVI56E LDM s Ethernet IP Addresses Set the MVI56E LDM s Ethernet port IP addresses by modifying the etc network interfaces file on the modu...

Page 22: ...server Host Defines host name or IP address of the server If the module is not connected to the Internet where ThingWorx server runs this can be the IP address of the PC in the local network where fo...

Page 23: ...imeWithPlc A flag indicating if system time should be synchronized with the PLC 0 Default value Synchronize once if current system year is less than 2019 which is usually the case after system restart...

Page 24: ...al or by rebooting the module the latter option requires existence of the script etc init d S88 tw which is installed by Firmware Update 6 5 Running of sample application The sample application was in...

Page 25: ...of the user s data that will be created in the ThingWorx Server instance The ThingWorx C Edge SDK that was previously downloaded includes a SteamSensor XML file 1 In the ThingWorx server click IMPORT...

Page 26: ...to see the SteamSensor mashup in the list of mashups Mashup is a graphical screen design unit in ThingWorx 6 Click the SteamSensor mashup to open the designer page 7 The mashup shows the GUI widgets i...

Page 27: ...the Sample Application ThingWorx Add On Quick Start Guide ProSoft Technology Inc Page 27 of 49 8 In the runtime view the Connected label will display with a green checkmark indicating the ThingWorx se...

Page 28: ...MVI56E LDM ControlLogix Platform Quick Start Guide ThingWorx Add On Page 28 of 49 ProSoft Technology Inc...

Page 29: ...the server The certificate root_ca cer file copied to the MVI56E LDM belongs to Digital Signature Trust Co a well known Certificate Authority which is a parent of SSL certificates used in ThingWorx t...

Page 30: ...d In case of using local instance of ThingWorx server with SSL certificate which is issued by root CA certificate other than Digital Signature Trust Co that root CA certificate should be saved in file...

Page 31: ...ft Technology Inc Page 31 of 49 2 As a result the SSL certificate will be displayed in new window Click on Certificate Path tab to display the certificates chain 3 Select root level certificate entry...

Page 32: ...rolLogix Platform Quick Start Guide ThingWorx Add On Page 32 of 49 ProSoft Technology Inc 4 In new window select Details tab page and click on the COPY TO FILE button 5 The Certificate Export Wizard w...

Page 33: ...lling Root CA Certificate ThingWorx Add On Quick Start Guide ProSoft Technology Inc Page 33 of 49 6 Select format Base 64encoded X 509 CER and click on NEXT button 7 Select location and file name to e...

Page 34: ...prefer and in that case modify the configuration file config json to reference the different name 9 Click on the FINISH button to complete export 10 Once saved the certificate needs to be copied to t...

Page 35: ...age 35 of 49 8 ThingWorx LDM Interface Library This section is intended for developers building custom applications using the library It describes high level design of the library and main API functio...

Page 36: ...ile and optionally pointer to the function to get application key used to connect to ThingWorx Server In case of success function returns 0 int tw_ldm_connect void This function connects to the ThingW...

Page 37: ...ect state of the PLC connection If this field omitted or set to empty value then this function will not be called int tw_ldm_get_status char is_verbose char buffer uint16_t max_size Used to get inform...

Page 38: ...ace lib registers callback functions at the ThingWorx C Edge SDK Note that callback function to read values is then called one time per each Thing with the rate equal to smallest scan rate of all tags...

Page 39: ...operty and SetStringProperty They both take 2 arguments name for thing s property name and value to pass value The service SetNumericProperty is intended to write numeric values as well as Boolean typ...

Page 40: ...eated for each property This calls the remote SetNumericProperty or SetStringProperty service For example the screenshot below shows a definition of the local service SetPressure You can see that it i...

Page 41: ...I56E LDM Description 1 C Workspace ThingWorx ldm sample app mvi56e Release tw ldm sample app mvi56e psft sample tw ThingWorx LDM sample application 2 C Workspace ThingWorx ldm sample app mvi56e config...

Page 42: ...tw on the MVI56E LDM Sample application executable binary used for the Firmware Update process on the module s webpage Generally this file is not FTP ed to the module 9 2 Running of Sample Application...

Page 43: ...he sample application Ensure the Prerequisites and Development Environment Setup is done first 10 1 Build using Visual Studio The Visual Studio 2017 solution file located at C Workspace ThingWorx ldm...

Page 44: ...and type these commands Powershell Set ExecutionPolicy ExecutionPolicy RemoteSIgn Scope LocalMachine Set ExecutionPolicy ExecutionPolicy RemoteSign Scope CurrentUser 5 In the Solution Explorer click o...

Page 45: ...ing this process 1 Product Version Number 2 System architecture 3 Network details If the issue is hardware related we will also need information regarding 1 Module configuration and associated ladder...

Page 46: ...88 neasia prosoft technology com Languages spoken English Chinese Japanese Korea Phone 60 3 7941 2888 korea prosoft technology com Languages spoken English Korean Regional Office Phone 33 0 5 34 36 87...

Page 47: ...la prosoft technology com Andean Countries Central America Caribbean Chile Bolivia Paraguay Phone 507 6427 48 38 andean prosoft technology com Languages spoken Spanish English REGIONAL TECH SUPPORT s...

Page 48: ...MVI56E LDM ControlLogix Platform Support Service Warranty ThingWorx Add On Quick Start Guide ProSoft Technology Inc Page 48 of 49...

Page 49: ...6 7 12 15 44 F Firmware Update 20 24 41 42 H Host 22 How to Contact Us 2 Hyper V 12 I interfaces 20 21 IP address 15 22 41 J JSON 7 14 22 36 P PLC 5 23 37 39 PowerShell 12 15 PTC 7 8 29 S sample app...

Search results

Summary of Contents for MVI56E-LDM

Reviews:

Related manuals for MVI56E-LDM

Brands by name

Popular brands

ProSoft Technology MVI56E-LDM, Quick Start Manual

Search results

Summary of Contents for MVI56E-LDM

Reviews:

Related manuals for MVI56E-LDM

Brands by name

Popular brands