Simulate/Implement a Bluetooth Low Energy sensor that can send:
- Cycling Power and Cadence (CSP Bluetooth profile)
- Running Speed and Cadence (RSC Bluetooth profile)
- Cycling Power and Cadence (FTMS Bluetooth profile - partial support)
Zwack has many possible uses, here are some examples:
- Simulate an indoor bike trainer (turbo) generating cyclist power,cadence & speed data to test bike computers fitness, or virtual indoor bike apps.
- Simulate a runner's speed and pace test bike computers fitness, or virtual indoor bike apps.
- Integrate a common treadmill with Zwift, sending data from the treadmill to the Zwift game via bluetooth
- Simulate an indoor bike trainer (turbo) that is able to receive SetTarget (wattage) commands from test bike fitness apps (eg: BreakAway: Indoor Training) for testing. (This method is currently using the Cycling Power Profile with the addition of Wahoo's extension)
At this time Zwack runs succesfuly on Mac OSX (Please check Requirements below) and Raspberry PI. Should run on Windows but it hasn't been tested. If it works let me know.
Install from npm
npm i zwack
or clone this repo and run
npm install
You may need to install Xcode on Mac to compile the bleno
Bluetooth module.
You can see a lot of debug information if you run the simulator or your app with the DEBUG environment variable set to
- csp - Cycling Power and Cadence messages
- rsc - Running Speed and Cadence messages
- ftms - Fitness Machine Messages
- ble - Bluetooth low energy messages
Example:
DEBUG=rsc npm run simulator
DEBUG=* npm run simulator
You'll see something similar to this
rsc [Zwack notifyRSC] {"speed":4.4703888888888885,"cadence":180} +0ms
rsc Running Speed: 4.4703888888888885 +2ms
rsc Running Cadence: 180 +0ms
rsc [Zwack notifyRSC] {"speed":4.4703888888888885,"cadence":180} +1s
rsc Running Speed: 4.4703888888888885 +0ms
Start the simulator by executing:
npm run simulator -- --variable=ftms --variable=rsc --variable=csp --variable=power --variable=cadence --variable=speed
On a different machine start your fitness app, bike computer or indoor virtual bike simulation software, like Zwift, and pair up the Zwack BLE sensor. The sensor name should be Zwack
, it may have some numbers added to the name or you may see the host name of the computer running zwack. It all depends on the operating system you're uing to run Zwack.
If your indoor biking software does not detect the BLE sensor, disable, then enable, the Bluetooth on the machine where Zwack is running and retry to discover and connect to the sensor again.
The ZwackBLE sensor may show up as Zwack
or has the host name of the machine running Zwack. This is normal.
Updating simulation parameters
List of Available Keys
c/C - Decrease/Increase cadence
p/P - Decrease/Increase power
s/S - Decrease/Increase running/cycling speed
d/D - Decrease/Increase running cadence
r/R - Decrease/Increase parameter variability
i/I - Decrease/Increase parameter increment
x/q - Exit
Pressing c
on your keyboard will decrease the cadence, conversly pressing C
(upper case) will increase simulated cadence. Same thing for power by pressing p
or P
.
The variability parameter will introduce some random variability to the cadence and power values, so they don't remain constant all the time. If you lower the variability to 0
the cadence and power values will remain constant.
Press x
or q
to exit Zwack.
npm run simulator -- --variable=ftms --variable=rsc --variable=csp --variable=power --variable=cadence --variable=speed
- ftms - enable broadcasting as FTMS service
- rsc - enable broadcasting as RSC service
- csp - enable broadcasting as CSP service
- power - enable broadcasting CSP with Power only data
- cadence - enable broadcasting CSP with Cadence data (to be combined with
power
) - speed - enable broadcasting CSP with Speed data (to be combined with
power
andcadence
)
Requires NodeJS, and should run in all Bleno (the base BLE module) supported platforms, which are Mac, Windows or Raspberry Pi.
Zwack cannot run on the same computer as the fitness or virtual indoor bike app, you'll need to run them on different systems.
If you have trouble getting BLE to work on MacOS, you can try to install bleno from abandonware using the command
npm install bleno@npm:@abandonware/bleno
Currently this version of zwack is able to broadcast and simulate a FTMS (indoor bike specifically) profile as well as Cycling Power (which also broadcasts Speed). The current implementation of Cycling Power (with Speed & Cadence) is NOT ideal. Cadence and Speed changes will be erratic
- takes ~2 sec to stabilize and be reflected in output
- will be unable to inject randomness into the output
- will need help on how to improve it
I'm sure there are many bugs but as of now, it works and suits the purpose which is for testing as there are no simulators available for bluetooth (similar in form to simulANT).
Initial prototype based on ble-cycling-power code from olympum.
Codes for FTMS support is taken from the FortuisANT project and edited to fit usage as a simulator