feat: implement sensor calibration flow

2026-05-21 16:19:43 +02:00
parent acbba735a0
commit cf3019f484
9 changed files with 1370 additions and 8 deletions
@@ -0,0 +1,71 @@
+enum CalibrationPhase { idle, ready, collecting, done, error }
+
+const calibrationDistances = [0.5, 1.0, 2.0, 3.0];
+
+class CalibrationState {
+  const CalibrationState({
+    this.phase = CalibrationPhase.idle,
+    this.samplesNeeded = 0,
+    this.samplesCollected = 0,
+    this.selectedDistance,
+    this.completedDistances = const {},
+    this.waveform = const [],
+    this.latestRssi,
+    this.avgRssi,
+    this.resultRssiRef,
+    this.resultPathLossExp,
+    this.error,
+  });
+
+  final CalibrationPhase phase;
+  final int samplesNeeded;
+  final int samplesCollected;
+  final double? selectedDistance;
+  final Set<double> completedDistances;
+  /// Circular buffer of recent RSSI readings for the waveform, max 30.
+  final List<double> waveform;
+  final double? latestRssi;
+  final double? avgRssi;
+  final double? resultRssiRef;
+  final double? resultPathLossExp;
+  final String? error;
+
+  bool get canFinish =>
+      completedDistances.length >= 2 && phase != CalibrationPhase.collecting;
+
+  double get progress =>
+      samplesNeeded == 0 ? 0 : samplesCollected / samplesNeeded;
+
+  CalibrationState copyWith({
+    CalibrationPhase? phase,
+    int? samplesNeeded,
+    int? samplesCollected,
+    double? selectedDistance,
+    Set<double>? completedDistances,
+    List<double>? waveform,
+    double? latestRssi,
+    double? avgRssi,
+    double? resultRssiRef,
+    double? resultPathLossExp,
+    String? error,
+    bool clearSelectedDistance = false,
+    bool clearLatestRssi = false,
+    bool clearAvgRssi = false,
+    bool clearError = false,
+  }) =>
+      CalibrationState(
+        phase: phase ?? this.phase,
+        samplesNeeded: samplesNeeded ?? this.samplesNeeded,
+        samplesCollected: samplesCollected ?? this.samplesCollected,
+        selectedDistance: clearSelectedDistance
+            ? null
+            : selectedDistance ?? this.selectedDistance,
+        completedDistances: completedDistances ?? this.completedDistances,
+        waveform: waveform ?? this.waveform,
+        latestRssi: clearLatestRssi ? null : latestRssi ?? this.latestRssi,
+        avgRssi: clearAvgRssi ? null : avgRssi ?? this.avgRssi,
+        resultRssiRef: resultRssiRef ?? this.resultRssiRef,
+        resultPathLossExp: resultPathLossExp ?? this.resultPathLossExp,
+        error: clearError ? null : error ?? this.error,
+      );
+}