Repository navigation
HMG-API 1.1.0-beta.1
Pre-releaseHMG-API 1.1.0-beta.1 is a beta, for owners who want to help test. If you'd rather not, stay on 1.0.2: it's still the current release. The final 1.1.0 is planned for mid-November, after a release candidate. Changes from maintainers can still land until Nov 11 (#135).
It comes with Wireless CarPlay + Android Auto 2.2.0-beta.1, the first release from the mod's own repository. ADB and NEMESIS in the app menu are the same as in 1.0.2.
What's new
- US Ioniq 5 (2023 on) on 260903: the full hook map (351 of 351 points, up from 325). The missing 26 came from joelsmith's on-car mapping (#1). Mods that use them now run on 260903 too: the 12V battery readings, CarPlay's points, the cluster and the iAP2 (CarPlay) service.
- No more head unit restart at car start on cars that send Digital Key data. With a mod that reads the car, HMG-API answered one of the car's callbacks wrongly, and system_server crashed (seen on a US Niro EV 260507). Thanks to dibble9012 (#101).
- Wireless CarPlay + Android Auto 2.2.0-beta.1:
- CarPlay turns on the cluster and HUD for more maneuvers: ordinary turns without an exit angle, left-hand-traffic routes, and the previous route's arrow cleared at the start. Thanks to codevalley (#15).
- Lanes only from the phone, no longer overwritten by the car's own navigation. Thanks to AwsomeFox.
- A new setting, off by default: Android Auto turns in the car's own format, for the AR HUD's arrow and distance bar.
- No more loading spinner on the cluster and HUD at roundabouts with Android Auto.
- "Support the project" in the app's Settings opens the wiki's Support page, which lists each maintainer's own links.
- For mod authors:
- The mod SDK (
hmgapi-mod-sdk-1.1.0-beta.1.zip, below), for building, testing and packaging a mod in its own repository. "nemesis_conflicts"in mod.json.- 12V battery sensor readings (
battery12v.*). Thanks to zpoon (#66). - New hook points (DiPO Bluetooth and picture, 12V battery), mapped on every car.
- Zips come out with the same bytes on any machine.
- The full list is in the CHANGELOG.
- The mod SDK (
Installing
- From 1.0.x: put
hmgapi-1.1.0-beta.1-update.zipinHMGAPI/updates/on a USB stick, then HMG-API app → Check USB updates. Then restart the head unit once. Your mods and settings stay. To get the wireless beta too, also putwireless-carplay-aa-2.2.0-beta.1.zipinHMGAPI/updates/, then pick it in Check USB updates and Apply changes. - With NEMESIS: unzip
hmgapi-1.1.0-beta.1-nemesis.ziponto a stick and update from NEMESIS Manager's Package Store. - New install: as in Installing HMG-API, with
hmgapi-1.1.0-beta.1-usb.zip.
What to test
- The app shows 1.1.0-beta.1 and "Hooks on". Your mods still run after the update and a restart.
- Wireless CarPlay and Android Auto connect, with turn-by-turn on the cluster and HUD: ordinary turns, roundabouts, lanes before a turn.
- Ioniq 5 on 260903: HMG-API app → Settings → Check the map on this car, then a Car Report. Reports from two or three cars let us mark the map as checked for everyone.
- With a car that has a Digital Key: no restart at car start.
- Settings → the "Support the project" line looks right on the screen.
Known issues
- Ioniq 5 on 260903: the wireless mod doesn't list this software yet, so it says "isn't for this head unit". Install anyway works, at your own risk.
- Not in this beta: Android Auto's left-hand-traffic roundabouts and "Recalculating…", keeping Bluetooth up during wireless CarPlay, and the CarPlay picture freeze fix. They're open pull requests in the wireless repo.
- The rest are the same as in 1.0.0. For example, a USB stick left in the port can start wired Android Auto and stop wireless from connecting. Take the stick out after installing.
Going back to 1.0.2
The app won't install an older HMG-API over a newer one, so either:
- With adb:
adb push hmgapi-1.0.2-update.zip /data/local/tmp/, thenadb shell hmgapid engine update-hmgapi /data/local/tmp/hmgapi-1.0.2-update.zip --force. Restart the head unit. - Without adb: uninstall HMG-API (Uninstalling, without
PURGE, so your mods and settings stay), restart, then install 1.0.2 as new.
For wireless 2.1.0: remove the mod in the app and apply, then install wireless-carplay-aa-2.1.0.zip from 1.0.2's release with Check USB updates.
Reporting
A Car Report, or open an issue with:
- your car;
- the head unit software (e.g. 260507 or 260903);
- the HMG-API version (1.1.0-beta.1) and the wireless mod's version;
- what you did and what happened.
Problems with wireless CarPlay or Android Auto go in the mod's repo. Please don't post your VIN, serial numbers or phone numbers; nothing needs them.