Command Table Summary

The following table lists every CT-BOX command, its purpose, its parameter(s) and the mode(s) of operation in which it applies, for quick reference.

In the Mode column: ALL means a general-purpose command usable in all three acquisition modes, OSC means the command applies only in oscilloscope mode, DMM means the command applies only in digital-multimeter mode, DLOG means it applies only in data-logger mode, DLOG-DMM means it applies in both data-logger and digital-multimeter modes, DLOG-OSC means it applies in both data-logger and oscilloscope modes. Settings of mode-specific commands can be written and read in any mode; only GET and ACQT are rejected outside their modes. Data is saved to the SD card only in DLOG and DMM modes.

Mode and Acquisition

Command

Purpose

Parameters

Mode

MODE

Set the device in OSC / DLOG / DMM mode

:OSC / :DLOG / :DMM

ALL

Read the device operation mode

:?

ALL

ACQ

Start / stop the measurements acquisition

:ON / :OFF

ALL

Read the acquisition status

:?

ALL

PRINT

Enable / disable printing on the communication stream

:ON / :OFF

ALL

Read the printing configuration

:?

ALL

Reading

Command

Purpose

Parameters

Mode

GET

Get a single current reading, in Amps

(none)

DLOG-OSC

GETA

Get an array of n current readings (Ethernet only)

:[1 - 5000]

ALL

GETT

Read the DCCT / external sensor temperature

:HEAD / :EXT

ALL

Output Data Rate and Acquisition Settings

Command

Purpose

Parameters

Mode

TS

Set the averaging interval, in µs

:[10 - 1000000]

OSC

Read the averaging interval

:?

OSC

FREQ

Set the output data frequency, in Hz

:[0.1 - 0.9] (step 0.1) / :[1 - 10] (step 1)

DLOG

Read the output data frequency

:?

DLOG

DMM

Set the DMM submode

:DC / :AC / :ACDC

DMM

Read the DMM submode

:?

DMM

Set the DMM frequency

:FREQ:[47.00 - 63.00]

DMM

Read the DMM frequency

:FREQ:?

DMM

Set the DMM number of periods

:NOP:{1; 10; 20; 100}

DMM

Read the DMM number of periods

:NOP:?

DMM

ACQT

Set the temperature acquisition configuration

:000 / :010 / :100 / :110

DLOG

Read the temperature acquisition configuration

:?

DLOG

Measurement Setup

Command

Purpose

Parameters

Mode

PTURNS

Set the number of primary turns

:[1 - 100]

ALL

Read the configured number of primary turns

:?

ALL

OFFSET

Zero the offset at null primary current

:ZERO

ALL

Alarm and Trigger

Command

Purpose

Parameters

Mode

ALARM

Enable / disable the alarm check functionality

:ON / :OFF

ALL

Clear the alarm condition

:CLR

ALL

Read the alarm check setting

:?

ALL

Set / read the upper current threshold, in Amps

:ULIM:<current> / :ULIM:?

ALL

Set / read the lower current threshold, in Amps

:LLIM:<current> / :LLIM:?

ALL

TRG

Set the trigger as input / output / gate or disable it

:IN / :OUT / :OFF / :GATE

IN / OUT: DLOG-OSC; GATE: DMM; OFF: ALL

Read the trigger status

:?

ALL

SD Card

Command

Purpose

Parameters

Mode

SD

Mount / unmount the SD card

:MOUNT / :UNMOUNT

DLOG-DMM

Read the SD card status

:?

DLOG-DMM

Reset the SD card

:RST

DLOG-DMM

List all files on the SD card

:LS

DLOG-DMM

Remove / size / read a file on the SD card

:RM:<filename> / :SIZE:<filename> / :READ:<filename>

DLOG-DMM

SAVE

Enable / disable saving to the SD card

:ON / :OFF

DLOG-DMM

Read the saving configuration

:?

DLOG-DMM

Real-Time Clock

Command

Purpose

Parameters

Mode

DATE

Set / read the RTC date (dd.mm.yyyy)

:<date> / :?

DLOG-DMM

TIME

Set / read the RTC time (hours.minutes.seconds)

:<time> / :?

DLOG-DMM

Network

Command

Purpose

Parameters

Mode

IP

Set / read the IP address

:<ip_address> / :?

ALL

MASK

Set / read the subnet mask

:<subnet_mask> / :?

ALL

GATE

Set / read the default gateway

:<gateway> / :?

ALL

PORT

Set / read the UDP data-stream port

:<port> / :?

OSC

Device Information and Reset

Command

Purpose

Parameters

Mode

VER

Read the installed firmware release

:?

ALL

CTBOX

Read the unit serial number

:SN:?

ALL

Set / read the user-defined unit name (max 15 chars)

:NAME:<des> / :NAME:?

ALL

Read the unit calibration date

:CDATE:?

ALL

DCCT

Read the matched DCCT serial number

:SN:?

ALL

Read the connected DCCT model and serial number

:MODEL:?

ALL

HWRESET

Perform a hardware reset of the unit

:FORCE

ALL

Status and Errors

Command

Purpose

Parameters

Mode

STATUS

Read the internal Status register

:?

ALL

ERR

Read the internal Error register

:?

ALL

Clear the internal Error register

:CLR

ALL

Calibration (Password Protected)

Command

Purpose

Parameters

Mode

PASSWORD

Unlock / lock the protected commands

:CAL-ADMIN / :LOCK

ALL

SCALE

Calculate the calibration parameters

:POS:<current> / :NEG:<current>

ALL

GAIN

Store / read the calibration parameters

:POS:<gain> / :POS:? / :NEG:<gain> / :NEG:?

ALL