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/CallChain.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 /* mbed Microcontroller Library
mega64 146:03e976389d16 2 * Copyright (c) 2006-2013 ARM Limited
mega64 146:03e976389d16 3 *
mega64 146:03e976389d16 4 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 146:03e976389d16 5 * you may not use this file except in compliance with the License.
mega64 146:03e976389d16 6 * You may obtain a copy of the License at
mega64 146:03e976389d16 7 *
mega64 146:03e976389d16 8 * http://www.apache.org/licenses/LICENSE-2.0
mega64 146:03e976389d16 9 *
mega64 146:03e976389d16 10 * Unless required by applicable law or agreed to in writing, software
mega64 146:03e976389d16 11 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 146:03e976389d16 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 146:03e976389d16 13 * See the License for the specific language governing permissions and
mega64 146:03e976389d16 14 * limitations under the License.
mega64 146:03e976389d16 15 */
mega64 146:03e976389d16 16 #ifndef MBED_CALLCHAIN_H
mega64 146:03e976389d16 17 #define MBED_CALLCHAIN_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/Callback.h"
mega64 146:03e976389d16 20 #include "platform/mbed_toolchain.h"
mega64 146:03e976389d16 21 #include <string.h>
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 namespace mbed {
mega64 146:03e976389d16 24 /** \addtogroup platform */
mega64 146:03e976389d16 25 /** @{*/
mega64 146:03e976389d16 26
mega64 146:03e976389d16 27 /** Group one or more functions in an instance of a CallChain, then call them in
mega64 146:03e976389d16 28 * sequence using CallChain::call(). Used mostly by the interrupt chaining code,
mega64 146:03e976389d16 29 * but can be used for other purposes.
mega64 146:03e976389d16 30 *
mega64 146:03e976389d16 31 * @Note Synchronization level: Not protected
mega64 146:03e976389d16 32 *
mega64 146:03e976389d16 33 * Example:
mega64 146:03e976389d16 34 * @code
mega64 146:03e976389d16 35 * #include "mbed.h"
mega64 146:03e976389d16 36 *
mega64 146:03e976389d16 37 * CallChain chain;
mega64 146:03e976389d16 38 *
mega64 146:03e976389d16 39 * void first(void) {
mega64 146:03e976389d16 40 * printf("'first' function.\n");
mega64 146:03e976389d16 41 * }
mega64 146:03e976389d16 42 *
mega64 146:03e976389d16 43 * void second(void) {
mega64 146:03e976389d16 44 * printf("'second' function.\n");
mega64 146:03e976389d16 45 * }
mega64 146:03e976389d16 46 *
mega64 146:03e976389d16 47 * class Test {
mega64 146:03e976389d16 48 * public:
mega64 146:03e976389d16 49 * void f(void) {
mega64 146:03e976389d16 50 * printf("A::f (class member).\n");
mega64 146:03e976389d16 51 * }
mega64 146:03e976389d16 52 * };
mega64 146:03e976389d16 53 *
mega64 146:03e976389d16 54 * int main() {
mega64 146:03e976389d16 55 * Test test;
mega64 146:03e976389d16 56 *
mega64 146:03e976389d16 57 * chain.add(second);
mega64 146:03e976389d16 58 * chain.add_front(first);
mega64 146:03e976389d16 59 * chain.add(&test, &Test::f);
mega64 146:03e976389d16 60 * chain.call();
mega64 146:03e976389d16 61 * }
mega64 146:03e976389d16 62 * @endcode
mega64 146:03e976389d16 63 */
mega64 146:03e976389d16 64
mega64 146:03e976389d16 65 typedef Callback<void()> *pFunctionPointer_t;
mega64 146:03e976389d16 66 class CallChainLink;
mega64 146:03e976389d16 67
mega64 146:03e976389d16 68 class CallChain {
mega64 146:03e976389d16 69 public:
mega64 146:03e976389d16 70 /** Create an empty chain
mega64 146:03e976389d16 71 *
mega64 146:03e976389d16 72 * @param size (optional) Initial size of the chain
mega64 146:03e976389d16 73 */
mega64 146:03e976389d16 74 CallChain(int size = 4);
mega64 146:03e976389d16 75 virtual ~CallChain();
mega64 146:03e976389d16 76
mega64 146:03e976389d16 77 /** Add a function at the end of the chain
mega64 146:03e976389d16 78 *
mega64 146:03e976389d16 79 * @param func A pointer to a void function
mega64 146:03e976389d16 80 *
mega64 146:03e976389d16 81 * @returns
mega64 146:03e976389d16 82 * The function object created for 'func'
mega64 146:03e976389d16 83 */
mega64 146:03e976389d16 84 pFunctionPointer_t add(Callback<void()> func);
mega64 146:03e976389d16 85
mega64 146:03e976389d16 86 /** Add a function at the end of the chain
mega64 146:03e976389d16 87 *
mega64 146:03e976389d16 88 * @param obj pointer to the object to call the member function on
mega64 146:03e976389d16 89 * @param method pointer to the member function to be called
mega64 146:03e976389d16 90 *
mega64 146:03e976389d16 91 * @returns
mega64 146:03e976389d16 92 * The function object created for 'obj' and 'method'
mega64 146:03e976389d16 93 *
mega64 146:03e976389d16 94 * @deprecated
mega64 146:03e976389d16 95 * The add function does not support cv-qualifiers. Replaced by
mega64 146:03e976389d16 96 * add(callback(obj, method)).
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 template<typename T, typename M>
mega64 146:03e976389d16 99 MBED_DEPRECATED_SINCE("mbed-os-5.1",
mega64 146:03e976389d16 100 "The add function does not support cv-qualifiers. Replaced by "
mega64 146:03e976389d16 101 "add(callback(obj, method)).")
mega64 146:03e976389d16 102 pFunctionPointer_t add(T *obj, M method) {
mega64 146:03e976389d16 103 return add(callback(obj, method));
mega64 146:03e976389d16 104 }
mega64 146:03e976389d16 105
mega64 146:03e976389d16 106 /** Add a function at the beginning of the chain
mega64 146:03e976389d16 107 *
mega64 146:03e976389d16 108 * @param func A pointer to a void function
mega64 146:03e976389d16 109 *
mega64 146:03e976389d16 110 * @returns
mega64 146:03e976389d16 111 * The function object created for 'func'
mega64 146:03e976389d16 112 */
mega64 146:03e976389d16 113 pFunctionPointer_t add_front(Callback<void()> func);
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 /** Add a function at the beginning of the chain
mega64 146:03e976389d16 116 *
mega64 146:03e976389d16 117 * @param tptr pointer to the object to call the member function on
mega64 146:03e976389d16 118 * @param mptr pointer to the member function to be called
mega64 146:03e976389d16 119 *
mega64 146:03e976389d16 120 * @returns
mega64 146:03e976389d16 121 * The function object created for 'tptr' and 'mptr'
mega64 146:03e976389d16 122 *
mega64 146:03e976389d16 123 * @deprecated
mega64 146:03e976389d16 124 * The add_front function does not support cv-qualifiers. Replaced by
mega64 146:03e976389d16 125 * add_front(callback(obj, method)).
mega64 146:03e976389d16 126 */
mega64 146:03e976389d16 127 template<typename T, typename M>
mega64 146:03e976389d16 128 MBED_DEPRECATED_SINCE("mbed-os-5.1",
mega64 146:03e976389d16 129 "The add_front function does not support cv-qualifiers. Replaced by "
mega64 146:03e976389d16 130 "add_front(callback(obj, method)).")
mega64 146:03e976389d16 131 pFunctionPointer_t add_front(T *obj, M method) {
mega64 146:03e976389d16 132 return add_front(callback(obj, method));
mega64 146:03e976389d16 133 }
mega64 146:03e976389d16 134
mega64 146:03e976389d16 135 /** Get the number of functions in the chain
mega64 146:03e976389d16 136 */
mega64 146:03e976389d16 137 int size() const;
mega64 146:03e976389d16 138
mega64 146:03e976389d16 139 /** Get a function object from the chain
mega64 146:03e976389d16 140 *
mega64 146:03e976389d16 141 * @param i function object index
mega64 146:03e976389d16 142 *
mega64 146:03e976389d16 143 * @returns
mega64 146:03e976389d16 144 * The function object at position 'i' in the chain
mega64 146:03e976389d16 145 */
mega64 146:03e976389d16 146 pFunctionPointer_t get(int i) const;
mega64 146:03e976389d16 147
mega64 146:03e976389d16 148 /** Look for a function object in the call chain
mega64 146:03e976389d16 149 *
mega64 146:03e976389d16 150 * @param f the function object to search
mega64 146:03e976389d16 151 *
mega64 146:03e976389d16 152 * @returns
mega64 146:03e976389d16 153 * The index of the function object if found, -1 otherwise.
mega64 146:03e976389d16 154 */
mega64 146:03e976389d16 155 int find(pFunctionPointer_t f) const;
mega64 146:03e976389d16 156
mega64 146:03e976389d16 157 /** Clear the call chain (remove all functions in the chain).
mega64 146:03e976389d16 158 */
mega64 146:03e976389d16 159 void clear();
mega64 146:03e976389d16 160
mega64 146:03e976389d16 161 /** Remove a function object from the chain
mega64 146:03e976389d16 162 *
mega64 146:03e976389d16 163 * @arg f the function object to remove
mega64 146:03e976389d16 164 *
mega64 146:03e976389d16 165 * @returns
mega64 146:03e976389d16 166 * true if the function object was found and removed, false otherwise.
mega64 146:03e976389d16 167 */
mega64 146:03e976389d16 168 bool remove(pFunctionPointer_t f);
mega64 146:03e976389d16 169
mega64 146:03e976389d16 170 /** Call all the functions in the chain in sequence
mega64 146:03e976389d16 171 */
mega64 146:03e976389d16 172 void call();
mega64 146:03e976389d16 173
mega64 146:03e976389d16 174 void operator ()(void) {
mega64 146:03e976389d16 175 call();
mega64 146:03e976389d16 176 }
mega64 146:03e976389d16 177 pFunctionPointer_t operator [](int i) const {
mega64 146:03e976389d16 178 return get(i);
mega64 146:03e976389d16 179 }
mega64 146:03e976389d16 180
mega64 146:03e976389d16 181 /* disallow copy constructor and assignment operators */
mega64 146:03e976389d16 182 private:
mega64 146:03e976389d16 183 CallChain(const CallChain&);
mega64 146:03e976389d16 184 CallChain & operator = (const CallChain&);
mega64 146:03e976389d16 185 CallChainLink *_chain;
mega64 146:03e976389d16 186 };
mega64 146:03e976389d16 187
mega64 146:03e976389d16 188 } // namespace mbed
mega64 146:03e976389d16 189
mega64 146:03e976389d16 190 #endif
mega64 146:03e976389d16 191
mega64 146:03e976389d16 192 /** @}*/