homekit-ovms-integration

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