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@80:66393a7b209d, 2014-01-30 (annotated)

Committer:
mbed_official
Date:
Thu Jan 30 12:15:05 2014 +0000
Revision:
80:66393a7b209d
Parent:
76:aeb1df146756
Child:
84:f54042cbc282
Synchronized with git revision dba523f83fe09b7fce11fc1299dd1216e9776359



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



Update of I2C, SPI, SLEEP for NUCLEO_F103RB and 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 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 76:aeb1df146756 117 obj->br_presc = SPI_BaudRatePrescaler_64; // Closest to 1MHz (72MHz/64 = 1.125MHz)
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 76:aeb1df146756 179 uint32_t PCLK = SystemCoreClock >> 1;
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