beautypg.com

Symbol description, Parameter type, Symbol description -5 – RIGOL DG1000Z Series User Manual

Page 11: Parameter type -5

background image

Chapter 1 Programming Overview

RIGOL

DG1000Z Programming Guide

1-5

Symbol Description

The following symbols are not the content of the SCPI commands and will not be sent with the commands.

They are usually used to describe the parameters in the commands.

1. Braces {}

Multiple optional parameters are enclosed in the braces and one of the parameters must be selected

when sending the command. For example, :DISPlay:MODE {DPV|DGV|SV}.

2. Vertical Bar |

The vertical bar is used to separate multiple parameters and one of the parameters must be selected

when sending the command. For example, :DISPlay:MODE {DPV|DGV|SV}.

3. Square Brackets []

The content (command keyword or parameter) in the square brackets can be omitted. If the parameter

is omitted, the instrument will set the parameter to its default. For example, for

the :COUNter:STATIstics[:STATe]? command, send any of the following two commands can achieve

the same effect.

:COUNter:STATIstics?

:COUNter:STATIstics:STATe?

4. Triangle Brackets <>

The parameter enclosed in the triangle brackets must be replaced by an effective value. For example,

sending the :COUNter:LEVEl command in :COUNter:LEVEl 1 form.

Parameter Type

The parameters of the commands introduced in this manual contain the following 5 types: bool, integer,

real number, discrete and ASCII string.

1 Bool

The parameter could be ON (1) or OFF (0). For example, :COUNter:HF {ON|1|OFF|0}.

2 Integer

Unless otherwise noted, the parameter can be any integer within the effective value range. Note that

do not set the parameter to a decimal; otherwise, errors will occur. For example, in

the :DISPlay:BRIGhtness command, can be any integer from 0 to 100.

3 Real Number

Unless otherwise noted, the parameter can be any real number within the effective value range.

For example, the range of in the :COUNter:LEVEl command is from -2.5V to 2.5V.

4 Discrete

The parameter could only be one of the specified values or characters. For example, in

the :DISPlay:MODE {DPV|DGV|SV} command, the parameter can only be DPV, DGV or SV.

5 ASCII String

The parameter should be the combinations of ASCII characters. For example, in

the :MMEMory:LOAD:STATe command, is the filename of the state file to be

loaded under the current directory of the external memory and can include English characters and

numbers.

Besides, you can replace the parameters in many commands with MINimum or MAXimum to set the

parameters to their minimum or maximum value. For example, MINimum and MAXimum in

the :DISPlay:BRIGhtness {|MINimum|MAXimum} command are used to set the brightness to

the minimum or maximum.