onlyn00bs-badge

test_log.h (1824B)

---

 #pragma once
 //  Test-mode CSV logger — a minimal append-only log over LittleFS, used by TEST
 //  MODE (toggled in the OPTIONS menu) to capture diagnostics for later analysis.
 //  Each instance owns one file: it appends one preformatted CSV line per sample
 //  (flushed immediately by closing, so a brownout can't eat the tail), writes its
 //  header lazily on the first line, caps the file by byte size (a safety valve so
 //  a forgotten test badge can't fill flash), and can dump itself to a Stream. The
 //  sampling CADENCE lives in the caller — this is just persistence + retrieval.
 //  Adding a new metric = a new TestLog instance; that's the whole "room for more".
 #include <Arduino.h>
 #include <LittleFS.h>
 #include "config.h"
 
 #ifndef TEST_LOG_MAX_BYTES
 #define TEST_LOG_MAX_BYTES 65536
 #endif
 
 class TestLog {
 public:
   TestLog(const char* path, const char* header) : _path(path), _header(header) {}
 
   // Append a CSV line (no trailing newline needed). Lazily writes the header to a
   // new/empty file; stops silently once the byte cap is reached.
   void append(const char* line) {
     File f = LittleFS.open(_path, "a");
     if (!f) return;
     if (f.size() == 0)                 f.println(_header);
     if (f.size() < TEST_LOG_MAX_BYTES) f.println(line);
     f.close();
   }
 
   // Dump the whole file to `out` — the retrieval path: plug in USB, read serial.
   void dump(Stream& out) const {
     out.print("==== "); out.print(_path); out.println(" ====");
     File f = LittleFS.open(_path, "r");
     if (!f) { out.println("(none)"); return; }
     while (f.available()) out.write(f.read());
     f.close();
     out.println("==== end ====");
   }
 
   // Start a fresh capture (called when test mode is enabled).
   void reset() { LittleFS.remove(_path); }
 
 private:
   const char* _path;
   const char* _header;
 };