Application Example AC500 Scalable PLC for Individual Automation Webserver Login Application Example With PM564-ETH abb
Content 1 Disclaimer... 2 1.1 For customers domiciled outside Germany/ Für Kunden mit Sitz außerhalb Deutschlands... 2 1.2 Nur für Kunden mit Sitz in Deutschland... 2 2 Application Example for Webserver login... 3 2.1 Content and structure of application example WEB_Login.project... 3 2.2 Configuration in Control Builder Plus... 3 2.2.1 Login visualization PLC_VISU... 5 2.2.2 Visualization vmain... 6 2.2.3 Visualizations vpc, vtablet and vphone... 6 2.3 The Login configuration file weblogin.xml... 8 2.3.1 Content of file weblogin.xml... 8 2.3.2 Include file weblogin.xml in WEB.ZIP and download to PLC... 9 3 Check file sizes and size of visualization... 14 3.1 Offline check of file sizes... 14 3.2 Check visu files in online mode... 17 Application Example - 1 - AC500/Issue: 11.2013
1 Disclaimer for application example 1.1 For customers domiciled outside Germany/ Für Kunden mit Sitz außerhalb Deutschlands "Warranty, Liability: The user shall be solely responsible for the use of this application example described within this file. ABB shall be under no warranty whatsoever. ABB's liability in connection with this application example or the files included within this file, irrespective of the legal ground, shall be excluded. The exclusion of liability shall not apply in the case of intention or gross negligence. The present declaration shall be governed by and construed in accordance with the laws of Switzerland under exclusion of its conflict of laws rules and of the Vienna Convention on the International Sale of Goods (CISG)." "Gewährleistung und Haftung: Der Nutzer ist allein für die Verwendung des in dieser Datei beschriebenen Anwendungsbeispiels verantwortlich. ABB unterliegt keiner Gewährleistung. Die Haftung von ABB im Zusammenhang mit diesem Anwendungsbeispiel oder den in dieser Datei enthaltenen Dateien - gleich aus welchem Rechtsgrund - ist ausgeschlossen. Dieser Ausschluß gilt nicht im Falle von Vorsatz oder grober Fahrlässigkeit. Diese Erklärung unterliegt Schweizer Recht unter Ausschluß der Verweisungsnormen und des UN-Kaufrechts (CISG)." 1.2 Nur für Kunden mit Sitz in Deutschland "Gewährleistung und Haftung: Die in diesem Anwendungsbeispiel enthaltenen Dateien beschreiben eine mögliche Anwendung der Steuerung AC500 bzw. zeigen eine mögliche Einsatzart der Steuerung. Sie stellen nur Beispiele für Programmierungen dar, sind aber keine fertigen Lösungen. Eine Gewähr kann nicht übernommen werden. Der Nutzer ist für die ordnungsgemäße, insbesondere vollständige und fehlerfreie Programmierung der Steuerungen selbst verantwortlich. Im Falle der teilweisen oder ganzen Übernahme der Programmierbeispiele können gegen ABB keine Ansprüche geltend gemacht werden. Die Haftung von ABB, gleich aus welchem Rechtsgrund, im Zusammenhang mit den Anwendungsbeispielen oder den in dieser Datei enthaltenen Dateien wird ausgeschlossen. Der Haftungsausschluß gilt jedoch nicht in Fällen des Vorsatzes, der groben Fahrlässigkeit, bei Ansprüchen nach dem Produkthaftungsgesetz, im Falle der Verletzung des Lebens, des Körpers oder der Gesundheit oder bei schuldhafter Verletzung einer wesentlichen Vertragspflicht. Im Falle der Verletzung einer wesentlichen Vertragspflicht ist die Haftung jedoch auf den vertragstypischen, vorhersehbaren Schaden begrenzt, soweit nicht zugleich ein anderer der in Satz 2 dieses Unterabsatzes erwähnten Fälle gegeben ist. Eine Änderung der Beweislast zum Nachteil des Nutzers ist hiermit nicht verbunden. Es gilt materielles deutsches Recht unter Ausschluß des UN-Kaufrechts." Only for customers with seat in Germany Warranties and Liability: The files contained in this application sample are only describing a possible use of the AC 500 control system showing a possible kind of operation of it. These are only examples of the programming features and in no way working solutions. No warranty can be accepted. Each user himself is exclusively responsible for the correct, i.e. complete and faultless programming of the control system. In case of a partial or complete adoption of programming samples no resulting claims may be asserted against ABB. In connection with the application examples or the files contained therein any liability of ABB regardless of the legal cause shall be excluded. The exclusion of liability does not apply in the case of willful misconduct or gross negligence by ABB, claims under product liability law, in case of damage to life, body or health or breach of an essential contractual obligation. In case of breach of an essential contractual obligation the liability will, however, be limited to compensation for the foreseeable damage, that is typical for this type of contract in as far as no other exceptions are listed under sentence 2 of this subparagraph is present at the same time. An amendment of the burden of proof to the disadvantage of the user shall not be associated with this. German substantive law shall apply excluding the UN Convention on the International Sale of Goods. Application Example - 2 - AC500/Issue: 11.2013
2 Application Example for Webserver login 2.1 Content and structure of application example WEB_Login.project Please copy the application example WEB_Login.project in your project folder. The application example was created in project folder C:\CBP\WEB-Visu. For the Visu and additional file the following folderstructure is used: For this reason you have to update the project folder in CoDeSys V2.3.9.x for the project AC500, if your project folder is different. In project are used the following folders: The story for this project is to have e.g. access to the PLC via WEB client from different devices as PC, Smart-Phone and/or Tablet. Each of this WEB clients has different graphic resolutions and may be should have access to different data/visualizations. Using the WEB login mechanism it is easy to call different WEB visus per Username and Password. 2.2 Configuration in Control Builder Plus In the application example a PLC PM564-ETH is used. The PLC configuration consists of Symbolic names for the Onboard inputs and outputs and the configuration of the IP settings: In the example the Webserver and the FTP-Server are activated. During Create configuration data the Webserver activation is automatically done also in CODESYS V2.3.9.x. You can check this in the CODESYS target settings in tab Visualization : Application Example - 3 - AC500/Issue: 11.2013
This application is a very simple project to show the usage of Webserver login mechanism. The project code contains only 3 counters in POU PLC_PRG: This is only to have some changing variables in the WEB visualization. The task configuration contains one task with cycle time 50 ms: Further on the CODESYS V2.3.9.x project contains 5 visualizations: Visu name Short description PLC_VISU Called from WEB client as startup visu, if not other visu is defined in webvisu.htm under: C:\Program Files\3S Software\CoDeSys V2.3\Visu in default installation: <param name="startvisu" value="plc_visu"> vmain Jump to vpc, VPhone or vtablet if you are logged in vpc WEB visu for PC vphone WEB visu for Smart-Phone vtablet WEB visu for Tablet Application Example - 4 - AC500/Issue: 11.2013
2.2.1 Login visualization PLC_VISU This is the login visualization called by JAVA applet or Smart-Phone/Tablet APP. The Login visualization can be created with the normal visu elements of CODESYS V2.3.9.x. But the following 3 elements must be included: 1. Element for input the Username This element should have the following configuration: - %s inside of Text à Content - CurrentUsername inside of Variables Textdisplay - Input Textinput of variable Textdisplay, activated with Text 2. Elemet for input the Password This element should have the following configuration: - %s inside of Text à Content - CurrentPassword inside of Variables Textdisplay - Input Textinput of variable Textdisplay, activated with Text and activated Hidden Note: during input the characters will be shown as **** 3. Element for Login This element should have the following configuration: - INTERN LOGIN inside Input à Execute program Note: The Login with Username and Password is only possible with Webserver. Using the CODESYS online visualization it does not work! Application Example - 5 - AC500/Issue: 11.2013
2.2.2 Visualization vmain The visualzation vmain has 3 buttoms and the bitmap element Home to finish the WEB visu access. Using the buttoms vphone, vtablet or vpc you can zoom to this visualizations. 2.2.3 Visualizations vpc, vtablet and vphone The visualization vpc shows the counters defined and calculated in PLC_PRG in different elements: With the Bitmap element Home you come back to visualization vmain. The other visus vtablet and vphone have the sama functionality.. Application Example - 6 - AC500/Issue: 11.2013
Note: In the example vpc and vtablet has nearly the same content. In practice they are different, e.g. because of different display resolutions. vphone with different WEB site resolution. Application Example - 7 - AC500/Issue: 11.2013
2.3 The Login configuration file weblogin.xml In addition to the normal files for the WEB visualization a file with the name weblogin.xml must be downloaded to the PLC. The content and the download mechanism for this file will be described in this chapter. Note: The name of the file cannot be changed! 2.3.1 Content of file weblogin.xml The file weblogin.xml must have the following file format: <login-config> <user> <username> Musterfrau </username> <password> Testpasswort </password> <startvisu> VISU_START </startvisu> <userid> 2 </userid> <userlevel> 3 </userlevel> </user> <user> <username> Mustermann </username> <password> Testpasswort </password> <startvisu> PLC_VISU </startvisu> <userid> 1 </userid> <userlevel> 7 </userlevel> </user> </login-config> The Login configuration for the WEB visualization must be described in this file format in file weblogin.xml. The file must be available in the <file-upload-dir> of the Webserver. For AC500 this is Userdisk/webvisu. Its possible to configure many <user>. For each <user> the following parameters must be available: <username> - the user name <password> - the password <startvisu> - the visualization which should be called after successfully login. <userid> - the user ID <userlevel> - the user level The <userid> from the login configuration is stored in the variable CurrentUserID. This variable can be used inside the visualization, e.g. to set invisible elements. The <userlevel> from the login configuration is stored in variable CurrentUserLevel. The CurrentUserLevel must be between 0-7 and influences the access rights of the visu elements. Thus <user> can be assigned to work groups. Application Example - 8 - AC500/Issue: 11.2013
For our example the file weblogin has the following content: 2.3.2 Include file weblogin.xml in WEB.ZIP and download to PLC The file weblogin.xml can be downloaded together with the CODESYS project and can be also included in the Bootproject. For this the following steps must be done: 1. Create list of additional files with Control Builder Plus Control Builder Plus offers the possibility to download additional files. This files will be included in the WEBVISU.ZIP and will be located in PLC userdisk in subfolder webvisu. Right mouse click on PLC_node opens context nmenu. Please chose entry Add additional files into download Application Example - 9 - AC500/Issue: 11.2013
The following dialog allows to add the files. For our example we need only weblogin.xml. 2. Click on Add files and select the needed files. As result all additional files are included in file: <projectname>.files.ini. We use the default PLC node name AC500, so the output file is AC500.files.ini. and the files are copied in (hidden) project subfolder C:\CBP\WEB-Visu\WEB_Login AC500_PM564_ETH AC500 3. Compile project and create Bootproject Change to CODESYS V2.3.9.x and perform Project à Clean all and Project à Rebuild all. Login in PLC (in project the IP address of PLC is 192.168.2.30), download project and Create the Boot project. The file(s) listed in AC500.files.ini are added to Webserver list file ac500vis.txt and are included in Application Example - 10 - AC500/Issue: 11.2013
WEBVISU.ZIP 4. Online test Lunch the PLC project and check the visualization at first with CODESYS online. After this lunch a WEB browser, e.g. Internet explorer and call the WEB visualization: http//192.168.2.30/webvisu.htm The JAVA applet is loaded and you get the PLC_VISU as follows: Click in the field under Username: Application Example - 11 - AC500/Issue: 11.2013
Type PC and <ENTER> Click on field Password: Type MyPC_123 and <ENTER> After this click on key Login: Application Example - 12 - AC500/Issue: 11.2013
If the password is ok, the configured in weblogin.xml page will be opened. In our case the visu vpc will be choosen: Click on Home the visu will zoom to visu vmain and you can select vpc or vtablet or vphone. Application Example - 13 - AC500/Issue: 11.2013
3 Check file sizes and size of visualization 3.1 Offline check of file sizes CODESYS V2.3.9.x for AC500 offers the possibility to show the names and the size of all files, which will be downloaded to PLC in RAM or as Bootproject in Flash. All this information can be shown in the file size dialog. Please use Online à Show file information For our example we will get the following diaglog: Here you get information about the Program data, Program code, the User disk and the Flsh. There are shown the used data, the maximum available data for this PM type and percentage of usage. Here the details of our project: Details of Program data Details of Program code Application Example - 14 - AC500/Issue: 11.2013
Details of User disk Details of Webserver files Details of User disk Application Example - 15 - AC500/Issue: 11.2013
Details of Flash Details of Flash à Configuration files Details of Flash à Flash The details for Flash à Program code and Flash à Webserver fies will be the same as shown before. Application Example - 16 - AC500/Issue: 11.2013
3.2 Check visu files in online mode In online mode you can check the files in PLC using the FTP server or also PLC browser from CODESYS V2.3.9.x or Control Builder Plus: With PLC browser use the command: filedir userdisk/webcvisu: Application Example - 17 - AC500/Issue: 11.2013
Application Example - 18 - AC500/Issue: 11.2013
Doc. kind: No. o. p.: R&D document 19 Title: Lang.: Webserver Login Application Example EN Manual No. 3ADR 025 193 M0201 abb ABB Automation Products GmbH Wallstadter Str. 59 D-68526 Ladenburg Tel. : +49 62 21 / 701-1444 Fax : +49 62 21 / 701-1382 E-Mail : plc.support@de.abb.com www.abb.com/plc