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/AnalogOut.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_ANALOGOUT_H
mega64 146:03e976389d16 17 #define MBED_ANALOGOUT_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/platform.h"
mega64 146:03e976389d16 20
mega64 146:03e976389d16 21 #if DEVICE_ANALOGOUT
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 #include "hal/analogout_api.h"
mega64 146:03e976389d16 24 #include "platform/PlatformMutex.h"
mega64 146:03e976389d16 25
mega64 146:03e976389d16 26 namespace mbed {
mega64 146:03e976389d16 27 /** \addtogroup drivers */
mega64 146:03e976389d16 28 /** @{*/
mega64 146:03e976389d16 29
mega64 146:03e976389d16 30 /** An analog output, used for setting the voltage on a pin
mega64 146:03e976389d16 31 *
mega64 146:03e976389d16 32 * @Note Synchronization level: Thread safe
mega64 146:03e976389d16 33 *
mega64 146:03e976389d16 34 * Example:
mega64 146:03e976389d16 35 * @code
mega64 146:03e976389d16 36 * // Make a sawtooth output
mega64 146:03e976389d16 37 *
mega64 146:03e976389d16 38 * #include "mbed.h"
mega64 146:03e976389d16 39 *
mega64 146:03e976389d16 40 * AnalogOut tri(p18);
mega64 146:03e976389d16 41 * int main() {
mega64 146:03e976389d16 42 * while(1) {
mega64 146:03e976389d16 43 * tri = tri + 0.01;
mega64 146:03e976389d16 44 * wait_us(1);
mega64 146:03e976389d16 45 * if(tri == 1) {
mega64 146:03e976389d16 46 * tri = 0;
mega64 146:03e976389d16 47 * }
mega64 146:03e976389d16 48 * }
mega64 146:03e976389d16 49 * }
mega64 146:03e976389d16 50 * @endcode
mega64 146:03e976389d16 51 */
mega64 146:03e976389d16 52 class AnalogOut {
mega64 146:03e976389d16 53
mega64 146:03e976389d16 54 public:
mega64 146:03e976389d16 55
mega64 146:03e976389d16 56 /** Create an AnalogOut connected to the specified pin
mega64 146:03e976389d16 57 *
mega64 146:03e976389d16 58 * @param AnalogOut pin to connect to (18)
mega64 146:03e976389d16 59 */
mega64 146:03e976389d16 60 AnalogOut(PinName pin) {
mega64 146:03e976389d16 61 analogout_init(&_dac, pin);
mega64 146:03e976389d16 62 }
mega64 146:03e976389d16 63
mega64 146:03e976389d16 64 /** Set the output voltage, specified as a percentage (float)
mega64 146:03e976389d16 65 *
mega64 146:03e976389d16 66 * @param value A floating-point value representing the output voltage,
mega64 146:03e976389d16 67 * specified as a percentage. The value should lie between
mega64 146:03e976389d16 68 * 0.0f (representing 0v / 0%) and 1.0f (representing 3.3v / 100%).
mega64 146:03e976389d16 69 * Values outside this range will be saturated to 0.0f or 1.0f.
mega64 146:03e976389d16 70 */
mega64 146:03e976389d16 71 void write(float value) {
mega64 146:03e976389d16 72 lock();
mega64 146:03e976389d16 73 analogout_write(&_dac, value);
mega64 146:03e976389d16 74 unlock();
mega64 146:03e976389d16 75 }
mega64 146:03e976389d16 76
mega64 146:03e976389d16 77 /** Set the output voltage, represented as an unsigned short in the range [0x0, 0xFFFF]
mega64 146:03e976389d16 78 *
mega64 146:03e976389d16 79 * @param value 16-bit unsigned short representing the output voltage,
mega64 146:03e976389d16 80 * normalised to a 16-bit value (0x0000 = 0v, 0xFFFF = 3.3v)
mega64 146:03e976389d16 81 */
mega64 146:03e976389d16 82 void write_u16(unsigned short value) {
mega64 146:03e976389d16 83 lock();
mega64 146:03e976389d16 84 analogout_write_u16(&_dac, value);
mega64 146:03e976389d16 85 unlock();
mega64 146:03e976389d16 86 }
mega64 146:03e976389d16 87
mega64 146:03e976389d16 88 /** Return the current output voltage setting, measured as a percentage (float)
mega64 146:03e976389d16 89 *
mega64 146:03e976389d16 90 * @returns
mega64 146:03e976389d16 91 * A floating-point value representing the current voltage being output on the pin,
mega64 146:03e976389d16 92 * measured as a percentage. The returned value will lie between
mega64 146:03e976389d16 93 * 0.0f (representing 0v / 0%) and 1.0f (representing 3.3v / 100%).
mega64 146:03e976389d16 94 *
mega64 146:03e976389d16 95 * @note
mega64 146:03e976389d16 96 * This value may not match exactly the value set by a previous write().
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 float read() {
mega64 146:03e976389d16 99 lock();
mega64 146:03e976389d16 100 float ret = analogout_read(&_dac);
mega64 146:03e976389d16 101 unlock();
mega64 146:03e976389d16 102 return ret;
mega64 146:03e976389d16 103 }
mega64 146:03e976389d16 104
mega64 146:03e976389d16 105 /** An operator shorthand for write()
mega64 146:03e976389d16 106 */
mega64 146:03e976389d16 107 AnalogOut& operator= (float percent) {
mega64 146:03e976389d16 108 // Underlying write call is thread safe
mega64 146:03e976389d16 109 write(percent);
mega64 146:03e976389d16 110 return *this;
mega64 146:03e976389d16 111 }
mega64 146:03e976389d16 112
mega64 146:03e976389d16 113 AnalogOut& operator= (AnalogOut& rhs) {
mega64 146:03e976389d16 114 // Underlying write call is thread safe
mega64 146:03e976389d16 115 write(rhs.read());
mega64 146:03e976389d16 116 return *this;
mega64 146:03e976389d16 117 }
mega64 146:03e976389d16 118
mega64 146:03e976389d16 119 /** An operator shorthand for read()
mega64 146:03e976389d16 120 */
mega64 146:03e976389d16 121 operator float() {
mega64 146:03e976389d16 122 // Underlying read call is thread safe
mega64 146:03e976389d16 123 return read();
mega64 146:03e976389d16 124 }
mega64 146:03e976389d16 125
mega64 146:03e976389d16 126 virtual ~AnalogOut() {
mega64 146:03e976389d16 127 // Do nothing
mega64 146:03e976389d16 128 }
mega64 146:03e976389d16 129
mega64 146:03e976389d16 130 protected:
mega64 146:03e976389d16 131
mega64 146:03e976389d16 132 virtual void lock() {
mega64 146:03e976389d16 133 _mutex.lock();
mega64 146:03e976389d16 134 }
mega64 146:03e976389d16 135
mega64 146:03e976389d16 136 virtual void unlock() {
mega64 146:03e976389d16 137 _mutex.unlock();
mega64 146:03e976389d16 138 }
mega64 146:03e976389d16 139
mega64 146:03e976389d16 140 dac_t _dac;
mega64 146:03e976389d16 141 PlatformMutex _mutex;
mega64 146:03e976389d16 142 };
mega64 146:03e976389d16 143
mega64 146:03e976389d16 144 } // namespace mbed
mega64 146:03e976389d16 145
mega64 146:03e976389d16 146 #endif
mega64 146:03e976389d16 147
mega64 146:03e976389d16 148 #endif
mega64 146:03e976389d16 149
mega64 146:03e976389d16 150 /** @}*/