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)

hal/ticker_api.h@147:38a0c20c7b3e, 2017-03-16 (annotated)

Committer:
mega64
Date:
Thu Mar 16 07:17:23 2017 +0000
Revision:
147:38a0c20c7b3e
fully rebuild, now based on mbed-dev v160. restore lost files

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mega64 147:38a0c20c7b3e 1
mega64 147:38a0c20c7b3e 2 /** \addtogroup hal */
mega64 147:38a0c20c7b3e 3 /** @{*/
mega64 147:38a0c20c7b3e 4 /* mbed Microcontroller Library
mega64 147:38a0c20c7b3e 5 * Copyright (c) 2015 ARM Limited
mega64 147:38a0c20c7b3e 6 *
mega64 147:38a0c20c7b3e 7 * Licensed under the Apache License, Version 2.0 (the "License");
mega64 147:38a0c20c7b3e 8 * you may not use this file except in compliance with the License.
mega64 147:38a0c20c7b3e 9 * You may obtain a copy of the License at
mega64 147:38a0c20c7b3e 10 *
mega64 147:38a0c20c7b3e 11 * http://www.apache.org/licenses/LICENSE-2.0
mega64 147:38a0c20c7b3e 12 *
mega64 147:38a0c20c7b3e 13 * Unless required by applicable law or agreed to in writing, software
mega64 147:38a0c20c7b3e 14 * distributed under the License is distributed on an "AS IS" BASIS,
mega64 147:38a0c20c7b3e 15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mega64 147:38a0c20c7b3e 16 * See the License for the specific language governing permissions and
mega64 147:38a0c20c7b3e 17 * limitations under the License.
mega64 147:38a0c20c7b3e 18 */
mega64 147:38a0c20c7b3e 19 #ifndef MBED_TICKER_API_H
mega64 147:38a0c20c7b3e 20 #define MBED_TICKER_API_H
mega64 147:38a0c20c7b3e 21
mega64 147:38a0c20c7b3e 22 #include <stdint.h>
mega64 147:38a0c20c7b3e 23 #include "device.h"
mega64 147:38a0c20c7b3e 24
mega64 147:38a0c20c7b3e 25 typedef uint32_t timestamp_t;
mega64 147:38a0c20c7b3e 26
mega64 147:38a0c20c7b3e 27 /** Ticker's event structure
mega64 147:38a0c20c7b3e 28 */
mega64 147:38a0c20c7b3e 29 typedef struct ticker_event_s {
mega64 147:38a0c20c7b3e 30 timestamp_t timestamp; /**< Event's timestamp */
mega64 147:38a0c20c7b3e 31 uint32_t id; /**< TimerEvent object */
mega64 147:38a0c20c7b3e 32 struct ticker_event_s *next; /**< Next event in the queue */
mega64 147:38a0c20c7b3e 33 } ticker_event_t;
mega64 147:38a0c20c7b3e 34
mega64 147:38a0c20c7b3e 35 typedef void (*ticker_event_handler)(uint32_t id);
mega64 147:38a0c20c7b3e 36
mega64 147:38a0c20c7b3e 37 /** Ticker's interface structure - required API for a ticker
mega64 147:38a0c20c7b3e 38 */
mega64 147:38a0c20c7b3e 39 typedef struct {
mega64 147:38a0c20c7b3e 40 void (*init)(void); /**< Init function */
mega64 147:38a0c20c7b3e 41 uint32_t (*read)(void); /**< Read function */
mega64 147:38a0c20c7b3e 42 void (*disable_interrupt)(void); /**< Disable interrupt function */
mega64 147:38a0c20c7b3e 43 void (*clear_interrupt)(void); /**< Clear interrupt function */
mega64 147:38a0c20c7b3e 44 void (*set_interrupt)(timestamp_t timestamp); /**< Set interrupt function */
mega64 147:38a0c20c7b3e 45 } ticker_interface_t;
mega64 147:38a0c20c7b3e 46
mega64 147:38a0c20c7b3e 47 /** Ticker's event queue structure
mega64 147:38a0c20c7b3e 48 */
mega64 147:38a0c20c7b3e 49 typedef struct {
mega64 147:38a0c20c7b3e 50 ticker_event_handler event_handler; /**< Event handler */
mega64 147:38a0c20c7b3e 51 ticker_event_t *head; /**< A pointer to head */
mega64 147:38a0c20c7b3e 52 } ticker_event_queue_t;
mega64 147:38a0c20c7b3e 53
mega64 147:38a0c20c7b3e 54 /** Ticker's data structure
mega64 147:38a0c20c7b3e 55 */
mega64 147:38a0c20c7b3e 56 typedef struct {
mega64 147:38a0c20c7b3e 57 const ticker_interface_t *interface; /**< Ticker's interface */
mega64 147:38a0c20c7b3e 58 ticker_event_queue_t *queue; /**< Ticker's event queue */
mega64 147:38a0c20c7b3e 59 } ticker_data_t;
mega64 147:38a0c20c7b3e 60
mega64 147:38a0c20c7b3e 61 #ifdef __cplusplus
mega64 147:38a0c20c7b3e 62 extern "C" {
mega64 147:38a0c20c7b3e 63 #endif
mega64 147:38a0c20c7b3e 64
mega64 147:38a0c20c7b3e 65 /**
mega64 147:38a0c20c7b3e 66 * \defgroup hal_ticker Ticker HAL functions
mega64 147:38a0c20c7b3e 67 * @{
mega64 147:38a0c20c7b3e 68 */
mega64 147:38a0c20c7b3e 69
mega64 147:38a0c20c7b3e 70 /** Initialize a ticker and set the event handler
mega64 147:38a0c20c7b3e 71 *
mega64 147:38a0c20c7b3e 72 * @param data The ticker's data
mega64 147:38a0c20c7b3e 73 * @param handler A handler to be set
mega64 147:38a0c20c7b3e 74 */
mega64 147:38a0c20c7b3e 75 void ticker_set_handler(const ticker_data_t *const data, ticker_event_handler handler);
mega64 147:38a0c20c7b3e 76
mega64 147:38a0c20c7b3e 77 /** IRQ handler that goes through the events to trigger overdue events.
mega64 147:38a0c20c7b3e 78 *
mega64 147:38a0c20c7b3e 79 * @param data The ticker's data
mega64 147:38a0c20c7b3e 80 */
mega64 147:38a0c20c7b3e 81 void ticker_irq_handler(const ticker_data_t *const data);
mega64 147:38a0c20c7b3e 82
mega64 147:38a0c20c7b3e 83 /** Remove an event from the queue
mega64 147:38a0c20c7b3e 84 *
mega64 147:38a0c20c7b3e 85 * @param data The ticker's data
mega64 147:38a0c20c7b3e 86 * @param obj The event object to be removed from the queue
mega64 147:38a0c20c7b3e 87 */
mega64 147:38a0c20c7b3e 88 void ticker_remove_event(const ticker_data_t *const data, ticker_event_t *obj);
mega64 147:38a0c20c7b3e 89
mega64 147:38a0c20c7b3e 90 /** Insert an event to the queue
mega64 147:38a0c20c7b3e 91 *
mega64 147:38a0c20c7b3e 92 * @param data The ticker's data
mega64 147:38a0c20c7b3e 93 * @param obj The event object to be inserted to the queue
mega64 147:38a0c20c7b3e 94 * @param timestamp The event's timestamp
mega64 147:38a0c20c7b3e 95 * @param id The event object
mega64 147:38a0c20c7b3e 96 */
mega64 147:38a0c20c7b3e 97 void ticker_insert_event(const ticker_data_t *const data, ticker_event_t *obj, timestamp_t timestamp, uint32_t id);
mega64 147:38a0c20c7b3e 98
mega64 147:38a0c20c7b3e 99 /** Read the current ticker's timestamp
mega64 147:38a0c20c7b3e 100 *
mega64 147:38a0c20c7b3e 101 * @param data The ticker's data
mega64 147:38a0c20c7b3e 102 * @return The current timestamp
mega64 147:38a0c20c7b3e 103 */
mega64 147:38a0c20c7b3e 104 timestamp_t ticker_read(const ticker_data_t *const data);
mega64 147:38a0c20c7b3e 105
mega64 147:38a0c20c7b3e 106 /** Read the next event's timestamp
mega64 147:38a0c20c7b3e 107 *
mega64 147:38a0c20c7b3e 108 * @param data The ticker's data
mega64 147:38a0c20c7b3e 109 * @return 1 if timestamp is pending event, 0 if there's no event pending
mega64 147:38a0c20c7b3e 110 */
mega64 147:38a0c20c7b3e 111 int ticker_get_next_timestamp(const ticker_data_t *const data, timestamp_t *timestamp);
mega64 147:38a0c20c7b3e 112
mega64 147:38a0c20c7b3e 113 /**@}*/
mega64 147:38a0c20c7b3e 114
mega64 147:38a0c20c7b3e 115 #ifdef __cplusplus
mega64 147:38a0c20c7b3e 116 }
mega64 147:38a0c20c7b3e 117 #endif
mega64 147:38a0c20c7b3e 118
mega64 147:38a0c20c7b3e 119 #endif
mega64 147:38a0c20c7b3e 120
mega64 147:38a0c20c7b3e 121 /** @}*/