- PDF Free Download

Size: px

Start display at page:

Download ""

Ira Moore
5 years ago
Views:

1 Acyclic Reading and Writing with the Library for SIMOTION SIMOTION Siemens Industry Online Support

2 Siemens AG 2017 All rights reserved Warranty and Liability Warranty and Liability Note The Application Examples are not binding and do not claim to be complete with regard to configuration, equipment or any contingencies. The Application Examples do not represent customer-specific solutions. They are only intended to provide support for typical applications. You are responsible for the correct operation of the described products. These Application Examples do not relieve you of the responsibility of safely and professionally using, installing, operating and servicing equipment. When using these Application Examples, you recognize that we cannot be made liable for any damage/claims beyond the liability clause described. We reserve the right to make changes to these Application Examples at any time and without prior notice. If there are any deviations between the recommendations provided in this Application Example and other Siemens publications e. g. catalogs the contents of the other documents shall have priority. 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 Application Example 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 fundamental contractual obligations ("wesentliche Vertragspflichten ). The compensation for damages due to a breach of a fundamental contractual obligation is, however, limited to the foreseeable damage, typical for the type of contract, except in the event of intent or gross negligence or injury to life, body or health. The above provisions do not imply a change of the burden of proof to your detriment. Any form of duplication or distribution of these Application Examples or excerpts hereof is prohibited without the expressed consent of Siemens AG. Security information Siemens provides products and solutions with Industrial Security functions that support the secure operation of plants, systems, machines and networks. In order to secure plants, systems, machines and networks against cyber threats it is necessary to implement (and to maintain continuously) a holistic, state-of-the-art Industrial Security concept. With this in mind, Siemens products and solutions are only one part of such a concept. It is the customer s responsibility to prevent unauthorized access to the customer s plants, systems, machines and networks. Systems, machines and components should only be connected to the company s network or the Internet, when and insofar as this is required and the appropriate protective measures (for example, use of firewalls and network segmentation) have been taken. In addition, the recommendations by Siemens regarding the respective protective measures have to be observed. For more information on Industrial Security, visit Siemens products and solutions undergo continuous development in order to make them even more secure. Siemens strongly recommends to perform updates as they become available and to use only the latest product versions. The use of obsolete or no longer supported versions can increase the risk of cyber threats. In order to always be informed about product updates, subscribe to the Siemens Industrial Security RSS Feed at Entry-ID: , V1.0.1, 06/2017 2

3 Siemens AG 2017 All rights reserved Table of Contents Table of Contents Warranty and Liability Introduction Overview... 5 FBIoLinkMaster... 5 FBIoLinkDevice Mode of operation... 6 Response under normal conditions... 6 Response in the event of an error Components used FBIoLinkDevice Block description Interface description Error handling FBIoLinkMaster Block description Interface description Error handling Integration into the user project Example Appendix Siemens Services Links & Literature History Entry-ID: , V1.0.1, 06/2017 3

4 Siemens AG 2017 All rights reserved 1 Introduction 1 Introduction You will receive a tested code with clearly defined interfaces together with these block libraries. These can be used as a basis for the task you want to implement. The core concern of this document is to describe all blocks belonging to the block library. the functionality implemented through these blocks. Figure 1-1 Configuration PROFINET IE Entry-ID: , V1.0.1, 06/2017 4

5 Siemens AG 2017 All rights reserved 1 Introduction 1.1 Overview FBIoLinkMaster FBIoLinkDevice The decentralized periphery SIMATIC ET 200 with master modules provides a quick and simple communication with sensors and actuators. master and its connected devices are configured with an configuration tool during commissioning, e.g. with the Port Configuration Tool (PCT). Here, it is determined, how the process data are exchanged cyclically between SIMOTION and the devices connected to the master modules. Additionally, via an acyclic access, parameters, measured values and diagnostic data can be accessed or system commands can be sent. For this, this application example provides two function blocks. You can backup or restore the device parameters and settings of an communication module/ master (e.g. ET 200SP CM 4x) with the help of the "FBIoLinkMaster function block. Using this "FBIoLinkDevice" function block helps you read parameters, measured values and diagnosic data from an device in the SIMOTION program, or write device parameters to an device or send system commands. Entry-ID: , V1.0.1, 06/2017 5

6 Siemens AG 2017 All rights reserved 1 Introduction 1.2 Mode of operation A data transfer can be started with a positive edge on the "execute input. If "readorwrite = False, data is rad and output to "recordioldata", if "readorwrite = TRUE, the data from "recordioldata" are sent to the Master or the Device. The blocks work asynchronously, i.e. processing takes place over several PLC cycles. The block generally uses a sequence of acyclic read/write accesses that are performed by the "_readrecord and "_writerecord S7 SIMOTION system functions. Response under normal conditions As long as no valid response data has arrived, this is signaled via the "busy = TRUE parameter. The value TRUE of the "done output shows that the transfer was performed successfully. In a read task, the data are consistently available at the "recordioldata" input/output and the "readdatalength" output displays the lenght of the data received. The value TRUE of the "error output indicates whether an error has occurred. As long as the input is REQ = TRUE, the output parameters maintain their value. If the input REQ = FALSE, before the processing of the FB was completed, the values of the output parameters are only held for one cycle after processing the job. Note The data transfer is in the form of raw date (ARRAY of byte) Response in the event of an error If an error occurs when executing the function, this is signaled via the "error output. The "errorsource output indicates, where the error has occurred and the "errorid output returns the error code. If there is a communication error, the status of _readrecord or _writerecord is passed on to the "errorid output. Entry-ID: , V1.0.1, 06/2017 6

7 Siemens AG 2017 All rights reserved 1 Introduction 1.3 Components used The application example has been created with the following components: Table 1-1 Component SIMOTION Drive-based Control Unit D435-2 DP/PN Numbe r Article number 1 6AU1435-2AD00-0AA0 IM 155-6PN ST 1 6ES7155-6AU00-0BN0 ET 200CM 4x 1 6ES7137-6BD00-0BA0 ET 200 BASEUNIT TYP A0 1 6ES7193-6BP00-0DA0 SIRIUS monitoring relay Spannung V 1 3UG4832-2AA40 Note The blocks work with the following communication modules: Table 1-2 communication module Article number ET 200S 4SI 6ES7138-4GA50-0AB0 ET 200S 4SI SIRIUS 3RK1005-0LB00-0AA0 ET 200SP CM 4x 6ES7137-6BD00-0BA0 ET 200AL CM 4x 6ES7147-5JD00-0BA0 ET 200ecoPN Master 6ES7148-6JA00-0AB0 Note communication modules of other suppliers are not supported by this library! Entry-ID: , V1.0.1, 06/2017 7

8 Siemens AG 2017 All rights reserved 2.1 FBIoLinkDevice Block description The reading and writing of acyclic data enables you to write the device parameter to an device or read parameters, measured values and diagnostics data of an device. The function block supports you with the following tasks: (Re)configuration of an device Diagnostics of an device Executing of port functions Saving / recovering of device parameters The data on an device can be uniquely addressed with index and subindex. The values for index and sub-index as well as the structure of the data record can be found in the description of the Device. In addition, port functions can also be executed with the "FBIoLinkDevice function block (e.g. switching of the port to the DI mode). Note The structure of the data objects and the port functions can be found in the respective documentation of the device and the master. The "FBIoLinkDevice" function block is based on a standardized protocol (PROFIBUS DP / PROFINET IO), which ensures access to data of an device behind masters. Generally a sequence of acyclic read/write accesses is used which is represented by the "_readrecord and "_writerecord SIMATIC SIMOTION system functions. The FBIoLinkDevice block works asynchronously, i.e. processing always takes place over several PLC cycles. Entry-ID: , V1.0.1, 06/2017 8

9 Siemens AG 2017 All rights reserved Interface description Figure 2-1 Configuration FBIoLinkDevice BOOLEAN execute done BOOLEAN DINT logaddress busy BOOLEAN UDINT record Number error BOOLEAN BOOLEAN readorwrite ErrorSource UINT INT port errorid DWORD INT iolindex status UDINT INT INT ARRAY[0..231] OF BYTE iolsubindex writedata Length recordioldata readdata Length UDINT ARRAY[0..231] OF BYTE Table 2-1: Parameter of FBIoLinkDevice Name P-type Data type Comment execute IN BOOLEAN With increasing edge the transmission will be started logaddress IN DINT First logic input address of the IO Link master module recordnumber IN UDINT Client Access Point (CAP) for ET200 always 227d readorwrite IN BOOLEAN FALSE = read task TRUE = write task port IN INT Port to which the device is connected at the master, at ET200 = iolindex 1 IN INT Index of the device data set, Number of the data record to be transmitted port functions iolsubindex IN INT Subindex; 0: complete data record (always for ET 200) 1-255: single value (not for ET200) writedatalength IN INT Length of the user data to be written (in bytes, without Header) only relevant, if readorwrite = TRUE done OUT BOOLEAN TRUE = Job completed successfully busy OUT BOOLEAN TRUE = Job running error OUT BOOLEAN 0: no error; 1: error 1 iolindex Entry-ID: , V1.0.1, 06/2017 9

10 Siemens AG 2017 All rights reserved Name P-type Data type Comment ErrorSource OUT UINT errorid OUT DWORD see chapter status OUT UDINT Current step: 0 = idle 1 = write record 2 = read record 3 = check data 4 = error 5 = done readdatalength OUT UDINT Length of the read user data (in bytes, without Header) recordioldata IN_OUT ARRAY [0..231] of BYTE User data to be transmitted to the device, or user data received from the device (max. 232 bytes) Error handling If the block detects an error, the process is cancelled and the error cause is displayed until the "execute input becomes FALSE again, however, at least for one cycle. If the FB has detected an error, this is signalled at the "error output. At the "errorsource output, it is specified, where the error has been detected. At the "errorid output, the error code can be read. Table 2-2 ErrorSource errorid Meaning 0 = no error 0 No error 1 = FB 8000 The transmission could not be completed within 20 sec 8001 The value for the port (port) is not between 0 and The index (iolindex) is not between 0 and The sub-index (iolsubindex) is not between 0 and The data length (writedatalength) is not between 0 and The data received does not match the data sent (header information are different) 8007 Error in step chain: 2 = write error various Error code of _writerecord system function 3 = read error various Error code of _readrecord system function 4 = Master various Error code of the Master Data hae been transmitted error-free, but an error has occurred during processing in the master The error codes of the _readrecord and _writerecord system functions can be found in the SIMOTION documentation (see \7\) The error codes of the Master can be found in the respective documentation. Entry-ID: , V1.0.1, 06/

11 Siemens AG 2017 All rights reserved 2.2 FBIoLinkMaster Block description You can backup or restore the device parameters and settings of an master module (e.g. ET 200SP CM 4x) with the help of this block via the SIMOTION program Interface description Figure 2-2 Configuration FBIoLinkMaster BOOLEAN execute done BOOLEAN DINT logaddress busy BOOLEAN BOOLEAN readorwrite error BOOLEAN ErrorSource UINT errorid DWORD status UINT ARRAY[0..231] OF BYTE recorddata readdata Length UDINT ARRAY[0..231] OF BYTE Table 2-3: Parameter of FBIoLinkMaster Name P-type Data type Comment execute IN BOOLEAN With increasing edge the transmission will be started logaddress IN DINT First logic input address of the IO Link master module readorwrite IN BOOLEAN FALSE = read task, backup TRUE = write task, restore done OUT BOOLEAN TRUE = Job completed successfully busy OUT BOOLEAN TRUE = Job running error OUT BOOLEAN TRUE = Error occurred ErrorSource OUT UINT errorid OUT DWORD see chapter status OUT UINT Current step: 0 = idle 1 = check 2 = read ID = read ID = read ID = read ID = read ID = read ID = error 9 = done readdatalength OUT UDINT Length of the read user data Entry-ID: , V1.0.1, 06/

12 Siemens AG 2017 All rights reserved Name P-type Data type Comment recorddata IN_OUT ARRAY[0..231] OF BYTE User data to be transmitted to the master, or user data received from the master (max. 232 bytes) Error handling If the block detects an error, the process is cancelled and the error cause is displayed until the "execute input becomes FALSE again, however, at least for one cycle. If the FB has detected an error, this is signalled at the "error output. At the "errorsource output, it is specified, where the error has been detected. At the "errorid output, the error code can be read. Table 2-4 ErrorSource errorid Meaning 0 = no error 0 No error 1 = FB 8001 No Siemens master module (Wrong data lenght of ID230) 8002 No data from ID No data from ID Data structure faulty (only at restore) = read ID230 various Error code of _readrecord system function in step 1 3 = read ID230 various Error code of _readrecord system function in step 10 4 = read ID220 various Error code of _readrecord system function 5 = read ID222 various Error code of _readrecord system function 6 = write ID220 various Error code of _readrecord system function 7 = write ID222 various Error code of _readrecord system function 8 = write ID230 various Error code of _readrecord system function The error codes of the _readrecord and _writerecord system functions can be found in the SIMOTION documentation (see \7\) Entry-ID: , V1.0.1, 06/

Siemens AG 2017 All rights reserved 2.3 Integration into the user project 1. Unzip the file 109740369_IO_Link_Library_LIB_v100.zip into a directory. 2. Open your project in the TIA Portal and then the SIMOTION configuration.

13 Siemens AG 2017 All rights reserved 2.3 Integration into the user project 1. Unzip the file _IO_Link_Library_LIB_v100.zip into a directory. 2. Open your project in the TIA Portal and then the SIMOTION configuration. 3. Right-click on Libraries > Export/Import > Import folders/objects Figure 2-3 Import library 4. In the opened dialog "Import object, navigate to the directory, to which you have unzipped the zip file and here, select the file "LioLink.xml". The library is now imported into the project. 5. In your program s declaration part, implement the LioLink library with "USELIB IoLoink (see Figure 2-4) 6. You can now use the "LIoLink_FBIoLinkDevice and "LIoLink_FBIoLinkMaster;" function blocks in your program. (see Figure 2-4) Note Notes on how to configure the function blocks can be found in the block description in chapter 2 and in the example in chapter 2.4 Entry-ID: , V1.0.1, 06/

Siemens AG 2017 All rights reserved 2.4 Example In the following example, a 3UG4832 voltage monitoring relay is connected to port 1 of an ET 200SP CM 4x module.

15 Siemens AG 2017 All rights reserved 2.4 Example In the following example, a 3UG4832 voltage monitoring relay is connected to port 1 of an ET 200SP CM 4x module. The currently measured voltage is to be read 1. Configure the block according to your hardware configuration: logaddress first logic input address of the IO Link master module in the HW configuration, 0 in the example Figure 2-5 Device view of the ET200SP Station Entry-ID: , V1.0.1, 06/

16 Siemens AG 2017 All rights reserved port Port to which the device is connected at the master, ET200 has ports 1 to 4, port 1 in the example Figure 2-6 Extract from the manual for CM 4x recordnumber For ET200, it is always 227d 2. Configure the block according to your device: iolindex and iolsubindex You will find the data in the description of your device, Index=94 and SubIndex=0 in the example Figure 2-7 Etract from the manual of the 3UG4832 monitoring relay 3. Configure the block according to the desired function: Entry-ID: , V1.0.1, 06/

17 Siemens AG 2017 All rights reserved readorwrite False = read, True= write. FALSE in the example, since Index 94 can only be read. 4. Start the data transfer with a rising edge at the execute input After the pass, the "done output is TRUE and you can find the read data in the "recorddata input/output. In the example, a voltage monitoring relay is connected with an applied voltage of 24V. Therefore, in bytes 16 and 17 (see Figure 2-7), you can find the current value of the currently measured voltage: 00F0h = 240d for 24V Figure 2-8 Display of read values Entry-ID: , V1.0.1, 06/

18 Siemens AG 2017 All rights reserved 3 Appendix 3 Appendix 3.1 Siemens Services Industry Online Support Technical Support You have questions or need support? Siemens Industry Online Support offers access to our entire service and support know-how as well as to our services. Siemens Industry Online Support is the central web address for information on our products, solutions and services. Product information, manuals, downloads, FAQs and application examples all information is accessible with just a few mouse clicks at Siemens Industry's Technical Support offers quick and competent support regarding all technical queries with numerous tailor-made offers from basic support to individual support contracts. Please address your requests to the Technical Support via the web form: Service offer Our service offer comprises i. a. the following services: Product Training Plant Data Services Spare Parts Services Repair Services Field & Maintenance Services Retrofit & Modernization Services Service Programs & Agreements Detailed information on our service offer is available in the Service Catalog: Industry Online Support App Thanks to the "Siemens Industry Online Support" app, you will get optimum support even when you are on the move. The app is available for Apple ios, Android and Windows Phone. Entry-ID: , V1.0.1, 06/

19 Siemens AG 2017 All rights reserved 3 Appendix 3.2 Links & Literature Table 3-3 Topic \1\ Siemens Industry Online Support \2\ Download page of the entry \3\ \4\ at Siemens \5\ Master of decentralized periphery SIMATIC ET \6\ Manual SIMATIC System \7\ Manual SIMOTION system functions/variables devices History Table 06/ Version Date Modifications V1.0 09/2016 First version V /2017 Documentation: changed marker in Figure 2-5 Library: corrected calculation of data length in FBIoLinkMaster Entry-ID: , V1.0.1, 06/

Configuration of an MRP ring with SIMOCODE and SIMATIC S SIMOCODE pro V PN, SIMATIC S Siemens Industry Online Support

Configuration of an MRP ring with SIMOCODE and SIMATIC S7-1500 SIMOCODE pro V PN, SIMATIC S7-1500 https://support.industry.siemens.com/cs/ww/en/view/109742280 Siemens Industry Online Support Siemens AG