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/BusInOut.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_BUSINOUT_H
mega64 146:03e976389d16 17 #define MBED_BUSINOUT_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "drivers/DigitalInOut.h"
mega64 146:03e976389d16 20 #include "platform/PlatformMutex.h"
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 namespace mbed {
mega64 146:03e976389d16 23 /** \addtogroup drivers */
mega64 146:03e976389d16 24 /** @{*/
mega64 146:03e976389d16 25
mega64 146:03e976389d16 26 /** A digital input output bus, used for setting the state of a collection of pins
mega64 146:03e976389d16 27 *
mega64 146:03e976389d16 28 * @Note Synchronization level: Thread safe
mega64 146:03e976389d16 29 */
mega64 146:03e976389d16 30 class BusInOut {
mega64 146:03e976389d16 31
mega64 146:03e976389d16 32 public:
mega64 146:03e976389d16 33
mega64 146:03e976389d16 34 /** Create an BusInOut, connected to the specified pins
mega64 146:03e976389d16 35 *
mega64 146:03e976389d16 36 * @param p<n> DigitalInOut pin to connect to bus bit p<n> (p5-p30, NC)
mega64 146:03e976389d16 37 *
mega64 146:03e976389d16 38 * @note
mega64 146:03e976389d16 39 * It is only required to specify as many pin variables as is required
mega64 146:03e976389d16 40 * for the bus; the rest will default to NC (not connected)
mega64 146:03e976389d16 41 */
mega64 146:03e976389d16 42 BusInOut(PinName p0, PinName p1 = NC, PinName p2 = NC, PinName p3 = NC,
mega64 146:03e976389d16 43 PinName p4 = NC, PinName p5 = NC, PinName p6 = NC, PinName p7 = NC,
mega64 146:03e976389d16 44 PinName p8 = NC, PinName p9 = NC, PinName p10 = NC, PinName p11 = NC,
mega64 146:03e976389d16 45 PinName p12 = NC, PinName p13 = NC, PinName p14 = NC, PinName p15 = NC);
mega64 146:03e976389d16 46
mega64 146:03e976389d16 47 BusInOut(PinName pins[16]);
mega64 146:03e976389d16 48
mega64 146:03e976389d16 49 virtual ~BusInOut();
mega64 146:03e976389d16 50
mega64 146:03e976389d16 51 /* Group: Access Methods */
mega64 146:03e976389d16 52
mega64 146:03e976389d16 53 /** Write the value to the output bus
mega64 146:03e976389d16 54 *
mega64 146:03e976389d16 55 * @param value An integer specifying a bit to write for every corresponding DigitalInOut pin
mega64 146:03e976389d16 56 */
mega64 146:03e976389d16 57 void write(int value);
mega64 146:03e976389d16 58
mega64 146:03e976389d16 59 /** Read the value currently output on the bus
mega64 146:03e976389d16 60 *
mega64 146:03e976389d16 61 * @returns
mega64 146:03e976389d16 62 * An integer with each bit corresponding to associated DigitalInOut pin setting
mega64 146:03e976389d16 63 */
mega64 146:03e976389d16 64 int read();
mega64 146:03e976389d16 65
mega64 146:03e976389d16 66 /** Set as an output
mega64 146:03e976389d16 67 */
mega64 146:03e976389d16 68 void output();
mega64 146:03e976389d16 69
mega64 146:03e976389d16 70 /** Set as an input
mega64 146:03e976389d16 71 */
mega64 146:03e976389d16 72 void input();
mega64 146:03e976389d16 73
mega64 146:03e976389d16 74 /** Set the input pin mode
mega64 146:03e976389d16 75 *
mega64 146:03e976389d16 76 * @param mode PullUp, PullDown, PullNone
mega64 146:03e976389d16 77 */
mega64 146:03e976389d16 78 void mode(PinMode pull);
mega64 146:03e976389d16 79
mega64 146:03e976389d16 80 /** Binary mask of bus pins connected to actual pins (not NC pins)
mega64 146:03e976389d16 81 * If bus pin is in NC state make corresponding bit will be cleared (set to 0), else bit will be set to 1
mega64 146:03e976389d16 82 *
mega64 146:03e976389d16 83 * @returns
mega64 146:03e976389d16 84 * Binary mask of connected pins
mega64 146:03e976389d16 85 */
mega64 146:03e976389d16 86 int mask() {
mega64 146:03e976389d16 87 // No lock needed since _nc_mask is not modified outside the constructor
mega64 146:03e976389d16 88 return _nc_mask;
mega64 146:03e976389d16 89 }
mega64 146:03e976389d16 90
mega64 146:03e976389d16 91 /** A shorthand for write()
mega64 146:03e976389d16 92 */
mega64 146:03e976389d16 93 BusInOut& operator= (int v);
mega64 146:03e976389d16 94 BusInOut& operator= (BusInOut& rhs);
mega64 146:03e976389d16 95
mega64 146:03e976389d16 96 /** Access to particular bit in random-iterator fashion
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 DigitalInOut& operator[] (int index);
mega64 146:03e976389d16 99
mega64 146:03e976389d16 100 /** A shorthand for read()
mega64 146:03e976389d16 101 */
mega64 146:03e976389d16 102 operator int();
mega64 146:03e976389d16 103
mega64 146:03e976389d16 104 protected:
mega64 146:03e976389d16 105 virtual void lock();
mega64 146:03e976389d16 106 virtual void unlock();
mega64 146:03e976389d16 107 DigitalInOut* _pin[16];
mega64 146:03e976389d16 108
mega64 146:03e976389d16 109 /** Mask of bus's NC pins
mega64 146:03e976389d16 110 * If bit[n] is set to 1 - pin is connected
mega64 146:03e976389d16 111 * if bit[n] is cleared - pin is not connected (NC)
mega64 146:03e976389d16 112 */
mega64 146:03e976389d16 113 int _nc_mask;
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 PlatformMutex _mutex;
mega64 146:03e976389d16 116
mega64 146:03e976389d16 117 /* disallow copy constructor and assignment operators */
mega64 146:03e976389d16 118 private:
mega64 146:03e976389d16 119 BusInOut(const BusInOut&);
mega64 146:03e976389d16 120 BusInOut & operator = (const BusInOut&);
mega64 146:03e976389d16 121 };
mega64 146:03e976389d16 122
mega64 146:03e976389d16 123 } // namespace mbed
mega64 146:03e976389d16 124
mega64 146:03e976389d16 125 #endif
mega64 146:03e976389d16 126
mega64 146:03e976389d16 127 /** @}*/