AeroAlign/docs/AEROALIGN_COG_INTEGRATION.md

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

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.