0.1.2 • Published 4 years ago

homekit-ovms-integration v0.1.2

Weekly downloads
1
License
MIT
Repository
-
Last release
4 years ago

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

PropertyValue
UUID00000004-0000-1000-8000-0036AC324978
Required CharacteristicsBatteryLevelChargingStateStatusLowBatteryActive
Optional CharacteristicsNameEstimatedRangeCurrentPower

Characteristics

CurrentPower

as defined here

EstimatedRange

PropertyValue
UUID00000007-0001-1000-8000-0036AC324978
PermissionsPaired Read, Notify
Formatfloat
Unitkilometers

License

FOSSA Status