Peter Drescher / mbed-F401

mbed library with additional peripherals for ST F401 board

Fork of mbed-src by mbed official

This mbed LIB has additional peripherals for ST F401 board

  • UART2 : PA_3 rx, PA_2 tx
  • UART3 : PC_7 rx, PC_6 tx
  • I2C2 : PB_3 SDA, PB_10 SCL
  • I2C3 : PB_4 SDA, PA_8 SCL

targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/i2c_api.c@88:81f18c97d490, 2014-02-10 (annotated)

Committer:
mbed_official
Date:
Mon Feb 10 19:00:06 2014 +0000
Revision:
88:81f18c97d490
Parent:
87:085cde657901
Child:
113:bf9eb0d91273
Synchronized with git revision 82b58af42c386d68aa6f12d8cfcae87f0f448b73



Full URL: https://github.com/mbedmicro/mbed/commit/82b58af42c386d68aa6f12d8cfcae87f0f448b73/



[NUCLEO_F401RE] Corrections in uvision exporter, GPIOs setting and SPI.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /* mbed Microcontroller Library
mbed_official 87:085cde657901 2 *******************************************************************************
mbed_official 87:085cde657901 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 87:085cde657901 4 * All rights reserved.
mbed_official 87:085cde657901 5 *
mbed_official 87:085cde657901 6 * Redistribution and use in source and binary forms, with or without
mbed_official 87:085cde657901 7 * modification, are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 8 *
mbed_official 87:085cde657901 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 10 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 13 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 15 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 16 * without specific prior written permission.
mbed_official 87:085cde657901 17 *
mbed_official 87:085cde657901 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 28 *******************************************************************************
mbed_official 87:085cde657901 29 */
mbed_official 87:085cde657901 30 #include "i2c_api.h"
mbed_official 87:085cde657901 31
mbed_official 87:085cde657901 32 #if DEVICE_I2C
mbed_official 87:085cde657901 33
mbed_official 87:085cde657901 34 #include "cmsis.h"
mbed_official 87:085cde657901 35 #include "pinmap.h"
mbed_official 87:085cde657901 36 #include "error.h"
mbed_official 87:085cde657901 37 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 38
mbed_official 87:085cde657901 39 /* Timeout values for flags and events waiting loops. These timeouts are
mbed_official 87:085cde657901 40 not based on accurate values, they just guarantee that the application will
mbed_official 87:085cde657901 41 not remain stuck if the I2C communication is corrupted. */
mbed_official 87:085cde657901 42 #define FLAG_TIMEOUT ((int)0x1000)
mbed_official 87:085cde657901 43 #define LONG_TIMEOUT ((int)0x8000)
mbed_official 87:085cde657901 44
mbed_official 87:085cde657901 45 static const PinMap PinMap_I2C_SDA[] = {
mbed_official 88:81f18c97d490 46 {PB_9, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 87:085cde657901 47 {NC, NC, 0}
mbed_official 87:085cde657901 48 };
mbed_official 87:085cde657901 49
mbed_official 87:085cde657901 50 static const PinMap PinMap_I2C_SCL[] = {
mbed_official 88:81f18c97d490 51 {PB_8, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 87:085cde657901 52 {NC, NC, 0}
mbed_official 87:085cde657901 53 };
mbed_official 87:085cde657901 54
mbed_official 87:085cde657901 55 I2C_HandleTypeDef I2cHandle;
mbed_official 87:085cde657901 56
mbed_official 87:085cde657901 57 void i2c_init(i2c_t *obj, PinName sda, PinName scl) {
mbed_official 87:085cde657901 58 // Determine the I2C to use
mbed_official 87:085cde657901 59 I2CName i2c_sda = (I2CName)pinmap_peripheral(sda, PinMap_I2C_SDA);
mbed_official 87:085cde657901 60 I2CName i2c_scl = (I2CName)pinmap_peripheral(scl, PinMap_I2C_SCL);
mbed_official 87:085cde657901 61
mbed_official 87:085cde657901 62 obj->i2c = (I2CName)pinmap_merge(i2c_sda, i2c_scl);
mbed_official 87:085cde657901 63
mbed_official 87:085cde657901 64 if (obj->i2c == (I2CName)NC) {
mbed_official 87:085cde657901 65 error("I2C error: pinout mapping failed.");
mbed_official 87:085cde657901 66 }
mbed_official 87:085cde657901 67
mbed_official 87:085cde657901 68 // Enable I2C clock
mbed_official 87:085cde657901 69 if (obj->i2c == I2C_1) {
mbed_official 87:085cde657901 70 __I2C1_CLK_ENABLE();
mbed_official 87:085cde657901 71 }
mbed_official 87:085cde657901 72
mbed_official 87:085cde657901 73 // Configure I2C pins
mbed_official 87:085cde657901 74 pinmap_pinout(sda, PinMap_I2C_SDA);
mbed_official 87:085cde657901 75 pinmap_pinout(scl, PinMap_I2C_SCL);
mbed_official 87:085cde657901 76 pin_mode(sda, OpenDrain);
mbed_official 87:085cde657901 77 pin_mode(scl, OpenDrain);
mbed_official 87:085cde657901 78
mbed_official 87:085cde657901 79 // Reset to clear pending flags if any
mbed_official 87:085cde657901 80 i2c_reset(obj);
mbed_official 87:085cde657901 81
mbed_official 87:085cde657901 82 // I2C configuration
mbed_official 87:085cde657901 83 i2c_frequency(obj, 100000); // 100 kHz per default
mbed_official 87:085cde657901 84 }
mbed_official 87:085cde657901 85
mbed_official 87:085cde657901 86 void i2c_frequency(i2c_t *obj, int hz) {
mbed_official 87:085cde657901 87 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 88
mbed_official 87:085cde657901 89 if ((hz != 0) && (hz <= 400000)) {
mbed_official 87:085cde657901 90 // I2C configuration
mbed_official 87:085cde657901 91 I2cHandle.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
mbed_official 87:085cde657901 92 I2cHandle.Init.ClockSpeed = hz;
mbed_official 87:085cde657901 93 I2cHandle.Init.DualAddressMode = I2C_DUALADDRESS_DISABLED;
mbed_official 87:085cde657901 94 I2cHandle.Init.DutyCycle = I2C_DUTYCYCLE_2;
mbed_official 87:085cde657901 95 I2cHandle.Init.GeneralCallMode = I2C_GENERALCALL_DISABLED;
mbed_official 87:085cde657901 96 I2cHandle.Init.NoStretchMode = I2C_NOSTRETCH_DISABLED;
mbed_official 87:085cde657901 97 I2cHandle.Init.OwnAddress1 = 0;
mbed_official 87:085cde657901 98 I2cHandle.Init.OwnAddress2 = 0;
mbed_official 87:085cde657901 99 HAL_I2C_Init(&I2cHandle);
mbed_official 87:085cde657901 100 }
mbed_official 87:085cde657901 101 else {
mbed_official 87:085cde657901 102 error("I2C error: frequency setting failed (max 400kHz).");
mbed_official 87:085cde657901 103 }
mbed_official 87:085cde657901 104 }
mbed_official 87:085cde657901 105
mbed_official 87:085cde657901 106 inline int i2c_start(i2c_t *obj) {
mbed_official 87:085cde657901 107 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 108 int timeout;
mbed_official 87:085cde657901 109
mbed_official 87:085cde657901 110 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 111
mbed_official 87:085cde657901 112 // Clear Acknowledge failure flag
mbed_official 87:085cde657901 113 __HAL_I2C_CLEAR_FLAG(&I2cHandle, I2C_FLAG_AF);
mbed_official 87:085cde657901 114
mbed_official 87:085cde657901 115 // Generate the START condition
mbed_official 87:085cde657901 116 i2c->CR1 |= I2C_CR1_START;
mbed_official 87:085cde657901 117
mbed_official 87:085cde657901 118 // Wait the START condition has been correctly sent
mbed_official 87:085cde657901 119 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 120 while (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_SB) == RESET) {
mbed_official 87:085cde657901 121 if ((timeout--) == 0) {
mbed_official 87:085cde657901 122 return 1;
mbed_official 87:085cde657901 123 }
mbed_official 87:085cde657901 124 }
mbed_official 87:085cde657901 125
mbed_official 87:085cde657901 126 return 0;
mbed_official 87:085cde657901 127 }
mbed_official 87:085cde657901 128
mbed_official 87:085cde657901 129 inline int i2c_stop(i2c_t *obj) {
mbed_official 87:085cde657901 130 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 131
mbed_official 87:085cde657901 132 // Generate the STOP condition
mbed_official 87:085cde657901 133 i2c->CR1 |= I2C_CR1_STOP;
mbed_official 87:085cde657901 134
mbed_official 87:085cde657901 135 return 0;
mbed_official 87:085cde657901 136 }
mbed_official 87:085cde657901 137
mbed_official 87:085cde657901 138 int i2c_read(i2c_t *obj, int address, char *data, int length, int stop) {
mbed_official 87:085cde657901 139 if (length == 0) return 0;
mbed_official 87:085cde657901 140
mbed_official 87:085cde657901 141 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 142
mbed_official 87:085cde657901 143 // Reception process with 5 seconds timeout
mbed_official 87:085cde657901 144 if (HAL_I2C_Master_Receive(&I2cHandle, (uint16_t)address, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 145 return 0; // Error
mbed_official 87:085cde657901 146 }
mbed_official 87:085cde657901 147
mbed_official 87:085cde657901 148 return length;
mbed_official 87:085cde657901 149 }
mbed_official 87:085cde657901 150
mbed_official 87:085cde657901 151 int i2c_write(i2c_t *obj, int address, const char *data, int length, int stop) {
mbed_official 87:085cde657901 152 if (length == 0) return 0;
mbed_official 87:085cde657901 153
mbed_official 87:085cde657901 154 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 155
mbed_official 87:085cde657901 156 // Transmission process with 5 seconds timeout
mbed_official 87:085cde657901 157 if (HAL_I2C_Master_Transmit(&I2cHandle, (uint16_t)address, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 158 return 0; // Error
mbed_official 87:085cde657901 159 }
mbed_official 87:085cde657901 160
mbed_official 87:085cde657901 161 return length;
mbed_official 87:085cde657901 162 }
mbed_official 87:085cde657901 163
mbed_official 87:085cde657901 164 int i2c_byte_read(i2c_t *obj, int last) {
mbed_official 87:085cde657901 165 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 166 int timeout;
mbed_official 87:085cde657901 167
mbed_official 87:085cde657901 168 if (last) {
mbed_official 87:085cde657901 169 // Don't acknowledge the last byte
mbed_official 87:085cde657901 170 i2c->CR1 &= ~I2C_CR1_ACK;
mbed_official 87:085cde657901 171 } else {
mbed_official 87:085cde657901 172 // Acknowledge the byte
mbed_official 87:085cde657901 173 i2c->CR1 |= I2C_CR1_ACK;
mbed_official 87:085cde657901 174 }
mbed_official 87:085cde657901 175
mbed_official 87:085cde657901 176 // Wait until the byte is received
mbed_official 87:085cde657901 177 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 178 while (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_RXNE) == RESET) {
mbed_official 87:085cde657901 179 if ((timeout--) == 0) {
mbed_official 87:085cde657901 180 return 0;
mbed_official 87:085cde657901 181 }
mbed_official 87:085cde657901 182 }
mbed_official 87:085cde657901 183
mbed_official 87:085cde657901 184 return (int)i2c->DR;
mbed_official 87:085cde657901 185 }
mbed_official 87:085cde657901 186
mbed_official 87:085cde657901 187 int i2c_byte_write(i2c_t *obj, int data) {
mbed_official 87:085cde657901 188 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 189 int timeout;
mbed_official 87:085cde657901 190
mbed_official 87:085cde657901 191 i2c->DR = (uint8_t)data;
mbed_official 87:085cde657901 192
mbed_official 87:085cde657901 193 // Wait until the byte is transmitted
mbed_official 87:085cde657901 194 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 195 while ((__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_TXE) == RESET) &&
mbed_official 87:085cde657901 196 (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_BTF) == RESET)) {
mbed_official 87:085cde657901 197 if ((timeout--) == 0) {
mbed_official 87:085cde657901 198 return 0;
mbed_official 87:085cde657901 199 }
mbed_official 87:085cde657901 200 }
mbed_official 87:085cde657901 201
mbed_official 87:085cde657901 202 return 1;
mbed_official 87:085cde657901 203 }
mbed_official 87:085cde657901 204
mbed_official 87:085cde657901 205 void i2c_reset(i2c_t *obj) {
mbed_official 87:085cde657901 206 if (obj->i2c == I2C_1) {
mbed_official 87:085cde657901 207 __I2C1_FORCE_RESET();
mbed_official 87:085cde657901 208 __I2C1_RELEASE_RESET();
mbed_official 87:085cde657901 209 }
mbed_official 87:085cde657901 210 }
mbed_official 87:085cde657901 211
mbed_official 87:085cde657901 212 #if DEVICE_I2CSLAVE
mbed_official 87:085cde657901 213
mbed_official 87:085cde657901 214 void i2c_slave_address(i2c_t *obj, int idx, uint32_t address, uint32_t mask) {
mbed_official 87:085cde657901 215 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 216 uint16_t tmpreg;
mbed_official 87:085cde657901 217
mbed_official 87:085cde657901 218 // Get the old register value
mbed_official 87:085cde657901 219 tmpreg = i2c->OAR1;
mbed_official 87:085cde657901 220 // Reset address bits
mbed_official 87:085cde657901 221 tmpreg &= 0xFC00;
mbed_official 87:085cde657901 222 // Set new address
mbed_official 87:085cde657901 223 tmpreg |= (uint16_t)((uint16_t)address & (uint16_t)0x00FE); // 7-bits
mbed_official 87:085cde657901 224 // Store the new register value
mbed_official 87:085cde657901 225 i2c->OAR1 = tmpreg;
mbed_official 87:085cde657901 226 }
mbed_official 87:085cde657901 227
mbed_official 87:085cde657901 228 void i2c_slave_mode(i2c_t *obj, int enable_slave) {
mbed_official 87:085cde657901 229 // Nothing to do
mbed_official 87:085cde657901 230 }
mbed_official 87:085cde657901 231
mbed_official 87:085cde657901 232 // See I2CSlave.h
mbed_official 87:085cde657901 233 #define NoData 0 // the slave has not been addressed
mbed_official 87:085cde657901 234 #define ReadAddressed 1 // the master has requested a read from this slave (slave = transmitter)
mbed_official 87:085cde657901 235 #define WriteGeneral 2 // the master is writing to all slave
mbed_official 87:085cde657901 236 #define WriteAddressed 3 // the master is writing to this slave (slave = receiver)
mbed_official 87:085cde657901 237
mbed_official 87:085cde657901 238 int i2c_slave_receive(i2c_t *obj) {
mbed_official 87:085cde657901 239 // TO BE DONE
mbed_official 87:085cde657901 240 return(0);
mbed_official 87:085cde657901 241 }
mbed_official 87:085cde657901 242
mbed_official 87:085cde657901 243 int i2c_slave_read(i2c_t *obj, char *data, int length) {
mbed_official 87:085cde657901 244 if (length == 0) return 0;
mbed_official 87:085cde657901 245
mbed_official 87:085cde657901 246 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 247
mbed_official 87:085cde657901 248 // Reception process with 5 seconds timeout
mbed_official 87:085cde657901 249 if (HAL_I2C_Slave_Receive(&I2cHandle, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 250 return 0; // Error
mbed_official 87:085cde657901 251 }
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 return length;
mbed_official 87:085cde657901 254 }
mbed_official 87:085cde657901 255
mbed_official 87:085cde657901 256 int i2c_slave_write(i2c_t *obj, const char *data, int length) {
mbed_official 87:085cde657901 257 if (length == 0) return 0;
mbed_official 87:085cde657901 258
mbed_official 87:085cde657901 259 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 260
mbed_official 87:085cde657901 261 // Transmission process with 5 seconds timeout
mbed_official 87:085cde657901 262 if (HAL_I2C_Slave_Transmit(&I2cHandle, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 263 return 0; // Error
mbed_official 87:085cde657901 264 }
mbed_official 87:085cde657901 265
mbed_official 87:085cde657901 266 return length;
mbed_official 87:085cde657901 267 }
mbed_official 87:085cde657901 268
mbed_official 87:085cde657901 269
mbed_official 87:085cde657901 270 #endif // DEVICE_I2CSLAVE
mbed_official 87:085cde657901 271
mbed_official 87:085cde657901 272 #endif // DEVICE_I2C