background image

 

 

CALCulate  Commands 

 

Copyright © Itech Electronic Co., Ltd. 

65

 

Query Syntax 

INTegral:STOP:TINTerval? 

INTegral:CONDition? 

This command is used to obtain the integral running state. 

Command Syntax 

INTegral:CONDition? 

Returned value 

Ready|Start|Stop|Time up|Error 

Query Syntax 

INTegral:CONDition? 

[:CALCulate][:METer]:MAXHold[:STATe] <bool> 

This command is used to set the hold mode of maximum value. 

Command Syntax 

CALCulate:METer:MAXHold <bool> 

Parameters 

0|1|OFF|ON 

Query Syntax 

CALCulate:METer:MAXHold? 

[:CALCulate][:METer]:CLEar[:IMMediate] 

This command is used to clear measuring value to zero. 

Command Syntax 

CALCulate:METer:CLEar:IMMediate 

Parameters 

None 

Query Syntax 

None 

[:CALCulate]:HARMonic[:STATe] <bool> 

This command is used to set the harmonic state. 

Command Syntax 

CALCulate:HARMonic <bool> 

Summary of Contents for IT9120 Series

Page 1: ...Power meter IT9120 Series Programming Guide Model IT9121 IT9121H IT9121C IT9121E Version V3 3...

Page 2: ...overing the materials in this document that conflict with these terms the warranty terms in the separate agreement shall prevail Technology Licenses The hardware and or software described herein are f...

Page 3: ...duties and other taxes shall be on the account of customer Limitation of Warranty This Warranty will be rendered invalid if the product is Damaged resulting from customer wired circuits or customer s...

Page 4: ...terminal Do not use the instrument if the detachable cover is removed or loosen Do not connect the instrument to any cable or terminal block before self testing To prevent the possibility of accident...

Page 5: ...normal use The expected useful life of the product is 10 years The product can be used safely during the 10 year Environment Friendly Use Period EFUP Upon expiration of the EFUP the product must be i...

Page 6: ...1000 4 2 2008 EN 61000 4 2 2009 IEC 61000 4 3 2006 A1 2007 A2 2010 EN 61000 4 3 2006 A1 2008 A2 2010 IEC 61000 4 4 2004 A1 2010 EN 61000 4 4 2004 A1 2010 IEC 61000 4 5 2005 EN 61000 4 5 2006 IEC 61000...

Page 7: ...tion EVENt 11 STATus OPERation CONDition 11 STATus OPERation ENABle 11 STATus OPERation NTRansition 12 STATus OPERation PTRansition 12 Chapter3 Current Measurement Commands 14 FETCh 14 FETCh SCALar CU...

Page 8: ...uency Measurement Commands 28 FETCh SCALar FREQuency VOLTage 28 MEASure SCALar FREQuency VOLTage 28 FETCh SCALar FREQuency CURRent 28 MEASure SCALar FREQuency CURRent 28 FETCh SCALar FREQuency SSOurce...

Page 9: ...CTive THDistort 40 FETCh SCALar HARMonics POWer APParent 40 MEASure SCALar HARMonics POWer APParent 40 FETCh SCALar HARMonics POWer REACtive 41 MEASure SCALar HARMonics POWer REACtive 41 FETCh SCALar...

Page 10: ...arge BOUGht 60 INPut INRush STATe OFF ON 60 INPut INRush TRIGger CURRent LEVel n 60 INPut INRush DELay TIME n 61 INPut INRush MEASure TIME n 61 Chapter13 CALCulate Commands 62 CALCulate INTegral STATe...

Page 11: ...CALibrate SECure STATe 71 CALibrate INITial 71 CALibrate SAVe 72 CALibrate CURRent POINt 72 CALibrate CURRent EXTernal POINt point 73 CALibrate CURRent EXTernal LEVel NRf 73 CALibrate VOLTage POINt 7...

Page 12: ...r part command tree Multiple commands in a message Several SCPI commands can be merged and sent as a single message with one information terminator Two aspects shall be considered when sending several...

Page 13: ...age unit and separate it by a semicolon separator of message unit Common commands will not influence the head path you can insert them into any place of the message VOLTage TRIGgered 17 5 INITialize T...

Page 14: ...example the parameter in the angle bracket is frequency in the above syntax statements Angle brackets are not sent along with command strings You must assign a value such as FREQ CENT 1000 to the par...

Page 15: ...ngs sent to the instrument must end with a Newline NL character IEEE 488 EOI End or Identify information can be used as NL character to replace termination command string of NL character It is accepta...

Page 16: ...ASCII character sets Character strings must start and end with paired quotation marks and single quotation marks or double quotation marks are both allowed Quotation mark separators may also act as on...

Page 17: ...ay be incorrect The interface cable must be connected to the correct serial port on your computer COM1 COM2 etc Communication setting Before communication operation please make sure that the following...

Page 18: ...equipment Internet or enterprise Intranet IP address refers to four 32 bit values within 0 255 which are separated by decimal points such as 192 168 111 24 Please ask the network administrator to pro...

Page 19: ...Always set to 0 2 QYE Query Error Set to 1 if the output queue is empty or if the data is missing even after a query has been sent 3 DDE Device Error Set to 1 when execution of the command is not poss...

Page 20: ...ENABle STATus QUEStionable CONDition This command is used to read the value of query condition register to get the power meter s status such as OCPeak OCRMS OV OP OT Query syntax STATus QUEStionable...

Page 21: ...1 to 0 transition of the corresponding bit of the Questionable Condition register causes that bit in the Questionable Event register to be set Command syntax STATus QUEStionable NTRansition NR1 Parame...

Page 22: ...and STATus OPERation ENABle The bit configuration of the Operation status registers is as follows Bit 2 Ranging Bit 3 ITG Integrate Busy Bit 4 ITM Integrate Timer Busy Bit 5 Waiting for trigger STATus...

Page 23: ...ation event register which will cause the operation summary bit OPER of the status register to be 1 Command syntax STATus OPERation NTRansition NR1 Parameters 0 65535 Example STATus OPERation NTRansit...

Page 24: ...Status Register Commands Copyright Itech Electronic Co Ltd 13 Example STATus OPERation PTRansition 128...

Page 25: ...PParent POWER_PF POWER_Phase FREQ_SSOurce Please refer to IT9120 User Manual for the detailed instructions of the parameters Command syntax FETCh Returned value NR2 NR2 NR2 FETCh SCALar CURRent AC Thi...

Page 26: ...d is used to read the latest pre processing average current It will not affect the device setting values and will not trigger a new measurement operation It only requires to get the latest available v...

Page 27: ...will not trigger a new measurement operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar CURRent RMN Returned value NR2 MEASure SCALar CURRent...

Page 28: ...will not trigger a new measurement operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar CURRent INRush Returned value NR2 MEASure SCALar CUR...

Page 29: ...operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar CURRent MINPk Returned value NR2 MEASure SCALar CURRent MINPk This command will trigger...

Page 30: ...mands Copyright Itech Electronic Co Ltd 19 MEASure SCALar CURRent PPEak This command will trigger the measurement operation to get a real time peak peak current Command Syntax MEASure SCALar CURRent P...

Page 31: ...C This command will trigger the measurement operation to get a real time AC voltage Command Syntax MEASure SCALar VOLTage AC Returned value NR2 FETCh SCALar VOLTage DC This command is used to read the...

Page 32: ...CALar VOLTage RMS Returned value NR2 FETCh SCALar VOLTage RMN This command is used to read the latest pre processing voltage rectified mean value It will not affect the device setting values and will...

Page 33: ...t pre processing voltage crest factor It will not affect the device setting values and will not trigger a new measurement operation It only requires to get the latest available value that has been mea...

Page 34: ...not trigger a new measurement operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar VOLTage MINPk Returned value NR2 MEASure SCALar VOLTage MI...

Page 35: ...right Itech Electronic Co Ltd 24 Returned value NR2 MEASure SCALar VOLTage PPEak This command will trigger the measurement operation to get a real time peak peak voltage Command Syntax MEASure SCALar...

Page 36: ...is command will trigger the measurement operation to get a real time active power Command Syntax MEASure SCALar POWer ACTive Returned value NR2 FETCh SCALar POWer APParent This command is used to read...

Page 37: ...ASure SCALar POWer REACtive Returned value NR2 FETCh SCALar POWer PFACtor This command is used to read the latest pre processing power factor It will not affect the device setting values and will not...

Page 38: ...to get the latest available value that has been measured Command Syntax FETCh SCALar POWer PHASe Returned value NR2 MEASure SCALar POWer PHASe This command will trigger the measurement operation to g...

Page 39: ...VOLTage This command will trigger the measurement operation to get a real time voltage frequency Command Syntax MEASure SCALar FREQuency VOLTage Returned value NR2 FETCh SCALar FREQuency CURRent This...

Page 40: ...ect the device setting values and will not trigger a new measurement operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar FREQuency SSOurce R...

Page 41: ...surement operation to get a real time sum of positive watt hour and negative watt hour Command Syntax MEASure SCALar ENERgy ACTive SUM Returned value NR2 FETCh SCALar ENERgy ACTive POSitive This comma...

Page 42: ...al time negative watt hour Command Syntax MEASure SCALar ENERgy ACTive NEGative Returned value NR2 FETCh SCALar ENERgy CHARge SUM This command is used to read the latest pre processing sum of positive...

Page 43: ...ge POSitive Returned value NR2 FETCh SCALar ENERgy CHARge NEGative This command is used to read the latest pre processing negative ampere hour It will not affect the device setting values and will not...

Page 44: ...2 FETCh SCALar ENERgy ACTive AVERage This command is used to read the latest pre processing active power integral value It will not affect the device setting values and will not trigger a new measurem...

Page 45: ...onics CURRent AMPLitude Parameters FUNDamental TOTal ALL NR1 Returned value NRf MEASure SCALar HARMonics CURRent AMPLitude This command will trigger the measurement operation to get a real time curren...

Page 46: ...t only requires to get the latest available value that has been measured Command Syntax FETCh SCALar HARMonics CURRent THARmonic Returned value NR2 MEASure SCALar HARMonics CURRent THARmonic This comm...

Page 47: ...It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar HARMonics VOLTage AMPLitude Parameters FUNDamental TOTal ALL NR1 Returned value NRf MEASure SCALa...

Page 48: ...values and will not trigger a new measurement operation It only requires to get the latest available value that has been measured Command Syntax FETCh SCALar HARMonics VOLTage THARmonic Returned value...

Page 49: ...it ude This command is used to read the latest pre processing power harmonics It will not affect the device setting values and will not trigger a new measurement operation It only requires to get the...

Page 50: ...he measurement operation to get a real time power fundamental harmonic Command Syntax MEAS SCALar HARMonics POWer ACTive FUNDamental Returned value NR2 FETCh SCALar HARMonics POWer ACTive THARm onic T...

Page 51: ...Di stort This command will trigger the measurement operation to get a real time total harmonic distortion factor of power Command Syntax MEASure SCALar HARMonics POWer ACTive THDistort Returned value...

Page 52: ...nd Syntax FETCh SCALar HARMonics POWer REACtive Parameters NR1 0 50 Returned value NRf MEASure SCALar HARMonics POWer REACtive This command will trigger the measurement operation to get a real time re...

Page 53: ...cessing phase difference of K order harmonic voltage Uk and fundamental wave U1 It will not affect the device setting values and will not trigger a new measurement operation It only requires to get th...

Page 54: ...et a real time phase difference of K order harmonic voltage Uk and harmonic current Command Syntax MEASure SCALar HARMonics POWer PHASe UI Parameters NR1 0 50 Returned value NRf FETCh SCALar HARMonics...

Page 55: ...Harmonic Measurement Commands Copyright Itech Electronic Co Ltd 44 Command Syntax MEASure SCALar HARMonics POWer PHASe II Parameters NR1 0 50 Returned value NRf...

Page 56: ...SENSe AVERage TCONtrol name This command is used to set the linear averaging type Command Syntax AVERage TCONtrol name Parameters REPeat MOVing Query Syntax AVERage TCONtrol SENSe AVERage TYPE boolea...

Page 57: ...age auto range function Command Syntax VOLTage RANGe AUTO bool Parameters 0 1 OFF ON Query Syntax VOLTage RANGe AUTO SENSe CURRent RANGe NRf This command is used to set the current range Command Synta...

Page 58: ...30V 75V 150V 300V Auto IT9121E CF 3 15V 30V 60V 150V 300V 600V Auto CF 6 7 5V 15V 30V 75V 150V 300V Auto IT9121H CF 3 15V 30V 60V 150V 300V 600V 1000V CF 1 5 Auto CF 6 7 5V 15V 30V 75V 150V 300V 500V...

Page 59: ...ratio of the external current sensor 2 Command Syntax CURRent SRATio EXS2 NRf Parameters 0 001 9999 999 Query Syntax CURRent SRATio EXS2 SENSe CURRent EXS RANGe This command is used to set the curren...

Page 60: ...Commands Copyright Itech Electronic Co Ltd 49 CF 6 1 25V 2 5V 5V 25mV 50mV 100mV 250mV 0 5V 1V IT9121C CF 3 5V 10V 100mV 250mV 500mV 1V 2 5V CF 6 2 5V 5V 50mV 125mV 250mV 0 5V 1 25V Query Syntax CURR...

Page 61: ...state This command is used to enable or disable the state of continous measurement period In off mode that means to enable a single measurement Command Syntax INITiate CONTinuous state Parameters ON...

Page 62: ...trigger signal EXTernal External clock trigger mode VOLTage Set input voltage source as a trigger signal CURRent Set input current source as a trigger signal Command Syntax TRIGger SOURce state Parame...

Page 63: ...r VOLTage LEVel level Parameters level Query Syntax TRIGger VOLTage LEVel TRIGger CURRent LEVel level This command is used to set the current trigger level when Current selected as trigger source mode...

Page 64: ...mand is used to set trigger slope when takes waveform as trigger source Command Syntax WAVE TRIG SLOP POSitive NEGative ANY Parameters POSitive NEGative ANY Query Syntax WAVE TRIG SLOP WAVE TRIG MODE...

Page 65: ...set the time grid value of the waveform display Avaiable setting 0 0005 0 001 0 002 0 005 0 01 0 02 0 05 0 1 0 2 0 5 Command Syntax WAVE TRIG DIVTime UNIT S n Parameters n Unit S Query Syntax WAVE TRI...

Page 66: ...ATA NORMalization This command is used to obtain the voltage datas after normalization Command Syntax WAVE VOLTage DATA Parameters n Query Syntax WAVE VOLTage DATA WAVE CURRent DATA NORMalization This...

Page 67: ...Oscilloscope Commands Copyright Itech Electronic Co Ltd 56 Command Syntax WAVE TRIGger STATe Returned value Auto Auto Trig Trig Stop Query Syntax WAVE TRIGger STATe...

Page 68: ...ource which is used for determining the fundamental wave cycle as the reference for analysis of harmonic orders Command Syntax HARMonic PLLSource OFF U I Parameters OFF U I Query Syntax HARMonic PLLSo...

Page 69: ...t the synchronous source type Command Syntax SSOurce OFF U I Parameters OFF U I Query Syntax SSOurce INPut CFACtor NRI This command is used to set the crest factor Command Syntax CFACtor NRI Parameter...

Page 70: ...ata updating rate Command Syntax RATE NRI Parameters 0 1s 0 25s 0 5s 1s 2s 5s Query Syntax RATE INPut INTegral ACAL bool This command is used to enable or disable the auto calculation function of inte...

Page 71: ...ge SOLD DISCharge BOUGht Query Syntax INTegrate WPTYpe INPut INRush STATe OFF ON This command is used to enable or disable the inrush current measurement function Command Syntax INPut INRush STATe OFF...

Page 72: ...rrent measurement Max time is 0 0002s Command Syntax INPut INRush DELay TIME n Parameters n Unit S Query Syntax INRush DELay TIME INPut INRush MEASure TIME n This command is used to set the inrush cur...

Page 73: ...ax CALCulate INTegral CLEar Parameters None Query Syntax None CALCulate INTegral CLEar AUTO ON OFF This command is used to enable or disable the automatic zero clearing function Command Syntax INTegra...

Page 74: ...Parameters None Query Syntax None CALCulate INTegral STARt DATE yy MM dd CALCulate INTegral STARt TIME hh mm ss This command is used to set the start date when time reached device start integral opera...

Page 75: ...STOP DATE yy MM dd CALCulate INTegral STOP TIME hh mm ss This command is used to set the stop date when time reached device stops integral operation Command Syntax INTegral STOP DATE yy MM dd INTegral...

Page 76: ...CALCulate METer MAXHold STATe bool This command is used to set the hold mode of maximum value Command Syntax CALCulate METer MAXHold bool Parameters 0 1 OFF ON Query Syntax CALCulate METer MAXHold CA...

Page 77: ...STATe bool This command is used to enable or disable the oscilloscope function Command Syntax CALCulate SCOPe bool Parameters 0 1 OFF ON Query Syntax CALCulate SCOPe CALCulate HOLD STATe bool This co...

Page 78: ...one Query Syntax None SYSTem BEEPer STATe bool This command is used to turn on or turn off the beeper Command Syntax SYSTem BEEPer bool Parameters 0 1 OFF ON Query Syntax SYSTem BEEPer STATe SYSTem DA...

Page 79: ...Syntax SYSTem KEY Parameters None SYSTem ERRor This command is used to query the error information Command Syntax SYSTem ERRor Parameters None SYSTem LANGuage NRi This command is use to set the system...

Page 80: ...This command is used to clear the error information Command Syntax SYSTem CLEar Parameters None Returned value None SYSTem RWLock This command is used to set power meter to remote control mode via RS2...

Page 81: ...System Commands Copyright Itech Electronic Co Ltd 70 Command Syntax SYST VERS Parameters None Returned value NR2 Example 1991 0...

Page 82: ...n mode is being enabled and the existing password is not 0 If the password is not entered or is incorrect an error is generated and the calibration mode remains disabled The query statement returns on...

Page 83: ...is command can only be used in calibration mode It saves any new calibration constants after a current or voltage calibration procedure has been completed in nonvolatile memory Command Syntax CALibrat...

Page 84: ...and CAL STAT CAL SAV CALibrate CURRent EXTernal POINt point This command is used to calibrate external current points Command Syntax CALibrate CURRent EXTernal POINt point Parameters point CALibrate C...

Page 85: ...age value that you obtain by reading an external meter You must first select a calibration level with CALibrate VOLTage POINt for the value being entered These constants are not stored in nonvolatile...

Page 86: ...nd is used to edit the value of standard event enable register It defines the specified bits from standard event register that will cause the value of ESB bit in status byte register to be 1 Command S...

Page 87: ...ommand is used to query related information of power meter Query Syntax IDN Parameters None Returned value AARD Example ITECH IT9121 KN34243232 01 00 OPC After all other commands executed before OPC c...

Page 88: ...mmand power meter will return back a decimal value which is a binary weighted sum of all bits from the enable register Command Syntax SRE NRf Parameters 0 255 Power on value Refer to PSC command Examp...

Page 89: ...I This command instructs the power meter not to process any further commands until all pending operations are completed Pending operations are as defined under the OPC command WAI can be aborted only...

Page 90: ...Thank you for purchasing ITECH products If you have any doubt about this product please contact us as follow 1 Visit ITECH website www itechate com 2 Select the most convenient contact for further co...

Reviews: