Waveshare VisionFive2 Manual

V i s i o n F i v e 2
O v e r v i e w
O n b o a r d R V 6 4 G C I S A Q u a d - c o r e 6 4 - b i t S o C , o p e r a t i n g
f r e q u e n c y u p t o 1 . 5 G H z , V i s i o n F i v e 2 s u p p o r t s O p e n C L 3 . 0 ,
O p e n G L E S 3 . 2 , a n d V u l k a n 1 . 2 . I t i s a v a i l a b l e i n 4 G B / 8 G B
L P D D R 4 R A M o p t i o n s a n d a n o p t i o n a l w i r e l e s s m o d u l e . A l s o , i t
h a s m u l t i p l e o n b o a r d i n t e r f a c e s , i n c l u d i n g M . 2 / C S I / D S I /
H D M I / e M M C / U S B 3 . 0 / 4 0 P I N G P I O / R J 4 5 G i g a b i t E t h e r n e t
p o r t / T F c a r d s l o t , e t c . S u p p o r t s 4 K @ 6 0 f p s a n d H 2 6 4 / H 2 6 5
m u l t i - s t r e a m v i d e o d e c o d i n g , 1 0 8 0 p @ 3 0 f p s a n d H 2 6 5 m u l t i -
s t r e a m v i d e o e n c o d i n g . O n b o a r d 4 0 P I N G P I O h e a d e r ,
V i s i o n F i v e 2 i s c o m p a t i b l e w i t h R a s p b e r r y P i s e r i e s b o a r d s .
P r o v i d e s w i d e s o f t w a r e c o m p a t i b i l i t y i n c l u d i n g s u p p o r t f o r D e b i a n .
P a r a m e t e r s
P r o c e s s o r
C P U
G P U
M e m o r y
S t o r a g e
C a m e r a
D i s p l a y P o r t
U S B H o s t
U S B D e v i c e
N e t w o r k i n g
O t h e r s
P o w e r S u p p l y
D i m e n s i o n s
R e c o m m e n d e d
O p e r a t i n g A m b i e n t
T e m p e r a t u r e
U s e r G u i d e
A s t h e D e b i a n i m a g e i s l a r g e , i t i s r e c o m m e n d e d t o u s e a T F c a r d o f 3 2 G B o r a b o v e .
U p d a t e O n b o a r d F l a s h F i r m w a r e
T h i s m e t h o d i s c u r r e n t l y o n l y a p p l i c a b l e t o i m a g e s v 2 . 5 . 0 - 6 9 a n d e a r l i e r . I f y o u n e e d t h e
l a t e s t v e r s i o n , p l e a s e r e f e r t o t h e o f f i c i a l d o c u m e n t a t i o n t o c o m p i l e t h e l a t e s t S D K s y s t e m .
Y o u c a n a l s o d o w n l o a d t h e o f f i c i a l l y c o m p i l e d f i l e s o n G i t H u b :
h t t p s : / / g i t h u b . c o m / s t a r f i v e - t e c h / V i s i o n F i v e 2 / r e l e a s e s
u-boot-spl.bin.normal.out
visionfive2_fw_payload.img
h t t p s : / / g i t h u b . c o m / s t a r f i v e - t e c h / T o o l s / t r e e / m a s t e r / r e c o v e r y
restore binaries: jh7110-recovery-xxxxxxxx.bin
I f t h e c o n t e n t i n t h e f l a s h o n y o u r b o a r d i s d a m a g e d o r y o u w a n t t o u p d a t e , p l e a s e u s e t h e
f o l l o w i n g m e t h o d .
B u r n t h e i m a g e s d c a r d . i m g , t u r n t h e D I P s w i t c h t o t h e p o s i t i o n s h o w n i n t h e p i c t u r e .
C o n n e c t t h e U S B t o t h e s e r i a l p o r t m o d u l e , c o n n e c t t o t h e p o w e r s u p p l y a n d s t a r t u p
n o r m a l l y .
A c c o u n t : r o o t
P a s s w o r d : s t a r f i v e
E n t e r i f c o n f i g t o g e t t h e I P a d d r e s s . N o t e h e r e t h a t o n l y t h e n e t w o r k p o r t c l o s e t o t h e
H D M I i n t e r f a c e c a n b e u s e d .
U s e M o b a X t e r m t o c o n n e c t t o t h e c o r r e s p o n d i n g I P w i t h s s h .
D o w n l o a d t h e c o r r e s p o n d i n g
s y s t e m .
U s e t h e c o m m a n d c a t / p r o c / m t d t o v i e w t h e M T D p a r t i t i o n .
I n p u t t h e c o m m a n d .
U p d a t e S P L e x a m p l e c o m m a n d s .
flashcp -v u-boot-spl.bin.normal.out /dev/mtd0
U p d a t e U - b o o t e x a m p l e c o m m a n d s :
flashcp -v visionfive2_fw_payload.img /dev/mtd1
T u r n o f f t h e p o w e r , a n d t u r n t h e s w i t c h t o t h e c o r r e s p o n d i n g p o s i t i o n .
U s e t h e x m o d e m p r o t o c o l t o u p d a t e t h r o u g h t h e s e r i a l p o r t a n d t r a n s f e r t h e f i l e j h 7 1 1 0 -
r e c o v e r y - 2 0 2 2 1 2 0 5 . b i n .
T u r n o f f t h e p o w e r a n d f o l l o w t h e n o r m a l s t a r t u p p r o c e s s t o s t a r t t h e D e b i a n s y s t e m .
I f y o u t h i n k t h e a b o v e i s t r o u b l e s o m e , y o u c a n u s e t h e s e r i a l p o r t t o t r a n s f e r a l l f i l e s u s i n g
t h e x m o d e m p r o t o c o l , b u t t h e s p e e d i s r e l a t i v e l y s l o w a n d t h e e r r o r r a t e i s h i g h .
T r a n s f e r t h e f i l e j h 7 1 1 0 - r e c o v e r y - 2 0 2 2 1 2 0 5 . b i n , p r e s s 0 a n d p r e s s E n t e r t o t r a n s f e r t h e f i l e
u - b o o t - s p l . b i n . n o r m a l . o u t ; p r e s s 2 a n d p r e s s E n t e r t o t r a n s f e r t h e f i l e
v i s i o n f i v e 2 _ f w _ p a y l o a d . i m g .
I n s t a l l D e b i a n S y s t e m
D o w n l o a d , o p e n S D F o r m a t t e r
D o w n l o a d , o p e n W i n 3 2 D i s k I m a g e r . z i p
c l i c k " w r i t e " .
B o o t i n g
T u r n t h e t w o D I P s w i t c h e s o n t h e b o a r d t o t h e r i g h t ( O N ) p o s i t i o n .
I n s e r t t h e T F c a r d t h a t b u r n e d t h e i m a g e , c o n n e c t t h e
t h e f i g u r e , c o n n e c t i t t o t h e P C , a n d c h e c k t h e p o r t .
O p e n M o b a X t e r m a n d o p e r a t e a s s h o w n b e l o w :
C o n n e c t t h e n e t w o r k c a b l e a n d p o w e r s u p p l y , t r y t o p r i n t t h e U - b o o t t o t h e p o s i t i o n s h o w n
i n t h e p i c t u r e , a n d p r e s s a n y k e y t o s w i t c h t o t h e d e v i c e t r e e .
E n t e r t h e f o l l o w i n g c o m m a n d ( t o b e e n t e r e d l i n e b y l i n e ) :
ext4load mmc 1:3 a0000000 /boot/uEnv.txt
env import a0000000 17c
setenv fdtfile starfive/jh7110-visionfive-v2.dtb
sysboot mmc 1:3 ext2 b0000000 /boot/extlinux/extlinux.conf
W a i t a f e w s e c o n d s a n d i t w i l l a u t o m a t i c a l l y e n t e r t h e s y s t e m ( i f y o u h a v e s e l e c t e d i t
b e f o r e , y o u m u s t s e l e c t i t b e f o r e e n t e r i n g t h e s y s t e m ) .
E n t e r t h e c o r r e s p o n d i n g a c c o u n t a n d p a s s w o r d :
U s e r n a m e : r o o t
P a s s w o r d : s t a r f i v e
E x t e n d e d f i l e s y s t e m e n s u r e s t h a t a l l s t o r a g e o n t h e m e m o r y
c a r d i s a v a i l a b l e
Q u e r y m e m o r y s p a c e : d f - h .
E n t e r t h e c o m m a n d s : f d i s k / d e v / m m c b l k 1 .
I n p u t a c c o r d i n g t o t h e c o n t e n t s h o w n i n t h e p i c t u r e , a n d p r e s s E n t e r d i r e c t l y a t p o s i t i o n s 5
a n d 6 .
E n t e r t h e c o m m a n d : r e s i z e 2 f s / d e v / m m c b l k 1 p 3 .
T h e n u s e d f - h t o v i e w t h e s i z e o f t h e s p a c e .
C h e c k I P
T h e n e t - t o o l s t o o l b o x i s n o t i n s t a l l e d o n t h e D e b i a n s y s t e m , s o i t n e e d s t o b e i n s t a l l e d
m a n u a l l y .
U s e c o m m a n d :
apt-get install net-tools
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 u s e t h e c o m m a n d i f c o n f i g t o v i e w t h e I P o f t h e
c o r r e s p o n d i n g n e t w o r k p o r t .
C o n n e c t T o S S H
T h e D e b i a n s y s t e m o f V i s i o n F i v e 2 d o e s n o t s u p p o r t t h e r o o t u s e r t o u s e a n s s h c o n n e c t i o n ,
s o i t n e e d s t o b e s e t a c c o r d i n g t o t h e f o l l o w i n g c o n f i g u r a t i o n .
E d i t t h e s s h c o n f i g u r a t i o n f i l e .
nano /etc/ssh/sshd_config
A d d t h e f o l l o w i n g t w o s e n t e n c e s a t t h e e n d o f t h e f i l e :
PasswordAuthentication yes
PermitRootLogin yes
S a v e , e x i t , a n d r e s t a r t t h e s s h s e r v i c e .
s e r v i c e s s h d r e s t a r t o r s y s t e m c t l r e s t a r t s s h d . s e r v i c e u s e M o b a X t e r m s o f t w a r e t o s s h
c o n n e c t i o n t o V i s i o n F i v e 2 , i f t h e c o n n e c t i o n f a i l s , r e s t a r t V i s i o n F i v e 2 .
H o w T o U s e W i t h O t h e r P r o d u c t s
W M 8 9 6 0
T r y p r i n t i n g t o t h e p o s i t i o n s h o w n i n t h e p i c t u r e i n U - b o o t , a n d p r e s s a n y k e y t o s w i t c h t o
t h e d e v i c e t r e e .
R e p l a c e t h e c o m m a n d a t s t a r t u p w i t h t h e f o l l o w i n g :
ext4load mmc 1:3 a0000000 /boot/uEnv.txt
env import a0000000 17c
setenv fdtfile starfive/jh7110-visionfive-v2-wm8960.dtb
sysboot mmc 1:3 ext2 b0000000 /boot/extlinux/extlinux.conf
I n s t a l l a l s a - u t i l s
apt install alsa-utils
I f t h e m o d u l e i s n o t c o n n e c t e d a t t h e b e g i n n i n g , y o u n e e d t o r e s t a r t V i s i o n F i v e 2 t o d e t e c t
t h e a u d i o d e v i c e .
T y p e a p l a y - l t o l i s t s o u n d c a r d s a n d d i g i t a l a u d i o d e v i c e s .
P a y a t t e n t i o n t o t h e p o s i t i o n m a r k e d o n t h e p i c t u r e , w h i c h i n d i c a t e s t h e d e v i c e n u m b e r o f
t h e s o u n d c a r d a n d d i g i t a l a u d i o e q u i p m e n t , w h e r e c a r d 0 a n d d e v i c e 0 a r e t h e h e a d p h o n e
j a c k s o n t h e V i s i o n F i v e 2 m o t h e r b o a r d , c a r d 0 a n d d e v i c e 2 a r e t h e h e a d p h o n e j a c k s o n t h e
W M 8 9 6 0 m o d u l e .
T y p e a r e c o r d - l t o l i s t s o u n d c a r d s a n d r e c o r d i n g d e v i c e s .
P a y a t t e n t i o n t o t h e p o s i t i o n m a r k e d o n t h e p i c t u r e , w h i c h i n d i c a t e s t h e d e v i c e n u m b e r o f
t h e s o u n d c a r d a n d r e c o r d i n g d e v i c e , c a r d 0 a n d d e v i c e 1 a r e t h e t w o p a t c h m i c r o p h o n e s o n
t h e W M 8 9 6 0 m o d u l e .
E n t e r t h e c o m m a n d :
arecord -Dhw:0,1 -f S32_LE -r16000 -c2 -d 10 -t wav sound_32b_16k.wav
S t a r t r e c o r d i n g 1 0 s e c o n d s o f 3 2 - b i t , 1 6 k H z a u d i o , a n d s a v e i t i n t h e c u r r e n t d i r e c t o r y , t h e
f i l e n a m e i s s o u n d _ 3 2 b _ 1 6 k . w a v .
i n p u t t h e c o m m a n d :
aplay -Dhw:0,2 -f S32_LE -r16000 -t wav sound_32b_16k.wav
U s e t h e W M 8 9 6 0 m o d u l e o n b o a r d h e a d p h o n e i n t e r f a c e t o p l a y a u d i o .
N o t e t h a t t h e h e a d p h o n e j a c k o n t h e V i s i o n F i v e 2 m o t h e r b o a r d o n l y s u p p o r t s a u d i o o u t p u t
i n 1 6 - b i t a u d i o f o r m a t .
L C D
C o m p a t i b l 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 o u t d e f i n i 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 t h e c o r r e s p o n d i n g l i b r a r y f i l e :
apt-get install pip
pip install VisionFive.gpio
apt-get install python3-numpy
apt-get install python3-pil
D o w n l o a d t h e d e m o :
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 y o u r L C 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
S e n s e H A T ( B )
I n s t a l l t h e c o r r e s p o n d i n g l i b r a r i e s f i l e .
apt-get install pip
pip install VisionFive.gpio
apt-get install python3-numpy
apt-get install python3-pil
apt-get python3-smbus
D o w n l o a d t h e p r o g r a m .
apt-get install p7zip-full
wget https://www.waveshare.com/w/upload/6/6c/Sense-HAT-B-Demo.7z
7z x Sense-HAT-B-Demo.7z -O./Sense-HAT-B-Demo
cd Sense-HAT-B-Demo
L P S 2 2 H B T R E x a m p l e P r o g r a m - B a r o m e t r i c P r e s s u r e S e n s o r D e m o n s t r a t i o n .
cd LPS22HB/VisionFive2
python3 LPS22HB.py
S H T C 3 S a m p l e P r o g r a m - T e m p e r a t u r e a n d H u m i d i t y S e n s o r D e m o n s t r a t i o n .
cd SHTC3/VisionFive2
python3 SHTC3.py
A D S 1 0 1 5 S a m p l e P r o g r a m - A D c o n v e r s i o n d e m o .
cd ADS1015/VisionFive2
python3 AD.py
I C M 2 0 9 4 8 S a m p l e P r o g r a m - 9 - A x i s S e n s o r D e m o n s t r a t i o n .
cd ICM-20948/VisionFive2
python3 ICM20948.py
T C S 3 4 7 2 5 S a m p l e P r o g r a m - C o l o r R e c o g n i t i o n S e n s o r D e m o n s t r a t i o n
I n s t a l l t h e p y g a m e l i b r a r y .
apt-get install pygame
R u n t h e d e m o .
cd TCS34725/VisionFive2
python3 main.py
R e s o u r c e s
O f f i c i a l R e s o u r c e / F o r u m A d d r e s s
R e s o u r c e s
F o r u m
S D K
G i t h u b
D e b i a n I m a g e
O f f i c i a l n e w e s t i m a g e
D e v e l o p m e n t S o f t w a r e
W i n 3 2 D i s k I m a g e r . z i p
S D F o r m a t t e r
M o b a X t e r m P o r t a b l e v 2 2 . 0 . z i p
F A Q
Q u e s t i o n : i m a g e 6 9 T h e s y s t e m c a n n o t s t a r t ?
A n s w e r :
T h e r e i s a l i t t l e p r o b l e m w i t h t h e s y s t e m s t a r t u p d i r e c t o r y .
S o l u t i o n :
E n t e r t h e f o l l o w i n g d o c u m e n t , f o l l o w t h e 4 . 4 s e c t i o n , a n d r e s t o r e t h e B o o t l o a d e r
o p e r a t i o n t o o p e r a t e .
h t t p s : / / d o c . r v s p a c e . o r g / V i s i o n F i v e 2 / P D F / V i s i o n F i v e 2 _ Q S G . p d f
Q u e s t i o n : O b v i o u s l y p u r c h a s e d 8 G m e m o r y , b u t o n l y 4 G m e m o r y i s c h e c k e d b y
u s i n g t h e c o m m a n d ?
A n s w e r :
T h e d e b i a n s y s t e m v e r s i o n i s t o o o l d , F l a s h f i r m w a r e v e r s i o n i s t o o o l d .
S o l u t i o n :
D o w n l o a d t h e l a t e s t D e b i a n i m a g e .
J u s t f o l l o w # U p d a t e O n b o a r d F l a s h F i r m w a r e
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 t a r F i v e J H 7 1 1 0
R I S C - V U 7 4 Q u a d - c o r e 6 4 - b i t V 6 4 G C I S A S o C @ 1 . 5 G H z
I M G B X E - 4 - 3 2
4 G / 8 G B y t e L P D D R 4
T F c a r d / e M M C
M I P I C S I 2 l a n e × 1
H D M I 2 . 0 × 1 ( 4 K @ 3 0 f p s o r 2 K @ 6 0 f p s ) ;
2 - l a n e M I P I D S I × 1 ( 1 0 8 0 p @ 3 0 f p s ) ;
4 - l a n e M I P I D S I × 1 ( 2 K @ 3 0 f p s ) ;
O n l y o n e D S I p o r t c a n b e u s e d f o r d i s p l a y a t t h e s a m e t i m e .
U S B T y p e - A 3 . 0 × 4
U S B D e v i c e × 1 ; m u l t i p l e x e d w i t h t h e U S B T y p e - C p o r t
1 × G i g a b i t E t h e r n e t p o r t ( m a i n E t h e r n e t p o r t ) ( n e a r t h e e d g e o f t h e
b o a r d ) ;
1 × 1 0 0 / 1 0 M E t h e r n e t p o r t
4 0 P I N × 1 ;
M . 2 M - K e y S S D s l o t ;
2 P i n f a n h e a d e r ;
3 . 5 m m A u d i o J a c k
S u p p o r t s Q u i c k C h a r g e i n p u t 5 V D C ( m i n i m u m 3 A ) ( u p t o 3 0 W )
S u p p o r t s 5 ~ 2 0 V f i x e d v o l t a g e i n p u t
S u p p o r t s U S B T y p e - C P D 2 . 0 , 9 V / 2 A , 1 2 V / 2 A , 1 5 V / 2 A , 2 0 V / 2 A
S u p p o r t s Q C 3 . 0 / 2 . 0 a d a p t e r , 9 V / 2 A , 1 2 V / 1 . 5 A
1 0 0 × 7 4 × 2 1 m m
℃
0 ~ 5 0 ( I f t h e o p e r a t i n g t e m p e r a t u r e o f t h e c h i p e x c e e d s 8 5 ° C , t h e
f r e q u e n c y a n d v o l t a g e o f t h e C P U w i l l b e a u t o m a t i c a l l y r e d u c e d f o r
c o o l i n g . )
u p d a t e p a c k a g e
, a n d f o r m a t t h e c o r r e s p o n d i n g T F c a r d .
, c h o o s e t h e c o r r e s p o n d i n g i m a g e a n d d i s k , a n d
a n d d r a g t h e c o r r e s p o n d i n g f i l e i n t o t h e
U S B t o T T L m o d u l e
V i s i o n F i v e 2 B o a r d P i n
3 . 3 V
G N D
1 9
2 3
2 4
2 2
1 3
1 2
.
V i s i o n F i v e 2
M G B X E - 4 - 3 2
C P U : R I S C - V U 7 4 q u a d - c o r e 6 4 - b i t
V 6 4 G C I S A S o C
M e m o r y : 4 G / 8 G B y t e L P D D R 4
S t o r a g e : E x t e r n a l S D c a r d / e M M C
a c c o r d i n g t o