Groesz.org/HP3457A
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Files
master
HP3457A/commands.json
S Groesz a5ee5781de Add structured GPIB command reference (commands.json) and docs 
Complete extraction of all 97 commands in HP 3457A Operating.pdf
Chapter 4, expanded to 120 JSON entries (F10-F58 modeled as 24
independent commands rather than one parameterized command). Each
entry includes description, syntax, structured parameters, important
points, worked examples, and tier/rationale classification to guide
which commands a Python control library actually needs.

Documents several findings not obvious from the manual alone: the
output buffer's single-reading data-loss behavior and the correct
burst-acquisition pattern, the CR/LF bus-hold gotcha, the Front Panel
checkbox's unreliability, the isolation-link mechanism behind F10-F58's
speed, and memory/timing capacity math for burst captures.

Updates README.md (was empty) and cmdformat.txt to document the
schema and key findings.
2026-08-24 22:50:36 -05:00

6084 lines
338 KiB
JSON
Raw Permalink Blame History

{
"_meta": {
"source": "HP 3457A Operating.pdf, Chapter 4 \"Command Reference\", pages 4-7 to 4-166 (the alphabetically-ordered command section). Covers 97 distinct manual entries (cross-checked 1:1 against an independent page-header scan of the whole chapter), expanded to 120 JSON entries because the F10-F58 manual page documents 24 separate zero-parameter commands on one page (see 'f10_f58_split' below) rather than one parameterized command.",
"f10_f58_split": "The manual presents F10 through F58 as a single page (4-54/4-55) with one syntax diagram ('F10 (typical)'), but each mnemonic (F10, F11, ... F58) is actually its own complete, standalone command with no parameters -- not a parameter choice within one 'F10-F58' command. They're modeled here as 24 separate entries, each with a 'family': 'F10-F58' field linking them together, 'selects_function'/'selects_range' fields showing what each one configures, and shared important_points (the two worked examples in the manual are attached to the specific commands they demonstrate: F10 and F43).",
"schema_note": "Field names follow cmdformat.txt. 'local' = Front Panel checkbox, 'remote' = Remote checkbox (both booleans, from the two checkboxes at the top of each command's first page). 'manual_pages' gives the printed page range (e.g. '4-7' to '4-8'), not the PDF's physical page numbers.",
"front_panel_caveat": "The 'local' field is transcribed faithfully from the printed checkboxes, but do not treat it as authoritative evidence of what's physically possible from the front panel — it can diverge from the real hardware. Example: DCV, ACV, ACI, ACDCV, and DCI are all marked Front-Panel-unchecked despite each having a literal dedicated or shifted panel key (confirmed against the actual scans and a photo of the unit), apparently because the checkbox tracks whether the *exact parameterized command syntax* (with max.input/%resolution) can be entered from the panel, not whether the underlying measurement mode is reachable at all. ACDCI is checked for both Front Panel and Remote despite Chapter 3 describing it in identical terms to ACV/ACI/ACDCV/DCV (word-for-word parallel 'the shifted key does not allow additional parameters' language) — this is most likely a printing erratum on the ACDCI page (4-10), not a real distinction. Since the Python library only cares about the Remote path, this field is informational only.",
"remote_only_exception": "Across all 120 entries, ADDRESS (4-22) is the ONLY one that is Remote-unchecked (Front-Panel-only) — you cannot remotely reassign the instrument's own bus address over that same bus. Every other command in this file is reachable via GPIB.",
"get_vs_put_convention": "As a rule, a trailing '?' means a query (a 'GET' -- reads a value back, no instrument state change beyond what the manual documents e.g. clearing a register) and no trailing '?' means a setter/action ('PUT' -- configures state or triggers an action, no return value expected). The one exception is the standalone '?' command itself: despite looking like a bare query, it is NOT one -- it's a trigger-generating action command (shorthand for TRIG SGL under specific preconditions), and expects no response. Don't special-case parsing purely on 'ends with ?' without excluding that single-character command.",
"tiering": "Each command also carries a 'tier' field -- 'core' (40 commands: the measurement functions themselves, plus the setup/trigger/timing/status commands a modern Python controller genuinely needs and can't replicate host-side -- includes MATH/MATH?, reclassified from 'extended' after the output-buffer finding below), 'protocol' (3 commands: ADDRESS/END/INBUF -- bus/transport housekeeping, a different kind of 'essential' than a measurement concept), or 'extended' (77 commands: real and documented, but not needed for a typical automated measurement workflow -- plug-in-card-only commands, on-instrument subprogram/state storage that a host script can replace, calibration/diagnostics/service, front-panel UI, legacy speed-optimized aliases like the F10-F58 family/R/T that existed to save parsing time on 1980s-era slow HP-IB controllers). See each command's 'tier_reason' for the specific rationale. Two deliberate judgment calls worth noting: TARM's multiple-arming (burst N measurement cycles per single command) and MEM/MFORMAT/MSIZE/RMEM (on-instrument reading memory) are classified 'core'/'extended' respectively but both remain genuinely useful on THIS project's Prologix-over-Ethernet transport specifically, since per-command round-trip latency there is real (unlike a fast native 1980s HP-IB card) -- revisit if burst-acquisition throughput becomes a concrete requirement.",
"output_buffer_data_loss_and_burst_pattern": "Critical finding from Chapter 3's \"Buffers\" section (page 3-28): the HP 3457's output buffer holds only ONE reading at a time, and its contents are REPLACED (silently, no error) by every new reading unless the present contents are still being read. This means that without MEM (reading memory) enabled, a fast unattended acquisition WILL silently drop readings if the host can't retrieve each one before the next lands -- there is no GPIB-level 'streaming' mode that queues multiple readings for you. The manual's own worked example for the RMS math operation (Chapter 3, page 3-25C) demonstrates the correct high-throughput pattern instead: configure NRDGS with a large count (e.g. 'NRDGS 1104') and a fast sample event, then send a SINGLE 'TRIG SGL' -- this runs the whole burst to completion INSIDE the instrument at its full internal measurement rate (the HP-IB bus is held throughout, per the CR/LF bus-hold mechanism in language_conventions), completely decoupled from bus/Ethernet round-trip time. Only afterward do you pay a transfer cost: either bulk-reading MEM (bounded by its 2208 bytes, gives every raw sample) or querying MATH STAT's registers via RMATH (unbounded burst length, but only gives the aggregate: SDEV/MEAN/NSAMP/UPPER/LOWER). STAT/PFAIL are the two math operations that do NOT alter the reading (per the Math Operations intro) -- they accumulate accurately in parallel with the reading stream even when individual readings never make it off the output buffer, which is why they're classified 'core'/'acquisition_timing' rather than 'era_computer_workaround' despite being math-family commands: this isn't about 1980s host CPUs being slow at arithmetic, it's about surviving a burst that outruns the transfer channel, a timeless (still relevant on this project's Prologix bridge) architectural concern.",
"service_commands": "CAL (4-30), DIAGNOSTIC (4-47), SECURE (4-134), and REV? (4-122) are service-related commands the manual explicitly defers to the HP 3457A Service manual for ('service_command': true in their entries) — no documented syntax/parameters here.",
"abbreviations": "R (4-115) is a shorthand alias for RANGE; T (4-148) is a shorthand alias for TRIG. Both have a 'see_also' field pointing to the full command instead of duplicating its content.",
"f10_f58_speed_mechanism": "The Operating manual states F10-F58 'configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)' but does not explain why. The Service manual (Section VIII, 'Cross-Isolation Link', ~page 8-39) explains the likely mechanism: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz, 11-bit frames (1 start + 8 data + 1 parity + 1 stop bit). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must first parse a free-form numeric range parameter. This is informed inference connecting two separate confirmed facts (the Operating manual's speed claim, and the Service manual's isolation-link architecture) — the manuals don't state the causal connection in these exact terms.",
"rationale_taxonomy": "Each command also carries a 'rationale' field, a second axis orthogonal to 'tier' that answers *why* the command is fast or exists, not just whether a modern library needs it: 'measurement_hardware' (28 commands -- the physical measurement action or an analog-signal-path/ADC-integration setting; timeless, no era-dependence -- this is just what a DMM does), 'acquisition_timing' (17 -- DMM-side batching/timing, e.g. TARM multiple-arming, NRDGS, TIMER, the MEM reading-memory family, RMATH HIRES, and MATH/MATH? (specifically the STAT/PFAIL operations -- see output_buffer_data_loss_and_burst_pattern above for why); reduces round-trips or improves timing precision beyond what host-side polling could do, a genuine win on ANY era of controller including this project's Prologix-Ethernet transport), 'wire_efficiency' (27 -- shorter command encodings that cut GPIB byte/handshake overhead: R, T, the standalone '?', and the whole F10-F58 family; real but modest, and the reason F10-F58 also gets measurably faster DMM-side execution, per 'f10_f58_speed_mechanism' above), 'era_computer_workaround' (8 -- SUB/SUBEND/CALL/PAUSE/SCRATCH/RSTATE/SSTATE/SMATH; existed mainly to let a slow/limited 1980s host offload sequencing or arithmetic onto the DMM, cleanly replaced by modern host-side scripting), 'plugin_card_dependent' (9 -- CHAN/SLIST/SADV/etc., requires the optional 44491/44492 card, unrelated to computer era), 'diagnostic_calibration' (7), 'status_error_readback' (7), 'ui_frontpanel_only' (5), 'bus_protocol' (12). Note MEM/MFORMAT/MSIZE/RMEM/MCOUNT? are 'extended' tier (not needed for a typical workflow) but 'acquisition_timing' rationale (genuinely useful *if* burst throughput matters) -- tier and rationale answer different questions and can disagree on purpose.",
"power_not_a_command": "POWER (on/off) is not documented in Chapter 4 at all — it's a pure physical front-panel switch with no GPIB equivalent (confirmed against a photo of the actual unit).",
"language_conventions": {
"source": "HP 3457A Operating.pdf pages 4-4/4-5, \"Language Conventions\"",
"message_terminators": "<CR>, <LF>, or a semicolon (;) all indicate the end of a message to the HP 3457 (per IEEE Std 728-1982). Any characters following the terminator are not processed until the current command finishes executing.",
"cr_lf_bus_hold_gotcha": "With the input buffer OFF (INBUF OFF; this is INBUF's power-on default), sending a command via the standard BASIC OUTPUT statement (e.g. OUTPUT 722;\"TEST\") appends <CR><LF>. The HP 3457 processes <CR> immediately but does NOT process <LF> until the command finishes executing — so for any slow command (CALL, TEST, ACAL, TARM SGL with multiple arming, etc.) the HP-IB bus is held until that command completes, and you cannot regain bus control in the meantime. This directly explains prior confusing behavior seen live on this project's hardware (see [[hp3457a-verification-status]] memory) where a query issued right after a slow command appeared to hang or get silently dropped — it was actually the bus being held by the pending <LF>, not a lost command.",
"suppressing_cr_lf": "Suppress <CR><LF> by sending with image specifiers: OUTPUT 722 USING \"#,K\";\"<CMD>;\" — the # specifier suppresses <CR><LF>, K suppresses leading/trailing spaces and uses free-field format, and the trailing semicolon is then REQUIRED to mark the end of the command to the HP 3457 (since <CR><LF> no longer does). Many command pages in this file mention this pattern in their example 'note' field for exactly the commands where it matters (CALL, TEST, ACAL, TARM multiple-arming, PAUSE-containing subprograms).",
"multiple_commands_per_string": "Multiple commands can be chained in one string separated by semicolons, e.g. OUTPUT 722;\"DCV 3,.0001;NPLC 10;TRIG AUTO\".",
"parameter_numbers": "Parameters can be integer, floating point, or exponential format; floats are rounded to the nearest integer if the command requires one (e.g. TERM .4 rounds down to TERM 0/open, TERM .5 rounds up to TERM 1/front, TERM 1.6 rounds up to TERM 2/rear).",
"comma_vs_space_delimiter": "From remote, any comma delimiter can be replaced with a space; a comma+space(s) combination is also accepted and the spaces are ignored (e.g. OUTPUT 722;\"DCV 3 , .001\" works the same as \"DCV 3,.001\").",
"defaulting_parameters": "Default a parameter by omitting it, or by replacing it with -1. From remote only, you can also use two commas to indicate a default value without omitting the position (e.g. \"ACV 10,,\" specifies 10 for the first parameter and defaults the second; \"ACV ,,.01\" defaults the first and specifies .01 for the second — note the space before the two commas in that second form matters, since omitting it changes which parameter is defaulted). Exception: SMATH's second (number) parameter cannot be defaulted with -1 — that literally writes -1 to the register instead."
},
"capacity_and_timing": {
"source": "HP 3457A Operating.pdf, Table 1-4 \"HP 3457 Specifications\" (pages 1-12, 1-14), and the MSIZE/MFORMAT/MEM/RMATH command entries in this file.",
"total_memory_bytes": 2208,
"memory_partitioning": "MSIZE splits the 2208 bytes into reading memory, subprogram memory, and (automatically) state memory. Minimums: reading memory 32 bytes, subprogram memory 32 bytes, state memory 69 bytes per state slot -- state location 0 (present-state-on-power-loss) is ALWAYS reserved regardless of allocation, per SSTATE important_points. Default MSIZE = 1000 (reading), 100 (subprogram), leaving 1108 for state. Max practical reading memory if you do not need subprograms/saved states = roughly 2208 - 32 (min subprogram) - 69 (mandatory state 0) = ~2107 bytes (rounded down to a multiple of 16 per MSIZE important_points).",
"bytes_per_reading_by_mformat": {
"ASCII": 16,
"SINT": 2,
"DINT": 4,
"SREAL": 4
},
"precision_vs_capacity_link": "MFORMAT byte count does not vary with NPLC/NDIG resolution directly -- but SINT (2 bytes, 16-bit range) only meaningfully holds 3.5-4.5 digit readings (per the Buffers section, Chapter 3 p.3-29: \"use this format when making high speed, LOW ACCURACY measurements\"). 5.5+ digit readings require DINT or SREAL (4 bytes). So choosing higher resolution indirectly HALVES the number of samples that fit in a given memory budget (2 bytes -> 4 bytes per sample). The 7.5-digit HIRES register is NOT bundled into MFORMAT-stored readings at all -- it must be queried separately via RMATH HIRES per measurement, which reintroduces a host round-trip and defeats the point of burst/MEM capture. Burst captures are therefore practically limited to native 6.5-digit resolution (no HIRES) if you want to preserve throughput.",
"sample_capacity_examples": {
"default_msize_1000B_reading_memory": {
"SINT_2B": 500,
"DINT_or_SREAL_4B": 250,
"ASCII_16B": 62
},
"max_msize_~2107B_reading_memory": {
"SINT_2B": "~1053",
"DINT_or_SREAL_4B": "~526",
"ASCII_16B": "~131"
}
},
"reading_rate_table_dcv_dci_ohm_up_to_30k": {
"note": "Table 1-4, page 1-12. Conditions per its own footnote (critical): zero DELAY, FIXED range (autorange off), DISPLAY OFF, front panel LOCKed, output to internal reading MEMORY (not live bus transfer) in SINT format, using the internal TIMER. I.e. these rates are only achievable via the NRDGS+TRIG SGL burst-into-MEM pattern documented in output_buffer_data_loss_and_burst_pattern, NOT via live per-reading GPIB polling.",
"rows_plc_digits_azOn_azOff_60Hz": [
[
0.0005,
"3.5",
300,
1350
],
[
0.005,
"4.5",
280,
1250
],
[
0.1,
"5.5",
140,
360
],
[
1.0,
"6.5",
26,
53
],
[
10,
"7.5 (HIRES only)",
2.5,
4.8
],
[
100,
"7.5 (HIRES only)",
0.25,
"0.48 (printed as \"48\" in the manual scan -- almost certainly a typo/missing decimal point: physically, 100 PLC takes 10x longer than 10 PLC so its rate should be roughly 10x SLOWER than the 10 PLC row (4.8), not faster; verified against a fresh high-res render of the actual page, the scan really does print \"48\" -- flagging as a likely original-manual erratum, not an extraction error, and using 0.48 for any downstream calculation."
]
]
},
"reading_rate_table_acv_aci": {
"note": "Table 1-4, page 1-14. Max ~9.5 readings/sec even in the fastest (0.0005 PLC, input>400Hz fast-response) case -- roughly 140x slower than DCV's ceiling. AC measurement functions (ACV/ACI/ACDCV/ACDCI) are true-RMS-style measurements that internally aggregate over some window before producing one value; they are NOT a stream of instantaneous samples and are a poor choice for anything like waveform/transient digitizing. DCV (or DCI/OHM) burst-mode sampling of the raw instantaneous input is the correct approach if the goal is to approximate an oscilloscope-like capture of a signal's time-domain shape."
},
"oscilloscope_comparison": "The user asked whether this DMM can approximate an oscilloscope. Roughly, yes, for slow phenomena, with the caveat that a scope's core is a fast ADC (Analog-to-Digital Converter, not DAC -- a DAC goes the other direction, digital to analog) sampling in the MHz-GHz range at 8-12 bits (~2.5-3.5 decimal digits). This instrument's ADC (a multi-slope integrating converter, per the Service manual's \"run-up interval\"/slope-decision description) tops out at 1350 samples/sec even at its lowest (3.5-digit) resolution -- roughly 1,000-1,000,000x slower than a real scope's sample rate, but with vastly higher per-sample resolution (up to 6.5 clean digits ~22 bits, vs a scope's 8-12 bits). By Nyquist, 1350 sps only meaningfully resolves signals well under a few hundred Hz, and realistically needs an order of magnitude more samples per cycle than the Nyquist minimum for a recognizable waveform, so this is a tool for slow transients/settling/drift capture (sub-second to many-second events), not for anything a real oscilloscope is used for."
}
},
"commands": [
{
"name": "ACAL",
"manual_pages": [
"4-7",
"4-8"
],
"local": true,
"remote": true,
"description": "The ACAL (autocal) command instructs the HP 3457 to perform one or both of its automatic calibrations.",
"syntax": "ACAL type",
"parameters": [
{
"name": "type",
"description": "The type parameter choices are:",
"values": [
{
"parameter": "ALL",
"decimal_equiv": 1,
"description": "Performs both of the following autocals",
"power_on": false,
"default": true
},
{
"parameter": "AC",
"decimal_equiv": 2,
"description": "Performs the AC flatness and AC offset autocal",
"power_on": false,
"default": false
},
{
"parameter": "OHMS",
"decimal_equiv": 3,
"description": "Performs the extended ohms and precharge autocal",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "ALL"
}
],
"important_points": [
"The AC autocal increases short term accuracy for AC or AC+DC voltage, and AC or AC+DC current measurements. The OHMS autocal increases short term accuracy of the 3GΩ range for 2-wire and 4-wire ohms measurements.",
"Always perform the OHMS autocal before making measurements on the 3 GΩ range. The OHMS autocal uses the presently selected input terminals (TERM command). Select the terminals you are going to use before performing the OHMS autocal.",
"Always disconnect any input signals before you perform an autocal. If you leave an input signal connected to the HP 3457, it may adversely affect the autocal.",
"The autocal constants are stored in non-volatile memory (remain intact when power is removed). That is, you do not necessarily need to perform autocal after power has been removed and re-applied.",
"The AC autocal takes about 3 seconds. The OHMS autocal takes about 32 seconds. Both autocals take about 35 seconds."
],
"examples": [
{
"code": "OUTPUT 722;\"ACAL 1\"",
"comment": "RUNS BOTH AUTOCALS",
"note": "This sends <CR><LF> following the command, which holds the HP-IB bus (unless the input buffer is enabled) until the autocals complete. To regain control of the bus immediately, suppress <CR><LF>: OUTPUT 722 USING \"#,K\";\"ACAL 1;\" (the semicolon after ACAL 1 marks the end of the command to the HP 3457 and must be present when <CR><LF> is suppressed)."
}
],
"tier": "extended",
"tier_reason": "autocalibration -- a real, occasionally useful maintenance operation, but not part of routine measurement flow",
"rationale": "diagnostic_calibration"
},
{
"name": "ACBAND",
"manual_pages": [
"4-9"
],
"local": true,
"remote": true,
"description": "The ACBAND (AC bandwidth) command selects the slow or fast measurement mode for AC voltage, AC current, frequency, or period measurements.",
"syntax": "ACBAND frequency",
"parameters": [
{
"name": "frequency",
"description": "You specify the frequency parameter as the expected frequency of the input signal. The HP 3457 then automatically selects the slow or fast mode.",
"values": [
{
"parameter": "< 400",
"unit": "Hz",
"description": "Selects the slow mode",
"power_on": true,
"default": true
},
{
"parameter": ">= 400",
"unit": "Hz",
"description": "Selects the fast mode",
"power_on": false,
"default": false
}
],
"power_on_raw": "selects the slow mode",
"default_raw": "selects the slow mode"
}
],
"important_points": [
"The slow mode selects a long time constant for the input filter and a long delay time. Use this mode for measurements where the frequency is below 400 Hz. The fast mode selects a short time constant and a short delay time. Use this mode for measurements where the frequency is equal to or greater than 400 Hz. Table 3-15 shows the slow and fast mode delays for all functions and ranges.",
"Since the fast mode has a short delay, it allows you to make a series of measurements faster than in the slow mode.",
"If you are unsure of the input frequency, or if the frequency may dip below 400 Hz, use the slow mode. This takes slightly more time per measurement, but assures you of accurate measurements."
],
"examples": [
{
"code": "OUTPUT 722;\"ACBAND 5000\"",
"comment": "SELECTS THE FAST MODE"
}
],
"tier": "core",
"tier_reason": "AC measurement bandwidth/speed mode -- meaningful speed tradeoff for AC measurements",
"rationale": "measurement_hardware"
},
{
"name": "ACDCI",
"manual_pages": [
"4-10",
"4-11",
"4-12"
],
"local": true,
"remote": true,
"description": "The ACDCI (AC+DC current) command instructs the HP 3457 to measure the combined AC and DC current of the input signal. This command also allows you to specify the measurement range and resolution.",
"syntax": "ACDCI max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of three standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's maximum expected RMS amplitude. The HP 3457 then selects the correct range.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - .03",
"selects_range": "30 mA",
"full_scale_reading": "32.5 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mA",
"full_scale_reading": "325 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 1",
"selects_range": "1 A",
"full_scale_reading": "1.05 A",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement resolution. When using autorange, the % resolution parameter is multiplied by the full scale reading of the selected range instead, giving a minimum resolution (the HP 3457 always gives at least this much, sometimes an additional digit).",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified by the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select AC+DC current measurements using the shifted ACDCI key or by accessing the FUNC command from the alphabetic command directory. The shifted ACDCI key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the amount of time during which it samples the input signal (integration time). Both the % resolution parameter and the NPLC command affect the integration time. When you execute a function command (ACV, DCV, ACI, etc.) the HP 3457 compares the integration time specified by % resolution to that specified by the NPLC command, and uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACDCI .6,.167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC+DC I, .6A max, .167% resolution",
"note": "Line 10 allows % resolution in line 20 to control the resolution. The resolution specified by line 20 is .6A x .00167 = .001A."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACDCI AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC+DC I, autorange, .033% resolution",
"note": "The HP 3457 provides at least .033% resolution for full scale readings on whatever range autorange selects."
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"ACDCI 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects AC+DC I, 1A max, .1% resolution",
"note": "Line 10 sets PLCs to 100 (maximum resolution), which prevents % resolution in line 20 from affecting the measurement. The requested resolution from line 20 is 1A x .001 = .001A, but because of line 10 the actual resolution is .000001A."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "ACDCV",
"manual_pages": [
"4-13",
"4-14",
"4-15"
],
"local": false,
"remote": true,
"description": "The ACDCV (AC+DC voltage) command instructs the HP 3457 to measure the combined AC and DC voltage of the input signal. It also allows you to specify the measurement range and resolution.",
"syntax": "ACDCV max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of five standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's maximum expected RMS amplitude.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - .03",
"selects_range": "30 mV",
"full_scale_reading": "32.5 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mV",
"full_scale_reading": "325 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 3",
"selects_range": "3 V",
"full_scale_reading": "3.25 V",
"power_on": false,
"default": false
},
{
"parameter": "> 3 - 30",
"selects_range": "30 V",
"full_scale_reading": "32.5 V",
"power_on": false,
"default": false
},
{
"parameter": "> 30 - 300",
"selects_range": "300 V",
"full_scale_reading": "303 V",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified by the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select AC+DC voltage measurements using the shifted ACDCV key or by accessing the FUNC command from the alphabetic command directory. The shifted ACDCV key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACDCV 6,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC+DC V, 6V max, .0167% resolution",
"note": "The resolution specified by line 20 is 6V x .000167 = .001V."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACDCV AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC+DC V, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"ACDCV 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects AC+DC V, 1V max, .1% resolution",
"note": "The requested resolution from line 20 is 1V x .001 = .001V, but because of line 10 the actual resolution is .000001V."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "ACI",
"manual_pages": [
"4-16",
"4-17",
"4-18"
],
"local": false,
"remote": true,
"description": "The ACI (AC current) command instructs the HP 3457 to measure AC current. It also allows you to specify the measurement range and resolution.",
"syntax": "ACI max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of three standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's maximum expected RMS amplitude.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - .03",
"selects_range": "30 mA",
"full_scale_reading": "32.5 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mA",
"full_scale_reading": "325 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 1",
"selects_range": "1 A",
"full_scale_reading": "1.05 A",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified by the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select AC current measurements using the ACI key or by accessing the FUNC command from the alphabetic command directory. The ACI key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACI .6,.167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC I, .6A max, .167% resolution",
"note": "The resolution specified by line 20 is .6A x .00167 = .001A."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACI AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC I, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"ACI 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects AC I, 1A max, .1% resolution",
"note": "The requested resolution from line 20 is 1A x .001 = .001A, but because of line 10 the actual resolution is .000001A."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "ACV",
"manual_pages": [
"4-19",
"4-20",
"4-21"
],
"local": false,
"remote": true,
"description": "The ACV (AC voltage) command instructs the HP 3457 to measure AC voltage. It also allows you to specify the measurement range and resolution.",
"syntax": "ACV max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of five standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's maximum expected RMS amplitude.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - .03",
"selects_range": "30 mV",
"full_scale_reading": "32.5 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mV",
"full_scale_reading": "325 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 3",
"selects_range": "3 V",
"full_scale_reading": "3.25 V",
"power_on": false,
"default": false
},
{
"parameter": "> 3 - 30",
"selects_range": "30 V",
"full_scale_reading": "32.5 V",
"power_on": false,
"default": false
},
{
"parameter": "> 30 - 300",
"selects_range": "300 V",
"full_scale_reading": "303 V",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified by the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select AC+DC voltage measurements using the shifted ACDCV key or by accessing the FUNC command from the alphabetic command directory. The shifted ACDCV key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution. NOTE: this is verbatim from the manual's ACV page — it appears to be a copy-paste holdover from the ACDCV page rather than describing an ACV-specific key; confirmed present in the actual scan (page 4-20), not an OCR artifact.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACV 6,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects ACV, 6V max, .0167% resolution",
"note": "The resolution specified by line 20 is 6V x .000167 = .001V."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"ACV AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects ACV, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"ACV 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects ACV, 1V max, .1% resolution",
"note": "The requested resolution from line 20 is 1V x .001 = .001V, but because of line 10 the actual resolution is .000001V."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "ADDRESS",
"manual_pages": [
"4-22",
"4-23"
],
"local": true,
"remote": false,
"description": "The ADDRESS command sets the HP 3457's HP-IB address. The HP 3457 stores the address in non-volatile memory (the address is not lost when power is removed).",
"syntax": "ADDRESS value",
"parameters": [
{
"name": "value",
"description": "The value parameter is 0-30 for a normal HP-IB address, or 31 for Talk Only mode. See the manual's ASCII Talk/Listen address character table (page 4-22) for the corresponding ASCII code characters per address.",
"values": [
{
"parameter": "0-30",
"description": "Normal HP-IB address",
"power_on": false,
"default": false
},
{
"parameter": "31",
"description": "Talk Only Mode",
"power_on": false,
"default": false
}
],
"power_on_raw": "previously stored address (factory setting = 22)",
"default_raw": "none; parameter required"
}
],
"important_points": [
"Address 31 sets the HP 3457 to the Talk Only mode. In this mode, the HP 3457 outputs directly to an HP-IB printer without a controller on the bus. Address 31, however, is not a valid HP-IB address with a controller on the bus.",
"If the HP 3457 detects a RAM failure it sets the address to 22.",
"An example showing how to change the address is under \"Changing the HP-IB Address\" in Chapter 2."
],
"examples": [],
"tier": "protocol",
"tier_reason": "bus address -- the one Remote-unchecked command; set via front panel only",
"rationale": "bus_protocol"
},
{
"name": "ARANGE",
"manual_pages": [
"4-24"
],
"local": true,
"remote": true,
"description": "The ARANGE (autorange) command enables or disables the autorange function.",
"syntax": "ARANGE control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Disables autorange algorithm",
"power_on": false,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Enables autorange algorithm",
"power_on": true,
"default": true
}
],
"power_on_raw": "ON",
"default_raw": "ON"
}
],
"important_points": [
"With autorange enabled, the HP 3457 samples the input signal before each measurement and selects the appropriate range.",
"Refer to the appropriate function command (ACV, DCV, ACDCI, etc.) for a listing of the possible ranges for that function.",
"If you have manually selected a range and then enable autorange, it is possible that autorange will select a different range. For example, if you are measuring 295 mVDC on the 300 mVDC range (manually selected) and then enable autorange, autorange selects the 3 VDC range."
],
"examples": [
{
"code": "OUTPUT 722;\"ARANGE ON\"",
"comment": "ENABLES AUTORANGE"
}
],
"tier": "core",
"tier_reason": "autorange on/off",
"rationale": "measurement_hardware"
},
{
"name": "AUXERR?",
"manual_pages": [
"4-25",
"4-26"
],
"local": true,
"remote": true,
"description": "When a hardware error is detected, the HP 3457 sets a bit in the auxiliary error register. The AUXERR? (auxiliary error) command returns a number representing these set bits and clears the register. The returned number is the weighted sum of all set bits.",
"syntax": "AUXERR?",
"parameters": [
{
"name": "(none; query command)",
"description": "Auxiliary Error Conditions and their weighted values:",
"values": [
{
"parameter": 1,
"bit": 0,
"description": "Isolation error during operation in any mode (self-test, autocal, measurements, etc.)"
},
{
"parameter": 2,
"bit": 1,
"description": "Slave processor self-test failure"
},
{
"parameter": 4,
"bit": 2,
"description": "Isolation self-test failure"
},
{
"parameter": 8,
"bit": 3,
"description": "Integrator convergence error"
},
{
"parameter": 16,
"bit": 4,
"description": "Front end zero measurement error"
},
{
"parameter": 32,
"bit": 5,
"description": "Current source, gain selection, input divider failure"
},
{
"parameter": 64,
"bit": 6,
"description": "Amps self-test failure"
},
{
"parameter": 128,
"bit": 7,
"description": "AC amplifier's DC offset test failure"
},
{
"parameter": 256,
"bit": 8,
"description": "AC flatness check"
},
{
"parameter": 512,
"bit": 9,
"description": "Ohms precharge failure during autocal"
},
{
"parameter": 1024,
"bit": 10,
"description": "32k ROM checksum failure"
},
{
"parameter": 2048,
"bit": 11,
"description": "8k ROM checksum failure"
},
{
"parameter": 4096,
"bit": 12,
"description": "Non-volatile RAM failure"
},
{
"parameter": 8192,
"bit": 13,
"description": "Volatile RAM failure"
},
{
"parameter": 16384,
"bit": 14,
"description": "Calibration RAM protection failure"
}
],
"power_on_raw": null,
"default_raw": null
}
],
"important_points": [
"The auxiliary error register indicates hardware related errors. If one or more bits are set, your HP 3457 needs repair or calibration.",
"The AUXERR? command returns a 0 if no error bits are set.",
"If any bit in the auxiliary error register is set, the HP 3457 sets bit 0 (hardware error) in the error register. Reading the auxiliary error register does not clear bit 0 in the error register. You must read the error register (ERR? command) to clear it.",
"If you execute the AUXERR? command from the HP 3457's front panel, the weighted sum goes to the display. If you execute AUXERR? from the controller, the weighted sum goes to the HP 3457's output buffer in ASCII format. After the weighted sum is sent to the output buffer, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"You cannot mask any bits in the auxiliary error register."
],
"examples": [
{
"code": "10 OUTPUT 722;\"AUXERR?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 reads the auxiliary error register; line 20 enters the weighted sum into variable A; line 30 displays the weighted sum",
"note": "As an example, if AUXERR? returns 513, that means the errors with weighted values of 1 (isolation error) and 512 (ohms precharge failure) have occurred."
}
],
"tier": "core",
"tier_reason": "hardware error detail -- basic error handling",
"rationale": "status_error_readback"
},
{
"name": "AZERO",
"manual_pages": [
"4-27"
],
"local": true,
"remote": true,
"description": "The AZERO (autozero) command enables or disables the autozero function.",
"syntax": "AZERO control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Zero measurement is updated once, then only after a function or range change",
"power_on": false,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Zero measurement is updated after every measurement",
"power_on": true,
"default": true
},
{
"parameter": "ONCE",
"decimal_equiv": 2,
"description": "Zero measurement is updated once, then only after a function or range change",
"power_on": false,
"default": false
}
],
"power_on_raw": "ON",
"default_raw": "ON"
}
],
"important_points": [
"When autozero is ON, the HP 3457 makes a zero measurement (measurement with the input disabled) following every measured reading and subtracts the zero measurement from the reading. This doubles the time required per measurement.",
"When autozero is OFF, the HP 3457 makes one zero measurement and subtracts this from all subsequent measurements. A new zero measurement is made whenever the function or range is changed. The control parameters OFF and ONCE have the same effect.",
"The display annunciator \"AZOFF\" is on whenever autozero is off."
],
"examples": [
{
"code": "OUTPUT 722;\"AZERO OFF\"",
"comment": "DISABLES AUTOZERO",
"note": "This line makes a single autozero measurement and then disables autozero until the measurement function or range changes."
}
],
"tier": "core",
"tier_reason": "autozero on/off -- meaningful speed/accuracy tradeoff",
"rationale": "measurement_hardware"
},
{
"name": "AZERO?",
"manual_pages": [
"4-28"
],
"local": true,
"remote": true,
"description": "The AZERO? (autozero?) command returns a number indicating the autozero mode: 1 = ON, 0 = OFF or ONCE.",
"syntax": "AZERO?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the AZERO? command by accessing the AZERO command from the alphabetic command directory and appending a question mark.",
"If you execute AZERO? from the HP 3457's front panel, the result goes to the display. If you execute AZERO? from the controller, the result goes to the HP 3457's output buffer in ASCII format after which the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"AZERO?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the autozero response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back autozero state",
"rationale": "measurement_hardware"
},
{
"name": "BEEP",
"manual_pages": [
"4-29"
],
"local": true,
"remote": true,
"description": "The BEEP command controls the HP 3457's beeper. When enabled, the beeper signals error situations with a 1 kHz beep.",
"syntax": "BEEP control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Disables the beeper",
"power_on": false,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Enables the beeper",
"power_on": false,
"default": false
},
{
"parameter": "ONCE",
"decimal_equiv": 2,
"description": "Beeps once then returns to previous mode (either enabled or disabled)",
"power_on": false,
"default": true
}
],
"power_on_raw": "last programmed value",
"default_raw": "ONCE"
}
],
"important_points": [
"The HP 3457 signals the end of a power-on sequence with a 500 Hz tone. The BEEP command does not affect this tone.",
"The HP 3457 stores the control value in non-volatile memory (the value is not lost when power is removed)."
],
"examples": [
{
"code": "OUTPUT 722;\"BEEP OFF\"",
"comment": "DISABLES THE BEEPER",
"note": "After executing this line, the HP 3457 does not beep when an error occurs."
}
],
"tier": "extended",
"tier_reason": "audible error indication -- irrelevant to unattended automation",
"rationale": "ui_frontpanel_only"
},
{
"name": "CAL",
"manual_pages": [
"4-30"
],
"local": true,
"remote": true,
"description": "This is a service related command. Refer to the HP 3457 Service manual for details.",
"syntax": null,
"parameters": [],
"important_points": [],
"examples": [],
"service_command": true,
"tier": "extended",
"tier_reason": "service-only, no documented syntax",
"rationale": "diagnostic_calibration"
},
{
"name": "CALL",
"manual_pages": [
"4-31"
],
"local": false,
"remote": true,
"description": "The CALL command executes a previously stored subprogram.",
"syntax": "CALL name",
"parameters": [
{
"name": "name",
"description": "The name parameter is a decimal number from 0 to 19 that selects the subprogram memory location.",
"values": [],
"power_on_raw": "none",
"default_raw": "0"
}
],
"important_points": [
"You store a subprogram using the SUB command.",
"The HP 3457 sets status bit 0 after executing a stored subprogram."
],
"examples": [
{
"code": "OUTPUT 722;\"CALL 2\"",
"comment": "RUNS SUBPROGRAM IN MEMORY LOCATION 2",
"note": "This sends <CR><LF> following the command, which holds the HP-IB bus (unless the input buffer is enabled) until subprogram execution completes. To regain control of the bus immediately, suppress <CR><LF>: OUTPUT 722 USING \"#,K\";\"CALL 2;\" (the semicolon after CALL 2 marks the end of the command to the HP 3457 and must be present when <CR><LF> is suppressed)."
}
],
"tier": "extended",
"tier_reason": "only relevant if using SUB",
"rationale": "era_computer_workaround"
},
{
"name": "CALNUM?",
"manual_pages": [
"4-31",
"4-32"
],
"local": true,
"remote": true,
"description": "The CALNUM? (calibration number?) command returns a decimal number indicating the number of times your HP 3457 has been calibrated. By routinely monitoring the calibration number, you can determine when calibrations are performed and whether or not an unauthorized calibration has been done.",
"syntax": "CALNUM?",
"parameters": [],
"important_points": [
"Your HP 3457 was calibrated before it left the factory. When you receive your HP 3457, read the calibration number to determine its initial value.",
"The calibration number is stored in non-volatile memory (not lost when power is removed).",
"The calibration number increments by one for each instrument point calibrated. A complete calibration increments the calibration number by several counts. The calibration number increments up to a maximum of 32767 after which it wraps around to 0.",
"Auto-calibration does not affect the calibration number.",
"When you execute the CALNUM? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the CALNUM? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"CALNUM?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 reads the calibration number; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "calibration-count diagnostic",
"rationale": "diagnostic_calibration"
},
{
"name": "CHAN",
"manual_pages": [
"4-33",
"4-34"
],
"local": true,
"remote": true,
"description": "The CHAN (channel) command allows you to select a plug-in card input channel for measurements.",
"syntax": "CHAN channel",
"parameters": [
{
"name": "channel",
"description": "The channel parameter is the number of the channel you want to use for measurements. For the HP 44491: 0-7 are 2-wire input channels, 8 and 9 are current input channels, 10-13 are 4-wire input channels. For the HP 44492: 0-9 are 2-wire input channels.",
"values": [
{
"parameter": "0-7",
"card": "HP 44491",
"description": "2-wire input channels"
},
{
"parameter": "8-9",
"card": "HP 44491",
"description": "Current input channels"
},
{
"parameter": "10-13",
"card": "HP 44491",
"description": "4-wire input channels"
},
{
"parameter": "0-9",
"card": "HP 44492",
"description": "2-wire input channels"
}
],
"power_on_raw": "none (no channel selected)",
"default_raw": "0"
}
],
"important_points": [
"To make a measurement on a plug-in card input channel, you must specify the plug-in card as the input source using the TERM command.",
"The CHAN command opens any previously selected scan list input channel. However, the scan list itself remains intact. If a specified SADV event occurs after a CHAN command, an advance is made to the next channel in the scan list.",
"If you execute the CHAN command with no plug-in card in the HP 3457's rear slot, you'll get the BAD HEADER error.",
"Refer to \"CHAN Command\" listed under your particular plug-in card in Chapter 5 for additional \"Important Points.\""
],
"examples": [
{
"code": "10 OUTPUT 722;\"RESET\"\n20 OUTPUT 722;\"TERM REAR\"\n30 OUTPUT 722;\"CHAN 2\"\n40 END",
"comment": "line 10 resets the HP 3457; line 20 selects the input source; line 30 selects channel 2"
},
{
"code": "10 OUTPUT 722;\"PRESET\"\n20 OUTPUT 722;\"TERM REAR\"\n30 OUTPUT 722;\"CHAN 2\"\n40 ENTER 722;A\n50 DISP A\n60 OUTPUT 722;\"CHAN 3\"\n70 ENTER 722;A\n80 DISP A\n90 END",
"comment": "presets, selects the input source and channel 2, triggers/enters/displays a reading, then opens channel 2 and closes channel 3 and repeats"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only (HP 44491/44492) -- irrelevant without that hardware installed",
"rationale": "plugin_card_dependent"
},
{
"name": "CHAN?",
"manual_pages": [
"4-35"
],
"local": true,
"remote": true,
"description": "The CHAN? (channel?) command returns the channel number of any presently selected plug-in card input channel.",
"syntax": "CHAN?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the CHAN? command by accessing the CHAN command from the alphabetic command directory and appending a question mark.",
"When you execute the CHAN? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the CHAN? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"If no channel is selected, the CHAN? command returns -1 (minus 1).",
"The CHAN? command does not reveal the state of an actuator channel (channel 8 or 9 on an HP 44491 card) unless that channel was closed by a scan list. The CHAN? command does reveal the state of channel 8 or 9 when selected as a current input."
],
"examples": [
{
"code": "10 OUTPUT 722;\"CHAN?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the present channel number; line 20 puts the response in variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "CLOSE",
"manual_pages": [
"4-36"
],
"local": true,
"remote": true,
"description": "The CLOSE command closes actuator channel 8 or 9 on the HP 44491 plug-in card.",
"syntax": "CLOSE actuator channel",
"parameters": [
{
"name": "actuator channel",
"description": "You specify the actuator channel parameter as the number of the channel you want to close (8 or 9).",
"values": [
{
"parameter": 8,
"description": "Actuator channel 8"
},
{
"parameter": 9,
"description": "Actuator channel 9"
}
],
"power_on_raw": "none (both channels open)",
"default_raw": "8"
}
],
"important_points": [
"On channels 8 and 9 there are separate current input relays and actuator output relays. If a current input relay is closed and you execute the CLOSE command on the same channel, the actuator closes then the current relay opens. The CLOSE command does not affect the present state of channels 0-7 or 10-13.",
"When power is applied, the HP 3457 performs a card reset which opens actuator channels 8 and 9 on the HP 44491.",
"You do not need to specify the HP 44491 as the input source (TERM command) to close or open an actuator.",
"If you execute the CLOSE command without a plug-in card in the HP 3457's rear slot, you'll get the BAD HEADER error."
],
"examples": [
{
"code": "OUTPUT 722;\"CLOSE 8\"",
"comment": "CLOSES THE CHANNEL 8 ACTUATOR"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "CRESET",
"manual_pages": [
"4-37"
],
"local": true,
"remote": true,
"description": "The CRESET (card reset) command opens all channels on a plug-in card without changing the HP 3457's configuration.",
"syntax": "CRESET",
"parameters": [],
"important_points": [
"The HP 3457 performs a card reset whenever you apply power or when you execute the RESET command.",
"The CRESET command opens any channel closed in a scan list. However, the CRESET command leaves the scan list intact and retains the present position in the list. The CRESET command executes a scan advance hold (SADV HOLD), stopping any scan sequence. If, for example, you execute a single scan advance after a card reset, an advance occurs to the next channel in the scan list.",
"If you issue the CRESET command without a plug-in card in the HP 3457's rear slot, you'll get the BAD HEADER error."
],
"examples": [
{
"code": "OUTPUT 722;\"CRESET\"",
"comment": "RESETS THE CARD IN THE REAR SLOT"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "CSB",
"manual_pages": [
"4-38"
],
"local": true,
"remote": true,
"description": "The CSB (clear status byte) command clears (sets to 0) all bits in the status register.",
"syntax": "CSB",
"parameters": [],
"important_points": [
"If an event that set a bit in the status register is still in effect, the bit will be immediately set again after you send the CSB command.",
"When you clear bit 6 (service requested) the HP 3457 sets the HP-IB SRQ line false."
],
"examples": [
{
"code": "OUTPUT 722;\"CSB\"",
"comment": "CLEARS THE STATUS REGISTER"
}
],
"tier": "extended",
"tier_reason": "clears status register; useful but rarely needed beyond what ERR?/STB? already handle by reading",
"rationale": "status_error_readback"
},
{
"name": "DCI",
"manual_pages": [
"4-39",
"4-40",
"4-41"
],
"local": false,
"remote": true,
"description": "The DCI (DC current) command instructs the HP 3457 to measure DC current. It also allows you to specify the measurement range and resolution.",
"syntax": "DCI max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of five standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's expected peak amplitude.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - .0003",
"selects_range": "300 µA",
"full_scale_reading": "303 µA",
"power_on": false,
"default": false
},
{
"parameter": "> .0003 - .003",
"selects_range": "3 mA",
"full_scale_reading": "3.03 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .003 - .03",
"selects_range": "30 mA",
"full_scale_reading": "30.3 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mA",
"full_scale_reading": "303 mA",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 1.5",
"selects_range": "1.5 A",
"full_scale_reading": "1.5 A",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified by the NPLC command (power-on NPLC = 10)"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select DC current measurements using the DCI key or by accessing the FUNC command from the alphabetic command directory. The DCI key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCI .6,.167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC current, .6A max, .167% resolution",
"note": "The resolution specified by line 20 is .6A x .00167 = .001A."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCI AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC current, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"DCI 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects DC current, 1A max, .1% resolution",
"note": "The requested resolution from line 20 is 1A x .001 = .001A, but because of line 10 the actual resolution is .000001A."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "DCV",
"manual_pages": [
"4-42",
"4-43",
"4-44"
],
"local": false,
"remote": true,
"description": "The DCV (DC voltage) command instructs the HP 3457 to measure DC voltage. It also allows you to specify the measurement range and resolution.",
"syntax": "DCV max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of five standard ranges or the autorange mode. To select a standard range, you specify max. input as the input signal's expected peak amplitude.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": true,
"default": true
},
{
"parameter": "0 - .03",
"selects_range": "30 mV",
"full_scale_reading": "30.3 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .03 - .3",
"selects_range": "300 mV",
"full_scale_reading": "303 mV",
"power_on": false,
"default": false
},
{
"parameter": "> .3 - 3",
"selects_range": "3 V",
"full_scale_reading": "3.03 V",
"power_on": false,
"default": false
},
{
"parameter": "> 3 - 30",
"selects_range": "30 V",
"full_scale_reading": "30.3 V",
"power_on": false,
"default": false
},
{
"parameter": "> 30 - 300",
"selects_range": "300 V",
"full_scale_reading": "303 V",
"power_on": false,
"default": false
}
],
"power_on_raw": "AUTO",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "determined by the integration time specified by the NPLC command",
"default_raw": "determined by the integration time specified by the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select DC voltage measurements using the DCV key or by accessing the FUNC command from the alphabetic command directory. The DCV key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution. See \"The A/D Converter,\" Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCV 6,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC volts, 6V max, .0167% resolution",
"note": "The resolution specified by line 20 is 6V x .000167 = .001V."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCV AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC volts, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"DCV 1,.1\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects DC volts, 1V max, .1% resolution",
"note": "The requested resolution from line 20 is 1V x .001 = .001V, but because of line 10 the actual resolution is .000001V."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "DELAY",
"manual_pages": [
"4-45"
],
"local": true,
"remote": true,
"description": "The DELAY command allows you to specify a time interval that is inserted before a measurement. If you are using the DELAY command and the TIMER parameter in the NRDGS command, the delay is inserted between the trigger event and the first measurement. If you are not using the TIMER parameter, the delay is inserted between the sample event and the first measurement. See \"Triggering\" in Chapter 3.",
"syntax": "DELAY time",
"parameters": [
{
"name": "time",
"description": "You specify the time parameter as the delay time you want, in seconds. Delay time can range between 1E-6 (1 µs) and 2100 seconds.",
"values": [],
"power_on_raw": "automatic (determined by function, range, resolution and ACBAND selection)",
"default_raw": "automatic (determined by function, range, resolution and ACBAND selection)"
}
],
"important_points": [
"The default or power-on delay changes automatically whenever you change the measurement function (DCV, ACV, etc.), the range, the resolution, or the AC measurement mode (ACBAND command). Table 3-15 shows the default and power-on delays used by the HP 3457 for all combinations of measurement functions, ranges, resolution and ACBAND.",
"The power-on or default delay is calculated for the amount of time necessary to process a newly applied AC signal. If you are measuring slowly changing AC amplitudes, you can make a faster series of measurements by specifying a shorter delay time than the HP 3457 would normally use for the present configuration. The resulting settling time, though, may not allow for accurate readings."
],
"examples": [
{
"code": "OUTPUT 722;\"DELAY 5\"",
"comment": "INSERTS A 5 SECOND DELAY"
}
],
"tier": "extended",
"tier_reason": "manual override of the DMM's automatic settling delay; automatic default is normally correct",
"rationale": "measurement_hardware"
},
{
"name": "DELAY?",
"manual_pages": [
"4-46"
],
"local": true,
"remote": true,
"description": "The DELAY? command returns the present delay time, in seconds.",
"syntax": "DELAY?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the DELAY? command by accessing the DELAY command from the alphabetic command directory and appending a question mark.",
"When you execute the DELAY? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the DELAY? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"DELAY?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the delay time; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "read back DELAY",
"rationale": "measurement_hardware"
},
{
"name": "DIAGNOSTIC",
"manual_pages": [
"4-47"
],
"local": true,
"remote": true,
"description": "This is a service related command. Refer to the HP 3457 Service manual for details.",
"syntax": null,
"parameters": [],
"important_points": [],
"examples": [],
"service_command": true,
"tier": "extended",
"tier_reason": "service-only, no documented syntax",
"rationale": "diagnostic_calibration"
},
{
"name": "DISP",
"manual_pages": [
"4-48",
"4-49"
],
"local": true,
"remote": true,
"description": "The DISP (display) command enables or disables the HP 3457's display. You can also use it to send a message to the display.",
"syntax": "DISP control, message",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Displays message, annunciators inactivated; display shuts off in approximately 3 minutes",
"power_on": false,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Normal (power-on mode) display operation",
"power_on": true,
"default": true
},
{
"parameter": "MSG",
"decimal_equiv": 2,
"description": "Display message, annunciators activated",
"power_on": false,
"default": false
}
],
"power_on_raw": "ON",
"default_raw": "ON"
},
{
"name": "message",
"description": "The message parameter is the message you want to display. It may contain spaces, any numeral, lower case letters (converted and displayed as upper case), upper case letters, and the characters: ! # $ % & ' ( ) * + - = < > ? : ; , . @ [ ] \\ ^ _",
"values": [],
"power_on_raw": null,
"default_raw": null
}
],
"important_points": [
"When a delimiter (space, comma, or semicolon) is in the message, you must use quotation marks to indicate to the HP 3457 that the delimiter is part of the message.",
"You can only send a message from the controller. The HP 3457 ignores messages originating from its keyboard.",
"The HP 3457 displays only the first 12 characters in a message and ignores any additional characters. However, since commas and periods share a display space with the preceding character, they are not considered individual characters."
],
"examples": [
{
"code": "OUTPUT 722;\"DISP OFF,TIME-OUT\"",
"comment": "DISPLAYS TIME-OUT",
"note": "The annunciators are inactivated and after approximately 3 minutes the display shuts off. Since there are no delimiters in the message, extra quotation marks are not required."
},
{
"code": "OUTPUT 722;\"DISP MSG,\"&CHR$(34)&\"TIME OUT\"&CHR$(34)",
"comment": "DISPLAYS TIME OUT",
"note": "Works on both HP Series-80 and Series-200 controllers. The message contains a space delimiter; since you cannot embed quotation marks on some Series-80 controllers, this line uses the ASCII equivalent (CHR$(34)). The & character concatenates strings."
},
{
"code": "OUTPUT 722;\"DISP OFF,\"\"TIME OUT\"\"\"",
"comment": "DISPLAYS TIME OUT",
"note": "Works on HP Series-200 controllers, which allow embedded quotation marks directly."
}
],
"tier": "extended",
"tier_reason": "front-panel display content -- irrelevant when no one is watching the panel during automated acquisition",
"rationale": "ui_frontpanel_only"
},
{
"name": "EMASK",
"manual_pages": [
"4-50"
],
"local": true,
"remote": true,
"description": "The EMASK (error mask) command allows you to designate which error conditions will set the error bit (bit 5) in the status register.",
"syntax": "EMASK value",
"parameters": [
{
"name": "value",
"description": "You enable (designate) an error condition by specifying its decimal weight as the value parameter. For more than one error condition, specify the sum of the weights.",
"values": [
{
"parameter": 1,
"bit": 0,
"description": "Hardware error - check the auxiliary error register"
},
{
"parameter": 2,
"bit": 1,
"description": "Error in the CAL or ACAL process"
},
{
"parameter": 4,
"bit": 2,
"description": "Trigger too fast"
},
{
"parameter": 8,
"bit": 3,
"description": "Syntax error"
},
{
"parameter": 16,
"bit": 4,
"description": "Unknown command received"
},
{
"parameter": 32,
"bit": 5,
"description": "Unknown parameter received"
},
{
"parameter": 64,
"bit": 6,
"description": "Parameter out of range"
},
{
"parameter": 128,
"bit": 7,
"description": "Required parameter missing"
},
{
"parameter": 256,
"bit": 8,
"description": "Parameter ignored"
},
{
"parameter": 512,
"bit": 9,
"description": "Out of calibration"
},
{
"parameter": 1024,
"bit": 10,
"description": "Autocal required"
}
],
"power_on_raw": "2047 (all enabled)",
"default_raw": "2047 (all enabled)"
}
],
"important_points": [
"When an error occurs, it sets the corresponding bit in the error register regardless of whether it has been enabled by the EMASK command."
],
"examples": [
{
"code": "OUTPUT 722;\"EMASK 4\"",
"comment": "ENABLES THE TRIGGER TOO FAST ERROR"
},
{
"code": "OUTPUT 722;\"EMASK 40\"",
"comment": "ENABLES SYNTAX (8) & UNKNOWN PARAMETER (32) ERRORS"
},
{
"code": "OUTPUT 722;\"EMASK 2047\"",
"comment": "ENABLES ALL ERRORS"
},
{
"code": "OUTPUT 722;\"EMASK 0\"",
"comment": "DISABLES ALL ERRORS"
}
],
"tier": "extended",
"tier_reason": "configures which errors set the status register's error bit -- relevant mainly for interrupt/SRQ-driven architectures",
"rationale": "status_error_readback"
},
{
"name": "END",
"manual_pages": [
"4-51"
],
"local": true,
"remote": true,
"description": "The END command enables or disables the HP-IB End Or Identify (EOI) function. When enabled, the HP-IB EOI line is set true concurrent with the transmission of the last data byte for any output format.",
"syntax": "END control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "EOI line never set true",
"power_on": true,
"default": false
},
{
"parameter": "ALWAYS",
"decimal_equiv": 2,
"description": "EOI line set true concurrent with last data byte",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ALWAYS"
}
],
"important_points": [
"The ASCII output format sends <CR><LF> (carriage-return line-feed) on the data bus following each transmission of data. This indicates the end of the transmission to most computers. The other output formats (DINT, SINT, and SREAL) do not send <CR><LF>. With these formats you can set END to ALWAYS to indicate the end of the transmission.",
"Check your computer manual for information on how your computer responds to the EOI line."
],
"examples": [
{
"code": "OUTPUT 722;\"END ALWAYS\"",
"comment": "ENABLES HP-IB EOI"
}
],
"tier": "protocol",
"tier_reason": "GPIB EOI line behavior -- bus/transport housekeeping",
"rationale": "bus_protocol"
},
{
"name": "ERR?",
"manual_pages": [
"4-52",
"4-53"
],
"local": true,
"remote": true,
"description": "When an error occurs, it sets a bit in the error register and causes the display's ERR annunciator to flash. The ERR? (error?) command returns a number representing all set bits, clears the register, and shuts off the annunciator. The returned number is the weighted sum of all set bits.",
"syntax": "ERR?",
"parameters": [
{
"name": "(none; query command)",
"description": "Error conditions and their weighted values:",
"values": [
{
"parameter": 1,
"bit": 0,
"description": "Hardware error - check the auxiliary error register"
},
{
"parameter": 2,
"bit": 1,
"description": "Error in the CAL or ACAL process"
},
{
"parameter": 4,
"bit": 2,
"description": "Trigger too fast"
},
{
"parameter": 8,
"bit": 3,
"description": "Syntax error"
},
{
"parameter": 16,
"bit": 4,
"description": "Unknown command received"
},
{
"parameter": 32,
"bit": 5,
"description": "Unknown parameter received"
},
{
"parameter": 64,
"bit": 6,
"description": "Parameter out of range"
},
{
"parameter": 128,
"bit": 7,
"description": "Required parameter missing"
},
{
"parameter": 256,
"bit": 8,
"description": "Parameter ignored"
},
{
"parameter": 512,
"bit": 9,
"description": "Out of calibration"
},
{
"parameter": 1024,
"bit": 10,
"description": "Autocal required"
}
],
"power_on_raw": null,
"default_raw": null
}
],
"important_points": [
"The ERR? command returns a 0 if no error bits are set.",
"If bit 0 is set (weight = 1), refer to the auxiliary error register (AUXERR? command) for more information.",
"Executing the ERR? command clears the status register's error bit (bit 5).",
"The shifted ERROR key on the HP 3457's front panel displays and clears error bits one at a time.",
"When you execute the ERR? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the ERR? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"ERR?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 reads & clears the error register; line 20 enters the weighted sum into variable A; line 30 displays the weighted sum",
"note": "If this program returns the weighted sum 513, that means the errors with weighted values 1 (hardware error) and 512 (out of calibration) have occurred."
}
],
"tier": "core",
"tier_reason": "error register read/clear -- basic error handling",
"rationale": "status_error_readback"
},
{
"name": "F10",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, Autorange range.",
"syntax": "F10",
"selects_function": "DC Voltage",
"selects_range": "Autorange",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [
{
"code": "OUTPUT 722;\"F10BEEP\"",
"comment": "SELECTS DC VOLTAGE, AUTORANGE, BEEPS ONCE",
"note": "Demonstrates appending another command directly after an F10-F58 command with no delimiter needed."
}
],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F11",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, 30 mV range.",
"syntax": "F11",
"selects_function": "DC Voltage",
"selects_range": "30 mV",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F12",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, 300 mV range.",
"syntax": "F12",
"selects_function": "DC Voltage",
"selects_range": "300 mV",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F13",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, 3 V range.",
"syntax": "F13",
"selects_function": "DC Voltage",
"selects_range": "3 V",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F14",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, 30 V range.",
"syntax": "F14",
"selects_function": "DC Voltage",
"selects_range": "30 V",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F15",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: DC Voltage, 300 V range.",
"syntax": "F15",
"selects_function": "DC Voltage",
"selects_range": "300 V",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F40",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, Autorange range.",
"syntax": "F40",
"selects_function": "2-Wire Ohms",
"selects_range": "Autorange",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F41",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 30 Ω range.",
"syntax": "F41",
"selects_function": "2-Wire Ohms",
"selects_range": "30 Ω",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F42",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 300 Ω range.",
"syntax": "F42",
"selects_function": "2-Wire Ohms",
"selects_range": "300 Ω",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F43",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 3 kΩ range.",
"syntax": "F43",
"selects_function": "2-Wire Ohms",
"selects_range": "3 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [
{
"code": "OUTPUT 722;\"F43\"",
"comment": "SELECTS 2-WIRE OHMS, 3 KΩ RANGE"
}
],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F44",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 30 kΩ range.",
"syntax": "F44",
"selects_function": "2-Wire Ohms",
"selects_range": "30 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F45",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 300 kΩ range.",
"syntax": "F45",
"selects_function": "2-Wire Ohms",
"selects_range": "300 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F46",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 3 MΩ range.",
"syntax": "F46",
"selects_function": "2-Wire Ohms",
"selects_range": "3 MΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F47",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 30 MΩ range.",
"syntax": "F47",
"selects_function": "2-Wire Ohms",
"selects_range": "30 MΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F48",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 2-Wire Ohms, 3 GΩ range.",
"syntax": "F48",
"selects_function": "2-Wire Ohms",
"selects_range": "3 GΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F50",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, Autorange range.",
"syntax": "F50",
"selects_function": "4-Wire Ohms",
"selects_range": "Autorange",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F51",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 30 Ω range.",
"syntax": "F51",
"selects_function": "4-Wire Ohms",
"selects_range": "30 Ω",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F52",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 300 Ω range.",
"syntax": "F52",
"selects_function": "4-Wire Ohms",
"selects_range": "300 Ω",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F53",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 3 kΩ range.",
"syntax": "F53",
"selects_function": "4-Wire Ohms",
"selects_range": "3 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F54",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 30 kΩ range.",
"syntax": "F54",
"selects_function": "4-Wire Ohms",
"selects_range": "30 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F55",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 300 kΩ range.",
"syntax": "F55",
"selects_function": "4-Wire Ohms",
"selects_range": "300 kΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F56",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 3 MΩ range.",
"syntax": "F56",
"selects_function": "4-Wire Ohms",
"selects_range": "3 MΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F57",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 30 MΩ range.",
"syntax": "F57",
"selects_function": "4-Wire Ohms",
"selects_range": "30 MΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "F58",
"manual_pages": [
"4-54",
"4-55"
],
"local": false,
"remote": true,
"description": "One of the F10-F58 family of special high speed commands. Each mnemonic (F10, F11, ... F58) is a complete, standalone, zero-parameter command that directly selects a specific measurement function and range in one step. The F10-F58 commands configure the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF, optionally combined with RANGE) -- this is a distinct command for every function+range combination, not a parameterized single command. This specific command selects: 4-Wire Ohms, 3 GΩ range.",
"syntax": "F58",
"selects_function": "4-Wire Ohms",
"selects_range": "3 GΩ",
"parameters": [],
"important_points": [
"You can append another HP 3457 command to an F10-F58 command without the need for a delimiter. This is shown in the second example below.",
"If you attempt to store an F10-F58 command in a subprogram, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"If the input buffer is enabled (INBUF ON command) and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus.",
"The Operating manual states this command family \"configure[s] the HP 3457 much more rapidly than their function command counterparts (DCV, OHM, or OHMF)\" but does not explain the mechanism. The Service manual (Section VIII, \"Cross-Isolation Link\") explains why this is architecturally plausible: the HP-IB/main controller (assembly A1) and the floating-common A/D measurement processor (assembly A2) are electrically isolated from each other for measurement accuracy, and communicate only through an opto-isolated full-duplex UART link running at 187 kHz with 11-bit frames (1 start + 8 data + 1 parity + 1 stop). Any command that changes function/range must have that result relayed across this comparatively slow isolated link before a measurement can occur. A single reserved Fxx token plausibly lets the main controller skip ASCII/numeric parsing and range-matching and send a simpler, more direct message across that link, versus DCV/OHM/OHMF which must parse a free-form numeric range parameter first. This is informed inference from the confirmed hardware architecture, not something the manuals state explicitly in these terms."
],
"examples": [],
"family": "F10-F58",
"tier": "extended",
"tier_reason": "high-speed shorthand duplicate of DCV/OHM/OHMF + RANGE, explicitly documented as existing to save command-parsing time on the original slow 1980s HP-IB controllers this instrument targeted; a modern controller has no such bottleneck, so prefer the clearer FUNC/DCV/OHM/OHMF + RANGE forms unless a specific measured latency problem justifies it",
"rationale": "wire_efficiency"
},
{
"name": "FIXEDZ",
"manual_pages": [
"4-56"
],
"local": true,
"remote": true,
"description": "The FIXEDZ (fixed impedance) command enables or disables the fixed input impedance function for DC voltage measurements. When enabled, the HP 3457 maintains its input impedance at 10 megohms for all ranges. This prevents a change in input impedance (caused by a range change) from affecting the DC voltage measurements.",
"syntax": "FIXEDZ control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are (input impedance shown for each range group):",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "FIXEDZ disabled",
"input_impedance_dcv_03_3_3v_ranges": "10 GΩ",
"input_impedance_dcv_30_300v_ranges": "10 MΩ",
"power_on": true,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "FIXEDZ enabled",
"input_impedance_dcv_03_3_3v_ranges": "10 MΩ",
"input_impedance_dcv_30_300v_ranges": "10 MΩ",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ON"
}
],
"important_points": [
"FIXEDZ remains enabled when you change from DC voltage measurements to 2-wire or 4-wire ohms measurements. For example, if FIXEDZ is enabled and you change from DC voltage measurements to 2-wire ohms, FIXEDZ remains enabled and the HP 3457 measures the 10 megohm FIXEDZ resistor.",
"FIXEDZ is temporarily disabled when you change from DC voltage measurements to AC voltage, AC+DC voltage, any type of current, frequency, or period measurements. When you return to DC voltage measurements, FIXEDZ is once again enabled."
],
"examples": [
{
"code": "OUTPUT 722;\"FIXEDZ ON\"",
"comment": "ENABLES FIXED IMPEDANCE"
}
],
"tier": "extended",
"tier_reason": "niche DCV input-impedance behavior; only matters for specific high-impedance source loading scenarios",
"rationale": "measurement_hardware"
},
{
"name": "FIXEDZ?",
"manual_pages": [
"4-57"
],
"local": true,
"remote": true,
"description": "The FIXEDZ? (fixed impedance?) command returns a number indicating whether fixed input impedance is on or off: 1 = ON, 0 = OFF.",
"syntax": "FIXEDZ?",
"parameters": [],
"important_points": [
"When you execute the FIXEDZ? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the FIXEDZ? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"FIXEDZ?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the FIXEDZ state; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "read back FIXEDZ state",
"rationale": "measurement_hardware"
},
{
"name": "FREQ",
"manual_pages": [
"4-58",
"4-59"
],
"local": false,
"remote": true,
"description": "The FREQ (frequency) command instructs the HP 3457 to measure frequency. It also allows you to specify the amplitude range of the input signal.",
"syntax": "FREQ max. input",
"parameters": [
{
"name": "max. input",
"description": "NOTE: max. input selects the amplitude range of the input signal, not the frequency range (Hz). It selects a standard range or the autorange mode; specify the maximum expected amplitude of the input signal, or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "Autorange"
},
{
"parameter": "0 - .03",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "30 mV"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "300 mV"
},
{
"parameter": "> .3 - 3",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "3 V"
},
{
"parameter": "> 3 - 30",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "30 V"
},
{
"parameter": "> 30 - 300",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "300 V"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "AC or AC+DC Current",
"selects_range": "Autorange"
},
{
"parameter": "0 - .03",
"measurement_group": "AC or AC+DC Current",
"selects_range": "30 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC or AC+DC Current",
"selects_range": "300 mA"
},
{
"parameter": "> .3 - 1",
"measurement_group": "AC or AC+DC Current",
"selects_range": "1 A"
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
}
],
"important_points": [
"You use the FREQ command along with the FSOURCE command. FSOURCE designates whether the input signal is AC voltage, AC+DC voltage, AC current, or AC+DC current.",
"Seven digits of resolution are always provided for frequency measurements regardless of the specified amount of integration time (NPLC command). The integration time does, however, affect the measurement speed.",
"From the front panel, you select frequency measurements using the FREQ key or by accessing the FUNC command from the alphabetic command directory. The FREQ key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution."
],
"examples": [
{
"code": "10 OUTPUT 722;\"FSOURCE ACI\"\n20 OUTPUT 722;\"FREQ .03\"\n30 END",
"comment": "line 10 selects AC current as the input source; line 20 selects frequency measurements on the 30mA range"
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "FSOURCE",
"manual_pages": [
"4-60"
],
"local": true,
"remote": true,
"description": "The FSOURCE (frequency source) command configures the HP 3457 to accept either AC voltage, AC+DC voltage, AC current, or AC+DC current as the input signal for frequency or period measurements.",
"syntax": "FSOURCE source",
"parameters": [
{
"name": "source",
"description": "The source parameter choices are:",
"values": [
{
"parameter": "ACV",
"decimal_equiv": 2,
"description": "Configures the HP 3457 for an AC voltage input",
"power_on": true,
"default": true
},
{
"parameter": "ACDCV",
"decimal_equiv": 3,
"description": "Configures the HP 3457 for an AC+DC voltage input",
"power_on": false,
"default": false
},
{
"parameter": "ACI",
"decimal_equiv": 7,
"description": "Configures the HP 3457 for an AC current input",
"power_on": false,
"default": false
},
{
"parameter": "ACDCI",
"decimal_equiv": 8,
"description": "Configures the HP 3457 for an AC+DC current input",
"power_on": false,
"default": false
}
],
"power_on_raw": "ACV",
"default_raw": "ACV"
}
],
"important_points": [
"The FSOURCE command does not alter the present ACBAND (AC fast or slow) configuration."
],
"examples": [
{
"code": "10 OUTPUT 722;\"FSOURCE ACDCI\"\n20 OUTPUT 722;\"FREQ .03\"\n30 END",
"comment": "line 10 selects AC+DC current as the input source; line 20 selects frequency measurements, 30mA range"
}
],
"tier": "core",
"tier_reason": "required companion setup for FREQ/PER measurements",
"rationale": "measurement_hardware"
},
{
"name": "FUNC",
"manual_pages": [
"4-61",
"4-62",
"4-63",
"4-64"
],
"local": true,
"remote": true,
"description": "The FUNC (function) command selects the type of measurement (AC voltage, DC current, etc.). It also allows you to specify the measurement range and resolution.",
"syntax": "FUNC function, max. input, % resolution",
"parameters": [
{
"name": "function",
"description": "The function parameter designates the type of measurement.",
"values": [
{
"parameter": "DCV",
"decimal_equiv": 1,
"description": "Selects DC voltage measurements",
"power_on": true,
"default": true
},
{
"parameter": "ACV",
"decimal_equiv": 2,
"description": "Selects AC voltage measurements",
"power_on": false,
"default": false
},
{
"parameter": "ACDCV",
"decimal_equiv": 3,
"description": "Selects AC+DC voltage measurements",
"power_on": false,
"default": false
},
{
"parameter": "OHM",
"decimal_equiv": 4,
"description": "Selects 2-wire ohms measurements",
"power_on": false,
"default": false
},
{
"parameter": "OHMF",
"decimal_equiv": 5,
"description": "Selects 4-wire ohms measurements",
"power_on": false,
"default": false
},
{
"parameter": "DCI",
"decimal_equiv": 6,
"description": "Selects DC current measurements",
"power_on": false,
"default": false
},
{
"parameter": "ACI",
"decimal_equiv": 7,
"description": "Selects AC current measurements",
"power_on": false,
"default": false
},
{
"parameter": "ACDCI",
"decimal_equiv": 8,
"description": "Selects AC+DC current measurements",
"power_on": false,
"default": false
},
{
"parameter": "FREQ",
"decimal_equiv": 9,
"description": "Selects frequency measurements",
"power_on": false,
"default": false
},
{
"parameter": "PER",
"decimal_equiv": 10,
"description": "Selects period measurements",
"power_on": false,
"default": false
}
],
"power_on_raw": "DCV",
"default_raw": "DCV"
},
{
"name": "max. input",
"description": "The max. input parameter selects a standard range or the autorange mode. You specify max. input as the input signal's maximum expected amplitude (or the maximum resistance for ohms measurements), or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"measurement_group": "Voltage",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - .03",
"measurement_group": "Voltage",
"selects_range": "30 mV",
"full_scale_reading": "30.3 mV DC, 32.5 mV AC"
},
{
"parameter": "> .03 - .3",
"measurement_group": "Voltage",
"selects_range": "300 mV",
"full_scale_reading": "303 mV DC, 325 mV AC"
},
{
"parameter": "> .3 - 3",
"measurement_group": "Voltage",
"selects_range": "3 V",
"full_scale_reading": "3.03 V DC, 3.25 V AC"
},
{
"parameter": "> 3 - 30",
"measurement_group": "Voltage",
"selects_range": "30 V",
"full_scale_reading": "30.3 V DC, 32.5 V AC"
},
{
"parameter": "> 30 - 300",
"measurement_group": "Voltage",
"selects_range": "300 V",
"full_scale_reading": "303 V DC, 303 V AC"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "AC Current",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - .03",
"measurement_group": "AC Current",
"selects_range": "30 mA",
"full_scale_reading": "32.5 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC Current",
"selects_range": "300 mA",
"full_scale_reading": "325 mA"
},
{
"parameter": "> .3 - 1",
"measurement_group": "AC Current",
"selects_range": "1 A",
"full_scale_reading": "1.05 A"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "DC Current",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - .0003",
"measurement_group": "DC Current",
"selects_range": "300 µA",
"full_scale_reading": "303 µA"
},
{
"parameter": "> .0003 - .003",
"measurement_group": "DC Current",
"selects_range": "3 mA",
"full_scale_reading": "3.03 mA"
},
{
"parameter": "> .003 - .03",
"measurement_group": "DC Current",
"selects_range": "30 mA",
"full_scale_reading": "30.3 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "DC Current",
"selects_range": "300 mA",
"full_scale_reading": "303 mA"
},
{
"parameter": "> .3 - 1.5",
"measurement_group": "DC Current",
"selects_range": "1.5 A",
"full_scale_reading": "1.5 A"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "Ohms",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - 30",
"measurement_group": "Ohms",
"selects_range": "30 Ω",
"full_scale_reading": "30.3 Ω"
},
{
"parameter": "> 30 - 300",
"measurement_group": "Ohms",
"selects_range": "300 Ω",
"full_scale_reading": "303 Ω"
},
{
"parameter": "> 300 - 3E3",
"measurement_group": "Ohms",
"selects_range": "3 kΩ",
"full_scale_reading": "3.03 kΩ"
},
{
"parameter": "> 3E3 - 3E4",
"measurement_group": "Ohms",
"selects_range": "30 kΩ",
"full_scale_reading": "30.3 kΩ"
},
{
"parameter": "> 3E4 - 3E5",
"measurement_group": "Ohms",
"selects_range": "300 kΩ",
"full_scale_reading": "303 kΩ"
},
{
"parameter": "> 3E5 - 3E6",
"measurement_group": "Ohms",
"selects_range": "3 MΩ",
"full_scale_reading": "3.03 MΩ"
},
{
"parameter": "> 3E6 - 3E7",
"measurement_group": "Ohms",
"selects_range": "30 MΩ",
"full_scale_reading": "30.3 MΩ"
},
{
"parameter": "> 3E7 - 3E9",
"measurement_group": "Ohms",
"selects_range": "3 GΩ",
"full_scale_reading": "3.03 GΩ"
}
],
"power_on_raw": "AUTO",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "determined by the integration time specified in the NPLC command",
"default_raw": "determined by the integration time specified in the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"FUNC DCV,6,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC voltage, 6V max, .0167% resolution",
"note": "The resolution specified by line 20 is 6V x .000167 = .001V."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"FUNC ACI,AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects AC current, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"FUNC OHM,1E3,.01\"\n30 END",
"comment": "line 10 sets PLCs to maximum; line 20 selects 2-wire ohms, 1kΩ max, .01% resolution",
"note": "The requested resolution from line 20 is 1kΩ x .0001 = .1Ω, but because of line 10 the actual resolution is .000001Ω."
}
],
"tier": "core",
"tier_reason": "generic form of the measurement-function commands; needed when range/resolution must be set in the same call",
"rationale": "measurement_hardware"
},
{
"name": "ID?",
"manual_pages": [
"4-65"
],
"local": true,
"remote": true,
"description": "The ID? (identity?) command returns the response \"HP3457A\". This allows you to easily locate the HP 3457, by its address, from remote.",
"syntax": "ID?",
"parameters": [],
"important_points": [
"The response \"HP3457A\" contains alpha and numeric characters. Some computer variables can only store numeric characters. When you use one of these variables, only the numeric portion (3457) is stored.",
"When you execute the ID? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the ID? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"ID?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the response; line 20 enters the response into the computer's numeric A variable; line 30 displays the response",
"note": "On an HP Series 80 computer, a simple (numeric) variable can only store numeric characters, so only \"3457\" is stored and displayed."
},
{
"code": "10 OUTPUT 722;\"ID?\"\n20 ENTER 722;A$\n30 DISP A$\n40 END",
"comment": "line 10 returns the response; line 20 enters the response into the computer's string A$ variable; line 30 displays the response",
"note": "A string variable can store both alpha and numeric characters, so the entire response \"HP3457A\" is stored and displayed."
}
],
"tier": "core",
"tier_reason": "device identification -- used to confirm you're actually talking to an HP 3457A",
"rationale": "bus_protocol"
},
{
"name": "INBUF",
"manual_pages": [
"4-66",
"4-67"
],
"local": true,
"remote": true,
"description": "The INBUF (input buffer) command enables or disables the HP 3457's input buffer. When enabled, the input buffer temporarily stores the commands it receives over the HP-IB bus. This releases the HP-IB bus immediately after the command is received, allowing the controller to perform other tasks while the HP 3457 is executing commands.",
"syntax": "INBUF control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Disables the input buffer - commands are only accepted when the HP 3457 is not busy",
"power_on": true,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Enables the input buffer - commands are stored, releasing the bus immediately",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ON"
}
],
"important_points": [
"When the input buffer is ON, you lose synchronization with the controller. Monitor the ready bit in the HP 3457's status register to determine when the contents of the input buffer have been executed (see the example below).",
"If you send more commands than the input buffer can store, the HP 3457 holds the bus until a command is executed, making buffer space available. By doing this, no commands are lost because of a full input buffer. The input buffer is 255 bytes long. You can use the procedure under \"Subprogram Storage\" in Chapter 3 to determine the number of bytes required per command.",
"The input buffer functions differently when you send an F10-F58 command. If the input buffer is enabled and you send an F10-F58 command, the HP 3457 (1) holds the bus, (2) empties the buffer, (3) executes the F10-F58 command, and (4) releases the bus."
],
"examples": [
{
"code": "10 OUTPUT 722;\"INBUF ON\"\n20 OUTPUT 722;\"TRIG HOLD\"\n30 OUTPUT 722;\"NPLC 10\"\n40 OUTPUT 722;\"NRDGS 10,AUTO\"\n50 OUTPUT 722;\"OHM\"\n60 P=SPOLL(722)\n70 IF BIT(P,4)=1 THEN GOTO 60\n80 OUTPUT 722;\"TRIG SGL\"\n90 END",
"comment": "enables the input buffer, queues TRIG HOLD/NPLC 10/NRDGS 10,AUTO/OHM, then polls the status byte's ready bit (bit 4) until the queued commands finish executing, then triggers a single measurement",
"note": "Lines 20-50 are placed in the input buffer and executed one at a time. Lines 60-70 monitor the ready bit until it goes to 0, meaning the buffered commands have executed."
}
],
"tier": "protocol",
"tier_reason": "input buffer on/off -- directly controls the CR/LF bus-hold behavior; important to get right, see _meta.language_conventions",
"rationale": "bus_protocol"
},
{
"name": "ISCALE?",
"manual_pages": [
"4-68",
"4-69"
],
"local": true,
"remote": true,
"description": "The ISCALE? (integer scale?) command returns the scale factor for a particular reading. When using the SINT or DINT output format, you can multiply the scale factor times the reading to convert it from integer format into fundamental units (volts, ohms, etc.).",
"syntax": "ISCALE?",
"parameters": [],
"important_points": [
"The scale factor is always 1 for the ASCII and SREAL output formats.",
"When using the SINT or DINT output format, the HP 3457 calculates a scale factor for each reading based on the present measurement function, range, A/D setting, and enabled math operations. Ensure that the HP 3457's configuration is the same when making measurements as it is when you retrieve the scale factor.",
"When using autorange and the DINT or SINT output format, a different scale factor may be applied for each range change. Tables 3-11 and 3-12 show the scale factors for all ranges in the SINT and DINT output formats.",
"When a math function is enabled (except STAT or PFAIL), the scale factor is always 1. When using the SINT or DINT output format with a math function enabled, you will be unable to use the ISCALE? command to retrieve the correct scale factor. Use Table 3-11 or 3-12 to determine the scale factor.",
"Always retrieve the reading from the output buffer before sending the ISCALE? command from the controller. If you send the ISCALE? command first, the reading may be destroyed.",
"When you execute the ISCALE? command from the HP 3457's front panel, the scale factor goes to the display. When executed from the controller, the scale factor goes to the HP 3457's output buffer in ASCII format. After executing the ISCALE? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"You specify the output format using the OFORMAT command."
],
"examples": [
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"OFORMAT DINT\"\n30 OUTPUT 722;\"TRIG SGL\"\n40 ENTER 722 USING \"#,B\";A,B,C,D\n50 T=A*16777216+B*65536+C*256+D\n60 IF A>127 THEN T=T-4294967296\n70 OUTPUT 722;\"ISCALE?\"\n80 ENTER 722;I\n90 R=T*I\n100 DISP R\n110 END",
"comment": "DINT format example: selects DCV, sets DINT output format, triggers a measurement, reads the 4-byte integer reading, corrects for sign, reads the scale factor, and converts to volts",
"note": "The reading is entered into the A,B,C,D variables using the # and B image specifiers (line 40): # suppresses the need for <CR><LF> following the transmission, and B enters the reading as four 8-bit bytes."
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"OFORMAT SINT\"\n30 OUTPUT 722;\"TRIG SGL\"\n40 ENTER 722 USING \"#,W\";A\n50 OUTPUT 722;\"ISCALE?\"\n60 ENTER 722;I\n70 R=A*I\n80 DISP R\n90 END",
"comment": "SINT format example: selects DCV, sets SINT output format, triggers a measurement, reads the 2-byte integer reading, reads the scale factor, and converts to volts",
"note": "The reading is entered into the A variable using the # and W image specifiers (line 40): # suppresses the need for <CR><LF>, and W enters the reading as two 8-bit bytes."
}
],
"tier": "core",
"tier_reason": "required to interpret SINT/DINT readings correctly",
"rationale": "bus_protocol"
},
{
"name": "LFREQ",
"manual_pages": [
"4-70"
],
"local": true,
"remote": true,
"description": "The LFREQ (line frequency) command allows you to change the line frequency reference used by the HP 3457's A/D converter.",
"syntax": "LFREQ value",
"parameters": [
{
"name": "value",
"description": "You specify the value parameter as 50 or 60 (Hz).",
"values": [
{
"parameter": 50,
"description": "50 Hz line frequency reference"
},
{
"parameter": 60,
"description": "60 Hz line frequency reference"
}
],
"power_on_raw": "measured line frequency (either 50 or 60 Hz)",
"default_raw": "present value"
}
],
"important_points": [
"When power is applied, the HP 3457 measures the line frequency and uses that value for the A/D converter's reference. You only need to use the LFREQ command if, for some reason, you want to change that frequency."
],
"examples": [
{
"code": "OUTPUT 722;\"LFREQ 50\"",
"comment": "SETS REFERENCE FREQUENCY TO 50 Hz"
}
],
"tier": "extended",
"tier_reason": "overrides the A/D converter's line-frequency reference; the automatic power-on measurement is normally correct",
"rationale": "bus_protocol"
},
{
"name": "LFREQ?",
"manual_pages": [
"4-71"
],
"local": true,
"remote": true,
"description": "The LFREQ? (line frequency?) command returns the value of the line frequency reference used by the HP 3457's A/D converter.",
"syntax": "LFREQ?",
"parameters": [],
"important_points": [
"Do not confuse the LFREQ? command with the LINE? command. LFREQ? returns the specified reference frequency used by the HP 3457's A/D converter. LINE? measures and returns the AC line power's actual frequency.",
"From the HP 3457's front panel, you execute the LFREQ? command by accessing the LFREQ command from the alphabetic command directory and appending a question mark.",
"When you execute the LFREQ? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the LFREQ? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"LFREQ?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the line frequency reference; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "read back LFREQ",
"rationale": "bus_protocol"
},
{
"name": "LINE?",
"manual_pages": [
"4-72"
],
"local": true,
"remote": true,
"description": "The LINE? command measures and returns the AC line power frequency.",
"syntax": "LINE?",
"parameters": [],
"important_points": [
"The LINE? command does not affect the line frequency reference used by the A/D converter.",
"When you execute the LINE? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the LINE? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"LINE?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 measures the line frequency; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "diagnostic line-frequency measurement, unrelated to the instrument's own A/D reference",
"rationale": "bus_protocol"
},
{
"name": "LOCK",
"manual_pages": [
"4-73"
],
"local": true,
"remote": true,
"description": "The LOCK (lockout) command enables or disables the HP 3457's keyboard.",
"syntax": "LOCK control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Enables the keyboard (normal operation)",
"power_on": true,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Disables the keyboard (pressing keys has no effect)",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ON"
}
],
"important_points": [
"The LOCK command is accessible from the front panel's alphabetic command directory. However, executing the LOCK command from the front panel has no effect.",
"When the keyboard is disabled, the HP 3457's reading rate increases slightly since it no longer scans the keyboard between measurements.",
"After disabling the keyboard, you can only enable it from the controller or by cycling power. The LOCK command disables the HP 3457's LOCAL key."
],
"examples": [
{
"code": "OUTPUT 722;\"LOCK ON\"",
"comment": "DISABLES THE KEYBOARD"
}
],
"tier": "extended",
"tier_reason": "disables front-panel keys -- situational (e.g. shared lab equipment), not needed for the measurement API itself",
"rationale": "ui_frontpanel_only"
},
{
"name": "MATH",
"manual_pages": [
"4-74",
"4-75",
"4-76"
],
"local": true,
"remote": true,
"description": "The MATH command enables or disables math operations.",
"syntax": "MATH operation a, operation b",
"parameters": [
{
"name": "operation a / operation b",
"description": "Selects up to two math operations, applied in sequence (operation a first, then operation b on its result). The operation parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Suspends any math operations",
"power_on": true,
"default": true
},
{
"parameter": "CONT",
"decimal_equiv": 1,
"description": "Enables the previous math operation. To resume two math operations send MATH CONT,CONT",
"power_on": false,
"default": false
},
{
"parameter": "CTHRM",
"decimal_equiv": 3,
"description": "Result = temperature (Celsius) of a 5kΩ thermistor (HP 0837-0164). Function must be OHM or OHMF (30kΩ range or higher)",
"power_on": false,
"default": false
},
{
"parameter": "DB",
"decimal_equiv": 4,
"description": "Result = 20 x log10(reading/REF register). The REF register is initialized to 1, yielding dBV",
"power_on": false,
"default": false
},
{
"parameter": "DBM",
"decimal_equiv": 5,
"description": "Result = 20 x log10(reading²/RES register/1mW). Function must be ACV, DCV, or ACDCV",
"power_on": false,
"default": false
},
{
"parameter": "FILTER",
"decimal_equiv": 6,
"description": "Result = output of exponentially weighted digital low-pass filter. Step response is set by the DEGREE register",
"power_on": false,
"default": false
},
{
"parameter": "FTHRM",
"decimal_equiv": 8,
"description": "Result = temperature (Fahrenheit) of a 5kΩ thermistor (HP 0837-0164). Function must be OHM or OHMF (30kΩ range or higher)",
"power_on": false,
"default": false
},
{
"parameter": "NULL",
"decimal_equiv": 9,
"description": "Result = reading - OFFSET register. The OFFSET register is set to the first reading; after that you can change it",
"power_on": false,
"default": false
},
{
"parameter": "PERC",
"decimal_equiv": 10,
"description": "Result = ((reading - PERC register) / PERC register) x 100",
"power_on": false,
"default": false
},
{
"parameter": "PFAIL",
"decimal_equiv": 11,
"description": "Reading vs. MAX and MIN registers",
"power_on": false,
"default": false
},
{
"parameter": "RMS",
"decimal_equiv": 12,
"description": "Result = squares reading, applies FILTER operation, takes square root",
"power_on": false,
"default": false
},
{
"parameter": "SCALE",
"decimal_equiv": 13,
"description": "Result = (reading - OFFSET register) / SCALE register",
"power_on": false,
"default": false
},
{
"parameter": "STAT",
"decimal_equiv": 14,
"description": "Performs statistical calculations on the present set of measurements and stores results in registers: SDEV (standard deviation), MEAN (average of readings), NSAMP (number of readings), UPPER (largest reading), LOWER (smallest reading)",
"power_on": false,
"default": false
}
],
"power_on_raw": "OFF,OFF. Power-on register values: all registers are set to 0 with these exceptions: DEGREE=20, SCALE=1, PERC=1, REF=1, RES=50",
"default_raw": "OFF,OFF"
}
],
"important_points": [
"When you enable a math operation, you disable any previous operation.",
"An enabled math operation is done on every subsequent reading. It stays enabled until you set MATH OFF or replace it by enabling another math operation.",
"When two math operations are enabled, operation a is performed on the reading first. Next, operation b is performed on the result of the first operation.",
"When a math operation is enabled, the display's 1/2 digit becomes a full digit. For example, if you are making 4 1/2 digit AC voltage measurements, and then enable the SCALE math function, the display is capable of showing 5 full digits.",
"You set math registers with the SMATH command. You read math registers using the RMATH command."
],
"examples": [
{
"code": "10 OUTPUT 722;\"OHM\"\n20 OUTPUT 722;\"TRIG HOLD\"\n30 OUTPUT 722;\"MATH NULL,FTHRM\"\n40 DISP \"SHORT LEADS, PRESS CONT\"\n50 PAUSE\n60 OUTPUT 722;\"TRIG SGL\"\n70 DISP \"CONNECT THERM.,PRESS CONT\"\n80 PAUSE\n90 OUTPUT 722;\"TRIG AUTO\"\n100 END",
"comment": "measures a thermistor's Fahrenheit temperature with lead resistance nulled out",
"note": "Line 40 instructs the operator to short the test leads and press continue; the first reading (test lead resistance) is placed in the OFFSET register. Line 70 instructs the operator to connect the leads to the thermistor and press continue. Line 90 sets triggering back to AUTO. In operation, the OFFSET register value is subtracted from each reading, then the HP 3457 calculates and displays the Fahrenheit temperature."
}
],
"tier": "core",
"tier_reason": "Re-examined after digging into Chapter 3 (\"Buffers\" and \"Math Operations\"): the output buffer holds only ONE reading and is silently overwritten by each new one if not drained in time -- so without MEM, a fast unattended burst WILL lose data if the host cannot keep up. STAT and PFAIL (unlike the other math operations) explicitly do NOT alter the reading, they just accumulate statistics on it in parallel -- meaning STAT keeps an accurate running mean/stdev/count/min/max across a burst even if every individual raw reading gets dropped from the output buffer along the way. Combined with NRDGS <big count> + a single TRIG SGL (the manuals own worked RMS-measurement example uses exactly this: NRDGS 1104 + TRIG SGL, letting 1104 readings run to completion internally before the bus is released), this lets the DMM characterize a burst far larger than its 2208-byte reading memory could hold, at O(1) transfer cost (just the final RMATH register reads) instead of O(N). This is NOT an era-of-slow-host-CPU workaround -- it is a genuine, still-relevant mechanism for getting accurate aggregate results from bursts that exceed this project's Prologix-Ethernet transfer throughput, exactly analogous to why TARM/NRDGS/MEM are core/acquisition_timing. The important caveat: STAT only gives you the aggregate, not the raw samples -- if you need the raw burst data too (e.g. for a transient plot), use MEM instead (bounded by its 2208 bytes, but gives you every sample); the two can also be combined.",
"rationale": "acquisition_timing"
},
{
"name": "MATH?",
"manual_pages": [
"4-77"
],
"local": true,
"remote": true,
"description": "The MATH? command returns two numbers, separated by a comma, indicating the enabled math functions: OFF=0, CTHRM=3, DB=4, DBM=5, FILTER=6, FTHRM=8, NULL=9, PERC=10, PFAIL=11, RMS=12, SCALE=13, STAT=14.",
"syntax": "MATH?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the MATH? command by accessing the MATH command from the alphabetic command directory and appending a question mark.",
"When you execute the MATH? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the MATH? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MATH?\"\n20 ENTER 722;A,B\n30 DISP A,B\n40 END",
"comment": "line 10 returns the math function numbers; line 20 enters them into variables A and B; line 30 displays them"
}
],
"tier": "core",
"tier_reason": "Re-examined after digging into Chapter 3 (\"Buffers\" and \"Math Operations\"): the output buffer holds only ONE reading and is silently overwritten by each new one if not drained in time -- so without MEM, a fast unattended burst WILL lose data if the host cannot keep up. STAT and PFAIL (unlike the other math operations) explicitly do NOT alter the reading, they just accumulate statistics on it in parallel -- meaning STAT keeps an accurate running mean/stdev/count/min/max across a burst even if every individual raw reading gets dropped from the output buffer along the way. Combined with NRDGS <big count> + a single TRIG SGL (the manuals own worked RMS-measurement example uses exactly this: NRDGS 1104 + TRIG SGL, letting 1104 readings run to completion internally before the bus is released), this lets the DMM characterize a burst far larger than its 2208-byte reading memory could hold, at O(1) transfer cost (just the final RMATH register reads) instead of O(N). This is NOT an era-of-slow-host-CPU workaround -- it is a genuine, still-relevant mechanism for getting accurate aggregate results from bursts that exceed this project's Prologix-Ethernet transfer throughput, exactly analogous to why TARM/NRDGS/MEM are core/acquisition_timing. The important caveat: STAT only gives you the aggregate, not the raw samples -- if you need the raw burst data too (e.g. for a transient plot), use MEM instead (bounded by its 2208 bytes, but gives you every sample); the two can also be combined.",
"rationale": "acquisition_timing"
},
{
"name": "MCOUNT?",
"manual_pages": [
"4-78"
],
"local": true,
"remote": true,
"description": "The MCOUNT? (memory count?) command returns the total number of stored readings.",
"syntax": "MCOUNT?",
"parameters": [],
"important_points": [
"When you execute the MCOUNT? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the MCOUNT? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MCOUNT?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the total number of stored readings; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "count of stored readings; only relevant if using MEM",
"rationale": "acquisition_timing"
},
{
"name": "MEM",
"manual_pages": [
"4-79",
"4-80"
],
"local": true,
"remote": true,
"description": "The MEM (memory) command enables or disables reading memory and designates the storage mode.",
"syntax": "MEM mode",
"parameters": [
{
"name": "mode",
"description": "The mode parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Stops storing readings (stored readings stay intact)",
"power_on": true,
"default": false
},
{
"parameter": "LIFO",
"decimal_equiv": 1,
"description": "Clears reading memory and stores new readings LIFO (last-in-first-out)",
"power_on": false,
"default": false
},
{
"parameter": "FIFO",
"decimal_equiv": 2,
"description": "Clears reading memory and stores new readings FIFO (first-in-first-out)",
"power_on": false,
"default": true
},
{
"parameter": "CONT",
"decimal_equiv": 3,
"description": "Keeps memory intact and selects the previous mode (if there was no previous mode, FIFO is selected)",
"power_on": false,
"default": false
}
],
"power_on_raw": "OFF",
"default_raw": "FIFO"
}
],
"important_points": [
"If you fill memory in the FIFO mode, the stored data remains intact and new readings are not stored. If you fill memory in the LIFO mode, the oldest readings are replaced with the new readings. In LIFO mode, the most recent readings are always available.",
"If the controller requests data from the HP 3457 when its output buffer is empty in the LIFO or FIFO mode, a reading is removed from memory and placed in the output buffer (the \"implied read\" method). In LIFO mode the most recent reading is returned; in FIFO mode the oldest reading is returned.",
"The reading storage mode (LIFO or FIFO) matters only for the \"implied read\" method of recalling readings; it has no effect on readings recalled using the RMEM command.",
"You specify the memory format (SINT, DINT, ASCII, or SREAL) using the MFORMAT command. You allocate the memory space using the MSIZE command."
],
"examples": [
{
"code": "OUTPUT 722;\"MEM FIFO\"",
"comment": "ENABLES READING MEMORY, FIFO MODE"
},
{
"code": "10 OUTPUT 722;\"NPLC 10\"\n20 OUTPUT 722;\"DCV 3\"\n30 OUTPUT 722;\"MSIZE 992\"\n40 OUTPUT 722;\"MEM FIFO\"\n50 OUTPUT 722;\"MFORMAT ASCII\"\n60 END",
"comment": "selects 10 PLCs integration time, DCV 3V range, allocates 992 bytes for reading memory, enables reading memory (FIFO mode), and selects ASCII memory format"
}
],
"tier": "extended",
"tier_reason": "on-instrument reading memory / FIFO-LIFO buffering; genuinely useful for high-speed burst acquisition where per-reading round trips over this project's Prologix-Ethernet transport would dominate, but a host-side buffer is simpler for most use cases -- worth revisiting if burst throughput becomes a real requirement",
"rationale": "acquisition_timing"
},
{
"name": "MFORMAT",
"manual_pages": [
"4-81",
"4-82"
],
"local": true,
"remote": true,
"description": "The MFORMAT (memory format) command clears reading memory and designates the storage format for new readings.",
"syntax": "MFORMAT format",
"parameters": [
{
"name": "format",
"description": "The format parameter choices are:",
"values": [
{
"parameter": "ASCII",
"decimal_equiv": 1,
"description": "ASCII - 14 characters followed by <CR><LF> (16 bytes per reading)",
"power_on": false,
"default": false
},
{
"parameter": "SINT",
"decimal_equiv": 2,
"description": "Single Integer - 16 bits 2's complement (2 bytes per reading)",
"power_on": false,
"default": false
},
{
"parameter": "DINT",
"decimal_equiv": 3,
"description": "Double Integer - 32 bits 2's complement (4 bytes per reading)",
"power_on": false,
"default": false
},
{
"parameter": "SREAL",
"decimal_equiv": 4,
"description": "Single Real - (IEEE-754) 32 bits (4 bytes per reading)",
"power_on": true,
"default": true
}
],
"power_on_raw": "SREAL",
"default_raw": "SREAL"
}
],
"important_points": [
"When using the SINT or DINT memory format, the HP 3457 stores each reading assuming a certain scale factor based on the present measurement function, range, A/D setting, and enabled math operations. When you recall a reading, the HP 3457 recalculates the scale factor from its present configuration and multiplies it by the stored reading. Always ensure the HP 3457's configuration is the same when storing and recalling data in SINT or DINT format. Caution: with autorange, a different scale factor may be applied for each range change and there is no way to recover each one, so be careful using autorange when storing data in DINT or SINT formats.",
"The memory format does not affect the output format specified by the OFORMAT command.",
"Always disable math operations before using the SINT or DINT memory format. When a math operation is enabled (except PFAIL or STAT), the scale factor is 1 and the data may be lost.",
"You enable reading memory using the MEM command. You allocate memory space using the MSIZE command. You access stored readings using the RMEM command or the \"implied read\" (discussed under \"Reading Memory\" in Chapter 2)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC 10\"\n20 OUTPUT 722;\"DCV 3\"\n30 OUTPUT 722;\"MATH OFF\"\n40 OUTPUT 722;\"MSIZE 1120\"\n50 OUTPUT 722;\"MEM FIFO\"\n60 OUTPUT 722;\"MFORMAT DINT\"\n70 END",
"comment": "sets 10 PLCs, DCV 3V range, disables math, allocates 1120 bytes for reading memory, enables FIFO reading memory, selects DINT memory format",
"note": "When recalling the stored data, make sure the HP 3457 is configured as it was when the data was stored (easiest by re-executing lines 10-30 first)."
}
],
"tier": "extended",
"tier_reason": "reading-memory storage format; only relevant if using MEM",
"rationale": "acquisition_timing"
},
{
"name": "MSIZE",
"manual_pages": [
"4-83",
"4-84"
],
"local": true,
"remote": true,
"description": "The MSIZE (memory size) command clears reading and subprogram memory and allocates memory for reading, subprogram, and state storage.",
"syntax": "MSIZE reading memory, subprogram memory",
"parameters": [
{
"name": "reading memory / subprogram memory",
"description": "The number of bytes of memory you want for reading memory and subprogram memory, respectively. Any remaining memory (of a total of 2208 bytes) is allocated for state storage. Minimum sizes: reading memory 32 bytes, subprogram memory 32 bytes, state memory 69 bytes.",
"values": [],
"power_on_raw": "last specified values",
"default_raw": "1000, 100"
}
],
"important_points": [
"The memory size allocation is stored in non-volatile memory (remains intact after power is removed).",
"If you do not specify the reading memory parameter as a multiple of 16, the HP 3457 rounds up to the nearest multiple of 16.",
"The HP 3457 allocates reading memory first. If any space is left, it allocates subprogram memory. Finally, it allocates any remaining space to state storage.",
"There is a total of 2208 bytes of available memory. If you specify more memory than is available, the HP 3457 flags the PARAM RANGE error (bit 6) and does not alter the existing memory space allocations.",
"The amount of space required per reading (reading memory) depends on the memory format; see the MFORMAT command.",
"You can determine the amount of space required for a subprogram (subprogram memory) using the procedure described under \"Subprogram Storage\" in Chapter 3.",
"The amount of state memory reserved for state 0 is 69 bytes. Each additional state requires 69 bytes. For example, to allocate room for one state (location 1), you need 69 + 69 = 138 bytes."
],
"examples": [
{
"code": "OUTPUT 722;\"MSIZE 800,1000\"",
"comment": "ALLOCATES MEMORY SPACE",
"note": "Allocates 800 bytes (16x50) for reading memory and 1000 bytes for subprogram memory. The remaining 408 bytes are allocated as state memory (enough for states 0 through 4)."
}
],
"tier": "extended",
"tier_reason": "reading/subprogram/state memory allocation; only relevant if using MEM, SUB, or SSTATE",
"rationale": "acquisition_timing"
},
{
"name": "MSIZE?",
"manual_pages": [
"4-84",
"4-85"
],
"local": true,
"remote": true,
"description": "The MSIZE? (memory size?) command returns two numbers, separated by a comma, that represent the present memory allocations. The first number is the size of reading memory and the second number is the size of subprogram memory.",
"syntax": "MSIZE?",
"parameters": [],
"important_points": [
"The HP 3457 contains 2208 bytes of available memory. You can determine the present size of state memory by adding the returned values of reading and subprogram memory, and subtracting this sum from 2208 (shown in the example below).",
"From the HP 3457's front panel, you execute the MSIZE? command by accessing the MSIZE command from the alphabetic command directory and appending a question mark.",
"When you execute the MSIZE? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the MSIZE? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MSIZE?\"\n20 ENTER 722;A,B\n30 DISP A,B\n40 END",
"comment": "line 10 returns reading & subprogram memory sizes; line 20 enters the sizes into variables A and B; line 30 displays them",
"note": "If this program returns 32 and 1000, that means 32 bytes of reading memory, 1000 bytes of program memory, and 2208 - 1032 = 1176 bytes of state memory (enough for 16 states and state 0)."
}
],
"tier": "extended",
"tier_reason": "read back MSIZE",
"rationale": "acquisition_timing"
},
{
"name": "NDIG",
"manual_pages": [
"4-86",
"4-87"
],
"local": true,
"remote": true,
"description": "The NDIG (number of digits) command designates how many digits are shown in the HP 3457's display.",
"syntax": "NDIG value",
"parameters": [
{
"name": "value",
"description": "For frequency, period, extended ohms measurements, and math operations, value maps to displayed digits as: 3->4, 4->5, 5->6, 6->7. For all other measurements: 3->3.5, 4->4.5, 5->5.5, 6->6.5.",
"values": [
{
"parameter": 3,
"digits_freq_per_ohms_math": 4,
"digits_other": "3.5"
},
{
"parameter": 4,
"digits_freq_per_ohms_math": 5,
"digits_other": "4.5"
},
{
"parameter": 5,
"digits_freq_per_ohms_math": 6,
"digits_other": "5.5",
"power_on": true,
"default": true
},
{
"parameter": 6,
"digits_freq_per_ohms_math": 7,
"digits_other": "6.5"
}
],
"power_on_raw": "5",
"default_raw": "5"
}
],
"important_points": [
"The NDIG command only affects the display digits. It does not affect the A/D converter's resolution, or readings sent to the HP-IB bus.",
"The NDIG command sets the maximum number of digits displayed. The HP 3457 cannot display more digits than are resolved by the A/D converter."
],
"examples": [
{
"code": "10 OUTPUT 722;\"FREQ\"\n20 OUTPUT 722;\"NDIG 3\"\n30 END",
"comment": "line 10 selects frequency measurements; line 20 sets the number of digits to 4"
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"NDIG 3\"\n30 END",
"comment": "line 10 selects DC voltage measurements; line 20 sets the number of digits to 3.5"
}
],
"tier": "extended",
"tier_reason": "display-only digit count; does not affect measurement or bus data, only what's shown on the physical front panel",
"rationale": "ui_frontpanel_only"
},
{
"name": "NPLC",
"manual_pages": [
"4-88",
"4-89",
"4-90"
],
"local": true,
"remote": true,
"description": "The NPLC (number of power line cycles) command designates the minimum integration time for the A/D converter. Integration time is the time, measured in power line cycles (PLCs), during which the HP 3457 samples the input signal.",
"syntax": "NPLC power line cycles",
"parameters": [
{
"name": "power line cycles",
"description": "Affects measurement speed (greater PLCs = slower speed), resolution, and normal mode rejection.",
"values": [
{
"parameter": "0 - .0005",
"digits_of_resolution": "3.5",
"normal_mode_rejection": "0 dB"
},
{
"parameter": ".005",
"digits_of_resolution": "4.5",
"normal_mode_rejection": "0 dB"
},
{
"parameter": ".1",
"digits_of_resolution": "5.5",
"normal_mode_rejection": "0 dB"
},
{
"parameter": 1,
"digits_of_resolution": "6.5",
"normal_mode_rejection": "60 dB",
"power_on": true
},
{
"parameter": 10,
"digits_of_resolution": "7.5*",
"normal_mode_rejection": "80 dB"
},
{
"parameter": 100,
"digits_of_resolution": "7.5*",
"normal_mode_rejection": "90 dB"
}
],
"notes": "* To get this resolution, you must access the HIRES math register and add its value to the displayed reading.",
"power_on_raw": "10",
"default_raw": ".0005"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit, making the power-on value for PLCs appear to be .1. Set the number of digits to 6 to view the remaining digit.",
"Since resolution is determined by the A/D converter's number of PLCs, an interaction occurs between the NPLC command and the % resolution parameter in the function commands (DCV, OHMF, etc.) or the RANGE command: if you send NPLC before the function or RANGE command, the HP 3457 satisfies whichever designates the most PLCs (greatest resolution); if you send NPLC after, the HP 3457 uses the integration time specified by NPLC regardless of whether it specifies more or less resolution.",
"Typically, use the NPLC command to select the required amount of normal mode rejection, and the % resolution parameter to select the required resolution. See \"The A/D Converter\" in Chapter 3.",
"Only the integral numbers of power line cycles (1, 10, or 100) provide normal mode rejection."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHM 600,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum, allowing % resolution in line 20 to control resolution; line 20 selects 2-wire ohms, 600Ω max, .0167% resolution",
"note": "The resolution specified by line 20 is 600Ω x .000167 = .1Ω."
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"OHM 1E3,.01\"\n30 END",
"comment": "line 10 sets PLCs to maximum (prevents % resolution in line 20 from affecting the measurement); line 20 selects 2-wire ohms, 1kΩ max, .01% resolution",
"note": "The requested resolution from line 20 is 1kΩ x .0001 = .1Ω, but because of line 10 the actual resolution is .000001Ω."
}
],
"tier": "core",
"tier_reason": "integration time / resolution setup -- the primary speed-vs-precision knob",
"rationale": "measurement_hardware"
},
{
"name": "NPLC?",
"manual_pages": [
"4-91"
],
"local": true,
"remote": true,
"description": "The NPLC? (number of power line cycles?) command returns the present number of power line cycles (PLCs) of integration time used by the A/D converter.",
"syntax": "NPLC?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the NPLC? command by accessing the NPLC command from the alphabetic command directory and appending a question mark.",
"When you execute the NPLC? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the NPLC? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"Since the number of PLCs can be set by a function command or the RANGE command, it is possible for NPLC? to return a greater number of PLCs than was specified by the NPLC command."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the present number of PLCs; line 20 enters the response into variable A; line 30 displays the response"
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCV 3,.0001\"\n30 OUTPUT 722;\"NPLC?\"\n40 ENTER 722;A\n50 DISP A\n60 END",
"comment": "sets PLCs to minimum, then selects DCV 3V range with .0001% resolution, then reads back the actual PLCs in effect",
"note": "Line 10 sets PLCs to a minimum (.0005), but line 20 selects a DCV measurement on the 3V range with .0001% resolution, which specifies an integration time corresponding to 1 PLC. The displayed response (line 50) is 1 PLC, not .0005, because the function command's resolution parameter demanded more PLCs than the NPLC command specified."
}
],
"tier": "core",
"tier_reason": "read back integration time",
"rationale": "measurement_hardware"
},
{
"name": "NRDGS",
"manual_pages": [
"4-92",
"4-93"
],
"local": true,
"remote": true,
"description": "The NRDGS (number of readings) command designates the number of readings made per trigger and the event that initiates each reading.",
"syntax": "NRDGS count, event",
"parameters": [
{
"name": "count",
"description": "The number of readings per trigger, from 1 to 32767.",
"values": [],
"power_on_raw": "1",
"default_raw": "1"
},
{
"name": "event",
"description": "The event that initiates a reading.",
"values": [
{
"parameter": "AUTO",
"decimal_equiv": 1,
"description": "Initiates reading whenever the HP 3457 is not busy",
"power_on": true,
"default": true
},
{
"parameter": "EXT",
"decimal_equiv": 2,
"description": "Initiates reading on external input",
"power_on": false,
"default": false
},
{
"parameter": "SYN",
"decimal_equiv": 5,
"description": "Initiates reading when the HP 3457's output buffer is empty, reading memory is off or empty, and the controller requests data",
"power_on": false,
"default": false
},
{
"parameter": "TIMER",
"decimal_equiv": 6,
"description": "Similar to AUTO with a time interval between successive readings. Specify the interval with the TIMER command",
"power_on": false,
"default": false
}
],
"power_on_raw": "AUTO",
"default_raw": "AUTO"
}
],
"important_points": [
"Since the TIMER event designates an interval between readings, it only applies when count is greater than one. The TIMER event disables autoranging. The first reading occurs without the TIMER interval; you can insert a time interval before the first reading with the DELAY command. See \"Delay\" in Chapter 3."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TRIG HOLD\"\n20 OUTPUT 722;\"DCV 3,.1\"\n30 OUTPUT 722;\"TIMER 10\"\n40 OUTPUT 722;\"NRDGS 4,TIMER\"\n50 OUTPUT 722;\"TRIG SGL\"\n60 END",
"comment": "suspends triggering, selects a DC voltage measurement, sets the timer interval to 10 seconds, selects 4 readings/trigger with TIMER event, then triggers once",
"note": "The HP 3457 makes 4 readings in response to the single trigger: the first reading is made immediately, the remaining 3 have a 10-second interval between them."
},
{
"code": "10 OUTPUT 722;\"DCV 3,.1\"\n20 OUTPUT 722;\"NRDGS 3,SYN\"\n30 OUTPUT 722;\"MEM OFF\"\n40 OUTPUT 722;\"TRIG AUTO\"\n50 FOR I=1 TO 20\n60 ENTER 722;A,B,C\n70 DISP A,B,C\n80 NEXT I\n90 END",
"comment": "selects a DC voltage measurement, 3 readings/trigger with the SYN event, disables reading memory, sets AUTO triggering, then loops reading and displaying 3 values at a time, 20 times (60 readings total)",
"note": "Line 60 requests data from the HP 3457; when the output buffer is empty, this satisfies the SYN event and initiates the measurements. The HP 3457 holds the HP-IB bus until all three readings are complete, then sends them to the controller."
}
],
"tier": "core",
"tier_reason": "readings-per-trigger and sample-event setup -- fundamental to burst/batch acquisition",
"rationale": "acquisition_timing"
},
{
"name": "NRDGS?",
"manual_pages": [
"4-93",
"4-94"
],
"local": true,
"remote": true,
"description": "The NRDGS? (number of readings?) command returns two numbers, separated by a comma, indicating the present measurement configuration: the specified number of readings per trigger, and the sample event (AUTO=1, EXT=2, SYN=5, TIMER=6).",
"syntax": "NRDGS?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the NRDGS? command by accessing the NRDGS command from the alphabetic command directory and appending a question mark.",
"When you execute the NRDGS? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the NRDGS? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NRDGS?\"\n20 ENTER 722;A,B\n30 DISP A,B\n40 END",
"comment": "line 10 returns the configuration response; line 20 enters the response into variables A and B; line 30 displays it"
}
],
"tier": "core",
"tier_reason": "read back NRDGS",
"rationale": "acquisition_timing"
},
{
"name": "OCOMP",
"manual_pages": [
"4-95"
],
"local": true,
"remote": true,
"description": "The OCOMP (offset compensation) command enables or disables the offset compensated ohms function.",
"syntax": "OCOMP control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Offset compensated ohms disabled",
"power_on": true,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Offset compensated ohms enabled",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ON"
}
],
"important_points": [
"With offset compensation enabled, the HP 3457 measures the offset voltage before each resistance reading and subtracts it from the following reading. This prevents the offset voltage from affecting the resistance reading but doubles the time required per reading.",
"You can use offset compensated ohms on both 2-wire and 4-wire resistance measurements.",
"When you have offset compensation enabled and change from ohms to some other measurement function, offset compensation is temporarily disabled. When you return to 2-wire or 4-wire ohms, offset compensation is once again enabled.",
"The HP 3457 only performs offset compensation on the 30 Ω, 300 Ω, and 3 kΩ ranges. If OCOMP is enabled on another range, the measurement is made without offset compensation."
],
"examples": [
{
"code": "OUTPUT 722;\"OCOMP ON\"",
"comment": "ENABLES OFFSET COMPENSATION"
}
],
"tier": "extended",
"tier_reason": "niche offset-compensated ohms mode; useful for diode/junction-sensitive resistance measurements specifically",
"rationale": "measurement_hardware"
},
{
"name": "OCOMP?",
"manual_pages": [
"4-96"
],
"local": true,
"remote": true,
"description": "The OCOMP? (offset compensation?) command returns a number indicating whether offset compensation is on or off: 1 = ON, 0 = OFF.",
"syntax": "OCOMP?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the OCOMP? command by accessing the OCOMP command from the alphabetic command directory and appending a question mark.",
"When you execute the OCOMP? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the OCOMP? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"OCOMP?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the offset compensation state; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "read back OCOMP state",
"rationale": "measurement_hardware"
},
{
"name": "OFORMAT",
"manual_pages": [
"4-97",
"4-98",
"4-99",
"4-100"
],
"local": true,
"remote": true,
"description": "The OFORMAT (output format) command designates the output format for measured readings.",
"syntax": "OFORMAT format",
"parameters": [
{
"name": "format",
"description": "The format parameter choices are:",
"values": [
{
"parameter": "ASCII",
"decimal_equiv": 1,
"description": "ASCII - 14 characters followed by <CR><LF> (16 bytes per reading)",
"power_on": true,
"default": true
},
{
"parameter": "SINT",
"decimal_equiv": 2,
"description": "Single Integer - 16 bits 2's complement (2 bytes per reading)",
"power_on": false,
"default": false
},
{
"parameter": "DINT",
"decimal_equiv": 3,
"description": "Double Integer - 32 bits 2's complement (4 bytes per reading)",
"power_on": false,
"default": false
},
{
"parameter": "SREAL",
"decimal_equiv": 4,
"description": "Single Real - (IEEE-754) 32 bits (4 bytes per reading)",
"power_on": false,
"default": false
}
],
"power_on_raw": "ASCII",
"default_raw": "ASCII"
}
],
"important_points": [
"The ASCII output format sends a <CR><LF> on the data bus following any HP-IB data transmission, indicating the end of the transmission to most computers. The SINT, DINT, and SREAL output formats do not send <CR><LF>; with these you can use the END command to indicate the end of the transmission. See \"The Output Buffer\" in Chapter 3.",
"The output format only applies to measured readings transferred over the HP-IB bus. Responses to query commands are always output in ASCII format regardless of the specified output format; following the query response, the output format returns to the specified type. The output format does not affect the memory format specified by the MFORMAT command.",
"When using the SINT or DINT output formats, the HP 3457 applies a scale factor to each reading, retrievable via the ISCALE? command. Always retrieve the measured reading from the output buffer before sending ISCALE? — sending it first may destroy the reading. The scale factor is based on the present measurement function, range, A/D setting, and enabled math operations, so ensure the configuration matches when retrieving it.",
"When using autorange and the DINT or SINT output format, a different scale factor may be applied for each range change. Tables 3-11 and 3-12 show the scale factors for all ranges in the SINT and DINT output formats.",
"When a math operation is enabled (except PFAIL or STAT) the scale factor is always 1, and ISCALE? cannot retrieve the correct scale factor in SINT/DINT format — use Table 3-11 or 3-12 instead. When PFAIL or STAT is enabled, ISCALE? does return the correct scale factor."
],
"examples": [
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"OFORMAT DINT\"\n30 OUTPUT 722;\"TRIG SGL\"\n40 ENTER 722 USING \"#,B\";A,B,C,D\n50 T=A*16777216+B*65536+C*256+D\n60 IF A>127 THEN T=T-4294967296\n70 OUTPUT 722;\"ISCALE?\"\n80 ENTER 722;I\n90 R=T*I\n100 DISP R\n110 END",
"comment": "DINT format example, identical pattern to the ISCALE? command's DINT example",
"note": "The # image specifier suppresses <CR><LF> so the computer doesn't misinterpret it as binary data; the B image specifier reads the reading as four 8-bit binary bytes, one per integer variable."
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"OFORMAT SINT\"\n30 OUTPUT 722;\"TRIG SGL\"\n40 ENTER 722 USING \"#,W\";A\n50 OUTPUT 722;\"ISCALE?\"\n60 ENTER 722;I\n70 R=A*I\n80 DISP R\n90 END",
"comment": "SINT format example",
"note": "The W image specifier reads the reading as two 8-bit bytes combined into a single 2's-complement integer variable (A)."
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"OFORMAT SREAL\"\n30 OUTPUT 722;\"TRIG SGL\"\n40 S=1\n50 ENTER 722 USING \"#,B\";A,B,C,D\n60 IF A>127 THEN S=-1\n70 IF A>127 THEN A=A-128\n80 A=A*2-127\n90 IF B>127 THEN A=A+1\n100 IF B<=127 THEN B=B+128\n110 R=S*(B*65536+C*256+D)*2^(A-231)\n120 DISP R\n130 END",
"comment": "SREAL (IEEE-754) format example: decodes the 4-byte single-precision float manually from its sign/exponent/mantissa bytes",
"note": "This manual conversion can produce more digits than the A/D converter actually resolved (e.g. 6.5 digits) — round the final reading to match the true resolution. See \"The A/D Converter\" in Chapter 3."
}
],
"tier": "core",
"tier_reason": "selects the wire format for readings (ASCII/SINT/DINT/SREAL) -- needed to parse results correctly",
"rationale": "bus_protocol"
},
{
"name": "OHM",
"manual_pages": [
"4-101",
"4-102",
"4-103"
],
"local": false,
"remote": true,
"description": "The OHM command instructs the HP 3457 to measure 2-wire ohms. It also allows you to specify the measurement range and resolution.",
"syntax": "OHM max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of eight standard ranges or the autorange mode. You specify max. input as the maximum expected resistance reading, or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - 30",
"selects_range": "30 Ω",
"full_scale_reading": "30.3 Ω",
"power_on": false,
"default": false
},
{
"parameter": "> 30 - 300",
"selects_range": "300 Ω",
"full_scale_reading": "303 Ω",
"power_on": false,
"default": false
},
{
"parameter": "> 300 - 3E3",
"selects_range": "3 kΩ",
"full_scale_reading": "3.03 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E3 - 3E4",
"selects_range": "30 kΩ",
"full_scale_reading": "30.3 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E4 - 3E5",
"selects_range": "300 kΩ",
"full_scale_reading": "303 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E5 - 3E6",
"selects_range": "3 MΩ",
"full_scale_reading": "3.03 MΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E6 - 3E7",
"selects_range": "30 MΩ",
"full_scale_reading": "30.3 MΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E7 - 3E9",
"selects_range": "3 GΩ",
"full_scale_reading": "3.03 GΩ",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified in the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select 2-wire ohms measurements using the OHM key or by accessing the FUNC command from the alphabetic command directory. The OHM key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution.",
"The 3 GΩ range is called the extended ohms range and is a combination of two ranges: the 300 MΩ range and the 3 GΩ range."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHM 600,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum, allowing % resolution in line 20 to control resolution; line 20 selects 2-wire ohms, 600Ω max, .0167% resolution",
"note": "The resolution specified by line 20 is 600Ω x .000167 = .1Ω."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHM AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects 2-wire ohms, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"OHM 1E3,.01\"\n30 END",
"comment": "line 10 sets PLCs to maximum (prevents % resolution in line 20 from affecting the measurement); line 20 selects 2-wire ohms, 1kΩ max, .01% resolution",
"note": "The requested resolution from line 20 is 1kΩ x .0001 = .1Ω, but because of line 10 the actual resolution is .000001Ω."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "OHMF",
"manual_pages": [
"4-104",
"4-105",
"4-106"
],
"local": true,
"remote": true,
"description": "The OHMF (4-wire ohms) command instructs the HP 3457 to measure 4-wire ohms. It also allows you to specify the measurement range and resolution.",
"syntax": "OHMF max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects one of eight standard ranges or the autorange mode. You specify max. input as the maximum expected resistance reading, or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"selects_range": "Autorange",
"full_scale_reading": null,
"power_on": false,
"default": true
},
{
"parameter": "0 - 30",
"selects_range": "30 Ω",
"full_scale_reading": "30.3 Ω",
"power_on": false,
"default": false
},
{
"parameter": "> 30 - 300",
"selects_range": "300 Ω",
"full_scale_reading": "303 Ω",
"power_on": false,
"default": false
},
{
"parameter": "> 300 - 3E3",
"selects_range": "3 kΩ",
"full_scale_reading": "3.03 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E3 - 3E4",
"selects_range": "30 kΩ",
"full_scale_reading": "30.3 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E4 - 3E5",
"selects_range": "300 kΩ",
"full_scale_reading": "303 kΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E5 - 3E6",
"selects_range": "3 MΩ",
"full_scale_reading": "3.03 MΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E6 - 3E7",
"selects_range": "30 MΩ",
"full_scale_reading": "30.3 MΩ",
"power_on": false,
"default": false
},
{
"parameter": "> 3E7 - 3E9",
"selects_range": "3 GΩ",
"full_scale_reading": "3.03 GΩ",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "none",
"default_raw": "determined by the integration time specified in the NPLC command"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"From the front panel, you select 4-wire ohms measurements using the shifted OHMF key or by accessing the FUNC command from the alphabetic command directory. The OHMF key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range and resolution.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it; the HP 3457 uses whichever designates the longest integration time (most resolution). Since the NPLC command's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution.",
"The 3 GΩ range is called the extended ohms range and is a combination of two ranges: the 300 MΩ range and the 3 GΩ range."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHMF 600,.0167\"\n30 END",
"comment": "line 10 sets PLCs to minimum, allowing % resolution in line 20 to control resolution; line 20 selects 4-wire ohms, 600Ω max, .0167% resolution",
"note": "The resolution specified by line 20 is 600Ω x .000167 = .1Ω."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHMF AUTO,.033\"\n30 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects 4-wire ohms, autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"OHMF 1E3,.01\"\n30 END",
"comment": "line 10 sets PLCs to maximum (prevents % resolution in line 20 from affecting the measurement); line 20 selects 4-wire ohms, 1kΩ max, .01% resolution",
"note": "The requested resolution from line 20 is 1kΩ x .0001 = .1Ω, but because of line 10 the actual resolution is .000001Ω."
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "OPEN",
"manual_pages": [
"4-107",
"4-108"
],
"local": true,
"remote": true,
"description": "The OPEN command opens actuator channel 8 or 9 on the HP 44491 plug-in card.",
"syntax": "OPEN actuator channel, control",
"parameters": [
{
"name": "actuator channel",
"description": "You specify the actuator channel parameter as the number of the channel you want to open (8 or 9).",
"values": [
{
"parameter": 8,
"description": "Actuator channel 8"
},
{
"parameter": 9,
"description": "Actuator channel 9"
}
],
"power_on_raw": "all open",
"default_raw": "8"
},
{
"name": "control",
"description": "The control parameter enables or disables a 1.2 second delay. When enabled, the delay occurs after the actuator opens and prevents the actuator from closing (CLOSE command or scan advance) until the delay period is over. This prevents possible relay damage caused by switching maximum or near maximum loads too fast. CAUTION: to prevent contact damage, use the delay if you are repeatedly switching currents greater than 25mA.",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "No delay occurs",
"power_on": true,
"default": false
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Adds a 1.2 second delay after every actuator opening",
"power_on": false,
"default": true
}
],
"power_on_raw": "OFF",
"default_raw": "ON"
}
],
"important_points": [
"You do not need to select the HP 44491 as the input source (TERM command) to open or close an actuator channel.",
"If you execute the OPEN command without an HP 44491 in the HP 3457's rear slot, you'll get the BAD HEADER error."
],
"examples": [
{
"code": "10 OUTPUT 722;\"CLOSE 8\"\n20 OUTPUT 722;\"OPEN 8,ON\"\n30 OUTPUT 722;\"CLOSE 8\"\n40 END",
"comment": "closes channel 8, opens channel 8 with the delay enabled, then closes channel 8 again"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "OPT?",
"manual_pages": [
"4-109"
],
"local": true,
"remote": true,
"description": "The OPT? (option?) command returns a number representing the type of device in the HP 3457's rear slot.",
"syntax": "OPT?",
"parameters": [
{
"name": "(none; query command)",
"description": "Possible returned values:",
"values": [
{
"parameter": 0,
"description": "Rear terminals or nothing in the rear slot"
},
{
"parameter": 44491,
"description": "HP 44491 General Purpose Card"
},
{
"parameter": 44492,
"description": "HP 44492 Multiplexer Card"
}
],
"power_on_raw": null,
"default_raw": null
}
],
"important_points": [
"If you execute OPT? from the HP 3457's front panel, the response goes to the display. If you execute OPT? from the controller, the response goes to the HP 3457's output buffer in ASCII format, after which the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"OPT?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the device number response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "reports which plug-in card (if any) is installed -- useful once at startup to detect hardware, but not a per-measurement command",
"rationale": "plugin_card_dependent"
},
{
"name": "PAUSE",
"manual_pages": [
"4-110",
"4-111"
],
"local": false,
"remote": true,
"description": "The HP 3457 executes subprograms on a command-by-command basis. When it encounters the PAUSE command, it suspends subprogram execution. Subprogram execution is resumed only when the HP-IB Group Execute Trigger (GET) is received.",
"syntax": "PAUSE",
"parameters": [],
"important_points": [
"If a Group Execute Trigger occurs during subprogram execution, but before the PAUSE command is encountered, it prevents the subsequent PAUSE command from suspending subprogram execution.",
"When you call a subprogram using the standard format (e.g. OUTPUT 722;\"CALL 1\"), the computer sends <CR><LF> following the CALL command. The HP 3457 processes <CR> immediately but does not process <LF> until the subprogram is executed — so the HP-IB bus is held until the subprogram completes. If a PAUSE command is in the subprogram, execution ceases and the bus remains held, so you cannot regain control of the computer to send the Group Execute Trigger. Prevent this by suppressing <CR><LF> when sending the CALL command (see the example)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MSIZE 200,1000\"\n20 OUTPUT 722;\"SUB 1\"\n30 OUTPUT 722;\"TRIG HOLD\"\n40 OUTPUT 722;\"MEM FIFO\"\n50 OUTPUT 722;\"OHM\"\n60 OUTPUT 722;\"NRDGS 5\"\n70 OUTPUT 722;\"TRIG SGL\"\n80 OUTPUT 722;\"PAUSE\"\n90 OUTPUT 722;\"ACV\"\n100 OUTPUT 722;\"NRDGS 10\"\n110 OUTPUT 722;\"TRIG SGL\"\n120 OUTPUT 722;\"SUBEND\"\n130 END",
"comment": "allocates memory, stores lines 30-120 as subprogram #1, then defines a subprogram that takes 5 ohms readings, pauses, then (after a Group Execute Trigger) takes 10 AC voltage readings",
"note": "Lines 20-70 make five 2-wire ohms measurements into reading memory. Line 80 suspends execution until a Group Execute Trigger is received; lines 90-110 then make 10 AC voltage measurements, for 15 total readings in memory. Call it with: OUTPUT 722 USING \"#,K\";\"CALL 1;\" (suppressing <CR><LF> so you can regain bus control while paused). After connecting an AC source, resume with: TRIGGER 7"
}
],
"tier": "extended",
"tier_reason": "only relevant inside a stored subprogram",
"rationale": "era_computer_workaround"
},
{
"name": "PER",
"manual_pages": [
"4-112",
"4-113"
],
"local": false,
"remote": true,
"description": "The PER (period) command instructs the HP 3457 to measure period. It also allows you to specify the amplitude range of the input signal.",
"syntax": "PER max. input",
"parameters": [
{
"name": "max. input",
"description": "NOTE: max. input selects the amplitude range of the input signal, not the period range (seconds). It selects a standard range or the autorange mode; specify the maximum expected amplitude of the input signal, or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "Autorange"
},
{
"parameter": "0 - .03",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "30 mV"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "300 mV"
},
{
"parameter": "> .3 - 3",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "3 V"
},
{
"parameter": "> 3 - 30",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "30 V"
},
{
"parameter": "> 30 - 300",
"measurement_group": "AC or AC+DC Voltage",
"selects_range": "300 V"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "AC or AC+DC Current",
"selects_range": "Autorange"
},
{
"parameter": "0 - .03",
"measurement_group": "AC or AC+DC Current",
"selects_range": "30 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC or AC+DC Current",
"selects_range": "300 mA"
},
{
"parameter": "> .3 - 1",
"measurement_group": "AC or AC+DC Current",
"selects_range": "1 A"
}
],
"power_on_raw": "none",
"default_raw": "AUTO"
}
],
"important_points": [
"You use the PER command along with the FSOURCE command. FSOURCE designates whether the input signal is AC voltage, AC+DC voltage, AC current, or AC+DC current.",
"From the front panel, you select period measurements using the shifted PER key or by accessing the FUNC command from the alphabetic command directory. The shifted PER key does not allow you to select any additional parameters. With the FUNC command, you can specify the measurement range.",
"Seven digits of resolution are always provided for period measurements regardless of the specified amount of integration time (NPLC command). The integration time does, however, affect the measurement speed."
],
"examples": [
{
"code": "10 OUTPUT 722;\"FSOURCE ACI\"\n20 OUTPUT 722;\"PER .03\"\n30 END",
"comment": "line 10 selects AC current as the input source; line 20 selects a period measurement on the 30mA range"
}
],
"tier": "core",
"tier_reason": "primary measurement function",
"rationale": "measurement_hardware"
},
{
"name": "PRESET",
"manual_pages": [
"4-114"
],
"local": true,
"remote": true,
"description": "The PRESET command configures the HP 3457 to a predefined state. This command is primarily for remote operation and selects a good starting point for remote operation.",
"syntax": "PRESET",
"parameters": [],
"important_points": [
"The PRESET command executes the following commands/states: ACBAND 20, AZERO ON, BEEP ON, CRESET, DCV AUTO, DELAY -1, DISP ON, FIXEDZ OFF, FSOURCE ACV, INBUF OFF, LOCK OFF, MATH OFF,OFF (all math registers set to 0 except DEGREE=20, PERC=1, REF=1, RES=50, SCALE=1), MEM OFF (last memory operation set to FIFO), MFORMAT SREAL, NDIG 5, NPLC 1, NRDGS 1,AUTO, OCOMP OFF, OFORMAT ASCII, SADV HOLD, SLIST (empty list), TARM AUTO, TERM FRONT, TIMER 1, TRIG SYN.",
"It is a good idea to include the PRESET command at the beginning of your programs to initialize the HP 3457. PRESET initializes the HP 3457 much faster than the RESET command."
],
"examples": [
{
"code": "OUTPUT 722;\"PRESET\"",
"comment": "PRESETS THE HP 3457"
}
],
"tier": "core",
"tier_reason": "fast, well-defined known-state initialization -- recommended at the start of any session",
"rationale": "bus_protocol"
},
{
"name": "R",
"manual_pages": [
"4-115"
],
"local": true,
"remote": true,
"description": "The R command is an abbreviation of the RANGE command. Except for the syntax (shorter mnemonic), the R and RANGE commands are identical.",
"syntax": "R max. input, % resolution",
"parameters": [],
"important_points": [],
"examples": [],
"see_also": "RANGE",
"tier": "extended",
"tier_reason": "bare syntax alias of RANGE; no functional reason to use over RANGE in a Python library",
"rationale": "wire_efficiency"
},
{
"name": "RANGE",
"manual_pages": [
"4-116",
"4-117",
"4-118"
],
"local": true,
"remote": true,
"description": "The RANGE command allows you to select a measurement range or the autorange mode. You can abbreviate this command with an R.",
"syntax": "RANGE max. input, % resolution",
"parameters": [
{
"name": "max. input",
"description": "The max. input parameter selects a standard range or the autorange mode for whatever measurement function is presently active. You specify max. input as the maximum expected amplitude of the input signal, or AUTO / default it for autorange.",
"values": [
{
"parameter": "-1 or AUTO",
"measurement_group": "AC Voltage",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - .03",
"measurement_group": "AC Voltage",
"selects_range": "30 mV",
"full_scale_reading": "32.5 mV"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC Voltage",
"selects_range": "300 mV",
"full_scale_reading": "325 mV"
},
{
"parameter": "> .3 - 3",
"measurement_group": "AC Voltage",
"selects_range": "3 V",
"full_scale_reading": "3.25 V"
},
{
"parameter": "> 3 - 30",
"measurement_group": "AC Voltage",
"selects_range": "30 V",
"full_scale_reading": "32.5 V"
},
{
"parameter": "> 30 - 300",
"measurement_group": "AC Voltage",
"selects_range": "300 V",
"full_scale_reading": "303 V"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "DC Voltage",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - .03",
"measurement_group": "DC Voltage",
"selects_range": "30 mV",
"full_scale_reading": "30.3 mV"
},
{
"parameter": "> .03 - .3",
"measurement_group": "DC Voltage",
"selects_range": "300 mV",
"full_scale_reading": "303 mV"
},
{
"parameter": "> .3 - 3",
"measurement_group": "DC Voltage",
"selects_range": "3 V",
"full_scale_reading": "3.03 V"
},
{
"parameter": "> 3 - 30",
"measurement_group": "DC Voltage",
"selects_range": "30 V",
"full_scale_reading": "30.3 V"
},
{
"parameter": "> 30 - 300",
"measurement_group": "DC Voltage",
"selects_range": "300 V",
"full_scale_reading": "303 V"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "AC Current",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "> 0 - .03",
"measurement_group": "AC Current",
"selects_range": "30 mA",
"full_scale_reading": "32.5 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "AC Current",
"selects_range": "300 mA",
"full_scale_reading": "325 mA"
},
{
"parameter": "> .3 - 1",
"measurement_group": "AC Current",
"selects_range": "1 A",
"full_scale_reading": "1.05 A"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "DC Current",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "> 0 - .0003",
"measurement_group": "DC Current",
"selects_range": "300 µA",
"full_scale_reading": "303 µA"
},
{
"parameter": "> .0003 - .003",
"measurement_group": "DC Current",
"selects_range": "3 mA",
"full_scale_reading": "3.03 mA"
},
{
"parameter": "> .003 - .03",
"measurement_group": "DC Current",
"selects_range": "30 mA",
"full_scale_reading": "30.3 mA"
},
{
"parameter": "> .03 - .3",
"measurement_group": "DC Current",
"selects_range": "300 mA",
"full_scale_reading": "303 mA"
},
{
"parameter": "> .3 - 1.5",
"measurement_group": "DC Current",
"selects_range": "1.5 A",
"full_scale_reading": "1.5 A"
},
{
"parameter": "-1 or AUTO",
"measurement_group": "Ohms (all)",
"selects_range": "Autorange",
"full_scale_reading": null
},
{
"parameter": "0 - 30",
"measurement_group": "Ohms (all)",
"selects_range": "30 Ω",
"full_scale_reading": "30.3 Ω"
},
{
"parameter": "> 30 - 300",
"measurement_group": "Ohms (all)",
"selects_range": "300 Ω",
"full_scale_reading": "303 Ω"
},
{
"parameter": "> 300 - 3E3",
"measurement_group": "Ohms (all)",
"selects_range": "3 kΩ",
"full_scale_reading": "3.03 kΩ"
},
{
"parameter": "> 3E3 - 3E4",
"measurement_group": "Ohms (all)",
"selects_range": "30 kΩ",
"full_scale_reading": "30.3 kΩ"
},
{
"parameter": "> 3E4 - 3E5",
"measurement_group": "Ohms (all)",
"selects_range": "300 kΩ",
"full_scale_reading": "303 kΩ"
},
{
"parameter": "> 3E5 - 3E6",
"measurement_group": "Ohms (all)",
"selects_range": "3 MΩ",
"full_scale_reading": "3.03 MΩ"
},
{
"parameter": "> 3E6 - 3E7",
"measurement_group": "Ohms (all)",
"selects_range": "30 MΩ",
"full_scale_reading": "30.3 MΩ"
},
{
"parameter": "> 3E7 - 3E9",
"measurement_group": "Ohms (all)",
"selects_range": "3 GΩ",
"full_scale_reading": "3.03 GΩ"
}
],
"power_on_raw": "AUTO",
"default_raw": "AUTO"
},
{
"name": "% resolution",
"description": "You specify % resolution as a percentage of max. input. The HP 3457 multiplies % resolution times max. input to determine the measurement's resolution. When using autorange, % resolution is multiplied by the full scale reading of the selected range instead, giving a minimum resolution.",
"values": [],
"power_on_raw": "determined by the integration time specified by the NPLC command (power-on value for NPLC = 10)",
"default_raw": "determined by the integration time specified by the NPLC command (power-on value for NPLC = 10)"
}
],
"important_points": [
"The power-on value for number of digits (NDIG) is 5. This masks one display digit. Set the number of digits to 6 to view the remaining digit.",
"The HP 3457 changes the measurement resolution by changing the integration time. Both % resolution and the NPLC command affect it. When you execute the RANGE command, the HP 3457 compares the integration time specified by % resolution to that specified by NPLC, and uses whichever designates the longest integration time (most resolution). Since NPLC's power-on value is 10 PLCs, you must lower the number of PLCs to get less resolution."
],
"examples": [
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"OHM\"\n30 OUTPUT 722;\"RANGE 600,.0167\"\n40 END",
"comment": "line 10 sets PLCs to minimum, allowing % resolution in line 30 to control resolution; line 20 selects 2-wire ohms; line 30 selects 600Ω max, .0167% resolution",
"note": "The resolution specified by line 30 is 600Ω x .000167 = .1Ω."
},
{
"code": "10 OUTPUT 722;\"NPLC .0005\"\n20 OUTPUT 722;\"DCV\"\n30 OUTPUT 722;\"RANGE AUTO,.033\"\n40 END",
"comment": "line 10 sets PLCs to minimum; line 20 selects DC voltage measurements; line 30 selects autorange, .033% resolution"
},
{
"code": "10 OUTPUT 722;\"NPLC 100\"\n20 OUTPUT 722;\"OHM\"\n30 OUTPUT 722;\"R 1E3,.01\"\n40 END",
"comment": "line 10 sets PLCs to maximum (prevents % resolution in line 30 from affecting the measurement); line 20 selects 2-wire ohms; line 30 selects 1kΩ max, .01% resolution, using the R abbreviation",
"note": "The requested resolution from line 30 is 1kΩ x .0001 = .1Ω, but because of line 10 the actual resolution is .000001Ω."
}
],
"tier": "core",
"tier_reason": "range/resolution setup",
"rationale": "measurement_hardware"
},
{
"name": "RANGE?",
"manual_pages": [
"4-119"
],
"local": true,
"remote": true,
"description": "The RANGE? command returns a number representing the present measurement range. See the RANGE command for a listing of the possible ranges for all measurement functions.",
"syntax": "RANGE?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the RANGE? command by accessing the RANGE command from the alphabetic command directory and appending a question mark.",
"When you execute the RANGE? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the RANGE? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"RANGE?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the measurement range; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back present measurement range",
"rationale": "measurement_hardware"
},
{
"name": "RESET",
"manual_pages": [
"4-120",
"4-121"
],
"local": true,
"remote": true,
"description": "The RESET command allows you to set the HP 3457 to the power-on state without cycling power.",
"syntax": "RESET",
"parameters": [],
"important_points": [
"The RESET command aborts readings in process, clears the error and auxiliary error registers, clears the status register except the Power-on SRQ bit (bit 3), checks the security code, measures line frequency and uses it for the A/D converter reference, and clears reading and subprogram memory. It also executes: ACBAND 20, AZERO ON, CRESET, DCV AUTO, DELAY -1, DISP ON, END OFF, FIXEDZ OFF, FSOURCE ACV, INBUF OFF, LOCK OFF, MATH OFF,OFF (all math registers set to 0 except DEGREE=20, SCALE=1, PERC=1, REF=1, RES=50), MEM OFF (last memory operation set to FIFO), MFORMAT SREAL, NDIG 5, NPLC 10, NRDGS 1,AUTO, OCOMP OFF, OFORMAT ASCII, SADV HOLD, SLIST (empty list), TARM AUTO, TERM FRONT, TIMER 1, TRIG AUTO.",
"The RESET command can be used from remote although it is primarily for front panel use. It configures the HP 3457 to a good starting point for local operation.",
"When attempting to send RESET from remote, the HP 3457 may be busy or the HP-IB bus may be held, so it will not immediately respond. Send the HP-IB device clear command before sending RESET (see the example)."
],
"examples": [
{
"code": "10 CLEAR 722\n20 OUTPUT 722;\"RESET\"\n30 END",
"comment": "line 10 clears the HP 3457 immediately (HP-IB device clear); line 20 resets the HP 3457"
}
],
"tier": "extended",
"tier_reason": "slower full reset primarily intended for front-panel/local use; PRESET is the documented preferred remote equivalent",
"rationale": "bus_protocol"
},
{
"name": "REV?",
"manual_pages": [
"4-122"
],
"local": true,
"remote": true,
"description": "This is a service related command. Refer to the HP 3457 Service manual for details.",
"syntax": null,
"parameters": [],
"important_points": [],
"examples": [],
"service_command": true,
"tier": "extended",
"tier_reason": "service-only, no documented syntax",
"rationale": "diagnostic_calibration"
},
{
"name": "RMATH",
"manual_pages": [
"4-123",
"4-124"
],
"local": true,
"remote": true,
"description": "The RMATH (recall math) command reads and returns the contents of a math register.",
"syntax": "RMATH register",
"parameters": [
{
"name": "register",
"description": "The register parameter choices are:",
"values": [
{
"parameter": "DEGREE",
"decimal_equiv": 1,
"description": "Time constant for FILTER and RMS",
"power_on": false,
"default": true
},
{
"parameter": "LOWER",
"decimal_equiv": 2,
"description": "Smallest reading in STATS",
"power_on": false,
"default": false
},
{
"parameter": "MAX",
"decimal_equiv": 3,
"description": "Upper limit for PFAIL operation",
"power_on": false,
"default": false
},
{
"parameter": "MEAN",
"decimal_equiv": 4,
"description": "Average of readings in STATS",
"power_on": false,
"default": false
},
{
"parameter": "MIN",
"decimal_equiv": 5,
"description": "Lower limit for PFAIL",
"power_on": false,
"default": false
},
{
"parameter": "NSAMP",
"decimal_equiv": 6,
"description": "Number of samples in STATS",
"power_on": false,
"default": false
},
{
"parameter": "OFFSET",
"decimal_equiv": 7,
"description": "Subtrahend in NULL and SCALE operations",
"power_on": false,
"default": false
},
{
"parameter": "PERC",
"decimal_equiv": 8,
"description": "% value for PERC operation",
"power_on": false,
"default": false
},
{
"parameter": "REF",
"decimal_equiv": 9,
"description": "Reference value for DB operation",
"power_on": false,
"default": false
},
{
"parameter": "RES",
"decimal_equiv": 10,
"description": "Reference impedance for DBM operation",
"power_on": false,
"default": false
},
{
"parameter": "SCALE",
"decimal_equiv": 11,
"description": "Divisor in the SCALE operation",
"power_on": false,
"default": false
},
{
"parameter": "SDEV",
"decimal_equiv": 12,
"description": "Standard deviation in STATS",
"power_on": false,
"default": false
},
{
"parameter": "UPPER",
"decimal_equiv": 13,
"description": "Largest reading in STATS",
"power_on": false,
"default": false
},
{
"parameter": "HIRES",
"decimal_equiv": 14,
"description": "Extra digit for measurements made with NPLC set to 10 or 100",
"power_on": false,
"default": false
}
],
"power_on_raw": "none",
"default_raw": "DEGREE"
}
],
"important_points": [],
"examples": [
{
"code": "10 OUTPUT 722;\"TRIG HOLD\"\n20 OUTPUT 722;\"NPLC 100\"\n30 OUTPUT 722;\"DCV 3\"\n40 OUTPUT 722;\"TRIG SGL\"\n50 ENTER 722;A\n60 OUTPUT 722;\"RMATH HIRES\"\n70 ENTER 722;B\n80 C=A+B\n90 DISP C\n100 END",
"comment": "gets an extra digit of resolution by reading the HIRES register and adding it to the normal 6.5-digit reading",
"note": "Only valid when NPLC is set to 10 or 100. This produces more digits than the A/D converter actually resolves — round the result to 7.5 digits."
}
],
"tier": "core",
"tier_reason": "the one math-family command worth keeping in core: RMATH HIRES is how you retrieve the extra digit of resolution at NPLC 10/100 (the 6.5-vs-7.5-digit trick)",
"rationale": "acquisition_timing"
},
{
"name": "RMEM",
"manual_pages": [
"4-125",
"4-126"
],
"local": true,
"remote": true,
"description": "The RMEM (recall memory) command reads and returns the value of a particular reading or group of readings from reading memory. This command leaves stored readings intact — it does not destroy (clear) readings.",
"syntax": "RMEM first, count, record",
"parameters": [
{
"name": "first",
"description": "Designates the beginning reading.",
"values": [],
"power_on_raw": "none",
"default_raw": "1"
},
{
"name": "count",
"description": "Designates the number of readings to be recalled, starting with first.",
"values": [],
"power_on_raw": "none",
"default_raw": "1"
},
{
"name": "record",
"description": "Designates the record from which you want to recall readings. Records correspond to the number of readings specified with the NRDGS command — e.g. if NRDGS specified 3 readings, each record contains 3 readings.",
"values": [],
"power_on_raw": "none",
"default_raw": "1"
}
],
"important_points": [
"The RMEM command automatically shuts off reading memory (MEM OFF). All previously stored readings remain intact and new readings are not stored.",
"The HP 3457 assigns a number to each reading in reading memory: the most recent reading is assigned the lowest number (1), the oldest reading has the highest number — regardless of FIFO or LIFO mode. Records are numbered the same way (most recent record is record 1).",
"When you execute RMEM from the front panel, readings are copied one at a time to the display, and you can view others with the up/down arrow keys. From the controller, the reading(s) are copied to the output buffer, separated by commas, with the final reading followed by <CR><LF>.",
"In addition to RMEM, you can also recall readings using \"implied read.\" See \"Reading Memory\" in Chapter 2."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TARM HOLD\"\n20 OUTPUT 722;\"DCV\"\n30 OUTPUT 722;\"TRIG AUTO\"\n40 OUTPUT 722;\"NRDGS 3,AUTO\"\n50 OUTPUT 722;\"MEM FIFO\"\n60 OUTPUT 722;\"TARM SGL,10\"\n70 OUTPUT 722;\"RMEM 1,3,6\"\n80 ENTER 722;A,B,C\n90 DISP A,B,C\n100 END",
"comment": "suspends trigger arming, selects DCV, sets AUTO triggering, 3 readings per sample event, FIFO reading memory, then arms for 10 groups of readings, and recalls the 1st-3rd readings from the 6th group"
}
],
"tier": "extended",
"tier_reason": "recalls stored readings; only relevant if using MEM",
"rationale": "acquisition_timing"
},
{
"name": "RQS",
"manual_pages": [
"4-127",
"4-128"
],
"local": true,
"remote": true,
"description": "The RQS (request service) command designates which status register conditions will set the SRQ line on the HP-IB bus.",
"syntax": "RQS value",
"parameters": [
{
"name": "value",
"description": "You enable a condition by specifying its decimal weight as the value parameter. For more than one condition, specify the sum of the weights. You can control the errors that affect bit 5 using the EMASK command.",
"values": [
{
"parameter": 1,
"bit": 0,
"description": "Program Memory Execution Completed"
},
{
"parameter": 2,
"bit": 1,
"description": "Hi or Lo Limit Exceeded"
},
{
"parameter": 4,
"bit": 2,
"description": "Front Panel SRQ"
},
{
"parameter": 8,
"bit": 3,
"description": "Power-On SRQ"
},
{
"parameter": 16,
"bit": 4,
"description": "Ready"
},
{
"parameter": 32,
"bit": 5,
"description": "Error (consult error register)"
},
{
"parameter": 64,
"bit": 6,
"description": "Service Requested (you cannot disable this bit)"
},
{
"parameter": 128,
"bit": 7,
"description": "Not used"
}
],
"power_on_raw": "8 if the Power-On SRQ was enabled when power was removed, otherwise 0",
"default_raw": "0 (no conditions enabled)"
}
],
"important_points": [
"The power-on SRQ bit is stored in non-volatile memory. All other bits are cleared at power-on."
],
"examples": [
{
"code": "OUTPUT 722;\"RQS 4\"",
"comment": "ENABLES THE FRONT PANEL SRQ CONDITION"
},
{
"code": "OUTPUT 722;\"RQS 40\"",
"comment": "ENABLES POWER-ON SRQ (8) & ERROR (32) CONDITIONS"
},
{
"code": "OUTPUT 722;\"RQS 255\"",
"comment": "ENABLES ALL CONDITIONS"
},
{
"code": "OUTPUT 722;\"RQS 0\"",
"comment": "DISABLES ALL CONDITIONS"
}
],
"tier": "extended",
"tier_reason": "configures SRQ line assertion conditions -- relevant mainly for interrupt-driven architectures, not needed for simple polling",
"rationale": "status_error_readback"
},
{
"name": "RSTATE",
"manual_pages": [
"4-129",
"4-130"
],
"local": true,
"remote": true,
"description": "The RSTATE (recall state) command recalls a stored state from memory and configures the HP 3457 to that state.",
"syntax": "RSTATE name",
"parameters": [
{
"name": "name",
"description": "A decimal number designating the memory location.",
"values": [
{
"parameter": 0,
"description": "Present state is stored here whenever power is removed"
},
{
"parameter": "1-10",
"description": "Non-volatile memory (stored state is not lost when power is removed)"
},
{
"parameter": "11-30",
"description": "Volatile memory (stored state is lost when power is removed)"
}
],
"power_on_raw": "none",
"default_raw": "0"
}
],
"important_points": [
"You store states using the SSTATE command.",
"Whenever the HP 3457's power is removed, the present state is stored in non-volatile memory location 0. After a power failure, the HP 3457 can be easily reconfigured by executing RSTATE 0.",
"Stored states in memory locations 11 through 30 are destroyed whenever the HP 3457's power is removed.",
"If you attempt to recall an empty memory location, you'll get a PARAM RANGE error (error 6).",
"If a scan list was stored in a state, an advance is made to the first channel in the list when you recall the state.",
"If the NULL math operation was enabled in a stored state, after recalling the state the first reading is placed in the OFFSET register (see \"NULL\" in Chapter 3)."
],
"examples": [
{
"code": "OUTPUT 722;\"RSTATE 2\"",
"comment": "RECALLS STORED STATE FROM LOCATION #2"
}
],
"tier": "extended",
"tier_reason": "recalls a saved instrument configuration -- can be handy as a quick preset mechanism, but a host-side config dict replayed via normal commands is equally capable and more transparent",
"rationale": "era_computer_workaround"
},
{
"name": "SADV",
"manual_pages": [
"4-131",
"4-132"
],
"local": true,
"remote": true,
"description": "The SADV (scan advance) command designates the event that causes an advance to the next channel in a plug-in card's scan list.",
"syntax": "SADV event",
"parameters": [
{
"name": "event",
"description": "The event parameter choices are:",
"values": [
{
"parameter": "HOLD",
"decimal_equiv": 0,
"description": "No advance occurs (use this to stop SADV AUTO)",
"power_on": true,
"default": false
},
{
"parameter": "SGL",
"decimal_equiv": 1,
"description": "Advances once and stays at that channel",
"power_on": false,
"default": true
},
{
"parameter": "AUTO",
"decimal_equiv": 2,
"description": "Advances after each measurement",
"power_on": false,
"default": false
}
],
"power_on_raw": "HOLD",
"default_raw": "SGL"
}
],
"important_points": [
"You use the SADV command along with the SLIST command. SLIST designates the channel numbers in a scan list.",
"Many of the \"Important Points\" under the SLIST command also pertain to the SADV command.",
"If you execute the SADV command without a plug-in card in the HP 3457's rear slot, you'll get the BAD HEADER error."
],
"examples": [
{
"code": "10 OUTPUT 722;\"PRESET\"\n20 OUTPUT 722;\"TERM REAR\"\n30 OUTPUT 722;\"SADV AUTO\"\n40 OUTPUT 722;\"SLIST 2,1,5,7,4\"\n50 FOR I=1 TO 5\n60 ENTER 722;A\n70 DISP A\n80 NEXT I\n90 END",
"comment": "presets the HP 3457, selects the rear input source, sets scan advance to AUTO, sets up a scan list (which advances to the first channel), then loops reading and displaying 5 values",
"note": "PRESET configures automatic DC voltage measurements with synchronous triggering. SLIST advances to channel 2 first; after that, a scan advance occurs after each measurement, moving to 1, 5, 7, then 4. Since triggering is synchronous, each measurement is initiated when the computer requests data (line 60), making one measurement per channel."
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "SCRATCH",
"manual_pages": [
"4-133"
],
"local": false,
"remote": true,
"description": "The SCRATCH command clears all subprograms from subprogram memory.",
"syntax": "SCRATCH",
"parameters": [],
"important_points": [
"SCRATCH clears every subprogram from memory. There is no way to selectively clear any one subprogram."
],
"examples": [
{
"code": "OUTPUT 722;\"SCRATCH\"",
"comment": "CLEARS SUBPROGRAM MEMORY"
}
],
"tier": "extended",
"tier_reason": "only relevant if using SUB",
"rationale": "era_computer_workaround"
},
{
"name": "SECURE",
"manual_pages": [
"4-134"
],
"local": true,
"remote": true,
"description": "This is a service related command. Refer to the HP 3457 Service manual for details.",
"syntax": null,
"parameters": [],
"important_points": [],
"examples": [],
"service_command": true,
"tier": "extended",
"tier_reason": "service-only, no documented syntax",
"rationale": "diagnostic_calibration"
},
{
"name": "SLIST",
"manual_pages": [
"4-135",
"4-136"
],
"local": true,
"remote": true,
"description": "The SLIST (scan list) command designates a series of plug-in card channels to scan and advances to the first channel in the list.",
"syntax": "SLIST channel 1, channel 2, ... channel n",
"parameters": [
{
"name": "channel",
"description": "The channel number(s) to scan, in the order specified. Channel numbers are 0-13 for the HP 44491 and 0-9 for the HP 44492. For channel 8 or 9 on the HP 44491, a special numbering scheme selects a current input channel or opens/closes an actuator.",
"values": [
{
"parameter": 8,
"description": "Channel 8 is a current input"
},
{
"parameter": 9,
"description": "Channel 9 is a current input"
},
{
"parameter": 14,
"description": "Opens the channel 8 actuator with delay"
},
{
"parameter": 15,
"description": "Opens the channel 9 actuator with delay"
},
{
"parameter": 16,
"description": "Closes the channel 8 actuator"
},
{
"parameter": 17,
"description": "Closes the channel 9 actuator"
},
{
"parameter": 18,
"description": "Opens the channel 8 actuator without delay"
},
{
"parameter": 19,
"description": "Opens the channel 9 actuator without delay"
}
],
"power_on_raw": "none (empty list)",
"default_raw": "re-uses the previous list and selects the first channel in that list"
}
],
"important_points": [
"You use the SLIST command along with the SADV command. SADV designates the event that causes an advance to the next channel in the list.",
"To make a measurement on a scan list channel, you must specify the plug-in card as the input source using the TERM command. However, the plug-in card does not have to be specified as the input source to open or close an actuator channel.",
"Advancing beyond the last channel in the scan list causes a wrap-around to the first channel in the list.",
"From the controller, you can specify up to 20 channels in a scan list. From the HP 3457's front panel, the keyboard buffer limits the length to less than 20 channels.",
"If you execute the SLIST command without a plug-in card in the HP 3457's rear slot, you'll get the BAD HEADER error.",
"See the SLIST command listed under your particular plug-in card in Chapter 5 for additional \"Important Points.\""
],
"examples": [
{
"code": "10 OUTPUT 722;\"PRESET\"\n20 OUTPUT 722;\"TERM SCANNER\"\n30 OUTPUT 722;\"SADV AUTO\"\n40 OUTPUT 722;\"SLIST 3,5,16,6,14\"\n50 FOR I=1 TO 5\n60 ENTER 722;A\n70 DISP A\n80 NEXT I\n90 END",
"comment": "resets, selects the scanner input source, sets scan advance to AUTO, sets up a scan list including actuator designators, then loops reading and displaying 5 values",
"note": "SLIST advances to channel 3 first; a scan advance occurs after each measurement, moving to 5, 16, 6, 14, then wrapping back to 3. Advancing to 16 closes the channel 8 actuator (channel 5 remains the input and is measured); advancing to 6 keeps the actuator closed and measures channel 6; advancing to 14 opens the channel 8 actuator, and channel 6 is measured again."
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "SLIST?",
"manual_pages": [
"4-136",
"4-137"
],
"local": true,
"remote": true,
"description": "The SLIST? (scan list?) command returns the total number of channels in a scan list when executed from remote, or the actual channels in the list when executed from the HP 3457's keyboard.",
"syntax": "SLIST?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the SLIST? command by accessing the SLIST command from the alphabetic command directory and appending a question mark.",
"When you execute the SLIST? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the SLIST? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"When executed from the front panel, SLIST? returns \"EMPTY\" if there is no scan list. When executed from remote, SLIST? returns 0 if there is no scan list.",
"The display's buffer holds only 24 characters. It is possible to have more channels in the scan list than can be displayed."
],
"examples": [
{
"code": "10 OUTPUT 722;\"SLIST?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the number-of-channels response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "extended",
"tier_reason": "plug-in scanner card only",
"rationale": "plugin_card_dependent"
},
{
"name": "SMATH",
"manual_pages": [
"4-138",
"4-139"
],
"local": true,
"remote": true,
"description": "The SMATH (store math) command places a number in a math register.",
"syntax": "SMATH register, number",
"parameters": [
{
"name": "register",
"description": "The register parameter choices are (with power-on values):",
"values": [
{
"parameter": "DEGREE",
"decimal_equiv": 1,
"description": "Determines step response for FILTER operation",
"power_on_value": 20,
"default": true
},
{
"parameter": "LOWER",
"decimal_equiv": 2,
"description": "Smallest reading in STATS",
"power_on_value": 0,
"default": false
},
{
"parameter": "MAX",
"decimal_equiv": 3,
"description": "Upper limit for PFAIL operation",
"power_on_value": 0,
"default": false
},
{
"parameter": "MEAN",
"decimal_equiv": 4,
"description": "Average of readings in STATS",
"power_on_value": 0,
"default": false
},
{
"parameter": "MIN",
"decimal_equiv": 5,
"description": "Lower limit for PFAIL",
"power_on_value": 0,
"default": false
},
{
"parameter": "NSAMP",
"decimal_equiv": 6,
"description": "Number of samples in STATS",
"power_on_value": 0,
"default": false
},
{
"parameter": "OFFSET",
"decimal_equiv": 7,
"description": "Subtrahend in NULL and SCALE operations",
"power_on_value": 0,
"default": false
},
{
"parameter": "PERC",
"decimal_equiv": 8,
"description": "% value for PERC operation",
"power_on_value": 1,
"default": false
},
{
"parameter": "REF",
"decimal_equiv": 9,
"description": "Reference value for DB operation",
"power_on_value": 1,
"default": false
},
{
"parameter": "RES",
"decimal_equiv": 10,
"description": "Reference impedance for DBM operation",
"power_on_value": 50,
"default": false
},
{
"parameter": "SCALE",
"decimal_equiv": 11,
"description": "Divisor in the SCALE operation",
"power_on_value": 1,
"default": false
},
{
"parameter": "SDEV",
"decimal_equiv": 12,
"description": "Standard deviation in STATS",
"power_on_value": 0,
"default": false
},
{
"parameter": "UPPER",
"decimal_equiv": 13,
"description": "Largest reading in STATS",
"power_on_value": 0,
"default": false
},
{
"parameter": "HIRES",
"decimal_equiv": 14,
"description": "Extra digit for 10 or 100 PLC measurements",
"power_on_value": 0,
"default": false
}
],
"power_on_raw": "see per-value power_on_value column above",
"default_raw": "DEGREE"
},
{
"name": "number",
"description": "The value you want to place in the register.",
"values": [],
"power_on_raw": "see register listing above",
"default_raw": "last reading"
}
],
"important_points": [
"You can use SMATH to place a number into one of the registers that store readings (UPPER, SDEV, etc.), but that value will be replaced with a reading if the corresponding math function is enabled (e.g. STATS).",
"The DB and DBM math operations check the value in the corresponding REF or RES register only once, after the first reading. Place a value in REF or RES before enabling the corresponding DB or DBM math operation.",
"You cannot use -1 to default the number parameter. If you specify -1, you will actually write -1 to the register."
],
"examples": [
{
"code": "OUTPUT 722;\"SMATH 11,1E-3\"",
"comment": "PLACES THE VALUE \"1E-3\" IN THE SCALE REGISTER"
},
{
"code": "10 OUTPUT 722;\"OHM\"\n20 OUTPUT 722;\"TRIG SGL\"\n30 OUTPUT 722;\"SMATH RES\"\n40 DISP \"CONNECT VOLTAGE SOURCE; PRESS CONT\"\n50 PAUSE\n60 OUTPUT 722;\"ACV\"\n70 OUTPUT 722;\"MATH DBM\"\n80 OUTPUT 722;\"TRIG AUTO\"\n90 END",
"comment": "measures a resistance, stores the reading in RES, then prompts the operator to connect a voltage source and enables the DBM math operation to display power delivered to the resistance in dB",
"note": "Lines 10-20 measure the connected resistance. Line 30 defaults the number parameter, storing the reading in the RES register. Line 40 prompts the operator. Line 70 enables DBM, which uses the RES register as the reference impedance."
}
],
"tier": "extended",
"tier_reason": "Needed to preset registers for the value-transforming operations (NULL/SCALE/DB/DBM/PERC/FILTER/RMS/CTHRM/FTHRM) before enabling them -- those remain reasonably classified as host-replaceable (era_computer_workaround) since a host with the raw reading can trivially replicate the same arithmetic. STAT and PFAIL, by contrast, need no register presets at all and derive their value from something a host CANNOT replicate after the fact: an accurate accumulation over readings that were never successfully transferred. See MATH/MATH?'s tier_reason for the full explanation.",
"rationale": "era_computer_workaround"
},
{
"name": "SRQ",
"manual_pages": [
"4-140"
],
"local": false,
"remote": true,
"description": "The SRQ (service request) command sets bit 6 in the HP 3457's status register and sets the HP-IB SRQ line.",
"syntax": "SRQ",
"parameters": [],
"important_points": [],
"examples": [
{
"code": "OUTPUT 722;\"SRQ\"",
"comment": "SETS BIT 6 AND THE SRQ LINE"
}
],
"tier": "extended",
"tier_reason": "manually asserts SRQ -- niche/diagnostic",
"rationale": "status_error_readback"
},
{
"name": "SSTATE",
"manual_pages": [
"4-141",
"4-142"
],
"local": true,
"remote": true,
"description": "The SSTATE (store state) command stores the HP 3457's present state into a numbered memory location.",
"syntax": "SSTATE name",
"parameters": [
{
"name": "name",
"description": "A decimal number designating the memory location.",
"values": [
{
"parameter": 0,
"description": "Present state is stored here whenever power is removed"
},
{
"parameter": "1-10",
"description": "Non-volatile memory (stored state is not lost when power is removed)"
},
{
"parameter": "11-30",
"description": "Volatile memory (stored state is lost when power is removed)"
}
],
"power_on_raw": "none",
"default_raw": "0"
}
],
"important_points": [
"The contents of the following math registers are stored when you store a state (all other registers are set to 0): DEGREE, LOWER, OFFSET, PERC, REF, RES, SCALE, UPPER.",
"State memory is allocated in sequence. For example, if you allocate space for three states (in addition to state 0), you must use locations 1, 2, and 3 — you'll get the PARAM RANGE error (bit 6) if you try to use another location.",
"You need to allocate 69 bytes of state memory for each state you want to store. You allocate memory space using the MSIZE command. The default MSIZE value provides space for state locations 0 through 14. The HP 3457 always leaves space for memory location 0 regardless of the memory allocation.",
"If you try to store more states than memory permits, you'll get a PARAM RANGE error (bit 6).",
"Whenever the HP 3457's power is removed, the present state is stored in non-volatile memory location 0, regardless of whether you're using the SSTATE command. Any previously stored state in location 0 is replaced.",
"Stored states in memory locations 11 through 30 are destroyed whenever the HP 3457's power is removed.",
"Stored states are recalled using the RSTATE command."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MSIZE 32,32\"\n20 OUTPUT 722;\"SSTATE 2\"\n30 END",
"comment": "sets reading & program memory to minimum sizes (32 bytes each), then stores the present state in location #2",
"note": "Setting reading and program memory to their minimum sizes leaves 2144 bytes of memory for state storage (enough for 30 states)."
}
],
"tier": "extended",
"tier_reason": "only relevant if using RSTATE",
"rationale": "era_computer_workaround"
},
{
"name": "STB?",
"manual_pages": [
"4-143",
"4-144"
],
"local": true,
"remote": true,
"description": "The status register contains seven bits that monitor various HP 3457 conditions. When a condition occurs, the corresponding bit is set. The STB? (status byte?) command returns a number representing the set bits — the weighted sum of all set bits.",
"syntax": "STB?",
"parameters": [
{
"name": "(none; query command)",
"description": "Status register conditions and their weights:",
"values": [
{
"parameter": 1,
"bit": 0,
"description": "Program Memory Execution Completed"
},
{
"parameter": 2,
"bit": 1,
"description": "Hi or Lo Limit Exceeded"
},
{
"parameter": 4,
"bit": 2,
"description": "Front Panel SRQ"
},
{
"parameter": 8,
"bit": 3,
"description": "Power On SRQ"
},
{
"parameter": 16,
"bit": 4,
"description": "Ready"
},
{
"parameter": 32,
"bit": 5,
"description": "Error (consult error register)"
},
{
"parameter": 64,
"bit": 6,
"description": "Service Requested (you cannot disable this bit)"
},
{
"parameter": 128,
"bit": 7,
"description": "Not used"
}
],
"power_on_raw": null,
"default_raw": null
}
],
"important_points": [
"When you execute the STB? command, the ready bit (bit 4) is always clear (not ready) because the HP 3457 is processing the STB? command.",
"When you execute the STB? command from the HP 3457's front panel, the weighted sum goes to the display. When executed from the controller, the weighted sum goes to the HP 3457's output buffer in ASCII format. After executing the STB? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII).",
"The STB? command returns a 0 if no error bits are set.",
"The CSB command clears the status register. The RQS command designates which status register conditions will assert SRQ on the HP-IB bus."
],
"examples": [
{
"code": "10 OUTPUT 722;\"STB?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the weighted sum of all set bits; line 20 enters the response into variable A; line 30 displays the response",
"note": "If this program returns the weighted sum 24, that means the bits with weighted values 8 (power-on SRQ) and 16 (ready) are set."
}
],
"tier": "core",
"tier_reason": "status byte read -- basic status polling",
"rationale": "status_error_readback"
},
{
"name": "SUB",
"manual_pages": [
"4-145",
"4-146"
],
"local": false,
"remote": true,
"description": "The SUB (subprogram) command stores a subprogram into a numbered subprogram memory location.",
"syntax": "SUB name",
"parameters": [
{
"name": "name",
"description": "A decimal number from 0 to 19 that designates the subprogram memory location.",
"values": [],
"power_on_raw": "none",
"default_raw": "0"
}
],
"important_points": [
"You indicate the end of a subprogram using the SUBEND command. You execute a subprogram using the CALL command. You can suspend subprogram execution, at some point, by including the PAUSE command in the subprogram.",
"You can store up to 20 subprograms. The maximum subprogram size depends on the memory space allocated (MSIZE command); the default MSIZE value provides 100 bytes of space. If you don't allocate enough subprogram memory, you'll get the SYNTAX ERROR when you attempt to store a subprogram. See \"Subprogram Storage\" in Chapter 3.",
"If you try to store a new subprogram using the name of an existing subprogram, the HP 3457 stores the new subprogram in another location in subprogram memory. Both subprograms still exist, but you cannot access the first. If there isn't enough memory for both, you'll get the SYNTAX ERROR.",
"If a syntax error, a CALL, SCRATCH, MSIZE, a second SUB, or the HP-IB Device Clear command occurs in a subprogram, the HP 3457 aborts subprogram storage. When aborted, none of the subprogram is stored, no memory is used, and any subsequent commands are executed (not stored).",
"To save memory space, use the numeric equivalent of parameters or default them whenever possible.",
"Subprograms are destroyed whenever the HP 3457's power is removed."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MSIZE 32,1000\"\n20 OUTPUT 722;\"MEM FIFO\"\n30 OUTPUT 722;\"SUB 2\"\n40 OUTPUT 722;\"DCI 1,.01\"\n50 OUTPUT 722;\"NRDGS 5,AUTO\"\n60 OUTPUT 722;\"TRIG SGL\"\n70 OUTPUT 722;\"SUBEND\"\n80 END",
"comment": "allocates 32 bytes reading / 1000 bytes subprogram memory, enables FIFO reading memory, then stores lines 40-60 as subprogram #2 (DC current measurement, 5 readings, single trigger)",
"note": "To execute the stored subprogram, send: OUTPUT 722;\"CALL 2\""
}
],
"tier": "extended",
"tier_reason": "on-instrument BASIC-like subprogram storage -- a design from an era when the DMM sometimes needed to run autonomously between host commands; a modern Python controller can simply issue commands directly instead of pre-storing a program on the instrument",
"rationale": "era_computer_workaround"
},
{
"name": "SUBEND",
"manual_pages": [
"4-147"
],
"local": false,
"remote": true,
"description": "The SUBEND (subprogram end) command signals the end of a subprogram.",
"syntax": "SUBEND",
"parameters": [],
"important_points": [
"When storing a subprogram, SUBEND signals the subprogram's end. When a subprogram has been executed, SUBEND sets bit 1 (if enabled) in the status register, signaling the subprogram's completion.",
"If you send SUBEND without first sending SUB, the HP 3457 sets the \"Program Memory Execution Complete\" bit (bit 1) in the status register."
],
"examples": [
{
"code": "10 OUTPUT 722;\"MSIZE 32,100\"\n20 OUTPUT 722;\"SUB 1\"\n30 OUTPUT 722;\"DCI 1,.01\"\n40 OUTPUT 722;\"TRIG SGL\"\n50 OUTPUT 722;\"SUBEND\"\n60 END",
"comment": "allocates 32 bytes reading / 100 bytes subprogram memory, then stores lines 30-40 as subprogram #1 (DC current measurement, single trigger)",
"note": "To execute the stored subprogram, send: OUTPUT 722;\"CALL 1\""
}
],
"tier": "extended",
"tier_reason": "only relevant if using SUB",
"rationale": "era_computer_workaround"
},
{
"name": "T",
"manual_pages": [
"4-148"
],
"local": true,
"remote": true,
"description": "The T command is an abbreviation of the TRIG command. Except for the syntax, the T and TRIG commands are identical.",
"syntax": "T event",
"parameters": [],
"important_points": [],
"examples": [],
"see_also": "TRIG",
"tier": "extended",
"tier_reason": "bare syntax alias of TRIG; no functional reason to use over TRIG",
"rationale": "wire_efficiency"
},
{
"name": "TARM",
"manual_pages": [
"4-149",
"4-150",
"4-151"
],
"local": true,
"remote": true,
"description": "The TARM (trigger arm) command defines the event that enables (arms) the specified trigger event. You can also use this command to perform multiple measurement cycles.",
"syntax": "TARM event, number arms",
"parameters": [
{
"name": "event",
"description": "The event parameter choices are:",
"values": [
{
"parameter": "AUTO",
"decimal_equiv": 1,
"description": "Always armed",
"power_on": true,
"default": true
},
{
"parameter": "EXT",
"decimal_equiv": 2,
"description": "Armed on external input",
"power_on": false,
"default": false
},
{
"parameter": "SGL",
"decimal_equiv": 3,
"description": "Armed once (upon receipt of TARM SGL) then HOLD",
"power_on": false,
"default": false
},
{
"parameter": "HOLD",
"decimal_equiv": 4,
"description": "Trigger disabled",
"power_on": false,
"default": false
},
{
"parameter": "SYN",
"decimal_equiv": 5,
"description": "Armed when the HP 3457's output buffer is empty, reading memory is off or empty, and the controller requests data from the HP 3457",
"power_on": false,
"default": false
}
],
"power_on_raw": "AUTO",
"default_raw": "AUTO"
},
{
"name": "number arms",
"description": "A number between 0 and 32767. When 0, the trigger is armed per the event table above. When 1-32767 (\"multiple arming\"), the HP 3457 generates enough single trigger arms to satisfy the number — e.g. specifying 5 arms the trigger 5 times.",
"values": [],
"power_on_raw": "0",
"default_raw": "0"
}
],
"important_points": [
"The trigger arm event operates along with the trigger event (a TRIG parameter) and the sample event (an NRDGS parameter). To make a measurement, the trigger arm event must occur first, followed by the trigger event, and finally the sample event.",
"The trigger arm event does not necessarily initiate a trigger — it merely enables a trigger, making it possible for one to occur. See \"Triggering\" in Chapter 3.",
"The SGL trigger arm event and the SGL trigger event do not work together. Do not specify TARM SGL and TRIG SGL in the same program.",
"Multiple arming: the trigger arm event must be specified as SGL. When the HP 3457 executes a TARM command specifying multiple arming, it holds the HP-IB bus until all measurement cycles are complete — so the TARM command must be the last line in the program, and you cannot use the synchronous trigger or sample event. When encountered in a subprogram, subprogram execution is suspended until the measurement cycles complete."
],
"examples": [
{
"code": "OUTPUT 722;\"TARM AUTO,0\"",
"comment": "ARMS TRIGGERING AUTOMATICALLY (ALWAYS ARMED)"
},
{
"code": "10 OUTPUT 722;\"TARM HOLD\"\n20 OUTPUT 722;\"OHM\"\n30 OUTPUT 722;\"MSIZE 200\"\n40 OUTPUT 722;\"MEM FIFO\"\n50 OUTPUT 722;\"NRDGS 5\"\n60 OUTPUT 722;\"TARM SGL\"\n70 END",
"comment": "suspends measurements, selects 2-wire ohms, allocates reading memory, enables FIFO memory, sets 5 readings per sample event, then enables one series of measurements"
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"TARM HOLD\"\n30 OUTPUT 722;\"TRIG AUTO\"\n40 OUTPUT 722;\"MSIZE 200\"\n50 OUTPUT 722;\"MEM FIFO\"\n60 OUTPUT 722;\"NRDGS 3,AUTO\"\n70 OUTPUT 722;\"TARM SGL,5\"\n80 END",
"comment": "selects DC voltage, suspends measurements, sets AUTO trigger event, allocates reading memory, sets 3 readings per sample event, then selects multiple arming for 5 cycles",
"note": "Line 70 arms the trigger once per cycle, 5 times; after the 5th cycle, trigger arming reverts to HOLD. This places 15 readings (3 x 5) into reading memory. Unless the input buffer is enabled, line 70 holds the HP-IB bus until all cycles complete; to regain control immediately, suppress <CR><LF>: OUTPUT 722 USING \"#,K\";\"TARM SGL,5;\""
}
],
"tier": "core",
"tier_reason": "fundamental trigger-arm control; the 'number arms' multiple-arming parameter is also genuinely useful here (not just a 1980s-era optimization) because it lets the DMM run a whole burst of N measurement cycles without a host round trip per cycle -- valuable on this project's Prologix-over-Ethernet transport where per-command latency is real, not just on slow historical GPIB cards",
"rationale": "acquisition_timing"
},
{
"name": "TARM?",
"manual_pages": [
"4-152"
],
"local": true,
"remote": true,
"description": "The TARM? (trigger arm?) command returns a number representing the trigger arm event: AUTO=1, EXT=2, HOLD=4, SYN=5.",
"syntax": "TARM?",
"parameters": [],
"important_points": [
"After executing a SGL (3) trigger arm, the trigger arm event reverts to HOLD (4). This means TARM? can never return 3 (SGL).",
"From the HP 3457's front panel, you execute the TARM? command by accessing the TARM command from the alphabetic command directory and appending a question mark.",
"When you execute the TARM? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the TARM? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TARM?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the trigger arm event response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back trigger arm event",
"rationale": "acquisition_timing"
},
{
"name": "TBUFF",
"manual_pages": [
"4-152A"
],
"local": true,
"remote": true,
"description": "The TBUFF (trigger buffer) command disables the TRIGGER TOO FAST error and stores the first external trigger that occurs during a measurement.",
"syntax": "TBUFF control",
"parameters": [
{
"name": "control",
"description": "The control parameter choices are:",
"values": [
{
"parameter": "OFF",
"decimal_equiv": 0,
"description": "Disables trigger buffering and enables the TRIGGER TOO FAST error",
"power_on": true,
"default": true
},
{
"parameter": "ON",
"decimal_equiv": 1,
"description": "Enables trigger buffering and disables the TRIGGER TOO FAST error",
"power_on": false,
"default": false
}
],
"power_on_raw": "OFF",
"default_raw": "OFF"
}
],
"important_points": [
"Executing the PRESET or RESET command sets TBUFF to OFF. Recalling a state does not affect the present TBUFF setting.",
"If the HP 3457 is continuously triggered with TBUFF ON, it may ignore commands sent over the bus."
],
"examples": [
{
"code": "OUTPUT 722;\"TBUFF ON\"",
"comment": "DISABLES TRIGGER TOO FAST ERROR"
}
],
"tier": "extended",
"tier_reason": "niche external-trigger buffering edge case",
"rationale": "bus_protocol"
},
{
"name": "TERM",
"manual_pages": [
"4-153"
],
"local": true,
"remote": true,
"description": "The TERM (terminal) command selects the HP 3457's input source for making measurements.",
"syntax": "TERM source",
"parameters": [
{
"name": "source",
"description": "The source parameter choices are:",
"values": [
{
"parameter": "OPEN",
"decimal_equiv": 0,
"description": "Disconnects all input sources",
"power_on": false,
"default": false
},
{
"parameter": "FRONT",
"decimal_equiv": 1,
"description": "Selects front terminals",
"power_on": true,
"default": true
},
{
"parameter": "REAR",
"decimal_equiv": 2,
"description": "Selects rear terminals or plug-in card",
"power_on": false,
"default": false
},
{
"parameter": "SCANNER",
"decimal_equiv": 2,
"description": "Selects rear terminals or plug-in card (identical to REAR)",
"power_on": false,
"default": false
}
],
"power_on_raw": "FRONT",
"default_raw": "FRONT"
}
],
"important_points": [
"Both the REAR and SCANNER source parameters select whatever device is installed in the rear of the HP 3457 — either the rear terminal block or a plug-in card."
],
"examples": [
{
"code": "OUTPUT 722;\"TERM SCANNER\"",
"comment": "SELECTS DEVICE IN REAR SLOT AS INPUT SOURCE"
}
],
"tier": "core",
"tier_reason": "input source selection (front/rear/plug-in)",
"rationale": "measurement_hardware"
},
{
"name": "TERM?",
"manual_pages": [
"4-154"
],
"local": true,
"remote": true,
"description": "The TERM? (terminal?) command returns a number representing the presently selected input terminals: 0 = all input terminals disconnected, 1 = front terminals, 2 = rear terminals or plug-in card.",
"syntax": "TERM?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the TERM? command by accessing the TERM command from the alphabetic command directory and appending a question mark.",
"When you execute the TERM? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the TERM? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TERM?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the terminal response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back input source",
"rationale": "measurement_hardware"
},
{
"name": "TEST",
"manual_pages": [
"4-155",
"4-156"
],
"local": true,
"remote": true,
"description": "The TEST command causes the HP 3457 to perform a series of internal self-tests.",
"syntax": "TEST",
"parameters": [],
"important_points": [
"Always disconnect any input signals before you run self-test. If you leave an input signal connected to the HP 3457, it may cause a self-test failure.",
"Self-test failures can set bit 9 or 10 in the error register, and any of the hardware error bits in the auxiliary error register. If a hardware error occurs, the HP 3457 sets bit 0 in the error register and a more descriptive bit in the auxiliary error register. The display's ERR annunciator flashes whenever an error is in the error register. You access the error registers with the ERR? and AUXERR? commands.",
"The HP 3457's self-tests are very extensive. If no failures occur, you have a very high confidence level that the HP 3457 is working and that measurements will be accurate.",
"A self-test failure indicates that the HP 3457 is out of calibration or malfunctioning. If bit 10 is set in the error register (ACAL REQUIRED) perform autocalibration and repeat the self-test. If self-test fails again, refer to the HP 3457 Service Manual.",
"You read the error register using the ERR? command. You read the auxiliary error register using the AUXERR? command."
],
"examples": [
{
"code": "OUTPUT 722;\"TEST\"",
"comment": "RUNS SELF-TEST",
"note": "This sends <CR><LF> following the command, which holds the HP-IB bus (unless the input buffer is enabled) until self-test completes. To regain control of the bus immediately, suppress <CR><LF>: OUTPUT 722 USING \"#,K\";\"TEST;\""
}
],
"tier": "extended",
"tier_reason": "self-test -- useful for startup health checks / diagnostics, not routine measurement",
"rationale": "diagnostic_calibration"
},
{
"name": "TIMER",
"manual_pages": [
"4-157",
"4-158"
],
"local": true,
"remote": true,
"description": "The TIMER command defines the time interval for the TIMER sample event in the NRDGS command. When using the TIMER event, the time interval is inserted between readings.",
"syntax": "TIMER time",
"parameters": [
{
"name": "time",
"description": "A number between 600E-6 (600 µs) and 2100 seconds, in 1 µs increments.",
"values": [],
"power_on_raw": "1 (second)",
"default_raw": "1 (second)"
}
],
"important_points": [
"The time is most accurate for DC voltage measurements (DCV command) with .1 or less power line cycles of integration time (NPLC command), and autozero disabled (AZERO command). It is less accurate for other measurement functions, different integration times, and when autozero is enabled. It is very inaccurate when the HP 3457 is in the overload condition.",
"When using the TIMER event, the first reading occurs without the time interval. You can insert a time interval before the first measurement using the DELAY command.",
"When using the TIMER event, autoranging is suspended. Autoranging resumes when you specify a different sample event.",
"The specified time equals the time from the beginning of one reading to the beginning of the next reading."
],
"examples": [
{
"code": "OUTPUT 722;\"TIMER 3\"",
"comment": "SELECTS 3 SECOND INTERVAL BETWEEN READINGS"
},
{
"code": "10 OUTPUT 722;\"TRIG HOLD\"\n20 OUTPUT 722;\"INBUF ON\"\n30 OUTPUT 722;\"DCV\"\n40 OUTPUT 722;\"NPLC .1\"\n50 OUTPUT 722;\"AZERO OFF\"\n60 OUTPUT 722;\"MSIZE 200\"\n70 OUTPUT 722;\"MEM FIFO\"\n80 OUTPUT 722;\"TIMER 2\"\n90 OUTPUT 722;\"NRDGS 10,TIMER\"\n100 OUTPUT 722;\"TRIG SGL\"\n110 END",
"comment": "sets up 10 DC voltage readings with a 2-second interval between them, using minimal integration time and autozero disabled for maximum timer accuracy"
}
],
"tier": "core",
"tier_reason": "sets the interval for TIMER-based sample events -- offloads precise inter-reading timing to the DMM's own clock, which is more accurate than software-side polling/sleep jitter from a host",
"rationale": "acquisition_timing"
},
{
"name": "TIMER?",
"manual_pages": [
"4-159"
],
"local": true,
"remote": true,
"description": "The TIMER? command returns the present time interval, in seconds, for the NRDGS timer event.",
"syntax": "TIMER?",
"parameters": [],
"important_points": [
"From the HP 3457's front panel, you execute the TIMER? command by accessing the TIMER command from the alphabetic command directory and appending a question mark.",
"When you execute the TIMER? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the TIMER? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TIMER?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the time interval response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back TIMER",
"rationale": "acquisition_timing"
},
{
"name": "TONE",
"manual_pages": [
"4-160"
],
"local": true,
"remote": true,
"description": "The TONE command generates a tone from the HP 3457's beeper.",
"syntax": "TONE frequency, duration",
"parameters": [
{
"name": "frequency",
"description": "A number between 0 and 3000 (Hz).",
"values": [],
"power_on_raw": "none",
"default_raw": "2048"
},
{
"name": "duration",
"description": "A number between 0 and 32767 (milliseconds).",
"values": [],
"power_on_raw": "none",
"default_raw": "512"
}
],
"important_points": [
"The BEEP command has no effect on the TONE command."
],
"examples": [
{
"code": "OUTPUT 722;\"TONE 1500,1200\"",
"comment": "GENERATES A 1500HZ TONE FOR 1200 mSECONDS"
}
],
"tier": "extended",
"tier_reason": "arbitrary beeper tone -- diagnostic/novelty use only",
"rationale": "ui_frontpanel_only"
},
{
"name": "TRIG",
"manual_pages": [
"4-161",
"4-162",
"4-163"
],
"local": true,
"remote": true,
"description": "The TRIG (trigger) command allows you to specify the event that enables a measurement.",
"syntax": "TRIG event",
"parameters": [
{
"name": "event",
"description": "The event parameter choices are:",
"values": [
{
"parameter": "AUTO",
"decimal_equiv": 1,
"description": "Triggers when not busy",
"power_on": true,
"default": false
},
{
"parameter": "EXT",
"decimal_equiv": 2,
"description": "Triggers on external input",
"power_on": false,
"default": false
},
{
"parameter": "SGL",
"decimal_equiv": 3,
"description": "Triggers once (upon receipt of TRIG SGL) then HOLDs",
"power_on": false,
"default": true
},
{
"parameter": "HOLD",
"decimal_equiv": 4,
"description": "Stops triggering",
"power_on": false,
"default": false
},
{
"parameter": "SYN",
"decimal_equiv": 5,
"description": "Triggers when the HP 3457's output buffer is empty, reading memory is off or empty, and the controller requests data from the HP 3457",
"power_on": false,
"default": false
}
],
"power_on_raw": "AUTO",
"default_raw": "SGL"
}
],
"important_points": [
"The trigger event operates along with the trigger arm event (a TARM parameter) and the sample event (an NRDGS parameter). To make a measurement, the trigger arm event must occur first, followed by the trigger event, and finally the sample event. The trigger event does not necessarily initiate a measurement — it merely enables one; the measurement is initiated when the sample event (NRDGS command) occurs. See \"Triggering Measurements\" in Chapter 3.",
"The SGL trigger arm and SGL trigger events do not work together. Do not specify TARM SGL and TRIG SGL in the same program.",
"The number of measurements made per trigger and the event that initiates each measurement (sample event) is determined by the NRDGS command. When NRDGS specifies 1 reading and the AUTO sample event, the trigger event initiates the measurement.",
"The trigger function must be armed (see the TARM command) before the TRIG command can enable a measurement."
],
"examples": [
{
"code": "OUTPUT 722;\"TRIG AUTO\"",
"comment": "SELECTS AUTO TRIGGER"
},
{
"code": "10 OUTPUT 722;\"DCV 3,.1\"\n20 OUTPUT 722;\"NRDGS 1,SYN\"\n30 OUTPUT 722;\"MEM OFF\"\n40 OUTPUT 722;\"TRIG EXT\"\n50 ENTER 722;A\n60 DISP A\n70 END",
"comment": "shows the interaction of TRIG and NRDGS: a transition on the external trigger input (line 40) must occur first, then the controller requesting data with an empty output buffer (line 50) satisfies the SYN sample event and initiates the measurement"
},
{
"code": "10 OUTPUT 722;\"DCV\"\n20 OUTPUT 722;\"TRIG HOLD\"\n30 OUTPUT 722;\"NRDGS 3,AUTO\"\n40 OUTPUT 722;\"TRIG SGL\"\n50 END",
"comment": "suspends measurements (TRIG HOLD), sets 3 readings per sample event, then generates a single trigger causing 3 readings",
"note": "After the three readings, the trigger event reverts to HOLD. Unless the input buffer is enabled, line 40 holds the HP-IB bus until the sequence completes; to regain control immediately, suppress <CR><LF>: 40 OUTPUT 722 USING \"#,K\";\"TRIG SGL;\""
}
],
"tier": "core",
"tier_reason": "fundamental trigger event control",
"rationale": "acquisition_timing"
},
{
"name": "TRIG?",
"manual_pages": [
"4-164"
],
"local": true,
"remote": true,
"description": "The TRIG? (trigger?) command returns a number representing the trigger event: AUTO=1, EXT=2, HOLD=4, SYN=5.",
"syntax": "TRIG?",
"parameters": [],
"important_points": [
"After executing a single trigger (TRIG SGL), the trigger event reverts to HOLD (4). For this reason, TRIG? will never return 3 (SGL).",
"From the HP 3457's front panel, you execute the TRIG? command by accessing the TRIG command from the alphabetic command directory and appending a question mark.",
"When you execute the TRIG? command from the HP 3457's front panel, the response goes to the display. When executed from the controller, the response goes to the HP 3457's output buffer in ASCII format. After executing the TRIG? command, the output format returns to the previously specified type (SINT, DINT, SREAL, or ASCII)."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TRIG?\"\n20 ENTER 722;A\n30 DISP A\n40 END",
"comment": "line 10 returns the trigger event response; line 20 enters the response into variable A; line 30 displays the response"
}
],
"tier": "core",
"tier_reason": "read back trigger event",
"rationale": "acquisition_timing"
},
{
"name": "?",
"manual_pages": [
"4-165",
"4-166"
],
"local": false,
"remote": true,
"description": "When the HP 3457 is properly configured (see \"Prerequisites\"), the ? command generates a single trigger.",
"syntax": "?",
"parameters": [],
"prerequisites": "The HP 3457 must be configured to accept the ? command before you send it, by sending: TARM AUTO, NRDGS 1,AUTO, TRIG HOLD or SGL. If not configured this way, no single trigger is generated and you'll get the BAD HEADER error (bit 4) when you send the ? command.",
"important_points": [
"You can append an HP 3457 command to a ? command without the need for a delimiter (shown in the second example).",
"You can send a series of ? commands without the need for delimiters. If the input buffer is enabled, however, a series of ? commands will flag the TRIGGER TOO FAST error (bit 2). Always disable the input buffer (INBUF OFF) before sending a series of ? commands (shown in the third example).",
"You cannot store a ? command as part of a subprogram. If you attempt to, the HP 3457 aborts subprogram storage and flags the SYNTAX ERROR (bit 3).",
"Do not confuse the remote ? command with the shifted ? key on the HP 3457's front panel. The ? key is used for appending a question mark to a command to create a query command."
],
"examples": [
{
"code": "10 OUTPUT 722;\"TARM AUTO\"\n20 OUTPUT 722;\"NRDGS 1,AUTO\"\n30 OUTPUT 722;\"TRIG HOLD\"\n40 OUTPUT 722;\"DCV\"\n50 OUTPUT 722;\"?\"\n60 END",
"comment": "configures the HP 3457 to accept the ? command (auto trigger arming, 1 reading per AUTO sample event, trigger set to HOLD, DCV selected), then generates a single trigger"
},
{
"code": "OUTPUT 722;\"?BEEP\"",
"comment": "GENERATES SINGLE TRIGGER AND BEEPS",
"note": "Demonstrates appending another command directly after ? with no delimiter needed."
},
{
"code": "10 OUTPUT 722;\"INBUF OFF\"\n20 OUTPUT 722;\"F13?????\"\n30 END",
"comment": "disables the input buffer, then selects DC voltage / 3V range and generates 5 single triggers via 5 consecutive ? characters",
"note": "A series of ? commands needs no delimiters between them, but requires the input buffer to be OFF to avoid the TRIGGER TOO FAST error."
}
],
"tier": "extended",
"tier_reason": "single-byte trigger shorthand, functionally redundant with TRIG SGL; only matters if per-command byte count/latency is a measured bottleneck",
"rationale": "wire_efficiency"
}
]
}
Reference in New Issue View Git Blame Copy Permalink