Rigol DM3000 Series, Programming Manual

Page 1: ...Programming Guide RIGOL Publication Number PGC01107 1110 Apr 2009 DM3000 Series Digital Multimeter DM3061 2 3 4 DM3051 2 3 4 2008 RIGOL Technologies Inc All Rights Reserved...

Page 2: ......

Page 3: ...protected by patent laws in and outside of the P R China Information in this publication replaces all previous corresponding material RIGOL Technologies Inc reserves the right to modify or change part...

Page 4: ...r guide and been familiar with the RIGOL DM3000 series multimeter s operation The manual contains four chapters Chapter 1 Generalize the methods of using commands Chapter 2 Introduce the detailed comm...

Page 5: ...unction Commands 2 4 Measure Commands 2 9 Precision Commands 2 36 System Commands 2 44 Utility Commands 2 54 Trigger Commands 2 61 Calculate Commands 2 67 Datalog Commands 2 76 Scan Commands 2 83 Chap...

Page 6: ......

Page 7: ...tion This chapter provides the guidance for user to use a RIGOL DM3000 series digital multimeter for remote control programming correctly and to achieve a long distance measuring operation This chapte...

Page 8: ...de Setup a multimeter Measure Receive data equipment working condition or measurement results from a multimeter A computer can communicate with a multimeter by sending and receiving messages over an I...

Page 9: ...not need any program data the blank space is not needed 3 Interrogation A query is formed by adding an interrogation to the end of the commands The query commands usually include different data and b...

Page 10: ...ix effective digits behind decimal point For example setting NULL offset command calculate NULL offset the parameters meet the range of the real number Table 2 12 indicated 3 Discrete Parameters The p...

Page 11: ...and to change the commands type For the usage please see the follows Syntax CMDSET RIGOL AGILENT FULUKE CMDSET Function The command sets and queries command types The first command parameters include...

Page 12: ......

Page 13: ...command parameters and the returned values are ASCII characters All the commands do not distinguish the letter size RIGOL DM3000 series digital multimeter includes the following commands subsystems Co...

Page 14: ...L 2008 RIGOL Technologies Inc Programming Guide for DM3000 Series 2 2 Common Commands This commands are used to query equipment state and perform some basic operations The commands mainly include IDN...

Page 15: ...1 IDN Syntax IDN Function The command queries equipment ID and returns 35 characters at least Return Format The query returns a character string and it shows the equipment ID 2 RST Syntax RST Functio...

Page 16: ...and they equal to select the measure function buttons in DM3000 front panel The commands mainly include function function voltage DC ratio function voltage DC function voltage AC function current DC...

Page 17: ...RESISTANCE CAPACITANCE CONTINUITY FRESISTANCE DIODE FREQUENCY PERIOD RATIO 2 function voltage DC ratio Syntax function voltage DC ratio Function The command turns on DC voltage ratio measure function...

Page 18: ...Syntax function current DC Function The command turns on DC current measure function Remark In function this function is corresponding to the returned value DCI 6 function current AC Syntax function c...

Page 19: ...Remark In function this function is corresponding to the returned value FRESISTANCE 9 function frequency Syntax function frequency Function The command turns on frequency measure function Remark In fu...

Page 20: ...ding to the returned value CONTINUITY 12 function diode Syntax function diode Function The command turns on diode measure function Remark In function this function is corresponding to the returned val...

Page 21: ...hide measure voltage AC freq state measure current DC measure current DC measure current DC range measure current DC digit measure current AC measure current AC measure current AC range measure curren...

Page 22: ...pleted or not If complete returns ture or else false Return Format The query returns true or false 2 measure Syntax measure AUTO MANU Function The command sets measure mode as auto or manual Example T...

Page 23: ...at the same time The measure mode will be changed into manual when setting range Table 2 1 incdicates the parameters and the resolutions Table 2 1 The DC voltage range and the resolution Parameter DC...

Page 24: ...DC impedance measure voltage DC impedance 10M 10G Function The command queries and sets DC voltage impedance Explanations measure voltage DC impedance returns 10M or 10G 10G measure voltage DC impeda...

Page 25: ...decrease digit 5 the digit is 5 6 the digit is 6 7 the digit is 7 Return Format measure voltage DC digit returns the current digit 5 6 or 7 Examples To set the digit of the DC voltage as 7 measure vo...

Page 26: ...t value sets the digit of the ratio of the DC voltages in two circuits The Table 2 2 indicates the parameters and their meanings Remarks If the showing digit reachs 5 DEC command will be invalid If 7...

Page 27: ...lt range discrete 0 1 2 3 4 2 Explanations The Table 2 3 lists the parameters and the ranges Table 2 3 The range of AC voltage Parameter Range 0 200mV 1 2 0V 2 20 0V 3 200 0V 4 750 0V MIN 200mV MAX 75...

Page 28: ...ddle or fast and the default is fast Return Format measure voltage AC filter returns the current filter speed slow mid or fast Example To set the filter speed as middle measure voltage AC filter MID 1...

Page 29: ...frequency Remarks Before sending the command please turn on AC voltage measure function Return Format The query returns the current frequency in the form of 5 000000e 01 and unit is Hz for example 16...

Page 30: ...ys on the secondary screen in measuring AC voltage Return Format The query returns the current state display or hide 19 measure current DC Syntax measure current DC Function The command queries DC cur...

Page 31: ...tions Parameter Current Resolution 0 2mA 1 nA 1 20mA 10nA 2 200mA 100nA 3 1A 1 A 4 10A 10 A MIN 2mA 1 nA MAX 10A 10 A DEF 200mA 100nA Example To set the DC current range as 10 0A measure current DC MA...

Page 32: ...owing digit reachs 5 DEC command will be invalid If 7 INC invalid Return Format measure current DC digit returns the current digit 5 6 or 7 Example To set the digit as 6 measure current DC digit 6 23...

Page 33: ...2 5 indicates the parameters and their meanings Table 2 5 The AC current parameters and their meanings Parameter Range 0 20mA 1 200mA 2 2A 3 10A MIN 20mA MAX 10A DEF 200mA Example To set the AC curre...

Page 34: ...digit INC DEC 5 6 7 sets the digit of the AC current The Table 2 2 indicates the parameters and their meanings Remarks If the showing digit reachs 5 DEC command will be invalid If 7 INC invalid Return...

Page 35: ...nt AC freq hide Function The command hides AC current frequency on the secondary screen Remark Please turn on AC current measure function before sending command 30 measure current AC freq state Syntax...

Page 36: ...stance range MIN MAX DEF Function The command sets the measure range of two circuits resistance Parameters Name Type Range Default range discrete 0 1 2 3 4 5 6 3 Explanations The table 2 6 indicates t...

Page 37: ...ure resistance digit INC DEC 5 6 7 Function The command queries and sets the digit of two circuits resistance Explanations measure resistance digit queries the digit of the two circuits resistance mea...

Page 38: ...mand sets the measure range of four circuits resistance Parameters Name Type Range Default range discrete 0 1 2 3 4 5 6 3 Explanation The Table 2 6 indicates the parameters and their meanings Example...

Page 39: ...fresistance digit INC DEC 5 6 7 sets the digit of the four circuits resistance Remarks If the showing digit reachs 5 DEC command will be invalid If 7 INC invalid Return Format measure fresistance digi...

Page 40: ...anations The frequency range is 3Hz 300kHz The Table 2 3 indicates the parameters and the ranges Example To set the voltage range as 20V measure frequency DEF 41 measure frequency range Syntax measure...

Page 41: ...digit INC DEC 5 6 7 sets the digit of the frequency The Table 2 2 indicates the meanings of the digit Remarks If the showing digit reachs 5 DEC command will be invalid If 7 INC invalid Return Format...

Page 42: ...ample To set the input voltage range as 20V measure period DEF or measure period 2 45 measure period range Syntax measure period range Function The command queries AC voltage range in measuring period...

Page 43: ...invalid If 7 INC invalid Return Format measure period digit returns the current digit 5 6 or 7 Example To set the digit as 6 measure period digit 6 47 measure continuity Syntax measure continuity Func...

Page 44: ...x measure diode Function The command queries diode voltage at both ends Remarks In measuring diode the beep condition is 0 1V Vmeasured 2 4 V Return Format The query returns the current diode voltage...

Page 45: ...e digit 6 51 measure capacitance Syntax measure capacitance Function The command queries capacitance Return Format The query returns the current capacitance in the form of 8 889030e 05 and unit is F f...

Page 46: ...ce range as 2uF measure capacitance 3 53 measure capacitance range Syntax measure capacitance range Function The command queries the measure range of capacitance Return Format The query returns the cu...

Page 47: ...35 measure capacitance digit queries the digit of the capacitance measure capacitance digit INC DEC 5 6 7 sets the digit of the capacitance The Table 2 2 indicates the parameters and their meanings Re...

Page 48: ...mmands The commands are used to set the measure precision for a multimeter The commands mainly includes resolution voltage DC resolution voltage DC ratio resolution voltage AC resolution current DC re...

Page 49: ...age Before sending the command please turn on DC voltage measure function resolution voltage DC range MIN MAX DEF sets the measure precision of the DC voltage The Table 2 8 indicates the parameters an...

Page 50: ...se turn on DC voltage ratio measure function resolution voltage DC ratio range MIN MAX DEF sets the measure precision of the DC voltage ratio The Table 2 8 indicates the parameters and their meanings...

Page 51: ...ir meanings Parameter Meaning 0 3 digit measure precision 1 4 digit 2 5 digit MAX 5 digit MIN 3 digit DEF 4 digit Return Format resolution voltage AC returns the current parameter 0 1 or 2 see Table 2...

Page 52: ...nt AC Syntax resolution current AC resolution current AC range MIN MAX DEF Function The command queries and sets the measure precision of AC current Parameters Name Type Range Default range discrete 0...

Page 53: ...Before sending the command please turn on two circuit resistance measure function resolution resistance range MIN MAX DEF sets the measure precision of the two circuits resistance The Table 2 8 indic...

Page 54: ...solution fresistance returns the current parameter 0 1 or 2 see Table 2 8 Example To set the measure precision of the four circuit resistance as 5 resolution fresistance 1 8 resolution capacitance Syn...

Page 55: ...ologies Inc Programming Guide for DM3000 Series 2 43 Return Format resolution capacitance returns the current parameter 0 1 or 2 see Table 2 8 Example To set the capacitance measure precision as 5 res...

Page 56: ...ds mainly include system beeper system beeper state system configure poweron system configure default system language system clock state system clock date system clock time system format decimal syste...

Page 57: ...em beeper state value Function The command queries and sets the beeper state Parameters Name Type Range Default value Boolean ON OFF ON Explanations system beeper state queries whether the beeper is o...

Page 58: ...The command is used to set the system parameters as the last setting or the system default when powering on LAST means to read the last setting and DEFAULT means the system default 4 system configure...

Page 59: ...rent system language CHINESE or ENGLISH 6 system clock state Syntax system clock state system clock state value Function The command queries and sets the display state of system clock Parameters Name...

Page 60: ...em clock date returns the current system date in the form of xxxx xx xx 8 system clock time Syntax system clock time system clock time value Function The command queries and sets system time Parameter...

Page 61: ...nged into Remarks As it is easier to change the format of data separator by using this commond so please do it carefully Return Format system format decimal returns the current radix point format COMM...

Page 62: ...arameters Name Type Range Default value Consecutive Integer 0 255 168 Explanations system display bright queries the display brightness system display bright value sets the display brightness The brig...

Page 63: ...tem display contrast returns the current display contrast and the range is 0 255 13 system display invert Syntax system display invert Function The command inverts the display color Explanation To inv...

Page 64: ...orm of XX XX XX XX XX XX For example 00 01 02 03 04 05 16 system lanserial Syntax system lanserial Function The command queries the module state of interface Explanation To query the interface module...

Page 65: ...RIGOL 2008 RIGOL Technologies Inc Programming Guide for DM3000 Series 2 53 To query the number of start up Return Format The query returns the current number of start up...

Page 66: ...that communication interface has been connected stably otherwise it possiblely to be abnormal or wrong The commands mainly include utility interface LAN dhcp utility interface LAN host utility interfa...

Page 67: ...nterface LAN dhcp value sets the DHCP state ON denotes DHCP is on and OFF denotes DHCP is off Return Format utility interface LAN dhcp returns the current DHCP state ON or OFF 2 utility interface LAN...

Page 68: ...acter string self definition RIGOL Explanations utility interface LAN domain queries the equipment domain name utility interface LAN domain value sets the equipment domain name The parameter is the us...

Page 69: ...ace LAN mask value Function The command queries and sets IP mask for LAN connection Parameters Name Type Range Default value character string self definition 255 255 255 0 Explanations utility interfa...

Page 70: ...way 7 utility interface LAN dns Syntax utility interface LAN dns utility interface LAN dns value Function The command queries and sets DNS address for LAN connection Parameters Name Type Range Default...

Page 71: ...urns the current GPIB address 9 utility interface RS232 baud Syntax utility interface RS232 baud utility interface RS232 baud value Function The command queries and sets communication baud rate of ser...

Page 72: ...rameters Name Type Range Default value discrete none8bits odd7bits even7bits none8bits Explanations utility interface RS232 parity queries the RS232 parity bit utility interface RS232 parity value set...

Page 73: ...Series 2 61 Trigger Commands The commands are used to set the tigger system parameters The commands mainly include trigger source trigger auto interval trigger auto hold trigger single triggered trig...

Page 74: ...trigger auto interval Syntax trigger auto interval trigger auto interval value Function The command queries and sets display interval Parameters Name Tyoe Range Default value consecutive integer 4 30...

Page 75: ...sets auto trigger delay state Parameters Name Type Range Default value Boolean ON OFF OFF Return Format trigger auto hold returns the current auto trigger delay state ON means the delay is on and OFF...

Page 76: ...e Table 2 10 5 trigger single Syntax trigger single trigger single value Function The command queries and sets sampling times in single trigger Parameters Name Type Range Default value consecutive int...

Page 77: ...ude RISE FALL HIGH LOW and respectively means rise edge trigger fall edge trigger high level trigger and low level trigger Return Format trigger ext returns the current trigger mode 8 trigger vmcomple...

Page 78: ...ms Explanations trigger vmcomplete pulsewidth queries the VMC output pulsewidth trigger vmcomplete pulsewidth value sets the VMC output pulsewidth The range of value the resolution is 4 1 30ms and the...

Page 79: ...o set the calculate system parameters for instrument The commands mainly include calculate function calculate statistic min calculate statistic max calculate statistic average calculate statistic coun...

Page 80: ...ing off math calculation calculate function value sets the math calculation function The Table 2 11 indicates the math calculation parameters and their meanings Table 2 11 The math calculation paramet...

Page 81: ...tic max Syntax calculate statistic max Function The command queries statistic maximum Remark When MAX calculation is available the command is just available Return Format The query returns the current...

Page 82: ...alculate NULL offset value Function The command queries and sets NULL calculation offset Parameters Name Type Range Default value consecutive real number range MIN MAX DEF Explanations calculate NULL...

Page 83: ...F frequency 3 6e 05 0 HZ Return Format calculate NULL offset returns the current NULL calculation offset 7 calculate DB Syntax calculate DB Function The command queries dB value Return Format The que...

Page 84: ...culate DBM Function The command queries dBm value Return Format The query returns the current dBm value 10 calculate DBM reference Syntax calculate DBM reference calculate DBM reference value Function...

Page 85: ...at The query returns whether the limit calculation have passed pass or fail 12 calculate limit lower Syntax calculate limit lower calculate limit lower value Function The command queries and sets lowe...

Page 86: ...120 120 0 Return Format calculate limit lower returns the current lower value 13 calculate limit upper Syntax calculate limit upper calculate limit upper value Function The command queries and sets up...

Page 87: ...RIGOL 2008 RIGOL Technologies Inc Programming Guide for DM3000 Series 2 75 Return Format calculate limit upper returns the current upper value...

Page 88: ...nction datalog configure startmode datalog configure startmode auto datalog configure startmode extern datalog configure startmode delaytime datalog configure stopmode datalog configure stopmode time...

Page 89: ...and queries and sets the datalog function Explanations configure function queries the current datalog function configure function DCV DCI 2WR 4WR range sets the datalog function The first parameter in...

Page 90: ...onfigure startmode auto Function The command sets the datalog startmode as auto Explanation If you have set the delay time the datalog system starts automatically when the delay time is reached If not...

Page 91: ...will set the default unit is s The range of the value is 0 3600s Return Format datalog configure startmode delaytime returns the delay time in auto startmode and the default unit is s 7 datalog config...

Page 92: ...the time every datalog function lasts for 9 datalog configure stopmode number Syntax datalog configure stopmode number datalog configure stopmode number value Function The commad queries and sets the...

Page 93: ...s 10K s 50K s Return Format datalog configure rate returns the range of the current sample rate 1 13 11 datalog run Syntax datalog run Function The command runs the datalog function according to the...

Page 94: ...alue is the serial number of the data packet the range is 1 4096 Every datalog starts storaging from the first packet The sencondary developmant of the PC programm needs RIGOL drive programm and dynam...

Page 95: ...mainly include scan create scan addtask scan deletetask scan intervaltime scan run scan run cycle scan stop scan list task scan list project scan current cycle scan current projname scan fetchdata sca...

Page 96: ...project Explanations scan addtask value adds a scan task the value are the new task s parameters including task number channel function precision sampling number and delay time Their parameter ranges...

Page 97: ...ters can be 0 1 2 3 or 4 When PERI measurement range parameters can be 0 1 2 3 or 4 When CAP measurement range parameters can be 0 1 2 3 4 or 5 3Note ultimeter respectively shows the range as 4 5 6 fo...

Page 98: ...circulates the current project one time 6 scan run cycle Syntax scan run cycle value Function The command sets the project cycle number and runs the current project Explanations scan run cycle value s...

Page 99: ...ecision sampling number and function 9 scan list project Syntax scan list project Function The command returns the table of all the project names in DM3000 local storage 10 scan current cycle Syntax s...

Page 100: ...saves the setting project Explanation scan saveproj value saves the setting project in DM3000 local The value is the number of the file location DM3000 can save up to 10 projects if exceeded and retur...

Page 101: ...leteproj value deletes the set project the value is the number of the file location 16 scan cardID Syntax scan cardID Function The command queries the hardware version of scan card Return Format scan...

Page 102: ......

Page 103: ...ultimeter s some remote control commands If users have been familiar with Agilent and Fluke s commands you can operate RIGOL DM3000 conveniently This chapter lists Agilent and Fluke s some commands th...

Page 104: ...mands to send CMDSET command that is CMDSET AGILENT For the details please refer to the Commands Introduction in page 1 5 Agilent SCPI Commands CALCulate AVERage AVERage CLEar COUNt MAXimum MINimum PT...

Page 105: ...e VOLTage AC DC CAPacitance NULL STATe STATe VALue VALue RANGe AUTO AUTO UPPer UPPer CURRent AC BANDwidth BANDwidth NULL STATe STATe VALue VALue PEAK STATe STATe RANGe AUTO AUTO UPPer UPPer DC APERtur...

Page 106: ...COPY DATA DELete LAST POINts REMove FETCh CURRent AC PTPeak DC PEAK MAXimum MINmum PTPeak VOLTage AC PTPeak DC PEAK MAXimum MINmum PTPeak FREQuency APERture APERture NULL STATe STATe VALue VALue RANG...

Page 107: ...lution RESolution FUNCtion ON ON IDN MEASure CAPacitance CONTinuity CURRent AC DC DIODe FREQuency FRESistance PERiod RESistance VOLTage AC DC MEMory NSTates STATe CATalog DELete DELete ALL NAME NAME R...

Page 108: ...Tage RANGe AUTO AUTO UPPer UPPer RCL RST RESistance APERture APERture NPLC NPLC NULL STATe STATe VALue VALue RANGe AUTO AUTO UPPer UPPer RESolution RESolution SAV SAMPle SOURce SOURce TIMer TIMer SENS...

Page 109: ...uE PEAK STATe STATe RANGe AUTO AUTO UPPer UPPer DC APERture APERture APERture ENABled NPLC NPLC NULL STATe STATe VALue VALuE PEAK STATe STATe RANGe AUTO AUTO UPPer UPPer RESolution RESolution ZERO AUT...

Page 110: ...PERture APERture ENABled NPLC NPLC NULL STATe STATe VALue VALue OCOMpensated OCOMpensated RANGe AUTO AUTO UPPer UPPer RESolution FUNCtion RESolution ON PERiod ON APERture APERture NULL STATe STATe VAL...

Page 111: ...e VALue OCOMpensated OCOMpensated RANGe AUTO AUTO UPPer UPPer RESolution RESolution ZERO AUTO VOLTage AUTO AC BANDwidth BANDwidth NULL STATe STATe VALue VALue PEAK STATe STATe RANGe AUTO AUTO UPPer UP...

Page 112: ...TO UPPer UPPer RESolution RESolution SYStem BEEPer ZERO AUTO AUTO COMMunicate STATe STATe ENABle ENABle GPIB SELF ADDRess ADDRess LAN BSTatus CONTrol DDNS DDNS DHCP DHCP DNS DNS DOMain DOMain GATEway...

Page 113: ...t DELay DELay DELay SLOPe AUTO SLOPe AUTO SOURce SOURce VOLTage AC BANDwidth BANDwidth NULL STATe STATe VALue VALue PEAK STATe STATe RANGe AUTO AUTO DC UPPer UPPer APERture APERture IMPedance AUTO AUT...

Page 114: ...RIGOL 2008 RIGOL Technologies Inc Programming Guide for DM3000 Series 3 12 UPPer RESolution RESolution...

Page 115: ...L DM3000 series digital multimeter Before using the commands to send CMDSET command that is CMDSET FLUKE For the detailsl please refer to the Commands Introduction in page 1 5 Fluke Commands AAC ADC A...

Page 116: ...RIGOL 2008 RIGOL Technologies Inc Programming Guide for DM3000 Series 3 14 MEAS2 MIN MINSET MMCLR MOD OHMS RANGE RANGE1 RATE RATE REL RELCLR RELSET RELSET VAC VAL VAL1 VAL2 VDC...

Page 117: ...o the commands In order to explain easily the serial number before every command is used to mark current command but not be the content of command The contents between and after every command are expl...

Page 118: ...beeping the beeper must be on The programming steps 0 RST reset 1 IDN query equipment ID 2 function voltage AC turn on AC voltage measure function 3 measure AUTO set measure methode as auto 4 calcula...

Page 119: ...AVERAGE calculation function 6 calculate statistic average query the average resistance 7 note the resistance value 3 302198e 01 8 calculate function NULL turn on NULL calculation function 9 calculate...

Page 120: ...turn on 2WR measure function 3 measure AUTO set resistance measurement as auto 4 measure resistance query the resistance measure the reference resistance for dBm calculation 5 function voltage AC turn...

Page 121: ...nfigure stopmode number 2 80 datalog configure rate 2 80 datalog run 2 81 datalog stop 2 81 datalog fetchdata 2 81 F function 2 5 function voltage DC ratio 2 5 function voltage DC 2 5 function voltage...

Page 122: ...diode 2 32 measure diode digit 2 32 measure capacitance 2 33 measure capacitance 2 33 measure capacitance range 2 34 measure capacitance digit 2 34 R resolution voltage DC 2 37 resolution voltage DC...

Page 123: ...trigger single triggered 2 64 trigger ext 2 65 trigger vmcomplete polar 2 65 trigger vmcomplete pulsewidth 2 66 U utility interface LAN dhcp 2 55 utility interface LAN host 2 55 utility interface LAN...