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/Ethernet.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_ETHERNET_H
mega64 146:03e976389d16 17 #define MBED_ETHERNET_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/platform.h"
mega64 146:03e976389d16 20
mega64 146:03e976389d16 21 #if DEVICE_ETHERNET
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 namespace mbed {
mega64 146:03e976389d16 24 /** \addtogroup drivers */
mega64 146:03e976389d16 25 /** @{*/
mega64 146:03e976389d16 26
mega64 146:03e976389d16 27 /** An ethernet interface, to use with the ethernet pins.
mega64 146:03e976389d16 28 *
mega64 146:03e976389d16 29 * @Note Synchronization level: Not protected
mega64 146:03e976389d16 30 *
mega64 146:03e976389d16 31 * Example:
mega64 146:03e976389d16 32 * @code
mega64 146:03e976389d16 33 * // Read destination and source from every ethernet packet
mega64 146:03e976389d16 34 *
mega64 146:03e976389d16 35 * #include "mbed.h"
mega64 146:03e976389d16 36 *
mega64 146:03e976389d16 37 * Ethernet eth;
mega64 146:03e976389d16 38 *
mega64 146:03e976389d16 39 * int main() {
mega64 146:03e976389d16 40 * char buf[0x600];
mega64 146:03e976389d16 41 *
mega64 146:03e976389d16 42 * while(1) {
mega64 146:03e976389d16 43 * int size = eth.receive();
mega64 146:03e976389d16 44 * if(size > 0) {
mega64 146:03e976389d16 45 * eth.read(buf, size);
mega64 146:03e976389d16 46 * printf("Destination: %02X:%02X:%02X:%02X:%02X:%02X\n",
mega64 146:03e976389d16 47 * buf[0], buf[1], buf[2], buf[3], buf[4], buf[5]);
mega64 146:03e976389d16 48 * printf("Source: %02X:%02X:%02X:%02X:%02X:%02X\n",
mega64 146:03e976389d16 49 * buf[6], buf[7], buf[8], buf[9], buf[10], buf[11]);
mega64 146:03e976389d16 50 * }
mega64 146:03e976389d16 51 *
mega64 146:03e976389d16 52 * wait(1);
mega64 146:03e976389d16 53 * }
mega64 146:03e976389d16 54 * }
mega64 146:03e976389d16 55 * @endcode
mega64 146:03e976389d16 56 */
mega64 146:03e976389d16 57 class Ethernet {
mega64 146:03e976389d16 58
mega64 146:03e976389d16 59 public:
mega64 146:03e976389d16 60
mega64 146:03e976389d16 61 /** Initialise the ethernet interface.
mega64 146:03e976389d16 62 */
mega64 146:03e976389d16 63 Ethernet();
mega64 146:03e976389d16 64
mega64 146:03e976389d16 65 /** Powers the hardware down.
mega64 146:03e976389d16 66 */
mega64 146:03e976389d16 67 virtual ~Ethernet();
mega64 146:03e976389d16 68
mega64 146:03e976389d16 69 enum Mode {
mega64 146:03e976389d16 70 AutoNegotiate,
mega64 146:03e976389d16 71 HalfDuplex10,
mega64 146:03e976389d16 72 FullDuplex10,
mega64 146:03e976389d16 73 HalfDuplex100,
mega64 146:03e976389d16 74 FullDuplex100
mega64 146:03e976389d16 75 };
mega64 146:03e976389d16 76
mega64 146:03e976389d16 77 /** Writes into an outgoing ethernet packet.
mega64 146:03e976389d16 78 *
mega64 146:03e976389d16 79 * It will append size bytes of data to the previously written bytes.
mega64 146:03e976389d16 80 *
mega64 146:03e976389d16 81 * @param data An array to write.
mega64 146:03e976389d16 82 * @param size The size of data.
mega64 146:03e976389d16 83 *
mega64 146:03e976389d16 84 * @returns
mega64 146:03e976389d16 85 * The number of written bytes.
mega64 146:03e976389d16 86 */
mega64 146:03e976389d16 87 int write(const char *data, int size);
mega64 146:03e976389d16 88
mega64 146:03e976389d16 89 /** Send an outgoing ethernet packet.
mega64 146:03e976389d16 90 *
mega64 146:03e976389d16 91 * After filling in the data in an ethernet packet it must be send.
mega64 146:03e976389d16 92 * Send will provide a new packet to write to.
mega64 146:03e976389d16 93 *
mega64 146:03e976389d16 94 * @returns
mega64 146:03e976389d16 95 * 0 if the sending was failed,
mega64 146:03e976389d16 96 * or the size of the packet successfully sent.
mega64 146:03e976389d16 97 */
mega64 146:03e976389d16 98 int send();
mega64 146:03e976389d16 99
mega64 146:03e976389d16 100 /** Recevies an arrived ethernet packet.
mega64 146:03e976389d16 101 *
mega64 146:03e976389d16 102 * Receiving an ethernet packet will drop the last received ethernet packet
mega64 146:03e976389d16 103 * and make a new ethernet packet ready to read.
mega64 146:03e976389d16 104 * If no ethernet packet is arrived it will return 0.
mega64 146:03e976389d16 105 *
mega64 146:03e976389d16 106 * @returns
mega64 146:03e976389d16 107 * 0 if no ethernet packet is arrived,
mega64 146:03e976389d16 108 * or the size of the arrived packet.
mega64 146:03e976389d16 109 */
mega64 146:03e976389d16 110 int receive();
mega64 146:03e976389d16 111
mega64 146:03e976389d16 112 /** Read from an recevied ethernet packet.
mega64 146:03e976389d16 113 *
mega64 146:03e976389d16 114 * After receive returnd a number bigger than 0it is
mega64 146:03e976389d16 115 * possible to read bytes from this packet.
mega64 146:03e976389d16 116 * Read will write up to size bytes into data.
mega64 146:03e976389d16 117 *
mega64 146:03e976389d16 118 * It is possible to use read multible times.
mega64 146:03e976389d16 119 * Each time read will start reading after the last read byte before.
mega64 146:03e976389d16 120 *
mega64 146:03e976389d16 121 * @returns
mega64 146:03e976389d16 122 * The number of byte read.
mega64 146:03e976389d16 123 */
mega64 146:03e976389d16 124 int read(char *data, int size);
mega64 146:03e976389d16 125
mega64 146:03e976389d16 126 /** Gives the ethernet address of the mbed.
mega64 146:03e976389d16 127 *
mega64 146:03e976389d16 128 * @param mac Must be a pointer to a 6 byte char array to copy the ethernet address in.
mega64 146:03e976389d16 129 */
mega64 146:03e976389d16 130 void address(char *mac);
mega64 146:03e976389d16 131
mega64 146:03e976389d16 132 /** Returns if an ethernet link is pressent or not. It takes a wile after Ethernet initializion to show up.
mega64 146:03e976389d16 133 *
mega64 146:03e976389d16 134 * @returns
mega64 146:03e976389d16 135 * 0 if no ethernet link is pressent,
mega64 146:03e976389d16 136 * 1 if an ethernet link is pressent.
mega64 146:03e976389d16 137 *
mega64 146:03e976389d16 138 * Example:
mega64 146:03e976389d16 139 * @code
mega64 146:03e976389d16 140 * // Using the Ethernet link function
mega64 146:03e976389d16 141 * #include "mbed.h"
mega64 146:03e976389d16 142 *
mega64 146:03e976389d16 143 * Ethernet eth;
mega64 146:03e976389d16 144 *
mega64 146:03e976389d16 145 * int main() {
mega64 146:03e976389d16 146 * wait(1); // Needed after startup.
mega64 146:03e976389d16 147 * if (eth.link()) {
mega64 146:03e976389d16 148 * printf("online\n");
mega64 146:03e976389d16 149 * } else {
mega64 146:03e976389d16 150 * printf("offline\n");
mega64 146:03e976389d16 151 * }
mega64 146:03e976389d16 152 * }
mega64 146:03e976389d16 153 * @endcode
mega64 146:03e976389d16 154 */
mega64 146:03e976389d16 155 int link();
mega64 146:03e976389d16 156
mega64 146:03e976389d16 157 /** Sets the speed and duplex parameters of an ethernet link
mega64 146:03e976389d16 158 *
mega64 146:03e976389d16 159 * - AutoNegotiate Auto negotiate speed and duplex
mega64 146:03e976389d16 160 * - HalfDuplex10 10 Mbit, half duplex
mega64 146:03e976389d16 161 * - FullDuplex10 10 Mbit, full duplex
mega64 146:03e976389d16 162 * - HalfDuplex100 100 Mbit, half duplex
mega64 146:03e976389d16 163 * - FullDuplex100 100 Mbit, full duplex
mega64 146:03e976389d16 164 *
mega64 146:03e976389d16 165 * @param mode the speed and duplex mode to set the link to:
mega64 146:03e976389d16 166 */
mega64 146:03e976389d16 167 void set_link(Mode mode);
mega64 146:03e976389d16 168 };
mega64 146:03e976389d16 169
mega64 146:03e976389d16 170 } // namespace mbed
mega64 146:03e976389d16 171
mega64 146:03e976389d16 172 #endif
mega64 146:03e976389d16 173
mega64 146:03e976389d16 174 #endif
mega64 146:03e976389d16 175
mega64 146:03e976389d16 176 /** @}*/