# BMHome

**Your BMW, integrated into Apple Home.**

Fed by BMW’s CarData Stream.

BMHome is a Homebridge plugin that brings selected BMW vehicle information into Apple Home, so your car can sit alongside the rest of your HomeKit devices.

BMHome is currently in public beta.

---

## What BMHome Shows in Apple Home

BMHome is designed to present useful BMW information as simple Apple Home tiles:

- **BMW Battery** — battery state of charge when BMW publishes it
- **BMW Lock** — vehicle security tile, with state feedback where BMW provides it
- **BMW Windows** — open / closed window status
- **BMW Boot** — boot / trunk open status
- **BMW Tyres** — simple OK / not OK tyre pressure status

BMHome deliberately avoids cluttering Apple Home with raw technical telemetry.

---

## How BMHome Works

BMHome connects to **BMW CarData Stream**.

BMW decides what data is published, when it is published, and which descriptors are available for each vehicle. BMHome displays the information BMW sends.

This means BMHome may not always match the MyBMW app instantly. Some updates arrive after vehicle activity such as driving, charging, locking, unlocking, or a BMW backend refresh.

---

## What Works Today

Validated during BMHome beta testing:

- BMW CarData Stream MQTT connection
- BMW iX3 battery state of charge
- Remaining range
- Window / boot descriptor parsing
- Tyre pressure summary
- Apple Home child bridge
- Human-readable Apple Home tile names
- Last-known vehicle state caching
- Quiet reconnect/logging behaviour

---

## Current Limitations

BMHome is not a replacement for the MyBMW app.

Current limitations:

- BMW CarData Stream is event-driven and can be delayed
- Some selected descriptors may not be emitted by BMW for every vehicle
- Lock/unlock command support remains under research
- Charging state and charging power may not be published reliably
- MINI support is expected through BMW Group CarData but is not yet widely field-tested

BMHome only displays or acts on data BMW makes available through CarData Stream.

---

## BMW CarData Stream Setup

Sign in to BMW CarData using the same BMW ID used in the MyBMW app.

BMW UK CarData catalogue:

```text
https://www.bmw.co.uk/en-gb/mybmw/public/cardata-telematic-catalogue
```

Navigate to:

```text
Login
→ My Vehicle Overview
→ BMW CarData
→ CarData API
→ CarData Stream
```

Create or confirm your CarData client, then enable and save the descriptors BMHome needs.

### Recommended Descriptors

```text
vehicle.drivetrain.batteryManagement.header
vehicle.drivetrain.electricEngine.kombiRemainingElectricRange
vehicle.drivetrain.lastRemainingRange

vehicle.body.trunk.isOpen
vehicle.body.trunk.door.isOpen

vehicle.cabin.window.row1.driver.status
vehicle.cabin.window.row1.passenger.status
vehicle.cabin.window.row2.driver.status
vehicle.cabin.window.row2.passenger.status
vehicle.cabin.sunroof.status

vehicle.chassis.axle.row1.wheel.left.tire.pressure
vehicle.chassis.axle.row1.wheel.right.tire.pressure
vehicle.chassis.axle.row2.wheel.left.tire.pressure
vehicle.chassis.axle.row2.wheel.right.tire.pressure

vehicle.body.chargingPort.status
vehicle.powertrain.electric.battery.charging.power
```

### Optional / Model-Specific Descriptors

```text
vehicle.trip.segment.end.drivetrain.batteryManagement.hvSoc
vehicle.drivetrain.fuelSystem.remainingFuel
vehicle.cabin.convertible.roofRetractableStatus
vehicle.vehicle.antiTheftAlarmSystem.alarm.isOn
```

Not every descriptor is available on every vehicle.

---

## Homebridge Setup

Install BMHome through Homebridge.

Plugin settings require:

- BMW CarData Client ID
- VIN
- BMW account authentication
- distance unit preference

BMHome should be run as a child bridge.

After configuration, pair the BMHome bridge with Apple Home using the QR code shown in Homebridge.

---

## BMW Update Behaviour

BMW vehicles do not continuously publish all telemetry in real time.

Updates may appear:

- after driving
- after charging
- after lock or unlock events
- after the vehicle wakes
- after BMW backend refreshes

BMHome keeps the last known state locally so Apple Home can remain useful even when BMW is quiet.

---

## Support Status

BMHome is under active development.

The current beta is intended for technically comfortable BMW owners who understand that BMW CarData behaviour varies by vehicle, region and backend support.

Feedback and issue reports are welcome on GitHub.

---

## Disclaimer

BMHome is an independent Homebridge plugin.

It is not affiliated with, endorsed by, or sponsored by BMW AG, BMW Group, MINI, Apple, or Homebridge.