This is a custom firmware project for the EleksTubeHAX family of IPS nixie-tube-style desk clocks. It is an embedded C++ application targeting ESP32 microcontrollers (ESP32, ESP32-S2, S3, C3) using the PlatformIO build system. The firmware provides a full-featured digital clock with customizable clock faces (stored as BMP or CLK images in LittleFS), WiFi connectivity (WPS, static IP), NTP time sync with adaptive polling intervals, battery-backed RTC support (DS1302, DS3231, RX8025T), and RGB backlight control (WS2812 LEDs) with multiple effects (pulse, breath, rainbow). It includes an on-device menu system with button (and gesture sensor) navigation, Home Assistant MQTT auto-discovery for remote control, and IP geolocation for automatic timezone/DST detection. The architecture is a monolith with clear class separation (Backlights, Buttons, Menu, TFTs, Clock, ChipSelect, WiFi_WPS, MQTT_client, IPGeolocation). The code heavily uses conditional compilation (#ifdef HARDWARE_*) to support over a dozen physical clock variants (EleksTube, SI HAI, Xunfeng, IPSTube, MarvelTubes, etc.), which increases complexity but enables a single codebase to target many boards. The project includes forked and modified libraries (TFT_eSPI, NTPClient, RTC_RX8025T, SparkFun APDS9960) integrated into the repo, which may diverge from upstream over time.
This repository provides a complete firmware solution for building a DIY force feedback (FFB) steering wheel for sim racing, targeting Arduino Leonardo/Micro/ProMicro (ATmega32U4). The firmware implements a custom USB HID joystick with full FFB support (constant, ramp, spring, damper, inertia, friction, periodic effects) and runs a 500 Hz control loop. It supports multiple hardware configurations: optical or magnetic encoders, PWM or DAC motor output, load cell pedals, button matrices, shift registers, and more. The codebase is a heavily modified fork of the BRWheel project, with custom Arduino core modifications to enable FFB HID descriptors. The repository includes precompiled HEX files for dozens of hardware variant combinations, wiring diagrams, and a serial configuration interface. While functionally complete and actively maintained, the code exhibits high technical drift due to reliance on Arduino IDE 1.8.5 and manual core patching, and the monolithic structure with extensive conditional compilation makes maintenance and reuse challenging.