feat: updates to 0.8.0 - initial write functions

minimateplus/client.py

@@ -45,6 +45,10 @@ from .protocol import MiniMateProtocol, ProtocolError
 from .protocol import (
     SUB_SERIAL_NUMBER,
     SUB_FULL_CONFIG,
+    SUB_WRITE_CONFIRM_A,
+    SUB_WRITE_CONFIRM_B,
+    SUB_WRITE_CONFIRM_C,
+    SUB_TRIGGER_CONFIRM,
 )
 from .transport import SerialTransport, BaseTransport
 
@@ -527,6 +531,74 @@ class MiniMateClient:
         else:
             log.warning("download_waveform: waveform decode produced no samples")
 
+    # ── Write commands ────────────────────────────────────────────────────────
+
+    def push_config_raw(
+        self,
+        event_index_data: bytes,
+        compliance_data: bytes,
+        trigger_data: bytes,
+        waveform_data: bytes,
+    ) -> None:
+        """
+        Push a complete config update to the device using the confirmed write
+        sequence from the 3-11-26 BW TX capture.
+
+        This is the raw-bytes interface — callers supply pre-encoded payloads for
+        each write block.  A higher-level method that encodes from ComplianceConfig
+        and re-reads the current payloads first can be built on top of this.
+
+        Full write sequence (confirmed from 3-11-26 BW TX capture frames 102–112):
+
+            SUB 68 → event index write   → ack SUB 0x97
+            SUB 73 → confirm B           → ack SUB 0x8C
+            SUB 71 (×3 chunks) → compliance write  → each ack SUB 0x8E
+            SUB 72 → confirm A           → ack SUB 0x8D
+            SUB 82 → trigger config write → ack SUB 0x7D
+            SUB 83 → trigger confirm     → ack SUB 0x7C
+            SUB 69 → waveform data write  → ack SUB 0x96
+            SUB 74 → confirm C           → ack SUB 0x8B
+            SUB 72 → confirm A           → ack SUB 0x8D
+
+        Args:
+            event_index_data:  Raw bytes for SUB 68 write (88-byte event index).
+            compliance_data:   Raw bytes for SUB 71 write (≥2082 bytes, 3 chunks).
+            trigger_data:      Raw bytes for SUB 82 write (44-byte trigger config).
+            waveform_data:     Raw bytes for SUB 69 write.
+
+        Raises:
+            RuntimeError:   if the client is not connected.
+            ProtocolError:  if any write step fails (timeout, bad ack SUB).
+            ValueError:     if compliance_data is too short for the 3-chunk split.
+        """
+        proto = self._require_proto()
+
+        # 68 → 73
+        log.info("push_config_raw: write event index (SUB 68)")
+        proto.write_event_index(event_index_data)
+        log.info("push_config_raw: confirm B (SUB 73)")
+        proto.write_confirm(SUB_WRITE_CONFIRM_B)
+
+        # 71×3 → 72  (handled internally by write_compliance_config_raw)
+        log.info("push_config_raw: write compliance config (SUB 71 ×3 + confirm 72)")
+        proto.write_compliance_config_raw(compliance_data)
+
+        # 82 → 83
+        log.info("push_config_raw: write trigger config (SUB 82)")
+        proto.write_trigger_config(trigger_data)
+        log.info("push_config_raw: trigger confirm (SUB 83)")
+        proto.write_confirm(SUB_TRIGGER_CONFIRM)
+
+        # 69 → 74 → 72
+        log.info("push_config_raw: write waveform data (SUB 69)")
+        proto.write_waveform_data(waveform_data)
+        log.info("push_config_raw: confirm C (SUB 74)")
+        proto.write_confirm(SUB_WRITE_CONFIRM_C)
+        log.info("push_config_raw: confirm A (SUB 72)")
+        proto.write_confirm(SUB_WRITE_CONFIRM_A)
+
+        log.info("push_config_raw: complete")
+
     # ── Internal helpers ──────────────────────────────────────────────────────
 
     def _require_proto(self) -> MiniMateProtocol: