StarFive VisionFive 2 User manual

VisionFive240-PinGPIOHeaderUser
Guide



StarFive

LegalStatements

PROPRIETARYNOTICE















ContactUs




StarFive

Preface

Aboutthisdocument

•
•
•
RevisionHistory
Table0-1RevisionHistory
Version Released Revision
  
   (on page 11)
Notesandnoces

•Tip:

•Note:

•Important:

•CAUTION:

•Warning:


StarFive

Contents

 
 
 
1.Overview............................................................................................................................................................................. 8
 
2.GPIOPinout ...................................................................................................................................................................... 9
3.Preparaon........................................................................................................................................................................ 10
 
 

 
 
 
4.GPIOOperaons................................................................................................................................................................ 15

5.I2COperaons................................................................................................................................................................... 16
 
 
 

6.SPIOperaons................................................................................................................................................................... 20

 



7.PWMOperaons............................................................................................................................................................... 25
 

 

8.UARTOperaons............................................................................................................................................................... 27

 
 
 
 
9.PeripheralExamples...........................................................................................................................................................33

 
 
  
 


StarFive


 
 
 


StarFive


ListofTables



 
 
  
 
 

 


StarFive


ListofFigures

 













 
 
 
 
 

 



 


 

 


StarFive

1.Overview


•
• (on page
15) (on page 16) (on page 20) (on page 25)
 (on page 27) 
• (on page 33) 
1.1.40-PinHeaderDenion

Figure1-140-PinDenion
1
3
5
7
9
11
17
19
23
27
31
35
13
15
21
25
29
33
37
39
2
4
6
8
10
12
18
20
24
28
32
36
14
16
22
26
30
34
38
40
5VPower
5VPower
GND
GPIO5(UARTTX)
GPIO6(UARTRX)
GPIO38
GPIO51
GND
GPIO49(SPICE0)
GPIO40
GPIO46(PWM0)
GPIO36
GND
GPIO54
GPIO50
GPIO56
GND
GND
GPIO61
GPIO44
3.3VPower
GPIO58(I2CSDA)
GPIO57(I2CSCL)
GPIO55
GND
GPIO42
3.3VPower
GPIO52(SPIMOSI)
GPIO48(SPISCLK)
GPIO45
GPIO39
GPIO63
GPIO43
GPIO47
GPIO53(SPIMISO)
GND
GPIO37
GPIO59(PWM1)
GPIO60
GND
 


StarFive

2.GPIOPinout

Table2-1GPIOAssignments
Sys dts GPIONum PinName PinNum PinNum PinName GPIONum dts Sys
     
   

   
   

   
    

  
    

  
       
      
       
      
   

   
   

    
   

  

  
      
       
      
     

 
  

   
       
       
      
Note:
•dts jh7110-visionfive-v2.dtsi

•Sys /sys/class/gpio



StarFive

3.Preparaon

3.1.PreparingHardware


Table3-1HardwarePreparaon
Type M/O*Item Notes
   
  •
•
•
•
•
•
•


   

  •
•

  •
•

   


  •
•

  •
•







 


StarFive


3.2.PreparingSoware


3.2.1.GitHubRepository

Note:

Table3-2GitHubRepositoryAddresses
Type Repository Branch
  
 •
•
•

  
  
  
3.2.2.FlashingDebianOStoaMicro-SDCard

Flashing OS to a Micro-SD Card VisionFive 2 Single Board Computer Quick Start
Guide
3.2.3.GenerangDTB


make <Configuration_File> ARCH=riscv CROSS_COMPILE=riscv64-linux-gnu-
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv dtbs
Tip:
crossbuild-essenal-riscv64
sudo apt-get install crossbuild-essential-riscv64
Tip:
<Conguraon_File>starfive_jh7110_defconfigstarfive_visionfive2_defconfig

make starfive_jh7110_defconfig ARCH=riscv CROSS_COMPILE=riscv64-linux-gnu-
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv dtbs

 


StarFive


•jh7110-visionfive-v2.dtb
•jh7110-visionfive-v2-ac108.dtb
•jh7110-visionfive-v2-wm8960.dtb
Tip:

3.2.4.ReplacingDTB

Figure3-1IdenedDirectories
/dev/sdb3 30G 21G 8.1G 73% /media/<UserName>/root
3.2.4.1.Method1:DirectlyReplacingDTBFile

Note:
•<DTB_File>

◦jh7110-visionfive-v2.dtb
◦jh7110-visionfive-v2-ac108.dtb
◦jh7110-visionfive-v2-wm8960.dtb
Tip:

•<Mount_Directory>/media/<UserName>
•<Kernel_Version>5.15.0-starfive
ExampleCommand:
sudo cp arch/riscv/boot/dts/starfive/jh7110-visionfive-v2.dtb
/media/<UserName>/root/usr/lib/linux-image-5.15.0-starfive/starfive/
3.2.4.2.Method2:AddingStartupItem

 
sudo cp arch/riscv/boot/dts/starfive/<DTB_File> <Mount_Direcotry>/
root/usr/lib/linux-image-<Kernel_Version>/starfive/
Tip:
◦<DTB_File>

▪jh7110-visionfive-v2.dtb
▪jh7110-visionfive-v2-ac108.dtb
▪jh7110-visionfive-v2-wm8960.dtb
 


StarFive


Tip:

◦<Mount_Directory>/media/<UserName>
◦<Kernel_Version>5.15.0-starfive
ExampleCommand:
sudo cp
arch/riscv/boot/dts/starfive/jh7100-starfive-visionfive-v2.dtb /
media/<UserName>/root/usr/lib/linux-image-5.15.0-starfive/starfive/
 
cd <Mount_Direcotry>/__boot
Tip:
<Mount_Directory> /media/UserName
 extlinux.conf
sudo gedit extlinux.conf
 
slabel l1
menu label Debian GNU/Linux bookworm/sid 5.15.0-starfive (customized)
linux /boot/vmlinuz-<Kernel_Version>
initrd /boot/initrd.img-<Kernel_Version>
fdt /usr/lib/linux-image-<Kernel_Version>/starfive/<DTB_File>
append root=/dev/mmcblk1p3 rw console=tty0 console=ttyS0,115200 earlycon rootwait
stmmaceth=chain_mode:1 selinux=0
label l1r
menu label Debian GNU/Linux bookworm/sid 5.15.0-starfive (customized)(rescue target)
linux /boot/vmlinuz-<Kernel_Version>
initrd /boot/initrd.img-<Kernel_Version>
fdt /usr/lib/linux-image-<Kernel_Version>/starfive/uart_test.dtb
append root=/dev/mmcblk1p3 rw console=tty0 console=ttyS0,115200 earlycon rootwait
stmmaceth=chain_mode:1 selinux=0 single
Tip:
◦<DTB_File>

▪jh7110-visionfive-v2.dtb
▪jh7110-visionfive-v2-ac108.dtb
▪jh7110-visionfive-v2-wm8960.dtb
Tip:

◦<Kernel_Version>5.15.0-starfive
◦Debian GNU/Linux bookworm/sid 5.15.0-starfive (customized)

 


StarFive


 DebianGNU/Linux
bookworm/sid5.15.0-starve(customized)
Tip:

 


StarFive

4.GPIOOperaons

4.1.ConguringGPIO
 

cd /sys/class/gpio
echo 44 > export
 
cd gpio44
Note:
44 (on page 9)
 
echo in > direction
 
echo out > direction
 
echo 1 > value
Tip:

 
echo 0 > value
Tip:

 3.3VPower
cat value
 GND
cat value
 


StarFive

5.I2COperaons

5.1.ConguringI2CGPIO

• (on page 16)
• (on page 17)
5.1.1.HardwareSetup

Table5-1ConnectSenseHat(B)tothe40-PinHeader
40-PinGPIOHeader
SenseHAT(B)
PinNumber PinName
  
  
  
  
Figure5-1ConnectSenseHat(B)tothe40-PinGPIOHeader
1
3
5
7
9
11
13
15
2
4
6
8
10
12
14
16
5VPower
5VPower
GND
GPIO5(UARTTX)
GPIO6(UARTRX)
GPIO38
GND
GPIO21
3.3VPower
GPIO58(I2CSDA)
GPIO57(I2CSCL)
GPIO55
GND
GPIO42
GPIO43
GPIO20
3V3
SDA
SCL
GND
SenseHat(B)
 


StarFive


5.1.2.ConguringdtsFile

jh7110-visionfive-v2.dtsi/linux/arch/riscv/boot/dts/starfive

Figure5-2ExampleFileContent
Note:
PinName
 (on page 9) 
•
•
5.2.DebuggingI2CGPIO

 
i2cdetect -l
Result:
Figure5-3ExampleOutput
 
i2cdetect -y -r 0
 


StarFive


Tip:

Result:
Figure5-4ExampleOutput
0x290x480x5c0x680x70
 
i2cget -f -y 0 0x5c 0x0f
Tip:
◦0
◦0x5c
◦0x0f
Result:
Figure5-5ExampleOutput
0xb1
 
i2cset -y 0 0x5c 0x11 0x10
Tip:
◦0
◦0x5c
◦0x11
◦0x10
 
i2cdump -y 0 0x5c
 


StarFive


Tip:
◦0
◦0x5c
Result:
Figure5-6ExampleOutput
 


StarFive

6.SPIOperaons

6.1.ConguringSPIGPIO
jh7110-visionfive-v2.dtsi/linux/arch/riscv/boot/dts/starfive

6.1.1.ModifyPins

 (on page 9) 
jh7110-visionfive-v2.dtsi
Figure6-1ModifyPins
6.2.DebuggingSPIGPIO

 


StarFive