Skip to content

Commit 739bf5f

Browse files
committed
[bsp][stm32][bluepill] update readme
1 parent 1526386 commit 739bf5f

File tree

5 files changed

+37
-14
lines changed

5 files changed

+37
-14
lines changed

bsp/stm32/stm32f103-blue-pill/README.md

Lines changed: 34 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ By reading the ***Quickly Get Started*** section developers can quickly get thei
1717

1818
## Onboard Resources
1919

20-
The Blue Pill is a STM32F103 based development board with Cortex-M3 ARM CPU that runs at 72 MHz, 20 KB of RAM and 64 or 128 KB of flash memory. The microcontroller (MCU) has a USB port, two serial ports, 16 bit PWM pins and 12 bit ADC pins. It runs at 3.3V, but some of its pins are 5V tolerant.
20+
The Blue Pill is a STM32F103 based development board with Cortex-M3 ARM CPU that runs at 72 MHz, 20 KB of RAM and 64 or 128 KB (hidden) of flash memory. The microcontroller (MCU) has a USB port, two serial ports, 16 bit PWM pins and 12 bit ADC pins. It runs at 3.3V, but some of its pins are 5V tolerant.
2121

2222
- MCU:STM32F103C8T6 @72MHz, 64KB FLASH , 20KB RAM
2323

@@ -40,7 +40,9 @@ This BSP provides MDK4, MDK5, and IAR projects for developers and it supports th
4040

4141
### Use ST-LINK Debugger to connect the Blue Pill Board
4242

43-
ST-LINK driver: https://www.st.com/en/development-tools/stsw-link009.html
43+
ST-LINK driver:
44+
45+
> https://www.st.com/en/development-tools/stsw-link009.html
4446
4547
| ST-LINK Debugger | Blue Pill 4-Pin SWD |
4648
| :--------------: | :-----------------: |
@@ -59,7 +61,9 @@ ST-LINK driver: https://www.st.com/en/development-tools/stsw-link009.html
5961

6062
### Use FTDI adapter(USB to UART) to connect the Blue Pill Board's PA9(Tx) and PA10(Rx) pins
6163

62-
FTDI adapter driver: https://www.ftdichip.com/FTDrivers.htm
64+
FTDI adapter driver:
65+
66+
> https://www.ftdichip.com/FTDrivers.htm
6367
6468
You can use other USB to UART adapters to replace FTDI adapter.
6569

@@ -90,21 +94,25 @@ You can use other USB to UART adapters to replace FTDI adapter.
9094

9195
### Compile and Download
9296

93-
- Double-click the `project.uvprojx` file to open the MDK5 project (**NOT** `template.uvprojx` file)
97+
- Double-click the `project.uvprojx` file to open the MDK-Keil5 project (**NOT** `template.uvprojx` file)
9498
- Click the “option for target” button
9599
- Debug: Choose "ST-LINK Debugger" and Click "Setting" button:
96100
- Port: choose "SW (Serial Wire)"
97101
- Flash Download: check "Reset and Run"
98102

99103
- Compile and download the program to the board
100104

105+
You can also follow this video to configurate *Blue Pill BSP* Keil5 project:
106+
107+
> https://www.youtube.com/watch?v=0PwBBYXQ08g&t
108+
101109

102110

103111
### Running Results
104112

105113
After the program is successfully downloaded, the system runs automatically. Observe the running results of the LED on the development board, and you will see the LED is flashing periodically.
106114

107-
The USB virtual COM port connects to **USART1 (PA9-Tx, PA10-Rx) by default**, and when the corresponding serial port (**115200**-8-1-N) is opened in the terminal tool, the output information of RT-Thread can be seen when the device is reset:
115+
The COM port connects to **USART1 (PA9-Tx, PA10-Rx) by default**, and when the corresponding serial port (**115200**-8-1-N) is opened in the terminal tool, the output information of RT-Thread can be seen when the device is reset:
108116

109117
```shell
110118
\ | /
@@ -114,13 +122,29 @@ The USB virtual COM port connects to **USART1 (PA9-Tx, PA10-Rx) by default**, an
114122
msh >
115123
```
116124

117-
- If you have no terminal tool software available, you can download *Putty*: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
125+
126+
127+
### Terminal tool - PuTTy
128+
129+
If you have no terminal tool software available, you can download *PuTTy*:
130+
131+
> https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
132+
133+
![putty](figures/putty.png)
134+
135+
136+
137+
These two videos will show you how to use PuTTy:
138+
139+
> https://www.youtube.com/watch?v=ab4ilbsteWU
140+
>
141+
> https://www.youtube.com/watch?v=dO-BMOzNKcI
118142
119143

120144

121145
## **Advanced Features**
122146

123-
This BSP only enables GPIO and USART1 by default. If you need more advanced features such as SPI, ADC, or to add software packages, you need to configure the BSP with RT-Thread [ENV tools](https://www.rt-thread.io/download.html?download=Env), as follows:
147+
This BSP only enables GPIO and USART1 by default. If you need more advanced features such as SPI, ADC, or to add software packages, you need to configure the BSP with RT-Thread [ENV tool](https://www.rt-thread.io/download.html?download=Env), as follows:
124148

125149
1. Open the ENV tool under the specific BSP folder, eg: *bsp/stm32/stm32f103-blue-pill* ;
126150
2. Enter `menuconfig` command to configure the project, then save and exit;
@@ -133,10 +157,11 @@ Learn how to use RT-Thread ENV, click [Here](https://github.com/RT-Thread/rtthre
133157

134158
## Read more
135159

136-
- [[Schematic]](https://stm32duinoforum.com/forum/images/c/c1/wiki_subdomain/Vcc-gnd.com-STM32F103C8-schematic.pdf)
160+
- [[STM32 Blue Pill Board Schematic]](https://stm32duinoforum.com/forum/images/c/c1/wiki_subdomain/Vcc-gnd.com-STM32F103C8-schematic.pdf)
137161
- [[STM32 Blue Pill vs Black Pill Microcontroller Boards]](https://www.youtube.com/watch?v=QCdnO43RBK4&t=875s)
138162
- [[STM32F103C8 datasheet]]( https://www.st.com/resource/en/datasheet/stm32f103c8.pdf)
139-
- [[STM32F103C8 More Information]](https://www.st.com/en/microcontrollers-microprocessors/stm32f103c8.html#overview)
163+
- [[STM32F103C8 More Information (ST official)]](https://www.st.com/en/microcontrollers-microprocessors/stm32f103c8.html#overview)
164+
- [[RT-Thread document center]](https://www.rt-thread.io/document/site/introduction/introduction/)
140165

141166

142167

63.1 KB
Binary file not shown.

bsp/stm32/stm32f103-blue-pill/README_zh.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -111,9 +111,7 @@ msh >
111111

112112

113113

114-
## 联系人信息
114+
## 感谢 & 维护
115115

116-
维护人:
117-
118-
- [obito0](https://github.com/obito0), 邮箱:<[email protected]>
119-
- Meco Man: [email protected] https://github.com/mysterywolf
116+
- 感谢[obito0](https://github.com/obito0)提供的[原始工程](../stm32f103-mini-system)
117+
- [Meco Man](https://github.com/mysterywolf): [email protected]
29.5 KB
Loading
20.4 KB
Loading

0 commit comments

Comments
 (0)