/homekit-ovms-integration

A HomeKit integration for electric vehicles.

Primary LanguageTypeScriptMIT LicenseMIT

homekit-ovms-integration

FOSSA Status

A HomeKit integration for electric vehicles.

This project integrates OVMS into Apple HomeKit. The exposed metrics mostly concern the car's battery and range, as well as the charger component.

Getting Started

Development

  • git clone https://github.com/theMomax/homekit-ovms-integration.git
  • cd homekit-ovms-integration
  • npm install
  • npm run build
  • DEBUG="*" npm run start -- -a <your OVMS address> -p <your OVMS password>

See Integrations for information on how to configure each integration.

Install Release

  • npm i -g homekit-ovms-integration
  • DEBUG="*,-*:debug,-follow-redirects" homekit-ovms-integration -a <your OVMS address> -p <your OVMS password>

App

I've started working on an iOS app (Home Batteries) that offers an overview for this project's custom services. It also provides an UI for creating automations. Check out the link for more details. The Eve App also supports all of the custom Services/Characteristics defined below.

Custom HomeKit Services & Characteristics

Services

ElectricVehicleChargingStation

Property Value
UUID 00000004-0000-1000-8000-0036AC324978
Required Characteristics BatteryLevel
ChargingState
StatusLowBattery
Active
Optional Characteristics Name
EstimatedRange
CurrentPower

Characteristics

CurrentPower

as defined here

EstimatedRange

Property Value
UUID 00000007-0001-1000-8000-0036AC324978
Permissions Paired Read, Notify
Format float
Unit kilometers

License

FOSSA Status