ProSoft Technology MVI56E-LDM Manuale utente

MVI56E-LDM

ControlLogix Platform

Linux Development Module

ThingWorx® Add-On

January 9, 2020

QUICK START GUIDE

Page 2 of 49 ProSoft Technology, Inc.

Your Feedback Please

We always want you to feel that you made the right decision to use our products. If you have suggestions,

comments, compliments or complaints about our products, documentation, or support, please write or call us.

How to Contact Us

ProSoft Technology, Inc.

+1 (661) 716-5100

+1 (661) 716-5101 (Fax)

www.prosoft-technology.com

[email protected]

MVI56E-LDM ThingWorx Quick Start Guide

January 9, 2020

ProSoft Technology®, is a registered copyright of ProSoft Technology, Inc. All other brand or product names are

or may be trademarks of, and are used to identify products and services of, their respective owners.

In an effort to conserve paper, ProSoft Technology no longer includes printed manuals with our product

shipments. User Manuals, Datasheets, Sample Ladder Files, and Configuration Files are provided at our

website: www.prosoft-technology.com

MVI56E-LDM ♦ ControlLogix Platform Contents

ThingWorx® Add-On Quick Start Guide

ProSoft Technology, Inc. Page 3 of 49

Contents

Your Feedback Please........................................................................................................................2

How to Contact Us..............................................................................................................................2

1Start Here 5

1.1 Introduction................................................................................................................5

1.2 Development Environment........................................................................................6

2Prerequisites 7

2.1 MVI56E-LDM-TW .zip file..........................................................................................7

2.2 Source Code for the ThingWorx Edge C SDK..........................................................8

2.3 ThingWorx Hosted Evaluation Server.......................................................................9

2.3.1 Launch the ThingWorx Server ................................................................................10

2.3.2 Get the AppKey.......................................................................................................11

2.4 Turn on Hyper-V......................................................................................................12

2.5 Docker.....................................................................................................................12

3Development Environment Setup 13

3.1 Create user..............................................................................................................13

3.2 Share folder.............................................................................................................13

3.3 Overwrite JSON files...............................................................................................14

4Build 15

5Connect to the MVI56E-LDM 17

5.1 Physical Connections..............................................................................................17

5.2 Configuring the ControlLogix Processor .................................................................17

6Run the Sample Application 19

6.1 Check the Certificate Dates.....................................................................................19

6.2 Install the Sample Application.................................................................................20

6.3 Set the MVI56E-LDM’s Ethernet IP Addresses ......................................................21

6.4 Configuration of the Sample Application.................................................................22

6.4.1 Set the Host.............................................................................................................22

6.4.2 Set the AppKey .......................................................................................................22

6.4.3 Structure of the Configuration File ..........................................................................22

6.5 Running of sample application................................................................................24

6.6 Import Sample Entities............................................................................................25

7Installing Root CA Certificate 29

7.1 Local Server Instance..............................................................................................30

Page 4 of 49 ProSoft Technology, Inc.

8ThingWorx-LDM Interface Library 35

8.1 Component Diagram............................................................................................... 35

8.2 Main API functions and Data Flow.......................................................................... 36

8.2.1 Functions Implemented by the Library ................................................................... 36

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

9Firmware Details 41

9.1 Firmware Contents ................................................................................................. 41

9.2 Running of Sample Application............................................................................... 42

10 Visual Studio 2017 Project 43

10.1 Build using Visual Studio........................................................................................ 43

11 Support, Service & Warranty 45

11.1 Contacting Technical Support................................................................................. 45

11.2 Warranty Information .............................................................................................. 47

Index 49

MVI56E-LDM ♦ ControlLogix Platform Start Here

ThingWorx® Add-On Quick Start Guide

ProSoft Technology, Inc. Page 5 of 49

1 Start Here

This Quick Start Guide will help you:

Setup your LDM Development Environment

Build a sample ThingWorx application program

Run the ThingWorx application program

1.1 Introduction

The ThingWorx-LDM-interface-lib is a software library (available for free at

www.prosoft-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.

The sample application can be used as-is. This document will provide step-by-

step instructions on how to create the sample application. You can also extend

the features of the sample application to suit your needs.

Our goal is to read and write data from the PLC to and from ThingWorx. This will

be accomplished by running the sample application on the MVI56E-LDM,

connected to the ThingWorks Server.

Start Here MVI56E-LDM ♦ ControlLogix Platform

Quick Start Guide ThingWorx® Add-On

Page 6 of 49 ProSoft Technology, Inc.

The Quick Start Guide provides the steps to install the software onto a Windows

10 PC, build the sample application, 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

previous ProSoft Technology LDM module, you may have setup a Linux Debian

6 Virtual Machine. The ThingWorx C library SDK will not compile on Debian 6, so

this guide will step you through using a Docker® container on a Windows 10 PC.

MVI56E-LDM ♦ ControlLogix Platform Prerequisites

ThingWorx® Add-On Quick Start Guide

ProSoft Technology, Inc. Page 7 of 49

2 Prerequisites

2.1 MVI56E-LDM-TW .zip file

Navigate to the MVI56E-LDM product page at www.prosoft-technology.com, and

download the zip file MVI56E-LDM-TW-xxx.zip (where xxx is version number).

On your PC, create a folder C:\Workspace. Save and unzip this file in this folder.

The interface library contains the following components:

C:\Workspace\

Subfolder

Description

cJSON

Files to overwrite the JSON files 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-

interface-lib

ThingWorx-LDM Interface Library

build

Folder where target binaries are created during

build

docker

Toolchain to build source code and Docker

configuration files to start container with build

environment.

entities

Specific files for ThingWorx sample

scripts

Build scripts

tw-ldm-interface-lib

Header files of the library

ThingWorx-ldm-

sample-app-mvi56e

Optional Visual Studio project files for sample

application

sample-app-mvi56e-

sln

Option Visual Studio 2017 solution file for sample

application

Prerequisites MVI56E-LDM ♦ ControlLogix Platform

Quick Start Guide ThingWorx® Add-On

Page 8 of 49 ProSoft Technology, Inc.

2.2 Source Code for the ThingWorx Edge C SDK

1 Download the C-SDK (c-sdk-2-2-1-1321.zip) file 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 folder on your PC, and copy the .zip file into it,

and unzip it. It will be unzipped into a folder c-sdk-2.2.1.1321-master.

Rename it to ThingWorx-edge-c-sdk.

3 You should now have C:\Workspace with these folders:

MVI56E-LDM ♦ ControlLogix Platform Prerequisites

ThingWorx® Add-On Quick Start Guide

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 found here:

https://developer.thingworx.com/login?returnURL=%2Fen%2Fprofile%2Fhosting

Prerequisites MVI56E-LDM ♦ ControlLogix Platform

Quick Start Guide ThingWorx® Add-On

Page 10 of 49 ProSoft Technology, Inc.

2.3.1 Launch the ThingWorx Server

1 Log in to the ThingWorx Evaluation Server.

2 Click the CREATE 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, as it is required to login to the server. Paste it

somewhere (such as Notepad) for later reference.

6 Make note of the Hostname.

7 When ready, click the LAUNCH button. It will option the ThingWorx GUI in

Composer mode.

Indice

Altri manuali ProSoft Technology Unità di controllo

ProSoft Technology

ProSoft Technology InRAX MVI46-PDPS Manuale utente

ProSoft Technology

ProSoft Technology MVI69-GSC CompactLogix Manuale utente

ProSoft Technology

ProSoft Technology inRax MVI69-101M Manuale utente

ProSoft Technology

ProSoft Technology PLX51-HART-4I Manuale utente

ProSoft Technology

ProSoft Technology PLX51-HART-4O Manuale utente

ProSoft Technology

ProSoft Technology MVI69E-MBTCP Manuale utente

ProSoft Technology

ProSoft Technology MVI69E-LDM-MQTT Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI46-PDPMV1 Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI56-S3964R Manuale utente

ProSoft Technology

ProSoft Technology ControlLogix MVI56E-SMGC Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI56-GEC Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI56-HART Manuale utente

ProSoft Technology

ProSoft Technology MVI71-GEC Manuale utente

ProSoft Technology

ProSoft Technology MVI56E-MCM Manuale utente

ProSoft Technology

ProSoft Technology MVI69E-GSC Manuale utente

ProSoft Technology

ProSoft Technology MVI69-GEC Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI46-GEC Manuale utente

ProSoft Technology

ProSoft Technology inRAX MVI69-S3964R Manuale utente

ProSoft Technology

ProSoft Technology ProTalk PTQ-104C Manuale utente

ProSoft Technology

ProSoft Technology MVI56E-SIE Manuale utente

ProSoft Technology

ProSoft Technology inRAx MVI56-CAS Manuale utente

ProSoft Technology

ProSoft Technology MVI56E-LDM-MQTT Manuale utente

ProSoft Technology

ProSoft Technology inRax MVI56-DNPSNET Manuale utente

ProSoft Technology

ProSoft Technology inRax MVI56-DH485R Manuale utente

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente