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/DirHandle.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_DIRHANDLE_H
mega64 146:03e976389d16 17 #define MBED_DIRHANDLE_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include <stdint.h>
mega64 146:03e976389d16 20 #include "platform/platform.h"
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 #include "FileHandle.h"
mega64 146:03e976389d16 23
mega64 146:03e976389d16 24 namespace mbed {
mega64 146:03e976389d16 25 /** \addtogroup drivers */
mega64 146:03e976389d16 26 /** @{*/
mega64 146:03e976389d16 27
mega64 146:03e976389d16 28 /** Represents a directory stream. Objects of this type are returned
mega64 146:03e976389d16 29 * by a FileSystemLike's opendir method. Implementations must define
mega64 146:03e976389d16 30 * at least closedir, readdir and rewinddir.
mega64 146:03e976389d16 31 *
mega64 146:03e976389d16 32 * If a FileSystemLike class defines the opendir method, then the
mega64 146:03e976389d16 33 * directories of an object of that type can be accessed by
mega64 146:03e976389d16 34 * DIR *d = opendir("/example/directory") (or opendir("/example")
mega64 146:03e976389d16 35 * to open the root of the filesystem), and then using readdir(d) etc.
mega64 146:03e976389d16 36 *
mega64 146:03e976389d16 37 * The root directory is considered to contain all FileLike and
mega64 146:03e976389d16 38 * FileSystemLike objects, so the DIR* returned by opendir("/") will
mega64 146:03e976389d16 39 * reflect this.
mega64 146:03e976389d16 40 *
mega64 146:03e976389d16 41 * @Note Synchronization level: Set by subclass
mega64 146:03e976389d16 42 */
mega64 146:03e976389d16 43 class DirHandle {
mega64 146:03e976389d16 44 public:
mega64 146:03e976389d16 45 MBED_DEPRECATED_SINCE("mbed-os-5.4",
mega64 146:03e976389d16 46 "The mbed 2 filesystem classes have been superseeded by the FileSystem api, "
mega64 146:03e976389d16 47 "Replaced by File")
mega64 146:03e976389d16 48 DirHandle() {}
mega64 146:03e976389d16 49
mega64 146:03e976389d16 50 /** Closes the directory.
mega64 146:03e976389d16 51 *
mega64 146:03e976389d16 52 * @returns
mega64 146:03e976389d16 53 * 0 on success,
mega64 146:03e976389d16 54 * -1 on error.
mega64 146:03e976389d16 55 */
mega64 146:03e976389d16 56 virtual int closedir()=0;
mega64 146:03e976389d16 57
mega64 146:03e976389d16 58 /** Return the directory entry at the current position, and
mega64 146:03e976389d16 59 * advances the position to the next entry.
mega64 146:03e976389d16 60 *
mega64 146:03e976389d16 61 * @returns
mega64 146:03e976389d16 62 * A pointer to a dirent structure representing the
mega64 146:03e976389d16 63 * directory entry at the current position, or NULL on reaching
mega64 146:03e976389d16 64 * end of directory or error.
mega64 146:03e976389d16 65 */
mega64 146:03e976389d16 66 virtual struct dirent *readdir()=0;
mega64 146:03e976389d16 67
mega64 146:03e976389d16 68 /** Resets the position to the beginning of the directory.
mega64 146:03e976389d16 69 */
mega64 146:03e976389d16 70 virtual void rewinddir()=0;
mega64 146:03e976389d16 71
mega64 146:03e976389d16 72 /** Returns the current position of the DirHandle.
mega64 146:03e976389d16 73 *
mega64 146:03e976389d16 74 * @returns
mega64 146:03e976389d16 75 * the current position,
mega64 146:03e976389d16 76 * -1 on error.
mega64 146:03e976389d16 77 */
mega64 146:03e976389d16 78 virtual off_t telldir() { return -1; }
mega64 146:03e976389d16 79
mega64 146:03e976389d16 80 /** Sets the position of the DirHandle.
mega64 146:03e976389d16 81 *
mega64 146:03e976389d16 82 * @param location The location to seek to. Must be a value returned by telldir.
mega64 146:03e976389d16 83 */
mega64 146:03e976389d16 84 virtual void seekdir(off_t location) { (void)location;}
mega64 146:03e976389d16 85
mega64 146:03e976389d16 86 virtual ~DirHandle() {}
mega64 146:03e976389d16 87
mega64 146:03e976389d16 88 protected:
mega64 146:03e976389d16 89
mega64 146:03e976389d16 90 /** Acquire exclusive access to this object.
mega64 146:03e976389d16 91 */
mega64 146:03e976389d16 92 virtual void lock() {
mega64 146:03e976389d16 93 // Stub
mega64 146:03e976389d16 94 }
mega64 146:03e976389d16 95
mega64 146:03e976389d16 96 /** Release exclusive access to this object.
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 virtual void unlock() {
mega64 146:03e976389d16 99 // Stub
mega64 146:03e976389d16 100 }
mega64 146:03e976389d16 101
mega64 146:03e976389d16 102 protected:
mega64 146:03e976389d16 103 /** Internal-only constructor to work around deprecated notices when not used
mega64 146:03e976389d16 104 *. due to nested deprecations and difficulty of compilers finding their way around
mega64 146:03e976389d16 105 * the class hierarchy
mega64 146:03e976389d16 106 */
mega64 146:03e976389d16 107 friend class FileSystemLike;
mega64 146:03e976389d16 108 DirHandle(int) {}
mega64 146:03e976389d16 109 };
mega64 146:03e976389d16 110
mega64 146:03e976389d16 111 } // namespace mbed
mega64 146:03e976389d16 112
mega64 146:03e976389d16 113 #endif /* MBED_DIRHANDLE_H */
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 /** @}*/