Skip to content

Commandline script to interact with volkswagencarnet library

License

Notifications You must be signed in to change notification settings

Langer75/volkswagencarnet-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

volkswagencarnet-client

command line script to interact with volkswagencarnet library

Table of Contents

General Information

The volkswagencarnet library retrieves statistics about your Volkswagen car from the Volkswagen Carnet online service. Also some actions can be requested via this library. This simple python script allows to use the library via command line and parameters list. In that way it can be used in an easy way e.g. in nodered with the exec node.

Setup

  • Just install the volkswagencarnet library
  • copy/download the script and put it whereever you want to use it from the command line
  • edit the credentials (user email, user password, SPIN) for your myvolkswagen account in the script

Usage

start from command line:

python3 carnet_cli.py <vin> <action> <action parameters>
e.g.
python3 carnet_cli.py <vin> update
python3 carnet_cli.py <vin> setrefresh
python3 carnet_cli.py <vin> setcharger <start/stop>
python3 carnet_cli.py <vin> setchargercurrent <#ampere>
python3 carnet_cli.py <vin> setclimatisationtemp <#temperature>
python3 carnet_cli.py <vin> setclimatisation <electric/auxiliary> <#temperature> <true/false>
python3 carnet_cli.py <vin> setwindowheating <start/stop>
python3 carnet_cli.py <vin> setlock <lock/unlock>"

(vin: Vehicle ID, true: without external power; false: with charging cable only)

All output data are printed out in json format

Features

Currently the following actions are implemented:

  • update - get all available data of the car identified by the VIN (from VW backend only)
  • setrefresh - force the vehicle data update directly from the car
  • setcharger - start or stop charging
  • setchargercurrent - set the chargingcurrent
  • setclimatisationtemp - set the targettemperature for climatisation
  • setclimatisation - start or stop climatisation (for auxiliary heater SPIN needed)
  • setwindowheating - start or stop the window heating
  • setlock - lock or unlock your car (only when activated, SPIN needed)

In addition to the volkswagencarnet library the script gets the newest longtermtripstatistics.

Example for usage

Nodered example of course you have to do something in nodered to get such a dashboard ;-)

Acknowledgements

Project Status

It was developed to use the volkswagencarnet library in nodered. All basic (from my point of view) functions are implemented. However I have tested it only with an eGolf. Feel free to use it or improve it for combustion cars or other functionalities available in the volkswagencarnet library. No licence, public domain, no guarantees.

About

Commandline script to interact with volkswagencarnet library

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages