namespace TuneBoss.Core.Models; /// /// Data model for an AFR Target table (AFR_Target1, AFR_Target2). /// /// Structurally identical to TuningTable (24 cols × 8 rows, same split read/write, /// same wire layout) but with a critical difference in value encoding: /// /// ── Fixed-point ×10 encoding ───────────────────────────────────────────────── /// All cell values are stored as byte × 10 on the wire. /// Wire byte 145 = AFR 14.5, byte 137 = AFR 13.7, etc. /// Display range set by caller: minDataVal=0.0, maxDataVal=15.0 (from populateInitTables) /// /// ── Modifier encoding ───────────────────────────────────────────────────────── /// MaxRaw / MinRaw are also stored ×10 on wire: /// modifiersInArray[0] = (byte)(maxRawVal * 10.0) /// modifiersInArray[1] = (byte)(minRawVal * 10.0) /// modifiersInArray[2] = (byte)multRawVal (same as TuningTable) /// modifiersInArray[3] = (byte)signRawVal (same as TuningTable) /// Confirmed from writeBtn_Click and prepareAllData() in TuningTablePanelAFR.cs. /// /// ── Button increments ──────────────────────────────────────────────────────── /// +/- large = 5.0 AFR (minusFive_Click / plusFive_Click) /// +/- small = 0.1 AFR (minusOne_Click / plusOne_Click) ← different from TuningTable /// Validated as double, displayed as "N1" (1 decimal place). /// /// ── Wire format ────────────────────────────────────────────────────────────── /// Identical layout to TuningTable (228 bytes, split at 0x7F): /// [0..191] Data — 192 bytes, row-major, each byte = AFR × 10 /// [192..199] Load — 8 bytes /// [200..223] RPM — 24 bytes, each × 100 = display RPM /// [224] MaxRaw — stored as byte = maxAFR × 10 /// [225] MinRaw — stored as byte = minAFR × 10 /// [226] Mult /// [227] Sign /// /// Read length from populateInitTables: 0xEF (239) — larger than TuningTable's 0xE3. /// public sealed record AfrTable { public const int Cols = 24; public const int Rows = 8; public const int DataBytes = Cols * Rows; // 192 public const int SplitFirstLength = 0x7F; // 127 — same as TuningTable public const int TotalPayloadBytes = DataBytes + Rows + Cols + 4; // 228 public const byte ReadLength = 0xEF; // 239 — from populateInitTables // ── Raw wire arrays ─────────────────────────────────────────────────────── /// 192 bytes, row-major [row * 24 + col]. Wire value = AFR × 10. public byte[] Data { get; init; } = new byte[DataBytes]; /// 8 bytes — load axis (0–110). public byte[] LoadAxis { get; init; } = new byte[Rows]; /// 24 bytes — RPM axis, each × 100 = display RPM. public byte[] RpmAxis { get; init; } = new byte[Cols]; // ── Modifiers [224–227] ─────────────────────────────────────────────────── /// Wire: maxAFR × 10. E.g. byte 150 = AFR 15.0. public byte MaxRaw { get; init; } /// Wire: minAFR × 10. E.g. byte 0 = AFR 0.0. public byte MinRaw { get; init; } public byte Mult { get; init; } public byte Sign { get; init; } // ── Derived display values ──────────────────────────────────────────────── public bool IsSigned => Sign > 0; /// Display AFR value for a cell (wire byte ÷ 10.0). public double GetCell(int row, int col) { byte raw = Data[row * Cols + col]; return IsSigned ? unchecked((sbyte)raw) / 10.0 : raw / 10.0; } /// Max AFR display value. public double MaxAfrDisplay => IsSigned ? unchecked((sbyte)MaxRaw) / 10.0 : MaxRaw / 10.0; /// Min AFR display value. public double MinAfrDisplay => IsSigned ? unchecked((sbyte)MinRaw) / 10.0 : MinRaw / 10.0; /// RPM axis in display units (raw × 100). public int[] RpmValues => RpmAxis.Select(r => r * 100).ToArray(); /// Load axis values (raw, 0–110). public int[] LoadValues => LoadAxis.Select(l => (int)l).ToArray(); // ── Serialisation ───────────────────────────────────────────────────────── /// /// Builds the combined 228-byte write payload. /// Matches prepareAllData() / writeBtn_Click() in TuningTablePanelAFR.cs. /// Modifier bytes [224–225] are stored as AFR × 10. /// public byte[] ToWirePayload() { var buf = new byte[TotalPayloadBytes]; Buffer.BlockCopy(Data, 0, buf, 0, DataBytes); Buffer.BlockCopy(LoadAxis,0, buf, DataBytes, Rows); Buffer.BlockCopy(RpmAxis, 0, buf, DataBytes + Rows, Cols); buf[DataBytes + Rows + Cols] = MaxRaw; buf[DataBytes + Rows + Cols + 1] = MinRaw; buf[DataBytes + Rows + Cols + 2] = Mult; buf[DataBytes + Rows + Cols + 3] = Sign; return buf; } public byte[] ToWirePayloadPart1() => ToWirePayload()[..(SplitFirstLength + 1)]; public byte[] ToWirePayloadPart2() => ToWirePayload()[(SplitFirstLength + 1)..]; // ── Deserialisation ─────────────────────────────────────────────────────── /// /// Parses a combined 228-byte buffer from two split read responses. /// Matches sendReadSplitTableToPanelThread (AFR path) in Form1_TableHandling.cs. /// public static AfrTable FromWirePayload(byte[] combined) { if (combined.Length < TotalPayloadBytes) throw new ArgumentException( $"Expected {TotalPayloadBytes} bytes, got {combined.Length}.", nameof(combined)); var data = new byte[DataBytes]; var loadAxis = new byte[Rows]; var rpmAxis = new byte[Cols]; Buffer.BlockCopy(combined, 0, data, 0, DataBytes); Buffer.BlockCopy(combined, DataBytes, loadAxis,0, Rows); Buffer.BlockCopy(combined, DataBytes + Rows, rpmAxis, 0, Cols); int modBase = DataBytes + Rows + Cols; return new AfrTable { Data = data, LoadAxis = loadAxis, RpmAxis = rpmAxis, MaxRaw = combined[modBase], MinRaw = combined[modBase + 1], Mult = combined[modBase + 2], Sign = combined[modBase + 3], }; } /// /// Assembles from two raw device response buffers (data starts at offset 4). /// public static AfrTable FromSplitResponses(byte[] part1Response, byte[] part2Response) { var combined = new byte[TotalPayloadBytes]; Buffer.BlockCopy(part1Response, 4, combined, 0, SplitFirstLength + 1); int part2Len = TotalPayloadBytes - (SplitFirstLength + 1); Buffer.BlockCopy(part2Response, 4, combined, SplitFirstLength + 1, part2Len); return FromWirePayload(combined); } // ── Mutation ────────────────────────────────────────────────────────────── /// /// Returns a new AfrTable with cell (row, col) adjusted by delta (in AFR units, e.g. 0.1). /// Delta is converted to wire units (×10) before clamping. /// Matches minusButton/addButton in TuningTablePanelAFR.cs. /// public AfrTable WithCellAdjusted(int row, int col, double deltaAfr, double minAfr = 0.0, double maxAfr = 15.0) { var newData = (byte[])Data.Clone(); int idx = row * Cols + col; double current = GetCell(row, col); double adjusted = Math.Clamp(current + deltaAfr, minAfr, maxAfr); // Round to 1 decimal place then encode ×10 double rounded = Math.Round(adjusted, 1, MidpointRounding.AwayFromZero); newData[idx] = IsSigned ? unchecked((byte)(sbyte)(rounded * 10.0)) : (byte)(rounded * 10.0); return new AfrTable { Data = newData, LoadAxis = LoadAxis, RpmAxis = RpmAxis, MaxRaw = MaxRaw, MinRaw = MinRaw, Mult = Mult, Sign = Sign, }; } // ── Convenience ────────────────────────────────────────────────────────── /// /// Returns modifier bytes as stored on wire. /// MaxRaw/MinRaw are AFR × 10; Mult/Sign are unchanged. /// public byte[] ToModifierBytes() => new[] { MaxRaw, MinRaw, Mult, Sign }; /// /// Builds modifier bytes from display AFR values for writing. /// Matches: modifiersInArray[0] = (byte)(maxRawVal * 10.0) /// public static byte[] BuildModifierBytes(double maxAfr, double minAfr, byte mult = 1, byte sign = 0) => new[] { (byte)(maxAfr * 10.0), (byte)(minAfr * 10.0), mult, sign }; }