5.18. SYSTem

SCPI command

Description

SYSTem

:BEEPer[:IMMediate]

Issues a single beep immediately

:KEY

:STATe {<bool>}

Enables click tone for local control

:STATe {<bool>}

Enables beeper function

:CAPability?

Returns an <instrument_specifier>

:CHANnel

:COLor {<channel>}, {<color>}

Sets channel color

[:COUNt]?

Returns the number of output channels

:INFOrmation

:CURRent?

Returns output current capability

:ONTime

LAST?

Returns time passed after last output enable

TOTal?

Returns channel’s total active time

:POWer?

Returns output power capability

:VOLTage?

Returns output voltage capability

:LABel {<channel>}, {<label>}

Sets channel label name

:MODel?

Returns the channel model and version name

:OPTion? [{<channel>}]

Returns names of all channel resources

:PIN

:LABel {<channel>}, {<pin>}, {<label>}

Sets module pin label name

:SLOT?

Returns the channel slot number

:VERSion?

Returns the channel version number

:COMMunicate

:ENABle {<bool>}, {<interface>}

Enables the remote interface

:ETHernet

:ADDRess {<ip_address>}

Sets the static LAN (IP) address

:CONTrol?

Returns the control connection port

:DHCP {<bool>}

Enables the use of the Dynamic Host Configuration Protocol (DHCP)

:DNS <ip_address>

Sets the IP address of the DNS server.

:GATEway {<ip_address>}

Sets the IP address of the default gateway

:HOSTname {<name>}

Sets the Ethernet communication host name

:MAC?

Returns the MAC address

:PORT {<number>}

Sets the port number

:SMASk {<mask>}

Sets the static subnet mask

:NTP {<server>}

Sets NTP service server address

:FREQuency

Sets the frequency of connection to the NTP service

:MQTT

:SETTings {<address>, <port>, <user>, <password>, <period>}

Sets MQTT connection parameters

:STATe?

Returns MQTT connection status

:UART

:BAUD {<baud>}

Sets UART speed in bits per second

:DATA {<data>}

Sets UART data size in bits

:MODE {<mode>}

Sets UART operation mode

:PARIty {<parity>}

Sets UART partity check

:RECeive?

Receive string via UART

:STOP {<stop>}

Sets UART number of stop bits

:TRANsmit {<string>}

Sends string via UART

:USB

:CLAss {<usb_class>}

Sets USB class

:MODE {<usb_mode>}

Sets USB mode

:RLSTate {<state>}

Places the instrument in remote or local mode

:CPU

:FIRMware?

Returns BB3 firmware version

:INFOrmation

:ONtime

LAST?

Returns time passed after last power on

TOTal?

Returns the BB3 total active time

:MODel?

Returns the control board model name

:SNO?

Returns the BB3 serial number

:VERSion?

Returns the BB3 version number

:DATE {<year>}, {<month>}, {<day>}

Sets the date of the system clock

DELay {<time>}

Sets a pause in SCPI execution

:DIGital

:INPut:DATA? {<pin>}

Reads the state of the digital port pins

:OUTPut

:DATA {<pin>}, {<state>}

Sets the state of the digital port pins

:PWM

:DUTY {<pin>}, {<duty>}

Sets square wave generator duty cycle

:FREQuency {<pin>}, {<frequency>}

Sets square wave generator frequency

:PIN<n>

:FUNCtion {<function>}

Sets the selected pin’s function

:POLarity {<polarity>}

Sets the selected pin’s polarity

:ERRor

[:NEXT]?

Queries and clears errors from the error queue

:COUNt?

Queries the error/event queue for the number of unread items

:FAN

:SPEed

Returns speed of the cooling fan

:STATus

Returns status of the cooling fan

:FORMat

:DATE

Sets format for displaying date

:TIME

Sets 12h or 24h clock format

:INHibit?

Queries system inhibit state

:KEY

:KLOCk

Disables front panel [lock/unlock] icon

:LFRequency {<frequency>}

Sets the AC mains frequency

:LOCal

Places the BB3 in the local mode

:MEASure

[:SCALar]

:TEMPerature

[:DC]? {<sensor>}

Takes a measurement; returns the average temperature

[:VOLTage]

[:DC]? {<device>}

Takes a voltage measurement of the RTC battery

:PASSword

:CALibration

:RESet

Resets the calibration password to initial value

:FPANel

:RESet

Resets the front panel lock password to initial value

:NEW {<old>}, {<new>}

Changes system password

:PON:OUTPut:DISable {<bool>}

Sets output state on power up

:POWer {<bool>}

Enters the BB3 into the standby mode

:PROTection:TRIP {<bool>}

Enters the BB3 into the standby mode in case of protection trip

:RELay:CYCLes? {<chanlist>}

Returns the cycle count on the specified channels

:REMote

Places the BB3 in the remote mode

:REStart

Initiate low-level (hardware) reset

:RWLock

Places the BB3 in the remote mode and disables front panel [lock/unlock] icon

:SLOT

[:COUNt]?

Returns the number of available slots

:COLor {<slot>}, {<color>}

Sets module color

:FIRMware?

Returns module firmware version

:LABel {<slot>}, {<label>}

Sets module label name

:MODel? {<slot>}

Returns the module model name

:SNO {<slot>}

Sets and returns the module serial number

:STATe {<slot>}, {<bool>}

Enables/disables module on selected slot

:VERSion? {<slot>}

Returns module version number

:TEMPerature

:PROTection

[:HIGH]

[:LEVel] {<temperature>} [, <sensor>]

Sets the OTP value

:CLEar {<sensor>}

Clears the latched protection status of the over-temperature protection (OTP)

:DELay

[:TIME] {<delay>} [, <sensor>]

Sets the OTP programming delay

:STATe {<bool>} [, <sensor>]

Enables/disables OTP on the selected temperature sensor

:TRIPped? [<sensor>]

Returns status of OTP activation

:TIME {<hours>}, {<minutes>}, {<seconds>}

Sets the time of the system clock

:DTS {rules}

Defines daylight saving time (DST) rules

:ZONE {zone}

Defines time zone

:VERSion?

Returns the SCPI version number

Syntax

SYSTem:BEEPer[:IMMediate]

Description

This command issues a single beep immediately.

Usage example

SYST:BEEP

Syntax

SYSTem:BEEPer:KEY:STATe {<bool>}

SYSTem:BEEPer:KEY:STATe?

Description

Use this command to enable or disable generation of audible “click” sound when front panel option is selected.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Usage example

SYST:BEEP:KEY:STAT ON

Related Commands

SYSTem:BEEPer[:IMMediate]

SYSTem:BEEPer:STATe

Syntax

SYSTem:BEEPer:STATe {<bool>}

SYSTem:BEEPer:STATe?

Description

When the beeper is enabled, the BB3 generates audible sound in any of the following situations:

• the power is turns on or off (see SYSTem:POWer),
• when error occurs during front panel operation or remote operation (see Section 7 for the list of error messages),
• self-test is failed and
• any of the protection function is “tripped”

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

ON

Usage example

SYST:BEEP:STAT ON

SYST:BEEP:STAT?

1

Related Commands

SYSTem:BEEPer[:IMMediate]

SYSTem:POWer

Syntax

SYSTem:CAPability?

Description

This query returns the BB3’s capabilities and outputs the appropriate specifiers.

See also SCPI Volume 4: Section 7.1, 1.4.1, 7.2.1, 7.2.2, and 7.2.3

Usage example

SYST:CAP?

DCPSUPPLY WITH (MEASURE|MULTIPLE|TRIGGER)

Syntax

SYSTem:CHANnel:COLor {<channel>}, {<color>}

SYSTem:CHANnel:COLor? [<channel>]

Modules

 DCP  DCM 

Description

Use this command to set channel header and frame color as defined with <color> value between 0 and 24. Use 0 to reset channel color to the default value. Default color number coresponds to the channel number. Available colors and its RGB values is listed below.

This command is only applicable to modules that have discrete channel numbers (CH1, CH2 …). If used on other modules, e.g. SMX or PREL, it may generate -241,"Hardware missing" execution error.

1
#d4c36b

2
#9fdd9a

3
#73bdd8

4
#d971ca

5
#dbafea

6
#adaaf9

7
#f44336

8
#e91e63

9
#9c27b0

10
#673ab7

11
#3f51b5

12
#2196f3

13
#03a9f4

14
#00bcd4

15
#009688

16
#4caf50

17
#8bc34a

18
#cddc39

19
#ffeb3b

20
#ffc107

21
#ff9800

22
#ff5722

23
#795548

24
#607d8b

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

<color>

NR1

0 – 24

0

Return

Query the color number of the specified channel.

Errors

-222,"Data out of range"

-241,"Hardware missing"

Usage example

SYST:CHAN:COL CH1,2

Related Commands

SYSTem:SLOT:COLor

Syntax

SYSTem:CHANnel[:COUNt]?

Description

This query returns the number of output channels in a mainframe.

Usage example

SYST:CHAN?

2

Related Commands

INSTrument[:SELect]

INSTrument:NSELect

Syntax

SYSTem:CHANnel:INFOrmation:CURRent? [<channel>]

Description

Use this query to get currently selected channel output current capability.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:INFO:CURR? CH2

5.00

Syntax

SYSTem:CHANnel:INFOrmation:ONTime:LAST? [<channel>]

Description

This query returns time passed after last activation of the currently selected channel. Resolution is 1 minute and this information is stored every 10 minutes in non-volatile memory. Therefore it’s possible that up to 10 minutes is lost after restart caused with power outage or system reset.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:INFO:ONT:LAST?

15m

Syntax

SYSTem:CHANnel:INFOrmation:ONTime:TOTal? [<channel>]

Description

This query returns total active time of the currently selected channel. Resolution is 1 minute and this information is stored every 10 minutes in non-volatile memory. Therefore it’s possible that up to 10 minutes is lost after restart caused with power outage or system reset.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:INFO:ONT:TOT?

1h 45m

Syntax

SYSTem:CHANnel:INFOrmation:POWer? [<channel>]

Description

Use this query to get currently selected channel output power capability.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:INFO:POW?

160.00

Syntax

SYSTem:CHANnel:INFOrmation:VOLTage? [<channel>]

Description

Use this query to get currently selected channel output voltage capability.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:INFO:VOLT?

40.00

Syntax

SYSTem:CHANnel:LABel {<channel>}, {<label>}

SYSTem:CHANnel:LABel? {<channel>}

Description

Use this command to define the label of selected <channel>.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

<label>

Quoted string

1 – 10 characters

–

Return

Returns the label of the channel queried as a quoted string.

Errors

-241,"Hardware missing"

Usage example

SYST:CHAN:LAB CH1,"Heater"

Related Commands

SYSTem:CHANnel:PIN:LABel

SYSTem:SLOT:LABel

Syntax

SYSTem:CHANnel:MODel? [<channel>]

Description

This query returns the model name and version of the specified channel.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:MOD?

"DCP405"

Related Commands

SYSTem:CHANnel:VERSion?

SYSTem:CPU:MODel?

Syntax

SYSTem:CHANnel:OPTion? [<channel>]

Description

This query returns names of all selected channel resources that can be controlled by firmware. Depending of the board model (see the SYSTem:CHANnel:MODel? query) various combination of the following features can be returned:

• Volt – program the output voltage while channel is in the CV mode of operation (see [SOURce[<n>]]:VOLTage and APPLy commands)
• Current – program the output current while channel is in the CC mode of operation (see [SOURce[<n>]]:CURRent and APPLy commands)
• Power – set max. allowed output power regardless of the channel mode of operation (see [SOURce[<n>]]:POWer:LIMit)
• OE – set channel power output (see OUTPut[:STATe])
• Dprog – control down-programmer circuit (see OUTPut:DPRog)
• Rprog – control output voltage programming source (see [SOURce[<n>]]:VOLTage:PROGram[:SOURce])
• Coupled – power outputs supports advanced coupling, i.e. in series and parallel (see

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

Reported resources for channel 1 on the DCP405 module:

SYST:CHAN:OPT? CH1

"Volt", "Current", "Power", "OE", "DProg", "Rprog", "Coupled"

Reported resources for channel 3 on the DCM220 module:

SYST:CHAN:OPT? CH1

"Volt", "Current", "Power", "OE"

Related Commands

APPLy

OUTPut:DPRog

OUTPut:MODE?

OUTPut[:STATe]

OUTPut:TRACk[:STATe] {<chanlist>}

[SOURce[<n>]]:CURRent

[SOURce[<n>]]:POWer:LIMit

[SOURce[<n>]]:VOLTage

[SOURce[<n>]]:VOLTage:PROGram[:SOURce])

SYSTem:CHANnel:MODel?

Syntax

SYSTem:CHANnel:PIN:LABel {<channel>}, {<pin>}, {<label>}

SYSTem:CHANnel:PIN:LABel? {<channel>}, {<pin>}

Modules

 MIO 

Description

Use this command to define the pin label specified by <label> on selected <channel>.

Parameters

Name

Type

Range

Default

<channel>

Channel

(@n01 or @n02) where n is the slot number

–

<pin>

NR1

1 – 8

–

<label>

Quoted string

1 – 5 characters

–

Return

Returns the label of the pin queried as a quoted string.

Errors

-241,"Hardware missing"

Usage example

SYST:CHAN:PIN:LAB 1,"In_1"

Related Commands

SYSTem:CHANnel:LABel

SYSTem:SLOT:LABel

Syntax

SYSTem:CHANnel:SLOT? [<channel>]

Description

This query returns the DIB backplane slot number of the specified channel.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:SLOT? CH4

3

Related Commands

SYSTem:CHANnel:SNO?

SYSTem:CHANnel:VERSion?

Syntax

SYSTem:CHANnel:VERSion? [<channel>]

Description

This query returns the version number of the specified channel.

Parameters

Name

Type

Range

Default

<channel>

Channel

CH1|CH2|CH3|CH4|CH5|CH6

–

Usage example

SYST:CHAN:VERS? CH4

"R2B6"

Related Commands

SYSTem:CHANnel:SLOT?

SYSTem:CHANnel:VERSion?

Syntax

SYSTem:COMMunicate:ENABle {<bool>}, {<interface>}

SYSTem:COMMunicate:ENABle? {<interface>}

Description

Enables or disables USB, Ethernet, MQTT, NTP service, or the remote service Sockets. The setting is effective after rebooting the BB3. This command setting is not changed by power off or the *RST command.

Enabling the Ethernet interface (SYSTem:COMMunicate:ENABle 1, ETH) will have no effect until a restart is performed using the SYSTem:REStart command.

Remote service Sockets is not supported yet

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

–

<interface>

Discrete

USB|ETHernet|MQTT|NTP|SOCKets

–

Return

This query returns the status of the selected interface that could be 0 (OFF) or 1 (ON).

Usage example

SYST:COMM:ENAB 0, SER

Related Commands

SYSTem:REStart

Syntax

SYSTem:COMMunicate:ETHernet:ADDRess {<ip_address>}

SYSTem:COMMunicate:ETHernet:ADDRess?

Description

Set the IP address of the BB3 manually if the DHCP mode is not enabled. If the DHCP mode is enabled setting the IP address using this command will be ignored.

Parameters

Name

Type

Range

Default

<ip_address>

Quoted string

15 characters max. formatted as four groups of up to 3 digits (range 0–255), separated by “.”

–

Return

The query returns the current IP address sets manually or assigned by the DHCP server.

Usage example

SYST:COMM:ETH:ADDR?

"192.168.10.100"

Related Commands

SYSTem:COMMunicate:ETHernet:DHCP

Syntax

SYSTem:COMMunicate:ETHernet:DHCP {<bool>}

SYSTem:COMMunicate:ETHernet:DHCP?

Description

Enable or disable the DHCP mode. In DHCP mode, the DHCP server in the current network assigns network parameters (IP ADdress, DNS address, GATEway address and the Subnet MASk) for the BB3.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

ON

Return

Query the status of the DHCP mode.

Usage example

SYST:COMM:ETH:DHCP?

1

Syntax

SYSTem:COMMunicate:ETHernet:DNS {<ip_address>}

SYSTem:COMMunicate:ETHernet:DNS?

Description

Set the DNS (Domain Name Service) address if the DHCP mode is not enabled. If the DHCP mode is enabled setting the DNS address using this command will be ignored.

Parameters

Name

Type

Range

Default

<ip_address>

Quoted string

15 characters max. formatted as four groups of up to 3 digits (range 0–255), separated by “.”

–

Return

The query returns the DNS address sets manually or assigned by the DHCP server.

If DHCP is used query will return “unknown”.

Usage example

SYST:COMM:ETH:DNS "192.168.1.200"

Related Commands

SYSTem:COMMunicate:ETHernet:DHCP

Syntax

SYSTem:COMMunicate:ETHernet:GATEway {<ip_address>}

SYSTem:COMMunicate:ETHernet:GATEway?

Description

Set the network gateway address if the DHCP mode is not enabled. If the DHCP mode is enabled setting the network gateway address using this command will be ignored.

Parameters

Name

Type

Range

Default

<ip_address>

Quoted string

15 characters max. formatted as four groups of up to 3 digits (range 0–255), separated by “.”

–

Return

The query returns the network gateway address sets manually or assigned by the DHCP server. If DHCP is used query will return “unknown”.

Usage example

SYST:COMM:ETH:GATE?

"192.168.10.1"

Related Commands

SYSTem:COMMunicate:ETHernet:DHCP

Syntax

SYSTem:COMMunicate:ETHernet:HOSTname {<hostname>}

SYSTem:COMMunicate:ETHernet:HOSTname?

Description

This command sets the BB3 local area network (LAN) connection hostname.

Parameters

Name

Type

Range

Default

<hostname>

Quoted string

1 – 63 characters

EEZ-BB3

Return

The query returns the BB3 local area network (LAN) connection hostname as a quoted string.

Usage example

SYST:COMM:ETH:HOST?

"bb3-test"

Related Commands

SYSTem:COMMunicate:ETHernet:ADDRess

SYSTem:COMMunicate:ETHernet:DHCP

Syntax

SYSTem:COMMunicate:ETHernet:MAC {<mac_address>}

SYSTem:COMMunicate:ETHernet:MAC?

Description

Use this command to set Ethernet communication port MAC address. You can set any combination of six hexadecimal values separated by “-”. The Ethernet connection will work as long as two different machine in the LAN don’t have the same MAC address.

Parameters

Name

Type

Range

Default

<mac_address>

Quoted string

17 characters formatted as six groups of 2 digits separated by “-”

74-69-69-2D-30-00

Return

The query returns the MAC address as a quoted string (six hexadecimal values separated by “-”).

Usage example

SYST:COMM:ETH:MAC?

"70-60-50-40-30-20"

Syntax

SYSTem:COMMunicate:ETHernet:PORT {<number>}

SYSTem:COMMunicate:ETHernet:PORT?

Description

Use this command to change default (5025) Ethernet communication port for SCPI.

Parameters

Name

Type

Range

Default

<number>

NR1

1-65535

5025

Return

The query returns the Ethernet communication port number.

Usage example

SYST:COMM:ETH:PORT?

5025

Related Commands

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:ETHernet:CONTrol?

Syntax

SYSTem:COMMunicate:ETHernet:SMASk {<mask>}

SYSTem:COMMunicate:ETHernet:SMASk?

Description

Set the subnet mask if the DHCP mode is not enabled. If the DHCP mode is enabled setting the network gateway address using this command will be ignored.

Parameters

Name

Type

Range

Default

<mask>

Quoted string

15 characters max. formatted as four groups of up to 3 digits (range 0–255), separated by “.”

–

Return

The query returns the subnet mask sets manually or assigned by the DHCP server. If DHCP is used query will return “unknown”.

Usage example

SYST:COMM:ETH:SMAS "255.255.255.0"

Related Commands

SYSTem:COMMunicate:ETHernet:DHCP

Syntax

SYSTem:COMMunicate:MQTT:SETTings {<address>}, {<port>}, {<user>}, {<password>}, {<period>}

Description

MQTT (MQ Telemetry Transport) is an open OASIS and ISO standard (ISO/IEC PRF 20922) lightweight, publish-subscribe network protocol that transports messages between devices (i.e. clients).

The EEZ BB3 becomes a MQTT client (or node) by establishing connection with this command to the MQTT broker. A broker is a server that receives all messages from the clients and then routes the messages to the appropriate destination clients. It acts as a post office, MQTT doesn’t use the address of the intended recipient but uses the subject line called “Topic”, and anyone who wants a copy of that message will subscribe to that topic. EEZ The BB3 can produce and receive data by both publishing and subscribing.

MQTT connection is initiated by sending a sequence of five comma separated connection parameters.

Parameters

Name

Type

Range

Default

<address>

Quoted string

Max. 64 characters

–

<port>

NR1

1 – 99999

–

<user>

Quoted string

Max. 32 characters

–

<password>

Quoted string

Max. 32 characters

–

<period>

NR2

0.1 – 120

1

Usage example

SYST:COMM:MQTT:CONN "farmer.cloudmqtt.com", 1883, "user", "password", 10

Errors

-104,"Data type error"

Related Commands

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:MQTT:STATe

Syntax

SYSTem:COMMunicate:MQTT:STATe?

Description

This query returns the current status of the MQTT connection.

Return

Returns -1 if an error occurred, 0 if connection is not established, 1 if connection is established. Return codes greater then 1 indicates various transient states.

Usage example

SYST:COMM:MQTT:STAT?

1

Related Commands

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:MQTT:SETTings

Syntax

SYSTem:COMMunicate:NTP {<server>}

SYSTem:COMMunicate:NTP?

Description

Use this command to set the NTP service server network address. The BB3 will try to establish connection with selected NTP service on each power up (hard reset), when *RST is issued or periodically as defined with the SYSTem:COMMunicate:NTP:FREQuency commad.

Parameters

Name

Type

Range

Default

<server>

Quoted string

IP address or NTP server host name up to 32 characters

europe.pool.ntp.org

Return

The query command returns the NTP service server network address.

Usage example

SYST:COMM:ENAB NTP

SYST:COMM:NTP "ntp.ubuntu.com"

Related Commands

*RST

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:FREQuency

SYSTem:DATE

SYSTem:TIME

Syntax

SYSTem:COMMunicate:NTP:FREQuency {<frequency>}

SYSTem:COMMunicate:NTP:FREQuency?

Description

Use this command to set the time in minutes between two connection attempts to the defined NTP service.

Parameters

Name

Type

Range

Default

<frequency>

NR1

15 – 14400

720

Return

The query command returns the period in minutes between two connection attempts to the NTP service.

Usage example

SYST:COMM:NTP:FREQ 60

Related Commands

*RST

SYSTem:COMMunicate:NTP

SYSTem:DATE

SYSTem:TIME

Syntax

SYSTem:COMMunicate:UART:BAUD {<baud>}

SYSTem:COMMunicate:UART:BAUD?

Description

This command sets one of predefined communication speed in bits per second (baud) if UART is configured on DIN1/DIN2.

Parameters

Name

Type

Range

Default

<baud>

Discrete

9600|14400|19200|38400|57600|115200

–

Return

The query command returns the set UART communication speed.

Usage example

SYST:COMM:UART:BAUD 19200

Errors

-222,"Data out of range"

Related Commands

SYSTem:COMMunicate:UART:MODE

SYSTem:COMMunicate:UART:RECeive

SYSTem:COMMunicate:UART:TRANsmit

Syntax

SYSTem:COMMunicate:UART:DATA {<data>}

SYSTem:COMMunicate:UART:DATA?

Description

Use this command to set the data size in bits of UART communication.

Parameters

Name

Type

Range

Default

<data>

NR1

6 – 8

–

Return

The query command returns the set UART communication data size in bits.

Usage example

SYST:COMM:UART:DATA 8

Errors

-222,"Data out of range"

Related Commands

SYSTem:COMMunicate:UART:MODE

SYSTem:COMMunicate:UART:RECeive

SYSTem:COMMunicate:UART:TRANsmit

Syntax

SYSTem:COMMunicate:UART:MODE {<uart_mode>}

SYSTem:COMMunicate:UART:MODE?

Description

Use this command to set UART mode of operation define with <uart_mode> as follows:

• BOOKmark – adds the received string as a new bookmark to the active DLOG session. See also the SENSe:DLOG:TRACe:BOOKmark command.
• BUFFer – data received via the UART is not interpreted as SCPI but stored in input buffer which can be retrieved by using the SYSTem:COMMunicate:UART:RECeive? query.
• SCPI – received data via UART will be passed to the SCPI parser and interpreted. Use this if you want that e.g. the external device you are testing controls BB3.

Use the SYSTem:DIGital:PIN<n>:FUNCtion command to activate UART. Changing DIN1 function to UART will automatically set DOUT1 to UART and vice versa.

Parameters

Name

Type

Range

Default

<uart_mode>

Discrete

BOOKmark|BUFFer|SCPI

–

Return

Returns the UART mode as a quoted string.

Usage example

SYST:COMM:UART:MODE SCPI

Related Commands

*RST

SENSe:DLOG:TRACe:BOOKmark

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:UART:RECeive

SYSTem:COMMunicate:UART:TRANsmit

SYSTem:DIGital:PIN<n>:FUNCtion

Syntax

SYSTem:COMMunicate:UART:PARIty {<parity>}

SYSTem:COMMunicate:UART:PARIty?

Description

Use this command to set the parity check of UART communication.

Parameters

Name

Type

Range

Default

<parity>

Discrete

NONe|EVEN|ODD

–

Return

The query command returns the set UART communication parity check.

Usage example

SYST:COMM:UART:PARI NON

Errors

-224,"Illegal parameter value"

Related Commands

SYSTem:COMMunicate:UART:MODE

SYSTem:COMMunicate:UART:RECeive

SYSTem:COMMunicate:UART:TRANsmit

Syntax

SYSTem:COMMunicate:UART:RECeive?

Description

Returns quoted string with the contents of the input buffer when UART {mode} is set to BUFFer. Use this query multiple times until input buffer is emptied (in which case it returns an empty string ‘""’) to get the whole contents of the buffer.

Usage example

SYST:COMM:UART:REC?

Test string

Related Commands

*RST

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:UART:MODE

Syntax

SYSTem:COMMunicate:UART:STOP {<stop>}

SYSTem:COMMunicate:UART:STOP?

Description

Use this command to set the number of stop bits for UART communication.

Parameters

Name

Type

Range

Default

<stop>

NR1

1 – 2

–

Return

The query command returns the set numbe of stop bits for UART communication.

Usage example

SYST:COMM:UART:BAUD 19200

Errors

-222,"Data out of range"

Related Commands

SYSTem:COMMunicate:UART:MODE

SYSTem:COMMunicate:UART:RECeive

SYSTem:COMMunicate:UART:TRANsmit

Syntax

SYSTem:COMMunicate:UART:TRANsmit {<string>}

Description

Use this command to transmit {string} over UART. The new line character (\n) is always appended.

Parameters

Name

Type

Range

Default

<string>

Quoted string

1 to 4096 characters

–

Usage example

SYST:COMM:UART:TRAN "Hello World!"

Related Commands

*RST

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:UART:MODE

Syntax

SYSTem:COMMunicate:USB:CLAss {<usb_class>}

SYSTem:COMMunicate:USB:CLAss?

Description

Use this command to set the USB interface class.

Parameters

Name

Type

Range

Default

<usb_class>

Discrete

VCOM|MSTOrage|HID

–

Return

The query command returns the USB interface class.

Usage example

SYST:COMM:USB:MODE "DEV"

SYST:COMM:USB:CLA "VCOM"

Related Commands

*RST

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:USB:MODE

Syntax

SYSTem:COMMunicate:USB:MODE {<usb_mode>}

SYSTem:COMMunicate:USB:MODE?

Description

Use this command to set the USB interface mode that could be one of the following:

• DEVice – the BB3 acts as an USB device when communicate with connected computer.
• HOST – in this mode the BB3 provides VBUS power for connected USB device (e.g. mouse, keypad, foot pedal, etc.). The USB class will be automatically set to HID.
• OTG – “on-the-go” mode allows detection of USB ID pin (set by USB cable or adapter) and adopt its USB mode and class in accordance with detected device.

Parameters

Name

Type

Range

Default

<usb_mode>

Discrete

DEVice|HOST|OTG

–

Return

The query command returns the USB interface mode.

Usage example

SYST:COMM:USB:MODE "HOST"

Related Commands

*RST

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:USB:CLAss

Syntax

SYSTem:COMMunicate:RLSTate {<state>}

SYSTem:COMMunicate:RLSTate?

Description

This command configures the remote/local state of the BB3 according to the following settings:

• LOCal – The BB3 is set to front panel and remote interface control.
• REMote – The BB3 is set to front panel and remote interface control.
• RWLock – The front panel keys are disabled. The BB3 can only be controlled via the remote interface. This programmable setting is completely independent from the front panel lock/unlock function that is available from the front panel menu. If you use this command to lock the front panel, the front panel will be unlocked when AC power is cycled.

The LOCal parameter is the same as SYSTem:LOCal, the REMote parameter is the same as SYSTem:REMote, and the RWLock parameter is the same as SYSTem:RWLock.

The remote/local state is unaffected by *RST or any SCPI commands other than SYSTem:COMMunicate:RLState.

Parameters

Name

Type

Range

Default

<state>

Discrete

LOCal|REMote|RWLock

LOCal

Return

The query command returns control state of the BB3 that could be LOC, REM, or RWL.

Usage example

SYST:COMM:RLST?

"LOC"

Related Commands

*RST

SYSTem:LOCal

SYSTem:REMote

SYSTem:RWLock

Syntax

SYSTem:CPU:FIRMware?

Description

This query returns BB3 (master) firmware version.

Usage example

SYST:CPU:FIRM?

"1.0"

Syntax

SYSTem:CPU:INFOrmation:ONTime:LAST?

Description

This query returns time passed after last activation of the BB3. Resolution is 1 minute and this information is stored every 10 minutes in non-volatile memory. Therefore it’s possible that up to 10 minutes is lost after restart caused with power outage or system reset.

Usage example

SYST:CPU:INFO:ONT:LAST?

15m

Syntax

SYSTem:CPU:INFOrmation:ONTime:TOTal?

Description

This query returns total active time of the BB3. Resolution is 1 minute and this information is stored every 10 minutes in non-volatile memory. Therefore it’s possible that up to 10 minutes is lost after restart caused with power outage or system reset.

Usage example

SYST:CPU:INFO:ONT:TOT?

"1h 45m"

Syntax

SYSTem:CPU:MODel?

Description

This query returns the model name and version of the MCU board. If simulator is used it returns “Simulator”.

Usage example

SYST:CPU:MOD?

"STM32F7, M1 0.3"

Related Commands

SYSTem:CPU:INFOrmation:ONTime:LAST?

SYSTem:CPU:INFOrmation:ONTime:TOTal?

Syntax

SYSTem:CPU:SNO?

Description

This query returns the BB3 serial number.

Usage example

SYST:CPU:SNO?

"992A003D3338510738323535"

Related Commands

*IDN?

Syntax

SYSTem:CPU:VERSion?

Description

This query returns the BB3 version number.

Usage example

SYST:CPU:VERS?

"R2B4"

Related Commands

*IDN?

Syntax

SYSTem:DATE {<year>}, {<month>}, {<day>}

SYSTem:DATE?

Description

Sets the date of the system clock (RTC). Specify the year, month, and day.

The self-test procedure compare date and time stored in RTC registers with values stored in the non-volatile memory (EEPROM). When the later is greater then former or any of them lost integrity (i.e. any of value is outside allowed range: for example seconds are higher then 60 or months are higher then 12, etc.) self-test will failed. The *TST? will return 1 and detailed report could be queried using the DIAGnostic:TEST? command.

The bit 3 (TIME) of the Questionable Status register will be set (see Section 3.4) if datetime self-test failed or datetime was never set.

Parameters

Name

Type

Range

Default

<year>

NR1

2000 – 2099

–

<month>

NR1

1 – 12

–

<day>

NR1

1 – 31

–

Return

Query the current date of the system clock in YYYY, MM, DD format.

Usage example

SYST:DATE?

2015, 10, 24

Related Commands

*TST?

DIAGnostic[:INFOrmation]:TEST?

SYSTem:FORMat:TIME

SYSTem:TIME

Syntax

SYSTem:DELay {<time>}

Description

This command inserts pause in parsing and executing SCPI commands. Execution of the next SCPI command will start only when the set delay expires. The programmed value can be up to 10 seconds (set in milliseconds).

Parameters

Name

Type

Range

Default

<time>

NR1

1 – 10000

–

Usage example

SYST:DEL 1500

Syntax

SYSTem:DIGital:INPut:DATA? {<pin>}

Description

This query reads the state of the digital control port.

Applies only to pin 1.

Parameters

Name

Type

Range

Default

<pin>

NR1

1

1

Return

The query returns the value of the state of input pin.

Usage example

SYST:DIG:INP:DATA? 1

1

Related Commands

SYSTem:DIGital:PIN<n>:FUNCtion

SYSTem:DIGital:PIN<n>:POLarity

Syntax

SYSTem:DIGital:OUTPut:DATA {<pin>}, {<state>}

SYSTem:DIGital:OUTPut:DATA? {<pin>}

Description

This command sets the output data on the digital output pin. Applies only to pin 3 and 4.

Parameters

Name

Type

Range

Default

<pin>

NR1

3 – 4

–

<state>

Discrete

ON|OFF|0|1

–

Return

The query returns the last programmed value on the selected pin.

Usage example

SYST:DIG:OUTP:DATA 3, 0

Errors

-114,"Header suffix out of range"

Related Commands

SYSTem:DIGital:PIN<n>:FUNCtion

SYSTem:DIGital:PIN<n>:POLarity

Syntax

SYSTem:DIGital:OUTPut:PWM:DUTY {<pin>}, {<duty>}

SYSTem:DIGital:OUTPut:PWM:DUTY? {<pin>}

Description

Use this command to set duty cycle of the output pin defined as PWM (see the SYSTem:DIGital:PIN<n>:FUNCtion command). Applies only to pin 4.

Parameters

Name

Type

Range

Default

<pin>

NR1

4

–

<duty>

NR3

0 – 100

50

Return

The query returns the square ware generator duty cycle for the specified output pin.

Usage example

SYST:DIG:OUTP:PWM:DUTY 4, 10

Errors

-224,"Illegal parameter value"

-230,"Digital pin function mismatch"

Related Commands

SYSTem:DIGital:OUTPut:PWM:FREQuency

SYSTem:DIGital:PIN<n>:FUNCtion

Syntax

SYSTem:DIGital:OUTPut:PWM:FREQuency {<pin>}, {<frequency>}

SYSTem:DIGital:OUTPut:PWM:FREQuency? {<pin>}

Description

Use this command to set frequency of the output pin defined as PWM (see the SYSTem:DIGital:PIN<n>:FUNCtion command). Applies only to pin 4.

Parameters

Name

Type

Range

Default

<pin>

NR1

4

–

<frequency>

NR3

0.03 – 5000000

0

Return

The query returns the square ware generator frequency for the specified output pin.

Usage example

SYST:DIG:OUTP:PWM:FREQ 4, 1000

Errors

-224,"Illegal parameter value"

-230,"Digital pin function mismatch"

Related Commands

SYSTem:DIGital:OUTPut:PWM:DUTY

SYSTem:DIGital:PIN<n>:FUNCtion

Syntax

SYSTem:DIGital:PIN<n>:FUNCtion {<function>}

SYSTem:DIGital:PIN<n>:FUNCtion?

Description

Use this command to set function of the selected digital port pin. The pin function is saved in non-volatile memory.

All input functions applies only to pin 1 and 2 and all output functions applies only to pin 3 and pin 4.

• DINPut – The pin is in digital input mode.
• DLOGtrig – The pin is configured as a DLOG trigger input.
• DOUTput – The pin is in digital output mode.
• FAULt – Setting FAULt means that pin functions as an isolated fault output. The fault signal is true when any output is in a protected state (from OCP, OVP, OTP, OPP) or Fan fault is detected.
• INHibit – When pin is configured as an inhibit input, a true signal at the pin will disable all output channels.
• ONCouple – output pin synchronize channel output state.
• PWM – (pin 4 only) square wave generator output.
• SYSTrig – The pin is configured as a system trigger input. When configured as a trigger input, the pin can be selected as the source for trigger signals. See TRIGger[:SEQuence]:SOURce.
• TOUTput – This allows a BUS trigger to be sent to any digital port pin that has been configured as a trigger output. A trigger out pulse is generated when the state is on and a bus trigger is received. A BUS trigger is generated using the *TRG command.
• UART – defines pin 1 as UART receiver, and pin 3 as UART transmitter.

Parameters

Name

Type

Range

Default

<function>

Discrete

DINP|DLOG|DOUT|FAUL|INH|ONC|PWM|SYST|TOUT|UART

–

Return

The query command returns the set pin function.

Usage example

SYST:DIG:PIN1:FUNC INH

SYST:DIG:PIN2:FUNC TINP

SYST:DIG:PIN3:FUNC FAUL

SYST:DIG:PIN4:FUNC ONC

Errors

-114,"Header suffix out of range"

Related Commands

TRIGger[:SEQuence]:SOURce

SYSTem:COMMunicate:UART:MODE

SYSTem:DIGital:INPut:DATA

SYSTem:DIGital:OUTPut:DATA

SYSTem:DIGital:OUTPut:PWM:DUTY

SYSTem:DIGital:OUTPut:PWM:FREQuency

Syntax

SYSTem:DIGital:PIN<n>:POLarity {<polarity>}

SYSTem:DIGital:PIN<n>:POLarity?

Description

This command sets the polarity of the selected digital port pin. The pin polarity is saved in non-volatile memory.

• POSitive – a logical true signal is a voltage high at the pin. For trigger inputs and outputs, POSitive means a rising edge.
• NEGative – a logical true signal is a voltage low at the pin. For trigger inputs and outputs, NEGative means a falling edge.

Parameters

Name

Type

Range

Default

<polarity>

Discrete

POSitive|NEGative

–

Return

The query command returns POS or NEG.

Usage example

SYST:DIG:PIN1:POL POS

SYST:DIG:PIN2:POL NEG

Errors

-114,"Header suffix out of range"

Related Commands

TRIGger[:SEQuence]:SOURce

SYSTem:DIGital:INPut:DATA

SYSTem:DIGital:OUTPut:DATA

Syntax

SYSTem:ERRor[:NEXT]?

Description

This query command reads and clear errors from the error queue. A record of up to 20 errors can be stored in the BB3’s error queue. See also “Error Messages” in Section 7.

Errors are retrieved in first-in-first-out (FIFO) order. The first error returned is the first error that was stored. The BB3 beeps once each time an error is generated. The error queue is cleared when power has been off or after a *CLS command.

Return

SYSTem:ERRor[:NEXT]? queries and clears the error messages in the error queue. The query returns the number and content of the error message.

Usage example

SYST:ERR?

-113,"Undefined header"

Errors

If more than 20 errors have occurred, the last error stored in the queue (the most recent error) is replaced with:

-350,"Queue overflow"

No additional errors are stored until you remove errors from the queue.

Related Commands

*CLS

*RST

SYSTem:ERRor:COUNt

Syntax

SYSTem:ERRor:COUNt?

Description

This query command queries the error/event queue for the number of unread items. As errors and events may occur at any time, more items may be present in the queue at the time it is actually read.

Usage example

SYST:ERR:COUN?

10

Related Commands

*CLS

*RST

SYSTem:ERRor[:NEXT]

Syntax

SYSTem:FAN:SPEed?

Description

Use this query to obtain cooling fan speed in rpm.

Usage example

SYST:FAN:SPE?

1450

Related Commands

SYSTem:FAN:STATus?

Syntax

SYSTem:FAN:STATus?

Description

Use this query to obtain information about cooling fan state.

Cooling fan is periodically tested while it’s working (that depends of measured channel’s temperature sensor value). When it does not passed the test, programmed output current is automatically limited to 2 A.

Return

Returns numerical status of the cooling fan:

• 0 – fault is detected
• 1 – fan is up and running
• 2 – fan testing is in progress
• 3 – fan is not installed

Usage example

SYST:FAN:STAT?

1

Related Commands

SYSTem:FAN:SPEed?

Syntax

SYSTem:FORMat:DATE {<format>}

SYSTem:FORMat:DATE?

Description

Set format that will be used for displaying date.

Parameters

Name

Type

Range

Default

<format>

Discrete

DMY|MDY

–

Return

The query command returns “DMY” or “MDY”.

Usage example

SYST:FORM:DATE MDY

Related Commands

SYSTem:DATE

SYSTem:FORMat:DATE

SYSTem:FORMat:TIME

Syntax

SYSTem:FORMat:TIME {<format>}

SYSTem:FORMat:TIME?

Description

Set clock format that will be used for displaying time.

Parameters

Name

Type

Range

Default

<format>

NR1

12|24

–

Return

The query command returns 12 or 24 clock format.

Usage example

SYST:FORM:TIME 12

Related Commands

SYSTem:DATE

SYSTem:FORMat:DATE

SYSTem:FORMat:TIME

Syntax

SYSTem:INHibit?

Description

Use this command to query BB3’s inhibit state that is controlled with digital input (see [SOURce]:DIGital:PIN<n>:FUNCtion command). When BB3 is in inhibited state, all channel’s output will be disabled (OFF) and triggered action (e.g. LIST) will be paused.

Channel output state command (OUTPut[:STATe]) can be used when BB3 is in inhibited mode but it will not affect output (i.e. change it to enable state).

Return

Returns 0 if inhibit is not active or 1 if inhibit is active.

Usage example

SYST:INH?

0

Related Commands

OUTPut[:STATe] {<bool>} [, <channel>]

[SOURce]:DIGital:PIN<n>:FUNCtion

Syntax

SYSTem:KLOCk

Description

This command similar to the SYSTem:REMote command disables all front-panel options except for [Lock/Unlock] icon. You can push and hold the [Lock/Unlock] for a few seconds to unlock the front panel. The system password may be needed if it is set.

Lock state is saved in non-volatile memory. Therefore, the front panel remains locked even after AC power is cycled.

Usage example

SYST:KLOC

Related Commands

SYSTem:COMMunicate:RLSTate

SYSTem:REMote

Syntax

SYSTem:LFRequency {<frequency>}

SYSTem:LFRequency?

Description

Use this command to set the AC mains frequency. This parameter determines the PLC (power line cycle) used for A/D conversion in modules such as MIO168 (default value is 50 Hz).

Parameters

Name

Type

Range

Default

<frequency>

NR1

50|60

50

Return

The query returns the set AC mains frequency.

Usage example

SYST:LFR?

50

Related Commands

SENSe:NPLCycles

Syntax

SYSTem:LOCal

Description

This command places the BB3 in the local mode during remote operation. All options on the front panel are fully functional.

Usage example

SYST:LOC

Related Commands

SYSTem:COMMunicate:RLSTate

SYSTem:REMote

SYSTem:RWLock

Syntax

SYSTem:MEASure[:SCALar]:TEMPerature[:THERmistor][:DC]? {<sensor>}

Description

Query the temperature measured using the specified temperature sensors as follows:

• AUX – auxiliary temperature sensor (built-in fan controller) used to monitor temperature inside BB3 chassis
• CH1, CH2, CH3, CH4, CH5, CH6 – temperature sensor connected to channel power module used to regulate fan speed

All installed sensors are periodically tested. When sensor does not passed the test, programmed output current is automatically limited to 2 A. If load that draws more current then 2 A output current will be set to zero.

Parameters

Name

Type

Range

Default

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Return

Returns the average temperature value in degrees Celsius (oC) as decimal number (NR2). If self-test detect selected temperature sensor failure or sensor is not installed a -240 or -241 error will be generated.

Usage example

SYST:MEAS:TEMP? CH2

49

Errors

-240,"Hardware error"

-241,"Hardware missing"

Related Commands

DIAGnostic[:INFOrmation]:FAN?

MEASure[:SCALar]:TEMPerature[:THERmistor][:DC]

SYSTem:CPU:OPTion?

SYSTem:TEMPerature:PROTection[:HIGH][:LEVel]

SYSTem:TEMPerature:PROTection[:HIGH]:DELay[:TIME]

SYSTem:TEMPerature:PROTection[:HIGH]:STATe

SYSTem:TEMPerature:PROTection[:HIGH]:TRIPped?

Syntax

SYSTem:MEASure[:SCALar][:VOLTage][:DC]? {<device>}

Description

Returns voltage of the RTC (Real-time-clock) backup battery.

Parameters

Name

Type

Range

Default

<device>

Discrete

RTC

RTC

Usage example

SYST:MEAS? RTC

3.07

Syntax

SYSTem:PASSword:CALibration:RESet

Description

This command resets the calibration password to the firmware default setting, which is “eezbb3”. This command does not reset the system password.

Usage example

SYST:PASS:CAL:RES

Related Commands

CALibration[:MODE]

CALibration:PASSword:NEW

Syntax

SYSTem:PASSword:FPANel:RESet

Description

This command resets the front panel lockout password to the firmware default setting, which is empty space (“”). This command does not reset the calibration password.

Usage example

SYST:PASS:FPAN:RES

Related Commands

SYSTem:KLOCk

SYSTem:PASSword:NEW

Syntax

SYSTem:PASSword:NEW {<old>}, {<new>}

Description

Enter a new system password. To change the password, first unsecure the BB3 using the old password. Then, the new code has to be entered. The calibration code may contain up to 16 characters over the remote interface. Minimum length is 4 characters.

The new password is automatically stored in non-volatile memory

Parameters

Name

Type

Range

Default

<old>

Quoted string

0 to 16 characters

–

<new>

Quoted string

4 to 16 characters

–

Usage example

SYST:PASS:NEW "","mypass2016"

Errors

122,"Invalid sys password"

125,"Sys password too long"

126,"Sys password too short"

Related Commands

SYSTem:KLOCk

Syntax

SYSTem:PON:OUTPut:DISable {<bool>}

SYSTem:PON:OUTPut:DISable?

Description

This command controls status off all channel outputs on power up. If enabled (ON), all outputs will be disabled regardless of what is stored in user profile selected for auto recall.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

Query returns status of forced output disabling on power up.

Usage example

OUTP?

1

SYST:PON:OUTP:DIS 1

(Restart)

OUTP?

0

Related Commands

MEMory:STATe:RECall:AUTO

SYSTem:POWer

Syntax

SYSTem:POWer {<bool>}

SYSTem:POWer?

Description

This command controls powering down and powering up sequence of the AC power inputs. The “Standby” indicator will be switched on when the BB3 enters the standby mode.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

Query returns BB3 power standby status.

Usage example

SYST:POW ON

SYST:POW?

1

Related Commands

*RST

*TST?

SYSTem:BEEP:STATe

Syntax

SYSTem:POWer:PROTection:TRIP {<bool>}

SYSTem:POWer:PROTection:TRIP?

Description

Use this command to shut down (set to standby mode) the BB3 when any of channel’s protection tripped. The SYSTem:POWer command has to be used to power the BB3 on again.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

Return

Query returns status of shutdown when tripped mode.

Usage example

SYST:POW:PROT:TRIP?

1

Related Commands

SYSTem:POWer

Syntax

SYSTem:RELay:CYCLes? {<chanlist>}

Modules

 SMX 

Description

This query returns the cycle count on the specified channels.

The SMX46 module channels are mapped in the following way (n is slot number):

• (@n03) – Power relay (max. 250 Vac, 8 A per contact)
• (@nrc) – Signal relay (1 A max., 30 Vdc / 0.3 A, 125 Vac) in switch matrix consists of 4 rows (r value) and 6 columns (c value). For example, use (@n23) to address relay for switch in row 2 and column 3.

When list of channels separated with comma is specified no space is allowed.

Parameters

Name

Type

Range

Default

<chanlist>

ChannelList

See channels mapping described above

–

Usage example

Query cycle count of power relay on the SMX46 installed in slot 2:

SYST:REL:CYCL? (@203)

44

Query cycle count of multiple signal relays on the SMX46 installed in slot 3:

SYST:REL:CYCL? (@311,312,313)

13,44,1023

Related Commands

SYSTem:SLOT[:COUNt]?

SYSTem:SLOT:STATe

SYSTem:SLOT:VERSion?

Syntax

SYSTem:REMote

Description

Use this command to place the BB3 into remote mode for USB (Virtual COM) or Ethernet remote control. All front-panel options are disabled except for [Lock/Unlock] icon. You can push and hold the [Lock/Unlock] for a few seconds to unlock the front panel. The system password may be needed if it is set.

Usage example

SYST:REM

Related Commands

SYSTem:COMMunicate:RLSTate

SYSTem:LOCal

SYSTem:RWLock

Syntax

SYSTem:REStart

Description

Use this command to initiate low-level (hardware) reset. When executed the power up procedure will start and currently active SCPI session will be lost.

Usage example

SYST:RES

Related Commands

*RST

Syntax

SYSTem:RWLock

Description

Places the BB3 in the remote mode for USB (Virtual COM) or Ethernet remote control. This command is the same as SYSTem:REMote, except that all front panel options are disabled, including the [Lock/Unlock] icon.

Usage example

SYST:RWL

Related Commands

SYSTem:COMMunicate:RLSTate

SYSTem:LOCal

SYSTem:REMote

Syntax

SYSTem:SLOT[:COUNt]?

Description

This query returns the number of available slots in BB3 enclosure. That number is always 3.

Usage example

SYST:SLOT?

3

Related Commands

SYSTem:SLOT:MODel?

SYSTem:SLOT:STATe

SYSTem:SLOT:VERSion?

Syntax

SYSTem:SLOT:COLor {<slot>}, {<color>}

SYSTem:SLOT:COLor? [<slot>]

Modules

 SMX  PREL 

Description

Use this command to set module header and frame color as defined with <color> value. Use 0 to reset module color to the default value. Default module color coresponds to the module slot number. Available colors and its RGB values can be found in the SYSTem:CHANnel:COLor command description.

This command is only applicable to modules that do not have discrete channel numbers (CH1, CH2 …), otherwise it may generate -241,"Hardware missing" execution error.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

<color>

NR1

0 – 24

0

Return

Query the status of module on the selected BB3 slot.

Errors

-222,"Data out of range"

-241,"Hardware missing"

Usage example

SYST:SLOT:COL 1,2

Related Commands

SYSTem:CHANnel:COLor

Syntax

SYSTem:SLOT:FIRMware? {<slot>}

Modules

 DCM  SMX  PREL  MIO 

Description

This query returns the firmware version number of the module installed into specified slot.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

Usage example

SYST:SLOT:FIRM? 3

"0.9"

Related Commands

SYSTem:SLOT[:COUNt]?

SYSTem:SLOT:MODel?

SYSTem:SLOT:SNO?

SYSTem:SLOT:STATe

SYSTem:SLOT:VERSion?

Syntax

SYSTem:SLOT:LABel {<slot>}, {<label>}

SYSTem:SLOT:LABel? {<slot>}

Description

Use this command to define the module label on selected <slot>.

This command is only applicable to modules that do not have discrete channel numbers (CH1, CH2 …), otherwise it may generate -241,"Hardware missing" execution error.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

<label>

Quoted string

1 – 10 characters

–

Return

Returns the label of the module queried as a quoted string.

Errors

-241,"Hardware missing"

Usage example

SYST:SLOT:LAB 1,"Cooler"

Related Commands

SYSTem:CHANnel:LABel

SYSTem:CHANnel:PIN:LABel

Syntax

SYSTem:SLOT:MODel? {<slot>}

Description

This query returns the model name of the module installed into specified slot.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

Usage example

SYST:SLOT:MOD? 2

"DCP405"

Related Commands

SYSTem:SLOT[:COUNt]?

SYSTem:SLOT:FIRMware?

SYSTem:SLOT:SNO?

SYSTem:SLOT:STATe

SYSTem:SLOT:VERSion?

Syntax

SYSTem:SLOT:SNO {<slot>}, {<sno>}

SYSTem:SLOT:SNO? {<slot>}

Description

Use this command to set serial number of module without on-board MCU like DCP405. Serial number has to be exactly 24 characters long and could contains only hexadecimal symbols, i.e. 0 to 9 and A to F otherwise a -224,"Illegal parameter value" error will be generated.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

<sno>

Quoted string

24 characters

–

Return

This query returns the serial number as qouted string of the module installed into specified slot.

Errors

-224,"Illegal parameter value"

Usage example

SYST:SLOT:SNO? 1

"99280045953510720393737"

Related Commands

SYSTem:SLOT:FIRMware?

SYSTem:SLOT:MODel?

SYSTem:SLOT:VERSion?

Syntax

SYSTem:SLOT:STATe {<slot>}, {<bool>}

SYSTem:SLOT:STATe? [<slot>]

Description

Use this command to enable or disable module installed into specified slot. When disabled an attempt to communicate with module will generate an execution error.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

<bool>

Boolean

ON|OFF|0|1

–

Return

Query the status of module on the selected BB3 slot.

Errors

-200,"Execution error"

Usage example

SYST:SLOT:STAT 1,0

Related Commands

*RST

DIAGnostic[:INFOrmation]:TEST?

SYSTem:SLOT[:COUNt]?

SYSTem:SLOT:MODel?

SYSTem:SLOT:VERSion?

Syntax

SYSTem:SLOT:VERSion? {<slot>}

Description

This query returns the version number of the module installed into specified slot.

Parameters

Name

Type

Range

Default

<slot>

NR1

1 – 3

–

Usage example

SYST:SLOT:VERS? 2

"R2B11"

Related Commands

*RST

DIAGnostic[:INFOrmation]:TEST?

SYSTem:CHANnel[:COUNt]?

Syntax

SYSTem:TEMPerature:PROTection[:HIGH][:LEVel] {<temperature>} [, <sensor>]

SYSTem:TEMPerature:PROTection[:HIGH][:LEVel]? [<sensor>]

Description

Set the over-temperature protection (OTP) value in degrees Celsius (oC) of the selected temperature sensor. When the over-temperature protection function of the specified temperature sensor is enabled (SYSTem:TEMPerature:PROTection[:HIGH]:STATe), one of the following action will be performed when the temperature exceeds the over-temperature protection value currently set:

• AUX – Switch off power of the main transformer and set bit 4 of the Questionable Status register
• CH1, CH2, CH3, CH4, CH5, CH6 – Disable channel output (OUTPut OFF) and set bit 4 of the Questionable Instrument Isummary register.

If any of above mentioned temperature sensors cause over-temperature condition an error tone will also follow if beeper is enabled (see SYSTem:BEEPer:STATe).

SYSTem:TEMPerature:PROTection[:HIGH]:TRIPped? command can be used to query whether over-temperature protection occurred on the selected temperature sensor.

Parameters

Name

Type

Range

Default

<temperature>

NR2

10 – 100

70 for CH1 to CH2, and 50 for AUX

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Return

Query the over-temperature protection (OTP) value of the selected temperature sensor.

Usage example

SYST:TEMP:PROT 50, AUX

SYST:TEMP:PROT?

50

Related Commands

*RST

SYSTem:TEMPerature:PROTection[:HIGH]:STATe

SYSTem:TEMPerature:PROTection[:HIGH]:TRIPped?

Syntax

SYSTem:TEMPerature:PROTection[:HIGH]:CLEar [<sensor>]

Description

This command clears the latched protection status when an over-temperature is detected.

All conditions that generate the fault must be removed before the latched status can be cleared. The output is restored to the state it was in before the fault condition occurred.

Name

Type

Range

Default

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Usage example

SYST:TEMP:PROT:CLE

Related Commands

SYSTem:TEMPerature:PROTection[:HIGH]:TRIPped

Syntax

SYSTem:TEMPerature:PROTection[:HIGH]:DELay[:TIME] {<delay>} [, <sensor>]

SYSTem:TEMPerature:PROTection[:HIGH]:DELay[:TIME]? [<sensor>]

Description

This command sets the over-temperature protection delay. The over-temperature protection function will not be triggered during the delay time. After the delay time has expired, the over-temperature protection function will be active.

Programmed values can range from 0 to 300 seconds. See also Section 8.1

Parameters

Name

Type

Range

Default

<delay>

NR1

0 – 300 seconds

10

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Return

The query returns programmed over-temperature protection delay.

Usage example

SYST:TEMP:PROT:DEL 30, CH2

Related Commands

*RST

SYSTem:TEMPerature:PROTection[:HIGH][:LEVel]

Syntax

SYSTem:TEMPerature:PROTection[:HIGH]:STATe {<bool>} [, <sensor>]

SYSTem:TEMPerature:PROTection[:HIGH]:STATe? [<sensor>]

Description

This command enables or disables the over-temperature protection (OTP) function. The enabled state is ON (1); the disabled state is OFF (0). If the over-temperature protection function is enabled and the measured output power reach value set by [SOURce[<n>]]:POWer:PROTection[:LEVel] the output is disabled and the Questionable Condition status register OPP bit 10 is set.

Parameters

Name

Type

Range

Default

<bool>

Boolean

ON|OFF|0|1

OFF

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Return

The query command returns 0 if the current protection state is OFF, and 1 if the current protection state is ON.

Usage example

SYST:TEMP:PROT:STAT? CH1

0

Related Commands

*RST

SYSTem:TEMPerature:PROTection[:HIGH]:CLEar

Syntax

SYSTem:TEMPerature:PROTection[:HIGH]:TRIPped? [<sensor>]

Description

Query whether OTP occurred on the selected temperature sensor. When protection is tripped bit 4 (TEMPerature) of the Questionable Status register will be set (see Section 3.4).

The SYSTem:TEMPerature:PROTection[:HIGH]:CLEar command can be send to clear OTP condition caused by the selected temperature sensor.

Parameters

Name

Type

Range

Default

<sensor>

Discrete

AUX|CH1|CH2|CH3|CH4|CH5|CH6

AUX

Return

This query returns a 1 if the protection circuit is tripped and a 0 if it is untripped.

Usage example

SYST:TEMP:PROT:TRIP?

0

Related Commands

SYSTem:TEMPerature:PROTection[:HIGH]:CLEar

SYSTem:TEMPerature:PROTection[:HIGH]:STATe

Syntax

SYSTem:TIME {<hours>}, {<minutes>}, {<seconds>}

SYSTem:TIME?

Description

Sets the time of the system clock (RTC). Specify the hours, minutes, and seconds.

The self-test procedure compare date and time stored in RTC registers with values stored in the non-volatile memory (EEPROM). When the later is greater then former or any of them lost integrity (i.e. any of value is outside allowed range: for example seconds are higher then 60 or months are higher then 12, etc.) self-test will failed. The *TST? will return 1 and detailed report could be queried using the DIAGnostic:TEST? command.

The bit 3 (TIME) of the Questionable Status register will be set (see Section 3.4) if datetime self-test failed or datetime was never set.

Parameters

Name

Type

Range

Default

<hours>

NR1

0 – 23

–

<minutes>

NR1

0 – 59

–

<seconds>

NR1

0 – 59

–

Return

Query the current time of the system clock in HH, MM, SS format.

Usage example

SYST:TIME?

15, 10, 33

Related Commands

*TST?

DIAGnostic[:INFOrmation]:TEST?

SYSTem:DATE

SYSTem:FORMat:TIME

Syntax

SYSTem:TIME:DST {<rules>}

SYSTem:TIME:DST?

Description

Use this command to define daylight saving time (DST) rules used in your region.

Firmware v1.0 support limited number of region: Europe, US/Canada and Australia/New Zealand.

Parameters

Name

Type

Range

Default

<rules>

Discrete

OFF|EU|USA|AUS

OFF

Return

Query the DTS rule name used for adjust time.

Usage example

SYST:TIME:DST EU

Related Commands

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:NTP

SYSTem:TIME

Syntax

SYSTem:TIME:ZONE {<zone>}

SYSTem:TIME:ZONE?

Description

Use this command to define time zone as offset from GMT.

Parameters

Name

Type

Range

Default

<zone>

Quoted string

-12:00 to 14:00

–

Return

Query the time zone as offset from GMT in the following format: “[sign]hh:mm GMT”

Usage example

SYST:TIME:ZONE 1

SYST:TIME:ZONE?

"+01:00 GMT"

Related Commands

SYSTem:COMMunicate:ENABle

SYSTem:COMMunicate:NTP

SYSTem:TIME

Syntax

SYSTem:VERSion?

Description

This command returns the version of the SCPI (Standard Commands for Programmable Instruments) standard with which the instrument is in compliance

Return

The command returns a string in the form “YYYY.V”, where YYYY represents the year of the version and V represents a version for that year.

Usage example

SYST:VERS?

1999.0