CPS2000
True-Average Connected Power Sensors
PROGRAMMING REFERNCE
MANUAL
P/N: 98408300A
Rev. 20180720
Страница 1: ...CPS2000 True Average Connected Power Sensors PROGRAMMING REFERNCE MANUAL P N 98408300A Rev 20180720 ...
Страница 2: ...tus 13 3 4 Standard Event Status 14 3 4 1 Standard Event Status Register 14 3 4 2 Standard Event Status Enable Register 15 3 5 Status Byte 15 3 5 1 Service Request Enable Register 16 3 6 Error Codes 16 4 SCPI Conformance Information 18 5 Measurement Sequence 19 5 1 Single Measurement Mode 19 5 2 Continuous Measurement Mode 20 5 3 Power Measurements 21 5 3 1 Power Measurement Filtering 21 5 3 2 Pow...
Страница 3: ...set MAGNitude 36 SENSe CORRection OFFset MAGNitude 36 SENSe FILTer STATe 37 SENSe FILTer STATe 37 SENSe FILTer TIMe 38 SENSe FILTer TIMe 38 SENSe FREQuency 39 SENSe FREQuency 39 7 4 Status Subsystem STATus Commands 40 STATus OPERation EVENt 40 STATus OPERation CONDition 40 STATus OPERation ENABle 41 STATus OPERation ENABle 41 STATus QUEStionable EVENt 42 STATus QUEStionable CONDition 42 STATus QUE...
Страница 4: ...te NETwork GATeway 49 SYSTem VERSion 49 SYSTem INFO 50 SYSTem INFO EXTended 50 7 6 Trigger Subsystem TRIGger Commands 51 TRIGger SOURce 51 TRIGger SOURce 51 TRIGger IMMediate 52 INITiate IMMediate 52 INITiate CONTinuous 53 INITiate CONTinuous 53 ABORt53 7 7 Unit Subsystem UNIT Commands 54 UNIT POWer 54 UNIT POWer 54 8 Revision Notes 55 TABLE OF CONTENTS Page 4 ...
Страница 5: ...ion may be repeated in this document for clarification purposes 1 2 Referenced Documents Ref Title Identification Revision Source 1 Standard Commands for Programmable Instruments SCPI 1999 0 1999 SCPI Consortium 2 ANSI IEEE Standard 488 2 1987 488 2 1987 The Institute of Electrical and Electronics Engineers Inc 1 3 Definitions Term Abbreviation Definition SCPI Standard Commands for Programmable In...
Страница 6: ...alues Boolean values enumerations and strings Within this document expected data types are specified along with each command s specification For more information on the data types supported by SCPI refer to the SCPI 99 specification and IEEE 488 2 2 1 1 Numeric Parameters Response Types Numeric parameters and response types are integer or floating point numerical values that can be positive or neg...
Страница 7: ...2 1 4 ASCII String Parameters Response Types The CPS2000 series of devices also supports ASCII string parameters and response types Some commands return textual information and or take text as a parameter In general ASCII string parameters and response types support the 8 bit ASCII character set Any other character formatting is not supported Denoted as string label where label is a descriptive la...
Страница 8: ...esents commands lower in the SCPI command tree where keywords to the left represent more base high level subsystems of a command tree INITiate CONTinuous INITiate and CONTinuous are separate keywords but are combined to make up a single command using the character Separates adjacent parameters or responses when more than one parameter or response is expected for a command SYSTem ERRor NEXT returns...
Страница 9: ... characters for a command These characters can be included or omitted from a command string If any are omitted all lower case keyword characters must be omitted INITiate CONTinuous In this command only the INIT and CONT characters are required As such an equivalent command would be INIT CONT Whitespace Generally ignored as long as they are not included within a command s keywords A single space ch...
Страница 10: ...ed by the CPS2000 series of devices follows a particular model according to the SCPI specification Each Status described in the following sections has a set of 4 associated registers a Condition register Transition Filter registers an Event register and an Enable register For the CPS2000 series of devices the Transition Filter registers are not used For an example of using registers see Section 6 ...
Страница 11: ...a 1 a 1 for the corresponding Event Register bit will result in a 1 for the summary bit in the Status Byte 3 2 Operation Status The Operation Status provides general operational status information for the instrument It follows the Status Registers Model described in section 3 1 and includes a Condition Register Event Register and Enable Register Configuration of each of these registers is performe...
Страница 12: ...in the WAITING_FOR_TRIGGER state See Section 5 Measurement Sequence for more details 6 Waiting for ARM bit Not Used 7 Correcting bit Not Used 8 12 Not Used 13 Instrument Summary bit Not Used 14 Programming Running bit Not Used 15 Always Zero 3 3 STATUS REPORTING Page 12 ...
Страница 13: ...ormed with the STATus QUEStionable SCPI commands as described in section 7 4 Status Subsystem STATus Commands The Questionable Status Condition Register is a 16 bit unsigned register with the following definition BIT DESCRIPTION 0 Questionable Voltage bit Not Used 1 Questionable Current bit Not Used 2 Questionable Time bit Not Used 3 Questionable Power bit Set to a 1 when the latest power measurem...
Страница 14: ...d only and contains the real time status of various events The Standard Event Status Register s value can be obtained using the ESR query The Standard Event Status Register s value is cleared when a Sending a CLS command or b Querying the value using the ESR query The Standard Event Status Register is an 8 bit unsigned register with the following definition BIT DESCRIPTION 0 Operation Complete bit...
Страница 15: ...when a Power cycling the device or b Sending a ESE 0 command 3 5 Status Byte The Status Byte contains summary information about the state of the device It contains bits corresponding to the Questionable Status Summary Standard Event Status Summary and the Operation Status Summary which are set as configured using the Status Registers Model see section 3 1 for more details The value of the Status B...
Страница 16: ...gister works similar to the other enable registers configuring which bits of the Status Byte constitute a 1 in the Service Request bit The Service Request Enable Register can be configured using the SRE command 3 6 Error Codes The list of SCPI error codes that are reported by the CPS2000 series of devices is as follows ERROR CODE DESCRIPTION 100 General command error 101 Invalid character 102 Synt...
Страница 17: ...or 160 Block data error 170 Expression error 200 General execution error 220 General parameter error 222 Data out of range error 230 Data corrupt or stale error 240 General hardware error 241 Hardware missing 242 Hardware malfunction 300 Generic device specific error 350 Queue overflow 3 8 STATUS REPORTING Page 17 3 8 STATUS REPORTING Page 17 ...
Страница 18: ...e not included in the 1999 0 revision of the SCPI standard SENSe FILTer STATe SENSe FILTer STATe SENSe FILTer TIMe SENSe FILTer TIMe SYSTem COMMunicate NETwork MAC SYSTem COMMunicate NETwork DHCP SYSTem COMMunicate NETwork DHCP SYSTem COMMunicate NETwork IP SYSTem COMMunicate NETwork IP SYSTem COMMunicate NETwork SUBNet SYSTem COMMunicate NETwork SUBNet SYSTem COMMunicate NETwork GATeway SYSTem CO...
Страница 19: ...default state in this mode is IDLE and the device only moves to the WAITING_FOR_TRIGGER state when an INITiate IMMediate command is received When a measurement is complete the device moves back into the IDLE state and again waits for an INITiate IMMediate command If the power measurement filter is enabled see SENSE FILTer a measurement is not considered complete as is not returned until the power ...
Страница 20: ...urement is complete 5 2 Continuous Measurement Mode Continuous Measurement Mode follows a sequence similar to the Single Measurement Mode except that the IDLE state is skipped after Continuous Measurement Mode is enabled Instead of returning to IDLE after the MEASURING state the device automatically initiates another measurement and moves into the WAITING_FOR_TRIGGER state If the device is in this...
Страница 21: ...s initial delay power measurements are then immediately available with no additional impact to the rate at which data can be retrieved When using the Power Measurement Filter it is recommended that the device be placed into Continuous Measurement Mode using the INITiate CONTinuous command 5 3 2 Power Measurement Averaging As an alternative to the Power Measurement Aperture the CPS2000 series of de...
Страница 22: ...al the averaging count in milliseconds Frequency Changes Additionally a delay is incurred when frequency is changed using the SENSe FREQuency command Whenever the frequency is changed the active measurement is cancelled the filter and averaging buffers are reset and a slight delay occurs due to internal calibration adjustments Note Due to the delays described above care must be taken when setting ...
Страница 23: ...ger IMMediate Send the software trigger STB 0 Check the MAV bit of the status byte STB 16 FETCh SCALar POWer AC 3 554235e 01 Fetch the power measurement 6 2 Continuous Power Measurements The following command sequence sets up continuous triggering mode with a trigger source of immediate and then retrieves actual power measurements TRIGger SOURce IMMediate Set the Trigger Source to Immediate INITia...
Страница 24: ...DBM Set Power units to dBm SENSe CORRection OFFset MAGNitude 12 3 Set Offset to 12 3 dBm SENSe FREQuency 1500000000 Set Frequency to 1 5 GHz 6 4 Retrieving Device Information This command sequence retrieves general device information IDN Boonton CPS2008 000025 1 0 0 Query basic information SYSTem INFO EXTended 0 cal_date 2017 11 18 Request first group of extended information 6 2 EXAMPLE COMMAND SE...
Страница 25: ... Operation Status Event Register Device indicates Measuring event STB 128 Request the Status Byte which now has bit 7 set since the Measuring bit in the Operation Status Event Register was set to 1 STATus OPERation EVENt 0 Query the Operation Status Event Register Event Register is cleared due to previous command 6 6 Retrieving and Setting Network Configuration The following command sequence retri...
Страница 26: ...nicate NETwork GW 192 168 1 1 Set device s static Gateway Address SYSTem COMMunicate NETwork DHCP OFF Query DHCP Enabled state SYSTem COMMunicate NETwork IP 192 168 1 101 Query device IP Address SYSTem COMMunicate NETwork SUBNET 255 255 255 0 Query device Subnet Address SYSTem COMMunicate NETwork GW 192 168 1 1 Query device Gateway 6 4 EXAMPLE COMMAND SEQUENCES Page 26 ...
Страница 27: ...umerical_value Parameters numerical_value A numerical value serving as a bitmask for the bits that will be enabled Range 0 255 Response None Description Standard Event Status Enable command Sets the Standard Event Status Enabled register See section 3 4 Standard Event Status ESE Syntax ESE Parameters None Response numerical_value The value of the Standard Event Status Enable register Description S...
Страница 28: ...atched until queried using this command after which the value is reset IDN Syntax IDN Parameters None Response string manufacturer string model string serial number string firmware version Basic identification information including manufacturer device model device serial number and device firmware version Description Identification query Retrieves basic identity information for the device Example ...
Страница 29: ...meters None Response None Description Reset command Resets the device to a known state Specifically the following settings and configuration options are reset Command Setting Reset to Default of SENSe AVERage COUNt 50 SENSe AVERage COUNt AUTO ON SENSe CORRection OFFset MAGNitude 0 0 SENSe FILTer STATe ON SENSe FILTer TIMe 50 SENSe FREQuency 1GHZ TRIGger SOURce IMMediate INITiate CONTinuous OFF UNI...
Страница 30: ...meters None Response numerical_value The value of the Service Request Enable register Description Service Request Enable query Returns the value of the Service Request Enable register See section 3 5 Status Byte for more information STB Syntax STB Parameters None Response numerical_value The device Status byte Description Read Status Byte query Returns the value of the device Status byte including...
Страница 31: ...d after completion of a measurement sequence as described in section 5 Measurement Sequence If the device is in the IDLE state and a measurement has not been initiated the FETCh query will not return any data and will instead generate an error with code 230 If a measurement has been initiated but not triggered the FETCh query will not return any data and will instead generate an error with code 23...
Страница 32: ...ment sequence and then retrieves a power measurement This command is equivalent to sending the following sequence of commands with a Trigger Source of IMMediate ABORt INITiate IMMediate FETCh SCALar POWer AC Since the READ query aborts any existing measurements and then initiates a new measurement it should not be used for continuous data acquisition Continuous Measurement Mode in this case use FE...
Страница 33: ...g or sequencing required Example Request FETCh SCALar TEMPerature Response 3 448959e 01 READ SCALar TEMPerature Syntax READ SCALar TEMPerature Parameters None Response numerical_value The current temperature reading from the device in degrees Celsius Description Retrieves the latest temperature measurement from the device Unlike power measurements temperature readings are always available and cons...
Страница 34: ... this command automatically disables automatic averaging For details regarding the measurement cycles and averaging see section 5 Measurement Sequence and section 5 3 2 Power Measurement Averaging Example SENSe AVERage COUNt 10 SENSe AVERage COUNt Syntax SENSe AVERage COUNt Parameters None Response numerical_value The averaging count in use by the device Description Retrieves the averaging count i...
Страница 35: ...ured using the SENSe AVERage COUNt command Additionally when this command is sent with an 0 parameter the Filter State is automatically disabled set to 0 For more details regarding the measurement cycles and averaging see section 5 Measurement Sequence and section 5 3 2 Power Measurement Averaging Example SENSe AVERage COUNt AUTO 1 SENSe AVERage COUNt AUTO Syntax SENSe AVERage COUNt AUTO Parameter...
Страница 36: ...en the device takes power measurements in dBm Example SENSe CORRection OFFset MAGNitude 12 510 SENSe CORRection OFFset MAGNitude Syntax SENSe CORRection OFFset MAGNitude Parameters None Response numerical_value The offset in use when taking power measurements in dBm Description Retrieves the offset in use by the device when taking power measurements in units of dBm Example Request SENSe CORRection...
Страница 37: ...complete until the power measurement filter is filled Additionally when set to 1 automatic averaging mode is set to 1 and averaging counts controlled by the SENSe AVERage COUNt command are ignored For more details regarding the measurement cycles and filtering see section 5 Measurement Sequence and section 5 3 1 Power Measurement Filtering Example SENSe FILTer STATe 0 SENSe FILTer STATe Syntax SEN...
Страница 38: ...nd filtering see section 5 Measurement Sequence and section 5 3 1 Power Measurement Filtering Example SENSe FILTer TIMe 125 SENSe FILTer TIMe Syntax SENSe FILTer TIMe Parameters None Response numeric_value The power measurement filter time in use by the power measurement filter in milliseconds Description Retrieves the time length of the power measurement filter If the power measurement filter is ...
Страница 39: ...ng power measurements Note Changing the correction frequency of the device will reset any filter or averaging buffers in use and as such will incur a slight delay before the next measurement is ready Example SENSe FREQuency 2 1GHZ SENSe FREQuency Syntax SENSe FREQuency Parameters None Response numerical_value The Correction Frequency to use for power measurements in Hz Description Retrieves the co...
Страница 40: ...r the register value is cleared The data in the Operation Status Event Register is latched until queried using this command after which the value is reset Example Request STATus OPERation EVENt Response 0 STATus OPERation CONDition Syntax STATus OPERation CONDition Parameters None Response numerical_value The contents of the Operation Status Condition Register Description Retrieves the value of th...
Страница 41: ...n the Status Registers and Status Registers Model see section 3 1 Status Registers Model STATus OPERation ENABle Syntax STATus OPERation ENABle Parameters None Response numerical_value The value of the Operation Status Enable register Description Retrieves the value of the Operation Status Enable register If a bit is set to 1 in the Operation Status Enable register using this command and its assoc...
Страница 42: ...s cleared The data in the Questionable Status Event Register is latched until queried using this command after which the value is reset Example Request STATus QUEStionable EVENt Response 0 STATus QUEStionable CONDition Syntax STATus QUEStionable CONDition Parameters None Response numerical_value The contents of the general Questionable Condition register Description Retrieves the value of the gene...
Страница 43: ...n the Status Registers and Status Registers Model see section 3 1 Status Registers Model STATus QUEStionable ENABle Syntax STATus QUEStionable ENABle Parameters None Response numerical_value The value of the Questionable Event Status Enable register Description Retrieves the value of the Questionable Event Status Enable register If a bit is set to 1 in this register its associated event bit transi...
Страница 44: ...cording to the RST command and clearing the status registers according to the CLS command and resets the following status registers Register PRESet Value Operation Event Register 0 Operation Condition Register 0 Operation Enable Register 0 Questionable Event Register 0 Questionable Condition Register 0 Questionable Enable Register 0 7 18 COMMAND REFERENCE Page 44 ...
Страница 45: ...ion Retrieves the next error event from the device s error event queue Errors and events are queued in a buffer on the device and retrieved using this command For a list of possible error codes retrieved using this command see section 3 6 Error Codes Example Request SYSTem ERRor NEXT Response SYSTem COMMunicate NETwork MAC Syntax SYSTem COMMunicate NETwork MAC Parameters None Response string MAC T...
Страница 46: ... a static IP as configured via the SYSTem COMMunicate NETwork IP command SYSTem COMMunicate NETwork DHCP Syntax SYSTem COMMunicate NETwork DHCP Parameters None Response Boolean 1 if DHCP is enabled 0 if DHCP is disabled Description Retrieves the status of the DHCP configuration If DHCP is enabled the device will automatically obtain a dynamic IP address If DHCP is disabled the device will instead ...
Страница 47: ... COMMunicate NETwork IP Parameters None Response string IP Address The IP address of the device in the form of xx xx xx xx where xx is a number in the range of 0 255 Description Retrieves the current IP address of the device If DHCP is enabled this address corresponds to the dynamic IP address automatically obtained via DHCP If DHCP is disabled this address corresponds to the static IP address set...
Страница 48: ...DHCP is enabled this address corresponds to the Subnet Mask automatically obtained via DHCP If DHCP is disabled this address corresponds to the Subnet Mask set using the SYSTem COMMunicate NETwork SUBNet command SYSTem COMMunicate NETwork GATeway Syntax SYSTem COMMunicate NETwork GATeway string IP Address Parameters string IP Address The Default Gateway IP address to use when DHCP is disabled Must...
Страница 49: ...Gateway IP address automatically obtained via DHCP If DHCP is disabled this address corresponds to the Gateway IP address set using the SYSTem COMMunicate NETwork GATeway command SYSTem VERSion Syntax SYSTem VERSion Parameters None Response string Version The SCPI version for which the device complies in the form of YYYY V Where YYYY corresponds to the year version and V corresponds to the approve...
Страница 50: ...XTended numeric_value Parameters numeric_value The extended information group number Response Key value pairs of extended information parameters separated by semicolon characters Description Retrieves extended device information The data returned depends on the group number specified the numeric_value parameter If an invalid group number is specified this command will return no data and instead th...
Страница 51: ...ger that is do not wait on a specific triggering event before taking a power measurement BUS Use a software induced trigger Waits to take a power measurement until a trigger event is signaled using the TRIGger IMMediate command or READ SCALar POWer AC command Default Value IMMediate Response None Description Sets the trigger source to use when taking power measurements Example TRIGger SOURce IMMed...
Страница 52: ...gger source configured for use when taking power measurements Example Request TRIGger SOURce Response BUS TRIGger IMMediate Syntax TRIGger IMMediate Parameters None Response None Description Performs an immediate trigger for the device Only supported when trigger source is set to BUS If the trigger source is set to IMMediate this command has no effect INITiate IMMediate Syntax INITiate IMMediate P...
Страница 53: ...one Response Boolean 1 if continuous triggering mode is enabled 2 if continuous triggering mode is disabled Description Retrieves the enabled or disabled state of the continuous triggering mode ABORt Syntax ABORt Parameters None Response None Description Aborts a trigger cycle and resets the trigger system Any actions related to a triggering cycle are aborted and the device returns to the IDLE sta...
Страница 54: ...ne Description Sets the unit of measurement used when taking power measurements Example UNIT POWer DBM UNIT POWer Syntax UNIT POWer Parameters None Response DBM W A string corresponding to the units in use when taking power measurements Possible options include DBM Power ratio in decibels dB in reference to one milliwatt mW W Power in Watts Description Retrieves the unit of measurement used when t...
Страница 55: ...atus Summary to the Status Byte description Wireless Telecom Group Inc 25 Eastmans Rd Parsippany NJ 07054 United States of America Tel 1 973 386 9696 Fax 1 973 386 9191 www boonton com Copyright 2018 All rights reserved Note Specifications terms and conditions are subject to change without prior notice ...