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)

platform/mbed_interface.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
mega64 146:03e976389d16 2 /** \addtogroup platform */
mega64 146:03e976389d16 3 /** @{*/
mega64 146:03e976389d16 4 /* mbed Microcontroller Library
mega64 146:03e976389d16 5 * Copyright (c) 2006-2013 ARM Limited
mega64 146:03e976389d16 6 *
mega64 146:03e976389d16 7 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 146:03e976389d16 8 * you may not use this file except in compliance with the License.
mega64 146:03e976389d16 9 * You may obtain a copy of the License at
mega64 146:03e976389d16 10 *
mega64 146:03e976389d16 11 * http://www.apache.org/licenses/LICENSE-2.0
mega64 146:03e976389d16 12 *
mega64 146:03e976389d16 13 * Unless required by applicable law or agreed to in writing, software
mega64 146:03e976389d16 14 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 146:03e976389d16 15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 146:03e976389d16 16 * See the License for the specific language governing permissions and
mega64 146:03e976389d16 17 * limitations under the License.
mega64 146:03e976389d16 18 */
mega64 146:03e976389d16 19 #ifndef MBED_INTERFACE_H
mega64 146:03e976389d16 20 #define MBED_INTERFACE_H
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 #include <stdarg.h>
mega64 146:03e976389d16 23
mega64 146:03e976389d16 24 #include "device.h"
mega64 146:03e976389d16 25
mega64 146:03e976389d16 26 /* Mbed interface mac address
mega64 146:03e976389d16 27 * if MBED_MAC_ADD_x are zero, interface uid sets mac address,
mega64 146:03e976389d16 28 * otherwise MAC_ADD_x are used.
mega64 146:03e976389d16 29 */
mega64 146:03e976389d16 30 #define MBED_MAC_ADDR_INTERFACE 0x00
mega64 146:03e976389d16 31 #define MBED_MAC_ADDR_0 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 32 #define MBED_MAC_ADDR_1 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 33 #define MBED_MAC_ADDR_2 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 34 #define MBED_MAC_ADDR_3 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 35 #define MBED_MAC_ADDR_4 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 36 #define MBED_MAC_ADDR_5 MBED_MAC_ADDR_INTERFACE
mega64 146:03e976389d16 37 #define MBED_MAC_ADDRESS_SUM (MBED_MAC_ADDR_0 | MBED_MAC_ADDR_1 | MBED_MAC_ADDR_2 | MBED_MAC_ADDR_3 | MBED_MAC_ADDR_4 | MBED_MAC_ADDR_5)
mega64 146:03e976389d16 38
mega64 146:03e976389d16 39 #ifdef __cplusplus
mega64 146:03e976389d16 40 extern "C" {
mega64 146:03e976389d16 41 #endif
mega64 146:03e976389d16 42
mega64 146:03e976389d16 43 #if DEVICE_SEMIHOST
mega64 146:03e976389d16 44
mega64 146:03e976389d16 45 /** Functions to control the mbed interface
mega64 146:03e976389d16 46 *
mega64 146:03e976389d16 47 * mbed Microcontrollers have a built-in interface to provide functionality such as
mega64 146:03e976389d16 48 * drag-n-drop download, reset, serial-over-usb, and access to the mbed local file
mega64 146:03e976389d16 49 * system. These functions provide means to control the interface suing semihost
mega64 146:03e976389d16 50 * calls it supports.
mega64 146:03e976389d16 51 */
mega64 146:03e976389d16 52
mega64 146:03e976389d16 53 /** Determine whether the mbed interface is connected, based on whether debug is enabled
mega64 146:03e976389d16 54 *
mega64 146:03e976389d16 55 * @returns
mega64 146:03e976389d16 56 * 1 if interface is connected,
mega64 146:03e976389d16 57 * 0 otherwise
mega64 146:03e976389d16 58 */
mega64 146:03e976389d16 59 int mbed_interface_connected(void);
mega64 146:03e976389d16 60
mega64 146:03e976389d16 61 /** Instruct the mbed interface to reset, as if the reset button had been pressed
mega64 146:03e976389d16 62 *
mega64 146:03e976389d16 63 * @returns
mega64 146:03e976389d16 64 * 1 if successful,
mega64 146:03e976389d16 65 * 0 otherwise (e.g. interface not present)
mega64 146:03e976389d16 66 */
mega64 146:03e976389d16 67 int mbed_interface_reset(void);
mega64 146:03e976389d16 68
mega64 146:03e976389d16 69 /** This will disconnect the debug aspect of the interface, so semihosting will be disabled.
mega64 146:03e976389d16 70 * The interface will still support the USB serial aspect
mega64 146:03e976389d16 71 *
mega64 146:03e976389d16 72 * @returns
mega64 146:03e976389d16 73 * 0 if successful,
mega64 146:03e976389d16 74 * -1 otherwise (e.g. interface not present)
mega64 146:03e976389d16 75 */
mega64 146:03e976389d16 76 int mbed_interface_disconnect(void);
mega64 146:03e976389d16 77
mega64 146:03e976389d16 78 /** This will disconnect the debug aspect of the interface, and if the USB cable is not
mega64 146:03e976389d16 79 * connected, also power down the interface. If the USB cable is connected, the interface
mega64 146:03e976389d16 80 * will remain powered up and visible to the host
mega64 146:03e976389d16 81 *
mega64 146:03e976389d16 82 * @returns
mega64 146:03e976389d16 83 * 0 if successful,
mega64 146:03e976389d16 84 * -1 otherwise (e.g. interface not present)
mega64 146:03e976389d16 85 */
mega64 146:03e976389d16 86 int mbed_interface_powerdown(void);
mega64 146:03e976389d16 87
mega64 146:03e976389d16 88 /** This returns a string containing the 32-character UID of the mbed interface
mega64 146:03e976389d16 89 * This is a weak function that can be overwritten if required
mega64 146:03e976389d16 90 *
mega64 146:03e976389d16 91 * @param uid A 33-byte array to write the null terminated 32-byte string
mega64 146:03e976389d16 92 *
mega64 146:03e976389d16 93 * @returns
mega64 146:03e976389d16 94 * 0 if successful,
mega64 146:03e976389d16 95 * -1 otherwise (e.g. interface not present)
mega64 146:03e976389d16 96 */
mega64 146:03e976389d16 97 int mbed_interface_uid(char *uid);
mega64 146:03e976389d16 98
mega64 146:03e976389d16 99 #endif
mega64 146:03e976389d16 100
mega64 146:03e976389d16 101 /** This returns a unique 6-byte MAC address, based on the interface UID
mega64 146:03e976389d16 102 * If the interface is not present, it returns a default fixed MAC address (00:02:F7:F0:00:00)
mega64 146:03e976389d16 103 *
mega64 146:03e976389d16 104 * This is a weak function that can be overwritten if you want to provide your own mechanism to
mega64 146:03e976389d16 105 * provide a MAC address.
mega64 146:03e976389d16 106 *
mega64 146:03e976389d16 107 * @param mac A 6-byte array to write the MAC address
mega64 146:03e976389d16 108 */
mega64 146:03e976389d16 109 void mbed_mac_address(char *mac);
mega64 146:03e976389d16 110
mega64 146:03e976389d16 111 /** Cause the mbed to flash the BLOD (Blue LEDs Of Death) sequence
mega64 146:03e976389d16 112 */
mega64 146:03e976389d16 113 void mbed_die(void);
mega64 146:03e976389d16 114
mega64 146:03e976389d16 115 /** Print out an error message. This is typically called when
mega64 146:03e976389d16 116 * hanlding a crash.
mega64 146:03e976389d16 117 *
mega64 146:03e976389d16 118 * @Note Synchronization level: Interrupt safe
mega64 146:03e976389d16 119 */
mega64 146:03e976389d16 120 void mbed_error_printf(const char* format, ...);
mega64 146:03e976389d16 121
mega64 146:03e976389d16 122 /** Print out an error message. Similar to mbed_error_printf
mega64 146:03e976389d16 123 * but uses a va_list.
mega64 146:03e976389d16 124 *
mega64 146:03e976389d16 125 * @Note Synchronization level: Interrupt safe
mega64 146:03e976389d16 126 */
mega64 146:03e976389d16 127 void mbed_error_vfprintf(const char * format, va_list arg);
mega64 146:03e976389d16 128
mega64 146:03e976389d16 129 #ifdef __cplusplus
mega64 146:03e976389d16 130 }
mega64 146:03e976389d16 131 #endif
mega64 146:03e976389d16 132
mega64 146:03e976389d16 133 #endif
mega64 146:03e976389d16 134
mega64 146:03e976389d16 135 /** @}*/