Micro Application Example - Siemens AG of Contents Micro Automation Set 21 - SOAP Beitrags-ID...
-
Upload
nguyendiep -
Category
Documents
-
view
231 -
download
0
Transcript of Micro Application Example - Siemens AG of Contents Micro Automation Set 21 - SOAP Beitrags-ID...
Micro Application Example
Wireless Data Communication based on GPRS
Web Visualization Using WinCC flexible and SOAP
Table of Contents
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
V1.0 25.02.2008 2/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Note The Micro Automation Sets are not binding and do not claim to be complete regarding their configuration, equipment and any eventuality. The Micro Automation Sets do not represent customer-specific solutions. They are only intended to provide support for typical applications. You are responsible for ensuring that the described products are correctly used. These Micro Automation Sets do not relieve you of the responsibility of safely and professionally using, installing, operating and servicing equipment. When using these Micro Automation Sets, you recognize that Siemens cannot be made liable for any damage/claims beyond the liability clause described. We reserve the right to make changes to these Micro Automation Sets at any time without prior notice. If there are any deviations between the recommendations provided in these Micro Automation Sets and other Siemens publications – e.g. Catalogs – the contents of the other documents have priority.
Warranty, Liability and Support We do not accept any liability for the information contained in this document.
Any claims against us – based on whatever legal reason – resulting from the use of the examples, information, programs, engineering and performance data etc., described in this Micro Automation Set shall be excluded. Such an exclusion shall not apply in the case of mandatory liability, e.g. under the German Product Liability Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life, body or health, guarantee for the quality of a product, fraudulent concealment of a deficiency or breach of a condition which goes to the root of the contract (“wesentliche Vertragspflichten”). However, claims arising from a breach of a condition which goes to the root of the contract shall be limited to the foreseeable damage which is intrinsic to the contract, unless caused by intent or gross negligence or based on mandatory liability for injury of life, body or health. The above provisions do not imply a change in the burden of proof to your detriment.
Copyright© 2008 Siemens A&D. It is not permissible to transfer or copy these Micro Automation Sets or excerpts of them without first having prior authorization from Siemens A&D in writing.
For questions about this document please use the following e-mail-address:
Table of Contents
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
V1.0 25.02.2008 3/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Foreword Micro Automation Sets are functional and tested automation configurations based on A&D standard products for easy, fast and inexpensive implementation of automation tasks for small-scale automation. Each of the available Micro Automatic Sets covers a frequently occurring subtask of a typical customer problem on the low-end performance level.
The sets help you to obtain answers with regard to required products and the question of how they function when combined.
However, depending on the system requirements, a variety of other components (e.g. other CPUs, power supplies, etc.) can be used to implement the functionality on which this set is based. Please refer to the respective SIEMENS A&D catalogs for these components. The Micro Automation Sets are also available by clicking the following link:
http://www.siemens.de/microset
Table of Contents
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
V1.0 25.02.2008 4/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Table of Contents
Table of Contents ......................................................................................................... 4
1 Micro Automation Set 21 and SOAP ............................................................. 5 1.1 Requirements ................................................................................................... 5 1.2 Benefits............................................................................................................. 5
2 Function Principle .......................................................................................... 6 2.1 Services for Remote Operation and Visualization ............................................ 6 2.2 Web-based Remote Operation with SOAP....................................................... 7 2.2.1 Variable Declaration and Write/Read Function with SOAP .............................. 7 2.2.2 Cyclic Reading by Means of JavaScript ........................................................... 9 2.2.3 Using Form Fields in the HTML Document..................................................... 10
3 Configuring the Startup Software ............................................................... 11 3.1 Preliminary Remarks ...................................................................................... 11 3.2 Downloading the Startup Code....................................................................... 11 3.3 Configuring Components ................................................................................ 12 3.4 Configuring the Network Neighborhood.......................................................... 12 3.5 Starting WinCC flexible SOAP Project at Central Station ............................... 13 3.6 Configuring Web Server at Central Station..................................................... 13 3.7 Configuring the Internet Explorer at Client Station ......................................... 14 3.8 Configuring the Name Resolution at Client Station ........................................ 15 3.9 Installing SOAP Toolkit 2.0 to Client Station................................................... 15
4 Live Demo...................................................................................................... 16 4.1 SOAP Web Interface “Simple” ........................................................................ 16 4.2 SOAP Web Interface “MAS21” ....................................................................... 17
Micro Automation Set 21 and SOAP
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
1 Micro Automation Set 21 and SOAP
1.1 Requirements
This description requires that you have read and understood the basic document on Micro Automation Set 21 “Set21_DocTech_vXdY_en.pdf”.
NOTE
In addition to the SIMATIC MicroBox PC “Central Station“ you will need a client PC with the following software components: Table 1-1
No. Description Type/Version
1. Operating system Windows XP Professional with Service Pack 2
2. SOAP Toolkit Microsoft SOAP Toolkit V2.0 SP2 3. Internet browser
V1.0 25.02.2008 5/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Microsoft Internet Explorer 4. WinCC flexible Sm@rtAccess No separate software; license
1.2 Benefits
Micro Automation Set 21 demonstrates the options of local operation and control on the part of the Central Station based on the incoming and outgoing process data via GPRS.
This additional document describes how to provide remote clients with the actual values that are available at the Central Station.
There, only standard software components from WinCC flexible and Microsoft Windows XP Professional are used. Figure 1-1
Mic
ro A
utom
atio
n Se
t 21
Basic Document Additional Document "SOAP"
Remote Station 1 Remote Station n Central Station
SINAUT MICRO SCWinCC flexible
Client Station
INTERNET
S7-200MD 720-3
S QC
S
S7-200MD 720-3
S
S QC
GPR
S
GPRS
Function Principle
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
2 Function Principle
2.1 Services for Remote Operation and Visualization
Sm@rtService and Sm@rtAccess To operate the control room configured in WinCC flexible from a remote place, WinCC flexible provides the services “Sm@rtService” and “Sm@rtAccess”.
Sm@rtAccess and Sm@rtService are the two options of WinCC flexible allowing you to establish communication between and with HMI systems via TCP/IP connections (e.g. LAN).
Therefore, Micro Automation Set 21 enables the operation of the WinCC flexible control room “Central Station” via the Internet or a local network. Figure 2-1
V1.0 25.02.2008 6/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Sm@rtService
Remote control via InternetExplorer (desktop view)
Remote control via Sm@rtClient application
(application view + hardware layout)
Sm@rtAccess
Data access via WinCC flexible client project
Data access via web service (SOAP) with
Internet Explorer
Described in this Document
Sm@rtAccess “SOAP” WinCC flexible provides options of using the web service (SOAP). The web service (SOAP) is based on the Simple Object Access Protocol. It enables you to access the variables of an operator panel from an external application (e.g. Internet Explorer, Microsoft Excel) via Intranet/Internet. Figure 2-2
Client StationCentral Station
INTERNET
SINAUT Micro SC
WinCCflexible
Variable rangefor localvisualization
Variable rangefor localvisualization
Variable rangeis made accessiblevia the web server
Creation of references tovariables on the remote server
with the help of SOAP Toolkit and Java Script
Creation of references tovariables on the remote server
with the help of SOAP Toolkit and Java Script
Variable rangeis made accessiblevia the web server
GetValue
SetValue
Process Value&
Acknowledgement
Function Principle
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
2.2 Web-based Remote Operation with SOAP
The linking of local input/output fields contained in an HTML form at the client station with the WinCC flexible variables at the server station shall be explained taking the example of the HTML file “startmas21simple.html”. Figure 2-3
2.2.1 Variable Declaration and Write/Read Function with SOAP
V1.0 25.02.2008 7/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Table 2-1
Line Description
9 The subsequent script is a VBScript. 10 • Declare variable (read) for filling level of Remote Station “IS”.
• Initialize variable with WinCC flexible variable structure. • Specify variables to be read always in the format
“ “ “(variable folder)\\(variable name)“ “ “. 11 • Declare and initialize variable (read) for starting the simulation
program of Remote Station “IS”. 12 • Declare and initialize variable (write) for starting the simulation
program of Remote Station “IS”. • Specify variables to be written always in the format
“ “ “(variable folder)\\(variable name)“ “ “. Create constant with the content of the file RuntimeAccess.wsdl on the “MiniWeb” web server.
15
16 Create constant with the content of the user name for logging on the “MiniWeb” web server.
Function Principle
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
V1.0 25.02.2008 8/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Line Description
17 Create constant with the content of the password assigned to the user name for logging on to the “MiniWeb” web server.
19+27 Create function for reading all declared (read) variables. 21+13 • Declare variable for the SOAP object
• Create SOAP client object. Here starts the creation of the client-to-server connection with the help of Microsoft SOAP Toolkits.
22 Here you specify the “path” to the server-sided file “RuntimeAccess.wsdl” for the SOAP client object.
23+24 Here you give the SOAP client the necessary information for logging on to the Sm@rtAccess (SOAP) service of the WinCC flexible server.
25+26 • Here you assign a value to input/output fields created in the HTML site.
• The value to be assigned will be read from the WinCC flexible tag management via the SOAP connection.
• As read command always use (SOAP object).GetValue((variable folder+variable name)).
29+40 Create function for writing all declared (write) variables. When calling up this function, the name of the calling input/output field and the actual value will be transferred.
30-33 See 21 to 24. 34+38 Execute the IF instruction only if the “ENTER“ key in the
input/output field has been pressed. 35+37 Execute the IF instruction only if the field name of the input/output
field corresponds to “in_out_start_demo”. Here you can add later on several input/output fields in the HTML document and always assign a unique field to the write command.
36 • Here a value will be read from the input/output fields created in the HTML site.
• The value read will be written into a variable from the WinCC flexible tag management via the SOAP connection.
• As write command always use (SOAP object).SetValue((variable folder+variable name), (value)).
Function Principle
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
2.2.2 Cyclic Reading by Means of JavaScript
Figure 2-4
V1.0 25.02.2008 9/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Table 2-2
Line Description
42 The subsequent script is a JavaScript. 43-46 Declaring and/or initializing variables.
This function will be started upon the first call of the HTML site. This function is the trigger to initialize the timer.
48 ff.
52 ff. This function initializes the timer with 10 seconds. 59 ff. This function terminates the timer.
This is the main function whereby the timer controls the refreshment of the reading values.
66
Once the timer is terminated, the function for reading all of the implemented variables will be called up.
68 ff.
The time to refreshment of all of the implemented variables is indicated in the status bar in the lower left corner of the Explorer. The timer counts down by ”1” every second. The function “StartTheTimer“ calls itself up automatically every 1000ms.
73 ff.
Function Principle
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
2.2.3 Using Form Fields in the HTML Document
Figure 2-5
Table 2-3
V1.0 25.02.2008 10/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Line Description
The event onLoad, i.e. the first opening of this HTML site, calls up the function ReadAllValues() from the VBScript Chapter 2.2.1.
84
The form name of the document is “Soap“. Through this form name you can address all form fields existing therein.
85
Here you create the input/output field “out_fill_level” for the output of the actual filling level. The property „readonly“ allows only reading access to the field (reading from the view of the calling function).
97
Here, the input/output field “in_out-start_demo” for starting the simulation program in the Remote Station “IS” is generated. Read and write access to this field is possible. When writing a new value into this field and pressing the “ENTER” key, the function WriteThisValue() will be called up. In the course of this, field name and actual value are passed on.
106
Configuring the Startup Software
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
V1.0 25.02.2008 11/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
3 Configuring the Startup Software
3.1 Preliminary Remarks
For the startup, we offer you a software example with the Startup Code for download. The software example supports you during the first steps and tests with this Micro Automation Set. It enables quick testing of the hardware and software interfaces between the products described in the Micro Automation Sets.
The software example is always related to the components used in the set and shows their principal interaction. However, it is not a real application in the sense of technological problem solving with definable properties.
3.2 Downloading the Startup Code
The software example is available on the HTML page from which you downloaded this document. Table 3-1
No. File name Contents
1. MAS21_WinCCFlex_SOAP_V1d0_en.hmi
Project file for WinCC flexible with activated “SOAP” service
2. MAS21_WinCCFlex_SOAP_V1d0_en.fwx
Runtime file for WinCC flexible with activated “SOAP” service
3. HTML_Client_V1d0.zip SOAP client in form of HTML files with Java Script. Simple version.
4. HTML_Client_MAS21_V1d0.zip
SOAP client in form of HTML files with Java Script. Complex version, especially for MAS21.
Configuring the Startup Software
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
3.3 Configuring Components
The chapter below shows the following configuration:
• “MiniWeb” web server by Central Station
• SOAP client by Client Station
In the basic document you will find the description of the configuration of the SINAUT Micro SC Server and the S7-200 Remote Stations. Use the file from Chapter 3.2, which has been adapted to the SOAP service, as WinCC flexible project. Table 3-2
No. Device Component Basic Document Additional Document
5. SINAUT Micro SC Yes No
6. WinCC flexible1 Yes No
7.
Central Station
Web Server No Yes
8. Installation, wiring Yes
V1.0 25.02.2008 12/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
No
9. Parameterizing the S7-200 controller Yes No
10.
Remote Station
Log-on procedure Remote Stations Yes No
11. Installation SOAP Toolkit No Yes
12.
Client Station
Creating SOAP client No Yes
13. All Configuring network neighborhood No Yes
1) Use the project file (Chapter 3.2) provided separately
3.4 Configuring the Network Neighborhood
To demonstrate the functionality of SOAP, configure the infrastructure of all Ethernet stations as follows: Figure 3-1
Client Station
Central Station
SINAUT Micro SC
WinCCflexible
IP Address (ext., fix):Provider-dependent
LAN
INTERNET
IP Address: 192.168.2.55
IP Address (ETH1): 192.168.2.127
WAN
IP Address (int.):192.168.2.X
Configuring the Startup Software
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
3.5 Starting WinCC flexible SOAP Project at Central Station
Table 3-3
No. Instructions Remarks
1. Start the WinCC flexible Runtime file listed in Table 3-1, No. 2.
MAS21_WinCCFlex_SOAP_V1d0_en.MAS21 Central Station.fwx
2. Make sure that the Remote Stations and Micro SC work properly.
Description in basic document “Set21_DocTech_vXdY_en.pdf”
3.6 Configuring Web Server at Central Station
Table 3-4
No. Instructions Remarks
1. Navigate to the folder C:\Program Files\Siemens\SIMATIC WinCC flexible\WinCC flexible 2007 Runtime\WebContent.
V1.0 25.02.2008 13/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
2. Extract the file
“startmas21simple.html” listed in Table 3-1, No. 3 into the folder “WebContent”.
3. Restart the “MiniWeb“ web server
from WinCC flexible. For this purpose, terminate the web server by right-clicking the icon and selecting the option “Exit”.
4.
To restart the “MiniWeb“ web server, navigate to the folder C:\Program Files\Siemens\SIMATIC WinCC flexible\WinCC flexible 2007 Runtime\. Double-click the file “MiniWeb.exe“.
The start of WinCC flexible Runtime automatically activates the web server, too. (Provided that the option “Sm@rtAccess: Web Service (SOAP)” has been selected). The table above describes the manual procedure to terminate and start the web server.
Note
Configuring the Startup Software
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
The root directory of the “MiniWeb” web server is “C:\..\WebContent”. The autostart HTML file is “start.html”. Do NOT overwrite or delete this file before you have made a backup copy.
Note
3.7 Configuring the Internet Explorer at Client Station
Table 3-5
No. Instructions Remarks
1. Open the Internet Explorer to add the server name of the Central Station to the Trusted Sites list.
2.
V1.0 25.02.2008 14/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
For this, open the Internet Options via “Extras/Internet Options”. Select the “Security” tab and mark the “Trusted Sites” icon, Click the button “Sites...”.
3.
Deactivate the checkbox „Require server verification (https:) for all sites in this zone“. Enter “mas21server” into the input line “Add this Web site to the zone:”. Click the button “Add”. Close all open windows with “OK”.
Configuring the Startup Software
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
3.8 Configuring the Name Resolution at Client Station
Table 3-6
No. Instructions Remarks
1. Set the name resolution for your web server. For this, navigate to the directory C:\WINDOWS\system32\drivers\etc.
2. Open the “hosts” file using Notepad.
3.
V1.0 25.02.2008 15/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Add to the list the IP address and the server name of the Central Station. (Here: “mas21server”.) Save and close the document.
3.9 Installing SOAP Toolkit 2.0 to Client Station
Table 3-7
No. Instructions Remarks
1. Make sure that Microsoft SOAP Toolkit 2.0 has been installed. Otherwise proceed with No. 2.
2. Download the installation file from
http://www.microsoft.com/downloads. For this, search by the terms “Soap Toolkit 2/3.0 new supported toolkit”.
3. Install the software by following the installation instructions of the wizard.
Live Demo
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
4 Live Demo
4.1 SOAP Web Interface “Simple”
The HTML SOAP client “simple“ does not show the entire functionality of WinCC flexible interfaces. Here, the main focus is on a function test of all stations. The following variables will be visualized.
• Fill level of Remote Station “Inspection Shaft (IS)” (read)
• Button for starting the simulation program at the Remote Station “Inspection Shaft (IS)” (read/write)
Starting SOAP Web Interface “Simple” Table 4-1
No. Instructions Remarks
4. Start the Internet Explorer.
V1.0 25.02.2008 16/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
5. Enter the web server address and the
specified HTML site into the address line. http://mas21server/startmas21simple.html.
Confirm with “Enter”.
Operating the SOAP Web Interface “Simple” Figure 4-1
1
23
Table 4-2
No. Description
Displaying the actual fill level of the Remote Station “Inspection Shaft“. Being refreshed every 10 seconds.
1
Starting the simulation program. Enter the value “1” and confirm with “Enter”. Being reset automatically.
2
3 Remaining time to refresh all values.
Live Demo
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
4.2 SOAP Web Interface “MAS21”
The HTML SOAP client “MAS21“ shows nearly the entire functionality of WinCC flexible interfaces.
Starting the SOAP Web Interface “MAS21” Table 4-3
No. Instructions Remarks
1. Perform the steps described in Chapter 3.6 at the Central Station. Use the HTML and GIF files from Table 3-1, No. 4.
2.
V1.0 25.02.2008 17/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
Start the Internet Explorer at the Client Station.
3. Enter the web server address and the specified HTML site into the address line. http://mas21server/startmas21.html.
Confirm with “Enter”.
Live Demo
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
Operating the SOAP Web Interface “MAS21” The layout of the web visualization screens is the same as that of the WinCC flexible operator screens in the basic document Set21_DocTech_vXdY_en.pdf Chapter 5.1.
The operation is nearly identical. Exceptions are explained below.
For the Live Demo use the relevant chapter from the basic document.
Web Visualization - Application View Figure 4-2
V1.0 25.02.2008 18/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
1
1
2
3
3
4
4
Table 4-4
No. Description
Switches (not pushbuttons) are assigned a value (0 or 1) via the keyboard. This value is sent to the Central Station by pressing the “Enter” key.
1.
2. Alarm messages will not be displayed. 3. Dry run of the pumps will not be indicated. 4. The pushbutton “Refresh Data“ updates
• the process variables in the WinCC flexible Central Station • the process variables on these web visualization screens
Live Demo
Micro Automation Set 21 - SOAP Beitrags-ID 22537809
Web Visualization - Communication View Figure 4-3
V1.0 25.02.2008 19/19
Cop
yrig
ht ©
Sie
men
s A
G 2
008
All
right
s re
serv
ed
Set
21_S
OA
P_D
ocTe
ch_v
1d0_
en.d
oc
1
1
Table 4-5
No. Description
1. The pushbutton “Refresh Data“ updates • the process variables in the WinCC flexible Central Station • the process variables on these web visualization screens