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/I2CSlave.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_I2C_SLAVE_H
mega64 146:03e976389d16 17 #define MBED_I2C_SLAVE_H
mega64 146:03e976389d16 18
mega64 146:03e976389d16 19 #include "platform/platform.h"
mega64 146:03e976389d16 20
mega64 146:03e976389d16 21 #if DEVICE_I2CSLAVE
mega64 146:03e976389d16 22
mega64 146:03e976389d16 23 #include "hal/i2c_api.h"
mega64 146:03e976389d16 24
mega64 146:03e976389d16 25 namespace mbed {
mega64 146:03e976389d16 26 /** \addtogroup drivers */
mega64 146:03e976389d16 27 /** @{*/
mega64 146:03e976389d16 28
mega64 146:03e976389d16 29 /** An I2C Slave, used for communicating with an I2C Master device
mega64 146:03e976389d16 30 *
mega64 146:03e976389d16 31 * @Note Synchronization level: Not protected
mega64 146:03e976389d16 32 *
mega64 146:03e976389d16 33 * Example:
mega64 146:03e976389d16 34 * @code
mega64 146:03e976389d16 35 * // Simple I2C responder
mega64 146:03e976389d16 36 * #include <mbed.h>
mega64 146:03e976389d16 37 *
mega64 146:03e976389d16 38 * I2CSlave slave(p9, p10);
mega64 146:03e976389d16 39 *
mega64 146:03e976389d16 40 * int main() {
mega64 146:03e976389d16 41 * char buf[10];
mega64 146:03e976389d16 42 * char msg[] = "Slave!";
mega64 146:03e976389d16 43 *
mega64 146:03e976389d16 44 * slave.address(0xA0);
mega64 146:03e976389d16 45 * while (1) {
mega64 146:03e976389d16 46 * int i = slave.receive();
mega64 146:03e976389d16 47 * switch (i) {
mega64 146:03e976389d16 48 * case I2CSlave::ReadAddressed:
mega64 146:03e976389d16 49 * slave.write(msg, strlen(msg) + 1); // Includes null char
mega64 146:03e976389d16 50 * break;
mega64 146:03e976389d16 51 * case I2CSlave::WriteGeneral:
mega64 146:03e976389d16 52 * slave.read(buf, 10);
mega64 146:03e976389d16 53 * printf("Read G: %s\n", buf);
mega64 146:03e976389d16 54 * break;
mega64 146:03e976389d16 55 * case I2CSlave::WriteAddressed:
mega64 146:03e976389d16 56 * slave.read(buf, 10);
mega64 146:03e976389d16 57 * printf("Read A: %s\n", buf);
mega64 146:03e976389d16 58 * break;
mega64 146:03e976389d16 59 * }
mega64 146:03e976389d16 60 * for(int i = 0; i < 10; i++) buf[i] = 0; // Clear buffer
mega64 146:03e976389d16 61 * }
mega64 146:03e976389d16 62 * }
mega64 146:03e976389d16 63 * @endcode
mega64 146:03e976389d16 64 */
mega64 146:03e976389d16 65 class I2CSlave {
mega64 146:03e976389d16 66
mega64 146:03e976389d16 67 public:
mega64 146:03e976389d16 68 enum RxStatus {
mega64 146:03e976389d16 69 NoData = 0,
mega64 146:03e976389d16 70 ReadAddressed = 1,
mega64 146:03e976389d16 71 WriteGeneral = 2,
mega64 146:03e976389d16 72 WriteAddressed = 3
mega64 146:03e976389d16 73 };
mega64 146:03e976389d16 74
mega64 146:03e976389d16 75 /** Create an I2C Slave interface, connected to the specified pins.
mega64 146:03e976389d16 76 *
mega64 146:03e976389d16 77 * @param sda I2C data line pin
mega64 146:03e976389d16 78 * @param scl I2C clock line pin
mega64 146:03e976389d16 79 */
mega64 146:03e976389d16 80 I2CSlave(PinName sda, PinName scl);
mega64 146:03e976389d16 81
mega64 146:03e976389d16 82 /** Set the frequency of the I2C interface
mega64 146:03e976389d16 83 *
mega64 146:03e976389d16 84 * @param hz The bus frequency in hertz
mega64 146:03e976389d16 85 */
mega64 146:03e976389d16 86 void frequency(int hz);
mega64 146:03e976389d16 87
mega64 146:03e976389d16 88 /** Checks to see if this I2C Slave has been addressed.
mega64 146:03e976389d16 89 *
mega64 146:03e976389d16 90 * @returns
mega64 146:03e976389d16 91 * A status indicating if the device has been addressed, and how
mega64 146:03e976389d16 92 * - NoData - the slave has not been addressed
mega64 146:03e976389d16 93 * - ReadAddressed - the master has requested a read from this slave
mega64 146:03e976389d16 94 * - WriteAddressed - the master is writing to this slave
mega64 146:03e976389d16 95 * - WriteGeneral - the master is writing to all slave
mega64 146:03e976389d16 96 */
mega64 146:03e976389d16 97 int receive(void);
mega64 146:03e976389d16 98
mega64 146:03e976389d16 99 /** Read from an I2C master.
mega64 146:03e976389d16 100 *
mega64 146:03e976389d16 101 * @param data pointer to the byte array to read data in to
mega64 146:03e976389d16 102 * @param length maximum number of bytes to read
mega64 146:03e976389d16 103 *
mega64 146:03e976389d16 104 * @returns
mega64 146:03e976389d16 105 * 0 on success,
mega64 146:03e976389d16 106 * non-0 otherwise
mega64 146:03e976389d16 107 */
mega64 146:03e976389d16 108 int read(char *data, int length);
mega64 146:03e976389d16 109
mega64 146:03e976389d16 110 /** Read a single byte from an I2C master.
mega64 146:03e976389d16 111 *
mega64 146:03e976389d16 112 * @returns
mega64 146:03e976389d16 113 * the byte read
mega64 146:03e976389d16 114 */
mega64 146:03e976389d16 115 int read(void);
mega64 146:03e976389d16 116
mega64 146:03e976389d16 117 /** Write to an I2C master.
mega64 146:03e976389d16 118 *
mega64 146:03e976389d16 119 * @param data pointer to the byte array to be transmitted
mega64 146:03e976389d16 120 * @param length the number of bytes to transmite
mega64 146:03e976389d16 121 *
mega64 146:03e976389d16 122 * @returns
mega64 146:03e976389d16 123 * 0 on success,
mega64 146:03e976389d16 124 * non-0 otherwise
mega64 146:03e976389d16 125 */
mega64 146:03e976389d16 126 int write(const char *data, int length);
mega64 146:03e976389d16 127
mega64 146:03e976389d16 128 /** Write a single byte to an I2C master.
mega64 146:03e976389d16 129 *
mega64 146:03e976389d16 130 * @data the byte to write
mega64 146:03e976389d16 131 *
mega64 146:03e976389d16 132 * @returns
mega64 146:03e976389d16 133 * '1' if an ACK was received,
mega64 146:03e976389d16 134 * '0' otherwise
mega64 146:03e976389d16 135 */
mega64 146:03e976389d16 136 int write(int data);
mega64 146:03e976389d16 137
mega64 146:03e976389d16 138 /** Sets the I2C slave address.
mega64 146:03e976389d16 139 *
mega64 146:03e976389d16 140 * @param address The address to set for the slave (ignoring the least
mega64 146:03e976389d16 141 * signifcant bit). If set to 0, the slave will only respond to the
mega64 146:03e976389d16 142 * general call address.
mega64 146:03e976389d16 143 */
mega64 146:03e976389d16 144 void address(int address);
mega64 146:03e976389d16 145
mega64 146:03e976389d16 146 /** Reset the I2C slave back into the known ready receiving state.
mega64 146:03e976389d16 147 */
mega64 146:03e976389d16 148 void stop(void);
mega64 146:03e976389d16 149
mega64 146:03e976389d16 150 protected:
mega64 146:03e976389d16 151 i2c_t _i2c;
mega64 146:03e976389d16 152 };
mega64 146:03e976389d16 153
mega64 146:03e976389d16 154 } // namespace mbed
mega64 146:03e976389d16 155
mega64 146:03e976389d16 156 #endif
mega64 146:03e976389d16 157
mega64 146:03e976389d16 158 #endif
mega64 146:03e976389d16 159
mega64 146:03e976389d16 160 /** @}*/