pi-score-counter

Raspberry Pi score counter for games.

How it works?

A Python script records every button action with the GPIO implementation from the Raspberry Pi.
Every action is saved in a SQLite database
A web interface will connect to that database to offer a UI to the program

What does it look like?

Player selection screen

Statistics screen (shown after 30 seconds of inactivity)

In-game screen

In-game screen (game over)

GPIO Inputs

Player 1 - Button A (GPIO23) was GPIO18 before 1.4.0
Player 1 - Button B (GPIO24)
Player 2 - Button A (GPIO22)
Player 2 - Button B (GPIO17)
Reset button (GPIO25)

GPIO Electrical Diagram

Buttons

NFC Reader

Use of buttons

Always
- Reset button: Resets the system to the home page
Before a game
- Button A - Change player
- Button B - Select player
During a game
- Button A - Increase score
- Button B - Decrease score

Game flow

Each players selects his name from the list of available players by using the A and B buttons (data will be prefilled)
When every players has selected his name, the game starts and the score is 0-0
By using buttons A or B, the players can make increase/decrease their score
When the game is over, the system returns to the home page when any button is pressed, and the flows restarts
Any time that the Reset button is pressed, the system returns to the home page
If the score is 0-0 and a decrease button is pressed, the system will return to main menu and cancel the current game

Default config and rules

The default config is based on Table Tennis Canada rules
Every games are 11 points
If there is an equality at 10-10, the game will finish when the difference of points is 2

Statistics

Every game is saved in the database with the score
An ELO based ranking algorithm is implemented to assign a rank to each player
A leaderboard is also shown after 1 minute of inactivity while in the main menu
15 games are required to be ranked

Seasons (new in 1.3.0)

Season have been implemented in web/js/season.js
You can change the variables values in this file to enabled season features
The statistics will be computed within the range of the given dates for the active season
Only 5 games are required to be ranked during a season

Player selection with NFC (new in 1.4.0)

You can now select a player by using a NFC chip
You simply have to write the player's id on the NFC chip with the game/create_player_chip.py script (player's id in arguments)
- sudo python create_player_chip.py [PLAYER_ID]
To setup the NFC Reader, please the section NFC Reader installation

Installation

Simply run install.sh in the install directory
Make sure pigpio is installed on your Pi (should already be installed)
Run whereis pigpiod and add it to your crontab at reboot
- Example: @reboot /usr/bin/pigpiod
If you want to install the NFC reader to choose players faster, please read the next section: NFC Reader installation

NFC Reader installation (new in 1.4.0)

GO TRONIC manual gives these instruction to make the NFC Reader work.
See more info at https://www.gotronic.fr/pj2-sbc-rfid-rc522-fr-1439.pdf
For the wiring, please read the section GPIO Electrical Diagram

On a Raspberry Pi, you should already have this installed:

Run sudo apt-get install python-pip python-dev build-essential
Run sudo pip install RPi.GPIO
Run sudo apt-get install python-imaging

Then follow these steps to enable SPI

Run sudo raspi-config
Search for the option Enable/Disable automatic loading of SPI kernel module and enable it (name and menu can differ from a Pi to another)
Reboot your Pi

After reboot, follow these steps:

Go in the game/SPI-Py folder
Run sudo python3 setup.py install

Execution

Run start.sh that was copied in /home/pi/Desktop

Update

Run update.sh in the install folder to update the code directly on your Raspberry Pi

TheWhite147/pi-score-counter