百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
E

EleksTubeHAX

> 编程语言
开源

EleksTube IPS 时钟和类似克隆的自定义固件(小生命,平克Cyber,MarvelTubes,IPSTube,

200 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

EleksTube IPS 时钟和类似克隆的自定义固件(小生命,平克Cyber,MarvelTubes,IPSTube,

EleksTubeHAX - An aftermarket custom firmware for the desk clock

This is the "Home Assistant Edition" with extendent MQTT support for Home Assistant, more info see below

1. Supported hardware models

1.1 Original EleksTube Models

  • EleksTube IPS Clock (Original Version)

  • EleksTube IPS Clock Gen2

    • incl. EleksTube IPS Classic Edition/Pro/PR1/PR2

1.2 Other Supported Models

  • SI HAI IPS Clock

  • Xunfeng IPS Clock

  • NovelLife SE Clock

    • With gesture sensor
  • 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

Notes
  • 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.

1.3 Purchasing Information

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.

1.4 Firmware Compatibility

  • 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.

2. Mainboard/PCB views

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.

3. Main features

  • 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)

3.2 Other Main Features

  • 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

3.1 Home Assistant integration with extensive MQTT features

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:

  • Clock automatically appears in the active MQTT integration in HA (auto discovery)
  • HA detects when the clock is powered off and grays out the entity.
  • Device detected as two separate light entities
    • Main (LCD displays)
    • Back (LED backlight)
  • Display control
    • Turn LCDs on/off (Main)
    • Adjust LCD brightness (Main)
    • Change clock face/effect (Main)
  • Backlight control
    • Turn LEDs on/off (Back)
    • Adjust LED brightness (Back)
    • Switch effects (Dark, Test, Constant, Pulse, Breathe or Rainbow) (Back)
    • Set static color (Back, Constant mode only)
    • Adjust effect speed (Back, for Pulse, Breathe and Rainbow)
  • Clock settings
    • Toggle 12/24-hour format
    • Enable/disable blank zeros

3.2 Clock specific features

Some clock models have specific functionalities or hardware specials which are only available for that model

3.2.1 NovelLife SE Clock with gesture sensor

  • No buttons on the clock, only a gesture sensor

  • Gesture sensor is supported by simulating the buttons like the other clocks have

3.2.2 IPSTube Clock - Model H401 and H402

  • 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/.

3.2.2.1 One button menu
  • The clock has only one button, so there is a special menu mode active for this model.
3.2.2.2 Color LED stripe
  • Some versions of this model have a LED stripe with 28 RGB LEDs installed on the bottom.
3.2.2.3 Dimmable displays
  • newer versions (after mid-2024) of the IPSTube clocks can do hardware dimming on the displays and turn off the displays completely

Note: See "Known problems/Limitations" for more info.

3.2.3 MarvelTubes Clock

  • 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/.

3.2.3b MarvelTubes Gen2 Clock

  • 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/.

3.2.4 MarvelTubes Mini Clock

  • 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).

3.2.5 D'Esign Clock

  • 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.

4. Quick Start - Backup and Pre-Build firmware images

Backup your original firmware and use the pre-built firmware to start with this custom firmware.

4.1 Backup first

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!

4.2 How to do the backup

1) Install the USB Serial Port Device Driver

Windows
  • 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.

Linux
  • 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.

2) Save your original firmware

To read from (or write to) the clock, it needs to be in the

Issues· 13 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言