Communicate with Volkswagen WeConnect
Project description
Volkswagen Carnet
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
- VolkswagenCarnetClient a cli version of this library
Installation
[venv-python3] user@localhost:~
$ pip install volkswagencarnet
Example
#!/usr/bin/env python3
import volkswagencarnet
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',
'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() as session:
connection = volkswagencarnet.Connection(session, VW_USERNAME, VW_PASSWORD)
if await connection._login():
if await connection.update(request_data=False):
# 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())
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
volkswagencarnet-4.4.3.tar.gz
(21.6 kB
view details)
Built Distribution
File details
Details for the file volkswagencarnet-4.4.3.tar.gz
.
File metadata
- Download URL: volkswagencarnet-4.4.3.tar.gz
- Upload date:
- Size: 21.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 139502545faf2fc942c62ac41035475f6d7f9899d93044b82235180bef8af65f |
|
MD5 | 68cbb984e7c70a58c288268fa5fa5382 |
|
BLAKE2b-256 | 30857e691dfec30b524192bf252cf3aa2baadf7aaf82845912ba993825435e9e |
Provenance
File details
Details for the file volkswagencarnet-4.4.3-py3-none-any.whl
.
File metadata
- Download URL: volkswagencarnet-4.4.3-py3-none-any.whl
- Upload date:
- Size: 19.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 140b50edc4d16541e3907a2c4bdefcb02791623b572e56757c68952e55d0f6f0 |
|
MD5 | 0ddc0629106918b7a3fb90291f9d282f |
|
BLAKE2b-256 | 8768f2779b6c4b0a11599aba9b5eb26f619d432867be14ecfc8603146597aa14 |