Repository navigation
Releases
FoxAir Control v0.4.1
0.4.1
- Cloud-Registerzuordnung korrigiert: COP, elektrische und thermische Leistung, Kompressorlaufzeit, Außentemperaturfühler und Eingangsstromwerte jetzt mit den richtigen Cloud-Abfragecodes verknüpft.
- T-Diagnosewerte vereinheitlicht: T49–T65 korrigiert; zusätzliche lokale Anzeigen T200–T205 für COP, Leistungen und Phasenströme eingeführt. Anzeige- und Cloud-Abfragecodes bleiben sauber getrennt.
- Cloud-Trennung verbessert: Bereits gelesene Cloudwerte bleiben nach dem Trennen sichtbar und werden eindeutig als „zuletzt bekannt“ gekennzeichnet.
- Cloud-Verbindungswechsel abgesichert: Verspätete Antworten werden nicht mehr als aktuelle Messwerte übernommen; bei Geräte- oder Kontowechsel werden alte Clouddaten zuverlässig bereinigt.
- Parameterdialog vereinfacht: Filter „Nur App-Parameter“ entfernt. Diagnose- und T-Register bleiben vollständig sichtbar, auch ohne zugeordneten App-Namen.
- Parameteranzeige verbessert: App-Bezeichnungen und zusätzliche Informationen in Tooltips ergänzt; Dialoglayout und Statusanzeige überarbeitet.
- Registerwissen aktualisiert: Weitere Firmware-V3.5-Erkenntnisse, Pumpenkennlinien und technische Parameterbeschreibungen ergänzt.
**v0.4.1 verbessert vor allem die Cloud-Diagnose, korrigiert wichtige Leistungs- und COP-Zuordnungen.
FoxAir Control v0.4.0
0.4.0
- WarmLink Cloud umfangreich erweitert: AT-7-Punkt-Kurve, SG Ready und zahlreiche Einstellungen jetzt direkt über Cloud les- und schreibbar.
- Timer über Cloud: WP Ein/Aus Timer 1–6, Betriebsart Timer 1–6 und Silentmodus mit automatischem Laden und gezieltem Schreiben geänderter Werte.
- Timer-Dialoge vereinfacht: Raw-Felder und einstellbare Schreibpausen entfernt; übersichtlichere Eingaben und Schutz ungespeicherter Änderungen.
- Cloud-Schreiben verbessert: gemeinsame Batch-Writes, frische Einzel-Readbacks und klarer Status bei unvollständigen Antworten – keine automatische Wiederholung unklarer Schreibvorgänge.
- Cloud-Schnellverbindung: direktes Verbinden und Trennen im Hauptfenster mit neuen Symbolen und animierter Statusanzeige.
- Cloud-Diagnose erweitert: Störungs-, Kontakt- und Lastausgangsdecoder mit gezieltem Laden aktueller Werte.
- AT- und SG-Dialoge überarbeitet: kompaktere 7-Punkt-Kurve, übersichtlichere SG-Einstellungen und automatische Cloud-Aktualisierung.
- LTE-/Cloud-Kommunikation stabilisiert: verbesserte Timeouts, Wiederverbindung und sichere Behandlung laufender Lese-/Schreibaufträge.
- Display-Modbus verbessert: korrigierte DWIN-/Telemetriedaten, virtuelle Register und zuverlässigere Parametersynchronisation.
- Registerwissen erweitert: neue V3.5-Diagnoseinformationen, Statusbits und Engineering-RAM-Register 8802–8808; effektiven Heiz-Wassersollwert auf MAIN:2017 korrigiert.
- Dokumentation und Tests aktualisiert: Cloud-Mappings, Registerbeschreibungen und FAQ ergänzt.
FoxAir Control v0.3.4
0.3.4
- Cloudsteuerung ewrweitert und verbessert (aber noch nicht fertig)
- WP- und AT-Steuerung nutzen einen gemeinsamen Steuertransport mit Modbus vor Cloud.
- Cloud-only: WP Ein/Aus, Modus und Solltemperaturen können über bestätigte WarmLink-Codes gesteuert werden.
- Cloud-Geräte lassen sich per Doppelklick auswählen und das Polling direkt starten.
- Haupttabelle verbessert: Spaltenbreiten sind einstellbar und werden gespeichert; lange Cloud-Werte bleiben kompakt.
- Cloud-Button zeigt aktives Polling mit einem animierten grünen Rahmen.
- Neuer System-/I/O-Statusdecoder für 2146/2147; Registerwissen und FAQ aktualisiert.
FoxAir Control v0.3.0
FoxAir Control v0.3.0
- Deutlich erweitertes Register-Mapping mit vielen neuen und korrigierten Parametern.
- SG Ready erweitert: zusätzliche Modi 4–7, AI Saving / Remote Energy Control sowie Low / Neutral / High PV.
- Neue V3.5-Warmlink-/Servicewerte integriert; bekannte 8xxx-Register werden direkt in der Haupttabelle angezeigt.
- Verbesserte Diagnose und Geräte-Info sowie präzisere Bus-, Status- und Firmwareinformationen.
- Zusätzliche Schutzlogik beim Schreiben kritischer Register sowie Verbesserungen bei Backup/Restore und Registerdarstellung.
FoxAir Control v0.2.62
0.2.61
Geräte-Info und Registerdaten
- Die drei direkten Geräte-Info-Reads werden mit jeweils einer Sekunde Buspause entzerrt.
- Cloud-Sonderfunktion im Dialog dezent hervorgehoben und oberhalb der direkten Abfrage angeordnet.
- Temperatur-/Feuchtesensor und Taupunkt (2178–2180) sowie die Warmwasser-Energiezähler-Wortpaare (2125–2128) dokumentiert.
- Reguläres FC03-Auslesen über 200/1, 2001/8 und C544 50500/13 ergänzt.
- Cloud-Sonderfunktion eindeutig benannt, mit MQTT-Hinweis und Sicherheitsabfrage versehen.
- Wartezeit auf 180 Sekunden erhöht und scrollbare Fortschrittsanzeige stabilisiert.
- Neuer eigenständiger, nicht blockierender Geräte-Info-Dialog neben dem About-Button.
- Read-only Register-4-Sonderabfrage ohne falschen generischen FC03-Timeout; Fortschritt über acht eindeutige Datenblöcke und 90-Sekunden-Teilabschluss.
- Gemeinsame Decoder für WiFi-ID und Datum, PHNIX/Aliyun ProductKey, C544-Hardware-/Softwareinformation sowie C37B-Quittung.
- Geräteidentität aus dem About-Dialog entfernt und fest codierte reale Gerätekennung durch strukturelle Prüfung ersetzt.
- Register 200–215, 50043–50044 und 50500–50512 vollständig beschriftet.
FoxAir Control v0.2.60
FoxAir / Phnix Control v0.2.60
Dieses Release erweitert vor allem die Diagnose- und Langzeitaufzeichnung des Warmlink-/LTE-Modbus und bereitet die Software darauf vor, mögliche Firmware-Übertragungen zwischen Warmlink-DTU und Wärmepumpen-Mainboard sicher mitzuschneiden.
Highlights
Neues Warmlink Langzeit-Capture
Der bisherige Warmlink RAW Langzeit-Capture wurde deutlich erweitert und besitzt jetzt zwei Betriebsarten:
Normaler Langzeit-Capture
Für normale Langzeitaufzeichnungen des Warmlink-Modbus.
- RX- und TX-Rohdaten aufzeichnen
- normale Registerabfragen weiterhin möglich
- Schreibbefehle weiterhin möglich
- Live-Polling und Diagnosefunktionen bleiben verfügbar
- geeignet zur Analyse von Messwerten und normalem Busverkehr
Der normale Langzeit-Capture ist aktuell weiterhin auf die Kommunikationsart Modbus Warmlink LTE beschränkt.
Firmware-Langzeit-Capture
Neuer streng passiver Modus zum Mitschneiden möglicher Firmware-Übertragungen zwischen Warmlink-/LTE-DTU und Wärmepumpen-Mainboard.
Im Firmware-Modus:
- FoxAir Control sendet selbst keinerlei Modbus-Telegramme
- zentrale Low-Level-TX-Sperre direkt vor dem eigentlichen Senden
- vorhandene Sendewarteschlangen werden geleert
- Init-Reads werden gesperrt
- Live-Polling wird gestoppt
- aktive Register-/Paketscans werden gesperrt
- Warmlink-Diagnose/Dual-Logger wird gegen aktive Übertragungen abgesichert
- aktive Warmlink-Cloud-Schreibbefehle werden blockiert
- blockierte Sendeversuche werden als Ereignis protokolliert
TX = 0 Bdient als zusätzliche Kontrolle für einen wirklich passiven Mitschnitt
Der Firmware-Capture führt kein Firmwareupdate durch. Er dient ausschließlich der passiven Aufzeichnung und Analyse einer vom Warmlink-DTU bzw. Hersteller ausgelösten Firmwareübertragung.
Eigenes Capture-Fenster
Der Langzeit-Capture befindet sich nicht mehr in den normalen Programmeinstellungen.
Im Hauptfenster gibt es unter Funktionen jetzt:
Langzeit-Capture ...
Das neue Fenster bietet unter anderem:
- großen Live-Status
- Verbindungsstatus
- Capture aktiv/inaktiv
- Normal-/Firmware-Modus
- Status der TX-Sperre
- RX-/TX-Datenmenge
- aktuelles Capture-Segment
- letzter RX/TX-Zeitpunkt
- Drop-Zähler
- Anomalie-Zähler
- Fehlerstatus
- Energiespar-Sperre
- Capture-Verzeichnis
- Rotation und Speicherlimits
- neues Segment manuell starten
- Capture starten/stoppen
Der Status wird lokal aktualisiert und erzeugt selbst keine zusätzlichen Modbus-Abfragen.
Ein laufender Capture läuft weiter, wenn das Capture-Fenster geschlossen wird.
Auch im Hauptfenster wird ein laufender Capture deutlich angezeigt:
● Langzeit-Capture AKTIV● Firmware-Capture AKTIV
Windows-Standby verhindern
Für Langzeitaufzeichnungen kann jetzt verhindert werden, dass Windows den Rechner automatisch in den Standby versetzt.
Beim Firmware-Capture wird die Energiespar-Sperre automatisch verwendet.
Der Bildschirm darf weiterhin ausgeschaltet werden – verhindert wird nur der System-Standby, damit ein laufender Mitschnitt nicht unterbrochen wird.
Firmware-/Protokollerkennung
Die vorhandene RAW-Analyse wurde um weitere Hinweise auf mögliche Firmwareübertragungen erweitert.
Erkannt bzw. protokolliert werden unter anderem:
- ungewöhnliche Datenbursts
- bekannte und unbekannte Modbus-Funktionscodes
- FC16-Sequenzen
- Änderungen der Mainboard-Softwareversion in Register
2104 / 0x0838 - ungewöhnlicher RAW-Datenverkehr mit wenigen oder keinen bekannten gültigen Modbusframes
- blockierte TX-Versuche im passiven Firmware-Modus
Die RAW-Binärdateien bleiben dabei immer die eigentliche Datenquelle für eine spätere Offline-Analyse.
Capture-Dateien
Pro Segment werden weiterhin unter anderem erzeugt:
*.rx.bin– empfangene Rohdaten*.tx.bin– von FoxAir Control gesendete Rohdaten*.events.jsonl– Ereignisse und Analyseinformationen*.summary.txt– Zusammenfassung*.UPDATE_DETECTED.txt– Marker bei erkannter Änderung der Firmwareversion
Bestehende Capture-Einstellungen und Dateiformate bleiben kompatibel.
Verbesserte Verbindungseinstellungen
Im Programm-Einstellungsfenster können Verbindungen jetzt direkt hergestellt und getrennt werden, ohne das Einstellungsfenster vorher schließen zu müssen.
Die Verbindungseinstellungen und Autoconnect-Funktionen sind dadurch übersichtlicher zusammengefasst.
Neue Warmlink-Modbus-Anleitung
Neu hinzugekommen ist eine ausführliche Anleitung zum parallelen Mithören des Warmlink-/LTE-RS485-Busses mit einem USB-RS485-Adapter.
Enthalten sind unter anderem:
- Anschluss am Mainboard
- Anschluss anhand des Schaltplans
- Fotos der relevanten Klemmen
- RS485-A/B
- 9600 Baud / 8N1
- Hinweise zur 120-Ω-Terminierung
- Hinweise zum rein passiven Mithören
- verwendeter USB-RS485-Adapter
- Fehlersuche
Anleitung:
HowToWarmlink_Modbus.md
Langzeit-Capture Dokumentation:
warmlink_raw_capture.md
Die beiden Anleitungen sind außerdem direkt aus dem neuen Langzeit-Capture-Fenster erreichbar.
Sicherheit beim Firmware-Capture
Beim Firmware-Capture wurde bewusst nicht nur die GUI gesperrt.
Die eigentliche Sicherheitsbarriere befindet sich auf der niedrigeren Kommunikationsschicht unmittelbar vor dem Senden der Daten.
Dadurch soll auch dann kein Telegramm auf den Warmlink-Bus gelangen, wenn eine interne Funktion versehentlich noch einen Read oder Write anfordert.
Blockierte Sendeversuche werden protokolliert, aber nicht übertragen.
Kompatibilität
- bestehende
warmlink_raw_captureEinstellungen bleiben erhalten - alte Konfigurationen verwenden automatisch den normalen Capture-Modus
- bestehende Capture-Dateien bleiben kompatibel
- keine Änderung des normalen Modbus-Protokolls
- keine automatische Baudratensuche während Firmware-Capture
- Firmware-Capture aktuell nur für Modbus Warmlink LTE
Wichtiger Hinweis
FoxAir / Phnix Control ist ein unabhängiges Diagnose- und Reverse-Engineering-Projekt und keine offizielle Software von FoxAir oder PHNIX.
Der Firmware-Langzeit-Capture ist ausschließlich zum passiven Mitschneiden und Analysieren von Buskommunikation vorgesehen. Er enthält keine Funktion zum Einspielen oder Manipulieren von Wärmepumpen-Firmware.
FoxAir Control v0.2.54
0.5.54
What's Changed
- Update Modbus and Displaybus register mappings (Neue erkentnisse) by @dosordie in #100
- Bereinige Display-Register-Duplikate und setze Display-only-Einträge by @dosordie in #92
- Einstellungsdialog: Tabs einführen und SVG-Icons im Hauptfenster by @dosordie in #96
- Icon-only main buttons and capture-mode hint in settings by @dosordie in #97
- Ignore JSON metadata keys in RegisterMap, update register data, and add integrity tests by @dosordie in #93
- FoxAir/Phnix: Register‑Kandidaten & Displaybus‑Mapping dokumentiert by @dosordie in #94
- Add optional UDP diagnostics by @dosordie in #95
- Group virtual Displaybus registers 91105 & 91108 into raw-status block by @dosordie in #98
- Add autoconnect and logging options; allow showing button text with icons by @dosordie in #99
FoxAir Control v0.2.53
What's Changed
- Register‑Mapping: ASCII block headers, Kelvin offsets, forum entries and trimmed init read blocks by @dosordie in #88
- ASCII-Blockkopf-Dekoder, 1326–1333 Umbenennung, 20xx/21xx auf Read by @dosordie in #89
- Touch-Scrolling für Haupt-Registertabelle aktivieren by @dosordie in #90
Full Changelog: v0.2.52...v0.2.53
FoxAir Control v0.2.52
FoxAir / PHNIX Control v0.5.52
Release-Datum: 2026-07-09
Kurzfassung
Version 0.5.52 ergänzt die Rückmeldung aus Issue #85 und verbessert die Darstellung der Paketkopf-/Kennungsregister 1001–1007.
Die Register bleiben technisch als Blockkopf/Kennung beschrieben, werden aber zusätzlich als lesbare WiFi-Barcode-/Kommunikationsmodul-ID dekodiert. Außerdem wurden mehrere Mapping-Korrekturen übernommen.
Highlights
WiFi Barcode / Kommunikationsmodul-ID
- Register
1001–1007bleiben als Blockkopf Paket 1 / Kennung Wort x erhalten. - Zusätzlich werden sie als ASCII-Teile des WiFi-Barcodes / der Kommunikationsmodul-ID erkannt.
- In der Hauptliste wird in der bestehenden Wertspalte nun der ASCII-Wert angezeigt, ohne zusätzliche Tabellenspalten.
- Zusammengesetzt ergibt das z. B.
WF2210250475.
About / Geräteinfo
- Wenn ein plausibler WiFi Barcode erkannt wird, zeigt der About-/Info-Dialog jetzt:
- WiFi Barcode / Kommunikationsmodul-ID
- dekodiertes Code-Datum aus dem Format
WF + YYMMDD + laufende Nummer - Hinweis, dass dieser Wert nicht identisch mit der Geräte-Serial-No. auf dem Typenschild ist
Mapping-Korrekturen aus Issue #85
1025 / H38: geändert auf Spracheinstellung / Language choice1033 / H20: App-Werte korrigiert auf0 = Hot Water-ON,1 = Hot Water-OFF1057 / A28: korrigiert auf Temp Diff between Outlet and DHW Temp
Technische Änderungen
- Neue ASCII-Dekodierung für 16-Bit Big-Endian-Worte.
- Nur druckbare ASCII-Zeichen werden angezeigt.
0x0000,0xFFFFund nicht druckbare Werte werden als leer/Reserve behandelt.- Keine neue Haupttabellen-Spalte.
- Keine Änderung an Raw-/Hex-Spalten.
- Keine Änderung an Parser-, Modbus-, Cloud-, Warmlink-Capture- oder Schreiblogik.
- Keine Firmware-/Flash-Funktion.
Hinweise
1001–1007sind weiterhin Blockkopf-/Kennungsregister.- Die zusätzlich erkannte Kennung ist nach aktuellem Stand der WiFi Barcode / die Kommunikationsmodul-ID, nicht die eigentliche Wärmepumpen-Seriennummer.
- Die Geräte-Serial-No. steht separat auf dem Typenschild.
FoxAir Control v0.2.51
FoxAir / PHNIX Control v0.2.51
Neues Firmware-Übertragungs-Logging
Diese Version enthält erstmals die neue Logging-/Capture-Funktion für Firmware-Übertragungen über Warmlink RAW Capture.
Sie schreibt keine Firmware und führt kein Update aus, sondern protokolliert passiv die RX-/TX-Datenströme, segmentiert vollständige Frames und erzeugt zusätzliche Metadaten wie frame_complete-Events mit Offsets in den RAW-Dateien.
Ziel der Funktion ist es, eine echte Firmware-Übertragung bzw. ein Updatefenster später nachvollziehen und analysieren zu können:
- vollständige RX-/TX-Rohdaten bleiben erhalten
- komplette Modbus-Frames werden in
events.jsonlindiziert - Segmentdateien werden sauber fortlaufend angelegt
- mögliche Firmware-/Versionsänderungen über Register 2104 werden passiv beobachtet
- es wird bewusst nichts aktiv geflasht oder zurückgespielt
Highlights
- Neuer Warmlink RAW Langzeit-Capture für den Modbus-Warmlink/LTE-Datenstrom.
- Passives Firmware-/Update-Logging vorbereitet, ohne Schreib- oder Replay-Funktion.
- Frame-Complete-Index für spätere Offline-Analyse vollständiger Warmlink-/Modbus-Frames.
- Robusteres Segment-Handling: neue Captures hängen nicht mehr an alte Tagessegmente an.
Warmlink RAW / Firmware-Logging
- RX/TX-Rohdaten werden verlustarm als echte Binärdateien
.rx.bin/.tx.bingespeichert. events.jsonldient als Hilfsindex mit Chunk-, Status-, Anomalie- und Firmware-Events.- Neue
frame_completeEvents indexieren vollständig erkannte Frames mit:- Richtung RX/TX
- Dateiname
- Offset-Start/Ende
- Länge
- Bus/Function-Code
- Registeradresse/Menge
- Payloadbereich, soweit sicher bestimmbar
- CRC-Status
- Register
2104 / Hauptsoftwareversionwird passiv beobachtet. - Aktives zyklisches 2104-Polling wurde wieder entfernt, weil der Wert im normalen Warmlink-Datenstrom auftaucht.
- Änderungen von 2104 erzeugen Firmware-Version-Events und optional eine
UPDATE_DETECTEDMarkerdatei. - Normale Statusblöcke wie
0x0443,0x07D1und0x082Bmit 90 Registern werden nicht mehr fälschlich als Firmware-Verdacht gewertet. - TCP-Continuation-Chunks werden nicht mehr als neue Frames bzw. falsche
unknown_function-Anomalien gewertet.
Segmentierung / Langzeitbetrieb
- Jeder Capture-Start erzeugt ein neues freies Segment.
- Wenn
_001bereits existiert, wird automatisch_002,_003, usw. verwendet. - Offsets in
events.jsonlundframe_completebeziehen sich eindeutig auf die zugehörige.rx.bin/.tx.bin. - Queue-Drops werden in Events/Summary dokumentiert.
- Summary enthält Drop-Status und Firmware-Verdacht.
UI / Einstellungen
- Programmeinstellungen können auch bei aktiver Verbindung geöffnet werden.
- Live-Kommunikationsparameter sind bei aktiver Verbindung gesperrt.
- Warmlink-Capture-Optionen bleiben bei aktiver Warmlink-Verbindung bedienbar.
- Capture-/Logger-Einstellungen sind nur für den Warmlink-Modbus/LTE-Stream vorgesehen.
Hinweise
- Der Capture ist rein passiv.
- Es gibt keine Firmware-Schreib-, Replay- oder Update-Funktion.
- RAW-Captures können sensible Daten enthalten und sollten nicht öffentlich geteilt werden.