Keithley 4200-SCS Reference Manual page 645

Model 4200-SCS Reference Manual
Remarks
Example
kspdefclr Define string to clear RS-232 instrument on devclr
Purpose
Format
4200-901-01 Rev. S / May 2017
The number of data bits that will be used. Valid inputs are 7 or 8
databits
bits.
Determines whether or not parity bits will be transmitted. Valid
parity
inputs are: 0 (no parity), 1 (odd parity), or 2 (even parity).
Sets the number of stop bits to be transmitted. Valid inputs are: 1
stopbits
or 2.
Determines the type of flow control that will be used. Valid inputs
flowctl
are: 0 (no flow control), 1 (XON/XOFF flow control), or 2
(hardware).
Port 1 must not be allocated to another program or utility when using the ksp (Keithley
Serial Port) commands.
• The databits, parity, stopbits, and flowctl settings must match those on
the instrument or device that you wish to control.
• Using a flow control setting of 0 may result in buffer overruns if the device or
instrument that you are controlling has a high data rate.
• If you use a flow-control setting of 2 (hardware), you must make sure that the
RS-232 cable has enough wires to handle the RTS/CTS signals.
Here is an example of how you would use kspcfg to set port 1 to 19200 baud, 8 data bits,
odd parity, 1 stop bit, and xon/xoff flow control:
int status;
.
.
.
status = kspcfg(1, 19200, 8, 1, 1, 1);/* port 1, 19200 baud,
8 bits, odd parity,
1 stop bit, and
xon-xoff flow ctl */
Defines a device-dependent character string sent to an instrument connected to a serial
port. This string is sent during the normal tester devclr process. It ensures that if the
tester is calling devclr internally, any device connected to the configured serial port
will be cleared with the given string.
int kspdefclr(int port, double timeout, double delay, int
buffsize, char *buffer);
The RS-232 port to be used. Currently only port 1 is supported.
port
This port must have been previously configured for
communications with the kspcfg command.
The serial communications timeout. The valid input range is 0 to
timeout
600 s.
The amount of time to delay after sending the string to the serial
delay
device. The valid input range is 0 to 600 s.
The length of the string to send to the serial device.
buffsize
Return to Section Topics
Section 8: Keithley User Library Tool (KULT)
8-129