Firmware-Settings

Some parameters of the firmware are configurable. These settings can be displayed and changed with the ‘CONFIG’ command set. The commands are grouped in a tree structure.

CONFIG?

Returns all customizable settings of the firmware configuration.

Syntax:

CONFIG?

Example output:

Basic Version:                         DPO BASIC (1975)
Apply Basic cheats:                    Yes
Loglevel:                              1 (ERROR)
Print error messages to USB:           Yes
Print status messages to USB:          Yes
Use USB as printer replacement:        Yes
Pulse Parameters Date:                 JULY 29,1974
Pulse Parameters Histogram resolution: 1
Pulse Parameters Voltage roundoff:     0
Pulse Parameters Time roundoff:        0
Pulse Parameters Deviation roundoff:   0
Pulse Parameters Exclusion Zone:       1

The individual commands are explained in the sections below.

BASIC

Returns the customizable settings related to the BASIC emulation layer of the firmware.

Syntax:

CONFIG:BASIC?

Example output:

Basic Version:                         DPO BASIC (1975)
Apply Basic cheats:                    Yes

The commands are explained in the sections below.

VERSION

Displays or sets the Basic version used by the firmware emulation layer. Two major BASIC versions were released for the DPO - “Tek DPO BASIC” and “Tek SPS BASIC”. For completeness the firmware also supports the prototype BASIC version which was used in very early ads and exhibitions.

Syntax:

CONFIG:BASIC:VERSION?
CONFIG:BASIC:VERSION [1973|1975|1980|PROTOTYPE|DPO_BASIC|SPS_BASIC]

The default value is 1975 (Tek SPS BASIC)

CHEATS

Some of the supported BASIC versions have small, but annoying errors like unnecessary line breaks in the middle of a word. Those things can be corrected with this setting.

Syntax:

CONFIG:BASIC:CHEATS?
CONFIG:BASIC:CHEATS [1|0|Y|N]

The default value is “Y”

TERMINAL

Returns the customizable settings related to the Terminal portion of the firmware.

Syntax:

CONFIG:TERMINAL?

Example output:

Loglevel:                              1 (ERROR)
Print error messages to USB:           Yes
Print status messages to USB:          Yes
Use USB as printer replacement:        Yes

The individual commands are explained in the sections below.

LOGLEVEL

The USB interface can provide logging messages for debugging and development purposes. Higher loglevels provide more detailled information. Valid settings are: 0 (nothing), 1 (errors only), 2 (errors + warnings), 3 (errors, warnings and selected addigtional infos), 4 (everything)

Syntax:

CONFIG:TERMINAL:LOGLEVEL?
CONFIG:TERMINAL:LOGLEVEL [0..4|OFF|ERROR|WARNING|INFO|DEBUG]

Valid settings are:

Loglevels Description

Setting

Name

Description

0

off

Nothing is logged

1

error

Software errors are logged

2

warning

Errors & warnings are logged

3

info

Errors, warnings & important infos

4

debug

Everything is logged including firmware debugging stuff

The default value is 1 (Error)

HWERROR

The DPO is capable of detecting bus conflict errors. The most likely cause for this kind of error is an attempt to communicate with a non-existent hardware address.

Syntax:

CONFIG:TERMINAL:HWERROR?
CONFIG:TERMINAL:HWERROR [1|0|Y|N]

The default value is 1

STATUSMSG

When this function is enabled, the USB interface sends a status message immediately after a USB connection is established. The status message is identical to the response to the ID? command.

Syntax:

CONFIG:TERMINAL:STATUSMSG?
CONFIG:TERMINAL:STATUSMSG [1|0|Y|N]

Example output of the status message:

P7001 USB Interface, HW:1.0, 04E9E50F4987
DPO: 1KB
Firmware: FW:2.0.0.1 - 2024-01-16 20-10-59 UTC
COPYRIGHT 2021..2025 HOLGER LUEBBEN

The default value is 1

PRINTER

Some programs, such as Pulse Parameter, use a printer as an additional output device. This setting redirects these outputs to the terminal connection.

Syntax:

CONFIG:TERMINAL:PRINTER?
CONFIG:TERMINAL:PRINTER [1|0|Y|N]

The default value is 1

PULSE

Returns the customizable options related to the Pulse Parameters program.

Syntax:

CONFIG:PULSE?

Example output:

Pulse Parameters Date:                 JULY 29,1974
Pulse Parameters Histogram resolution: 1
Pulse Parameters Voltage roundoff:     0
Pulse Parameters Time roundoff:        0
Pulse Parameters Deviation roundoff:   0
Pulse Parameters Exclusion Zone:       1

The individual commands are explained in the sections below.

DATE

This date is used on printouts from the program. It follows the current date or can be set to a fixed date.

Syntax:

CONFIG:PULSE:DATE?
CONFIG:PULSE:DATE 1974-07-04
CONFIG:PULSE:DATE 0-0-0

The accepted formats are:

yyyy-MM-dd

and

YY-MM-dd

Explanation

YY

The year as a two-digit number. The valid range is from 70 to 99 and 00 to 69.

yyyy

The year as a four-digit number. The valid range is from 1970 to 2500

MM

The month, from 01 through 12.

dd

The day of the month, from 01 through 31.

When all parameters are set to 0, the current date wil be used on printouts. The delimeter can be any character which is not a semicolon, a number or part of a numerical expression. The minus sign is allowed as a delimiter for this call. Some basic sanity checks are done on the input. Additional time parameters in the format HH:mm:ss are accepted but ignored.

The default date is: JULY 29,1974

HISTRESOLUTION

Syntax:

CONFIG:PULSE:HISTRESOLUTION?
CONFIG:PULSE:HISTRESOLUTION [1..8]

This value specifies the number of points used in forming the amplitude histogram. A value of 2 specifies a 512/2 = 256-point histogram. The allowable range is from 1 through 8. Beyond 8, too few point are used for a reliable histogram.

The default value is: 1

VOLTROUNDOFF

Syntax:

CONFIG:PULSE:VOLTROUNDOFF?
CONFIG:PULSE:VOLTROUNDOFF [0.1 .. 100.0]

This value specifies the percent of full-scale roundoff to be used in computing voltage measurements. A given value of 0.0 disables rounding. See the Pulse Parameters Manual 070-1883-00 for further details.

The default value is: 0.0

TIMEROUNDOFF

Syntax:

CONFIG:PULSE:TIMEROUNDOFF?
CONFIG:PULSE:TIMEROUNDOFF [0.1 .. 100.0]

This value specifies the percent of full-scale roundoff to be used in computing time measurements. A given value of 0.0 disables rounding. See the Pulse Parameters Manual 070-1883-00 for further details.

The default value is: 0.0

DEVROUNDOFF

Syntax:

CONFIG:PULSE:DEVROUNDOFF?
CONFIG:PULSE:DEVROUNDOFF [0.1 .. 100.0]

This value specifies the roundoff used in computing figures for deviations from the ideal waveform. This percent of roundoff is with respect to the amplitude of the deviation waveform. See the Pulse Parameters Manual 070-1883-00 for further details.

The default value is: 0.0

EXCLUSIONZONE

Syntax:

CONFIG:PULSE:EXCLUSIONZONE?
CONFIG:PULSE:EXCLUSIONZONE [>0]

This value used in specifying the exclusion zone size when computing deviations excluding transitions. This exclusion zone (or zones if there are two transitions) are zeroed out in the deviation waveform before the maximum, minimum, and total deviations are computed. The manner in which EX is used in determining an exclusion zone is shown in the image below. See the Pulse Parameters Manual 070-1883-00 for further details.

Computing exclusion zones with EX.