Files
AeroAlign/docs/AEROALIGN_COG_INTEGRATION.md
T

62 lines
2.4 KiB
Markdown

# AeroAlign + CoG Scale Integration
## Zielbild
Das System wird von einem reinen digitalen Einstellwinkelmesser zu einer gemeinsamen RC-Setup-Plattform erweitert:
- AeroAlign-Knoten messen Pitch/Roll fuer EWD, Ruderausschlag und Bezugswinkel.
- CoG-Scale-Knoten messen Front- und Heckauflagegewicht ueber Load Cells.
- Ein gemeinsamer ESP32-Master sammelt beide Geraeteklassen ueber ESP-NOW und stellt alles in derselben Web-Oberflaeche bereit.
## Externe Referenz
Die geplante CoG-Funktion orientiert sich konzeptionell an diesem Projekt:
- [RC plane Center of Gravity finder | Hackaday.io](https://hackaday.io/project/202834-rc-plane-center-of-gravity-finder/details)
Aus der Referenz uebernommen:
- zwei digitale Waagen mit ESP32
- Front- und Heckgewicht als Echtzeitdaten
- CoG-Berechnung aus dem Abstand der Auflagepunkte
- Speicherung modellspezifischer Parameter im Geraet
## Mechanisches Modell
Wenn die vordere Auflage bei `x = 0` und die hintere bei `x = L` liegt, dann gilt aus dem Momentengleichgewicht:
`x_cog_from_front_support = rear_weight / (front_weight + rear_weight) * L`
Das ist eine technische Ableitung aus der in der Hackaday-Referenz gezeigten Zwei-Waagen-Anordnung.
Um die Lage relativ zur Fluegelvorderkante zu erhalten:
`x_cog_from_leading_edge = support_offset_from_leading_edge + x_cog_from_front_support`
## Netzwerkmodell
Ein gemeinsames ESP-NOW-Protokoll transportiert nun Geraetetypen:
- `IMU`: klassische AeroAlign-Sensoren
- `CoG Scale`: Waagenknoten mit Front/Heck/CoG
- `Hybrid`: spaeter fuer kombinierte Vorrichtungen
Der Master muss deshalb keine getrennten Netze oder Apps mehr betreiben.
## Empfohlene Phase 5
1. Eigenen CoG-Slave auf Basis `firmware/slave` anlegen.
2. HX711-Treiber und Tare/Kalibrierung integrieren.
3. Master-API um Modellparameter `support_distance_mm` und `leading_edge_offset_mm` erweitern.
4. Web-UI um CoG-Ansicht mit Livewerten, Sollwert und Ballast-Rechner erweitern.
5. NVS-Datenmodell fuer Flugzeugprofile einfuehren.
## Firmware-Schnittstelle
Aktuell ist im Protokoll nur die Transportbasis vorbereitet:
- `pitch/roll/yaw` bleiben fuer IMU-Knoten erhalten.
- CoG-Scale-Knoten belegen dieselben drei Float-Felder mit `front_weight_g`, `rear_weight_g` und `cog_position_mm`.
Das ist bewusst pragmatisch, damit bestehende ESP-NOW-Kommunikation erhalten bleibt und die eigentliche HX711-Integration als naechster Schritt isoliert umgesetzt werden kann.