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_L152RE/spi_api.c@76:aeb1df146756, 2014-01-27 (annotated)

Committer:
mbed_official
Date:
Mon Jan 27 14:30:07 2014 +0000
Revision:
76:aeb1df146756
Child:
80:66393a7b209d
Synchronized with git revision a31ec9c5f7bcb5c8a1b2eced103f6a1dfa921abd



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



Add NUCLEO_L152RE

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 76:aeb1df146756 40 {PA_7, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 0)},
mbed_official 76:aeb1df146756 41 {PB_5, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 1)}, // 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 76:aeb1df146756 46 {PA_6, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 0)},
mbed_official 76:aeb1df146756 47 {PB_4, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 1)}, // 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 76:aeb1df146756 52 {PA_5, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 0)},
mbed_official 76:aeb1df146756 53 {PB_3, SPI_1, STM_PIN_DATA(GPIO_Mode_AF_PP, 1)}, // 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 76:aeb1df146756 59 {PB_6, SPI_1, STM_PIN_DATA(GPIO_Mode_IN_FLOATING, 0)}, // Generic IO, not real H/W NSS pin
mbed_official 76:aeb1df146756 60 //{PA_4, SPI_1, STM_PIN_DATA(GPIO_Mode_IN_FLOATING, 0)},
mbed_official 76:aeb1df146756 61 //{PA_15, SPI_1, STM_PIN_DATA(GPIO_Mode_IN_FLOATING, 1)}, // Remap
mbed_official 76:aeb1df146756 62 {NC, NC, 0}
mbed_official 76:aeb1df146756 63 };
mbed_official 76:aeb1df146756 64
mbed_official 76:aeb1df146756 65 static void init_spi(spi_t *obj) {
mbed_official 76:aeb1df146756 66 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 67 SPI_InitTypeDef SPI_InitStructure;
mbed_official 76:aeb1df146756 68
mbed_official 76:aeb1df146756 69 SPI_Cmd(spi, DISABLE);
mbed_official 76:aeb1df146756 70
mbed_official 76:aeb1df146756 71 SPI_InitStructure.SPI_Mode = obj->mode;
mbed_official 76:aeb1df146756 72 SPI_InitStructure.SPI_NSS = obj->nss;
mbed_official 76:aeb1df146756 73 SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;
mbed_official 76:aeb1df146756 74 SPI_InitStructure.SPI_DataSize = obj->bits;
mbed_official 76:aeb1df146756 75 SPI_InitStructure.SPI_CPOL = obj->cpol;
mbed_official 76:aeb1df146756 76 SPI_InitStructure.SPI_CPHA = obj->cpha;
mbed_official 76:aeb1df146756 77 SPI_InitStructure.SPI_BaudRatePrescaler = obj->br_presc;
mbed_official 76:aeb1df146756 78 SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
mbed_official 76:aeb1df146756 79 SPI_InitStructure.SPI_CRCPolynomial = 7;
mbed_official 76:aeb1df146756 80 SPI_Init(spi, &SPI_InitStructure);
mbed_official 76:aeb1df146756 81
mbed_official 76:aeb1df146756 82 SPI_Cmd(spi, ENABLE);
mbed_official 76:aeb1df146756 83 }
mbed_official 76:aeb1df146756 84
mbed_official 76:aeb1df146756 85 void spi_init(spi_t *obj, PinName mosi, PinName miso, PinName sclk, PinName ssel) {
mbed_official 76:aeb1df146756 86 // Determine the SPI to use
mbed_official 76:aeb1df146756 87 SPIName spi_mosi = (SPIName)pinmap_peripheral(mosi, PinMap_SPI_MOSI);
mbed_official 76:aeb1df146756 88 SPIName spi_miso = (SPIName)pinmap_peripheral(miso, PinMap_SPI_MISO);
mbed_official 76:aeb1df146756 89 SPIName spi_sclk = (SPIName)pinmap_peripheral(sclk, PinMap_SPI_SCLK);
mbed_official 76:aeb1df146756 90 SPIName spi_ssel = (SPIName)pinmap_peripheral(ssel, PinMap_SPI_SSEL);
mbed_official 76:aeb1df146756 91
mbed_official 76:aeb1df146756 92 SPIName spi_data = (SPIName)pinmap_merge(spi_mosi, spi_miso);
mbed_official 76:aeb1df146756 93 SPIName spi_cntl = (SPIName)pinmap_merge(spi_sclk, spi_ssel);
mbed_official 76:aeb1df146756 94
mbed_official 76:aeb1df146756 95 obj->spi = (SPIName)pinmap_merge(spi_data, spi_cntl);
mbed_official 76:aeb1df146756 96
mbed_official 76:aeb1df146756 97 if (obj->spi == (SPIName)NC) {
mbed_official 76:aeb1df146756 98 error("SPI pinout mapping failed");
mbed_official 76:aeb1df146756 99 }
mbed_official 76:aeb1df146756 100
mbed_official 76:aeb1df146756 101 // Enable SPI clock
mbed_official 76:aeb1df146756 102 if (obj->spi == SPI_1) {
mbed_official 76:aeb1df146756 103 RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);
mbed_official 76:aeb1df146756 104 }
mbed_official 76:aeb1df146756 105 if (obj->spi == SPI_2) {
mbed_official 76:aeb1df146756 106 RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE);
mbed_official 76:aeb1df146756 107 }
mbed_official 76:aeb1df146756 108
mbed_official 76:aeb1df146756 109 // Configure the SPI pins
mbed_official 76:aeb1df146756 110 pinmap_pinout(mosi, PinMap_SPI_MOSI);
mbed_official 76:aeb1df146756 111 pinmap_pinout(miso, PinMap_SPI_MISO);
mbed_official 76:aeb1df146756 112 pinmap_pinout(sclk, PinMap_SPI_SCLK);
mbed_official 76:aeb1df146756 113
mbed_official 76:aeb1df146756 114 // Save new values
mbed_official 76:aeb1df146756 115 obj->bits = SPI_DataSize_8b;
mbed_official 76:aeb1df146756 116 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 117 obj->cpha = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 118 obj->br_presc = SPI_BaudRatePrescaler_64; // Closest to 1MHz (72MHz/64 = 1.125MHz)
mbed_official 76:aeb1df146756 119
mbed_official 76:aeb1df146756 120 if (ssel == NC) { // Master
mbed_official 76:aeb1df146756 121 obj->mode = SPI_Mode_Master;
mbed_official 76:aeb1df146756 122 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 123 }
mbed_official 76:aeb1df146756 124 else { // Slave
mbed_official 76:aeb1df146756 125 pinmap_pinout(ssel, PinMap_SPI_SSEL);
mbed_official 76:aeb1df146756 126 obj->mode = SPI_Mode_Slave;
mbed_official 76:aeb1df146756 127 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 128 }
mbed_official 76:aeb1df146756 129
mbed_official 76:aeb1df146756 130 init_spi(obj);
mbed_official 76:aeb1df146756 131 }
mbed_official 76:aeb1df146756 132
mbed_official 76:aeb1df146756 133 void spi_free(spi_t *obj) {
mbed_official 76:aeb1df146756 134 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 135 SPI_I2S_DeInit(spi);
mbed_official 76:aeb1df146756 136 }
mbed_official 76:aeb1df146756 137
mbed_official 76:aeb1df146756 138 void spi_format(spi_t *obj, int bits, int mode, int slave) {
mbed_official 76:aeb1df146756 139 // Save new values
mbed_official 76:aeb1df146756 140 if (bits == 8) {
mbed_official 76:aeb1df146756 141 obj->bits = SPI_DataSize_8b;
mbed_official 76:aeb1df146756 142 }
mbed_official 76:aeb1df146756 143 else {
mbed_official 76:aeb1df146756 144 obj->bits = SPI_DataSize_16b;
mbed_official 76:aeb1df146756 145 }
mbed_official 76:aeb1df146756 146
mbed_official 76:aeb1df146756 147 switch (mode) {
mbed_official 76:aeb1df146756 148 case 0:
mbed_official 76:aeb1df146756 149 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 150 obj->cpha = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 151 break;
mbed_official 76:aeb1df146756 152 case 1:
mbed_official 76:aeb1df146756 153 obj->cpol = SPI_CPOL_Low;
mbed_official 76:aeb1df146756 154 obj->cpha = SPI_CPHA_2Edge;
mbed_official 76:aeb1df146756 155 break;
mbed_official 76:aeb1df146756 156 case 2:
mbed_official 76:aeb1df146756 157 obj->cpol = SPI_CPOL_High;
mbed_official 76:aeb1df146756 158 obj->cpha = SPI_CPHA_1Edge;
mbed_official 76:aeb1df146756 159 break;
mbed_official 76:aeb1df146756 160 default:
mbed_official 76:aeb1df146756 161 obj->cpol = SPI_CPOL_High;
mbed_official 76:aeb1df146756 162 obj->cpha = SPI_CPHA_2Edge;
mbed_official 76:aeb1df146756 163 break;
mbed_official 76:aeb1df146756 164 }
mbed_official 76:aeb1df146756 165
mbed_official 76:aeb1df146756 166 if (slave == 0) {
mbed_official 76:aeb1df146756 167 obj->mode = SPI_Mode_Master;
mbed_official 76:aeb1df146756 168 obj->nss = SPI_NSS_Soft;
mbed_official 76:aeb1df146756 169 }
mbed_official 76:aeb1df146756 170 else {
mbed_official 76:aeb1df146756 171 obj->mode = SPI_Mode_Slave;
mbed_official 76:aeb1df146756 172 obj->nss = SPI_NSS_Hard;
mbed_official 76:aeb1df146756 173 }
mbed_official 76:aeb1df146756 174
mbed_official 76:aeb1df146756 175 init_spi(obj);
mbed_official 76:aeb1df146756 176 }
mbed_official 76:aeb1df146756 177
mbed_official 76:aeb1df146756 178 void spi_frequency(spi_t *obj, int hz) {
mbed_official 76:aeb1df146756 179 // Get SPI clock frequency
mbed_official 76:aeb1df146756 180 uint32_t PCLK = SystemCoreClock >> 1;
mbed_official 76:aeb1df146756 181
mbed_official 76:aeb1df146756 182 // Choose the baud rate divisor (between 2 and 256)
mbed_official 76:aeb1df146756 183 uint32_t divisor = PCLK / hz;
mbed_official 76:aeb1df146756 184
mbed_official 76:aeb1df146756 185 // Find the nearest power-of-2
mbed_official 76:aeb1df146756 186 divisor = (divisor > 0 ? divisor-1 : 0);
mbed_official 76:aeb1df146756 187 divisor |= divisor >> 1;
mbed_official 76:aeb1df146756 188 divisor |= divisor >> 2;
mbed_official 76:aeb1df146756 189 divisor |= divisor >> 4;
mbed_official 76:aeb1df146756 190 divisor |= divisor >> 8;
mbed_official 76:aeb1df146756 191 divisor |= divisor >> 16;
mbed_official 76:aeb1df146756 192 divisor++;
mbed_official 76:aeb1df146756 193
mbed_official 76:aeb1df146756 194 uint32_t baud_rate = __builtin_ffs(divisor) - 2;
mbed_official 76:aeb1df146756 195
mbed_official 76:aeb1df146756 196 // Save new value
mbed_official 76:aeb1df146756 197 obj->br_presc = ((baud_rate > 7) ? (7 << 3) : (baud_rate << 3));
mbed_official 76:aeb1df146756 198
mbed_official 76:aeb1df146756 199 init_spi(obj);
mbed_official 76:aeb1df146756 200 }
mbed_official 76:aeb1df146756 201
mbed_official 76:aeb1df146756 202 static inline int ssp_readable(spi_t *obj) {
mbed_official 76:aeb1df146756 203 int status;
mbed_official 76:aeb1df146756 204 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 205 // Check if data is received
mbed_official 76:aeb1df146756 206 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 207 return status;
mbed_official 76:aeb1df146756 208 }
mbed_official 76:aeb1df146756 209
mbed_official 76:aeb1df146756 210 static inline int ssp_writeable(spi_t *obj) {
mbed_official 76:aeb1df146756 211 int status;
mbed_official 76:aeb1df146756 212 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 213 // Check if data is transmitted
mbed_official 76:aeb1df146756 214 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 215 return status;
mbed_official 76:aeb1df146756 216 }
mbed_official 76:aeb1df146756 217
mbed_official 76:aeb1df146756 218 static inline void ssp_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 219 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 220 while (!ssp_writeable(obj));
mbed_official 76:aeb1df146756 221 SPI_I2S_SendData(spi, (uint16_t)value);
mbed_official 76:aeb1df146756 222 }
mbed_official 76:aeb1df146756 223
mbed_official 76:aeb1df146756 224 static inline int ssp_read(spi_t *obj) {
mbed_official 76:aeb1df146756 225 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 226 while (!ssp_readable(obj));
mbed_official 76:aeb1df146756 227 return (int)SPI_I2S_ReceiveData(spi);
mbed_official 76:aeb1df146756 228 }
mbed_official 76:aeb1df146756 229
mbed_official 76:aeb1df146756 230 static inline int ssp_busy(spi_t *obj) {
mbed_official 76:aeb1df146756 231 int status;
mbed_official 76:aeb1df146756 232 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 233 status = ((SPI_I2S_GetFlagStatus(spi, SPI_I2S_FLAG_BSY) != RESET) ? 1 : 0);
mbed_official 76:aeb1df146756 234 return status;
mbed_official 76:aeb1df146756 235 }
mbed_official 76:aeb1df146756 236
mbed_official 76:aeb1df146756 237 int spi_master_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 238 ssp_write(obj, value);
mbed_official 76:aeb1df146756 239 return ssp_read(obj);
mbed_official 76:aeb1df146756 240 }
mbed_official 76:aeb1df146756 241
mbed_official 76:aeb1df146756 242 int spi_slave_receive(spi_t *obj) {
mbed_official 76:aeb1df146756 243 return (ssp_readable(obj) && !ssp_busy(obj)) ? (1) : (0);
mbed_official 76:aeb1df146756 244 };
mbed_official 76:aeb1df146756 245
mbed_official 76:aeb1df146756 246 int spi_slave_read(spi_t *obj) {
mbed_official 76:aeb1df146756 247 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 248 return (int)SPI_I2S_ReceiveData(spi);
mbed_official 76:aeb1df146756 249 }
mbed_official 76:aeb1df146756 250
mbed_official 76:aeb1df146756 251 void spi_slave_write(spi_t *obj, int value) {
mbed_official 76:aeb1df146756 252 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 76:aeb1df146756 253 while (!ssp_writeable(obj));
mbed_official 76:aeb1df146756 254 SPI_I2S_SendData(spi, (uint16_t)value);
mbed_official 76:aeb1df146756 255 }
mbed_official 76:aeb1df146756 256
mbed_official 76:aeb1df146756 257 int spi_busy(spi_t *obj) {
mbed_official 76:aeb1df146756 258 return ssp_busy(obj);
mbed_official 76:aeb1df146756 259 }
mbed_official 76:aeb1df146756 260
mbed_official 76:aeb1df146756 261 #endif