namespace TuneBoss.Core.Models;
///
/// Parsed APP_MONITORING (0x70) streaming diagnostics frame.
///
/// ── Wire layout — 36 bytes (value[0..35]) ────────────────────────────────────
/// Sourced from UpdateDiagLabel() and label assignment logic in the WinForms app.
/// Column mapping confirmed from tableLayoutPanel1 Designer.cs:
/// col 0/2 = definition label (static text)
/// col 1/3 = value label (updated each frame)
///
/// Byte Channel Notes / Display
/// ───── ───────────────────────── ──────────────────────────────────────────
/// [0] (TL command = 0x70) Packet type, not a data channel
/// [1] (reserved / seq)
/// [2] (reserved)
/// [3] (reserved)
/// [4] Load Raw load value
/// [5] RPM_raw × 100 = display RPM
/// [6] Baro_kPa Barometric pressure kPa
/// [7] VBAT_deciV Battery voltage (decivolts)
/// [8] FuelStartAngle1_raw × 3 = display degrees (label71)
/// [9] FuelStartAngle2_raw × 3 = display degrees (label71a)
/// [10] FuelPW1_lo Combined: [10] + 256×[11] = fuel PW 1
/// [11] FuelPW1_hi
/// [12] SparkAngle1 unchecked sbyte
/// [13] SparkAngle2 unchecked sbyte
/// [14] CrankSyncLostCounter
/// [15] SparkPulseWidth
/// [16] FuelEndAngle_lo Combined: [16] + 256×[17]
/// [17] FuelEndAngle_hi
/// [18] TPS_Raw Raw TPS value (label78 = "TPS Raw")
/// [19] CrankState_packed [19] & 0x0F = CrankState, [19] & 0xF0 >> 4 = TC_Mode
/// [20] ETEMP_DegC Engine temperature °C
/// [21] IAT_DegC Intake air temperature °C
/// [22] TPS_Percent TPS as percentage (used for gauge + tracker)
/// [23] MAP_kPa Manifold absolute pressure kPa
/// [24] O2_AirFuel_x10 AFR × 10 (e.g. 145 = 14.5 AFR)
/// [25] MAP_Lo_Avg_kPa
/// [26] MAP_Hi_Avg_kPa + ([29] & 0x10) × 16 = extra speed bit (2026/04/06)
/// [27] Baro_Dynamic
/// [28] ThrottleState_packed [28] & 0x0F = ThrottleState, [28] & 0x10 = FuelPW_Limit
/// [29] RPMState_packed [29] & 0x0F = RPMState, [29] & 0x80 = StayTuned,
/// [29] & 0x20 = Mode, [29] & 0x10 = extra speed bit
/// [30] UMState_packed [30] & 0x0F = UMState, [30] & 0xF0 >> 4 = GearRatio
/// [31] ErrorState1 Bit-packed analog errors (current)
/// [32] ErrorState2 Bit-packed output errors (current)
/// [33] ErrorState1_Persistent Bit-packed analog errors (persistent)
/// [34] ErrorState2_Persistent Bit-packed output errors (persistent) (also captureError arg 3)
/// [35] ErrorState_Extra Bit-packed output errors persistent (captureError arg 4)
///
/// ── Tracker channels ──────────────────────────────────────────────────────────
/// Load tracker : uses value[4] (Load)
/// RPM tracker : uses value[5] (RPM_raw)
/// TPS tracker : uses value[22] (TPS_Percent) ← for user-adjust tables (diag4/5/10/11/12)
///
/// ── CrankState display values ─────────────────────────────────────────────────
/// 5 = Yellow (near-sync), 6 = Green (running), other = Red (lost/searching)
///
/// ── UMState display values ────────────────────────────────────────────────────
/// 0=INIT, 1=STOP, 2=START, 3=RUN, 4=CUT, 5=SAFEMODE_RUN, 6=SAFEMODE_CUT,
/// 7=LAUNCHBOSS, 8=LAUNCHBOSS_CUT
///
public sealed class DiagnosticsFrame
{
public const int FrameBytes = 36;
// ── Identity ─────────────────────────────────────────────────────────────
public byte SeqNum { get; init; }
public DateTime ReceivedAt { get; init; }
// ── Primary channels ─────────────────────────────────────────────────────
public byte Load { get; init; } // [4]
public byte RPM_Raw { get; init; } // [5] × 100 = RPM
public byte Baro_kPa { get; init; } // [6]
public byte VBAT_deciV { get; init; } // [7]
// ── Fuel channels ────────────────────────────────────────────────────────
public byte FuelStartAngle1_Raw { get; init; } // [8] × 3 = degrees
public byte FuelStartAngle2_Raw { get; init; } // [9] × 3 = degrees
public int FuelPulseWidth1 { get; init; } // [10] + 256×[11]
public int FuelEndAngle { get; init; } // [16] + 256×[17]
// ── Spark channels ────────────────────────────────────────────────────────
public sbyte SparkAngle1 { get; init; } // [12] sbyte
public sbyte SparkAngle2 { get; init; } // [13] sbyte
public byte SparkPulseWidth { get; init; } // [15]
// ── Crank ────────────────────────────────────────────────────────────────
public byte CrankSyncLostCounter { get; init; } // [14]
public byte CrankState_Raw { get; init; } // [19] raw packed byte
public byte TPS_Raw { get; init; } // [18]
// ── Sensor channels ──────────────────────────────────────────────────────
public byte ETEMP_DegC { get; init; } // [20]
public byte IAT_DegC { get; init; } // [21]
public byte TPS_Percent { get; init; } // [22]
public byte MAP_kPa { get; init; } // [23]
public byte O2_AFR_x10 { get; init; } // [24] ÷ 10 = AFR
public byte MAP_Lo_Avg { get; init; } // [25]
public byte MAP_Hi_Avg_Raw{ get; init; } // [26] raw (extra bit in [29])
public byte Baro_Dynamic { get; init; } // [27]
// ── State packed bytes ────────────────────────────────────────────────────
public byte ThrottleState_Packed { get; init; } // [28]
public byte RPMState_Packed { get; init; } // [29]
public byte UMState_Packed { get; init; } // [30]
// ── Error bytes ──────────────────────────────────────────────────────────
// captureError(value[32], value[33], value[34], value[35])
// = captureError(analogError, analogErrorP, outputError, outputErrorP)
public byte ErrorsFatal { get; init; } // [31] raw display only (label91)
public byte AnalogError_Current { get; init; } // [32] analogError
public byte AnalogError_Persistent { get; init; } // [33] analogErrorP
public byte OutputError_Current { get; init; } // [34] outputError
public byte OutputError_Persistent { get; init; } // [35] outputErrorP
// ── Derived display values ────────────────────────────────────────────────
public int RPM => RPM_Raw * 100;
public int FuelStartAngle1_Deg => FuelStartAngle1_Raw * 3;
public int FuelStartAngle2_Deg => FuelStartAngle2_Raw * 3;
public double O2_AFR => O2_AFR_x10 / 10.0;
public double VBAT_Volts => VBAT_deciV / 10.0;
// [19] CrankState nibbles
public int CrankState => CrankState_Raw & 0x0F;
public int TC_Mode => (CrankState_Raw & 0xF0) >> 4;
// [28] ThrottleState
public ThrottleStateValue ThrottleState => (ThrottleStateValue)(ThrottleState_Packed & 0x0F);
public bool FuelPW_LimitActive => (ThrottleState_Packed & 0x10) != 0;
// [29] RPM State
public RPMStateValue RPMState => (RPMStateValue)(RPMState_Packed & 0x0F);
public bool StayTunedRunning => (RPMState_Packed & 0x80) != 0;
public bool ModeSelected => (RPMState_Packed & 0x20) != 0;
public bool SpeedExtraBit => (RPMState_Packed & 0x10) != 0;
// [26] Meter speed with extra bit from [29] (added 2026/04/06)
public int MeterSpeed => MAP_Hi_Avg_Raw + (SpeedExtraBit ? 0x10 * 16 : 0);
// [30] UM State
public UMStateValue UMState => (UMStateValue)(UMState_Packed & 0x0F);
public int GearRatio => (UMState_Packed & 0xF0) >> 4;
// ── Error flags ───────────────────────────────────────────────────────────
public bool[] AnalogErrors_Current => UnpackBits(AnalogError_Current);
public bool[] OutputErrors_Current => UnpackBits(OutputError_Current);
public bool[] AnalogErrors_Persistent => UnpackBits(AnalogError_Persistent);
public bool[] OutputErrors_Persistent => UnpackBits(OutputError_Persistent);
public bool HasActiveError =>
AnalogError_Current != 0 || OutputError_Current != 0;
/// Parsed error flags — ready to drive the 16-indicator error panel.
public ErrorFlags Errors => ErrorFlags.From(this);
// ── Parser ────────────────────────────────────────────────────────────────
///
/// Parses a raw diagnostics frame payload.
/// is the full BLE packet payload starting at byte [0] = 0x70.
/// Byte indices in comments refer to the payload array as used in UpdateDiagLabel().
///
public static DiagnosticsFrame Parse(byte[] data, byte seqNum, DateTime? receivedAt = null)
{
if (data.Length < FrameBytes)
throw new ArgumentException(
$"Expected at least {FrameBytes} bytes, got {data.Length}.", nameof(data));
return new DiagnosticsFrame
{
SeqNum = seqNum,
ReceivedAt = receivedAt ?? DateTime.UtcNow,
Load = data[4],
RPM_Raw = data[5],
Baro_kPa = data[6],
VBAT_deciV = data[7],
FuelStartAngle1_Raw = data[8],
FuelStartAngle2_Raw = data[9],
FuelPulseWidth1 = data[10] + (256 * data[11]),
SparkAngle1 = unchecked((sbyte)data[12]),
SparkAngle2 = unchecked((sbyte)data[13]),
CrankSyncLostCounter = data[14],
SparkPulseWidth = data[15],
FuelEndAngle = data[16] + (256 * data[17]),
TPS_Raw = data[18],
CrankState_Raw = data[19],
ETEMP_DegC = data[20],
IAT_DegC = data[21],
TPS_Percent = data[22],
MAP_kPa = data[23],
O2_AFR_x10 = data[24],
MAP_Lo_Avg = data[25],
MAP_Hi_Avg_Raw = data[26],
Baro_Dynamic = data[27],
ThrottleState_Packed = data[28],
RPMState_Packed = data[29],
UMState_Packed = data[30],
ErrorsFatal = data[31],
AnalogError_Current = data[32],
AnalogError_Persistent = data[33],
OutputError_Current = data[34],
OutputError_Persistent = data[35],
};
}
// ── CSV log format ────────────────────────────────────────────────────────
///
/// Returns a CSV log row matching the format in UpdateDiagLabel().
/// Columns match the .tbd log format used by TracBoss.
///
public string ToCsvRow(string timestamp) =>
$"{timestamp}," +
$"{Load}," +
$"{RPM}," +
$"{Baro_kPa}," +
$"{VBAT_deciV}," +
$"{FuelPulseWidth1}," +
$"{FuelEndAngle}," +
$"{SparkAngle1}," +
$"{SparkAngle2}," +
$"{CrankSyncLostCounter}," +
$"{SparkPulseWidth}," +
$"{FuelEndAngle}," +
$"{TPS_Raw}," +
$"{CrankState_Raw}," +
$"{ETEMP_DegC}," +
$"{IAT_DegC}," +
$"{TPS_Percent}," +
$"{MAP_kPa}," +
$"{O2_AFR_x10}," +
$"{MAP_Lo_Avg}," +
$"{MAP_Hi_Avg_Raw}," +
$"{Baro_Dynamic}," +
$"{ThrottleState_Packed}," +
$"{RPMState_Packed}," +
$"{UMState_Packed}," +
$"{AnalogError_Current}," +
$"{OutputError_Current}," +
$"{AnalogError_Persistent}," +
$"{OutputError_Persistent},";
// ── Helpers ───────────────────────────────────────────────────────────────
private static bool[] UnpackBits(byte b) =>
Enumerable.Range(0, 8).Select(i => (b & (1 << i)) != 0).ToArray();
}
// ── State enums ───────────────────────────────────────────────────────────────
public enum ThrottleStateValue : byte
{
Steady = 0,
Accel = 1,
Decel = 2,
}
public enum RPMStateValue : byte
{
Steady = 0,
Decel = 1,
Accel = 2,
}
public enum UMStateValue : byte
{
Init = 0,
Stop = 1,
Start = 2,
Run = 3,
Cut = 4,
SafeMode_Run = 5,
SafeMode_Cut = 6,
LaunchBoss = 7,
LaunchBoss_Cut = 8,
}
///
/// Diagnostics tracker coordinates for highlighting the active cell
/// in a tuning table grid. Produced by getRpmToHighlight/getLoadToHighlight.
///
public sealed record DiagnosticsTracker(
int ColHighlight, // exact RPM column
int ColLowlight, // next RPM column
int RowHighlight, // exact load/TPS row
int RowLowlight); // next load/TPS row
///
/// Parsed error flags from the four error bytes in a DiagnosticsFrame.
///
/// Call site (UpdateDiagLabel): captureError(value[32], value[33], value[34], value[35])
/// analogError = [32] AnalogError_Current
/// analogErrorP = [33] AnalogError_Persistent
/// outputError = [34] OutputError_Current
/// outputErrorP = [35] OutputError_Persistent
///
/// Display: Red = active now, Yellow = persistent (ever triggered), Green = clear
///
/// ── Analog errors (err1–err8) bit map ────────────────────────────────────────
/// Bit 0 err1 Throttle Position Sensor
/// Bit 1 err2 Manifold Air Pressure Sensor
/// Bit 2 err3 Intake Air Temperature Sensor
/// Bit 3 err4 Vehicle Down Sensor
/// Bit 4 err5 Engine Temperature Sensor
/// Bit 5 err6 Oxygen Sensor
/// Bit 6 err7 Battery Voltage
/// Bit 7 err8 Aux
///
/// ── Output errors (err9o–err16o) bit map ─────────────────────────────────────
/// Bit 0 err9o Injector 1
/// Bit 1 err10o Injector 2 / Idle Solenoid
/// Bit 2 err11o Fuel Pump
/// Bit 3 err12o Radiator Fan
/// Bit 4 err13o Spark Ignition 1
/// Bit 5 err14o Spark Ignition 2
/// Bit 6 err15o 5V PSU
/// Bit 7 err16o O2H
///
public sealed class ErrorFlags
{
// ── Raw bytes ─────────────────────────────────────────────────────────────
public byte AnalogCurrent { get; init; } // value[32]
public byte AnalogPersistent { get; init; } // value[33]
public byte OutputCurrent { get; init; } // value[34]
public byte OutputPersistent { get; init; } // value[35]
// ── Analog error channels ─────────────────────────────────────────────────
public ErrorStatus TPS => Get(AnalogCurrent, AnalogPersistent, 0);
public ErrorStatus MAP => Get(AnalogCurrent, AnalogPersistent, 1);
public ErrorStatus IAT => Get(AnalogCurrent, AnalogPersistent, 2);
public ErrorStatus VehicleDown => Get(AnalogCurrent, AnalogPersistent, 3);
public ErrorStatus ETemp => Get(AnalogCurrent, AnalogPersistent, 4);
public ErrorStatus OxygenSensor=> Get(AnalogCurrent, AnalogPersistent, 5);
public ErrorStatus BattVoltage => Get(AnalogCurrent, AnalogPersistent, 6);
public ErrorStatus Aux => Get(AnalogCurrent, AnalogPersistent, 7);
// ── Output error channels ─────────────────────────────────────────────────
public ErrorStatus Injector1 => Get(OutputCurrent, OutputPersistent, 0);
public ErrorStatus Injector2_IdleSol => Get(OutputCurrent, OutputPersistent, 1);
public ErrorStatus FuelPump => Get(OutputCurrent, OutputPersistent, 2);
public ErrorStatus RadiatorFan => Get(OutputCurrent, OutputPersistent, 3);
public ErrorStatus SparkIgnition1 => Get(OutputCurrent, OutputPersistent, 4);
public ErrorStatus SparkIgnition2 => Get(OutputCurrent, OutputPersistent, 5);
public ErrorStatus PSU_5V => Get(OutputCurrent, OutputPersistent, 6);
public ErrorStatus O2Heater => Get(OutputCurrent, OutputPersistent, 7);
// ── Summary ───────────────────────────────────────────────────────────────
public bool HasActiveError =>
AnalogCurrent != 0 || OutputCurrent != 0;
/// All 16 error channels in display order (analog first, then output).
public IEnumerable<(string Name, ErrorStatus Status)> AllErrors()
{
yield return ("Throttle Position Sensor", TPS);
yield return ("Manifold Air Pressure Sensor", MAP);
yield return ("Intake Air Temperature Sensor", IAT);
yield return ("Vehicle Down Sensor", VehicleDown);
yield return ("Engine Temperature Sensor", ETemp);
yield return ("Oxygen Sensor", OxygenSensor);
yield return ("Battery Voltage", BattVoltage);
yield return ("Aux", Aux);
yield return ("Injector 1", Injector1);
yield return ("Injector 2 / Idle Solenoid", Injector2_IdleSol);
yield return ("Fuel Pump", FuelPump);
yield return ("Radiator Fan", RadiatorFan);
yield return ("Spark Ignition 1", SparkIgnition1);
yield return ("Spark Ignition 2", SparkIgnition2);
yield return ("5V PSU", PSU_5V);
yield return ("O2 Heater", O2Heater);
}
// ── Factory ───────────────────────────────────────────────────────────────
public static ErrorFlags From(DiagnosticsFrame frame) => new()
{
AnalogCurrent = frame.AnalogError_Current,
AnalogPersistent = frame.AnalogError_Persistent,
OutputCurrent = frame.OutputError_Current,
OutputPersistent = frame.OutputError_Persistent,
};
public static ErrorFlags Clear => new()
{
AnalogCurrent = 0, AnalogPersistent = 0,
OutputCurrent = 0, OutputPersistent = 0,
};
// ── Helper ────────────────────────────────────────────────────────────────
private static ErrorStatus Get(byte current, byte persistent, int bit)
{
bool isActive = (current & (1 << bit)) != 0;
bool wasPersistent= (persistent & (1 << bit)) != 0;
if (isActive) return ErrorStatus.Active;
if (wasPersistent) return ErrorStatus.Persistent;
return ErrorStatus.Clear;
}
}
///
/// Three-state error status matching the traffic-light display:
/// Active = Red (currently faulted)
/// Persistent = Yellow (was faulted this session, now cleared)
/// Clear = Green (no fault)
///
public enum ErrorStatus
{
Clear,
Persistent,
Active,
}