How to characterize a programmable RF attenuator

A programmed attenuation value and an RF measurement describe different things. The command specifies the requested setting. A calibrated measurement establishes what happened to the signal at a particular frequency, power level, and reference plane.

This guide is a measurement procedure, not a new performance report or a certification of a specific unit. Use it alongside the POE-ATTEN-6G specifications, the datasheet's published response plots, and your test instrument's calibration procedure.

Define the question first

Record the device model, serial number, hardware and firmware revisions, frequency points, input power, attenuation settings, and temperature. Decide whether the test measures baseline insertion loss, attenuation relative to the zero setting, accuracy against the requested increment, or repeatability after cycling settings.

Choose levels within the ratings of the attenuator, source, receiver, and DUT. The attenuator's 0.25 dB command resolution is not a substitute for an accuracy specification or an uncertainty budget.

Establish the reference planes

For a VNA measurement, calibrate using the instrument's documented procedure at the cable ends that will connect to the attenuator, including the adapters you intend to leave in place. Record calibration date, sweep settings, source power, IF bandwidth, averaging, and any fixture correction. Keep cable placement and connector handling consistent between runs.

For a source-and-receiver measurement, establish a reference path and confirm receiver linearity and usable noise floor across the planned levels. A single power reading without a stable reference cannot distinguish attenuator error from source drift or receiver error.

Save the original Touchstone (.s2p) captures as well as plots. Keep the frequency units, reference impedance, and data format with each file. Record the frequency range actually acquired; a sweep that begins at 300 kHz cannot establish performance at 100 kHz, and measurements beyond a product's rated band do not extend that rating.

Measure the baseline and each setting

  1. Set the attenuation to 0 dB, read back the commanded setting, allow the measurement setup to settle, and capture transmission across the required frequency points.
  2. Apply the next attenuation setting and read it back. Use an independently chosen settling interval before acquiring the RF measurement.
  3. Repeat the acquisition with the same reference planes and instrument settings, or record every deliberate setting change.
  4. Return to 0 dB periodically to check drift. Repeat selected settings in both directions to examine repeatability.

The Python control example can sequence setpoints and log API readback. Add acquisition from your VNA or receiver after the dwell; the control log by itself contains no RF measurement.

Calculate the quantities separately

For a calibrated VNA reporting transmission magnitude S21 in dB:

Baseline insertion loss (dB) = -S21 at the 0 dB setting
Relative attenuation (dB) = S21 at 0 dB - S21 at the requested setting
Attenuation error (dB) = relative attenuation - requested setting

Here S21 is already expressed in dB, not a linear amplitude. For a stable source-and-receiver setup, use the difference between the received reference power and received power at the requested setting, both in dBm, to obtain relative attenuation in dB.

Keep baseline insertion loss and programmable attenuation separate. The signal level at a DUT also includes cables, fixtures, and any switches in the path. Compare measured errors with the datasheet limits applicable to the same frequency and setting, including measurement uncertainty.

Check the measurement floor at high attenuation

As received signal approaches the instrument noise floor, measured transmission can stop changing even when the command changes. Leakage around the intended RF path can create a similar limit. Do not report a floor-limited reading as the attenuator's true attenuation or accuracy.

Check shielding and unintended coupling, the instrument's specified dynamic range, source power, receiver settings, and the repeatability of the reference. Document the usable measurement range. Increasing source power is only appropriate within every connected component's ratings.

A repeat sweep with a narrower IF bandwidth or more averaging can help investigate random receiver noise, with a corresponding increase in acquisition time. It does not remove a coherent leakage path. Compare the result with the original capture and report the changed settings. Smoothing an existing trace does not create additional measurement dynamic range.

Compare units and present plots consistently

Reference each unit's relative attenuation to its own 0 dB capture. This separates its attenuation error from differences in baseline insertion loss. Compare matching frequency points and setpoints; a unit measured at five settings and one measured at every step support a direct comparison only at their common settings.

Retain the unsmoothed data. If a display uses smoothing, state the method and window size, and distinguish extrema calculated from raw data from extrema calculated after smoothing. Keep noisy or floor-limited regions visible and labelled. Choose plot limits that show the complete result, including excursions outside the expected range.

Keep a reproducible record

Field Why it matters
DUT serial, hardware revision, firmware Identifies the unit and command behavior tested
Instrument identity and calibration Establishes the measurement chain
Frequency, source power, temperature Defines operating conditions
Requested setting and API readback Confirms what the control system requested and reported
Zero-setting transmission and measured transmission Supports the baseline and relative-attenuation calculation
Acquisition configuration and settling interval Allows another engineer to reproduce the acquisition
Uncertainty, repeat count, floor-limited flag Prevents overstating precision or usable dynamic range
Raw capture filenames and plot processing Connects each plotted result to its source and makes smoothing explicit

Publish representative plots with the raw data, conditions, and applicable unit revision when sharing a report. Do not label a single-unit plot as a guaranteed production limit. If your application needs a particular accuracy at high attenuation or below the datasheet's characterized band, review that requirement with Nine Fives.

Related resources: attenuator product and datasheet links, API documentation, and RF test automation guides.