RaceClocker button firmware update

From time to time, new features or corrections will be made available for the RaceClocker button.

The latest firmware versions can be found on the following link:

https://gee-jee.net/RCButton/Firmware

First step is to check your current firmware version with the button setup tool:

https://gee-jee.net/RCButton/Setup

If you have an older version and want to upgrade to the latest (and hopefully greatest) version, start the Firmware flasher on the following link:

https://gee-jee.net/RCButton/Flasher

  • Download the bundled firmware zip file from the Firmware page.
  • Select the firmware file in the first step

  • Put the button in firmware mode by pressing the button for at least 15 seconds. After 10 seconds, it will start to blink and after another 5 seconds, the LED will be dark.
  • Click on Connect ESP32-S3

You will see the pop up below, select the COM port to connect to and click on the Connect button

  • If all goes well, the button should now show as connected

  • Click on Install Firmware to start the upgrade. The progress bar will show when the upgrade is completed.

After the upgrade is done, make sure to power cycle the button to make the new firmware active.

Once upon a RaceClocker button…

Introduction

Our rowing club organizes regular rowing matches and a number of years ago, we switched from manual stopwatches to RaceClocker for our timing. As we do our timing on bridges for our Bridge to Bridge Race, we primarily use phones for our timing. Tapping on a phone screen is not ideal for timing and we already had an alternative in place with a programmable Bluetooth button. This works fine with a couple of drawbacks. If the phone goes in standby, the button might not reconnect and Bluetooth LE does introduce a small delay when sending the keyboard command.

Enter a new idea: Let’s use a wired USB keyboard emulator button instead!

First task, check which ESP32 is best suitable for this task: The Seeed studio Xiao ESP32 S3 can emulate USB keyboards quite nicely and has a small (enough) footprint. Next step was to select a button which is sturdy enough. Initially I wanted to go with a separate button and LED indicator but found some really nice buttons at TinyTronics with integrated LED ring.

I then spend several hours/days to design and finetune a housing for both the button and ESP32 board.

Support

In case you have any questions or problems building the buttons or are interested in purchasing ready build buttons, feel free to use the Contact form.

Required parts

Note: With the latest firmware, you can also run the RGB version as mono LED.

Assembly

  • Print the 5 parts from my Thingiverse page. Note: The button conn tool and button nut tool are assembly aids and only need to be printed once (unless you misplace them).
  • Cut the foam grip to size (if you ordered the longer version) and slide/wrestle it onto the housing. Leave a bit extra as it tends to stretch when you push it on, you can push it to the correct length later.
  • On the bottom side of the button, mark where the red wire(s) of the connector need to go
  • Put the rubber seal ring on the button and insert it into the hole of the housing.
  • Use the button nut tool to screw the nut onto the button
  • Download the latest firmware file:
  • Start the web based firmware update tool and program the ESP32
  • Solder the connection lead wires to the ESP32 board and insulate them with the heat shrink tubing. Refer to the wiring diagrams for the correct connections.
  • Using the button connector tool, push the connector onto the button.
    • Note 1: Always check the proper orientation first!
    • Note 2: The tool is usable for both the mono connector as well as the RGB connector, make sure to use the correct end.
    • Note 3: I actually cut off the restrain clip of the RGB connector to get it off/on more easily.
  • Test if the button works correctly
  • Slide the ESP32 board into the ESP32 holder (there is a cutout for the Bluetooth connector)
  • Slide the bottom plate onto the ESP32 holder and make sure to align the USB connector properly. Note: You can superglue the holder and plate together to add some extra rigidity and easier assembly of the bottom plate into the housing but this will make it harder to replace the foam grip or ESP32 board.
  • Wiggle the bottom plate into the housing and line up the holes of the housing with the holes in the ESP32 holder. Push the foam grip to the side and screw the holder onto the housing
  • Double check if all is working fine!

Wiring diagram

Mono LED button version:

  • White & Black wire => GND
  • Yellow => D1
  • Red => D2

RGB LED button version:

  • Yellow (NO) => GND
  • Red (3) => 3V3
  • Green (C) => D1
  • Black (2) => D2
  • Red (1) => D3
  • Black (4) => D4

Firmware versions

Mono colour button version

1.0 Initial version
1.1 Added bootloader option to update firmware
1.2 Added USB descriptor for firmware version identification
1.3 Added USB host detection upon startup

RGB colour button version

1.0 Initial version
1.1 Added USB host detection upon startup
1.2 Changed USB host detection to magenta, button press to blue, red blink for bootloader warning
1.3 Added LED “bulb” test upon startup, sequence is red, green, blue, magenta
2.0.0 Combined RGB and Mono colour functionality in the same firmware, added button control functions for setting the LED mode, LED colour (mono LED mode) and which keystroke is send.
2.1.0 Added web based setup tool integration to control button functions
2.2.0 Added settings for RGB mode colors (USB detection, standby, button pressed, bootloader warning).
2.3.0 Optional buzzer support and serial number now showing on setup web tool