Skip to content

GUITION 3.5" screen support #426

Closed
Closed

Description

I found this while looking around for different models of USB 3.5" screens. I found this:

https://www.aliexpress.us/item/3256806022857282.html

It mentions some software called Guition which seems to be different from the stuff I have already seen. Maybe this is another variant of a newer screen type?

Activity

  1. ghost added
    enhancementNew feature or request
    on Dec 21, 2023
  2. mathoudebine commented on Dec 22, 2023

    @mathoudebine
    Owner

    Hello @braewoods you're right it seems there is a new smart screen model on the market, thanks for telling me!
    Damn, this will not help with my smart screen addiction 😆
    I will definitely buy some and try to integrate it to this project!

    image
    This line in the ad is a lie, or this smart screen use a different technology than the others 3.5" that are unable to display gifs due to their very low refresh rate.

  3. mathoudebine commented on Feb 19, 2024

    @mathoudebine
    Owner

    Hi again! I finally received the product and investigated a bit using HHD Serial Port Monitor to get the data transiting between the display and the computer.
    I have bad news unfortunately.

    Based on what I've seen, it seems like the display is based on an ESP32. When a theme is selected from the Windows software, a new complete ESP32 firmware is compiled by the Windows software and flashed to the display. I can see it on the Serial Port Monitor interface.

    Then, when program is running, only sensors data are sent to the display periodically as you can see on this screen capture:
    guition
    Frames in red are sent periodically by the software to the display, and contains a set of predefined sensor values separed by $N. Here I created a theme with only 1 sensor (CPU usage) and it is the data you can see (22,61) in the frame. The display acknowledge every frame from the computer.

    So it seems you were right: even though the display does not use the HID protocol to communicate with the computer but a virtual serial port, it is working as the Fuldho 3.5" IPS Screen you're working on.
    I don't think it can be integrated to this project.

  4. changed the title [-]New 3.5" screen variant?[/-] [+]GUITION 3.5" screen support[/+] on Mar 1, 2024
  5. matu6968 commented on Jun 29, 2024

    @matu6968

    Hi again! I finally received the product and investigated a bit using HHD Serial Port Monitor to get the data transiting between the display and the computer. I have bad news unfortunately.

    Based on what I've seen, it seems like the display is based on an ESP32. When a theme is selected from the Windows software, a new complete ESP32 firmware is compiled by the Windows software and flashed to the display. I can see it on the Serial Port Monitor interface.

    It seems like everything including the toolchain, obfuscated (maybe?) source code is in the main executable by finding patterns like GCC using a hex editor, also will try using binwalk to see if there is anything inetresting in there. So to add support, reverse engineering of the executable is needed to extract the source code and the build flags.

  6. q20021410 commented on Sep 14, 2026

    @q20021410

    Hi @mathoudebine and everyone interested in this screen! 👋

    Like many others, I purchased this exact Guition 3.5" IPS USB-C Secondary Screen, but the proprietary software bundled by the seller was no longer functioning properly. To bring this hardware back to life and make it genuinely useful, I refactored the ESP32-C3 firmware and transmission logic with the assistance of AI, and I can confirm it now works flawlessly with turing-smart-screen-python!

    I created a dedicated repository containing the pre-compiled firmware binaries, factory restore backups, and full setup guides:
    👉 Guition-Turing-Smart-Screen (GitHub)


    📷 Hardware Showcase (Verified Working)

    🖥️ Real-Time Monitoring in Action (Landscape) ⏳ 80MHz Custom Firmware Standby Screen
    Guition 3.5 in Action Standby Screen

    🔍 Technical Details & How It Works

    • Hardware: ESP32-C3 RISC-V @ 160MHz, 4MB Flash, ST7796S 3.5" IPS display (AliExpress Link).
    • Protocol Compatibility: By flashing the 80MHz SPI DMA custom firmware at offset 0x10000, the screen responds 1:1 to the standard REVISION: A (Turing Rev A / Command 197 DISPLAY_BITMAP) protocol.
    • Factory Firmware Backup: A clean 4MB raw factory flash dump is also provided at 0x0, so anyone can safely restore it at any time.

    ⚙️ Recommended config.yaml Settings

    display:
      REVISION: A
      DISPLAY_REVERSE: true
      RESET_ON_STARTUP: false
  7. matu6968 commented on Sep 14, 2026

    @matu6968

    Hi @mathoudebine and everyone interested in this screen! 👋

    Like many others, I purchased this exact Guition 3.5" IPS USB-C Secondary Screen, but the proprietary software bundled by the seller was no longer functioning properly. To bring this hardware back to life and make it genuinely useful, I refactored the ESP32-C3 firmware and transmission logic with the assistance of AI, and I can confirm it now works flawlessly with turing-smart-screen-python!

    I created a dedicated repository containing the pre-compiled firmware binaries, factory restore backups, and full setup guides:
    👉 Guition-Turing-Smart-Screen (GitHub)


    📷 Hardware Showcase (Verified Working)

    🖥️ Real-Time Monitoring in Action (Landscape) ⏳ 80MHz Custom Firmware Standby Screen
    Guition 3.5 in Action Standby Screen

    🔍 Technical Details & How It Works

    • Hardware: ESP32-C3 RISC-V @ 160MHz, 4MB Flash, ST7796S 3.5" IPS display (AliExpress Link).
    • Protocol Compatibility: By flashing the 80MHz SPI DMA custom firmware at offset 0x10000, the screen responds 1:1 to the standard REVISION: A (Turing Rev A / Command 197 DISPLAY_BITMAP) protocol.
    • Factory Firmware Backup: A clean 4MB raw factory flash dump is also provided at 0x0, so anyone can safely restore it at any time.

    ⚙️ Recommended config.yaml Settings

    display:
      REVISION: A
      DISPLAY_REVERSE: true
      RESET_ON_STARTUP: false

    No source code for both ends and with it being apparently closed source (only .exe binaries and pre-compiled firmware binaries for the ESP32-C3 display) based off upstream sounds like a GPL violation to me, will sources be published (atleast for the upstream frontend software fork) to comply with the GPL?

  8. q20021410 commented on Sep 14, 2026

    @q20021410

    Hi @mathoudebine and everyone interested in this screen! 👋
    Like many others, I purchased this exact Guition 3.5" IPS USB-C Secondary Screen, but the proprietary software bundled by the seller was no longer functioning properly. To bring this hardware back to life and make it genuinely useful, I refactored the ESP32-C3 firmware and transmission logic with the assistance of AI, and I can confirm it now works flawlessly with turing-smart-screen-python!
    I created a dedicated repository containing the pre-compiled firmware binaries, factory restore backups, and full setup guides:
    👉 Guition-Turing-Smart-Screen (GitHub)

    📷 Hardware Showcase (Verified Working)

    🖥️ Real-Time Monitoring in Action (Landscape)
    ⏳ 80MHz Custom Firmware Standby Screen

    Guition 3.5 in Action Standby Screen

    🔍 Technical Details & How It Works

    • Hardware: ESP32-C3 RISC-V @ 160MHz, 4MB Flash, ST7796S 3.5" IPS display (AliExpress Link).
    • Protocol Compatibility: By flashing the 80MHz SPI DMA custom firmware at offset 0x10000, the screen responds 1:1 to the standard REVISION: A (Turing Rev A / Command 197 DISPLAY_BITMAP) protocol.
    • Factory Firmware Backup: A clean 4MB raw factory flash dump is also provided at 0x0, so anyone can safely restore it at any time.

    ⚙️ Recommended config.yaml Settings

    display:
    REVISION: A
    DISPLAY_REVERSE: true
    RESET_ON_STARTUP: false

    No source code for both ends and with it being apparently closed source (only .exe binaries and pre-compiled firmware binaries for the ESP32-C3 display) based off upstream sounds like a GPL violation to me, will sources be published (atleast for the upstream frontend software fork) to comply with the GPL?

    The change is complete. I also separated and re-uploaded the entire source code and the ESP-related parts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions