North Atlantic 8810A User manual

Programmer’s Reference Guide for 8810A
Two Synchro/Resolver Measurement and
One optional Reference supply
Programmer’s Reference
Programmer’s
Reference Guide
for
8810A
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Guide for 8810A
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 1 of 50

Contents
Table of Contents
1 Introduction............................................................................................................................. 3
2 Remote Setup.......................................................................................................................... 4
2.1 Controlling Channel 1 Signal Input................................................................................ 5
3 Language Support................................................................................................................... 7
3.1 Compatibility to 8810 APIs............................................................................................ 9
3.2 Language Independent Commands............................................................................... 11
3.3 API-8810A Native........................................................................................................ 12
3.4 API-8810 Native (Legacy)............................................................................................ 29
3.5 API-8810 SR103 (Legacy) ........................................................................................... 31
3.7 API-8810 HSR202 (Legacy)......................................................................................... 32
3.8 API-8810 HSR203 (Legacy)......................................................................................... 33
3.9 API-8810 MATE/CIIL (Legacy).................................................................................. 34
4 API-8810A USB Protocol..................................................................................................... 35
5 API-8810A Ethernet Protocol............................................................................................... 37
6 API-8810A DLL................................................................................................................... 40
7 API-8810A Soft Panel Program............................................................................................ 41
8 Cypress USB Driver Installation for Windows XP .............................................................. 49
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 2 of 50
8810A Programmer’s

Introduction
1 Introduction
The 8810A Angle Position Indicator Measurement Instrument provides two fully independent
channels with 0.0001°resolution and 0.004°(Standard)/ 0.001°(Special) accuracy. The 8810A
allows all programming to be done via the touch-screen or mouse interface. In addition, remote
operation capabilities are provided via IEEE-488, USB, Ethernet and J1 connection (50 pin
DSUB connector in back of the unit).
Reference Documentation
For additional information about this instrument refer to the Operation Manual for Model 8810A.
For additional information about the Application Programming Interface (API) provided in the
API8810ADll refer to the Function Reference Manual for 8810A.
Reference CD
For electronic copies of the 8810A documentation, API-8810A Soft Panel application program,
and source code for API-8810ADll and Soft Panel application refer to the 8810A Product CD.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 3 of 50
8810A Programmer’s

RemoteSetup
2 Remote Setup
To enable remote operation capabilities via IEEE-488, USB, Ethernet and J1 connection (50 pin
DSUB connector in back of the unit), the unit must be configured for remote operation.
8810A Programmer’s
Click on the button labeled “Loc/Rem” to view the Local/Remote Configuration screen:
In “Local” mode, the configuration settings can be queried. The unit must be in one of the
“Remote” modes (Ethernet, IEEE, USB or J1) before configuration settings can be changed
remotely. Note, for remote programming via the IEEE interface, the language type must be
selected, refer to section 3 on language support.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 4 of 50

RemoteSetup
2.1 Controlling Channel 1 Signal Input
The signal input for channel 1 can be read from the front panel connector or from the J1
connection in the back of the unit. The signal input for channel 2 is read only from the J1
connection.
The configuration for channel 1 is configured two ways:
One method is to click the button shown below:
8810A Programmer’s
The second method is to click on the “Setup” button.
(See next page)
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 5 of 50

RemoteSetup
Click the “Options” button.
Select the “Front Panel” or “Back Connector” option for Channel 1 Input. Click on the “Set”
button.
8810A Programmer’s
Note: the “Auto Save” option is not available on 8810A Revision B instruments.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 6 of 50

Language Support
3 Language Support
The 8810A Unit is a direct replacement for all 8810’s. This unit supports the following
languages:
IEEE-488.1 USB Ethernet
API-8810A Native Supported Supported Supported
API-8810 Native (Legacy) Supported Not available Not available
API-8810 SR103 (Legacy) Supported Not available Not available
API-8810 HSR202
(Legacy) Supported Not available Not available
API-8810 HSR203
(Legacy) Supported Not available Not available
API-8810 MATE/CIIL
(Legacy) Please contact
manufacturer for
MATE/CIIL
support
Not available Not available
The following table lists the applicable IEEE-488 bus commands for the API-8810A.
Mnemonic ASCII Hex Function
GTL SOH 01 Go To Local - This command instructs the API to go to local
mode. All front panel controls are active.
SDC EOT 04 Selected Device Clear - When the SDC command is
received, and if the API is addressed to listen, the API will
initialize to the conditions listed under DCL.
DCL DC4 14 Device Clear - When the API receives the DCL command it
is initialized to the following state:
SYNCHRO
DATA FREEZE - OFF
SRQ MODE - OFF
GET MODE – OFF
GET BS 08 Group Execute Trigger - When the GET command is
received, and if the API is addressed to listen and has the
GET mode switch on, data sent to the API will be applied to
the instrument.
LLO DC1 11 Local Lockout - This command disables the front panel
REM switch. It gives the controller complete control over
whether the API is in remote or local operation.
SPE CAN 18 Serial Poll Enable - After receipt of this command the API,
when addressed to talk, will transmit the Status Byte.
SPD EM 19 Serial Poll Disable - This command cancels the SPE
command and allows the API, when it is addressed to talk,
to send data.
UNL / 3F Unlisten - Unaddresses the API listen address.
UNT - 5F Untalk - Unaddresses the API talk address.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 7 of 50
8810A Programmer’s

Language Support
The following table lists the interface function capability codes for the API-8810A.
Code Function
AH1 Acceptor handshake - complete capability
SH1 Source handshake - complete capability
T6 Talk capability - all except TON
TEO Extended Talk capability – none
L4 Listen capability - all except LON
LEO Extended Listen capability - none
SR1 Service request - complete capability
RL1 Remote/Local - complete capability
PPO Parallel Poll - no capability
DC1 Device Clear - complete capability
DT1 Device Trigger - complete capability
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 8 of 50
8810A Programmer’s

Language Support
3.1 Compatibility to 8810 APIs
The 8810A will provide language compatibility to the following 8810 systems:
API-8810 Native
API-8810 SR103
API-8810 HSR202
API-8810 HSR203
Legacy 8810 Data
When the IEEE language type selected is one of the 8810 legacy languages, the API will send angle data to
the controller in the following format:
<DDDDDD<CR><LF>
e.g., <179999<CR><LF>
The standard API data message will always be 7 characters long plus a <cr><lf>. The API when used in
the ±180 mode will send angle data to the IEEE controller in the following format:
<SDDDDDD<CR><LF>
e.g., <-149999<CR><LF>
The ±180 degree data message will always be eight characters long plus a <CR><LF>.
Serial Poll
When the IEEE language type selected is one of the 8810 legacy languages, the status byte returned by the
API indicates the status of the instrument. The bits of the status byte are defined as:
D7 D6 D5 D4 D3 D2 D1 D0
ERROR RQS 0 0 0 0 FREEZE RESOLVER
ERROR -When bit is set the API data is not stable. If FREEZE is programmed, this bit will always be 0.
RQS -When bit is set the API is asserting the SRQ line.
FREEZE -When bit is set the display is frozen.
RESOLVER -When bit is set the API is programmed for RESOLVER mode. When cleared the API is set to
SYNCHRO mode.
If the RQS bit is set, the remaining bits indicate the state of the API when the SRQ line was last asserted. If
the RQS line is not set then the remaining bits indicate the state of the API at the time the status byte is
read.
Service Request The API can be programmed to assert the SRQ line when the display data is stable.
Stability is defined as the angle readings being within <TBD> degrees or the FREEZE mode is
programmed. The V command instructs the API to assert the SRQ line when stable data is detected. If
stability is not detected within 4 seconds, SRQ will be asserted nevertheless and the ERROR bit in the
STATUS byte will be set. This command cancels itself once SRQ is asserted and must be reprogrammed
for subsequent SRQs. When SRQ is asserted the display data is saved and will be transmitted to the
controller (when addressed to talk) regardless of the display value. Once read, the API output data will then
agree with the display.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 9 of 50
8810A Programmer’s

Language Support
GET Mode When the G command is included in the programming string, the API will hold off applying the
programming data until the GET (Group Executive Trigger) bus command is received. GET mode is
cancelled once the bus command GET is received and must be reprogrammed if desired again.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 10 of 50
8810A Programmer’s

Language Support
3.2 Language Independent Commands
Note the following commands are case-sensitive.
Function Syntax (commands must be sent with upper-case) Comments
API COMMANDS
Identification *IDN?<cr><lf> Queries the device
for the ID.
Error
Reporting *ERR?<cr><lf> Queries for any error messages on
the error message
queue. “No error”
is returned when
there are no errors
on the queue.
Reset *RST?<cr><lf> Clears the error
message queue and
resets the device
with power-on or
last saved
configuration
settings.
APICMD<b>LANG?<cr><lf> Queries the IEEE
Language setting.
Query returns:
‘8810ANATIVE’,
or ‘8810NATIVE’,
or ‘8810SR103’, or
’8810HSR202’, or
‘8810HSR203’, or
“8810MATECIIL’
Language
APICMD<b>LANG<b>< 8810ANATIVE|8810NATIVE|
8810SR103|8810HSR202|8810HSR203|8810MATECIIL>
<cr><lf>
Sets the IEEE
Language setting.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 11 of 50
8810A Programmer’s

Language Support
3.3 API-8810A Native
The API-8810A Native language is support via the IEEE-488.1, USB and Ethernet interfaces.
The language provides remote programming access to the features available on the 8810A unit.
Note the following commands are case-sensitive.
API CHANNELS
Function Syntax (commands must be sent with upper-case) Comments
API<chan><b>UPDATE?<cr><lf> Queries the
track/latch state of
the channel.
Query returns:
‘LATCHED’ or
‘TRACK’.
Track/Latch
Angle
API<chan><b>UPDATE<b><LATCH|TRACK><cr><lf> Sets the track/latch
state for the channel.
API<chan><b>MODE?<cr><lf> Queries the mode
state of the channel.
Query returns: ‘RSL’
or SYN’.
Signal
Mode
API<chan><b>MODE<b><RSL|SYN><cr><lf> Sets the Rsl/Syn state
for the channel.
API<chan><b>REF_SOURCE?<cr><lf> Queries the reference
source for the
channel.
Query returns: ‘INT’
or ‘EXT’.
Reference
Mode
API<chan><b>REF_SOURCE<b><INT|EXT><cr><lf> Sets the
Internal/External
reference source
mode for the channel.
Ratio API<chan><b>RATIO?<cr><lf> Queries the ratio
setting for each
channel.
Query returns the ‘1’
always for channel 1
and for channel 2, the
ratio setting value:
Ratio Range = 1 to
255.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 12 of 50
8810A Programmer’s

Language Support
API<chan><b>RATIO<b><value><cr><lf> Sets the ratio setting
for each channel.
Channel 1 can only
be set to 1. Channel
2 can be set to any
value between 1 and
255.
API<chan><b>BANDWIDTH?<cr><lf>
Queries the
bandwidth setting for
each channel. Query
returns:
AUTO bwValue
or
OVERRIDE
bwValue
API<chan><b>BANDWIDTH<b><AUTO><cr><lf>
Sets the channel to
auto-bandwidth
mode.
Bandwidth
API<chan><b>BANDWIDTH<b><SET><value><cr><lf
> Sets the channel bandwidth value
Range: 6 <= value <=
1200
API<chan><b>AVERAGE?<cr><lf> Queries the averaging
setting for the
channel. Query
returns:
ON avgRate
or
OFF avgRate
API<chan><b>AVERAGE<b>STATE<b><ON|OFF>
<cr><lf>
Turns on or off the
channel’s averaging
feature.
API<chan><b>AVERAGE<b>RATE?<cr><lf> Queries the averaging
setting for the
averaging rate in
msec for the channel.
Angle
Averaging
API<chan><b>AVERAGE<b>RATE<b><value><cr><lf>
Set the channel’s averaging rate in
msec.
Range: 10<= value
<= 10000.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 13 of 50
8810A Programmer’s

Language Support
API<chan><b>AVG_ANGLE?<cr><lf> Queries the average
angle value for the
channel.
Query returns angle
in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
API<chan><b>ANG_LIMIT?<cr><lf> Queries the angle
limit test settings for
the channel.
Query returns:
‘ON’ or ‘OFF’ to
indicate whether limit
testing is active or
disable, a blank
space,
‘ABS’ or ‘ERR’ to
indicate whether
absolute angle or
angle error
comparison is used
for limit testing.
API<chan><b>ANG_LIMIT<b><ON|OFF><cr><lf> Turns on or off the
channel’s angle limit
testing feature.
API<chan><b>ANG_LIMIT<b>CMP?<cr><lf> Queries the angle
limit test comparison
settings for the
channel.
Query returns ‘ABS’
or ‘ERR’.
Angle Limit
Testing
API<chan><b>ANG_LIMIT<b>CMP<b><ABS|ERR>
<cr><lf> Set the channel’s angle limit
comparison to
Absolute Angle or
Angle Error.
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 14 of 50
8810A Programmer’s

Language Support
API<chan><b>ANG_LIMIT<b>HI?<cr><lf> Queries the upper
limit test value
settings for the
channel.
Query returns upper
limit in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
API<chan><b>ANG_LIMIT<b>HI<b><value><cr><lf> Sets the upper limit
test value in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
API<chan><b>ANG_LIMIT LO?<cr><lf> Queries the lower
limit test value
settings for the
channel.
Query returns lower
limit in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
API<chan><b>ANG_LIMIT<b>LO<b><value><cr><lf> Sets the lower limit
test value in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 15 of 50
8810A Programmer’s

Language Support
API<chan><b>ANG_LIMIT STEP?<cr><lf> Queries the angle
step value for limit
test value settings for
the channel.
Query returns step
value in degrees:
Range: 0.001 < value
< 359.999
API<chan><b>ANG_LIMIT<b>STEP<b><value>
<cr><lf> Sets the angle step test value in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
Angle API<chan><b>ANGLE?<cr><lf> Queries the angle
data for the channel.
Query returns angle
in degrees:
Range: 0.0000 <
value < 359.9999
or
Bipolar Range:
-180.0000 < value <
+180.0000
Velocity API<chan><b>VEL?<cr><lf> Queries the angle
velocity data for the
channel.
Query returns
channel velocity in
degrees per second:
Range: -32767 <
value < +32767.
Line-to-
Line
Voltage
API<chan><b>LL_VOLT?<cr><lf> Queries the line-to-
line voltage for the
channel.
Null
Voltage API<chan><b>NULL_VOLT?<cr><lf> Queries the null voltage for the
channel.
Note this feature has
not been
implemented. The
value 0.00 will
always be returned.
Reference API<chan><b>REF_VOLT?<cr><lf> Queries the reference
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 16 of 50
8810A Programmer’s

Language Support
Voltage voltage for the
channel.
Reference
Frequency API<chan><b>REF_FREQ?<cr><lf> Queries the reference frequency for the
channel.
API<chan><b>DA<b>OUTPUT?<cr><lf> Queries the D/A
setup for the data to
use for D/A voltage
output conversion for
the channel.
Query returns ‘ANG’
or ‘VEL’.
API<chan><b>DA<b>OUTPUT<b><ANG|VEL>
<cr><lf> Sets the D/A data to use either angle or
velocity for D/A
voltage output
conversion for the
channel.
Digital-to-
Analog
Setup
API<chan><b>DA<b>HIDATA?<cr><lf> Queries the D/A
Upper Limit Data
conversion for the
channel.
Query returns for
Angle Data in
degrees:
Unipolar Range:
0.0000 < value <
359.9999
or Bipolar Range:
-180.0000 < value <
+180.0000
Query returns for
Velocity Data in
degrees/sec:
Range:
-10000<value<10000
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 17 of 50
8810A Programmer’s

Language Support
API<chan><b>DA<b>HIDATA<b><value><cr><lf> Sets the D/A Upper
Limit Data
conversion for the
channel.
Angle Data Range in
degrees:
Unipolar Range:
0.0000 < value <
359.9999
or Bipolar Range:
-180.0000 < value <
+180.0000
Velocity Data Range
in degrees/sec:
-10000<value<10000
API<chan><b>DA<b>HIVOLT?<cr><lf> Queries the D/A
Voltage conversion
for the Upper Limit
Conversion for the
channel.
Query returns voltage
value in the range:
-10.0<value<10.0
API<chan><b>DA<b>HIVOLT<b><value><cr><lf> Sets the D/A Voltage
conversion for the
Upper Limit
Conversion for the
channel.
Voltage range in
volts:
-10.0<value<10.0
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 18 of 50
8810A Programmer’s

Language Support
API<chan><b>DA<b>LODATA?<cr><lf> Queries the D/A
Lower Limit Data
conversion for the
channel.
Query returns for
Angle Data in
degrees:
Unipolar Range:
0.0000 < value <
359.9999
or Bipolar Range:
-180.0000 < value <
+180.0000
Query returns for
Velocity Data in
degrees/sec:
Range:
-10000<value<10000
API<chan><b>DA<b>LODATA<b><value><cr><lf> Sets the D/A Lower
Limit Data
conversion for the
channel.
Angle Data Range in
degrees:
Unipolar Range:
0.0000 < value <
359.9999
or Bipolar Range:
-180.0000 < value <
+180.0000
Velocity Data Range
in degrees/sec:
-10000<value<10000
API<chan><b>DA<b>LOVOLT?<cr><lf> Queries the D/A
Voltage conversion
for the Lower Limit
Conversion for the
channel.
Query returns voltage
value in the range:
-10.0<value<10.0
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 19 of 50
8810A Programmer’s

Language Support
API<chan><b>DA<b>LOVOLT<b><value><cr><lf> Sets the D/A Voltage
conversion for the
Lower Limit
Conversion for the
channel.
Voltage range in
volts:
-10.0<value<10.0
North Atlantic Industries, Inc. 631.567.1100/631.567.1823 (fax) Revision 2.0.0.2 Reference Guide
110 Wilbur Place, Bohemia, NY 11716 www.naii.com / e-mail:[email protected] Page 20 of 50
8810A Programmer’s