Product Characteristics 3 CMS X-TOOLS CMS X-TOOLS ION SIMOTION T001 Add Library into the Project 4 Manual Software Engineering 5

Size: px

Start display at page:

Download "Product Characteristics 3 CMS X-TOOLS CMS X-TOOLS ION SIMOTION T001 Add Library into the Project 4 Manual Software Engineering 5"

Chad Greer
6 years ago
Views:

1 ION SIMOTION T001 User Manual Preface 1 Scope of Delivery 2 Product Characteristics 3 ION SIMOTION T001 Add Library into the Project 4 Manual Software Engineering 5 Block Description 6 References 7 Release Contact Information 8 Release / 17

2 ION SIMOTION T001 User Manual Safety Guidelines This document contains notices which you should observe to ensure your own personal safety as well as to avoid property damage. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring to property damage only have no safety alert symbol. Danger indicates an imminently hazardous situation which, if not avoided, will result in death or serious injury. Warning indicates a potentially hazardous situation which, if not avoided, could result in death or serious injury. Caution used with the safety alert symbol indicates a potentially hazardous situation which, if not avoided, may result in minor or moderate injury. Caution used without safety alert symbol indicates a potentially hazardous situation which, if not avoided, may result in property damage. Notice used without the safety alert symbol indicates a potential situation which, if not avoided, may result in an undesirable result or state. When several danger levels apply, the notices of the highest level (lower number) are always displayed. If a notice refers to personal damages with the safety alert symbol, then another notice may be added warning of property damage. Qualified Personnel The device/system may only be set up and operated in conjunction with this documentation. Only qualified personnel should be allowed to install and work on the equipment. Qualified persons are defined as persons who are authorized to commission, to earth, and to tag circuits, equipment and systems in accordance with established safety practices and standards. Intended Use Please note the following: Trademarks Warning This device and its components may only be used for the applications described in the catalog or technical description, and only in connection with devices or components from other manufacturers approved or recommended by Siemens. This product can only function correctly and safely if it is transported, stored, set up and installed correctly, and operated and maintained as recommended. All designations marked with are registered trademarks of Siemens AG. Other designations in this documentation might be trademarks which, if used by third parties for their purposes, might infringe upon the rights of the proprietors. Copyright Siemens AG 2010 All rights reserved. Reproduction, transmission or use of this document or its contents is not permitted without express written authority. Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserved. Disclaimer of Liability We have checked the contents of this document for agreement with the hardware and software described. Since deviations cannot be precluded entirely, we cannot guarantee full agreement. However, the data in the manual are reviewed regularly, and any necessary corrections will be included in subsequent editions. Suggestions for improvement are welcomed. Siemens AG Industry Sector P.O. Box Nuremberg Germany Siemens AG 2010 Technical data subject to change Release / 17

3 ION SIMOTION T001 User Manual Table of Contents 1 Preface Purpose of this Document Basic Knowledge Required Validity of this Document Terms Scope of Delivery Scope of Delivery Unpacking and Checking Product Characteristics What is? Introduction Hard- and Software Requirements Hardware Software Ordering Numbers Installation L_CS_ION Setting of Constants Software Engineering Function Call Function Parameters UIK Program example Block Description Data Structures ChannelType StructION_SIMOTION_T001_Comm Function blocks FB_ION_SIMOTION_T001_Data FB_ION_SIMOTION_T001_Comm Tips and Tricks Configuration of windows firewall References Other Documentation Contact Information Release / 17

4 ION SIMOTION T001 User Manual 1 Preface 1.1 Purpose of this Document This document supports you when commissioning and using the software ION SIMOTION T001 of the productline. 1.2 Basic Knowledge Required In order to understand this manual, general knowledge of automation technology and software packages CMS X-Tools and SIMOTION Scout is required. In addition, you must be familiar with network technology (UDP/IP) and with using computers with MS Windows XP. 1.3 Validity of this Document This document is valid for the following software: IONSIMOTION T001, V During the following pages, this software will be referred to by the term ION SIMOTION T Terms The following terms are used within this document. Definition CMS ION UIK URN Description Condition Monitoring System I/O-Node Universal Identification Key User Node Release / 17

5 ION SIMOTION T001 User Manual 2 Scope of Delivery 2.1 Scope of Delivery What is shipped? CD IONSIMOTION T Unpacking and Checking After unpacking, please check the packet for completeness and all parts for transport damage. Caution Do not use any content / parts that show evidence of damage! Release / 17

ION SIMOTION T001 User Manual 3 Product Characteristics 3.1 What is? is an industrial-suited Condition Monitoring System for technical and technological services in industrial plants.

6 ION SIMOTION T001 User Manual 3 Product Characteristics 3.1 What is? is an industrial-suited Condition Monitoring System for technical and technological services in industrial plants. is a modular, scalable analysis and diagnosis system. It is optimized for reaction less measurement of analog, binary and numerical data. can be integrated in existing and new industrial plants. can be integrated into the TIA-Architecture. 3.2 Introduction The ION SIMOTION T001 is used in order to acquire numerical data from a SIMOTION controller and to transmit the recorded data via Ethernet to a superior industrial PC. The usage of an ION SIMOTION T001 allows transmitting up to 171 channels (171 x 4 = 684 Bytes) per measurement cycle of the controller. In order to transmit more data, multiple ION SIMOTION T001 can be engineered into the program of the controller. The ION SIMOTION T001 consists of two functional blocks which must be engineered into SIMOTION controllers. After the engineering, the ION SIMOTION T001 is used for the communication with X- Tools (during the following pages referred as X-Tools) and for the transmission of measurement data to X- Tools. The engineered ION SIMOTION T001 identifies itself to X-Tools as Ethernet device which communicates via UDP. When the measurement data transmission is started through X-Tools, the ION SIMOTION T001 sends the requested values of the SIMOTION to the used PC during each cycle. 3.3 Hard- and Software Requirements Hardware PC with Windows XP Professional (Service Pack 2 recommended) o CPU with 2.4 GHz Release / 17

7 ION SIMOTION T001 User Manual o working memory 512 MByte (2 GByte recommended) o OpenGL enabled graphic controller (from 1024x768 Pixels, 1280x1024 Pixels or more recommended) o IEEE1394, Ethernet and USB interfaces SIMOTION controller with Ethernet or PROFInet interface, SIMOTION Kernel V3.2 or higher. Ethernet connecting cabels Software Professional (V 04.01) SIMOTION Scout (V 4.0 or higher) 3.4 Ordering Numbers Article CMS X-Tools Professional V Ordering Number (MLFB) 9AE4160-1AD00 Further information is obtained from your local Siemens office and from the homepage Release / 17

8 ION SIMOTION T001 User Manual 4 Installation 4.1 L_CS_ION Installation 1. Insert the product-cd IONSIMOTION T001 into the CD/DVD-drive of your PC. 2. Start the SIMOTION Scout and open the project, in which the library should be imported. 3. Inside the project-navigator click on the container LIBRARIES. 4. Chose in the context menu: Import Object. 5. Chose under source-path and source-name of the import the path of your CD/DVD-drive and open the XML-file: <CD-path>:\ \ION SIMOTION T001\L_CS_ION.xml from the product-cd. 6. Apply with OK. 7. The import will start. In the details of register XML Export/Import State the successful import will be shown. In the project navigator the library L_CS_ION is shown. 4.2 Setting of Constants The maximum count of Channels and internal Buffers has to be defined by engineering the Unit ION_Cfg. 1. In the Unit ION_Cfg, the user constants have to be set as follows: //################ User Constants ####################################### NUM_OF_BUFFER_LAYERS : INT := 20; //Buffer depth, min 1 // should be big enough for greater BackGroundTask times MAX_CHANNEL : INT := 171; //MIN 1, MAX 171 // Maximum count of data channels //####################################################################### Example: setting of constants 2. The constant NUM_OF_BUFFER_LAYERS defines the size of the ring-buffer. It must be chosen large enough for longer BackGroundTask times. 3. The constant MAX_CHANNEL defines the maximum number of data channels range ( ). Release / 17

9 ION SIMOTION T001 User Manual 5 Software Engineering 5.1 Function Call The ST-Sourcecode-Example shows a possibility for the call and it is possible to insert it into a new ST-Source directly. Depending on usage and system configuration it is wise to make custom changes. Condition for the call of the functional-block is, that the library L_CS_ION with the functional-block is imported into your user project (see chapter 4). To work with the functional-block in your program proceed as follows: 1. Add a new program ( insert ST-programm) or open an existing program. 2. In the Interfacearea of the Program the library L_CS_ION has to be included with the command USELIB L_CS_ION;. 3. Next step is to declare the common variables for the function block parameters. These parameters could also be set at the call of the function block.the instances of the function blocks and the two patterns (StructION_SIMOTION_T001_Comm and ChannelType) must be declared for every ION SIMOTION T001 in controller. To declare it there are two possibilities: The variables and instances were defined as global variables in the IMPLEMENTATION-Area of the source (see example). So they are only valid in the particular unit. This option is advisable by calling more then one ION SIMOTION T001 in one project. The variables and instances were defined as global Variables in the INTERFACE-Area of the source. In this case they are available in the whole project and it is easy to load data into them. By calling more then one ION SIMOTION T001 all IONs must have their own variables and Instances with their unique values (port-number, name,...). In the example the following variables were declared: Name in example Type Function myfb_comm FB_ION_SIMOTION_T001_Comm FB Instance myfb_data FB_ION_SIMOTION_T001_Data FB Instance mycommdata StructION_SIMOTION_T001_Comm Struct for Data exchange mychannel ChannelType Data channel myuik UIKType UIK, see 5.4 for details CycleTime UDINT Cycle time of the synch. Task in ms mycommandport UINT Command-Port, in example 2000 mydataport UINT Data-Port, in example 2001 numofchannels INT Number of channels mydevice_description DeviceDescriptionType Description, must be unique mydevice_location DeviceLocationType Additional Information 4. The program for the BackGroundTask (CS_Bkgrnd) is calling the instance of the communication block (myfb_comm). This call is parameterized with the declared variables (see Chapter 5.2). It is also possible to do the parameterization directly at the communication block. 5. In the program for the synchron task (CS_Cycl) the data channels were filled with data and the instance of the data block (myfb_data) is called. See chapter 5.2 for more details for parameterization. Release / 17

10 ION SIMOTION T001 User Manual 5.2 Function Parameters Input Parameters for the Function Block FB_ION_SIMOTION_T001_Comm 1. The parameter COM_RST is optional and causes a reset of the block. 2. Enter for the parameter CYCLE_T the variable which contains the cycle time for the synchronous task, where the function lock FB_ION_SIMOTION_T001_Data is called. 3. Enter for the parameter COMMAND_PORT a unique UDP Port for the command connection ( ). 4. Enter for the parameter DATA_PORT a unique UDP Port for the Data connection ( ). 5. Enter for the parameter CURRENT_CHANNELS the desired number of channels which shall be transmitted each cycle (1 171). 6. Enter for the parameter UIK the defined UIK. See Chapter 5.3 for details. 7. Enter for the parameter DEVICE_DESCRIPTION the description for the ION SIMOTION T001, which should be shown inside X-Tools. The Description can be changed by X-Tools and must be unique for each function block in the system. By this DEVICE_DESCRIPTION the ION is assigned to the device profile in X-Tools. By changing the DEVICE_DESCRIPTION it is necessary to reassign the new name to the X-Tools device profile. 8. Enter for the parameter DEVICE_LOCATION the location of the ION SIMOTION T001, which should be visible inside X-Tools. This is a optional additional information. 9. Enter for the parameter CommData the structure for data exchange between Function blocks FB_ION_SIMOTION_T001_Comm and FB_ION_SIMOTION_T001_Data. This must be the same structure used at the call of FB_ION_SIMOTION_T001_Data. Parameter configuration for FB_ION_SIMOTION_T001_Data Note 1. Enter for the parameter Channel the data channel, which should be transmitted. The Channel must be filled with values before calling. 2. Enter for the parameter CommData the structure for data exchange between Function blocks FB_ION_SIMOTION_T001_Comm and FB_ION_SIMOTION_T001_DataThis must be the same structure used at the call of FB_ION_SIMOTION_T001_Comm. The programs must be assigned to the system sequences. Alternate it is possible to use available programs. First the channels that should be transmitted were served according to the variable mychannel. There are up to 171 channels available with 4 bytes for every channel, in total 684 byte. These data were send cyclic to the PC, after X-Tools is connected to ION SIMOTION T001. The origin measurement data were defined with the configuration of these 171 channels. The different data types must be converted to DWORD. It is possible to use one channel for different data, e.g. 4 BOOL's, 4 BYTE's or 2 INT's (see also the examples). Release / 17

11 ION SIMOTION T001 User Manual 5.3 UIK Every ION SIMOTION T001 must have a unique identification in the complete system, the UIK. This UIK is used by X-Tools for the unique identification of every ION SIMOTION T001. Normaly it is created with 2 null bytes and the MAC-address (6 Bytes) of the assembly. Insert after the second byte the MAC-address byte-by-byte (hex view). In the following example the MAC-Adresse CE-C6 is used. VAR_GLOBAL... myuik : ARRAY[0..7] OF BYTE :=[16#0,16#0,16#08,16#00,16#06,16#71,16#CE,16#C6];... END_VAR Sourcecode example: UIK If there were more then one ION SIMOTION T001 function blocks operated on one assembly, it is essential, that the UIK is unique. In this case, use the first two bytes for a serial numbering of the blocks. 5.4 Program example INTERFACE USELIB L_CS_ION; PROGRAM CS_Bkgrnd; //Call in BackGroundTask PROGRAM CS_Cycl; //Call in a Synchronous or Timer Interrupt Task END_INTERFACE IMPLEMENTATION VAR_GLOBAL myfb_data : FB_ION_SIMOTION_T001_Data; // FB for collected data cyclic call myfb_comm : FB_ION_SIMOTION_T001_Comm; // FB for communication - BackGroundTask mycommdata : StructION_SIMOTION_T001_Comm; // Structure for the common Data of the FBs mychannel : ChannelType; // ARRAY[1..MAX_CHANNEL] OF DWORD // Data channels, every Date channel has Type DWORD // must be filled with data cyclic. // Interpretation in as Intel-Notation myuik : UIKType :=[16#0,16#0,16#08,16#00,16#06,16#71,16#CE,16#C6]; // Universal Identification Key - unique ION-Identifier // normaly created with 2 null bytes and the MAC-Address of the assembly CycleTime : UDINT := 3000; // Executing interval of the synchronous Tasks in microseconds mycommandport : UINT := 2000; mydataport : UINT := 2001; numofchannels : INT := 171; //Count of the actual transmitted data channels mydevice_description : DeviceDescriptionType := 'ION SIMOTION T001 ( CEC6)'; // Description of assembly or asset must be unique mydevice_location : DeviceLocationType := 'Unknown Location'; // Location of assembly or asset END_VAR PROGRAM CS_Bkgrnd //Call in BackGroundTask myfb_comm( COM_RST := FALSE // Reset of the FB, option,cycle_t := CycleTime // Executing interval of the synchronous Tasks,COMMAND_PORT := MyCommandPort // Receive Port for commands,data_port := MyDataPort // Send Port for Data,CURRENT_CHANNELS := numofchannels // the wanted count of channels,(1..171),uik := myuik,device_description := mydevice_description,device_location := mydevice_location // Location of assembly or asset,commdata := mycommdata); END_PROGRAM PROGRAM CS_Cycl //Call in a Synchronous or TimerInterrupt Task VAR //Example variables i : INT; mybool0 : BOOL; mybool1 : BOOL; mybool2 : BOOL; mybool3 : BOOL; myint0 : INT; myint1 : INT; Release / 17

12 ION SIMOTION T001 User Manual mydint : DINT; myreal : REAL; mylreal : LREAL; END_VAR myint0 := myint0 + 1; IF myint0 >= 133 THEN myint0 := 0; END_IF; myint1 := myint1 + 2; myreal := myreal ; mylreal := mylreal ; IF mylreal >= THEN mylreal := 20.00; END_IF; IF mycommdata.ctrlstartstream THEN // The different data types must be converted to DWORD // it is possible to use one channel for different signals, e.g. 16 BOOL's, // 4 BYTE's or 2 INT's mychannel[1] := _dword_from_2word(word0:= INT_TO_WORD(myInt0),word1 := INT_TO_WORD(myInt1)); mychannel[2] := REAL_TO_DWORD(myReal); mychannel[3] := REAL_TO_DWORD(LREAL_TO_REAL(myLReal)); mychannel[4] := _dword_from_4byte( byte0:=mybool0, byte1:=mybool1, byte2:=mybool2, byte3:=mybool3); FOR i := 5 TO numofchannels DO mychannel[i] := REAL_TO_DWORD(myReal); END_FOR; END_IF; myfb_data(channel := mychannel,commdata := mycommdata); END_PROGRAM END_IMPLEMENTATION Sourcecode example: ST-Quelle Release / 17

13 ION SIMOTION T001 User Manual 6 Block Description 6.1 Data Structures ChannelType This array defines the channels, which shall be transmitted to X-Tools ChannelType: ARRAY[0..MAX_CHANNEL] OF DWORD; Sourcecode example: ChannelType StructION_SIMOTION_T001_Comm The data exchange between _FB_ION_SIMOTION_T001_Comm and _FB_ION_SIMOTION_T001_Data is performed via structure StructION_SIMOTION_T001_Comm: STRUCT Name Type Description ctrlstartstream BOOL Data streming state cycletime UDINT Cylce time of calling task (in microseconds) CURRENT_CHANNELS INT Number of channels to be transmitted to X-Tools each cycle numofpakets INT Number of packets per buffer level cyclicdata 6.2 Function blocks ARRAY[0..NUM_OF_BUFFER_LAYERS] OF StructLayer Parameter definition: StructION_SIMOTION_T001_Comm Ring buffer for data transmission FB_ION_SIMOTION_T001_Data In FB_ION_SIMOTION_T001_Data the data were collected in buffers and provided with timestamps. The data sending to X-Tools occurs with FB_ION_SIMOTION_T001_Comm. Required is the calling from a SynchronousTask or a TimerInterruptTask. Name Data type Type Description CHANNEL ChannelType IN/OUT This array represents the single channels which shall be transmitted to X-Tools CommData StructION_SIMOTIONT001_Comm IN/OUT Ring buffer and internal data exchange error DINT OUT Error state of the FB. 0: No error Parameter definition: FB_ION_SIMOTION_T001_Data -1: ring buffer overflow, the constant _NUM_OF_BUFFER_LAYERS is too small Release / 17

14 ION SIMOTION T001 User Manual FB_ION_SIMOTION_T001_Comm The function block _FB_ION_SIMOTION_T001_Comm is used for communication between ION SIMOTION T001 and X-Tools. After X-Tools has registered itself over the CommandPort (here 2000) the FB activates and a data exchange with X-Tools begins. For data transmission a dedicated DataPort (here 2001) is used. The functional block must be integrated into the BackGroundTask. Alternative, in case of long cycle times of the BackGroundTask, the functional block can be integrated into a separate MotionTask in an infinite loop. The infinite loop task must end with the _waittime(t#0ms) command. PROGRAM CS_MotionTask //Aufruf in einer MotionTask WHILE TRUE DO myfb_comm( COM_RST := FALSE,CYCLE_T := mycycletime,command_port := mycommandport,data_port := mydataport,current_channels := numofchannels,uik := myuik,device_description := mydevice_description,device_location := mydevice_location,commdata := mycommdata); myretdint := _waittime(t#0ms); END_WHILE; END_PROGRAM Source code example: Motion Task Parameter Datatype Type Comment COM_RST BOOL IN TRUE causes a reset of the block. During running blocks the parameter should be FALSE. The FB remains in initializing status as routine as long as COM_RST is TRUE. CYCLE_T UDINT IN Cycle time of calling syncronous task (in microseconds) COMMAND_PORT UINT IN Unique UDP port for command connection. DATA_PORT UINT IN Unique UDP data for command connection. CURRENT_CHANNELS INT IN Number of channels which shall be transmitted to X-Tools each cycle (1 MAX_CHANNEL) UIK ARRAY[0..7] OF BYTE IN Unique identifier, normally existing of 2 zero bytes and the MAC address DEVICE_DESCRIPTION STRING IN Description of component or installation. DEVICE_LOCATION STRING IN Location of component or installation. CommData StructION_SIMOTI ON_T001_Comm IN_OUT Ring buffer for internal data exchange error DINT OUT Error state of FB. Matches the messages of the system function udpsend and udpreceive. Parameter definition: FB_ION_SIMOTION_T001_Comm Release / 17

$Open Allow a program through Windows Firewall from the Control Panel\System and Security window 2. Allow a program through Windows Firewall a.$

15 ION SIMOTION T001 User Manual 7 Tips and Tricks 7.1 Configuration of windows firewall If the firewall does not allow X-Tools server application then the communication will not start between the automation system and CMS X-Tools. Please verify the configuration as follow. 1. Open Allow a program through Windows Firewall from the Control Panel\System and Security window 2. Allow a program through Windows Firewall a. Add X-Tools in the list of exception in order to allow X-Tools through Windows Firewall for public and Home/Work(Private) Networks Release / 17

16 ION SIMOTION T001 User Manual 8 References 8.1 Other Documentation Manual: X-Tools User Manual Program manual SIMOTION ST, Structured Text Manual: SIMATIC Programming with STEP 7 Release / 17

17 ION SIMOTION T001 User Manual 9 Contact Information Should you have any questions concerning the software application, please refer to the Industry Sector Technical Support. Department Siemens AG Industry Sector Phone +49 (0) (Monday to Friday, 09:00 am to 05:00 pm CET/CEST) Fax +49 (0) Internet Thank you for using one of the above mentioned contacts to ensure your inquiry is registered and can be processed. Release / 17

Preface 1. Scope of Delivery 2 SIPLUS CMS4000 Introducing the Product 3 Interface Node SIPLUS CMS4000 ION SIMATIC S7 PN Block Description 4

Preface 1. Scope of Delivery 2 SIPLUS CMS4000 Introducing the Product 3 Interface Node SIPLUS CMS4000 ION SIMATIC S7 PN Block Description 4 Preface 1 Scope of Delivery 2 SIPLUS CMS4000 Introducing the Product 3 Interface Node SIPLUS CMS4000 ION SIMATIC S7 PN Block Description 4 6AT8000-0CA00-4XA0 Installation 5 Engineering in AWL 6 Engineering