/// <summary>
/// Test battery charging.
/// </summary>
private void TestBatteryCharging()
{
if ( !Configuration.DockingStation.IsRechargeable() )
return;
if ( !IsInstrumentDocked() )
return;
if ( _dockedInstrument == null )
_dockedInstrument = ReadDockedInstrument();
if ( _dockedInstrument == null )
{
ReportDiagnostic( DiagnosticResources.BATTERY_INSTALLED, false /*battery installed == false*/, true /*failed*/ );
return;
}
// Find the battery code.
string batteryCode = string.Empty;
foreach ( InstalledComponent installedComponent in _dockedInstrument.InstalledComponents )
{
if ( installedComponent.Component.Type.Code.StartsWith( "BP" ) )
batteryCode = installedComponent.Component.Type.Code;
}
// Determine if a battery is installed
if ( batteryCode == string.Empty )
ReportDiagnostic( DiagnosticResources.BATTERY_INSTALLED, false /*battery installed == false*/, true /*failed*/ );
// Check the battery type.
string message = GetText( DiagnosticResources.INSTRUMENT_BATTERY_CODE_PROMPT, batteryCode , DiagnosticResources.PRESS_LEFT_SUCCESS_PROMPT );
Controller.Key keyPressed = GetPassFailKey( message );
ReportDiagnostic( DiagnosticResources.INSTRUMENT_BATTERY_CODE, keyPressed , ( keyPressed != Controller.Key.Left ) );
// If correct battery type, test charging.
if ( keyPressed == Controller.Key.Left )
{
#if !MANUAL
InstrumentChargingOperation chargingOp = new InstrumentChargingOperation();
chargingOp.Execute();
ChargingService.ChargingState chState = chargingOp.ChargingState;
// Note that "NotCharging" is a passable state. The instrument will report a
// phase of ChargeComplete if it's receiving charge current from the IDS but
// isn't currently using it. This will result in a NotCharging chargingstate.
// The instrument will report a phase of ChargeOff if it's NOT receiving a
// charge current from the IDS. This is what we're interested in detecting
// and it results in a ChargingState.Error.
bool failed = chargingOp.ChargingState == ChargingService.ChargingState.Error;
ReportDiagnostic( DiagnosticResources.INSTRUMENT_CHARGING, chState.ToString(), failed );
#else
message = GetText( DiagnosticResources.INSTRUMENT_CHARGING_PROMPT" , batteryCode , DiagnosticResources.PRESS_LEFT_SUCCESS_PROMPT" );
keyPressed = GetPassFailKey( message );
ReportDiagnostic( DiagnosticResources.INSTRUMENT_CHARGING" , keyPressed , ( keyPressed != Controller.Keys.Left ) );
#endif
}
}
/// <summary>
/// Helper method for Run() which communicates with instrument to determine its charging status
/// then updates charger service status properties
/// </summary>
private void RunUpdateChargerState()
{
const string funcName = "RunUpdateChargerState";
Log.Debug(string.Format("{0} invoking {1} on a \"{2}\" battery", Name, funcName, BatteryCode));
if (!Controller.IsDocked())
{
Log.Debug(string.Format("{0}: instrument undocked.", funcName));
return;
}
try
{
InstrumentChargingOperation op = new InstrumentChargingOperation();
op.Execute();
// Keep track of consecutively occurring phases, and when they first occur.
if (_phase != op.InstrumentChargePhase)
{
_phase = op.InstrumentChargePhase;
_phaseStart = DateTime.UtcNow;
}
// If instrument is having any charging problems, report the error to server.
// This will also allow the error to upload to iNet if they're an inet customer.
if (_phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeFailure ||
_phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeFault
// || _phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeOverTempFailure
// || _phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeUnderTempFailure
// || _phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeOff ( AND battery is lithium )
|| _phase == ISC.iNet.DS.DomainModel.ChargePhase.PreChargeFault ||
_phase == ISC.iNet.DS.DomainModel.ChargePhase.ChargeTimeout)
{
// Do not change this message. iNet is parsing it!
string msg = string.Format("Instrument \"{0}\" has reported a \"{1}\" charging error (Battery=\"{2}\", type=\"{3}\").",
op.InstrumentSerialNumber, _phase.ToString(), op.BatterySerialNumber, op.BatteryCode);
Master.ReporterService.ReportError(new DockingStationError(msg, DockingStationErrorLevel.Warning, op.InstrumentSerialNumber));
}
// BatteryCode should be empty if user has docked a completely dead
// battery. If the instrument has now charged up enough such that we
// can now talk to it, then get the battery type.
if (BatteryCode == string.Empty)
{
BatteryCode = op.BatteryCode;
}
if (op.ChargingState == ChargingState.Error)
{
// How much time has elasped between now and when we first saw the
// instrument go into error?
TimeSpan errorTimeElapsed = DateTime.UtcNow - _phaseStart;
Log.Debug(string.Format("{0} - BATTERY IN {1} PHASE! ELAPSED TIME: {2}", Name, _phase.ToString(), errorTimeElapsed.ToString()));
// Instrument hasn't been in error too long? Then
// just treat it as if the intrument is normally charging; no need to
// scare the user. But if it's been stuck in error too
// long, then finally just report it as an error.
TimeSpan maxTimeAllowed = (_phase == ChargePhase.ChargeOverTempFailure || _phase == ChargePhase.ChargeUnderTempFailure) ? _maxTempFailureTimeAllowed : _maxErrorPhaseAllowed;
if (errorTimeElapsed <= maxTimeAllowed)
{
State = ChargingState.Charging;
}
else
{
State = ChargingState.Error;
// Do not change this message. iNet is parsing it!
string msg = string.Format("Instrument \"{0}\" has been in \"{1}\" for an overextended period of time ({2}). (Battery=\"{3}\", type=\"{4}\")",
op.InstrumentSerialNumber, _phase.ToString(), errorTimeElapsed.ToString(), op.BatterySerialNumber, op.BatteryCode);
Log.Error(string.Format("{0} - {1}", Name, msg.ToUpper()));
Log.Error(string.Format("{0} - Reporting {1} to server", Name, op.InstrumentChargePhase.ToString()));
Master.ReporterService.ReportError(new DockingStationError(msg, DockingStationErrorLevel.Warning, op.InstrumentSerialNumber));
}
} // end ChargingState.Error
else // op.State != ChargingState.Error
{
State = op.ChargingState;
}
Log.Debug(Name + " - ChargingState=" + State);
// When instrument is done charging, then turn it off!
if (State == ChargingState.NotCharging)
{
Log.Debug(Name + " - INSTRUMENT APPEARS FULLY CHARGED. TURNING OFF INSTRUMENT.");
Log.Debug(Name + " - WILL NO LONGER POLL INSTRUMENT FOR CHARGING STATUS.");
new InstrumentTurnOffOperation(InstrumentTurnOffOperation.Reason.ChargingComplete).Execute();
}
}
catch (InstrumentPingFailedException e)
{
Log.Error(Name, e);
if (!Controller.IsDocked()) // May have got the exception because they undocked. Ignore it.
{
State = ChargingState.NotCharging;
}
else
{
State = ChargingState.Error; // Couldn't ping the instrument. dead battery?
}
}
catch (Exception e)
{
Log.Error(Name, e);
// Whatever the error was, if the instrument isn't present, then it's
// not charging.
if (!Controller.IsDocked())
{
State = ChargingState.NotCharging;
}
// Not sure what the error is. Leave charging state as is.
}
}