Jeroen van Zoeren / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Ophaalbrug-dev

Fork of mbed-dev by mbed official

targets/hal/TARGET_STM/TARGET_STM32L0/spi_api.c@46:b2af06471858, 2016-01-14 (annotated)

Committer:
jeroenvz
Date:
Thu Jan 14 18:52:28 2016 +0000
Revision:
46:b2af06471858
Parent:
0:9b334a45a8ff 
- LPCXpresso Interrupt fix

Who changed what in which revision?

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