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/I2C.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-2015 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/I2C.h"
mega64 146:03e976389d16 17
mega64 146:03e976389d16 18 #if DEVICE_I2C
mega64 146:03e976389d16 19
mega64 146:03e976389d16 20 namespace mbed {
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 I2C *I2C::_owner = NULL;
mega64 146:03e976389d16 23 SingletonPtr<PlatformMutex> I2C::_mutex;
mega64 146:03e976389d16 24
mega64 146:03e976389d16 25 I2C::I2C(PinName sda, PinName scl) :
mega64 146:03e976389d16 26 #if DEVICE_I2C_ASYNCH
mega64 146:03e976389d16 27 _irq(this), _usage(DMA_USAGE_NEVER),
mega64 146:03e976389d16 28 #endif
mega64 146:03e976389d16 29 _i2c(), _hz(100000) {
mega64 146:03e976389d16 30 // No lock needed in the constructor
mega64 146:03e976389d16 31
mega64 146:03e976389d16 32 // The init function also set the frequency to 100000
mega64 146:03e976389d16 33 i2c_init(&_i2c, sda, scl);
mega64 146:03e976389d16 34
mega64 146:03e976389d16 35 // Used to avoid unnecessary frequency updates
mega64 146:03e976389d16 36 _owner = this;
mega64 146:03e976389d16 37 }
mega64 146:03e976389d16 38
mega64 146:03e976389d16 39 void I2C::frequency(int hz) {
mega64 146:03e976389d16 40 lock();
mega64 146:03e976389d16 41 _hz = hz;
mega64 146:03e976389d16 42
mega64 146:03e976389d16 43 // We want to update the frequency even if we are already the bus owners
mega64 146:03e976389d16 44 i2c_frequency(&_i2c, _hz);
mega64 146:03e976389d16 45
mega64 146:03e976389d16 46 // Updating the frequency of the bus we become the owners of it
mega64 146:03e976389d16 47 _owner = this;
mega64 146:03e976389d16 48 unlock();
mega64 146:03e976389d16 49 }
mega64 146:03e976389d16 50
mega64 146:03e976389d16 51 void I2C::aquire() {
mega64 146:03e976389d16 52 lock();
mega64 146:03e976389d16 53 if (_owner != this) {
mega64 146:03e976389d16 54 i2c_frequency(&_i2c, _hz);
mega64 146:03e976389d16 55 _owner = this;
mega64 146:03e976389d16 56 }
mega64 146:03e976389d16 57 unlock();
mega64 146:03e976389d16 58 }
mega64 146:03e976389d16 59
mega64 146:03e976389d16 60 // write - Master Transmitter Mode
mega64 146:03e976389d16 61 int I2C::write(int address, const char* data, int length, bool repeated) {
mega64 146:03e976389d16 62 lock();
mega64 146:03e976389d16 63 aquire();
mega64 146:03e976389d16 64
mega64 146:03e976389d16 65 int stop = (repeated) ? 0 : 1;
mega64 146:03e976389d16 66 int written = i2c_write(&_i2c, address, data, length, stop);
mega64 146:03e976389d16 67
mega64 146:03e976389d16 68 unlock();
mega64 146:03e976389d16 69 return length != written;
mega64 146:03e976389d16 70 }
mega64 146:03e976389d16 71
mega64 146:03e976389d16 72 int I2C::write(int data) {
mega64 146:03e976389d16 73 lock();
mega64 146:03e976389d16 74 int ret = i2c_byte_write(&_i2c, data);
mega64 146:03e976389d16 75 unlock();
mega64 146:03e976389d16 76 return ret;
mega64 146:03e976389d16 77 }
mega64 146:03e976389d16 78
mega64 146:03e976389d16 79 // read - Master Reciever Mode
mega64 146:03e976389d16 80 int I2C::read(int address, char* data, int length, bool repeated) {
mega64 146:03e976389d16 81 lock();
mega64 146:03e976389d16 82 aquire();
mega64 146:03e976389d16 83
mega64 146:03e976389d16 84 int stop = (repeated) ? 0 : 1;
mega64 146:03e976389d16 85 int read = i2c_read(&_i2c, address, data, length, stop);
mega64 146:03e976389d16 86
mega64 146:03e976389d16 87 unlock();
mega64 146:03e976389d16 88 return length != read;
mega64 146:03e976389d16 89 }
mega64 146:03e976389d16 90
mega64 146:03e976389d16 91 int I2C::read(int ack) {
mega64 146:03e976389d16 92 lock();
mega64 146:03e976389d16 93 int ret;
mega64 146:03e976389d16 94 if (ack) {
mega64 146:03e976389d16 95 ret = i2c_byte_read(&_i2c, 0);
mega64 146:03e976389d16 96 } else {
mega64 146:03e976389d16 97 ret = i2c_byte_read(&_i2c, 1);
mega64 146:03e976389d16 98 }
mega64 146:03e976389d16 99 unlock();
mega64 146:03e976389d16 100 return ret;
mega64 146:03e976389d16 101 }
mega64 146:03e976389d16 102
mega64 146:03e976389d16 103 void I2C::start(void) {
mega64 146:03e976389d16 104 lock();
mega64 146:03e976389d16 105 i2c_start(&_i2c);
mega64 146:03e976389d16 106 unlock();
mega64 146:03e976389d16 107 }
mega64 146:03e976389d16 108
mega64 146:03e976389d16 109 void I2C::stop(void) {
mega64 146:03e976389d16 110 lock();
mega64 146:03e976389d16 111 i2c_stop(&_i2c);
mega64 146:03e976389d16 112 unlock();
mega64 146:03e976389d16 113 }
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 void I2C::lock() {
mega64 146:03e976389d16 116 _mutex->lock();
mega64 146:03e976389d16 117 }
mega64 146:03e976389d16 118
mega64 146:03e976389d16 119 void I2C::unlock() {
mega64 146:03e976389d16 120 _mutex->unlock();
mega64 146:03e976389d16 121 }
mega64 146:03e976389d16 122
mega64 146:03e976389d16 123 #if DEVICE_I2C_ASYNCH
mega64 146:03e976389d16 124
mega64 146:03e976389d16 125 int I2C::transfer(int address, const char *tx_buffer, int tx_length, char *rx_buffer, int rx_length, const event_callback_t& callback, int event, bool repeated)
mega64 146:03e976389d16 126 {
mega64 146:03e976389d16 127 lock();
mega64 146:03e976389d16 128 if (i2c_active(&_i2c)) {
mega64 146:03e976389d16 129 unlock();
mega64 146:03e976389d16 130 return -1; // transaction ongoing
mega64 146:03e976389d16 131 }
mega64 146:03e976389d16 132 aquire();
mega64 146:03e976389d16 133
mega64 146:03e976389d16 134 _callback = callback;
mega64 146:03e976389d16 135 int stop = (repeated) ? 0 : 1;
mega64 146:03e976389d16 136 _irq.callback(&I2C::irq_handler_asynch);
mega64 146:03e976389d16 137 i2c_transfer_asynch(&_i2c, (void *)tx_buffer, tx_length, (void *)rx_buffer, rx_length, address, stop, _irq.entry(), event, _usage);
mega64 146:03e976389d16 138 unlock();
mega64 146:03e976389d16 139 return 0;
mega64 146:03e976389d16 140 }
mega64 146:03e976389d16 141
mega64 146:03e976389d16 142 void I2C::abort_transfer(void)
mega64 146:03e976389d16 143 {
mega64 146:03e976389d16 144 lock();
mega64 146:03e976389d16 145 i2c_abort_asynch(&_i2c);
mega64 146:03e976389d16 146 unlock();
mega64 146:03e976389d16 147 }
mega64 146:03e976389d16 148
mega64 146:03e976389d16 149 void I2C::irq_handler_asynch(void)
mega64 146:03e976389d16 150 {
mega64 146:03e976389d16 151 int event = i2c_irq_handler_asynch(&_i2c);
mega64 146:03e976389d16 152 if (_callback && event) {
mega64 146:03e976389d16 153 _callback.call(event);
mega64 146:03e976389d16 154 }
mega64 146:03e976389d16 155
mega64 146:03e976389d16 156 }
mega64 146:03e976389d16 157
mega64 146:03e976389d16 158
mega64 146:03e976389d16 159 #endif
mega64 146:03e976389d16 160
mega64 146:03e976389d16 161 } // namespace mbed
mega64 146:03e976389d16 162
mega64 146:03e976389d16 163 #endif