Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jasper-seinhorst/homebridge-porsche-taycan

Homebridge plugin for owners of a Porsche Taycan or Macan EV. See current charge state and Battery level in the Apple Home app
https://github.com/jasper-seinhorst/homebridge-porsche-taycan

apple apple-home apple-homekit electric-vehicles ev homebridge homebridge-plugin homekit local macan porsche taycan typescript

Last synced: 2 months ago
JSON representation

Homebridge plugin for owners of a Porsche Taycan or Macan EV. See current charge state and Battery level in the Apple Home app

Host: GitHub
URL: https://github.com/jasper-seinhorst/homebridge-porsche-taycan
Owner: jasper-seinhorst
License: apache-2.0
Created: 2023-03-03T14:15:45.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-03-24T18:59:29.000Z (9 months ago)
Last Synced: 2024-04-25T22:20:59.109Z (8 months ago)
Topics: apple, apple-home, apple-homekit, electric-vehicles, ev, homebridge, homebridge-plugin, homekit, local, macan, porsche, taycan, typescript
Language: TypeScript
Homepage:
Size: 702 KB
Stars: 10
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Homebridge Porsche EV

[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)

[![npm](https://img.shields.io/npm/dt/homebridge-porsche-taycan.svg)](https://www.npmjs.com/package/homebridge-porsche-taycan)

[![npm](https://img.shields.io/npm/v/homebridge-porsche-taycan.svg)](https://www.npmjs.com/package/homebridge-porsche-taycan)

This Homebrudge plugin offers a range of useful features for your Porsche Taycan and Macan EV, including real-time monitoring of battery level, charging status and charging power. Moreover, it also enables you to easily toggle the direct climatisation option on or off and automate your home with your vehicles location.

## Supported vehicles:

- Taycan (MY19 and newer)

- Macan EV (MY25 and newer)

## Key features

![room](./assets/example-room.png)

- Switch for **Precool / heat**

- Switch for **Direct Charge**

- Sensor for your **Charger** with **SoC**

_{^{A *contact sensor* will indicate if your vehicle is charging, SoC (battery level) is available as accessory characteristic or as separate sensor}}

- Sensor for the **Charging Power** (Optional)

_{^{A *light (lux)* sensor will show current charging power. E.g. 10 lux means your vehicles charges with a speed of 10 kwh.}}

- Sensor for the **Location** fo your vehicle (Optional)

_{^{An *occupancy sensor* indicates if your vehicle is at home when the location of your vehicle is within 300 meters of your home}}

- Sensor for the **SoC** (optional)

_{^{By default SoC is available as characteristic of the charger sensor. Optionally the SoC can be exposed as *humidity sensor*.}}

![charger](./assets/example-charger.png) ![charging power](./assets/example-charging-power.png) ![SoC](./assets/example-soc.png) ![Occupancy](./assets/example-occupancy.png)

## Installation

To install the *Homebridge Porsche Taycan* plugin follow these steps:

- Follow the instructions on the [Homebridge Wiki](https://homebridge.io/how-to-install-homebridge) to install Node.js and Homebridge;

- Install the *Homebridge Porsche Taycan* plugin through Homebridge Config UI X or manually;

  ```

  $ sudo npm -g i homebridge-porsche-taycan

  ```

- Edit config.json and add the *Porsche Taycan* platform. E.g;

    ```

    {

        "username": "<>",

        "password": "<>",

        "pollInterval": 30,

        "batteryDevice": false,

        "chargingPowerDevice": true,

        "lowBattery": 40,

        "platform": "PorscheTaycan",

        locationConfig: {

          "lat": "<>",

          "long": "<>",

        }

    }

    ```

  In above example the charging state and battery level are updated every 30 minutes. The battery level is considered low when the SoC drops below 40. No separate battery level device is exposed, but the current charging power is.

## Caveats

- The plugin can throw authentication errors. The login method used from Porsche's API expects a captcha now and then. As a work around logon to my.porsche.com and restart the plugin. Logging in on my.porsche.com reset the need for a captcha.

- Precool/heat cools or heats your vehicle on activation, the desired temperature can only be changed in the My Porsche app when setting a charge timer.

## Credits

This plugin is not an official plugin from Porsche. The usage of Porsche Connect API endpoints are reverse engineered on MyPorsche with help of Google Chrome Dev tools. It uses the unofficial 'porsche-connect' node package to communicate to Porsches servers.

This plugin started as a hobby project but is now available to the public. Pull requests to improve the plugins are more than welcome.