Manual. PLC Lib: Tc2_SMI. TwinCAT 3. Version: Date:

Transcription

1 Manual PLC Lib: Tc2_SMI TwinCAT 3 Version: Date:

2

3 Table of contents Table of contents 1 Foreword Notes on the documentation Safety instructions Introduction SMI Device addressing Programming POUs Base Basic commands Addressing commands System commands Error codes DUTs Enums Structures Appendix Example: Configuration of SMI devices Manufacturer codes Support and Service PLC Lib: Tc2_SMI Version: 1.4 3

4 Table of contents 4 Version: 1.4 PLC Lib: Tc2_SMI

5 Foreword 1 Foreword 1.1 Notes on the documentation This description is only intended for the use of trained specialists in control and automation engineering who are familiar with the applicable national standards. It is essential that the documentation and the following notes and explanations are followed when installing and commissioning the components. It is the duty of the technical personnel to use the documentation published at the respective time of each installation and commissioning. The responsible staff must ensure that the application or use of the products described satisfy all the requirements for safety, including all the relevant laws, regulations, guidelines and standards. Disclaimer The documentation has been prepared with care. The products described are, however, constantly under development. We reserve the right to revise and change the documentation at any time and without prior announcement. No claims for the modification of products that have already been supplied may be made on the basis of the data, diagrams and descriptions in this documentation. Trademarks Beckhoff, TwinCAT, EtherCAT, Safety over EtherCAT, TwinSAFE, XFC and XTS are registered trademarks of and licensed by Beckhoff Automation GmbH. Other designations used in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owners. Patent Pending The EtherCAT Technology is covered, including but not limited to the following patent applications and patents: EP , EP , DE , DE with corresponding applications or registrations in various other countries. The TwinCAT Technology is covered, including but not limited to the following patent applications and patents: EP , US with corresponding applications or registrations in various other countries. EtherCAT is registered trademark and patented technology, licensed by Beckhoff Automation GmbH, Germany Copyright Beckhoff Automation GmbH & Co. KG, Germany. The reproduction, distribution and utilization of this document as well as the communication of its contents to others without express authorization are prohibited. Offenders will be held liable for the payment of damages. All rights reserved in the event of the grant of a patent, utility model or design. PLC Lib: Tc2_SMI Version: 1.4 5

6 Foreword 1.2 Safety instructions Safety regulations Please note the following safety instructions and explanations! Product-specific safety instructions can be found on following pages or in the areas mounting, wiring, commissioning etc. Exclusion of liability All the components are supplied in particular hardware and software configurations appropriate for the application. Modifications to hardware or software configurations other than those described in the documentation are not permitted, and nullify the liability of Beckhoff Automation GmbH & Co. KG. Personnel qualification This description is only intended for trained specialists in control, automation and drive engineering who are familiar with the applicable national standards. Description of symbols In this documentation the following symbols are used with an accompanying safety instruction or note. The safety instructions must be read carefully and followed without fail! Serious risk of injury! Failure to follow the safety instructions associated with this symbol directly endangers the life and health of persons. DANGER Risk of injury! Failure to follow the safety instructions associated with this symbol endangers the life and health of persons. WARNING Personal injuries! Failure to follow the safety instructions associated with this symbol can lead to injuries to persons. CAUTION Damage to the environment or devices Failure to follow the instructions associated with this symbol can lead to damage to the environment or equipment. Attention Tip or pointer This symbol indicates information that contributes to better understanding. Note 6 Version: 1.4 PLC Lib: Tc2_SMI

7 Introduction 2 Introduction The user of this library requires basic knowledge of the following: TwinCAT XAE PC and network knowledge Structure and properties of the Beckhoff Embedded PC and its Bus Terminal system Technology of SMI devices Relevant safety regulations for building technical equipment This software library is intended for building automation system partners of Beckhoff Automation GmbH & Co. KG. The system partners operate in the field of building automation and are concerned with the installation, commissioning, expansion, maintenance and service of measurement, control and regulating systems for the technical equipment of buildings. The Tc2_SMI library is usable on all hardware platforms that support TwinCAT 3.1 or higher. Hardware documentation in the Beckhoff information system: PLC Lib: Tc2_SMI Version: 1.4 7

8 SMI 3 SMI The automation of roller shutters and sun blinds in building automation is simplified with the SMI-Bus system (Standard Motor Interface). With SMI drives roller shutters can drive to precise positions and blind drives can drive to angular positions with an accuracy of a degree. The SMI drives can transmit actual positions, error messages and service information back to the SMI master terminal. Major European manufacturers have joined forces in the SMI working group and have developed the digital interface. Drives are controlled by means of telegrams via this uniform interface. Using standard commands, functions can be implemented that are not so easy to realize with conventional drives. Examples are the precise movement to positions, the feedback of the current position and diagnosis. For the adjustment of louvers in shading systems, for example, angular resolutions of 2 can be achieved. Adjustment of the louvers in relation to the position of the sun is thus possible for constant light control. Powerful PLC function blocks are available in the TwinCAT HVAC library for room automation according to VDI Distances of up to 350 meters between the controller and the drive are possible. A normal 5-core power cable can be used for the cabling (with PE, N, L and the SMI-specific I+ and I-); I+ and I- are protected against pole reversal. Up to 16 drives can be connected in parallel and addressed individually. SMI drives are available for mains voltage (230 V AC) and for low voltage (24 V DC). In order to ensure the compatibility of the SMI products with one another, all products that are to be marked with the SMI logo must be certified. A positive certification can be read on the SMI Group s homepage ( Further information on the SMI-Bus and SMI drives can also be found there. 3.1 Device addressing SMI defines various modes of device addressing. In principle distinction can be made between individual addressing, group addressing and the collective call (broadcast). Most PLC function blocks have the dwaddr input and eaddrtype for this. While the dwaddr input contains the necessary address details, eaddrtype defines the mode of addressing. The individual modes of addressing are described below. Note that not every command supports all addressing modes. Details can be found in the description of the respective PLC function block. by the address of a device (eaddrtype: = esmiaddrtypeaddress) Each SMI device can be assigned an address from 0 to 15. The address is stored in the SMI device and must be correctly set again when exchanging the drive. Since each address should only be assigned once, each SMI device can be addressed individually. With this mode of addressing the dwaddr input contains the address in the range 0 to 15. If a value outside the valid range is specified, then the respective function block outputs an error [} 46]. This address is also occasionally called the slave address. The slave address must not be confused with the slave ID (see below). per slave ID (eaddrtype := esmiaddrtypeslaveid) The individual device manufacturers store a unique 32-bit number in each SMI device. This slave ID, also called the key ID, can also be used for the addressing of a device. With this mode of addressing the dwaddr input contains the 32-bit slave ID and the dwaddroption input contains the manufacturer code (see below). This ensures that SMI devices can be addressed worldwide without them requiring an address. With some SMI devices the slave ID is printed on the name plate or is made visible by a label on the cable. Most read commands do not support addressing by Slave ID. by the manufacturer code (eaddrtype := esmiaddrtypemanufacturer) In addition to the slave ID, SMI defines a further unique ID, the so-called manufacturer code [} 55]. The manufacturer code is permanently stored in the SMI device and cannot be changed. The possible range of values is from 0 to 15, wherein the values 0 and 14 have a special meaning. The manufacturer code 0 addresses all devices, irrespective of the manufacturer. This addressing mode can therefore also be used to dispatch broadcast commands. The value 15 is reserved for future expansions and may not be used. The 8 Version: 1.4 PLC Lib: Tc2_SMI

9 SMI English designation manufacturer code or the abbreviation M-ID is frequently found here. All devices from a manufacturer are always addressed by this addressing. With this mode of addressing the dwaddr input contains the manufacturer code in the range from 0 to 14. If a value outside the valid range is specified, then the respective function block outputs an error [} 46]. With some SMI devices the manufacturer code is printed on the name plate or is made visible by a label on the cable. by group addressing (eaddrtype: = esmiaddrtypegroup) Each device that is to be controlled via group addressing must have an address from 0 to 15. Each bit of the dwaddr input corresponds to an address in the case of group addressing. If bit 0 of dwaddr is set, then the device with the address 0 is addressed. If bit 1 is set, then device 1 is addressed and so on. The group addressing thus occupies the bits 0 to 15, which corresponds to a range of values from 0 to If a value outside the valid range is specified, then the respective function block outputs an error [} 46]. Example: The drives with the addresses 1, 4, 7 and 12 are to be addressed. The value 2# _ or 16#1092 or 4242 must therefore be supplied to dwaddr. by Broadcast (eaddrtype := esmiaddrtypebroadcast) When addressing by broadcast all devices are always addressed, irrespective of the address set on the device. The dwaddr input is not required with this method of addressing and is not evaluated either. Internally the PLC function blocks use addressing by manufacturer code, wherein the manufacturer code 0 is used. PLC Lib: Tc2_SMI Version: 1.4 9

10 4 Programming 4.1 POUs Basic commands Name FB_KL6831KL6841Communication [} 11] FB_KL6831KL6841Config [} 13] FB_SMISendSMICommand [} 16] Description Reads the SMI commands sequentially from the internal buffer of the PLC library and forwards them to the KL6831/KL6841. This function block can be used to configure the KL6831/KL6841. This function block is for the general sending of an SMI command. Basic commands Name FB_SMIDiagAll [} 17] FB_SMIDown [} 19] FB_SMIDownStep [} 20] FB_SMIPos1 [} 21] FB_SMIPos1Read [} 22] FB_SMIPos1Write [} 24] FB_SMIPos2 [} 25] FB_SMIPos2Read [} 26] FB_SMIPos2Write [} 27] FB_SMIPosRead [} 28] FB_SMIPosWrite [} 29] FB_SMIStop [} 30] FB_SMISyn [} 31] FB_SMIUp [} 32] FB_SMIUpStep [} 33] Description Diagnostic telegram is sent. Motor operation to the lower final position. Motor runs downwards by a specified angle. Drives to the fixed position Pos1 configured on the motor side. Reads the fixed position Pos1 configured on the motor side. Writes the fixed position Pos1 which is configured on the motor side. Drives to the fixed position Pos2 configured on the motor side. Reads the fixed position Pos2 configured on the motor side. Writes the fixed position Pos2 which is configured on the motor side. Reads the current position. Drives to a position. Stops the motor operation. Queries the manufacturer code and drive type. Motor operation to the upper final position. Motor operation upwards by a specified angle. Addressing commands Name FB_SMIAddressing [} 34] FB_SMIDiscoverySlaveId [} 35] FB_SMISlaveAddrRead [} 37] FB_SMISlaveAddrWrite [} 38] FB_SMISlaveIdCompare [} 39] FB_SMISlaveIdRead [} 41] Description Addresses SMI devices. Searches for SMI devices by manufacturer code. Reads the address (0-15) of a drive. Writes an address (0-15) to one or more drives. Compares a specified slave ID (32-bit key ID) with the slave ID (32-bit key ID) of one or more drives, which is defined on the motor side. Reads the slave ID (32-bit Key ID). 10 Version: 1.4 PLC Lib: Tc2_SMI

11 System commands Name FB_SMIParValueReadByte [} 42] FB_SMIParValueReadWord [} 43] FB_SMIParValueReadDWord [} 45] Description Reads a byte parameter (1 byte) stored on the motor side. Reads a Word parameter (2 bytes) stored on the motor side. Reads a DWord parameter (4 bytes) stored on the motor side Base FB_KL6831KL6841Communication The function blocks for the SMI commands do not directly access the process image of the KL6831/KL6841; instead, they place the individual SMI commands into three different buffers. The FB_KL6831KL6841Communication() block reads the SMI commands sequentially from these three buffers and forwards them to the KL6831/KL6841. This prevents multiple blocks accessing the KL6831/KL68411 process image at the same time. Each of these three buffers is processed with a different priority (high, medium or low). The parameter ecommandpriority [} 47], which is available for most function blocks, can be used to specify the priority with which the respective SMI command is processed by the block FB_KL6831KL6841Communication(). The buffers in which the SMI commands are placed are all contained in a variable of the type ST_SMICommandBuffer [} 51]. For each KL6831/KL6841 there is an instance of the FB_KL6831KL6841Communication() function block and a variable of the type ST_SMICommandBuffer. If possible, the FB_KL6831KL6841Communication() function block should be called in a separate, faster task. The extent to which the buffers are utilized can be determined from the outputs of the block. Three arrays are output for this in which each element (0, 1 or 2) represents one of the three buffers (high, middle or low). If you detect regular overflow for one of the three buffers, you should consider the following: How heavily are the individual PLC tasks utilized? TwinCAT XAE provides suitable analysis tools. Try reducing the cycle time of the task in which the FB_KL6831KL6841Communication() function block is called. The value should not exceed 6 ms. Ideally it should be 2 ms. Check the cycle time of the PLC task in which the blocks for the individual SMI commands are called. This value should be between 10 ms and 60 ms. If possible avoid polling (regular reading) of values. Only read values when they are actually required. Distribute the individual drives evenly over several SMI lines. Since several SMI lines are processed simultaneously per PLC cycle, the data throughput as a whole is increased as a result. PLC Lib: Tc2_SMI Version:

12 VAR_INPUT bresetmaximumdemandcounter bresetoverflowcounter bresetinactiveprocessimage bresetdataframeerror dwoptions : DWORD := 0; bresetmaximumdemandcounter: a positive edge resets the stored value of the maximum command buffer utilization (arrbuffermaximumdemandmeter). bresetoverflowcounter: a positive edge resets the stored value of the number of command buffer overflows (arrbufferoverflowcounter). bresetinactiveprocessimage: A positive edge cancels the blocking of the process image of the terminal. The bprocessimageinactive, bdigitalinput1active and bdigitalinput2active outputs are again set to FALSE. The blocking is activated as soon as one of the digital inputs Input1 or Input2 on the terminal is actuated. bresetdataframeerror: a positive edge resets the message for a telegram error. The bdataframeerror output is set again to FALSE. The blocking is activated as soon as the terminal detects a telegram error. dwoptions: reserved for future expansions. VAR_OUTPUT bbusy berror udierrorid : UDINT; arrbufferdemandmeter : ARRAY [0..2] OF BYTE; arrbuffermaximumdemandmeter : ARRAY [0..2] OF BYTE; arrbufferoverflowcounter : ARRAY [0..2] OF UINT; blineisinitialized b24vpowersupplyswitchedon bdigitalinput1active bdigitalinput2active bprocessimageinactive bdataframeerror bchecksumerror bbusy: this output is set as soon as the function block processes a command and remains active until the command has been processed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). arrbufferdemandmeter: Occupancy of the respective buffer (0-100%). arrbuffermaximumdemandmeter: previous maximum occupancy of the respective buffer (0-100%). arrbufferoverflowcounter: Number of buffer overflows to date. blineisinitialized: if the function block is being called for the first time (e.g. when the controller is starting up) an initialization process is executed. No SMI commands can be processed during this time. This output is set to TRUE once the initialization has been completed. b24vpowersupplyswitchedon: the KL6831/KL6841 must be supplied with 24 V DC via two connections. The output is set as soon as 24 V DC is detected. If there is no 24 V DC the output goes FALSE and no SMI commands can be processed by the controller as long as there is no 24 V DC. bdigitalinput1active: the digital input Input1 on the terminal has been or is actuated (see also the terminal documentation). The bprocessimageinactive output is set and no further SMI commands can be processed by the controller. bdigitalinput2active: the digital input Input2 on the terminal has been or is actuated (see also the terminal documentation). The bprocessimageinactive output is set and no further SMI commands can be processed by the controller. 12 Version: 1.4 PLC Lib: Tc2_SMI

13 bprocessimageinactive: one of the digital inputs Input1 or Input2 has been actuated on the terminal. No further SMI commands can be processed by the controller. The blockage must be released again via the bresetinactiveprocessimage input. bdataframeerror: the terminal has detected a telegram error on the SMI bus. The error must be reset via the bresetdataframeerror input. bchecksumerror: the terminal has detected a checksum error on the SMI bus. The message is automatically reset as soon as a telegram is transmitted without error once again. VAR_IN_OUT stindata : ST_KL6831KL6841InData; stoutdata : ST_KL6831KL6841OutData; stcommandbuffer : ST_SMICommandBuffer; stindata : Reference to the structure for communication with the KL6831/KL6841 (see ST_KL6831KL6841InData [} 50] ). stoutdata : Reference to the structure for communication with the KL6831/KL6841 (see ST_KL6831KL6841OutData [} 51]). stcommandbuffer: Reference to the structure for communication with the SMI blocks (see ST_SMICommandBuffer [} 51]) FB_KL6831KL6841Config This function block is used to configure the KL6831/KL6841. The configuration is executed when the PLC program starts, or it can be triggered by a positive edge at the input bconfigurate. The parameters are stored in the respective registers of the KL6831/KL6841 in a non-volatile manner. In addition, some general information, such as the firmware version, is read from the KL6831/KL6841. Example: The function block is called in the same task as the function block FB_KL6831KL6841Communication() [} 11]. PLC Lib: Tc2_SMI Version:

14 The function block FB_KL6831KL6841Config() is linked to the process image of the KL6831/KL6841. Once the configuration is complete, the function block FB_KL6831KL6841Communication() [} 11] received the process values of the KL6831/KL6841. No SMI commands can be sent while the configuration is in progress. VAR_INPUT bconfigurate : BOOL := FALSE; ecommandkbuswatchdog : E_SMIConfigurationCommands := esmicommanddonothing; ecommanddi1risingedge : E_SMIConfigurationCommands := esmicommandup; ecommanddi1fallingedge : E_SMIConfigurationCommands := esmicommandstop; ecommanddi2risingedge : E_SMIConfigurationCommands := esmicommanddown; ecommanddi2fallingedge : E_SMIConfigurationCommands := esmicommandstop; dwoptions : DWORD := 0; bconfigurate: Configuration of the Bus Terminal is started by a positive edge at this input. ecommandkbuswatchdog: Defines the SMI command that is sent as soon as the Bus Terminal is no longer addressed via the K-bus (see E_SMIConfigurationCommands [} 49]). Corresponds to register 33 to 35 of the Bus Terminal. ecommanddi1risingedge: Defines the SMI command that is sent as soon as a rising edge is detected at input 1 of the Bus Terminal (see E_SMIConfigurationCommands [} 49]). Corresponds to register 36 to 38 of the Bus Terminal. ecommanddi1fallingedge: Defines the SMI command that is sent as soon as a falling edge is detected at input 1 of the Bus Terminal (see E_SMIConfigurationCommands [} 49]). Corresponds to register 39 to 41 of the Bus Terminal. ecommanddi2risingedge: Defines the SMI command that is sent as soon as a rising edge is detected at input 2 of the Bus Terminal (see E_SMIConfigurationCommands [} 49]). Corresponds to register 42 to 44 of the Bus Terminal. ecommanddi2fallingedge: Defines the SMI command that is sent as soon as a falling edge is detected at input 2 of the Bus Terminal (see E_SMIConfigurationCommands [} 49]). Corresponds to register 45 to 47 of the Bus Terminal. 14 Version: 1.4 PLC Lib: Tc2_SMI

15 dwoptions: Reserved for future extensions. VAR_OUTPUT bbusy berror udierrorid : UDINT; wterminaldescription : WORD; wfirmwareversion : WORD; sdescription : STRING; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. Reactivating the function block via the bconfigurate input sets the output to FALSE again. udierrorid: Contains the command-specific error code of the most recently executed command. It is reset to 0 by activating the function block again via the input bconfigurate. See Error codes. wterminaldescription: Contains the terminal designation (e.g. 6831). Corresponds to register 8 of the Bus Terminal. wfirmwareversion: Contains the firmware version. Corresponds to register 9 of the Bus Terminal. sdescription: Terminal designation and firmware version as string (e.g. 'Terminal KL6831 / Firmware 1D'). VAR_IN_OUT stindataterminal : ST_KL6831KL6841InData; stoutdataterminal : ST_KL6831KL6841OutData; stindata : ST_KL6831KL6841InData; stoutdata : ST_KL6831KL6841OutData; stindataterminal: Reference to the structure for communication with the KL6831/KL6841 (see ST_KL6831KL6841InData [} 50]). stoutdataterminal: Reference to the structure for communication with the KL6831/KL6841 (see ST_KL6831KL6841OutData [} 51]). stindata: Reference to the structure for communication with the function block FB_KL6831KL6841Communication() [} 11] (see ST_KL6831KL6841InData [} 50]). stoutdata: Reference to the structure for communication with the function block FB_KL6831KL6841Communication() [} 11] (see ST_KL6831KL6841OutData [} 51]). Prerequisites Library from v Tc2_SMI from PLC Lib: Tc2_SMI Version:

16 FB_SMISendSMICommand This function block is for the general sending of an SMI command. The precise structure of an SMI command and the functioning of the KL6831/KL6841 must be known for this. The use of this function block is necessary only if an SMI command is to be sent that is not covered by the other PLC function blocks. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; ecommandtype : E_SMICommandType := esmicommandtypewrite; eresponseformat : E_SMIResponseFormat := esmiresponseformatdiagnosis; arridentificationbytes : ARRAY [0..2] OF BYTE; arrparameters : ARRAY [0..2] OF DWORD; bsuppressresponsebuffer : BOOL := FALSE; dwoptions : DWORD := 0; bstart: The function block is activated by a positive edge at this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). ecommandtype: Command type: Write/Read (see E_SMICommandType [} 47]). This parameter affects bit 5 of the start byte of the SMI telegram. eresponseformat: ResponseFormat: Special diagnostic formats/standard (see E_SMIResponseFormat [} 50]). This parameter affects bit 6 of the start byte of the SMI telegram. arridentificationbytes: an SMI telegram can consist of up to 3 blocks. Each block possesses an identifier byte. Each block possesses an identifier byte. arrparameters: an SMI telegram can consist of up to 3 blocks. Each block possesses up to four value bytes. The value bytes of the individual blocks are defined by this array. bsuppressresponsebuffer: if this input is set to TRUE the internal software buffer is not filled with the responses from the FB_KL6831KL6841Communication() [} 11] block. dwoptions: reserved for future expansions. 16 Version: 1.4 PLC Lib: Tc2_SMI

17 VAR_OUTPUT bbusy berror udierrorid : UDINT; arrresponsedata : ARRAY [0..7] OF BYTE; byresponsedatalength : BYTE; byresponseidentificationbyte : BYTE; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). arrresponsedata: the data received from the SMI devices. byresponsedatalength: the length of the data received in bytes. byresponseidentificationbyte: the identifier byte received. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) Basic commands FB_SMIDiagAll Using this command it is possible to determine the direction in which the drives are driving, whether they have stopped or whether there is a motor error. The command can also be sent also to several SMI slaves. The states of all SMI slaves can thus be queried with a single command. The result of the query is forwarded by four outputs. Each of these outputs can assume three states: The condition applies to at least one drive. The condition does not apply to any drive. The condition could not be determined. Some examples of this are explained further below. PLC Lib: Tc2_SMI Version:

18 VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; eresdrivesup : E_SMIDiagResDrivesUp; eresdrivesdown : E_SMIDiagResDrivesDown; eresisstopped : E_SMIDiagResIsStopped; ereswitherror : E_SMIDiagResWithError; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). eresdrivesup: At least one motor is driving up / no motor is driving up / the value is undefined. (see E_SMIDiagResDrivesUp [} 49]). eresdrivesdown: at least one motor is driving down / no motor is driving down / the value is undefined (see E_SMIDiagResDrivesDown [} 49]). eresisstopped: at least one motor is stopped / no motor is stopped / the value is undefined (see E_SMIDiagResIsStopped [} 49]). ereswitherror: at least one motor is in an error state / no motor is in an error state / the value is undefined (see E_SMIDiagResWithError [} 50]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). Examples All drives have stopped: Outputs eresdrivesup = esmidiagresnomotordrivesup Meaning No drive is driving up. 18 Version: 1.4 PLC Lib: Tc2_SMI

19 Outputs eresdrivesdown = esmidiagresnomotordrivesdown eresisstopped = esmidiagresatleastonemotorisstopped ereswitherror = esmidiagresnomotorwitherror Meaning No drive is driving down. At least one drive has stopped. No drive has a motor error. All drives are driving up: Outputs eresdrivesup = esmidiagresatleastonemotordrivesup eresdrivesdown = esmidiagresnomotordrivesdown eresisstopped = esmidiagresnomotorisstopped ereswitherror = esmidiagresnomotorwitherror Meaning At least one drive is driving up. No drive is driving down. No drive has stopped. No drive has a motor error. One drive has stopped and one drive is driving up: Outputs eresdrivesup = esmidiagresatleastonemotordrivesup eresdrivesdown = esmidiagresnomotordrivesdown eresisstopped = esmidiagresatleastonemotorisstopped ereswitherror = esmidiagresnomotorwitherror Meaning At least one drive is driving up. No drive is driving down. At least one drive has stopped. No drive has a motor error. One drive has stopped, one drive is driving up and one drive is driving down: Outputs eresdrivesup = esmidiagresatleastonemotordrivesup eresdrivesdown = esmidiagresatleastonemotordrivesdown eresisstopped = esmidiagresatleastonemotorisstopped ereswitherror = esmidiagresnomotorwitherror Meaning At least one drive is driving up. At least one drive is driving down. At least one drive has stopped. No drive has a motor error FB_SMIDown Motor operation to the lower final position. PLC Lib: Tc2_SMI Version:

20 VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIDownStep Motor operation downwards by a specified angular degree (0-510 degrees). 20 Version: 1.4 PLC Lib: Tc2_SMI

21 VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; uiangle : UINT := 0; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). uiangle: the specified angular degree. The range of values is 0 to 510 degrees. The SMI standard reduces the accuracy to a resolution of 2 degrees. VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIPos1 PLC Lib: Tc2_SMI Version:

22 Drives to the fixed position Pos1 configured on the motor side. The reading and changing of Pos1 is possible with the FB_SMIPos1Read() [} 22] and FB_SMIPos1Write() [} 24] blocks. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIPos1Read 22 Version: 1.4 PLC Lib: Tc2_SMI

23 Reads the fixed position Pos1 configured on the motor side. Pos1 can be changed using the FB_SMIPos1Write() [} 24] function block. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; wposition : WORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). wposition: The fixed position Pos1 read out. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). PLC Lib: Tc2_SMI Version:

24 FB_SMIPos1Write Writes the fixed position Pos1 which is configurable on the motor side. Pos1 can be changed using the FB_SMIPos1Read() [} 22] block. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wposition : WORD := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wposition: the new fixed position Pos1. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). 24 Version: 1.4 PLC Lib: Tc2_SMI

25 FB_SMIPos2 Drives to the fixed position Pos2 configured on the motor side. The reading and changing of Pos2 is possible with the FB_SMIPos2Read() [} 26] and FB_SMIPos2Write() [} 27] blocks. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). PLC Lib: Tc2_SMI Version:

26 FB_SMIPos2Read Reads the fixed position Pos2 configured on the motor side. Pos2 can be changed using the FB_SMIPos2Write() [} 27] function block. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; wposition : WORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). wposition: The fixed position Pos2 read. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; 26 Version: 1.4 PLC Lib: Tc2_SMI

27 stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIPos2Write Writes the fixed position Pos2 which is configurable on the motor side. Pos2 can be changed using the FB_SMIPos2Read() [} 26] block. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wposition : WORD := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wposition: the new fixed position Pos2. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). PLC Lib: Tc2_SMI Version:

28 VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIPosRead The current position is read from the drive. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; wposition : WORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). 28 Version: 1.4 PLC Lib: Tc2_SMI

29 wposition: The position read out. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIPosWrite The drive is driven to the specified position. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wposition : WORD := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wposition: the new position. The value 0 corresponds here to the upper final position and the value (0xFFFF) to the lower final position. VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. PLC Lib: Tc2_SMI Version:

30 berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIStop The motor operation is stopped. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. 30 Version: 1.4 PLC Lib: Tc2_SMI

31 berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMISyn The manufacturer code and the drive type are queried. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; bymanufactorcode : BYTE; bydrivetype : BYTE; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. PLC Lib: Tc2_SMI Version:

32 berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). bymanufactorcode: the manufacturer code [} 55] (1-14). bydrivetype: the type of drive (0-15). The meaning is manufacturer-specific. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIUp Motor operation to the upper final position. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; 32 Version: 1.4 PLC Lib: Tc2_SMI

33 bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIUpStep Motor operation upwards by a specified angle (0-510 degrees). VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; uiangle : UINT := 0; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). uiangle: the specified angular degree. The range of values is 0 to 510 degrees. The SMI standard reduces the accuracy to a resolution of 2 degrees. PLC Lib: Tc2_SMI Version:

34 VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) Addressing commands FB_SMIAddressing This function block addresses the connected SMI devices according to the random principle. The user has no influence over which address is assigned to which SMI device. The addresses are assigned in descending order, starting with the address specified by the byhighestaddress parameter. Applying a positive edge to the bstart input starts the function block, and the bbusy output goes TRUE. The function block now independently addresses all SMI devices. The output variable arraddresseddevices provides information which SMI devices have already received an address. Once all SMI devices have been addressed, the bbusy output goes FALSE again. Addressing can be aborted through a positive edge at input bcancel. Processing this function block can take several minutes, depending on how many SMI devices are connected. VAR_INPUT bstart bcancel byhighestaddress : BYTE := 15; dwoptions : DWORD := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. 34 Version: 1.4 PLC Lib: Tc2_SMI

35 bcancel: the function block is deactivated and the search is aborted on applying a positive edge to this input. byhighestaddress: address from which the SMI devices are addressed in descending order (0-15). dwoptions: reserved for future extensions. VAR_OUTPUT bbusy berror udierrorid : UDINT; dwcurrentsearchslaveid : DWORD; bycurrentmanufacturer : BYTE; bycurrentslaveaddr : BYTE; arraddresseddevices : ARRAY [0..15] OF BOOL; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). dwcurrentsearchslaveid: current slave ID used in the search algorithm. bycurrentmanufacturer: current manufacturer code [} 55] used in the search algorithm. bycurrentslaveaddr: current address used in the search algorithm. arraddresseddevices: if an address is assigned to an SMI device, then the corresponding element in the array is set to TRUE. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIDiscoverySlaveId The first drive is sought that corresponds to the specified manufacturer code and has the address 0. This function block is used in the addressing of SMI devices and is used in the FB_SMIAddressing() [} 34] function block. PLC Lib: Tc2_SMI Version:

36 VAR_INPUT bstart bcancel bymanufacturer : BYTE := 0; dwoptions : DWORD := 0; bstart: the function block is activated and the search is started by applying a positive edge to this input. bcancel: the function block is deactivated and the search is aborted on applying a positive edge to this input. bymanufacturer: the manufacturer code [} 55] specified for the search for the SMI device. Some SMI devices do not permit the manufacturer code 0. dwoptions: reserved for future extensions. VAR_OUTPUT bbusy berror udierrorid : UDINT; dwcurrentsearchslaveid : DWORD; eresslaveaddret0andslaveidltserachid : E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId; eresslaveaddret0andslaveidgtserachid : E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId; eresslaveaddret0andslaveidetserachid : E_SMICompResSlaveAddrET0AndSlaveIdETSearchId; eresslaveaddrne0 : E_SMICompResSlaveAddrNE0; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). dwcurrentsearchslaveid: as soon as the execution of the function block has ended (bbusy changes from TRUE to FALSE) this output indicates the slave ID of the SMI device found. eresslaveaddret0andslaveidltserachid: For at least one motor / no motor has the address 0 and the slave ID is smaller than the slave ID sought (dwslave-id) / the value is undefined. (see E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId [} 48]). eresslaveaddret0andslaveidgtserachid: For at least one motor / no motor the address is 0 and the slave ID is less than the searched slave ID (dwslave-id) / the value is undefined (see E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId [} 48]). eresslaveaddret0andslaveidetserachid: For at least one motor / no motor the address is 0 and the slave ID is greater than the searched slave ID (dwslave-id) / the value is undefined (see E_SMICompResSlaveAddrET0AndSlaveIdETSearchId [} 48]). eresslaveaddrne0: at least one motor / no motor has an address unequal 0 / the value is undefined (see E_SMICompResSlaveAddrNE0 [} 48]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). 36 Version: 1.4 PLC Lib: Tc2_SMI

37 FB_SMISlaveAddrRead The address (0-15) of a drive is read. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; byslaveaddr : BYTE; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). byslaveaddr: The read slave address (0-15). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). PLC Lib: Tc2_SMI Version:

38 FB_SMISlaveAddrWrite Writes the address (0-15) of one or more drives. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bynewslaveaddr : BYTE := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). bynewslaveaddr: the new slave address (0-15). VAR_OUTPUT bbusy berror udierrorid : UDINT; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). 38 Version: 1.4 PLC Lib: Tc2_SMI

39 FB_SMISlaveIdCompare A specified slave ID (32-bit key ID) is compared with the slave ID (32-bit key ID) of one or more drives which is defined on the motor side. The command can also be sent also to several SMI slaves. The result of the query is forwarded by four outputs. Each of these outputs can assume three states: The condition applies to at least one drive. The condition does not apply to any drive. The condition could not be determined. Some examples of this are explained further below. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; dwslaveid : DWORD := 0; bstart: the function block is activated and the command is send by applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). dwslaveid: the Slave ID with which the Slave ID on the motor side is compared. VAR_OUTPUT bbusy berror udierrorid : UDINT; eresslaveaddret0andslaveidltserachid : E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId; eresslaveaddret0andslaveidgtserachid : E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId; eresslaveaddret0andslaveidetserachid : E_SMICompResSlaveAddrET0AndSlaveIdETSearchId; eresslaveaddrne0 : E_SMICompResSlaveAddrNE0; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). PLC Lib: Tc2_SMI Version:

40 eresslaveaddret0andslaveidltserachid: For at least one motor / no motor has the address 0 and the slave ID is smaller than the slave ID sought (dwslave-id) / the value is undefined. (see E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId [} 48]). eresslaveaddret0andslaveidgtserachid: For at least one motor / no motor the address is 0 and the slave ID is less than the searched slave ID (dwslave-id) / the value is undefined (see E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId [} 48]). eresslaveaddret0andslaveidetserachid: For at least one motor / no motor the address is 0 and the slave ID is greater than the searched slave ID (dwslave-id) / the value is undefined (see E_SMICompResSlaveAddrET0AndSlaveIdETSearchId [} 48]). eresslaveaddrne0: at least one motor / no motor has an address unequal 0 / the value is undefined (see E_SMICompResSlaveAddrNE0 [} 48]). VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). Examples The following tables show the results of the function block with different initial situations. In all cases two SMI devices are connected to an SMI terminal and both addresses are greater than 0. The slave ID (dwslaveid) sought lies between the slave IDs of the two drives: Outputs eresslaveaddret0andslaveidltserachid = esmidiagresatleastoneslaveaddret0andslaveidl TSearchId eresslaveaddret0andslaveidgtserachid = esmidiagresatleastoneslaveaddret0andslaveid GTSearchId Meaning At least one motor has the slave address equal 0 and the slave ID is smaller than the slave ID sought. At least one motor has the slave address equal 0 and the slave ID is greater than the slave ID sought. eresslaveaddret0andslaveidetserachid = No motor has the slave address equal 0 and the esmidiagresnoslaveaddret0andslaveidetsearchi slave ID is the same as the slave ID sought. d eresslaveaddrne0 = esmidiagresnoslaveaddrne0 No motor has the slave address unequal 0. The slave ID (dwslaveid) sought is greater than the slave IDs of the two drives: Outputs eresslaveaddret0andslaveidltserachid = esmidiagresatleastoneslaveaddret0andslaveidl TSearchId eresslaveaddret0andslaveidgtserachid = esmidiagresnoslaveaddret0andslaveidgtsearch Id eresslaveaddret0andslaveidetserachid = esmidiagresnoslaveaddret0andslaveidltsearchi d eresslaveaddrne0 = esmidiagresnoslaveaddrne0 Meaning At least one motor has the slave address equal 0 and the slave ID is smaller than the slave ID sought. No motor has the slave address equal 0 and the slave ID is greater than the slave ID sought. No motor has the slave address equal 0 and the slave ID is smaller than the slave ID sought. No motor has the slave address unequal 0. The slave ID (dwslaveid) sought is smaller than the slave IDs of the two drives: 40 Version: 1.4 PLC Lib: Tc2_SMI

41 Outputs eresslaveaddret0andslaveidltserachid = esmidiagresnoslaveaddret0andslaveidltsearchi d eresslaveaddret0andslaveidgtserachid = esmidiagresatleastoneslaveaddret0andslaveid GTSearchId Meaning No motor has the slave address equal 0 and the slave ID is smaller than the slave ID sought. At least one motor has the slave address equal 0 and the slave ID is greater than the slave ID sought. eresslaveaddret0andslaveidetserachid = No motor has the slave address equal 0 and the esmidiagresnoslaveaddret0andslaveidetsearchi slave ID is the same as the slave ID sought. d eresslaveaddrne0 = esmidiagresnoslaveaddrne0 The slave ID (dwslaveid) sought is the same as the slave ID of a drive: Outputs eresslaveaddret0andslaveidltserachid = esmidiagresnoslaveaddret0andslaveidltsearchi d eresslaveaddret0andslaveidgtserachid = esmidiagresatleastoneslaveaddret0andslaveid GTSearchId No motor has the slave address unequal 0. Meaning No motor has the slave address equal 0 and the slave ID is smaller than the slave ID sought. At least one motor has the slave address equal 0 and the slave ID is greater than the slave ID sought. eresslaveaddret0andslaveidetserachid = At least one motor has the slave address equal 0 and esmidiagresatleastoneslaveaddret0andslaveide the slave ID is the same as the slave ID sought. TSearchId eresslaveaddrne0 = esmidiagresnoslaveaddrne0 No motor has the slave address unequal FB_SMISlaveIdRead The slave ID (32-bit key ID) is read from a drive. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; bstart: the function block is started and the command is sent on applying a positive edge to this input. dwaddr: manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. PLC Lib: Tc2_SMI Version:

42 eaddrtype: defines whether the dwaddr input is to be evaluated as a manufacturer code [} 55], the address of a device (see E_SMIAddrType [} 47]), for group addressing or as a slave ID. dwaddroption: if the SMI device is addressed by slave ID (eaddrtype = esmiaddrtypeslaveid), then the manufacturer code [} 55] must be specified via this input. ecommandpriority: priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). VAR_OUTPUT bbusy berror udierrorid : UDINT; dwslaveid : DWORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). dwslaveid: the slave ID read out. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) System commands FB_SMIParValueReadByte Reads a byte parameter (1 byte) stored on the motor side. The meaning of the individual parameters is manufacturer-specific. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; 42 Version: 1.4 PLC Lib: Tc2_SMI

43 dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wparaddr : WORD := 0; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wparaddr: Address of the parameter (0-4095) to be read. VAR_OUTPUT bbusy berror udierrorid : UDINT; byparvalue : BYTE; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). byparvalue: the byte parameter read out. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]) FB_SMIParValueReadWord Reads a Word parameter (2 bytes) stored on the motor side. The meaning of the individual parameters is manufacturer-specific. PLC Lib: Tc2_SMI Version:

44 VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wparaddr : WORD := 0; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wparaddr: Address of the parameter (0-4095) to be read. VAR_OUTPUT bbusy berror udierrorid : UDINT; wparvalue : WORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). wparvalue: the Word parameter read out. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). 44 Version: 1.4 PLC Lib: Tc2_SMI

45 FB_SMIParValueReadDWord Reads a DWord parameter (4 bytes) stored on the motor side. The meaning of the individual parameters is manufacturer-specific. VAR_INPUT bstart dwaddr : DWORD := 0; eaddrtype : E_SMIAddrType := esmiaddrtypeaddress; dwaddroption : DWORD := 0; ecommandpriority : E_SMICommandPriority := esmicommandprioritymiddle; wparaddr : WORD := 0; bstart: The function block is activated and the command is send by applying a positive edge to this input. dwaddr: Manufacturer code [} 55] (0-15), address of a device (0-15), bit field (16 bits) for the group addressing or slave ID (32-bit key ID). This input has no meaning if a collective call (broadcast) is sent. eaddrtype: Determines whether the input dwaddr is evaluated as manufacturer code [} 55], device address (see E_SMIAddrType [} 47]) or as part of the group address. Addressing via slave ID (eaddrtype = esmiaddrtypeslaveid) is not permitted. dwaddroption: Reserved for future extensions. ecommandpriority: Priority (high, medium or low) with which the command is processed by the PLC library (see E_SMICommandPriority [} 47]). wparaddr: Address of the parameter (0-4095) to be read. VAR_OUTPUT bbusy berror udierrorid : UDINT; dwparvalue : DWORD; bbusy: When the function block is activated the output is set, and it remains active until execution of the command has been completed. berror: This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in udierrorid. The output is set back to FALSE by the reactivation of the function block via the bstart input. udierrorid: Contains the command-specific error code of the most recently executed command. It is set back to 0 by the reactivation of the function block via the bstart input (see error codes [} 46]). dwparvalue: the DWord parameter read out. VAR_IN_OUT stcommandbuffer : ST_SMICommandBuffer; stcommandbuffer: reference to the structure for communication (buffer) with the FB_KL6831KL6841Communication() [} 11] function block (see ST_SMICommandBuffer [} 51]). PLC Lib: Tc2_SMI Version:

46 4.1.5 Error codes Value (hex) Value (dec) Description 0x No error. 0x No response from the SMI drive. 0x No terminal feedback for the transmit data from the SMI terminal. 0x The terminal has detected a telegram error (StatusWord.6 = true). This message must be acknowledged by the bresetdataframeerror input of FB_KL6831KL6841Communication(). 0x NACK received from the drive. 0x Invalid feedback received from the drive. 0x Communication buffer overflow. 0x No response from the communication function block. 0x The SMI_COMMAND_BUFFER_ENTRIES constant is outside the valid range (2-250). 0x The ID byte received is incorrect. 0x800A The data length received is not correct. 0x800B No 24 V supply voltage to the KL6831/KL6841 (StatusWord.2 = false). 0x800C Process image was deactivated by the Switch1 or Switch2 input of the terminal (StatusWord.5 = true). This message must be acknowledged by the bresetinactiveprocessimage input of FB_KL6831KL6841Communication(). 0x800D The terminal has detected a checksum error (StatusWord.8 = true). This message is reset as soon as a telegram is successfully transmitted. 0x800E The SMI command does not support addressing via slave ID (eaddrtype = esmiaddrtypeslaveid). 0x800F The waddr parameter (bit field for group addressing) is outside the valid range ( ). 0x The waddr parameter (address) is outside the valid range (0-15). 0x The ecommandpriority parameter is invalid. 0x The ecommandtype parameter is invalid. 0x The uiangle parameter is outside the valid range (0-510). 0x The wparaddr parameter is outside the valid range (0-4095). 0x The eaddrtype parameter is invalid. 0x The eresponseformat parameter is invalid. 0x The waddr parameter (manufacturer code) is outside the valid range (0-15). 0x The command supports only individual addressing. 0x The waddroption parameter (manufacturer code) is outside the valid range (0-15). 0x801A An internal error has occurred in the FB_SMIDiscoverySlaveId function block. 46 Version: 1.4 PLC Lib: Tc2_SMI

47 Value (hex) Value (dec) Description 0x801B No devices were found. 0x801C All 16 addresses have already been assigned. There are possibly more than 16 devices connected to the SMI bus. 0x801D Invalid diagnostic response received (neither NACK nor ACK). 0x801E The byhighestaddress parameter (highest address) is outside the valid range (0-15). 4.2 DUTs Enums E_SMIAddrType TYPE E_SMIAddrType : ( esmiaddrtypemanufacturer := 0, esmiaddrtypeaddress := 1, esmiaddrtypegroup := 2, esmiaddrtypeslaveid := 3, esmiaddrtypebroadcast := 4 ); END_TYPE E_SMICommandPriority TYPE E_SMICommandPriority : ( esmicommandpriorityhigh := 0, esmicommandprioritymiddle := 1, esmicommandprioritylow := 2 ); END_TYPE E_SMICommandType TYPE E_SMICommandType : ( esmicommandtypewrite := 0, esmicommandtyperead := 1 ); END_TYPE PLC Lib: Tc2_SMI Version:

48 E_SMICompResSlaveAddrET0AndSlaveIdETSearchId TYPE E_SMICompResSlaveAddrET0AndSlaveIdETSearchId : ( esmidiagresslaveaddret0andslaveidetsearchidundefined := 0, esmidiagresnoslaveaddret0andslaveidetsearchid := 1, esmidiagresatleastoneslaveaddret0andslaveidetsearchid := 2 ); END_TYPE E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId TYPE E_SMICompResSlaveAddrET0AndSlaveIdGTSearchId : ( esmidiagresslaveaddret0andslaveidgtsearchidundefined := 0, esmidiagresnoslaveaddret0andslaveidgtsearchid := 1, esmidiagresatleastoneslaveaddret0andslaveidgtsearchid := 2 ); END_TYPE E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId TYPE E_SMICompResSlaveAddrET0AndSlaveIdLTSearchId : ( esmidiagresslaveaddret0andslaveidltsearchidundefined := 0, esmidiagresnoslaveaddret0andslaveidltsearchid := 1, esmidiagresatleastoneslaveaddret0andslaveidltsearchid := 2 ); END_TYPE E_SMICompResSlaveAddrNE0 TYPE E_SMICompResSlaveAddrNE0 : ( esmidiagresslaveaddrne0undefined := 0, esmidiagresnoslaveaddrne0 := 1, esmidiagresatleastoneslaveaddrne0 := 2 ); END_TYPE 48 Version: 1.4 PLC Lib: Tc2_SMI

49 E_SMIConfigurationCommands TYPE E_SMIConfigurationCommands : ( esmicommanddonothing := 0, esmicommandup := 1, esmicommanddown := 2, esmicommandstop := 3, esmicommandpos1 := 4, esmicommandpos2 := 5 ); END_TYPE Prerequisites Library from v Tc2_SMI from E_SMIDiagResDrivesDown TYPE E_SMIDiagResDrivesDown : ( esmidiagresdrivesdownundefined := 0, esmidiagresnomotordrivesdown := 1, esmidiagresatleastonemotordrivesdown := 2 ); END_TYPE E_SMIDiagResDrivesUp TYPE E_SMIDiagResDrivesUp : ( esmidiagresdrivesupundefined := 0, esmidiagresnomotordrivesup := 1, esmidiagresatleastonemotordrivesup := 2 ); END_TYPE E_SMIDiagResIsStopped TYPE E_SMIDiagResIsStopped : ( esmidiagresisstoppedundefined := 0, esmidiagresnomotorisstopped := 1, PLC Lib: Tc2_SMI Version:

50 esmidiagresatleastonemotorisstopped := 2 ); END_TYPE E_SMIDiagResWithError TYPE E_SMIDiagResWithError : ( esmidiagreswitherrorundefined := 0, esmidiagresnomotorwitherror := 1, esmidiagresatleastonemotorwitherror := 2 ); END_TYPE E_SMIResponseFormat TYPE E_SMIResponseFormat : ( esmiresponseformatdiagnosis := 0, esmiresponseformatstandard := 1 ); END_TYPE Structures ST_KL6831KL6841InData TYPE ST_KL6831KL6841InData : STRUCT wstateword : WORD; arrdata : ARRAY [0..21] OF BYTE; END_STRUCT END_TYPE 50 Version: 1.4 PLC Lib: Tc2_SMI

51 ST_KL6831KL6841OutData TYPE ST_KL6831KL6841OutData : STRUCT wcontrolword : WORD; arrdata : ARRAY [0..21] OF BYTE; END_STRUCT END_TYPE ST_SMICommandBuffer TYPE ST_SMICommandBuffer : STRUCT arrmessagequeue : ARRAY [0..2] OF ST_SMIMessageQueue; stresponsetable : ST_SMIResponseTable; udimessagehandle : UDINT; END_STRUCT END_TYPE ST_SMIMessageQueue TYPE ST_SMIMessageQueue : STRUCT arrbuffer : ARRAY [1..SMI_COMMAND_BUFFER_ENTRIES] OF ST_SMIMessageQueueItem; bybufferreadpointer : BYTE; bybufferwritepointer : BYTE; bybufferdemandcounter : BYTE; bybuffermaximumdemandcounter : BYTE; uibufferoverflowcounter : UINT; blocksemaphore END_STRUCT END_TYPE ST_SMIMessageQueueItem TYPE ST_SMIMessageQueueItem : STRUCT dwaddr : DWORD; eaddrtype : E_SMIAddrType; ecommandtype : E_SMICommandType; eresponseformat : E_SMIResponseFormat; arridentificationbytes : ARRAY [0..2] OF BYTE; arrparameters : ARRAY [0..2] OF DWORD; udimessagehandle : UDINT; bsuppressresponsebuffer END_STRUCT END_TYPE PLC Lib: Tc2_SMI Version:

52 ST_SMIResponseTable TYPE ST_SMIResponseTable : STRUCT arrresponsetable : ARRAY [1..SMI_COMMAND_BUFFER_ENTRIES] OF ST_SMIResponseTableItem; byresponsetablecounter : BYTE; byresponsetablemaxcounter : BYTE; uiresponsetableoverflowcounter : UINT; blocksemaphore END_STRUCT END_TYPE ST_SMIResponseTableItem TYPE ST_SMIResponseTableItem : STRUCT arrresponsedata : ARRAY [0..7] OF BYTE; bydatalength : BYTE; byidentificationbyte : BYTE; udimessagehandle : UDINT; udierrorid : UDINT; END_STRUCT END_TYPE 52 Version: 1.4 PLC Lib: Tc2_SMI

53 Appendix 5 Appendix 5.1 Example: Configuration of SMI devices TwinCAT 3 project: zip/ zip With the example it is possible to address SMI devices or to expand an existing installation. Moreover the dialogs for diagnostics and error analysis can be used. A total of 5 dialogs are available. Start Under SMI_Start is the main menu, via which the four submenus can be accessed. Control On pressing the StartScanning button, a search is made for addressed SMI devices on the SMI line. All SMI devices found are displayed in the list on the left by the manufacturer code [} 55] and the slave ID. An entry is selected by clicking it. The other buttons are always related to the selected entry. This allows all important SMI commands to be sent to every addressed SMI device. If an error is detected with an SMI command, this is indicated in the bottom right-hand corner by the error code [} 46]. PLC Lib: Tc2_SMI Version: