Awesome
Drum booth controller
JavaFX UI running on Raspberry Pi with relays and a serial connection to an Arduino to control the lights and LED strips in a drum booth.
This project combines multiple examples of the book "Getting started with Java on Raspberry Pi". All the sources of the examples in this book are freely available on GitHub.
History of this Project
As Java, JavaFX, and the used hardware has evolved, the main branch deviated from the original blog post.
202409 Waveshare Raspberry Pi Zero
202003 Raspberry Pi with I2C stack-on relays boards
Full description is available in this blog post: "Drumbooth controller with Raspberry Pi and JavaFX".
If you need the sources of this version, please check-out the tag i2c-relays.
Wiring
- Shared
- USB cable between both boards (for serial communication)
- 5V and ground from power supply to Pi, Arduino and LED strips
- Raspberry Pi
- Raspberry Pi Zero 2 W
- Mounted in a Waveshare Industrial 6-ch Relay Module for Raspberry Pi Zero, RS485/CAN, Isolated Protections
- Arduino
- Control cable between pins 6, 7 and 8 to each of the three LED strips
Commands between Java and Arduino application
The commands shared between both boards are strings in the structure “COMMAND_ID:SPEED:R1:G1:B1:R2:G2:B2”, where the command ID is one of the following options:
Java application
JavaFX user interface with three screens
Undertow webpage to trigger some actions
Build and run on Raspberry Pi
These instructions are intended to be used with an ARMv8 Raspberry Pi (RPi4+ or RPi Zero 2) with Raspberry Pi OS 64-bit. In the following code examples, the user account is drum and the hostname drumbooth.
Install Visual Studio Code (if needed)
After initial startup, you can run the following commands to also install Visual Studio Code if you want to test, modify, and/or build the code:
$ sudo apt update
$ sudo apt upgrade
$ sudo apt install code
Enable Serial
The commands for the LED strips are sent via serial communication to the Arduino board, so it has to be enabled in raspi-config:
$ sudo rasp-config
> 3 Interface Options
> I6 Serial Port
> Login shell: no
> Serial hardware: yes
> Finish
> Reboot
Build and Copy the JAR to the Raspberry Pi
Build and copy the files to your Raspberry Pi from your development PC. Create the drumbooth directory before executing these commands the first time.
$ mvn package
$ scp target/*dependencies.jar drum@drumbooth.local://home/drum/drumbooth
$ scp target/distribution/* drum@drumbooth.local://home/drum/drumbooth
$ scp scripts/start.sh drum@drumbooth.local://home/drum/drumbooth
Running on Raspberry Pi
- Install JDK with JavaFX following the guidelines on :
$ sudo apt install gnupg ca-certificates curl
$ curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg
$ echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list
$ sudo apt update
$ sudo apt install zulu22-jdk
- Check the Java version:
$ sudo java -version
openjdk version "22.0.2" 2024-07-16
OpenJDK Runtime Environment Zulu22.32+15-CA (build 22.0.2+9)
OpenJDK 64-Bit Server VM Zulu22.32+15-CA (build 22.0.2+9, mixed mode, sharing)
- Download the JavaFX runtime
$ wget -O openjfx.zip https://download2.gluonhq.com/openjfx/22.0.2/openjfx-22.0.2_linux-aarch64_bin-sdk.zip
$ unzip openjfx.zip
$ sudo mv javafx-sdk-22.0.2/ /opt/javafx-sdk/
$ rm openjfx.zip
- Run with the included script which can also be used at startup of the Pi to automatically launch the application
sudo bash /home/drum/drumbooth/start.sh
Kiosk mode
$ sudo apt update
$ sudo apt upgrade
$ sudo apt install libgl1-mesa-glx
TFT screen
Settings to be added to config.txt
max_usb_current=1
hdmi_force_hotplug=1
config_hdmi_boost=10
hdmi_group=2
hdmi_mode=87
hdmi_cvt 1024 600 60 0 0 0
Arduino project
http://wiki.openmusiclabs.com/wiki/ArduinoFHT http://wiki.openmusiclabs.com/wiki/FHTExample
Application
Controls three WS2812 LED strips with the same effect. Code is separated into multiple file so it's easier to understand and maintain.