Anritsu MS2026C - Trace Header Parameters

Power Monitor Commands :TRACe Power Monitor Subsystem
MS20xxC PM PN: 10580-00306 Rev. E 5-3
Trace Header Parameters
Table 5-2 describes parameters that can be returned by the :TRACe:PREamble? command.
Table 5-2. Trace Header Parameters
Parameter Name Description
SN Instrument Serial #
UNIT_NAME Instrument name
DATE Trace date/time
APP_NAME Application name
APP_VER Application firmware (FW) version
PM_RELATIVE
a
a. For both PM_RELATIVE and PM_ZERO, the :TRACe:PREamble? command returns
0 for On, and returns 1 for Off. This is not the same as the values that are returned from
:CALCulate:PMONitor:RELative[:STATe]? and from :CALCulate:PMONitor:ZERO[:STATe]?,
where 0 is returned for Off, and 1 is returned for On.
Relative State (Off/On), where 0 is On and 1 is Off
PM_OFFSET
b
b. The value that is returned by PM_OFFSET is in units of millidecibel (mdB). (For example: When “1” is
returned, the measurement value is 1 mdB. When “2000” is returned, the measurement value is 2000 mdB,
or 2 dB.)
Offset value
PM_DBMUNITS Specifies the unit (dBm or watts), when Relative is Off,
where 0 is returned for “dBm”, and 1 for “watts”
PM_DBUNITS Specifies the unit (dB or Percent), when Relative is On,
where 0 is returned for “dB”, and 1 for “Percent”
PM_ZERO
a
Zero State (Off/On), where 0 is On and 1 is Off
PM_DATA
c
c. The value that is returned by PM_DATA is in the units that have been set with the Units command
(:CALCulate:PMONitor:UNITs DBM|WATT|DB|PERCent).
If the set Unit is dBm or percent or dB, then the returned value is 1000 times the unit value.
If the unit is watt, then the returned value is 10 times nW (in other words, the units are in
0.1 nanowatt (0.1 nw) increments). Examples:
When the unit is in percent, and 1000 is returned, then the measurement value is 1 percent.
When the unit is in dB, and –1000 is returned, then the measurement value is –1 dB.
When the unit is in dBm, and –1000 is returned, then the measurement value is –1 dBm.
When the unit is in dBm, and –4600 is returned, then the measurement value is –4.6 dBm.
When the unit is in watts, and 1 is returned, then the measurement value is 0.1 nW.
When the unit is in watts, and 3500000 is returned, then the measurement value is 350 µW.
Power Monitor reading
PM_ZERO_DATA
d
d. The value that is returned by PM_ZERO_DATA is in 0.1 nanowatt (0.1 nw) increments. (For
example: When “1” is returned, then the measurement value is 0.1 nw. When “20” is returned, then the
measurement value is 2.0 nw.)
Zero data
PM_REL_DATA
e
e. The value that is returned by PM_REL_DATA is 1000 times the unit value in dBm (in other words, the
units are in 0.001 dBm increments, or 1 millidBm (mdBm) increments. Examples:
When “1000” is returned, then the measurement value is 1 dBm.
When “20000” is returned, then the measurement value is 20 dBm.)
Reference data