docs: add some hw guides
also remove dead links
This commit is contained in:
parent
543dc97d21
commit
7c99ea05f3
@ -10,12 +10,10 @@ In general, if the device can show a GNU/Linux desktop, then KlipperScreen shoul
|
||||
* [BTT HDMI5/7](https://biqu.equipment/products/bigtreetech-hdmi5-v1-0-hdmi7-v1-0)
|
||||
* [Raspberry PI 7" Touchscreen](https://www.raspberrypi.org/products/raspberry-pi-touch-display/)
|
||||
* [Hyperpixel 4](https://shop.pimoroni.com/products/hyperpixel-4)
|
||||
* [3.5" Elegoo](https://www.elegoo.com/de/products/elegoo-3-5-inch-tft-lcd-screen)
|
||||
* [3.5" RPi Display](http://www.lcdwiki.com/3.5inch_RPi_Display)
|
||||
* [5" HDMI Display-B](http://lcdwiki.com/5inch_HDMI_Display-B)
|
||||
* [VoCore](https://klipper.discourse.group/t/hardware-known-to-work-with-klipperscreen/35/7)
|
||||
* [WAVESHARE 4.3 inch DSI LCD](https://www.waveshare.com/4.3inch-dsi-lcd.htm)
|
||||
* [DFrobot DFR0550](https://wiki.dfrobot.com/5%27%27TFT-Display_with_Touchscreen_V1.0_SKU_DFR0550)
|
||||
* [Android phone](Android.md)
|
||||
|
||||
|
||||
|
49
docs/Hardware/GPIO_35.md
Normal file
49
docs/Hardware/GPIO_35.md
Normal file
@ -0,0 +1,49 @@
|
||||
|
||||
How i installed the 3.5" (A) type of screen on RaspberryOS Bookworm (Debian 12)
|
||||
|
||||

|
||||
|
||||
!!! abstract
|
||||
this is based on my own experience and it's provided for general information
|
||||
and does not constitute as advice of any kind.
|
||||
|
||||
|
||||
## Initial install
|
||||
|
||||
This screens connect to the [GPIO](https://en.wikipedia.org/wiki/General-purpose_input/output)
|
||||
they were usually installed via repositories named LCD-show ([1](https://github.com/waveshare/LCD-show), [2](https://github.com/goodtft/LCD-show)),
|
||||
however in the bookworm release there is a simpler solution
|
||||
|
||||
```sh
|
||||
sudo nano /boot/firmware/config.txt
|
||||
```
|
||||
at the bottom add:
|
||||
```
|
||||
dtoverlay=piscreen,drm
|
||||
```
|
||||
|
||||
???+ info
|
||||
in this context drm stands for [Direct Rendering Manager](https://en.wikipedia.org/wiki/Direct_Rendering_Manager)
|
||||
|
||||
Close the nano editor using `ctrl`+`x` (exit), then `y` for yes (save).
|
||||
|
||||
```sh
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
## Wrong colors
|
||||
|
||||
Some screens will not behave correctly and display wrong colors,
|
||||
this usually due to the wrong [SPI](https://en.wikipedia.org/wiki/Serial_Peripheral_Interface) speed
|
||||
In my case I had to use 16 Mhz (default is 24Mhz)
|
||||
```
|
||||
dtoverlay=piscreen,drm,speed=16000000
|
||||
```
|
||||
|
||||
## Rotation
|
||||
|
||||
You can rotate the screen adding a rotate line with the degrees [0, 90, 180, 270]
|
||||
```
|
||||
dtoverlay=piscreen,drm,speed=16000000,rotate=180
|
||||
```
|
||||
Screen rotation will require adjusting the touch matrix see [Touch issues](../../Troubleshooting/Touch_issues/)
|
48
docs/Hardware/HDMI.md
Normal file
48
docs/Hardware/HDMI.md
Normal file
@ -0,0 +1,48 @@
|
||||
|
||||
Screens that use HDMI should work out of the box
|
||||
|
||||
you may need to configure the resolution in RaspberryOS Bookworm
|
||||
you can do this by editing the kernel commandline
|
||||
|
||||
```
|
||||
sudo nano /boot/firmware/cmdline.txt
|
||||
```
|
||||
|
||||
!!! tip "Important"
|
||||
Put all parameters in cmdline.txt on the same line, do not use carriage returns.
|
||||
|
||||
for example:
|
||||
```
|
||||
video=1920x1080
|
||||
```
|
||||
|
||||
more complex example:
|
||||
```
|
||||
video=HDMI-A-1:1920x1080M@60,rotate=90,reflect_x
|
||||
```
|
||||
|
||||
| Device | Display |
|
||||
|-------------|-------------------------------------------------|
|
||||
| HDMI-A-1 | HDMI 1 (sometimes HDMI 0 on PCB) |
|
||||
| HDMI-A-2 | HDMI 2 (sometimes HDMI 1 on PCB if starts at 0) |
|
||||
| DSI-1 | DSI or DPI |
|
||||
| Composite-1 | Composite |
|
||||
|
||||
|
||||
Valid mode specifiers:
|
||||
```
|
||||
<xres>x<yres>[M][R][-<bpp>][@<refresh-rate>][i][m][eDd]
|
||||
```
|
||||
options on brackets are optional
|
||||
|
||||
| Option | Description |
|
||||
|-----------------|----------------------------------------------------------------------------------------|
|
||||
| M | Calculate timings using [CVT](https://en.wikipedia.org/wiki/Coordinated_Video_Timings) |
|
||||
| R | CVT reduced blanking (refresh rate must be 60Hz) |
|
||||
| -<bpp> | Bits per pixel, A.K.A. BitDepth usuallly 24 |
|
||||
| @<refresh-rate> | acceptable refresh rates are 50, 60, 70 or 85 Hz only |
|
||||
| e | Force enable |
|
||||
| D | Force enable Digital mode |
|
||||
| d | Disable |
|
||||
|
||||
For more info read [modedb default video mode support](https://docs.kernel.org/fb/modedb.html)
|
BIN
docs/img/hardware/rpi35a.jpg
Normal file
BIN
docs/img/hardware/rpi35a.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 24 KiB |
BIN
docs/img/troubleshooting/xtcal.png
Normal file
BIN
docs/img/troubleshooting/xtcal.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 272 B |
@ -9,7 +9,10 @@ nav:
|
||||
- Home: index.md
|
||||
- FAQ: FAQ.md
|
||||
- Setup:
|
||||
- Hardware.md
|
||||
- Hardware: Hardware.md
|
||||
- Hardware specific:
|
||||
- GPIO 3.5": Hardware/GPIO_35.md
|
||||
- HDMI: Hardware/HDMI.md
|
||||
- Installation.md
|
||||
- Updating.md
|
||||
- Configuration.md
|
||||
|
Loading…
x
Reference in New Issue
Block a user