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/SerialBase.cpp@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 #include "drivers/SerialBase.h"
mega64 146:03e976389d16 17 #include "platform/mbed_wait_api.h"
mega64 146:03e976389d16 18 #include "platform/mbed_critical.h"
mega64 146:03e976389d16 19
mega64 146:03e976389d16 20 #if DEVICE_SERIAL
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 namespace mbed {
mega64 146:03e976389d16 23
mega64 146:03e976389d16 24 static void donothing() {};
mega64 146:03e976389d16 25
mega64 146:03e976389d16 26 SerialBase::SerialBase(PinName tx, PinName rx, int baud) :
mega64 146:03e976389d16 27 #if DEVICE_SERIAL_ASYNCH
mega64 146:03e976389d16 28 _thunk_irq(this), _tx_usage(DMA_USAGE_NEVER),
mega64 146:03e976389d16 29 _rx_usage(DMA_USAGE_NEVER),
mega64 146:03e976389d16 30 #endif
mega64 146:03e976389d16 31 _serial(), _baud(baud) {
mega64 146:03e976389d16 32 // No lock needed in the constructor
mega64 146:03e976389d16 33
mega64 146:03e976389d16 34 for (size_t i = 0; i < sizeof _irq / sizeof _irq[0]; i++) {
mega64 146:03e976389d16 35 _irq[i] = donothing;
mega64 146:03e976389d16 36 }
mega64 146:03e976389d16 37
mega64 146:03e976389d16 38 serial_init(&_serial, tx, rx);
mega64 146:03e976389d16 39 serial_baud(&_serial, _baud);
mega64 146:03e976389d16 40 serial_irq_handler(&_serial, SerialBase::_irq_handler, (uint32_t)this);
mega64 146:03e976389d16 41 }
mega64 146:03e976389d16 42
mega64 146:03e976389d16 43 void SerialBase::baud(int baudrate) {
mega64 146:03e976389d16 44 lock();
mega64 146:03e976389d16 45 serial_baud(&_serial, baudrate);
mega64 146:03e976389d16 46 _baud = baudrate;
mega64 146:03e976389d16 47 unlock();
mega64 146:03e976389d16 48 }
mega64 146:03e976389d16 49
mega64 146:03e976389d16 50 void SerialBase::format(int bits, Parity parity, int stop_bits) {
mega64 146:03e976389d16 51 lock();
mega64 146:03e976389d16 52 serial_format(&_serial, bits, (SerialParity)parity, stop_bits);
mega64 146:03e976389d16 53 unlock();
mega64 146:03e976389d16 54 }
mega64 146:03e976389d16 55
mega64 146:03e976389d16 56 int SerialBase::readable() {
mega64 146:03e976389d16 57 lock();
mega64 146:03e976389d16 58 int ret = serial_readable(&_serial);
mega64 146:03e976389d16 59 unlock();
mega64 146:03e976389d16 60 return ret;
mega64 146:03e976389d16 61 }
mega64 146:03e976389d16 62
mega64 146:03e976389d16 63
mega64 146:03e976389d16 64 int SerialBase::writeable() {
mega64 146:03e976389d16 65 lock();
mega64 146:03e976389d16 66 int ret = serial_writable(&_serial);
mega64 146:03e976389d16 67 unlock();
mega64 146:03e976389d16 68 return ret;
mega64 146:03e976389d16 69 }
mega64 146:03e976389d16 70
mega64 146:03e976389d16 71 void SerialBase::attach(Callback<void()> func, IrqType type) {
mega64 146:03e976389d16 72 lock();
mega64 146:03e976389d16 73 // Disable interrupts when attaching interrupt handler
mega64 146:03e976389d16 74 core_util_critical_section_enter();
mega64 146:03e976389d16 75 if (func) {
mega64 146:03e976389d16 76 _irq[type] = func;
mega64 146:03e976389d16 77 serial_irq_set(&_serial, (SerialIrq)type, 1);
mega64 146:03e976389d16 78 } else {
mega64 146:03e976389d16 79 _irq[type] = donothing;
mega64 146:03e976389d16 80 serial_irq_set(&_serial, (SerialIrq)type, 0);
mega64 146:03e976389d16 81 }
mega64 146:03e976389d16 82 core_util_critical_section_exit();
mega64 146:03e976389d16 83 unlock();
mega64 146:03e976389d16 84 }
mega64 146:03e976389d16 85
mega64 146:03e976389d16 86 void SerialBase::_irq_handler(uint32_t id, SerialIrq irq_type) {
mega64 146:03e976389d16 87 SerialBase *handler = (SerialBase*)id;
mega64 146:03e976389d16 88 handler->_irq[irq_type]();
mega64 146:03e976389d16 89 }
mega64 146:03e976389d16 90
mega64 146:03e976389d16 91 int SerialBase::_base_getc() {
mega64 146:03e976389d16 92 // Mutex is already held
mega64 146:03e976389d16 93 return serial_getc(&_serial);
mega64 146:03e976389d16 94 }
mega64 146:03e976389d16 95
mega64 146:03e976389d16 96 int SerialBase::_base_putc(int c) {
mega64 146:03e976389d16 97 // Mutex is already held
mega64 146:03e976389d16 98 serial_putc(&_serial, c);
mega64 146:03e976389d16 99 return c;
mega64 146:03e976389d16 100 }
mega64 146:03e976389d16 101
mega64 146:03e976389d16 102 void SerialBase::send_break() {
mega64 146:03e976389d16 103 lock();
mega64 146:03e976389d16 104 // Wait for 1.5 frames before clearing the break condition
mega64 146:03e976389d16 105 // This will have different effects on our platforms, but should
mega64 146:03e976389d16 106 // ensure that we keep the break active for at least one frame.
mega64 146:03e976389d16 107 // We consider a full frame (1 start bit + 8 data bits bits +
mega64 146:03e976389d16 108 // 1 parity bit + 2 stop bits = 12 bits) for computation.
mega64 146:03e976389d16 109 // One bit time (in us) = 1000000/_baud
mega64 146:03e976389d16 110 // Twelve bits: 12000000/baud delay
mega64 146:03e976389d16 111 // 1.5 frames: 18000000/baud delay
mega64 146:03e976389d16 112 serial_break_set(&_serial);
mega64 146:03e976389d16 113 wait_us(18000000/_baud);
mega64 146:03e976389d16 114 serial_break_clear(&_serial);
mega64 146:03e976389d16 115 unlock();
mega64 146:03e976389d16 116 }
mega64 146:03e976389d16 117
mega64 146:03e976389d16 118 void SerialBase::lock() {
mega64 146:03e976389d16 119 // Stub
mega64 146:03e976389d16 120 }
mega64 146:03e976389d16 121
mega64 146:03e976389d16 122 void SerialBase:: unlock() {
mega64 146:03e976389d16 123 // Stub
mega64 146:03e976389d16 124 }
mega64 146:03e976389d16 125
mega64 146:03e976389d16 126 #if DEVICE_SERIAL_FC
mega64 146:03e976389d16 127 void SerialBase::set_flow_control(Flow type, PinName flow1, PinName flow2) {
mega64 146:03e976389d16 128 lock();
mega64 146:03e976389d16 129 FlowControl flow_type = (FlowControl)type;
mega64 146:03e976389d16 130 switch(type) {
mega64 146:03e976389d16 131 case RTS:
mega64 146:03e976389d16 132 serial_set_flow_control(&_serial, flow_type, flow1, NC);
mega64 146:03e976389d16 133 break;
mega64 146:03e976389d16 134
mega64 146:03e976389d16 135 case CTS:
mega64 146:03e976389d16 136 serial_set_flow_control(&_serial, flow_type, NC, flow1);
mega64 146:03e976389d16 137 break;
mega64 146:03e976389d16 138
mega64 146:03e976389d16 139 case RTSCTS:
mega64 146:03e976389d16 140 case Disabled:
mega64 146:03e976389d16 141 serial_set_flow_control(&_serial, flow_type, flow1, flow2);
mega64 146:03e976389d16 142 break;
mega64 146:03e976389d16 143
mega64 146:03e976389d16 144 default:
mega64 146:03e976389d16 145 break;
mega64 146:03e976389d16 146 }
mega64 146:03e976389d16 147 unlock();
mega64 146:03e976389d16 148 }
mega64 146:03e976389d16 149 #endif
mega64 146:03e976389d16 150
mega64 146:03e976389d16 151 #if DEVICE_SERIAL_ASYNCH
mega64 146:03e976389d16 152
mega64 146:03e976389d16 153 int SerialBase::write(const uint8_t *buffer, int length, const event_callback_t& callback, int event)
mega64 146:03e976389d16 154 {
mega64 146:03e976389d16 155 if (serial_tx_active(&_serial)) {
mega64 146:03e976389d16 156 return -1; // transaction ongoing
mega64 146:03e976389d16 157 }
mega64 146:03e976389d16 158 start_write((void *)buffer, length, 8, callback, event);
mega64 146:03e976389d16 159 return 0;
mega64 146:03e976389d16 160 }
mega64 146:03e976389d16 161
mega64 146:03e976389d16 162 int SerialBase::write(const uint16_t *buffer, int length, const event_callback_t& callback, int event)
mega64 146:03e976389d16 163 {
mega64 146:03e976389d16 164 if (serial_tx_active(&_serial)) {
mega64 146:03e976389d16 165 return -1; // transaction ongoing
mega64 146:03e976389d16 166 }
mega64 146:03e976389d16 167 start_write((void *)buffer, length, 16, callback, event);
mega64 146:03e976389d16 168 return 0;
mega64 146:03e976389d16 169 }
mega64 146:03e976389d16 170
mega64 146:03e976389d16 171 void SerialBase::start_write(const void *buffer, int buffer_size, char buffer_width, const event_callback_t& callback, int event)
mega64 146:03e976389d16 172 {
mega64 146:03e976389d16 173 _tx_callback = callback;
mega64 146:03e976389d16 174
mega64 146:03e976389d16 175 _thunk_irq.callback(&SerialBase::interrupt_handler_asynch);
mega64 146:03e976389d16 176 serial_tx_asynch(&_serial, buffer, buffer_size, buffer_width, _thunk_irq.entry(), event, _tx_usage);
mega64 146:03e976389d16 177 }
mega64 146:03e976389d16 178
mega64 146:03e976389d16 179 void SerialBase::abort_write(void)
mega64 146:03e976389d16 180 {
mega64 146:03e976389d16 181 serial_tx_abort_asynch(&_serial);
mega64 146:03e976389d16 182 }
mega64 146:03e976389d16 183
mega64 146:03e976389d16 184 void SerialBase::abort_read(void)
mega64 146:03e976389d16 185 {
mega64 146:03e976389d16 186 serial_rx_abort_asynch(&_serial);
mega64 146:03e976389d16 187 }
mega64 146:03e976389d16 188
mega64 146:03e976389d16 189 int SerialBase::set_dma_usage_tx(DMAUsage usage)
mega64 146:03e976389d16 190 {
mega64 146:03e976389d16 191 if (serial_tx_active(&_serial)) {
mega64 146:03e976389d16 192 return -1;
mega64 146:03e976389d16 193 }
mega64 146:03e976389d16 194 _tx_usage = usage;
mega64 146:03e976389d16 195 return 0;
mega64 146:03e976389d16 196 }
mega64 146:03e976389d16 197
mega64 146:03e976389d16 198 int SerialBase::set_dma_usage_rx(DMAUsage usage)
mega64 146:03e976389d16 199 {
mega64 146:03e976389d16 200 if (serial_tx_active(&_serial)) {
mega64 146:03e976389d16 201 return -1;
mega64 146:03e976389d16 202 }
mega64 146:03e976389d16 203 _rx_usage = usage;
mega64 146:03e976389d16 204 return 0;
mega64 146:03e976389d16 205 }
mega64 146:03e976389d16 206
mega64 146:03e976389d16 207 int SerialBase::read(uint8_t *buffer, int length, const event_callback_t& callback, int event, unsigned char char_match)
mega64 146:03e976389d16 208 {
mega64 146:03e976389d16 209 if (serial_rx_active(&_serial)) {
mega64 146:03e976389d16 210 return -1; // transaction ongoing
mega64 146:03e976389d16 211 }
mega64 146:03e976389d16 212 start_read((void*)buffer, length, 8, callback, event, char_match);
mega64 146:03e976389d16 213 return 0;
mega64 146:03e976389d16 214 }
mega64 146:03e976389d16 215
mega64 146:03e976389d16 216
mega64 146:03e976389d16 217 int SerialBase::read(uint16_t *buffer, int length, const event_callback_t& callback, int event, unsigned char char_match)
mega64 146:03e976389d16 218 {
mega64 146:03e976389d16 219 if (serial_rx_active(&_serial)) {
mega64 146:03e976389d16 220 return -1; // transaction ongoing
mega64 146:03e976389d16 221 }
mega64 146:03e976389d16 222 start_read((void*)buffer, length, 16, callback, event, char_match);
mega64 146:03e976389d16 223 return 0;
mega64 146:03e976389d16 224 }
mega64 146:03e976389d16 225
mega64 146:03e976389d16 226
mega64 146:03e976389d16 227 void SerialBase::start_read(void *buffer, int buffer_size, char buffer_width, const event_callback_t& callback, int event, unsigned char char_match)
mega64 146:03e976389d16 228 {
mega64 146:03e976389d16 229 _rx_callback = callback;
mega64 146:03e976389d16 230 _thunk_irq.callback(&SerialBase::interrupt_handler_asynch);
mega64 146:03e976389d16 231 serial_rx_asynch(&_serial, buffer, buffer_size, buffer_width, _thunk_irq.entry(), event, char_match, _rx_usage);
mega64 146:03e976389d16 232 }
mega64 146:03e976389d16 233
mega64 146:03e976389d16 234 void SerialBase::interrupt_handler_asynch(void)
mega64 146:03e976389d16 235 {
mega64 146:03e976389d16 236 int event = serial_irq_handler_asynch(&_serial);
mega64 146:03e976389d16 237 int rx_event = event & SERIAL_EVENT_RX_MASK;
mega64 146:03e976389d16 238 if (_rx_callback && rx_event) {
mega64 146:03e976389d16 239 _rx_callback.call(rx_event);
mega64 146:03e976389d16 240 }
mega64 146:03e976389d16 241
mega64 146:03e976389d16 242 int tx_event = event & SERIAL_EVENT_TX_MASK;
mega64 146:03e976389d16 243 if (_tx_callback && tx_event) {
mega64 146:03e976389d16 244 _tx_callback.call(tx_event);
mega64 146:03e976389d16 245 }
mega64 146:03e976389d16 246 }
mega64 146:03e976389d16 247
mega64 146:03e976389d16 248 #endif
mega64 146:03e976389d16 249
mega64 146:03e976389d16 250 } // namespace mbed
mega64 146:03e976389d16 251
mega64 146:03e976389d16 252 #endif