/// <summary>
/// Read the flow sensor
/// </summary>
/// <remarks>
/// Engineering Notes: This step is to check if the reading of flow sensor is reasonable.
/// With the pump closed and all valves closed, the flow should be lower than a certain level.
/// Failure on this indicates the reading of flow rate is not correct.
/// </remarks>
/// <param name="details">The string to hold details.</param>
private void TestFlowSensor( DetailsBuilder details )
{
Pump.CloseAllValves( true );
Pump.Stop();
Thread.Sleep( 500 ); // Give the valves a chance to finish closing
// Read the flow rate.
ushort rawFlowCount = Pump.GetRawFlow();
ushort flowVolts = Pump.ConvertRawFlowToVolts( rawFlowCount );
ushort vacuumCounts = Pump.GetRawVacuum();
double vacuumInches = Pump.ConvertRawVacuumToInches( vacuumCounts );
int flowRate = Pump.CalculateFlowRate( flowVolts, vacuumCounts );
// Test flow reading
string flowString = BuildFlowString( rawFlowCount, flowRate, flowVolts );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_FLOW", rawFlowCount.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_FLOW_VOLTS", flowVolts.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_FLOW_RATE", flowRate.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_FLOW_VACUUM", vacuumCounts.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_FLOW_VACUUM_INCHES", vacuumInches.ToString() ) );
// Flow value should be in the range of 0 (0mV) to 186 (600 mV), inclusive.
// INS-3067, 6/26/2013, JMP - changer criteria from 43/128 to 0/186.
ReportDiagnostic( details, DiagnosticResources.FLOW, flowString, ( ( rawFlowCount < 0 ) || ( rawFlowCount > 186 ) ) );
}
/// <summary>
/// Test the specified solenoid
/// </summary>
/// <param name="details">The string to hold details.</param>
private void TestFlow( DetailsBuilder details, int solenoid )
{
// Validate the solenoid number
if ( solenoid < 1 || solenoid > Configuration.DockingStation.NumGasPorts )
{
Log.Debug( "TestFlow: Invalid solenoid value = " + solenoid.ToString() );
return;
}
Log.Debug( "TestFlow: port=" + solenoid.ToString() );
// Determine whether a cylinder is attached to this port.
// If there is one attached, skip this test.
DockingStation ds = Controller.GetDockingStation();
GasEndPoint gasEndPoint = ds.GasEndPoints.Find(m => m.Position == solenoid);
if (gasEndPoint != null && gasEndPoint.Cylinder.IsFreshAir == false)
{
Log.Debug( "TestFlow: Cylinder attached to port " + solenoid.ToString() + "; SKIPPING THIS TEST." );
return;
}
Pump.DoCheckFlow = true;
// Ensure that only the specified solenoid is open.
Pump.CloseAllValves( true );
Thread.Sleep(500); // Give the valves a chance to finish closing
Pump.OpenValve(solenoid, false); // Open the specified solenoid
Thread.Sleep(500); // Pause at least 500ms.
Pump.SetDesiredFlow( Pump.StandardFlowRate);
Pump.Start( Pump.StandardStartVoltage ); // Turn on the pump.
Thread.Sleep( 3000 ); // Wait for it to stabilize the flow before letting CheckFlow take its first reading.
// CheckFlow could enter an infinite loop if it's unable to
// establish the desired flow rate and we don't tell it to time out.
// We therefore give it a time out of a minute which should be more than sufficient.
ushort rawFlowCounts;
ushort rawVacuumCounts;
Pump.FlowStatus flowStatus = Pump.CheckFlow( new TimeSpan( 0, 1, 0 ), out rawFlowCounts, out rawVacuumCounts );
byte pumpVoltage = Pump.GetPumpVoltage(); // obtain and hold onto final voltage of the pump, to report it to inet.
// Get the flow rate.
ushort flowVolts = Pump.ConvertRawFlowToVolts( rawFlowCounts );
int flowRate = Pump.CalculateFlowRate( flowVolts, rawVacuumCounts ); // Convert that value to mL/min
// Report the results.
string flowString = BuildFlowString(flowRate, flowVolts);
// We create a property for every value used to compute the flow rate, and also the flow rate itself.
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_VACUUM", rawVacuumCounts.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_VACUUM_INCHES", Pump.ConvertRawVacuumToInches( rawVacuumCounts ).ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid, rawFlowCounts.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_VOLTS", flowVolts.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_RATE", flowRate.ToString() ) );
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_PUMP_VOLTS", pumpVoltage.ToString() ) );
// The flow is considered a failure if it's not equal to the StandardFlowRate plus/minus the standardtolerance
bool flowFailed = flowRate < ( Pump.StandardFlowRate - Pump.FLOWRATE_TOLERANCE ) || flowRate > ( Pump.StandardFlowRate + Pump.FLOWRATE_TOLERANCE );
// TODO - we should rename the translation string so that it's prefixed with "CHECK_FLOW" instead of "SOLENOID_FLOW"
ReportDiagnostic( details, details.GetText( "SOLENOID_FLOW_" + solenoid ), flowString, flowFailed );
// Check Pump Error Status -- FAIL IF STATE IS 1
int pumpErrorState = Pump.GetPumpErrorState();
// Report the results.
_gdpList.Add( new GeneralDiagnosticProperty( "DIAGNOSTIC_CHECK_FLOW_" + solenoid + "_PUMP_ERROR", pumpErrorState.ToString() ) );
// TODO - we should rename the translation string so that it's prefixed with "CHECK_FLOW" instead of "SOLENOID_FLOW"
ReportDiagnostic(details, details.GetText("SOLENOID_PUMP_ERROR_" + solenoid), pumpErrorState.ToString(), (pumpErrorState == 1));
// Stop the pump and close the solenoid
Pump.CloseValve(solenoid);
Pump.DoCheckFlow = false;
}
/// <summary>
/// Check if pump works properly.
/// </summary>
/// <remarks>
/// Engineering Notes: This step is to check if pump works properly.
/// Run pump at two different control voltages, check the flow rate difference between these two cases.
/// </remarks>
/// <param name="details">The string to hold details.</param>
private void TestPump(DetailsBuilder details)
{
// Find a port without a gas cylinder connected.
// If all ports are connected, skip this test.
DockingStation ds = Controller.GetDockingStation();
// First, see if port one is unconnected or is providing FRESH AIR
// Note: we are trying ports in the order of 3-2-1 so as to avoid pulling air through the filter, if possible.
int testPort = -1;
GasEndPoint gasEndPoint = null;
for ( int solenoid = Configuration.DockingStation.NumGasPorts; solenoid >= 1 && testPort <= 0; solenoid-- )
{
gasEndPoint = ds.GasEndPoints.Find(m => m.Position == solenoid);
if (gasEndPoint == null || gasEndPoint.Cylinder.IsFreshAir)
testPort = solenoid;
}
if (testPort <= 0)
{
Log.Debug("TestPump: could not find open solenoid; this test will be skipped.");
return;
}
// Open solenoid valve determined to be unconnected
Pump.CloseAllValves( true );
Thread.Sleep(500); // Give the valves a chance to finish closing
Pump.OpenValve(testPort, false);
// Start pump with pump voltage of 80
Pump.Start(80);
// Wait 3 seconds
Thread.Sleep(3000);
// Read flow 1
ushort flowCount1 = Pump.GetRawFlow();
ushort flowVolts1 = Pump.ConvertRawFlowToVolts( flowCount1 );
ushort vacuumCounts1 = Pump.GetRawVacuum();
int flowRate1 = Pump.CalculateFlowRate( flowVolts1, vacuumCounts1 );
string flowString1 = BuildFlowString(flowCount1, flowRate1, flowVolts1);
// Increase pump voltage to 240
Pump.SetNewPumpVoltage(240);
// Wait 3 seconds
Thread.Sleep(3000);
// Check Pump Error status
int pumpErrorState = Pump.GetPumpErrorState();
// Fail if state is 1
_gdpList.Add(new GeneralDiagnosticProperty("DIAGNOSTIC_PUMP_ERROR_STATUS", pumpErrorState.ToString()));
ReportDiagnostic(details, DiagnosticResources.PUMP_ERROR_STATUS, pumpErrorState.ToString(), (pumpErrorState == 1));
// Read flow 2
ushort flowCount2 = Pump.GetRawFlow();
ushort flowVolts2 = Pump.ConvertRawFlowToVolts( flowCount2 );
ushort vacuumCounts2 = Pump.GetRawVacuum();
int flowRate2 = Pump.CalculateFlowRate( flowVolts2, vacuumCounts2 );
string flowString2 = BuildFlowString(flowCount2, flowRate2, flowVolts2);
// Fail if f2 - f1 < 100 OR f2 - f1 > 450
_gdpList.Add(new GeneralDiagnosticProperty("DIAGNOSTIC_PUMP_F1", flowCount1.ToString()));
_gdpList.Add(new GeneralDiagnosticProperty("DIAGNOSTIC_PUMP_F2", flowCount2.ToString()));
ReportDiagnostic(details, DiagnosticResources.PUMP, flowString1, flowString2, ( flowCount2 - flowCount1 < 100 ) || ( flowCount2 - flowCount1 > 450 ) );
// Stop the pump and close the port used for this test
Pump.CloseValve(testPort);
Thread.Sleep(500);
}