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_semihost_api.c@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 #include "cmsis.h"
mega64 146:03e976389d16 17 #include "platform/mbed_semihost_api.h"
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include <stdint.h>
mega64 146:03e976389d16 20 #include <string.h>
mega64 146:03e976389d16 21
mega64 146:03e976389d16 22 #if DEVICE_SEMIHOST
mega64 146:03e976389d16 23
mega64 146:03e976389d16 24 // ARM Semihosting Commands
mega64 146:03e976389d16 25 #define SYS_OPEN (0x1)
mega64 146:03e976389d16 26 #define SYS_CLOSE (0x2)
mega64 146:03e976389d16 27 #define SYS_WRITE (0x5)
mega64 146:03e976389d16 28 #define SYS_READ (0x6)
mega64 146:03e976389d16 29 #define SYS_ISTTY (0x9)
mega64 146:03e976389d16 30 #define SYS_SEEK (0xa)
mega64 146:03e976389d16 31 #define SYS_ENSURE (0xb)
mega64 146:03e976389d16 32 #define SYS_FLEN (0xc)
mega64 146:03e976389d16 33 #define SYS_REMOVE (0xe)
mega64 146:03e976389d16 34 #define SYS_RENAME (0xf)
mega64 146:03e976389d16 35 #define SYS_EXIT (0x18)
mega64 146:03e976389d16 36
mega64 146:03e976389d16 37 // mbed Semihosting Commands
mega64 146:03e976389d16 38 #define RESERVED_FOR_USER_APPLICATIONS (0x100) // 0x100 - 0x1ff
mega64 146:03e976389d16 39 #define USR_XFFIND (RESERVED_FOR_USER_APPLICATIONS + 0)
mega64 146:03e976389d16 40 #define USR_UID (RESERVED_FOR_USER_APPLICATIONS + 1)
mega64 146:03e976389d16 41 #define USR_RESET (RESERVED_FOR_USER_APPLICATIONS + 2)
mega64 146:03e976389d16 42 #define USR_VBUS (RESERVED_FOR_USER_APPLICATIONS + 3)
mega64 146:03e976389d16 43 #define USR_POWERDOWN (RESERVED_FOR_USER_APPLICATIONS + 4)
mega64 146:03e976389d16 44 #define USR_DISABLEDEBUG (RESERVED_FOR_USER_APPLICATIONS + 5)
mega64 146:03e976389d16 45
mega64 146:03e976389d16 46 #if DEVICE_LOCALFILESYSTEM
mega64 146:03e976389d16 47 FILEHANDLE semihost_open(const char* name, int openmode) {
mega64 146:03e976389d16 48 uint32_t args[3];
mega64 146:03e976389d16 49 args[0] = (uint32_t)name;
mega64 146:03e976389d16 50 args[1] = (uint32_t)openmode;
mega64 146:03e976389d16 51 args[2] = (uint32_t)strlen(name);
mega64 146:03e976389d16 52 return __semihost(SYS_OPEN, args);
mega64 146:03e976389d16 53 }
mega64 146:03e976389d16 54
mega64 146:03e976389d16 55 int semihost_close(FILEHANDLE fh) {
mega64 146:03e976389d16 56 return __semihost(SYS_CLOSE, &fh);
mega64 146:03e976389d16 57 }
mega64 146:03e976389d16 58
mega64 146:03e976389d16 59 int semihost_write(FILEHANDLE fh, const unsigned char* buffer, unsigned int length, int mode) {
mega64 146:03e976389d16 60 if (length == 0) return 0;
mega64 146:03e976389d16 61
mega64 146:03e976389d16 62 uint32_t args[3];
mega64 146:03e976389d16 63 args[0] = (uint32_t)fh;
mega64 146:03e976389d16 64 args[1] = (uint32_t)buffer;
mega64 146:03e976389d16 65 args[2] = (uint32_t)length;
mega64 146:03e976389d16 66 return __semihost(SYS_WRITE, args);
mega64 146:03e976389d16 67 }
mega64 146:03e976389d16 68
mega64 146:03e976389d16 69 int semihost_read(FILEHANDLE fh, unsigned char* buffer, unsigned int length, int mode) {
mega64 146:03e976389d16 70 uint32_t args[3];
mega64 146:03e976389d16 71 args[0] = (uint32_t)fh;
mega64 146:03e976389d16 72 args[1] = (uint32_t)buffer;
mega64 146:03e976389d16 73 args[2] = (uint32_t)length;
mega64 146:03e976389d16 74 return __semihost(SYS_READ, args);
mega64 146:03e976389d16 75 }
mega64 146:03e976389d16 76
mega64 146:03e976389d16 77 int semihost_istty(FILEHANDLE fh) {
mega64 146:03e976389d16 78 return __semihost(SYS_ISTTY, &fh);
mega64 146:03e976389d16 79 }
mega64 146:03e976389d16 80
mega64 146:03e976389d16 81 int semihost_seek(FILEHANDLE fh, long position) {
mega64 146:03e976389d16 82 uint32_t args[2];
mega64 146:03e976389d16 83 args[0] = (uint32_t)fh;
mega64 146:03e976389d16 84 args[1] = (uint32_t)position;
mega64 146:03e976389d16 85 return __semihost(SYS_SEEK, args);
mega64 146:03e976389d16 86 }
mega64 146:03e976389d16 87
mega64 146:03e976389d16 88 int semihost_ensure(FILEHANDLE fh) {
mega64 146:03e976389d16 89 return __semihost(SYS_ENSURE, &fh);
mega64 146:03e976389d16 90 }
mega64 146:03e976389d16 91
mega64 146:03e976389d16 92 long semihost_flen(FILEHANDLE fh) {
mega64 146:03e976389d16 93 return __semihost(SYS_FLEN, &fh);
mega64 146:03e976389d16 94 }
mega64 146:03e976389d16 95
mega64 146:03e976389d16 96 int semihost_remove(const char *name) {
mega64 146:03e976389d16 97 uint32_t args[2];
mega64 146:03e976389d16 98 args[0] = (uint32_t)name;
mega64 146:03e976389d16 99 args[1] = (uint32_t)strlen(name);
mega64 146:03e976389d16 100 return __semihost(SYS_REMOVE, args);
mega64 146:03e976389d16 101 }
mega64 146:03e976389d16 102
mega64 146:03e976389d16 103 int semihost_rename(const char *old_name, const char *new_name) {
mega64 146:03e976389d16 104 uint32_t args[4];
mega64 146:03e976389d16 105 args[0] = (uint32_t)old_name;
mega64 146:03e976389d16 106 args[1] = (uint32_t)strlen(old_name);
mega64 146:03e976389d16 107 args[0] = (uint32_t)new_name;
mega64 146:03e976389d16 108 args[1] = (uint32_t)strlen(new_name);
mega64 146:03e976389d16 109 return __semihost(SYS_RENAME, args);
mega64 146:03e976389d16 110 }
mega64 146:03e976389d16 111 #endif
mega64 146:03e976389d16 112
mega64 146:03e976389d16 113 int semihost_exit(void) {
mega64 146:03e976389d16 114 uint32_t args[4];
mega64 146:03e976389d16 115 return __semihost(SYS_EXIT, args);
mega64 146:03e976389d16 116 }
mega64 146:03e976389d16 117
mega64 146:03e976389d16 118 int semihost_uid(char *uid) {
mega64 146:03e976389d16 119 uint32_t args[2];
mega64 146:03e976389d16 120 args[0] = (uint32_t)uid;
mega64 146:03e976389d16 121 args[1] = DEVICE_ID_LENGTH + 1;
mega64 146:03e976389d16 122 return __semihost(USR_UID, &args);
mega64 146:03e976389d16 123 }
mega64 146:03e976389d16 124
mega64 146:03e976389d16 125 int semihost_reset(void) {
mega64 146:03e976389d16 126 // Does not normally return, however if used with older firmware versions
mega64 146:03e976389d16 127 // that do not support this call it will return -1.
mega64 146:03e976389d16 128 return __semihost(USR_RESET, NULL);
mega64 146:03e976389d16 129 }
mega64 146:03e976389d16 130
mega64 146:03e976389d16 131 int semihost_vbus(void) {
mega64 146:03e976389d16 132 return __semihost(USR_VBUS, NULL);
mega64 146:03e976389d16 133 }
mega64 146:03e976389d16 134
mega64 146:03e976389d16 135 int semihost_powerdown(void) {
mega64 146:03e976389d16 136 return __semihost(USR_POWERDOWN, NULL);
mega64 146:03e976389d16 137 }
mega64 146:03e976389d16 138
mega64 146:03e976389d16 139 #if DEVICE_DEBUG_AWARENESS
mega64 146:03e976389d16 140
mega64 146:03e976389d16 141 int semihost_connected(void) {
mega64 146:03e976389d16 142 return (CoreDebug->DHCSR & CoreDebug_DHCSR_C_DEBUGEN_Msk) ? 1 : 0;
mega64 146:03e976389d16 143 }
mega64 146:03e976389d16 144
mega64 146:03e976389d16 145 #else
mega64 146:03e976389d16 146 // These processors cannot know if the interface is connect, assume so:
mega64 146:03e976389d16 147 static int is_debugger_attached = 1;
mega64 146:03e976389d16 148
mega64 146:03e976389d16 149 int semihost_connected(void) {
mega64 146:03e976389d16 150 return is_debugger_attached;
mega64 146:03e976389d16 151 }
mega64 146:03e976389d16 152 #endif
mega64 146:03e976389d16 153
mega64 146:03e976389d16 154 int semihost_disabledebug(void) {
mega64 146:03e976389d16 155 #if !(DEVICE_DEBUG_AWARENESS)
mega64 146:03e976389d16 156 is_debugger_attached = 0;
mega64 146:03e976389d16 157 #endif
mega64 146:03e976389d16 158 return __semihost(USR_DISABLEDEBUG, NULL);
mega64 146:03e976389d16 159 }
mega64 146:03e976389d16 160
mega64 146:03e976389d16 161 #endif
mega64 146:03e976389d16 162