SINUMERIK 840/840C SINUMERIK 880/880 GA2 PLC 135 WB, S5-HLL, High-Level Language Programming

Transcription

1 SINUMERIK 840/840C SINUMERIK 880/880 GA2 PLC 135 WB, S5-HLL, High-Level Language Programming Planning Guide Edition Manufacturer Documentation

2 SINUMERIK 840/840C SINUMERIK 880/880 GA2 PLC 135 WB, S5-HLL, High-Level Language Programming Planning Guide Manufacturer Documentation Valid for: Control Software Version SINUMERIK 840T/M 01 or higher SINUMERIK 840C 01 SINUMERIK 880T/M 04 or higher SINUMERIK 880 GA Edition

3 SINUMERIK documentation Printing history Brief details of this edition and previous editions are listed below. The status of each edition is shown by the code in the Remarks column. Status code in Remarks column: A... New documentation. B... Unrevised reprint with new Order No. C... Revised edition with new status. If factual changes have been made on the page since the last edition, this is indicated by a new edition coding in the header on that page. Edition Order No. Remarks ZB CQ02-0BA0 A ZB CQ02-0AA1 C FC AC00-0BP0 C Other functions not described in this documentation might be executable in the control. This does not, however, represent an obligation to supply such functions with a new control or when servicing. This publication was produced on the Siemens 5800 Office System. Subject to change without prior notice. The 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. Siemens AG 1990, 1991, 1992, All Rights Reserved

4 SINUMERIK 840/880C SINUMERIK 880/880 GA2 Part 1: S5-HLL Block Generator Planning Guide Manufacturer Documentation

5 Introduction 1 Requirements for the Operation of the Block Generator 2 Installation 3 Operation 4 Interfaces of the HLL Block 5 Format of the Module Header 6 Programming with PL/M 7 Programming with C 8 Programming Examples 9 Information for the Use of the Block Generator 10 Error Messages and Warnings 11

6 Contents Page 1 Introduction PLC Programming with High-Level Languages PL/M and C Function Blocks for the PLC 135 WB Testing the HLL Function Blocks Definition of Terminology Modifications since the Preceding Version Requirements for the Operation of the Block Generator Hardware Requirements Software Requirements Installation Required Programs Installation Program Integration of the Program Editor Installation Procedure Files and Directories Operation General Operating Information Menu Tree Default Settings in Menus Use of Upper and Lower Case Letters for Input Block Generation Sequence Calling the Block Generator Parameters for HLL Block (Menu 1) Define Key Data of HLL Block Function Keys and Special Keys in Menu Define Directories (Menu 1.1) Paths Function Keys and Special Keys in Menu Select Processing Steps (Menu 2) Description of the Processing Steps Define Block Interface Change Block Interface Create Block Program Generate Block Prepare Block for Transfer Check Block Function Keys in Menu

7 4.7 Define/Change Call Parameters (Menu 5) Block without Call Parameters Block with Call Parameters Add Call Parameters Change Call Parameters Exit Menu Function Keys and Special Keys in Menu Define/Change System Interface (Menu 6) Function Keys and Special Keys in Menu Edit HLL Block Compile and Link HLL Block (Menu 3) Function Keys and Special Keys for Menu Generate S5-DOS Block File (Menu 4) Define S5-DOS Block File Name and Block List Function Keys and Special Keys in Menu Interfaces of the HLL Block Type and Scope of the Block Interfaces STEP 5-Specific Data Format Call Parameters of HLL Blocks Types of Call Parameters Data Format Conversion for Call Parameters PLC System Functions Overview HLL_ADB(), Open Data Blocks HLL_S5(), Call STEP 5 Program Blocks HLL_MACRO(), Call Function Macro Available Function Macros Passing Parameters to Function Macros HLL_HLL(), HLL Block Calls HLL Block HLL_LIM(), HLL_SIM(), Disable and Enable OBs HLL_STOP(), Initiate System Stop PLC System Data Overview I/Q/F/C/T Areas Process Images Flag Area and Extended Flag Area Timers and Counters Interpreter Data Status Bits on PLC Systems with COP/ACOP Active OB No Processing of Data Blocks Global Declaration of Data Blocks Opening Data Blocks Length of the Active Data Block Processing of Data Blocks with Pointers Memory Management Block and I/O Address Lists Block Address Lists on PLC Systems with COP/ACOP I/O Address Lists on PLC Systems with COP/ACOP

8 6 Format of the Module Header Task of the Module Header Call Parameter Definitions in the Module Header Evaluation of the Module Header by the Block Generator Operating Situations in which the Module Header is Evaluated Criteria for Cancellation of Evaluation of the Module Header Programming with PL/M Language-Specific Features of PL/M Format of the PL/M Module Body Module Body of a PL/M Block Module Header Compiler Statements Module Block and Literally Declarations External Declarations of System Data and Functions Procedure Declaration of Main Program, Call Parameters Local Data and Statement Part Parameter Check for HLL Calls in PL/M Parameter Data Types Recognized in the Parameter Check Cross-Reference List Brief Examples for PL/M Rules for Upper and Lower Case Notation Reserved Identifiers Programming with C Language-Specific Features of C Format of the C Module Body Module Body of a C Block Module Header Definition of Types of Constants External Declarations of System Data and Functions Procedure Declaration of Main Program, Call Parameters Local Data and Statement Part Brief Examples for C Processing of Data Blocks Use of C Macros Rules for Upper and Lower Case Notation Reserved Identifiers Example Programs Examples in PL/M FB 1, Access to Data Blocks FB 2, Access to Process Image FB 4, Processing of Counters and Timers FB 6, Search in Data Block FB 8, Call Other HLL Procedures FB 10, FB 15, Use of Semaphores FB 20, I/O Processing

9 9.2 Examples in C FX 1, Access to Data Blocks FX 2, Access to Process Image FX 4, Processing of Counters and Timers FX 6, Search in Data Block FX 8, Call Other HLL Procedures FX 10, FX 15, Use of Semaphores FX 20, I/O Processing Information for the Use of the Block Generator Information for the Use of HLL Programs on the Programmable Controller Restrictions for the Use of the Block Generator Restrictions for Programming General Restrictions Further Restrictions for C Blocks Error Messages and Warnings Error Messages from the HLL Block Error Messages of Block Generator Warnings of Block Generator

10 Introduction 1.1 PLC Programming with High-Level Languages 1 Introduction 1.1 PLC Programming with High-Level Languages The PLC 135 WB is programmed with the control language STEP 5. This language is tailored to the needs of a programmable logic controller, i.e. to high-speed bit processing. The tasks performed by the PLC as an interface between numerical controls (NC) and machine tools have increased enormously over the years. The PLC has taken on a key role in the powerful combination of NC and machine. PLC programs have become so complex that high-level programming languages have emerged as powerful tools for programming the PLC. Program branches, conditions and the processing of large data blocks can be programmed faster and more compactly in high-level languages than in STEP 5. Structogram generators are also available for high-level languages for the graphical description of program structures and the automatic generation of high-level language source code (e.g. XTOOLS). When programming the PLC, the high-level language compiler must generate code and runtime-optimized machine programs, because the program memory has to be utilized as effectively as possible and the programs are components of a real-time system. The availability of software development tools for many high-level languages even makes it possible to create and test programs on standard PCs. 1.2 PL/M and C Function Blocks for the PLC 135 WB The S5-HLL block generator supports the formulation of function blocks for the PLC 135 WB in the high-level languages PL/M and C. Compilers for these languages, which are produced by the intel Corporation especially for the processors used in PLCs, enable PLC programmers to utilize the full potential of the languages STEP 5, PL/M and C, with the aid of the S5-HLL block generator. The S5-HLL block generator performs the following main tasks: Menu-driven definition of the key data for the block and block interfaces Automatic generation of the module body for the block Integrated program editors for the creation of the block program Generation of the function block from the source code Generation of S5 block files with multiple function blocks Management of the high-level language program blocks from interface definition to S5 block file The following are obtainable for the block generator: The HLL data generator, which enables testing of HLL function blocks on the PC in combination with a standard high-level language debugger; the system environment is simulated The HLL on-line debugger for testing the programs on the target hardware Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 1 1

11 1 Introduction Testing the HLL Function Blocks 1.3 Testing the HLL Function Blocks The high-level blocks generated with the S5-HLL block generator can be tested both on-line and off-line. Off-line test In combination with a standard high-level language debugger, the HLL data generator enables the HLL blocks to be tested on the same PC on which they are programmed. The PLC is simulated with the aid of the data generator. The PLC system data can be displayed and modified. On-line test The HLL on-line debugger enables the HLL blocks to be tested on the PLC. You can use a programming device to test the operation of your HLL function blocks directly in the application environment. 1.4 Definition of Terminology In order to prevent misunderstandings and to make the documentation as concise as possible by avoiding unnecessary repetition, terms which occur frequently are defined below. You can also refer to the section entitled "Terms and Abbreviations" at the end of this documentation (Appendix). HLL Abbreviation for high-level language. HLL is used as a synonym for the languages PL/M and/or C, particularly in cases where it is irrelevant whether the language is PL/M or C. PLC In this documentation, the term PLC always refers to the PLC 135 WB. A distinction is made between the PLC 135 WB version with the COP coprocessor and the version with the ACOP coprocessor. PLC system data The term PLC system data refers to all PLC data which can be accessed by an HLL program block (e.g. process image, I/Os, etc.). PL/M The term PL/M always refers to PL/M-86 of the intel Corporation. C C always refers to ic86 of the intel Corporation. 1 2 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

12 Introduction 1.5 Modifications since the Preceding Version 1.5 Modifications since the Preceding Version The present version 2.2 of the block generator incorporates the following main modifications compared with the preceding version: The modification of the block interface, i.e. the call parameters and the use of PLC system data, can now be performed with the block generator. In this case, the declarations of the old block interface are deleted; please refer to the section on "Block Interfaces" and the section on "Format of the Module Header". Logical drives are no longer supported. The corresponding menu has been omitted. The version with ACOP is also supported on the PLC 135 WB. The data to be entered in the block have been extended with this item. The library number and the block name can also be changed with Version 2.1 of the block generator. It was previously only possible to enter this data. The system interface to the PLC has been extended. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 1 3

13 Requirements for the Operation of the Block Generator 2.1 Hardware Requirements 2 Requirements for the Operation of the Block Generator 2.1 Hardware Requirements A PC 16-20, PG 750 or any other IBM-compatible PC with the following configuration is required for the operation of the S5-HLL block generator: A hard disk with at least 1 MB free capacity At least 640 KB main memory A Hercules graphics card or a color graphics card (CGA, EGA or VGA) or compatible graphics card The target hardware for the generated function blocks is the PLC 135 WB. The block generator distinguishes between versions of the PLC 135 WB with COP or with ACOP. 2.2 Software Requirements The block generator runs under MS-DOS. The following software components are required: S5-HLL block generator for SINUMERIK (Siemens, Version 2.2) ASM86 for DOS (intel, Version 2.1) PL/M-86 for DOS (intel, Version 2.7) ic-86 for DOS (intel, Version 4.1) LINK86 for DOS (intel, Version 2.7) LOC86 for DOS (intel, Version 2.5) OH86 for DOS (intel, Version 1.1) SuperCopy (Comfood Software GmbH) Program editor (e.g. Aedit, Word, etc.) Compatible versions can also be used. If required, a structogram editor such as XTOOLS can be used for the development of HLL blocks for the application software. The function blocks generated with the block generator are intended for use on the PLC 135 WB and require a system environment with the PLC operating system and a STEP 5 standard program which calls the HLL function blocks. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 2 1

14 Installation 3.1 Required Programs 3 Installation This chapter describes the installation of the S5-HLL block generator on your MS-DOS computer. 3.1 Required Programs The installation program INSTALL.EXE and the files of the block generator are stored on the program diskette containing the S5-HLL block generator. In addition to the files on the block generator program diskette, you will also require the following programs for the installation of the block generator: PLM86 (PL/M compiler) ic86 (C compiler) ASM86 (Assembler) LINK86 (Linker) LOC86 (Locator) OH86 (Hex converter) SuperCopy Program editor (e.g. Aedit, Word, etc.) The producers of these programs and permissible versions are listed in the section entitled "Requirements for the Operation of the Block Generator". 3.2 Installation Program On the supplied diskette, you will find the installation program INSTALL.EXE, which is used to install the S5-HLL block generator on your hard disk. Insert the diskette in a diskette drive on your computer and change to this drive. To start the program, enter the following command in the command line: INSTALL Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 3 1

15 3 Installation Installation Program When you press the Return key, the following menu appears on the screen: SINUMERIK S5-HLL Installation Program Block Generator Menu 1 Version 1.1 Welcome to the installation program for the block generator To start, define your individual path environment with function key F1. Then start the installation with function key F2. Press function key F8 to exit the installation. Paths Copy End Installation Menu When you press function key F1, a menu appears in which you can define the directory structure to be used for the installation. Block Generator System Data : > C:\PLM < Source Data : > C:\PLM\SOURCE < Object Files : > C:\PLM\OBJECT < Program Lists : > C:\PLM\LIST < SINUMERIK S5-HLL Installation Program Block Generator Menu 1 Version 1.1 Copy End Definition of the Directories for Installation 3 2 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

16 Installation 3.2 Installation Program The software suggests default directories for the standard installation of the block generator. The following files are stored or are expected to be found in the following separate directories: Block generator: System Data All data relating to the block generator are stored here. Source Data The C or PL/M source files are stored here. Object Files The compiled, linked and located HLL blocks are stored here. Program Lists The program lists and MAP files of the HLL blocks are stored here. The conventional editing keys are available for changing the default directories: Ins, Del, BS, Home, Ret and the cursor control keys. If you change the name of a directory, you can restore the old name by pressing the Escape key as long as the cursor is positioned in the field. When you have defined all the directories, start the installation by pressing F2. The installation then proceeds as follows: The defined directories are created. The batch file INST.BAT is started. This file copies the files from the supplied diskette into the directories which you have defined on the hard disk. When all the files have been copied, you can exit the installation program by pressing function key F8. Note: When installing the HLL data generator, the directories which you define for the block generator must be the same as entered here. 3.3 Integration of the Program Editor A program editor call is integrated in the block generator. You can thus edit HLL programs directly by calling the program editor from the block generator. You can choose your own program editor; the AEDIT editor (intel) is the default setting. The program editor is called by the block generator via the batch file EDIT_HLL.BAT. You can integrate the desired program editor (or, to be more precise, you can integrate the call) by editing the EDIT_HLL.BAT file. In the most straightforward case (where the editor is stored within the search path of the operating system) you will only need to change the name of the default editor (AEDIT). Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 3 3

17 3 Installation Integration of the Program Editor Suggestion for EDIT_HLL.BAT: aedit %3%4%5,%6%7%8 Meaning of parameters %1... %8: %1 Current drive %2 Current path %3 Drive where the source file to be edited is stored %4 Path of the source file to be edited %5 Name and extension of the source file to be edited %6 Drive where the list file to be edited is stored %7 Path of the list file to be edited %8 Name and extension of the list file to be edited Parameters %1 to %8 for the batch file are passed by the block generator. Note: Following processing of the batch file by the operating system, the same current directory and drive must be set as when the block generator was called. If the current directory is changed in EDIT_HLL.BAT, it must be reset at the end of EDIT_HLL.BAT using parameters %1 and %2. Example for EDIT_HLL.BAT with directory change: c: cd \editor editor %3%4%5 %1 cd %2 The block generator expects to find the file EDIT_HLL.BAT in the current directory (the directory that was set when the block generator was called). This allows any user to use a program editor of his choice without having to modify the installation of the block generator. 3.4 Installation Procedure This section summarizes all the steps for installing the block generator with the aid of the installation program. Installation steps: Start the computer Insert the program diskette containing the S5-HLL block generator in drive A: of your computer. Make drive A: the current drive by entering A: and pressing the Return key. If a README file is stored on the program diskette, please read this file and follow the instructions provided. Start the installation program by entering INSTALL and pressing the Return key. Enter the desired directory names in the menu of the installation program. 3 4 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

18 Installation 3.4 Installation Procedure Start the file transfer for the block generator by pressing function key F2. When the required directories have been set up and the files have been copied from the program diskette, you can exit the installation program by pressing function key F8. Press function key F1 to call up the menu for entering the directories. Enter the desired directory names. Install the programs PLM86 ic86 ASM86 LINK86 LOC86 OH86 in the directory which you have defined in the installation menu as the system directory for the block generator. Please follow the installation instructions provided by the manufacturers of these programs. Install the SUPERCOPY program in accordance with the instructions of the manufacturer. Define the program editor: In the file HLL_EDIT.BAT, specify the program editor which you want to use to edit HLL programs from the block generator (see the section entitled "Integration of the Program Editor"). If the program editor is not yet ready for operation, please install it now on your computer. Check the FILES command: The block generator opens up to 10 files simultaneously. Check whether the value in the FILES command in the CONFIG.SYS file on your computer is sufficiently high and increase the number if necessary. Specify the screen type: If the computer on which you install the block generator has a plasma screen, you must include the following entry in the AUTOEXEC.BAT file of your computer (please remember to enter the command in upper case letters): SET SWSCREEN=MONO When you have done this, restart your computer to invoke the command. In the event of an operating system error message (such as "Insufficient environment memory"), please consult your DOS manual. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 3 5

19 3 Installation Files and Directories 3.5 Files and Directories The block generator distinguishes between the following directories: Directory with system programs " " system data " " source programs " " object files " " lists S5-DOS directory Current directory The paths to these directories are defined during the installation and can be displayed and modified in Menu 1.1 "Define Directories" of the block generator (see the section entitled "Operation"). The directory with the system programs and the S5-DOS directory are not yet required at the time of installation. Please enter these directories in Menu 1.1. The current directory is the directory which is active when you call the block generator. The following list shows which files of the block generator are stored or are expected to be found in the individual directories. Directory with system programs: The following programs must be stored here: PLM86 ic86 ASM86 LINK86 LOC86 OH86 Note: If no path for the system programs is specified in Menu 1.1 "Define Directories", the DOS search path is used when the listed system programs are called. Directory with system data: This directory must contain the files with the texts for the system data and with the located system data. SYSDATxn.DBF DAT_COMn.LOC with x=p for the PL/M language x=c for the C language and n=1 for the PLC system with COP n=2 for the PLC system with ACOP Directory with source programs: File with assembler code for the block header (*.ASM) File with assembler code for the block end (*.ASM) Source files for the HLL blocks (*.PLM or *.C) 3 6 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

20 Installation 3.5 Files and Directories Directory with the object files: File with the object code for the block header (*.OBJ) File with the object code for the block end (*.OBJ) Object files for the HLL blocks (*.OBJ) All files which are to be linked to the block (e.g. *.OBJ, *.LNK, *.LOC, *.LIB) Files with the linked blocks (*.LNK) Files with the located blocks (*.LOC) Files with the intel hex code for the blocks (*.H86) Files with the prepared binary code for the blocks (*.BIN) List directory: Compiler lists for the HLL source blocks (*.LST) Assembler lists for the block headers and block ends (*.LST) Error list of the assembler (*.ERR) List file for diagnostics data and error messages (S5HLL.ERR) Cross-reference lists (*.CRF) Map files for the linker (*.MP1) Map files for the locator (*.MP2) S5-DOS directory: S5-DOS block file Copies of the link and list files for the HLL blocks entered in the block file (insofar as link and list files exist for the blocks) Current directory: Batch file for calling the program editor EDIT_HLL.BAT Include files of HLL blocks (if no path is specified in the include statement) Temporary files for the block generator Parameter file S5.PAR with the data of the last block generator call made from this directory Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 3 7

21 Operation 4.1 General Operating Information 4 Operation 4.1 General Operating Information The operation of the block generator is performed mainly using the function keys. Certain other special keys are also used in some of the menus. Particular reference should therefore be made to the meaning of the special keys in the individual menus. The active input field is always displayed in inverse format and/or highlighted in color. Some functions in the block generator do not require a menu. If errors occur with these functions, the error messages appear, where possible, in the menu last displayed Menu Tree Call block generator Menu 1 Menu 2 Menu 3 Menu 4 Menu 5 Editor Menu 6 Menu 1.1 Next menu depends on input in Menu 2 Menu Tree of the Block Generator Notes: If several processing steps are selected simultaneously in Menu 2, the block generator determines the sequence of the menus and the other processing steps automatically. The sequence of the processing steps is based on the requirements of the block generation. If the predefined directory structure does not match the real directory structure, Menu 1.1 "Define Directories" appears with an error message when the block generator is called. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 1

22 4 Operation Default Settings in Menus Default Settings in Menus Where possible, appropriate default values are entered in the menus. These defaults are based, for example, on: the last entries in that menu the current values for the selected block, or the processing steps which must be performed on the basis of your entries Use of Upper and Lower Case Letters for Input You can use upper or lower case letters for input. The block generator converts the entries in the menu fields to upper case. When you use a progarm editor to edit the source files of the block programs, the input notation (upper or lower case) is retained. 4.2 Block Generation Sequence The following flow chart illustrates the generation sequence of an HLL block. The framed steps in the block generation flow chart must be performed by the user; the unframed steps are performed by the block generator. The block generation steps can be performed individually, and the order of the individual steps can be changed. The selection of the processing steps and their meaning are described in the following sections on the operation of the block generator. 4 2 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

23 Operation 4.2 Block Generation Sequence Define block key data or Select existing block Define block interface or Change block interface Generate module body for the HLL source program or change declarations and module header in HLL source program Edit HLL source program (integrated editor call) Include any modified input/output parameters in HLL source program 1) Compile HLL source program Edit HLL source program (integrated editor call) Check parameters 2) Correct errors (integrated editor call) Generate ASM block header and block end, assemble, link block, locate, generate hex code Correct hex code and convert Generate S5-DOS block file Transfer HLL blocks Block Generation Sequence (Principle) 1) Only relevant for HLL blocks generated with Version 1 of the block generator (see section entitled "Format of Module Header") 2) Only possible when calling other PL/M blocks from PL/M blocks Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 3

24 4 Operation Calling the Block Generator 4.3 Calling the Block Generator The block generator is started by entering S5_DOS and pressing the Return key. Note: If an S5.PAR file already exists in the current directory (it is generated automatically by the block generator), the data of the last block to be processed from the current directory are reactivated. 4.4 Parameters for HLL Block (Menu 1) When the block generator is called, the following menu (Menu 1 "Parameters for HLL Block") appears on the screen. (The data in the input fields are examples.) Block Type (FB, FX) : >X< Block Number : >004< Block Name : >TOOLVERW< Library Number : >09135< Language (PL/M, C) : >PL/M< PLC System : >PLC 135WB with ACOP< Defpath SINUMERIK S5-HLL Block Generator Menu 1 Version 2.2 Continue Back Menu 1, Parameters for HLL Block In this menu, you enter the basic parameters for the function block which is to be processed. The block generator checks your parameters to see if the block already exists. This check includes the directories which appear in Submenu 1.1. You should therefore make sure that the desired directory structure has been defined (see the description of function key F2 "Defpath" and of Menu 1.1). 4 4 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

25 Operation Define Key Data of HLL Block Define Key Data of HLL Block This section describes the meaning of the input fields in Menu 1 "Parameters for HLL Block". Unique definition of block identification Within the selected directory structure, an HLL block is identified by block type, block number and programming language. If a block matching the parameters entered for the block type, block number and programming language does not yet exist, a new block is subsequently created. This is indicated by the following message in the lower region of Menu 1: Note: New block will be created When you move the cursor away from one of the input fields for the block type, block number or programming language, the block generator checks whether a block for the current data already exists in the defined directory structure. If the block generator finds a matching HLL block, the remaining input fields of Menu 1 are filled with the data of this block. Block type (FB, FX) Input: Meaning, effect: Space bar Switch block type B Select block type FB X Select block type FX When you enter "B" or "X", the appropriate block type is set and the cursor jumps to the next field in the menu. Block number Input: Meaning, effect: Here you enter the number of the function block you want to process. (decimal number) Language (PL/M, C) Input: Space bar Block name Input: Alphanumeric, max. 8 characters Meaning, effect: You enter the programming language in which the block is to be, or has been, created. Press the space bar to change the programming language in the display. Meaning, effect: Here you can define a name for the block. The definition of a block name is optional and is not required for operation of the block generator. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 5

26 4 Operation Define Key Data of HLL Block Library number Input: Decimal number Meaning, effect: Here you can define the number of a block library. The definition of a library number is optional and is not required for operation of the block generator. PLC system Input: Space bar Meaning, effect: Here you can define the PLC system on which the block is to be used. Use the Space bar to toggle the display between the PLC 135 WB with COP and the PLC 135 WB with ACOP. File names This parameter defines the file name under which the block generator stores the source file for a block. File names have the following structure: xfyxxx.xxx File name extension PLM for PL/M function block C for C function block Block number Value range: Parameter with leading zeroes Block type "FB" or "FX" Language identifier P for PL/M C for C Notes: When you call the block generator, the data of the last block to be processed are generally reactivated (see note in the section entitled "Calling the Block Generator"). If there are no parameters for previous blocks, the following fixed values appear as the defaults in Menu 1: Block: FB 000 Block Name and Library Number: unassigned Language: PL/M PLC System: PLC 135 WB with ACOP If the last directories to be used no longer exist, Menu 1.1 appears (see the section "Define Directories (Menu 1.1)"). The input fields for block type, block number, language and PLC system must be filled in. 4 6 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

27 Operation Define Key Data of HLL Block The meaning of the PLC system for block generation is described in the section entitled "Upwards Compatibility". A new block is not created until you reach the "Define Block Interface" processing step. This processing step is therefore always selected for new blocks in Menu 2 "Select Processing Steps". Modifications to the library number or block name for existing blocks: Modifications to the library number or block name only take effect when you reach the "Change Block Interface" processing step. If you do not run this processing step following a change to the block name or library number, the changes are cancelled. When you change to Menu 2 "Select Processing Steps", the "Change Block Interface" step is therefore always selected following a change to the library number or block name. The file names are assigned by the block generator and cannot be changed. Examples: PL/M function block FB 16 File name: PFB016.PLM C function block FX 8 File name: CFX008.C Function Keys and Special Keys in Menu 1 F1 Continue The entries in Menu 1, for selecting and defining the block to be processed, are accepted. They are used for further processing of the block. Menu 2 appears for the selection of the processing steps. F2 Defpath Menu 1.1 appears for defining the directories. F8 Back Exits the block generator. The last block to be processed and the directory structure which was used are stored in the current directory. These parameters are used as defaults the next time the block generator is called up (from the current directory). If you exit the block generator without having activated F1 "Continue" from Menu 2 "Select Processing Steps", F8 "Back" in Menu 1 acts as a Cancel function. Because the block has not been processed in this case, no data are saved. Space bar Use the Space bar to toggle between the valid values in the input fields for block type, language and PLC system. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 7

28 4 Operation Define Directories (Menu 1.1) 4.5 Define Directories (Menu 1.1) The directories used by the block generator when processing the block are defined during installation. The directories are displayed and can be modified in Menu 1.1. The files which the block generators stores or expects to find in the individual directories are described in the section entitled "Files and Directories". When you select Menu 1.1, the current directory structure is displayed. (The paths in the input fields of the illustrated menu are examples). SINUMERIK S5-HLL Block Generator Menu 1.1 Version 2.2 System Programs : >C:\SYSTEM\ < System Data : >C:\S5HLL\SYSDAT\ < Source Files : >D:\PROJEKT\MASCHINE\PLC1\SOURCE\ < Object Files : >D:\PROJEKT\MASCHINE\PLC1\OBJ\ < Program Lists : >D:\LISTEN\TEMP\ < S5-DOS Directory : >H: < Continue Back Menu 1.1 Defining the Directories Notes: When the block generator is called, it searches in the current directory for information on the last directory structure to be used. These settings are reactivated when the block generator is called. If the block generator does not find any information on the default directory structure, the current directory is used for all paths. In this case, the fields in Menu 1.1 are empty. If the defaults for the last directory structure to be used do not match the real directory structure, Menu 1.1 appears immediately after the block generator is called. In this case, you must change the settings in the menu. If you do not change the incorrect paths (and activate F8 "Back" instead), the block generator uses the current directory for all paths. The default settings are deleted. The above situation can arise when directories are deleted. 4 8 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

29 Operation Paths Paths The length of the path for the directories is limited to 30 characters (including the drive parameter). Paths must be terminated with a Backslash (\); if the Backslash is omitted, it is automatically inserted by the block generator. If you only enter a drive, you do not need the Backslash; your entry is accepted unmodified by the block generator Function Keys and Special Keys in Menu 1.1 F1 Continue The block generator initially checks whether the directories defined in Menu 1.1 exist. If not all of the defined directories exist, the block generator outputs an error message. If this happens, you should correct the path. If the defined directories exist, the directory structure set in Menu 1.1 is activated immediately. When the path check is complete, you exit Menu 1.1 and Menu 1 "Parameters for HLL Block" appears. F8 Back Menu 1 "Parameters for HLL Block" reappears. Any changes which you have made in Menu 1.1 are cancelled. The parameters which were active before you selected Menu 1.1 remain valid; no checks are performed (exception: see notes above).,, Ret, PgUp, PgDn, Home, End When the block generator is called, it searches in the current directory for information on the last directory structure to be used. These settings are reactivated when the block generator is called.,, BS, Del, Ins These key functions are available for editing text in the input fields. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 9

30 4 Operation Select Processing Steps (Menu 2) 4.6 Select Processing Steps (Menu 2) In Menu 2, you can enter the processing steps for the block selected in Menu 1. You can define several processing steps simultaneously. The block generator executes the defined processing steps in an appropriate order. The processing steps are selected with an "X" or the Space bar. The Space bar has a toggle function which you can use to deselect processing steps which are already selected, and viceversa. PL/M Function Block: >PFX004< Name: >TOOLVERW< Please Select: Define Block Interface > < Change Block Interface >X< Create Block Program >X< Generate Block > < Prepare Block for Transfer > < Check Block > < SINUMERIK S5-HLL Block Generator Menu 2 Version 2.2 Continue Back Menu 2, Select Processing Steps 4 10 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

31 Operation Description of the Processing Steps Description of the Processing Steps Define Block Interface This function defines the call parameters and the system interface for the new block. The function runs in Menus 5 and 6. The block generator subsequently generates the module body for the HLL block. Caution: In this processing step, the block generator creates a new block. If this processing step is selected for an existing block, the existing block is deleted. You are prompted to overwrite the block or cancel the operation Change Block Interface You can use this function to modify the block interface for existing blocks. Menus 5 and 6 are also used for this function. In contrast to the "Define Block Interface" processing step, the source file of the HLL block is not created, it is only modified. Changes to the block name or library number which you have entered in Menu 1 are activated during this processing step Create Block Program You can edit the block with the installed editor (see the section entitled "Installation") by calling it from the block generator Generate Block In Menu 3 "Compile and Link HLL Block", you can define additional link modules with which the block is to be linked. The block generator creates the assembler header for the function block and compiles the HLL source file. Following error-free compilation of the block, the block is linked and located. The hex code for the HLL block is subsequently generated from the resulting file Prepare Block for Transfer In Menu 4 "Generate S5-DOS Block File" you can define which function blocks are to be stored together in a block file. The block generator then creates the S5-DOS block file which is used to transfer the blocks to the PLC (or initially to the programming device). Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 11

32 4 Operation Description of the Processing Steps Check Block The block generator checks the parameters of the HLL block calls in the current function block. This parameter check can only be performed on blocks which have been created in the PL/M language and compiled without errors. If the HLL block still contains errors, particularly violations of the block structure, the results of the parameter check will be purely arbitrary. For the parameter check, the block generator must be able to access the source files of all the HLL blocks called in the PL/M block and all the Include files used. If the block generator cannot find these files, it cancels the parameter check and outputs an error message. During the parameter check, the block generator produces a cross-reference list of all HLL blocks called by the block being checked. This cross-reference list is stored in the list directory defined in Menu 1.1 "Define Directories". The file name differs from the source file only with respect to the file name extension. File names for cross-reference lists always have the extension ".CRF". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * SINUMERIK Block Generator S5-PL/M Version 2.2 Date * * Directory of all blocks called from: FB 8 Page: 1 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Block Type Number Name Called in File name Line Parameters FB 2 I/Q/F PFB008.PLM 99 NR : D KF NR1 : I BY 4 12 Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0

33 Operation Function Keys in Menu Function Keys in Menu 2 F1 Continue The block generator executes the processing steps selected in Menu 2 in a logical sequence. Further menus and/or messages are displayed on the screen. When all selected steps have been executed, Menu 1 reappears on the screen. F8 Back Menu 1 is displayed again. The selected processing steps are not executed, however the selections that you made in Menu 2 are retained.,,,, Ret, PgUp, PgDn, Home, End You can use these keys to select the desired input field. The page keys and the Home and End keys move the cursor to the first or last input field. You cannot exit an input field that contains illegal characters ("X" or the space character are legal). Space bar The Space bar can be used to set or cancel selections in the input fields. The Space bar acts as a toggle function. Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0 4 13

34 4 Operation Define/Change Call Parameters (Menu 5) 4.7 Define/Change Call Parameters (Menu 5) In Menu 5, you define the call parameters for the block. The function block is displayed as a graphical symbol in Menu 5; the inputs and outputs of the function block correspond to the call parameters. Call parameters can be redefined in Menu 5, and parameters which are displayed can be modified or deleted Block without Call Parameters A new function block will initially have no call parameters. In Menu 5, a block without parameters is represented by an empty box. The block generator asks you whether call parameters are to be assigned to the block. In this case, Menu 5 will have the following appearance: PL/M Block: FX 004 Block Name: TOOLVERW Library Number: 9135 Assign parameters to this block? SINUMERIK S5-HLL Block Generator Menu 5 Version 2.2 Yes No Menu 5, Define/Change Call Parameters Use function keys F1 and F2 to define whether or not call parameters are to be assigned to the block. If you enter "No" with function key F2, Menu 6 "Define/Change System Interface" appears and no call parameters are assigned to the function block. If you press function key F1 for "Yes", you are prompted to enter a parameter name. Note: If you change the interface on existing blocks which do not have call parameters, the block generator responds in the same way as with a new block Siemens AG 1990 All Rights Reserved 6FC5197-0AC00-0BP0