mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 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