Apple Watch: Übersicht, Ausrichten mit Vibration, Kühlbox am Handgelenk

Neues Target CamperMonitorWatch, eingebettet in die iPhone-App. Die Uhr
zeigt je Gerät den Hauptwert, die Nivellierung mit Libelle und Keilhöhen,
den Ausrichtungs-Assistenten und stellt die Kühlbox.

Die Uhr funkt nicht selbst, obwohl watchOS das könnte. BMS, Kühlbox und
Neigungsmesser lassen jeweils nur eine Verbindung zu – eine mitlesende Uhr
würde dem iPhone die Verbindung wegnehmen, statt sie zu ergänzen. Und die
Victron-Schlüssel liegen in der Keychain des iPhones; sie ein zweites Mal
auf der Uhr aufzubewahren brächte nichts. Das iPhone bleibt also das
Funkgerät und reicht fertige Messwerte über WatchConnectivity weiter.

Gesendet wird in zwei Takten: ein halber Sekundentakt als Nachricht,
solange die Watch-App im Vordergrund ist und das über eine Frist meldet,
sonst alle zwei Sekunden als Anwendungskontext und nur bei Änderungen.
Läuft die Frist ab, hört das iPhone von selbst wieder auf.

Solange die Uhr hinschaut, hält die App das Funkgerät auch im Hintergrund
am Leben (UIBackgroundModes in Config/CamperMonitor-Info.plist) – beim
Rangieren liegt das iPhone sonst mit dunklem Bildschirm in der Halterung
und die Anzeige am Handgelenk wäre genau dann tot. Die verbundenen Geräte
liefern dabei weiter, die Victron-Werbedaten nicht: ungefiltertes Suchen
lässt iOS im Hintergrund nicht zu.

Der plattformneutrale Modellcode wandert nach Shared/ und wird in beide
Targets übersetzt; LevelState ist dafür aus VanAlignProtocol.swift
herausgelöst. Datensatz und Befehle stehen in Shared/WatchLink und sind
in run-tests.sh abgesichert: Rundlauf, Schutz gegen fremde Formatversion,
Vergleich ohne Zeitstempel und die Auflösung der Zeitangaben.

Geprüft sind der Bau beider Targets samt Einbetten und der Testlauf; auf
echter Hardware noch nicht.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
BiasF
2026-08-31 15:20:16 +02:00
co-authored by Claude Opus 5
parent 32659ff0b9
commit 6612b07fd5
31 changed files with 1904 additions and 101 deletions
@@ -0,0 +1,111 @@
import SwiftUI
import WatchKit
/// Der Ausrichtungs-Assistent am Handgelenk der eigentliche Grund für die
/// Uhr: Beim Rangieren hat man das iPhone nicht in der Hand, aber den Arm am
/// Lenkrad. Ein Blick nach unten genügt, und die Rückmeldung steht eben kommt
/// zusätzlich als Vibration, ganz ohne Blick.
///
/// Gerechnet wird mit demselben `AlignmentAssistant` wie am iPhone: kein
/// Ortsbezug, nur der zeitliche Verlauf der Neigung. Was besser und was
/// schlechter wird, steckt vollständig darin.
struct WatchAlignView: View {
let deviceID: UUID
@Environment(PhoneLink.self) private var link
@State private var assistant = AlignmentAssistant()
/// Damit die Vibration einmal kommt und nicht im Sekundentakt.
@State private var hasAnnouncedTarget = false
private var state: LevelState? {
link.payload?.devices.first { $0.id == deviceID }?.level
}
var body: some View {
ScrollView {
VStack(spacing: 8) {
if let current = assistant.current {
Text(String(format: "%.1f°", current.deviation))
.font(.system(size: 40, weight: .semibold, design: .rounded))
.monospacedDigit()
.foregroundStyle(assistant.hasReachedTarget ? .green : .primary)
.contentTransition(.numericText())
} else {
ProgressView()
.padding(.vertical, 12)
}
Label(assistant.trend.text, systemImage: assistant.trend.symbol)
.font(.footnote.weight(.medium))
.foregroundStyle(trendColor)
Text(assistant.advice)
.font(.caption)
.multilineTextAlignment(.center)
.foregroundStyle(.secondary)
if let state {
HStack(spacing: 12) {
WatchBubble(pitch: state.pitch, roll: state.roll)
.frame(width: 56, height: 56)
VStack(alignment: .leading, spacing: 2) {
Text(String(format: "Längs %.1f°", state.pitch ?? 0))
Text(String(format: "Quer %.1f°", state.roll ?? 0))
}
.font(.caption2)
.monospacedDigit()
.foregroundStyle(.secondary)
}
.padding(.top, 2)
}
Button("Von vorn messen", systemImage: "arrow.counterclockwise") {
assistant.reset()
hasAnnouncedTarget = false
}
.font(.caption2)
.padding(.top, 4)
}
.padding(.horizontal, 4)
}
.navigationTitle("Ausrichten")
.onChange(of: reading, initial: true) { _, reading in
guard let reading else { return }
assistant.add(pitch: reading.pitch, roll: reading.roll)
announceIfLevel()
}
}
/// Ein Wertepaar als Auslöser: nur wenn sich wirklich eine Neigung ändert,
/// wird gerechnet nicht bei jedem Datensatz des iPhones.
private var reading: Reading? {
guard let state, let pitch = state.pitch, let roll = state.roll else { return nil }
return Reading(pitch: pitch, roll: roll)
}
private struct Reading: Equatable {
let pitch: Double
let roll: Double
}
private var trendColor: Color {
switch assistant.trend {
case .improving: return .green
case .worsening: return .orange
default: return .secondary
}
}
/// Die Vibration ist der Punkt: Sie sagt anhalten, ohne dass jemand
/// hinschauen muss. Erneut gemeldet wird erst, wenn das Fahrzeug die
/// Toleranz zwischendurch wieder verlassen hat.
private func announceIfLevel() {
if assistant.hasReachedTarget {
guard !hasAnnouncedTarget else { return }
hasAnnouncedTarget = true
WKInterfaceDevice.current().play(.success)
} else {
hasAnnouncedTarget = false
}
}
}
@@ -0,0 +1,77 @@
import SwiftUI
/// Libelle für die Uhr: eine Blase, die dorthin wandert, wo das Fahrzeug
/// **höher** steht wie bei einer echten Wasserwaage.
///
/// Bewusst schlichter als am iPhone: Auf 40 mm Bildschirm ist der innere Ring
/// (die Toleranz) die einzige Hilfslinie, die sich noch ablesen lässt.
struct WatchBubble: View {
let pitch: Double?
let roll: Double?
/// Bis zu welcher Neigung die Anzeige ausschlägt.
var range: Double = 4
var body: some View {
GeometryReader { geometry in
let side = min(geometry.size.width, geometry.size.height)
let radius = side / 2
let bubble = side * 0.22
let travel = radius - bubble / 2 - 2
let tolerance = max(LevelState.levelTolerance / range * travel, bubble * 0.55)
ZStack {
Circle().fill(Color.gray.opacity(0.25))
Circle().strokeBorder(Color.gray.opacity(0.5), lineWidth: 1)
Circle()
.strokeBorder(isLevel ? Color.green : Color.gray.opacity(0.6),
lineWidth: isLevel ? 2 : 1)
.frame(width: tolerance * 2, height: tolerance * 2)
Circle()
.fill(color)
.frame(width: bubble, height: bubble)
// Positiver Pitch heisst: das Heck steht höher, die Blase
// wandert nach oben in der Ansicht also nach hinten.
.offset(x: clamped(roll) / range * travel,
y: -clamped(pitch) / range * travel)
.animation(.spring(duration: 0.3), value: pitch)
.animation(.spring(duration: 0.3), value: roll)
.opacity(pitch == nil && roll == nil ? 0.25 : 1)
}
.frame(width: side, height: side)
.frame(maxWidth: .infinity, maxHeight: .infinity)
}
.aspectRatio(1, contentMode: .fit)
.accessibilityLabel(accessibilityText)
}
/// Hält die Blase im Ring, auch wenn das Fahrzeug stark schräg steht.
private func clamped(_ value: Double?) -> Double {
guard let value else { return 0 }
return min(max(value, -range), range)
}
private var deviation: Double? {
switch (pitch, roll) {
case let (p?, r?): return max(abs(p), abs(r))
case let (p?, nil): return abs(p)
case let (nil, r?): return abs(r)
default: return nil
}
}
private var isLevel: Bool { (deviation ?? .infinity) <= LevelState.levelTolerance }
/// Grün nur, wenn es wirklich eben ist die Akzentfarbe der App ist selbst
/// grün, sonst sähe schief aus wie eben.
private var color: Color {
guard let deviation else { return .gray }
if deviation <= LevelState.levelTolerance { return .green }
return deviation <= 2 ? .orange : .red
}
private var accessibilityText: String {
guard let pitch, let roll else { return "Keine Messwerte" }
return String(format: "Längsneigung %.1f Grad, Querneigung %.1f Grad", pitch, roll)
}
}
@@ -0,0 +1,59 @@
import SwiftUI
/// Alle Werte eines Geräts. Am iPhone stehen hier zusätzlich Verlauf und
/// Diagnose auf der Uhr wäre beides unlesbar und ist deshalb weggelassen.
struct WatchDeviceDetailView: View {
let deviceID: UUID
@Environment(PhoneLink.self) private var link
private var device: WatchDevice? {
link.payload?.devices.first { $0.id == deviceID }
}
var body: some View {
List {
if let device {
if let fridge = device.fridge {
WatchFridgeControls(deviceID: device.id, fridge: fridge)
}
Section {
ForEach(device.snapshot?.metrics.filter { $0.value != nil } ?? []) { metric in
LabeledContent(metric.label) {
Text(metric.formattedWithUnit)
.monospacedDigit()
}
.font(.footnote)
}
} header: {
Text("Messwerte")
}
Section {
if let fault = device.snapshot?.fault {
Label(fault, systemImage: "exclamationmark.triangle.fill")
.font(.caption2)
.foregroundStyle(.red)
}
if let state = device.snapshot?.state {
Text(state).font(.caption2)
}
ForEach(device.snapshot?.offReasons ?? [], id: \.self) { reason in
Text(reason)
.font(.caption2)
.foregroundStyle(.secondary)
}
Label(device.link.label, systemImage: "antenna.radiowaves.left.and.right")
.font(.caption2)
.foregroundStyle(.secondary)
}
} else {
Text("Gerät ist nicht mehr im Fahrzeugprofil.")
.font(.footnote)
.foregroundStyle(.secondary)
}
}
.navigationTitle(device?.name ?? "Gerät")
}
}
@@ -0,0 +1,63 @@
import SwiftUI
/// Die Kühlbox von der Uhr aus stellen das einzige Gerät, das sich stellen
/// lässt.
///
/// Wie am iPhone folgen die Schalter dem Gerät, nicht der Vermutung: Getippt
/// wird ein Befehl, angezeigt wird, was die Box zurückmeldet. Über die Uhr
/// dauert das einen Wimpernschlag länger der Weg geht über das iPhone ,
/// dafür kann kein Schalter etwas behaupten, das die Box nie bestätigt hat.
struct WatchFridgeControls: View {
let deviceID: UUID
let fridge: WatchFridge
@Environment(PhoneLink.self) private var link
var body: some View {
Section {
Toggle("Ein", isOn: Binding(
get: { fridge.isPoweredOn },
set: { link.send(.fridgePower(device: deviceID, on: $0)) }
))
Toggle("Eco", isOn: Binding(
get: { fridge.isEco },
set: { link.send(.fridgeEco(device: deviceID, eco: $0)) }
))
.disabled(!fridge.isPoweredOn)
target(zone: .left,
title: fridge.isDualZone ? "Soll links" : "Soll",
value: fridge.leftTarget)
if fridge.isDualZone {
target(zone: .right, title: "Soll rechts", value: fridge.rightTarget)
}
} header: {
Text("Kühlbox")
} footer: {
if !link.isReachable {
Text("iPhone gerade nicht erreichbar Stellbefehle gehen erst "
+ "wieder durch, wenn es antwortet.")
.font(.caption2)
}
}
}
private func target(zone: WatchFridgeZone, title: String, value: Int?) -> some View {
Stepper(value: Binding(
get: { value ?? fridge.targetRange.lowerBound },
set: { link.send(.fridgeTarget(device: deviceID, zone: zone, value: $0)) }
), in: fridge.targetRange) {
VStack(alignment: .leading, spacing: 0) {
Text(title)
.font(.caption2)
.foregroundStyle(.secondary)
Text(value.map { "\($0) \(fridge.unitSymbol)" } ?? "")
.font(.headline)
.monospacedDigit()
}
}
.disabled(!fridge.isPoweredOn || value == nil)
}
}
@@ -0,0 +1,94 @@
import SwiftUI
/// Nivellierung auf der Uhr: Libelle, Zahlen, und was zu tun ist.
struct WatchLevelView: View {
/// Nur für den Einstieg angezeigt wird immer der Stand aus dem letzten
/// Datensatz, sonst bliebe die Ansicht auf dem Wert vom Öffnen stehen.
let device: WatchDevice
@Environment(PhoneLink.self) private var link
@State private var isCalibrating = false
private var current: WatchDevice { link.payload?.levelDevice ?? device }
private var state: LevelState { current.level ?? LevelState() }
var body: some View {
ScrollView {
VStack(spacing: 10) {
WatchBubble(pitch: state.pitch, roll: state.roll)
.frame(maxWidth: 110)
HStack(spacing: 14) {
angle("Längs", state.pitch)
angle("Quer", state.roll)
}
Text(state.instruction ?? "Keine Werte")
.font(.footnote.weight(.medium))
.multilineTextAlignment(.center)
.foregroundStyle(state.isLevel ? .green : .primary)
if let wedges = wedgeText {
Text(wedges)
.font(.caption2)
.foregroundStyle(.secondary)
.multilineTextAlignment(.center)
}
NavigationLink {
WatchAlignView(deviceID: current.id)
} label: {
Label("Ausrichten", systemImage: "car.side.rear.and.collision.and.car.side.front")
}
.buttonStyle(.borderedProminent)
Button("Kalibrieren", systemImage: "scope") { isCalibrating = true }
.font(.footnote)
if state.isKnownUncalibrated {
Text("Noch nicht kalibriert die Anzeige zeigt die Lage des "
+ "Sensors, nicht die des Fahrzeugs.")
.font(.caption2)
.foregroundStyle(.orange)
.multilineTextAlignment(.center)
}
}
.padding(.horizontal, 4)
}
.navigationTitle("Nivellierung")
.confirmationDialog("Auf aktuelle Lage kalibrieren?",
isPresented: $isCalibrating, titleVisibility: .visible) {
Button("Kalibrieren") { link.send(.calibrateLevel(device: current.id)) }
Button("Abbrechen", role: .cancel) {}
} message: {
Text("Nur sinnvoll, wenn das Fahrzeug jetzt eben steht.")
}
}
private func angle(_ title: String, _ value: Double?) -> some View {
VStack(spacing: 0) {
Text(value.map { String(format: "%.1f°", $0) } ?? "")
.font(.title3.weight(.semibold))
.monospacedDigit()
Text(title)
.font(.caption2)
.foregroundStyle(.secondary)
}
}
/// Wie hoch die Auffahrkeile sein müssen reine Geometrie, und nur zu
/// haben, wenn im Fahrzeugprofil Spurweite und Radstand stehen.
private var wedgeText: String? {
guard let profile = link.payload?.profile else { return nil }
var parts: [String] = []
if let roll = state.roll, let width = profile.trackWidth,
let wedge = LevelingWedge.across(roll: roll, trackWidth: width) {
parts.append(String(format: "%.0f cm %@", wedge.heightInCentimetres, wedge.side.text))
}
if let pitch = state.pitch, let base = profile.wheelbase,
let wedge = LevelingWedge.along(pitch: pitch, wheelbase: base) {
parts.append(String(format: "%.0f cm %@", wedge.heightInCentimetres, wedge.side.text))
}
return parts.isEmpty ? nil : "Keile: " + parts.joined(separator: ", ")
}
}
@@ -0,0 +1,164 @@
import SwiftUI
/// Der Einstieg: das Wichtigste untereinander, in der Reihenfolge, in der man
/// im Wohnmobil danach schaut.
struct WatchRootView: View {
@Environment(PhoneLink.self) private var link
var body: some View {
NavigationStack {
Group {
if let payload = link.payload {
content(for: payload)
} else {
waiting
}
}
.navigationTitle(link.payload?.profile.name ?? "Camper")
}
}
private func content(for payload: WatchPayload) -> some View {
List {
if let level = payload.levelDevice {
Section {
NavigationLink {
WatchLevelView(device: level)
} label: {
LevelSummaryRow(state: level.level, link: level.link)
}
}
}
Section {
ForEach(payload.devices.filter { $0.role != .leveling }) { device in
NavigationLink {
WatchDeviceDetailView(deviceID: device.id)
} label: {
DeviceRow(device: device)
}
}
}
Section {
FreshnessNote(payload: payload, receivedAt: link.receivedAt)
}
}
}
private var waiting: some View {
VStack(spacing: 8) {
Image(systemName: "iphone.gen3.radiowaves.left.and.right")
.font(.title2)
.foregroundStyle(.tint)
Text("Warte auf das iPhone")
.font(.headline)
Text("Die Werte kommen vom iPhone. Dort muss Camper Monitor "
+ "geöffnet sein.")
.font(.caption2)
.foregroundStyle(.secondary)
.multilineTextAlignment(.center)
}
.padding(.horizontal, 4)
}
}
/// Eine Gerätezeile: Name klein, Hauptwert gross auf dem kleinen Bildschirm
/// zählt nur der eine Wert, wegen dem man den Arm hebt.
struct DeviceRow: View {
let device: WatchDevice
var body: some View {
HStack(spacing: 8) {
Image(systemName: device.role.symbol)
.foregroundStyle(.tint)
.frame(width: 20)
VStack(alignment: .leading, spacing: 1) {
Text(device.name)
.font(.caption2)
.foregroundStyle(.secondary)
.lineLimit(1)
if let metric = device.snapshot?.primaryMetric, metric.value != nil {
Text(metric.formattedWithUnit)
.font(.title3.weight(.semibold))
.monospacedDigit()
.foregroundStyle(device.isLive ? .primary : .secondary)
} else {
Text(device.link.label)
.font(.footnote)
.foregroundStyle(.secondary)
}
}
Spacer(minLength: 0)
Circle()
.fill(device.statusColor)
.frame(width: 7, height: 7)
}
}
}
/// Die Nivellierung bekommt eine eigene, grössere Zeile: sie ist der Grund,
/// aus dem man die Uhr im Fahrzeug überhaupt anschaut.
struct LevelSummaryRow: View {
let state: LevelState?
let link: DeviceLinkState
var body: some View {
HStack(spacing: 10) {
WatchBubble(pitch: state?.pitch, roll: state?.roll)
.frame(width: 44, height: 44)
VStack(alignment: .leading, spacing: 2) {
Text("Nivellierung")
.font(.caption2)
.foregroundStyle(.secondary)
// Ohne Messwerte steht hier, woran es liegt, statt eines
// nichtssagenden Strichs.
Text(state?.instruction ?? link.label)
.font(.footnote.weight(.medium))
.lineLimit(2)
}
Spacer(minLength: 0)
}
.padding(.vertical, 2)
}
}
/// Wie alt der Stand ist auf der Uhr die wichtigste Nebenangabe. Alles hier
/// ist weitergereicht; eine abgerissene Strecke zum iPhone sieht sonst genauso
/// aus wie ein Fahrzeug, an dem sich nichts tut.
struct FreshnessNote: View {
let payload: WatchPayload
let receivedAt: Date?
var body: some View {
TimelineView(.periodic(from: .now, by: 1)) { context in
let age = context.date.timeIntervalSince(receivedAt ?? payload.generatedAt)
Label {
Text(text(age: age))
.font(.caption2)
} icon: {
Image(systemName: age > 10 ? "exclamationmark.triangle.fill" : "iphone.gen3")
}
.foregroundStyle(age > 10 ? .orange : .secondary)
}
}
private func text(age: TimeInterval) -> String {
if !payload.isRadioReady { return payload.radioStatus }
if age < 3 { return "Stand: eben" }
if age < 90 { return String(format: "Stand: vor %.0f s", age) }
return String(format: "Stand: vor %.0f min iPhone erreichbar?", age / 60)
}
}
extension WatchDevice {
/// Grün heisst: der Wert ist frisch und kommt vom Gerät selbst.
var statusColor: Color {
switch link {
case .live: return (snapshot?.isStale ?? true) ? .orange : .green
case .needsKey: return .orange
case .failed: return .red
default: return .gray
}
}
}