Manuals >Reference >IC-CAP Functions
Print version of this Book (PDF file)
prevnext

HP5250_init

HP 5250A Switching Matrix function. Must be run first to initialize the instrument with the address and interface. Using this transform the configuration mode can be set to AUTO. When the instrument is in AUTO configuration mode the same type of card must be installed in the HP 5250 slots from slot 1 continuously. The installed cards are then treated as 1 card (numbered 0).

Syntax

HP5250_init (BusAddress, "Interface", "Configuration")

Where

BusAddress is interface bus address (default is 22)

"Interface" is interface name (default is hpib)

"Configuration" is AUTO/NORMAL A/N (default is NORMAL)

HP5250_show

HP 5250A Switching Matrix function. Has no inputs. Returns to the standard output (screen or file) the following data about the instrument status:

Instrument Name

Instrument Configuration (AUTO/NORMAL).

The following information is output for each card installed in the instrument (card 0 if the instrument is in auto configuration mode):

Connection mode

Connection sequence

Input Bias Port

Enabled Output Bias Ports

Bias Sate (ON/OFF)

Coupled Input Ports (only lower number is listed, e.g., "3,5" means ports 3 and 4 are coupled)

Couple Port Mode (ON/OFF)

Connection Matrix Inputs(10)xOutputs(12,24,36, or48).

HPdiode_C

Produces an array of data that contains the high-frequency intrinsic capacitance at measured bias points for the Agilent Root Diode model.

Output:

Array of real numbers; size determined by the setup

Automatic Invocation:

None

HPdiode_C2

Produces an array of data that contains the high-frequency intrinsic capacitance at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers; size determined by the setup

HPdiode_I

Produces an array of data that contains the current values at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers; size determined by the setup

HPdiode_Q

Produces an array of data that contains the charge values at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers; size determined by the setup

HPdiode_R

Produces an array of data that contains the intrinsic resistance at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers; size determined by the setup

HPdiode_S11i

Produces an array of data that contains the imaginary part of S11 at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers; size determined by the setup

HPdiode_S11r

Produces an array of data that contains the real part of S11 at measured bias points for the Agilent Root Diode model.

Output  Array of real numbers, size determined by the setup

HPdiode_V

Produces an array of data that contains the voltage values at measured bias points for the Agilent Root Diode model.

HPdiode_data_acqu

Extraction function for acquiring data for the Agilent Root Diode model. Adaptively takes data throughout the safe operating range of the device.

Input Arguments:

 

   Reals or Integers:

Vmax, Vmin, Max step, Min step, Noise level, Eps

Automatic Invocation:

By Extract menu function

HPdiode_fgrt

No documentation available at this time

HPdiode_fless

No documentation available at this time

HPdiode_iextr

No documentation available at this time

HPdiode_mdl

Extraction function for generating the Agilent Root Diode model.

Input Arguments:

 

   Reals or Integers:

LowBound V, HighBound V, Extraction f

Extracts:

Generates the model function and look-up table

Automatic Invocation:

By Extract menu function

HPdiode_para_at_f

Calculates parasitics at the specified frequency for the Agilent Root Diode model.

Input Arguments:

 

   Reals or Integers:

Extraction f

Extracts:

cac, cag, ccg, R, L_tot

HPdiode_para_f

Extracts parasitic elements and writes them to the Para.data file.

Input Arguments:

 

   Data Sets:

Freq, S param, I

Reals or Integers:

Ideality

Output:

None

HPdiode_wr

Writes the inputs to the Measured.data file.

Input Arguments:

 

   Data Sets:

Freq, S param, I, V

HPIB_abort

Breaks GPIB communication and resets the bus.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open()

Output:

0 for success, -1 for error.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_abort(file_num)
HPIB_clear

Sends a Device Clear command to an instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address.

Output:

0 for success, -1 for error.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_clear(file_num, 16)
HPIB_close

Terminates GPIB communication and releases resources.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open().

Output:

0 for success, -1 for error.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_close(file_num)
HPIB_command

Sends a single GPIB command byte on the bus.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), command byte.

Output:

0 for success, -1 for error.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_command(file_num, 20) ! DCL 
HPIB_eoi

Enables or disables if eoi is sent with last byte transmitted.

Usage:

HPIB_eio(EID,eoiFlag)

Input Arguments:

 

   EID

Specifies the descriptor returned from HPIB_open()

   eoiFlag

0 for disable, 1 for enable

Output:

0 for success, -1 for error

 

HPIB_fwrite

Formatted write to GPIB. Writes a variety of formats to the designated instrument.

Usage:

HPIB_fwrite(EID,Address,numBytes,numericalData,convertChar)

Input Arguments:

 

   EID

Specifies the descriptor returned from HPIB_open()

   Address

Specifies the address of the instrument

   numBytes

Specifies how many bytes to read from the bus

   numericalData

Specifies the number to be written out

   convertChar

Specifies how to interpret the bytes as follows:

"F"   Must request numBytes=4 or numBytes=8
Numerical data will be converted to a single or double precision number and sent across the bus.

"I"  Must request numBytes=2 or numBytes=4
Numerical data will be converted to a 2's complement number of the specified size and sent across the bus.

Output:

0 for success, -1 for error

HPIB_open

Initiates GPIB communication and reserves resources. Instrument control through GPIB should use this function family to be portable across platforms. Defined in userc_io.c.

Input Arguments:

 

   Reals or Integers:

Interface file name. Refer to Measurement chapter.

Output:

File descriptor.

Automatic Invocation:

None

Example PEL Statement:

file_num = HPIB_open("hpib") ! for s700  
file_num = HPIB_open("/dev/gpib0") ! for Sun
HPIB_read

Reads a variety of formats from the designated instrument.

Usage:

HPIB_read(EID,Address,numBytes,Format,Variable)

Input Arguments:

 

   EID

Specifies the descriptor returned from HPIB_open()

   Address

Specifies the address of the instrument

   numBytes

Specifies how many bytes to read from the bus

   Format

Specifies how to interpret the bytes as follows:

 

"A"  Return an ASCII string less than or equal to numBytes in length (depending on EOI and Null characters read.) Allow for a terminator in your numBytes length, but this terminator will be stripped from the return.

 

"F"  Must request numBytes=4 or numBytes=8 Result will be these bytes interpreted as a normal ordered single or double precision number.

 

"I"  Must request numBytes=2 or numBytes=4 Result will be these bytes interpreted as a normal ordered 2's complement integer.

 

"C"  Must request numBytes=1. Result will be this byte interpreted as a normal ordered unsigned integer.

 

"H"  Interprets a string of characters as a hexadecimal number and outputs the decimal equivalent. NumBytes may be any length. Hexadecimal interpretation will continue until a non hexadecimal character or NULL byte is encountered. hexadecimal character set [0-9, a-f, A-F].

 

"O"  Interprets a string of characters as an octal number and outputs the decimal equivalent. NumBytes may be any length. Octal interpretation will continue until a non-octal character or NULL byte is encountered. octal character set [0-7].

Variable

Specifies the name of a variable in a variable table will receive the read data.

Output:

0 for success, -1 for error

  

HPIB_read_reals

This function was obsoleted and replaced by HPIB_read.

Reads multiple real numbers from a designated instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address, an optional scanf() format to pick up a real number. If the format is blank, "%lf" is used.

Output:

Array of real numbers.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_read_reals(file_num, 16, "%lf\n")
HPIB_readnum

This function was obsoleted and replaced by HPIB_read.

Reads a single real number from a designated instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address, an optional scanf() format to pick up a real number. If the format is blank, "%lf" is used.

Output:

a real number (the value 9.99998E+37 means an error occurred).

Automatic Invocation:

None

Example PEL Statement:

data = HPIB_readnum(file_num, 16, "")
HPIB_readstr

This function was obsoleted and replaced by HPIB_read.

Reads a single character string from a designated instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address, an optional scanf() format to pick up a real number, a variable name that receives the character string. If the format is blank, "%[^\r\n]*" is used to exclude CR/LF.

Output:

0 for success, -1 for error.

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_readstr(file_num, 16, "%s\n", "IC-CAP_variable")
HPIB_spoll

Reads a status byte from a designated instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address.

Output:

status byte (real number)

Automatic Invocation:

None

Example PEL Statement:

status = HPIB_spoll(file_num, 16)
HPIB_srq

Tests if SRQ line of the bus is True or False.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open().

Output:

1 for True, 0 for False, -1 for error

Automatic Invocation:

None

Example PEL Statement:

srq = HPIB_srq(file_num)
HPIB_timeout

Sets the GPIB timeout.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), timeout in seconds.

Output:

0 for success, -1 for error

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_timeout(file_num, 10) ! timeout on 10 sec
HPIB_write

This function was obsoleted and replaced by HPIB_fwrite.

Sends a character string to a designated instrument.

Input Arguments:

 

   Reals or Integers:

File descriptor returned from HPIB_open(), target GPIB address, a character string to be sent that allows normal C escapes.

Output:

0 for success, -1 for error

Automatic Invocation:

None

Example PEL Statement:

x = HPIB_write(file_num, 16, "*IDN?\n")
HPMOS_process_pars

Allows specification of initial values for the Agilent MOS process related parameters LD, RS, RSH, TOX, WD, and XJ. The drain resistance RD is set equal to the specified value of RS.

Input Arguments:

 

   Data Sets:

Lateral Diffusion, Source Resistance, Sheet Resistance, Oxide Thickness, Width Reduction

Output:

None

Extracts:

(not applicable)

Automatic Invocation:

By Extract menu function

HPMOSDC_lin_large

Standard extraction for the Agilent MOS model. Extracts classical parameters using Id versus Vg measured on a large device.

Input Arguments:

 

   Data Sets:

Gate V, Bulk V, Drain V, Drain I

Output:

None

Extracts:

VTO, NSUB, UO, VNORM

Automatic Invocation:

By Extract menu function

HPMOSDC_lin_narrow

Standard extraction for the Agilent MOS model. Extracts width effect parameters using Id versus Vg measured on a narrow device.

Input Arguments:

 

   Data Sets:

Gate V, Bulk V, Drain V, Drain I

Output:

None

Extracts:

WD, VWFF, WFF

Automatic Invocation:

By Extract menu function

HPMOSDC_lin_short

Standard extraction for the Agilent MOS model. Extracts length effect parameters using Id versus Vg measured on a short device.

Input Arguments:

 

   Data Sets:

Gate V, Bulk V, Drain V, Drain I

Output:

None

Extracts:

LD, VDFF, LFF

Automatic Invocation:

By Extract menu function

HPMOSDC_sat_short

Standard extraction for the Agilent MOS model. Extracts saturation parameters using Id versus Vd measured on a short device.

Input Arguments:

 

   Data Sets:

Gate V, Bulk V, Drain V, Drain I

Output:

None

Extracts:

ETRA, ECRIT, DESAT

Automatic Invocation:

By Extract menu function

HPRoot_data_acqu

Extraction function for acquiring data for the Agilent Root model. Adaptively takes data throughout the safe operating range of the device.

Input Arguments:

None

Output:

None

Automatic Invocation:

By Extract menu function

HPRoot_FET

Extraction function for generating the Agilent Root FET model.

Input Arguments:

None

Output:

None

Extracts:

Generates the model functions and look-up table.

Automatic Invocation:

By Extract menu function

HPRoot_fet_acqu

Extraction function for acquiring data for the Agilent Root FET model. Adaptively takes data throughout the safe operating range of the device.

Input Arguments:

 

   Reals or Integers:

Power level, I_Brk, I_Fwd, Min Vd, Max Vd, Min Vg, Max Vg, Min step, Max step, Vp, Delta, Vdiode. Eps, Noise thresh, SMU Compl

Output:

None

Automatic Invocation:

By Extract menu function

HPRoot_FET_t

Extraction function for generating the Agilent Root FET model.

Input Arguments:

 

   Reals or Integers:

vd_start, vg_start, t_dispersion

Extracts:

Generates the model function and look-up table

Automatic Invocation:

By Extract menu function

HPRoot_Id

Produces array of data that contains the drain current values at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Idh

Produces array of data that contains the high frequency current values at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Ig

Produces array of data that contains the gate current values at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_initial

Initializes plots displayed with the Agilent Root FET model.

Input Arguments:

None

Output:

None

Automatic Invocation:

By Extract menu function

HPRoot_mos_acqu

Extraction function for acquiring data for the Agilent Root MOSFET model. Adaptively takes data throughout the safe operating range of the device.

Input Arguments:

 

   Reals or Integers:

Power level, I Breakdown, Min Vd, Max Vd, Min Vg, Max Vg, Min step, Max step, Vth, Delta, Eps, Noise thresh, SMU Compl

Automatic Invocation:

By Extract menu function

HPRoot_mos_para

Calculates Z matrix from S parameter input and extracts the parasitic elements for the Agilent Root MOS model.

Input Arguments:

 

   Data Sets:

S param, Freq

   Strings/Pars/Vars:

Mode ( Z / EXTR )

Output:

Matrix array, size determined by inputs

  

HPRoot_MOSFET

Extraction function for generating the Agilent Root FET model.

Input Arguments:

 

   Reals or Integers:

vd_start, vg_start, t_dispersion

Extracts:

Generates the model function and look-up table

Automatic Invocation:

By Extract menu function

HPRoot_n

Extracts the ideality parameter for the Agilent Root FET and Agilent Root Diode models.

Input Arguments:

 

   Data Sets:

V, N array

   Reals or Integers:

LowBound V, HighBound V, Max 

Output:

None

Extracts:

N

Automatic Invocation:

None

HPRoot_parasitic

Measures the parasitic elements of a device for the Agilent Root FET model.

Input Arguments:

None

Output:

None

Extracts:

The parasitic resistors Rs, Rd, and Rg, and the parasitic inductors Ls_tot, Ld_tot, and Lg_tot.

Automatic Invocation:

By Extract menu function

HPRoot_para_cal

Calculates the parasitic elements of a device for the Agilent Root FET and Agilent Root MOS models.

Input Arguments:

 

   Strings/Pars/Vars:

Mode ( Mesfet / Mosfet)

Extracts:

Rg, Rs, Rd, Lg_tot, Ls_tot, Ld_tot

Automatic Invocation:

None

HPRoot_Qd

Produces array of data that contains the drain charge values at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Qg

Produces array of data that contains the gate charge values at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Vd

Produces array of data that contains the drain voltage values of the bias distribution of the whole operating range of the device for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Vg

Produces array of data that contains the gate voltage values of the bias distribution of the whole operating range of the device for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_wr

Reads measured parasitic data and extracted frequency and calculates parasitic resistances, inductances and computes the intrinsic matrix Zp and Yp for linear AC de-embedding.

Input Arguments:

 

   Data Sets:

Freq, S param, IG, ID, VG, VD

trings/Pars/Vars:

S   Mode ( s / p )

HPRoot_Y11i

Produces array of data that contains the imaginary part of Y11 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y11r

Produces array of data that contains the real part of Y11 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y12i

Produces array of data that contains the imaginary part of Y12 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y12r

Produces array of data that contains the real part of Y12 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y21i

Produces array of data that contains the imaginary part of Y21 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y21r

Produces array of data that contains the real part of Y21 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y22i

Produces array of data that contains the imaginary part of Y22 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPRoot_Y22r

Produces array of data that contains the real part of Y22 at measured bias points for Agilent Root FET model.

Input Arguments:

None

Output:

Array of real numbers; size determined by setup

Automatic Invocation:

None

HPTFT_param

This function is obsolete.

The dielectric constant of oxide film in the Agilent A-Si:H TFT model is calculated.

Input Arguments:

 

   Data Sets:

EPSFM

Output:

The value of EPSFM

Automatic Invocation:

None


prevnext