Softmotion Library - SMB MAT-LC-C Series User Manual

I.4

SoftMotion library

SM3_Basic Library
This library is the base library for CODESYS SoftMotion applications, so it must be included in
the SoftMotion project. This will happen automatically when a SoftMotion device is plugged in.
The library provides the following function blocks and functions:
● PLCopen function block allows both single-axis motion control and two-axis synchronous
motion. In addition to the library elements for status checking, parameterization and general
operation, there are function blocks for driving the axis with defined velocity, acceleration
parameters. There are also modules for synchronizing master, slave and drive shafts.
● DriveInterface basic driver function blocks (AXIS_REF_SM3, AXIS_REF_VIRTUAL_SM3,
AXIS_REF_MAPPING_SM3)
● Utility functions such as file serving and error reporting
● A function block or implementation of a specific drive driver, an extension of the basic drive
function block. These special driver function blocks (named AXIS_REF_*) are usually included in
a separate library that is referenced by the corresponding device description for this device.
The function blocks are organized as follows:
● Drive interface
Instruction Name
AXIS_REF
● Data types, global variables
Instruction Name
MC_DIRECTION
MC_TAPPETMODE
SMC_BRAKESETSTATE
SMC_CAMTAPPETACTION
SMC_CAMTAPPETTYPE
This driver interface is a function block. It is provided by the
"SM3_Basic.library" library and includes work as a driver.
Each SoftMotion axis
AXIS_REF_SM3 instance.
It is used as input to several function blocks and specifies
the direction of movement. Note that not all modes are
available for all function blocks and axis types
(modulo/finite).
It is used in the function block MC_DigitalCAMSwitch to
determine whether the tappet value should refer to the
spindle setpoint (1), or the actual position (2). In the case of
automatic detection (0), the decision of the function block
depends on whether the control state of the drive uses the
setpoint (bRegulatorOn = TRUE) or the actual value
(bRegulatorOn = FALSE).
It is used in the function block SMC3_BrakeControl and
determines how the drive sets the mechanical brake.
It determines which switching actions are performed when
the cam has been passed.
It is used to determine which direction the cam must go in
order to be activated.
162
Function
is an extension
Funcation
of the