Waveshare 10.1inch DSI LCD (C) Manual

1 0 . 1 i n c h D S I L C D ( C )
F e a t u r e
1 0 . 1 - i n c h I P S c a p a c i t i v e t o u c h s c r e e n w i t h a h a r d w a r e r e s o l u t i o n o f 1 2 8 0 x 8 0 0 .
A d o p t s o p t i c a l b o n d i n g t e c h n i q u e a n d c l e a r e r i m a g i n g .
S u p p o r t 1 0 - p o i n t c a p a c i t i v e t o u c h c o n t r o l , t e m p e r e d g l a s s t o u c h p a n e l w i t h 6 H h a r d n e s s .
C a n b e d i r e c t l y c o n n e c t e d t o t h e L C D b y t h e D S I i n t e r f a c e o f t h e R a s p b e r r y P i , a n d i t s
r e f r e s h i n g r a t e i s u p t o 6 0 H z .
W h e n w o r k i n g w i t h R a s p b e r r y P i , w e p r o v i d e t h e R a s p b e r r y P i O S s y s t e m d r i v e r .
S u p p o r t P i 4 B / 3 B + / 3 A + , C M 3 + / 4 s h o u l d w o r k w i t h
S u p p o r t b a c k l i g h t a d j u s t e d b y s o f t w a r e .
W o r k i n g W i t h R a s p b e r r y P i
H a r d w a r e C o n n e c t i o n
M e t h o d 1 : B a c k L o c k I n s t a l l a t i o n
1 . C o n n e c t t h e D S I i n t e r f a c e o f t h e L C D t o t h e D S I i n t e r f a c e o f t h e R a s p b e r r y P i b o a r d .
2 . T h e R a s p b e r r y P i i s i n s t a l l e d o n t h e d i s p l a y b o a r d w i t h t h e b a c k f a c i n g d o w n , a n d t h e 5 V
p o w e r s u p p l y a n d I 2 C c o m m u n i c a t i o n a r e c o n n e c t e d t h r o u g h t h e 4 P I N .
T h e R a s p b e r r y P i 4 B b a c k l o c k i n s t a l l a t i o n e f f e c t i s a s f o l l o w s :
M e t h o d 2 : F l a t C o n n e c t i o n
1 . C o n n e c t t h e D S I i n t e r f a c e o f t h e d i s p l a y t o t h e D S I p o r t o f t h e R a s p b e r r y P i b o a r d w i t h a
1 5 P I N F P C c a b l e .
2 . C o n n e c t t h e U S B p o r t o f t h e R a s p b e r r y P i t o t h e T y p e - C p o r t o n t h e d i s p l a y b a s e b o a r d
w i t h a U S B c a b l e .
T h e R a s p b e r r y P i 4 B f l a t i n s t a l l a t i o n e f f e c t i s a s f o l l o w s :
T h e C M 4 I O B o a r d f l a t i n s t a l l a t i o n e f f e c t i s a s f o l l o w s :
S o f t w a r e S e t t i n g
M e t h o d 1 : I n s t a l l M a n u a l l y
1 . D o w n l o a d t h e i m a g e o f t h e n e w e s t v e r s i o n
f i l e t o t h e P C a n d e x t r a c t t h e . i m g f i l e .
2 . C o n n e c t T F c a r d t o P C , u s e
3 . O p e n W i n 3 2 D i s k I m a g e r
c l i c k w r i t e t o b u r n t h e s y s t e m i m a g e .
4 . A f t e r t h e p r o g r a m m i n g i s c o m p l e t e d , c o n n e c t t h e T F c a r d t o t h e R a s p b e r r y P i , s t a r t
t h e R a s p b e r r y P i , a n d l o g i n t o t h e t e r m i n a l o f t h e R a s p b e r r y P i ( y o u c a n c o n n e c t t h e
R a s p b e r r y P i t o a n H D M I d i s p l a y o r l o g i n r e m o t e l y w i t h s s h ) .
#Step 1: Download
git clone https://github.com/waveshare/Waveshare-DSI-LCD
cd Waveshare-DSI-LCD
#Step 2: Enter uname -a in the terminal to view the kernel version
the corresponding file directory
#5.15.61 then run the following command
cd 5.15.61
#Step 3: Please check the bits of your system, enter the
-bit systems,
cd 32
#cd 64
#Step 4: Enter your corresponding model command to install the driver, pay a
ttention to the selection of the I2C DIP
#10.1inch DSI LCD (C) 1280×800 driver:
sudo bash ./WS_xinchDSI_MAIN.sh 101C I2C0
#Step 5: Wait
d no error is prompted, restart
ormally
sudo reboot
N o t e : T h e a b o v e s t e p s n e e d t o e n s u r e t h a t t h e R a s p b e r r y P i c a n b e c o n n e c t e d t o t h e
I n t e r n e t n o r m a l l y .
5 . W a i t f o r t h e s y s t e m t o r e s t a r t , i t w i l l b e a b l e t o d i s p l a y a n d t o u c h n o r m a l l y .
M e t h o d 2 : P r o g r a m P r e - i n s t a l l e d I m a g e
1 . S e l e c t y o u r c o r r e s p o n d i n g R a s p b e r r y P i v e r s i o n i m a g e , d o w n l o a d , a n d d e c o m p r e s s i t a s
a " . i m g " f i l e .
F o r R a s p b e r r y P i 4 B / C M 4 v e r s i o n , d o w n l o a d : W a v e s h a r e D S I L C D - P i 4 p r e - i n s t a l l i m a g e .
F o r R a s p b e r r y P i 3 B / 3 B + / C M 3 v e r s i o n , d o w n l o a d : W a v e s h a r e D S I L C D - P i 3 p r e - i n s t a l l
i m a g e .
2 . C o n n e c t t h e T F c a r d t o t h e P C a n d u s e
3 . O p e n W i n 3 2 D i s k I m a g e r
a n d t h e n c l i c k " w r i t e " t o w r i t e t h e s y s t e m i m a g e .
4 . A f t e r t h e p r o g r a m m i n g i s f i n i s h e d , o p e n t h e c o n f i g . t x t f i l e i n t h e r o o t d i r e c t o r y o f t h e T F
c a r d , a d d t h e f o l l o w i n g c o d e u n d e r [ a l l ] , s a v e a n d e j e c t t h e T F c a r d s a f e l y .
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=8,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=10
5 . C o n n e c t t h e T F c a r d t o t h e R a s p b e r r y P i , a n d s t a r t t h e R a s p b e r r y P i , w a i t f o r a b o u t 3 0
s e c o n d s t o d i s p l a y a n d t o u c h n o r m a l l y .
R o t a t i o n
M e t h o d 1 : G r a p h i c a l I n t e r f a c e R o t a t i o n
I n t h e s t a r t m e n u , s e l e c t : P r e f e r e n c e s - > S c r e e n C o n f i g u r a t i o n - > C o n f i g u r e - > S c r e e n s - >
D S I - 1 - > O r i e n t a t i o n , s e l e c t t h e c o r r e s p o n d i n g a n g l e i n i t , c l i c k " √ " , s e l e c t Y e s , a n d r e s t a r t .
M e t h o d 2 : R o t a t i o n D i s p l a y I n L i t e V e r s i o n
sudo nano /boot/cmdline.txt
#Add a command corresponding to the display rotation angle at the beginnin
g of the cmdline.txt file, save it and restart it to take effect
#display rotated 90 degrees
video=DSI-1:1280x800M@60,rotate=90
#display rotated 180 degrees
video=DSI-1:1280x800M@60,rotate=180
#display rotated 270 degrees
video=DSI-1:1280x800M@60,rotate=270
T o u c h t o R o t a t e
sudo nano /boot/config.txt
#Modify the instruction of the touch rotation angle at the end of the conf
ig.txt file, and it will take effect after restarting (there is a 0° touch
direction instruction by default)
#0°:
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy
#90°:
dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy
#180°:
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy
#270°:
dtoverlay=WS_xinchDSI_Touch
B a c k l i g h t C o n t r o l
M e t h o d 1 : G r a p h i c a l I n t e r f a c e D i m m i n g
U s i n g t h e a p p l i c a t i o n p r o v i d e d b y W a v e s h a r e :
cd Waveshare-DSI-LCD
# Determine the currently used kernel version, such as the 5.15.61 kernel,
and run the following command
cd 5.15.61
#Check the bits of the system, the 32-bit system enters 32 directory, the
64-bit system enters 64 directory
cd 32
#cd 64
cd Backlight
sudo ./install.sh
A f t e r t h e i n s t a l l a t i o n i s c o m p l e t e , y o u c a n o p e n t h e p r o g r a m i n t h e S t a r t m e n u - >
A c c e s s o r i e s - > B r i g h t n e s s , a s s h o w n b e l o w :
M e t h o d 2 : L i t e V e r s i o n D i m m i n g C o m m a n d
T o a d j u s t t h e s y s t e m c o m m a n d o f t h e l i t e v e r s i o n , a f t e r e n t e r i n g t h e r o o t p r i v i l e g e , e x e c u t e
t h e f o l l o w i n g c o m m a n d o n t h e R a s p b e r r y P i t e r m i n a l :
echo X > /sys/waveshare/rpi_backlight/brightness
( X v a l u e i n t h e r a n g e o f 0 ~ 2 5 5 . )
F o r e x a m p l e :
sudo su root
echo 100 > /sys/waveshare/rpi_backlight/brightness
D i s a b l e T o u c h i n g
A t t h e e n d o f t h e c o n f i g . t x t f i l e , a d d t h e f o l l o w i n g c o m m a n d s c o r r e s p o n d i n g t o d i s a b l i n g
t o u c h ( t h e c o n f i g f i l e i s l o c a t e d i n t h e r o o t d i r e c t o r y o f t h e T F c a r d , a n d c a n a l s o b e
a c c e s s e d t h r o u g h t h e c o m m a n d : s u d o n a n o / b o o t / c o n f i g . t x t ) :
disable_touchscreen=1
N o t e : A f t e r a d d i n g t h e c o m m a n d , i t n e e d s t o b e r e s t a r t e d t o t a k e e f f e c t .
N o t e s
1 . U p d a t e t h e s y s t e m :
sudo apt-get update
sudo apt-get full-upgrade
A f t e r u p d a t i n g t h e s y s t e m , s o m e f i l e s o f t h e o r i g i n a l l y i n s t a l l e d d r i v e r w i l l b e o v e r w r i t t e n , i n
t h i s c a s e , t h e d r i v e r n e e d s t o b e r e i n s t a l l e d t o d i s p l a y n o r m a l l y .
2 . R e p l a c e t h e b o a r d :
I f t h e d r i v e r w a s o r i g i n a l l y i n s t a l l e d o n R a s p b e r r y P i 4 M o d e l B , t h e u s e r r e p l a c e s t h e b o a r d ,
s u c h a s m o d i f y i n g i t t o R a s p b e r r y P i 3 M o d e l B + , w h i c h w i l l c a u s e t h e d i s p l a y t o f a i l t o
d i s p l a y n o r m a l l y . B e c a u s e P i 4 a n d P i 3 n e e d t o l o a d d i f f e r e n t d r i v e r f i l e s .
I n t h i s c a s e , t h e d r i v e r n e e d s t o b e r e i n s t a l l e d o n t h e n e w b o a r d t o d i s p l a y n o r m a l l y .
D o c u m e n t
3 D D r a w i n g
1 0 . 1 i n c h D S I L C D ( C ) D r a w i n g
P r e - i n s t a l l e d i m a g e
W a v e s h a r e D S I L C D - P i 4 P r e - i n s t a l l e d I m a g e
W a v e s h a r e D S I L C D - P i 3 P r e - i n s t a l l e d I m a g e
F A Q
Q u e s t i o n : W h a t ' s t h e p o w e r c o n s u m p t i o n o f 1 0 . 1 i n c h D S I L C D ( C ) ?
A n s w e r :
W i t h a 5 V p o w e r s u p p l y , t h e o p e r a t i n g c u r r e n t o f t h e b a c k l i g h t i s a b o u t 5 2 0 m A , a n d t h e
o p e r a t i n g c u r r e n t o f t h e b a c k l i g h t i s a b o u t 1 5 0 m A .
Q u e s t i o n : H o w t o r e p l a c e t h e l o g o i m a g e o f R a s p b e r r y P i B o o t i n g ?
A n s w e r :
R e p l a c e t h e c u s t o m i m a g e w i t h t h e i m a g e i n t h i s d i r e c t o r y
/ u s r / s h a r e / p l y m o u t h / t h e m e s / p i x / s p l a s h . p n g .
S u p p o r t
I f y o u r e q u i r e t e c h n i c a l s u p p o r t , p l e a s e g o t o t h e p a g e a n d o p e n a t i c k e t .
S D F o r m a t t e r
s o f t w a r e , s e l e c t t h e s y s t e m i m a g e p r e p a r e d i n s t e p 1 a n d
and enter the Waveshare-DSI-LCD driver folder
and enter the 64
for a few seconds, when the driver installation is complete
s o f t w a r e , c h o o s e t h e s y s t e m i m a g e p r e p a r e d i n t h e f i r s t s t e p ,
D S I c a b l e
（
v i a D S I 1 p o r t
R a s p b e r r y P i
t o f o r m a t T F c a r d .
directory for 64-bit systems
switch
and load the DSI driver
S D F o r m a t t e r
.
）
, d o w n l o a d t h e c o m p r e s s e d
32 directory
and it can be used n
t o f o r m a t t h e T F c a r d .
and cd to
for 32
an