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_F401RE/spi_api.c@87:085cde657901, 2014-02-08 (annotated)

Committer:
mbed_official
Date:
Sat Feb 08 19:45:06 2014 +0000
Revision:
87:085cde657901
Child:
88:81f18c97d490
Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2



Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/



Add NUCLEO_F401RE, improvements

Who changed what in which revision?

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