Skip to content

Latest commit

 

History

History
125 lines (82 loc) · 4.31 KB

README.md

File metadata and controls

125 lines (82 loc) · 4.31 KB

Version

Mini4wdChrono is a fully free and open source project to make a functional 3-lane lap timer for Mini4WD Japan Cup tracks.

The hardware

The hardware has been chosen to be as simple and cheap as possible, while still maintain accuracy.

The software

The software has been built to ease the work of race organizers, while still having a clean interface that can be shown on a big TV screen during the race.

Note: the program reads data from the "Mini4WD Track Editor" and "Mini4WD Tournament Generator" websites to access track length and player names, so you are required to create your track and player list using those websites.

Download the software

You can download the latest releases for Windows 10 (64-bit) or Mac OS (64-bit) from the releases page.

Screenshots

Main lap timer view, with position, delay from first place, average speed and split times.

race view

Player roster view, sorted, showing best time of each player in red.

players view

Tournament view with all rounds. Times are editable.

manches view

Race setup screen. You can import data from Mini4WD Track Editor.

setup view

Developing and contributing

Build on OSX

Run brew install nodenv and follow installation instructions here. https://github.com/nodenv/nodenv

brew cask install arduino
cd mini4wdchrono
nodenv install
npm install

# make sure the arduino board is connected via USB, then
npm start

To package the project run utils/build_darwin.sh, or

electron-packager . Mini4wdChrono --overwrite --icon=images/ic_launcher_web.icns --prune=true --out=release-builds

Build on Windows

Make sure you are running a Powershell with administrator permissions, and Chocolatey is installed.

choco install python2
choco install arduino
choco install nodejs --version=10.16.3
npm install -g windows-build-tools
cd mini4wdchrono
npm install

# make sure the arduino board is connected via USB, then
npm start

To package the project run utils/build_win64.ps1, or

electron-packager . Mini4wdChrono --overwrite --asar --icon=images/ic_launcher_web.ico --prune=true --out=release-builds

Build on Linux

⚠️ This instructions are from a very old note, I haven't tried them recently.

sudo apt update
sudo apt install build-essential apt-transport-https lsb-release ca-certificates curl
curl -sL https://deb.nodesource.com/setup_10.x | bash -
sudo apt install nodejs
sudo apt install npm
cd mini4wdchrono/
npm install
./node_modules/.bin/electron-rebuild
sudo chmod 666 /dev/ttyACM0

# make sure the arduino board is connected via USB, then
npm start

Errors

If you get an error when running the program like

Serialport was compiled against a different Node.js version using NODE_MODULE_VERSION 72. This version of Node.js requires NODE_MODULE_VERSION 70. Please try re-compiling or re-installing the module (for instance, using npm rebuild or npm install).

it means you need to run electron-rebuild on the project. Please run npm run postinstall inside the project directory.

Related issue: serialport/node-serialport#1910