2470 High Voltage SourceMeter Instrument Reference Manual
Section 14: TSP command reference
2470-901-01 Rev. A /
May
2019
14-289
upgrade.unit()
This function upgrades the 2470 firmware.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
No
Usage
upgrade.unit()
Details
When
upgrade.unit()
is used, the firmware is only loaded if the version of the firmware is newer
than the existing version. If the version is older or at the same revision level, it is not upgraded.
When you send this function, the instrument searches the USB flash drive in the front-panel USB port
for an upgrade file. If the file is found, the instrument verifies that the file is a newer version. If the
version is older or at the same revision level, it is not upgraded, although it does request a reboot. If it
is a newer version, the instrument performs the upgrade. An error event message is returned if no
upgrade file is found.
Also see
(on page 14-288)
userstring.add()
This function adds a user-defined string to nonvolatile memory.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
No
Usage
userstring.add("
name
", "
value
")
name
The name of the string; the key of the key-value pair
value
The string to associate with
name
; the value of the key-value pair
Details
This function associates the string
value
with the string
name
and stores this key-value pair in
nonvolatile memory.
Use the
userstring.get()
function to retrieve the
value
associated with the specified
name
.
You can use the
userstring
functions to store custom, instrument-specific information in the
instrument, such as department number, asset number, or manufacturing plant location.