Merge pull request #3995 from mysterywolf/master

[bsp][stm32][bluepill] update readme

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

@@ -17,7 +17,7 @@ By reading the ***Quickly Get Started*** section developers can quickly get thei
 
 ## Onboard Resources
 
-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.
+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.
 
 - MCU：STM32F103C8T6 @72MHz, 64KB FLASH , 20KB RAM
 
@@ -40,7 +40,9 @@ This BSP provides MDK4, MDK5, and IAR projects for developers and it supports th
 
 ### Use ST-LINK Debugger to connect the Blue Pill Board
 
-ST-LINK driver: https://www.st.com/en/development-tools/stsw-link009.html
+ST-LINK driver: 
+
+> https://www.st.com/en/development-tools/stsw-link009.html
 
 | ST-LINK Debugger | Blue Pill 4-Pin SWD |
 | :--------------: | :-----------------: |
@@ -59,7 +61,9 @@ ST-LINK driver: https://www.st.com/en/development-tools/stsw-link009.html
 
 ### Use FTDI adapter(USB to UART) to connect the Blue Pill Board's PA9(Tx) and PA10(Rx) pins
 
-FTDI adapter driver: https://www.ftdichip.com/FTDrivers.htm
+FTDI adapter driver:
+
+> https://www.ftdichip.com/FTDrivers.htm
 
 You can use other USB to UART adapters to replace FTDI adapter.
 
@@ -90,7 +94,7 @@ You can use other USB to UART adapters to replace FTDI adapter.
 
 ### Compile and Download
 
-- Double-click the `project.uvprojx` file to open the MDK5 project  (**NOT** `template.uvprojx` file)
+- Double-click the `project.uvprojx` file to open the MDK-Keil5 project  (**NOT** `template.uvprojx` file)
 - Click the “option for target” button
   - Debug: Choose "ST-LINK Debugger" and Click "Setting" button:
     - Port: choose "SW (Serial Wire)"
@@ -98,13 +102,17 @@ You can use other USB to UART adapters to replace FTDI adapter.
 
 - Compile and download the program to the board
 
+You can also follow this video to configurate *Blue Pill BSP* Keil5 project: 
+
+> https://www.youtube.com/watch?v=0PwBBYXQ08g&t
+
 
 
 ### Running Results
 
 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.
 
-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:
+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:
 
 ```shell
  \ | /
@@ -114,13 +122,29 @@ The USB virtual COM port connects to **USART1 (PA9-Tx, PA10-Rx) by default**, an
 msh >
 ```
 
-- If you have no terminal tool software available, you can download *Putty*: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
+
+
+### Terminal tool - PuTTy 
+
+If you have no terminal tool software available, you can download *PuTTy*:
+
+>  https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
+
+![putty](figures/putty.png)
+
+
+
+These two videos will show you how to use PuTTy:
+
+> https://www.youtube.com/watch?v=ab4ilbsteWU
+>
+> https://www.youtube.com/watch?v=dO-BMOzNKcI
 
 
 
 ## **Advanced Features**
 
-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:
+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:
 
 1. Open the ENV tool under the specific BSP folder, eg: *bsp/stm32/stm32f103-blue-pill* ;
 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
 
 ## Read more
 
-- [[Schematic]](https://stm32duinoforum.com/forum/images/c/c1/wiki_subdomain/Vcc-gnd.com-STM32F103C8-schematic.pdf)
+- [[STM32 Blue Pill Board Schematic]](https://stm32duinoforum.com/forum/images/c/c1/wiki_subdomain/Vcc-gnd.com-STM32F103C8-schematic.pdf)
 - [[STM32 Blue Pill vs Black Pill Microcontroller Boards]](https://www.youtube.com/watch?v=QCdnO43RBK4&t=875s)
 - [[STM32F103C8 datasheet]]( https://www.st.com/resource/en/datasheet/stm32f103c8.pdf)
-- [[STM32F103C8 More Information]](https://www.st.com/en/microcontrollers-microprocessors/stm32f103c8.html#overview)
+- [[STM32F103C8 More Information (ST official)]](https://www.st.com/en/microcontrollers-microprocessors/stm32f103c8.html#overview)
+- [[RT-Thread document center]](https://www.rt-thread.io/document/site/introduction/introduction/)
 
 
 

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

@@ -111,9 +111,7 @@ msh >
 
 
 
-## 联系人信息
+## 感谢 & 维护
 
-维护人:
-
--  [obito0](https://github.com/obito0), 邮箱：<496420502@qq.com>
--  Meco Man: jiantingman@foxmail.com     https://github.com/mysterywolf
+- 感谢[obito0](https://github.com/obito0)提供的[原始工程](../stm32f103-mini-system)
+- [Meco Man](https://github.com/mysterywolf): jiantingman@foxmail.com