Aiways Drivers Wiki

User Tools

Site Tools

Trace: • mainboard
software:adc

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
software:adc [2026/10/11 21:02] – external edit 127.0.0.1software:adc [2026/11/02 18:00] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== ADC 0.14.9 alpha ======+====== ADC 0.14.34 alpha ======
 ===== Wireless CarPlay for the head unit ===== ===== Wireless CarPlay for the head unit =====
  
-**ADC** (the software of the **A**iways **D**rivers **C**ommunity) replaces and extends parts of the head unit's software: Bluetooth, CarPlay and the connection menus run on our own code instead of the manufacturer's. It is installed from a USB stick and can be removed again completely. It doesn't install a new operating system; it's more or less an update of the existing firmware. It runs on app builds **052**, **060** and **104** (how to find yours: see "Before you start" below). Whether it also works with **other** builds, we don't know yet. If you try it and nothing works any more, there's no way back for you for the time being, until we've made a firmware stick for your original version. If nothing works at all, you may have to take off the plastic trim on the passenger side to get at the USB hub and remove it, or you may even need an extra cable for your head unit. So better not try it, unless you're brave and can live with your head unit not working for a few weeks.+**ADC** (the software of the **A**iways **D**rivers **C**ommunity) replaces and extends parts of the head unit's software: Bluetooth, CarPlay and the connection menus run on our own code instead of the manufacturer's. It is installed from a USB stick and can be removed again completely. It doesn't install a new operating system; it's more or less an update of the existing firmware. It runs on app builds **052**, **060**, **102**, **104** and **108** (how to find yours: see "Before you start" below). Whether it also works with **other** builds, we don't know yet. If you try it and nothing works any more, there's no way back for you for the time being, until we've made a firmware stick for your original version. If nothing works at all, you may have to take off the plastic trim on the passenger side to get at the USB hub and remove it, or you may even need an extra cable for your head unit. So better not try it, unless you're brave and can live with your head unit not working for a few weeks.
 Most likely everything can be fixed, because the bootloader is never overwritten, but a) that isn't certain and b) it can take a while. Most likely everything can be fixed, because the bootloader is never overwritten, but a) that isn't certain and b) it can take a while.
  
-**Status: alpha.** Version **0.14.9** (11 October 2026) brings **two-finger zoom in Android Auto** and a safeguard when reverting: the Connect app refuses a stock-firmware stick whose apps do not fit your car's MCU ([[:software:versions|Head unit versions]]). On our test head unit (app build 060) the installation and the stick check ran with 0.14.9; two-finger zoom ran there with exactly the same program files. CarPlay was not re-tested on 0.14.9. Version 0.14.6 is installed and tested on a test head unit with app build **060**: menus, CarPlay, Android Auto, switching phones, restart. On **104** the previous version 0.14.4 ran with CarPlay; the 104 menus of 0.14.6 have not run on a device yet. On **052** the menus are the same as before. In real cars 0.14.0 (052) and 0.14.2 (060, still without the new menus) have run so far — use at your own risk, see the [[:disclaimer|disclaimer]].+**Status: alpha.** Version **0.14.34** (2 November 2026): on app builds 102, 104 and 108 the **left bar** stays next to CarPlay and Android Auto, after the car was off the head unit retries **Android Auto** by itself, Android Auto music **stops the radio**, and **logs for a bug report** can be saved to the USB stick. See the [[:software:adc_changelog|changelog]]. Use at your own risk, see the [[:disclaimer|disclaimer]].
  
 What changed from version to version: **[[:software:adc_changelog|Changelog]]**. What changed from version to version: **[[:software:adc_changelog|Changelog]]**.
Line 21: Line 21:
   * **Connecting Android Auto:** pair the Android phone the normal way via **Bluetooth** (in the head unit's Bluetooth menu). With Android Auto switched on, it then starts by itself. Going through the CarPlay menu works too, because that also pairs Bluetooth — but that is not what it is meant for.   * **Connecting Android Auto:** pair the Android phone the normal way via **Bluetooth** (in the head unit's Bluetooth menu). With Android Auto switched on, it then starts by itself. Going through the CarPlay menu works too, because that also pairs Bluetooth — but that is not what it is meant for.
   * **Two-finger zoom in Android Auto** (new in 0.14.9): maps zoom with two fingers. Rotating does not work — Android Auto apparently does not allow it on the car screen.   * **Two-finger zoom in Android Auto** (new in 0.14.9): maps zoom with two fingers. Rotating does not work — Android Auto apparently does not allow it on the car screen.
 +  * **Turn-by-turn in the instrument cluster** (since 0.14.12, lanes new in 0.14.13): while a CarPlay navigation app (e.g. Apple Maps, ABRP) or Android Auto navigates, the cluster's right-hand display shows the arrow, the distance, the road or direction, the exit and — when it follows soon — the next instruction. At junctions with several lanes the **lanes** replace the arrow: white the ones to take, grey the others. It disappears when the navigation ends. Tried with CarPlay in our daily car.
 +  * **CarPlay hotspot password** (new in 0.14.12): Settings › Connect › CarPlay shows, at the bottom, the name and password of the hotspot the iPhone joins.
 +  * **Darker screen** (new in 0.14.14): the brightness slider in Settings › Display and in the panel that drops down at the top right of the home screen has **15 steps instead of 10** — the lower five are darker than the former minimum, the upper ten are the former steps. The slider deliberately never switches the screen off completely.
 +  * **Speedwarning** (new in 0.14.32): shows the speed limit of the road you are on. The road map for Europe and Israel is on the install stick and is copied into the car during the installation. Its settings are under Vehicle control › Speed warning.
 +  * **Siri on the steering-wheel voice button** (new in 0.14.32): while CarPlay is connected, hold the button, speak, release. Without a phone the button opens the CarPlay pairing. During a call it does nothing.
 +  * **The radio pauses during phone calls** (new in 0.14.32): Bluetooth, CarPlay and Android Auto calls pause the car's radio; afterwards it plays on.
 +  * **Calls have their own volume** (new in 0.14.32): during a call the volume knob sets the call volume. The car keeps it for the next call, and the music volume stays as it was.
 +  * **Light display mode** (new in 0.14.32, app builds 102, 104 and 108): our menus, pages and tiles follow the car's light mode.
   * **Switching phones**: tap a paired phone in the Bluetooth menu: it connects and starts CarPlay or Android Auto, and the previous one is disconnected.   * **Switching phones**: tap a paired phone in the Bluetooth menu: it connects and starts CarPlay or Android Auto, and the previous one is disconnected.
   * **Bluetooth** — pairing, music with track info and controls, hands-free calls with call audio, phone book. Might also work in parallel with CarPlay, but that's untested.   * **Bluetooth** — pairing, music with track info and controls, hands-free calls with call audio, phone book. Might also work in parallel with CarPlay, but that's untested.
Line 27: Line 35:
   * **SSH**: an up-to-date SSH server (dropbear 2026.94) with ''scp'' and ''sftp''   * **SSH**: an up-to-date SSH server (dropbear 2026.94) with ''scp'' and ''sftp''
   * **Self-test** — after every start a short report is written to ''/sdcard/OpenAiways/selftest.txt''.   * **Self-test** — after every start a short report is written to ''/sdcard/OpenAiways/selftest.txt''.
 +  * **Logs for a bug report** (new in 0.14.34): plug in the ADC stick (or a FAT32 stick with a folder named ''adc-logs''). The Connect app's window then shows the row "Logs for a bug report": it saves the Android Auto, CarPlay, Bluetooth and installation logs in the folder ''adc-logs'' on the stick, without passwords and keys. Send that folder with your bug report.
  
 === What else there is, and what can go wrong === === What else there is, and what can go wrong ===
Line 40: Line 49:
  
 ^ Settings › Connect › … ^ after installation ^ what it does ^ ^ Settings › Connect › … ^ after installation ^ what it does ^
-| CarPlay › CarPlay | on | CarPlay on/off (the switch itself is not tested yet). Below it, the phones that have used CarPlay in this car: the bin deletes the pairing, "Pairing mode" pairs a new one. |+| CarPlay › CarPlay | on | CarPlay on/off (the switch itself is not tested yet). Below it, the phones that have used CarPlay in this car: the bin deletes the pairing, "Pairing mode" pairs a new one. At the bottom the CarPlay hotspot's name and password. |
 | Android Auto › Android Auto (wireless) | **off** | Android Auto on/off; off ends a running session. | | Android Auto › Android Auto (wireless) | **off** | Android Auto on/off; off ends a running session. |
 | WLAN | **off** | The car as a Wi-Fi client, e.g. on your home network — an option for developers. | | WLAN | **off** | The car as a Wi-Fi client, e.g. on your home network — an option for developers. |
 +| Wi-Fi networks | – | The networks the car joins as a Wi-Fi client: order, edit, add, delete. |
 | ADB | on | Android debug access (ADB) over the network. | | ADB | on | Android debug access (ADB) over the network. |
 | SSH › SSH IVI | on | SSH access to the head unit, key only. | | SSH › SSH IVI | on | SSH access to the head unit, key only. |
-| SSH › SSH TBox | on | The same keys for the T-Box as well. | +| SSH › SSH TBox | – | Greyed out: the T-Box comes later as a separate step. | 
-| SSH › SSH config web page | off | A web page for entering the SSH keys; needs WLAN. |+| SSH › SSH config web page | off | A web page for entering the SSH keys. The line below it shows its address (''http://<IP>:8080/''), reachable over Wi-Fi or Ethernet. |
 | Ethernet › Ethernet (USB adapter) | **off** | A USB network adapter gets an address (never the car's default route). | | Ethernet › Ethernet (USB adapter) | **off** | A USB network adapter gets an address (never the car's default route). |
 +| T-Box | – | Greyed out: the T-Box comes later as a separate step. |
 +
 +===== App builds =====
 +
 +^ AP version ^ ADC 0.14.34 installs ^ ran ^
 +| _052 | the core, our menus and home screen, Speedwarning | 0.14.34 in our daily car: installation, CarPlay, Speedwarning's speed limits (0.14.32 there also with the road map and calls); Android Auto with 0.14.2 on our test head unit |
 +| _060 | the core, our menus and home screen, Speedwarning | our test head unit: CarPlay and Android Auto (0.14.5/0.14.6), the installation with Speedwarning and the road map (0.14.20) |
 +| _102 | the core, our menus and home screen with light mode, the left bar in the right colours and also next to CarPlay and Android Auto, Speedwarning | our test head unit: the installation of 0.14.15; CarPlay and Android Auto not tried yet |
 +| _104 | as 102 | an alpha tester's car: Android Auto with 0.14.32; our test head unit: CarPlay with an in-between version (0.14.4) |
 +| _108 | as 102 | our test head unit: the installation of an in-between version (0.14.27) with light mode and the left-bar fix; CarPlay and Android Auto not tried yet |
  
 ===== Before you start ===== ===== Before you start =====
  
   * Your head unit must have firmware **MX64_V2.01.0051.05-9-R-210326** — it's shown under ''Settings › About''. The installer checks this itself and refuses any other firmware without changing anything.   * Your head unit must have firmware **MX64_V2.01.0051.05-9-R-210326** — it's shown under ''Settings › About''. The installer checks this itself and refuses any other firmware without changing anything.
-  * **Your app build** must match: under ''Settings › About'' tap the version entry about **5 times**; then the **System**, **MCU** and **AP version** are shown. The **AP version** must end in **_052**, **_060** or **_104** — that is your app build. The firmware number 0051 doesn't tell you: it belongs to the operating-system part, which is the same on all three builds. Which versions belong together: [[:software:versions|Head unit versions]]. +  * **Your app build** must match: under ''Settings › About'' tap the version entry about **5 times**; then the **System**, **MCU** and **AP version** are shown. The **AP version** must end in **_052**, **_060**, **_102**, **_104** or **_108** — that is your app build. The firmware number 0051 doesn't tell you: it belongs to the operating-system part, which is the same on all five builds. Which versions belong together: [[:software:versions|Head unit versions]]. 
-  * On app builds **052**, **060** and **104** ADC installs the core (Bluetooth, CarPlay, Android Auto, the Connect app) and the modified Settings with the home screen. **Other app builds** (e.g. 076 or 086) are untested: the installer checks several of the build's files, among them the Bluetooth app. If it doesn't know them, it stops and installs nothing; if it does, you get only the core without the new menus, and the end screen says "UPDATE INCOMPLETE".+  * On app builds **052**, **060**, **102**, **104** and **108** ADC installs the core (Bluetooth, CarPlay, Android Auto, the Connect app), the modified Settings with the home screen, and Speedwarning. **Other app builds** (e.g. 076 or 086) are untested: the installer checks several of the build's files, among them the Bluetooth app. If it doesn't know them, it stops and installs nothing; if it does, you get only the core without the new menus, and the end screen says "UPDATE INCOMPLETE".
   * ⚠️ **Check first, then reset:** on a car without ADC the installation starts with the factory reset, and that runs **before** the check. If the installer then refuses (other firmware, other app build), paired phones, Wi-Fi networks and settings are already deleted.   * ⚠️ **Check first, then reset:** on a car without ADC the installation starts with the factory reset, and that runs **before** the check. If the installer then refuses (other firmware, other app build), paired phones, Wi-Fi networks and settings are already deleted.
   * About **50 MB must be free** on the internal storage (SD card): the installer backs up the original apps it replaces there.   * About **50 MB must be free** on the internal storage (SD card): the installer backs up the original apps it replaces there.
 +  * The road map needs about **600 MB** of the car's app storage (it has about 5 GB; 1 GB always stays free). If it doesn't fit, it is not installed and the end screen says "UPDATE INCOMPLETE"; the reason is in ''/sdcard/OpenAiways/install-warnings.txt''.
   * Installing on a car **without** ADC needs a **factory reset**: paired phones, Wi-Fi networks and settings are deleted. ADC itself survives a later factory reset. The only way back is the stock firmware.   * Installing on a car **without** ADC needs a **factory reset**: paired phones, Wi-Fi networks and settings are deleted. ADC itself survives a later factory reset. The only way back is the stock firmware.
-  * A USB stick formatted **FAT32** (MS-DOS FAT). The head unit can't read exFAT sticks.+  * A USB stick of at least **2 GB**, formatted **FAT32** (MS-DOS FAT). The head unit can't read exFAT sticks.
  
 ===== Download ===== ===== Download =====
  
 ^ File ^ Size ^ SHA-256 ^ ^ File ^ Size ^ SHA-256 ^
-| {{:downloads:adc-0.14.9-usb-stick.zip|adc-0.14.9-usb-stick.zip}} — the install stick | 236 MB | ''58430500376b39a0cfad8856bbd60151c69923fdb758d3b35e078e2ad6fd4f81'' | +| {{:downloads:adc-0.14.34-usb-stick.zip|adc-0.14.34-usb-stick.zip}} — the install stick with the road map | 1.08 GB | ''1a9f607a5814d56a880697092b7bdf45aab2031c1b7a9397394ccb6ebd76a1b6'' |
-| {{:downloads:adc-0.14.9-rollback-usb-stick.zip|adc-0.14.9-rollback-usb-stick.zip}} — removes ADC again | 0.7 MB | ''87abeff92977c7b1f07f48769e16c2624c18a72dc2351a2e1b2e1db24b83b841'' |+
  
-Unzip the download and copy the **four files** — ''update.zip'', ''update_os.zip'', ''ota_update.ini'' and ''OpenAiwaysConnect.apk'' — to the **top level** of the stick, not into a folder. Nothing else on this stick, above all no files of the stock firmware (''imx6.ini'', ''imx6.bin'', ''imx6ap.bin'').+Unzip the download and copy **everything** — the four files ''update.zip'', ''update_os.zip'', ''ota_update.ini'', ''OpenAiwaysConnect.apk'' and the folder ''adc-data'' (the road map) — to the **top level** of the stick, not into another folder. Nothing else on this stick, above all no files of the stock firmware (''imx6.ini'', ''imx6.bin'', ''imx6ap.bin'').
  
 ===== Installing ===== ===== Installing =====
Line 72: Line 92:
  
   - Switch the car on and plug the stick into the **USB port in the centre console**.   - Switch the car on and plug the stick into the **USB port in the centre console**.
 +  - If you used our [[:software:backup_stick|backup stick]] before, the Connect app may now open a window with **ADC 0.14.34** and **Install**. Close it and go on with the next step: with backup stick 0.14 or older, its Connect app copies the update into the car first through that window, and the road map does not come along.
   - Open **Settings › About › Factory Reset** and confirm.   - Open **Settings › About › Factory Reset** and confirm.
-  - The car restarts, deletes its data and installs ADC: first a reset message, then about 25 seconds of black screen, then the installation progress. About 2–3 minutes in total. +  - The car restarts, deletes its data and installs ADC: first a reset message, then about 25 seconds of black screen, then the installation progress; the road map is copied last. Several minutes in total, most of it for the map.
-  - The installation may stop and **start over** once or twice (it did twice on our test head unit) — just let it run and only pull the stick when the end is shown.+
   - When the firmware has finished installing, pull out the USB stick; the head unit then reboots automatically. The first start takes a bit longer than normal.   - When the firmware has finished installing, pull out the USB stick; the head unit then reboots automatically. The first start takes a bit longer than normal.
  
 ==== On a car that already has ADC ==== ==== On a car that already has ADC ====
  
-  - Plug in the stick. The Connect app opens a window with a row **ADC 0.14.9** — press **Install**. +  - Plug in the stick. The Connect app opens a window with a row **ADC 0.14.34** — press **Install**. 
-  - It copies the update into the car and then asks you to **pull out the stick**. As soon as it's out, the car restarts and installs. Paired phones and settings are kept.+  - If your car has ADC 0.14.32, it restarts and installs straight from the stick, road map included. **Leave the stick in** until the screen asks you to pull it. 
 +  - If it has an older version (0.14.15 or earlier), the Connect app first copies the update into the car and then asks you to **pull out the stick**; as soon as it's out, the car restarts and installs. The **road map does not come along** this way — see "Road map missing?" below. 
 +  - Paired phones and settings are kept either way. 
 + 
 +**Road map missing?** Plug the stick in again with the car switched on. Speedwarning then copies the map by itself and shows the progress on the screen. Leave the stick in until it says "Road map installed — the USB stick can be removed".
  
 ===== Going back ===== ===== Going back =====
  
-  * **Back to the stock firmware** (everything as delivered, all data deleted): see [[:software:stock_firmware|Stock firmware 0051]]. On a car with ADC the Connect app offers **Revert** as soon as the stick with the stock firmware is plugged in. From 0.14.7 on only if the stick's apps fit your car's MCU; otherwise it refuses ("Stock version _104 denied. Incompatible with MCU _060.") and changes nothing. ⚠️ The check only covers this button. If the head unit restarts while the stick is plugged in, it flashes it without any check — for example after a factory reset, and on cars without the USB hub already when you switch on. So pull out a refused stick straight away. +  * **Back to the stock firmware** (everything as delivered, all data deleted): see [[:software:stock_firmware|Stock Firmware]]. On a car with ADC the Connect app offers **Revert** as soon as the stick with the stock firmware is plugged in. From 0.14.7 on only if the stick's apps fit your car's MCU; otherwise it refuses ("Stock version _104 denied. Incompatible with MCU _060.") and changes nothing. ⚠️ The check only covers this button. If the head unit restarts while the stick is plugged in, it flashes it without any check — for example after a factory reset, and on cars without the USB hub already when you switch on. So pull out a refused stick straight away.
-  * **Remove only ADC:** the rollback stick puts back every file ADC replaced, from the backup the installer made at the first installation. Prepare it like the install stick, plug it into the front USB port and run **Settings › About › Factory Reset**. The rollback ran successfully on a community member's car in October 2026 (version 0.14.2, app build 060); if in doubt, go via the stock firmware.+
  
 ===== Good to know ===== ===== Good to know =====
software/adc.1791745332.txt.gz · Last modified: by 127.0.0.1