Dynamic Link Library (DLL )
Communication Reference Guide
P94DLL01A
About These Instructions
This documentation applies to the implementation of DLL with the PositionServo drive and should be used
in conjunction with the PositionServo User Manual (S94P01) that shipped with the drive. These documents
should be read carefully as they contain important technical data and describe the installation and operation of the drive. This manual describes the use of DLL with the PositionServo drives. It contains information for anyone who participates in the evaluation of or design of a distributed motion control system. The
user should have prior knowledge of motion control, networks and software development.
Copyright ©2007 by AC Technology Corporation.
All rights reserved. No part of this manual may be reproduced or transmitted in any form without written
permission from AC Technology Corporation. The information and technical data in this manual are subject
to change without notice. AC Tech makes no warranty of any kind with respect to this material, including,
but not limited to, the implied warranties of its merchantability and fitness for a given purpose. AC Tech
assumes no responsibility for any errors that may appear in this manual and makes no commitment to
update or to keep current the information in this manual.
MotionView®, PositionServo®, and all related indicia are either registered trademarks or trademarks of
Lenze AG in the United States and other countries.
Microsoft Windows®, Visual Basic®, Visual C++® and all related indicia are registered trademarks of the
Microsoft Corporation in the United States and other countries.
This document printed in the United States of America
2
P94DLL01A
Table of Contents
1. Safety Information ............................................................................ 4
1.1 Warnings, Cautions & Notes ...................................................................4
1.2 Reference Documents .........................................................................5
2. PositionServo DLL Overview ............................................................. 6
3 Files in the DLL Library .....................................................................
4 Communication Flowchart ................................................................
5 DLL Functions Overview ...................................................................
6 Return Codes .............................................................................
7 DLL Functions Usage Examples ........................................................
8 DLL Functions .............................................................................
8.1 Connection Services Functions ...............................................................9
8.2 Data Manipulation Functions ................................................................10
6
7
8
8
8
9
P94DLL01A
3
1. Safety Information
1.1 Warnings, Cautions & Notes
General
Some parts of Lenze controllers (frequency inverters, servo inverters, DC controllers) can be live, with the
potential to cause attached motors to move or rotate. Some surfaces can be hot.
Non-authorized removal of the required cover, inappropriate use, and incorrect installation or operation
creates the risk of severe injury to personnel or damage to equipment.
All operations concerning transport, installation, and commissioning as well as maintenance must be carried out by qualified, skilled personnel (IEC 364 and CENELEC HD 384 or DIN VDE 0100 and IEC report 664
or DIN VDE0110 and national regulations for the prevention of accidents must be observed).
According to this basic safety information, qualified skilled personnel are persons who are familiar with
the installation, assembly, commissioning, and operation of the product and who have the qualifications
necessary for their occupation.
Application as directed
Drive controllers are components which are designed for installation in electrical systems or machinery.
They are not to be used as appliances. They are intended exclusively for professional and commercial
purposes according to EN 61000-3-2. The documentation includes information on compliance with the EN
61000-3-2.
When installing the drive controllers in machines, commissioning (i.e. the starting of operation as directed)
is prohibited until it is proven that the machine complies with the regulations of the EC Directive 98/37/EC
(Machinery Directive); EN 60204 must be observed.
Commissioning (i.e. starting of operation as directed) is only allowed when there is compliance with the
EMC Directive (89/336/EEC).
The drive controllers meet the requirements of the Low Voltage Directive 73/23/EEC. The harmonised
standards of the series EN 50178/DIN VDE 0160 apply to the controllers.
The availability of controllers is restricted according to EN 61800-3. These products can cause
radio interference in residential areas.
Installation
Ensure proper handling and avoid excessive mechanical stress. Do not bend any components and do not
change any insulation distances during transport or handling. Do not touch any electronic components and
contacts.
Controllers contain electrostatically sensitive components, which can easily be damaged by inappropriate
handling. Do not damage or destroy any electrical components since this might endanger your health!
Electrical connection
When working on live drive controllers, applicable national regulations for the prevention of accidents (e.g.
VBG 4) must be observed.
The electrical installation must be carried out according to the appropriate regulations (e.g. cable crosssections, fuses, PE connection). Additional information can be obtained from the national regulation documentation. In the United States, electrical installation is regulated by the National Electric Code (nec) and
NFPA 70 along with state and local regulations.
4
P94DLL01A
Operation
Systems including controllers must be equipped with additional monitoring and protection devices according to the corresponding standards (e.g. technical equipment, regulations for prevention of accidents, etc.).
You are allowed to adapt the controller to your application as described in the standards documentation.
DANGER!
• After the controller has been disconnected from the supply voltage,
do not touch live components or power connection until capacitors can
discharge. Wait at least 3 minutes before servicing the drive Please
observe the corresponding notes on the controller.
• Do not continuously cycle input power to the controller more than once
every three minutes.
• Please close all protective covers and doors during operation.
WARNING!
Network control permits automatic operation of the inverter drive. The
system design must incorporate adequate protection to prevent personnel from accessing moving equipment while power is applied to the
drive system.
Pictographs used in these instructions:
Pictograph Signal Word Meaning Consequence if Ignored
DANGER!
WARNING!
STOP!
NOTE
Warning of Hazardous Electrical
Voltage.
Impending or possible danger to
personnel
Possible damage to equipment Damage to drive system or its
Useful tip: If note is observed, it
will make using the drive easier
1.2 Reference Documents
• PositionServo Programming Manual: PM94P01
• PositionServo User Manual: S94P01C
• MotionView Software Manual: IM94MV01A
Reference to an imminent danger that may result in death or
serious personal injury if the
corresponding measures are
not taken.
Death or injury
surroundings
Refer to: http://www.actech.com
P94DLL01A
5