diff --git a/bsp/stm32/stm32f103-blue-pill/README.md b/bsp/stm32/stm32f103-blue-pill/README.md index 8a3dae848f00adf9dd19044853af99c9c1960002..4b7eacdc4fdc1bba52ac8dc30428bb4038aede51 100644 --- a/bsp/stm32/stm32f103-blue-pill/README.md +++ b/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/) diff --git a/bsp/stm32/stm32f103-blue-pill/README.pdf b/bsp/stm32/stm32f103-blue-pill/README.pdf index 973eef4a3953b78e8fd05e42ed27be0f0a3f8c8b..d0908d582bdba91e4c9d5efe8bd572b8d432c210 100644 Binary files a/bsp/stm32/stm32f103-blue-pill/README.pdf and b/bsp/stm32/stm32f103-blue-pill/README.pdf differ diff --git a/bsp/stm32/stm32f103-blue-pill/README_zh.md b/bsp/stm32/stm32f103-blue-pill/README_zh.md index 4ff65a9908d1dc9f7dc4020775ab911103f0d00a..422b06a0a4c9d8750355af9c8c611325b90b8ef7 100644 --- a/bsp/stm32/stm32f103-blue-pill/README_zh.md +++ b/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 \ No newline at end of file +- 感谢[obito0](https://github.com/obito0)提供的[原始工程](../stm32f103-mini-system) +- [Meco Man](https://github.com/mysterywolf): jiantingman@foxmail.com \ No newline at end of file diff --git a/bsp/stm32/stm32f103-blue-pill/figures/jumper.jpg b/bsp/stm32/stm32f103-blue-pill/figures/jumper.jpg index 9b951363a28dc8d53a91cfef9c917eb4b47ecb13..5ce9b34745dc9d7e8bd0fdc2ce8f16cfd5e4c1a3 100644 Binary files a/bsp/stm32/stm32f103-blue-pill/figures/jumper.jpg and b/bsp/stm32/stm32f103-blue-pill/figures/jumper.jpg differ diff --git a/bsp/stm32/stm32f103-blue-pill/figures/putty.png b/bsp/stm32/stm32f103-blue-pill/figures/putty.png new file mode 100644 index 0000000000000000000000000000000000000000..e1905b231e9bf78e3d50bd80ff79ca9927114d68 Binary files /dev/null and b/bsp/stm32/stm32f103-blue-pill/figures/putty.png differ