SPiiPlus ADK Suite v2 - 30 - 02 Release Notes
SPiiPlus ADK Suite v2 - 30 - 02 Release Notes
Suite
Release Notes
December 2016
Document Revision: 2.30.01
SPiiPlus ADK Suite Release Notes
SPiiPlus ADK Suite
Release Date: December 2016
Copyright
© ACS Motion Control Ltd.2016. All rights reserved.
Changes are periodically made to the information in this document. Changes are published as release notes and later incorporated into
revisions of this document.
No part of this document may be reproduced in any form without prior written permission from ACS Motion Control.
Trademarks
ACS Motion Control, SPiiPlus, PEG, MARK, ServoBoost, NetworkBoost and NanoPWM are trademarks of ACS Motion Control Ltd.
Windows and Visual Basic are trademarks of Microsoft Corporation.
EtherCAT is registered trademark and patented technology, licensed by Beckhoff Automation GmbH, Germany.
Any other companies and product names mentioned herein may be the trademarks of their respective owners.
Patents
ACS Motion Control Ltd. NanoPWM products are protected under the following patents:
Israel Patent No. 235022
US Patent Application No. 14/532,023
Europe Patent application No.15187586.1
Japan Patent Application No.: 2015-193179
Chinese Patent Application No.: 201510639732.X
Taiwan(R.O.C.) Patent Application No. 104132118
Korean Patent Application No. 10-2015-0137612
www.acsmotioncontrol.com
[email protected]
[email protected]
Notice
The information in this document is deemed to be correct at the time of publishing. ACS Motion Control reserves the right to change
specifications without notice. ACS Motion Control is not responsible for incidental, consequential, or special damages of any kind in
connection with using this document.
Revision History
Version 2.30.01 2
SPiiPlus ADK Suite Release Notes
Format Description
Bold Names of GUI objects or commands.
BOLD+ UPPERCASE ACSPL+ variables and commands
Monospace + grey background Code example.
Italic Names of other documents.
Blue Web pages, and e-mail addresses.
[ ] In commands indicates optional item(s)
| In commands indicates either/or items
Flagged Text
WARNING - describes a condition that may result in serious bodily injury or death.
Version 2.30.01 3
SPiiPlus ADK Suite Release Notes
Related Documents
Documents listed in the following table provide additional information related to this document as well as new
documents and updated documents as part of maintenance, which is not related to the new features of SPiiPlus
ADK Suite v2.30.
The most updated version of the documents can be downloaded by authorized users from
www.acsmotioncontrol.com/downloads.
Document Description
SPiiPlus Command & Variable Reference Guide Software manuals updated for v2.30
SPiiPlus ACSPL+ Programmer's Guide
SPiiPlus MMI Application Studio User Guide
SPiiPlus C Library Reference
SPiiPlus COM Library Reference
GSP_G&M Codes Extension to ACSPL+ Reference Guide
SPiiPlus Modbus Setup Guide
SPiiPlus Ethernet IP Guide
SPiiPlus Utilities User Guide
SPiiPlusSC Setup for Windows XP
SPiiPlusSC Silent Installation Guide
SPiiPlusSC User Guide
SPiiPlus .NET Library Reference New Software manuals for v2.30
SPiiPlusSC Setup for Windows 7, 8, 10
MC4U Control Module Hardware Guide Rev B Hardware manuals updated for v2.30
MC4U Control Module Hardware Guide Rev D
SPiiPlusNT-DC Control Module Hardware Guide 2.30B
SPiiPlusNT-DC Control Module Hardware Guide 2.30D
SPiiPlusEC Installation Guide
Felxible Configuration New Application Note for v2.30
PEG and MARK Operations Application Notes updated for v2.30
Version 2.30.01 4
SPiiPlus ADK Suite Release Notes
Table of Contents
1. Introduction 9
1.1 Document Scope 9
1.2 Product Overview 9
2. SPiiPlus ADK Suite Compatibility 10
2.1 Windows Platform Support 10
2.2 Backward Compatibility 10
2.2.1 Dedicated Mechanical Brake Outputs Behavior 11
2.3 SPiiPlus Product Support 11
3. New Feature Support Highlights 13
4. New Product Support Highlights 15
4.1 NPMpm, NPApm, NPMpc, NPApc, NPA3U NanoPWM™ technology based products 15
5. SPiiPlus Firmware 16
5.1 Axes Support 16
5.2 Buffers Support 16
5.3 Controller Cycle Time (CTIME) Support 16
5.4 Non-ACS Motion Control Devices Support 30
6. Important Requirements 36
6.1 Controller Cycle Time (CTIME) 36
6.2 EtherCAT Cable Length 36
6.3 Simultaneously Starting/Stopping All Axes Motion 36
6.4 #IR Terminal Command 36
6.5 ECREPAIR 36
6.6 PDMnt 36
6.6.1 P/D Pulses 36
6.6.2 Minimum Pulse Width 36
6.6.3 Maximum Input Current 36
6.6.4 Finding an Index for the First Time 37
6.6.5 Homing Repeatability Improvement (for SIN-COS Encoders Only) 37
6.6.6 Servo Processor Signals & SPiiPlus MMI Application Studio 37
7. XSEG Enhancements 38
8. GSP Extensions 39
9. Flexible Configuration 40
10. Enhanced Gantry, Dual Loop, and Feedback Routing 41
10.1 Enhanced Gantry Mode Support 41
10.2 Dual Loop 41
Version 2.30.01 5
SPiiPlus ADK Suite Release Notes
Version 2.30.01 6
SPiiPlus ADK Suite Release Notes
17.2 CloseSimulator 62
18. SPiiPlus User Mode Driver 64
19. SPiiPlus .NET Library 66
19.1 Specific .NET Library Features 66
20. ACSPL+ Commands & Variables 67
20.1 New ACSPL+ Commands 67
20.1.1 ECGETOPTGRP 67
20.1.2 ECGRPINFO 67
20.1.3 ECGETGRPIND 68
20.1.4 ECSAVEDCNF 68
20.1.5 ECSAVECFG 68
20.2 New ACSPL+ Variables 69
20.2.1 G_01WCS...G_12WCS 69
20.2.2 GPEXL 69
20.2.3 GUFAC 70
20.2.4 EPOS 70
20.2.5 E_AOFFS 71
20.2.6 E2_FREQ 71
20.2.7 E2_PAR_A 72
20.2.8 E2_PAR_B 73
20.2.9 E2_PAR_C 73
20.2.10 E2_PAR_D 74
20.2.11 E2_PAR_E 74
20.2.12 E2_FLAGS 75
20.2.13 E2_TYPE 76
20.2.14 E2_SCMUL 77
20.2.15 S2LABITS 77
20.2.16 SC2COFFS 78
20.2.17 SC2GAIN 78
20.2.18 SC2PHASE 79
20.2.19 SC2SOFFS 79
20.2.20 SLEBIASC 80
20.2.21 SLEBIASD 81
20.2.22 F2ACC 81
20.2.23 SLP2ROUT 81
20.2.24 SLLROUT 83
20.2.25 SLHROUT 83
Version 2.30.01 7
SPiiPlus ADK Suite Release Notes
20.2.26 SLSTHALL 84
20.2.27 STODELAY 84
20.3 Updated ACSP+ Variables 85
20.3.1 S_SETUP 85
20.3.2 E_FLAGS 85
List of Tables
Table 1. CTIME Values for MC4Unt SPiiPlusNT-LT/HP/LD/NP (Rev. D and later) Controller 17
Table 2. CTIME Values for MC4Unt SPiiPlusNT-LT/HP/LD/NP (Rev. A, B, C) Controller 18
Table 3. CTIME Values for SPiiPlusNTM Controller 19
Table 4. CTIME Values for Various Controller Units 20
Table 5. CTIME Values for SPiiPlusEC Controller 25
Table 6. CTIME Values for SPiiPlusCMhv (Rev. D1 and later) Controller 26
Table 7. CTIME Values for SPiiPlusCMhv (Rev. A - B) Controller 27
Table 8. CTIME Values for SPiiPlusCMhp (Rev. C1 and later) Controller 28
Table 9. CTIME Values for SPiiPlusCMhp (Rev A - B) Controller 29
Table 10. DS402 Qualified Drives 30
Table 11. General I/O Devices 33
Table 12. Enhanced Protection ACSPL Buffers 42
Table 13. Enhanced Protection Communication Terminal 44
Version 2.30.01 8
SPiiPlus ADK Suite Release Notes
1. Introduction
1. Introduction
1.1 Document Scope
This document describes new features and changes that were introduced since the last SPiiPlusNT Suite version
2.28 release. For a description of all common features, refer to the documentation included in the SPiiPlus ADK
Suite v2.30 installation package.
Version 2.30.01 9
SPiiPlus ADK Suite Release Notes
2. SPiiPlus ADK Suite Compatibility
Use of SPiiPlus MMI Application Studio with legacy SPiiPlus products is possible but not officially
supported.
● The new System Setup component in SPiiPlus MMI Application Stuido v2.30 impacts systems that were
configured with EtherCAT Configurator version 2.20 and lower. Modification is required only for applications
that are upgraded to firmware 2.30 and use ACSPL+ ECIN/ECOUT functions (or their equivalent in
C\COM\.NET libraries). Systems that were configured with EtherCAT Configurator versions 2.25 or 2.27 or
System Setup version 2.28 are not affected.
Version 2.30.01 10
SPiiPlus ADK Suite Release Notes
2. SPiiPlus ADK Suite Compatibility
Version 2.30.01 11
SPiiPlus ADK Suite Release Notes
2. SPiiPlus ADK Suite Compatibility
Version 2.30.01 12
SPiiPlus ADK Suite Release Notes
3. New Feature Support Highlights
Version 2.30.01 13
SPiiPlus ADK Suite Release Notes
3. New Feature Support Highlights
♦ The ability to save the Scope MMI Data file in Excel (CSV) format.
Version 2.30.01 14
SPiiPlus ADK Suite Release Notes
4. New Product Support Highlights
Version 2.30.01 15
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
5. SPiiPlus Firmware
This section outlines changes introduced into the SPiiPlus Firmware for SPiiPlus ADK Suite Version 2.30.
If the CTIME parameter is changed, then the EtherCAT network must be rescanned and the EtherCAT
Configuration file rebuilt. See System Setup in the SPiiPlusMMI Application Studio User Guide.
The following tables present the available CTIME values for the various controller units.
Version 2.30.01 16
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Table 1. CTIME Values for MC4Unt SPiiPlusNT-LT/HP/LD/NP (Rev. D and later) Controller
Default Maximum Number of
Number Simultaneously Controller Cycle Time
Number Maximum Running
of ServoBoost
Controller of Built-in Number
Available Default Supported
Drives of Axes ACSPL+ 0.50 0.25 0.20
ACSPL+ Motors 1 (msec) Value
Buffers** Buffers (msec) (msec)* (msec)*
(msec)
SPiiPlusNT (Rev. D and later) to be inserted into MC4Unt
SPiiPlus NT-LT-4 4 4 10 4 10 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-4 4 8 10 8 10 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-4 4 16 16 16 16 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-4 4 32 32 32 32 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-4 4 64 64 64 64 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-8 8 8 10 8 10 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-8 8 16 16 16 16 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-8 8 32 32 32 32 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-LT-8 8 64 64 64 64 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 -
SPiiPlus NT-HP-4 / NT-LD-4 / NT-NP-2 4 4 10 4 10 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ 0.5 √
SPiiPlus NT-HP-4 / NT-LD-4 / NT-NP-2 4 8 10 8 10 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾⁾ √ ⁽³⁾̛ ⁽⁵⁾ 0.5 √
SPiiPlus NT-HP-4 / NT-LD-4 / NT-NP-2 4 16 16 16 16 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽³⁾̛ ⁽⁵⁾ - 0.5 √
SPiiPlus NT-HP-4 / NT-LD-4 / NT-NP-2 4 32 32 32 32 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ - - 0.5 √
SPiiPlus NT-HP-4 / NT-LD-4 / NT-NP-2 4 64 64 64 64 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 √
SPiiPlus NT-HP-8 / NT-LD-8 / NT-NP-4 8 8 10 8 10 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽³⁾̛ ⁽⁵⁾ 0.5 √
SPiiPlus NT-HP-8 / NT-LD-8 / NT-NP-4 8 16 16 16 16 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽³⁾̛ ⁽⁵⁾ - 0.5 √
SPiiPlus NT-HP-8 / NT-LD-8 / NT-NP-4 8 32 32 32 32 √ ⁽⁴⁾̛ ⁽⁵⁾ √ ⁽⁴⁾̛ ⁽⁵⁾ - - 0.5 √
SPiiPlus NT-HP-8 / NT-LD-8 / NT-NP-4 8 64 64 64 64 √ ⁽⁴⁾̛ ⁽⁵⁾ - - - 1 √
⁽¹⁾ If the MPU processing power is not sufficient, then use the MC4UDC version with an external SPiiPlusNTM-yy-xx-xx-xx-xxx-H-x or SPiiPlusEC-yy-xx-xx-xx-xxx-x-x type controller.
⁽²⁾ If the MPU processing power is not sufficient, then use the UDMpm / UDMba / UDMhp / UDMhv version with an external SPiiPlusNTM-yy-xx-xx-xx-xxx-H-x or SPiiPlusEC-yy-xx-xx-xx-xxx-x-x type controller.
⁽³⁾ 2-axes Extended Segmented Motion (XSEG) with limitations: a. Segment length > 5 ms, b. IMM VEL = … command shouldn't be used
⁽⁴⁾ 6-axes Extended Segmented Motion (XSEG) with limitation: Segment length > 1 ms. The user's responsibility is to ensure that the USAGE doesn't exceed 80%.
⁽⁵⁾ NetworkBoost (Ring Topology) with limitations: a. CTIME = 1 msec - up to 64 axes b. CTIME = 0.50 msec - up to 24 axes c. CTIME = 0.25 msec - up to 8 axes d. CTIME = 0.20 msec - up to 4 axes
Version 2.30.01 17
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 18
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 19
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 20
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 21
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 22
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 23
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 24
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 25
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 26
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 27
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 28
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 29
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 30
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 31
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 32
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 33
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Version 2.30.01 34
SPiiPlus ADK Suite Release Notes
5. SPiiPlus Firmware
Using non-ACS Motion Control products within an ACS Motion Control network requires purchasing a
special license, and pre-loading the master accordingly. Any attempt to operate the network with
non-ACS Motion Control products without having the above options activated will prevent any
network operation.
Version 2.30.01 35
SPiiPlus ADK Suite Release Notes
6. Important Requirements
6. Important Requirements
The SPiiPlus product line currently has the following requirements:
6.5 ECREPAIR
The ECREPAIR function can take a long time to complete; therefore it is recommended calling the function from a
Program Buffer. It is possible to enter ECREPAIR in the SPiiPlus MMI Application Studio Communication Terminal;
however, in this case, the controller’s COMMUNICATION TIMEOUT property has to be increased to 300 seconds
and returned to its operational value when the command terminates its action (otherwise, a Timeout error
occurs).
6.6 PDMNT
PDMNT controllers only support a single step width for all 4 axes. The STEPW value for all 4 PDMNT axes should be
set to the same value. Setting different STEPW values to the axes results in at least one axis using an incorrect step
width value.
6.6.1 P/D Pulses
P/D does not send all the pulses that the firmware sends. Even if a sophisticated mechanism is implemented to
make sure that DISABLE only comes into effect after all counted firmware pulses are sent, the motor itself will still
be “off” by a few counts as a result of inertia. When the using DISABLE during motion, there is no way to avoid a
certain drift between the position in the firmware and actual motor position.
6.6.2 Minimum Pulse Width
The minimum pulse width is limited by the software to 120 ns.
6.6.3 Maximum Input Current
The maximum input current is 17 mA.
Version 2.30.01 36
SPiiPlus ADK Suite Release Notes
6. Important Requirements
Version 2.30.01 37
SPiiPlus ADK Suite Release Notes
7. XSEG Enhancements
7. XSEG Enhancements
A new 6-axes extension provides the ability to add up to four axes to the existing two main axes in XSEG motion.
The main axes are called primary axes and the additional axes are called secondary axes.
The primary axes supports the full look-ahead functionality which exists for 2-axes XSEG.
The secondary axes are provided some limited functionality and are treated as additional to the primary axes.
The 6-axes extension provides the ability to handle different multi-axes operations such as those encountered in
CNC and laser cutting applications.
Version 2.30.01 38
SPiiPlus ADK Suite Release Notes
8. GSP Extensions
8. GSP Extensions
The following new features are introduced in this version:
● 6-Axes Concurrent Synchronous Motion with Look-Ahead Capabilities
● Alternative Feed Rate Specification as Time per a Motion Segment
● Cylindrical Interpolation
● Workpiece Coordinate System
● Block Execution Indication
● Inch/Metric Mode
● Feedrate Override
The following new ACSPL+ variables were added to support this feature:
● G_01WCS...G_12WCS
● GPEXL
● GUFAC
Version 2.30.01 39
SPiiPlus ADK Suite Release Notes
9. Flexible Configuration
9. Flexible Configuration
Flexible configuration enables an expansion, reduction, or topology change for a network without reconfiguration
of the system and not requiring application changes.
Single or Multiple configurations are defined using the System Setup tool, for more details see SpiiPlus MMI
Application Studio User Guide.
Transitions between predefined configurations require your approval.
Flexible Configuration is compatible with the NetworkBoost.
In addition, it can be used with EtherCAT Junctions. The EtherCAT Junctions enable the using “star topology”, or
"tree topology" which might be useful when using the Flexible Configuration future.
Version 2.30.01 40
SPiiPlus ADK Suite Release Notes
10. Enhanced Gantry, Dual Loop, and Feedback Routing
Version 2.30.01 41
SPiiPlus ADK Suite Release Notes
11. Enhanced Application Protection
Version 2.30.01 42
SPiiPlus ADK Suite Release Notes
11. Enhanced Application Protection
Version 2.30.01 43
SPiiPlus ADK Suite Release Notes
11. Enhanced Application Protection
Version 2.30.01 44
SPiiPlus ADK Suite Release Notes
12. The Safe Torque Off (STO)
12.1 STODELAY
In version 2.30, the following new ACSPL+ variable has been added:
● STODELAY
A new variable STODELAY allows to set the delay time between the STO fault indication and the default disable
response to such event. The default value is 50 msec. The range is [0, 200]. During this time the user can activate
his own response (auto-routine) to kill the motion.
12.2 SAFIN
SAFIN(<axis>).17 (#STO1) and SAFIN(<axis>).18 (#STO2) present the status of STO inputs.
Version 2.30.01 45
SPiiPlus ADK Suite Release Notes
12. The Safe Torque Off (STO)
12.3 SAFINI
Inversion of STO inputs is NOT supported.
12.4 FAULT
FAULT(<axis>).18 (#STO) presents the STO fault status.
FAULT(<axis>).#STO indicates STO fault immediately, while the default (and the only one allowed) response
(DISABLE <axis>) will be followed after STODELAY period.
The user can write an auto-routine to kill the motion during the STODELAY period .
12.5 FMASK
FMASK(<axis>).18 (#STO) allows to enable / disable STO fault inspection.
By default, inspection of the STO fault will be ON. In existing applications, STO fault inspection is turned OFF for
backward compatibility reasons. The user can turn ON the STO fault inspection by setting FMASK(<axis>).18 (#STO)
bit to 1.
12.6 FDEF
FDEF(<axis>).18 (#STO) always is ON. The default response to the STO fault should always be used.
The user can write an auto-routine to kill the motion during the STODELAY period .
12.7 SAFETYCONF
SAFETYCONF does not allow to change the default (DISABLE <AXIS>) response to the STO fault.
SETCONF(92, <index>, <operation>) will allow to route STO inputs to any of the 8 general purpose inputs of the
MC4U.
<index> - AAIINNOO (decimal)
AA - axis
II - safety input
NN - digital input index
OO - digital input bit
<operation> - (0) - cancel assignment, (1) – assign
Version 2.30.01 46
SPiiPlus ADK Suite Release Notes
12. The Safe Torque Off (STO)
For example:
To assign STO1 signal (SAFIN(<axis>).#STO1 - bit 17) of axis 5 to IN(2).6 the following command should be
executed:
SETCONF(92, 05170206)
To assign STO2 signal (SAFIN(<axis>).#STO2 - bit 18) of axis 5 to IN(2).7 the following command should be
executed:
SETCONF(92, 05180207)
Version 2.30.01 47
SPiiPlus ADK Suite Release Notes
13. "Hardware Emergency Stop" Input
13.1 SAFIN
SAFIN(<AXIS>).28 (#ES) will present the status of “Hardware Emergency Stop” input of the network unit that
<axis> is associated with.
13.2 SAFINI
SAFINI(<AXIS>).28 (#ES) will allow to invert the “Hardware Emergency Stop” input of the network unit that <axis>
is associated with.
13.3 S_SAFIN
No changes (backward compatible).
13.4 S_SAFINI
No changes (backward compatible).
13.5 FAULT
No changes (backward compatible).
13.6 S_FAULT
S_FAULT.#ES will present an aggregated fault of all “Hardware Emergency Stop” inputs by taking into account its
inversion.
13.7 S_FMASK
No changes, S_FMASK.#ES remains as a system level fault inspection (backward compatible).
13.8 S_FDEF
No changes, S_FDEF.#ES remains as a system level default response to fault (backward compatible).
Version 2.30.01 48
SPiiPlus ADK Suite Release Notes
14. "Component Failure" Input
Version 2.30.01 49
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 50
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 51
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
To stop highlighting the optional group user selects either “Undo highlighting optional group” from the right click
menu, or highlights another optional group. Only one optional group can be highlighted at the same time.
Version 2.30.01 52
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 53
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 54
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 55
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
3. Custom Protection
There are three tasks that can be performed from the Custom Protection window:
■ You can set the program in the specified buffers such that its contents cannot be modified and/or cannot
be seen.
Version 2.30.01 56
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
■ You can set specified variables to Read Only, that is, it can be viewed but cannot be modified.
Version 2.30.01 57
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
15.6 Scope
The MMI scope user interface now has the following features.
● The ability to set Y axis limits to each scope signal.
● The ability to save the Scope MMI Data file in Excel (CSV) format.
Version 2.30.01 58
SPiiPlus ADK Suite Release Notes
15. SPiiPlus MMI Application Studio
Version 2.30.01 59
SPiiPlus ADK Suite Release Notes
16. SpiiPlus C Library
16.1 acsc_OpenCommSimulator
Description
The function executes the SPiiPlus stand-alone simulator via SPiiPlus User Mode Driver in case it is not running.
The function connects to the simulator via TCP/IP protocol.
Syntax
HANDLE acsc_OpenCommSimulator()
Return value
If the function succeeds the return value is a HANDLE that is used as a standing connection to the simulator.
If the function fails return value is ACSC_INVALID (-1) and an appropriate error is set.
Error codes (in case of failure)
ACSC_SIMULATOR_RUN_EXT – if the ports set for simulator in SPiiPlus User Mode Driver are taken by another
application.
ACSC_SIMULATOR_NOT_SET – in case a simulator execution attempt was made without setting a simulator
executable and default simulator executable was not found
Example
// open communication (and open if needed) with SPiiPlus simulator
HANDLE Handle = acsc_OpenCommSimulator();
if (Handle == ACSC_INVALID)
{
printf("error opening communication: %d\n", acsc_GetLastError());
}
16.2 acsc_CloseSimulator
Description
The function Stops the SPiiPlus simulator via SPiiPlus User Mode Driver in case it is running.
Syntax
int acsc_CloseSimulator ()
Return value
If the function succeeds: return value =1.
In the case of function failure: return value =0.
Version 2.30.01 60
SPiiPlus ADK Suite Release Notes
16. SpiiPlus C Library
Version 2.30.01 61
SPiiPlus ADK Suite Release Notes
17. SPiiPlus COM Library
17.1 OpenCommSimulator
Description
The method executes the SPiiPlus stand-alone simulator via SPiiPlus User Mode Driver in the case that it is not
running.
The function connects to the simulator via TCP/IP protocol.
Syntax
object.OpenCommSimulator()
Error codes (in case of failure)
Code 133 – if the ports set for simulator in SPiiPlus User Mode Driver are taken by another application.
Code 136 – in case a simulator execution attempt was made without setting a simulator executable and default
simulator executable was not found.
Example
Sub OpenCommSimulator_Sample()
On Error GoTo except
'Open Ethernet with TCP protocol
'communication with the SPiiPlus simulator
Call Ch.OpenCommSimulator()
Exit Sub
except:
MyErrorMsg 'See Error Handling in Visual Basic
End Sub
17.2 CloseSimulator
Description
The method stops the SPiiPlus Simulator via SPiiPlus User Mode Driver in the case it is running.
Syntax
object.CloseSimulator()
Error codes (in case of failure)
Code 131 - in case an attempt to stop simulator was made without it running in the first place.
Example
Sub CloseSimulator_Sample()
On Error GoTo except
'Open Ethernet with TCP protocol
'communication with the SPiiPlus simulator
Call Ch.CloseSimulator()
Exit Sub
Version 2.30.01 62
SPiiPlus ADK Suite Release Notes
17. SPiiPlus COM Library
except:
MyErrorMsg 'See Error Handling in Visual BasicEnd Sub
Version 2.30.01 63
SPiiPlus ADK Suite Release Notes
18. SPiiPlus User Mode Driver
Version 2.30.01 64
SPiiPlus ADK Suite Release Notes
18. SPiiPlus User Mode Driver
The parameters input into the setup procedure are stored for future executions of the SPiiPlus User
Mode Driver.
In case the simulator cannot be run because ports are occupied or the simulator executable has not
been set an error message will be displayed.
Version 2.30.01 65
SPiiPlus ADK Suite Release Notes
19. SPiiPlus .NET Library
Version 2.30.01 66
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
20.1.1 ECGETOPTGRP
Description
The function returns number of actually connected optional groups, not including the mandatory group.
Syntax
ECGETOPTGRP()
Arguments
None.
Return Value
Returns number of actually connected optional groups, not including the mandatory group.
Example:
?ecgetoptgrp()
2
20.1.2 ECGRPINFO
Description
The function fills array with nodes’ indexes which are members of a given optional group. In addition, it returns the
number of members in the group.
Syntax
ECGRPINFO(group_index, nodes_array)
Arguments
Return Value
Returns the number of the members in the specified optional group.
Example:
int nodes(5)
I0=ecgrpinfo(1,nodes) ! returns number of nodes in optional group 1
! nodes array is filled with: {0,-1,0,0,0}
Version 2.30.01 67
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
20.1.3 ECGETGRPIND
Description
The function returns an array that contains optional groups’ indexes that are part of the current configuration
(including mandatory group, which is 0). The array ends with {-1}.
Syntax
ECGETGRPIND(groups_array)
Arguments
groups_array Array of type INT, filled with groups’ indexes. {-1} marks the end.
Return Value
None.
Example:
int groups(5)
ecgetgrpind(groups) ! groups array is filled with: {0,1,-1,0,0},
!meaning that there is one optional group (with index 1) defined in the
actual system.
20.1.4 ECSAVEDCNF
Description
The function returns array that contains optional groups’ indexes that are part of the last saved configuration
(including mandatory group, which is 0). The array ends with {-1}.
Syntax
ECSAVEDCNF(groups_array)
Arguments
groups_array Array of type INT, filled with groups’ indexes. {-1} marks the end.
Return Value
None.
Example:
int groups(5)
ecsavedcnf(groups) ! groups array is filled with: {0,1,-1,0,0},
>!meaning that there is one optional group (with index 1) in the last saved
configuration.
20.1.5 ECSAVECFG
Description
Extension of already existing command.
The command saves to flash an array of optional groups based on current configuration, based on ecgetgrpind()
function. For example, actual configuration that contains 1 optional group will be represented as: {0,1,-1}. This
Version 2.30.01 68
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
array will be read upon power-up of the controller. Actual configuration will be checked against the approved
configuration. If not identical, error 6016, “The actual network configuration doesn’t match the last approved
configuration.”, is displayed.
Syntax
ECSAVECFG
Arguments
None
Return Value
None.
Example:
ecsavecfg
20.2.1 G_01WCS...G_12WCS
Description
G_01WCS to G_012WCS are each a real array, with one element for each axis in the system (up to 9 axes). Each is
used for defining one of the 12 work-piece coordinate systems a user can set as part of the CNC
setup/configuration. During the execution of a GSP program, a user can select one of them to work. If user choses
going back to work in the Machine Coordinate System, he can then chose to clear it.
Syntax
N/A
Arguments
N/A
Tag
284…295
Accessibility
Read Only
COM Library Methods
ReadVariable
C Library Functions
acsc_ReadReal
20.2.2 GPEXL
Description
GPEXL is an integer array, with one element for each program buffer in the system. It indicates the GSP program
executed block. If block executes motion then GPEXL will indicate this line till this motion completion.
Version 2.30.01 69
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Syntax
N/A
Arguments
N/A
Tag
296
Accessibility
Read Only
COM Library Methods
ReadVariable
C Library Functions
acsc_ReadInteger
20.2.3 GUFAC
Description
GUFAC is a real array, with one element for each program buffer in the system. Each entry in the array holds the
value a conversion factor, from 'Common Physical Units' in [mm] to 'Controller Units' (In the world of ACSPL+,
those 'Controller Units' are sometimes related to as 'User Units'). As part of GSP modality data, default value of
GUFAC is 1.0 for all buffers.
Syntax
N/A
Arguments
N/A
Tag
298
Accessibility
Read-Write
COM Library Methods
ReadVariable
C Library Functions
acsc_ReadReal
20.2.4 EPOS
Description
EPOS is a real array, one element for each feedback, and is used for showing the encoder feedback. Not affected
by Gantry mode.
Version 2.30.01 70
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Comments
EPOS value is affected by ACSPL+ SET command only when applied to FPOS variable with the same index (a
relevant offset is being added to EPOS value).
EPOS variable can be useful for displaying the encoder position in Gantry mode.
Tag
299
Accessibility
Read only
Com Library Methods
ReadVariable
C Library Functions
acsc_ReadInteger
20.2.5 E_AOFFS
Description
E_AOFFS is an integer array, with one element for each axis in the system, and is used for setting user-defined
offset for absolute encoder.
Comments
Modifying E_AOFFS causes absolute encoder initialization.
The EOFFS variable is being modified according to E_AOFFS’ value:
EOFFS=EOFFS-E_AOFFS.
Tag
300
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.6 E2_FREQ
Description
E2_FREQ is an integer array, with one element for each axis in the system, and is used for defining the maximum
encoder pulse frequency (in MHz) for secondary feedback.
Syntax
E2_FREQ(axis_index)=value
Version 2.30.01 71
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value Value of each member can be one of the following:
● 2 (shown as 2MHz but practically is 2.5 MHz, default for an analog Sin-Cos encoder)
● 20 (default for a digital encoder)
● 60
Tag
303
Comments
The encoder is represented in the controller as a synchronous machine that is activated by a clock, with
programmable frequency in the SPiiPlus processor.
E2_FREQ provides three optional clock rates that define the maximum encoder pulse frequency (in MHz)
measured after an internal 4x multiplication.
In general, using a higher E2_FREQ enables to read a higher rate of encoder input. However, the electrical noise
immunity is reduced and Encoder Error FAULT might occur. Per case, it is recommended to use the lowest
possible E2_FREQ that does not generate an Encoder Error FAULT. In case of an Encoder Error, FCLEAR(axis_
index) command should be executed and a higher E2_FREQ value should be set.
For more information, see the Encoder Input Clock section in the SPiiPlus Setup Guide.
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.7 E2_PAR_A
Description
E2_PAR_A is used for setting the encoder data transmission actual frequency in MHz. it is a double array, with one
element for each axis in the system. Used for Secondary Feedback.
Syntax
E2_PAR_A (axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value The encoder data transmission actual frequency in MHz ranging from 1.25 to 10.
Tag
304
Accessibility
Read-Write
Version 2.30.01 72
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
20.2.8 E2_PAR_B
Description
E2_PAR_B is used for setting the encoder data control CRC code. it is an integer array, with one element for each
axis in the system. Used for Secondary Feedback.
Syntax
E2_PAR_B (axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value The encoder data control CRC ranging from 0 to 255.
Tag
305
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.9 E2_PAR_C
Description
E2_PAR_C is used for setting the interval (in microseconds) of encoder position reading. it is an integer array, with
one element for each axis in the system. Used for Secondary Feedback. The default value is 0 which means 50
microseconds.
Syntax
E2_PAR_C (axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value The interval of encoder position reading in microseconds valid range [0,..3]
Valid Values
0 50 microseconds (default)
1 100 microseconds
Version 2.30.01 73
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
2 200 microseconds
3 400 microseconds
Tag
306
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.10 E2_PAR_D
Description
E2_PAR_D defines number of status bits (LSB) in the real-time position data. The status bits include warning and
error bits. These bits are not part of the real-time position. it is an integer array, with one element for each axis in
the system. Used for Secondary Feedback. The default value is 0 which means no status bits at all. Maximum value
is 16.
Syntax
E2_PAR_D (axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value Number of status bits; the range is [0,16].
Tag
307
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.11 E2_PAR_E
Description
E2_PAR_E defines a mask for setting error bits. It is an integer array, with one element for each axis in the system.
Used for the secondary feedback.The default value is 0, which means no encoder error will be triggered. All bits
that are not set in the mask but covered by E2_PAR_D are defined as warning bits.
Version 2.30.01 74
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Syntax
E2_PAR_E (axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value Error bits MASK; minimum value is 0 (default – no error bits). The range is [0,2E2_PAR_D-1]
Tag
308
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.12 E2_FLAGS
Description
E2_FLAGS is an integer array, with one element for each axis in the system. Used for the secondary feedback. Each
element contains different configuration bits for absolute encoder, in current version it includes 3 bits.
E2_FLAGS Bit Description
axis The specific axis index. Valid numbers are: 0,1… up to the number of axes in the
system, minus 1.
bit_designator The meanings of bit_designator are defined in the table above.
Tag
268
Comments
The bits applies for all types of encoders.
Version 2.30.01 75
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
The bit change event causes the FW to reinitialize the absolute encoder.
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.13 E2_TYPE
Description
E2_TYPE is an integer array, with one element for each axis in the system, and is used for defining the encoder
type for the secondary feedback.
Syntax
E2_TYPE(axis_index)=value
Arguments
axis Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus 1.
value value of each member can be one of the following:
● 0 – not defined
● 1 - Clock direction counter
● 2 - Quadrature single-ended encoder
● 3 - Quadrature encoder (Default)
● 4 - 250 KHz / 500 KHz Sin-Cos encoder multiplier
● 5 - HSSI encoder
● 9 - Resolver
● 10 - EnDat 2.2
● 11 - Smart-Abs
● 12 - Panasonic
● 13 - BiSS-C
● 14 – Hiperface
● 17 - SSI
● 18 - 10 MHz Sin-Cos encoder multiplier
● 19 – Sanyo Denki
Tag
31
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
Version 2.30.01 76
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
20.2.14 E2_SCMUL
Description
E2_SCMUL is an integer array, with one element for each axis in the system, and is used for specifying the Sin-Cos
multiplication factor for the encoder. Used for secondary feedback.
Syntax
E2_SCMUL (axis_index)=value
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value Value ranges from 2 to 16, default=10.
Tag
30
Comments
E2_SCMUL specifies the Sin-Cos multiplication factor as a power of 2. The maximum value of 16 corresponds to a
multiplication of 65536 = 216. The minimum value of 2 corresponds to a
multiplication of 4 = 22
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.15 S2LABITS
Description
S2LABITS is an integer array, with one element for each axis in the system, and is used for setting the total number
of absolute position bits for an absolute encoder connected to a secondary feedback.
Syntax
S2LABITS(axis_index)=value
Comments
S2LABITS is used for setting the total number of absolute position bits for an absolute encoder. This is the sum of
the multi-turn resolution bits and the turn resolution bits. For example, for an encoder with 17 bits turn resolution
and 16 bits multi-turn resolution, SLABITS should be set to 33.
Tag
310
Version 2.30.01 77
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Accessibility
Read-Write
Com Library Methods
ReadVariable, Write Variable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.16 SC2COFFS
Description
SC2COFFS is a real array, with one element for each axis in the system, and is used for defining the Sin-Cos Cosine
offset. Used for secondary feedback.
Syntax
SC2COFFS (axis_index)=value
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value value designates the offset ranging from -32766 to 32766.
Tag
311
Comments
The digital range corresponds to ±0.5 Volts. This number is used to modify the offset of the Sin-Cos encoder signal
related to the axis. The ratio between this number and the offset is 9.6.
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.17 SC2GAIN
Description
SC2GAIN is a real array, with one element for each axis in the system, and is a Sin-Cos encoder gain compensation
variable used to compensate the Cosine signal for an improper amplitude relative to the Sine signal. Used for
secondary feedback.
Syntax
SC2GAIN (axis_index)=value
Version 2.30.01 78
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value value ranges between 0.5 and 1.5; Default: 1.
Tag
312
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.18 SC2PHASE
Description
SC2PHASE is a real array, with one element for each axis in the system, and is a Sin-Cos encoder phase
compensation variable and is used to compensate the Cosine signal for an improper phase difference relative to
the Sine signal. Used for Secondary Feedback.
Syntax
SC2PHASE (axis_index)=value
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value value in degrees, the value ranges between -15 and 15; default is 0.
Tag
313
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.19 SC2SOFFS
Description
SC2SOFFS is a real array, with one element for each axis in the system, and is used for defining the Sin-Cos Sine
offset. Used for secondary feedback.
Version 2.30.01 79
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Syntax
SC2SOFFS (axis_index)=value
Arguments
axis_index Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system
minus 1.
value value designates the offset ranging from -32766 to 32766.
Tag
314
Comments
The digital range corresponds to ±0.5 Volts. This number is used to modify the offset of the Sin-Cos encoder signal
related to the axis. The ratio between this number and the offset is 9.6.
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.20 SLEBIASC
Description
SLEBIASC is a real array, with one element for each axis in the system, and is used for defining the Sin-Cos
encoder’s hardware compensation for the Sine offset. Used for secondary feedback.
Syntax
SLEBIASC (axis_index)=value
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value value designates the offset ranging from -50 to 50; default: 0.
Tag
315
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
Version 2.30.01 80
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.21 SLEBIASD
Description
SLEBIASD is a real array, with one element for each axis in the system, and is used for defining the Sin-Cos
encoder’s hardware compensation for the Cosine offset. Used for secondary feedback.
Syntax
SLEBIASD (axis_index)=value
Arguments
axis_ Designates the specific axis, valid numbers are: 0,1,2,… up to the number of axes in the system minus
index 1.
value value designates the offset ranging from -50 to 50; default: 0.
Tag
316
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.2.22 F2ACC
Description
F2ACC is a real array, with one element for each axis in the system, and is used for defining the feedback
acceleration value of the axis. Used for secondary feedback.
Tag
317
Accessibility
Read-Only
Com Library Methods
ReadVariable
C Library Functions
acsc_ReadReal
20.2.23 SLP2ROUT
SPL2ROUT is a new ACSPL+ variable for setting the feedback routing of the secondary feedback position.
Version 2.30.01 81
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Description
SLP2ROUT is an integer array, one element for each axis in the system, and is used for setting the feedback routing
of the secondary feedback position for the specified axis.
Syntax
SLP2ROUT(<axis>)=value
Arguments
The value values and the feedback sources associated with them are given below. The default value is 0.
Value F2POS
0 Secondary Feedback is not used
001 From channel 0 quadrature position or Absolute Encoder position
002 From channel 0 SINCOS position
003 From channel 0 HSSI position101
004 From analog input 0
005 From channel 0 resolver position
101 From channel 1 quadrature position or Absolute Encoder position
102 From channel 1 SINCOS position
103 From channel 1 HSSI position
104 From analog input 1
105 From channel 1 resolver position
201 From channel 2 quadrature position or Absolute Encoder position
202 From channel 2 SINCOS position
203 From channel 2 HSSI position304
204 From analog input 2
205 From channel 2 resolver position
301 From channel 3 quadrature position or Absolute Encoder position
302 From channel 3 SINCOS position
303 From channel 3 HSSI position
304 From analog input 3
305 From channel 3 resolver position
Comments
SLP2ROUT variable can be used for routing when applied on secondary feedback only.
Tag
301
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
Version 2.30.01 82
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
20.2.24 SLLROUT
HW Limits Routing is available using a new ACSPL+ variable: SLLROUT
Description
SLLROUT is an integer array, with one element for each axis in the system, and is used for setting the HW limits
routing for the specified axis.
Syntax
SLLROUT(<axis>)=value
Arguments
Value HW Limits
0 According to SLPROUT
001 From channel 0
101 From channel 1
201 From channel 2
301 From channel 3
Comments
If SLLROUT(<axis>)=0, the routing is being done according to SLPROUT. In particular, if SLPROUT(<axis>)=0, the HW
limits are being taken from the axis itself.
Tag
318
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.25 SLHROUT
Hall Routing is available using a new ACSPL+ variable: SLHROUT
Description
SLHROUT is an integer array, with one element for each axis in the system, and is used for setting the Hall state
routing for the specified axis.
Syntax
SLHROUT(<axis>)=value
Value SLSTHALL
0 Default
001 From channel 0
Version 2.30.01 83
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Value SLSTHALL
101 From channel 1
201 From channel 2
301 From channel 3
Comments
Hall state is an integer number within the range [0,5]. Getconf(262,<index>) returns Hall state of axis with index
<index>. If SLHROUT(<index>) is not 0, Getconf(262,<index>) returns the hall state of the channel based on the
table defined above.
Tag
302
Accessibility
Read-Write
Com Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadInteger, acsc_WriteInteger
20.2.26 SLSTHALL
Description
SLSTHALL is an integer array, with one element for each axis in the system, and is used for getting the hall state of
each axis.
The value is an integer number, in range of {-1,5}. -1 means invalid hall state.
Comments
The SLSTHALL variable’s value is being updated every cycle.
Tag
196
Accessibility
Read only
Com Library Methods
ReadVariable
20.2.27 STODELAY
Description
STODELAY is a real array, with one element for each axis in the system. It is used to configure the delay time
between the STO fault indication and the default response (disable) to the fault. During this time the user can
activate his own response (auto-routine) to kill the motion.
Syntax
STODELAY(axis) = value
Version 2.30.01 84
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Arguments
axis The specific axis index. Valid numbers are: 0,1… up to the number of axes in the system,
minus 1.
value The value is the delay time between the STO fault indication and the default response (dis-
able) to the fault. value can range between 0 (minimum) to 200 (maximum). The default is
50.
Tag
319
Accessibility
Read-Write
COM Library Methods
ReadVariable, WriteVariable
C Library Functions
acsc_ReadReal, acsc_WriteReal
20.3.1 S_SETUP
The following bit was added:
20.3.2 E_FLAGS
ACSPL+ variable E_FLAGS introduces a new bit, #INVERSE, which defines the Encoder Direction Inverse.
Version 2.30.01 85
SPiiPlus ADK Suite Release Notes
20. ACSPL+ Commands & Variables
Changing this bit may require changing the drive polarity (MFLAGS bit 13) or repeat commutation.
In case of a brushless motor, after the bit is changed the commutation will no longer be correct and the user
should repeat the Adjuster commutation.
In case of a brush motor, the user should re-verify the drive polarity in the Adjuster by running Open Loop
Verification.
Failure to repeat the Adjuster Commutation and Open Loop Verification may result critical position
error, over current faults and in certain cases motor run away.
Version 2.30.01 86
1 Hataasia St
Ramat Gabriel Industrial Park
Migdal Ha’Emek 2307037 Israel
Tel: (+972) (4) 654 6440 Fax: (+972) (4) 654 6443