Waveshare B08H24H7KX Manual

2 . 4 i n c h L C D M o d u l e
O v e r v i e w
I n t r o d u c t i o n
A s a 2 . 4 i n c h T F T d i s p l a y m o d u l e w i t h a r e s o l u t i o n o f 2 4 0 * 3 2 0 ,
i t u s e s t h e S P I i n t e r f a c e f o r c o m m u n i c a t i o n . L C D h a s a n i n t e r n a l
c o n t r o l l e r w i t h b a s i c f u n c t i o n s , w h i c h c a n b e u s e d t o d r a w
p o i n t s , l i n e s , c i r c l e s , a n d r e c t a n g l e s , a n d c a n d i s p l a y E n g l i s h , C h i n e s e a s w e l l a s p i c t u r e s .
W e p r o v i d e c o m p l e t e s u p p o r t i n g R a s p b e r r y P i d e m o s ( B C M 2 8 3 5 l i b r a r y , W i r i n g P i l i b r a r y ,
a n d p y t h o n d e m o s ) , S T M 3 2 d e m o s , a n d A r d u i n o d e m o s .
S p e c i f i c a t i o n
O p e r a t i n g v o l t a g e : 3 . 3 V / 5 V
5 V ; W h e n u s i n g 3 . 3 V p o w e r s u p p l y , t h e l o g i c v o l t a g e i s 3 . 3 V )
I n t e r f a c e : S P I
L C D T y p e : T F T
C o n t r o l l e r : I L 9 3 4 1
R e s o l u t i o n : 2 4 0 ( V ) x 3 2 0 ( H ) R G B
D i s p l a y S i z e : 3 6 . 7 2
P i x e l S i z e : 0 . 1 5 3
D i m e n s i o n : 7 0 . 5 x 4 3 . 3 ( m m )
I n t e r f a c e D e s c r i p t i o n
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
P l e a s e c o n n e c t t h e L C D t o y o u r R a s p b e r r y P i b y t h e 8 P I N c a b l e a c c o r d i n g t o t h e t a b l e
b e l o w
I f y o u u s e t h e p i n h e a d e r o r P H 2 . 0 8 P I N i n t e r f a c e , y o u n e e d t o c o n n e c t a c c o r d i n g t o t h e
f o l l o w i n g t a b l e
C o n n e c t t o R a s p b e r r y P i
L C D
V C C
G N D
D I N
C L K
C S
D S
R S T
B L
T h e 2 . 4 i n c h L C D u s e s t h e P H 2 . 0 8 P I N i n t e r f a c e , w h i c h c a n b e c o n n e c t e d t o t h e R a s p b e r r y
P i a c c o r d i n g t o t h e a b o v e t a b l e :
c o l o r o f t h e w i r i n g i n t h e p i c t u r e i s f o r r e f e r e n c e o n l y , a n d t h e a c t u a l c o l o r s h a l l p r e v a i l . )
S T M 3 2 h a r d w a r e c o n n e c t i o n
T h e e x a m p l e w e p r o v i d e i s b a s e d o n S T M 3 2 F 1 0 3 R B T 6 , a n d t h e c o n n e c t i o n m e t h o d
p r o v i d e d i s a l s o t h e c o r r e s p o n d i n g p i n o f S T M 3 2 F 1 0 3 R B T 6 . I f y o u n e e d t o t r a n s p l a n t t h e
p r o g r a m , p l e a s e c o n n e c t a c c o r d i n g t o t h e a c t u a l p i n .
S T M 3 2 F 1 0 3 Z E T c o n n e c t i o n p i n c o r r e s p o n d e n c e
T a k e t h e X N U C L E O - F 1 0 3 R B d e v e l o p m e n t b o a r d
e x a m p l e , t h e c o n n e c t i o n i s a s f o l l o w s :
A r d u i n o h a r d w a r e c o n n e c t i o n
A r d u i n o U N O C o n n e c t i o n p i n c o r r e s p o n d e n c e
T h e c o n n e c t i o n d i a g r a m i s a s f o l l o w s ( c l i c k t o e n l a r g e ) :
H a r d w a r e D e s c r i p t i o n
L C D a n d t h e c o n t r o l l e r
T h e L C D s u p p o r t s 1 2 - b i t , 1 6 - b i t , a n d 1 8 - b i t i n p u t c o l o r f o r m a t s p e r p i x e l , n a m e l y R G B 4 4 4 ,
R G B 5 6 5 , a n d R G B 6 6 6 t h r e e c o l o r f o r m a t s , t h i s d e m o u s e s R G B 5 6 5 c o l o r f o r m a t , w h i c h i s
a l s o a c o m m o n l y u s e d R G B f o r m a t .
F o r m o s t L C D c o n t r o l l e r s , t h e c o m m u n i c a t i o n m o d e o f t h e c o n t r o l l e r c a n b e c o n f i g u r e d ,
u s u a l l y w i t h a n 8 0 8 0 p a r a l l e l i n t e r f a c e , t h r e e - w i r e S P I , f o u r - w i r e S P I , a n d o t h e r
c o m m u n i c a t i o n m e t h o d s . T h i s L C D u s e s a f o u r - w i r e S P I c o m m u n i c a t i o n i n t e r f a c e , w h i c h
c a n g r e a t l y s a v e t h e G P I O p o r t , a n d t h e c o m m u n i c a t i o n s p e e d w i l l b e f a s t e r .
C o m m u n i c a t i o n P r o t o c o l
N o t e : D i f f e r e n t f r o m t h e t r a d i t i o n a l S P I p r o t o c o l , t h e d a t a l i n e f r o m t h e s l a v e t o t h e m a s t e r
i s h i d d e n s i n c e t h e d e v i c e o n l y h a s a d i s p l a y r e q u i r e m e n t .
R E S X : t h e r e s e t p i n , i t s h o u l d b e l o w w h e n p o w e r i n g t h e m o d u l e a n d b e h i g h e r a t o t h e r
t i m e s ;
C S X : s l a v e c h i p s e l e c t , w h e n C S i s l o w , t h e c h i p i s e n a b l e d .
D / C X : d a t a / c o m m a n d c o n t r o l p i n , w h e n D C = 0 , w r i t e c o m m a n d , w h e n D C = 1 , w r i t e d a t a
S D A : t h e d a t a p i n f o r t r a n s m i t t i n g R G B d a t a , i t w o r k s a s t h e M O S I p i n o f S P I i n t e r f a c e ;
S C L w o r k s a s t h e S C L K p i n s o f S P I i n t e r f a c e .
S P I c o m m u n i c a t i o n h a s d a t a t r a n s f e r t i m i n g , w h i c h i s c o m b i n e d b y C P H A a n d C P O L .
C P O L d e t e r m i n e s t h e l e v e l o f t h e s e r i a l s y n c h r o n o u s c l o c k a t i d l e s t a t e . W h e n C P O L = 0 ,
t h e l e v e l i s L o w . H o w e v e r , C P O L h a s l i t t l e e f f e c t t o t h e t r a n s m i s s i o n .
C P H A d e t e r m i n e s w h e t h e r d a t a i s c o l l e c t e d a t t h e f i r s t c l o c k e d g e o r a t t h e s e c o n d c l o c k
e d g e o f s e r i a l s y n c h r o n o u s c l o c k ; w h e n C P H L = 0 , d a t a i s c o l l e c t e d a t t h e f i r s t c l o c k e d g e .
T h e r e a r e 4 S P I c o m m u n i c a t i o n m o d e s . S P I 0 i s c o m m o n l y u s e d , i n w h i c h C P H L = 0 , C P O L
= 0 .
W o r k i n g w i t h R a s p b e r r y P i
E n a b l e S P I i n t e r f a c e
P S : I f y o u a r e u s i n g t h e s y s t e m o f t h e B u l l s e y e b r a n c h , y o u n e e d t o c h a n g e " a p t - g e t " t o
" a p t " , t h e s y s t e m o f t h e B u l l s e y e b r a n c h o n l y s u p p o r t s P y t h o n 3 .
O p e n t e r m i n a l , u s e c o m m a n d t o e n t e r t h e c o n f i g u r a t i o n p a g e
sudo raspi-config
Choose Interfacing Options -> SPI -> Yes
R e b o o t R a s p b e r r y P i
sudo reboot
P l e a s e m a k e s u r e t h e S P I i s n o t o c c u p i e d b y o t h e r d e v i c e s , y o u c a n c h e c k i n t h e m i d d l e o f
/ b o o t / c o n f i g . t x t
I n s t a l l L i b r a r i e s
I n s t a l l B C M 2 8 3 5 l i b r a r i e s
#Open the Raspberry Pi terminal and run the following command
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
tar zxvf bcm2835-1.71.tar.gz
cd bcm2835-1.71/
sudo ./configure && sudo make && sudo make check && sudo make install
# For more information, please refer to the official website: http://www.a
irspayce.com/mikem/bcm2835/
I n s t a l l w i r i n g P i l i b r a r i e s
#Open the Raspberry Pi terminal and run the following command
sudo apt-get install wiringpi
#For Raspberry Pi systems after May 2019 (earlier than before, you may not
need to execute), you may need to upgrade:
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
# Run gpio -v and version 2.52 will appear. If it does not appear, the ins
tallation is wrong
#Bullseye branch system use the following command:
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v
# Run gpio -v and version 2.60 will appear. If it does not appear, it mean
s that there is an installation error
I n s t a l l P y t h o n l i b r a r i e s
#python2
sudo apt-get update
sudo apt-get install python-pip
sudo apt-get install python-pil
sudo apt-get install python-numpy
sudo pip install RPi.GPIO
sudo pip install spidev
#python3
sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo pip3 install RPi.GPIO
sudo pip3 install spidev
D o w n l o a d E x a m p l e s
O p e n R a s p b e r r y P i t e r m i n a l a n d r u n t h e f o l l o w i n g c o m m a n d
sudo apt-get install unzip -y
sudo wget https://www.waveshare.com/w/upload/8/8d/LCD_Module_RPI_code.zip
sudo unzip ./LCD_Module_RPI_code.zip
cd LCD_Module_RPI_code/RaspberryPi/
R u n t h e d e m o c o d e s
P l e a s e g o i n t o t h e R a s p b e r r y P i d i r e c t o r y ( d e m o c o d e s ) f i r s t a n d r u n t h e c o m m a n d s i n
t e r m i n a l
C c o d e s
R e - c o m p i l e t h e d e m o c o d e s
cd c
sudo make clean
sudo make -j 8
T h e t e s t p r o g r a m o f a l l s c r e e n s c a n b e c a l l e d d i r e c t l y b y e n t e r i n g t h e c o r r e s p o n d i n g s i z e
sudo ./main Screen Size
D e p e n d i n g o n t h e L C D , o n e o f t h e f o l l o w i n g c o m m a n d s s h o u l d b e e n t e r e d :
#0.96inch LCD Module
sudo ./main 0.96
#1.14inch LCD Module
sudo ./main 1.14
#1.28inch LCD Module
sudo ./main 1.28
#1.3inch LCD Module
sudo ./main 1.3
#1.47inch LCD Module
sudo ./main 1.47
#1.54inch LCD Module
sudo ./main 1.54
#1.8inch LCD Module
sudo ./main 1.8
#2inch LCD Module
sudo ./main 2
#2.4inch LCD Module
sudo ./main 2.4
p y t h o n
E n t e r t h e p y t h o n p r o g r a m d i r e c t o r y a n d r u n t h e c o m m a n d l s - l
cd python/examples
ls -l
T e s t p r o g r a m s f o r a l l s c r e e n s c a n b e v i e w e d , s o r t e d b y s i z e :
0 i n c h 9 6 _ L C D _ t e s t . p y : 0 . 9 6 i n c h L C D t e s t p r o g r a m
1 i n c h 1 4 _ L C D _ t e s t . p y : 1 . 1 4 i n c h L C D t e s t p r o g r a m
1 i n c h 2 8 _ L C D _ t e s t . p y : 1 . 2 8 i n c h L C D t e s t p r o g r a m
1 i n c h 3 _ L C D _ t e s t . p y : 1 . 3 i n c h L C D t e s t p r o g r a m
1 i n c h 4 7 _ L C D _ t e s t . p y : 1 . 4 7 i n c h L C D t e s t p r o g r a m
1 i n c h 5 4 _ L C D _ t e s t . p y : 1 . 5 4 i n c h L C D t e s t p r o g r a m
1 i n c h 8 _ L C D _ t e s t . p y : 1 . 8 i n c h L C D t e s t p r o g r a m
2 i n c h _ L C D _ t e s t . p y : 2 i n c h L C D t e s t p r o g r a m
2 i n c h 4 _ L C D _ t e s t . p y : 2 i n c h 4 L C D t e s t p r o g r a m
J u s t r u n t h e p r o g r a m c o r r e s p o n d i n g t o t h e s c r e e n , t h e p r o g r a m s u p p o r t s p y t h o n 2 / 3
# python2
sudo python 0inch96_LCD_test.py
sudo python 1inch14_LCD_test.py
sudo python 1inch28_LCD_test.py
sudo python 1inch3_LCD_test.py
sudo python 1inch47_LCD_test.py
sudo python 1inch54_LCD_test.py
sudo python 1inch8_LCD_test.py
sudo python 2inch_LCD_test.py
sudo python 2inch4_LCD_test.py
# python3
sudo python3 0inch96_LCD_test.py
sudo python3 1inch14_LCD_test.py
sudo python3 1inch28_LCD_test.py
sudo python3 1inch3_LCD_test.py
sudo python3 1inch47_LCD_test.py
sudo python3 1inch54_LCD_test.py
sudo python3 1inch8_LCD_test.py
sudo python3 2inch_LCD_test.py
sudo python3 2inch4_LCD_test.py
F B C P P o r t i n g
P S : F B C P i s c u r r e n t l y n o t c o m p a t i b l e w i t h 6 4 - b i t R a s p b e r r y P i s y s t e m , i t i s r e c o m m e n d e d
t o u s e 3 2 - b i t s y s t e m .
F r a m e b u f f e r u s e s a v i d e o o u t p u t d e v i c e t o d r i v e a v i d e o d i s p l a y d e v i c e f r o m a m e m o r y
b u f f e r c o n t a i n i n g c o m p l e t e f r a m e d a t a . S i m p l y p u t , a m e m o r y a r e a i s u s e d t o s t o r e t h e
d i s p l a y c o n t e n t , a n d t h e d i s p l a y c o n t e n t c a n b e c h a n g e d b y c h a n g i n g t h e d a t a i n t h e
m e m o r y .
T h e r e i s a n o p e n s o u r c e p r o j e c t o n g i t h u b : f b c p - i l i 9 3 4 1 . C o m p a r e d w i t h o t h e r f b c p
p r o j e c t s , t h i s p r o j e c t u s e s p a r t i a l r e f r e s h a n d D M A t o a c h i e v e a s p e e d o f u p t o 6 0 f p s
D o w n l o a d D r i v e r s
sudo apt-get install cmake -y
cd ~
wget https://www.waveshare.com/w/upload/1/18/Waveshare_fbcp.zip
unzip Waveshare_fbcp.zip
cd Waveshare_fbcp/
sudo chmod +x ./shell/*
M e t h o d 1 : U s e a s c r i p t ( r e c o m m e n d e d )
H e r e w e h a v e w r i t t e n s e v e r a l s c r i p t s t h a t a l l o w u s e r s t o q u i c k l y u s e f b c p a n d r u n
c o r r e s p o n d i n g c o m m a n d s a c c o r d i n g t o t h e i r o w n s c r e e n
I f y o u u s e a s c r i p t a n d d o n o t n e e d t o m o d i f y i t , y o u c a n i g n o r e t h e s e c o n d m e t h o d b e l o w .
N o t e : T h e s c r i p t w i l l r e p l a c e t h e c o r r e s p o n d i n g / b o o t / c o n f i g . t x t a n d / e t c / r c . l o c a l a n d
r e s t a r t , i f t h e u s e r n e e d s , p l e a s e b a c k u p t h e r e l e v a n t f i l e s i n a d v a n c e .
#0.96inch LCD Module
sudo ./shell/waveshare-0inch96
#1.14inch LCD Module
sudo ./shell/waveshare-1inch14
#1.3inch LCD Module
sudo ./shell/waveshare-1inch3
#1.44inch LCD Module
sudo ./shell/waveshare-1inch44
#1.54inch LCD Module
sudo ./shell/waveshare-1inch54
#1.8inch LCD Module
sudo ./shell/waveshare-1inch8
#2inch LCD Module
sudo ./shell/waveshare-2inch
#2.4inch LCD Module
sudo ./shell/waveshare-2inch4
M e t h o d 2 : M a n u a l C o n f i g u r a t i o n
E n v i r o n m e n t C o n f i g u r a t i o n
R a s p b e r r y P i ' s v c 4 - k m s - v 3 d w i l l c a u s e f b c p t o f a i l , s o w e n e e d t o c l o s e v c 4 - k m s - v 3 d b e f o r e
i n s t a l l i n g i t i n f b c p .
sudo nano /boot/config.txt
J u s t b l o c k t h e s t a t e m e n t c o r r e s p o n d i n g t o t h e p i c t u r e b e l o w .
A r e b o o t i s t h e n r e q u i r e d .
sudo reboot
C o m p i l e a n d r u n
mkdir build
cd build
cmake [options] ..
sudo make -j
sudo ./fbcp
R e p l a c e i t b y y o u r s e l f a c c o r d i n g t o t h e L C D M o d u l e y o u u s e , a b o v e c m a k e [ o p t i o n s ] . .
#0.96inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_0INCH96_LCD=ON -DBACKLIG
HT_CONTROL=ON -DSTATISTICS=0 ..
#1.14inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH14_LCD=ON -DBACKLIG
HT_CONTROL=ON -DSTATISTICS=0 ..
#1.3inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH3_LCD=ON -DBACKLIGH
T_CONTROL=ON -DSTATISTICS=0 ..
#1.54inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH54_LCD=ON -DBACKLIG
HT_CONTROL=ON -DSTATISTICS=0 ..
#1.8inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_1INCH8_LCD=ON -DBACKLIGH
T_CONTROL=ON -DSTATISTICS=0 ..
#2inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_2INCH_LCD=ON -DBACKLIGHT
_CONTROL=ON -DSTATISTICS=0 ..
#2.4inch LCD Module
sudo cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DWAVESHARE_2INCH4_LCD=ON -DBACKLIGH
T_CONTROL=ON -DSTATISTICS=0 ..
S e t u p t o s t a r t a u t o m a t i c a l l y
sudo cp ~/Waveshare_fbcp/buil
d/fbcp /usr/local/bin/fbcp
sudo nano /etc/rc.local
A d d f b c p & b e f o r e e x i t 0 . N o t e t h a t y o u
m u s t a d d " & " t o r u n i n t h e
b a c k g r o u n d , o t h e r w i s e t h e s y s t e m
m a y n o t b e a b l e t o s t a r t .
S e t t h e D i s p l a y R e s o l u t i o n
S e t t h e u s e r i n t e r f a c e d i s p l a y s i z e i n t h e / b o o t / c o n f i g . t x t f i l e .
sudo nano /boot/config.txt
T h e n a d d t h e f o l l o w i n g l i n e s a t t h e e n d o f t h e c o n f i g . t x t .
hdmi_force_hotplug=1
hdmi_cvt=[options]
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
display_rotate=0
R e p l a c e t h e a b o v e h d m i _ c v t = [ o p t i o n s ] a c c o r d i n g t o t h e L C D M o d u l e y o u a r e u s i n g .
#2.4inchinch LCD Module & 2inchinch LCD Module
hdmi_cvt=640 480 60 1 0 0 0
#1.8inch LCD Module
hdmi_cvt=400 300 60 1 0 0 0
#1.3inch LCD Module & 1.54inch LCD Module
hdmi_cvt=300 300 60 1 0 0 0
#1.14inch LCD Module
hdmi_cvt=300 170 60 1 0 0 0
#0.96inch LCD Module
hdmi_cvt=300 150 60 1 0 0 0
A n d t h e n r e b o o t t h e s y s t e m
sudo reboot
A f t e r r e b o o t i n g t h e s y s t e m , t h e R a s p b e r r y P i O S u s e r i n t e r f a c e w i l l b e d i s p l a y e d .
A P I D e s c r i p t i o n
T h e R a s p b e r r y P i s e r i e s c a n s h a r e a s e t o f p r o g r a m s , b e c a u s e t h e y a r e a l l e m b e d d e d
s y s t e m s , a n d t h e c o m p a t i b i l i t y i s r e l a t i v e l y s t r o n g .
T h e p r o g r a m i s d i v i d e d i n t o b o t t o m - l a y e r h a r d w a r e i n t e r f a c e , m i d d l e - l a y e r L C D s c r e e n
d r i v e r , a n d u p p e r - l a y e r a p p l i c a t i o n ;
C
H a r d w a r e I n t e r f a c e
W e h a v e c a r r i e d o u t t h e l o w - l e v e l e n c a p s u l a t i o n , i f y o u n e e d t o k n o w t h e i n t e r n a l
i m p l e m e n t a t i o n c a n g o t o t h e c o r r e s p o n d i n g d i r e c t o r y t o c h e c k , f o r t h e r e a s o n t h e
h a r d w a r e p l a t f o r m a n d t h e i n t e r n a l i m p l e m e n t a t i o n a r e d i f f e r e n t .
Y o u c a n o p e n D E V _ C o n f i g . c ( . h ) t o s e e d e f i n i t i o n s , w h i c h i n t h e d i r e c t o r y
R a s p b e r r y P i \ c \ l i b \ C o n f i g .
1. There are three ways for C to drive: BCM2835 library, WiringPi library,
and Dev library respectively
2. We use Dev libraries by default. If you need to change to BCM2835 or Wi
ringPi libraries, please open RaspberryPi\c\Makefile and modify lines 13-1
5 as follows:
D a t a t y p e :
#define UBYTE
#define UWORD
#define UDOUBLE
M o d u l e i n i t i a l i z a t i o n a n d e x i t p r o c e s s i n g .
void DEV_Module_Init(void);
void DEV_Module_Exit(void);
Note:
Here is some GPIO processing before and after using the LCD screen.
G P I O r e a d a n d w r i t e :
void DEV_Digital_Write(UWORD Pin, UBYTE Value);
UBYTE DEV_Digital_Read(UWORD Pin);
S P I w r i t e d a t a :
void DEV_SPI_WriteByte(UBYTE Value);
U p p e r a p p l i c a t i o n
I f y o u n e e d t o d r a w p i c t u r e s o r d i s p l a y C h i n e s e a n d E n g l i s h c h a r a c t e r s , w e p r o v i d e s o m e
b a s i c f u n c t i o n s h e r e a b o u t s o m e g r a p h i c s p r o c e s s i n g i n t h e d i r e c t o r y
R a s p b e r r y P i \ c \ l i b \ G U I \ G U I _ P a i n t . c ( . h ) .
T h e f o n t s c a n b e f o u n d i n R a s p b e r r y P i \ c \ l i b \ F o n t s d i r e c t o r y .
N e w I m a g e P r o p e r t i e s : C r e a t e a n e w i m a g e b u f f e r , t h i s p r o p e r t y i n c l u d e s t h e i m a g e
b u f f e r n a m e , w i d t h , h e i g h t , f l i p A n g l e , a n d c o l o r .
void Paint_NewImage(UBYTE *image, UWORD Width, UWORD Height, UWORD Rotate,
UWORD Color)
Parameters:
Image: the name of the image buffer, which is actually a pointer to
the first address of the image buffer;
Width: image buffer Width;
Height: the Height of the image buffer;
Rotate: Indicates the rotation Angle of an image
Color: the initial Color of the image;
S e l e c t i m a g e b u f f e r : T h e p u r p o s e o f t h e s e l e c t i o n i s t h a t y o u c a n c r e a t e m u l t i p l e i m a g e
a t t r i b u t e s , t h e r e c a n b e m u l t i p l e i m a g e s b u f f e r , y o u c a n s e l e c t e a c h i m a g e y o u c r e a t e .
void Paint_SelectImage(UBYTE *image)
Parameters:
Image: the name of the image buffer, which is actually a pointer to
the first address of the image buffer;
I m a g e R o t a t i o n : S e t t h e r o t a t i o n A n g l e o f t h e s e l e c t e d i m a g e , p r e f e r a b l y a f t e r
P a i n t _ S e l e c t I m a g e ( ) , y o u c a n c h o o s e t o r o t a t e 0 , 9 0 , 1 8 0 , 2 7 0 .
void Paint_SetRotate(UWORD Rotate)
Parameters:
Rotate: ROTATE_0, ROTATE_90, ROTATE_180, and ROTATE_270 correspond
to 0, 90, 180, and 270 degrees.
I m a g e m i r r o r f l i p : S e t t h e m i r r o r f l i p o f t h e s e l e c t e d i m a g e . Y o u c a n c h o o s e n o m i r r o r ,
h o r i z o n t a l m i r r o r , v e r t i c a l m i r r o r , o r i m a g e c e n t e r m i r r o r .
void Paint_SetMirroring(UBYTE mirror)
Parameters:
Mirror: indicates the image mirroring mode. MIRROR_NONE, MIRROR_HO
RIZONTAL, MIRROR_VERTICAL, MIRROR_ORIGIN correspond to no mirror, horizont
al mirror, vertical mirror, and image center mirror respectively.
S e t p o i n t s o f t h e d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r : h e r e i s t h e c o r e G U I f u n c t i o n ,
p r o c e s s i n g p o i n t s d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r .
void Paint_SetPixel(UWORD Xpoint, UWORD Ypoint, UWORD Color)
Parameters:
Xpoint: the X position of a point in the image buffer
Ypoint: Y position of a point in the image buffer
Color: indicates the Color of the dot
I m a g e b u f f e r f i l l c o l o r : F i l l s t h e i m a g e b u f f e r w i t h a c o l o r , u s u a l l y u s e d t o f l a s h t h e
s c r e e n i n t o b l a n k .
void Paint_Clear(UWORD Color)
Parameters:
Color: fill Color
T h e f i l l c o l o r o f a c e r t a i n w i n d o w i n t h e i m a g e b u f f e r : t h e i m a g e b u f f e r p a r t o f t h e
w i n d o w f i l l e d w i t h a c e r t a i n c o l o r , u s u a l l y u s e d t o f r e s h t h e s c r e e n i n t o b l a n k , o f t e n u s e d
f o r t i m e d i s p l a y , f r e s h t h e l a s t s e c o n d o f t h e s c r e e n .
void Paint_ClearWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color)
Parameters:
Xstart: the x-starting coordinate of the window
Ystart: the y-starting coordinate of the window
Xend: the x-end coordinate of the window
Yend: the y-end coordinate of the window
Color: fill Color
D r a w p o i n t : I n t h e i m a g e b u f f e r , d r a w p o i n t s o n ( X p o i n t , Y p o i n t ) , y o u c a n c h o o s e t h e
c o l o r , t h e s i z e o f t h e p o i n t , t h e s t y l e o f t h e p o i n t .
void Paint_DrawPoint(UWORD Xpoint, UWORD Ypoint, UWORD Color, DOT_PIXEL Do
t_Pixel, DOT_STYLE Dot_Style)
Parameters:
Xpoint: indicates the X coordinate of a point.
Ypoint: indicates the Y coordinate of a point.
Color: fill Color
Dot_Pixel: The size of the dot, the demo provides 8 size pointss b
y default.
Dot_Style: the size of a point that expands from the center of the
point or from the bottom left corner of the point to the right and up.
D r a w l i n e : I n t h e i m a g e b u f f e r , d r a w l i n e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d , Y e n d ) , y o u c a n
c h o o s e t h e c o l o r , t h e w i d t h a n d t h e s t y l e o f t h e l i n e .
void Paint_DrawLine(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UW
ORD Color, LINE_STYLE Line_Style ,
Parameters:
Xstart: the x-starting coordinate of a line
Ystart: the y-starting coordinate of the a line
Xend: the x-end coordinate of a line
Yend: the y-end coordinate of a line
Color: fill Color
Line_width: The width of the line, the demo provides 8 sizes of wi
dth by default.
Line_Style: line style. Select whether the lines are joined in a s
traight or dashed way.
D r a w r e c t a n g l e : I n t h e i m a g e b u f f e r , d r a w a r e c t a n g l e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d ,
Y e n d ) , y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , w h e t h e r t o f i l l t h e i n s i d e o f t h e
r e c t a n g l e .
void Paint_DrawRectangle(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color, DOT_PIXEL Line_width,
Parameters:
Xstart: the starting X coordinate of the rectangle
Ystart: the starting Y coordinate of the rectangle
Xend: the x-end coordinate of the rectangle
Yend: the y-end coordinate of the rectangle
Color: fill Color
Line_width: The width of the four sides of a rectangle. And the de
mo provides 8 sizes of width by default.
Draw_Fill: Fill, whether to fill the inside of the rectangle
D r a w c i r c l e : I n t h e i m a g e b u f f e r , d r a w a c i r c l e o f R a d i u s w i t h ( X _ C e n t e r Y _ C e n t e r ) a s t h e
c e n t e r . Y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , a n d w h e t h e r t o f i l l t h e i n s i d e o f
t h e c i r c l e .
void Paint_DrawCircle(UWORD X_Center, UWORD Y_Center, UWORD Radius, UWORD
Color, DOT_PIXEL Line_width,
Parameters:
X_Center: the x-coordinate of the center of the circle
Y_Center: the y-coordinate of the center of the circle
Radius: indicates the Radius of a circle
Color: fill Color
Line_width: The width of the arc, with a default of 8 widths
Draw_Fill: fill, whether to fill the inside of the circle
W r i t e A s c i i c h a r a c t e r : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a n
A s c i i c h a r a c t e r , y o u c a n s e l e c t A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawChar(UWORD Xstart, UWORD Ystart, const char Ascii_Char, sFO
NT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y-coordinate of the left vertex of a character
Ascii_Char: indicates the Ascii character
Font: Ascii visual character library, in the Fonts folder the demo
provides the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e E n g l i s h s t r i n g : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f E n g l i s h c h a r a c t e r s , y o u c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t
f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawString_EN(UWORD Xstart, UWORD Ystart, const char * pString,
sFONT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: Ascii visual character library, in the Fonts folder the demo
provides the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e C h i n e s e s t r i n g : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f C h i n e s e c h a r a c t e r s , y o u c a n c h o o s e c h a r a c t e r f o n t , f o n t f o r e g r o u n d c o l o r , a n d
f o n t b a c k g r o u n d c o l o r o f t h e G B 2 3 1 2 e n c o d i n g .
void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString,
cFONT* font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: GB2312 encoding character Font library, in the Fonts folder
the demo provides the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e n u m b e r s : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a s t r i n g
o f n u m b e r s , y o u c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawNum(UWORD Xpoint, UWORD Ypoint, double Nummber, sFONT* Fon
t, UWORD Digit, UWORD Color_Foreground,
Parameters:
Xpoint: the x-coordinate of the left vertex of a character
Ypoint: the Y coordinate of the left vertex of the font
Nummber: indicates the number displayed, which can be a decimal
Digit: It's a decimal number
Font: Ascii visual character library, in the Fonts folder the demo
provides the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
D i s p l a y t i m e : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , d i s p l a y t i m e , y o u
c a n c h o o s e A s c i i v i s u a l c h a r a c t e r f o n t , f o n t f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawTime(UWORD Xstart, UWORD Ystart, PAINT_TIME *pTime, sFONT*
Font, UWORD Color_Background,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PTime: display time, A time structure is defined here, as long as
the hours, minutes, and seconds are passed to the parameters;
Font: Ascii visual character library, in the Fonts folder the demo
provides the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
R e a d t h e l o c a l b m p i m a g e a n d w r i t e i t t o t h e c a c h e .
F o r L i n u x o p e r a t i n g s y s t e m s s u c h a s R a s p b e r r y P i , y o u c a n r e a d a n d w r i t e p i c t u r e s . F o r
R a s p b e r r y P i , i n t h e d i r e c t o r y : R a s p b e r r y P i \ c \ l i b \ G U I \ G U I _ B M P f i l e . c ( . h ) .
UBYTE GUI_ReadBmp(const char *path, UWORD Xstart, UWORD Ystart)
parameter:
path: the relative path of the BMP image
Xstart: The X coordinate of the left vertex of the image, generally
0 is passed by default
Ystart: The Y coordinate of the left vertex of the picture, general
ly 0 by default
T e s t i n g C o d e f o r U s e r s
F o r R a s p b e r r y P i , i n t h e d i r e c t o r y : R a s p b e r r y P i \ c \ e x a m p l e s , f o r a l l t h e t e s t c o d e ;
I f y o u n e e d t o r u n t h e 0 . 9 6 - i n c h L C D t e s t p r o g r a m , y o u n e e d t o a d d 0 . 9 6 a s a p a r a m e t e r
w h e n r u n n i n g t h e m a i n d e m o .
R e - e x e c u t e i n L i n u x c o m m a n d m o d e a s f o l l o w s :
make clean
make
sudo ./main 0.96
P y t h o n ( f o r R a s p b e r r y P i )
W o r k s w i t h p y t h o n a n d p y t h o n 3 .
F o r p y t h o n , h i s c a l l s a r e n o t a s c o m p l i c a t e d a s C .
R a s p b e r r y P i : R a s p b e r r y P i \ p y t h o n \ l i b \
l c d c o n f i g . p y
M o d u l e i n i t i a l i z a t i o n a n d e x i t p r o c e s s i n g .
def module_init()
def module_exit()
Note:
1. Here is some GPIO processing before and after using the LCD screen.
2. The module_init() function is automatically called in the INIT () initi
alizer on the LCD, but the module_exit() function needs to be called by it
self.
G P I O r e a d a n d w r i t e :
def digital_write(pin, value)
def digital_read(pin)
S P I w r i t e d a t a .
def spi_writebyte(data)
x x x _ L C D _ t e s t . p y ( x x x i n d i c a t e s t h e s i z e , i f i t i s a 0 . 9 6 i n c h L C D , i t i s
0 i n c h 9 6 _ L C D _ t e s t . p y , a n d s o o n )
p y t h o n i s i n t h e f o l l o w i n g d i r e c t o r y :
R a s p b e r r y P i : R a s p b e r r y P i \ p y t h o n \ e x a m p l e s \
I f y o u r p y t h o n v e r s i o n i s p y t h o n 2 a n d y o u n e e d t o r u n t h e 0 . 9 6 i n c h L C D t e s t p r o g r a m , r e -
e x e c u t e i t a s f o l l o w s i n l i n u x c o m m a n d m o d e :
sudo python 0inch96_LCD_test.py
I f y o u r p y t h o n v e r s i o n i s p y t h o n 3 a n d y o u n e e d t o r u n t h e 0 . 9 6 i n c h L C D t e s t p r o g r a m , r e -
e x e c u t e t h e f o l l o w i n g i n l i n u x c o m m a n d m o d e :
sudo python3 0inch96_LCD_test.py
A b o u t R o t a t i o n S e t t i n g s
I f y o u n e e d t o s e t t h e s c r e e n r o t a t i o n i n t h e p y t h o n p r o g r a m , y o u c a n s e t i t b y t h e
s t a t e m e n t i m _ r = i m a g e 1 . r o t a t e ( 2 7 0 ) .
im_r= image1.rotate(270)
R o t a t i o n e f f e c t , t a k e 1 . 5 4 a s a n e x a m p l e , t h e o r d e r i s 0 ° , 9 0 ° , 1 8 0 ° , 2 7 0 °
G U I F u n c t i o n s
P y t h o n h a s a n i m a g e l i b r a r y
t h e l o g i c a l l a y e r l i k e C a n d c a n d i r e c t l y c a l l t o t h e i m a g e l i b r a r y f o r i m a g e p r o c e s s i n g . T h e
f o l l o w i n g w i l l t a k e a 1 . 5 4 - i n c h L C D a s a n e x a m p l e , w e p r o v i d e a b r i e f d e s c r i p t i o n o f t h e
d e m o .
I t n e e d s t o u s e t h e i m a g e l i b r a r y a n d i n s t a l l t h e l i b r a r y .
sudo apt-get install python3-pil
A n d t h e n i m p o r t t h e l i b r a r y
from PIL import Image,ImageDraw,ImageFont.
A m o n g t h e m , I m a g e i s t h e b a s i c l i b r a r y , I m a g e D r a w i s t h e d r a w i n g f u n c t i o n , a n d
I m a g e F o n t i s t h e t e x t f u n c t i o n .
D e f i n e a n i m a g e c a c h e t o f a c i l i t a t e d r a w i n g , w r i t i n g , a n d o t h e r f u n c t i o n s o n t h e p i c t u r e .
image1 = Image.new("RGB", (disp.width, disp.height), "WHITE")
T h e f i r s t p a r a m e t e r d e f i n e s t h e c o l o r d e p t h o f t h e i m a g e , w h i c h i s d e f i n e d a s " 1 " t o i n d i c a t e
t h e b i t m a p o f o n e - b i t d e p t h . T h e s e c o n d p a r a m e t e r i s a t u p l e t h a t d e f i n e s t h e w i d t h a n d
h e i g h t o f t h e i m a g e . T h e t h i r d p a r a m e t e r d e f i n e s t h e d e f a u l t c o l o r o f t h e b u f f e r , w h i c h i s
d e f i n e d a s " W H I T E " .
C r e a t e a d r a w i n g o b j e c t b a s e d o n I m a g e 1 o n w h i c h a l l d r a w i n g o p e r a t i o n s w i l l b e
p e r f o r m e d o n h e r e .
draw = ImageDraw.Draw(image1)
D r a w a l i n e .
draw.line([(20, 10),(70, 60)], fill = "RED",width = 1)
T h e f i r s t p a r a m e t e r i s a f o u r - e l e m e n t t u p l e s t a r t i n g a t ( 0 , 0 ) a n d e n d i n g a t ( 1 2 7 , 0 ) . D r a w a
l i n e . F i l l = " 0 " m e a n s t h e c o l o r o f t h e l i n e i s w h i t e .
D r a w a r e c t a n g l e .
draw.rectangle([(20,10),(70,60)],fill = "WHITE",outline="BLACK")
T h e f i r s t a r g u m e n t i s a t u p l e o f f o u r e l e m e n t s . ( 2 0 , 1 0 ) i s t h e c o o r d i n a t e v a l u e i n t h e u p p e r
l e f t c o r n e r o f t h e r e c t a n g l e , a n d ( 7 0 , 6 0 ) i s t h e c o o r d i n a t e v a l u e i n t h e l o w e r r i g h t c o r n e r o f
t h e r e c t a n g l e . F i l l = " W H I T E " m e a n s B L A C K i n s i d e , a n d o u t l i n e = " B L A C K " m e a n s t h e c o l o r
o f t h e o u t l i n e i s b l a c k .
D r a w a c i r c l e .
draw.arc((150,15,190,55),0, 360, fill =(0,255,0)
D r a w a n i n s c r i b e d c i r c l e i n t h e s q u a r e , t h e f i r s t p a r a m e t e r i s a t u p l e o f 4 e l e m e n t s , w i t h
( 1 5 0 , 1 5 ) a s t h e u p p e r l e f t c o r n e r v e r t e x o f t h e s q u a r e , ( 1 9 0 , 5 5 ) a s t h e l o w e r r i g h t c o r n e r
v e r t e x o f t h e s q u a r e , s p e c i f y i n g t h e l e v e l m e d i a n l i n e o f t h e r e c t a n g u l a r f r a m e i s t h e a n g l e
o f 0 d e g r e e s , t h e s e c o n d p a r a m e t e r i n d i c a t e s t h e s t a r t i n g a n g l e , t h e t h i r d p a r a m e t e r
i n d i c a t e s t h e e n d i n g a n g l e , a n d f i l l = 0 i n d i c a t e s t h a t t h e c o l o r o f t h e l i n e i s w h i t e . I f t h e
f i g u r e i s n o t s q u a r e a c c o r d i n g t o t h e c o o r d i n a t i o n , y o u w i l l g e t a n e l l i p s e .
B e s i d e s t h e a r c f u n c t i o n , y o u c a n a l s o u s e t h e c h o r d f u n c t i o n f o r d r a w i n g a s o l i d c i r c l e .
draw.ellipse((150,65,190,105), fill = 0)
T h e f i r s t p a r a m e t e r i s t h e c o o r d i n a t i o n o f t h e e n c l o s i n g r e c t a n g l e . T h e s e c o n d a n d t h i r d
p a r a m e t e r s a r e t h e b e g i n n i n g a n d e n d d e g r e e s o f t h e c i r c l e . T h e f o u r t h p a r a m e t e r i s t h e f i l l
c o l o r o f t h e c i r c l e .
C h a r a c t e r .
T h e I m a g e F o n t m o d u l e n e e d s t o b e i m p o r t e d a n d i n s t a n t i a t e d :
Font1 = ImageFont.truetype("../Font/Font01.ttf",25)
Font2 = ImageFont.truetype("../Font/Font01.ttf",35)
Font3 = ImageFont.truetype("../Font/Font02.ttf",32)
Y o u c a n u s e t h e f o n t s o f W i n d o w s o r o t h e r f o n t s w h i c h i s i n t t c f o r m a t . .
N o t e : E a c h c h a r a c t e r l i b r a r y c o n t a i n s d i f f e r e n t c h a r a c t e r s ; I f s o m e c h a r a c t e r s c a n n o t b e
d i s p l a y e d , i t i s r e c o m m e n d e d t h a t y o u c a n r e f e r t o t h e e n c o d i n g s e t r o u s e d . T o d r a w
E n g l i s h c h a r a c t e r s , y o u c a n d i r e c t l y u s e t h e f o n t s ; f o r C h i n e s e c h a r a c t e r s , y o u n e e d t o a d d
a s y m b o l u :
draw.text((40, 50), 'WaveShare', fill = (128,255,128),font=Font2)
text= u"微雪电子"
draw.text((74, 150),text, fill = "WHITE",font=Font3)
T h e f i r s t p a r a m e t e r i s a t u p l e o f 2 e l e m e n t s , w i t h ( 4 0 , 5 0 ) a s t h e l e f t v e r t e x , t h e f o n t i s
F o n t 2 , a n d t h e f i l l i s t h e f o n t c o l o r . Y o u c a n d i r e c t l y m a k e f i l l = " W H I T E " , b e c a u s e t h e
r e g u l a r c o l o r v a l u e i s a l r e a d y d e f i n e d W e l l , o f c o u r s e , y o u c a n a l s o u s e f i l l = ( 1 2 8 , 2 5 5 , 1 2 8 ) ,
t h e p a r e n t h e s e s c o r r e s p o n d t o t h e v a l u e s o f t h e t h r e e R G B c o l o r s s o t h a t y o u c a n p r e c i s e l y
c o n t r o l t h e c o l o r y o u w a n t . T h e s e c o n d s e n t e n c e s h o w s M i c r o S n o w E l e c t r o n i c s , u s i n g
F o n t 3 , t h e f o n t c o l o r i s w h i t e .
r e a d l o c a l i m a g e
image = Image.open('../pic/LCD_1inch28.jpg')
T h e p a r a m e t e r i s t h e i m a g e p a t h .
O t h e r f u n c t i o n s .
F o r m o r e i n f o r m a t i o n , y o u c a n r e f e r t o
U s i n g w i t h S T M 3 2
S o f t w a r e d e s c r i p t i o n
T h e d e m o i s d e v e l o p e d b a s e d o n t h e H A L l i b r a r y . D o w n l o a d t h e d e m o , f i n d t h e S T M 3 2
p r o g r a m f i l e d i r e c t o r y , a n d o p e n t h e L C D _ d e m o . u v p r o j x i n t h e
S T M 3 2 \ S T M 3 2 F 1 0 3 R B T 6 \ M D K - A R M d i r e c t o r y t o c h e c k t h e p r o g r a m .
O p e n m a i n . c , y o u c a n s e e a l l t h e t e s t p r o g r a m s , r e m o v e t h e c o m m e n t s i n f r o n t o f t h e
t e s t p r o g r a m s o n t h e c o r r e s p o n d i n g s c r e e n , a n d r e c o m p i l e a n d d o w n l o a d .
L C D _ 0 i n 9 6 _ t e s t ( ) 0 . 9 6 i n c h L C D t e s t p r o g r a m
L C D _ 1 i n 1 4 _ t e s t ( ) 1 . 1 4 i n c h L C D t e s t p r o g r a m
L C D _ 1 i n 2 8 _ t e s t ( ) 1 . 2 8 i n c h L C D t e s t p r o g r a m
L C D _ 1 i n 3 _ t e s t ( ) 1 . 3 i n c h L C D t e s t p r o g r a m
L C D _ 1 i n 5 4 _ t e s t ( ) 1 . 5 4 i n c h L C D t e s t p r o g r a m
L C D _ 1 i n 8 _ t e s t ( ) 1 . 8 i n c h L C D t e s t p r o g r a m
L C D _ 2 i n _ t e s t ( ) 2 i n c h L C D t e s t p r o g r a m
P r o g r a m d e s c r i p t i o n
U n d e r l y i n g h a r d w a r e i n t e r f a c e
D a t a t y p e
#define UBYTE
#define UWORD
#define UDOUBLE
M o d u l e i n i t i a l i z a t i o n a n d e x i t p r o c e s s i n g
UBYTE System_Init(void);
void System_Exit(void);
Note:
1.here is some GPIO processing before and after using the LCD screen.
2.After the System_Exit(void) function is used, the OLED display will be t
urned off;
W r i t e a n d r e a d G P I O
void DEV_Digital_Write(UWORD Pin, UBYTE Value);
UBYTE DEV_Digital_Read(UWORD Pin);
S P I w r i t e d a t a
UBYTE SPI4W_Write_Byte(uint8_t value);
T h e u p p e r a p p l i c a t i o n
F o r t h e s c r e e n , i f y o u n e e d t o d r a w p i c t u r e s , d i s p l a y C h i n e s e a n d E n g l i s h c h a r a c t e r s ,
d i s p l a y p i c t u r e s , e t c . , y o u c a n u s e t h e u p p e r a p p l i c a t i o n t o d o , a n d w e p r o v i d e s o m e b a s i c
f u n c t i o n s h e r e a b o u t s o m e g r a p h i c s p r o c e s s i n g i n t h e d i r e c t o r y
S T M 3 2 \ S T M 3 2 F 1 0 3 R B \ U s e r \ G U I _ D E V \ G U I _ P a i n t . c ( . h )
N o t e : B e c a u s e o f t h e s i z e o f t h e i n t e r n a l R A M o f S T M 3 2 a n d a r d u i n o , t h e G U I i s d i r e c t l y
w r i t t e n t o t h e R A M o f t h e L C D .
T h e c h a r a c t e r f o n t w h i c h G U I d e p e n d e n t i s i n t h e d i r e c t o r y
S T M 3 2 \ S T M 3 2 F 1 0 3 R B \ U s e r \ F o n t s
N e w I m a g e P r o p e r t i e s : C r e a t e a n e w i m a g e p r o p e r t y , t h i s p r o p e r t y i n c l u d e s t h e i m a g e
b u f f e r n a m e , w i d t h , h e i g h t , f l i p A n g l e , c o l o r .
void Paint_NewImage(UWORD Width, UWORD Height, UWORD Rotate, UWORD Color)
Parameters:
Width: image buffer Width;
Height: the Height of the image buffer;
Rotate: Indicates the rotation Angle of an image
Color: the initial Color of the image;
S e t t h e c l e a r s c r e e n f u n c t i o n , u s u a l l y c a l l t h e c l e a r f u n c t i o n o f L C D d i r e c t l y .
void Paint_SetClearFuntion(void (*Clear)(UWORD));
parameter:
Clear : Pointer to the clear screen function, used to quickly clear th
e screen to a certain color;
S e t t h e d r a w i n g p i x e l f u n c t i o n
void Paint_SetDisplayFuntion(void (*Display)(UWORD,UWORD,UWORD));
parameter:
Display: Pointer to the pixel drawing function, which is used to write
data to the specified location in the internal RAM of the LCD;
S e l e c t i m a g e b u f f e r : t h e p u r p o s e o f t h e s e l e c t i o n i s t h a t y o u c a n c r e a t e m u l t i p l e i m a g e
a t t r i b u t e s , i m a g e b u f f e r c a n e x i s t m u l t i p l e , y o u c a n s e l e c t e a c h i m a g e y o u c r e a t e .
void Paint_SelectImage(UBYTE *image)
Parameters:
Image: the name of the image cache, which is actually a pointer to the
first address of the image buffer
I m a g e R o t a t i o n : S e t t h e s e l e c t e d i m a g e r o t a t i o n A n g l e , p r e f e r a b l y a f t e r
P a i n t _ S e l e c t I m a g e ( ) , y o u c a n c h o o s e t o r o t a t e 0 , 9 0 , 1 8 0 , 2 7 0 .
void Paint_SetRotate(UWORD Rotate)
Parameters:
Rotate: ROTATE_0, ROTATE_90, ROTATE_180, and ROTATE_270 correspond to
0, 90, 180, and 270 degrees respectively;
I m a g e m i r r o r f l i p : S e t t h e m i r r o r f l i p o f t h e s e l e c t e d i m a g e . Y o u c a n c h o o s e n o m i r r o r ,
h o r i z o n t a l m i r r o r , v e r t i c a l m i r r o r , o r i m a g e c e n t e r m i r r o r .
void Paint_SetMirroring(UBYTE mirror)
Parameters:
Mirror: indicates the image mirroring mode. MIRROR_NONE, MIRROR_HORIZO
NTAL, MIRROR_VERTICAL, MIRROR_ORIGIN correspond to no mirror, horizontal m
irror, vertical mirror, and about image center mirror respectively.
S e t p o i n t s o f d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r : h e r e i s t h e c o r e G U I f u n c t i o n ,
p r o c e s s i n g p o i n t s d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r .
void Paint_SetPixel(UWORD Xpoint, UWORD Ypoint, UWORD Color)
Parameters:
Xpoint: the X position of a point in the image buffer
Ypoint: Y position of a point in the image buffer
Color: indicates the Color of the dot
I m a g e b u f f e r f i l l c o l o r : F i l l s t h e i m a g e b u f f e r w i t h a c o l o r , u s u a l l y u s e d t o f l a s h t h e
s c r e e n i n t o b l a n k .
void Paint_Clear(UWORD Color)
Parameters:
Color: fill Color
I m a g e b u f f e r p a r t o f t h e w i n d o w f i l l i n g c o l o r : t h e i m a g e b u f f e r p a r t o f t h e w i n d o w f i l l e d
w i t h a c e r t a i n c o l o r , g e n e r a l l y a s a w i n d o w w h i t e w a s h i n g f u n c t i o n , o f t e n u s e d f o r t i m e
d i s p l a y , w h i t e w a s h i n g o n a s e c o n d
void Paint_ClearWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color)
Parameters:
Xstart: the x-starting coordinate of the window
Ystart: indicates the Y starting point of the window
Xend: the x-end coordinate of the window
Yend: indicates the y-end coordinate of the window
Color: fill Color
D r a w p o i n t s : I n t h e i m a g e b u f f e r , d r a w p o i n t s o n ( X p o i n t , Y p o i n t ) , y o u c a n c h o o s e t h e
c o l o r , t h e s i z e o f t h e p o i n t , t h e s t y l e o f t h e p o i n t .
void Paint_DrawPoint(UWORD Xpoint, UWORD Ypoint, UWORD Color, DOT_PIXEL Do
t_Pixel, DOT_STYLE Dot_Style)
Parameters:
Xpoint: indicates the X coordinate of a point
Ypoint: indicates the Y coordinate of a point
Color: fill Color
Dot_Pixel: The size of the dot, providing a default of eight size poin
ts
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
Dot_Style: the size of a point that expands from the center of the poi
nt or from the bottom left corner of the point to the right and up
typedef enum {
DOT_FILL_AROUND
DOT_FILL_RIGHTUP,
} DOT_STYLE;
L i n e d r a w i n g : I n t h e i m a g e b u f f e r , l i n e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d , Y e n d ) , y o u c a n
c h o o s e t h e c o l o r , l i n e w i d t h , l i n e s t y l e .
void Paint_DrawLine(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UW
ORD Color, LINE_STYLE Line_Style ,
Parameters:
Xstart: the x-starting coordinate of a line
Ystart: indicates the Y starting point of a line
Xend: x-terminus of a line
Yend: the y-end coordinate of a line
Color: fill Color
Line_width: The width of the line, which provides a default of eight w
idths
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
Line_Style: line style. Select whether the lines are joined in a strai
ght or dashed way
typedef enum {
LINE_STYLE_SOLID = 0,
LINE_STYLE_DOTTED,
} LINE_STYLE;
D r a w r e c t a n g l e : I n t h e i m a g e b u f f e r , d r a w a r e c t a n g l e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d ,
Y e n d ) , y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , w h e t h e r t o f i l l t h e i n s i d e o f t h e
r e c t a n g l e .
void Paint_DrawRectangle(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color, DOT_PIXEL Line_width,
Parameters:
Xstart: the starting X coordinate of the rectangle
Ystart: indicates the Y starting point of the rectangle
Xend: X terminus of the rectangle
Yend: specifies the y-end coordinate of the rectangle
Color: fill Color
Line_width: The width of the four sides of a rectangle. Default ei
ght widths are provided
typedef enum {
} DOT_PIXEL;
Draw_Fill: Fill, whether to fill the inside of the rectangle
typedef enum {
} DRAW_FILL;
D r a w c i r c l e : I n t h e i m a g e b u f f e r , d r a w a c i r c l e o f R a d i u s w i t h ( X _ C e n t e r Y _ C e n t e r ) a s t h e
c e n t e r . Y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , a n d w h e t h e r t o f i l l t h e i n s i d e o f
t h e c i r c l e .
void Paint_DrawCircle(UWORD X_Center, UWORD Y_Center, UWORD Radius, UWORD
Color, DOT_PIXEL Line_width,
Parameters:
X_Center: the x-coordinate of the center of a circle
Y_Center: Y coordinate of the center of a circle
Radius: indicates the Radius of a circle
Color: fill Color
Line_width: The width of the arc, with a default of 8 widths
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
Draw_Fill: fill, whether to fill the inside of the circle
typedef enum {
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
} DRAW_FILL;
W r i t e A s c i i c h a r a c t e r : I n t h e i m a g e b u f f e r , a t ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a n
A s c i i c h a r a c t e r , y o u c a n s e l e c t A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawChar(UWORD Xstart, UWORD Ystart, const char Ascii_Char, sFO
NT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
Ascii_Char: indicates the Ascii character
Font: Ascii visual character library, in the Fonts folder provides the
following Fonts:
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e E n g l i s h s t r i n g : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f E n g l i s h c h a r a c t e r s , c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d
c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawString_EN(UWORD Xstart, UWORD Ystart, const char * pString,
sFONT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: Ascii visual character library, in the Fonts folder provides the
following Fonts:
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e C h i n e s e s t r i n g : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f C h i n e s e c h a r a c t e r s , y o u c a n c h o o s e G B 2 3 1 2 e n c o d i n g c h a r a c t e r f o n t , f o n t
f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString,
cFONT* font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: GB2312 encoding character Font library, in the Fonts folder prov
ides the following Fonts:
Font12CN: ASCII font 11*21, Chinese font 16*21
Font24CN: ASCII font24 *41, Chinese font 32*41
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e n u m b e r s : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a s t r i n g
o f n u m b e r s , y o u c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawNum(UWORD Xpoint, UWORD Ypoint, double Nummber, sFONT* Fon
t, UWORD Digit, UWORD Color_Foreground,
Parameters:
Xpoint: the x-coordinate of the left vertex of a character
Ypoint: the Y coordinate of the left vertex of the font
Nummber: indicates the number displayed, which can be a decimal
Digit: It's a decimal number
Font: Ascii visual character library, in the Fonts folder provides the
following Fonts:
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Color_Foreground: Font color
Color_Background: indicates the background color
D i s p l a y t i m e : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , d i s p l a y t i m e , y o u
c a n c h o o s e A s c i i v i s u a l c h a r a c t e r f o n t , f o n t f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawTime(UWORD Xstart, UWORD Ystart, PAINT_TIME *pTime, sFONT*
Font, UWORD Color_Background,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PTime: display time, here defined a good time structure, as long as th
e hour, minute and second bits of data to the parameter;
Font: Ascii visual character library, in the Fonts folder provides the
following Fonts:
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Color_Foreground: Font color
Color_Background: indicates the background color
A r d u i n o s o f t w a r e d e s c r i p t i o n
N o t e : T h e d e m o s a r e a l l t e s t e d o n A r d u i n o u n o . I f y o u n e e d o t h e r t y p e s o f A r d u i n o , y o u
n e e d t o d e t e r m i n e w h e t h e r t h e c o n n e c t e d p i n s a r e c o r r e c t .
R u n p r o g r a m
I n t h e p r o d u c t e n c y c l o p e d i a i n t e r f a c e d o w n l o a d
A r d u i n o p r o g r a m i s l o c a t e d a t ~ / A r d u i n o / ...
P l e a s e s e l e c t t h e c o r r e s p o n d i n g p r o g r a m a c c o r d i n g t o t h e L C D s c r e e n m o d e l t o o p e n .
Y o u c a n v i e w t e s t p r o g r a m s f o r a l l s c r e e n s i z e s , s o r t e d b y s i z e :
F o r e x a m p l e , 1 . 5 4 i n c h L C D M o d u l e . O p e n t h e L C D _ 1 i n c h 5 4 f o l d e r a n d r u n t h e
L C D _ 1 i n c h 5 4 . i n o f i l e .
O p e n t h e p r o g r a m , s e l e c t t h e d e v e l o p m e n t b o a r d m o d e l A r d u i n o U N O .
S e l e c t t h e c o r r e s p o n d i n g C O M p o r t
T h e n c l i c k t o c o m p i l e a n d d o w n l o a d
P r o g r a m D e s c r i p t i o n
D o c u m e n t I n t r o d u c t i o n
T a k e A r d u i n o U N O c o n t r o l l i n g a 1 . 5 4 - i n c h L C D a s a n e x a m p l e , o p e n t h e
A r d u i n o \ L C D _ 1 i n c h 5 4 d i r e c t o r y :
O f w h i c h :
L C D _ 1 i n c h 5 4 . i n o : o p e n w i t h A r d u i n o I D E ;
L C D _ D r i v e r . c p p ( . h ) : i s t h e d r i v e r o f t h e L C D s c r e e n ;
D E V _ C o n f i g . c p p ( . h ) : I t i s t h e h a r d w a r e i n t e r f a c e d e f i n i t i o n , w h i c h e n c a p s u l a t e s t h e r e a d
a n d w r i t e s p i n l e v e l s , S P I t r a n s m i s s i o n d a t a , a n d p i n i n i t i a l i z a t i o n ;
f o n t 8 . c p p , f o n t 1 2 . c p p , f o n t 1 6 . c p p , f o n t 2 0 . c p p , f o n t 2 4 . c p p , f o n t 2 4 C N . c p p , f o n t s . h : f o n t s f o r
c h a r a c t e r s o f d i f f e r e n t s i z e s ;
i m a g e . c p p ( . h ) : i s t h e i m a g e d a t a , w h i c h c a n c o n v e r t a n y B M P i m a g e i n t o a 1 6 - b i t t r u e c o l o r
i m a g e a r r a y t h r o u g h I m g 2 L c d ( d o w n l o a d a b l e i n t h e d e v e l o p m e n t d a t a ) .
T h e p r o g r a m i s d i v i d e d i n t o b o t t o m - l a y e r h a r d w a r e i n t e r f a c e , m i d d l e - l a y e r L C D s c r e e n
d r i v e r , a n d u p p e r - l a y e r a p p l i c a t i o n ;
U n d e r l y i n g h a r d w a r e i n t e r f a c e
T h e h a r d w a r e i n t e r f a c e i s d e f i n e d i n t h e t w o f i l e s D E V _ C o n f i g . c p p ( . h ) , a n d f u n c t i o n s s u c h
a s r e a d a n d w r i t e p i n l e v e l , d e l a y , a n d S P I t r a n s m i s s i o n a r e e n c a p s u l a t e d .
w r i t e p i n l e v e l
void DEV_Digital_Write(int pin, int value)
T h e f i r s t p a r a m e t e r i s t h e p i n , a n d t h e s e c o n d i s t h e h i g h a n d l o w l e v e l s .
R e a d p i n l e v e l
int DEV_Digital_Read(int pin)
T h e p a r a m e t e r i s t h e p i n , a n d t h e r e t u r n v a l u e i s t h e l e v e l o f t h e r e a d p i n .
D e l a y
DEV_Delay_ms(unsigned int delaytime)
m i l l i s e c o n d l e v e l d e l a y .
S P I o u t p u t d a t a
DEV_SPI_WRITE(unsigned char data)
T h e p a r a m e t e r i s c h a r t y p e , o c c u p y i n g 8 b i t s .
T h e u p p e r a p p l i c a t i o n
F o r t h e s c r e e n , i f y o u n e e d t o d r a w p i c t u r e s , d i s p l a y C h i n e s e a n d E n g l i s h c h a r a c t e r s ,
d i s p l a y p i c t u r e s , e t c . , y o u c a n u s e t h e u p p e r a p p l i c a t i o n t o d o , a n d w e p r o v i d e s o m e b a s i c
f u n c t i o n s h e r e a b o u t s o m e g r a p h i c s p r o c e s s i n g i n t h e d i r e c t o r y G U I _ P a i n t . c ( . h )
N o t e : B e c a u s e o f t h e s i z e o f t h e i n t e r n a l R A M o f S T M 3 2 a n d A r d u i n o , t h e G U I i s d i r e c t l y
w r i t t e n t o t h e R A M o f t h e L C D .
T h e f o n t s u s e d b y t h e G U I a l l d e p e n d o n t h e f o n t * . c p p ( h ) f i l e s u n d e r t h e s a m e f i l e
N e w I m a g e P r o p e r t i e s : C r e a t e a n e w i m a g e p r o p e r t y , t h i s p r o p e r t y i n c l u d e s t h e i m a g e
b u f f e r n a m e , w i d t h , h e i g h t , f l i p A n g l e , a n d c o l o r .
void Paint_NewImage(UWORD Width, UWORD Height, UWORD Rotate, UWORD Color)
Parameters:
Width: image buffer Width;
Height: the Height of the image buffer;
Rotate: Indicates the rotation Angle of an image
Color: the initial Color of the image;
S e t t h e c l e a r s c r e e n f u n c t i o n , u s u a l l y c a l l t h e c l e a r f u n c t i o n o f L C D d i r e c t l y .
void Paint_SetClearFuntion(void (*Clear)(UWORD));
parameter:
Clear: Pointer to the clear screen function, used to quickly clear the
screen to a certain color;
S e t t h e d r a w i n g p i x e l f u n c t i o n .
void Paint_SetDisplayFuntion(void (*Display)(UWORD,UWORD,UWORD));
parameter:
Display: Pointer to the pixel drawing function, which is used to write
data to the specified location in the internal RAM of the LCD;
S e l e c t i m a g e b u f f e r : t h e p u r p o s e o f t h e s e l e c t i o n i s t h a t y o u c a n c r e a t e m u l t i p l e i m a g e
a t t r i b u t e s , i m a g e b u f f e r c a n e x i s t m u l t i p l e , a n d y o u c a n s e l e c t e a c h i m a g e y o u c r e a t e .
void Paint_SelectImage(UBYTE *image)
Parameters:
Image: the name of the image cache, which is actually a pointer to the
first address of the image buffer
I m a g e R o t a t i o n : S e t t h e s e l e c t e d i m a g e r o t a t i o n A n g l e , p r e f e r a b l y a f t e r
P a i n t _ S e l e c t I m a g e ( ) , y o u c a n c h o o s e t o r o t a t e 0 , 9 0 , 1 8 0 , 2 7 0 .
void Paint_SetRotate(UWORD Rotate)
Parameters:
Rotate: ROTATE_0, ROTATE_90, ROTATE_180, and ROTATE_270 correspond to
0, 90, 180, and 270 degrees respectively;
I m a g e m i r r o r f l i p : S e t t h e m i r r o r f l i p o f t h e s e l e c t e d i m a g e . Y o u c a n c h o o s e n o m i r r o r ,
h o r i z o n t a l m i r r o r , v e r t i c a l m i r r o r , o r i m a g e c e n t e r m i r r o r .
void Paint_SetMirroring(UBYTE mirror)
Parameters:
Mirror: indicates the image mirroring mode. MIRROR_NONE, MIRROR_HORIZO
NTAL, MIRROR_VERTICAL, MIRROR_ORIGIN correspond to no mirror, horizontal m
irror, vertical mirror, and about image center mirror respectively.
S e t p o i n t s o f d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r : h e r e i s t h e c o r e G U I f u n c t i o n ,
p r o c e s s i n g p o i n t s d i s p l a y p o s i t i o n a n d c o l o r i n t h e b u f f e r .
void Paint_SetPixel(UWORD Xpoint, UWORD Ypoint, UWORD Color)
Parameters:
Xpoint: the X position of a point in the image buffer
Ypoint: Y position of a point in the image buffer
Color: indicates the Color of the dot
I m a g e b u f f e r f i l l c o l o r : F i l l s t h e i m a g e b u f f e r w i t h a c o l o r , u s u a l l y u s e d t o f l a s h t h e
s c r e e n i n t o b l a n k .
void Paint_ClearWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color)
Parameters:
Xstart: the x-starting coordinate of the window
Ystart: indicates the Y starting point of the window
Xend: the x-end coordinate of the window
Yend: indicates the y-end coordinate of the window
Color: fill Color
D r a w p o i n t s : I n t h e i m a g e b u f f e r , d r a w p o i n t s o n ( X p o i n t , Y p o i n t ) , y o u c a n c h o o s e t h e
c o l o r , t h e s i z e o f t h e p o i n t , t h e s t y l e o f t h e p o i n t .
void Paint_DrawPoint(UWORD Xpoint, UWORD Ypoint, UWORD Color, DOT_PIXEL Do
t_Pixel, DOT_STYLE Dot_Style)
Parameters:
Xpoint: indicates the X coordinate of a point
Ypoint: indicates the Y coordinate of a point
Color: fill Color
Dot_Pixel: The size of the dot, providing a default of eight size poin
ts
typedef enum {
} DOT_PIXEL;
Dot_Style: the size of a point that expands from the center of the poi
nt or from the bottom left corner of the point to the right and up
typedef enum {
} DOT_STYLE;
L i n e d r a w i n g : I n t h e i m a g e b u f f e r , l i n e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d , Y e n d ) , y o u c a n
c h o o s e t h e c o l o r , l i n e w i d t h , l i n e s t y l e .
void Paint_DrawLine(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UW
ORD Color, LINE_STYLE Line_Style ,
Parameters:
Xstart: the x-starting coordinate of a line
Ystart: indicates the Y starting point of a line
Xend: x-terminus of a line
Yend: the y-end coordinate of a line
Color: fill Color
Line_width: The width of the line, which provides a default of eig
ht widths
Line_Style: line style. Select whether the lines are joined in a s
traight or dashed way
D r a w a r e c t a n g l e : I n t h e i m a g e b u f f e r , d r a w a r e c t a n g l e f r o m ( X s t a r t , Y s t a r t ) t o ( X e n d ,
Y e n d ) , y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , a n d w h e t h e r t o f i l l t h e i n s i d e o f
t h e r e c t a n g l e .
void Paint_DrawRectangle(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yen
d, UWORD Color, DOT_PIXEL Line_width,
Parameters:
Xstart: the starting X coordinate of the rectangle
Ystart: indicates the Y starting point of the rectangle
Xend: X terminus of the rectangle
Yend: specifies the y-end coordinate of the rectangle
Color: fill Color
Line_width: The width of the four sides of a rectangle. Default ei
ght widths are provided
typedef enum {
} DOT_PIXEL;
Draw_Fill: Fill, whether to fill the inside of the rectangle
typedef enum {
} DRAW_FILL;
D r a w c i r c l e : I n t h e i m a g e b u f f e r , d r a w a c i r c l e o f R a d i u s w i t h ( X _ C e n t e r Y _ C e n t e r ) a s t h e
c e n t e r . Y o u c a n c h o o s e t h e c o l o r , t h e w i d t h o f t h e l i n e , a n d w h e t h e r t o f i l l t h e i n s i d e o f
t h e c i r c l e .
void Paint_DrawCircle(UWORD X_Center, UWORD Y_Center, UWORD Radius, UWORD
Color, DOT_PIXEL Line_width,
Parameters:
X_Center: the x-coordinate of the center of a circle
Y_Center: Y coordinate of the center of a circle
Radius: indicates the Radius of a circle
Color: fill Color
Line_width: The width of the arc, with a default of 8 widths
typedef enum {
} DOT_PIXEL;
Draw_Fill: fill, whether to fill the inside of the circle
typedef enum {
} DRAW_FILL;
W r i t e A s c i i c h a r a c t e r : I n t h e i m a g e b u f f e r , a t ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a n
A s c i i c h a r a c t e r , y o u c a n s e l e c t A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawChar(UWORD Xstart, UWORD Ystart, const char Ascii_Char, sFO
NT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
Ascii_Char: indicates the Ascii character
Font: Ascii visual character library, in the Fonts folder provides
the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e E n g l i s h s t r i n g : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f E n g l i s h c h a r a c t e r s , c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d
c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawString_EN(UWORD Xstart, UWORD Ystart, const char * pString,
sFONT* Font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: Ascii visual character library, in the Fonts folder provides
the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e C h i n e s e s t r i n g : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a
s t r i n g o f C h i n e s e c h a r a c t e r s , y o u c a n c h o o s e G B 2 3 1 2 e n c o d i n g c h a r a c t e r f o n t , f o n t
f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString,
cFONT* font, UWORD Color_Foreground,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PString: string, string is a pointer
Font: GB2312 encoding character Font library, in the Fonts folder
provides the following Fonts:
W r i t e n u m b e r s : I n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a s t r i n g
o f n u m b e r s , y o u c a n c h o o s e A s c i i v i s u a l c h a r a c t e r l i b r a r y , f o n t f o r e g r o u n d c o l o r , f o n t
b a c k g r o u n d c o l o r .
void Paint_DrawNum(UWORD Xpoint, UWORD Ypoint, double Nummber, sFONT* Fon
t, UWORD Digit, UWORD Color_Foreground,
Parameters:
Xpoint: the x-coordinate of the left vertex of a character
Ypoint: the Y coordinate of the left vertex of the font
Nummber: indicates the number displayed, which can be a decimal
Digit: It's a decimal number
Font: Ascii visual character library, in the Fonts folder provides
the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
W r i t e n u m b e r s w i t h d e c i m a l s : a t ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , w r i t e a s t r i n g o f
n u m b e r s w i t h d e c i m a l s , y o u c a n c h o o s e A s c i i c o d e v i s u a l c h a r a c t e r f o n t , f o n t f o r e g r o u n d
c o l o r , f o n t b a c k g r o u n d c o l o r
void Paint_DrawFloatNum(UWORD Xpoint, UWORD Ypoint, double Nummber, UBYTE
Decimal_Point, sFONT* Font, UWORD Color_Foreground, UWORD Color_Backgroun
d);
parameter:
Xstart: the X coordinate of the left vertex of the character
Ystart: Y coordinate of the left vertex of the font
Nummber: the displayed number, which is saved in double type here
Decimal_Point: Displays the number of digits after the decimal po
int
Font: Ascii code visual character font library, the following fon
ts are provided in the Fonts folder:
Color_Foreground: font color
Color_Background: background color
D i s p l a y t i m e : i n t h e i m a g e b u f f e r , u s e ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , d i s p l a y t i m e , y o u
c a n c h o o s e A s c i i v i s u a l c h a r a c t e r f o n t , f o n t f o r e g r o u n d c o l o r , f o n t b a c k g r o u n d c o l o r .
void Paint_DrawTime(UWORD Xstart, UWORD Ystart, PAINT_TIME *pTime, sFONT*
Font, UWORD Color_Background,
Parameters:
Xstart: the x-coordinate of the left vertex of a character
Ystart: the Y coordinate of the font's left vertex
PTime: display time, here defined a good time structure, as long a
s the hour, minute and second bits of data to the parameter;
Font: Ascii visual character library, in the Fonts folder provides
the following Fonts:
Color_Foreground: Font color
Color_Background: indicates the background color
D i s p l a y i m a g e : a t ( X s t a r t Y s t a r t ) a s t h e l e f t v e r t e x , d i s p l a y a n i m a g e w h o s e w i d t h i s
W _ I m a g e a n d h e i g h t i s H _ I m a g e ;
void Paint_DrawImage(const unsigned char *image, UWORD xStart, UWORD yStar
t, UWORD W_Image, UWORD H_Image)
parameter:
image: image address, pointing to the image information you want to
display
Xstart: the X coordinate of the left vertex of the character
Ystart: Y coordinate of the left vertex of the font
W_Image: Image width
H_Image: Image height
V i s i o n F i v e 2
A d a p t i v e M o d e l
0 . 9 6 i n c h L C D M o d u l e
1 . 1 4 i n c h L C D M o d u l e
1 . 2 8 i n c h L C D M o d u l e
1 . 3 i n c h L C D M o d u l e
1 . 5 4 i n c h L C D M o d u l e
1 . 8 i n c h L C D M o d u l e
2 i n c h L C D M o d u l e
2 . 4 i n c h L C D M o d u l e
H a r d w a r e C o n n e c t i o n
V i s i o n F i v e 2 P i n C o n n e c t i o n
L C D
V C C
G N D
D I N
C L K
C S
D C
R S T
B L
I n s t a l l C o r r e s p o n d i n g L i b r a r i e s
apt-get install pip
pip install VisionFive.gpio
apt-get install python3-numpy
apt-get install python3-pil
D e m o D o w n l o a d
apt-get install p7zip-full
wget https://www.waveshare.com/w/upload/e/e9/LCD_Module_code.7z
7z x LCD_Module_code.7z -o./LCD_Module_code
cd LCD_Module_code/VisionFive/python/example/
R u n t h e C o r r e s p o n d i n g D e m o A c c o r d i n g t o t h e S c r e e n Y o u
P u r c h a s e d
python3 0inch96_LCD_test.py
python3 1inch14_LCD_test.py
python3 1inch28_LCD_test.py
python3 1inch3_LCD_test.py
python3 1inch54_LCD_test.py
python3 1inch8_LCD_test.py
python3 2inch_LCD_test.py
python3 2inch4_LCD_test.py
R e s o u r c e
D o c u e m n t s
S c h e m a t i c
I L 9 3 4 1 D a t a s h e e t
S o f t w a r e
I m a g e 2 L c d
D e m o c o d e s
D e m o c o d e s
3 D D r a w i n g
2 . 4 i n c h L C D M o d u l e 3 D D r a w i n g
2 D D r a w i n g
2 . 4 i n c h L C D M o d u l e 2 D D r a w i n g
F A Q
' Q u e s t i o n : ' 1 . T h e L C D i s b l a n k w h e n u s i n g w i t h R a s p b e r r y P i ?
A n s w e r :
a ) M a k e s u r e t h a t y o u h a v e e n a b l e d t h e S P I i n t e r f a c e
b ) C h e c k t h e o u t p u t o f B L p i n , i f i t d o e s n ' t h a v e a n y v a l u e , p l e a s e t r y t o d i s c o n n e c t i t .
' Q u e s t i o n : ' 2 . H o w t o c h a n g e t h e d i s p l a y o r i e n t a t i o n
A n s w e r :
I f y o u u s e t h e C c o d e s , y o u c a n u s e P a i n t _ S e t R o t a t e ( R o t a t e ) f u n c t i o n t o s e t t h e d i s p l a y
o r i e n t a t i o n , o n l y 0 ° , 9 0 ° , 1 8 0 ° , a n d t h e 2 7 0 ° a r e a v a i l a b l e .
I f y o u u s e P y t h o n c o d e s , y o u c a n u s e t h e r o t a t e ( R o t a t e ) f u n c t i o n t o c h a n g e t h e o r i e n t a t i o n i n
a n y a n g l e .
' Q u e s t i o n : ' 3 . P y t h o n I m a g e l i b r a r i e s
A n s w e r :
I f y o u g e t l i b r a r i e s e r r o r w h e n r u n n i n g t h e p y t h o n e x a m p l e , p l e a s e t r y t o i n s t a l l t h e P I L
l i b r a r i e s b y c o m m a n d : s u d o a p t - g e t i n s t a l l p y t h o n - i m a g i n g
' Q u e s t i o n : ' 4 . W h y d o e s n ' t t h e s c r e e n d i s p l a y p r o p e r l y w h e n c o n n e c t e d t o a n
A r d u i n o ?
A n s w e r :
W h e n u s i n g a n A r d u i n o , p l e a s e m a k e s u r e i t i s p l u g g e d i n t o a 5 v p o w e r s u p p l y .
' Q u e s t i o n : '
5 . I n c o r r e c t u s e o f R a s p b e r r y P i c o n t r o l s m a y c a u s e ?
A n s w e r :
I f r u n n i n g t h e w i r i n g P i r o u t i n e i s n o r m a l , t h e n r u n n i n g p y t h o n o r B C M 2 8 3 5 m a y c a u s e t h e
s c r e e n t o f a i l t o r e f r e s h n o r m a l l y , b e c a u s e t h e b c m 2 8 3 5 l i b r a r y i s a l i b r a r y f u n c t i o n o f t h e
R a s p b e r r y P i c p u c h i p , a n d t h e b o t t o m l a y e r i s t o d i r e c t l y o p e r a t e t h e r e g i s t e r s , w h i l e t h e
b o t t o m l a y e r o f t h e w i r i n g P i l i b r a r y a n d p y t h o n a r e r e a d a n d w r i t t e n b y r e a d i n g a n d w r i t i n g .
T h e d e v i c e f i l e o f t h e l i n u x s y s t e m o p e r a t e s t h e d e v i c e , w h i c h m a y c a u s e t h e G P I O p o r t t o b e
a b n o r m a l . R e s t a r t i n g t h e R a s p b e r r y P i c a n s o l v e i t p e r f e c t l y .
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 .
( W h e n u s i n g 5 V p o w e r s u p p l y , t h e l o g i c v o l t a g e i s
（ ） （
H x 4 8 . 9 6
（ ） （ ）
H x 0 . 1 5 3 V
( P l e a s e c o n n e c t a c c o r d i n g t o t h e p i n d e f i n i t i o n t a b l e . T h e
L C D
V C C
G N D
D I N
C L K
C S
D C
R S T
B L
L C D
V C C
G N D
D I N
C L K
C S
D C
R S T
B L
：
uint8_t
uint16_t
uint32_t
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
typedef enum {
DOT_FILL_AROUND
DOT_FILL_RIGHTUP,
} DOT_STYLE;
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
typedef enum {
LINE_STYLE_SOLID = 0,
LINE_STYLE_DOTTED,
} LINE_STYLE;
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
typedef enum {
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
} DRAW_FILL;
DRAW_FILL Draw_Fill)
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
typedef enum {
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
} DRAW_FILL;
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font12CN: ASCII font 11*21, Chinese font 16*21
Font24CN: ASCII font24 *41, Chinese font 32*41
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
P I L o f f i c i a l l i b r a r y l i n k
uint8_t
uint16_t
uint32_t
= 1,
,
,
,
,
,
,
,
= 1,
= 1,
,
,
,
,
,
,
,
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
DRAW_FILL Draw_Fill)
= 1,
,
,
,
,
,
,
,
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
DOT_FILL_AROUND
DOT_FILL_RIGHTUP,
typedef enum {
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
} DOT_PIXEL;
typedef enum {
LINE_STYLE_SOLID = 0,
LINE_STYLE_DOTTED,
} LINE_STYLE;
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
DRAW_FILL Draw_Fill)
DOT_PIXEL_1X1
DOT_PIXEL_2X2
DOT_PIXEL_3X3
DOT_PIXEL_4X4
DOT_PIXEL_5X5
DOT_PIXEL_6X6
DOT_PIXEL_7X7
DOT_PIXEL_8X8
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font12CN: ASCII font 11*21, Chinese font 16*21
Font24CN: ASCII font24 *41, Chinese font 32*41
Color_Foreground: Font color
Color_Background: indicates the background color
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
Font8: 5*8 font
Font12: 7*12 font
Font16: 11*16 font
Font20: 14*20 font
Font24: 17*24 font
）
V m m
m m
R a s p b e r r y P i
B C M 2 8 3 5
3 . 3 V
G N D
M O S I
S C L K
C E 0
2 5
2 7
1 8
d e v e l o p e d b y o u r c o m p a n y a s a n
to enable SPI interface
= 1, // 1 x 1
,
,
,
,
,
,
,
= 1,
LINE_STYLE Line_Style)
= 1, // 1 x 1
,
,
,
,
,
,
,
DRAW_FILL Draw_Fill)
= 1,
,
,
,
,
,
,
,
= 1,
,
,
,
,
,
,
,
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Foreground)
, i t d o e s n o t n e e d t o w r i t e c o d e f r o m
h t t p : / / e f f b o t . o r g / i m a g i n g b o o k
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
LINE_STYLE Line_Style)
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
DRAW_FILL Draw_Fill)
= 1, // 1 x 1
,
,
,
,
,
,
,
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Foreground)
t h e p r o g r a m
= 1,
,
,
,
,
,
,
,
= 1,
LINE_STYLE Line_Style)
= 1,
,
,
,
,
,
,
,
DRAW_FILL Draw_Fill)
= 1,
,
,
,
,
,
,
,
= 1,
,
,
,
,
,
,
,
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Background)
UWORD Color_Foreground)
V i s i o n F i v e 2 B o a r d P i n N o .
3 . 3 V
G N D
1 9
2 3
2 4
2 2
1 3
1 2
2 . 4 i n c h L C D M o d u l e
2 4 0 x 3 2 0
S T M 3 2
3 . 3 V
G N D
P A 7
P A 5
P B 6
P A 8
P A 9
P C 7
U N O
5 V
G N D
D 1 1
D 1 3
D 1 0
D 7
D 8
D 9
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
p i l
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
, a n d t h e n u n z i p i t . T h e
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
// 1 x 1
// 2 X 2
// 3 X 3
// 4 X 4
// 5 X 5
// 6 X 6
// 7 X 7
// 8 X 8
B o a r d
3 . 3 V
G N D
1 9
2 3
2 4
2 2
1 3
1 2