beautypg.com

KEPCO ABC VISA INSTRUMENT DRIVER User Manual

Page 5

background image

ABC-VISA 092303

5

Save/Recall Settings

KpAbc_SaveRecSet

Saves the current settings to the selected memory location or restores
previously stored settings from a memory location. The memory loca-
tion range is from 1 to 40.

UTILITY FUNCTIONS — This class of functions provides lower level functions to communicate with the instrument and to change
instrument parameters.

Identify Power Supply

KpAbc_identify

Returns the full message returned by the power supply to the *IDN?
query. This message contains four fields: manufacturer, power supply
type, serial number and firmware version.

Revision Query

KpAbc_RevisionQuery

Returns the revision numbers of the instrument driver and instrument
firmware version from the *idn? query. This instrument driver's Revision
Number is "Rev 1.0, 9/95, CVI 3.1" and the ABC firmware version is
Firmware Version "1.0". This data is necessary when requesting techni-
cal support.

Model Query

KpAbc_ModelQuery

Return the model number of the ABC power supply.

Serial Number Query

KpAbc_SerialnQuery

Returns the serial number of the ABC power supply. The serial number
is extracted from the answer to the *idn? query.

Query SCPI Version

KpAbc_GetScpiVersion

Returns the power supply answer to the Query SCPI Version com-
mand. Checks the Standard Commands for Programmable Instru-
ments (SCPI) language version.

Set/Reset Keypad Lock

KpAbc_setResetKeybLock

Locks or unlocks keypad operation. Used to prevent changing the set-
tings of the power supply from the local keypad.

Keypad Lock Status

KpAbc_keybLockStat

Return the status of the local keypad access: 0 if local access enabled;
1 if local access is disabled.

Display Text

KpAbc_display

Configures the front panel display of the instrument. In normal mode
the values measured at the output of the power supply are displayed.
In text mode a user defined string can be displayed on the second row
of the display.

Get Display Text

KpAbc_getDisplay

Gets the string which is displayed on the second line of the display.

Get Display Contrast

KpAbc_getContrast

Gets the contrast value of the front panel display of the instrument
(between 0.1 and 0.9).

Set Display Contrast

KpAbc_setContrast

Configures the contrast of front panel display of the instrument (value
between 0.1 and 0.9).

Write To Instrument

KpAbc_writeInstrData

This function writes commands and queries to the instrument to modify
parameters and query device settings.

Read Instrument Data

KpAbc_readInstrData

This function reads data from the instrument's output buffer and returns
it to the specified variable in memory. Because the instrument may
return both numeric and text data in response to queries, this function
returns the data in string format. NOTE: If valid data is not available at
the instrument's output buffer when this function is called, the instru-
ment will hang up and the function will not return until it times out. If the
time-out is disabled,` this function will hang indefinitely and it may be
necessary to reboot the computer to break out.

Reset

KpAbc_psReset

Resets the instrument to a known state and sends initialization com-
mands to the instrument.

Self-Test

KpAbc_selfTest

Runs the instrument's self test routine and returns the test result(s).

Error-Query

KpAbc_errorQuery

Reads an error code from the instrument's error queue.

Error Message

KpAbc_errorMessage

Takes the Status Code returned by the instrument driver functions,
interprets it and returns it as a user readable string.

Calibration Status On/Off KpAbc_CalStatus

Used to enter or exit the calibration state. To enter the calibration state
a 4 digits password is required. When the instrument is shipped from
the factory the calibration password is the 4 digit model number. The
password protects the instrument against unauthorized calibrations.

TABLE 1. ABC VISA DRIVER FUNCTIONS (CONTINUED)

Purpose

Function Name

Description