====== ADC 0.14.34 alpha ======
===== Wireless CarPlay für die Head-Unit =====

**ADC** (die Software der **A**iways **D**rivers **C**ommunity) ersetzt und erweitert Teile der Software der Head-Unit: Bluetooth, CarPlay und die Verbindungsmenüs laufen mit unserem eigenen Code statt mit dem des Herstellers. Sie wird von einem USB-Stick installiert und lässt sich wieder vollständig entfernen. Sie installiert kein neues Betriebssystem, sondern stellt quasi ein Update der bestehenden Firmware dar. Sie läuft auf den App-Builds **052**, **060**, **102**, **104** und **108** (wie du deinen findest, steht unten unter „Bevor du anfängst“). Ob sie auch mit **anderen** Builds funktioniert, wissen wir noch nicht. Wenn du's ausprobierst und es geht nix mehr, gibt's für dich erst mal kein Zurück, bis wir nen Firmware-Stick für deine Original-Version gemacht haben. Wenn gar nix mehr geht, kann es sein, dass du den USB-Hub hinter dem Plastik auf der Beifahrerseite freilegen musst, um den USB-Hub zu entfernen oder evtl. sogar ein extra Kabel für deine Head-Unit brauchst, also probier's besser nicht aus, es sei denn, du bist mutig und kommst klar, wenn deine Head-Unit mal ein paar Wochen nicht geht. 
Sehr wahrscheinlich lässt sich alles lösen, weil der Bootloader nicht überschrieben wird, aber a) ist das nicht sicher und b) kann's halt dauern. 

**Stand: Alpha.** Version **0.14.34** (2. November 2026): Auf den App-Builds 102, 104 und 108 bleibt die **linke Leiste** neben CarPlay und Android Auto, nach dem Ausschalten des Autos versucht die Head-Unit **Android Auto** selbst erneut zu verbinden, Android-Auto-Musik **stoppt das Radio**, und **Protokolle für einen Fehlerbericht** lassen sich auf den USB-Stick speichern. Siehe [[de:software:adc_changelog|Änderungen]]. Nutzung auf eigenes Risiko, siehe [[de:disclaimer|Haftungsausschluss]].

Was sich von Version zu Version geändert hat: **[[de:software:adc_changelog|Änderungen]]**.

====== Disclaimer ======
Das ist eine **ALPHA!!!**-Version. Da ist noch ganz viel schwierig, komisch und ungetestet. Es kann gut sein, dass dann "handsfree" nicht mehr geht oder manche Audioformate nicht gespielt werden können oder das Mikrofon nicht tut und so fort. Installiere die Version nur, wenn du weißt, was du tust, und Lust hast, am Entwicklungsprozess teilzunehmen. Kommentare wie "mein Audio geht nich" sind nicht hilfreich. Bug-Reports sind ausführliche Beschreibungen dessen, was man in welcher Reihenfolge getan hat, auf welchem Gerät mit welcher Firmware-Version und einer genauen Fehlerbeschreibung. Wir leisten keinen Support, wenn du nicht klarkommst, und kommen auch nicht vorbei, wenn du deine Head-Unit nicht mehr benutzen kannst, weil was schiefgegangen ist ;-)
Aber wir nutzen gerne dein Feedback und die Bug-Reports, um die Firmware zu verbessern. 
Wenn du schon eigene Apps installiert hast, kann sein, dass die dann weg sind oder nicht mehr funktionieren. Es kann auch sein, dass die mit dieser Firmware kollidieren und deshalb irgendwas nicht funktioniert. Nicht unser Problem, deinstalliere sie halt und probier's noch mal. Und wir fixen Bugs, wenn wir Zeit und Lust haben. Drängeln macht's nicht schneller... glaub mir. 

===== Feature-Liste =====

  * **Kabelloses CarPlay** über den 5-GHz-Hotspot des Autos. Die CarPlay-Kachel auf dem Startbildschirm zeigt, welches Telefon verbunden ist. Verbinden tust du dich indem du unter Settings > Connect > Carplay auf verbinden klickst und auf dem Telefon unter Settings > allgemein > Carplay das Auto findest und anklickst.
  * **Flüssigeres CarPlay** sollte jetzt mit ungefähr 30Hz laufen
  * **Kabelloses Android Auto** (experimentell) einschalten unter Settings › Connect › Android Auto. Das Telefon braucht die Android-Auto-App mit "Wireless Android Auto". Es läuft immer nur eins: Android Auto oder CarPlay.
  * **Android Auto verbinden:** das Android-Telefon ganz normal per **Bluetooth koppeln** (im Bluetooth-Menü der Head-Unit). Ist Android Auto eingeschaltet, startet es danach von selbst. Über das CarPlay-Menü klappt es zwar auch, weil dabei ebenfalls Bluetooth gekoppelt wird — dafür ist es aber nicht gedacht.
  * **Zwei-Finger-Zoom in Android Auto** (neu in 0.14.9): Karten lassen sich mit zwei Fingern zoomen. Drehen geht nicht — das lässt Android Auto auf dem Auto-Bildschirm offenbar nicht zu.
  * **Abbiege-Hinweise im Kombiinstrument** (seit 0.14.12, Fahrspuren neu in 0.14.13): Navigiert ein CarPlay-Navi (z. B. Apple Karten, ABRP) oder Android Auto, zeigt das rechte Display im Kombiinstrument Pfeil, Entfernung, Straße oder Richtung, die Ausfahrt und — wenn er kurz danach kommt — den nächsten Hinweis. An Kreuzungen mit mehreren Spuren stehen statt des Pfeils die **Spuren**: weiß die richtigen, grau die anderen. Endet die Navigation, verschwindet die Anzeige. Mit CarPlay in unserem Alltagsauto ausprobiert.
  * **CarPlay-Hotspot-Passwort** (neu in 0.14.12): Settings › Connect › CarPlay zeigt unten Name und Passwort des Hotspots, mit dem sich das iPhone verbindet.
  * **Dunklerer Bildschirm** (neu in 0.14.14): Der Helligkeitsregler unter Settings › Display und im Menü, das oben rechts auf dem Startbildschirm aufklappt, hat **15 statt 10 Stufen** — die fünf unteren sind dunkler als das bisherige Minimum, die oberen zehn sind die bisherigen. Ganz aus geht der Bildschirm über den Regler absichtlich nicht.
  * **Speedwarning** (neu in 0.14.32): zeigt das Tempolimit der Straße, auf der du fährst. Die Straßenkarte für Europa und Israel liegt auf dem Installations-Stick und wird bei der Installation ins Auto kopiert. Die Einstellungen stehen unter Vehicle control › Speed warning.
  * **Siri über die Sprachtaste am Lenkrad** (neu in 0.14.32): Solange CarPlay verbunden ist, die Taste halten, sprechen, loslassen. Ohne Telefon öffnet die Taste die CarPlay-Kopplung. Während eines Telefonats tut sie nichts.
  * **Radio pausiert beim Telefonieren** (neu in 0.14.32): Telefonate über Bluetooth, CarPlay und Android Auto pausieren das Radio des Autos; danach läuft es weiter.
  * **Eigene Lautstärke für Telefonate** (neu in 0.14.32): Während eines Telefonats stellt der Lautstärkeregler die Gesprächslautstärke ein. Das Auto merkt sie sich fürs nächste Telefonat, die Musiklautstärke bleibt, wie sie war.
  * **Heller Anzeigemodus** (neu in 0.14.32, App-Builds 102, 104 und 108): Unsere Menüs, Seiten und Kacheln folgen dem hellen Modus des Autos.
  * **Telefon wechseln** im Bluetooth-Menü ein gekoppeltes Telefon antippen: Es wird verbunden und startet CarPlay bzw. Android Auto, das bisherige wird getrennt.
  * **Bluetooth** — Koppeln, Musik mit Titelanzeige und Steuerung, Freisprechen mit Gesprächston, Telefonbuch. Könnte auch parallel zu CarPlay funktionieren, ist aber ungetestet. 
  * **Startbildschirm** — die CarPlay-Kachel mit dem verbundenen Telefon, eine Android-Auto-Kachel (dunkel, solange Android Auto aus ist) und der Netzwerkstatus (Hotspot, mobile Daten, Ethernet).
  * **USB-Sticks mit neuer Firmware** — steckst du einen ein, zeigt die Connect-App, was darauf ist, mit der passenden Aktion: ein ADC-Update installieren, den 3D-Teilekatalog kopieren oder zur Original-Firmware zurückkehren.
  * **SSH** ein aktueller SSH-Server (dropbear 2026.94) mit ''scp'' und ''sftp''
  * **Selbsttest** — nach jedem Start wird ein kurzer Bericht nach ''/sdcard/OpenAiways/selftest.txt'' geschrieben.
  * **Protokolle für einen Fehlerbericht** (neu in 0.14.34): Steck den ADC-Stick ein (oder einen FAT32-Stick mit einem Ordner ''adc-logs''). Das Fenster der Connect-App zeigt dann die Zeile „Protokolle für einen Fehlerbericht“: Sie speichert die Protokolle von Android Auto, CarPlay, Bluetooth und der Installation im Ordner ''adc-logs'' auf dem Stick, ohne Passwörter und Schlüssel. Schick diesen Ordner mit deinem Fehlerbericht.

=== Was es alles noch gibt und was alles schiefgehen kann ===
  * Wlan muss aus sein für carplay oder Android Auto, Das ist eigentlich nur zum debuggen gut und dafür auch nicht wirklich
  * Es ist jetzt ein Ethernet über USB Treiber enthalten, Wenn du so einen Adapter anschilesst kommst du auch auf das CLI der Headunit, wenn carplay an ist.
  * Den SSH Key kannst du entweder über ADB aufs Gerät tun oder du schaltest kurz in den Settings > Connect > SSH den Webserver ein und kopierst deinen ssh pubkey dann in das Feld auf der Webseite
  * 


===== Einstellungen =====

Die Schalter liegen unter **Settings › Connect** (Einstellungen › Connect). Bei einem Update bleibt erhalten, was du eingestellt hast.

^ Settings › Connect › … ^ nach der Installation ^ was er tut ^
| CarPlay › CarPlay | an | CarPlay ein/aus (der Schalter selbst ist noch ungetestet). Darunter die Telefone, die CarPlay in diesem Auto benutzt haben: Der Papierkorb löscht die Kopplung, "Pairing mode" koppelt ein neues. Ganz unten Name und Passwort des CarPlay-Hotspots. |
| Android Auto › Android Auto (wireless) | **aus** | Android Auto ein/aus; aus beendet eine laufende Sitzung. |
| WLAN | **aus** | Das Auto als WLAN-Client, z. B. im Heimnetz — eine Option für Entwickler. |
| Wi-Fi networks | – | Die Netze, mit denen sich das Auto als WLAN-Client verbindet: Reihenfolge, bearbeiten, hinzufügen, löschen. |
| ADB | an | Android-Debug-Zugang (ADB) übers Netzwerk. |
| SSH › SSH IVI | an | SSH-Zugang zur Head-Unit, nur mit Schlüssel. |
| SSH › SSH TBox | – | Ausgegraut: Die T-Box kommt später als eigener Schritt. |
| SSH › SSH config web page | aus | Webseite zum Eintragen der SSH-Schlüssel. Die Zeile darunter zeigt ihre Adresse (''http://<IP>:8080/''), erreichbar über WLAN oder Ethernet. |
| Ethernet › Ethernet (USB adapter) | **aus** | Ein USB-Netzwerkadapter bekommt eine Adresse (nie die Standardroute des Autos). |
| T-Box | – | Ausgegraut: Die T-Box kommt später als eigener Schritt. |

===== App-Builds =====

^ AP-Version ^ ADC 0.14.34 installiert ^ gelaufen ^
| _052 | den Kern, unsere Menüs und den Startbildschirm, Speedwarning | 0.14.34 in unserem Alltagsauto: Installation, CarPlay, die Tempolimits von Speedwarning (0.14.32 dort auch mit Straßenkarte und Telefonaten); Android Auto mit 0.14.2 auf unserer Test-Head-Unit |
| _060 | den Kern, unsere Menüs und den Startbildschirm, Speedwarning | unsere Test-Head-Unit: CarPlay und Android Auto (0.14.5/0.14.6), die Installation mit Speedwarning und Straßenkarte (0.14.20) |
| _102 | den Kern, unsere Menüs und den Startbildschirm mit hellem Modus, die linke Leiste in den richtigen Farben und auch neben CarPlay und Android Auto, Speedwarning | unsere Test-Head-Unit: die Installation von 0.14.15; CarPlay und Android Auto noch nicht ausprobiert |
| _104 | wie 102 | das Auto eines Alpha-Testers: Android Auto mit 0.14.32; unsere Test-Head-Unit: CarPlay mit einer Zwischenversion (0.14.4) |
| _108 | wie 102 | unsere Test-Head-Unit: die Installation einer Zwischenversion (0.14.27) mit hellem Modus und der Korrektur der linken Leiste; CarPlay und Android Auto noch nicht ausprobiert |

===== Bevor du anfängst =====

  * Deine Head-Unit muss die Firmware **MX64_V2.01.0051.05-9-R-210326** haben, steht unter ''Einstellungen › Über''. Der Installer prüft das selbst und lehnt jede andere Firmware ab, ohne etwas zu verändern.
  * **Dein App-Build** muss passen: Unter ''Einstellungen › Über'' etwa **5× auf die Versionsangabe tippen**, dann werden **System-**, **MCU-** und **AP-Version** angezeigt. Die **AP-Version** muss auf **_052**, **_060**, **_102**, **_104** oder **_108** enden — das ist dein App-Build. Die Firmware-Nummer 0051 verrät ihn nicht: Sie gehört zum Betriebssystem-Teil, und der ist bei allen fünf Builds derselbe. Welche Versionen zusammengehören: [[de:software:versions|Head-Unit-Versionen]].
  * Auf den App-Builds **052**, **060**, **102**, **104** und **108** installiert ADC den Kern (Bluetooth, CarPlay, Android Auto, die Connect-App), die geänderten Settings mit dem Startbildschirm und Speedwarning. **Andere App-Builds** (z. B. 076 oder 086) sind nicht getestet: Der Installer prüft mehrere Dateien des Builds, darunter die Bluetooth-App. Kennt er sie nicht, bricht er ab und installiert nichts; kennt er sie, kommt nur der Kern ohne die neuen Menüs, und am Ende steht „UPDATE INCOMPLETE“.
  * ⚠️ **Erst prüfen, dann zurücksetzen:** Auf einem Auto ohne ADC beginnt die Installation mit dem Zurücksetzen auf Werkseinstellungen, und das läuft **vor** der Prüfung. Lehnt der Installer danach ab (andere Firmware, anderer App-Build), sind gekoppelte Telefone, WLAN-Netze und Einstellungen trotzdem schon gelöscht.
  * Auf dem internen Speicher (SD-Karte) müssen etwa **50 MB frei** sein: Der Installer sichert dort die Original-Apps, die er ersetzt.
  * Die Straßenkarte braucht etwa **600 MB** im App-Speicher des Autos (er hat etwa 5 GB; 1 GB bleibt immer frei). Passt sie nicht, wird sie nicht installiert, und am Ende steht „UPDATE INCOMPLETE“; den Grund nennt ''/sdcard/OpenAiways/install-warnings.txt''.
  * Die Installation auf einem Auto **ohne** ADC braucht ein **Zurücksetzen auf Werkseinstellungen**: gekoppelte Telefone, WLAN-Netze und Einstellungen werden gelöscht. ADC selbst überlebt einen späteren Reset auf Werkseinstellungen. Du kommst nur zurück mit der Original-Firmware.
  * Einen USB-Stick mit mindestens **2 GB** und **FAT32** (MS-DOS FAT). exFAT-Sticks liest die Head-Unit nicht.

===== Download =====

^ Datei ^ Größe ^ SHA-256 ^
| {{:downloads:adc-0.14.34-usb-stick.zip|adc-0.14.34-usb-stick.zip}} — der Installations-Stick mit Straßenkarte | 1,08 GB | ''1a9f607a5814d56a880697092b7bdf45aab2031c1b7a9397394ccb6ebd76a1b6'' |

Entpacke den Download und kopiere **alles** — die vier Dateien ''update.zip'', ''update_os.zip'', ''ota_update.ini'', ''OpenAiwaysConnect.apk'' und den Ordner ''adc-data'' (die Straßenkarte) — in die **oberste Ebene** des Sticks, nicht in einen weiteren Ordner. Sonst nichts auf diesen Stick, vor allem keine Dateien der Original-Firmware (''imx6.ini'', ''imx6.bin'', ''imx6ap.bin'').

===== Installieren =====

==== Auf einem Auto ohne ADC ====

  - Auto einschalten und den Stick in den **USB-Port an der Mittelkonsole** stecken.
  - Hast du vorher unseren [[de:software:backup_stick|Backup-Stick]] benutzt, öffnet die Connect-App jetzt womöglich ein Fenster mit **ADC 0.14.34** und **Installieren**. Schließe es und mach mit dem nächsten Schritt weiter: Mit dem Backup-Stick 0.14 oder älter kopiert dessen Connect-App das Update über das Fenster erst ins Auto, und die Straßenkarte kommt nicht mit.
  - **Settings › About › Factory Reset** (Einstellungen › Über › Werkseinstellungen) öffnen und bestätigen.
  - Das Auto startet neu, löscht seine Daten und installiert ADC: zuerst eine Meldung zum Zurücksetzen, dann etwa 25 Sekunden schwarzer Bildschirm, dann der Installationsfortschritt; zuletzt wird die Straßenkarte kopiert. Insgesamt einige Minuten, das meiste davon für die Karte.
  - Wenn die Firmware fertig installiert ist, muss man den USB-Stick rausziehen, dann rebootet die Head-Unit automatisch. Dauert dann beim ersten Mal etwas länger als normal. 

==== Auf einem Auto, das schon ADC hat ====

  - Stick einstecken. Die Connect-App öffnet ein Fenster mit einer Zeile **ADC 0.14.34** — **Installieren** drücken.
  - Hat dein Auto ADC 0.14.32, startet es neu und installiert direkt vom Stick, mit Straßenkarte. **Lass den Stick stecken**, bis der Bildschirm bittet, ihn zu ziehen.
  - Hat es eine ältere Version (0.14.15 oder früher), kopiert die Connect-App das Update erst ins Auto und bittet dann, **den Stick abzuziehen**; sobald er draußen ist, startet das Auto neu und installiert. So kommt die **Straßenkarte nicht mit** — siehe „Straßenkarte fehlt?“ unten.
  - Gekoppelte Telefone und Einstellungen bleiben in beiden Fällen erhalten.

**Straßenkarte fehlt?** Stecke den Stick bei eingeschaltetem Auto wieder ein. Speedwarning kopiert die Karte dann selbst und zeigt den Fortschritt auf dem Bildschirm. Lass den Stick stecken, bis dort „Straßenkarte installiert – der USB-Stick kann abgezogen werden“ steht.

===== Zurück =====

  * **Zurück zur Original-Firmware** (alles wie ausgeliefert, alle Daten gelöscht): siehe [[de:software:stock_firmware|Original-Firmware]]. Auf einem Auto mit ADC bietet die Connect-App **Zurücksetzen** an, sobald der Stick mit der Original-Firmware steckt. Ab 0.14.7 nur, wenn die Apps des Sticks zur MCU deines Autos passen; sonst lehnt sie ab („Original-Version _104 abgelehnt. Inkompatibel mit MCU _060.“) und verändert nichts. ⚠️ Die Prüfung gilt nur für diesen Knopf. Startet die Head-Unit neu, solange der Stick steckt, flasht sie ihn ohne Prüfung — zum Beispiel nach „Werkseinstellungen“ und bei Autos ohne USB-Hub schon beim Einschalten. Einen abgelehnten Stick deshalb sofort abziehen.

===== Gut zu wissen =====

  * Jede Installation schreibt ein Protokoll nach ''/cache/oa-install.log''; die Sicherung jeder ersetzten Datei liegt unter ''/sdcard/OpenAiways/backup/''.
  * ADC liegt auf den System- und Vendor-Partitionen und übersteht deshalb Neustarts und Werksresets; ein Werksreset setzt nur seine Einstellungen zurück.
  * **Android Auto** ist experimentell und nach der Installation ausgeschaltet.
  * Die Bildrate von CarPlay begrenzt ''max_fps'' in ''/sdcard/aiwayscp.conf'' (Standard 30). Einen Wert, den du dort selbst einträgst, lässt jedes Update stehen.

===== DISCLAIMER =====

Die Firmware ist eine **ALPHA**-Version, vieles ist noch ungetestet, du wirst viel experimentieren müssen und einiges geht nicht.