beautypg.com

4 context-sensitive help, 5 installer, 6 rights – KEPCO KLR Series Developers Guide User Manual

Page 24: 2 ivi-com instrument driver functions, Context-sensitive help -2, Installer -2, Rights -2, Ivi-com instrument driver functions -2

background image

3-2

KLR-DEV 060713

3.1.4

CONTEXT-SENSITIVE HELP

The driver includes both HTML 1.x and HTML 2.0 help files which document the following driver
elements:

• Interfaces

• Methods

• Method parameters

• Properties

3.1.5

INSTALLER

A stand-alone installer, file KepcoDCPwr.0.1.0.0.msi, using Microsoft MSI technology may be
downloaded from the Kepco website at www.kepcopower.com/drivers.

NOTE: The filename of the installer, either on our web site or sent via e-mail, will have .delme

added to the end of the file. After downloading the file, it must be renamed, deleting
.delme. The .delme extension allows the driver to pass through most firewalls. The
.msi extension indicates the file is a system update file and many networks prohibit
them. Once it is renamed, it can be installed on the computer by double clicking the file.

This installer complies with all of the installer requirements of Section 6 of IVI-3.1: Driver Archi-
tecture Specification.

The installer checks to insure the IVI foundation class components of the proper revision are
installed. It also verifies the VISA-COM driver is properly registered. If these checks fail, the
installer provides instructions on how to repair the problem. The installer will not install the
Kepco driver unless the IVI foundation class is installed. If VISA-COM problems are detected,
they are reported with suggestions for repair, but do not stop the driver from installing and regis-
tering the files.

3.1.6

RIGHTS

The IVI-COM driver was written by Kepco for use on Kepco products. It was written using
Pacific Mindworks Nimbus system. It is intended for use with Kepco power supplies. Disassem-
bly and/or modification of the IVI-COM driver is expressly forbidden.

3.2

IVI-COM INSTRUMENT DRIVER FUNCTIONS

Table 3-1 is a list of the KLR IVI-COM driver functions. The installed help file provides detailed
information on these functions and all functions in the driver. This driver is both a DCPWR class
driver and a Kepco Specific driver. The DCPWR class driver requires the class specific attribute
to be accessed as a member in a structure. The standard functions such as enabling the output,
setting the voltage level, setting the current level are handled in this manner.

A setting in Table 3-1 is identified by the variable being in all caps. Functions use both upper and
lower case letters in the function name. When a setting is to be modified, then the functions
KpDCPwr_SetAttributeViBoolean, or KpDCPwr_SetAttributeViReal64 are used to update the
variable and the functions KpDCPwr_GetAttributeViBoolean or KpDCPwr_GetAttributeViReal64
are used to get the variable. When one of these class-specified variables are modified, its value
is maintained in the driver. When the get or read of the variable is called for, the internal state
variable is returned. This behavior can be modified by making the KPDCPWR_ATTR_CACHE
attribute false. It defaults to a true state as required by the IVI conventions.