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/InterruptIn.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_INTERRUPTIN_H
mega64 146:03e976389d16 17 #define MBED_INTERRUPTIN_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/platform.h"
mega64 146:03e976389d16 20
mega64 146:03e976389d16 21 #if DEVICE_INTERRUPTIN
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 #include "hal/gpio_api.h"
mega64 146:03e976389d16 24 #include "hal/gpio_irq_api.h"
mega64 146:03e976389d16 25 #include "platform/Callback.h"
mega64 146:03e976389d16 26 #include "platform/mbed_critical.h"
mega64 146:03e976389d16 27 #include "platform/mbed_toolchain.h"
mega64 146:03e976389d16 28
mega64 146:03e976389d16 29 namespace mbed {
mega64 146:03e976389d16 30 /** \addtogroup drivers */
mega64 146:03e976389d16 31 /** @{*/
mega64 146:03e976389d16 32
mega64 146:03e976389d16 33 /** A digital interrupt input, used to call a function on a rising or falling edge
mega64 146:03e976389d16 34 *
mega64 146:03e976389d16 35 * @Note Synchronization level: Interrupt safe
mega64 146:03e976389d16 36 *
mega64 146:03e976389d16 37 * Example:
mega64 146:03e976389d16 38 * @code
mega64 146:03e976389d16 39 * // Flash an LED while waiting for events
mega64 146:03e976389d16 40 *
mega64 146:03e976389d16 41 * #include "mbed.h"
mega64 146:03e976389d16 42 *
mega64 146:03e976389d16 43 * InterruptIn event(p16);
mega64 146:03e976389d16 44 * DigitalOut led(LED1);
mega64 146:03e976389d16 45 *
mega64 146:03e976389d16 46 * void trigger() {
mega64 146:03e976389d16 47 * printf("triggered!\n");
mega64 146:03e976389d16 48 * }
mega64 146:03e976389d16 49 *
mega64 146:03e976389d16 50 * int main() {
mega64 146:03e976389d16 51 * event.rise(&trigger);
mega64 146:03e976389d16 52 * while(1) {
mega64 146:03e976389d16 53 * led = !led;
mega64 146:03e976389d16 54 * wait(0.25);
mega64 146:03e976389d16 55 * }
mega64 146:03e976389d16 56 * }
mega64 146:03e976389d16 57 * @endcode
mega64 146:03e976389d16 58 */
mega64 146:03e976389d16 59 class InterruptIn {
mega64 146:03e976389d16 60
mega64 146:03e976389d16 61 public:
mega64 146:03e976389d16 62
mega64 146:03e976389d16 63 /** Create an InterruptIn connected to the specified pin
mega64 146:03e976389d16 64 *
mega64 146:03e976389d16 65 * @param pin InterruptIn pin to connect to
mega64 146:03e976389d16 66 * @param name (optional) A string to identify the object
mega64 146:03e976389d16 67 */
mega64 146:03e976389d16 68 InterruptIn(PinName pin);
mega64 146:03e976389d16 69 virtual ~InterruptIn();
mega64 146:03e976389d16 70
mega64 146:03e976389d16 71 /** Read the input, represented as 0 or 1 (int)
mega64 146:03e976389d16 72 *
mega64 146:03e976389d16 73 * @returns
mega64 146:03e976389d16 74 * An integer representing the state of the input pin,
mega64 146:03e976389d16 75 * 0 for logical 0, 1 for logical 1
mega64 146:03e976389d16 76 */
mega64 146:03e976389d16 77 int read();
mega64 146:03e976389d16 78
mega64 146:03e976389d16 79 /** An operator shorthand for read()
mega64 146:03e976389d16 80 */
mega64 146:03e976389d16 81 operator int();
mega64 146:03e976389d16 82
mega64 146:03e976389d16 83
mega64 146:03e976389d16 84 /** Attach a function to call when a rising edge occurs on the input
mega64 146:03e976389d16 85 *
mega64 146:03e976389d16 86 * @param func A pointer to a void function, or 0 to set as none
mega64 146:03e976389d16 87 */
mega64 146:03e976389d16 88 void rise(Callback<void()> func);
mega64 146:03e976389d16 89
mega64 146:03e976389d16 90 /** Attach a member function to call when a rising edge occurs on the input
mega64 146:03e976389d16 91 *
mega64 146:03e976389d16 92 * @param obj pointer to the object to call the member function on
mega64 146:03e976389d16 93 * @param method pointer to the member function to be called
mega64 146:03e976389d16 94 * @deprecated
mega64 146:03e976389d16 95 * The rise function does not support cv-qualifiers. Replaced by
mega64 146:03e976389d16 96 * rise(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 rise function does not support cv-qualifiers. Replaced by "
mega64 146:03e976389d16 101 "rise(callback(obj, method)).")
mega64 146:03e976389d16 102 void rise(T *obj, M method) {
mega64 146:03e976389d16 103 core_util_critical_section_enter();
mega64 146:03e976389d16 104 rise(callback(obj, method));
mega64 146:03e976389d16 105 core_util_critical_section_exit();
mega64 146:03e976389d16 106 }
mega64 146:03e976389d16 107
mega64 146:03e976389d16 108 /** Attach a function to call when a falling edge occurs on the input
mega64 146:03e976389d16 109 *
mega64 146:03e976389d16 110 * @param func A pointer to a void function, or 0 to set as none
mega64 146:03e976389d16 111 */
mega64 146:03e976389d16 112 void fall(Callback<void()> func);
mega64 146:03e976389d16 113
mega64 146:03e976389d16 114 /** Attach a member function to call when a falling edge occurs on the input
mega64 146:03e976389d16 115 *
mega64 146:03e976389d16 116 * @param obj pointer to the object to call the member function on
mega64 146:03e976389d16 117 * @param method pointer to the member function to be called
mega64 146:03e976389d16 118 * @deprecated
mega64 146:03e976389d16 119 * The rise function does not support cv-qualifiers. Replaced by
mega64 146:03e976389d16 120 * rise(callback(obj, method)).
mega64 146:03e976389d16 121 */
mega64 146:03e976389d16 122 template<typename T, typename M>
mega64 146:03e976389d16 123 MBED_DEPRECATED_SINCE("mbed-os-5.1",
mega64 146:03e976389d16 124 "The fall function does not support cv-qualifiers. Replaced by "
mega64 146:03e976389d16 125 "fall(callback(obj, method)).")
mega64 146:03e976389d16 126 void fall(T *obj, M method) {
mega64 146:03e976389d16 127 core_util_critical_section_enter();
mega64 146:03e976389d16 128 fall(callback(obj, method));
mega64 146:03e976389d16 129 core_util_critical_section_exit();
mega64 146:03e976389d16 130 }
mega64 146:03e976389d16 131
mega64 146:03e976389d16 132 /** Set the input pin mode
mega64 146:03e976389d16 133 *
mega64 146:03e976389d16 134 * @param mode PullUp, PullDown, PullNone
mega64 146:03e976389d16 135 */
mega64 146:03e976389d16 136 void mode(PinMode pull);
mega64 146:03e976389d16 137
mega64 146:03e976389d16 138 /** Enable IRQ. This method depends on hw implementation, might enable one
mega64 146:03e976389d16 139 * port interrupts. For further information, check gpio_irq_enable().
mega64 146:03e976389d16 140 */
mega64 146:03e976389d16 141 void enable_irq();
mega64 146:03e976389d16 142
mega64 146:03e976389d16 143 /** Disable IRQ. This method depends on hw implementation, might disable one
mega64 146:03e976389d16 144 * port interrupts. For further information, check gpio_irq_disable().
mega64 146:03e976389d16 145 */
mega64 146:03e976389d16 146 void disable_irq();
mega64 146:03e976389d16 147
mega64 146:03e976389d16 148 static void _irq_handler(uint32_t id, gpio_irq_event event);
mega64 146:03e976389d16 149
mega64 146:03e976389d16 150 protected:
mega64 146:03e976389d16 151 gpio_t gpio;
mega64 146:03e976389d16 152 gpio_irq_t gpio_irq;
mega64 146:03e976389d16 153
mega64 146:03e976389d16 154 Callback<void()> _rise;
mega64 146:03e976389d16 155 Callback<void()> _fall;
mega64 146:03e976389d16 156 };
mega64 146:03e976389d16 157
mega64 146:03e976389d16 158 } // namespace mbed
mega64 146:03e976389d16 159
mega64 146:03e976389d16 160 #endif
mega64 146:03e976389d16 161
mega64 146:03e976389d16 162 #endif
mega64 146:03e976389d16 163
mega64 146:03e976389d16 164 /** @}*/