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)

drivers/FlashIAP.cpp@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 /* mbed Microcontroller Library
mega64 146:03e976389d16 2 * Copyright (c) 2017 ARM Limited
mega64 146:03e976389d16 3 *
mega64 146:03e976389d16 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
mega64 146:03e976389d16 5 * of this software and associated documentation files (the "Software"), to deal
mega64 146:03e976389d16 6 * in the Software without restriction, including without limitation the rights
mega64 146:03e976389d16 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
mega64 146:03e976389d16 8 * copies of the Software, and to permit persons to whom the Software is
mega64 146:03e976389d16 9 * furnished to do so, subject to the following conditions:
mega64 146:03e976389d16 10 *
mega64 146:03e976389d16 11 * The above copyright notice and this permission notice shall be included in
mega64 146:03e976389d16 12 * all copies or substantial portions of the Software.
mega64 146:03e976389d16 13 *
mega64 146:03e976389d16 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
mega64 146:03e976389d16 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
mega64 146:03e976389d16 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
mega64 146:03e976389d16 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
mega64 146:03e976389d16 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
mega64 146:03e976389d16 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
mega64 146:03e976389d16 20 * SOFTWARE.
mega64 146:03e976389d16 21 */
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 #include <string.h>
mega64 146:03e976389d16 24 #include "FlashIAP.h"
mega64 146:03e976389d16 25 #include "mbed_assert.h"
mega64 146:03e976389d16 26
mega64 146:03e976389d16 27
mega64 146:03e976389d16 28 #ifdef DEVICE_FLASH
mega64 146:03e976389d16 29
mega64 146:03e976389d16 30 namespace mbed {
mega64 146:03e976389d16 31
mega64 146:03e976389d16 32 SingletonPtr<PlatformMutex> FlashIAP::_mutex;
mega64 146:03e976389d16 33
mega64 146:03e976389d16 34 static inline bool is_aligned(uint32_t number, uint32_t alignment)
mega64 146:03e976389d16 35 {
mega64 146:03e976389d16 36 if ((number % alignment) != 0) {
mega64 146:03e976389d16 37 return false;
mega64 146:03e976389d16 38 } else {
mega64 146:03e976389d16 39 return true;
mega64 146:03e976389d16 40 }
mega64 146:03e976389d16 41 }
mega64 146:03e976389d16 42
mega64 146:03e976389d16 43 FlashIAP::FlashIAP()
mega64 146:03e976389d16 44 {
mega64 146:03e976389d16 45
mega64 146:03e976389d16 46 }
mega64 146:03e976389d16 47
mega64 146:03e976389d16 48 FlashIAP::~FlashIAP()
mega64 146:03e976389d16 49 {
mega64 146:03e976389d16 50
mega64 146:03e976389d16 51 }
mega64 146:03e976389d16 52
mega64 146:03e976389d16 53 int FlashIAP::init()
mega64 146:03e976389d16 54 {
mega64 146:03e976389d16 55 int ret = 0;
mega64 146:03e976389d16 56 _mutex->lock();
mega64 146:03e976389d16 57 if (flash_init(&_flash)) {
mega64 146:03e976389d16 58 ret = -1;
mega64 146:03e976389d16 59 }
mega64 146:03e976389d16 60 _mutex->unlock();
mega64 146:03e976389d16 61 return ret;
mega64 146:03e976389d16 62 }
mega64 146:03e976389d16 63
mega64 146:03e976389d16 64 int FlashIAP::deinit()
mega64 146:03e976389d16 65 {
mega64 146:03e976389d16 66 int ret = 0;
mega64 146:03e976389d16 67 _mutex->lock();
mega64 146:03e976389d16 68 if (flash_free(&_flash)) {
mega64 146:03e976389d16 69 ret = -1;
mega64 146:03e976389d16 70 }
mega64 146:03e976389d16 71 _mutex->unlock();
mega64 146:03e976389d16 72 return ret;
mega64 146:03e976389d16 73 }
mega64 146:03e976389d16 74
mega64 146:03e976389d16 75
mega64 146:03e976389d16 76 int FlashIAP::read(void *buffer, uint32_t addr, uint32_t size)
mega64 146:03e976389d16 77 {
mega64 146:03e976389d16 78 _mutex->lock();
mega64 146:03e976389d16 79 memcpy(buffer, (const void *)addr, size);
mega64 146:03e976389d16 80 _mutex->unlock();
mega64 146:03e976389d16 81 return 0;
mega64 146:03e976389d16 82 }
mega64 146:03e976389d16 83
mega64 146:03e976389d16 84 int FlashIAP::program(const void *buffer, uint32_t addr, uint32_t size)
mega64 146:03e976389d16 85 {
mega64 146:03e976389d16 86 uint32_t page_size = get_page_size();
mega64 146:03e976389d16 87 uint32_t current_sector_size = flash_get_sector_size(&_flash, addr);
mega64 146:03e976389d16 88 // addr and size should be aligned to page size, and multiple of page size
mega64 146:03e976389d16 89 // page program should not cross sector boundaries
mega64 146:03e976389d16 90 if (!is_aligned(addr, page_size) ||
mega64 146:03e976389d16 91 !is_aligned(size, page_size) ||
mega64 146:03e976389d16 92 (size < page_size) ||
mega64 146:03e976389d16 93 (((addr % current_sector_size) + size) > current_sector_size)) {
mega64 146:03e976389d16 94 return -1;
mega64 146:03e976389d16 95 }
mega64 146:03e976389d16 96
mega64 146:03e976389d16 97 int ret = 0;
mega64 146:03e976389d16 98 _mutex->lock();
mega64 146:03e976389d16 99 if (flash_program_page(&_flash, addr, (const uint8_t *)buffer, size)) {
mega64 146:03e976389d16 100 ret = -1;
mega64 146:03e976389d16 101 }
mega64 146:03e976389d16 102 _mutex->unlock();
mega64 146:03e976389d16 103 return ret;
mega64 146:03e976389d16 104 }
mega64 146:03e976389d16 105
mega64 146:03e976389d16 106 bool FlashIAP::is_aligned_to_sector(uint32_t addr, uint32_t size)
mega64 146:03e976389d16 107 {
mega64 146:03e976389d16 108 uint32_t current_sector_size = flash_get_sector_size(&_flash, addr);
mega64 146:03e976389d16 109 if (!is_aligned(size, current_sector_size) ||
mega64 146:03e976389d16 110 !is_aligned(addr, current_sector_size)) {
mega64 146:03e976389d16 111 return false;
mega64 146:03e976389d16 112 } else {
mega64 146:03e976389d16 113 return true;
mega64 146:03e976389d16 114 }
mega64 146:03e976389d16 115 }
mega64 146:03e976389d16 116
mega64 146:03e976389d16 117 int FlashIAP::erase(uint32_t addr, uint32_t size)
mega64 146:03e976389d16 118 {
mega64 146:03e976389d16 119 uint32_t current_sector_size = 0UL;
mega64 146:03e976389d16 120
mega64 146:03e976389d16 121 if (!is_aligned_to_sector(addr, size)) {
mega64 146:03e976389d16 122 return -1;
mega64 146:03e976389d16 123 }
mega64 146:03e976389d16 124
mega64 146:03e976389d16 125 int32_t ret = 0;
mega64 146:03e976389d16 126 _mutex->lock();
mega64 146:03e976389d16 127 while (size) {
mega64 146:03e976389d16 128 ret = flash_erase_sector(&_flash, addr);
mega64 146:03e976389d16 129 if (ret != 0) {
mega64 146:03e976389d16 130 ret = -1;
mega64 146:03e976389d16 131 break;
mega64 146:03e976389d16 132 }
mega64 146:03e976389d16 133 current_sector_size = flash_get_sector_size(&_flash, addr);
mega64 146:03e976389d16 134 if (!is_aligned_to_sector(addr, size)) {
mega64 146:03e976389d16 135 ret = -1;
mega64 146:03e976389d16 136 break;
mega64 146:03e976389d16 137 }
mega64 146:03e976389d16 138 size -= current_sector_size;
mega64 146:03e976389d16 139 addr += current_sector_size;
mega64 146:03e976389d16 140 }
mega64 146:03e976389d16 141 _mutex->unlock();
mega64 146:03e976389d16 142 return ret;
mega64 146:03e976389d16 143 }
mega64 146:03e976389d16 144
mega64 146:03e976389d16 145 uint32_t FlashIAP::get_page_size() const
mega64 146:03e976389d16 146 {
mega64 146:03e976389d16 147 return flash_get_page_size(&_flash);
mega64 146:03e976389d16 148 }
mega64 146:03e976389d16 149
mega64 146:03e976389d16 150 uint32_t FlashIAP::get_sector_size(uint32_t addr) const
mega64 146:03e976389d16 151 {
mega64 146:03e976389d16 152 return flash_get_sector_size(&_flash, addr);
mega64 146:03e976389d16 153 }
mega64 146:03e976389d16 154
mega64 146:03e976389d16 155 uint32_t FlashIAP::get_flash_start() const
mega64 146:03e976389d16 156 {
mega64 146:03e976389d16 157 return flash_get_start_address(&_flash);
mega64 146:03e976389d16 158 }
mega64 146:03e976389d16 159
mega64 146:03e976389d16 160 uint32_t FlashIAP::get_flash_size() const
mega64 146:03e976389d16 161 {
mega64 146:03e976389d16 162 return flash_get_size(&_flash);
mega64 146:03e976389d16 163 }
mega64 146:03e976389d16 164
mega64 146:03e976389d16 165 }
mega64 146:03e976389d16 166
mega64 146:03e976389d16 167 #endif