Apps that run only on the head unit of BMW / MINI / Toyota Supra cars with NBT EVO (iDrive 5 / 6), as HMI plugins in the iDrive menu, and the USB stick that installs them. No phone, no network, no bridge: the car data comes from the head unit itself (CDS) and the pictures are installed with the plugin.
One repository for all the apps: every app is a folder in apps/, the stick is one folder
(usb/nbt-evo-apps) with one package per app, and one package manager installs them. Apps can
be for every car or for one brand (MINI, BMW, Supra): you choose your car once.
| App | Package | For | Status |
|---|---|---|---|
| MINI Sport: revs and shift light, G-meter, timers (0-100, 0-50, 80-120, braking 100-0), engine gauges | MiniSport |
MINI | s1: car tests 12/11 and 13/11 failed (no digits, no icon, theme inverted, Giri page not following); build 14/11 c, to try: moving pictures by id from a 90 KB zip (inside what loaded in the car: ProvaZip B), 10 updates per second, start count also on the stick |
| App da USB: the packages of the stick from the iDrive menu, with the knob | AppUsb |
all | t0 = diagnosis only, installs nothing |
| Lettura dati: TEST, reads only - which car data (CDS) a plugin gets, and the graphics libraries of the HMI | LetturaDati |
all | t0 |
| SportTest: test plugin of the car data and of the HMI calls | SportTest |
all | t1, tried in the car (results below); replaced by MINI Sport |
The stick can also carry the iDrive Plus plugins (weather, news, fuel, traffic, vehicle status) as packages:
tools/importa_idrive_plus.py turns an iDrive Plus stick into packages.
| Page | What it shows |
|---|---|
| Giri e cambiata | rev ring, shift light (10 LEDs, blinking at the shift point), gear, oil and water temperature, accelerator pedal, torque |
| G-meter | dot with a trail, g now, maxima (left, right, push, braking), the last minute |
| Cronometri | 0-100 and 0-50 km/h from a stop, 80-120, braking 100-0, best values |
| Strumenti motore | oil, water, accelerator pedal and torque dials, battery, steering angle, clutch |
The look follows the MINI ID6 screens; blue accents in MID / GREEN, red in SPORT (from the car's driving mode).
What SportTest (t1) showed in the car, and how the apps use it:
| In the car | Used for | |
|---|---|---|
Pictures of the plugin's zip switched by id (ImageID) |
works | every LED, segment, digit, bar and label |
Moving a picture (setProperty x / y) |
works | G-meter dot, centring of numbers |
Showing / hiding a picture, changing its width (setProperty 3 / 9) |
nothing happened | not used |
An action on the press of a button (raAction) |
never arrived | not used: a press opens a state, the focus in it starts the work |
| Car data (CDS) | revs ~9/s, accelerations ~13/s, pedals ~14/s, torque ~6/s |
t0 is a diagnosis: it shows the packages of the stick and what is installed, lets you choose the car and the iDrive Plus phone app, and checks in the car what a real installer needs (can a plugin change the system, does the press reach the plugin). The full answers go in its log. The installing version comes after.
The usb/nbt-evo-apps folder goes in the root of a FAT USB stick (next to anything else already there).
The built files (libraries, the pictures of MINI Sport) are not in the repository: build them first (see Build).
On the head unit shell (SSH root needed):
mount -o remount rw /net/hu-omap/fs/sda0
on -f /net/hu-omap/ /bin/sh
sh /mnt/umass*/nbt-evo-apps/pkg.sh # menu: choose the car, install / remove / previous version
# reboot: hold the power button for 30 sOr without the menu: pkg.sh brand mini, pkg.sh install MiniSport AppUsb, pkg.sh install all,
pkg.sh remove NAME, pkg.sh restore NAME, pkg.sh list. install.sh (MINI Sport) and remove.sh are still there.
What the package manager does:
- checks every file of the package (
files.sum, POSIX cksum) before touching anything; - builds the new folder next to the one in use and swaps them only when it is complete;
- keeps one previous version in
/opt/aa/nbt-evo-apps/previous/(restoreputs it back), and writes what is installed in/opt/aa/nbt-evo-apps/installed/; - installs the apps that are for your car only; files that change by brand or by iDrive Plus phone app come from
marche/<variant>/of the package; - moves removed apps to
/opt/aa/plugins_off(recoverable); nothing starts by itself.
- Read only: the apps read the car data, they send nothing to the car.
- Every app has its off switch (
/opt/aa/<name>.disable) and stays off on its own after 3 starts that do not reach 30 s. - Use the sport apps parked or on a closed track.
apps/<Name>/ one app: C++ plugin, generator of its stick files (make.py), package.txt, test/
framework/ declarations of the HMI plugin framework of the head unit
build/build.sh builds every app (ARM, QNX) and copies lib<Name>.so into its package
tools/pacchetti.py copies package.txt into the packages and writes files.sum
tools/dme-lettura.ps1 Windows PC + ENET cable: READ-ONLY look at what the engine computer answers (UDS 22 / OBD 01 only)
tools/importa_idrive_plus.py iDrive Plus stick -> packages
usb/nbt-evo-apps/ the stick folder: pkg.sh, install.sh, remove.sh, README.txt, pacchetti/<Name>/
python3 apps/MiniSport/make.py # pictures, zips, XML of MINI Sport + apps/MiniSport/layout.h (a few minutes; pip install pyoxipng)
python3 apps/AppUsb/make.py # XML, zips of App da USB
python3 apps/LetturaDati/make.py # XML, zips of Lettura dati
python3 apps/SportTest/make.py # XML, pictures of SportTest
sh build/build.sh # lib<Name>.so of every app (clang + ld.lld, no QNX SDK)
python3 tools/importa_idrive_plus.py <iDrive Plus stick folder> # optional
python3 tools/pacchetti.py # package.txt and files.sum of every package
sh apps/MiniSport/test/host.sh # MINI Sport on the PC with a fake framework, pages drawn into apps/MiniSport/test/out/
sh apps/AppUsb/test/host.sh # App da USB on the PC (root: /opt/aa, /mnt, /dev/shmem)
sh apps/LetturaDati/test/host.sh # Lettura dati on the PC: CDS from another thread, the stick marker (root: /mnt, /dev/shmem)The version of an app is written only in its package.txt.
MINI Sport's menu icons come from apps/MiniSport/icone/; put your own in apps/MiniSport/icone_mie/ (same
names: app.png, giri.png, gmeter.png, crono.png, motore.png) and the generator uses those instead. That
folder is never committed.
build/build.sh needs libAppFramework.A.so and libCoreFramework.A.so from your head unit in build/link/
(find / -name "lib*Framework.A.so" on the head unit): they belong to the head unit and are not in this repository.
The framework declarations are in framework/bmw_plugin.h.
apps/<Name>/<name>.cpp(start from an existing app),apps/<Name>/make.pywriting its XML, manifest and zips intousb/nbt-evo-apps/pacchetti/<Name>/, andapps/<Name>/package.txt:name=<Name> title=<shown in the menu of App da USB> version=<version> group=nbt-evo-apps brands=all (or: mini / bmw / supra, several separated by spaces) dest=plugin reset=<Name>.avvii disable_file=/opt/aa/<name>.disable- A new focus id, connector id and image ids (used: focus 32748-32750, 32754-32767, connector 212-227; images SportTest 64001-64110, AppUsb 64150, LetturaDati 64160, MiniSport 64200-65000, ProvaZip 65100-65649 and 66000-66399, iDrive Plus 57001-63001; NBT-AAD uses focus 32752-32753, connector 210, images 55001-55002). Image ids are shared by all the plugins: never give the same id to two plugins.
build/build.shandtools/pacchetti.pypick it up by themselves.
No BMW files (libraries, pictures, texts of the head unit).
- idrive-plus: weather, news, fuel and traffic in the iDrive, from a phone app.
- nbt-aa-tile: Android Auto tile in the main menu.
- NBT-AAD: Android Auto on NBT EVO; the plugin start-up follows its plugin code.
PolyForm Noncommercial 1.0.0, see LICENSE.md. Not affiliated with or endorsed by BMW, MINI or Toyota.