EleksTube IPS 时钟和类似克隆的自定义固件(小生命,平克Cyber,MarvelTubes,IPSTube,
EleksTube IPS Clock (Original Version)
EleksTube IPS Clock Gen2
SI HAI IPS Clock
Xunfeng IPS Clock
NovelLife SE Clock
PunkCyber IPS Clock f/k/a RGB Glow Tube DIY Clock
IPSTube Clock - Model H401 and H402
With and without bottom LED stripe
With and without hardware dimming
MarvelTubes Clock
MarvelTubes Gen2 Clock
MarvelTubes Mini Clock f/k/a Marvel Tribe Mini
D'Esign Clock
EleksTube IPS Clock is the original model created by the inventor in 2021. There are now many similar designs and clones on the market with varying hardware modifications.
All "Original EleksTube" clocks sold after July 2022 are "Gen2" versions. Refer to the Blog post on EleksTube website for more details.
Newer versions from EleksTube, such as PR1 and PR2, Pro and special editions (Pink etc.), are based on the base Gen2 version and sometimes called Gen3, because the original firmware version is already at Version 3.x for them.
The "basic" version is now officially called "EleksTube IPS Classic Edition"
In 2024, the IPSTube clocks became the cheapest and most widely available "clone" variant of the EleksTube clocks on the market. They are offered by a wide range of sellers and under many different names, but they all have the "IPSTube" logo printed on the front. Most listings include words like Nixie, Tube, Clock, LED, Light, RGB, IPS, and Glow in the description.
Since 2025, the MarvelTubes Gen2 is a production-cost-reduced variant of the MarvelTubes clock (retail price unchanged) — the MCU was changed from the ESP32-S2 to a standard ESP32 (no PSRAM), and the RTC chip and backup battery were omitted; the time is kept exclusively via NTP.
You can buy the "EleksTube IPS Clock" (or its clones) from eBay, Banggood, AliExpress, Amazon, the EleksTube website and other retailers.
Ensure the seller has a good reputation and offers a kind of return guarantee to avoid purchasing fake products or being tricked.
This firmware supports and has been tested on various clock models listed above.
If you discover a new clone or version of these types of clocks, please report it by creating an issue in the "Issues" section of the GitHub project. Provide as many details as possible to help expand compatibility.
EleksTube IPS - original Version - with hardware modification EleksTube IPS - Gen2 (EleksTube IPS Classic Edition/Pro/PR1/PR2) SI HAI IPS Xunfeng IPS Clock NovelLife SE PunkCyber IPS IPSTube - H401 IPSTube - H402 MarvelTubes MarvelTubes Gen2 MarvelTubes Mini D'Esign Clock
For detailed pictures for most of the clocks see the docs subdirectory.
Show the actual time on the LCDs of the clock with the selected clock face
On-Screen menu to change settings/configuration of the clock
Multiple clock faces can be loaded into the clocks flash memory. Switchable via clock menu (or MQTT messages)
12/24 hour view (switchable via clock menu)
WiFi connectivity with NTP server synchronization
Supports either WPS connection or hardcoded WiFi credentials (from code)
Automatic time zone and Daylight Saving adjustment using IP-based geolocation APIs (supports multiple providers)
Optional manual time zone adjustment in 1 h and 15 minute slots (if IP Geolocation is disabled or fails)
RGB backlights (wall lights) for nice ambient light with multiple modes ("Off", "Test", "Constant", "Rainbow", "Pulse" and "Breath")
Dimming of the displays and backlights during the night time (start and end time configurable in code)
Turning displays on and off (not supported on all clock versions)
Keeping time even when power is off by using battery-powered real-time clock
Saving and loading clock configuration from the flash, to store all settings, even when power is off
Supports various bitmap image file variants (classic or palettized BMP) and proprietary compressed files (CLK)
Maximum image size is 135 x 240 (Width x Height) pixels
Supports smaller images – they will be automatically centered
Advanced error handling for best user experience
Supports Home Assistant integration with extensive MQTT support (see below for details)
Supports custom MQTT integration (for example SmartNest.cz) for remote control - Switch clock faces and turn displays on/off
With a MQTT broker (SmartNest, HiveMQ, SmartThings, Mosquitto etc.), this can also be integrated via a mobile phone app, a website or into an existing home automation network (and can be controlled via Google assistant, Alexa, etc.)
WiFi and MQTT errors are displayed below the digits
Debug outputs via the serial port
If activated in the code, clock can be remote controlled via Home Assistant - one of the leading free home automation solutions (see Home Assistant Homepage).
Features:
Some clock models have specific functionalities or hardware specials which are only available for that model
No buttons on the clock, only a gesture sensor
Gesture sensor is supported by simulating the buttons like the other clocks have
This model has a 8MB flash memory, so either more clock faces can be stored on the clock or in a better quality (i.e. no palettization/conversion needed) or bigger size of the images.
Uses a dedicated PlatformIO environment (IPSTube) with the partition_8MB.csv layout and custom board definition found in boards/.
Note: See "Known problems/Limitations" for more info.
Ships with 16MB of flash, allocating a 2MB application slot and a large LittleFS partition so high-resolution or alternate clock faces rarely need recompression.
Uses an ESP32-S2-WROVER module with 16 MB flash and 2 MB PSRAM.
Hardware PWM dimming for the displays.
Uses a dedicated PlatformIO environment (MarvelTubes) with the partition_16MB.csv layout and custom board definition found in boards/.
Second-generation MarvelTubes clock with a standard ESP32-WROOM-32E module (not S2), 16 MB flash, no PSRAM, no RTC.
Hardware PWM dimming for the displays.
Uses a dedicated PlatformIO environment (MarvelTubes_Gen2) with the partition_16MB.csv layout and the custom board definition esp32devmarveltubesgen2 found in boards/.
Compact version of the MarvelTubes clock with 6× ST7735 80×160 px IPS TFT displays on individual breakout boards.
Uses an ESP32-C3-Mini-1 module with built-in USB Serial/JTAG — no external USB-UART chip (e.g. CH340).
Chip select lines, display reset and backlight power/dimming are all controlled via an I2C IO expander (address 0x19) — no shift register, no direct GPIO CS.
Hardware brightness dimming is done through the IO expander register, not via PWM or software alpha blending.
No RTC or battery is included in the standard kit. Soldering pads for an I2C RTC are present on the PCB but unpopulated — time is kept exclusively via NTP.
Clock face images are automatically rescaled to 80×160 px during the build process by a pre-build script (script_prepare_mini_clockfaces.py).
Uses a dedicated PlatformIO environment (MarvelTubesMini) with the partition_4MB.csv layout and the custom board definition esp32devc3minimarveltubesmini found in boards/.
Uses a modified version of the TFT_eSPI library (stored in lib/modified_TFT_eSPI) for ESP32-C3 processor support and correct ST7735 80×160 display offsets.
Requires monitor_dtr = 0 and monitor_rts = 0 in PlatformIO to prevent unintended clock resets when opening or closing the serial monitor (the ESP32-C3 USB-CDC reacts to DTR/RTS signals).
Custom-designed ESP32-based tube clock with 6× ST7735S 80×160 px IPS TFT displays on individual PCBs.
No physical buttons — replaced by two capacitive metal touch rings. Touch detection uses the ESP32 hardware touchRead() peripheral.
Two-ring touch menu: short tap = value change, long press right = next menu item, long press left = exit menu.
Hardware PWM dimming for the displays.
Active buzzer on GPIO21 (not used).
Clock face images are automatically rescaled to 80×160 px during the build process by a pre-build script (script_prepare_mini_clockfaces.py).
Uses a dedicated PlatformIO environment (DEsign) with the partition_4MB.csv layout.
Backup your original firmware and use the pre-built firmware to start with this custom firmware.
Always backup YOUR clocks firmware version as a first step!
If you mess-up your clock, it's only your fault!
Note: Backup images from other users normally DO NOT WORK as the most original firmware (like from EleksTube) is locked to the MAC address of the ESP32!
For other clocks it MAY work, but don't assume it! Most clocks have MAC address binding!
So again: Do a backup of your original firmware first!
On Windows, plug-in the cable into the clock and connect it to an USB port of your PC. Then run Windows Update. It will find and install the driver and generate an virtual COM port.
Windows device manager COM port example:
Only if Windows Update is not working for you, visit the Chinese manufacturer's website for newest CH340 driver for Windows and install them manually.
On an up-to-date Linux it works out of the box. COM port should be something like /dev/ttyUSB0.
If it is not working, see this tutorial and see the Chinese manufacturer's website for newest CH340 driver for Linux.
To read from (or write to) the clock, it needs to be in the
暂无开放 Issues,或尚未同步最近议题。