shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_L152RE/spi_api.c@84:f54042cbc282, 2014-02-03 (annotated)

Committer:
mbed_official
Date:
Mon Feb 03 09:30:05 2014 +0000
Revision:
84:f54042cbc282
Parent:
80:66393a7b209d
Child:
118:b44c45162f28
Synchronized with git revision bbbd8699601c42149ccf0c37bc42bb6856ccc4c6



Full URL: https://github.com/mbedmicro/mbed/commit/bbbd8699601c42149ccf0c37bc42bb6856ccc4c6/



[NUCLEO_L152RE/F030_R8] SPI, I2C, Ticker, PWM updates

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /* mbed Microcontroller Library
mbed_official 76:aeb1df146756 2 *******************************************************************************
mbed_official 76:aeb1df146756 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 76:aeb1df146756 4 * All rights reserved.
mbed_official 76:aeb1df146756 5 *
mbed_official 76:aeb1df146756 6 * Redistribution and use in source and binary forms, with or without
mbed_official 76:aeb1df146756 7 * modification, are permitted provided that the following conditions are met:
mbed_official 76:aeb1df146756 8 *
mbed_official 76:aeb1df146756 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 76:aeb1df146756 10 * this list of conditions and the following disclaimer.
mbed_official 76:aeb1df146756 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 76:aeb1df146756 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 76:aeb1df146756 13 * and/or other materials provided with the distribution.
mbed_official 76:aeb1df146756 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 76:aeb1df146756 15 * may be used to endorse or promote products derived from this software
mbed_official 76:aeb1df146756 16 * without specific prior written permission.
mbed_official 76:aeb1df146756 17 *
mbed_official 76:aeb1df146756 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 76:aeb1df146756 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 76:aeb1df146756 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 76:aeb1df146756 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 76:aeb1df146756 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 76:aeb1df146756 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 76:aeb1df146756 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 76:aeb1df146756 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 76:aeb1df146756 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 76:aeb1df146756 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 76:aeb1df146756 28 *******************************************************************************
mbed_official 76:aeb1df146756 29 */
mbed_official 76:aeb1df146756 30 #include "spi_api.h"
mbed_official 76:aeb1df146756 31
mbed_official 76:aeb1df146756 32 #if DEVICE_SPI
mbed_official 76:aeb1df146756 33
mbed_official 76:aeb1df146756 34 #include <math.h>
mbed_official 76:aeb1df146756 35 #include "cmsis.h"
mbed_official 76:aeb1df146756 36 #include "pinmap.h"
mbed_official 76:aeb1df146756 37 #include "error.h"
mbed_official 76:aeb1df146756 38
mbed_official 76:aeb1df146756 39 static const PinMap PinMap_SPI_MOSI[] = {
mbed_official 80:66393a7b209d 40 {PA_7, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)},
mbed_official 80:66393a7b209d 41 {PA_12, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)}, // REMAP
mbed_official 76:aeb1df146756 42 {NC, NC, 0}
mbed_official 76:aeb1df146756 43 };
mbed_official 76:aeb1df146756 44
mbed_official 76:aeb1df146756 45 static const PinMap PinMap_SPI_MISO[] = {
mbed_official 80:66393a7b209d 46 {PA_6, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)},
mbed_official 80:66393a7b209d 47 {PA_11, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)}, // REMAP
mbed_official 76:aeb1df146756 48 {NC, NC, 0}
mbed_official 76:aeb1df146756 49 };
mbed_official 76:aeb1df146756 50
mbed_official 76:aeb1df146756 51 static const PinMap PinMap_SPI_SCLK[] = {
mbed_official 80:66393a7b209d 52 {PA_5, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)},
mbed_official 80:66393a7b209d 53 {PB_3, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)}, // REMAP
mbed_official 76:aeb1df146756 54 {NC, NC, 0}
mbed_official 76:aeb1df146756 55 };
mbed_official 76:aeb1df146756 56
mbed_official 76:aeb1df146756 57 // Only used in Slave mode
mbed_official 76:aeb1df146756 58 static const PinMap PinMap_SPI_SSEL[] = {
mbed_official 80:66393a7b209d 59 {PA_4, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)},
mbed_official 80:66393a7b209d 60 {PA_15, SPI_1, STM_PIN_DATA(GPIO_Mode_AF, GPIO_OType_PP, GPIO_PuPd_UP, GPIO_AF_SPI1)}, // REMAP
mbed_official 76:aeb1df146756 61 {NC, NC, 0}
mbed_official 76:aeb1df146756 62 };
mbed_official 76:aeb1df146756 63
mbed_official 76:aeb1df146756 64 static void init_spi(spi_t *obj) {
mbed_official 76:aeb1df146756 65 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 66 SPI_InitTypeDef SPI_InitStructure;
mbed_official 76:aeb1df146756 67
mbed_official 76:aeb1df146756 68 SPI_Cmd(spi, DISABLE);
mbed_official 76:aeb1df146756 69
mbed_official 76:aeb1df146756 70 SPI_InitStructure.SPI_Mode = obj->mode;
mbed_official 76:aeb1df146756 71 SPI_InitStructure.SPI_NSS = obj->nss;
mbed_official 76:aeb1df146756 72 SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;
mbed_official 76:aeb1df146756 73 SPI_InitStructure.SPI_DataSize = obj->bits;
mbed_official 76:aeb1df146756 74 SPI_InitStructure.SPI_CPOL = obj->cpol;
mbed_official 76:aeb1df146756 75 SPI_InitStructure.SPI_CPHA = obj->cpha;
mbed_official 76:aeb1df146756 76 SPI_InitStructure.SPI_BaudRatePrescaler = obj->br_presc;
mbed_official 76:aeb1df146756 77 SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
mbed_official 76:aeb1df146756 78 SPI_InitStructure.SPI_CRCPolynomial = 7;
mbed_official 76:aeb1df146756 79 SPI_Init(spi, &SPI_InitStructure);
mbed_official 76:aeb1df146756 80
mbed_official 76:aeb1df146756 81 SPI_Cmd(spi, ENABLE);
mbed_official 76:aeb1df146756 82 }
mbed_official 76:aeb1df146756 83
mbed_official 76:aeb1df146756 84 void spi_init(spi_t *obj, PinName mosi, PinName miso, PinName sclk, PinName ssel) {
mbed_official 76:aeb1df146756 85 // Determine the SPI to use
mbed_official 76:aeb1df146756 86 SPIName spi_mosi = (SPIName)pinmap_peripheral(mosi, PinMap_SPI_MOSI);
mbed_official 76:aeb1df146756 87 SPIName spi_miso = (SPIName)pinmap_peripheral(miso, PinMap_SPI_MISO);
mbed_official 76:aeb1df146756 88 SPIName spi_sclk = (SPIName)pinmap_peripheral(sclk, PinMap_SPI_SCLK);
mbed_official 76:aeb1df146756 89 SPIName spi_ssel = (SPIName)pinmap_peripheral(ssel, PinMap_SPI_SSEL);
mbed_official 76:aeb1df146756 90
mbed_official 76:aeb1df146756 91 SPIName spi_data = (SPIName)pinmap_merge(spi_mosi, spi_miso);
mbed_official 76:aeb1df146756 92 SPIName spi_cntl = (SPIName)pinmap_merge(spi_sclk, spi_ssel);
mbed_official 76:aeb1df146756 93
mbed_official 76:aeb1df146756 94 obj->spi = (SPIName)pinmap_merge(spi_data, spi_cntl);
mbed_official 76:aeb1df146756 95
mbed_official 76:aeb1df146756 96 if (obj->spi == (SPIName)NC) {
mbed_official 76:aeb1df146756 97 error("SPI pinout mapping failed");
mbed_official 76:aeb1df146756 98 }
mbed_official 76:aeb1df146756 99
mbed_official 76:aeb1df146756 100 // Enable SPI clock
mbed_official 76:aeb1df146756 101 if (obj->spi == SPI_1) {
mbed_official 76:aeb1df146756 102 RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);
mbed_official 76:aeb1df146756 103 }
mbed_official 76:aeb1df146756 104 if (obj->spi == SPI_2) {
mbed_official 76:aeb1df146756 105 RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE);
mbed_official 76:aeb1df146756 106 }
mbed_official 76:aeb1df146756 107
mbed_official 76:aeb1df146756 108 // Configure the SPI pins
mbed_official 76:aeb1df146756 109 pinmap_pinout(mosi, PinMap_SPI_MOSI);
mbed_official 76:aeb1df146756 110 pinmap_pinout(miso, PinMap_SPI_MISO);
mbed_official 76:aeb1df146756 111 pinmap_pinout(sclk, PinMap_SPI_SCLK);
mbed_official 76:aeb1df146756 112
mbed_official 76:aeb1df146756 113 // Save new values
mbed_official 76:aeb1df146756 114 obj->bits = SPI_DataSize_8b;
mbed_official 76:aeb1df146756 115 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 116 obj->cpha = SPI_CPHA_1Edge;
mbed_official 84:f54042cbc282 117 obj->br_presc = SPI_BaudRatePrescaler_16; // 1 MHz
mbed_official 76:aeb1df146756 118
mbed_official 76:aeb1df146756 119 if (ssel == NC) { // Master
mbed_official 76:aeb1df146756 120 obj->mode = SPI_Mode_Master;
mbed_official 76:aeb1df146756 121 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 122 }
mbed_official 76:aeb1df146756 123 else { // Slave
mbed_official 76:aeb1df146756 124 pinmap_pinout(ssel, PinMap_SPI_SSEL);
mbed_official 76:aeb1df146756 125 obj->mode = SPI_Mode_Slave;
mbed_official 76:aeb1df146756 126 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 127 }
mbed_official 76:aeb1df146756 128
mbed_official 76:aeb1df146756 129 init_spi(obj);
mbed_official 76:aeb1df146756 130 }
mbed_official 76:aeb1df146756 131
mbed_official 76:aeb1df146756 132 void spi_free(spi_t *obj) {
mbed_official 76:aeb1df146756 133 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 134 SPI_I2S_DeInit(spi);
mbed_official 76:aeb1df146756 135 }
mbed_official 76:aeb1df146756 136
mbed_official 76:aeb1df146756 137 void spi_format(spi_t *obj, int bits, int mode, int slave) {
mbed_official 76:aeb1df146756 138 // Save new values
mbed_official 76:aeb1df146756 139 if (bits == 8) {
mbed_official 76:aeb1df146756 140 obj->bits = SPI_DataSize_8b;
mbed_official 76:aeb1df146756 141 }
mbed_official 76:aeb1df146756 142 else {
mbed_official 76:aeb1df146756 143 obj->bits = SPI_DataSize_16b;
mbed_official 76:aeb1df146756 144 }
mbed_official 76:aeb1df146756 145
mbed_official 76:aeb1df146756 146 switch (mode) {
mbed_official 76:aeb1df146756 147 case 0:
mbed_official 76:aeb1df146756 148 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 149 obj->cpha = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 150 break;
mbed_official 76:aeb1df146756 151 case 1:
mbed_official 76:aeb1df146756 152 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 153 obj->cpha = SPI_CPHA_2Edge;
mbed_official 76:aeb1df146756 154 break;
mbed_official 76:aeb1df146756 155 case 2:
mbed_official 76:aeb1df146756 156 obj->cpol = SPI_CPOL_High;
mbed_official 76:aeb1df146756 157 obj->cpha = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 158 break;
mbed_official 76:aeb1df146756 159 default:
mbed_official 76:aeb1df146756 160 obj->cpol = SPI_CPOL_High;
mbed_official 76:aeb1df146756 161 obj->cpha = SPI_CPHA_2Edge;
mbed_official 76:aeb1df146756 162 break;
mbed_official 76:aeb1df146756 163 }
mbed_official 76:aeb1df146756 164
mbed_official 76:aeb1df146756 165 if (slave == 0) {
mbed_official 76:aeb1df146756 166 obj->mode = SPI_Mode_Master;
mbed_official 76:aeb1df146756 167 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 168 }
mbed_official 76:aeb1df146756 169 else {
mbed_official 76:aeb1df146756 170 obj->mode = SPI_Mode_Slave;
mbed_official 76:aeb1df146756 171 obj->nss = SPI_NSS_Hard;
mbed_official 76:aeb1df146756 172 }
mbed_official 76:aeb1df146756 173
mbed_official 76:aeb1df146756 174 init_spi(obj);
mbed_official 76:aeb1df146756 175 }
mbed_official 76:aeb1df146756 176
mbed_official 76:aeb1df146756 177 void spi_frequency(spi_t *obj, int hz) {
mbed_official 76:aeb1df146756 178 // Get SPI clock frequency
mbed_official 84:f54042cbc282 179 uint32_t PCLK = SystemCoreClock;
mbed_official 76:aeb1df146756 180
mbed_official 76:aeb1df146756 181 // Choose the baud rate divisor (between 2 and 256)
mbed_official 76:aeb1df146756 182 uint32_t divisor = PCLK / hz;
mbed_official 76:aeb1df146756 183
mbed_official 76:aeb1df146756 184 // Find the nearest power-of-2
mbed_official 76:aeb1df146756 185 divisor = (divisor > 0 ? divisor-1 : 0);
mbed_official 76:aeb1df146756 186 divisor |= divisor >> 1;
mbed_official 76:aeb1df146756 187 divisor |= divisor >> 2;
mbed_official 76:aeb1df146756 188 divisor |= divisor >> 4;
mbed_official 76:aeb1df146756 189 divisor |= divisor >> 8;
mbed_official 76:aeb1df146756 190 divisor |= divisor >> 16;
mbed_official 76:aeb1df146756 191 divisor++;
mbed_official 76:aeb1df146756 192
mbed_official 76:aeb1df146756 193 uint32_t baud_rate = __builtin_ffs(divisor) - 2;
mbed_official 76:aeb1df146756 194
mbed_official 76:aeb1df146756 195 // Save new value
mbed_official 76:aeb1df146756 196 obj->br_presc = ((baud_rate > 7) ? (7 << 3) : (baud_rate << 3));
mbed_official 76:aeb1df146756 197
mbed_official 76:aeb1df146756 198 init_spi(obj);
mbed_official 76:aeb1df146756 199 }
mbed_official 76:aeb1df146756 200
mbed_official 76:aeb1df146756 201 static inline int ssp_readable(spi_t *obj) {
mbed_official 76:aeb1df146756 202 int status;
mbed_official 76:aeb1df146756 203 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 204 // Check if data is received
mbed_official 76:aeb1df146756 205 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 206 return status;
mbed_official 76:aeb1df146756 207 }
mbed_official 76:aeb1df146756 208
mbed_official 76:aeb1df146756 209 static inline int ssp_writeable(spi_t *obj) {
mbed_official 76:aeb1df146756 210 int status;
mbed_official 76:aeb1df146756 211 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 212 // Check if data is transmitted
mbed_official 76:aeb1df146756 213 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 214 return status;
mbed_official 76:aeb1df146756 215 }
mbed_official 76:aeb1df146756 216
mbed_official 76:aeb1df146756 217 static inline void ssp_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 218 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 219 while (!ssp_writeable(obj));
mbed_official 76:aeb1df146756 220 SPI_I2S_SendData(spi, (uint16_t)value);
mbed_official 76:aeb1df146756 221 }
mbed_official 76:aeb1df146756 222
mbed_official 76:aeb1df146756 223 static inline int ssp_read(spi_t *obj) {
mbed_official 76:aeb1df146756 224 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 225 while (!ssp_readable(obj));
mbed_official 76:aeb1df146756 226 return (int)SPI_I2S_ReceiveData(spi);
mbed_official 76:aeb1df146756 227 }
mbed_official 76:aeb1df146756 228
mbed_official 76:aeb1df146756 229 static inline int ssp_busy(spi_t *obj) {
mbed_official 76:aeb1df146756 230 int status;
mbed_official 76:aeb1df146756 231 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 232 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_BSY) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 233 return status;
mbed_official 76:aeb1df146756 234 }
mbed_official 76:aeb1df146756 235
mbed_official 76:aeb1df146756 236 int spi_master_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 237 ssp_write(obj, value);
mbed_official 76:aeb1df146756 238 return ssp_read(obj);
mbed_official 76:aeb1df146756 239 }
mbed_official 76:aeb1df146756 240
mbed_official 76:aeb1df146756 241 int spi_slave_receive(spi_t *obj) {
mbed_official 76:aeb1df146756 242 return (ssp_readable(obj) && !ssp_busy(obj)) ? (1) : (0);
mbed_official 76:aeb1df146756 243 };
mbed_official 76:aeb1df146756 244
mbed_official 76:aeb1df146756 245 int spi_slave_read(spi_t *obj) {
mbed_official 76:aeb1df146756 246 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 247 return (int)SPI_I2S_ReceiveData(spi);
mbed_official 76:aeb1df146756 248 }
mbed_official 76:aeb1df146756 249
mbed_official 76:aeb1df146756 250 void spi_slave_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 251 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 252 while (!ssp_writeable(obj));
mbed_official 76:aeb1df146756 253 SPI_I2S_SendData(spi, (uint16_t)value);
mbed_official 76:aeb1df146756 254 }
mbed_official 76:aeb1df146756 255
mbed_official 76:aeb1df146756 256 int spi_busy(spi_t *obj) {
mbed_official 76:aeb1df146756 257 return ssp_busy(obj);
mbed_official 76:aeb1df146756 258 }
mbed_official 76:aeb1df146756 259
mbed_official 76:aeb1df146756 260 #endif