1# Raspberry PI 3B 32 BSP (Board Support Package) Execution Instruction
2
3[中文页](README_zh.md) |
4
5## Introduction
6
7This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the Raspberry PI 3B 32 development board.
8
9[![raspi3_f](https://github.com/RT-Thread/rt-thread/raw/master/bsp/raspberry-pi/raspi3-32/figures/raspi3_f.jpg)](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/raspi3_f.jpg)
10
11[![raspi3_b](https://github.com/RT-Thread/rt-thread/raw/master/bsp/raspberry-pi/raspi3-32/figures/raspi3_b.jpg)](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/raspi3_b.jpg)
12
13## Hardware Features
14
15| Hardware       | Description                               |
16| -------------- | ----------------------------------------- |
17| CPU            | quad-core ARM Cortex A53(ARMv8)           |
18| Main Frequency | 1.2 GHz                                   |
19| GPU            | VideoCore IV                              |
20| GPU Frequency  | 400MHz                                    |
21| Memory         | 1GB (0x0000000 - 0x40000000)              |
22|                | 0x3f000000 - 0x40000000 is for peripheral |
23
24**The description of functional pins is as shown as follow:**
25
26[![GPIO-Pinout-Diagram-2](https://github.com/RT-Thread/rt-thread/raw/master/bsp/raspberry-pi/raspi3-32/figures/GPIO-Pinout-Diagram-2.png)](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/GPIO-Pinout-Diagram-2.png)
27
28## **Compilation Instruction**
29
30The [env](https://www.rt-thread.io/download.html?download=Env) tool is recommended for compiling in Windows environments.
31
32The cross-compiler gcc-arm-none-eabi-4_8-2014q1_linux is recommended in Linux environment. If you don’t have compiling tool, please uncompress the downloaded package like this:
33
34```
35tar vxf gcc-arm-none-eabi-4_8-2014q1_linux.tar.bz2
36```
37
38In Linux environment, you need to modify the settings of the compiler directory, and modify the actual directory of the compiling tool in bsp/raspi3-32/rtconfig. py, remember to add the suffix /bin here.
39
40```
41EXEC_PATH = r'/opt/gcc-arm-none-eabi-4_8-2014q1_gri/bin'
42```
43
44Enter the rt-thread/bsp/raspi3-32 directory and run the following command to compile this BSP:
45
46```
47scons
48```
49
50If everything goes well, a new 'rtthread.elf' and 'kernel7.img' file will be generated. ‘kernel7.img' is what we need to put into the root directory of the Raspberry PI 3B SD card.
51
52###  **Eclipse compiling environment**
53
54- Step 1: Install the eclipse plugin 'cdt'.
55- Step 2: Open eclipse cdt and set workspace, and set the workspace to 'rt-thread/bsp/raspberry-pi/raspi3-32'.
56- Step 3: Import the project by selecting 'General->Existing Projects into Workspace' and then 'Browse ...'. Noted that the compiling only supports scons now.
57
58
59## **Running**
60
61### **Prepare the [Raspbian](https://downloads.raspberrypi.org/raspbian_lite_latest) SD card**
62
63Download the raspbian image, for example, "2018-06-27-raspbian-stretch-lite.zip". Unpack it.
64
65**Burn the SD card on Windows**
66
67On Windows, download the burning tool " [etcher.io](https://www.balena.io/etcher/) ", run it and choose the unpacked image "2018-06-27-raspbian-stretch-lite.img".
68
69When the burning process is completed, put "kernel8.img" into the boot partition to replace the file wit the same name.
70
71**Burn the SD card on Linux**
72
73Prepare an empty SD card, plug it in the computer and then execute the command below:
74
75"sudo dd if=2018-06-27-raspbian-stretch-lite.img of=/dev/xxx bs=32M conv=fsync"
76
77Note that the device file "/dev/xxx" should be replaced with the real SD card.
78
79### **Prepare the serial port wire**
80
81The BSP uses GPIO 14 & GPIO 15 of raspi 3 as the communication ports, as shown in the following image:
82
83
84
85[![raspberrypi-console](https://github.com/RT-Thread/rt-thread/raw/master/bsp/raspberry-pi/raspi3-32/figures/raspberrypi-console.png)](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/raspberrypi-console.png)
86
87The serial port parameters: 115200 8N1, hardware and software flow control is off.
88
89## **Running Result**
90
91Insert the burned SD card into Raspberry Pi, power up, the output information on the serial port should be like this:
92
93```
94heap: 0x0005d784 - 0x0045d784
95
96 \ | /
97- RT -     Thread Operating System
98 / | \     4.0.2 build Jan  9 2020
99 2006 - 2019 Copyright by rt-thread team
100[I/I2C] I2C bus [i2c0] registered
101[I/I2C] I2C bus [i2c1] registered
102[I/SDIO] SD card capacity 15558144 KB.
103found part[0], begin: 1048576, size: 63.0MB
104found part[1], begin: 67108864, size: 14.793GB
105file system initialization done!
106boot cpu:3
107msh />cpu = 0x00000003
108cpu 3 startup.
109start OK: CPU 3
110boot cpu:2
111cpu = 0x00000002
112cpu 2 startup.
113start OK: CPU 2
114boot cpu:1
115cpu = 0x00000001
116cpu 1 startup.
117start OK: CPU 1
118Hello RT-Thread!
119
120msh />
121```
122
123## **Peripheral Condition**
124
125| Drive          | Support | Remark |
126| -------------- | ------- | ------ |
127| UART           | Support | UART0  |
128| GPIO           | Support |     -   |
129| IIC            | Support |    -    |
130| SPI            | Support |   -     |
131| CPU Timer      | Support |     -   |
132| SD card driver | Support |    -    |
133| RTC | Support | - |
134| WDT | Support | - |
135| MAILBOX | Support | - |
136| SMP | Support | - |
137| FRAMEBUFFER | Support | HDMI |
138