Android Auto and Carplay Cluster Integration for Porsche mh2p/PCM5

Service Injection

All platform services are injected via setters after construction:

AA Event → BAP Maneuver Translation

Maps Android Auto eventCode (1–19) + turnSide + angle + num to a BAP maneuver descriptor.

Direction is a 0–255 byte (0=straight, 64=left/90°, 128=back/180°, 192=right/270°).

Distance Update Pipeline

1. Throttle check — minimum ms between sends per proximity zone (veryFar=2000ms down to now=100ms). In "always" bargraph mode, bargraph-only updates bypass the throttle.
2. Maneuver change detection — key = road|eventCode|turnSide. New maneuver resets baseline distance and bypasses throttle for first update.
3. Distance threshold — minimum change required per zone (100m at veryFar down to 5m at now) before text updates. Bargraph always updates for smooth fill.
4. Unit conversion — metric: m below 100m, tenths of km to 19.9km. Imperial: yards below 161m, tenths of miles to 9.9mi.
5. Bargraph — (1 − distance/maneuverInitialDistance) × 100, clamped 0–100.
6. Roundabout traversal — force distance/bargraph to 0 during CONTINUE events to suppress erratic display inside roundabout.

Heartbeat

A daemon timer fires every heartbeatInterval ms (default 2000ms) while navigation is active.
It resends the last cached maneuver, distance, bargraph, and destination data to continuously override the cluster's native navigation display.

Unit & Drive-Side Detection (3-tier each)

Bargraph Auto Mode — Car Variant Detection

When bargraphMode="auto", the car type is queried at runtime via sysServices.config().carType():

Explicit JSON values always override auto-detection.

Roundabout Latching

Android Auto sends EXIT (event=13) first, then CONTINUE (event=12) × N through the roundabout.
Latching caches the exit direction on event=11/13 and reuses it for all subsequent event=12 updates, preventing the arrow from flickering.
Cleared on any non-roundabout event. Configurable via enableRoundaboutLatching.

Logging

Two parallel log files: plain (full road names) and hashed (road names, music metadata replaced with [HASH_nnn] for privacy).
Each entry has a dual timestamp: QNX boot time + real car clock from ISysServices.clock().localTime().
When enableExternalLogging=true, logs are written to USB/SD if writable, with automatic fallback to /tmp.

Logging

Features

Units and Display

Bargraph

Dynamic Thresholds

Controls how aggressively distance updates are sent per proximity zone. Each zone has a boundary (upper edge in metres), distance threshold (minimum change to trigger a send), and rateLimit (minimum ms between sends). now has no boundary — catch-all below veryClose.boundary.

"dynamicThresholds": {
  "veryFar":    { "boundary": 5000, "distance": 100, "rateLimit": 2000 },
  "far":        { "boundary": 1000, "distance": 50,  "rateLimit": 500  },
  "approaching":{ "boundary": 500,  "distance": 25,  "rateLimit": 250  },
  "near":       { "boundary": 200,  "distance": 15,  "rateLimit": 200  },
  "close":      { "boundary": 100,  "distance": 15,  "rateLimit": 150  },
  "veryClose":  { "boundary": 50,   "distance": 10,  "rateLimit": 120  },
  "now":        {                    "distance": 5,   "rateLimit": 100  }
}

Countries

List of country overrides for when locale cannot be detected from platform services. Each entry determines drive side (RHD) and unit system. Countries not listed default to LHD metric. forceImperial and forceRHD override this table entirely.

{ "code": "GB", "name": "United Kingdom", "rhd": true, "imperial": true }
{ "code": "US", "name": "United States",  "rhd": false, "imperial": true }
{ "code": "DE", "name": "Germany",        "rhd": false, "imperial": false }