Table of Contents

1. INTRODUCTION 4

Purpose 4

Prerequisites 4

1. GENERAL PURPOSE LIBRARY DOWNLOAD 5

Extracting the Zipped Files 6

1. ECOSTRUXURE CONTROL EXPERT 7

Installation 7

Opening and Deploying the Demonstration Project 8

1. OPC FACTOR SERVER (OFS) 12
2. WONDERWARE SYSTEM PLATFORM 13

Windows Users and Groups 13

Creating the Galaxy Demonstration Project 13

Intouch Application Migration 15

WindowViewer Application 19

• • 1. Method 1 19
    2. Method 2 21

ParameterSet Configuration 21

Purpose

1

Introduction

The aim of this document is to provide a step by step guide for the installation and setup of the General Purpose Library (GPL) with Wonderware System Platform using the supplied Demonstration Project.

Prerequisites

The guide has been tested on the following software:

• EcoStruxure Control Expert V14.1
• OPC Factory Server (OFS) V3.62 for AVEVA / Wonderware System Platform version, using the System Platform License
• Wonderware System Platform 2017 Update 3 The General Purpose Library used:
• Modicon Libraries General Purpose 2020 for EcoStruxure Control Expert
• Modicon Libraries General Purpose for Wonderware System Platform 2018 R4

2 General Purpose Library Download

The General Purpose Library can be downloaded from Schneider Electric Exchange https://exchange.se.com, navigate to the shop and search for ‘General Purpose Library’ order and download:

• General Purpose Library for EcoStruxure Control Expert
• General Purpose Library for Wonderware System Platform 2018 R4

Extracting the Zipped Files

Both downloaded files need to be extracted due to the file name length. Rename both to GPL-CE.zip and

GPL-WSP.zip respectively.

Modicon-Libraries—General-Purpose-2020.zip => GPL-CE.zip

Modicon-Libraries—General-Purpose-for-Wonderware-System-Platform-2018-R4.zip => GPL-WSP.zip

Extract both zip files into their respective folders.

Open the GPL-WSP Folder and rename Modicon Libraries- General Purpose for System Platform – 2018 R4 – Demo Process.zip to GPL-Demo.zip and then extract into a folder.

3 EcoStruxure Control Expert

Installation

Installation has been divided into five library families:

Each family needs to be individually installed using the EcoStruxure Control Expert Types Library Update

tool.

1. Open the Types Library Update

1. Navigate to the folder “GPL-CE\Modicon Libraries – General Purpose 2020 Setup\GPL_Communication” and select FAMILY.DSC
2. Select the Install family button after a few seconds an Installation has succeeded dialog box will appear
3. Repeat for:
   • GPL_Devices
   • GPL_Diagnostics
   • GPL_Process
   • GPL_SignalConditioning
4. The Library installation is complete

Opening and Deploying the Demonstration Project

1. Once the General Purpose Library has been installed, start EcoStruxure Control Expert. On starting a warning will appear – please ignore and select OK

1. Open the Demonstration Project by selecting Open
2. Change the folder to “GLP-WSP\Modicon Libraries – General Purpose for Wonderware System Platform 2018 R4\GPL-Demo\Unity V13 Project” and change the file type to STA
3. Select the demoprocess_fat_20181205.sta

Select Update with latest version available

1. Once opened, select Tools > Project Settings >Common
2. Select checkbox Enable implicit type conversion

1. There is an upgrade error within the block MBSEPAM80C – this has been reported and will be fixed in the next release. As this is a demonstration, we can simply remove the block.
2. Open the logic section called iPMCC and locate RL1001_SEPAM which uses the function block

MBSEPAM80C and delete the function block

1. Open Variables & FB instances and select the Function Blocks Tab and search for

*RL1001_SEPAM*

1. Select RL1001_SEPAM and Delete
2. Open the Derived FB Types and delete the function block MBSEPAM80C

1. Select Build > Rebuild All Project, accept the default dialog boxes
2. Save the project
3. Now deploy the project to the Simulator

4 OPC Factory Server (OFS)

Configure OFS Server

1. Open the OFS Configuration Tool
2. Select File > Open Archive

Navigate to the folder GLP-WSP\Modicon Libraries – General Purpose for Wonderware System Platform 2018 R4\GPL-Demo\OFS 3.50.2912.0 Configuration File

1. Select Backup-20171214.xml

1. Select File > Save Configuration
2. If the OFS Server is running it will need to be restarted before the new configuration will take effect

5 Wonderware System Platform

Windows Users and Groups

The Demonstration Project has been designed using Windows Group Security and the PC requires the following groups to be defined:

• • PCSAdministrators (mandatory to open the Galaxy)
  • PCSEngineers
  • PCSOperators
  • PCSSupervisors

Assign the current user to the PCSAdministrators group

Creating the Galaxy Demonstration Project

To create a Galaxy based on the Demonstration Project follow the steps below:

Copy the file GPL DemoProcess 20181130.cab from GLP-WSP\Modicon Libraries – General Purpose for Wonderware System Platform 2018 R4\GPL-Demo\Galaxy Backup

1. Paste the file to C:\Program Files (x86)\ArchestrA\Framework\Bin\BackupGalaxies

1. Open System Platform IDE
2. Select New Galaxy and set the name to GPLDemo and select the Galaxy type as GPL DemoProcess 20181130

1. Click Create
2. You will be required to log into SQL for authentication. It’s recommended you include the Computer Name and Username, e.g., DESKTOP-S07N0QU\Admin and click OK

1. Creating the Galaxy will take some time

1. Once completed, select the Connect button

1. If the Demonstration Galaxy version supplied is different to the Wonderware System Platform installed, the user will be asked to migrate. Note: this can take over an hour and cannot be aborted or cancelled. If you are happy to continue, select Yes.

Once finished the IDE will open

Intouch Application Migration.

Follow the step by step guide to Migrate Intouch:

1. Select the Derivation Tab at the bottom and Navigate to $Demoprocess
2. Select $Demoprocess and Right Click > Open

1. Click OK to the Dialog ArchestrA IDE

1. After a few seconds a WindowMaker popup will appear asking ‘Do you want to migrate the application’ Select Yes

1. You will be asked ‘Do you want to Backup this application’ – select No

1. Depending upon your resolution, WindowMaker will create another popup asking to convert the resolution – click Yes

1. WindowMaker will open and the Migration will start. Each page will be opened and updated. Once finished, select DemoMain and OK.

1. Within WindowMaker Select File > Exit

1. Click the Deployment Tab and select PSxWinPlatform_001 and Right Click > Deploy

1. Leave the default values and click OK (it will take several minutes to deploy)

WindowViewer Application

There are two methods of opening the WindowViewer:

Method 1

• • • 1. Select the Model Tab and open Demoprocess_001

• • • 1. If a popup appears asking to allow editing of derived template, click Yes

• • • 1. Cancel the popup asking to Open Window and select Runtime button (top right corner)

• • • 1. WindowViewer will Start

Method 2

Select Start Menu > Wonderware InTouch > InTouch Application Manager

• • • 1. Select $PSxDemoprocess > right click WindowViewer

• • • 1. WindowViewer will Start

ParameterSet Configuration

To use the ParameterSet functionality a Database called ParameterSets needs creating within SQL Server and the supplied backup database restoring:

Copy the folder GLP-WSP\Modicon Libraries – General Purpose for Wonderware System Platform 2018 R4\GPL-Demo\Parameter Sets to C Drive

1. Open the SQL Server Management Studio
2. Right click on Database and select New Database

1. Name the Database ParameterSets

1. Select the ParameterSets > Right Click >Tasks > Restore > Database

1. Select Device and the Folder selection Button
2. Select Add and Navigate to C Drive/Parameter Sets/ GPL DemoProcess PS database 20161115 Note: to select the file change the extension filter to *.*

1. Select the options tab and select the following checkboxes:
   1. Overwrite the existing database
   2. Close existing Connections to destination database Once selected, click the OK button

1. Once the database has been restored, it is possible to now open the Parameter Set within the WindowsViewer