/// <summary>Performs actions to initiate acquisition and measurement.<para></para> Enables the specified measurement(s) before optionally
/// automatically adjusting the reference level before beginning measurements. Finally, initiates the acquisition and measurement(s).</summary>
/// <param name="wlanSignal">Specifies the WLAN signal to configure.</param>
/// <param name="measurements">Specifies one or more previously configured measurements to enable for this acquisition.</param>
/// <param name="autoLevelConfig">Specifies the configuration for the optional AutoLevel process which will automatically set the analyzer's reference level.</param>
/// <param name="enableTraces">(Optional) Specifies whether traces should be enabled for the measurement(s). See the RFmx help for more documention of this parameter.</param>
/// <param name="selectorString">Pass an empty string. The signal name that is passed when creating the signal configuration is used.See the RFmx help for more documention of this parameter.</param>
/// <param name="resultName">(Optional) Specifies the name to be associated with measurement results. Provide a unique name, such as "r1" to enable
/// fetching of multiple measurement results and traces. See the RFmx help for more documentation of this parameter.</param>
public static void SelectAndInitiateMeasurements(RFmxWlanMX wlanSignal, RFmxWlanMXMeasurementTypes[] measurements, AutoLevelConfiguration autoLevelConfig = default,
bool enableTraces = false, string selectorString = "", string resultName = "")
{
// Aggregate the selected measurements into a single value
// OR of 0 and x equals x
RFmxWlanMXMeasurementTypes selectedMeasurements = 0;
foreach (RFmxWlanMXMeasurementTypes measurement in measurements)
{
selectedMeasurements |= measurement;
}
wlanSignal.SelectMeasurements(selectorString, selectedMeasurements, enableTraces);
if (autoLevelConfig.Enabled)
{
wlanSignal.AutoLevel(selectorString, autoLevelConfig.MeasurementInterval_s);
}
// Initiate acquisition and measurement for the selected measurements
wlanSignal.Initiate(selectorString, resultName);
}
public void Run()
{
ConfigureGeneration();
ConfigureMeasurement();
ConfigureServo();
ConfigureSweep();
rfsgSession.Initiate();
// Define sweep
Stopwatch watch = new Stopwatch();
watch.Reset();
StreamWriter stream = new StreamWriter(File.Create("data.csv"));
stream.WriteLine(string.Join(", ", "Frequency", "Averages", "Symbols"));
var sweep = new Sweep(sweepSteps, () =>
{
// get rid of first run jitter
wlan.Initiate("", "");
wlan.WaitForMeasurementComplete("", 10.0);
wlan.OfdmModAcc.Configuration.GetAveragingCount("", out int numAverages);
wlan.OfdmModAcc.Results.GetNumberOfSymbolsUsed("", out int numSymbolsUsed);
wlan.OfdmModAcc.Results.GetCompositeRmsEvmMean("", out double evm);
wlan.GetCenterFrequency("", out double centFreq);
string currentPoints = string.Join(", ", centFreq.ToString(), sweepSteps[1].GetCurrentPoint().ToString(),
sweepSteps[2].GetCurrentPoint().ToString());
stream.Write(currentPoints);
Console.WriteLine(currentPoints);
for (int i = 0; i < repeatabilityCount; i++)
{
powerServo.Disable();
powerServo.Enable();
watch.Restart();
wlan.Initiate("", "");
powerServo.Start();
powerServo.Wait(ServoTimeout, out ushort servoNumberOfAveragesCaptured, out bool servoDone, out bool servoFailed);
// powerServo.GetDigitalGain(out double servoRawDigitalGain, out double servoDigitalGain);
// powerServo.GetServoSteps(servoNumberOfAveragesCaptured, servoContinuous, false, 0, out servoMeasurementTimes, out servoMeasurementLevels);
wlan.WaitForMeasurementComplete("", 10.0);
wlan.OfdmModAcc.Configuration.GetAveragingCount("", out numAverages);
wlan.OfdmModAcc.Results.GetCompositeRmsEvmMean("", out evm);
wlan.OfdmModAcc.Results.GetNumberOfSymbolsUsed("", out numSymbolsUsed);
watch.Stop();
if (numAverages != (int)sweepSteps[1].GetCurrentPoint() || numSymbolsUsed != (int)sweepSteps[2].GetCurrentPoint())
{
throw new Exception();
}
stream.Write(", " + evm.ToString());
stream.Write(", " + watch.ElapsedMilliseconds.ToString());
}
static void Main()
{
#region Configure Generation
string resourceName = "VST2";
string filePath = Path.GetFullPath(@"Support Files\80211a_20M_48Mbps.tdms");
NIRfsg nIRfsg = new NIRfsg(resourceName, false, false);
InstrumentConfiguration instrConfig = InstrumentConfiguration.GetDefault();
instrConfig.CarrierFrequency_Hz = 2.412e9;
ConfigureInstrument(nIRfsg, instrConfig);
Waveform waveform = LoadWaveformFromTDMS(filePath);
DownloadWaveform(nIRfsg, waveform);
WaveformTimingConfiguration timing = new WaveformTimingConfiguration
{
DutyCycle_Percent = 60,
PreBurstTime_s = 1e-9,
PostBurstTime_s = 1e-9,
BurstStartTriggerExport = "PXI_Trig0"
};
PAENConfiguration paenConfig = new PAENConfiguration
{
PAEnableMode = PAENMode.Dynamic,
PAEnableTriggerExportTerminal = "PFI0",
PAEnableTriggerMode = RfsgMarkerEventOutputBehaviour.Toggle
};
ConfigureBurstedGeneration(nIRfsg, waveform, timing, paenConfig, out double period, out _);
nIRfsg.Initiate();
#endregion
RFmxInstrMX instr = new RFmxInstrMX("VST2", "");
RFmxWlanMX wlan = instr.GetWlanSignalConfiguration();
instr.GetWlanSignalConfiguration();
CommonConfiguration commonConfiguration = CommonConfiguration.GetDefault();
commonConfiguration.CenterFrequency_Hz = 2.412e9;
AutoLevelConfiguration autoLevel = new AutoLevelConfiguration
{
AutoLevelMeasureTime_s = period,
AutoLevelReferenceLevel = true
};
SA.RFmxWLAN.ConfigureCommon(instr, wlan, commonConfiguration, autoLevel);
SignalConfiguration signal = SignalConfiguration.GetDefault();
signal.AutoDetectSignal = false;
signal.ChannelBandwidth_Hz = 20e6;
signal.Standard = RFmxWlanMXStandard.Standard802_11ag;
SA.RFmxWLAN.ConfigureSignal(wlan, signal);
TxPConfiguration txpConfig = new TxPConfiguration
{
AveragingCount = 10,
MaximumMeasurementInterval_s = waveform.BurstLength_s,
AveragingEnabled = RFmxWlanMXTxpAveragingEnabled.True
};
SA.RFmxWLAN.ConfigureTxP(wlan, txpConfig);
OFDMModAccConfiguration modAccConfig = OFDMModAccConfiguration.GetDefault();
modAccConfig.OptimizeDynamicRangeForEvmEnabled = RFmxWlanMXOfdmModAccOptimizeDynamicRangeForEvmEnabled.False;
modAccConfig.AveragingEnabled = RFmxWlanMXOfdmModAccAveragingEnabled.True;
SA.RFmxWLAN.ConfigureOFDMModAcc(wlan, modAccConfig);
TxPServoConfiguration servoConfig = TxPServoConfiguration.GetDefault();
servoConfig.TargetTxPPower_dBm = 0.5;
SA.RFmxWLAN.TxPServoPower(wlan, nIRfsg, servoConfig, autoLevel);
SEMConfiguration semConfig = SEMConfiguration.GetDefault();
SA.RFmxWLAN.ConfigureSEM(wlan, semConfig);
wlan.Initiate("", "");
TxPResults txpRes = SA.RFmxWLAN.FetchTxP(wlan);
OFDMModAccResults modAccResults = SA.RFmxWLAN.FetchOFDMModAcc(wlan);
SEMResults semResults = SA.RFmxWLAN.FetchSEM(wlan);
Console.WriteLine("TXP Avg Power: {0:N}", txpRes.AveragePowerMean_dBm);
Console.WriteLine("Composite RMS EVM (dB): {0:N}", modAccResults.CompositeRMSEVMMean_dB);
Console.WriteLine("\n----------Lower Offset Measurements----------\n");
for (int i = 0; i < semResults.LowerOffsetMargin_dB.Length; i++)
{
Console.WriteLine("Offset {0}", i);
Console.WriteLine("Measurement Status :{0}",
semResults.lowerOffsetMeasurementStatus[i]);
Console.WriteLine("Margin (dB) :{0}", semResults.LowerOffsetMargin_dB[i]);
Console.WriteLine("Margin Frequency (Hz) :{0}", semResults.LowerOffsetMarginFrequency_Hz[i]);
Console.WriteLine("Margin Absolute Power (dBm) :{0}\n", semResults.LowerOffsetMarginAbsolutePower_dBm[i]);
}
Console.WriteLine("\n----------Upper Offset Measurements----------\n");
for (int i = 0; i < semResults.UpperOffsetMargin_dB.Length; i++)
{
Console.WriteLine("Offset {0}", i);
Console.WriteLine("Measurement Status :{0}", semResults.upperOffsetMeasurementStatus[i]);
Console.WriteLine("Margin (dB) :{0}", semResults.UpperOffsetMargin_dB[i]);
Console.WriteLine("Margin Frequency (Hz) :{0}", semResults.UpperOffsetMarginFrequency_Hz[i]);
Console.WriteLine("Margin Absolute Power (dBm) :{0}\n", semResults.UpperOffsetMarginAbsolutePower_dBm[i]);
}
Console.WriteLine("\n--------------------\n\nPress any key to exit.");
Console.ReadKey();
wlan.Dispose();
instr.Close();
AbortGeneration(nIRfsg);
CloseInstrument(nIRfsg);
}
static void LoadAndRunMeasurements(string instrName, string inputPath, string outputPath)
{
inputPath = Path.GetFullPath(inputPath);
RFmxInstrMX instr = null;
NIRfsa rfsa = null;
IntPtr rfsaHandle;
try
{
Console.WriteLine($"Initializing RFmx session with instrument \"{instrName}\"...");
instr = new RFmxInstrMX(instrName, "");
Console.WriteLine($"Loading configuration from \"{Path.GetFileName(inputPath)}\"...");
instr.LoadAllConfigurations(inputPath, true);
instr.DangerousGetNIRfsaHandle(out rfsaHandle);
rfsa = new NIRfsa(rfsaHandle);
string[] signalNames = new string[0];
RFmxInstrMXPersonalities[] personalities = new RFmxInstrMXPersonalities[0];
Console.WriteLine("Configuration loaded successfully.");
instr.GetSignalConfigurationNames("", RFmxInstrMXPersonalities.All, ref signalNames, ref personalities);
for (int i = 0; i < signalNames.Length; i++)
{
Console.WriteLine("");
ConsoleKeyInfo info;
switch (personalities[i])
{
case RFmxInstrMXPersonalities.BT:
RFmxBTMX bt = instr.GetBTSignalConfiguration(signalNames[i]);
Console.WriteLine($"Enter 'y' to initiate acquisition for RFmx Bluetooth with signal \"{signalNames[i]}\"; any other key to skip.");
info = Console.ReadKey();
Console.WriteLine();
if (info.KeyChar == 'y')
{
bt.Initiate("", "");
bt.WaitForMeasurementComplete("", 10);
FetchAndLog(rfsa, personalities[i], signalNames[i], outputPath);
}
bt.Dispose();
break;
case RFmxInstrMXPersonalities.Wlan:
RFmxWlanMX wlan = instr.GetWlanSignalConfiguration(signalNames[i]);
Console.WriteLine($"Enter 'y' to initiate acquisition for RFmx WLAN with signal \"{signalNames[i]}\"; any other key to skip.");
info = Console.ReadKey();
Console.WriteLine();
if (info.KeyChar == 'y')
{
wlan.Initiate("", "");
wlan.WaitForMeasurementComplete("", 10);
FetchAndLog(rfsa, personalities[i], signalNames[i], outputPath);
}
wlan.Dispose();
break;
case RFmxInstrMXPersonalities.SpecAn:
RFmxSpecAnMX specAn = instr.GetSpecAnSignalConfiguration(signalNames[i]);
Console.WriteLine($"Enter 'y' to initiate acquisition for RFmx SpecAn with signal \"{signalNames[i]}\"; any other key to skip.");
info = Console.ReadKey();
Console.WriteLine();
if (info.KeyChar == 'y')
{
specAn.Initiate("", "");
specAn.WaitForMeasurementComplete("", 10);
FetchAndLog(rfsa, personalities[i], signalNames[i], outputPath);
}
specAn.Dispose();
break;
case RFmxInstrMXPersonalities.NR:
RFmxNRMX nr = instr.GetNRSignalConfiguration(signalNames[i]);
Console.WriteLine($"Enter 'y' to initiate acquisition for RFmx NR with signal \"{signalNames[i]}\"; any other key to skip.");
info = Console.ReadKey();
Console.WriteLine();
if (info.KeyChar == 'y')
{
nr.Initiate("", "");
nr.WaitForMeasurementComplete("", 10);
FetchAndLog(rfsa, personalities[i], signalNames[i], outputPath);
}
nr.Dispose();
break;
case RFmxInstrMXPersonalities.Lte:
RFmxLteMX lte = instr.GetLteSignalConfiguration(signalNames[i]);
Console.WriteLine($"Enter 'y' to initiate acquisition for RFmx LTE with signal \"{signalNames[i]}\"; any other key to skip.");
info = Console.ReadKey();
Console.WriteLine();
if (info.KeyChar == 'y')
{
lte.Initiate("", "");
lte.WaitForMeasurementComplete("", 10);
FetchAndLog(rfsa, personalities[i], signalNames[i], outputPath);
}
lte.Dispose();
break;
default:
throw new System.NotImplementedException($"The \"{personalities[i].ToString()}\" personality has not been implemented.");
}
}
Console.WriteLine("All measurements complete.");
}
catch (Exception ex)
{
Console.WriteLine("Exception occurred: " + ex.Message);
Console.WriteLine("Location: " + ex.StackTrace);
}
finally
{
if (instr != null)
{
instr.Dispose();
}
}
}