Transcription

1 Basic Process Library WinCC 7.3/7.4 / TIA Portal V14 SP1 / S / S Siemens Industry Online Support

2 Legal information Legal information Use of application examples Application examples illustrate the solution of automation tasks through an interaction of several components in the form of text, graphics and/or software modules. The application examples are a free service by Siemens AG and/or a subsidiary of Siemens AG ( Siemens ). They are nonbinding and make no claim to completeness or functionality regarding configuration and equipment. The application examples merely offer help with typical tasks; they do not constitute customer-specific solutions. You yourself are responsible for the proper and safe operation of the products in accordance with applicable regulations and must also check the function of the respective application example and customize it for your system. Siemens grants you the non-exclusive, non-sublicensable and non-transferable right to have the application examples used by technically trained personnel. Any change to the application examples is your responsibility. Sharing the application examples with third parties or copying the application examples or excerpts thereof is permitted only in combination with your own products. The application examples are not required to undergo the customary tests and quality inspections of a chargeable product; they may have functional and performance defects as well as errors. It is your responsibility to use them in such a manner that any malfunctions that may occur do not result in property damage or injury to persons. Disclaimer of liability Siemens shall not assume any liability, for any legal reason whatsoever, including, without limitation, liability for the usability, availability, completeness and freedom from defects of the application examples as well as for related information, configuration and performance data and any damage caused thereby. This shall not apply in cases of mandatory liability, for example under the German Product Liability Act, or in cases of intent, gross negligence, or culpable loss of life, bodily injury or damage to health, non-compliance with a guarantee, fraudulent non-disclosure of a defect, or culpable breach of material contractual obligations. Claims for damages arising from a breach of material contractual obligations shall however be limited to the foreseeable damage typical of the type of agreement, unless liability arises from intent or gross negligence or is based on loss of life, bodily injury or damage to health. The foregoing provisions do not imply any change in the burden of proof to your detriment. You shall indemnify Siemens against existing or future claims of third parties in this connection except where Siemens is mandatorily liable. By using the application examples you acknowledge that Siemens cannot be held liable for any damage beyond the liability provisions described. Other information Siemens reserves the right to make changes to the application examples at any time without notice. In case of discrepancies between the suggestions in the application examples and other Siemens publications such as catalogs, the content of the other documentation shall have precedence. The Siemens terms of use ( shall also apply. 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 protect plants, systems, machines and networks against cyber threats, it is necessary to implement and continuously maintain a holistic, state-of-the-art industrial security concept. Siemens products and solutions constitute one element of such a concept. Customers are responsible for preventing unauthorized access to their plants, systems, machines and networks. Such systems, machines and components should only be connected to an enterprise network or the Internet if and to the extent such a connection is necessary and only when appropriate security measures (e.g. firewalls and/or network segmentation) are in place. For additional information on industrial security measures that may be implemented, please visit Siemens products and solutions undergo continuous development to make them more secure. Siemens strongly recommends that product updates are applied as soon as they are available and that the latest product versions are used. Use of product versions that are no longer supported, and failure to apply the latest updates may increase customer s exposure to cyber threats. To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed at: Entry ID: , V1.1, 06/2018 2

3 1 Library overview 1.1 Hardware and software requirements Table of contents Legal information Library overview Hardware and software requirements Library resources General functions General functions General faceplate functions FB 2001 LibBPL_Mtr FB 2002 LibBPL_Mtr FB 2003 LibBPL_MtrF FB 2004 LibBPL_Vlv FB 2005 LibBPL_VlvA FB 2008 LibBPL_AnaRead FB 2010 LibBPL_AnaAvg FB 2032 LibBPL_CntrP (impulse counter) FB 2033 LibBPL_CntrP (integrated counter) FB 2034 LibBPL_CntrD (differential counter) FB 2014 LibBPL_HMI_Cntr FB 2015 LibBPL_SetCrv FB 2115 LibBPL_HMI_SetCrv FB 2012 LibBPL_CtrlPID FB 2013 LibBPL_CtrlStp FB 2021 LibBPL_ClctVal FB 2031 LibBPL_Msg FB 2023 LibBPL_Intlk FB 2020 LibBPL_Aggr FB 2018 LibBPL_OpAna FB 2019 LibBPL_OpDig FB 2017 LibBPL_TimeSw FB 2117 LibBPL_HMI_TimeSw FB 2016 LibBPL_Select FB 2116 LibBPL_HMI_Select FB 2011 LibBPL_Polygon FB 2022 LibBPL_PU Internal functions FC 2099 LibBPL_GetEditData FC 2084 LibBPL_SetStreamDWord FC 2082 LibBPL_SetStreamReal FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamWord FB 2099 LibBPL_Log Working with the library Integrating the library in STEP New object created Error messages Notes and restrictions Version of the Blocks Version of the Faceplate Appendix Entry ID: , V1.1, 06/2018 3

4 1 Library overview 1.1 Hardware and software requirements 5.1 Service and support Links and literature Change documentation Entry ID: , V1.1, 06/2018 4

5 1 Library overview 1.1 Hardware and software requirements 1 Library overview What you will receive: This document describes the Basic Process Library block. With the block library you receive tested code with clearly defined interfaces. In this manner you can set up according to the task to be implemented. The core of the document is the description of all the blocks belonging to the block library of the functionality implemented by these blocks This documentation also shows possible areas of application and helps you to integrate the library into your application with step-by-step instructions. Preconditions: Know-how for the products used in this application example is imparted in the following SITRAIN courses. Basics of Programming \3\ TIA-PRO1, de \3\ TIA-PRO1, en \4\ The basics of WinCC Professional or WinCC V7 WinCC Professional: TIA-WCCS, de \5\ WinCC Professional: TIA-WCCS, en \6\ WinCC V7: ST-BWINCCS, de \7\ WinCC V7: ST-BWINCCS, en \8\ Entry ID: , V1.1, 06/2018 5

6 1 Library overview 1.1 Hardware and software requirements 1.1 Hardware and software requirements Requirements for this library In order to use the functionality of the library described here, the following hardware and software requirements must be met: Hardware Table 1-1 Component Item number Amount S7-1200: 1 S Software Table 1-2 Component Item number Amount WinCC V7.3 Upd8 1 TIA V14 SP1 1 Note Alternatively, similar components can also be used for the components listed in Table 1-2. A migration of the TIA library blocks to TIA V15 is possible. Entry ID: , V1.1, 06/2018 6

7 1 Library overview 1.2 Library resources 1.2 Library resources What will you find here? Below you will find an overview of the memory usage of the blocks of the Basic Process Library. Assignment of the individual blocks The blocks use the parameterized block numbers described in the table. They can be changed. Table 1-3 Block Symbol Memory allocation FB 2001 LibBPL_Mtr 55 Kbytes FB 2002 LibBPL_MtrDS 70 Kbytes FB 2003 LibBPL_MtrF 53 Kbytes FB 2004 LibBPL_Vlv 56 Kbytes FB 2005 LibBPL_VlvA 53 Kbytes FB 2008 LibBPL_AnaRead 52 Kbytes FB 2010 LibBPL_AnaAvg 49 Kbytes FB 2032 LibBPL_CntrP 19 Kbytes FB 2033 LibBPL_CntrA 22 Kbytes FB 2034 LibBPL_CntrD 20 Kbytes FB 2014 LibBPL_HMI_Cntr 35 Kbytes FB 2015 LibBPL_SetCrv 43 Kbytes FB 2115 LibBPL_HMI_SetCrv 45 Kbytes FB 2012 LibBPL_CtrlPID 60 Kbytes FB 2013 LibBPL_CtrlStp 65 Kbytes FB 2021 LibBPL_ClctVal 16 Kbytes FB 2031 LibBPL_Msg8 26 Kbytes FB 2023 LibBPL_Intlk8 46 Kbytes FB 2020 LibBPL_Aggr8 96 Kbytes FB 2018 LibBPL_OpAna 22 Kbytes FB 2019 LibBPL_OpDig 17 Kbytes FB 2017 LibBPL_TimeSw 22 Kbytes FB 2117 LibBPL_HMI_TimeSw 55 Kbytes FB 2016 LibBPL_Select 75 Kbytes FB 2116 LibBPL_HMI_Select 29 Kbytes FB 2011 LibBPL_Polygon 53 Kbytes FB 2022 LibBPL_PU1 108 Kbytes FC 2099 LibBPL_GetEditData 10 Kbytes FC 2081 LibBPL_SetStreamString 6 Kbytes FC 2082 LibBPL_SetStreamReal 6 Kbytes FC 2083 LibBPL_SetStreamWord 6 Kbytes FC 2084 LibBPL_SetStreamDWord 6 Kbytes FB 2099 LibBPL_Log15 16 Kbytes Entry ID: , V1.1, 06/2018 7

8 1 Library overview 1.3 General functions 1.3 General functions General functions Station related locking Authorization levels This concept is supported by all blocks. This function is activated by icon and locks the other stations. This functionality ensures that the technical function (motor, valve...) is only controlled by the currently selected faceplate. Access can also only be enabled again by the respective station. There are 4 authorization levels for operating the faceplates, which are described in the following table. The lower-level functionality can be used with a higher-level access level. Table 1-4: Authorization levels Level Description Operator Technological operation Setting and resetting the stationrelated interlock at the current station Super user Resetting the station-related locking at all stations Engineer Changing parameters Administrator Full access (currently not used) Central alarm and acknowledgement concept This applies to all functions that can generate acknowledgeable messages. Each function with notification function receives internal WinCC variables, one for the status and another for the acknowledgement. These variables are prefixed with the name of the technological function followed by _MsgStatus and _MsgAck. In this way, the status of each function can be displayed and acknowledged from the faceplate General faceplate functions Each faceplate has a toolbar at the top. These can be used to switch between the surfaces for operation Status display (1) Figure 1-1: Toolbar Shows an overview and allows operation of the function. Entry ID: , V1.1, 06/2018 8

9 1 Library overview 1.3 General functions Message display (2) Alarms and warnings are displayed using the Msg8 block. Figure 1-2: Message display The saved errors and warnings are displayed here and the messages can be filtered with the options in the upper area. In addition, these messages can be printed, exported and sorted or saved short and long term archives can be opened. Parameter view (3) Here you can make settings for the faceplate and the technological object. Entry ID: , V1.1, 06/2018 9

10 1 Library overview 1.3 General functions Locking for other stations (4) The operator can lock and unlock the operation of the object for other stations. The operator can block the operability for other stations. The service lock can only be deactivated by the access level Superuser. The service lock only affects the faceplates. All relevant views at the locked station are displayed semitransparently and cannot be operated. Figure 1-3: Interlock Faceplate Close (5) Faceplate can be closed. Entry ID: , V1.1, 06/

11 2.1 FB 2001 LibBPL_Mtr This chapter describes all blocks of the Basic Process Library. 2.1 FB 2001 LibBPL_Mtr Block Figure 2-1: LibBPL_Mtr Function description The block Mtr can be used to operate motors with one direction of rotation and one speed. The engine can be used in the following modes: Manual mode: The engine is operated via the HMI. Automatic mode: Engine is controlled by the CPU. Local mode: Engine is controlled directly at the engine itself. (Local operation has the highest priority) Repair operation: Input indrepair is set; no control possible and no display of errors and warnings. The block controls the reaction of the motor to a switch-over from ON or OFF. Error and status messages are generated automatically and can be displayed using the Msg8 block. In addition, the diagnostic buffer of the CPU can be displayed in the HMI. Entry ID: , V1.1, 06/

12 2.1 FB 2001 LibBPL_Mtr In all operating modes, the motor can only be switched on if the switch-on enable ("indrelease") is set. If the engine is switched on, a missing switch-on enable does not lead to a switch-off. The following functions can be used for maintenance: Runtime meter Limit for operating hours (monitoring with limit greater than zero) Counter Change Controls Limit counter controls (monitoring with limit greater than zero) Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-1 Parameters Data type Description identname string[30] Name of the instance runtime indoff bool Feedback engine true: Engine is OFF indon bool Feedback engine true: Motor is ON indtrip bool true: OK false: Emergency OFF inderr bool true: External error false: OK indwarn bool true: External Warning fals: OK indrelease bool true: Engine can be activated false: Engine is locked indinterlock bool Interlocking (switches the engine off or prevents it from being switched on) indrepair bool Feedback repair mode (engine can only be controlled externally; errors and warnings are not displayed via faceplate) indlocal bool true: Engine is in local mode and can only be activated by input cmdlocon. cmdlocon bool true: Control command for local operation cmdaut bool External mode command Positive edge -> Automatic mode cmdautoon bool true: Control command for automatic operation cmdreset bool External reset command "Reset" is performed on rising edge. Entry ID: , V1.1, 06/

13 2.1 FB 2001 LibBPL_Mtr Parameters Data type Description timeout time Parameter monitoring time for "Timeout" and "Plausibility" messages Output parameters Table 2-2 Parameters Data type Description on bool Control of the engine collecterror bool Collective error collectmaintenance bool Collective warning modeaut bool Collective maintenance message collectwarning bool Automatic operating mode active reset bool "Reset" active interror word Fault detection of the block Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Status and Error Display Table 2-3 Status Description 16#0001 Error when reading the system time 16#0002 Error when writing the parameter string "LibBPLMtr". 16#0003 Error when writing the parameter string "plchmi". Table 2-4: Values for internal log Value HMI Description 16#0101 ERR TRIP Emergency stop detected 16#0102 ERR EXTERN External error identified 16#0103 ERR TIMEOUT Timeout Error identified 16#0104 ERR PLAUS Plausibility error identified 16#0201 CMD RESET Reset command identified 16#0202 CMD AUT Switchover to automatic mode 16#0203 CMD MAN Switchover to manual mode 16#0204 CMD LOC ON Enable to switch on activated 16#0205 CMD LOC OFF Enable to switch on activated 16#0206 CMD MAN ON Local operation deactivated 16#0207 CMD MAN OFF Local operation deactivated 16#0208 AUT ON Control disabled 16#0209 AUT OFF Control enabled Entry ID: , V1.1, 06/

14 2.1 FB 2001 LibBPL_Mtr Value HMI Description 16#020A NO RELEASE Switch-on blocked due to missing switchon enable 16#020B [CHECK] Test entry initiated via faceplate 16#020C REPAIR OFF Repair operation deactivated 16#020D REPAIR ON Repair shop activated 16#020E INTLCK OFF Locking deactivated 16#020F INTLCK ON Interlock activated Table 2-5: Warnings and error "HMI_msg_errWrn Bit Type Description 0 error Emergency Off 1 error External error 2 error Timeout 3 error Plausibility 4 maintenance Operating hours limit reached 5 maintenance Operating hours limit reached 6 maintenance External Warning Table 2-6: Status "HMI_msg_status Bit Description 0 Engine off 1 Engine ON 2 Manual (=0), automatic (=1) operating mode 3 On-site operating mode 4 Start enable 5 Engine switches off 6 Engine switches on 7 Automatic command (0=Off, 1=On) 8 Stored message "Emergency stop" 9 Stored message "External error" 11 Interlock active 12 Repair operation 13 Collective message warning 14 Collective message warning 15 Collective message error 16 "Emergency stop" message 17 Message "External error" 18 Message "Timeout" 19 Message "Plausibility" 20 Message "Operating hours limit reached" 21 Message "Switch-on limit reached" Entry ID: , V1.1, 06/

15 2.1 FB 2001 LibBPL_Mtr Table 2-7: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLMtr string[150] Parameter string: Version / identname / comment / opstation / overwrite HMI_msg_errWrn word Messages (alarms, warnings) HMI_msg_status dword Status double word HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plcHMI string[200] Parameter string Faceplate The faceplate can be used to operate an engine. It shows the status and the warnings or errors of the engine. In addition, parameters such as operating hours, monitoring time and a limit for operating cycles can be set. Entry ID: , V1.1, 06/

16 2.1 FB 2001 LibBPL_Mtr Status display Display Status On Error Start Stop ON in automatic mode Figure 2-2: Controller Mtr Engine in repair mode All errors are saved and displayed in the lower area of the faceplate. To restart the engine, these must be reset. Error display: Emergency Stop (indtrip) External error (inderr) Timeout (feedback monitoring) Plausibility Engine in field operation When an error occurs, the motor is switched off and automatic mode changes to manual mode. Entry ID: , V1.1, 06/

17 2.1 FB 2001 LibBPL_Mtr The following table shows the different statuses of the displayed errors. Table 2-8: Status and Error Error is pending and is displayed with a red dot and red frame. The error must be acknowledged and reset. Error is no longer pending, but must be reset. Error detected Acknowledgement function is not implemented. Entry ID: , V1.1, 06/

18 2.1 FB 2001 LibBPL_Mtr Parameter view Operating hours Displays the current operating hours of the motor. In addition, a limit can be parameterised. Switch cycles Counts the operating cycles of the engine. In addition, a limit can be set for the switching cycles. Timeout There are two ways to set the time monitoring. As a rule, this is set directly on the block in the PLC. In addition, this can also be set and activated in the faceplate. Comment A comment can be assigned and is displayed in the upper area of the faceplate. Figure 2-3: Parameter view 1 PLC Log The commands are displayed here. Generate test signal A test message can be created for testing. Figure 2-4: Parameter view 2 Entry ID: , V1.1, 06/

19 2.1 FB 2001 LibBPL_Mtr Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_MTR" must be called at the "Mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-9 Property Status Param MsgStatus (optional) Variable [Instance]_HMI_msg_status [Instance]_HMI_LibBPLMtr [Instance]_MsgStatus The icons for displaying pumps have a "Direction" property which can be used to set the "flow direction". The acknowledgement state is only displayed on all icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. Entry ID: , V1.1, 06/

20 2.1 FB 2001 LibBPL_Mtr SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

21 2.1 FB 2001 LibBPL_Mtr Integration of additional blocks It is possible to combine the module with other blocks and integrate their calls into the faceplate. In the faceplate, the icon appears in appropriate places By clicking on the icon the corresponding faceplate can be called up. The following conditions must be fulfilled in the SPS program: The name of the instance of the block to be linked must consist of the name of the Mtr instance and a specific suffix. The blocks must be interconnected. The value of the parameter "identname" on the Mtr and Msg8 block must be the same if the messages are to appear in the message window of the engine. The following connections are possible: Block "Msg8" with the parameter "inderr" (external error) Block "Msg8" with the parameter "inderr" (external warning) "Intlk8" block with the "indrelease" parameter (switch-on enabled) "Intlk8" block with the "indinterlock" parameter (interlock) Connection with "Msg8": The instance of the "Msg8" block must have the suffix "_ErrExt" (for connection with external error) or "_WrnExt" (for connection with external warning). If the stored messages of the "Msg8" block are to be used: The "collectsave" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the engine block. The "reset" output is connected to the "Msg8" input "cmdreset". If the actual messages of the "Msg8" block are to be used: The "collectact" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the motor block. The "Msg8" input "cmdreset" is set to "True" if the reset is to be performed automatically. Connection with "Intlk8": The "Intlk8" device must have the suffix "_RelOn" (for connection with switch-on enable) or "_LockOn" (for connection with interlock). The "result" output of "Intlk8" is routed to the "indrelease" or "indinterlock" input. Entry ID: , V1.1, 06/

22 2.2 FB 2002 LibBPL_Mtr 2.2 FB 2002 LibBPL_Mtr Block Figure 2-5: LibBPL_MtrDS Function description This module controls a motor with two directions and two speeds. The engine can be used in the following operating modes. Manual mode: The engine is operated via the HMI. Automatic mode: Engine is controlled by the CPU. Local mode: Engine is controlled directly at the engine itself. (Local operation has the highest priority) Repair operation: Input indrepair is set; no control possible and no display of errors and warnings. Entry ID: , V1.1, 06/

23 2.2 FB 2002 LibBPL_Mtr The block controls the response time when the motor is switched to ON or OFF. Error and status messages are generated automatically and can be displayed using the Msg8 block. In addition, the diagnostic buffer of the CPU can be displayed in the HMI. The following functions can be used for maintenance: Runtime meter Limit for operating hours (monitoring with limit greater than zero) Counter Change Controls Limit counter controls (monitoring with limit greater than zero) Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-10 Parameters Data type Description identname string[30] Name of the instance runtime indoff bool Feedback engine true: Engine is OFF indon bool Feedback engine true: Engine is ON indspeed2 bool Feedback speed true: Engine in second gear indreverse bool Feedback in second gear true: Engine in second direction of rotation indtrip bool true: OK false: Emergency OFF inderr bool true: External error false: OK indwarn bool true: External Warning fals: OK indrelease bool true: Engine can be started false: Engine is locked indinterlock Bool Interlocking (switches the engine off or prevents it from being switched on) indrepair bool Feedback repair mode (engine can only be controlled externally; errors and warnings are not displayed via faceplate) indlocal bool true: Engine is in local mode and can only be activated by input cmdlocon. Entry ID: , V1.1, 06/

24 2.2 FB 2002 LibBPL_Mtr Parameters Data type Description cmdlocon bool true: Control command for local operation cmdlocspeed2 bool true: On-site operation speed 2 cmdlocreverse bool true: On-site operation second direction of rotation cmdaut bool External control command Positive edge -> Reset cmdautoon bool true: Control command for automatic operation cmdautspeed2 bool true: Automatic mode -> Speed 2 cmdautreverse bool true: Automatic mode -> second direction of rotation cmdreset bool External reset command "Reset" is performed on rising edge. timeout time Parameter monitoring time for "Timeout" and "Plausibility" messages timespeed1 time Parameter Time during which the motor must have run in stage 1 before switching to stage 2 is possible timechangedir time Parameter time during which the engine must be switched off before it can start in the opposite direction of rotation. Output parameters Table 2-11 Parameters Data type Description on bool Control of the engine speed2 bool Control of speed 2 reverse bool Control Reverse mode collecterror Collective error collectwarning bool Collective warning collectmaintenance bool Collective maintenance message modeaut bool Automatic operating mode active reset bool "Reset" active interror word Fault detection of the block Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-12 Status Description 16#0001 Error when reading the system time 16#0002 Error when writing the parameter string "LibBPLMtrDS". 16#0003 Error when writing the parameter string "PlcHmi" Entry ID: , V1.1, 06/

25 2.2 FB 2002 LibBPL_Mtr Table 2-13: Values for internal log Value HMI Description 16#0101 ERR TRIP Emergency stop detected 16#0102 ERR EXTERN External error identified 16#0103 ERR TIMEOUT Timeout Error identified 16#0104 ERR PLAUS Plausibility error identified 16#0201 CMD RESET Reset command identified 16#0202 CMD AUT Switchover to automatic mode 16#0203 CMD MAN Switchover to manual mode 16#0204 RELEASE ON Enable to switch on activated 16#0205 RELEASE OFF Enable to switch on activated 16#0206 MODE LOC ON Local operation deactivated 16#0207 MODE LOCAL OFF Local operation deactivated 16#0208 OFF Control disabled 16#0209 ON1 Control of speed 1 activated 16#020A ON2 Control of speed 2 activated 16#020B ON1R Control of speed 1 reverse activated 16#020C ON2R Control of speed 2 reverse activated 16#020D NO RELEASE Switch-on blocked due to missing switch-on enable 16#020E [CHECK] Test entry initiated via faceplate 16#020F WAIT_SPEED Waiting time for switching over to speed 2 active 16#0210 WAIT_DIR Waiting time for switching to opposite direction of rotation active 16#0211 REPAIR OFF Repair operation deactivated 16#0212 REPAIR ON Repair shop activated 16#0213 INTLCK OFF Locking deactivated 16#0214 INTLCK ON Interlock activated Table 2-14: Warnings and error "HMI_msg_errWrn Bit Type Description 0 error Emergency Off 1 error External error 2 error Timeout 3 error Plausibility 4 maintenance Operating hours limit reached 5 maintenance Operating hours limit reached 6 maintenance External Warning Table 2-15: Status "HMI_msg_status Bit Description 0 OFF 1 On 2 Automatic operation Entry ID: , V1.1, 06/

26 2.2 FB 2002 LibBPL_Mtr Bit Description 3 Local operation 4 Start enable 5 On-Off 6 Off-On 7 Automatic command (On) 11 Interlock active 12 Repair operation 13 Collective Maintenance Message 14 Collective message warning 15 Collective alarm message 24 Speed 2 active 25 Reverse operation active 26 Automatic command (speed 2) 27 Automatic command (Reverse) Table 2-16: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLMtr DS HMI_msg_errWr n HMI_msg_statu s HMI_param_val ues_edit HMI_param_v alues_plchmi instfblog15_ datahmi string[160] word dword string[100] string[100] string[210] Parameter string: Version / identname / comment / opstation / overwrite Messages (alarms, warnings) Status double word Parameter-Edit-String Parameter string Log-Data(optional) Table 2-17: Internal variables für HMI Communication Parameters Data type Description MsgAck byte Acknowledgement messages MsgStatus word Message statuses Entry ID: , V1.1, 06/

27 2.2 FB 2002 LibBPL_Mtr Faceplate The faceplate can be used to operate an engine with two speeds and two directions of operation. It shows the status and the warnings or errors of the engine. In addition, parameters such as operating hours, monitoring time and a limit for operating cycles can be set. Status display Figure 2-6: Motor DS Representation status ON All errors are saved and displayed in the lower area of the faceplate. To restart the engine, these must be reset. Error Switching on Switching off Automatic operation: Repair operation On-site operation Speed 2 is activated Invert is activated Activate speed 2 or reverse direction of rotation Entry ID: , V1.1, 06/

28 2.2 FB 2002 LibBPL_Mtr Parameter view Page 1 and 3 are identical to the parameter view of the Mtr faceplate. Timer for speed 2 Here time can be paramameterised, the engine must have been running at low speed in order to activate the high speed. Timer for stop before direction change Here a timer can be set for how long the engine must be idle before the reverse direction of rotation can be activated. In the lower area you can select whether a manual speed or direction change may be carried out. Figure 2-7: Parameter view 2 Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_MTRDS" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-18 Property Status Param MsgStatus (optional) Variable [Instance]_HMI_msg_status [Instance]_HMI_LibBPLMtrDS [Instance]_MsgStatus Entry ID: , V1.1, 06/

29 2.2 FB 2002 LibBPL_Mtr The "EnableSpeed2" and "EnableReverse" properties can be used to set the visibility of the speed or reverse display. The acknowledgement state is only displayed on all icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Integration of additional blocks It is possible to combine the module with other blocks and integrate their calls into the faceplate. In the faceplate, the icon appears in appropriate places By clicking on the icon the corresponding faceplate can be called up. The following conditions must be fulfilled in the SPS program: The name of the instance of the block to be linked must consist of the name of the Mtr instance and a specific suffix. The blocks must be interconnected. The value of the parameter "identname" on the MtrDS and Msg8 block must be the same if the messages are to appear in the message window of the motor. Entry ID: , V1.1, 06/

30 2.2 FB 2002 LibBPL_Mtr The following connections are possible: Block "Msg8" with the parameter "inderr" (external error) Block "Msg8" with the parameter "inderr" (external warning) "Intlk8" block with the "indrelease" parameter (switch-on enabled) "Intlk8" block with the "indinterlock" parameter (interlock) Connection with "Msg8": The instance of the "Msg8" block must have the suffix "_ErrExt" (for connection with external error) or "_WrnExt" (for connection with external warning). If the stored messages of the "Msg8" block are to be used: The "collectsave" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the engine block. The "reset" output is connected to the "Msg8" input "cmdreset". If the actual messages of the "Msg8" block are to be used: The "collectact" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the motor block. The "Msg8" input "cmdreset" is set to "True" if the reset is to be performed automatically. Connection with "Intlk8": The "Intlk8" device must have the suffix "_RelOn" (for connection with switch-on enable) or "_LockOn" (for connection with interlock). The "result" output of "Intlk8" is routed to the "indrelease" or "indinterlock" input. Entry ID: , V1.1, 06/

31 2.3 FB 2003 LibBPL_MtrF 2.3 FB 2003 LibBPL_MtrF Block Function description Figure 2-8: LibBPL_MtrF This block is used to control an engine with variable speed (frequency converter) and analog speed feedback. The engine can be switched on and off and a speed value is also transmitted. The faceplate can also be used to define when the engine is considered to have stopped. The engine can be used in the following modes: Manual mode: The engine is operated via the HMI. Automatic mode: Engine is controlled by the CPU. Local mode: Engine is controlled directly at the engine itself. (Local operation has the highest priority) Repair operation: Input indrepair is set; no control possible and no display of errors and warnings. Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Entry ID: , V1.1, 06/

32 2.3 FB 2003 LibBPL_MtrF Input parameters Table 2-19 Parameters Data type Description identname string[30] Name of the instance runtime inspeed real Speed feedback [0 100%] indoff bool Acknowledgement "Off" indon bool Feedback "On" indtrip bool Emergency stop (0=Emergency stop) inderr bool External error indwarn bool External Warning indinterlock Bool Interlock (sets the speed to 0% or prevents acceleration) indrepair bool Feedback "Repair operation" In this operating mode, the engine is controlled externally only. There is no error monitoring and control via the block. indlocal bool Feedback "On-site operation" cmdlocspeed real Speed setpoint for local operation [0 100%] cmdaut bool External mode command When the edge is rising, the system switches to the "Automatic" operating mode. cmdautspeed real Speed setpoint for automatic operation[ %]. cmdreset bool External reset command "Reset" is performed on rising edge. timeout time Parameter monitoring time for "Timeout" and "Plausibility" messages tolerance real Parameter tolerance speed for feedback monitoring Output parameters Table 2-20 Parameters Data type Description speed real Speed value for controlling the motor[ %] collecterror bool Collective error collectwarning bool Collective warning collectmaintenance bool Collective maintenance message modeaut bool Automatic operating mode active reset bool "Reset" active interror word Fault detection of the block Entry ID: , V1.1, 06/

33 2.3 FB 2003 LibBPL_MtrF Status and Error Display Table 2-21 Status Description 16#0001 Error when reading the system time 16#0002 Error when writing the parameter string 16#0003 Error when writing the parameter string "PlcHmi" Communication between CPU and HMI Table 2-22: Values for internal log Value HMI Description 16#0101 ERR TRIP Emergency stop detected 16#0102 ERR EXTERN 16#0103 ERR TIMEOUT 16#0201 CMD RESET External error identified Timeout Error identified Reset command identified 16#0202 CMD AUT Switchover to automatic mode 16#0203 CMD MAN Switchover to manual mode 16#0204 MODE LOC ON 16#0205 MODE LOCAL OFF Local operation deactivated Local operation deactivated 16#0206 [CHECK] Test entry initiated via faceplate 16#0207 REPAIR OFF 16#0208 REPAIR ON 16#0209 INTLCK OFF 16#020A INTLCK ON Repair operation deactivated Repair shop activated Locking deactivated Interlock activated Table 2-23: Warnings and error "HMI_msg_errWrn Bit Type Description 0 Alarm EMERGENCY STOP 1 Alarm External error 2 Alarm Feedback error 4 maintenan ce Operating hours limit Entry ID: , V1.1, 06/

34 2.3 FB 2003 LibBPL_MtrF Table 2-24: Status "HMI_msg_status Bit Description 0 Engine off 1 Engine ON 2 Manual (=0), automatic (=1) operating mode 3 On-site operating mode 5 Speed reduction 6 Increase in speed 8 Stored message "Emergency stop" 9 Stored message "External error" 11 Interlock active 12 Repair operation 13 Collective message warning 14 Collective message warning 15 Collective message error 16 "Emergency stop" message 17 Message "External error" 18 Message "Timeout" 19 "External warning" message 20 Message "Operating hours limit reached" Table 2-25: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLMtrF string[170] Parameter string: Version / identname / comment / opstation / overwrite HMI_msg_errWrn word Messages (alarms, warnings) HMI_msg_status dword Status double word HMI_param_values_edi t HMI_param_values_ plchmi string[100] string[100] Parameter-Edit-String Parameter string HMI_speed real Current speed [0 100%] instfblog15_datah MI string[210] Log-Data(optional) Table 2-26: External variables for HMI Communication Name Data type Description MsgAck byte Acknowledgement messages MsgStatus word Message statuses Entry ID: , V1.1, 06/

35 2.3 FB 2003 LibBPL_MtrF Faceplate This faceplate can be used to control an engine with frequency converter. It shows the status and the warnings or errors of the engine. In addition, parameters such as operating hours counter, monitoring time and the limit for switching cycles can be adjusted. Status display Display Status ON Manual operation Manual operation OFF Error Automatic operation: Figure 2-9: MtrF All errors are saved and displayed in the lower area of the faceplate. To restart the engine, these must be reset. Motor in on-site operation OFF Motor in on-site operation ON Engine in repair mode Entry ID: , V1.1, 06/

36 2.3 FB 2003 LibBPL_MtrF Parameter view Figure 2-10: Parameter view 1 Tolerance Tolerance can be parameterized Operating hours Timeout Here the operating hours are There are two ways to set the time displayed and a limit can be set. monitoring As rule, this is set directly on the block in the PLC. In addition, this can also be set and Speed limit OFF & Use speed limit activated in the faceplate. ON The speed limit in percent for the Comment "ON" and "OFF" status can be A comment can be assigned and is parameterized here. displayed in the upper area of the faceplate. Figure 2-11: Parameter view 2 Entry ID: , V1.1, 06/

37 2.3 FB 2003 LibBPL_MtrF Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_MTRF" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-27 Property Status Param Speed MsgStatus (optional) Variable [Instance]_HMI_msg_status [Instance]_HMI_LibBPLMtrF [Instance]_HMI_speed [Instance]_MsgStatus The icons for displaying pumps have a "Direction" property which can be used to set the "Flow direction" (see screenshots) The HMI parameters "Use Speed Limit Off" and "Use Speed Limit On" must be activated and described with meaningful values to display the on/off states of the icons. The icon "@LibBPL_SYM_MTRF" is an exception: If the above parameters are not set, the current speed is displayed in color (the higher the speed, the greener the symbol becomes). The acknowledgement state is only displayed on all icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. Entry ID: , V1.1, 06/

38 2.3 FB 2003 LibBPL_MtrF SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

39 2.3 FB 2003 LibBPL_MtrF Integration of additional blocks It is possible to combine the module with other blocks and integrate their calls into the faceplate. In the faceplate, the icon appears in appropriate places By clicking on the icon the corresponding faceplate can be called up. The following conditions must be fulfilled in the SPS program: The name of the instance of the block to be linked must consist of the name of the Mtr instance and a specific suffix. The blocks must be interconnected. The value of the parameter "identname" on the MtrDS and Msg8 block must be the same if the messages are to appear in the message window of the motor. The following connections are possible: Block "Msg8" with the parameter "inderr" (external error) Block "Msg8" with the parameter "inderr" (external warning) "Intlk8" block with the "indinterlock" parameter (interlock) Connection with "Msg8": The instance of the "Msg8" block must have the suffix "_ErrExt" (for connection with external error) or "_WrnExt" (for connection with external warning). If the stored messages of the "Msg8" block are to be used: The "collectsave" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the engine block. The "reset" output is connected to the "Msg8" input "cmdreset". If the actual messages of the "Msg8" block are to be used: The "collectact" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the motor block. The "Msg8" input "cmdreset" is set to "True" if the reset is to be performed automatically. Connection with "Intlk8": The "Intlk8" block must have the suffix "_LockOn" (for connection with interlock). The "result" output of the "Intlk8" is routed to the "indinterlock" input. Entry ID: , V1.1, 06/

40 2.4 FB 2004 LibBPL_Vlv 2.4 FB 2004 LibBPL_Vlv Block Figure 2-12: LibBPL_Vlv Function description This block can be used to control valves with 2 position feedback signals (open / closed). The starting position can be declared as open or closed. Both feedback signals can be monitored. The valve can be used in the following modes: Manual mode: Valve is operated via the HMI. Automatic mode: Valve is controlled by the CPU. Local mode: Valve is checked directly on the valve itself. (Local operation has the highest priority) Repair operation: Input indrepair is set; no control possible and no display of errors and warnings. Error messages, status messages and group messages can be generated to monitor the valve. The following functions can be used for maintenance: Runtime meter Counter Change Controls Limit counter controls (monitoring with limit greater than zero) Entry ID: , V1.1, 06/

41 2.4 FB 2004 LibBPL_Vlv Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-28 Parameters Data type Description identname string[30] Name of the instance runtime indclosed bool Feedback Valve true: Valve list closed indopened bool Feedback Valve true: Valve list open indtrip bool true: OK false: Emergency OFF inderr bool true: External error false: OK indwarn bool true: External Warning fals: OK indinterlock bool Interlock: Depending on the "lockclose" input signal, the valve is closed ("lockclose" = False) or opened ("lockclose" = True) and further movement is prevented. indrepair bool Feedback "Repair operation" In this operating mode, the valve is controlled externally only. There is no error monitoring and control via the block. indlocal bool true: Feedback "On-site operation" cmdlocon bool true: Control command for local operation cmdaut bool External mode command When the edge is rising, the system switches to the "Automatic" operating mode. cmdreset bool External reset command "Reset" is performed on rising edge. timeout time Parameter monitoring time for "Timeout" and "Plausibility" messages lockclose bool Determines how the lock is to act (see "indinterlock") Entry ID: , V1.1, 06/

42 2.4 FB 2004 LibBPL_Vlv Output parameters Table 2-29 Parameters Data type Description close bool Control of the valve: Close open bool Control of the valve: Open collecterror bool Collective error collectwarning bool Collective warning collectmaintenance bool Collective maintenance message modeaut bool Automatic operating mode active reset bool "Reset" active interror word Fault detection of the block Table 2-30 Status Description 16#0001 Error when reading the system time 16#0002 Error when writing the parameter string "LibBPLVlv". 16#0003 Error when writing the parameter string "PlcHmi" Communication between CPU and HMI Table 2-31: Values for internal log Value HMI Description 0x0101 ERR TRIP Emergency stop detected 0x0102 ERR EXTERN External error identified 0x0103 ERR TIMEOUT Timeout Error identified 0x0104 ERR PLAUS Plausibility error identified 0x0201 CMD RESET Reset command identified 0x0202 CMD AUT Switchover to automatic mode 0x0203 CMD MAN Switchover to manual mode 0x0206 MODE LOC ON Local operation deactivated 0x0207 MODE LOC OFF Local operation deactivated 0x0208 CLOSE "Closing" control 0x0209 OPEN Control "Open" 0x020B [CHECK] Test entry initiated via faceplate 0x020C REPAIR OFF Repair operation deactivated 0x020D REPAIR ON Repair shop activated 0x020E INTLCK OFF Locking deactivated 0x020F INTLCK ON Interlock activated Entry ID: , V1.1, 06/

43 2.4 FB 2004 LibBPL_Vlv Table 2-32: Warnings and error messages "HMI_msg_errWrn" Bit type Description 0 alarm Emergency OFF 1 alarm External error 2 alarm Error time monitoring 3 alarm Error plausibility 4 maintenance Operating hours limit reached 5 maintenance limit switching on 6 warning External Warning Table 2-33: Status "HMI_msg_status Bit Description 0 Valve closed 1 Valve open 2 Manual (=0), automatic (=1) operating mode 3 On-site operating mode 5 Valve closing 6 Valve opening 7 Automatic command (0=closed, 1=open) 8 Stored message "Emergency stop" 9 Stored message "External error" 11 Interlock active 12 Repair operation 13 Collective message warning 14 Collective message warning 15 Collective message error 16 "Emergency stop" message 17 Message "External error" 18 Message "Timeout" 19 Message "Plausibility" 20 Message "Operating hours limit reached" 21 Message "Limit switching operations reached" 22 Operating direction for interlock Table 2-34: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLVlv string[160] Parameter String: Version / identname / comment / opstation / overwrite HMI_msg_errWrn word Messages (alarms, warnings) HMI_msg_status dword Status double word HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plcH MI string[100] Parameter string Entry ID: , V1.1, 06/

44 2.4 FB 2004 LibBPL_Vlv Name Data type Description instfblog15_datahmi string[210] Log-Data(optional) Table 2-35: External tags for HMI communicationvalues for internal log Name Data type Description MsgAck byte Acknowledgement messages MsgStatus word Message statuses Faceplate This faceplate can be used to control a digital valve. It visualizes the status of the valve. In addition, parameters such as the operating hours, feedback time and a limit for the switching changes can be set. Status display Display status open closed Error Automatic operation: Figure 2-13: Status Vlv All errors are saved and displayed in the lower area of the faceplate. To restart the valve, these must be reset. The following table shows the different statuses and errors. The errors are in thetable 2-8: Status and Error listed. On-site operation and closed On-site operation and open Repair operation Entry ID: , V1.1, 06/

45 2.4 FB 2004 LibBPL_Vlv Parameter view Comment A comment can be set and is displayed at the top of the faceplate. Timeout There are two ways to set the time monitoring As a rule, this is set directly on the block in the PLC. In addition, this can also be set and activated in the faceplate. Figure 2-14: Parameter 1 Operating hours Displays the current operating hours of the motor. In addition, a limit can be parameterised. Switch cycles Counts the operating cycles of the engine. In addition, a limit can be set for the switching cycles. Figure 2-15: Parameter 2 Entry ID: , V1.1, 06/

46 2.4 FB 2004 LibBPL_Vlv Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_VLV" must be called at the "Mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-36 Property Status Param MsgStatus (optional) Variable [Instance]_HMI_msg_status [Instance]_HMI_LibBPLVlv [Instance]_MsgStatus The acknowledgement state is only displayed on all icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. Entry ID: , V1.1, 06/

47 2.4 FB 2004 LibBPL_Vlv SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Integration of additional blocks It is possible to combine the module with other blocks and integrate their calls into the faceplate. In the faceplate, the icon appears in appropriate places By clicking on the icon the corresponding faceplate can be called up. The following conditions must be fulfilled in the SPS program: The name of the instance of the block to be linked must consist of the name of the Vlv instance and a specific suffix. The blocks must be interconnected. The value of the parameter "identname" on the Vlv and Msg8 block must be the same if the messages are to appear in the message window of the motor. The following connections are possible: Block "Msg8" with the parameter "inderr" (external error) Block "Msg8" with the parameter "inderr" (external warning) "Intlk8" block with the "indinterlock" parameter (interlock) Connection with "Msg8": The instance of the "Msg8" block must have the suffix "_ErrExt" (for connection with external error) or "_WrnExt" (for connection with external warning). If the stored messages of the "Msg8" block are to be used: The "collectsave" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the valve block. The "reset" output is connected to the "Msg8" input "cmdreset". If the actual messages of the "Msg8" block are to be used: The "collectact" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the valve block. The "Msg8" input "cmdreset" is set to "True" if the reset is to be performed automatically. Entry ID: , V1.1, 06/

48 2.4 FB 2004 LibBPL_Vlv Connection with "Intlk8": The instance of the "Intlk8" block must have the suffix "_LockOn". The "result" output of the "Intlk8" is routed to the "indinterlock" input. Entry ID: , V1.1, 06/

49 2.5 FB 2005 LibBPL_VlvA 2.5 FB 2005 LibBPL_VlvA Block Figure 2-16: LibBPL_VlvA Function description This block can be used to control an analog valve (damper) with an analog control and feedback signal. An analog control command can be set and is monitored. In addition, a monitoring time can be parameterised. The valve can be used in the following modes: Manual mode: Valve is operated via the HMI. Automatic mode: Valve is controlled by the CPU. Local mode: Valve is checked directly on the valve itself. (Local operation has the highest priority) Repair operation: Input indrepair is set; no control possible and no display of errors and warnings. Entry ID: , V1.1, 06/

50 2.5 FB 2005 LibBPL_VlvA Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-37 Parameters Data type Description identname string[30] Name of the instance runtime inposition real Position feedback [0 100%] indclosed bool Feedback Valve true: Valve list closed indopened bool Feedback Valve true: Valve is open indtrip bool true: OK false: EMERGENCY STOP inderr bool true: External error false: OK indwarn bool true: External Warning fals: OK indinterlock bool Interlock: Depending on the "lockclose" input signal, the valve is closed ("lockclose" = False) or opened ("lockclose" = True) and further movement is prevented. indrepair bool Feedback "Repair operation" In this operating mode, the valve is controlled externally only. There is no error monitoring and control via the block. indlocal bool true: Feedback "On-site operation" cmdlocposition real Setpoint for local operation[ %] cmdaut bool External mode command When the edge is rising, the system switches to the "Automatic" operating mode. cmdautposition real Setpoint for automatic operation[ %] cmdreset bool External reset command "Reset" is performed on rising edge. timeout time Parameter monitoring time for "Timeout" and "Plausibility" messages tolerance real Parameter Tolerance Control value for feedback monitoring lockclose bool Determines how the lock is to act (see "indinterlock") Entry ID: , V1.1, 06/

51 2.5 FB 2005 LibBPL_VlvA Output parameters Table 2-38 Parameters Data type Description position real Setpoint for controlling the valve [ %] collecterror bool Collective error collectwarning bool Collective warning collectmaintenance bool Collective maintenance message modeaut bool Automatic operating mode active reset bool "Reset" active interror word Fault detection of the block Communication between CPU and HMI Table 2-39 Status Description 16#0001 Error when reading the system time 16#0002 Error when writing the parameter string "LibBPLVlvA" 16#0003 Error when writing the parameter string "PlcHmi" Table 2-40: Values for internal log Value HMI Description 16#0101 ERR TRIP Emergency stop detected 16#0102 ERR EXTERN External error identified 16#0103 ERR TIMEOUT Timeout Error identified 16#0201 CMD RESET Reset command identified 16#0202 CMD AUT Switchover to automatic mode 16#0203 CMD MAN Switchover to manual mode 16#0204 MODE LOC ON Local operation deactivated 16#0205 MODE LOCAL OFF Local operation deactivated 16#0206 [CHECK] Test entry initiated via faceplate 16#0207 REPAIR OFF Repair operation deactivated 16#0208 REPAIR ON Repair shop activated 16#0209 INTLCK OFF Locking deactivated 16#020A INTLCK ON Interlock activated Table 2-41: Warnings and error "HMI_msg_errWrn Bit Type Description 0 alarm EMERGENCY STOP 1 alarm External error 2 alarm Error time monitoring 4 warning External Warning Entry ID: , V1.1, 06/

52 2.5 FB 2005 LibBPL_VlvA Table 2-42: Status "HMI_msg_status Bit Description 0 Valve closed 1 Valve open 2 Manual (=0), automatic (=1) operating mode 3 On-site operating mode 5 Valve closing 6 Valve opening 8 Stored message "Emergency stop" 9 Stored message "External error" 11 Interlock active 12 Repair operation 13 Collective message warning 14 Collective message warning 15 Collective message error 16 "Emergency stop" message 17 Message "External error" 18 Message "Timeout" 19 "External warning" message 20 Message "Operating hours limit reached" Table 2-43: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLVlvA string[170] Parameter String: Version / identname / comment / opstation / overwrite HMI_msg_errWrn word Messages (alarms, warnings) HMI_msg_status dword Status double word HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plcHMI string[100] Parameter string HMI_position real Current position [0 100%] instfblog15_datahmi string[210] Log-Data(optional) Table 2-44: Internal variables für HMI Communication Name Data type Description MsgAck byte Acknowledgement messages MsgStatus word Message statuses Faceplate This faceplate can be used to control a valve with analog control. It shows the status and the warnings or errors of the valve. In addition, parameters such as operating hours, monitoring time and a limit for operating cycles can be set. Entry ID: , V1.1, 06/

53 2.5 FB 2005 LibBPL_VlvA Status display All errors are saved and displayed in the lower section of the faceplate. To restart the valve, these must be reset. Description Status Open Closed Error Figure 2-17: Controller VlvA Valve closed in local operation Valve open in local operation Valve in automatic mode Valve in repair mode Entry ID: , V1.1, 06/

54 2.5 FB 2005 LibBPL_VlvA Parameter view Timeout There are two ways to set the time monitoring As a rule, this is set directly on the block in the PLC. In addition, this can also be set and activated in the faceplate. Tolerance Tolerance can be set here. Comment A comment can be assigned and is displayed in the upper area of the faceplate. Figure 2-18: Parameter view 1 Operating hours Displays the current operating hours of the motor. In addition, a limit can be parameterised. Limit Closed / Opened A tolerance for Open and Closed can be parameterised here. Figure 2-19: Parameter view 2 Entry ID: , V1.1, 06/

55 2.5 FB 2005 LibBPL_VlvA Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_VLVA" must be called at the "Mouse click" time. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-45 Property Status Param Speed MsgStatus (optional) Variable [Instance]_HMI_msg_status [Instance]_HMI_LibBPLVlvA [Instance]_HMI_speed [Instance]_MsgStatus The acknowledgement state is only displayed on all icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. Entry ID: , V1.1, 06/

56 2.5 FB 2005 LibBPL_VlvA SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Integration of additional blocks It is possible to combine the module with other blocks and integrate their calls into the faceplate. In the faceplate, the icon appears in appropriate places By clicking on the icon the corresponding faceplate can be called up. The following conditions must be fulfilled in the SPS program: The name of the instance of the module to be linked must consist of the name of the VlvA instance and a specific suffix. The blocks must be interconnected. The value of the parameter "identname" on the VlvA and Msg8 block must be the same if the messages are to appear in the message window of the engine. The following connections are possible: Block "Msg8" with the parameter "inderr" (external error) Block "Msg8" with the parameter "inderr" (external warning) "Intlk8" block with the "indinterlock" parameter (interlock) Connection with "Msg8": The instance of the "Msg8" block must have the suffix "_ErrExt" (for connection with external error) or "_WrnExt" (for connection with external warning). If the stored messages of the "Msg8" block are to be used: The "collectsave" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the VlvA block. The "reset" output is connected to the "Msg8" input "cmdreset". If the actual messages of the "Msg8" block are to be used: The "collectact" output of the "Msg8" is routed to the "inderr" or "indwarn" input of the VlvA block. The "Msg8" input "cmdreset" is set to "True" if the reset is to be performed automatically. Entry ID: , V1.1, 06/

57 2.5 FB 2005 LibBPL_VlvA Connection with "Intlk8": The instance of the "Intlk8" block must have the suffix "_LockOn". The "result" output of the "Intlk8" is routed to the "indinterlock" input. Entry ID: , V1.1, 06/

58 2.6 FB 2008 LibBPL_AnaRead 2.6 FB 2008 LibBPL_AnaRead Block Figure 2-20: LibBPL_AnaRead Function description The block processes an analog value and displays it graphically. The value coming from the input module is displayed in a scale. The limit ranges for warning and alarm can be parameterised. Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-46 Parameters Data type Description identname string[30] Unique name of the runtime instance. Displayed in the HMI as a technological short name. mode int Defines the type of scaling of the valueper input or the use of the valuealt: 0 = alternate value 1 = peripheral value unipolar 2 = peripheral value bipolar 3 = factor = factor 0.01 Entry ID: , V1.1, 06/

59 2.6 FB 2008 LibBPL_AnaRead Parameters Data type Description 5 = factor 1 6 = factor 10 7 = factor 100 valueper int At mode > 0: the value of the analog input is read from the periphery. rangebegin real Mode > 0: the value used for scaling the peripheral value for the start of the measuring range. rangeend real Mode > 0: the value used for scaling the peripheral value for the end of the measuring range limitah real Limit value for triggering the high alarm. limitwh real Limit value for triggering the high warning. limitwh real Limit value for triggering the low warning. limital real Limit value for triggering the low alarm. timeout time Value for the time hysteresis: Limit alarms/ warnings are reset at the earliest after this time has elapsed. hysteresis real Value for the absolute hysteresis: Limit value alarms/warnings are not reset until the measured value from the limit value plus/minus of the hysteresis is found. valuealt real If mode = 0, this value is used as measured value without scaling. Output parameters Table 2-47 Parameters Data type Description AH bool alarm high WH bool warning high WL bool warning low AL bool alarm low errorhigh bool Measured value error: Overrun errorlow bool Measured value error: Undercutting/wire fracture value real At mode > 0: the scaled measured value, otherwise qvalue corresponds to the value of valuealt. interror word Internal error Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Entry ID: , V1.1, 06/

60 2.6 FB 2008 LibBPL_AnaRead Status and Error Display Table 2-48 Status Description 16#0101 Measured value error: Overrun 16#0102 Measured value error: Undercutting/wire fracture 16#0201 Alarm High 16#0202 Warning High 16#0203 Warning Low 16#0204 Alarm Low Table 2-49: Warning and error "HMI_status Bit Type Description 0 alarm Limit max2 exceeded 1 warning Limit max1 exceeded 2 alarm Limit min2 exceeded 3 warning Limit min1 exceeded 4 alarm Measured value error (high) 5 alarm Measured value error (low) Table 2-50: External variables for HMI Communication Name Data type Description HMI_cmd word Command HMI_LibBPLMtr string[150] Parameter string: Version / identname / comment / opstation / overwrite HMI_msg_errWrn word Messages (alarms, warnings) HMI_msg_status dword Status double word HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plcHMI string[200] Parameter string Faceplate The faceplate represents the process value graphically. Parameters such as display format, unit, ranges, warning and alarm areas can be set. Entry ID: , V1.1, 06/

61 2.6 FB 2008 LibBPL_AnaRead Status display Display Description Yellow, if a warning is pending Red when there's an alarm. No alarm pending, but old alarm not yet acknowledged. Red frame flashes. Alarm is on and not acknowledged. Alarm is on but acknowledged. Warning is present. Parameter view Figure 2-21: AnaRead Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit The unit to be displayed can be set. Format The output format can be set here. The number of digits and decimal places to be displayed can be parameterised here. In addition, it can be set whether it is a value with or without sign. Figure 2-22: Parameter view 1 Entry ID: , V1.1, 06/

62 2.6 FB 2008 LibBPL_AnaRead Mode The mode can be set as follows: Alternative value Peripheral value unipolar Peripheral value bipolar Factor 0.1 Factor 0.01 Factor 1 Factor 10 Factor 100 Alternative value An alternative value can be set and selected. Figure 2-23: Parameter view 2 The first value indicates the value set in the CPU. An alternative value can be selected using the slider. Figure 2-24: Parameter view 3 Entry ID: , V1.1, 06/

63 2.6 FB 2008 LibBPL_AnaRead The warning and error areas can be set here. Figure 2-25: Parameter view 4 PLC Log The log entries are displayed here. Figure 2-26: Parameter view 5 Entry ID: , V1.1, 06/

64 2.6 FB 2008 LibBPL_AnaRead Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_ANAREAD" must be called at the "mouse click" function. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-51 Property Variable Status Param Value MsgStatus [Instance]_HMI_status [Instance]_HMI_LibBPLAnaRead [Instance]_HMI_value [Instance]_MsgStatus The acknowledgement state is only displayed on the icons by flashing if the "MsgStatus" property is supplied with the corresponding status variable. SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

65 2.7 FB 2010 LibBPL_AnaAvg 2.7 FB 2010 LibBPL_AnaAvg Block Figure 2-27: LibBPL_AnaAvg Function description The function calculates an average of up to three input values. An accepted deviation can be parameterized and error messages are generated if a value exceeds the acceptable deviation. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-52 Parameters Data type Description identname string[30] Name of the instance mode int 0 OFF 1 - value1 2- value1 and value2 3 - value1, value2 and value3 time Time Calculation cycle indval1 dint Value1 indval2 dint Value2 indval3 dint Value3 devvalue real Acceptable deviation in percent reset bool Reset Entry ID: , V1.1, 06/

66 2.7 FB 2010 LibBPL_AnaAvg Output parameters Table 2-53 Parameters Data type Description midvalact real Current average value for all parameterised inputs. midvalarch real Historical average value for all parameterised inputs. midvalarch 1 bool Historical mean value of the respective input midvalarch 2 bool Historical mean value of the respective input midvalarch 3 bool Historical mean value of the respective input status word Bit Plausibility messages of inputs interror word Fault detection of the block Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Status and Error Display Table 2-54 Status Description 16#0100 Error during writing the parameter string "LibBPLVlvA" 16#0200 Error when writing the parameter string "plchmi". Table 2-55 Bit Type Description 0 alarm Plausibility value 1 1 alarm Plausibility value 2 2 alarm Plausibility value 3 Table 2-56 Parameters Data type Description HMI_LibBPLAnaAvg string[190] Parameter string: Version / identname / comment / opstation / overwrite HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_pl chmi string[100] Parameter string HMI_midValAct real current mean value HMI_midValArch real archived mean value Entry ID: , V1.1, 06/

67 2.7 FB 2010 LibBPL_AnaAvg Faceplate The faceplate graphically displays the calculated mean value. Parameters such as output format, unit, warning and alarm ranges can be set additionally. Status display Mean value: Current: Current mean value of the parameterized combination (values 1 to 3) Historical: Average of stored values (up to 96 values) Individual: Current and historical value of each channel Figure 2-28: AnaAvg Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit A unit can be parameterised. Output format The format to be output can be set here. Area The displayed area can be adjusted here. Figure 2-29: Parameter view 1 Entry ID: , V1.1, 06/

68 2.7 FB 2010 LibBPL_AnaAvg Mode Shows the current mode which is configured in the CPU. In addition, a mode can be set manually via faceplate. - OFF - 1 Value - 2 Values - 3 Values Time Cycle for calculated mean value Deviation Deviation in percent Reset Delete all archived values Figure 2-30: Parameter view 2 Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_ANAAVG" must be called at the "Mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-57 Property Variable Status Param Value ValueArch [Instance]_HMI_status [Instance]_HMI_LibBPLAnaAvg [Instance]_HMI_midValAct [Instance]_HMI_midValArch The plausibility messages are displayed on the icons as alarms (red). The acknowledgement state is not displayed. Entry ID: , V1.1, 06/

69 2.7 FB 2010 LibBPL_AnaAvg SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

70 2.8 FB 2032 LibBPL_CntrP (impulse counter) 2.8 FB 2032 LibBPL_CntrP (impulse counter) Block Figure 2-31: LibBPL_CntrP Function description This function can be used to count up or down. This block can be used e.g. in a fast OB for counting pulses. To realize a visualization, the block LibBPL_HMI_Cntr must be used. Note This function requires the following functions: FB 2099 LibBPL_Log15 Input parameters Table 2-58 Parameters Data type Description indinc bool Counting impulse forwards inddec bool Counting impulse backwards factor real Impulse value eninput bool Enable calculation of meter reading cmdinit bool Initialization command (resets the internal residual value) cmdreset bool External reset command (sets the counter value to zero) In/out parameter Table 2-59 Parameters Data type Description datahmi version If the block is to be visualized, a connection to the block LibBPL_HMI_Cntr must be realized here. Entry ID: , V1.1, 06/

71 2.8 FB 2032 LibBPL_CntrP (impulse counter) Output parameters Table 2-60 Parameters Data type Description counterval dint Counter value interror word Fault detection Status and error display Table 2-61 Status Description 16#0004 Error reading datahmi 16#0005 Error writing datahmi Entry ID: , V1.1, 06/

72 2.9 FB 2033 LibBPL_CntrP (integrated counter) 2.9 FB 2033 LibBPL_CntrP (integrated counter) Block Figure 2-32: LibBPL_CntrA Function description The block forms a counter value by integrating an analog value. Both up and down counting (with negative analog value) is possible. To connect to the HMI, the block LibBPL_HMI_Cntr can be called. Note This function requires the following functions: FB 2099 LibBPL_Log15 Input parameters Table 2-62 Parameters Data type Description indanalogue real Analog value from which the counter value is to be derived factor real Factor for calculating the counter value difference time real Time interval for difference calculation Example for m³-meter from analogue value in m³/h: factor = 0,001, time = 3600 ms eninput bool Enable calculation of meter reading cmdinit bool Initialization command (resets the internal values) cmdreset bool External reset command (sets the counter value to zero) Entry ID: , V1.1, 06/

73 2.9 FB 2033 LibBPL_CntrP (integrated counter) In/out parameter Table 2-63 Parameters Data type Description datahmi version If the block is to be linked to the HMI, a connection to the "LibBPL_HMI_Cntr" block must be parameterized here (.prepdata). Otherwise, any variable can be switched as a dummy. Output parameters Table 2-64 Parameters Data type Description counterval dint Counter value interror word Error detection block Status and error display Table 2-65 Status Meaning 16#0001 Error when reading the system time 16#0004 Error reading datahmi 16#0005 Error writing datahmi Entry ID: , V1.1, 06/

74 2.10 FB 2034 LibBPL_CntrD (differential counter) 2.10 FB 2034 LibBPL_CntrD (differential counter) Block Figure 2-33: LibBPL_CntrD Function description The block forms a counter value by forming a difference from an input counter value. Both up and down counting (decreasing input value) is possible. To connect to the HMI, the block LibBPL_HMI_Cntr can be called. Note This function requires the following functions: FB 2099 LibBPL_Log15 Input parameters Table 2-66 Parameters Data type Description indcounter dint Input counter value from which the output counter value is to be derived factor real Factor for calculating the counter value difference limit dint If a value > 0 is parameterized here, a negative difference is evaluated as an overflow of indcounter. In this case, the calculation of the new output counter value takes limit into account as the maximum value of the input counter. eninput bool Enable calculation of meter reading cmdinit bool Initialization command (resets the internal values) cmdreset bool External reset command (sets the counter value to zero) Entry ID: , V1.1, 06/

75 2.10 FB 2034 LibBPL_CntrD (differential counter) In/Out parameters Table 2-67 Parameters Data type Description datahmi version If the block is to be linked to the HMI, a connection to the "LibBPL_HMI_Cntr" block must be parameterized here (.prepdata). Otherwise, any variable can be switched as a dummy. Output parameters Table 2-68 Parameters Data type Description counterval dint Counter value interror word Error detection block Status and error displays Table 2-69 Status 16#0004 Error reading datahmi 16#0005 Error writing datahmi Description Entry ID: , V1.1, 06/

76 2.11 FB 2014 LibBPL_HMI_Cntr 2.11 FB 2014 LibBPL_HMI_Cntr Block Figure 2-34_ LibBPL_HMI_Cntr Function description The block enables the display and parameterization of a block of type LibBPL_CntrP, LibBPL_CntrA or LibBPL_CntrD. To do this, the parameter datahmi of the corresponding block must be connected to the instance variable LibBPL_HMI_Cntr. The block automatically recognizes to which meter type it is connected and provides the corresponding views and editing options. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamWord FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table 2-70 Parameters Data type Description indentname string[30] Name of the runtime instance reset bool External reset command (sends a reset command to the upstream counter device) Output parameters Table 2-71 Parameters Data type Description counterval dint Counter value of upstream counter block eninput bool Count is enabled correction byte Identifier for last correction: Bit 0 Initialization Entry ID: , V1.1, 06/

77 2.11 FB 2014 LibBPL_HMI_Cntr Parameters Data type Description Bit 1 Reset Bit 2 Correction counter status Bit 3 - Residual value correction lastcounter dint Counter reading before last correction lastrest real Residual value before last correction interror word Fault detection of the block Static parameters Table 2-72 Parameters Data type Description predata UDT LibBPL_Data_Cntr Data from/to upstream counter block Status and error display Table 2-73 Status Description 16#0001 CntrA: Error when reading the system time 16#0002 Error when writing the parameter string "LibBPLCntr" 16#0003 Error when writing the parameter string "plchmi". 16#0004 CntrP/CntrA/CntrD: Error reading datahmi 16#0005 CntrP/CntrA/CntrD: Error writing datahmi Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-74: External variables for HMI Communication Parameters Data type Description HMI_LicDCPCntr string[170] Parameterstring: Version / identname / comment / opstation / overwrite HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plcHMI string[70] Parameter string HMI_counter dint Counter value Faceplate This faceplate can be used to display counter values of the blocks LibBPL_Cntr. Entry ID: , V1.1, 06/

78 2.11 FB 2014 LibBPL_HMI_Cntr Status display Counter value Display depends on the LibBPLCntr block connected before. Figure 2-35: LibBPL_HMI_Cntr Parameter display Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit The unit for the processed value can be parameterised here. Output format The output format and the number of decimal places can be parameterized here. You can also specify whether the value has a sign or not. Figure 2-36: Parameter display 1 Entry ID: , V1.1, 06/

79 2.11 FB 2014 LibBPL_HMI_Cntr Activate counter The counter can be activated or deactivated. Last correction Information about the last correction Previous value Information about the value before the correction. Initialization Internal variables and values are reset Reset Counter value is reset Figure 2-37: Parameter display 2 Parameterizing the counter Display for the impulse counter Figure 2-38: Parameter display 3 Entry ID: , V1.1, 06/

80 2.11 FB 2014 LibBPL_HMI_Cntr Parameterizing the counter Display for the integrating counter Figure 2-39: Parameter display 4 Parameterizing the counter Display for the differentiating counter Figure 2-40: Parameter display 5 Entry ID: , V1.1, 06/

81 2.11 FB 2014 LibBPL_HMI_Cntr Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_CNTR" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table 2-75 Property Variable Value Param [Instance]_HMI_counter [Instance]_HMI_LibBPLCntr SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

82 2.12 FB 2015 LibBPL_SetCrv 2.12 FB 2015 LibBPL_SetCrv Block Function description Figure 2-41: LibBPL_SetCrv This block can be used to create a time-dependent setpoint curve. For connection to the HMI, the block can be connected with LibBPL_HMI_SetCrv. Input parameters Table 2-76 Parameters Data type Description identname string[30] Name of the runtime instance cmd word Command word: Bit 0 Deactivate Bit 1 Activation with percentage time setpoint Bit 2 - Start via absolute time starttime (parameter) Bit 3 Interpolation (Parameter) Bit percentage time value for activation ( ) starttimer Time_of_ Start time (Bit 2 = true) Entry ID: , V1.1, 06/

83 2.12 FB 2015 LibBPL_SetCrv Parameters Day Data type Description valuedefault real Default value. This is output when the setpoint curve is not active. value1 value8 real Values for times time1 time 8 time Times 1 8 In/out parameter Table 2-77 Parameters Data type Description datahmi version If the block is to be linked with the HMI, a connection to the block LibBPL_HMI_SetCrv must be parameterized here (.datahmi). Otherwise, any variable can be switched as a dummy. Output parameters Table 2-78 Parameters Data type Description status word Status word Bit 0 active Bit 1 - last time value reached (end of curve) Bit 2 - Waiting for start time active Bit 3 Interpolation active Bit percentage time value ( ) value real Current value of the curve interror word Fault detection of the block Status and Error Display Table 2-79 Status Description 16#0001 Error reading datahmi 16#0002 Error writing datahmi 16#0003 Error reading local time Entry ID: , V1.1, 06/

84 2.13 FB 2115 LibBPL_HMI_SetCrv 2.13 FB 2115 LibBPL_HMI_SetCrv Block Figure 2-42: LibBPL_HMI_SetCrv Function description The block provides the connection to the HMI for a block LibBPL_SetCrv. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamReal FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Output parameters Table 2-80 Parameters Data type Description indentname string[30] Name of the runtime instance interror word Fault detection of the block Static parameters Table 2-81 Parameters Data type Description datahmi UDT LibBPL_UDT_SetCrv Data from/to the block LibBPL_SetCrv Status and error displays Table 2-82 Status Description 16#0100 Error when writing the parameter string "LibBPLSetCrv". 16#0200 Error when writing the parameter string "plc" 16#0300 Error when writing the parameter string "hmi" Entry ID: , V1.1, 06/

85 2.13 FB 2115 LibBPL_HMI_SetCrv Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-83: External variables for HMI Communication Parameters Data type Description HMI_LibBPLSet Crv HMI_param_val ues_edit HMI_param_val ues_plc HMI_param_val ues_hmi string[170] string[100] string[200] string[170] Parameterstring: Version / identname / comment / opstation / overwrite Parameter-Edit-String Parameter string Parameter string HMI_status word Status-Wort von LibBPL_SetCrv HMI_timeRemai n dint Current remaining time HMI_value real Current output value Faceplate This faceplate can be used to display a generated curve from the SetCurve block. In addition, parameters such as start time, activation or deactivation of start times and interpolation can be used. Status display Display Status Parameterised start time and remaining time until the next trigger. Manual on and off. Releative time and the current output value are displayed. Figure 2-43: LibBPL_SetCrv Entry ID: , V1.1, 06/

86 2.13 FB 2115 LibBPL_HMI_SetCrv Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-44: Parameter view 1 Standard value A default value can be activated via CPU or HMI. Start after absolute time The start time can be set via CPU or HMI. Interpolation Interpolation can be activated or deactivated via CPU or HMI. Allow switching by operator Operator can switch timers on or off Figure 2-45: Parameter view 2 Entry ID: , V1.1, 06/

87 2.13 FB 2115 LibBPL_HMI_SetCrv Up to 8 times can be parameterised via PLC or HMI. Figure 2-46: Parameter view 3-6 Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_SETCRV" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table 2-84 Property Variable Value Status Param [Instance]_HMI_value [Instance]_HMI_status [Instance]_HMI_LibBPLSetCrv Entry ID: , V1.1, 06/

88 2.13 FB 2115 LibBPL_HMI_SetCrv SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

89 2.14 FB 2012 LibBPL_CtrlPID 2.14 FB 2012 LibBPL_CtrlPID Block Figure 2-47: LibBPL_CtrlPID Function description It is a configurable PID controller. The important parameters of the controller can be parameterized via faceplate. The controller can be used in manual and automatic mode. Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2099 LibBPL_GetEditData Input parameters Table 2-85 Parameters Data type Description identname string[30] Name of the instance runtime input real Tag of the user program is used as the source of the process value. setpoint real Setpoint for PID controller in automatic mode disturbance real Disturbance or pilot control value manualvalue real Manual value This value is used as output value in Entry ID: , V1.1, 06/

90 2.14 FB 2012 LibBPL_CtrlPID Parameters Data type Description manual mode. KP real KP Value TN real TN Value TV real TV Value modeaut bool Automatic operation cmdack bool Acknowledge cmdreset bool Reset Output parameters Table 2-86 Parameters Data type Description output real Output value outpurpwm bool Pulse width modulated output value setpointlimit_h bool If SetpointLimit_H = TRUE, the absolute upper limit of the setpoint is reached setpointlimit_l bool If SetpointLimit_L = TRUE, the absolute lower limit of the setpoint is reached state int Displays the operating mode: State = 0: Inactive State = 1: Initial optimization State = 2: Subsequent optimization State = 3: Automatic operation State = 4: Manual mode State = 5: Replacement output value with error monitoring error bool Error detected errorbits dword Error bit displays error message Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table : Values of the "errorbits" variable Bit pattern 0x x x x x x x x No error Description The parameter input is outside the actual value limits. Error during post-optimization. The setpoint was changed during optimization. Initial optimization is not allowed during post-optimization. Error during initial optimization. The output value limits are not configured correctly. Error during post-optimization led to invalid parameters. Invalid value at parameter input: Value has no valid number Entry ID: , V1.1, 06/

91 2.14 FB 2012 LibBPL_CtrlPID Bit pattern 0x x x x x x x format. Description Calculation of the initial value failed. Sampling time error: PID_3Step is not called within the sampling time of the alarm clock OB. Invalid value at parameter setpoint: Value has no valid number format. Invalid value on the feedback parameter. Value has no valid number format. Error in digital position feedback. actuatorh = TRUE and actuatorl = TRUE. Invalid value at parameter manualvalue. Value has no valid number format. Invalid value at parameter disturbance. Value has no valid number format. Table : Values for internal log Parameters Data type Description 0x0101 ERR INP 1 (0001) The "Input" parameter is outside the process value limits 0x0102 ERR INP 2 (0002) Invalid value for "Input_PER" parameter 0x0103 ERR OPTR 1 (0004) Error during post-optimization 0x0104 ERR OPTI 1 (0008) Error starting initial optimization, actual value too close to setpoint 0x0105 ERR OPT SP (0010) The setpoint was changed during optimization 0x0106 ERR OPTI 2 (0020) Initial optimization is not allowed during post-optimization 0x0107 ERR OPTI 3 (0080) Error during initial optimization, the output limits are not configured correctly 0x0108 ERR OPTR 2 (0100) Error during post-optimization led to invalid parameters 0x0109 ERR INP 3 (0200) Invalid value at "Input" parameter 0x010A ERR OUTPUT (0400) Output value calculation failed, check PID parameters 0x010B ERR CYCLE (0800) Sampling time error 0x010C ERR SETP (1000) Invalid value at parameter setpoint 0x010D ERR MANVAL (10000) Invalid value at parameter manual value 0x010E ERR SUBST (20000) Invalid value at parameter SubstituteOutput 0x010F ERR DISTURB (40000) Invalid value at parameter Disturbance 0x0201 CMD OFF "Controller Off" command recognized 0x0202 CMD OPT INI Command "Startup initial optimization erkannt" 0x0203 CMD OPT RE "Start post-tuning detected" command 0x0204 CMD AUT "Automatic mode" command recognized Entry ID: , V1.1, 06/

92 2.14 FB 2012 LibBPL_CtrlPID Parameters Data type Description 0x0205 CMD MAN "Manual operation" command recognized 0x0206 MODE OFF Mode: Off 0x0207 MODE OPTI Mode: Initial optimization 0x0208 MODE OPTR Mode: Subsequent optimization 0x0209 MODE AUT Mode: Automatic 0x020A MODE MAN Mode: Manual mode Table 2-89: External variables for HMI Communication Value Type Description HMI_LibBPLCtrlPID string[200] Parameter string HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plc string[80] Parameter string HMI_param_values_hmi string[80] Parameter string HMI_param_values_config string[50] Parameter string HMI_status word Current operating mode of the controller: 0 - inactive 1 Initial optimization 2 Subsequent optimization 3 Automatic operation 4 Manual operation HMI_cmd word Command HMI_msg dword Error bits (see above) HMI_value_feedback real Position feedback of the valve HMI_value_input real Actual value of the controller HMI_value_setpoint real Setpoint of the controller HMI_intError word Internal error word (see above) instfblog15_datahmi string[210] Log-Data(optional) Faceplate This faceplate is used to parameterize and display a PID controller. Entry ID: , V1.1, 06/

93 2.14 FB 2012 LibBPL_CtrlPID Status display Current Current value Setpoint Setpoint Manual Value for manual operation. Output Output value for the system. Manual mode A manual output value can be set. The transition from manual mode to automatic mode can be carried out here. Manual operation is also possible if an error is present. Figure 2-48: PID controllers Automatic operation In automatic mode, the controlled system is controlled with the respective parameters. Error display Can be used to display errors. Figure 2-49: Error display Entry ID: , V1.1, 06/

94 2.14 FB 2012 LibBPL_CtrlPID Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-50: Parameter view 1 Mode PID is controlled by the CPU or HMI Initial optimization The initial optimization determines the process response to a jump in the initial value and searches for the turning point. The PID parameters are calculated from the maximum gradient and the dead time of the controlled system. Subsequent optimization The subsequent optimization generates a constant, limited oscillation of the actual value. The PID parameters are recalculated from the amplitude and frequency of this oscillation. Reset The PID Controller is reset. Figure 2-51: Parameter view 2 Entry ID: , V1.1, 06/

95 2.14 FB 2012 LibBPL_CtrlPID Range Start Lower limit for the process value. Range End Upper limit for the process value. Tuning level Accepted deviation during optimization Figure 2-52: Parameter view 3 The displayed values can be entered directly in the faceplate. The displayed values can be entered directly in the faceplate. Input value Current value Setpoint Deviation A permitted deviation can be set here. Output value The output value can be set manually here. Entry ID: , V1.1, 06/

96 2.14 FB 2012 LibBPL_CtrlPID Figure 2-53: Parameter view The parameters gain, TI and TD can be set here and loaded into the controller or read from the controller. gain P Portion TI Integral action time [s] TD derivative action time [s] Download CPU parameters to CPU 1 2 Download HMI parameters to CPU 3 Download current CPU values in HMI Figure 2-54: Parameter view 5 PLC Log The log entries are displayed here. Figure 2-55: Parameter view 6 Entry ID: , V1.1, 06/

97 2.14 FB 2012 LibBPL_CtrlPID Process image icons Various icons (designed as faceplate types) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_CTRLPID" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-90 Property Variable Status Param Value Errors [Instance]_HMI_status [Instance]_HMI_LibBPLCtrlPID [Instance]_HMI_value_setpoint [Instance]_HMI_msg SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. Entry ID: , V1.1, 06/

98 2.14 FB 2012 LibBPL_CtrlPID The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

99 2.15 FB 2013 LibBPL_CtrlStp 2.15 FB 2013 LibBPL_CtrlStp Block Figure 2-56: LibBPL_CtrlStp Function description The block implements a PID controller with self-optimization for valves or actuators with integrating behavior. The controller can be operated with or without position feedback. Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2099 LibBPL_GetEditData Entry ID: , V1.1, 06/

100 2.15 FB 2013 LibBPL_CtrlStp Input parameters Table 2-91 Parameters Data type Description identname string[30] Name of the runtime instance input real Actual value of the PID controller setpoint real PID controller setpoint disturbance real Disturbance or pilot control value manualvalue real Position setpoint of the valve in manual mode, only valid if a position feedback is used (feedbackon = TRUE) KP real P component of the PID controller TN real I component of the PID controller TV real D component of the PID controller feedback real Position feedback of the valve, is only used with feedbackon = TRUE. feedbackon bool FALSE: feedback is not used TRUE: feedback is used actuatorh bool Digital position feedback of the valve for the upper stop. If actuatorh = TRUE the position of the valve is at the upper stop and the valve is not moved further in this direction. actuatorl bool Digital position feedback of the valve for the lower stop. If actuatorl = TRUE the position of the valve is at the lower stop and the valve is not moved further in this direction. modeaut bool FALSE: Switches the controller to manual mode TRUE: Activates automatic operation of the controller cmdack bool With rising edge, the error bits are reset cmdreset bool If the edge is rising, the controller is restarted. As long as cmdreset = TRUE, the controller remains inactive cmdmanup bool Command to open the valve manually cmdmandown bool Command to close the valve manually Output parameters Table 2-92 Parameters Data type Description outputup bool Control command for opening the valve outputdown bool Control command for closing the valve setpointlimit_h bool Absolute upper limit of the setpoint has been reached setpointlimit_l bool Absolute lower limit of the setpoint has been reached Entry ID: , V1.1, 06/

101 2.15 FB 2013 LibBPL_CtrlStp Parameters Data type Description state int Current operating mode of the controller: 0 - inactive 1 Initial optimization 2 Subsequent optimization 3 Automatic operation 4 Manual operation error bool Collective error errorbits dword Error bits (see above) interror word Fault detection of the block Status and error displays Table 2-93: Error codes of the "errorbits" controller Status Description 0x x x x x x x x x x x x x x x x x No error The parameter input is outside the actual value limits. Invalid value at parameter input_per Error during post-optimization The setpoint was changed during optimization Initial optimization is not allowed during post-optimization Error during initial optimization. The output value limits are not configured correctly. Error during post-optimization led to invalid parameters. Invalid value at parameter input: Value has no valid number format. Calculation of the initial value failed. Sampling time error: PID_3Step is not called within the sampling time of the alarm clock OB. Invalid value at parameter setpoint: Value has no valid number format. Invalid value on the feedback parameter. Value has no valid number format. Invalid value at parameter Feedback_PER Error in digital position feedback. actuatorh = TRUE and actuatorl = TRUE. Invalid value at parameter manualvalue. Value has no valid number format. Invalid value at parameter disturbance. Value has no valid number format. Table 2-94: "interror Status 0x0001 0x0002 0x0004 Meaning Error when writing the parameter string "plc" Error when writing the parameter string "config". Error when writing the parameter string "hmi" Entry ID: , V1.1, 06/

102 2.15 FB 2013 LibBPL_CtrlStp Status Meaning 0x0008 Error when writing the parameter string "LibBPLCtrlStp". Table 2-95: LogData PLC HMI Description 0x0101 ERR INP 1 (0001) The "Input" parameter is outside the process value limits 0x0102 ERR INP 2 (0002) Invalid value for "Input_PER" parameter 0x0103 ERR OPTR 1 (0004) Error during post-optimization 0x0104 ERR OPTI 1 (0008) Error starting initial optimization, actual value too close to setpoint 0x0105 ERR OPT SP (0010) The setpoint was changed during optimization 0x0106 ERR OPTI 2 (0020) Initial optimization is not allowed during post-optimization 0x0107 ERR OPTI 3 (0080) Error during initial optimization, the output limits are not configured correctly 0x0108 ERR OPTR 2 (0100) Error during post-optimization led to invalid parameters 0x0109 ERR INP 3 (0200) Invalid value at "Input" parameter 0x010A ERR OUTPUT (0400) Output value calculation failed, check PID parameters 0x010B ERR CYCLE (0800) Sampling time error 0x010C ERR SETP (1000) Invalid value at parameter setpoint 0x010D ERR MANVAL (10000) Invalid value at parameter manual value 0x010E ERR SUBST (20000) Invalid value at parameter SubstituteOutput 0x010F ERR DISTURB (40000) Invalid value at parameter Disturbance 0x0201 CMD OFF "Controller Off" command recognized 0x0202 CMD OPT INI Command "Startup initial optimization erkannt" 0x0203 CMD OPT RE "Start post-tuning detected" command 0x0204 CMD AUT "Automatic mode" command recognized 0x0205 CMD MAN "Manual operation" command recognized 0x0206 MODE OFF Mode: Off 0x0207 MODE OPTI Mode: Initial optimization 0x0208 MODE OPTR Mode: Subsequent optimization 0x0209 MODE AUT Mode: Automatic 0x020A MODE MAN Mode: Manual mode Table 2-96: HMI external variables Parameters Data type Description HMI_LibBPLCtrlStp String[200] Parameter String: Version / identname / comment / opstation / overwrite HMI_param_values_edit String[100] Parameter-Edit-String Entry ID: , V1.1, 06/

103 2.15 FB 2013 LibBPL_CtrlStp Parameters Data type Description HMI_param_values_plc String[80] Parameter string HMI_param_values_hmi String[80] Parameter string HMI_param_values_config String[50] Parameter string HMI_status Word Current operating mode of the controller: 0 - inactive 1 Initial optimization 2 Subsequent optimization 3 Automatic operation 4 Manual operation HMI_cmd Word Command HMI_msg DWord Error bits (see above) HMI_value_feedback Real Position feedback of the valve HMI_value_input Real Actual value of the controller HMI_value_setpoint Real Setpoint of the controller HMI_intError Word Internal error word (see above) instfblog15_datahmi String[210] Log-Data(optional) Faceplate This faceplate can be used to control a valve or a flap with a 3 step regulator. It shows the status and pending errors. Additionally, the parameters for this slider can be adjusted in the faceplate. Entry ID: , V1.1, 06/

104 2.15 FB 2013 LibBPL_CtrlStp Status display Current: Current value Setpoint Setpoint Manual Value for manual operation. Output Output value for the system. Manual mode A manual output value can be set. The transition from manual mode to automatic mode can be carried out here. Manual operation is also possible if an error is present.. Figure 2-57: Control CtrlStep Automatic operation In automatic mode, the controlled system is controlled with the respective parameters. Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-58: Parameter view 1 Entry ID: , V1.1, 06/

105 2.15 FB 2013 LibBPL_CtrlStp Mode PID is controlled by the CPU or HMI Initial optimization The initial optimization determines the process response to a jump in the initial value and searches for the turning point. The PID parameters are calculated from the maximum gradient and the dead time of the controlled system. Subsequent optimization The subsequent optimization generates a constant, limited oscillation of the actual value. The PID parameters are recalculated from the amplitude and frequency of this oscillation. Reset The PID Controller is reset. Figure 2-59: Parameter view 2 Range Start Lower limit for the process value. Range End Upper limit for the process value. Tuning level Accepted deviation during optimization Figure 2-60: Parameter view 3 Entry ID: , V1.1, 06/

106 2.15 FB 2013 LibBPL_CtrlStp The displayed values can be entered directly in the faceplate. The displayed values can be entered directly in the faceplate. Input value Current value Setpoint Deviation A permitted deviation can be set here. Output value The output value can be set manually here. Figure 2-61: Parameter view 4 The parameters gain, TI and TD can be set here and loaded into the controller or read from the controller. Gain P Portion TI Integral action time [s] TD derivative action time [s] Download CPU parameters to CPU Download HMI parameters to CPU 3 Download current CPU values to HMI Figure 2-62: Parameter view 5 Entry ID: , V1.1, 06/

107 2.15 FB 2013 LibBPL_CtrlStp PLC Log The log entries are displayed here. Figure2-63: Parameter view 6 Process image icons The symbols of the CtrlPID block are used for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_CTRLSTP" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The icons are dynamized by linking the corresponding properties to the process variables of the instance: Table 2-97 Property Variable Status Param Value Errors [Instance]_HMI_status [Instance]_HMI_LibBPLCtrlStp [Instance]_HMI_value_setpoint [Instance]_HMI_msg Entry ID: , V1.1, 06/

108 2.16 FB 2021 LibBPL_ClctVal 2.16 FB 2021 LibBPL_ClctVal Block Figure 2-64: LibBPL_ClctVal Function description The block generates a WinCC(V7)-compliant collective display. It is possible to combine collective displays via corresponding wiring at the prevclctval input. The acknowledgement status of the message from WinCC alarm logging can be processed via the statushmi input. The wiring of the ackhmi parameter enables the forwarding of acknowledgements to WinCC. Input parameters Table 2-98 Parameters Datatyp Description collectbitpos uint Position of the message bit in the collective display (0...15). message bool Current message status. ack bool Acknowledge command (rising edge). statushmi version When wired with a DWORD or WORD variable, this is interpreted as a state variable linked with WinCC alarm logging and the acknowledgement status is derived from this. Otherwise, the block's own acknowledgement status is used. HMIBitPos uint When using the parameters statushmi and/or ackhmi, the corresponding bit position is specified here. prevclctval dword For sequential grouping of several collective displays, the "Predecessor" collective display can be switched on here. The output collectvalue is then the result of linking the current collective display with prevclctval. Entry ID: , V1.1, 06/

109 2.16 FB 2021 LibBPL_ClctVal In/out parameter Table 2-99 Parameters Datatyp Description ackhmi version When wired with a WORD or BYTE variable, this is interpreted as an acknowledgement variable linked with WinCC alarm logging. In this case, an acknowledgement via ack is set in this variable. Output parameters Table Parameters Datatyp Description collectvalue dword Collective message generated. interror word Fault detection of the block Display status and error. Table Status Description 16#0001 Invalid bit position for statushmi in HMIBitPos. 16#0002 Invalid bit position for ackhmi in HMIBitPos. 16#0003 Invalid bit position for collectvalue in collectbitpos. Entry ID: , V1.1, 06/

110 2.17 FB 2031 LibBPL_Msg FB 2031 LibBPL_Msg8 Block Figure 2-65: LibBPL_Msg8 Function description The block creates messages based on an 8-digit binary code and stores a maximum of 8 messages. Messages received can be reset via "reset". If the messages are not to be saved, "reset" can be set to "True". NOTE This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2099 LibBPL_GetEditData Entry ID: , V1.1, 06/

111 2.17 FB 2031 LibBPL_Msg8 Input parameters Table Parameters Data type Description identname string[30] Name of the instance runtime cmdreset bool Resetting the stored messages in1 bool Message 1 in2 bool Message 2 in3 bool Message 3 in4 bool Message 4 in5 bool Message 5 in6 bool Message 6 in7 bool Message 7 in8 bool Message 8 name1 string[28] Message text 1 for visualization in the faceplate name2 string[28] Message text 2 for visualization in the faceplate name3 string[28] Message text 3 for visualization in the faceplate name4 string[28] Message text 4 for visualization in the faceplate name5 string[28] Message text 5 for visualization in the faceplate name6 string[28] Message text 6 for visualization in the faceplate name7 string[28] Message text 7 for visualization in the faceplate name8 string[28] Message text 8 for visualization in the faceplate Output parameters Table Parameters Data type Description collectsave bool Collective message of the stored messages cmdreset bool Collective message of the stored messages interror Word Fault detection of the block Status and error displays Table Status Description 16#0100 Error when writing the string "LibBPLMsg8". 16#0200 Error when writing the string "plchmi". Table 2-105: Status "HMI_msg_status Bit Description 0 Saved message 1 1 Saved message 2 2 Saved message 3 3 Saved message 4 4 Saved message 5 Entry ID: , V1.1, 06/

112 2.17 FB 2031 LibBPL_Msg8 Bit Description 5 Saved message 6 6 Saved message 7 7 Saved message 8 8 Current message 1 9 Current message 2 10 Current message 3 11 Current message 4 12 Current message 5 13 Current message 6 14 Current message 7 15 Current message 8 Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-106: External variables for HMI Communication Parameters Data type Description HMI_LibBPLMsg8 string[150] Parameter string HMI_param_values_plcHMI string[250] Parameter string HMI_param_values_edit string[100] Edit string HMI_values word Bit 0 8 saved Messages Bit 9 15 Current messages Table 2-107: Internal variables for HMI Parameters Data type Description MsgAck byte Acknowledgement messages (optional) MsgStatus dword Message statuses (optional) Faceplate The faceplate displays pending messages. These can then be acknowledged and reset via faceplate. Entry ID: , V1.1, 06/

113 2.17 FB 2031 LibBPL_Msg8 Status display Parameter display Figure 2-66: Status display Msg8 Comment A comment can be assigned and is displayed in the upper area of the faceplate. Message types The message types can be displayed in yellow or red. Figure 2-67: Parameter display 1 Entry ID: , V1.1, 06/

114 2.17 FB 2031 LibBPL_Msg8 Text messages The message types can be displayed in yellow or red. Figure 2-68: Parameter display 2 Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_MSG8" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. Entry ID: , V1.1, 06/

115 2.17 FB 2031 LibBPL_Msg8 The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Status Param MsgStatus (optional) Variable [Instance]_HMI_values [Instance]_HMI_LibBPLMsg8 [Instance]_MsgStatus SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

116 2.18 FB 2023 LibBPL_Intlk FB 2023 LibBPL_Intlk8 Block Figure 2-69: LibBPL_Intlk8 Entry ID: , V1.1, 06/

117 2.18 FB 2023 LibBPL_Intlk8 Function description The block generates an output signal from up to 8 binary inputs from a programmable logic. NOTE This function requires the following functions: LibBPL_SetStreamWord LibBPL_SetStreamString LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the instance runtime in1 in8 bool Inputs logic1 integer Logical connection for in1/in2: 0 - in2 bypassed 1 - Connection in1 OR in2 2 - Connection in1 AND in2 3 - Connection in1 OR NOT in2 4 - Connection in1 AND NOT in2 logic2 integer Logical linking of the intermediate result with in3 logic3 integer Logical linking of the intermediate result with in4 logic4 integer Logical linking of the intermediate result with in5 logic5 integer Logical linking of the intermediate result with in6 logic6 integer Logical linking of the intermediate result with in7 logic7 integer Logical linking of the intermediate result with in8 text1 text8 string[20] Textual description of the signals in1... in8 for HMI display Output parameters Table Parameters Data type Description result bool Output signal interror word Fault detection of the block Log entries Table Status Description 16#0001 Error when writing the parameter string "LibBPLIntlk8". 16#0002 Error when writing the parameter string "plc" 16#0003 Error when writing the parameter string "hmi" Entry ID: , V1.1, 06/

118 2.18 FB 2023 LibBPL_Intlk8 Table 2-112: Status "HMI_status Bit Description 0 Logical signal in1 1 Logical signal in2 2 Logical signal in3 3 Logical signal in4 4 Logical signal in5 5 Logical signal in6 6 Logical signal in7 7 Logical signal in8 8 Result 1: Link in1 with in2 9 Result 2: Link result 1 with in3 10 Result 3: Link result 2 with in4 11 Result 4: Link result 3 with in5 12 Result 5: Link result 4 with in6 13 Result 6: Link result 5 with in7 14 Result 7: Link result 6 with in8 15 End result Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-113: External variables for HMI Communication Parameters Data type Description HMI_LibBPLIntlk8 String[160] Parameter string HMI_param_values_edit String[100] Parameter-Edit-String HMI_param_values_plc String[230] Parameter string HMI_param_values_hmi String[230] Parameter string HMI_status Word Status word (see above) Faceplate The faceplate represents the logic and the result. Entry ID: , V1.1, 06/

119 2.18 FB 2023 LibBPL_Intlk8 Status display Parameter display Figure 2-70: Status display Intlk8 Comment A comment can be assigned and is displayed in the upper area of the faceplate. Texts Below this, you can enter texts for inputs 1 to 8. The following applies here: If a text is empty, the text parameterised in the PLC is displayed in the status view. Changes of texts 1 to 8 are only displayed in the status view after closing and reopening the faceplate. Figure 2-71: Parameter display 1 Entry ID: , V1.1, 06/

120 2.18 FB 2023 LibBPL_Intlk8 Input signals The switches on this page can be used to overwrite the input signals in1 to in8 for test purposes. The switches on the lefthand side are used to determine whether the corresponding input is to be overwritten. The positions of the switches on the right side define the logical signal for overwriting. Figure 2-72: Parameter display 2 Entry ID: , V1.1, 06/

121 2.18 FB 2023 LibBPL_Intlk8 The parameters on this page are used to define the logic circuits. The logics parameterised in the PLC are displayed on the left. The switches can be used to set or reset their overwriting. The contents of the overwrites are defined on the right-hand side. Figure 2-73: Parameter display 3 On this page you can change the color of the result and the signal flow in the main window of the faceplate. The representation set for the result is also adopted by the symbol (see below). Figure 2-74: Parameter display 4 Entry ID: , V1.1, 06/

122 2.18 FB 2023 LibBPL_Intlk8 Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_INTLK8" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Status Param [Instance]_HMI_status [Instance]_HMI_LibBPLIntlk8 SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

123 2.19 FB 2020 LibBPL_Aggr FB 2020 LibBPL_Aggr8 Block Figure 2-75: LibBPL_Aggr8 Function description The block manages the automatic on/off and switching of up to eight units. The following modes are possible: Sequential switching according to priority: Switching on: The released aggregate with the highest priority Switching off: The unit in operation with the lowest priority Priority-controlled control is active as soon as different priorities are parameterised. Changeover taking into account the operating hours: Switching on: The released aggregate with the shortest total runtime Switching off: The unit in operation with the longest total running time This operating mode is active if the input parswitchbytime is TRUE. Changeover taking into account the cycle times: Switching on: The released unit with the shortest last cycle time Switching off: The unit in operation with the longest current cycle time This operating mode is active if the input parswitchbytime is FALSE. Automatic switching after reaching a time limit: Switching off: After reaching the cycle time defined by limitsecs Automatic switching is active if the limitsecs parameter is not zero. Entry ID: , V1.1, 06/

124 2.19 FB 2020 LibBPL_Aggr8 The request input is used to set how many units (0...8) are to be in operation. With rising edge at the switchcmd input, the block switches over one unit at a time, if possible. The feedback signals from the aggregates and their control by the module are compared. If these are not identical within the time set by delaytime, the corresponding aggregate is blocked. RestTime can be used to set a rest period. This has the effect that after they have been switched off, aggregates are blocked for the parameterised rest period until they can be switched on again. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname String[30] Name of the runtime instance switchcmd Bool Triggers a change-over with rising edge. parswitchbytimes Bool FALSE: Switching on/off takes into account the running times of the last/current cycle TRUE: Switching on/off takes the total running times into account request UInt Number of aggregates requested (0...8) indaggr1 indaggr8 Byte Defines the current states of the aggregates and their priority Bit 0 Aggregate ready for operation Bit 1 Aggregate on Bit 4 7 Priority (0 8) delaytime Time Monitoring time limitsecs DInt Time limit for automatic switchover [s] resttime Time Rest time after switch-off reset Bool Resetting the aggregate errors and the current rest periods Entry ID: , V1.1, 06/

125 2.19 FB 2020 LibBPL_Aggr8 Output parameters Table Parameters Data type Description on Byte Control commands of the units (bit 0...7) errnoswitch Bool TRUE: no switching possible erraggr Byte Error bits of the units 1..8 (bits 0...7) switchenable Bool TRUE: Switching allowed switchactive Bool TRUE: Enabling/disabling is active interror Word Fault detection of the block Status and error display Table Status 0x0001 0x0002 0x0004 Description Error when reading the system time Error when writing the parameter string "LibBPLAggr8". Error when writing the parameter string "plc" Table 2-118: Status "HMI_msg Bit Type Description 0 alarm Time monitoring unit 1 1 alarm Time monitoring unit 2 2 alarm Time monitoring unit 3 3 alarm Time monitoring unit 4 4 alarm Time monitoring unit 5 5 alarm Time monitoring unit 6 6 alarm Time monitoring unit 7 7 alarm Time monitoring unit 8 8 warning Switching not possible 9 status Switching active 10 status Switching possible Table 2-119: Status "HMI_status Bit Type Description 0 status Control unit 1 1 status Control unit 2 2 status Control unit 3 3 status Control unit 4 4 status Control unit 5 5 status Control unit 6 6 status Control unit 7 Entry ID: , V1.1, 06/

126 2.19 FB 2020 LibBPL_Aggr8 Bit Type Description 7 status Control unit 8 8 status Standby unit 1 9 status Standby unit 2 10 status Standby unit 3 11 status Standby unit 4 12 status Standby unit 5 13 status Standby unit 6 14 status Standby unit 7 15 status Standby unit 8 Table 2-120: External tags for HMI communication Parameters Data type Description HMI_LibBPLAggr8 String[230] Parameter string HMI_param_values_edit String[100] Parameter-Edit-String HMI_param_values_plc String[250] Parameter string HMI_msg Word Messages: Bit 0 7 error unit 1 8 Bit 8 Warning: no switching possible Bit 9 Switching active Bit 10 Switching allowed HMI_request UInt Number of aggregates currently requested HMI_status Word Status word Bit Unit Off (FALSE)/ON (TRUE) Bit Unit ready (TRUE) Entry ID: , V1.1, 06/

127 2.19 FB 2020 LibBPL_Aggr8 Faceplate Number of units requested The number of units requested is specified here. Overview of switched on units Ready Unit ready for operation Error - An error is pending ON Unit is ON Figure 2-76: Control 1 LibBPL_Aggr8 Number of units requested Set with CPU or HMI Switch control Here you can parameterize whether or not the value is accepted by the CPU or the HMI. In addition, you can also select whether time control is activated. Operating hours The operating hours of the units are displayed here. Next unit to be switched Here it is indicated, which unit is switched next. Figure 2-77: Control 2 LibBPL_Aggr8 Entry ID: , V1.1, 06/

128 2.19 FB 2020 LibBPL_Aggr8 Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Idle time Here the minimum rest time after switching off can be parameterized Limit Time Time for automatic switching. Figure 2-78: Parameter view 1 Priority A priority can be parameterised for each unit. Figure 2-79: Parameter view 2 Entry ID: , V1.1, 06/

129 2.19 FB 2020 LibBPL_Aggr8 Operating hours The operating hours for each unit can be edited. Figure 2-80: Parameter view 3 Process image icons Various icons (designed as faceplate type) are available for visualization. The icons contain internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_AGGR8" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Value Param Msg MsgStatus (optional) Variable [Instance]_HMI_request [Instance]_HMI_LibBPLAggr8 [Instance]_HMI_msg [Instance]_MsgStatus Entry ID: , V1.1, 06/

130 2.19 FB 2020 LibBPL_Aggr8 SiVArc-Parameter (WinCC Prof.) The icons are already supplied with SiVArc parameters, so that an automated instantiation (connection with the HMI variables of the instance) is possible. This does not apply to any internal variables that may be required (reporting system). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

131 2.20 FB 2018 LibBPL_OpAna 2.20 FB 2018 LibBPL_OpAna Block Figure 2-81: LibBPL_OpAna Function description This function can be used for switching analog values. This value can be monitored via defined limits. A value is only switched through if it is between the defined limits. Instead of a specified value, a process value can also be switched and monitored. If the parameterized value violates the ranges, warnings and errors are generated. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the instance runtime indvalue real Input value (value to be overwritten) limitmin real Lower input limit limitmax real Upper input limit Output parameters Table Parameters Data type Description value real Output value interror word Fault detection of the block Entry ID: , V1.1, 06/

132 2.20 FB 2018 LibBPL_OpAna Status and error messages Table Status Meaning 16#0100 Error when writing the parameter string "LibBPLOpAna" 16#0200 Error when writing the parameter string "plchmi". Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-125: External variables for HMI Communication Parameters Data type Description HMI_LibBPLOpAna string[210] Parameter string: Version / identname / comment / opstation / overwrite HMI_param_values_e dit HMI_param_values_p lchmi string[100] string[250] Parameter-Edit-String Parameter string HMI_value real Output value Faceplate This faceplate can be used to display and parameterize analog values and to monitor their limits. Status overview The current analog value is displayed. In addition, a value can be entered manually and switched to this value. Figure 2-82: Controle OpAna Entry ID: , V1.1, 06/

133 2.20 FB 2018 LibBPL_OpAna Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Labeling A label can be set which is displayed on the main page. Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-83: Parameter view 1 Input area An input area can be defined by CPU or HMI. Tracking of the analog value during switchover Smooth switching can be activated Figure 2-84: Parameter view 2 Entry ID: , V1.1, 06/

134 2.20 FB 2018 LibBPL_OpAna Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_OPANA" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Value Param [Instance]_HMI_value [Instance]_HMI_LibBPLOpAna SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

135 2.21 FB 2019 LibBPL_OpDig 2.21 FB 2019 LibBPL_OpDig Block Figure 2-85: LibBPL_OpDig Function description The block allows the switching of a digital signal. Three operating modes are possible: - Static: The module works like an on/off switch - Rising impulse: The block operates like a closing pushbutton, i.e. a pulse is output when actuated, otherwise the output is FALSE. - Falling impulse: The block operates like an opening pushbutton, i.e. one cycle is output FALSE otherwise the output is on TRUE. - Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the instance runtime indon bool Input value (value to be operated) Output parameters Table Parameters Data type Description on real Output value (value served) interror word Fault detection of the block Entry ID: , V1.1, 06/

136 2.21 FB 2019 LibBPL_OpDig Status and error messages Table Status Description 16#0100 Error when writing the parameter string "LibBPLOpDig" Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-130: External variables for HMI Communication Parameters Data type Description HMI_LibBPLOpDig string[190] Parameter string: Version / identname / comment / opstation / overwrite HMI_param_values_edit string[100] Parameter-Edit-String HMI_status word Status word Entry ID: , V1.1, 06/

137 2.21 FB 2019 LibBPL_OpDig Faceplate 1 Switching automatically per CPU or manually per HMI 2 If (1) is set to HMI, the switch can be set or reset here. 1 2 Parameter view Figure 2-86: Controle OpDig Comment A comment can be assigned and is displayed in the upper area of the faceplate. Labeling A label can be set which is displayed on the main page. Input type: Static: Works like an ON/OFF switch Rising flank Function works like a closing pushbutton. When actuated, the output is an impulse. Falling flank Works like an opening push button. When actuated, a cycle FALSE is output. Figure 2-87: Parameter view 1 Entry ID: , V1.1, 06/

138 2.21 FB 2019 LibBPL_OpDig Process image icons An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_OPDIG" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Status Param [Instance]_HMI_status [Instance]_HMI_LibBPLOpDig SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

139 2.22 FB 2017 LibBPL_TimeSw 2.22 FB 2017 LibBPL_TimeSw Block Figure 2-88: LibBPL_TimeSwW Function description The block realizes a time switch for different parameterizable cycles. For connection to the HMI, the block can be connected with LibBPL_HMI_TimeSw. Input parameters Table Parameters Data type Description typecycle char Type of time switching point: "1" "7" Sunday Saturday (weekly) "D" Daily "H" Hourly "M" - Minutily timeon time_of_day Switching time (for type "H", the configured hour is not taken into account; for type "M", the hour and minute are not taken into account) duration time switching time indexhmi int The block for communication with the HMI can be connected with up to 8 LibBPL_TimeSw blocks. The index must be specified here. Entry ID: , V1.1, 06/

140 2.22 FB 2017 LibBPL_TimeSw In/out parameter Table Parameters Data type Description datahmi bool If the block is to be linked with the HMI, a connection to the block LibBPL_HMI_TimeSw must be parameterized here (.datahmi). Otherwise, any variable can be switched as a dummy. Output parameters Table Parameters Data type Description on bool Current switching status interror word Fault detection of the block Status and error messages Table Status Description 16#0001 Error reading datahmi 16#0002 Error writing datahmi 16#0003 Error reading local time 16#0004 Invalid parameterization for type Entry ID: , V1.1, 06/

141 2.23 FB 2117 LibBPL_HMI_TimeSw 2.23 FB 2117 LibBPL_HMI_TimeSw Block Figure 2-89: LibBPL_HMI_Time_Sw Operating principle The block enables the display and parameterization of up to eight blocks of type LibBPL_TimeSw. To do this, the parameter datahmi of the corresponding block must be linked to the instance variable datahmi of LibBPL_HMI_TimeSw. The block automatically recognizes how many blocks it is linked to and displays only the corresponding information/parameters. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the runtime instance Output parameters Table Parameters Data type Description interror word Fault detection of the block Static parameters Table datahmi Parameters Data type Description UDT LibBPL_UDT_TimeSw Data from/to the blocks LibBPL_TimeSW Entry ID: , V1.1, 06/

142 2.23 FB 2117 LibBPL_HMI_TimeSw Status and error display Table Status Description 16#0100 Error when writing the parameter string "LibBPLTimeSw". 16#0200 Error when writing the parameter string "plc" 16#0300 Error when writing the parameter string "hmi" Communication between CPU and HMI Hexadecimal values and variables are defined for communication between the controller and the HMI. Table 2-140: External tags for HMI communication Parameters Data type Description HMI_LibBPLTimeSw string[190] Parameter string: Version / identname / comment / opstation / overwrite HMI_param_values_edit string[100] Parameter-Edit-String HMI_param_values_plc string[190] Parameter string HMI_param_values_hmi string[190] Parameter string HMI_status word Status word Bit current switching states Bit 8 15 Internal conditions Faceplate The faceplate can be used to parameterize the timers. Timer overview In this area the individual timers are displayed. Figure 2-90: Controle HMI_TimeSw Entry ID: , V1.1, 06/

143 2.23 FB 2117 LibBPL_HMI_TimeSw Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Time - Deactivate overwrite - Activate overwrite Overwrite - Overwrite ON - Overwrite OFF Output by CPU Output by HMI: OFF Figure 2-91: Parameter view 1 Output through HMI: EN Timer 1-8 Each timer can be parameterised in this range. Figure 2-92: Parameter view 2-5 Entry ID: , V1.1, 06/

144 2.23 FB 2117 LibBPL_HMI_TimeSw Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_OPDIG" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Status Param [Instance]_HMI_status [Instance]_HMI_LibBPLTimeSw SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

145 2.24 FB 2016 LibBPL_Select 2.24 FB 2016 LibBPL_Select Block Figure 2-93: LibBPL_Select Function description The block reads in two values and outputs one of them according to the following possible selection criteria: - mode = "SEL": The value is determined by input select (select=false: valuesel = value0, select = TRUE: valuesel = value1). - mode = "MIN": The smaller value is output. - mode = "MAX": The larger value is output. The output result indicates which value is selected (result = FALSE: value0, result =TRUE: value1). Realizable functionalities are described in Tabelle Input parameters Table Parameters Data type Description mode string[3] Function: "SEL", "MIN" or "MAX" select bool Only with mode="sel": FALSE - selection value0 TRUE - selection value1 value0 version First input value. The data types Bool, Byte, Int, DInt, Word, DWord, Real and LReal are possible. value1 version Second input value. The data types Bool, Byte, Int, DInt, Word, DWord, Real and LReal are possible. valuesel version Selected value. The data types Bool, Byte, Int, DInt, Word, DWord, Real and LReal are possible. The data type of this parameter determines the data format with which the inputs are processed Entry ID: , V1.1, 06/

146 2.24 FB 2016 LibBPL_Select Parameters Data type Description internally. In/out parameter Table Parameters Data type Description datahmi version If the block is to be linked with the HMI, a connection to the block LibBPL_HMI_Select must be parameterized here (.datahmi). Otherwise, any variable can be switched as a dummy. Output Parameters Table Parameters Data type Description result bool Result: FALSE value0 is selected TRUE value1 is selected interror word Fault detection of the block Status and error messages Table Status Description 16#0001 Invalid data format of value0. 16#0002 Invalid data format of value1. 16#0003 Invalid data format of valuesel 16#0004 Invalid value for mode. Modes Tabelle 2-146: Modes Function Mode Description Selection by switch SEL The value is determined by input select (select=false: valuesel = value0, select = TRUE: valuesel = value1). Determination of the smaller value Determination of the smaller value Monitoring to lower limit Monitoring to higher limit MIN MAX MIN MAX The smaller value is output The greater value is output value0: Limit value value1: Value to be monitored result: TRUE limit value undershot value0: Limit value value1: Value to be monitored result: TRUE limit exceeded Entry ID: , V1.1, 06/

147 2.25 FB 2116 LibBPL_HMI_Select 2.25 FB 2116 LibBPL_HMI_Select Figure 2-94: HMI_Select The block establishes the connection to the HMI for a block LibBPL_Select. Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the runtime instance Output parameters Table Parameters Data type Description interror bool Fault detection of the block Table 2-149: Error "IntError Value Description 16#0100 Error when writing the parameter string "LibBPLSelect". 16#0200 Error when writing the parameter string "plc" Communication between CPU and HMI Table 2-150: External variables for HMI Communication Parameters Data type Description HMI_LibBPLSelect string[200] Parameter string: Version / identname / comment / opstation / overwrite HMI_param_values_edit string[100] Parameter-Edit-String Entry ID: , V1.1, 06/

148 2.25 FB 2116 LibBPL_HMI_Select Parameters Data type Description HMI_param_values_plc string[50] Parameter string HMI_value lreal Selected value. Faceplate With this faceplate it is possible to display values and to parameterize the function LibBPL_Select. Entry ID: , V1.1, 06/

149 2.25 FB 2116 LibBPL_HMI_Select Status View The mode used is displayed in the upper area. The unit and the value output are displayed in the lower area. Parameter view Figure 2-95: Controle Select Comment A comment can be assigned and is displayed in the upper area of the faceplate. Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-96: Parameter view 1 Entry ID: , V1.1, 06/

150 2.25 FB 2116 LibBPL_HMI_Select Result: 1 Selection whether value is used by the CPU or the HMI HMI value is set to true or false Selected value Value is written automatically by CPU or manually by HMI Figure 2-97: Parameter view 2 Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_SELECT" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Value Param Property [Instance]_HMI_value Variable [Instance]_HMI_LibBPLSelect Entry ID: , V1.1, 06/

151 2.25 FB 2116 LibBPL_HMI_Select SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

152 2.26 FB 2011 LibBPL_Polygon 2.26 FB 2011 LibBPL_Polygon Block Figure 2-98: LibBPL_Polygon Entry ID: , V1.1, 06/

153 2.26 FB 2011 LibBPL_Polygon Function description A linear function is created based on 8 coordinates. Depending on the input value, the corresponding output value is output at the output of the block. Figure 2-99: Polygon principle Note This function requires the following functions: FB 2099 LibBPL_Log15 FC 2081 LibBPL_SetStreamString FC 2083 LibBPL_SetStreamReal FC 2099 LibBPL_GetEditData Input parameters Table Parameters Data type Description identname string[30] Name of the instance runtime U real Input value (value to be converted) U1 real Support point for input value 1 U2 real Support point for input value 2 U3 real Support point for input value 3 U4 real Support point for input value 4 U5 real Support point for input value 5 U6 real Support point for input value 6 U7 real Support point for input value 7 U8 real Support point for input value 8 V1 real Support point for input value 1 V2 real Support point for output value 2 V3 real Support point for output value 3 V4 real Support point for output value 4 V5 real Support point for output value 5 V6 real Support point for output value 6 Entry ID: , V1.1, 06/

154 2.26 FB 2011 LibBPL_Polygon Parameters Data type Description V7 real Support point for output value 7 V8 real Support point for output value 8 Output parameters Table Parameters Data type Description V real Output value Communication between PLC and HMI Table 2-154: External HMI variables Parameters Data type Description HMI_LibBPLPolygon string[200] Parameter string: Version / identname / comment / opstation / overwrite HMI_status word Status word HMI_valueIn real Input value HMI_valueOut real Output value HMI_param_plc string[170] Parameter string HMI_param_hmi string[170] Parameter string HMI_param_edit string[100] Parameter-Edit-String Entry ID: , V1.1, 06/

155 2.26 FB 2011 LibBPL_Polygon Faceplate The faceplate represents the parameterized curve. The interpolation points for creating the linear curve can be parameterized and modified. Status View The cross in the coordinate system marks the current point, which is formed from the input value and the corresponding output value. In addition, the input and output values are displayed decimally in the lower area. Figure 2-100: Polygon Entry ID: , V1.1, 06/

156 2.26 FB 2011 LibBPL_Polygon Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Input/output The current values can be overwritten manually. Figure 2-101: Parameter view 1 Unit A unit can be parameterised. Output format The format to be output can be set here. Figure 2-102: Parameter view 2 Entry ID: , V1.1, 06/

157 2.26 FB 2011 LibBPL_Polygon The support points can be adjusted on pages 4 to 7. Figure 2-103: Coordinates Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_POLYGON" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Value Param [Instance]_HMI_valueOut [Instance]_HMI_LibBPLPolygon Entry ID: , V1.1, 06/

158 2.26 FB 2011 LibBPL_Polygon SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

159 2.27 FB 2022 LibBPL_PU FB 2022 LibBPL_PU1 Block Figure 2-104: LibBPL_PU1 Operating principle The block allows the combination and operation of a technological unit (package unit) consisting of: - a digital "On" feedback - an analog feedback (e.g %) - 8 status bits, 8 short texts (parameterized for HMI) - 8 alarm, warning bits, 8 short texts (parameterised to HMI) - 8 analog display values, 8 short texts, 8 texts for the physical unit (each parameterized to HMI) Note This function requires the following functions: FC 2081 LibBPL_SetStreamString FC 2082 LibBPL_SetStreamReal FC 2084 LibBPL_SetStreamDWord FC 2099 LibBPL_GetEditData Entry ID: , V1.1, 06/

160 2.27 FB 2022 LibBPL_PU1 Input parameters Table Parameters Data type Description identname string[30] Name of the runtime instance indvalue Real Analog feedback ( %) indon Bool Digital acknowledgement "On". indstatusflags Byte Status bits statusmask Byte Bit mask for determining which status bits are to be displayed in the faceplate. indmsgflags Byte Alarm/Warning bits msgmask Byte Bit mask for determining which message bits are to be displayed in the faceplate. msgtypes Byte Bit mask for defining the message types of the message bits: FALSE Alarm TRUE - Warnung cmdaut Bool External automatic command (automatic mode); (Rising flank) cmdautvalue Real Analog automatic setpoint cmdreset Bool External reset command If this input is statically parameterised with TRUE, the stored message states correspond to the current message states. valueext1 valueext8 Variant Analog/Boolean display values All values parameterized here with the data types Bool, Int, DInt or Real are displayed in the faceplate. Output parameters Table Parameters Data type Description value Real Analogue control value on Bool Digital control command (or "On" status) collecterror Bool Group alarm collectwarning Bool Group warning modeaut Bool Status operating mode: FALSE Manual mode TRUE - Automatic mode interror Word Fault detection of the block Entry ID: , V1.1, 06/

161 2.27 FB 2022 LibBPL_PU1 Status and error messages Table Status 0x0001 0x0002 0x0004 0x0008 0x0010 Meaning Error when writing the parameter string "LibBPLPU1". Error when writing parameter string "hmi1" Error when writing parameter string "hmi2" Error when writing the parameter string "hmi3". Error converting external variables Communication between CPU and HMI Table 2-159: External HMI variables Parameters Data type Description HMI_LibBPLPU1 String[220] Parameter string HMI_param_values_edit String[100] Parameter-Edit-String HMI_param_values_hmi1 String[250] Parameter string HMI_param_values_hmi2 String[190] Parameter string HMI_param_values_hmi3 String[190] Parameter string HMI_status Word Bit 0 Unit off (FALSE)/on (TRUE) Bit 1 Unit Manual (FALSE)/Automatic (TRUE) HMI_value Real current actuating value (0 100 %) HMI_msg_errWrn Word Bit 0 7 stored alarms/warnings Bits current alarms/warnings HMI_msg_status Word Bit 0 7 Status messages Table 2-160: Internal HMI tags Parameters Data type Description MsgStatus DWord Status tag AlarmLogging (optional) MsgAck word Acknowledge variable alarm logging (optional) Faceplate The faceplate can be used to control and display relevant parameters and errors / warnings. Entry ID: , V1.1, 06/

162 2.27 FB 2022 LibBPL_PU1 Status View The package unit can be controlled in this area. 2 The current status of the PU is displayed here. The displayed image can be exchanged in WinCC. To change the image, the in the folder GraCS folder of the WinCC Project. LibBPL_Test1\GraCS\@LibBPL_FP_P U1.png must be changed. 3 Parameterized messages and status are displayed here 4 Go to page 2 4 Figure 2-105: Package Unit Page 1 Up to 8 values can be parameterized and displayed in this range. Figure 2-106: PUnit page 2 Entry ID: , V1.1, 06/

163 2.27 FB 2022 LibBPL_PU1 Parameter view Comment A comment can be assigned and is displayed in the upper area of the faceplate. Ignore error Errors are ignored and do not cause the PU to shut down. Figure 2-107: Parameter view 1 The texts of the errors and warnings can be defined here Figure 2-108: Parameter view 2 Entry ID: , V1.1, 06/

164 2.27 FB 2022 LibBPL_PU1 The texts of the status messages can be defined here Figure 2-109: Parameter view 3 The displayed values can be parameterised on pages 4 to 11. Figure 2-110: Parameter view 4 Entry ID: , V1.1, 06/

165 2.27 FB 2022 LibBPL_PU1 Process image icon An icon (executed as faceplate type) is available for visualization. The icon contains internal VB scripts for displaying the current status. The corresponding faceplate can be opened with a mouse click. To do this, the following conditions must be met: The object must have the name of the instance and the VB function "LibBPL_OpenFaceplateHome2" with the parameter "@LibBPL_FP_POLYGON" must be called at the "mouse click" event. Alternatively, the "LibBPL_OpenFaceplateHome" function can be called. It also allows the transfer of the parameter for the instance. The symbol is dynamized by linking the corresponding properties to the process variables of the instance: Table Property Variable Value Param Status [Instance]_HMI_value [Instance]_HMI_LibBPLPU1 [Instance]_HMI_status SiVArc-Parameter (WinCC Prof.) The icon is already supplied with SiVArc parameters, to enable an automated instantiation (connection with the HMI variables of the instance). The call of the VB function LibBPL_OpenFaceplateHome2 with the name of the faceplate to be called is parameterized as SiVArc event for the mouse click. Entry ID: , V1.1, 06/

166 2.28 Internal functions 2.28 Internal functions The main blocks of the library require additional internal functions, which are described in this chapter. These must be added to the TIA portal FC 2099 LibBPL_GetEditData Function description This function extracts parameters that are transferred from the HMI to the controller. Input parameters Table Parameters Data type Description editindex editvalue paramindex char string char In/out parameter Table Parameters Data type Description paramvalue version FC 2084 LibBPL_SetStreamDWord Function description The function encodes DWord values from the CPU to the HMI. Input parameters Table Parameters Data type Description value dword In/out parameter Table Parameters Data type Description stream string Entry ID: , V1.1, 06/

167 2.28 Internal functions FC 2082 LibBPL_SetStreamReal Function description The function encodes real values from the CPU to the HMI. Input parameters Table Parameters Data type Description value real In/out parameter Table Parameters Data type Description stream string FC 2081 LibBPL_SetStreamString Function description This function encodes string values from the CPU to the HMI. Input parameters Table Parameters Data type Description value string In/out parameter Table Parameters Data type Description stream string Entry ID: , V1.1, 06/

168 2.28 Internal functions FC 2083 LibBPL_SetStreamWord Function description This function encodes Word values from the CPU to the HMI. Input parameters Table Parameters Data type Description value word In/Out parameters Table Parameters Data type Description stream string FB 2099 LibBPL_Log15 Function description This function writes and reads up to 15 logs. This function is integrated in many modules for the traceability of events. Input parameters Table Parameters Data type Description codewrite word code to log Communication between PLC and HMI Table Parameters Data type Description datahmi string[210] Entry ID: , V1.1, 06/

169 3 Working with the library 3.1 Integrating the library in STEP 7 3 Working with the library This chapter describes how to customize the Basic Process Library. There are two ways to use this library: 1. Use the sample project and copy & paste the objects. 2. Create a new project and copy and paste the required objects. 3.1 Integrating the library in STEP 7 The steps for using the library in STEP 7 TIA and WinCC are listed below. Note The presence of a STEP 7 project is assumed in the following New object created Table 3-1 No. Action Note 1. Start WinCC and open the supplied project. 2. The demo project appears. In this example, a new engine is to be created. Entry ID: , V1.1, 06/

170 3 Working with the library 3.1 Integrating the library in STEP 7 No. Action Note 3. In WinCC select the item Graphics Designer and search for the entry "Demo1.pdl" in the right window and select it by double-clicking. The Graphics Designer opens. 4. Right-click on the object to be copied. Select duplicate in the appearing context menu. 5. Drag the copied object to the desired position. Entry ID: , V1.1, 06/

171 3 Working with the library 3.1 Integrating the library in STEP 7 No. Action Note 6. TIA portal open. Drag & drop the desired function into the project. In the example the block FB2003 LibBPL_MtrF is required. 7. In the call functions, select whether the function is to be called as a single or multi instance. 8. Assign a name at the identname input. Each name may only be assigned once in the entire project. 9. Load project into the controller. Entry ID: , V1.1, 06/

172 3 Working with the library 3.1 Integrating the library in STEP 7 No. Action Note 10. Connect online with the controller and verify that the offline and online project is identical. 11. Open variable management. Entry ID: , V1.1, 06/

173 3 Working with the library 3.1 Integrating the library in STEP 7 No. Action Note 12. Right-click on the CPU and select "Load from file" via "AS Symbols". 13. Search for the added object with the assigned instance name and activate it using the checkboxes. 14. Now right-click on "Properties" in the Graphics Designer. 15. The "Object properties" are now visible in the lower area. Now select the "Status" area. 16. Now right-click on the "Tag..." option to set the corresponding variable for each attribute. Entry ID: , V1.1, 06/

174 3 Working with the library 3.1 Integrating the library in STEP 7 No. Action Note 17. The variables of the configured CPU are displayed in the window that opens. Select the corresponding variable here. Repeat this step with all attributes to be linked. Save and close the window. 18. Back in Graphics Designer, open the "Object Properties" of the added object. Now adjust the object name of the added object so that it corresponds to the instance name of the building block created in the TIA Portal project. The prefix of the object must correspond to the name of the instance of the called DB: prefix: Demo_1_1_ (DB of FB_Demo_1) suffix: LibBPL_MtrF_Manual (Name of the instance) 19. Now the faceplate of the added object can be opened. Entry ID: , V1.1, 06/

175 3 Working with the library 3.1 Integrating the library in STEP Error messages Overview A distinction must be made between messages that can be acknowledged and messages that cannot be acknowledged. Alarms, warnings and repair messages should be created as acknowledgeable messages. Status messages need not be acknowledgeable. Each message requires a status variable. Messages that are to be displayed in the faceplate require a status variable. Messages that can be acknowledged in the faceplate also require an acknowledgement variable. Creating state variables If the status of the message is to be displayed, a status variable must be created and linked to the message system in WinCC. The state variable must be twice as long as the acknowledge variable. Table 3-2 Type of message variable Type of status variable byte word word dword The name of the state variable must be identical to the instance name of the block and then be extended by _MsgStatus. Figure 3-1: Acknowledgment variable Figure 3-2: State variable Entry ID: , V1.1, 06/

176 3 Working with the library 3.1 Integrating the library in STEP 7 Create acknowledgement variable If messages are to be acknowledged, an acknowledgement variable is required. This must be linked to the alarm system in WinCC. The data type must be identical to the data type of the message variable. The name of the acknowledge variable must match the name of the block instance and the extension _MsgAck must be appended. Figure 3-3: Register variable Figure 3-4: Acknowledgment variable Parameterize signalling system Some functions contain messages which can be displayed in the faceplate. If these are to be used, they must be added to the reporting system and linked as described in the previous chapter. The alarm messages are stored in each description and must be added as shown in the following figure. Entry ID: , V1.1, 06/