bb91502465
https://github.com/RT-Thread/rt-thread/pull/9420 |
||
---|---|---|
.. | ||
.settings | ||
board | ||
docs/picture | ||
ra | ||
ra_cfg | ||
ra_gen | ||
script | ||
src | ||
.api_xml | ||
.config | ||
.cproject | ||
.gitignore | ||
.ignore_format.yml | ||
.project | ||
.secure_azone | ||
.secure_xml | ||
Kconfig | ||
README.md | ||
README_zh.md | ||
SConscript | ||
SConstruct | ||
buildinfo.gpdsc | ||
configuration.xml | ||
memory_regions.scat | ||
project.uvoptx | ||
project.uvprojx | ||
rtconfig.h | ||
rtconfig.py | ||
template.uvoptx | ||
template.uvprojx |
README.md
Vision Board BSP Introduction
English | 中文
Overview
The Vision-Board is introduced by RT-Thread, in collaboration with Renesas Electronics, the vision board is based on the Renesas Cortex-M85 architecture RA8D1 chip, to provide engineers with a flexible and comprehensive development platform, empowering developers to gain deeper experiences in the field of machine vision.
Hardware Introduction
The Vision-Board comes equipped with various onboard resources, including:
Peripheral Support
The BSP currently supports several peripherals as listed below:
On-Chip Peripheral | Support Status | Remarks |
---|---|---|
UART | Supported | UART9 is the default log output port |
GPIO | Supported | |
USB | Supported | TinyUSB |
Camera | Supported | ov2640, ov7725, ov7670... |
SDHC | Supported | 1-bit, 4-bit |
ADC | Supported | |
DAC | Supported | |
SPI | Supported | |
PWM | Supported | |
RTC | Supported | |
FLASH | Supported | |
WDT | Supported | |
I2C | Supported | |
Wi-Fi | Supported | RW007 |
- Note: The repository initially contains the minimal system. Additional peripherals can be added/enabled by referring to the Peripheral Driver Usage Tutorial.
Template Project Description
The RGB-LED, as shown above, is a common anode LED. The cathodes are connected to the microcontroller pins. For instance, the blue LED corresponds to pin P102. The LED can be lit by setting the microcontroller pin to a low level and turned off by setting it to a high level.
Software Introduction
The source code for flashing the LED is located in ra8d1-vision-board/src/hal_entry.c
. It defines a macro LED_PIN
representing the LED pin number, corresponding to BSP_IO_PORT_01_PIN_02
(P102).
#define LED_PIN BSP_IO_PORT_01_PIN_02 /* Onboard LED pins */
In the hal_entry
function, this pin is configured as an output. The LED is toggled periodically (every 500 milliseconds) in the while loop.
void hal_entry(void)
{
rt_kprintf("\nHello RT-Thread!\n");
while (1)
{
rt_pin_write(LED_PIN, PIN_HIGH);
rt_thread_mdelay(500);
rt_pin_write(LED_PIN, PIN_LOW);
rt_thread_mdelay(500);
}
}
Usage Instructions
Usage instructions are divided into two sections:
- Quick Start
- This section provides instructions for newcomers to RT-Thread to run the RT-Thread operating system on this development board and observe experimental results.
- Advanced Usage
- This section is for developers who need to utilize more development board resources on the RT-Thread operating system. It guides users on enabling more onboard resources using the ENV tool to achieve more advanced functionality.
Supported Compilation Platforms
- armclang (AC6 V6.19)
- LLVM (V16/17) ARM-software/LLVM-embedded-toolchain-for-Arm (github.com)
FSP Version Introduction
This BSP uses FSP 5.1.0 version for peripheral-related development. Users need to download and install it. Additionally, instructions for enabling additional peripherals are provided in the Peripheral Driver Usage Tutorial.
Quick Start
1. Compiling with MDK:
This BSP provides an MDK5 project. Compile and download the program using the MDK5 development environment.
Compile and Download
- Compile: Double-click the project.uvprojx file to open the MDK5 project and compile the program.
- Download: Click the Debug button in MDK to download and debug."
2. Compiling with LLVM
Open the current BSP using the ENV tool to set the toolchain and its corresponding path. Then, execute the scons
command to compile.
set RTT_CC=llvm-arm
set RTT_EXEC_PATH=D:\Progrem\LLVMEmbeddedToolchainForArm-17.0.1-Windows-x86_64\bin
execute the scons
command to compile.
scons
Observing the Program Execution
Once the program is downloaded successfully, the system will initiate automatically, displaying system information.
Connect the development board's respective serial port to the PC. Launch the terminal tool and configure the serial port settings accordingly (115200-8-1-N). Upon resetting the device, you'll observe output information from RT-Thread. To explore the system's supported commands, enter the "help" command.
[D/main] sdram init success, mapped at 0x68000000, size is 33554432 bytes, data width is 16
\ | /
- RT - Thread Operating System
/ | \ 5.1.0 build Mar 5 2024 13:57:23
2006 - 2024 Copyright by RT-Thread team
Hello RT-Thread!
msh >
msh >
Advanced Usage
Resources and Documentation
ENV Configuration
- How to use the ENV tool: RT-Thread ENV Tool User Manual
By default, this BSP only enables UART9 functionality. If you require more advanced features such as components, software packages, etc., you'll need to configure them using the ENV tool.
The steps are as follows:
- Open the ENV tool in the bsp directory.
- Enter the "menuconfig" command to configure the project. Once configured, save and exit.
- Use the "pkgs --update" command to update software packages.
- Use the "scons --target=mdk5" command to regenerate the project.
*FSP Configuration
- How to use FSP: Configuring Peripheral Drivers Using FSP for RA Series
The BSP repository currently enables the minimum configuration by default. Users can enable ENV peripheral configurations through the following steps:
- Open the ENV tool in the bsp directory and generate an MDK project using the
scons --target=mdk5'
Command. - Open the
project.uvprojx
file in the bsp directory. Navigate to theSoftware Components"
configuration in the top navigation bar. Open the configuration button next toRA Configuration
underFlex Software
. This action will automatically detect the installed FSP version on your computer. After selecting the specified version, enter FSP.
-
Inside FSP, you'll find some pre-configured peripherals. Click the
Generate Project Content
button to generate the required driver files. -
4. Return to ENV, save and exit after enabling the required peripheral configurations.
Contact Information
If you have any ideas or suggestions during usage, we encourage you to contact us via the RT-Thread Community Forum.
SDK Repository
This is the SDK repository for Vision Board: sdk-bsp-ra8d1-vision-board. This repository includes peripheral drivers and a variety of sample projects. If you'd like to experience open-source examples provided by the official website/community, please visit this repository for development. The RT-Thread main repository only maintains the latest driver-related code.
Code Contributions
If you're interested in Vision Board and have some exciting projects to share with the community, wlecome any contributions. Please refer to How to Contribute to RT-Thread Code.