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)

platform/SingletonPtr.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
mega64 146:03e976389d16 2 /** \addtogroup platform */
mega64 146:03e976389d16 3 /** @{*/
mega64 146:03e976389d16 4 /* mbed Microcontroller Library
mega64 146:03e976389d16 5 * Copyright (c) 2006-2013 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 SINGLETONPTR_H
mega64 146:03e976389d16 20 #define SINGLETONPTR_H
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 #include <stdint.h>
mega64 146:03e976389d16 23 #include <new>
mega64 146:03e976389d16 24 #include "platform/mbed_assert.h"
mega64 146:03e976389d16 25 #ifdef MBED_CONF_RTOS_PRESENT
mega64 146:03e976389d16 26 #include "cmsis_os.h"
mega64 146:03e976389d16 27 #endif
mega64 146:03e976389d16 28
mega64 146:03e976389d16 29 #ifdef MBED_CONF_RTOS_PRESENT
mega64 146:03e976389d16 30 extern osMutexId singleton_mutex_id;
mega64 146:03e976389d16 31 #endif
mega64 146:03e976389d16 32
mega64 146:03e976389d16 33 /** Lock the singleton mutex
mega64 146:03e976389d16 34 *
mega64 146:03e976389d16 35 * This function is typically used to provide
mega64 146:03e976389d16 36 * exclusive access when initializing a
mega64 146:03e976389d16 37 * global object.
mega64 146:03e976389d16 38 */
mega64 146:03e976389d16 39 inline static void singleton_lock(void)
mega64 146:03e976389d16 40 {
mega64 146:03e976389d16 41 #ifdef MBED_CONF_RTOS_PRESENT
mega64 146:03e976389d16 42 osMutexWait(singleton_mutex_id, osWaitForever);
mega64 146:03e976389d16 43 #endif
mega64 146:03e976389d16 44 }
mega64 146:03e976389d16 45
mega64 146:03e976389d16 46 /** Unlock the singleton mutex
mega64 146:03e976389d16 47 *
mega64 146:03e976389d16 48 * This function is typically used to provide
mega64 146:03e976389d16 49 * exclusive access when initializing a
mega64 146:03e976389d16 50 * global object.
mega64 146:03e976389d16 51 */
mega64 146:03e976389d16 52 inline static void singleton_unlock(void)
mega64 146:03e976389d16 53 {
mega64 146:03e976389d16 54 #ifdef MBED_CONF_RTOS_PRESENT
mega64 146:03e976389d16 55 osMutexRelease (singleton_mutex_id);
mega64 146:03e976389d16 56 #endif
mega64 146:03e976389d16 57 }
mega64 146:03e976389d16 58
mega64 146:03e976389d16 59 /** Utility class for creating an using a singleton
mega64 146:03e976389d16 60 *
mega64 146:03e976389d16 61 * @Note Synchronization level: Thread safe
mega64 146:03e976389d16 62 *
mega64 146:03e976389d16 63 * @Note: This class must only be used in a static context -
mega64 146:03e976389d16 64 * this class must never be allocated or created on the
mega64 146:03e976389d16 65 * stack.
mega64 146:03e976389d16 66 *
mega64 146:03e976389d16 67 * @Note: This class is lazily initialized on first use.
mega64 146:03e976389d16 68 * This class is a POD type so if it is not used it will
mega64 146:03e976389d16 69 * be garbage collected.
mega64 146:03e976389d16 70 */
mega64 146:03e976389d16 71 template <class T>
mega64 146:03e976389d16 72 struct SingletonPtr {
mega64 146:03e976389d16 73
mega64 146:03e976389d16 74 /** Get a pointer to the underlying singleton
mega64 146:03e976389d16 75 *
mega64 146:03e976389d16 76 * @returns
mega64 146:03e976389d16 77 * A pointer to the singleton
mega64 146:03e976389d16 78 */
mega64 146:03e976389d16 79 T* get() {
mega64 146:03e976389d16 80 if (NULL == _ptr) {
mega64 146:03e976389d16 81 singleton_lock();
mega64 146:03e976389d16 82 if (NULL == _ptr) {
mega64 146:03e976389d16 83 _ptr = new (_data) T();
mega64 146:03e976389d16 84 }
mega64 146:03e976389d16 85 singleton_unlock();
mega64 146:03e976389d16 86 }
mega64 146:03e976389d16 87 // _ptr was not zero initialized or was
mega64 146:03e976389d16 88 // corrupted if this assert is hit
mega64 146:03e976389d16 89 MBED_ASSERT(_ptr == (T *)&_data);
mega64 146:03e976389d16 90 return _ptr;
mega64 146:03e976389d16 91 }
mega64 146:03e976389d16 92
mega64 146:03e976389d16 93 /** Get a pointer to the underlying singleton
mega64 146:03e976389d16 94 *
mega64 146:03e976389d16 95 * @returns
mega64 146:03e976389d16 96 * A pointer to the singleton
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 T* operator->() {
mega64 146:03e976389d16 99 return get();
mega64 146:03e976389d16 100 }
mega64 146:03e976389d16 101
mega64 146:03e976389d16 102 // This is zero initialized when in global scope
mega64 146:03e976389d16 103 T *_ptr;
mega64 146:03e976389d16 104 // Force data to be 4 byte aligned
mega64 146:03e976389d16 105 uint32_t _data[(sizeof(T) + sizeof(uint32_t) - 1) / sizeof(uint32_t)];
mega64 146:03e976389d16 106 };
mega64 146:03e976389d16 107
mega64 146:03e976389d16 108 #endif
mega64 146:03e976389d16 109
mega64 146:03e976389d16 110 /** @}*/