Modification of mbed-src library only for STM32F030F4, very cheap microcontroller in 20-Pin TSSOP package, with 16Kbytes of Flash and 4Kbytes of Ram. **Target for online compilator must be Nucleo 32F030R8.**

Dependents:   STM32F031_blink_LED_2


Information

For programming similar chips in TSSOP20 package, but with 32kB flash: STM32F031F6 and STM32F050F6 (virtually identical to STM32F031F6 and no longer produced but still on sale), it is recommended to use NUCLEO-F031K6 as compiler platform, and the mbed library without the need for any modifications.

Just remember that the only significant difference between these chips and NUCLEO-F031K6 is the lack of pins: PB_0, PB_3, PB_4, PB_5, PB_6, PB_7, PA_11, PA_12, PA_15 in TSSOP-20.



STM32F030F4 pinout (pin functions supported in mbed library).

/media/uploads/mega64/mbedf4.jpg

other pins:

Pin nrPin nameConnectedST-LINK on Nucleo (programming and debug)
1.BOOT0GND
4.NRSTCN4 pin 5
5.VDDA+3.3V
15.VSSGNDCN4 pin 3
16.VDD+3.3V
19.SWDIOCN4 pin 4
20.SWCLKCN4 pin 2
  • Remove jumpers CN2 on Nucleo when CN4 is connected to STM32F030F4
  • NRST connection is not necessarily needed, but in this case, after programming it is necessary to manually reset the target processor


STM32R030F4 programming using Nucleo (any type):
/media/uploads/mega64/f4_nucleo.jpg Notes:

  • When programming using the Nucleo virtual disk (drag and drop) , first turn on the power STM32F030F4, and then connect Nucleo to USB. When programming with "ST-LINK Utility", it does not matter.




STM32R030F4 programming using Arduino (as a simple USB-Serial converter) and FlyMcu program:
/media/uploads/mega64/f4_arduino.jpg

Notes:

  • For Usart in STM32F030F4, only 5V tolerant TX, RX pins are pins 17 and 18. Just their uses internal serial bootloader, so you can use such Arduino or other USB-Serial converter operating as standard 5V.
  • Where used FlyMcu, binary file from online compiler Mbed need to convert to intel hex file and during the conversion add the data offset 0x08000000 (or if offset is 0, manually add/edit the first line of the .hex file to ":020000040800F2").
  • During programming procedure, pin 1 (BOOT0) should be connected to 3.3 V. And before contact with the loader program, temporarily pin 4 (NRST) shorted to GND to reset the chip. After programming BOOT0 is connected to GND.
  • In this set with Arduino Uno, the "Flash loader demonstrator" from STM does not work (does not recognize the response from the chip at the initial stage of connection). But with Arduino Duemilanove program "STM Flash loader demonstrator" works perfectly (ver. 2.7.0). And do not need any additional file conversion (as the need for FlyMcu). You can use a binary file directly from the on-line compiler mbed.

Warning.
Because of the small size of the STM32F030F4 flash, for programs that use UART, it is proposed not to use the Serial class but use the <cstdio> (stdio.h) functions that directly use stdout and stdin (e.g printf().putchar(),getchar(),vprintf(),scanf() ).

Example:

version with serial class

#include "mbed.h"
Serial pc(USBTX, USBRX); // tx, rx

int main()
{

    pc.printf("Hello World!\n");

}

consuming 13.7kB FLASH and 1.5kB RAM

but this:

version without serial class

#include "mbed.h"
int main()
{

    printf("Hello World!\n");

}

consuming only 8.7kB FLASH and 0.4kB RAM

5kB used flash difference (with 16kB total size) !!!

However, if you need other than the default UART settings for stdin and stdout (that is 9600b, pins PA_2, PA_3), you can do as an example:

change uart pins and speed

#include "mbed.h"

// declarations needed to change here the parameters of stdio UART
extern int stdio_uart_inited;
extern serial_t stdio_uart; 

int main()
{
    // for change pins
    serial_init(&stdio_uart, PA_9,PA_10);
    stdio_uart_inited=1;

    // for change baud rate
    serial_baud(&stdio_uart, 115000);


    printf("Hello World!\n");

}




uVision users

In the case of online compilation of the program with this library using Keil, to prevent linker errors set in the project options "One ELF Section per Function" and Optimisation: Level 2.



Additional information (and inspiration for this modification):

http://developer.mbed.org/forum/electronics/topic/5184/

http://developer.mbed.org/questions/4643/Does-mbed-support-STM32F030F4/

http://developer.mbed.org/questions/2927/mbed-on-other-packages-stm32f030f4-TSSOP/

http://developer.mbed.org/questions/4139/Programming-STM32F030F4-with-Nucleo-F030/

Committer:
mega64
Date:
Sat Oct 18 02:40:17 2014 +0000
Revision:
0:38ccae254a29
only for STM32F030F4

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mega64 0:38ccae254a29 1 /* mbed Microcontroller Library
mega64 0:38ccae254a29 2 * Copyright (c) 2006-2013 ARM Limited
mega64 0:38ccae254a29 3 *
mega64 0:38ccae254a29 4 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 0:38ccae254a29 5 * you may not use this file except in compliance with the License.
mega64 0:38ccae254a29 6 * You may obtain a copy of the License at
mega64 0:38ccae254a29 7 *
mega64 0:38ccae254a29 8 * http://www.apache.org/licenses/LICENSE-2.0
mega64 0:38ccae254a29 9 *
mega64 0:38ccae254a29 10 * Unless required by applicable law or agreed to in writing, software
mega64 0:38ccae254a29 11 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 0:38ccae254a29 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 0:38ccae254a29 13 * See the License for the specific language governing permissions and
mega64 0:38ccae254a29 14 * limitations under the License.
mega64 0:38ccae254a29 15 */
mega64 0:38ccae254a29 16 #include "LocalFileSystem.h"
mega64 0:38ccae254a29 17
mega64 0:38ccae254a29 18 #if DEVICE_LOCALFILESYSTEM
mega64 0:38ccae254a29 19
mega64 0:38ccae254a29 20 #include "semihost_api.h"
mega64 0:38ccae254a29 21 #include <string.h>
mega64 0:38ccae254a29 22 #include <stdio.h>
mega64 0:38ccae254a29 23
mega64 0:38ccae254a29 24 namespace mbed {
mega64 0:38ccae254a29 25
mega64 0:38ccae254a29 26 /* Extension to FINFO type defined in RTL.h (in Keil RL) - adds 'create time'. */
mega64 0:38ccae254a29 27 typedef struct {
mega64 0:38ccae254a29 28 unsigned char hr; /* Hours [0..23] */
mega64 0:38ccae254a29 29 unsigned char min; /* Minutes [0..59] */
mega64 0:38ccae254a29 30 unsigned char sec; /* Seconds [0..59] */
mega64 0:38ccae254a29 31 unsigned char day; /* Day [1..31] */
mega64 0:38ccae254a29 32 unsigned char mon; /* Month [1..12] */
mega64 0:38ccae254a29 33 unsigned short year; /* Year [1980..2107] */
mega64 0:38ccae254a29 34 } FTIME;
mega64 0:38ccae254a29 35
mega64 0:38ccae254a29 36 typedef struct { /* File Search info record */
mega64 0:38ccae254a29 37 char name[32]; /* File name */
mega64 0:38ccae254a29 38 long size; /* File size in bytes */
mega64 0:38ccae254a29 39 int fileID; /* System File Identification */
mega64 0:38ccae254a29 40 FTIME create_time; /* Date & time file was created */
mega64 0:38ccae254a29 41 FTIME write_time; /* Date & time of last write */
mega64 0:38ccae254a29 42 } XFINFO;
mega64 0:38ccae254a29 43
mega64 0:38ccae254a29 44 #define RESERVED_FOR_USER_APPLICATIONS (0x100) /* 0x100 - 0x1ff */
mega64 0:38ccae254a29 45 #define USR_XFFIND (RESERVED_FOR_USER_APPLICATIONS + 0)
mega64 0:38ccae254a29 46
mega64 0:38ccae254a29 47 static int xffind (const char *pattern, XFINFO *info) {
mega64 0:38ccae254a29 48 unsigned param[4];
mega64 0:38ccae254a29 49
mega64 0:38ccae254a29 50 param[0] = (unsigned long)pattern;
mega64 0:38ccae254a29 51 param[1] = (unsigned long)strlen(pattern);
mega64 0:38ccae254a29 52 param[2] = (unsigned long)info;
mega64 0:38ccae254a29 53 param[3] = (unsigned long)sizeof(XFINFO);
mega64 0:38ccae254a29 54
mega64 0:38ccae254a29 55 return __semihost(USR_XFFIND, param);
mega64 0:38ccae254a29 56 }
mega64 0:38ccae254a29 57
mega64 0:38ccae254a29 58 #define OPEN_R 0
mega64 0:38ccae254a29 59 #define OPEN_B 1
mega64 0:38ccae254a29 60 #define OPEN_PLUS 2
mega64 0:38ccae254a29 61 #define OPEN_W 4
mega64 0:38ccae254a29 62 #define OPEN_A 8
mega64 0:38ccae254a29 63 #define OPEN_INVALID -1
mega64 0:38ccae254a29 64
mega64 0:38ccae254a29 65 int posix_to_semihost_open_flags(int flags) {
mega64 0:38ccae254a29 66 /* POSIX flags -> semihosting open mode */
mega64 0:38ccae254a29 67 int openmode;
mega64 0:38ccae254a29 68 if (flags & O_RDWR) {
mega64 0:38ccae254a29 69 /* a plus mode */
mega64 0:38ccae254a29 70 openmode = OPEN_PLUS;
mega64 0:38ccae254a29 71 if (flags & O_APPEND) {
mega64 0:38ccae254a29 72 openmode |= OPEN_A;
mega64 0:38ccae254a29 73 } else if (flags & O_TRUNC) {
mega64 0:38ccae254a29 74 openmode |= OPEN_W;
mega64 0:38ccae254a29 75 } else {
mega64 0:38ccae254a29 76 openmode |= OPEN_R;
mega64 0:38ccae254a29 77 }
mega64 0:38ccae254a29 78 } else if (flags & O_WRONLY) {
mega64 0:38ccae254a29 79 /* write or append */
mega64 0:38ccae254a29 80 if (flags & O_APPEND) {
mega64 0:38ccae254a29 81 openmode = OPEN_A;
mega64 0:38ccae254a29 82 } else {
mega64 0:38ccae254a29 83 openmode = OPEN_W;
mega64 0:38ccae254a29 84 }
mega64 0:38ccae254a29 85 } else if (flags == O_RDONLY) {
mega64 0:38ccae254a29 86 /* read mode */
mega64 0:38ccae254a29 87 openmode = OPEN_R;
mega64 0:38ccae254a29 88 } else {
mega64 0:38ccae254a29 89 /* invalid flags */
mega64 0:38ccae254a29 90 openmode = OPEN_INVALID;
mega64 0:38ccae254a29 91 }
mega64 0:38ccae254a29 92
mega64 0:38ccae254a29 93 return openmode;
mega64 0:38ccae254a29 94 }
mega64 0:38ccae254a29 95
mega64 0:38ccae254a29 96 FILEHANDLE local_file_open(const char* name, int flags) {
mega64 0:38ccae254a29 97 int openmode = posix_to_semihost_open_flags(flags);
mega64 0:38ccae254a29 98 if (openmode == OPEN_INVALID) {
mega64 0:38ccae254a29 99 return (FILEHANDLE)NULL;
mega64 0:38ccae254a29 100 }
mega64 0:38ccae254a29 101
mega64 0:38ccae254a29 102 FILEHANDLE fh = semihost_open(name, openmode);
mega64 0:38ccae254a29 103 if (fh == -1) {
mega64 0:38ccae254a29 104 return (FILEHANDLE)NULL;
mega64 0:38ccae254a29 105 }
mega64 0:38ccae254a29 106
mega64 0:38ccae254a29 107 return fh;
mega64 0:38ccae254a29 108 }
mega64 0:38ccae254a29 109
mega64 0:38ccae254a29 110 LocalFileHandle::LocalFileHandle(FILEHANDLE fh) : _fh(fh), pos(0) {
mega64 0:38ccae254a29 111 }
mega64 0:38ccae254a29 112
mega64 0:38ccae254a29 113 int LocalFileHandle::close() {
mega64 0:38ccae254a29 114 int retval = semihost_close(_fh);
mega64 0:38ccae254a29 115 delete this;
mega64 0:38ccae254a29 116 return retval;
mega64 0:38ccae254a29 117 }
mega64 0:38ccae254a29 118
mega64 0:38ccae254a29 119 ssize_t LocalFileHandle::write(const void *buffer, size_t length) {
mega64 0:38ccae254a29 120 ssize_t n = semihost_write(_fh, (const unsigned char*)buffer, length, 0); // number of characters not written
mega64 0:38ccae254a29 121 n = length - n; // number of characters written
mega64 0:38ccae254a29 122 pos += n;
mega64 0:38ccae254a29 123 return n;
mega64 0:38ccae254a29 124 }
mega64 0:38ccae254a29 125
mega64 0:38ccae254a29 126 ssize_t LocalFileHandle::read(void *buffer, size_t length) {
mega64 0:38ccae254a29 127 ssize_t n = semihost_read(_fh, (unsigned char*)buffer, length, 0); // number of characters not read
mega64 0:38ccae254a29 128 n = length - n; // number of characters read
mega64 0:38ccae254a29 129 pos += n;
mega64 0:38ccae254a29 130 return n;
mega64 0:38ccae254a29 131 }
mega64 0:38ccae254a29 132
mega64 0:38ccae254a29 133 int LocalFileHandle::isatty() {
mega64 0:38ccae254a29 134 return semihost_istty(_fh);
mega64 0:38ccae254a29 135 }
mega64 0:38ccae254a29 136
mega64 0:38ccae254a29 137 off_t LocalFileHandle::lseek(off_t position, int whence) {
mega64 0:38ccae254a29 138 if (whence == SEEK_CUR) {
mega64 0:38ccae254a29 139 position += pos;
mega64 0:38ccae254a29 140 } else if (whence == SEEK_END) {
mega64 0:38ccae254a29 141 position += semihost_flen(_fh);
mega64 0:38ccae254a29 142 } /* otherwise SEEK_SET, so position is fine */
mega64 0:38ccae254a29 143
mega64 0:38ccae254a29 144 /* Always seems to return -1, so just ignore for now. */
mega64 0:38ccae254a29 145 semihost_seek(_fh, position);
mega64 0:38ccae254a29 146 pos = position;
mega64 0:38ccae254a29 147 return position;
mega64 0:38ccae254a29 148 }
mega64 0:38ccae254a29 149
mega64 0:38ccae254a29 150 int LocalFileHandle::fsync() {
mega64 0:38ccae254a29 151 return semihost_ensure(_fh);
mega64 0:38ccae254a29 152 }
mega64 0:38ccae254a29 153
mega64 0:38ccae254a29 154 off_t LocalFileHandle::flen() {
mega64 0:38ccae254a29 155 return semihost_flen(_fh);
mega64 0:38ccae254a29 156 }
mega64 0:38ccae254a29 157
mega64 0:38ccae254a29 158 class LocalDirHandle : public DirHandle {
mega64 0:38ccae254a29 159
mega64 0:38ccae254a29 160 public:
mega64 0:38ccae254a29 161 struct dirent cur_entry;
mega64 0:38ccae254a29 162 XFINFO info;
mega64 0:38ccae254a29 163
mega64 0:38ccae254a29 164 LocalDirHandle() : cur_entry(), info() {
mega64 0:38ccae254a29 165 }
mega64 0:38ccae254a29 166
mega64 0:38ccae254a29 167 virtual int closedir() {
mega64 0:38ccae254a29 168 delete this;
mega64 0:38ccae254a29 169 return 0;
mega64 0:38ccae254a29 170 }
mega64 0:38ccae254a29 171
mega64 0:38ccae254a29 172 virtual struct dirent *readdir() {
mega64 0:38ccae254a29 173 if (xffind("*", &info)!=0) {
mega64 0:38ccae254a29 174 return NULL;
mega64 0:38ccae254a29 175 }
mega64 0:38ccae254a29 176 memcpy(cur_entry.d_name, info.name, sizeof(info.name));
mega64 0:38ccae254a29 177 return &cur_entry;
mega64 0:38ccae254a29 178 }
mega64 0:38ccae254a29 179
mega64 0:38ccae254a29 180 virtual void rewinddir() {
mega64 0:38ccae254a29 181 info.fileID = 0;
mega64 0:38ccae254a29 182 }
mega64 0:38ccae254a29 183
mega64 0:38ccae254a29 184 virtual off_t telldir() {
mega64 0:38ccae254a29 185 return info.fileID;
mega64 0:38ccae254a29 186 }
mega64 0:38ccae254a29 187
mega64 0:38ccae254a29 188 virtual void seekdir(off_t offset) {
mega64 0:38ccae254a29 189 info.fileID = offset;
mega64 0:38ccae254a29 190 }
mega64 0:38ccae254a29 191 };
mega64 0:38ccae254a29 192
mega64 0:38ccae254a29 193 FileHandle *LocalFileSystem::open(const char* name, int flags) {
mega64 0:38ccae254a29 194 /* reject filenames with / in them */
mega64 0:38ccae254a29 195 for (const char *tmp = name; *tmp; tmp++) {
mega64 0:38ccae254a29 196 if (*tmp == '/') {
mega64 0:38ccae254a29 197 return NULL;
mega64 0:38ccae254a29 198 }
mega64 0:38ccae254a29 199 }
mega64 0:38ccae254a29 200
mega64 0:38ccae254a29 201 int openmode = posix_to_semihost_open_flags(flags);
mega64 0:38ccae254a29 202 if (openmode == OPEN_INVALID) {
mega64 0:38ccae254a29 203 return NULL;
mega64 0:38ccae254a29 204 }
mega64 0:38ccae254a29 205
mega64 0:38ccae254a29 206 FILEHANDLE fh = semihost_open(name, openmode);
mega64 0:38ccae254a29 207 if (fh == -1) {
mega64 0:38ccae254a29 208 return NULL;
mega64 0:38ccae254a29 209 }
mega64 0:38ccae254a29 210 return new LocalFileHandle(fh);
mega64 0:38ccae254a29 211 }
mega64 0:38ccae254a29 212
mega64 0:38ccae254a29 213 int LocalFileSystem::remove(const char *filename) {
mega64 0:38ccae254a29 214 return semihost_remove(filename);
mega64 0:38ccae254a29 215 }
mega64 0:38ccae254a29 216
mega64 0:38ccae254a29 217 DirHandle *LocalFileSystem::opendir(const char *name) {
mega64 0:38ccae254a29 218 return new LocalDirHandle();
mega64 0:38ccae254a29 219 }
mega64 0:38ccae254a29 220
mega64 0:38ccae254a29 221 } // namespace mbed
mega64 0:38ccae254a29 222
mega64 0:38ccae254a29 223 #endif