RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity

boards: Split off 128KiB version of bl*pill

Browse Source 
- Created new `bluepill-128kib` as 128KiB version of the `bluepill`
- Created new `blackpill-128kib` as 128KiB version of the `blackpill`
- Updated `openocd.cfg` to allow flashing 128KiB of ROM
This commit is contained in:
Marian Buschsieweke 2019-09-04 14:58:32 +02:00
parent c1d5286516
commit 09d1dcf6b3
No known key found for this signature in database
GPG Key ID: 61F64C6599B1539F
40 changed files with 454 additions and 334 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
boards/blackpill-128kib/Makefile Normal file
View File

@ -0,0 +1,5 @@
MODULE = board
DIRS = $(RIOTBOARD)/common/blxxxpill
include $(RIOTBASE)/Makefile.base

1
boards/blackpill-128kib/Makefile.dep Normal file
View File

@ -0,0 +1 @@
include $(RIOTBOARD)/common/blxxxpill/Makefile.dep

1
boards/blackpill-128kib/Makefile.features Normal file
View File

@ -0,0 +1 @@
include $(RIOTBOARD)/common/blxxxpill/Makefile.features

8
boards/blackpill-128kib/Makefile.include Normal file
View File

@ -0,0 +1,8 @@
## the cpu to build for
export CPU = stm32f1
export CPU_MODEL = stm32f103cb
export OPENOCD_CONFIG ?= $(RIOTBOARD)/common/blxxxpill/dist/openocd-128kib.cfg
USEMODULE += boards_common_blxxxpill
include $(RIOTBOARD)/common/blxxxpill/Makefile.include

9
boards/blackpill-128kib/doc.txt Normal file
View File

@ -0,0 +1,9 @@
/**
@defgroup boards_blackpill_128kib Blackpill board (128KiB flash hack version)
@ingroup boards
@brief Support for the stm32f103c8 based blackpill board.
Refer to the common documentation of the bluepill and blackpill board in
@ref boards_common_blxxxpill instead.
*/

52
boards/blackpill-128kib/include/board.h Normal file
View File

@ -0,0 +1,52 @@
/*
* Copyright (C) 2015 TriaGnoSys GmbH
* 2017 Alexander Kurth, Sören Tempel, Tristan Bruns
* 2018 Otto-von-Guericke-Universität Magdeburg
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_blackpill_128kib
* @brief Support for the stm32f103c8 based Black pill.
*
* @{
*
* @file
* @brief Peripheral MCU configuration for the Black Pill board
*
* @author Víctor Ariño <victor.arino@triagnosys.com>
* @author Sören Tempel <tempel@uni-bremen.de>
* @author Tristan Bruns <tbruns@uni-bremen.de>
* @author Alexander Kurth <kurth1@uni-bremen.de>
* @author Marian Buschsieweke <marian.buschsieweke@ovgu.de>
*/
#ifndef BOARD_H
#define BOARD_H
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Macros for controlling the on-board LED.
* @{
*/
#define LED0_PORT GPIOB /**< GPIO-Port the LED is connected to */
#define LED0_PORTNUM PORT_B /**< GPIO Port number the LED is connected to */
#define LED0_PINNUM (12) /**< Pin number the LED is connected to */
/** @} */
#ifdef __cplusplus
}
#endif
/* Beware: This include must come *after* LED0 paramters have been defined */
#include "board_common.h"
#endif /* BOARD_H */
/** @} */

2
boards/blackpill/Makefile
View File

@ -1,5 +1,5 @@
MODULE = board
DIRS = $(RIOTBOARD)/common/stm32f103c8
DIRS = $(RIOTBOARD)/common/blxxxpill
include $(RIOTBASE)/Makefile.base

5
boards/blackpill/Makefile.dep
View File

@ -1,4 +1 @@
ifneq (,$(filter saul_default,$(USEMODULE)))
USEMODULE += saul_gpio
endif
include $(RIOTBOARD)/common/stm32f103c8/Makefile.dep
include $(RIOTBOARD)/common/blxxxpill/Makefile.dep

2
boards/blackpill/Makefile.features
View File

@ -1 +1 @@
include $(RIOTBOARD)/common/stm32f103c8/Makefile.features
include $(RIOTBOARD)/common/blxxxpill/Makefile.features

10
boards/blackpill/Makefile.include
View File

@ -1,2 +1,8 @@
USEMODULE += boards_common_stm32f103c8
include $(RIOTBOARD)/common/stm32f103c8/Makefile.include
## the cpu to build for
export CPU = stm32f1
export CPU_MODEL = stm32f103c8
export OPENOCD_CONFIG ?= $(RIOTBOARD)/common/blxxxpill/dist/openocd.cfg
USEMODULE += boards_common_blxxxpill
include $(RIOTBOARD)/common/blxxxpill/Makefile.include

35
boards/blackpill/board.c
View File

@ -1,35 +0,0 @@
/*
* Copyright (C) 2015 TriaGnoSys GmbH
* 2017 Alexander Kurth, Sören Tempel, Tristan Bruns
* 2018 Otto-von-Guericke-Universität Magdeburg
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_blackpill
* @{
*
* @file
* @brief Board specific implementations for the Black Pill
* Board
*
* @author Víctor Ariño <victor.arino@triagnosys.com>
* @author Sören Tempel <tempel@uni-bremen.de>
* @author Tristan Bruns <tbruns@uni-bremen.de>
* @author Alexander Kurth <kurth1@uni-bremen.de>
* @author Marian Buschsieweke <marian.buschsieweke@ovgu.de>
*
* @}
*/
#include "board.h"
#include "periph/gpio.h"
void board_init(void)
{
cpu_init();
gpio_init(LED0_PIN, GPIO_OUT);
}

1
boards/blackpill/dist/openocd.cfg vendored
View File

@ -1 +0,0 @@
../../common/stm32f103c8/dist/openocd.cfg

9
boards/blackpill/doc.txt Normal file
View File

@ -0,0 +1,9 @@
/**
@defgroup boards_blackpill Blackpill board
@ingroup boards
@brief Support for the stm32f103c8 based blackpill board.
Refer to the common documentation of the bluepill and blackpill board in
@ref boards_common_blxxxpill instead.
*/

42
boards/blackpill/include/board.h
View File

@ -9,17 +9,9 @@
*/
/**
* @defgroup boards_blackpill Black pill
* @ingroup boards
* @ingroup boards_blackpill
* @brief Support for the stm32f103c8 based Black pill.
*
* This board can be bought very cheaply on sides like eBay or
* AliExpress. Although the MCU nominally has 64 KiB ROM, most of them
* have 128 KiB ROM. This board is almost identical to the bluepill board,
* except for the pin layout and the on board LED is connected to PB12 instead
* of PC13. For more information see:
* http://wiki.stm32duino.com/index.php?title=Black_Pill
*
* @{
*
* @file
@ -35,6 +27,7 @@
#ifndef BOARD_H
#define BOARD_H
#ifdef __cplusplus
extern "C" {
#endif
@ -43,36 +36,17 @@ extern "C" {
* @name Macros for controlling the on-board LED.
* @{
*/
#define LED0_PORT GPIOB
#define LED0_PIN GPIO_PIN(PORT_B, 12)
#define LED0_MASK (1 << 12)
#define LED0_ON (LED0_PORT->BSRR = (LED0_MASK << 16))
#define LED0_OFF (LED0_PORT->BSRR = LED0_MASK)
#define LED0_TOGGLE (LED0_PORT->ODR ^= LED0_MASK)
/** @} */
/**
* @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
/**
* @brief Use the 2nd UART for STDIO on this board
*/
#define STDIO_UART_DEV UART_DEV(1)
/**
* @name xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
#define XTIMER_BACKOFF (19)
#define LED0_PORT GPIOB /**< GPIO-Port the LED is connected to */
#define LED0_PORTNUM PORT_B /**< GPIO Port number the LED is connected to */
#define LED0_PINNUM (12) /**< Pin number the LED is connected to */
/** @} */
#ifdef __cplusplus
}
#endif
/* Beware: This include must come *after* LED0 paramters have been defined */
#include "board_common.h"
#endif /* BOARD_H */
/** @} */

49
boards/blackpill/include/gpio_params.h
View File

@ -1,49 +0,0 @@
/*
* Copyright (C) 2017 HAW Hamburg
* 2018 Otto-von-Guericke-Universität Magdeburg
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_blackpill
* @{
*
* @file
* @brief Board specific configuration of direct mapped GPIOs
*
* @author Sebastian Meiling <s@mlng.net>
* @author Marian Buschsieweke <marian.buschsieweke@ovgu.de>
*/
#ifndef GPIO_PARAMS_H
#define GPIO_PARAMS_H
#include "board.h"
#include "saul/periph.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief GPIO pin configuration
*/
static const saul_gpio_params_t saul_gpio_params[] =
{
{
.name = "LED",
.pin = LED0_PIN,
.mode = GPIO_OUT,
.flags = (SAUL_GPIO_INVERTED | SAUL_GPIO_INIT_CLEAR)
},
};
#ifdef __cplusplus
}
#endif
#endif /* GPIO_PARAMS_H */
/** @} */

5
boards/bluepill-128kib/Makefile Normal file
View File

@ -0,0 +1,5 @@
MODULE = board
DIRS = $(RIOTBOARD)/common/blxxxpill
include $(RIOTBASE)/Makefile.base

1
boards/bluepill-128kib/Makefile.dep Normal file
View File

@ -0,0 +1 @@
include $(RIOTBOARD)/common/blxxxpill/Makefile.dep

1
boards/bluepill-128kib/Makefile.features Normal file
View File

@ -0,0 +1 @@
include $(RIOTBOARD)/common/blxxxpill/Makefile.features

8
boards/bluepill-128kib/Makefile.include Normal file
View File

@ -0,0 +1,8 @@
## the cpu to build for
export CPU = stm32f1
export CPU_MODEL = stm32f103cb
export OPENOCD_CONFIG ?= $(RIOTBOARD)/common/blxxxpill/dist/openocd-128kib.cfg
USEMODULE += boards_common_blxxxpill
include $(RIOTBOARD)/common/blxxxpill/Makefile.include

9
boards/bluepill-128kib/doc.txt Normal file
View File

@ -0,0 +1,9 @@
/**
@defgroup boards_bluepill_128kib Bluepill board (128KiB flash hack version)
@ingroup boards
@brief Support for the stm32f103c8 based bluepill board.
Refer to the common documentation of the bluepill and blackpill board in
@ref boards_common_blxxxpill instead.
*/

45
boards/bluepill-128kib/include/board.h Normal file
View File

@ -0,0 +1,45 @@
/*
* Copyright (C) 2015 TriaGnoSys GmbH
* 2017 Alexander Kurth, Sören Tempel, Tristan Bruns
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_bluepill_128kib
*
* This board can be bought very cheaply on sides like eBay or
* AliExpress. Although the MCU nominally has 64 KiB ROM, most of them
* have 128 KiB ROM. For more information see:
* http://wiki.stm32duino.com/index.php?title=Blue_Pill
*
* @{
*
* @file
* @brief Peripheral MCU configuration for the bluepill board
*
* @author Víctor Ariño <victor.arino@triagnosys.com>
* @author Sören Tempel <tempel@uni-bremen.de>
* @author Tristan Bruns <tbruns@uni-bremen.de>
* @author Alexander Kurth <kurth1@uni-bremen.de>
*/
#ifndef BOARD_H
#define BOARD_H
#include "board_common.h"
#ifdef __cplusplus
extern "C" {
#endif
/* Board common contains all required info */
#ifdef __cplusplus
}
#endif
#endif /* BOARD_H */
/** @} */

2
boards/bluepill/Makefile
View File

@ -1,5 +1,5 @@
MODULE = board
DIRS = $(RIOTBOARD)/common/stm32f103c8
DIRS = $(RIOTBOARD)/common/blxxxpill
include $(RIOTBASE)/Makefile.base

5
boards/bluepill/Makefile.dep
View File

@ -1,4 +1 @@
ifneq (,$(filter saul_default,$(USEMODULE)))
USEMODULE += saul_gpio
endif
include $(RIOTBOARD)/common/stm32f103c8/Makefile.dep
include $(RIOTBOARD)/common/blxxxpill/Makefile.dep

2
boards/bluepill/Makefile.features
View File

@ -1 +1 @@
include $(RIOTBOARD)/common/stm32f103c8/Makefile.features
include $(RIOTBOARD)/common/blxxxpill/Makefile.features

10
boards/bluepill/Makefile.include
View File

@ -1,2 +1,8 @@
USEMODULE += boards_common_stm32f103c8
include $(RIOTBOARD)/common/stm32f103c8/Makefile.include
## the cpu to build for
export CPU = stm32f1
export CPU_MODEL = stm32f103c8
export OPENOCD_CONFIG ?= $(RIOTBOARD)/common/blxxxpill/dist/openocd.cfg
USEMODULE += boards_common_blxxxpill
include $(RIOTBOARD)/common/blxxxpill/Makefile.include

1
boards/bluepill/dist/openocd.cfg vendored
View File

@ -1 +0,0 @@
../../common/stm32f103c8/dist/openocd.cfg

153
boards/bluepill/doc.txt
View File

@ -3,156 +3,7 @@
@ingroup boards
@brief Support for the stm32f103c8 based bluepill board.
## Overview
Refer to the common documentation of the bluepill and blackpill board in
@ref boards_common_blxxxpill instead.
The bluepill is an STM32F103 based board which can be bought for around
2€ on sides like AliExpress, eBay and others. Although the STM32F130C8
MCU nominally has 64 KB flash, most [actually have 128 KB
flash][Flashsize].
## Hardware
![bluepill](https://camo.githubusercontent.com/8df2fb54f87527bdd57fe007352d72c1f377d08f/687474703a2f2f77696b692e73746d33326475696e6f2e636f6d2f696d616765732f7468756d622f312f31392f53544d33325f426c75655f50696c6c5f746f702e6a70672f38303070782d53544d33325f426c75655f50696c6c5f746f702e6a7067)
### MCU
| MCU | STM32F103C8 |
|:----------|:-----------------------|
| Family | ARM Cortex-M3 |
| Vendor | STMicroelectronics |
| RAM | 20 KB |
| Flash | 64 KB / 128 KB |
| Frequency | up to 72 MHz |
| Timer | 3x 16-Bit |
| ADC | 2x 12-bit, 10 channels |
| UART | 3 |
| SPI | 2 |
| I2C | 2 |
| CAN | 1 |
| Vcc | 2.0 to 3.6 V |
| Datasheet | [Datasheet][Datasheet] |
## Implementation Status
| ID | Supported |
|:----- |:--------- |
| GPIO | yes |
| PWM | yes |
| UART | yes |
| ADC | yes |
| I2C | no |
| SPI | yes |
| USB | no |
| Timer | yes |
| CAN | no |
## Flashing
To program and debug the board you need a SWD capable debugger. The
easiest way is using [OpenOCD][OpenOCD]. By default RIOT uses the hardware
reset signal and connects to the chip under reset for flashing. This is
required to reliably connect to the device even when the MCU is in a low power
mode. Therefore not only SWDIO and SWCLK, but also the RST pin of your
debugger need to be connected to the board. Once the device is connected to
the debugger and OpenOCD is installed, you can flash the device with:
$ make BOARD=bluepill flash
### Additional Flash
To make use of the entire 128 KB flash, compile your application with:
$ make STM32F103C8_FLASH_HACK=1 BOARD=bluepill
This sets the `CPU_MODEL` make variable to `stm32f103cb`, the default
value is `stm32f103c8`. These two CPU models basically only have one
major difference, the latter has 128 KB flash while the former has 64
KB. You may also set `STM32F103C8_FLASH_HACK` as environment variable.
If you want to flash a binary compiled this way you either need to
figure out how to adjust the OpenOCD configuration to make it use 128 KB
flash or use this [stlink fork][caboStlink] which has a
[patch][caboPatch] to make use of the entire 128 KB flash using:
$ C8T6HACK=1 st-flash write /dev/sgX $pathToHexFile 0x8000000
## Connecting via Serial
The default UART port used is UART2, which uses pins A2 (TX) and A3 (RX).
To use it, configure your UART to operate at a baudrate of 115200/8N1.
## Using PWM
PWM is available at pins A8 to A11.
## Known Issues
### USB connector
The Micro-USB port is sometimes not soldered properly. Also, it is
usually equipped with an incorrect resistor. [This can be fixed multiple
ways][USB].
### Flashing fails
Please check whether the debugger is properly connected, including the hardware
reset signal pin.
| Pin on Debugger | Pin on Blue Pill |
|:------------------ |:---------------- |
| SWDIO | DIO |
| SWCLK | DCLK |
| NRST | R |
| GND | GND |
| VDD (3.3V) (*) | 3.3 |
| Target VCC (**) | 3.3 |
- (*) Most debuggers have a 3.3V supply voltage to power the board. You can
alternatively power the board using the TTL-Adapter or via Micro-USB.
- (**) Some debuggers monitor the voltage of the target MCU. Their target VCC
pin needs to be connected to one of the 3.3V pins of the boards.
Most very cheap SWD debuggers (especially those imported for about 2€ from far
east) do not have a Target VCC pin; they will still work just fine. On these
cheap debuggers the pin to send the reset signal to the board is often either
not present or defunct. You can work around this by pressing the reset button
when OpenOCD wants to connect to the Blue Pill. Hit the reset button again after
flashing in order to boot the newly flashed image.
## Where to buy
The board is sold under different names. On some sites it is called
`bluepill` or `blue pill`. On others you might find it by searching for
`stm32f103c8` or `stm32f103c8t6`.
Try [eBay][eBay] or [AliExpress][AliExpress].
## Further reading
* http://wiki.stm32duino.com/index.php?title=Blue_Pill
* http://wiki.stm32duino.com/index.php?title=Maple_Mini#Clones
* http://www.st.com/content/st_com/en/products/microcontrollers/stm32-32-bit-
arm-cortex-mcus/stm32-mainstream-mcus/stm32f1-series/stm32f103/stm32f103c8.html
[Datasheet]: http://www.st.com/content/ccc/resource/technical/document/datash
eet/33/d4/6f/1d/df/0b/4c/6d/CD00161566.pdf/files/CD00161566.pdf/jcr:content/tran
slations/en.CD00161566.pdf
[Flashsize]:
http://wiki.stm32duino.com/index.php?title=Blue_Pill#128_KB_flash_on_C8_version
[eBay]: https://www.ebay.com/sch/i.html?_nkw=stm32f103c8
[AliExpress]: https://www.aliexpress.com/wholesale?SearchText=STM32F103C8T6
[OpenOCD]: https://github.com/RIOT-OS/RIOT/wiki/OpenOCD
[USB]:
http://wiki.stm32duino.com/index.php?title=Blue_Pill#Hardware_installation
[imgTop]:
http://wiki.stm32duino.com/images/thumb/1/19/STM32_Blue_Pill_top.jpg/800px-
STM32_Blue_Pill_top.jpg
[caboStlink]: https://github.com/cabo/stlink
[caboPatch]:
https://github.com/cabo/stlink/commit/e2ff1710ca6caeb55b5b99f7bd8a29181ccf533d
*/

33
boards/bluepill/include/board.h
View File

@ -29,41 +29,12 @@
#ifndef BOARD_H
#define BOARD_H
#include "board_common.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Macros for controlling the on-board LED.
* @{
*/
#define LED0_PORT GPIOC
#define LED0_PIN GPIO_PIN(PORT_C, 13)
#define LED0_MASK (1 << 13)
#define LED0_ON (LED0_PORT->BSRR = (LED0_MASK << 16))
#define LED0_OFF (LED0_PORT->BSRR = LED0_MASK)
#define LED0_TOGGLE (LED0_PORT->ODR ^= LED0_MASK)
/** @} */
/**
* @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
/**
* @brief Use the 2nd UART for STDIO on this board
*/
#define STDIO_UART_DEV UART_DEV(1)
/**
* @name xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
#define XTIMER_BACKOFF (19)
/** @} */
#ifdef __cplusplus
}
#endif

2
boards/common/stm32f103c8/Makefile → boards/common/blxxxpill/Makefile
View File

@ -1,3 +1,3 @@
MODULE = boards_common_stm32f103c8
MODULE = boards_common_blxxxpill
include $(RIOTBASE)/Makefile.base

3
boards/common/blxxxpill/Makefile.dep Normal file
View File

@ -0,0 +1,3 @@
ifneq (,$(filter saul_default,$(USEMODULE)))
USEMODULE += saul_gpio
endif

0
boards/common/stm32f103c8/Makefile.features → boards/common/blxxxpill/Makefile.features
View File

11
boards/common/stm32f103c8/Makefile.include → boards/common/blxxxpill/Makefile.include
View File

@ -1,13 +1,4 @@
## the cpu to build for
export CPU = stm32f1
STM32F103C8_FLASH_HACK ?= 0
ifneq ($(STM32F103C8_FLASH_HACK),0)
export CPU_MODEL = stm32f103cb
else
export CPU_MODEL = stm32f103c8
endif
INCLUDES += -I$(RIOTBOARD)/common/stm32f103c8/include
INCLUDES += -I$(RIOTBOARD)/common/blxxxpill/include
# define the default port depending on the host OS
PORT_LINUX ?= /dev/ttyUSB0

0
boards/bluepill/board.c → boards/common/blxxxpill/board.c
View File

22
boards/common/blxxxpill/dist/openocd-128kib.cfg vendored Normal file
View File

@ -0,0 +1,22 @@
set CHIPNAME STM32F103C8Tx
# Enable debug when in low power modes
set ENABLE_LOW_POWER 1
# Stop Watchdog counters when halt
set STOP_WATCHDOG 1
# STlink Debug clock frequency
set CLOCK_FREQ 4000
# use hardware reset, connect under reset
# connect_assert_srst needed if low power mode application running (WFI...)
reset_config srst_only srst_nogate connect_assert_srst
set CONNECT_UNDER_RESET 1
# brutally overwriting detected flash size with 128KiB (OpenOCD > 0.10.0)
set FLASH_SIZE 0x20000
source [find target/stm32f1x.cfg]
$_TARGETNAME configure -rtos auto

0
boards/common/stm32f103c8/dist/openocd.cfg → boards/common/blxxxpill/dist/openocd.cfg vendored
View File

161
boards/common/blxxxpill/doc.txt Normal file
View File

@ -0,0 +1,161 @@
/**
@defgroup boards_common_blxxxpill Common code for bluepill and blackpill
@ingroup boards_common
@brief Support for cheap stm32f103c8 based boards such as bluepill and blackpill.
## Overview
The bluepill and the blackpill are STM32F103 based board which can be bought for
around 2€ on sides like AliExpress, eBay and others. Although the STM32F130C8
MCU nominally has 64 KiB flash, most [actually have 128 KiB flash][Flashsize].
There are also versions that only report to have 32 KiB, but actually have
64 KiB.
## Hardware
![bluepill](https://camo.githubusercontent.com/8df2fb54f87527bdd57fe007352d72c1f377d08f/687474703a2f2f77696b692e73746d33326475696e6f2e636f6d2f696d616765732f7468756d622f312f31392f53544d33325f426c75655f50696c6c5f746f702e6a70672f38303070782d53544d33325f426c75655f50696c6c5f746f702e6a7067)
### MCU
| MCU | STM32F103C8 |
|:----------|:--------------------------|
| Family | ARM Cortex-M3 |
| Vendor | STMicroelectronics |
| RAM | 20 KiB |
| Flash | 32 KiB/ 64 KiB / 128 KiB |
| Frequency | up to 72 MHz |
| Timer | 3x 16-Bit |
| ADC | 2x 12-bit, 10 channels |
| UART | 3 |
| SPI | 2 |
| I2C | 2 |
| CAN | 1 |
| Vcc | 2.0 to 3.6 V |
| Datasheet | [Datasheet][Datasheet] |
## Implementation Status
| ID | Supported |
|:----- |:--------- |
| GPIO | yes |
| PWM | yes |
| UART | yes |
| ADC | yes |
| I2C | yes |
| SPI | yes |
| USB | no |
| Timer | yes |
| CAN | no |
## Flashing
To program and debug the board you need a SWD capable debugger. The
easiest way is using [OpenOCD][OpenOCD]. By default RIOT uses the hardware
reset signal and connects to the chip under reset for flashing. This is
required to reliably connect to the device even when the MCU is in a low power
mode. Therefore not only SWDIO and SWCLK, but also the RST pin of your
debugger need to be connected to the board. Once the device is connected to
the debugger and OpenOCD is installed, you can flash the device with:
$ make BOARD=bluepill flash
Or for the blackpill with:
$ make BOARD=blackpill flash
### Additional Flash
To make use of the entire 128 KiB flash, compile and flash your application
with:
$ make BOARD=bluepill-128kib flash
Or for the blackpill with:
$ make BOARD=blackpill-128kib flash
This sets the `CPU_MODEL` make variable to `stm32f103cb`, the default
value is `stm32f103c8`. These two CPU models basically only have one
major difference, the former has 128 KiB flash while the latter has 64
KiB.
Flashing for the 128KiB version currently (as of September 2019) requires the
development version of OpenOCD.
## Connecting via Serial
The default UART port used is UART2, which uses pins A2 (TX) and A3 (RX).
To use it, configure your UART to operate at a baudrate of 115200/8N1.
## Using PWM
PWM is available at pins A8 to A11.
## Known Issues
### USB connector
The Micro-USB port is sometimes not soldered properly. Also, it is
usually equipped with an incorrect resistor. [This can be fixed multiple
ways][USB].
### Flashing fails
Please check whether the debugger is properly connected, including the hardware
reset signal pin.
| Pin on Debugger | Pin on Blue Pill |
|:------------------ |:---------------- |
| SWDIO | DIO |
| SWCLK | DCLK |
| NRST | R |
| GND | GND |
| VDD (3.3V) (*) | 3.3 |
| Target VCC (**) | 3.3 |
- (*) Most debuggers have a 3.3V supply voltage to power the board. You can
alternatively power the board using the TTL-Adapter or via Micro-USB.
- (**) Some debuggers monitor the voltage of the target MCU. Their target VCC
pin needs to be connected to one of the 3.3V pins of the boards.
Most very cheap SWD debuggers (especially those imported for about 2€ from far
east) do not have a Target VCC pin; they will still work just fine. On these
cheap debuggers the pin to send the reset signal to the board is often either
not present or defunct. You can work around this by pressing the reset button
when OpenOCD wants to connect to the Blue Pill. Hit the reset button again after
flashing in order to boot the newly flashed image.
## Where to buy
The board is sold under different names. On some sites it is called
`bluepill` or `blue pill`. On others you might find it by searching for
`stm32f103c8` or `stm32f103c8t6`.
Try [eBay][eBay] or [AliExpress][AliExpress].
## Further reading
* http://wiki.stm32duino.com/index.php?title=Blue_Pill
* http://wiki.stm32duino.com/index.php?title=Maple_Mini#Clones
* http://www.st.com/content/st_com/en/products/microcontrollers/stm32-32-bit-
arm-cortex-mcus/stm32-mainstream-mcus/stm32f1-series/stm32f103/stm32f103c8.html
[Datasheet]: http://www.st.com/content/ccc/resource/technical/document/datash
eet/33/d4/6f/1d/df/0b/4c/6d/CD00161566.pdf/files/CD00161566.pdf/jcr:content/tran
slations/en.CD00161566.pdf
[Flashsize]:
http://wiki.stm32duino.com/index.php?title=Blue_Pill#128_KB_flash_on_C8_version
[eBay]: https://www.ebay.com/sch/i.html?_nkw=stm32f103c8
[AliExpress]: https://www.aliexpress.com/wholesale?SearchText=STM32F103C8T6
[OpenOCD]: https://github.com/RIOT-OS/RIOT/wiki/OpenOCD
[USB]:
http://wiki.stm32duino.com/index.php?title=Blue_Pill#Hardware_installation
[imgTop]:
http://wiki.stm32duino.com/images/thumb/1/19/STM32_Blue_Pill_top.jpg/800px-
STM32_Blue_Pill_top.jpg
*/

75
boards/common/blxxxpill/include/board_common.h Normal file
View File

@ -0,0 +1,75 @@
/*
* Copyright (C) 2015 TriaGnoSys GmbH
* 2017 Alexander Kurth, Sören Tempel, Tristan Bruns
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_common_blxxxpill
*
* @{
*
* @file
* @brief Peripheral MCU configuration for the bluepill/blackpill board
*
* @author Víctor Ariño <victor.arino@triagnosys.com>
* @author Sören Tempel <tempel@uni-bremen.de>
* @author Tristan Bruns <tbruns@uni-bremen.de>
* @author Alexander Kurth <kurth1@uni-bremen.de>
*/
#ifndef BOARD_COMMON_H
#define BOARD_COMMON_H
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Macros for controlling the on-board LED.
* @{
*/
#ifndef LED0_PORT
#define LED0_PORT GPIOC /**< GPIO-Port the LED is connected to */
#endif
#ifndef LED0_PORTNUM
#define LED0_PORTNUM PORT_C /**< GPIO Port number the LED is connected to */
#endif
#ifndef LED0_PINNUM
#define LED0_PINNUM (13) /**< Pin number the LED is connected to */
#endif
#define LED0_PIN GPIO_PIN(LED0_PORTNUM, LED0_PINNUM) /**< GPIO-Pin the LED is connected to */
#define LED0_MASK (1 << LED0_PINNUM)
#define LED0_ON (LED0_PORT->BSRR = (LED0_MASK << 16)) /**< Turn LED0 on */
#define LED0_OFF (LED0_PORT->BSRR = LED0_MASK) /**< Turn LED0 off */
#define LED0_TOGGLE (LED0_PORT->ODR ^= LED0_MASK) /**< Toggle LED0 */
/** @} */
/**
* @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
/**
* @brief Use the 2nd UART for STDIO on this board
*/
#define STDIO_UART_DEV UART_DEV(1)
/**
* @name xtimer configuration
* @{
*/
#define XTIMER_WIDTH (16)
#define XTIMER_BACKOFF (19)
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* BOARD_COMMON_H */
/** @} */

2
boards/bluepill/include/gpio_params.h → boards/common/blxxxpill/include/gpio_params.h
View File

@ -7,7 +7,7 @@
*/
/**
* @ingroup boards_bluepill
* @ingroup boards_common_blxxxpill
* @{
*
* @file

6
boards/common/stm32f103c8/include/periph_conf.h → boards/common/blxxxpill/include/periph_conf.h
View File

@ -8,13 +8,11 @@
*/
/**
* @defgroup boards_common_stm32f103c8 STM32F103C8 based boards common
* @ingroup boards_common
* @brief Shared files and configuration for STM32F103C8 based boards
* @ingroup boards_common_blxxxpill
* @{
*
* @file
* @brief Peripheral MCU configuration for the bluepill board
* @brief Peripheral MCU configuration for the bluepill/blackpill boards
*
* @author Víctor Ariño <victor.arino@triagnosys.com>
* @author Sören Tempel <tempel@uni-bremen.de>

0
boards/common/stm32f103c8/Makefile.dep
View File