LinearX LT360 Manuale del proprietario

LT360 Precision Turntable

DLL Programming Manual

Precision Turntable

2LT360 Precision Turntable

DLL Programming Manual

LT360 Precision Turntable

DLL Programming Manual

LT360LIB.DLL Win32 OS

Tel: (503) 612-9565

Fax: (503) 612-9344

Printed in the United States of America.

March 30, 2006.

This document was produced on a Pentium-4 / 2GHz PC with Win2K using Adobe PageMaker 7.0, Adobe

Illustrator 10.0, Adobe PhotoShop 7.0, MathType 4.0 for mathematics typography, and SnagIt 5.2 for screen

captures. Final masters were produced using an Xerox Docutech image setter. Help files were composed and

compiled using Windows Help Designer 3.1.

LT360 Precision Turntable

DLL Programming Manual

License Agreement and Limited Warranty

Carefully read all of the following terms and conditions of this agreement before opening and using the contents of this

package. The opening of this package indicates your acceptance of the terms and conditions of this license agreement. If you

are not willing to accept the terms and conditions of this agreement, then you should return the entire product, with the

package seal unbroken, to the place of purchase for a full refund of the purchase price.

■Copyright Ownership

Both the program and the documentation are protected under applicable copyright laws. LinearX is the holder of this copyright. Your right to use the program

and the documentation are limited to the terms and conditions described herein. Use of the software unless pursuant to the terms and conditions of this

license, or as otherwise authorized by law, is an infringement of the copyright.

■Limited Non-Exclusive License

You may: (a) use the enclosed program on a single computer, (b) physically transfer the program from one computer to another provided that the program is

used on only one computer at a time, and that you remove any copies of the program from the computer from which the program is being transferred, (c) make

copies of the program solely for backup or archival purposes. You must reproduce and include the copyright notice and label any backup copy.

You may not: (a) distribute copies of the program or the documentation to others, (b) lease, rent, grant sublicenses, or other rights to the program, (c) provide

use of the program in a computer service business, network, time-sharing multiple CPU or multiple users arrangement without the prior written consent of

LinearX, (d) translate or otherwise alter the program or related documentation without the prior written consent of LinearX.

■Terms

Your license to use the program and the documentation will automatically terminate if you fail to comply with the terms of this agreement. Your license

terminates in the event that you receive a license for an updated version of the product that replaces this product. If a license expiration date is printed on your

documentation, or provided through other means such as a time limited electronic or software key, your license expires on the day as shown in the documen-

tation, or on the day that the electronic or software key expires. If this license is terminated you agree to destroy all copies of the program and documentation.

■Limited Warranty

LinearX warrants to the original licensee that the disk(s) and or electronic key(s) on which the program is recorded will be free from defects in materials and

workmanship under normal use for a period of ninety (90) days from the date of purchase as evidenced by a copy of your receipt. If failure of the product

components has resulted from accident, abuse, or misapplication of the product, then LinearX or third party licensors shall have no responsibility to replace the

disk(s) or key(s) under this limited warranty.

This limited warranty and right of replacement is in lieu of, and you hereby waive, any and all other warranties, both expressed and implied, including but not

limited to warranties of merchantability and fitness for a particular purpose. The liability of LinearX or third party licensors pursuant to this limited warranty shall

be limited to the replacement of the defective disk(s) or key(s), and in no event shall LinearX or third party licensors be liable for incidental, indirect, punitive,

or consequential damages, including but not limited to loss of use, loss of profits, loss of data or data being rendered inaccurate, or losses sustained by third

parties even if LinearX or third party licensors have been advised of the possibility of such damages. This warranty gives you specific legal rights which may

vary from state to state. Some states do not allow the limitation or exclusion of liability for consequential damages, so the above limitation may not apply to you.

In addition to the foregoing, you should recognize that all complex software systems and their documentation contain errors and omissions. LinearX, its

distributors, and dealers shall not be responsible under any circumstances for providing information on or corrections to errors and omissions discovered at any

time in the product, whether or not they are aware of the errors or omissions. LinearX does not recommend the use of this product in applications in which

errors or omissions could result in loss of life, injury, or other significant loss.

This license agreement shall be governed by the laws of the state of Oregon and shall inure to the benefit of LinearX, its successors, administrators, heirs and

assigns or third party licensors.

■United States Federal Government Restrictions

If this software is acquired by or on behalf of the U.S. Federal government or its agencies, this provision applies. Use, duplication, or disclosure of this software

is subject to restrictions set forth in the appropriate FAR 52.227-19 and DFAR 252.227-7013 documents, as applicable. The software is "commercial computer

software" and is licensed only with "Restricted Rights". Other Federal restrictions may also apply.

LinearX Systems Inc.

9500 SW Tualatin-Sherwood Rd.

Tualatin, OR 97062-8586 USA

TEL:(503) 612-9565 FAX:(503) 612-9344 WEB: www.linearx.com

4LT360 Precision Turntable

DLL Programming Manual

Technical Support

LinearX provides detailed printed manuals and on-line help within the program as the primary

source for user information and assistance regarding the use of this product. If these sources do

not contain the answers to your questions, contact LinearX via any of the following methods:

Internet Forums: www.linearx.com/forums

Internet Email: [email protected]

Internet Web: www.linearx.com

Fax: (503) 612-9344

Tel: (503) 612-9565

Technical support is free and unlimited at this time, however we reserve the right to charge for

this service in the future as conditions, overhead, and support personnel requirements dictate.

When contacting us regarding a technical support issue, PLEASE follow these steps to aid us in

understanding and solving your problem:

(1) If your question involves specific details or parameters unique to your project and problem, please include a copy of

your design files with the necessary data so that we can reproduce your problem. This is only possible if you are

communicating via an electronic means such as Email or uploading files directly to our web site.

(2) If the issue regards error messages from the program, please include an exact description of the error message

and/or address information that the program reports.

(3) If there are specific steps involved to reproduce the issue, please note these exact steps required so that we can

reproduce the problem.

Note: Technical support

does not

include programming assistance. It is assumed that the reader has sufficient

experience and knowledge to incorporate the DLL into their own application.

Technical support hours are: Monday-Friday 9:00AM to 5:00PM Pacific Standard Time.

LT360 Precision Turntable

DLL Programming Manual

1.1 Overview of LT360LIB.DLL ........................................................ 7

1.2 Header / Include Files ............................................................ 8

1.3 Opening and Closing a Link ..................................................... 9

1.4 Error Messages ...................................................................... 11

1.5 Using LT360 Commands ..................................................... 16

2.1 Goto CCW .......................................................................... 17

2.2 Goto CW ........................................................................... 18

2.3 Step CCW ..................................................................... 19

2.4 Step CW .................................................................... 20

2.5 Set Smart Torque .................................................... 21

2.6 Set Baud Rate ......................................................... 22

2.7 Set Origin .................................................................... 23

2.8 Set Pulse Direction ........................................................ 24

2.9 Set Pulse Edge ........................................................... 25

2.10 Set Step Size .......................................................... 26

2.11 Set Velocity ........................................................... 27

2.12 Set Torque ............................................................ 28

2.13 Set Acceleration Function .......................................... 29

2.14 Set Name ............................................................... 31

2.15 Set Pulse Input ...................................................... 32

2.16 Set Analog Input ...................................................... 33

2.17 Set Display Polarity ................................................ 34

2.18 Set Input Polarity ................................................... 35

2.19 Set Output Polarity ................................................ 36

2.20 Set Move Abort .................................................... 37

2.21 Set Motor Home Check ......................................... 38

2.22 Set Output Mode .................................................... 39

2.23 Get Name ............................................................... 41

2.24 Get Title ................................................................. 42

2.25 Get Firmware Version ............................................. 43

2.26 Get Firmware Date .................................................. 44

2.27 Get Production Date .................................................. 45

2.28 Get Calibration Date .................................................. 46

Contents

Chapter 1: Overview 7

Chapter 2: Command Reference 17

6LT360 Precision Turntable

DLL Programming Manual

2.29 Get Calibration Due ..................................................... 47

2.30 Get Serial Number ...................................................... 48

2.31 Get Baud Rate ............................................................ 49

2.32 Get Position ............................................................ 50

2.33 Get Pulse Direction ................................................... 51

2.34 Get Pulse Edge .......................................................... 52

2.35 Get Step Size ........................................................... 53

2.36 Get Velocity ............................................................ 54

2.37 Get Torque ............................................................ 55

2.38 Get Acceleration Function ........................................ 56

2.39 Get Moving ............................................................ 58

2.40 Get Pulse Input ......................................................... 59

2.41 Get Analog Input .................................................... 60

2.42 Get Smart Torque ....................................................... 61

2.43 Get Display Polarity .................................................... 62

2.44 Get Input Polarity ...................................................... 63

2.45 Get Output Polarity ................................................... 64

2.46 Get Motor Home Check .............................................. 65

2.47 Get Revision Code ....................................................... 66

2.48 Get Output Mode ........................................................... 67

Contents

LT360 Precision Turntable

DLL Programming Manual

1.1 Overview of LT360LIB.DLL

A DLL (Dynamic Link Library) is provided for use by user application

programs to allow direct control of the LT360 Precision Turntable. The DLL

supports the Win32 OS environments. For other operating system environ-

ments, the universal RS-232 programming method should be used.

The DLL supports both methods of linking to LT360 turntables either via

serial RS-232 connections or the USB (Universal Serial Bus). Multiple LT360

units can be managed by the DLL simultaneously, from 1 to 128 units.

The DLL handles all of the management details necessary for easy serial

communications over either the PC's com ports or USB. The application

program needs only to place calls to the DLL through 4 simple functions.

The LT360LIB.DLL file should be placed in a folder where the Windows

system can find it. Typically placing a copy in the application folder is

common, or in the main Windows folder.

The DLL functions are 32 bit code and can be called by any Win32 applica-

tion written in any language. An appropriate header file is all that is required

for the exported functions for linking.

8LT360 Precision Turntable

DLL Programming Manual

1.2 Header / Include Files

Two example header / include files for linking and calling the DLL

functions are provided for C/C++ or Delphi/Pascal:

Header / Include Files

■LT360LIB.h C/C++

■LT360LIB.pas Delphi/Pascal

Other header files for different languages can be translated from these

examples. The header files contain all of the prototype exported

functions along with the command identifier constants used to make the

various function calls to the LT360 turntables.

The header files may require modification depending on the particular

behavior of the compiler/linker being used.

LT360 Precision Turntable

DLL Programming Manual

The procedure for opening a link is very easy. First connect an LT360 to

either a serial COM port or USB port on the computer. Then call one of

two functions to open the link:

LONGINT LT360LIB_OpenLinkUSB(void);

LONGINT LT360LIB_OpenLinkCOM(LONGINT ComNum, LONGINT BaudRate);

■LT360LIB_OpenLinkUSB

This call is used if the turntable is connected to the USB bus. There are no

parameters. Since there may be multiple LT360 units attached to the USB

bus, this function can be called more than once.

The function returns a Handle to each unit found, which is simply a numeric

index. The calling program should maintain and store these handles. If no

more LT360 units are found, then the handle returned is 0.

Note: The USB driver for the LT360 must be installed in the Win32 system.

■LT360LIB_OpenLinkCOM

This call is used if the turntable is connected to a serial COM port. There

are two parameters: the COM port number (ie. 1,2,3,4...) and the baud rate.

The default baud rate shipped with the LT360 is 9600. You must specify

the COM port number in which the LT360 is connected. The function may

be called multiple times with different com port numbers for LT360 units

attached to the different com ports.

The function returns a Handle to the unit found, which is simply a numeric

index. The calling program should maintain and store these handles. If no

LT360 unit is found, then the handle is 0.

Note: The 9 pin serial cable should be straight-through, not null modem.

■LT360LIB_CloseLink

To close a link to an LT360, call this function with the handle of the unit.

The return value is True if successful, and false if an error.

LONGBOOL LT360LIB_CloseLink(LONGINT Handle);

1.3 Opening and Closing a Link

10 LT360 Precision Turntable

DLL Programming Manual

■Example with USB link

The following code fragment demonstrates the sequence of calls for a

USB link to a LT360 unit.

// Open link via USB, save returned handle

H360 = LT360LIB_OpenLinkUSB();

...

// Call the LT360 to set the Step Size to 1 degree

LT360LIB_CmdValue(H360,lt_SetStepSize,'1.0');

// Call the LT360 to do a step CCW

LT360LIB_CmdValue(H360,lt_Step_CCW,null);

...

// Close the link when done

LT360LIB_CloseLink(H360);

■Example with COM link

The following code fragment demonstrates the sequence of calls for a

RS-232 serial port link to a LT360 unit.

// Open link via serial port, COM3 at 9600 baud, save returned handle

H360 = LT360LIB_OpenLinkCOM(3,9600);

...

// Call the LT360 to set the Step Size to 1 degree

LT360LIB_CmdValue(H360,lt_SetStepSize,'1.0');

// Call the LT360 to do a step CCW

LT360LIB_CmdValue(H360,lt_Step_CCW,null);

...

// Close the link when done

LT360LIB_CloseLink(H360);

Altri manuali per LT360

Indice

Altri manuali LinearX Giradischi

LinearX

LinearX LT360 Manuale utente

Manuali Giradischi popolari di altre marche

Gemini

Gemini CDT-05 MKII Manuale utente

Rotel

Rotel RP-820 Manuale utente

Shuman

Shuman MC-250BT Manuale utente

Stanton

Stanton STR8-150 Manuale utente

Audio Technica

Audio Technica AT-LPW40WN Manuale utente

Crosley

Crosley McQueen CR7011-GY Manuale utente

Reloop

Reloop SMP-1 Manuale utente

auna

auna TT-Classic Plus Manuale utente

COMO AUDIO

COMO AUDIO Turntable Analog Manuale utente

Dual

Dual 1009 F Manuale utente

REED

REED Muse3C Manuale utente

AXIOMTEK

AXIOMTEK OPS883-H Series Manuale utente

Pioneer

Pioneer PL-71 Manuale utente

Vestax

Vestax PDX-a1 Manuale utente

Denon

Denon DP-400 Manuale utente

Dual

Dual 504 Manuale utente

Audio-Techica

Audio-Techica AT-LP60XBT Manuale utente

Goldring

Goldring G99 Manuale utente