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/SPISlave.h@146:03e976389d16, 2017-03-16 (annotated)

Committer:
mega64
Date:
Thu Mar 16 06:15:53 2017 +0000
Revision:
146:03e976389d16
fully rebuild, now based on mbed-dev v160

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_SPISLAVE_H
mega64 146:03e976389d16 17 #define MBED_SPISLAVE_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/platform.h"
mega64 146:03e976389d16 20
mega64 146:03e976389d16 21 #if DEVICE_SPISLAVE
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 #include "hal/spi_api.h"
mega64 146:03e976389d16 24
mega64 146:03e976389d16 25 namespace mbed {
mega64 146:03e976389d16 26 /** \addtogroup drivers */
mega64 146:03e976389d16 27 /** @{*/
mega64 146:03e976389d16 28
mega64 146:03e976389d16 29 /** A SPI slave, used for communicating with a SPI Master device
mega64 146:03e976389d16 30 *
mega64 146:03e976389d16 31 * The default format is set to 8-bits, mode 0, and a clock frequency of 1MHz
mega64 146:03e976389d16 32 *
mega64 146:03e976389d16 33 * @Note Synchronization level: Not protected
mega64 146:03e976389d16 34 *
mega64 146:03e976389d16 35 * Example:
mega64 146:03e976389d16 36 * @code
mega64 146:03e976389d16 37 * // Reply to a SPI master as slave
mega64 146:03e976389d16 38 *
mega64 146:03e976389d16 39 * #include "mbed.h"
mega64 146:03e976389d16 40 *
mega64 146:03e976389d16 41 * SPISlave device(p5, p6, p7, p8); // mosi, miso, sclk, ssel
mega64 146:03e976389d16 42 *
mega64 146:03e976389d16 43 * int main() {
mega64 146:03e976389d16 44 * device.reply(0x00); // Prime SPI with first reply
mega64 146:03e976389d16 45 * while(1) {
mega64 146:03e976389d16 46 * if(device.receive()) {
mega64 146:03e976389d16 47 * int v = device.read(); // Read byte from master
mega64 146:03e976389d16 48 * v = (v + 1) % 0x100; // Add one to it, modulo 256
mega64 146:03e976389d16 49 * device.reply(v); // Make this the next reply
mega64 146:03e976389d16 50 * }
mega64 146:03e976389d16 51 * }
mega64 146:03e976389d16 52 * }
mega64 146:03e976389d16 53 * @endcode
mega64 146:03e976389d16 54 */
mega64 146:03e976389d16 55 class SPISlave {
mega64 146:03e976389d16 56
mega64 146:03e976389d16 57 public:
mega64 146:03e976389d16 58
mega64 146:03e976389d16 59 /** Create a SPI slave connected to the specified pins
mega64 146:03e976389d16 60 *
mega64 146:03e976389d16 61 * mosi or miso can be specfied as NC if not used
mega64 146:03e976389d16 62 *
mega64 146:03e976389d16 63 * @param mosi SPI Master Out, Slave In pin
mega64 146:03e976389d16 64 * @param miso SPI Master In, Slave Out pin
mega64 146:03e976389d16 65 * @param sclk SPI Clock pin
mega64 146:03e976389d16 66 * @param ssel SPI chip select pin
mega64 146:03e976389d16 67 */
mega64 146:03e976389d16 68 SPISlave(PinName mosi, PinName miso, PinName sclk, PinName ssel);
mega64 146:03e976389d16 69
mega64 146:03e976389d16 70 /** Configure the data transmission format
mega64 146:03e976389d16 71 *
mega64 146:03e976389d16 72 * @param bits Number of bits per SPI frame (4 - 16)
mega64 146:03e976389d16 73 * @param mode Clock polarity and phase mode (0 - 3)
mega64 146:03e976389d16 74 *
mega64 146:03e976389d16 75 * @code
mega64 146:03e976389d16 76 * mode | POL PHA
mega64 146:03e976389d16 77 * -----+--------
mega64 146:03e976389d16 78 * 0 | 0 0
mega64 146:03e976389d16 79 * 1 | 0 1
mega64 146:03e976389d16 80 * 2 | 1 0
mega64 146:03e976389d16 81 * 3 | 1 1
mega64 146:03e976389d16 82 * @endcode
mega64 146:03e976389d16 83 */
mega64 146:03e976389d16 84 void format(int bits, int mode = 0);
mega64 146:03e976389d16 85
mega64 146:03e976389d16 86 /** Set the spi bus clock frequency
mega64 146:03e976389d16 87 *
mega64 146:03e976389d16 88 * @param hz SCLK frequency in hz (default = 1MHz)
mega64 146:03e976389d16 89 */
mega64 146:03e976389d16 90 void frequency(int hz = 1000000);
mega64 146:03e976389d16 91
mega64 146:03e976389d16 92 /** Polls the SPI to see if data has been received
mega64 146:03e976389d16 93 *
mega64 146:03e976389d16 94 * @returns
mega64 146:03e976389d16 95 * 0 if no data,
mega64 146:03e976389d16 96 * 1 otherwise
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 int receive(void);
mega64 146:03e976389d16 99
mega64 146:03e976389d16 100 /** Retrieve data from receive buffer as slave
mega64 146:03e976389d16 101 *
mega64 146:03e976389d16 102 * @returns
mega64 146:03e976389d16 103 * the data in the receive buffer
mega64 146:03e976389d16 104 */
mega64 146:03e976389d16 105 int read(void);
mega64 146:03e976389d16 106
mega64 146:03e976389d16 107 /** Fill the transmission buffer with the value to be written out
mega64 146:03e976389d16 108 * as slave on the next received message from the master.
mega64 146:03e976389d16 109 *
mega64 146:03e976389d16 110 * @param value the data to be transmitted next
mega64 146:03e976389d16 111 */
mega64 146:03e976389d16 112 void reply(int value);
mega64 146:03e976389d16 113
mega64 146:03e976389d16 114 protected:
mega64 146:03e976389d16 115 spi_t _spi;
mega64 146:03e976389d16 116
mega64 146:03e976389d16 117 int _bits;
mega64 146:03e976389d16 118 int _mode;
mega64 146:03e976389d16 119 int _hz;
mega64 146:03e976389d16 120 };
mega64 146:03e976389d16 121
mega64 146:03e976389d16 122 } // namespace mbed
mega64 146:03e976389d16 123
mega64 146:03e976389d16 124 #endif
mega64 146:03e976389d16 125
mega64 146:03e976389d16 126 #endif
mega64 146:03e976389d16 127
mega64 146:03e976389d16 128 /** @}*/