Skip to content

Commit ea46dbe

Browse files
authored
Merge pull request #4151 from mysterywolf/g070
【English readme】 [stm32][g070] add english readme
2 parents 1276ec1 + fa51aaa commit ea46dbe

File tree

2 files changed

+168
-96
lines changed

2 files changed

+168
-96
lines changed
Lines changed: 52 additions & 96 deletions
Original file line numberDiff line numberDiff line change
@@ -1,116 +1,72 @@
1-
# STM32G071 BSP
1+
# STM32G070-Nucleo BSP Introduction
22

3-
## 简介
3+
[中文](README_zh.md)
44

5-
本文档为 STM32G070RB-Nucleo 开发板的 BSP (板级支持包) 说明。
5+
## MCU: STM32G070RB @64MHz, 128KB FLASH, 36KB RAM
66

7-
主要内容如下:
7+
The STM32G070CB/KB/RB mainstream microcontrollers are based on high-performance Arm® Cortex®-M0+ 32-bit RISC core operating at up to 64 MHz frequency. Offering a high level of integration, they are suitable for a wide range of applications in consumer, industrial and appliance domains and ready for the Internet of Things (IoT) solutions.
88

9-
- 开发板资源介绍
10-
- BSP 快速上手
11-
- 进阶使用方法
9+
The devices incorporate a memory protection unit (MPU), high-speed embedded memories (128 Kbytes of Flash program memory with read protection, write protection, and 36 Kbytes of SRAM), DMA and an extensive range of system functions, enhanced I/Os and peripherals. The devices offer standard communication interfaces (two I2Cs, two SPIs / one I2S, and four USARTs), one 12-bit ADC (2.5 MSps) with up to 19 channels, a low-power RTC, an advanced control PWM timer, five general-purpose 16-bit timers, two basic timers, two watchdog timers, and a SysTick timer.
10+
The devices operate within ambient temperatures from -40 to 85°C. They can operate with supply voltages from 2.0 V to 3.6 V. Optimized dynamic consumption combined with a comprehensive set of power-saving modes allows the design of low-power applications.
11+
VBAT direct battery input allows keeping RTC and backup registers powered.
12+
The devices come in packages with 32 to 64 pins.
1213

13-
通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。在进阶使用指南章节,将会介绍更多高级功能,帮助开发者利用 RT-Thread 驱动更多板载资源。
14+
#### KEY FEATURES
1415

15-
## 开发板介绍
16+
- Core: Arm® 32-bit Cortex®-M0+ CPU, frequency up to 64 MHz
17+
- -40°C to 85°C operating temperature
18+
- Memories
19+
- 128 Kbytes of Flash memory with protection
20+
- 36 Kbytes of SRAM (32 Kbytes with HW parity check)
21+
- CRC calculation unit
22+
- Reset and power management
23+
- Voltage range: 2.0 V to 3.6 V
24+
- Power-on/Power-down reset (POR/PDR)
25+
- Low-power modes:Sleep, Stop, Standby
26+
- VBAT supply for RTC and backup registers
27+
- Clock management
28+
- 4 to 48 MHz crystal oscillator
29+
- 32 kHz crystal oscillator with calibration
30+
- Internal 16 MHz RC with PLL option
31+
- Internal 32 kHz RC oscillator (±5 %)
32+
- Up to 59 fast I/Os
33+
- All mappable on external interrupt vectors
34+
- Multiple 5 V-tolerant I/Os
1635

17-
STM32G070RB-Nucleo 开发板是 ST 官方推出的一款基于 ARM Cortex-M0+ 内核的开发板,最高主频为 64Mhz,该开发板具有丰富的扩展接口,可以方便验证 STM32G070RB 的芯片性能。
36+
- 7-channel DMA controller with flexible mapping
37+
- 12-bit, 0.4 µs ADC (up to 16 ext. channels)
38+
- Up to 16-bit with hardware oversampling
39+
- Conversion range: 0 to 3.6V
40+
- 11 timers: 16-bit for advanced motor control, five 16-bit general-purpose, two basic 16-bit, two watchdogs, SysTick timer
41+
- Calendar RTC with alarm and periodic wakeup from Stop/Standby
42+
- Communication interfaces
43+
- Two I2C-bus interfaces supporting Fast-mode Plus (1 Mbit/s) with extra current sink, one supporting SMBus/PMBus and wakeup from Stop mode
44+
- Four USARTs with master/slave synchronous SPI; two supporting ISO7816 interface, LIN, IrDA capability, auto baud rate detection and wakeup feature
45+
- Two SPIs (32 Mbit/s) with 4- to 16-bit programmable bitframe, one multiplexed with I2S interface
46+
- Development support: serial wire debug (SWD)
47+
- All packages ECOPACK 2 compliant
1848

19-
开发板外观如下图所示:
2049

21-
![board](figures/board.jpg)
2250

23-
该开发板常用 **板载资源** 如下:
51+
## Read more
2452

25-
- MCU:STM32G070RB,主频 64MHz,128KB FLASH ,36KB RAM
26-
- 外部 RAM:无
27-
- 外部 FLASH:无
28-
- 常用外设
29-
- 按键:1个,user(兼具唤醒功能,PC13)
30-
- 常用接口:USB 转串口、arduino 接口等
31-
- 调试接口,标准 SWD
53+
| Documents | Description |
54+
| :----------------------------------------------------------: | :----------------------------------------------------------: |
55+
| [STM32_Nucleo-64_BSP_Introduction](../docs/STM32_Nucleo-64_BSP_Introduction.md) | How to run RT-Thread on STM32 Nucleo-64 boards (**Must-Read**) |
56+
| [STM32G070RB ST Official Website](https://www.st.com/en/microcontrollers-microprocessors/stm32g070rb.html#documentation) | STM32G070RB datasheet and other resources |
3257

33-
开发板更多详细信息请参考 ST 的 [NUCLEO 开发板介绍](https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-g070rb.html)
3458

35-
## 外设支持
3659

37-
本 BSP 目前对外设的支持情况如下:
60+
## Maintained By
3861

39-
| **板载外设** | **支持情况** | **备注** |
40-
| :----------------- | :----------: | :------------------------------------- |
41-
| ST-LINK 虚拟串口 | 支持 | 使用 USART2 |
42-
| **片上外设** | **支持情况** | **备注** |
43-
| GPIO | 支持 | PA0, PA1... PC15 ---> PIN: 0, 1...47 |
44-
| UART | 支持 | USART1/2/3 |
45-
| TIM | 支持 | TIM1/3 |
46-
| PWM | 支持 | |
47-
| SPI | 支持 | SPI1/2 |
48-
| I2C | 支持 | 软件 I2C |
49-
| ADC | 支持 | |
50-
| WDT | 支持 | |
51-
| FLASH | 支持 | 已适配 [FAL](https://github.com/RT-Thread-packages/fal) |
52-
| RTC | 暂不支持 | 详见注意事项 |
62+
[NU-LL](https://github.com/NU-LL)
5363

54-
## 使用说明
5564

56-
使用说明分为如下两个章节:
5765

58-
- 快速上手
66+
## Translated By
5967

60-
本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。
68+
Meco Man @ RT-Thread Community
6169

62-
- 进阶使用
63-
64-
本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。
65-
66-
### 快速上手
67-
68-
本 BSP 为开发者提供 MDK5 和 IAR 工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。
69-
70-
#### 硬件连接
71-
72-
使用数据线连接开发板到 PC,打开电源开关。
73-
74-
#### 编译下载
75-
76-
双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。
77-
78-
> 将工程使用的仿真器设置为ST-Link并安装仿真器好驱动程序以后,将开发板连接到PC,点击下载按钮即可下载程序到开发板。
79-
80-
#### 运行结果
81-
82-
下载程序成功之后,系统会自动运行。
83-
84-
连接开发板对应串口到 PC , 在终端工具里打开相应的串口(115200-8-1-N),复位设备后,可以看到 RT-Thread 的输出信息:
85-
86-
```bash
87-
\ | /
88-
- RT - Thread Operating System
89-
/ | \ 4.0.2 build Jul 1 2020
90-
2006 - 2019 Copyright by rt-thread team
91-
msh >
92-
```
93-
94-
### 进阶使用
95-
96-
此 BSP 默认只开启了 GPIO 和 UART 的功能,如果需使用 SPI,I2C 等更多高级功能,需要利用 ENV 工具对BSP 进行配置,步骤如下:
97-
98-
1. 在 bsp 下打开 env 工具。
99-
100-
2. 输入`menuconfig`命令配置工程,配置好之后保存退出。
101-
102-
3. 输入`pkgs --update`命令更新软件包。
103-
104-
4. 输入`scons --target=mdk5/iar` 命令重新生成工程。
105-
106-
本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](../docs/STM32系列BSP外设驱动使用教程.md)
107-
108-
## 注意事项
109-
110-
- G0系列RTC驱动有点问题,详见论坛 [该贴](https://www.rt-thread.org/qa/thread-424601-1-2.html)
111-
112-
## 联系人信息
113-
114-
维护人:
115-
116-
- [NU-LL](https://github.com/NU-LL)
70+
71+
>
72+
> https://github.com/mysterywolf
Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
# STM32G071 BSP
2+
3+
## 简介
4+
5+
本文档为 STM32G070RB-Nucleo 开发板的 BSP (板级支持包) 说明。
6+
7+
主要内容如下:
8+
9+
- 开发板资源介绍
10+
- BSP 快速上手
11+
- 进阶使用方法
12+
13+
通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。在进阶使用指南章节,将会介绍更多高级功能,帮助开发者利用 RT-Thread 驱动更多板载资源。
14+
15+
## 开发板介绍
16+
17+
STM32G070RB-Nucleo 开发板是 ST 官方推出的一款基于 ARM Cortex-M0+ 内核的开发板,最高主频为 64Mhz,该开发板具有丰富的扩展接口,可以方便验证 STM32G070RB 的芯片性能。
18+
19+
开发板外观如下图所示:
20+
21+
![board](figures/board.jpg)
22+
23+
该开发板常用 **板载资源** 如下:
24+
25+
- MCU:STM32G070RB,主频 64MHz,128KB FLASH ,36KB RAM
26+
- 外部 RAM:无
27+
- 外部 FLASH:无
28+
- 常用外设
29+
- 按键:1个,user(兼具唤醒功能,PC13)
30+
- 常用接口:USB 转串口、arduino 接口等
31+
- 调试接口,标准 SWD
32+
33+
开发板更多详细信息请参考 ST 的 [NUCLEO 开发板介绍](https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-g070rb.html)
34+
35+
## 外设支持
36+
37+
本 BSP 目前对外设的支持情况如下:
38+
39+
| **板载外设** | **支持情况** | **备注** |
40+
| :----------------- | :----------: | :------------------------------------- |
41+
| ST-LINK 虚拟串口 | 支持 | 使用 USART2 |
42+
| **片上外设** | **支持情况** | **备注** |
43+
| GPIO | 支持 | PA0, PA1... PC15 ---> PIN: 0, 1...47 |
44+
| UART | 支持 | USART1/2/3 |
45+
| TIM | 支持 | TIM1/3 |
46+
| PWM | 支持 | |
47+
| SPI | 支持 | SPI1/2 |
48+
| I2C | 支持 | 软件 I2C |
49+
| ADC | 支持 | |
50+
| WDT | 支持 | |
51+
| FLASH | 支持 | 已适配 [FAL](https://github.com/RT-Thread-packages/fal) |
52+
| RTC | 暂不支持 | 详见注意事项 |
53+
54+
## 使用说明
55+
56+
使用说明分为如下两个章节:
57+
58+
- 快速上手
59+
60+
本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。
61+
62+
- 进阶使用
63+
64+
本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。
65+
66+
### 快速上手
67+
68+
本 BSP 为开发者提供 MDK5 和 IAR 工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。
69+
70+
#### 硬件连接
71+
72+
使用数据线连接开发板到 PC,打开电源开关。
73+
74+
#### 编译下载
75+
76+
双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。
77+
78+
> 将工程使用的仿真器设置为ST-Link并安装仿真器好驱动程序以后,将开发板连接到PC,点击下载按钮即可下载程序到开发板。
79+
80+
#### 运行结果
81+
82+
下载程序成功之后,系统会自动运行。
83+
84+
连接开发板对应串口到 PC , 在终端工具里打开相应的串口(115200-8-1-N),复位设备后,可以看到 RT-Thread 的输出信息:
85+
86+
```bash
87+
\ | /
88+
- RT - Thread Operating System
89+
/ | \ 4.0.2 build Jul 1 2020
90+
2006 - 2019 Copyright by rt-thread team
91+
msh >
92+
```
93+
94+
### 进阶使用
95+
96+
此 BSP 默认只开启了 GPIO 和 UART 的功能,如果需使用 SPI,I2C 等更多高级功能,需要利用 ENV 工具对BSP 进行配置,步骤如下:
97+
98+
1. 在 bsp 下打开 env 工具。
99+
100+
2. 输入`menuconfig`命令配置工程,配置好之后保存退出。
101+
102+
3. 输入`pkgs --update`命令更新软件包。
103+
104+
4. 输入`scons --target=mdk5/iar` 命令重新生成工程。
105+
106+
本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](../docs/STM32系列BSP外设驱动使用教程.md)
107+
108+
## 注意事项
109+
110+
- G0系列RTC驱动有点问题,详见论坛 [该贴](https://www.rt-thread.org/qa/thread-424601-1-2.html)
111+
112+
## 联系人信息
113+
114+
维护人:
115+
116+
- [NU-LL](https://github.com/NU-LL)

0 commit comments

Comments
 (0)