Skip to main content

OpenHamClock Kiosk

For an amateur radio operator, having a real-time dashboard is essential for monitoring band conditions and identifying DX opportunities. While several solutions exist, I recently completed a project centered on OpenHamClock, an open-source, web-based successor to Elwood Downey’s (WB0OEW) original HamClock. My goal was to move beyond simply opening a browser tab and instead create a dedicated, always-on kiosk for my workshop/shack. This setup allows me to monitor live DX cluster spots, PSKReporter reception, and satellite X-ray flux in real-time, helping me decide exactly when to jump into a radio session.

Prototype build of OpenHamClock kiosk.

The heart of this project is a two-component system: a centralized server and a remote kiosk unit. For the server, I utilized a PC equipped with an AMD Ryzen 7 series CPU and 32GB of RAM. While this machine hosts multiple other services, it serves as the perfect, reliable host for the OpenHamClock backend.

The installation process is straightforward, following the official repository guidelines to get the software running on Node.js. To tailor the dashboard to my specific needs, I configured a .env file in the root directory with my preferred settings. Once I verified the deployment was accessible via the default port 3000, I transitioned the application into a formal system service to ensure it runs continuously and resumes automatically after system restarts.

Live traffic updates in local OpenHamClock deployment.

When creating the custom openhamclock.service script, it is vital to update the Environment, WorkingDirectory, and ExecStart paths to match your specific installation. If you use a Node.js version manager other than NVM (such as fnm or brew), ensure you modify the service file accordingly. Additionally, update the User and Group variables to reflect your Linux credentials. After a quick daemon-reload and enabling the service via systemctl (check the commands in below), the backend was up and running without any issues:

sudo systemctl daemon-reload
sudo systemctl enable openhamclock.service
sudo systemctl restart openhamclock.service

With the server established, I turned my attention to the kiosk hardware. I chose the Banana Pi M4 Zero, based on the Allwinner H618 with 2GB of DDR4 RAM - paired with a 10.1-inch display. This SBC provides ample power for a dedicated web interface while maintaining a tiny footprint. Because the kiosk is intended for long-term operation, thermal management and power stability were my primary hardware priorities.

Banana Pi M4 Zero setup.

I am running this unit in a workshop environment where ambient temperatures typically stay between 29°C and 31°C. To prevent overheating during extended uptime, I installed a commonly available Banana Pi M4 Zero heatsink kit. After 24 hours of continuous operation, the board temperature stabilized at approximately 38°C, which is a very safe range for this chipset. Powering the unit requires a reliable source to avoid mid-session crashes; I used a 5V 3A power supply unit to drive the board.

Heat map of the Banana Pi M4 Zero after 24 hours of continuous operation.

The software side of the kiosk required a "set it and forget it" approach. I used Armbian to craft a minimal OS image built on the X Window System using the Openbox window manager and Chromium. This image requires no keyboard or mouse and boots directly into the dashboard. To protect against SD card wear and file system corruption, the OS is designed to launch with a read-only rootfs. While the initial launch takes a moment, subsequent boots are impressively fast, typically reaching the dashboard within 30 to 35 seconds.

Integrating the Banana Pi into the display unit involved some custom fabrication. I designed a mounting unit using a 2mm acrylic sheet to securely attach the SBC to the back of the 10.1-inch display. Using a laser cutter, I precision-cut the sheet and all necessary mounting holes. This mounting panel drawing available in the download pack.

Mounting structure.

The final touch was optimizing the UI for the hardware. Given the display’s 1024×600 resolution, I configured OpenHamClock to run in "tablet mode", which scales the information perfectly for this screen size. The unit has been running continuously in my workshop for a few weeks now, allowing me to monitor the ionosphere, HF band traffic, and track SOTA/POTA activators in real-time.

All mentioned service scripts, environment files, and mounting drawings are available in my Google drive, and the OS build system can be found on https://github.com/dilshan/openhamclock-kiosk.

Comments

Popular posts from this blog

Building the TD4 4-Bit CPU

The TD4 is a famous 4-bit CPU featured in the book How to Build a CPU by Kaoru Tonami . The book focuses on constructing a functional processor entirely from basic 74-series TTL logic ICs. While the book is unfortunately only available in Japanese, a friend from Japan sent me a copy along with a TD4 PCB. I believe the PCB is based on the open-source design files available on BG5DIW's GitHub repository . "How to Build CPU" book and the PCB. Recently, I finally found the time to build and experiment with it. The project took a few months, as I had to translate the book myself to grasp the core concepts. The overall design is simple and elegant, offering a set of 12 instructions and a 16-byte ROM (implemented via DIP switches) for programming. The board operates on 5V and can be powered via USB. Most components were sourced from local shops, though I had to order a few 74HC-series ICs online. Later, I tested the circuit by replacing some 74HC components with 74LS series...

CD2003 - yet another simple FM radio receiver

In the last few days, we are looking for some simple FM radio receiver to integrate into one of our ongoing projects. For that, we try several FM radio receiver ICs including TDA7000, CD2003/TA2003/TA8164, CXA1019, and KA22429. Out of all those chips we select CD2003 (or TA2003/TA8164) based receiver for our project because of its simplicity and outstanding performance. Except to CD2003, Sony CXA1019 also perform well but we drop it because of its higher component count. We design our receiver based on Toshiba TA2003 datasheet and later we try TA8164 and CD2003 with the same circuit. Either CD2003 or TA8164 can directly replace TA2003 IC, and as per our observations, TA8164 gives excellent results out of those 3 chips. A prototype version of CD2003 FM radio receiver The PCB design and schematic which we used in our prototype project are available to download at google drive (including pin-outs of crystal filters and inductors ). Except for CD2003 IC, this receiver consist...

Arduino superheterodyne receiver

In this project, we extend the shortwave superheterodyne receiver we developed a few years ago . Like the previous design, this receiver operates on the traditional superheterodyne principle.  In this upgrade, we enhanced the local oscillator with Si5351 clock generator module and Arduino control circuit. Compared to the old design, this new receiver uses an improved version of an intermediate frequency amplifier with 3 I.F transformers. In this new design, we divide this receiver into several blocks, which include, mixer with a detector, a local oscillator, and an I.F amplifier. The I.F amplifier builds into one PCB. The filter stage, mixer, and detector stages place in another PCB. Prototype version of 455kHz I.F amplifier. In this prototype build, the Si5351 clock generator drives using an Arduino Uno board. With the given sketch, the user can tune and switch the shortwave meter bands using a rotary encoder. The supplied sketch support clock generation from 5205kHz (tuner f...