138 lines
5.2 KiB
Markdown
138 lines
5.2 KiB
Markdown
# Raspberry PI 3B 32 BSP (Board Support Package) Execution Instruction
|
||
|
||
[中文页](README_zh.md) |
|
||
|
||
## Introduction
|
||
|
||
This 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.
|
||
|
||
[](https://github.com/RT-Thread/rt-thread/blob/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_b.jpg)
|
||
|
||
## Hardware Features
|
||
|
||
| Hardware | Description |
|
||
| -------------- | ----------------------------------------- |
|
||
| CPU | quad-core ARM Cortex A53(ARMv8) |
|
||
| Main Frequency | 1.2 GHz |
|
||
| GPU | VideoCore IV |
|
||
| GPU Frequency | 400MHz |
|
||
| Memory | 1GB (0x0000000 - 0x40000000) |
|
||
| | 0x3f000000 - 0x40000000 is for peripheral |
|
||
|
||
**The description of functional pins is as shown as follow:**
|
||
|
||
[](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/GPIO-Pinout-Diagram-2.png)
|
||
|
||
## **Compilation Instruction**
|
||
|
||
The [env](https://www.rt-thread.io/download.html?download=Env) tool is recommended for compiling in Windows environments.
|
||
|
||
The 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:
|
||
|
||
```
|
||
tar vxf gcc-arm-none-eabi-4_8-2014q1_linux.tar.bz2
|
||
```
|
||
|
||
In 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.
|
||
|
||
```
|
||
EXEC_PATH = r'/opt/gcc-arm-none-eabi-4_8-2014q1_gri/bin'
|
||
```
|
||
|
||
Enter the rt-thread/bsp/raspi3-32 directory and run the following command to compile this BSP:
|
||
|
||
```
|
||
scons
|
||
```
|
||
|
||
If 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.
|
||
|
||
### **Eclipse compiling environment**
|
||
|
||
- Step 1: Install the eclipse plugin 'cdt'.
|
||
- Step 2: Open eclipse cdt and set workspace, and set the workspace to 'rt-thread/bsp/raspberry-pi/raspi3-32'.
|
||
- Step 3: Import the project by selecting 'General->Existing Projects into Workspace' and then 'Browse ...'. Noted that the compiling only supports scons now.
|
||
|
||
|
||
## **Running**
|
||
|
||
### **Prepare the [Raspbian](https://downloads.raspberrypi.org/raspbian_lite_latest) SD card**
|
||
|
||
Download the raspbian image, for example, "2018-06-27-raspbian-stretch-lite.zip". Unpack it.
|
||
|
||
**Burn the SD card on Windows**
|
||
|
||
On 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".
|
||
|
||
When the burning process is completed, put "kernel8.img" into the boot partition to replace the file wit the same name.
|
||
|
||
**Burn the SD card on Linux**
|
||
|
||
Prepare an empty SD card, plug it in the computer and then execute the command below:
|
||
|
||
"sudo dd if=2018-06-27-raspbian-stretch-lite.img of=/dev/xxx bs=32M conv=fsync"
|
||
|
||
Note that the device file "/dev/xxx" should be replaced with the real SD card.
|
||
|
||
### **Prepare the serial port wire**
|
||
|
||
The BSP uses GPIO 14 & GPIO 15 of raspi 3 as the communication ports, as shown in the following image:
|
||
|
||
|
||
|
||
[](https://github.com/RT-Thread/rt-thread/blob/master/bsp/raspberry-pi/raspi3-32/figures/raspberrypi-console.png)
|
||
|
||
The serial port parameters: 115200 8N1, hardware and software flow control is off.
|
||
|
||
## **Running Result**
|
||
|
||
Insert the burned SD card into Raspberry Pi, power up, the output information on the serial port should be like this:
|
||
|
||
```
|
||
heap: 0x0005d784 - 0x0045d784
|
||
|
||
\ | /
|
||
- RT - Thread Operating System
|
||
/ | \ 4.0.2 build Jan 9 2020
|
||
2006 - 2019 Copyright by rt-thread team
|
||
[I/I2C] I2C bus [i2c0] registered
|
||
[I/I2C] I2C bus [i2c1] registered
|
||
[I/SDIO] SD card capacity 15558144 KB.
|
||
found part[0], begin: 1048576, size: 63.0MB
|
||
found part[1], begin: 67108864, size: 14.793GB
|
||
file system initialization done!
|
||
boot cpu:3
|
||
msh />cpu = 0x00000003
|
||
cpu 3 startup.
|
||
start OK: CPU 3
|
||
boot cpu:2
|
||
cpu = 0x00000002
|
||
cpu 2 startup.
|
||
start OK: CPU 2
|
||
boot cpu:1
|
||
cpu = 0x00000001
|
||
cpu 1 startup.
|
||
start OK: CPU 1
|
||
Hello RT-Thread!
|
||
|
||
msh />
|
||
```
|
||
|
||
## **Peripheral Condition**
|
||
|
||
| Drive | Support | Remark |
|
||
| -------------- | ------- | ------ |
|
||
| UART | Support | UART0 |
|
||
| GPIO | Support | - |
|
||
| IIC | Support | - |
|
||
| SPI | Support | - |
|
||
| CPU Timer | Support | - |
|
||
| SD card driver | Support | - |
|
||
| RTC | Support | - |
|
||
| WDT | Support | - |
|
||
| MAILBOX | Support | - |
|
||
| SMP | Support | - |
|
||
| FRAMEBUFFER | Support | HDMI |
|