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/FileLike.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_FILELIKE_H
mega64 146:03e976389d16 17 #define MBED_FILELIKE_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/mbed_toolchain.h"
mega64 146:03e976389d16 20 #include "drivers/FileBase.h"
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 namespace mbed {
mega64 146:03e976389d16 23 /** \addtogroup drivers */
mega64 146:03e976389d16 24 /** @{*/
mega64 146:03e976389d16 25
mega64 146:03e976389d16 26
mega64 146:03e976389d16 27 /* Class FileLike
mega64 146:03e976389d16 28 * A file-like object is one that can be opened with fopen by
mega64 146:03e976389d16 29 * fopen("/name", mode).
mega64 146:03e976389d16 30 *
mega64 146:03e976389d16 31 * @Note Synchronization level: Set by subclass
mega64 146:03e976389d16 32 */
mega64 146:03e976389d16 33 class FileLike : public FileBase {
mega64 146:03e976389d16 34 public:
mega64 146:03e976389d16 35 /** Constructor FileLike
mega64 146:03e976389d16 36 *
mega64 146:03e976389d16 37 * @param name The name to use to open the file.
mega64 146:03e976389d16 38 */
mega64 146:03e976389d16 39 FileLike(const char *name = NULL) : FileBase(name, FilePathType) {}
mega64 146:03e976389d16 40 virtual ~FileLike() {}
mega64 146:03e976389d16 41
mega64 146:03e976389d16 42 /** Read the contents of a file into a buffer
mega64 146:03e976389d16 43 *
mega64 146:03e976389d16 44 * @param buffer The buffer to read in to
mega64 146:03e976389d16 45 * @param size The number of bytes to read
mega64 146:03e976389d16 46 * @return The number of bytes read, 0 at end of file, negative error on failure
mega64 146:03e976389d16 47 */
mega64 146:03e976389d16 48 virtual ssize_t read(void *buffer, size_t len) = 0;
mega64 146:03e976389d16 49
mega64 146:03e976389d16 50 /** Write the contents of a buffer to a file
mega64 146:03e976389d16 51 *
mega64 146:03e976389d16 52 * @param buffer The buffer to write from
mega64 146:03e976389d16 53 * @param size The number of bytes to write
mega64 146:03e976389d16 54 * @return The number of bytes written, negative error on failure
mega64 146:03e976389d16 55 */
mega64 146:03e976389d16 56 virtual ssize_t write(const void *buffer, size_t len) = 0;
mega64 146:03e976389d16 57
mega64 146:03e976389d16 58 /** Close a file
mega64 146:03e976389d16 59 *
mega64 146:03e976389d16 60 * @return 0 on success, negative error code on failure
mega64 146:03e976389d16 61 */
mega64 146:03e976389d16 62 virtual int close() = 0;
mega64 146:03e976389d16 63
mega64 146:03e976389d16 64 /** Flush any buffers associated with the file
mega64 146:03e976389d16 65 *
mega64 146:03e976389d16 66 * @return 0 on success, negative error code on failure
mega64 146:03e976389d16 67 */
mega64 146:03e976389d16 68 virtual int sync() = 0;
mega64 146:03e976389d16 69
mega64 146:03e976389d16 70 /** Check if the file in an interactive terminal device
mega64 146:03e976389d16 71 *
mega64 146:03e976389d16 72 * @return True if the file is a terminal
mega64 146:03e976389d16 73 */
mega64 146:03e976389d16 74 virtual int isatty() = 0;
mega64 146:03e976389d16 75
mega64 146:03e976389d16 76 /** Move the file position to a given offset from from a given location
mega64 146:03e976389d16 77 *
mega64 146:03e976389d16 78 * @param offset The offset from whence to move to
mega64 146:03e976389d16 79 * @param whence The start of where to seek
mega64 146:03e976389d16 80 * SEEK_SET to start from beginning of file,
mega64 146:03e976389d16 81 * SEEK_CUR to start from current position in file,
mega64 146:03e976389d16 82 * SEEK_END to start from end of file
mega64 146:03e976389d16 83 * @return The new offset of the file
mega64 146:03e976389d16 84 */
mega64 146:03e976389d16 85 virtual off_t seek(off_t offset, int whence = SEEK_SET) = 0;
mega64 146:03e976389d16 86
mega64 146:03e976389d16 87 /** Get the file position of the file
mega64 146:03e976389d16 88 *
mega64 146:03e976389d16 89 * @return The current offset in the file
mega64 146:03e976389d16 90 */
mega64 146:03e976389d16 91 virtual off_t tell() = 0;
mega64 146:03e976389d16 92
mega64 146:03e976389d16 93 /** Rewind the file position to the beginning of the file
mega64 146:03e976389d16 94 *
mega64 146:03e976389d16 95 * @note This is equivalent to file_seek(file, 0, FS_SEEK_SET)
mega64 146:03e976389d16 96 */
mega64 146:03e976389d16 97 virtual void rewind() = 0;
mega64 146:03e976389d16 98
mega64 146:03e976389d16 99 /** Get the size of the file
mega64 146:03e976389d16 100 *
mega64 146:03e976389d16 101 * @return Size of the file in bytes
mega64 146:03e976389d16 102 */
mega64 146:03e976389d16 103 virtual size_t size() = 0;
mega64 146:03e976389d16 104
mega64 146:03e976389d16 105 /** Move the file position to a given offset from a given location.
mega64 146:03e976389d16 106 *
mega64 146:03e976389d16 107 * @param offset The offset from whence to move to
mega64 146:03e976389d16 108 * @param whence SEEK_SET for the start of the file, SEEK_CUR for the
mega64 146:03e976389d16 109 * current file position, or SEEK_END for the end of the file.
mega64 146:03e976389d16 110 *
mega64 146:03e976389d16 111 * @returns
mega64 146:03e976389d16 112 * new file position on success,
mega64 146:03e976389d16 113 * -1 on failure or unsupported
mega64 146:03e976389d16 114 */
mega64 146:03e976389d16 115 MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileLike::seek")
mega64 146:03e976389d16 116 virtual off_t lseek(off_t offset, int whence) { return seek(offset, whence); }
mega64 146:03e976389d16 117
mega64 146:03e976389d16 118 /** Flush any buffers associated with the FileHandle, ensuring it
mega64 146:03e976389d16 119 * is up to date on disk
mega64 146:03e976389d16 120 *
mega64 146:03e976389d16 121 * @returns
mega64 146:03e976389d16 122 * 0 on success or un-needed,
mega64 146:03e976389d16 123 * -1 on error
mega64 146:03e976389d16 124 */
mega64 146:03e976389d16 125 MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileLike::sync")
mega64 146:03e976389d16 126 virtual int fsync() { return sync(); }
mega64 146:03e976389d16 127
mega64 146:03e976389d16 128 /** Find the length of the file
mega64 146:03e976389d16 129 *
mega64 146:03e976389d16 130 * @returns
mega64 146:03e976389d16 131 * Length of the file
mega64 146:03e976389d16 132 */
mega64 146:03e976389d16 133 MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileLike::size")
mega64 146:03e976389d16 134 virtual off_t flen() { return size(); }
mega64 146:03e976389d16 135
mega64 146:03e976389d16 136 protected:
mega64 146:03e976389d16 137 /** Acquire exclusive access to this object.
mega64 146:03e976389d16 138 */
mega64 146:03e976389d16 139 virtual void lock() {
mega64 146:03e976389d16 140 // Stub
mega64 146:03e976389d16 141 }
mega64 146:03e976389d16 142
mega64 146:03e976389d16 143 /** Release exclusive access to this object.
mega64 146:03e976389d16 144 */
mega64 146:03e976389d16 145 virtual void unlock() {
mega64 146:03e976389d16 146 // Stub
mega64 146:03e976389d16 147 }
mega64 146:03e976389d16 148 };
mega64 146:03e976389d16 149
mega64 146:03e976389d16 150
mega64 146:03e976389d16 151 /** @}*/
mega64 146:03e976389d16 152 } // namespace mbed
mega64 146:03e976389d16 153
mega64 146:03e976389d16 154 #endif