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@115:4f0cb9cdc478, 2014-03-11 (annotated)

Committer:
mbed_official
Date:
Tue Mar 11 12:00:07 2014 +0000
Revision:
115:4f0cb9cdc478
Parent:
88:81f18c97d490
Child:
125:23cc3068a9e4
Synchronized with git revision 2bb462f5a37de3bf6e9c9ad9dc33e60be35d06a7



Full URL: https://github.com/mbedmicro/mbed/commit/2bb462f5a37de3bf6e9c9ad9dc33e60be35d06a7/

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