Skip to content

AxelDuerrbaum/ZoePHP

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZoePHP

Unofficial PHP client for the Renault Zoe.

Requirements

  • Renault Zoe with active data subscription
  • Webserver with PHP 5.3 (or newer) and cURL installed
  • Write permissions for the script in its own folder

Usage instructions

  • If you work from GitHub, download config.php and make sure it is in .gitignore (should be already).
  • Adjust the settings in config.php before you run the script for the first time.
  • When calling the script for the first time it creates a "session" file. This file is used for caching your account id, token, car data and so on. Please delete this file after every update of the script.
  • When you activate the database function the script will create "database.csv" as database file for all data records. You can import this file into Microsoft Excel, for example. For saving your car's data regulary you can run the script periodically, for example with cron.
  • If it wasn't possible to receive new data from Renault you will see a notice together with cached data.
  • You can activate two simple mail notifications when running the script periodically: When 1) a specified battery level is reached and/or 2) charging is finished. You can even execute commands when these events are triggered.
  • When the battery level above is reached you can also activate the schedule mode to stop charging.
  • When you call the script periodically using "index.php?cron" or "php index.php cron" you can set how often the Renault API is called (charging/not charging), regardless how often the script itself is called.
  • When you call the script periodically you can also submit live data to ABRP. Just add your ABRP generic token and car model in the config.php.
  • Thanks to @ToKen for the openweathermap.org integration for Ph2-Zoes! If you want to use this feature you need an API key from openweathermap.org.
  • Give a big hand also to Muscat's OxBlog for decrypting the Renault API.
  • For security reasons I recommend to secure the script with basic authentication or other access restrictions.

Screenshots

Ph1 Ph2
Screenshot Ph1 Screenshot Ph2

Packages

No packages published

Languages

  • PHP 98.9%
  • CSS 1.1%