Communicate with Volkswagen Connect
Project description
Volkswagen Carnet
Help Wanted
As i don't have a car with Volkswagen Connect anymore i would appreciate if it would be possible to get help to keep this repository maintained. So if you feel that you have some time over and is interested in helping out with this. Please feel to contact me! Thanks
Information
Retrieve statistics about your Volkswagen from the Volkswagen Carnet online service
No licence, public domain, no guarantees, feel free to use for anything. Please contribute improvements/bugfixes etc.
Thanks to
For supporting and helping in this project.
Other related repositories
- HomeAssistant Component a custom component for Home Assistant
Installation
[venv-python3] user@localhost:~
$ pip install volkswagencarnet
Example
#!/usr/bin/env python3
from volkswagencarnet.vw_connection import Connection
import pprint
import asyncio
import logging
from aiohttp import ClientSession
logging.basicConfig(level=logging.DEBUG)
VW_USERNAME='test@example.com'
VW_PASSWORD='mysecretpassword'
COMPONENTS = {
'sensor': 'sensor',
'binary_sensor': 'binary_sensor',
'lock': 'lock',
'device_tracker': 'device_tracker',
'switch': 'switch',
'climate': 'climate'
}
RESOURCES = [
'position',
'distance',
'electric_climatisation',
'combustion_climatisation',
'window_heater',
'combustion_engine_heating',
'charging',
'adblue_level',
'battery_level',
'fuel_level',
'service_inspection',
'oil_inspection',
'last_connected',
'charging_time_left',
'electric_range',
'combustion_range',
'combined_range',
'charge_max_ampere',
'climatisation_target_temperature',
'external_power',
'parking_light',
'climatisation_without_external_power',
'door_locked',
'trunk_locked',
'request_in_progress',
'windows_closed',
'sunroof_closed',
'trip_last_average_speed',
'trip_last_average_electric_consumption',
'trip_last_average_fuel_consumption',
'trip_last_duration',
'trip_last_length'
]
def is_enabled(attr):
"""Return true if the user has enabled the resource."""
return attr in RESOURCES
async def main():
"""Main method."""
async with ClientSession(headers={'Connection': 'keep-alive'}) as session:
connection = Connection(session, VW_USERNAME, VW_PASSWORD)
if await connection.doLogin():
if await connection.update():
# Print overall state
pprint.pprint(connection._state)
# Print vehicles
for vehicle in connection.vehicles:
pprint.pprint(vehicle)
# get all instruments
instruments = set()
for vehicle in connection.vehicles:
dashboard = vehicle.dashboard(mutable=True)
for instrument in (
instrument
for instrument in dashboard.instruments
if instrument.component in COMPONENTS
and is_enabled(instrument.slug_attr)):
instruments.add(instrument)
# Output all supported instruments
for instrument in instruments:
print(f'name: {instrument.full_name}')
print(f'str_state: {instrument.str_state}')
print(f'state: {instrument.state}')
print(f'supported: {instrument.is_supported}')
print(f'attr: {instrument.attr}')
print(f'attributes: {instrument.attributes}')
if __name__ == "__main__":
loop = asyncio.get_event_loop()
# loop.run(main())
loop.run_until_complete(main())
Development
I'd strongly advise installing the git pre-commit hook using pre-commit install
. See pre-commit.com for details.
Some basic checks are performed before you commit the code, so code style issues
will be visible and fixable before creating the PR. Git pre-commit hooks can
always be skipped using the --no-verify
flag to git commit
, if there
is something preventing you from actually fixing the reported (and non-auto-fixed) issues.
Decent test coverage for any new or changed code is also much appreciated :)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file volkswagencarnet-5.0.2.tar.gz
.
File metadata
- Download URL: volkswagencarnet-5.0.2.tar.gz
- Upload date:
- Size: 75.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 93f02e7a0cdbc46b8df43e3658c3cbd590cb875274adc47f822d040aa8dc51de |
|
MD5 | f61aae9a102a9288773e92c29f58ed35 |
|
BLAKE2b-256 | 6a45079252e81c2347720ab402ca054971aeaa0c21493346ede34fbb32d06fbf |
File details
Details for the file volkswagencarnet-5.0.2-py3-none-any.whl
.
File metadata
- Download URL: volkswagencarnet-5.0.2-py3-none-any.whl
- Upload date:
- Size: 51.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | faca6afb6ce032d386aacead7782527b663e4330d9f36344bfad3b705c4719c0 |
|
MD5 | dbbdbd5c2298304d62a0501916aa505f |
|
BLAKE2b-256 | 3c3516ca13f6bc88552ae4763211ca7989d4ac6fea4381f1e43fc291ef33c32e |