0.1.2 • Published 4 years ago
homekit-ovms-integration v0.1.2
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 | BatteryLevelChargingStateStatusLowBatteryActive |
Optional Characteristics | NameEstimatedRangeCurrentPower |
Characteristics
CurrentPower
as defined here
EstimatedRange
Property | Value |
---|---|
UUID | 00000007-0001-1000-8000-0036AC324978 |
Permissions | Paired Read, Notify |
Format | float |
Unit | kilometers |