gabriel della-monica / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_DISCO_L053C8/spi_api.c@439:c4382fcbbaed, 2014-12-15 (annotated)

Committer:
mbed_official
Date:
Mon Dec 15 09:30:07 2014 +0000
Revision:
439:c4382fcbbaed
Parent:
376:cb4d9db17537 
Synchronized with git revision 6172cbea1a558a9a2ebbd965e77f83a9ceeec670



Full URL: https://github.com/mbedmicro/mbed/commit/6172cbea1a558a9a2ebbd965e77f83a9ceeec670/



Targets: DISCO_L053C8 - update from nucleo latest changes

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 376:cb4d9db17537 1 /* mbed Microcontroller Library
mbed_official 376:cb4d9db17537 2 *******************************************************************************
mbed_official 376:cb4d9db17537 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 376:cb4d9db17537 4 * All rights reserved.
mbed_official 376:cb4d9db17537 5 *
mbed_official 376:cb4d9db17537 6 * Redistribution and use in source and binary forms, with or without
mbed_official 376:cb4d9db17537 7 * modification, are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 8 *
mbed_official 376:cb4d9db17537 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 10 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 13 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 15 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 16 * without specific prior written permission.
mbed_official 376:cb4d9db17537 17 *
mbed_official 376:cb4d9db17537 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 28 *******************************************************************************
mbed_official 376:cb4d9db17537 29 */
mbed_official 376:cb4d9db17537 30 #include "mbed_assert.h"
mbed_official 376:cb4d9db17537 31 #include "spi_api.h"
mbed_official 376:cb4d9db17537 32
mbed_official 376:cb4d9db17537 33 #if DEVICE_SPI
mbed_official 376:cb4d9db17537 34
mbed_official 376:cb4d9db17537 35 #include <math.h>
mbed_official 376:cb4d9db17537 36 #include "cmsis.h"
mbed_official 376:cb4d9db17537 37 #include "pinmap.h"
mbed_official 439:c4382fcbbaed 38 #include "PeripheralPins.h"
mbed_official 376:cb4d9db17537 39
mbed_official 376:cb4d9db17537 40 static SPI_HandleTypeDef SpiHandle;
mbed_official 376:cb4d9db17537 41
mbed_official 439:c4382fcbbaed 42 static void init_spi(spi_t *obj)
mbed_official 439:c4382fcbbaed 43 {
mbed_official 376:cb4d9db17537 44 SpiHandle.Instance = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 45
mbed_official 376:cb4d9db17537 46 __HAL_SPI_DISABLE(&SpiHandle);
mbed_official 376:cb4d9db17537 47
mbed_official 376:cb4d9db17537 48 SpiHandle.Init.Mode = obj->mode;
mbed_official 376:cb4d9db17537 49 SpiHandle.Init.BaudRatePrescaler = obj->br_presc;
mbed_official 376:cb4d9db17537 50 SpiHandle.Init.Direction = SPI_DIRECTION_2LINES;
mbed_official 376:cb4d9db17537 51 SpiHandle.Init.CLKPhase = obj->cpha;
mbed_official 376:cb4d9db17537 52 SpiHandle.Init.CLKPolarity = obj->cpol;
mbed_official 376:cb4d9db17537 53 SpiHandle.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLED;
mbed_official 376:cb4d9db17537 54 SpiHandle.Init.CRCPolynomial = 7;
mbed_official 376:cb4d9db17537 55 SpiHandle.Init.DataSize = obj->bits;
mbed_official 376:cb4d9db17537 56 SpiHandle.Init.FirstBit = SPI_FIRSTBIT_MSB;
mbed_official 376:cb4d9db17537 57 SpiHandle.Init.NSS = obj->nss;
mbed_official 376:cb4d9db17537 58 SpiHandle.Init.TIMode = SPI_TIMODE_DISABLED;
mbed_official 376:cb4d9db17537 59
mbed_official 376:cb4d9db17537 60 HAL_SPI_Init(&SpiHandle);
mbed_official 376:cb4d9db17537 61
mbed_official 376:cb4d9db17537 62 __HAL_SPI_ENABLE(&SpiHandle);
mbed_official 376:cb4d9db17537 63 }
mbed_official 376:cb4d9db17537 64
mbed_official 439:c4382fcbbaed 65 void spi_init(spi_t *obj, PinName mosi, PinName miso, PinName sclk, PinName ssel)
mbed_official 439:c4382fcbbaed 66 {
mbed_official 376:cb4d9db17537 67 // Determine the SPI to use
mbed_official 376:cb4d9db17537 68 SPIName spi_mosi = (SPIName)pinmap_peripheral(mosi, PinMap_SPI_MOSI);
mbed_official 376:cb4d9db17537 69 SPIName spi_miso = (SPIName)pinmap_peripheral(miso, PinMap_SPI_MISO);
mbed_official 376:cb4d9db17537 70 SPIName spi_sclk = (SPIName)pinmap_peripheral(sclk, PinMap_SPI_SCLK);
mbed_official 376:cb4d9db17537 71 SPIName spi_ssel = (SPIName)pinmap_peripheral(ssel, PinMap_SPI_SSEL);
mbed_official 376:cb4d9db17537 72
mbed_official 376:cb4d9db17537 73 SPIName spi_data = (SPIName)pinmap_merge(spi_mosi, spi_miso);
mbed_official 376:cb4d9db17537 74 SPIName spi_cntl = (SPIName)pinmap_merge(spi_sclk, spi_ssel);
mbed_official 376:cb4d9db17537 75
mbed_official 376:cb4d9db17537 76 obj->spi = (SPIName)pinmap_merge(spi_data, spi_cntl);
mbed_official 376:cb4d9db17537 77 MBED_ASSERT(obj->spi != (SPIName)NC);
mbed_official 376:cb4d9db17537 78
mbed_official 376:cb4d9db17537 79 // Enable SPI clock
mbed_official 376:cb4d9db17537 80 if (obj->spi == SPI_1) {
mbed_official 376:cb4d9db17537 81 __SPI1_CLK_ENABLE();
mbed_official 376:cb4d9db17537 82 }
mbed_official 376:cb4d9db17537 83 if (obj->spi == SPI_2) {
mbed_official 376:cb4d9db17537 84 __SPI2_CLK_ENABLE();
mbed_official 376:cb4d9db17537 85 }
mbed_official 376:cb4d9db17537 86
mbed_official 376:cb4d9db17537 87 // Configure the SPI pins
mbed_official 376:cb4d9db17537 88 pinmap_pinout(mosi, PinMap_SPI_MOSI);
mbed_official 376:cb4d9db17537 89 pinmap_pinout(miso, PinMap_SPI_MISO);
mbed_official 376:cb4d9db17537 90 pinmap_pinout(sclk, PinMap_SPI_SCLK);
mbed_official 376:cb4d9db17537 91
mbed_official 376:cb4d9db17537 92 // Save new values
mbed_official 376:cb4d9db17537 93 obj->bits = SPI_DATASIZE_8BIT;
mbed_official 376:cb4d9db17537 94 obj->cpol = SPI_POLARITY_LOW;
mbed_official 376:cb4d9db17537 95 obj->cpha = SPI_PHASE_1EDGE;
mbed_official 376:cb4d9db17537 96 obj->br_presc = SPI_BAUDRATEPRESCALER_256;
mbed_official 376:cb4d9db17537 97
mbed_official 376:cb4d9db17537 98 obj->pin_miso = miso;
mbed_official 376:cb4d9db17537 99 obj->pin_mosi = mosi;
mbed_official 376:cb4d9db17537 100 obj->pin_sclk = sclk;
mbed_official 376:cb4d9db17537 101 obj->pin_ssel = ssel;
mbed_official 376:cb4d9db17537 102
mbed_official 376:cb4d9db17537 103 if (ssel == NC) { // SW NSS Master mode
mbed_official 376:cb4d9db17537 104 obj->mode = SPI_MODE_MASTER;
mbed_official 376:cb4d9db17537 105 obj->nss = SPI_NSS_SOFT;
mbed_official 376:cb4d9db17537 106 } else { // Slave
mbed_official 376:cb4d9db17537 107 pinmap_pinout(ssel, PinMap_SPI_SSEL);
mbed_official 376:cb4d9db17537 108 obj->mode = SPI_MODE_SLAVE;
mbed_official 376:cb4d9db17537 109 obj->nss = SPI_NSS_HARD_INPUT;
mbed_official 376:cb4d9db17537 110 }
mbed_official 376:cb4d9db17537 111
mbed_official 376:cb4d9db17537 112 init_spi(obj);
mbed_official 376:cb4d9db17537 113 }
mbed_official 376:cb4d9db17537 114
mbed_official 439:c4382fcbbaed 115 void spi_free(spi_t *obj)
mbed_official 439:c4382fcbbaed 116 {
mbed_official 376:cb4d9db17537 117 // Reset SPI and disable clock
mbed_official 376:cb4d9db17537 118 if (obj->spi == SPI_1) {
mbed_official 376:cb4d9db17537 119 __SPI1_FORCE_RESET();
mbed_official 376:cb4d9db17537 120 __SPI1_RELEASE_RESET();
mbed_official 376:cb4d9db17537 121 __SPI1_CLK_DISABLE();
mbed_official 376:cb4d9db17537 122 }
mbed_official 376:cb4d9db17537 123
mbed_official 376:cb4d9db17537 124 if (obj->spi == SPI_2) {
mbed_official 376:cb4d9db17537 125 __SPI2_FORCE_RESET();
mbed_official 376:cb4d9db17537 126 __SPI2_RELEASE_RESET();
mbed_official 376:cb4d9db17537 127 __SPI2_CLK_DISABLE();
mbed_official 376:cb4d9db17537 128 }
mbed_official 376:cb4d9db17537 129
mbed_official 376:cb4d9db17537 130 // Configure GPIO
mbed_official 376:cb4d9db17537 131 pin_function(obj->pin_miso, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
mbed_official 376:cb4d9db17537 132 pin_function(obj->pin_mosi, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
mbed_official 376:cb4d9db17537 133 pin_function(obj->pin_sclk, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
mbed_official 376:cb4d9db17537 134 pin_function(obj->pin_ssel, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
mbed_official 376:cb4d9db17537 135 }
mbed_official 376:cb4d9db17537 136
mbed_official 439:c4382fcbbaed 137 void spi_format(spi_t *obj, int bits, int mode, int slave)
mbed_official 439:c4382fcbbaed 138 {
mbed_official 376:cb4d9db17537 139 // Save new values
mbed_official 376:cb4d9db17537 140 if (bits == 16) {
mbed_official 376:cb4d9db17537 141 obj->bits = SPI_DATASIZE_16BIT;
mbed_official 376:cb4d9db17537 142 } else {
mbed_official 376:cb4d9db17537 143 obj->bits = SPI_DATASIZE_8BIT;
mbed_official 376:cb4d9db17537 144 }
mbed_official 376:cb4d9db17537 145
mbed_official 376:cb4d9db17537 146 switch (mode) {
mbed_official 376:cb4d9db17537 147 case 0:
mbed_official 376:cb4d9db17537 148 obj->cpol = SPI_POLARITY_LOW;
mbed_official 376:cb4d9db17537 149 obj->cpha = SPI_PHASE_1EDGE;
mbed_official 376:cb4d9db17537 150 break;
mbed_official 376:cb4d9db17537 151 case 1:
mbed_official 376:cb4d9db17537 152 obj->cpol = SPI_POLARITY_LOW;
mbed_official 376:cb4d9db17537 153 obj->cpha = SPI_PHASE_2EDGE;
mbed_official 376:cb4d9db17537 154 break;
mbed_official 376:cb4d9db17537 155 case 2:
mbed_official 376:cb4d9db17537 156 obj->cpol = SPI_POLARITY_HIGH;
mbed_official 376:cb4d9db17537 157 obj->cpha = SPI_PHASE_1EDGE;
mbed_official 376:cb4d9db17537 158 break;
mbed_official 376:cb4d9db17537 159 default:
mbed_official 376:cb4d9db17537 160 obj->cpol = SPI_POLARITY_HIGH;
mbed_official 376:cb4d9db17537 161 obj->cpha = SPI_PHASE_2EDGE;
mbed_official 376:cb4d9db17537 162 break;
mbed_official 376:cb4d9db17537 163 }
mbed_official 376:cb4d9db17537 164
mbed_official 376:cb4d9db17537 165 if (slave == 0) {
mbed_official 376:cb4d9db17537 166 obj->mode = SPI_MODE_MASTER;
mbed_official 376:cb4d9db17537 167 obj->nss = SPI_NSS_SOFT;
mbed_official 376:cb4d9db17537 168 } else {
mbed_official 376:cb4d9db17537 169 obj->mode = SPI_MODE_SLAVE;
mbed_official 376:cb4d9db17537 170 obj->nss = SPI_NSS_HARD_INPUT;
mbed_official 376:cb4d9db17537 171 }
mbed_official 376:cb4d9db17537 172
mbed_official 376:cb4d9db17537 173 init_spi(obj);
mbed_official 376:cb4d9db17537 174 }
mbed_official 376:cb4d9db17537 175
mbed_official 439:c4382fcbbaed 176 void spi_frequency(spi_t *obj, int hz)
mbed_official 439:c4382fcbbaed 177 {
mbed_official 376:cb4d9db17537 178 // Note: The frequencies are obtained with SPI1 clock = 32 MHz (APB2 clock)
mbed_official 376:cb4d9db17537 179 if (hz < 250000) {
mbed_official 376:cb4d9db17537 180 obj->br_presc = SPI_BAUDRATEPRESCALER_256; // 125 kHz
mbed_official 376:cb4d9db17537 181 } else if ((hz >= 250000) && (hz < 500000)) {
mbed_official 376:cb4d9db17537 182 obj->br_presc = SPI_BAUDRATEPRESCALER_128; // 250 kHz
mbed_official 376:cb4d9db17537 183 } else if ((hz >= 500000) && (hz < 1000000)) {
mbed_official 376:cb4d9db17537 184 obj->br_presc = SPI_BAUDRATEPRESCALER_64; // 500 kHz
mbed_official 376:cb4d9db17537 185 } else if ((hz >= 1000000) && (hz < 2000000)) {
mbed_official 376:cb4d9db17537 186 obj->br_presc = SPI_BAUDRATEPRESCALER_32; // 1 MHz
mbed_official 376:cb4d9db17537 187 } else if ((hz >= 2000000) && (hz < 4000000)) {
mbed_official 376:cb4d9db17537 188 obj->br_presc = SPI_BAUDRATEPRESCALER_16; // 2 MHz
mbed_official 376:cb4d9db17537 189 } else if ((hz >= 4000000) && (hz < 8000000)) {
mbed_official 376:cb4d9db17537 190 obj->br_presc = SPI_BAUDRATEPRESCALER_8; // 4 MHz
mbed_official 376:cb4d9db17537 191 } else if ((hz >= 8000000) && (hz < 16000000)) {
mbed_official 376:cb4d9db17537 192 obj->br_presc = SPI_BAUDRATEPRESCALER_4; // 8 MHz
mbed_official 376:cb4d9db17537 193 } else { // >= 16000000
mbed_official 376:cb4d9db17537 194 obj->br_presc = SPI_BAUDRATEPRESCALER_2; // 16 MHz
mbed_official 376:cb4d9db17537 195 }
mbed_official 376:cb4d9db17537 196 init_spi(obj);
mbed_official 376:cb4d9db17537 197 }
mbed_official 376:cb4d9db17537 198
mbed_official 439:c4382fcbbaed 199 static inline int ssp_readable(spi_t *obj)
mbed_official 439:c4382fcbbaed 200 {
mbed_official 376:cb4d9db17537 201 int status;
mbed_official 376:cb4d9db17537 202 SpiHandle.Instance = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 203 // Check if data is received
mbed_official 376:cb4d9db17537 204 status = ((__HAL_SPI_GET_FLAG(&SpiHandle, SPI_FLAG_RXNE) != RESET) ? 1 : 0);
mbed_official 376:cb4d9db17537 205 return status;
mbed_official 376:cb4d9db17537 206 }
mbed_official 376:cb4d9db17537 207
mbed_official 439:c4382fcbbaed 208 static inline int ssp_writeable(spi_t *obj)
mbed_official 439:c4382fcbbaed 209 {
mbed_official 376:cb4d9db17537 210 int status;
mbed_official 376:cb4d9db17537 211 SpiHandle.Instance = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 212 // Check if data is transmitted
mbed_official 376:cb4d9db17537 213 status = ((__HAL_SPI_GET_FLAG(&SpiHandle, SPI_FLAG_TXE) != RESET) ? 1 : 0);
mbed_official 376:cb4d9db17537 214 return status;
mbed_official 376:cb4d9db17537 215 }
mbed_official 376:cb4d9db17537 216
mbed_official 439:c4382fcbbaed 217 static inline void ssp_write(spi_t *obj, int value)
mbed_official 439:c4382fcbbaed 218 {
mbed_official 376:cb4d9db17537 219 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 220 while (!ssp_writeable(obj));
mbed_official 376:cb4d9db17537 221 spi->DR = (uint16_t)value;
mbed_official 376:cb4d9db17537 222 }
mbed_official 376:cb4d9db17537 223
mbed_official 439:c4382fcbbaed 224 static inline int ssp_read(spi_t *obj)
mbed_official 439:c4382fcbbaed 225 {
mbed_official 376:cb4d9db17537 226 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 227 while (!ssp_readable(obj));
mbed_official 376:cb4d9db17537 228 return (int)spi->DR;
mbed_official 376:cb4d9db17537 229 }
mbed_official 376:cb4d9db17537 230
mbed_official 439:c4382fcbbaed 231 static inline int ssp_busy(spi_t *obj)
mbed_official 439:c4382fcbbaed 232 {
mbed_official 376:cb4d9db17537 233 int status;
mbed_official 376:cb4d9db17537 234 SpiHandle.Instance = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 235 status = ((__HAL_SPI_GET_FLAG(&SpiHandle, SPI_FLAG_BSY) != RESET) ? 1 : 0);
mbed_official 376:cb4d9db17537 236 return status;
mbed_official 376:cb4d9db17537 237 }
mbed_official 376:cb4d9db17537 238
mbed_official 439:c4382fcbbaed 239 int spi_master_write(spi_t *obj, int value)
mbed_official 439:c4382fcbbaed 240 {
mbed_official 376:cb4d9db17537 241 ssp_write(obj, value);
mbed_official 376:cb4d9db17537 242 return ssp_read(obj);
mbed_official 376:cb4d9db17537 243 }
mbed_official 376:cb4d9db17537 244
mbed_official 439:c4382fcbbaed 245 int spi_slave_receive(spi_t *obj)
mbed_official 439:c4382fcbbaed 246 {
mbed_official 376:cb4d9db17537 247 return (ssp_readable(obj) ? 1 : 0);
mbed_official 376:cb4d9db17537 248 };
mbed_official 376:cb4d9db17537 249
mbed_official 439:c4382fcbbaed 250 int spi_slave_read(spi_t *obj)
mbed_official 439:c4382fcbbaed 251 {
mbed_official 376:cb4d9db17537 252 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 253 while (!ssp_readable(obj));
mbed_official 376:cb4d9db17537 254 return (int)spi->DR;
mbed_official 376:cb4d9db17537 255 }
mbed_official 376:cb4d9db17537 256
mbed_official 439:c4382fcbbaed 257 void spi_slave_write(spi_t *obj, int value)
mbed_official 439:c4382fcbbaed 258 {
mbed_official 376:cb4d9db17537 259 SPI_TypeDef *spi = (SPI_TypeDef *)(obj->spi);
mbed_official 376:cb4d9db17537 260 while (!ssp_writeable(obj));
mbed_official 376:cb4d9db17537 261 spi->DR = (uint16_t)value;
mbed_official 376:cb4d9db17537 262 }
mbed_official 376:cb4d9db17537 263
mbed_official 439:c4382fcbbaed 264 int spi_busy(spi_t *obj)
mbed_official 439:c4382fcbbaed 265 {
mbed_official 376:cb4d9db17537 266 return ssp_busy(obj);
mbed_official 376:cb4d9db17537 267 }
mbed_official 376:cb4d9db17537 268
mbed_official 376:cb4d9db17537 269 #endif