/// <summary>
/// Queries the available diagnostic trouble codes (DTCs)
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> List containing all DTCs that could be retrieved </returns>
public static List <DiagnosticTroubleCode> DiagnosticTroubleCodes(IOBDConnection obdConnection)
{
// issue the request for the actual DTCs
ControllerResponse response = obdConnection.Query(Mode.DiagnosticTroubleCodes);
if (response.HasValidData())
{
throw new QueryException("Diagnostic trouble codes couldn't be queried, the controller returned no data");
}
if (response.Value.Length < 2)
{
throw new QueryException("Diagnostic trouble codes couldn't be queried, received data was not complete");
}
var fetchedCodes = new List <DiagnosticTroubleCode>();
for (int i = 1; i < response.Value.Length; i += 3) // each error code got a size of 3 bytes
{
byte[] troubleCode = new byte[3];
Array.Copy(response.Value, i, troubleCode, 0, 3);
if (!troubleCode.All(b => b == default(Byte))) // if the byte array is not entirely empty, add the error code to the parsed list
{
fetchedCodes.Add(new DiagnosticTroubleCode(troubleCode));
}
}
return(fetchedCodes);
}
/// <summary>
/// Queries the current calculated engine load value
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved calculated engine load value in percentage (0-100) </returns>
public static uint CalculatedEngineLoadValue(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.CalculatedEngineLoadValue);
if (response.HasValidData()) throw new QueryException("Calculated engine load value couldn't be queried, the controller returned no data");
// given in percentage, first value byte *100/255
return (response.Value.Length >= 1) ? (Convert.ToUInt32(response.Value.First()) * 100) / 255 : 0;
}
/// <summary>
/// Queries the current engine temperature
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> Temperature given in celsius </returns>
public static int EngineTemperature(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.EngineTemperature);
if (response.HasValidData())
{
throw new QueryException("Engine temperature couldn't be queried, the controller returned no data");
}
// the first value byte minus 40 represents the engine temperature in celsius
return((response.Value.Length >= 1) ? Convert.ToInt32(response.Value.First()) - 40 : 0);
}
/// <summary>
/// Queries the current vehicle speed
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> Speed given in km/h </returns>
public static uint Speed(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.Speed);
if (response.HasValidData())
{
throw new QueryException("Vehicle speed couldn't be queried, the controller returned no data");
}
// the first value byte represents the speed in km/h
return((response.Value.Length >= 1) ? Convert.ToUInt32(response.Value.First()) : 0);
}
/// <summary>
/// Queries the current fuel pressure
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved fuel pressure given in kPa </returns>
public static uint FuelPressure(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.FuelPressure);
if (response.HasValidData())
{
throw new QueryException("Fuel pressure couldn't be queried, the controller returned no data");
}
// given in kPa, first value byte * 3
return((response.Value.Length >= 1) ? Convert.ToUInt32(response.Value.First()) * 3 : 0);
}
/// <summary>
/// Queries the current calculated engine load value
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved calculated engine load value in percentage (0-100) </returns>
public static uint CalculatedEngineLoadValue(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.CalculatedEngineLoadValue);
if (response.HasValidData())
{
throw new QueryException("Calculated engine load value couldn't be queried, the controller returned no data");
}
// given in percentage, first value byte *100/255
return((response.Value.Length >= 1) ? (Convert.ToUInt32(response.Value.First()) * 100) / 255 : 0);
}
/// <summary>
/// Queries the status of the malfunction indicator lamp (MIL)
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> true if the MIL is illuminated, false if not </returns>
public static bool MalfunctionIndicatorLamp(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.MIL);
if (response.HasValidData())
{
throw new QueryException("Malfunction indicator lamp couldn't be queried, the controller returned no data");
}
if (response.Value.Length == 0)
{
return(false);
}
return(Convert.ToBoolean((response.Value.First() >> 7) & 1));
}
/// <summary>
/// Queries the available diagnostic trouble codes (DTCs)
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> List containing all DTCs that could be retrieved </returns>
public static List<DiagnosticTroubleCode> DiagnosticTroubleCodes(IOBDConnection obdConnection)
{
// issue the request for the actual DTCs
ControllerResponse response = obdConnection.Query(Mode.DiagnosticTroubleCodes);
if (response.HasValidData()) throw new QueryException("Diagnostic trouble codes couldn't be queried, the controller returned no data");
if (response.Value.Length < 2) throw new QueryException("Diagnostic trouble codes couldn't be queried, received data was not complete");
var fetchedCodes = new List<DiagnosticTroubleCode>();
for (int i = 1; i < response.Value.Length; i += 3) // each error code got a size of 3 bytes
{
byte[] troubleCode = new byte[3];
Array.Copy(response.Value, i, troubleCode, 0, 3);
if(!troubleCode.All(b => b == default(Byte))) // if the byte array is not entirely empty, add the error code to the parsed list
fetchedCodes.Add(new DiagnosticTroubleCode(troubleCode));
}
return fetchedCodes;
}
/// <summary>
/// Queries the current RPM
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved RPM </returns>
public static uint RPM(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.RPM);
if (response.HasValidData())
{
throw new QueryException("RPM couldn't be queried, the controller returned no data");
}
// RPM is given in 2 bytes
// Formula: ((A*256)+B)/4
if (response.Value.Length < 2)
{
throw new QueryException("RPM couldn't be queried, retrieved data was uncomplete");
}
uint rpm1 = Convert.ToUInt32(response.Value.First());
uint rpm2 = Convert.ToUInt32(response.Value.ElementAt(1));
return(((rpm1 * 256) + rpm2) / 4);
}
/// <summary>
/// Queries the current engine temperature
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> Temperature given in celsius </returns>
public static int EngineTemperature(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.EngineTemperature);
if (response.HasValidData()) throw new QueryException("Engine temperature couldn't be queried, the controller returned no data");
// the first value byte minus 40 represents the engine temperature in celsius
return (response.Value.Length >= 1) ? Convert.ToInt32(response.Value.First()) - 40 : 0;
}
/// <summary>
/// Queries the current vehicle speed
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> Speed given in km/h </returns>
public static uint Speed(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.Speed);
if (response.HasValidData()) throw new QueryException("Vehicle speed couldn't be queried, the controller returned no data");
// the first value byte represents the speed in km/h
return (response.Value.Length >= 1) ? Convert.ToUInt32(response.Value.First()) : 0;
}
/// <summary>
/// Queries the current RPM
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved RPM </returns>
public static uint RPM(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.RPM);
if (response.HasValidData()) throw new QueryException("RPM couldn't be queried, the controller returned no data");
// RPM is given in 2 bytes
// Formula: ((A*256)+B)/4
if (response.Value.Length < 2) throw new QueryException("RPM couldn't be queried, retrieved data was uncomplete");
uint rpm1 = Convert.ToUInt32(response.Value.First());
uint rpm2 = Convert.ToUInt32(response.Value.ElementAt(1));
return ((rpm1 * 256) + rpm2) / 4;
}
/// <summary>
/// Queries the status of the malfunction indicator lamp (MIL)
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> true if the MIL is illuminated, false if not </returns>
public static bool MalfunctionIndicatorLamp(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.MIL);
if (response.HasValidData()) throw new QueryException("Malfunction indicator lamp couldn't be queried, the controller returned no data");
if (response.Value.Length == 0) return false;
return Convert.ToBoolean((response.Value.First() >> 7) & 1);
}
/// <summary>
/// Queries the current fuel pressure
/// </summary>
/// <param name="obdConnection"> Connection to the vehicle interface used to query the data </param>
/// <returns> The retrieved fuel pressure given in kPa </returns>
public static uint FuelPressure(IOBDConnection obdConnection)
{
ControllerResponse response = obdConnection.Query(Mode.CurrentData, PID.FuelPressure);
if (response.HasValidData()) throw new QueryException("Fuel pressure couldn't be queried, the controller returned no data");
// given in kPa, first value byte * 3
return (response.Value.Length >= 1) ? Convert.ToUInt32(response.Value.First()) * 3 : 0;
}
