Keysight Technologies DAQ970A Operating instructions

Programming
Guide
Keysight
DAQ970A/DAQ973A
Data Acquisition System

Notices 12
Copyright Notice 12
Manual Part Number 12
Edition 12
Published by 12
Software Revision 12
Warranty 13
Technology Licenses 13
Restricted Rights Legend 13
Waste Electrical and Electronic Equipment (WEEE) 13
Declarations of Conformity 13
Safety Information 14
1 Remote Operation 15
Introduction to the SCPI Language 16
Syntax conventions 17
SCPI command separators 17
Querying parameter settings 18
Using the MIN, MAX, and DEFparameters 18
SCPI command terminators 18
IEEE-488.2 common commands 19
Channel list parameter 19
SCPIparameter types 20
Using Device Clear 21
LANport usages 21
Factory Reset State 22
Instrument Preset State 24
2 SCPI Programming 26
INSTrument Subsystem 28
R Subsystem 29
READ Subsystem 30
TEST Subsystem 31
UNIT Subsystem 32
ABORt Subsystem 33
ABORt 33
ABORt3 33
ACQuire Subsystem 35
ACQuire? 35
ACQuire:CURRent[:DC] 35
ACQuire:VOLTage[:DC] 35
ACQuire:RESistance 35
ACQuire:FRESistance 35
ACQuire:STRain:DIRect 35
ACQuire:STRain:FDIRect 35
ACQuire:STRain:QUARter 35
ACQuire:STRain:HALF:BENDing 35
ACQuire:STRain:FULL:BENDing 35
ACQuire:STRain:HALF:POISson 35
ACQuire:STRain:FULL:POISson 35
ACQuire:STRain:FULL:BENDing:POISson 35
ACQuire:TEMPerature:FRTD 35
2Keysight DAQ970A/DAQ973A Programming Guide

ACQuire:TEMPerature:RTD 35
ACQuire:TEMPerature:TCouple 35
ACQuire3 Subsystem 46
ACQuire3? 46
ACQuire3:POWer:ANALysis 46
ACQuire3:STRain:QUARter 46
ACQuire3:STRain:HALF:BENDing 46
ACQuire3:STRain:FULL:BENDing 46
ACQuire3:STRain:HALF:POISson 46
ACQuire3:STRain:FULL:POISson 46
ACQuire3:STRain:FULL:BENDing:POISson 46
ACQuire3:VOLTage[:DC] 46
ARM3 Subsystem 55
ARM3:COUNt 55
ARM3:SOURce 55
CALCulate Subsystem 58
CALCulate:AVERage Subsystem 59
CALCulate:AVERage:ALL? 59
CALCulate:AVERage:AVERage? 59
CALCulate:AVERage:MAXimum? 59
CALCulate:AVERage:MINimum? 59
CALCulate:AVERage:PTPeak? 59
CALCulate:AVERage:SDEViation? 59
CALCulate:AVERage:CLEar 59
CALCulate:AVERage:COUNt? 59
CALCulate:AVERage:MAXimum:TIME? 59
CALCulate:AVERage:MINimum:TIME? 59
CALCulate:COMPare Subsystem 62
CALCulate:COMPare:DATA 62
CALCulate:COMPare:MASK 62
CALCulate:COMPare:STATe 62
CALCulate:COMPare:TYPE 62
CALCulate:LIMit Subsystem 66
CALCulate:LIMit:LOWer 66
CALCulate:LIMit:UPPer 66
CALCulate:LIMit:LOWer:STATe 66
CALCulate:LIMit:UPPer:STATe 66
CALCulate:MATH 71
CALCulate:SCALe Subsystem 73
CALCulate:SCALe:DB:REFerence 73
CALCulate:SCALe:DBM:REFerence 73
CALCulate:SCALe:FUNCtion 73
CALCulate:SCALe:GAIN 73
CALCulate:SCALe:OFFSet 73
CALCulate:SCALe:OFFSet:NULL 73
CALCulate:SCALe:REFerence 73
CALCulate:SCALe:REFerence:AUTO 73
CALCulate:SCALe:REFerence:IMMEdiate 73
CALCulate:SCALe[:STATe] 73
CALCulate:SCALe:UNIT 73
CALCulate:SCALe:UNIT:STATe 73
CALibration Subsystem 82
Keysight DAQ970A/DAQ973A Programming Guide 3

CALibration:ADC? 82
CALibration[:ALL]? 82
CALibration:COUNt? 82
CALibration:DATE? 82
CALibration:SECure:CODE 82
CALibration:SECure:STATe 82
CALibration:STORe 82
CALibration:STRing 82
CALibration:TEMPerature? 82
CALibration:TIME? 82
CALibration:VALue 82
CONFigure Subsystem 88
CONFigure? 88
CONFigure:CAPacitance 88
CONFigure:CURRent:{AC|DC} 88
CONFigure:DAC:OUTPut 88
CONFigure:DAC:SENSe 88
CONFigure:DIGital[:BYTE] 88
CONFigure:DIODe 88
CONFigure:{FREQuency|PERiod} 88
CONFigure:{RESistance|FRESistance} 88
CONFigure:STRain:{DIRect|FDIRect} 88
CONFigure:STRain:{FULL|HALF}:BENDing 88
CONFigure:STRain:{FULL|HALF}:POISson 88
CONFigure:STRain:FULL:BENDing:POISson 88
CONFigure:STRain:QUARter 88
CONFigure:TEMPerature 88
CONFigure:TOTalize 88
CONFigure[:VOLTage]:{AC|DC} 88
DATA Subsystem 108
DATA:LAST? 108
DATA:POINts? 108
DATA:POINts:EVENt:THReshold 108
DATA:REMove? 108
DATA3 Subsystem 111
DATA3:LAST? 111
DATA3:POINts 111
DATA3:RECords? 111
DISPlay Subsystem 114
DISPlay 114
DISPlay:TEXT 114
DISPlay:TEXT:CLEar 114
FETCh Subsystem 117
FETCh? 117
FETCh:DATA 117
FETCh:{DCYCle | DUTYcycle} 117
FETCh:FFTRansform:MAGNitude 117
FETCh:FFTRansform:PHASe 117
FETCh:FREQuency 117
FETCh:{FTIMe|FALL:TIME} 117
FETCh:NWIDth 117
FETCh:PERiod 117
4Keysight DAQ970A/DAQ973A Programming Guide

FETCh:PWIDth 117
FETCh:RMS? 117
FETCh:{RTIMe|RISE:TIME} 117
FETCh:STATistics 117
FETCh:THDNoise 117
FETCh:THDistortion 117
FETCh3 Subsystem 125
FETCh3 125
FETCh3:DATA 125
FETCh3:{DCYCle | DUTYcycle} 125
FETCh3:FFTRansform:MAGNitude 125
FETCh3:FFTRansform:PHASe 125
FETCh3:FREQuency 125
FETCh3:{FTIMe|FALL:TIME} 125
FETCh3:NWIDth 125
FETCh3:PERiod 125
FETCh3:POWer 125
FETCh3:PWIDth 125
FETCh3:RMS? 125
FETCh3:{RTIMe|RISE:TIME} 125
FETCh3:STATistics 125
FETCh3:THDNoise 125
FETCh3:THDistortion 125
FORMat Subsystem 139
FORMat:READing:ALARm 139
FORMat:READing:CHANnel 139
FORMat:READing:TIME 139
FORMat:READing:TIME:TYPE 139
FORMat:READing:UNIT 139
FORMat:BORDer 139
FORMat[:DATA] 139
FORMat3 Subsystem 143
FORMat3:BORDer 143
FORMat3[:DATA] 143
HCOPy Subsystem 145
HCOPy:SDUMp:DATA? 145
HCOPy:SDUMp:DATA:FORMat 145
IEEE-488.2 Common Commands 147
*CAL? 147
*CLS 147
*ESE 147
*ESR? 147
*IDN? 147
*OPC 147
*PSC 147
*RCL 147
*RST 147
*SAV 147
*SRE 147
*STB? 147
*TRG 147
*TST? 147
Keysight DAQ970A/DAQ973A Programming Guide 5

*WAI 147
INITiate Subsystem 154
INITiate[:IMMediate] 154
INITiate3 154
INPut3 Subsystem 157
INPut3:COUPling 157
INPut3:TYPE 157
LXI Subsystem 159
LXI:IDENtify:STATe 159
LXI:MDNS:ENABle 159
LXI:MDNS:HNAMe[:RESolved]? 159
LXI:MDNS:SNAMe:DESired 159
LXI:MDNS:SNAMe[:RESolved]? 159
LXI:MDNS[:STATe] 159
LXI:RESet 159
LXI:RESTart 159
MEASure Subsystem 163
MEASure:CAPacitance? 163
MEASure:CURRent:{AC|DC}? 163
MEASure:DAC:OUTPut? 163
MEASure:DAC:SENSe? 163
MEASure:DIGital[:BYTE]? 163
MEASure:DIODe? 163
MEASure:{FREQuency|PERiod}? 163
MEASure:{RESistance|FRESistance}? 163
MEASure:STRain:{DIRect|FDIRect}? 163
MEASure:STRain:{FULL|HALF}:BENDing? 163
MEASure:STRain:{FULL|HALF}:POISson? 163
MEASure:STRain:FULL:BENDing:POISson? 163
MEASure:STRain:QUARter? 163
MEASure:TEMPerature? 163
MEASure:TOTalize? 163
MEASure[:VOLTage]:{AC|DC} 163
MMEMory Subsystem 178
Data Transfer Commands 178
MMEMory:DOWNload:DATA 178
MMEMory:DOWNload:FNAMe 178
MMEMory:FORMat:READing:CHEAder 178
MMEMory:FORMat:READing:CSEParator 178
MMEMory:FORMat:READing:RLIMit 178
MMEMory:FORMat:READing:RLIMit:COUNt 178
MMEMory:STORe:DATA 178
MMEMory:STORe:DATA:AUTO 178
MMEMory:STORe:DATA:AUTO:FNAMe 178
MMEMory:UPLoad? 178
STATe and PREFerence Management Commands 178
MMEMory:LOAD:PREFerences 178
MMEMory:STORe:PREFerences 178
MMEMory:LOAD:STATe 178
MMEMory:STORe:STATe 178
MMEMory:STATe:RECall:AUTO 178
MMEMory:STATe:RECall:SELect 178
6Keysight DAQ970A/DAQ973A Programming Guide

MMEMory:STATe:VALid? 178
General Purpose File Management Commands 179
MMEMory:CATalog[:ALL]? 179
MMEMory:CDIRectory 179
MMEMory:MDIRectory 179
MMEMory:RDIRectory 179
MMEMory:COPY 179
MMEMory:DELete 179
MMEMory:LOG[:ENABle] 179
MMEMory:LOG:NEW 179
MMEMory:MOVE 179
MMEMory3 Subsystem 195
MMEMory3:STORe:DATA 195
MMEMory3:STORe:DATA:AUTO 195
MMEMory3:STORe:DATA:AUTO:FNAMe 195
OUTPut Subsystem 198
OUTPut:ALARm:CLEar:ALL 198
OUTPut:ALARm{1|2|3|4}:CLEar 198
OUTPut:ALARm{1|2|3|4}:SOURce 198
OUTPut:ALARm:MODE 198
OUTPut:ALARm:SLOPe 198
OUTPut:TRIGger:SLOPe 198
ROUTe Subsystem 203
ROUTe:CHANnel:ADVance:SOURce 203
ROUTe:CHANnel:DELay 203
ROUTe:CHANnel:DELay:AUTO 203
ROUTe:CHANnel:FWIRe 203
ROUTe:CHANnel:LABel 203
ROUTe:CHANnel:LABel:CLEar:MODule 203
ROUTe:CLOSe 203
ROUTe:CLOSe:EXCLusive 203
ROUTe:DONE? 203
ROUTe:MONitor 203
ROUTe:MONitor:DATA? 203
ROUTe:MONitor:DATA:FULL? 203
ROUTe:MONitor:STATe 203
ROUTe:MONitor:VIEW 203
ROUTe:OPEN 203
ROUTe:SCAN 203
ROUTe:SCAN:SIZE? 203
SAMPle Subsystem 216
SAMPle:COUNt 216
SAMPle:COUNt:PRETrigger 216
SAMPle:TIMer 216
SAMPle3 Subsystem 220
SAMPle3:COUNt 220
SAMPle3:COUNt:PRETrigger 220
SAMPle3:RATE 220
SENSe Subsystem 223
[SENSe:]CAPacitance Subsystem 226
[SENSe:]CAPacitance:RANGe:AUTO 226
[SENSe:]CAPacitance:RANGe 226
Keysight DAQ970A/DAQ973A Programming Guide 7

[SENSe:]CURRent Subsystem 228
[SENSe:]CURRent:AC:BANDwidth 228
[SENSe:]CURRent:{AC|DC}:RANGe:AUTO 228
[SENSe:]CURRent:{AC|DC}:RANGe 228
[SENSe:]CURRent[:DC]:APERture 228
[SENSe:]CURRent[:DC]:APERture:ENABle 228
[SENSe:]CURRent[:DC]:NPLCycles 228
[SENSe:]CURRent[:DC]:ZERO:AUTO 228
[SENSe:]{FREQuency|PERiod} Subsystem 234
[SENSe:]{FREQuency|PERiod}:APERture 234
[SENSe:]{FREQuency|PERiod}:RANGe:LOWer 234
[SENSe:]{FREQuency|PERiod}:VOLTage:RANGe:AUTO 234
[SENSe:]{FREQuency|PERiod}:VOLTage:RANGe 234
[SENSe:]{RESistance|FRESistance} Subsystem 239
[SENSe:]{RESistance|FRESistance}:APERture 239
[SENSe:]{RESistance|FRESistance}:APERture:ENABle 239
[SENSe:]{RESistance|FRESistance}:NPLCycles 239
[SENSe:]{RESistance|FRESistance}:OCOMpensated 239
[SENSe:]{RESistance|FRESistance}:POWer:LIMit[:STATe] 239
[SENSe:]{RESistance|FRESistance}:RANGe:AUTO 239
[SENSe:]{RESistance|FRESistance}:RANGe 239
[SENSe:]RESistance:ZERO:AUTO 239
[SENSe:]STRain Subsystem 248
[SENSe:]STRain:APERture 248
[SENSe:]STRain:APERture:ENABle 248
[SENSe:]STRain:EXCitation 248
[SENSe:]STRain:EXCitation:TYPE 248
[SENSe:]STRain:GFACtor 248
[SENSe:]STRain:NPLCycles 248
[SENSe:]STRain:OCOMpensated 248
[SENSe:]STRain:POISson 248
[SENSe:]STRain:RESistance 248
[SENSe:]STRain:UNSTrained 248
[SENSe:]STRain:UNSTrained:IMMediate 248
[SENSe:]STRain:VOLTage:RANGe:AUTO 248
[SENSe:]STRain:VOLTage:RANGe 248
[SENSe:]STRain:ZERO:AUTO 248
[SENSe:]TEMPerature Subsystem 258
[SENSe:]TEMPerature:APERture 258
[SENSe:]TEMPerature:APERture:ENABle 258
[SENSe:]TEMPerature:NPLCycles 258
[SENSe:]TEMPerature:RJUNction? 258
[SENSe:]TEMPerature:TRANsducer:{FRTD|RTD}:OCOMpensated 258
[SENSe:]TEMPerature:TRANsducer:{FRTD|RTD}:POWer:LIMit[:STATe] 258
[SENSe:]TEMPerature:TRANsducer:{FRTD|RTD}:REFerence 258
[SENSe:]TEMPerature:TRANsducer:{FRTD|RTD}:RESistance[:REFerence] 258
[SENSe:]TEMPerature:TRANsducer:{FTHermistor|THERmistor}:POWer:LIMit[:STATe] 258
[SENSe:]TEMPerature:TRANsducer:{FTHermistor|THERmistor}:REFerence 258
[SENSe:]TEMPerature:TRANsducer:{FTHermistor|THERmistor}:TYPE 258
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk 258
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction 258
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE 258
8Keysight DAQ970A/DAQ973A Programming Guide

[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE 258
[SENSe:]TEMPerature:TRANsducer:TYPE 258
[SENSe:]TEMPerature:ZERO:AUTO 258
[SENSe:]VOLTage Subsystem 272
[SENSe:]VOLTage:AC:BANDwidth 272
[SENSe:]VOLTage:{AC|DC}:RANGe:AUTO 272
[SENSe:]VOLTage:{AC|DC}:RANGe 272
[SENSe:]VOLTage[:DC]:APERture 272
[SENSe:]VOLTage[:DC]:APERture:ENABle 272
[SENSe:]VOLTage[:DC]:IMPedance:AUTO 272
[SENSe:]VOLTage[:DC]:NPLCycles 272
[SENSe:]VOLTage[:DC]:REFerence 272
[SENSe:]VOLTage[:DC]:ZERO:AUTO 272
[SENSe:]TOTalize Subsystem 280
[SENSe:]TOTalize:CLEar:IMMediate 280
[SENSe:]TOTalize:DATA? 280
[SENSe:]TOTalize:SLOPe 280
[SENSe:]TOTalize:STARt 280
[SENSe:]TOTalize:STOP 280
[SENSe:]TOTalize:TYPE 280
SENSe3 Subsystem 283
SENSe3:FILTer:MODE 283
SENSe3:FUNCtion 283
SENSe3:STRain:EXCitation 283
SENSe3:STRain:GFACtor 283
SENSe3:STRain:POISson 283
SENSe3:STRain:UNSTrained 283
SENSe3:STRain:UNSTrained:IMMediate 283
SENSe3:STRain:VOLTage:RANGe 283
SOURce Subsystem 288
SOURce:CURRent 288
SOURce:DIGital:DATA[:BYTE] 288
SOURce:DIGital:DATA:WORD 288
SOURce:DIGital:STATe? 288
SOURce:MODE 288
SOURce:MODE:LOCK 288
SOURce:VOLTage 288
STATus Subsystem 292
STATus:ALARm:CONDition? 296
STATus:ALARm:ENABle 296
STATus:ALARm[:EVENt]? 296
STATus:OPERation:CONDition? 296
STATus:OPERation:ENABle 296
STATus:OPERation[:EVENt]? 296
STATus:PRESet 296
STATus:QUEStionable:CONDition? 296
STATus:QUEStionable:ENABle 296
STATus:QUEStionable[:EVENt] 296
SYSTem Subsystem 300
General Commands 300
SYSTem:ACALibration Subsystem 300
SYSTem:ALARm? 300
Keysight DAQ970A/DAQ973A Programming Guide 9

SYSTem:BEEPer 300
SYSTem:BEEPer:STATe 300
SYSTem:CLICk:STATe 300
SYSTem:CPON 300
SYSTem:CTYPe? 300
SYSTem:DATE 300
SYSTem:ERRor? 300
SYSTem:HELP? 300
SYSTem:LOCal 300
SYSTem:LOCK Subsystem 300
SYSTem:PERSona Subsystem 300
SYSTem:PRESet 300
SYStem:RELay Subsystem 300
SYSTem:REMote 300
SYSTem:SECurity:COUNt? 300
SYSTem:SECurity:ENABle 300
SYSTem:SECurity:IMMediate 300
SYSTem:SET 300
SYSTem:SLOT:LABel 300
SYSTem:TIME 300
SYSTem:TIME:SCAN? 301
SYSTem:TIME:TRIGger 301
SYSTem:TIME:TRIGger3 301
SYSTem:UPTime? 301
SYSTem:VERSion? 301
SYSTem:WMESsage 301
Remote Interface Configuration Commands 301
SYSTem:COMMunicate:ENABle 301
SYSTem:COMMunicate:GPIB:ADDRess 301
SYSTem:COMMunicate:LAN:CONTrol? 301
SYSTem:COMMunicate:LAN:DHCP 301
SYSTem:COMMunicate:LAN:DNS 301
SYSTem:COMMunicate:LAN:DOMain? 301
SYSTem:COMMunicate:LAN:GATeway 301
SYSTem:COMMunicate:LAN:HOSTname 301
SYSTem:COMMunicate:LAN:IPADdress 301
SYSTem:COMMunicate:LAN:MAC? 301
SYSTem:COMMunicate:LAN:SMASk 301
SYSTem:COMMunicate:LAN:TELNet:PROMpt 301
SYSTem:COMMunicate:LAN:TELNet:WMESsage 301
SYSTem:COMMunicate:LAN:UPDate 301
SYSTem:COMMunicate:LAN:WINS 301
SYSTem:USB:HOST:ENABle 301
TRIGger Subsystem 337
TRIGger:COUNt 337
TRIGger:DELay 337
TRIGger:LEVel 337
TRIGger:SLOPe 337
TRIGger:SOURce 337
TRIGger:TIMer 337
TRIGger3 Subsystem 345
TRIGger3:DELay 345
10 Keysight DAQ970A/DAQ973A Programming Guide

TRIGger3:LEVel 345
TRIGger3:SLOPe 345
TRIGger3:SOURce 345
TRIGger3:WFTRigger 345
3SCPI Error Messages 350
SCPI Error Messages 351
Command Errors (-100...) 352
Execution Errors (-200...) 353
Device-Specific Errors (-300...) 355
Query Errors (-400...) 356
Network Errors (+100...) 356
Instrument Errors (+200...) 356
Miscellaneous Errors (+300..., +400..., and +500...) 357
Self-test Errors (+600...) 358
Calibration Errors (+700...) 363
Miscellaneous Errors (+800...) 365
4Plug-in Modules Reference 366
DAQM900A 20-Channel FET Multiplexer 367
DAQM901A 20-Channel Armature Multiplexer 371
DAQM902A 16-Channel Reed Multiplexer 376
DAQM903A 20-Channel Actuator/General Purpose Switch 380
DAQM904A 4×8 Two-Wire Matrix Switch 381
DAQM905A Dual 1:4 RF Multiplexer (50 Ω) Module 382
DAQM907A Multifunction Module 383
DAQM908A 40-Channel Single-Ended Multiplexer 386
DAQM909A 4-Channel 24-Bit Digitizer Module 390
Keysight DAQ970A/DAQ973A Programming Guide 11

Notices
Copyright Notice
© Keysight Technologies, 2019
No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or
translation into a foreign language) without prior agreement and written consent from Keysight Technologies as
governed by United States and international copyright laws.
Manual Part Number
DAQ97-90002
Edition
Edition 3, September 2019
Published by
Keysight Technologies
Bayan Lepas Free Industrial Zone
11900 Bayan Lepas, Penang
Malaysia
Software Revision
Periodically, Keysight releases software updates to fix known defects and incorporate product enhancements. To
search for software updates and the latest documentation for your product, go to the product page at:
–www.keysight.com/find/DAQ970A
–www.keysight.com/find/DAQ973A
A portion of the software in this product is licensed under terms of the General Public License Version 2 (GPLv2). The
text of the license and source code can be found at www.keysight.com/find/GPLV2.
This product uses Microsoft Windows CE. Keysight highly recommends that all Windows-based computers con-
nected to Windows CE instruments use current anti-virus software. For more information, go to the respective
product page at:
–www.keysight.com/find/DAQ970A
–www.keysight.com/find/DAQ973A
12 Keysight DAQ970A/DAQ973A Programming Guide
Notices

Warranty
THE MATERIAL CONTAINED IN THIS DOCUMENT IS PROVIDED "AS IS", AND IS SUBJECT TO BEING CHANGED,
WITHOUT NOTICE, IN FUTURE EDITIONS. FURTHER, TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE
LAW, KEYSIGHT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH REGARD TO THIS MANUAL
AND ANY INFORMATION CONTAINED HEREIN, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. KEYSIGHT SHALL NOT BE LIABLE FOR ERRORS
OR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING, USE, OR
PERFORMANCE OF THIS DOCUMENT OR OF ANY INFORMATION CONTAINED HEREIN. SHOULD KEYSIGHT AND
THE USER HAVE A SEPARATE WRITTEN AGREEMENT WITH WARRANTY TERMS COVERING THE MATERIAL IN THIS
DOCUMENT THAT CONFLICT WITH THESE TERMS, THE WARRANTY TERMS IN THE SEPARATE AGREEMENT
SHALL CONTROL.
Technology Licenses
The hardware and/or software described in this document are furnished under a license and may be used or copied
only in accordance with the terms of such license.
Restricted Rights Legend
If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered
and licensed as "Commercial computer software" as defined in DFAR 252.227-7014 (June 1995), or as a "com-
mercial item" as defined in FAR 2.101(a) or as "Restricted computer software" as defined in FAR 52.227-19 (June
1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to
Keysight Technologies’ standard commercial license terms, and non-DOD Departments and Agencies of the U.S.
Government will receive no greater than Restricted Rights as defined in FAR 52.227-19(c) (1-2) (June 1987). U.S.
Government users will receive no greater than Limited Rights as defined in FAR 52.227-14 (June 1987) or DFAR
252.227-7015 (b)(2) (November 1995), as applicable in any technical data.
Waste Electrical and Electronic Equipment (WEEE)
This product complies with the European WEEE directive marketing requirement. The affixed product label (see
below) indicates that you must not discard this electrical/electronic product in domestic household waste.
Product Category: With reference to the equipment types in the WEEE directive Annex 1, this product is classified as
"Monitoring and Control instrumentation" product. Do not dispose in domestic household waste.
To return unwanted products, contact your local Keysight office, or see http://-
about.keysight.com/en/companyinfo/environment/takeback.shtml for more information.
Declarations of Conformity
Declarations of Conformity for this product and for other Keysight products may be downloaded from the Web. Go
to https://regulations.about.keysight.com/DoC/default.htm and click on “Declarations of Conformity". You can
Keysight DAQ970A/DAQ973A Programming Guide 13
Notices

then search by product number to find the latest Declaration of Conformity.
Safety Information
The WARNING sign denotes a hazard. It calls attention to a procedure, practice, or the like, which, if not cor-
rectly performed or adhered to, could result in personal injury. Do not proceed beyond a WARNING sign until
the indicated conditions are fully understood and met.
The CAUTION sign denotes a hazard. It calls attention to an operating procedure, or the like, which, if not cor-
rectly performed or adhered to, could result in damage to or destruction of part or all of the product. Do not
proceed beyond CAUTION sign until the indicated conditions are fully understood and met.
The NOTE sign denotes important information. It calls attention to a procedure, practice, condition or the like,
which is essential to highlight.
14 Keysight DAQ970A/DAQ973A Programming Guide
Notices

1 Remote Operation
Introduction to the SCPI Language
Factory Reset State
Instrument Preset State
This chapter describes the remote operation for the DAQ970A/DAQ973A using SCPI pro-
gramming language.
Keysight DAQ970A/DAQ973A Programming Guide 15
1 Remote Operation

Introduction to the SCPI Language
SCPI (Standard Commands for Programmable Instruments) is an ASCII-based programming language for test and
measurement instruments. SCPI commands use a hierarchical structure known as a tree system. Associated com-
mands are grouped under a common node or root, thus forming subsystems. A portion of the SENSe subsystem
illustrates this, as below.
SENSe:
VOLTage:
DC:RANGe {<range>|MIN|MAX|DEF}
DC:RANGe? [MIN|MAX|DEF]
SENSe is the root keyword of the command, VOLTage is a second-level keyword, and DC is a third-level keyword. A
colon ( : ) separates consecutive keywords.
Syntax conventions
SCPI command separators
Querying parameter settings
Using the MIN, MAX, and DEFparameters
SCPI command terminators
IEEE-488.2 common commands
Channel list parameter
SCPI parameter types
Using Device Clear
LANport usages
16 Keysight DAQ970A/DAQ973A Programming Guide
1 Remote Operation

Syntax conventions
The format used to show commands is illustrated as below:
VOLTage:DC:RANGe {<range>|MIN|MAX|DEF}
The command syntax shows most commands (and some parameters) as amixture of upper- and lower-case letters.
The upper-case letters indicate the abbreviated spelling for the command. For shorter program lines, you can send
the abbreviation form. For better program readability, you can send the full form.
For example, in the above syntax statement, VOLT and VOLTage are both acceptable forms. You can use upper- or
lower-case letters. Therefore, VolTaGe, volt and Volt are all acceptable forms. Other forms, such as VOL and
VOLTAG, are not valid and will generate an error.
– Braces ( { } ) enclose the parameter choices. The braces are not sent with the command string.
–A vertical bar ( | ) separates multiple parameter choices. For example, {<range>|MIN|MAX|DEF} in the above com-
mand indicates that you can specify a numeric range parameter, or "MIN", "MAX", or "DEF". The bar is not sent
with the command string.
– Angle brackets ( < > ) indicate that you must specify a value for the enclosed parameter. For example, the above
syntax statement shows the <range> parameter in angle brackets. Do not send the brackets with the command
string. You must specify a value for the parameter (for example "VOLT:DC:RANG 10") unless you select one of the
other options shown in the syntax (for example "VOLT:DC:RANG MIN").
– Optional parameters are enclosed in square brackets ( [ ] ). Thebrackets are not sent with the command string. If
you donot specify a value for an optional parameter, the instrument uses a default value.
SCPI command separators
A colon ( : ) separates consecutive keywords. You must insert a blank space to separate a parameter from a com-
mand keyword. If a command requires more than one parameter, separate adjacent parameters using a comma:
CONF:VOLT:DC 10,0.003
A semicolon ( ; ) separates commands within the same subsystem and can also minimize typing. For example, the fol-
lowing string:
TRIG:SOUR EXT; COUNT 10
... is equivalent to the following two commands:
TRIG:SOUR EXT
TRIG:COUNT 10
Use a semicolon and colon ( ;: ) to link commands from different subsystems. For example, in the following com-
mand string, an error is generated if you do not use both the semicolon and colon:
DISP:TEXT:CLE;:SOUR:CURR MIN
Keysight DAQ970A/DAQ973A Programming Guide 17
1 Remote Operation

Querying parameter settings
You can query the current value of most parameters by adding a question mark ( ? ) to the command. The following
example sets the trigger count to 10 measurements:
TRIG:COUN 10
You can then query the count value by executing:
TRIG:COUN?
You can also query the minimum or maximum count allowed as follows:
TRIG:COUN? MIN
TRIG:COUN? MAX
Using the MIN, MAX, and DEFparameters
For many commands, you can substitute "MIN" or "MAX" in place of a parameter. In some cases you may also sub-
stitute "DEF". For example,
VOLTage:DC:RANGe {<range>|MIN|MAX|DEF}
Instead of selecting a specific value for the <range> parameter, you can substitute MIN to set the range to its min-
imum value, MAX to set the range to its maximum value, or DEF to set the range to its default value.
SCPI command terminators
A command string sent to the instrument must terminate with a <new line> (<NL>) character. The IEEE-488 EOI
(End-Or-Identify) message is interpreted as a <NL> character and can be used to terminate a command string in
place of a <NL> character. A <carriage return> followed by a <NL> is also accepted. Command string termination
will always reset the current command path to the root level.
For every message that includes a query and is sent to the instrument , the instrument terminates the
returned response with a <NL> or line-feed character (EOI). For example, if *IDN? is sent, the response is
terminated with a <NL> after the block of data that is returned. If a message includes multiple queries
separated by semicolons (for example "*ESR?;*IDN?"), the returned response is again terminated by a <NL>
after the response to the last query. In either case, the program must read this <NL> in the response before
another command is sent to the instrument, or an error will occur.
18 Keysight DAQ970A/DAQ973A Programming Guide
1 Remote Operation

IEEE-488.2 common commands
The IEEE-488.2 standard defines a set of common standards that perform functions such as reset, self-test, and
status operations. Common commands always begin with an asterisk ( * ), three characters in length, and may
include one or more parameters. The common keyword is separated from the first parameter by a blank space.
Use a semicolon ( ; ) to separate multiple commands as shown below:
*RST; *CLS; *ESE 32; *OPC?
Channel list parameter
A channel list always starts with "@" and is enclosed in parentheses, shown as "@<ch_list>" throughout this doc-
ument.
You can use the channel list parameter to address one or more channels, example:
(@301) - channel 01 on the module in slot 3.
(@301:302) - channels 01 and 02 on the module in slot 3.
Or list a range of channels, example:
(@101,201:202,302) - channel 01 on the module in slot 1, channels 01 and 02 on the module in slot 2, and channel
02 on the module in slot 3.
A maximum of three channels may be specified through a combination of single channel and ranges. Query results
are channel list order-sensitive. Results are returned in the order they are specified in the list.
If you omit the optional @<ch_list> parameter, the command applies to the currently defined scan list.
When adding a channel list parameter to a query, you must include a space character between the query
indicator ( ? ) and the channel list parameter, example: CALC:MATH? (@401). Otherwise error "–103 Invalid
separator" will occur as listed in Command Errors list.
Keysight DAQ970A/DAQ973A Programming Guide 19
1 Remote Operation

SCPIparameter types
The SCPI language defines several data formats to be used in program messages and response messages.
Numeric parameters
Commands that require numeric parameters accept all commonly used decimal representations of numbers includ-
ing optional signs, decimal points, and scientific notation. Special values for numeric parameters such as MIN, MAX,
and DEF are also accepted. You can also send engineering unit suffixes with numeric parameters (e.g., M, k, m, or
µ). If a command accepts only certain specific values, the instrument rounds the input numeric parameters to the
accepted values. The following command requires a numeric parameter for the range value:
VOLTage:DC:RANGe {<range>|MIN|MAX|DEF}
As the SCPI parser is case-insensitive, there is some confusion over the letter "M" (or "m"). For your
convenience, the instrument interprets "mV" (or "MV") as millivolts, but "MHZ" (or "mhz") as megahertz.
Likewise "MΩ" (or "mΩ") is interpreted as megaohm. You can use the prefix "MA" for mega. For example,
"MAV" is interpreted as megavolts.
Discrete parameters
Discrete parameters are used to program settings that have a limited number of values (like IMMediate, EXTernal, or
BUS). They have a short form and a long form just like command keywords. You can mix upper- and lower-case let-
ters. Query responses always return the short form in all upper-case letters. The following example requires a dis-
crete parameters for the temperature units:
UNIT:TEMPerature {C|F|K}
Boolean parameters
Boolean parameters represent a single binary condition that is either true or false. For a false condition, the instru-
ment accepts "OFF" or "0". For a true condition, the instrument accepts "ON" or "1". When you query a Boolean set-
ting, the instrument returns "0" or "1". The following example requires a Boolean parameter:
DISPlay:STATe {OFF|ON}
ASCII string parameters
String parameters can contain virtually any set of ASCII characters. A string must begin and end with matching
quotes; either with a single quote or a double quote. You can include the quote delimiter as part of the string by typ-
ing it twice without any characters in between. The following command uses a string parameter:
DISP:TEXT "<string>"
The following example displays the message "WAITING..." on the instrument's front panel (the quotes are not dis-
played).
DISP:TEXT "WAITING..."
You can also display the same message with single quotes.
20 Keysight DAQ970A/DAQ973A Programming Guide
1 Remote Operation