0.1.2 • Published 5 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.gitcd homekit-ovms-integrationnpm installnpm run buildDEBUG="*" 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-integrationDEBUG="*,-*: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 |