slopfixing / issue 004

webui/src/context/telemetryViews.js

@@ -0,0 +1,218 @@
+// Telemetry Views
+// Purpose: Defines small, stable telemetry projections for UI components.
+// Scope: Keeps rendering subscriptions focused on the sensor fields each view actually uses.
+
+import { shallowArrayEqual, shallowObjectEqual } from './TelemetryContext.jsx';
+
+export const EMPTY_MAP_TELEMETRY = Object.freeze({
+  bumpLeft: false,
+  bumpRight: false,
+  wheelDropLeft: false,
+  wheelDropRight: false,
+  leftWheelOvercurrent: false,
+  rightWheelOvercurrent: false,
+  sideBrushOvercurrent: false,
+  mainBrushOvercurrent: false,
+  wheelLeftCurrentMa: 0,
+  wheelRightCurrentMa: 0,
+  sideBrushCurrentMa: 0,
+  mainBrushCurrentMa: 0,
+  lightBumpLeftSignal: null,
+  lightBumpFrontLeftSignal: null,
+  lightBumpCenterLeftSignal: null,
+  lightBumpCenterRightSignal: null,
+  lightBumpFrontRightSignal: null,
+  lightBumpRightSignal: null,
+  cliffLeftSignal: null,
+  cliffFrontLeftSignal: null,
+  cliffFrontRightSignal: null,
+  cliffRightSignal: null,
+  cliffLeft: false,
+  cliffFrontLeft: false,
+  cliffFrontRight: false,
+  cliffRight: false,
+  dirtDetectLeft: null,
+  dirtDetect: null,
+});
+
+const EMPTY_BATTERY_TELEMETRY = Object.freeze({
+  batteryChargeMah: null,
+  batteryCapacityMah: null,
+});
+
+const EMPTY_DOCK_TELEMETRY = Object.freeze({
+  oiModeLabel: 'Unknown',
+  chargingStateLabel: '',
+  homeBase: false,
+});
+
+const EMPTY_SPECTATOR_TELEMETRY = Object.freeze({
+  voltageMv: null,
+  currentMa: null,
+  batteryChargeMah: null,
+  oiModeLabel: 'Unknown',
+  chargingStateLabel: '',
+  homeBase: false,
+});
+
+const EMPTY_HOST_STATS = Object.freeze({});
+const EMPTY_OVERCURRENT_FLAGS = Object.freeze({
+  leftWheel: false,
+  rightWheel: false,
+  mainBrush: false,
+  sideBrush: false,
+});
+const EMPTY_MAIN_BRUSH_AUDIO = Object.freeze({
+  mainBrushCurrentMa: 0,
+  mainBrushOvercurrent: false,
+});
+
+function bucketNumber(value, step) {
+  // Visual widgets do not benefit from repainting for tiny analog jitter. The
+  // bucket step intentionally applies only to display selectors; raw telemetry
+  // remains available through useTelemetryFrame for control and debugging code.
+  if (value == null || !Number.isFinite(Number(value))) return value ?? null;
+  return Math.round(Number(value) / step) * step;
+}
+
+export function mapTelemetryEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function batteryTelemetryEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function dockTelemetryEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function hostStatsEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function selectVisualMapTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return EMPTY_MAP_TELEMETRY;
+  const bumps = sensors.bumpsAndWheelDrops || {};
+  const wheelOver = sensors.wheelOvercurrents || {};
+  return {
+    bumpLeft: Boolean(bumps.bumpLeft),
+    bumpRight: Boolean(bumps.bumpRight),
+    wheelDropLeft: Boolean(bumps.wheelDropLeft),
+    wheelDropRight: Boolean(bumps.wheelDropRight),
+    leftWheelOvercurrent: Boolean(wheelOver.leftWheel),
+    rightWheelOvercurrent: Boolean(wheelOver.rightWheel),
+    sideBrushOvercurrent: Boolean(wheelOver.sideBrush),
+    mainBrushOvercurrent: Boolean(wheelOver.mainBrush),
+    wheelLeftCurrentMa: bucketNumber(sensors.wheelLeftCurrentMa ?? 0, 25),
+    wheelRightCurrentMa: bucketNumber(sensors.wheelRightCurrentMa ?? 0, 25),
+    sideBrushCurrentMa: bucketNumber(sensors.sideBrushCurrentMa ?? 0, 25),
+    mainBrushCurrentMa: bucketNumber(sensors.mainBrushCurrentMa ?? 0, 25),
+    lightBumpLeftSignal: bucketNumber(sensors.lightBumpLeftSignal, 25),
+    lightBumpFrontLeftSignal: bucketNumber(sensors.lightBumpFrontLeftSignal, 25),
+    lightBumpCenterLeftSignal: bucketNumber(sensors.lightBumpCenterLeftSignal, 25),
+    lightBumpCenterRightSignal: bucketNumber(sensors.lightBumpCenterRightSignal, 25),
+    lightBumpFrontRightSignal: bucketNumber(sensors.lightBumpFrontRightSignal, 25),
+    lightBumpRightSignal: bucketNumber(sensors.lightBumpRightSignal, 25),
+    cliffLeftSignal: bucketNumber(sensors.cliffLeftSignal, 25),
+    cliffFrontLeftSignal: bucketNumber(sensors.cliffFrontLeftSignal, 25),
+    cliffFrontRightSignal: bucketNumber(sensors.cliffFrontRightSignal, 25),
+    cliffRightSignal: bucketNumber(sensors.cliffRightSignal, 25),
+    cliffLeft: Boolean(sensors.cliffLeft),
+    cliffFrontLeft: Boolean(sensors.cliffFrontLeft),
+    cliffFrontRight: Boolean(sensors.cliffFrontRight),
+    cliffRight: Boolean(sensors.cliffRight),
+    dirtDetectLeft: bucketNumber(sensors.dirtDetectLeft, 1),
+    dirtDetect: bucketNumber(sensors.dirtDetect, 1),
+  };
+}
+
+export function selectLightBumpTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return [];
+  return [
+    bucketNumber(sensors.lightBumpLeftSignal, 25),
+    bucketNumber(sensors.lightBumpFrontLeftSignal, 25),
+    bucketNumber(sensors.lightBumpCenterLeftSignal, 25),
+    bucketNumber(sensors.lightBumpCenterRightSignal, 25),
+    bucketNumber(sensors.lightBumpFrontRightSignal, 25),
+    bucketNumber(sensors.lightBumpRightSignal, 25),
+  ];
+}
+
+export function lightBumpTelemetryEqual(left, right) {
+  return shallowArrayEqual(left, right);
+}
+
+export function selectBatteryTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return EMPTY_BATTERY_TELEMETRY;
+  return {
+    batteryChargeMah: sensors.batteryChargeMah ?? null,
+    batteryCapacityMah: sensors.batteryCapacityMah ?? null,
+  };
+}
+
+export function selectOvercurrentFlags(frame) {
+  const wheelOvercurrents = frame?.sensors?.wheelOvercurrents;
+  if (!wheelOvercurrents) return EMPTY_OVERCURRENT_FLAGS;
+  return {
+    leftWheel: Boolean(wheelOvercurrents.leftWheel),
+    rightWheel: Boolean(wheelOvercurrents.rightWheel),
+    mainBrush: Boolean(wheelOvercurrents.mainBrush),
+    sideBrush: Boolean(wheelOvercurrents.sideBrush),
+  };
+}
+
+export function selectMainBrushAudioTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return EMPTY_MAIN_BRUSH_AUDIO;
+  return {
+    mainBrushCurrentMa: bucketNumber(sensors.mainBrushCurrentMa ?? 0, 25),
+    mainBrushOvercurrent: Boolean(sensors.wheelOvercurrents?.mainBrush),
+  };
+}
+
+export function mainBrushAudioTelemetryEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function overcurrentFlagsEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function selectDockTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return EMPTY_DOCK_TELEMETRY;
+  return {
+    oiModeLabel: sensors.oiMode?.label || 'Unknown',
+    chargingStateLabel: sensors.chargingState?.label || '',
+    homeBase: Boolean(sensors.chargingSources?.homeBase),
+  };
+}
+
+export function selectSpectatorTelemetry(frame) {
+  const sensors = frame?.sensors;
+  if (!sensors) return EMPTY_SPECTATOR_TELEMETRY;
+  return {
+    voltageMv: bucketNumber(sensors.voltageMv, 25),
+    currentMa: bucketNumber(sensors.currentMa, 25),
+    batteryChargeMah: sensors.batteryChargeMah ?? null,
+    oiModeLabel: sensors.oiMode?.label || 'Unknown',
+    chargingStateLabel: sensors.chargingState?.label || '',
+    homeBase: Boolean(sensors.chargingSources?.homeBase),
+  };
+}
+
+export function spectatorTelemetryEqual(left, right) {
+  return shallowObjectEqual(left, right);
+}
+
+export function selectHostStats(frame) {
+  return frame?.hostStats || EMPTY_HOST_STATS;
+}
+
+export function selectFrameForDisplay(frame) {
+  return frame || null;
+}