Interaction between software and the display

In this section, I will explain how the X3seriesLCD software on the mainboard interacts with the display.
Understanding this relationship is crucial for avoiding errors and issues.

Key Point:
Always ensure that the firmware on the display and the X3seriesLCD software are on the same version to maintain compatibility.

And here is why:

The Klipper firmware is installed on the Armbian operating system.
My custom software, called X3seriesLCD, runs on this system and communicates with Klipper via the official Moonraker API.
Through this connection, it receives real-time information about the printer's status, subsystems (e.g., the print head), and various components (like the nozzle temperature, fan speed, etc.).
It can also control these components, such as adjusting temperatures etc..
This information is then exchanged with the display.

Contrary to what one might initially think, the display is not merely a passive screen.
Instead, it's an independent device with its own processor and a display.
What does that mean? Unlike HDMI, where visual signals are transmitted to the display, only information about the components is exchanged via a serial interface.
The display processes this information and presents it through a user interface on its screen.
For this reason, the display's firmware had to be rewritten from scratch.

Once you understand the relationship between the X3seriesLCD software (on the mainboard with Klipper) and the display firmware, it becomes clear why new functions in the software may not be supported by the display.
This happens because those functions did not exist previously, and the software is now sending unknown information to the display.
The display simply doesnt know how to handle it.

It is therefore important that the software version of X3seriesLCD always matches the firmware of the display to ensure smooth communication between the two.

I always publish new X3seriesLCD software at the X3seriesLCD directory.
Older versions can be found in the old_X3seriesLCD_software directory.

For the screen, you can find the firmware in the screen_firmwares directory.