Nothing Special / mbed-STM32F103C8

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)

hal/flash_api.h@148:8b0b02bf146f, 2017-04-27 (annotated)

Committer:
mega64
Date:
Thu Apr 27 23:56:38 2017 +0000
Revision:
148:8b0b02bf146f
Parent:
146:03e976389d16 
Remove unnecessary folders

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mega64 146:03e976389d16 1 /** \addtogroup hal */
mega64 146:03e976389d16 2 /** @{*/
mega64 146:03e976389d16 3
mega64 146:03e976389d16 4 /* mbed Microcontroller Library
mega64 146:03e976389d16 5 * Copyright (c) 2017 ARM Limited
mega64 146:03e976389d16 6 *
mega64 146:03e976389d16 7 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 146:03e976389d16 8 * you may not use this file except in compliance with the License.
mega64 146:03e976389d16 9 * You may obtain a copy of the License at
mega64 146:03e976389d16 10 *
mega64 146:03e976389d16 11 * http://www.apache.org/licenses/LICENSE-2.0
mega64 146:03e976389d16 12 *
mega64 146:03e976389d16 13 * Unless required by applicable law or agreed to in writing, software
mega64 146:03e976389d16 14 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 146:03e976389d16 15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 146:03e976389d16 16 * See the License for the specific language governing permissions and
mega64 146:03e976389d16 17 * limitations under the License.
mega64 146:03e976389d16 18 */
mega64 146:03e976389d16 19 #ifndef MBED_FLASH_API_H
mega64 146:03e976389d16 20 #define MBED_FLASH_API_H
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 #include "device.h"
mega64 146:03e976389d16 23 #include <stdint.h>
mega64 146:03e976389d16 24
mega64 146:03e976389d16 25 #if DEVICE_FLASH
mega64 146:03e976389d16 26
mega64 146:03e976389d16 27 #define MBED_FLASH_INVALID_SIZE 0xFFFFFFFF
mega64 146:03e976389d16 28
mega64 146:03e976389d16 29 typedef struct flash_s flash_t;
mega64 146:03e976389d16 30
mega64 146:03e976389d16 31 #if TARGET_FLASH_CMSIS_ALGO
mega64 146:03e976389d16 32 #include "flash_data.h"
mega64 146:03e976389d16 33 #endif
mega64 146:03e976389d16 34
mega64 146:03e976389d16 35 #ifdef __cplusplus
mega64 146:03e976389d16 36 extern "C" {
mega64 146:03e976389d16 37 #endif
mega64 146:03e976389d16 38
mega64 146:03e976389d16 39 /**
mega64 146:03e976389d16 40 * \defgroup flash_hal Flash HAL API
mega64 146:03e976389d16 41 * @{
mega64 146:03e976389d16 42 */
mega64 146:03e976389d16 43
mega64 146:03e976389d16 44 /** Initialize the flash peripheral and the flash_t object
mega64 146:03e976389d16 45 *
mega64 146:03e976389d16 46 * @param obj The flash object
mega64 146:03e976389d16 47 * @return 0 for success, -1 for error
mega64 146:03e976389d16 48 */
mega64 146:03e976389d16 49 int32_t flash_init(flash_t *obj);
mega64 146:03e976389d16 50
mega64 146:03e976389d16 51 /** Uninitialize the flash peripheral and the flash_t object
mega64 146:03e976389d16 52 *
mega64 146:03e976389d16 53 * @param obj The flash object
mega64 146:03e976389d16 54 * @return 0 for success, -1 for error
mega64 146:03e976389d16 55 */
mega64 146:03e976389d16 56 int32_t flash_free(flash_t *obj);
mega64 146:03e976389d16 57
mega64 146:03e976389d16 58 /** Erase one sector starting at defined address
mega64 146:03e976389d16 59 *
mega64 146:03e976389d16 60 * The address should be at sector boundary. This function does not do any check for address alignments
mega64 146:03e976389d16 61 * @param obj The flash object
mega64 146:03e976389d16 62 * @param address The sector starting address
mega64 146:03e976389d16 63 * @return 0 for success, -1 for error
mega64 146:03e976389d16 64 */
mega64 146:03e976389d16 65 int32_t flash_erase_sector(flash_t *obj, uint32_t address);
mega64 146:03e976389d16 66
mega64 146:03e976389d16 67 /** Program one page starting at defined address
mega64 146:03e976389d16 68 *
mega64 146:03e976389d16 69 * The page should be at page boundary, should not cross multiple sectors.
mega64 146:03e976389d16 70 * This function does not do any check for address alignments or if size is aligned to a page size.
mega64 146:03e976389d16 71 * @param obj The flash object
mega64 146:03e976389d16 72 * @param address The sector starting address
mega64 146:03e976389d16 73 * @param data The data buffer to be programmed
mega64 146:03e976389d16 74 * @param size The number of bytes to program
mega64 146:03e976389d16 75 * @return 0 for success, -1 for error
mega64 146:03e976389d16 76 */
mega64 146:03e976389d16 77 int32_t flash_program_page(flash_t *obj, uint32_t address, const uint8_t *data, uint32_t size);
mega64 146:03e976389d16 78
mega64 146:03e976389d16 79 /** Get sector size
mega64 146:03e976389d16 80 *
mega64 146:03e976389d16 81 * @param obj The flash object
mega64 146:03e976389d16 82 * @param address The sector starting address
mega64 146:03e976389d16 83 * @return The size of a sector
mega64 146:03e976389d16 84 */
mega64 146:03e976389d16 85 uint32_t flash_get_sector_size(const flash_t *obj, uint32_t address);
mega64 146:03e976389d16 86
mega64 146:03e976389d16 87 /** Get page size
mega64 146:03e976389d16 88 *
mega64 146:03e976389d16 89 * @param obj The flash object
mega64 146:03e976389d16 90 * @param address The page starting address
mega64 146:03e976389d16 91 * @return The size of a page
mega64 146:03e976389d16 92 */
mega64 146:03e976389d16 93 uint32_t flash_get_page_size(const flash_t *obj);
mega64 146:03e976389d16 94
mega64 146:03e976389d16 95 /** Get start address for the flash region
mega64 146:03e976389d16 96 *
mega64 146:03e976389d16 97 * @param obj The flash object
mega64 146:03e976389d16 98 * @return The start address for the flash region
mega64 146:03e976389d16 99 */
mega64 146:03e976389d16 100 uint32_t flash_get_start_address(const flash_t *obj);
mega64 146:03e976389d16 101
mega64 146:03e976389d16 102 /** Get the flash region size
mega64 146:03e976389d16 103 *
mega64 146:03e976389d16 104 * @param obj The flash object
mega64 146:03e976389d16 105 * @return The flash region size
mega64 146:03e976389d16 106 */
mega64 146:03e976389d16 107 uint32_t flash_get_size(const flash_t *obj);
mega64 146:03e976389d16 108
mega64 146:03e976389d16 109 /**@}*/
mega64 146:03e976389d16 110
mega64 146:03e976389d16 111 #ifdef __cplusplus
mega64 146:03e976389d16 112 }
mega64 146:03e976389d16 113 #endif
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 #endif
mega64 146:03e976389d16 116
mega64 146:03e976389d16 117 #endif
mega64 146:03e976389d16 118
mega64 146:03e976389d16 119 /** @}*/