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@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