If you want to support this project, visit my ko-fi page!

Prerequisites

  • A compatible Amazfit device with a current v0.0.82 package

    • Active 2, round or square, with or without NFC

    • Active 3 Premium

    • Active Max

    • Balance 2

    • Balance 2 XT

    • Bip 6

    • Cheetah 2 Pro

    • Cheetah 2 Ultra

    • T-Rex 3

    • T-Rex 3 Pro, 44 mm or 48 mm

    • T-Rex Ultra 2

  • Zepp app installed on your phone

Experimental support for older watches

An untested API 3.6 / ZeppOS 3.5 build is available for these older devices:

  • Active

  • Balance

  • Cheetah Pro

  • Cheetah Round

  • Cheetah Square

  • Falcon

  • GTR 4

  • GTS 4

  • T-Rex Ultra

This build has not been tested on real hardware, and some features may not work as intended. Use the experimental API 3.6 release if you want to test it and provide feedback.

Installation

  1. Open the current WheelDash v0.0.82 release. Older-device testers should use the experimental release linked above.
  2. Scroll to find your watch model
  3. Open the zepp app and go to Profile > Settings > About, then repeatedly tap the Zepp app’s icon (or version number) about 7-10 times until a confirmation pops up, which unlocks features like scanning QR codes for installing custom apps.
  4. In the Zepp app, go to Device > General > Developer Mode > Mini Program and click on + and select scan
  5. Scan the QRcode found at step 2
  6. Wait a bit (leave the watch nearby) and you are done

Configuration

  1. If you just completed the install, you are already there. Otherwise, in the Zepp app, go to Device > General > Developer Mode > Mini Program
  2. Click on settings for WheelDash
  3. If you want to upload your data to the wheeldash server:
    1. Click on User, then on Register
    2. Enter a valid email and a password, then click on Register. This is the login and password you will need to enter on https://wd.nijalabs.com to view your data.

The rest of the configuration should be self explanatory. Adding a new wheel configuration is done from the watch.

If you have a Garmin Varia radar or Engo HUD Glasses, you first need to add (pair) the device on the watch. The configuration happens in the Wheeldash Zepp app settings and apply to all the wheel profiles. If the glasses or the radar are not found when a profile is started, Wheeldash will ask you if you want to skip them for this ride.

Using the watch app

  1. Go to app launcher and find the Wheeldash icon to launch it (Note: you can assign a shortcut in Zepp. Go to Device > Device Setting and assign Wheeldash, which can be shown as Null, to on of the buttons).
  2. To add a wheel: Click on the + button. (Note: It is way easier to find your wheel the first time if no other wheel are turned on around you)
  3. The bottom button will allow you to start/stop recording
  4. The top button will allow you to exit the app
  5. You can leave your phone at home while riding but you will need the phone nearby and Zepp running when you want to upload your ride
  6. At the end of the ride, you can decide to immediately updload your data as it is proposed when you do, but if your do not, you can always launch the watch app later and click on Ride Manager as the data is saved on the watch