KEPCO ABC VISA INSTRUMENT DRIVER User Manual
Page 5
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