CreatBotKlipperScreen/docs/Hardware.md

Hardware

There are no recommended screens, but here are some guidelines:

• There is no support for vertical/portrait mode, only widescreen
• Minimum resolution of 480x320

Hardware known to work

• BTT PI TFT50

• Raspberry PI 7" Touchscreen

• Hyperpixel 4

• 3.5" Elegoo

• 3.5" RPi Display

• 5" HDMI Display-B

• VoCore

• Android Phone

• WAVESHARE 4.3 inch DSI LCD

• DFrobot DFR0550

• More known hardware in the klipper discourse

Configuration

Follow the manufacturer instructions on how to install your screen. In general if you see a white screen, then it's not properly installed, ensure that you at least see a console, Then KlipperScreen, if you are having troubles refer to the for further information.

Touchscreen Calibration

Most people don't need to calibrate, but if you do need to calibrate your touchscreen, follow the below steps.

Run this command:

DISPLAY=:0 xinput_calibrator --list

It will output something such as:

Device "wch.cn USB2IIC_CTP_CONTROL" id=6

Find the ID of your display and put it in the following command:

DISPLAY=:0 xinput_calibrator -v --device <id from last command>

Touchscreen touch rotation

If your touchscreen isn't registering touches properly after the screen has been rotated, you will need to apply a transformation matrix. You can have the matrix be one of the following:

• 0°: 1 0 0 0 1 0 0 0 1
• 90° Clockwise: 0 -1 1 1 0 0 0 0 1
• 90° Counter-Clockwise: 0 1 0 -1 0 1 0 0 1
• 180°: -1 0 1 0 -1 1 0 0 1

To check the current matrix, you will need your <screen name> (which can be found via the last section, ex: "wch.cn USB2IIC_CTP_CONTROL"). Run the following command: xinput list-props "wch.cn USB2IIC_CTP_CONTROL"

It will output something such as:

Device '<screen name>':
        Device Enabled (115):   1
        Coordinate Transformation Matrix (116): 1.000000, 0.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000, 0.000000, 1.000000
        libinput Calibration Matrix (247):      -1.000000, 0.000000, 1.000000, 0.000000, -1.000000, 1.000000, 0.000000, 0.000000, 1.000000
        libinput Calibration Matrix Default (248):      -1.000000, 0.000000, 1.000000, 0.000000, -1.000000, 1.000000, 0.000000, 0.000000, 1.000000
        libinput Send Events Modes Available (249):     1, 0
        libinput Send Events Mode Enabled (250):        0, 0
        libinput Send Events Mode Enabled Default (251):        0, 0
        Device Node (252):      "/dev/input/event0"
        Device Product ID (253):        6790, 58083

You can verify by checking that the 'Coordinate Transformation Matrix' or 'libinput Calibration Matrix'.

You can test a change by running: xinput set-prop "<screen name>" 'Coordinate Transformation Matrix' <matrix>

Replace matrix with one of the options above, such as: 1 0 0 0 1 0 0 0 1

To make this permanent, modify the file /etc/udev/rules.d/51-touchscreen.rules and add following line:

ACTION=="add", ATTRS{name}=="<screen name>", ENV{LIBINPUT_CALIBRATION_MATRIX}="<matrix>"