/// <summary>
/// Runs a measurement as specified in the method on the connected device.
/// </summary>
/// <param name="method">The method containing the measurement parameters.</param>
/// <param name="muxChannel">The mux channel to measure on.</param>
/// <returns>
/// A SimpleMeasurement instance containing all the data related to the measurement.
/// </returns>
/// <exception cref="System.NullReferenceException">Not connected to a device.</exception>
/// <exception cref="System.ArgumentException">Method is incompatible with the connected device.</exception>
/// <exception cref="System.Exception">Could not start measurement.</exception>
public async Task <SimpleMeasurement> MeasureAsync(Method method, int muxChannel, TaskBarrier taskBarrier = null)
{
_activeMeasurement = null;
if (_comm == null)
{
throw new NullReferenceException("Not connected to a device.");
}
//Update the autoranging depending on the current ranges supported by the connected device
if (Connected)
{
method.Ranging.SupportedCurrentRanges = Capabilities.SupportedRanges;
}
//Check whether method is compatible with the connected device
ValidateMethod(method, out bool isValidMethod, out List <string> errors);
if (!isValidMethod)
{
throw new ArgumentException("Method is incompatible with the connected device.");
}
//Init task to wait for the active measurement to be initiated by CommManager.MeasureAsync()
_taskCompletionSource = new TaskCompletionSource <SimpleMeasurement>();
_comm.BeginMeasurementAsync += GetActiveMeasurementAsync;
string error = "";
//Start the measurement on the connected device, this triggers an event that updates _activeMeasurement
error = await RunAsync <string>(async() =>
{
//Need to check again as the task can be scheduled to run at a later point after which this could have changed
if (_comm == null)
{
throw new NullReferenceException("Not connected to a device");
}
return(await _comm.MeasureAsync(method, muxChannel, taskBarrier));
});
if (!(string.IsNullOrEmpty(error)))
{
throw new Exception($"Could not start measurement: {error}");
}
return(await _taskCompletionSource.Task);
}