A small Windows and Android host for QML interfaces supplied by a VESC controller.
The application discovers VESC adapters, connects over TCP, BLE or USB where the platform supports it, selects an optional CAN target, downloads the controller QML and renders it in a shared viewport. It deliberately leaves motor configuration and package logic on the controller.
- Native Qt 5 host based on the VESC Tool transport and packet implementation.
- Automatic discovery with explicit user selection; no automatic connection.
- Direct and forwarded-CAN QML transfer.
- German and English UI, light/dark themes and persistent connection preferences.
- Windows and Android packaging scripts.
- Local simulator and Qt tests for development without a controller.
Real BLE, USB and bike operation still need broader hardware testing. Treat current builds as development versions.
src/,qml/: application and common connection UI.android/,windows/,deployment/: platform integration and packaging.tools/: local build, packaging and verification helpers.tests/,fixtures/: simulator and offline tests.integration/: optional E-Bike UI used as an offline integration fixture.QML-CONTRACT.md: interface between the host and controller QML.THIRD_PARTY.md,licenses/: upstream source and license information.
Build products, downloaded toolchains and generated files stay under .local/ and
are not committed. The build uses a pinned VESC Tool checkout so packet and QML
handling remain compatible with the VESC ecosystem.
Typical commands from the repository root:
python3 tools/prototype.py build
python3 tools/prototype.py test
python3 -B tests/test_build_tools.py -v
python3 tools/prototype.py run --simulatePlatform helpers:
python3 -B tools/platforms.py windows
python3 -B tools/platforms.py androidThe helpers report missing SDKs or toolchains without installing anything globally.
GPL-3.0-or-later. See LICENSE and THIRD_PARTY.md.