Userstring Functions - Keithley 2601 Reference Manual

Section 12: Instrument Control Library
tsplink.writeport
Function Writes to all TSP-Link synchronization lines.
Usage
tsplink.writeport(data)
data
Remarks • The binary representation of data indicates the output pattern to be written to the I/O port.
For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1), and
the other 2 lines are set low (0).
• Write protected lines will not be changed (see tsplink.writeprotect).
• The reset function does not affect the present states of the digital I/O lines.
• Use the tsplink.writebit and tsplink.writeport commands to control the
output state of the synchronization line while the trigger mode is set to
tsplink.TRIG_BYPASS.
Details See "Controlling digital I/O
Also see tsplink.readbit, tsplink.readport, tsplink.writebit.
Example Sets the synchronization lines 1 and 2 high (binary 011):
tsplink.writeport(3)
tsplink.writeprotect
Write protect mask that disables bits from being changed with the
Attribute
and
tsplink.writeport
Usage
mask = tsplink.writeprotect
tsplink.writeprotect = mask
mask
Remarks • Bits set to 1 cause the corresponding line to be write protected.
• The binary equivalent of mask indicates the mask to be set for the I/O port. For example,
a mask value of 5 has a binary equivalent 101. This mask write protects lines 1 and 3.
Details See "Controlling digital I/O
Also see tsplink.readbit,
Example Write protects lines 1 and 3:
tsplink.writeprotect = 5

userstring functions

The functions in this group are used to store/retrieve user-defined strings in non-volatile memory.
userstring.add
Function Adds a user-defined string to non-volatile memory.
Usage
userstring.add(name, value)
name
value
This function will associate the string
Remarks
non-volatile memory. The value associated with the given name can be retrieved with
the
userstring.get
userstring.catalog, userstring.delete,
Also see
Example Stores user-defined strings in non-volatile memory:
userstring.add("assetnumber", "236")
userstring.add("department", "Widgets")
userstring.add("contact", "John Doe")
12-116
Value to write to the port; 0 to 7.
lines" in Section
functions.
-
- Reads write protect mask.
-- Writes write protect mask.
--
Set to the value that specifies the bit pattern
for write protect
lines" in Section
tsplink.readport tsplink.writeport
The name for the string.
The string to associate with the name.
value
function.
userstring.get
Return to Section Topics
Series 2600 System SourceMeter® Instruments Reference Manual
10.
tsplink.writebit
.
10.
with the string and store the pair in
name
2600S-901-01 Rev. C / January 2008