Universal Device Driver Reference Manual

1.115 Channel-Power-Measurement

This page describes the Channel-Power-Measurement device driver and the device window for this device.

Device window pages

The following table shows which device window pages are available for this device type. Toolbar functions not mentioned here are described in the general description of device windows.

— The measurement parameters view.
— The faults page.
— The device info page.
— The maintenance page. The configuration parameters described below are set on this page.

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameters which must be set to measure the channel power.

parameter --- description
spectrumDevice --- The spectrum deviceId you want to measure (SPECTRUM-DEVICE).
matrixPortId --- The matrix portId you want to measure (MATRIX-DEVICE.output.portId).
nextMeasurementDevice -- The next power measurement channel device name. If set, the next measurement will automatically start after the current measurement finishes.

The measurement parameters view

The measurement parameters view shows the following inputs, which are used to change the spectrum and matrix device parameters, as well as other controls.

center: Center frequency for the measurement.
rbw: Resolution Bandwidth for the measurement.
atten: Attenuation for the measurement.
span: Span frequency for the measurement.
vbw: Video Bandwidth for the measurement.
measurementDelay: After commanding or setting the values, this is how long the system waits before starting the measurement. The default value is 2000 ms.
matrixInput: Set input (03) on the matrix device.
Start measurement: Start commanding or setting values and start the measurement.
channel power: Shows the measurement result. -999 dB indicates that the device is currently measuring.
Learn spectrum values: It adopt the values from the spectrum device.

Fault flags

fault flag	fault name	description
faults.01	Spectrum	This fault is set and extracted from `SPECTRUM‑DEVICE.fault`. That means if the spectrum device has any fault, it will be mirrored.
faults.02	Matrix	This fault is set the same way as faults.01 but with `MATRIX‑DEVICE.fault`.
faults.03	Sweep timeout	This fault is set if the spectrum sweep takes longer than 1 minute.

Variables defined by this device driver

name	type	flags	range
info.driver	TEXT	R/O	StringRange R/O
info.type	TEXT	R/O	StringRange R/O
info.frame	TEXT	R/O	StringRange R/O
config.spectrumDevice	TEXT	SAVE SETUP	StringRange
config.matrixPortId	TEXT	SAVE SETUP	StringRange
config.nextMeasurementDevice	TEXT	SAVE SETUP	StringRange
center	FLOAT	SAVE	DoubleRange (0.000000 .. 10000.000000)
span	FLOAT	SAVE	DoubleRange (0.000000 .. 10000.000000)
rbw	FLOAT	SAVE	DoubleRange (0.000 .. 0.000)
vbw	FLOAT	SAVE	DoubleRange (0.000 .. 0.000)
atten	FLOAT	SAVE	DoubleRange (0 .. 65)
matrixInput	CHOICE	SAVE	EnumRange (OFF 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64)
measurementDelay	INTEGER	SAVE	IntegerRange (0 .. 5000)
channelPower	FLOAT	R/O	DoubleRange R/O (0.00 .. 0.00)
adoptValues	TEXT	NOPRESET	StringRange
start	TEXT	NOPRESET	StringRange
faults.01	ALARM	R/O	AlarmFlagRange R/O (Spectrum)
faults.02	ALARM	R/O	AlarmFlagRange R/O (Matrix)
faults.03	ALARM	R/O	AlarmFlagRange R/O (Sweep timeout)