VA-Control-for-linux/reference/ARCHITEKTUR.md

VA-Remotecontrol — Reverse-Engineering-Notizen

Analyse der Voice_Acoustic_VA-Remotecontrol_64_bit_v_4_0_1 (Stand 08/2026).

Was ist das?

Ein Rebrand der AllDSP „AllControl" DSP-Software zur Fernsteuerung/Konfiguration der DSP-Verstärker (HDSP-Serie, Paveosub-…sp, Venia-…sp, PAV115sp usw.).

Merkmal	Wert
Sprache	Python 2.6 (py2exe-Bundle, 32-bit)
GUI	wxPython / wxWidgets 2.8 (wx._core_.pyd, wxmsw28uh_*_vc.dll)
Numerik	numpy + scipy (FIR-Design, RTA-Messungen, PDF-Report)
Bootstrap-EXE	VA-Remotecontrol.exe (enthält angehängtes ZIP mit 904 .pyc)
MSVC-Runtime	VC++2008 / msvcr90 (nicht gebundlet → unter Wine vcrun2008)
Lizenz-Dongle	keiner (keyfile.py = statischer Preset-Encryption-Key)

Ordner im Installat

• src/ — dekompilierter App-Quellcode (47 Module, s.u.) ← zum Analysieren
• pycode/ — die 904 rohen .pyc (App + komplette Py2.6-Standardbibliothek)
• *.pyd,*.dll— native Extension-Module (numpy/scipy/wx/pywin32) + Python-Runtime
• factory/ — Werks-Presets/Firmware .ffi je Produkt (HDSP-3/-6, Paveosub-112/115/118/218sp, Venia-8sp, PAV115sp-8K4 …)
• configurations/ — DSP-Struktur-Definitionen .cfg + .csv (DPD2, DPCP88, DPD3 …)
• dfi/ — Geräte-/Frontplatten-Layouts .dfi/.dfu/.dfe
• skins/ — SVG-Bedienpanels (das UI wird aus SVGs aufgebaut, s. svg_panel.py)
• local/ — Sprachdateien (deutsch, english, mandarin, nederlands, polish, portuguese, spanish, …)
• drivers/ — Windows-USB-Treiber adspusb.inf/.cat

Modul-Landkarte (src/)

Einstieg

• main.py → ruft one_unit.main_application(argv).start()
• one_unit.py (3.7k Z.) — Haupt-App/Fenster; child_unit.py, select_unit* — Geräteauswahl/-instanzen
• countDSPs.py — zählt/erkennt angeschlossene DSPs

Kommunikation zu den Verstärkern (der interessante Teil)

• d_protocol.py — Wire-Protokoll (nutzt struct, socket, myserial, zipfile)
• d_usb.py — findet USB-Geräte per WMI, Filter auf VID_0684 (= AllDSP GmbH), mappt auf COM-Port
• d_ethernet.py — TCP/IP-Transport (socket)
• d_keepalive.py, d_bootloader.py — Verbindung halten / Firmware-Flash
• protocol.py, server.py — höhere Protokoll-/Serverschicht
• network_settings.py, network_graphical.py, network_customized.py — Multi-Device-Netz

Transport = USB-Seriell (virtueller COM-Port) ODER Ethernet. Kein FTDI-D2XX, sondern klassisch über COM (myserial = pyserial-Wrapper).

GUI / DSP-Bedienung

• svg_panel.py — rendert Bedienoberflächen aus SVG
• control_panel.py, diagram.py (EQ/Filterkurven), my_menu.py, dialog.py, fir_dialog.py, MyOGLlike.py (OpenGL-Canvas)
• user_config_*.py — die einzelnen DSP-Blöcke: audio, dc, display, keys, leds, model, network, tcs, timer, various, vu
• rta_measurements.py (Echtzeit-Analyzer, nutzt PortAudio/pyaudio), record.py, makePDF.py

Daten

• data_model.py, definitions.py — Datenmodell / Konstanten (STRUCT_ID_GAIN/DELAY/LPF/HPF/PEQ/LIMITER/…)
• keyfile.py — nur preset_encryption_key (Presets sind verschlüsselt; keine Lizenzprüfung)

Für Linux/Docker relevante Stolpersteine

1. Crypto: Py2.6 random.seed() → os.urandom → Windows-CryptoAPI. Im Wine-Prefix muss rsaenh.dll registriert sein (regsvr32 rsaenh.dll), sonst Crash 0x80090017. → ist im Docker-Image gefixt.
2. USB-Erkennung via WMI (d_usb.ListUSBDevices, Win32_USBControllerDevice): funktioniert unter Wine praktisch nicht. → Gerät stattdessen als COM-Port durchreichen (/dev/ttyUSB0 → dosdevices/com1) und in der App den COM-Port manuell wählen, oder die Ethernet-Anbindung nutzen (umgeht das USB/WMI-Problem komplett).
3. RTA-Messung braucht Audio-I/O (PortAudio) — im Container nur mit ALSA/Pulse-Durchreichung.

Wie der Quellcode entstand

• .pyc aus dem an VA-Remotecontrol.exe angehängten ZIP extrahiert.
• Dekompiliert mit uncompyle6 (42 Module); die 5 komplexeren mit pycdc/Decompyle++ (Kopf-Kommentar „NOTE: mit pycdc…" → dort ggf. kleinere Ungenauigkeiten prüfen).