https://github.com/blueandi/racinglaptimer
Racing lap timer, based on a laser sensor.
https://github.com/blueandi/racinglaptimer
competition cpp11 esp8266 esp8266-arduino laptimer laser race waveshare wemos-d1-mini
Last synced: about 2 months ago
JSON representation
Racing lap timer, based on a laser sensor.
- Host: GitHub
- URL: https://github.com/blueandi/racinglaptimer
- Owner: BlueAndi
- License: mit
- Created: 2020-07-13T18:41:04.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-04-16T20:38:40.000Z (8 months ago)
- Last Synced: 2025-08-31T13:38:40.981Z (3 months ago)
- Topics: competition, cpp11, esp8266, esp8266-arduino, laptimer, laser, race, waveshare, wemos-d1-mini
- Language: C++
- Homepage:
- Size: 1.64 MB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Racing Lap Timer
A racing lap timer, based on a laser sensor.
[](http://choosealicense.com/licenses/mit/)
[](https://www.repostatus.org/#wip)
[](https://github.com/BlueAndi/RacingLapTimer/releases)
[](https://github.com/BlueAndi/RacingLapTimer/actions/workflows/main.yml)
- [Racing Lap Timer](#racing-lap-timer)
- [Motivation](#motivation)
- [Initial Startup](#initial-startup)
- [Electronic](#electronic)
- [Schematic](#schematic)
- [Software](#software)
- [Preparation](#preparation)
- [IDE](#ide)
- [Installation](#installation)
- [Build Project](#build-project)
- [Update of the device](#update-of-the-device)
- [Update via usb](#update-via-usb)
- [Used Libraries](#used-libraries)
- [System Context](#system-context)
- [Issues, Ideas And Bugs](#issues-ideas-and-bugs)
- [License](#license)
- [Contribution](#contribution)
# Motivation
For line follower competitions a racing lap timer shall be used. It doesn't only measure the lap time, it shows it nice via web interface, inclusive automatically result table generation.
# Initial Startup
If the system starts up the first time, it will spawn a wifi access point with the SSID RacingLapTimer. Connect to it, it will request a password (default: "let me in").
Configure there the wifi network SSID/password to which the system shall later connect.
After configuration, the system will try to establish a connection. If the connection is not successful, the access point will be spawned again. Otherwise the credentials will be stored to persistent memory and loaded the next time automatically.
# Electronic
* [Wemos D1 Mini (esp8266)](https://docs.platformio.org/en/latest/boards/espressif8266/d1_mini.html)
* [Waveshare laser sensor](https://www.waveshare.com/wiki/Laser_Sensor)
## Schematic
Schematic files can be found [here](./doc/electronic/RacingLapTimer). These have been developed using KiCAD 6.
### MCU
- Digital signal of laser sensor is connected to D1/GPIO_5 of the Wemos D1 Mini.
- Power is supplied by USB 5V directly to the Wemos D1 Mini
### Laser Power Supply
- Laser module Vcc shall be 3.3V, because MCU is only 3.3V tolerant.
- THT or SMD resistor options are provided. **DO NOT PLACE ALL RESISTORS**.
### Laser Sensor
- Pin header for Waveshare Laser Sensor.
## PCB
### v1.0
- It is recommended to give the Laser Sensor some kind of support in order to protect the pin header from breaking. The height of the support depends on the pin headers used.
# Software
## Preparation
Install the serial driver for the Wemos D1 Mini board. Find the latest drivers here: https://www.wemos.cc/en/latest/ch340_driver.html
## IDE
The [PlatformIO IDE](https://platformio.org/platformio-ide) is used for the development. Its build on top of Microsoft Visual Studio Code.
## Installation
1. Install [VSCode](https://code.visualstudio.com/).
2. Install PlatformIO IDE according to this [HowTo](https://platformio.org/install/ide?install=vscode).
3. Close and start VSCode again.
4. Recommended is to take a look to the [quick-start guide](https://docs.platformio.org/en/latest/ide/vscode.html#quick-start).
## Build Project
1. Load workspace in VSCode.
2. Change to PlatformIO toolbar.
3. _Project Tasks -> Build_ or via hotkey ctrl-alt-b
## Update of the device
### Update via usb
1. Connect the Wemos D1 Mini board to your PC via USB.
2. Build and upload the software via _Project Tasks -> Upload_.
3. Build and upload the filesystem via _Project Tasks -> Upload File System image_.
## Used Libraries
* [Arduino](https://github.com/esp8266/Arduino) - ESP framework.
* [WifiManager](https://github.com/tzapu/WiFiManager) - ESP8266 WiFi Connection manager with fallback web configuration portal.
* [WebSockets](https://github.com/Links2004/arduinoWebSockets) - A WebSocket Server and Client for Arduino based on RFC6455.
## System Context
# Issues, Ideas And Bugs
If you have further ideas or you found some bugs, great! Create a [issue](https://github.com/BlueAndi/RacingLapTimer/issues) or if you are able and willing to fix it by yourself, clone the repository and create a pull request.
# License
The whole source code is published under the [MIT license](http://choosealicense.com/licenses/mit/).
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any
additional terms or conditions.