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_F303RE/TOOLCHAIN_ARM_MICRO/i2c_device.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_DISCO_F303VC/TARGET_STM/TARGET_STM32F3/i2c_device.h@163:e59c8e839560
Child:
172:65be27845400
mbed library. Release version 164

Who changed what in which revision?

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