mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_L496ZG_P/TARGET_STM/TARGET_STM32L4/i2c_device.h@158:1c57384330a6, 2017-11-23 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 23 11:44:04 2017 +0000
Revision:
158:1c57384330a6
mbed library. Release version 156

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 158:1c57384330a6 1 /* mbed Microcontroller Library
AnnaBridge 158:1c57384330a6 2 *******************************************************************************
AnnaBridge 158:1c57384330a6 3 * Copyright (c) 2015, STMicroelectronics
AnnaBridge 158:1c57384330a6 4 * All rights reserved.
AnnaBridge 158:1c57384330a6 5 *
AnnaBridge 158:1c57384330a6 6 * Redistribution and use in source and binary forms, with or without
AnnaBridge 158:1c57384330a6 7 * modification, are permitted provided that the following conditions are met:
AnnaBridge 158:1c57384330a6 8 *
AnnaBridge 158:1c57384330a6 9 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 158:1c57384330a6 10 * this list of conditions and the following disclaimer.
AnnaBridge 158:1c57384330a6 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 158:1c57384330a6 12 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 158:1c57384330a6 13 * and/or other materials provided with the distribution.
AnnaBridge 158:1c57384330a6 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 158:1c57384330a6 15 * may be used to endorse or promote products derived from this software
AnnaBridge 158:1c57384330a6 16 * without specific prior written permission.
AnnaBridge 158:1c57384330a6 17 *
AnnaBridge 158:1c57384330a6 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 158:1c57384330a6 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 158:1c57384330a6 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 158:1c57384330a6 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 158:1c57384330a6 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 158:1c57384330a6 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 158:1c57384330a6 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 158:1c57384330a6 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 158:1c57384330a6 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 158:1c57384330a6 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 158:1c57384330a6 28 *******************************************************************************
AnnaBridge 158:1c57384330a6 29 */
AnnaBridge 158:1c57384330a6 30 #ifndef MBED_I2C_DEVICE_H
AnnaBridge 158:1c57384330a6 31 #define MBED_I2C_DEVICE_H
AnnaBridge 158:1c57384330a6 32
AnnaBridge 158:1c57384330a6 33 #include "cmsis.h"
AnnaBridge 158:1c57384330a6 34
AnnaBridge 158:1c57384330a6 35 #ifdef __cplusplus
AnnaBridge 158:1c57384330a6 36 extern "C" {
AnnaBridge 158:1c57384330a6 37 #endif
AnnaBridge 158:1c57384330a6 38
AnnaBridge 158:1c57384330a6 39 #ifdef DEVICE_I2C
AnnaBridge 158:1c57384330a6 40
AnnaBridge 158:1c57384330a6 41 #define I2C_IP_VERSION_V2
AnnaBridge 158:1c57384330a6 42
AnnaBridge 158:1c57384330a6 43 #define I2C_IT_ALL (I2C_IT_ERRI|I2C_IT_TCI|I2C_IT_STOPI|I2C_IT_NACKI|I2C_IT_ADDRI|I2C_IT_RXI|I2C_IT_TXI)
AnnaBridge 158:1c57384330a6 44
AnnaBridge 158:1c57384330a6 45 /* Family specifc settings for clock source */
AnnaBridge 158:1c57384330a6 46 #define I2CAPI_I2C1_CLKSRC RCC_I2C1CLKSOURCE_SYSCLK
AnnaBridge 158:1c57384330a6 47 #define I2CAPI_I2C2_CLKSRC RCC_I2C2CLKSOURCE_SYSCLK
AnnaBridge 158:1c57384330a6 48 #define I2CAPI_I2C3_CLKSRC RCC_I2C3CLKSOURCE_SYSCLK
AnnaBridge 158:1c57384330a6 49 #define I2CAPI_I2C4_CLKSRC RCC_I2C4CLKSOURCE_SYSCLK
AnnaBridge 158:1c57384330a6 50
AnnaBridge 158:1c57384330a6 51 /* Provide the suitable timing depending on requested frequencie */
AnnaBridge 158:1c57384330a6 52 static inline uint32_t get_i2c_timing(int hz)
AnnaBridge 158:1c57384330a6 53 {
AnnaBridge 158:1c57384330a6 54 uint32_t tim = 0;
AnnaBridge 158:1c57384330a6 55 if (SystemCoreClock == 80000000) {
AnnaBridge 158:1c57384330a6 56 // Common settings: I2C clock = 80 MHz, Analog filter = ON, Digital filter coefficient = 0
AnnaBridge 158:1c57384330a6 57 switch (hz) {
AnnaBridge 158:1c57384330a6 58 case 100000:
AnnaBridge 158:1c57384330a6 59 tim = 0x30C14E6B; // Standard mode with Rise Time = 400ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 60 break;
AnnaBridge 158:1c57384330a6 61 case 400000:
AnnaBridge 158:1c57384330a6 62 tim = 0x10D1143A; // Fast mode with Rise Time = 250ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 63 break;
AnnaBridge 158:1c57384330a6 64 case 1000000:
AnnaBridge 158:1c57384330a6 65 tim = 0x00810E27; // Fast mode Plus with Rise Time = 60ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 66 break;
AnnaBridge 158:1c57384330a6 67 default:
AnnaBridge 158:1c57384330a6 68 break;
AnnaBridge 158:1c57384330a6 69 }
AnnaBridge 158:1c57384330a6 70 } else if (SystemCoreClock == 48000000) {
AnnaBridge 158:1c57384330a6 71 // Common settings: I2C clock = 48 MHz, Analog filter = ON, Digital filter coefficient = 0
AnnaBridge 158:1c57384330a6 72 switch (hz) {
AnnaBridge 158:1c57384330a6 73 case 100000:
AnnaBridge 158:1c57384330a6 74 tim = 0x20A03E55; // Standard mode with Rise Time = 400ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 75 break;
AnnaBridge 158:1c57384330a6 76 case 400000:
AnnaBridge 158:1c57384330a6 77 tim = 0x10800C21; // Fast mode with Rise Time = 250ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 78 break;
AnnaBridge 158:1c57384330a6 79 case 1000000:
AnnaBridge 158:1c57384330a6 80 tim = 0x00500816; // Fast mode Plus with Rise Time = 60ns and Fall Time = 100ns
AnnaBridge 158:1c57384330a6 81 break;
AnnaBridge 158:1c57384330a6 82 default:
AnnaBridge 158:1c57384330a6 83 break;
AnnaBridge 158:1c57384330a6 84 }
AnnaBridge 158:1c57384330a6 85 }
AnnaBridge 158:1c57384330a6 86 return tim;
AnnaBridge 158:1c57384330a6 87 }
AnnaBridge 158:1c57384330a6 88
AnnaBridge 158:1c57384330a6 89 #ifdef __cplusplus
AnnaBridge 158:1c57384330a6 90 }
AnnaBridge 158:1c57384330a6 91 #endif
AnnaBridge 158:1c57384330a6 92
AnnaBridge 158:1c57384330a6 93 #endif // DEVICE_I2C
AnnaBridge 158:1c57384330a6 94
AnnaBridge 158:1c57384330a6 95 #endif