aiobiketrax

aiobiketrax

Python library for interacting with the PowUnity BikeTrax GPS tracker.

Introduction

This library is mainly written to work with a custom component for Home Assistant. You can find this custom component here.

The PowUnity BikeTrax is a GPS tracker for electric bicycles. It provides real-time updates every when the bike is in motion, using a 2G modem. It works in Europe, and requires a subscription after a trial period of one year.

Features

• Multi-device support.
• Traccar and admin API support.
• Live updates using websocket.

Not implemented:

• Geofencing.
• Global configuration, such as webhooks.

Known issues

The schemas of the models haven been reversed-engineerd by observing responses for a small number of devices. It is likely that responses of other devices do not map onto the current models. For example, some properties are not set if they have never been configured from the app.

Please open an issue, and provide some responses so that the schemas can be improved. Be sure to redact sensitive information, such as locations, unique identifiers and personal details.

Debugging

In case of issues, it is possible to enable logging in your application for the following loggers:

• aiobiketrax.api - API logging.
• aiobiketrax.api.responses - Additional API response logging.
• aiobiketrax.api.client - Client interaction logging.

Usage

In code

from aiobiketrax import Account

import aiohttp

async with aiohttp.ClientSession() as session:
    account = Account(
        username="someone@example.org",
        password="secret",
        session=session)

    await account.update_devices()

    for device in account.devices:
        print(device.name)

CLI

For demonstration and testing purposes, one can use the CLI as well. If you have the package installed, use biketrax --help command to get started.

Mock server

For development, a mock server is included in contrib/mock/. Simply run server.py and adapt aiobiketrax/consts.py to use other endpoints.

API_TRACCAR_ENDPOINT = "http://localhost:5555/traccar/api"
API_ADMIN_ENDPOINT = "http://localhost:5555/admin/api"

Do note that authentication is not mocked.

Contributing

See the CONTRIBUTING.md file.

License

See the LICENSE.md file (MIT license).

Disclaimer

Use this library at your own risk. I cannot be held responsible for any damages.

This page and its content is not affiliated with PowUnity.