Adding Bluetooth to your treadmill with an ESP32

The premise

Since the Covid pandemic started a few years back. We are staying at home most of the time and at some point, I decided to purchase a treadmill. After a few weeks of reviewing and investigating different options I went with a cheap Chinese no-name brand that had most of the features of a premium treadmill but none of the so-called “smart” features like Bluetooth or ANT protocols. But deep diving into some forums and projects there is a way to get Bluetooth from it via an ESP32 board.


For this setup, I am using a YK-ET1801B a seemingly no-name brand treadmill.


ESP-WROOM-32 module with WiFi and Bluetooth


An A3144 3Pin model Hall sensor

Hall sensor

Get some Female-to-female Dupont jumper wires if you don’t want to solder. Not necessary but could make things easier

Dupont Jumper wires

Get the Arduino IDE software from

Have a micro USB cable handy as we will need to connect the ESP32 to our PC.

How this overall works is the sensor will get contact when the motor running the belt spins the treadmill mat. The contact is done on the rotating part on the inside of it usually there is a magnet. The treadmill itself actually does the same thing we are just adding another contact next to it. Although I do believe we could attach to the existing one by splicing in the cables I didn’t want to mod the existing manufacturer installation and just add my own. Especially since the sensor costs pennies.
You can see on my installation the original black sensor market in Green is there already. Mine (in Red) is hot glued next to it. And the magnet is inside spinning when used and comes into reach when it revolves around the sensors.

Hall sensor placement.

The setup

So we can initially start the Arduino IDE software. We need to do some things with it before we start.
You can head on over to the site where I got the .ino file that we are going to use for this.

Virus total report as well for security reasons

The work we are going to do is based on that script as that’s how I made it work on mine since it is pretty much versatile for any treadmill with this type of configuration.

In the IDE software, you can on the .ino file from File -> Open
If you are using the ESP32 board I posted above then we need to add support for it.
Go to File -> Preferences
In the Additional Board Manager URLs add this:
Options menu

Once the link is added press OK.
Go to Tools -> Board -> Boards Manager…

Boards Manager

Search for ESP32 and install it.

esp32 library

We will need a few libraries since they do not come as standard with the stock IDE application. First, we go to Sketch -> Include Library -> Manage Libraries…

Library manager

In the search, menu type in Time. Alphabetically scroll down until you find the Time library and install it

Time library

We need two more libraries but they are not in this list so we will need to add them manually.
You can get them at

Download the code as ZIP.

Download as ZIP

Add both libraries by navigating the same way to the library manager but instead choose Sketch -> Include Library -> Add .Zip Library…
Once added we should be good to go with compiling.
Few more things to change.
Go to Tools -> Board and select ESP32 Dev Module

Dev module setup

Set Upload speed to 115200

Upload speed

Set the Partition Scheme to Huge APP (3MB No OTA/1MB SPIFFS)

Partition scheme

We’re done here. You can verify if it compiles by going to sketch Verify/Compile. It will take some time but should finish without any errors. You will see the message at the bottom console


Now inside the code, you need to first change these lines

const char *ssid = "Your_SSID_here";
const char *password = "Your_Wifi_Password_here";

Enter your WiFi SSID ( the name of your WiFi) and password in the second line. This will let the module connect to your WiFi and host a small Web interface that you can access to monitor how it is working.

The other line that needs to be changed is the belt distance and this will be specific to your treadmill the number is measured in mm (millimeters) so keep note. Change that number to what you have currently.

volatile long belt_distance = 142;

Mine measured to 161 but I re-flashed a few times as there was a bit of a difference in what the treadmill screen was showing and what the sensor was picking up. So you can adjust the number and re-flash your modules as many times as you like before you are satisfied with the reading accuracy.

You can also change or remove the name of the device which is shown in the web interface. Default is:


But you can name it what you want or just remove it. The interface basically looks like this.

Web Interface

We need to connect the sensor to the ESP too.
here is the pinout for the Hall sensor.

Hall sensor pinout

And the ESP32 pinout:

ESP32 Pinout

Naturally, VCC and GND are next to each other and that’s an easy one. For the Sensor itself, you can choose the PIN you want. Find the Pin in your code here:

#define interruptPin 26      // the number of the IR Receiver pin

As you can see the default is 26 but you can change it to the other GPIO pins as you like and connect the Signal wire to that PIN as you set it up.

Now the last part is what I mentioned is flashing so when you connect the ESP board via the micro USB cable you will need to select a port on which it is connected. If you don’t have any other USB devices connected you should most likely have only one so it should be easy. But if not you can find it in the Device Manager check under Ports (COM & LPT)

To set the port go to Tools -> Port -> select your port

COM port select

Once that is done you can go ahead and do Sketch -> Upload. The code will start compiling and be uploaded. After that is done leave the board connected and check if the web interface is running. For that, you need to know what IP address your ESP board has. You can find that in your router or use a program like Angry IP Scanner. The program scans your network and finds any device that is connected and live. So you can try the IPs in your browser and see which one it is.

If everything is working we can continue to the last part.

The installation

So you want the Hall sensor to detect the magnet as it spins around. The easiest way is to do it firstly by hand. Place the ESP32 near the motor and hold the sensor in hand while having a phone or laptop with the web interface the monitor the speed and if it is being detected properly. Change the speeds of the treadmill to see if it updates and if it is accurate. If not change the mm length and try again until you are satisfied with the result and accuracy no placing the sensor is up to you. Double-sided tape, super glue, hot glue. Whichever works and keeps it in place as it has to keep up with the vibrations that it will deal with once you are running on it. As well as get some kind of phone charger adapter so you can power the ESP board as well. Any will most likely do. Hopefully, you have a spare power socket nearby.
You can refer to my pictures here:

Install and cable routing

Top view as well

Top view of placement

Check that no cables will snag or interfere with anything and you should be good to go.

I tested it with Zwift and you can see the results:

Zwift Demo


So we managed to add a sensor to measure the cadence and via Bluetooth to detect and connect to programs like Zwift to have additional interaction and provide an enhanced experience to your treadmill sessions.

I hope this has helped you out.



I always wanted to somehow document my work and ideas. I'm finally writing something.

You may also like...

Leave a Reply

Your email address will not be published. Required fields are marked *