mbed library sources
Fork of mbed-src by
targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/i2c_api.c@87:085cde657901, 2014-02-08 (annotated)
- Committer:
- mbed_official
- Date:
- Sat Feb 08 19:45:06 2014 +0000
- Revision:
- 87:085cde657901
- Child:
- 88:81f18c97d490
Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2
Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/
Add NUCLEO_F401RE, improvements
Who changed what in which revision?
User | Revision | Line number | New 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 | 87:085cde657901 | 46 | {PB_9, I2C_1, STM_PIN_DATA(GPIO_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 | 87:085cde657901 | 51 | {PB_8, I2C_1, STM_PIN_DATA(GPIO_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 |