From 4564eb99808c506913d943d2b89f5f34dd5e2fc3 Mon Sep 17 00:00:00 2001
From: GlassOnTin <GlassOnTin@users.noreply.github.com>
Date: Sun, 29 Mar 2026 11:00:06 +0100
Subject: [PATCH] Save profile baseline, add --save option to profile command
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Baseline profile (scripts/profile_baseline.json) captured after
beacon/stopRadio loop fix. Use for regression comparison:
  ./scripts/screenshot.py profile --save scripts/profile_latest.json

Key baseline numbers:
  Idle frame: 914µs, Full frame: 80ms, Data update: 2ms,
  Per-tile nav: 75ms, Main loop: 331µs
---
 scripts/profile_baseline.json | 18 ++++++++++++++++++
 scripts/screenshot.py         | 13 +++++++++----
 2 files changed, 27 insertions(+), 4 deletions(-)
 create mode 100644 scripts/profile_baseline.json

diff --git a/scripts/profile_baseline.json b/scripts/profile_baseline.json
new file mode 100644
index 0000000..073cad5
--- /dev/null
+++ b/scripts/profile_baseline.json
@@ -0,0 +1,18 @@
+{
+  "test": "profile",
+  "build": "Mar 29 2026 10:57:00",
+  "date": "2026-03-29",
+  "device": "T-Watch Ultimate (unprovisioned, hwcdc)",
+  "notes": "Baseline after beacon/stopRadio loop fix. GPS active with fix, radio not provisioned.",
+  "idle_us": 914,
+  "idle_flush_us": 0,
+  "full_us": 79592,
+  "full_flush_us": 37176,
+  "data_update_us": 1939,
+  "nav_5tile_us": 374708,
+  "burst_10frame_us": 801653,
+  "avg_frame_us": 80165,
+  "loop_us": 331,
+  "heap": 7298759,
+  "psram": 7143315
+}
diff --git a/scripts/screenshot.py b/scripts/screenshot.py
index c1ef1e3..0dfb946 100755
--- a/scripts/screenshot.py
+++ b/scripts/screenshot.py
@@ -153,11 +153,11 @@ def cmd_navigate(s, screen):
     print(f"Navigate → {screen} ({col},{row})")
 
 
-def cmd_profile(s):
+def cmd_profile(s, save_path=None):
     """Run standardized performance profile test"""
     send_cmd(s, ord('P'))
     buf = b""
-    deadline = time.time() + 30  # profile test takes several seconds
+    deadline = time.time() + 30
     while time.time() < deadline:
         chunk = s.read(max(1, s.in_waiting or 1))
         if chunk:
@@ -178,6 +178,10 @@ def cmd_profile(s):
                 print(f"Main loop:      {data['loop_us']:>8} µs")
                 print(f"Heap free:      {data['heap']:>8} bytes")
                 print(f"PSRAM free:     {data['psram']:>8} bytes")
+                if save_path:
+                    with open(save_path, 'w') as f:
+                        json.dump(data, f, indent=2)
+                    print(f"Saved: {save_path}")
                 return
     print(f"Timeout ({len(buf)} bytes)")
 
@@ -246,8 +250,9 @@ def main():
 
     sub.add_parser("invalidate", aliases=["inv"])
 
-    sub.add_parser("profile", aliases=["p"],
+    p = sub.add_parser("profile", aliases=["p"],
                     help="Run standardized performance test")
+    p.add_argument("--save", metavar="FILE", help="Save raw JSON to file")
 
     sub.add_parser("log", aliases=["l"],
                     help="Toggle IMU logging to SD card")
@@ -275,7 +280,7 @@ def main():
         elif args.command in ("invalidate", "inv"):
             cmd_invalidate(s)
         elif args.command in ("profile", "p"):
-            cmd_profile(s)
+            cmd_profile(s, getattr(args, 'save', None))
         elif args.command in ("log", "l"):
             cmd_log(s)
         elif args.command in ("files", "f"):