shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/i2c_api.c@172:2f4f8c56b261, 2014-04-28 (annotated)

Committer:
mbed_official
Date:
Mon Apr 28 16:00:08 2014 +0100
Revision:
172:2f4f8c56b261
Parent:
125:23cc3068a9e4
Child:
181:a4cbdfbbd2f4
Synchronized with git revision d57a23dd6e37a8b92073a94ad1daaeecd64865cb



Full URL: https://github.com/mbedmicro/mbed/commit/d57a23dd6e37a8b92073a94ad1daaeecd64865cb/



[NUCLEO_F401RE] Add LSE configuration for RTC, remove trailing spaces, t...

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
mbed_official 87:085cde657901 38 /* Timeout values for flags and events waiting loops. These timeouts are
mbed_official 172:2f4f8c56b261 39 not based on accurate values, they just guarantee that the application will
mbed_official 172:2f4f8c56b261 40 not remain stuck if the I2C communication is corrupted. */
mbed_official 87:085cde657901 41 #define FLAG_TIMEOUT ((int)0x1000)
mbed_official 87:085cde657901 42 #define LONG_TIMEOUT ((int)0x8000)
mbed_official 87:085cde657901 43
mbed_official 87:085cde657901 44 static const PinMap PinMap_I2C_SDA[] = {
mbed_official 115:4f0cb9cdc478 45 {PB_3, I2C_2, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF9_I2C2)},
mbed_official 115:4f0cb9cdc478 46 {PB_4, I2C_3, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF9_I2C3)},
mbed_official 125:23cc3068a9e4 47 {PB_7, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 125:23cc3068a9e4 48 {PB_9, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 125:23cc3068a9e4 49 {PC_9, I2C_3, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C3)},
mbed_official 87:085cde657901 50 {NC, NC, 0}
mbed_official 87:085cde657901 51 };
mbed_official 87:085cde657901 52
mbed_official 87:085cde657901 53 static const PinMap PinMap_I2C_SCL[] = {
mbed_official 125:23cc3068a9e4 54 {PA_8, I2C_3, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C3)},
mbed_official 125:23cc3068a9e4 55 {PB_6, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 88:81f18c97d490 56 {PB_8, I2C_1, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C1)},
mbed_official 115:4f0cb9cdc478 57 {PB_10, I2C_2, STM_PIN_DATA(STM_MODE_AF_OD, GPIO_NOPULL, GPIO_AF4_I2C2)},
mbed_official 87:085cde657901 58 {NC, NC, 0}
mbed_official 87:085cde657901 59 };
mbed_official 87:085cde657901 60
mbed_official 87:085cde657901 61 I2C_HandleTypeDef I2cHandle;
mbed_official 87:085cde657901 62
mbed_official 172:2f4f8c56b261 63 void i2c_init(i2c_t *obj, PinName sda, PinName scl) {
mbed_official 87:085cde657901 64 // Determine the I2C to use
mbed_official 87:085cde657901 65 I2CName i2c_sda = (I2CName)pinmap_peripheral(sda, PinMap_I2C_SDA);
mbed_official 87:085cde657901 66 I2CName i2c_scl = (I2CName)pinmap_peripheral(scl, PinMap_I2C_SCL);
mbed_official 87:085cde657901 67
mbed_official 87:085cde657901 68 obj->i2c = (I2CName)pinmap_merge(i2c_sda, i2c_scl);
mbed_official 172:2f4f8c56b261 69
mbed_official 87:085cde657901 70 if (obj->i2c == (I2CName)NC) {
mbed_official 87:085cde657901 71 error("I2C error: pinout mapping failed.");
mbed_official 87:085cde657901 72 }
mbed_official 87:085cde657901 73
mbed_official 87:085cde657901 74 // Enable I2C clock
mbed_official 172:2f4f8c56b261 75 if (obj->i2c == I2C_1) {
mbed_official 87:085cde657901 76 __I2C1_CLK_ENABLE();
mbed_official 87:085cde657901 77 }
mbed_official 115:4f0cb9cdc478 78 if (obj->i2c == I2C_2) {
mbed_official 115:4f0cb9cdc478 79 __I2C2_CLK_ENABLE();
mbed_official 115:4f0cb9cdc478 80 }
mbed_official 115:4f0cb9cdc478 81 if (obj->i2c == I2C_3) {
mbed_official 115:4f0cb9cdc478 82 __I2C3_CLK_ENABLE();
mbed_official 115:4f0cb9cdc478 83 }
mbed_official 87:085cde657901 84
mbed_official 87:085cde657901 85 // Configure I2C pins
mbed_official 87:085cde657901 86 pinmap_pinout(sda, PinMap_I2C_SDA);
mbed_official 87:085cde657901 87 pinmap_pinout(scl, PinMap_I2C_SCL);
mbed_official 87:085cde657901 88 pin_mode(sda, OpenDrain);
mbed_official 87:085cde657901 89 pin_mode(scl, OpenDrain);
mbed_official 172:2f4f8c56b261 90
mbed_official 87:085cde657901 91 // Reset to clear pending flags if any
mbed_official 87:085cde657901 92 i2c_reset(obj);
mbed_official 172:2f4f8c56b261 93
mbed_official 87:085cde657901 94 // I2C configuration
mbed_official 172:2f4f8c56b261 95 i2c_frequency(obj, 100000); // 100 kHz per default
mbed_official 87:085cde657901 96 }
mbed_official 87:085cde657901 97
mbed_official 87:085cde657901 98 void i2c_frequency(i2c_t *obj, int hz) {
mbed_official 87:085cde657901 99 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 172:2f4f8c56b261 100
mbed_official 87:085cde657901 101 if ((hz != 0) && (hz <= 400000)) {
mbed_official 87:085cde657901 102 // I2C configuration
mbed_official 87:085cde657901 103 I2cHandle.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
mbed_official 87:085cde657901 104 I2cHandle.Init.ClockSpeed = hz;
mbed_official 87:085cde657901 105 I2cHandle.Init.DualAddressMode = I2C_DUALADDRESS_DISABLED;
mbed_official 87:085cde657901 106 I2cHandle.Init.DutyCycle = I2C_DUTYCYCLE_2;
mbed_official 87:085cde657901 107 I2cHandle.Init.GeneralCallMode = I2C_GENERALCALL_DISABLED;
mbed_official 87:085cde657901 108 I2cHandle.Init.NoStretchMode = I2C_NOSTRETCH_DISABLED;
mbed_official 87:085cde657901 109 I2cHandle.Init.OwnAddress1 = 0;
mbed_official 87:085cde657901 110 I2cHandle.Init.OwnAddress2 = 0;
mbed_official 87:085cde657901 111 HAL_I2C_Init(&I2cHandle);
mbed_official 87:085cde657901 112 }
mbed_official 87:085cde657901 113 else {
mbed_official 87:085cde657901 114 error("I2C error: frequency setting failed (max 400kHz).");
mbed_official 87:085cde657901 115 }
mbed_official 87:085cde657901 116 }
mbed_official 87:085cde657901 117
mbed_official 87:085cde657901 118 inline int i2c_start(i2c_t *obj) {
mbed_official 87:085cde657901 119 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 120 int timeout;
mbed_official 172:2f4f8c56b261 121
mbed_official 87:085cde657901 122 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 172:2f4f8c56b261 123
mbed_official 87:085cde657901 124 // Clear Acknowledge failure flag
mbed_official 87:085cde657901 125 __HAL_I2C_CLEAR_FLAG(&I2cHandle, I2C_FLAG_AF);
mbed_official 172:2f4f8c56b261 126
mbed_official 87:085cde657901 127 // Generate the START condition
mbed_official 87:085cde657901 128 i2c->CR1 |= I2C_CR1_START;
mbed_official 172:2f4f8c56b261 129
mbed_official 87:085cde657901 130 // Wait the START condition has been correctly sent
mbed_official 87:085cde657901 131 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 132 while (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_SB) == RESET) {
mbed_official 172:2f4f8c56b261 133 if ((timeout--) == 0) {
mbed_official 172:2f4f8c56b261 134 return 1;
mbed_official 172:2f4f8c56b261 135 }
mbed_official 87:085cde657901 136 }
mbed_official 172:2f4f8c56b261 137
mbed_official 87:085cde657901 138 return 0;
mbed_official 87:085cde657901 139 }
mbed_official 87:085cde657901 140
mbed_official 87:085cde657901 141 inline int i2c_stop(i2c_t *obj) {
mbed_official 87:085cde657901 142 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 172:2f4f8c56b261 143
mbed_official 87:085cde657901 144 // Generate the STOP condition
mbed_official 87:085cde657901 145 i2c->CR1 |= I2C_CR1_STOP;
mbed_official 87:085cde657901 146
mbed_official 87:085cde657901 147 return 0;
mbed_official 87:085cde657901 148 }
mbed_official 87:085cde657901 149
mbed_official 172:2f4f8c56b261 150 int i2c_read(i2c_t *obj, int address, char *data, int length, int stop) {
mbed_official 87:085cde657901 151 if (length == 0) return 0;
mbed_official 172:2f4f8c56b261 152
mbed_official 87:085cde657901 153 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 154
mbed_official 87:085cde657901 155 // Reception process with 5 seconds timeout
mbed_official 87:085cde657901 156 if (HAL_I2C_Master_Receive(&I2cHandle, (uint16_t)address, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 157 return 0; // Error
mbed_official 87:085cde657901 158 }
mbed_official 87:085cde657901 159
mbed_official 87:085cde657901 160 return length;
mbed_official 87:085cde657901 161 }
mbed_official 87:085cde657901 162
mbed_official 87:085cde657901 163 int i2c_write(i2c_t *obj, int address, const char *data, int length, int stop) {
mbed_official 87:085cde657901 164 if (length == 0) return 0;
mbed_official 172:2f4f8c56b261 165
mbed_official 87:085cde657901 166 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 167
mbed_official 87:085cde657901 168 // Transmission process with 5 seconds timeout
mbed_official 87:085cde657901 169 if (HAL_I2C_Master_Transmit(&I2cHandle, (uint16_t)address, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 170 return 0; // Error
mbed_official 87:085cde657901 171 }
mbed_official 172:2f4f8c56b261 172
mbed_official 87:085cde657901 173 return length;
mbed_official 87:085cde657901 174 }
mbed_official 87:085cde657901 175
mbed_official 87:085cde657901 176 int i2c_byte_read(i2c_t *obj, int last) {
mbed_official 87:085cde657901 177 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 178 int timeout;
mbed_official 172:2f4f8c56b261 179
mbed_official 87:085cde657901 180 if (last) {
mbed_official 87:085cde657901 181 // Don't acknowledge the last byte
mbed_official 87:085cde657901 182 i2c->CR1 &= ~I2C_CR1_ACK;
mbed_official 87:085cde657901 183 } else {
mbed_official 87:085cde657901 184 // Acknowledge the byte
mbed_official 87:085cde657901 185 i2c->CR1 |= I2C_CR1_ACK;
mbed_official 87:085cde657901 186 }
mbed_official 87:085cde657901 187
mbed_official 87:085cde657901 188 // Wait until the byte is received
mbed_official 87:085cde657901 189 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 190 while (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_RXNE) == RESET) {
mbed_official 172:2f4f8c56b261 191 if ((timeout--) == 0) {
mbed_official 172:2f4f8c56b261 192 return 0;
mbed_official 172:2f4f8c56b261 193 }
mbed_official 87:085cde657901 194 }
mbed_official 172:2f4f8c56b261 195
mbed_official 87:085cde657901 196 return (int)i2c->DR;
mbed_official 87:085cde657901 197 }
mbed_official 87:085cde657901 198
mbed_official 87:085cde657901 199 int i2c_byte_write(i2c_t *obj, int data) {
mbed_official 87:085cde657901 200 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 201 int timeout;
mbed_official 87:085cde657901 202
mbed_official 87:085cde657901 203 i2c->DR = (uint8_t)data;
mbed_official 87:085cde657901 204
mbed_official 87:085cde657901 205 // Wait until the byte is transmitted
mbed_official 172:2f4f8c56b261 206 timeout = FLAG_TIMEOUT;
mbed_official 87:085cde657901 207 while ((__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_TXE) == RESET) &&
mbed_official 87:085cde657901 208 (__HAL_I2C_GET_FLAG(&I2cHandle, I2C_FLAG_BTF) == RESET)) {
mbed_official 87:085cde657901 209 if ((timeout--) == 0) {
mbed_official 87:085cde657901 210 return 0;
mbed_official 87:085cde657901 211 }
mbed_official 87:085cde657901 212 }
mbed_official 172:2f4f8c56b261 213
mbed_official 87:085cde657901 214 return 1;
mbed_official 87:085cde657901 215 }
mbed_official 87:085cde657901 216
mbed_official 87:085cde657901 217 void i2c_reset(i2c_t *obj) {
mbed_official 172:2f4f8c56b261 218 if (obj->i2c == I2C_1) {
mbed_official 87:085cde657901 219 __I2C1_FORCE_RESET();
mbed_official 87:085cde657901 220 __I2C1_RELEASE_RESET();
mbed_official 87:085cde657901 221 }
mbed_official 115:4f0cb9cdc478 222 if (obj->i2c == I2C_2) {
mbed_official 115:4f0cb9cdc478 223 __I2C2_FORCE_RESET();
mbed_official 115:4f0cb9cdc478 224 __I2C2_RELEASE_RESET();
mbed_official 115:4f0cb9cdc478 225 }
mbed_official 115:4f0cb9cdc478 226 if (obj->i2c == I2C_3) {
mbed_official 115:4f0cb9cdc478 227 __I2C3_FORCE_RESET();
mbed_official 115:4f0cb9cdc478 228 __I2C3_RELEASE_RESET();
mbed_official 115:4f0cb9cdc478 229 }
mbed_official 87:085cde657901 230 }
mbed_official 87:085cde657901 231
mbed_official 87:085cde657901 232 #if DEVICE_I2CSLAVE
mbed_official 87:085cde657901 233
mbed_official 87:085cde657901 234 void i2c_slave_address(i2c_t *obj, int idx, uint32_t address, uint32_t mask) {
mbed_official 87:085cde657901 235 I2C_TypeDef *i2c = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 236 uint16_t tmpreg;
mbed_official 87:085cde657901 237
mbed_official 87:085cde657901 238 // Get the old register value
mbed_official 87:085cde657901 239 tmpreg = i2c->OAR1;
mbed_official 87:085cde657901 240 // Reset address bits
mbed_official 87:085cde657901 241 tmpreg &= 0xFC00;
mbed_official 87:085cde657901 242 // Set new address
mbed_official 87:085cde657901 243 tmpreg |= (uint16_t)((uint16_t)address & (uint16_t)0x00FE); // 7-bits
mbed_official 87:085cde657901 244 // Store the new register value
mbed_official 87:085cde657901 245 i2c->OAR1 = tmpreg;
mbed_official 87:085cde657901 246 }
mbed_official 87:085cde657901 247
mbed_official 87:085cde657901 248 void i2c_slave_mode(i2c_t *obj, int enable_slave) {
mbed_official 87:085cde657901 249 // Nothing to do
mbed_official 87:085cde657901 250 }
mbed_official 87:085cde657901 251
mbed_official 87:085cde657901 252 // See I2CSlave.h
mbed_official 87:085cde657901 253 #define NoData 0 // the slave has not been addressed
mbed_official 87:085cde657901 254 #define ReadAddressed 1 // the master has requested a read from this slave (slave = transmitter)
mbed_official 87:085cde657901 255 #define WriteGeneral 2 // the master is writing to all slave
mbed_official 87:085cde657901 256 #define WriteAddressed 3 // the master is writing to this slave (slave = receiver)
mbed_official 87:085cde657901 257
mbed_official 87:085cde657901 258 int i2c_slave_receive(i2c_t *obj) {
mbed_official 87:085cde657901 259 // TO BE DONE
mbed_official 87:085cde657901 260 return(0);
mbed_official 87:085cde657901 261 }
mbed_official 87:085cde657901 262
mbed_official 87:085cde657901 263 int i2c_slave_read(i2c_t *obj, char *data, int length) {
mbed_official 87:085cde657901 264 if (length == 0) return 0;
mbed_official 172:2f4f8c56b261 265
mbed_official 87:085cde657901 266 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 267
mbed_official 87:085cde657901 268 // Reception process with 5 seconds timeout
mbed_official 87:085cde657901 269 if (HAL_I2C_Slave_Receive(&I2cHandle, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 270 return 0; // Error
mbed_official 87:085cde657901 271 }
mbed_official 87:085cde657901 272
mbed_official 87:085cde657901 273 return length;
mbed_official 87:085cde657901 274 }
mbed_official 87:085cde657901 275
mbed_official 87:085cde657901 276 int i2c_slave_write(i2c_t *obj, const char *data, int length) {
mbed_official 87:085cde657901 277 if (length == 0) return 0;
mbed_official 172:2f4f8c56b261 278
mbed_official 87:085cde657901 279 I2cHandle.Instance = (I2C_TypeDef *)(obj->i2c);
mbed_official 87:085cde657901 280
mbed_official 87:085cde657901 281 // Transmission process with 5 seconds timeout
mbed_official 87:085cde657901 282 if (HAL_I2C_Slave_Transmit(&I2cHandle, (uint8_t *)data, length, 5000) != HAL_OK) {
mbed_official 87:085cde657901 283 return 0; // Error
mbed_official 87:085cde657901 284 }
mbed_official 87:085cde657901 285
mbed_official 87:085cde657901 286 return length;
mbed_official 87:085cde657901 287 }
mbed_official 87:085cde657901 288
mbed_official 87:085cde657901 289
mbed_official 87:085cde657901 290 #endif // DEVICE_I2CSLAVE
mbed_official 87:085cde657901 291
mbed_official 87:085cde657901 292 #endif // DEVICE_I2C