Modification of Mbed-dev library for LQFP48 package microcontrollers: STM32F103C8 (STM32F103C8T6) and STM32F103CB (STM32F103CBT6) (Bluepill boards, Maple mini etc. )

Fork of mbed-STM32F103C8_org by Nothing Special

Library for STM32F103C8 (Bluepill boards etc.).
Use this instead of mbed library.
This library allows the size of the code in the FLASH up to 128kB. Therefore, code also runs on microcontrollers STM32F103CB (eg. Maple mini).
But in the case of STM32F103C8, check the size of the resulting code would not exceed 64kB.

To compile a program with this library, use NUCLEO-F103RB as the target name. !

Changes:

  • Corrected initialization of the HSE + crystal clock (mbed permanent bug), allowing the use of on-board xtal (8MHz).(1)
  • Additionally, it also set USB clock (48Mhz).(2)
  • Definitions of pins and peripherals adjusted to LQFP48 case.
  • Board led LED1 is now PC_13 (3)
  • USER_BUTTON is now PC_14 (4)

    Now the library is complete rebuilt based on mbed-dev v160 (and not yet fully tested).

notes
(1) - In case 8MHz xtal on board, CPU frequency is 72MHz. Without xtal is 64MHz.
(2) - Using the USB interface is only possible if STM32 is clocking by on-board 8MHz xtal or external clock signal 8MHz on the OSC_IN pin.
(3) - On Bluepill board led operation is reversed, i.e. 0 - led on, 1 - led off.
(4) - Bluepill board has no real user button

Information

After export to SW4STM (AC6):

  • add line #include "mbed_config.h" in files Serial.h and RawSerial.h
  • in project properties change Optimisation Level to Optimise for size (-Os)
Committer:
mega64
Date:
Thu Apr 27 23:56:38 2017 +0000
Revision:
148:8b0b02bf146f
Parent:
147:38a0c20c7b3e
Remove unnecessary folders

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mega64 147:38a0c20c7b3e 1
mega64 147:38a0c20c7b3e 2 /** \addtogroup hal */
mega64 147:38a0c20c7b3e 3 /** @{*/
mega64 147:38a0c20c7b3e 4 /* mbed Microcontroller Library
mega64 147:38a0c20c7b3e 5 * Copyright (c) 2006-2013 ARM Limited
mega64 147:38a0c20c7b3e 6 *
mega64 147:38a0c20c7b3e 7 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 147:38a0c20c7b3e 8 * you may not use this file except in compliance with the License.
mega64 147:38a0c20c7b3e 9 * You may obtain a copy of the License at
mega64 147:38a0c20c7b3e 10 *
mega64 147:38a0c20c7b3e 11 * http://www.apache.org/licenses/LICENSE-2.0
mega64 147:38a0c20c7b3e 12 *
mega64 147:38a0c20c7b3e 13 * Unless required by applicable law or agreed to in writing, software
mega64 147:38a0c20c7b3e 14 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 147:38a0c20c7b3e 15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 147:38a0c20c7b3e 16 * See the License for the specific language governing permissions and
mega64 147:38a0c20c7b3e 17 * limitations under the License.
mega64 147:38a0c20c7b3e 18 */
mega64 147:38a0c20c7b3e 19 #ifndef MBED_GPIO_API_H
mega64 147:38a0c20c7b3e 20 #define MBED_GPIO_API_H
mega64 147:38a0c20c7b3e 21
mega64 147:38a0c20c7b3e 22 #include <stdint.h>
mega64 147:38a0c20c7b3e 23 #include "device.h"
mega64 147:38a0c20c7b3e 24
mega64 147:38a0c20c7b3e 25 #ifdef __cplusplus
mega64 147:38a0c20c7b3e 26 extern "C" {
mega64 147:38a0c20c7b3e 27 #endif
mega64 147:38a0c20c7b3e 28
mega64 147:38a0c20c7b3e 29 /**
mega64 147:38a0c20c7b3e 30 * \defgroup hal_gpio GPIO HAL functions
mega64 147:38a0c20c7b3e 31 * @{
mega64 147:38a0c20c7b3e 32 */
mega64 147:38a0c20c7b3e 33
mega64 147:38a0c20c7b3e 34 /** Set the given pin as GPIO
mega64 147:38a0c20c7b3e 35 *
mega64 147:38a0c20c7b3e 36 * @param pin The pin to be set as GPIO
mega64 147:38a0c20c7b3e 37 * @return The GPIO port mask for this pin
mega64 147:38a0c20c7b3e 38 **/
mega64 147:38a0c20c7b3e 39 uint32_t gpio_set(PinName pin);
mega64 147:38a0c20c7b3e 40 /* Checks if gpio object is connected (pin was not initialized with NC)
mega64 147:38a0c20c7b3e 41 * @param pin The pin to be set as GPIO
mega64 147:38a0c20c7b3e 42 * @return 0 if port is initialized with NC
mega64 147:38a0c20c7b3e 43 **/
mega64 147:38a0c20c7b3e 44 int gpio_is_connected(const gpio_t *obj);
mega64 147:38a0c20c7b3e 45
mega64 147:38a0c20c7b3e 46 /** Initialize the GPIO pin
mega64 147:38a0c20c7b3e 47 *
mega64 147:38a0c20c7b3e 48 * @param obj The GPIO object to initialize
mega64 147:38a0c20c7b3e 49 * @param pin The GPIO pin to initialize
mega64 147:38a0c20c7b3e 50 */
mega64 147:38a0c20c7b3e 51 void gpio_init(gpio_t *obj, PinName pin);
mega64 147:38a0c20c7b3e 52
mega64 147:38a0c20c7b3e 53 /** Set the input pin mode
mega64 147:38a0c20c7b3e 54 *
mega64 147:38a0c20c7b3e 55 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 56 * @param mode The pin mode to be set
mega64 147:38a0c20c7b3e 57 */
mega64 147:38a0c20c7b3e 58 void gpio_mode(gpio_t *obj, PinMode mode);
mega64 147:38a0c20c7b3e 59
mega64 147:38a0c20c7b3e 60 /** Set the pin direction
mega64 147:38a0c20c7b3e 61 *
mega64 147:38a0c20c7b3e 62 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 63 * @param direction The pin direction to be set
mega64 147:38a0c20c7b3e 64 */
mega64 147:38a0c20c7b3e 65 void gpio_dir(gpio_t *obj, PinDirection direction);
mega64 147:38a0c20c7b3e 66
mega64 147:38a0c20c7b3e 67 /** Set the output value
mega64 147:38a0c20c7b3e 68 *
mega64 147:38a0c20c7b3e 69 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 70 * @param value The value to be set
mega64 147:38a0c20c7b3e 71 */
mega64 147:38a0c20c7b3e 72 void gpio_write(gpio_t *obj, int value);
mega64 147:38a0c20c7b3e 73
mega64 147:38a0c20c7b3e 74 /** Read the input value
mega64 147:38a0c20c7b3e 75 *
mega64 147:38a0c20c7b3e 76 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 77 * @return An integer value 1 or 0
mega64 147:38a0c20c7b3e 78 */
mega64 147:38a0c20c7b3e 79 int gpio_read(gpio_t *obj);
mega64 147:38a0c20c7b3e 80
mega64 147:38a0c20c7b3e 81 // the following functions are generic and implemented in the common gpio.c file
mega64 147:38a0c20c7b3e 82 // TODO: fix, will be moved to the common gpio header file
mega64 147:38a0c20c7b3e 83
mega64 147:38a0c20c7b3e 84 /** Init the input pin and set mode to PullDefault
mega64 147:38a0c20c7b3e 85 *
mega64 147:38a0c20c7b3e 86 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 87 * @param pin The pin name
mega64 147:38a0c20c7b3e 88 */
mega64 147:38a0c20c7b3e 89 void gpio_init_in(gpio_t* gpio, PinName pin);
mega64 147:38a0c20c7b3e 90
mega64 147:38a0c20c7b3e 91 /** Init the input pin and set the mode
mega64 147:38a0c20c7b3e 92 *
mega64 147:38a0c20c7b3e 93 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 94 * @param pin The pin name
mega64 147:38a0c20c7b3e 95 * @param mode The pin mode to be set
mega64 147:38a0c20c7b3e 96 */
mega64 147:38a0c20c7b3e 97 void gpio_init_in_ex(gpio_t* gpio, PinName pin, PinMode mode);
mega64 147:38a0c20c7b3e 98
mega64 147:38a0c20c7b3e 99 /** Init the output pin as an output, with predefined output value 0
mega64 147:38a0c20c7b3e 100 *
mega64 147:38a0c20c7b3e 101 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 102 * @param pin The pin name
mega64 147:38a0c20c7b3e 103 * @return An integer value 1 or 0
mega64 147:38a0c20c7b3e 104 */
mega64 147:38a0c20c7b3e 105 void gpio_init_out(gpio_t* gpio, PinName pin);
mega64 147:38a0c20c7b3e 106
mega64 147:38a0c20c7b3e 107 /** Init the pin as an output and set the output value
mega64 147:38a0c20c7b3e 108 *
mega64 147:38a0c20c7b3e 109 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 110 * @param pin The pin name
mega64 147:38a0c20c7b3e 111 * @param value The value to be set
mega64 147:38a0c20c7b3e 112 */
mega64 147:38a0c20c7b3e 113 void gpio_init_out_ex(gpio_t* gpio, PinName pin, int value);
mega64 147:38a0c20c7b3e 114
mega64 147:38a0c20c7b3e 115 /** Init the pin to be in/out
mega64 147:38a0c20c7b3e 116 *
mega64 147:38a0c20c7b3e 117 * @param obj The GPIO object
mega64 147:38a0c20c7b3e 118 * @param pin The pin name
mega64 147:38a0c20c7b3e 119 * @param direction The pin direction to be set
mega64 147:38a0c20c7b3e 120 * @param mode The pin mode to be set
mega64 147:38a0c20c7b3e 121 * @param value The value to be set for an output pin
mega64 147:38a0c20c7b3e 122 */
mega64 147:38a0c20c7b3e 123 void gpio_init_inout(gpio_t* gpio, PinName pin, PinDirection direction, PinMode mode, int value);
mega64 147:38a0c20c7b3e 124
mega64 147:38a0c20c7b3e 125 /**@}*/
mega64 147:38a0c20c7b3e 126
mega64 147:38a0c20c7b3e 127 #ifdef __cplusplus
mega64 147:38a0c20c7b3e 128 }
mega64 147:38a0c20c7b3e 129 #endif
mega64 147:38a0c20c7b3e 130
mega64 147:38a0c20c7b3e 131 #endif
mega64 147:38a0c20c7b3e 132
mega64 147:38a0c20c7b3e 133 /** @}*/