takashi kadono / Mbed OS Nucleo_446

Color Oled(SSD1331) connect to STMicroelectronics Nucleo-F466

Dependencies:   ssd1331

mbed-os/drivers/SPI.cpp@3:f3764f852aa8, 2018-10-11 (annotated)

Committer:
kadonotakashi
Date:
Thu Oct 11 02:27:46 2018 +0000
Revision:
3:f3764f852aa8
Parent:
0:8fdf9a60065b 
Nucreo 446 + SSD1331 test version;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
kadonotakashi 0:8fdf9a60065b 1 /* mbed Microcontroller Library
kadonotakashi 0:8fdf9a60065b 2 * Copyright (c) 2006-2013 ARM Limited
kadonotakashi 0:8fdf9a60065b 3 *
kadonotakashi 0:8fdf9a60065b 4 * Licensed under the Apache License, Version 2.0 (the "License");
kadonotakashi 0:8fdf9a60065b 5 * you may not use this file except in compliance with the License.
kadonotakashi 0:8fdf9a60065b 6 * You may obtain a copy of the License at
kadonotakashi 0:8fdf9a60065b 7 *
kadonotakashi 0:8fdf9a60065b 8 * http://www.apache.org/licenses/LICENSE-2.0
kadonotakashi 0:8fdf9a60065b 9 *
kadonotakashi 0:8fdf9a60065b 10 * Unless required by applicable law or agreed to in writing, software
kadonotakashi 0:8fdf9a60065b 11 * distributed under the License is distributed on an "AS IS" BASIS,
kadonotakashi 0:8fdf9a60065b 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
kadonotakashi 0:8fdf9a60065b 13 * See the License for the specific language governing permissions and
kadonotakashi 0:8fdf9a60065b 14 * limitations under the License.
kadonotakashi 0:8fdf9a60065b 15 */
kadonotakashi 0:8fdf9a60065b 16 #include "drivers/SPI.h"
kadonotakashi 0:8fdf9a60065b 17 #include "platform/mbed_critical.h"
kadonotakashi 0:8fdf9a60065b 18
kadonotakashi 0:8fdf9a60065b 19 #if DEVICE_SPI_ASYNCH
kadonotakashi 0:8fdf9a60065b 20 #include "platform/mbed_power_mgmt.h"
kadonotakashi 0:8fdf9a60065b 21 #endif
kadonotakashi 0:8fdf9a60065b 22
kadonotakashi 0:8fdf9a60065b 23 #if DEVICE_SPI
kadonotakashi 0:8fdf9a60065b 24
kadonotakashi 0:8fdf9a60065b 25 namespace mbed {
kadonotakashi 0:8fdf9a60065b 26
kadonotakashi 0:8fdf9a60065b 27 #if DEVICE_SPI_ASYNCH && TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 28 CircularBuffer<Transaction<SPI>, TRANSACTION_QUEUE_SIZE_SPI> SPI::_transaction_buffer;
kadonotakashi 0:8fdf9a60065b 29 #endif
kadonotakashi 0:8fdf9a60065b 30
kadonotakashi 0:8fdf9a60065b 31 SPI::SPI(PinName mosi, PinName miso, PinName sclk, PinName ssel) :
kadonotakashi 0:8fdf9a60065b 32 _spi(),
kadonotakashi 0:8fdf9a60065b 33 #if DEVICE_SPI_ASYNCH
kadonotakashi 0:8fdf9a60065b 34 _irq(this),
kadonotakashi 0:8fdf9a60065b 35 _usage(DMA_USAGE_NEVER),
kadonotakashi 0:8fdf9a60065b 36 _deep_sleep_locked(false),
kadonotakashi 0:8fdf9a60065b 37 #endif
kadonotakashi 0:8fdf9a60065b 38 _bits(8),
kadonotakashi 0:8fdf9a60065b 39 _mode(0),
kadonotakashi 0:8fdf9a60065b 40 _hz(1000000),
kadonotakashi 0:8fdf9a60065b 41 _write_fill(SPI_FILL_CHAR)
kadonotakashi 0:8fdf9a60065b 42 {
kadonotakashi 0:8fdf9a60065b 43 // No lock needed in the constructor
kadonotakashi 0:8fdf9a60065b 44 spi_init(&_spi, mosi, miso, sclk, ssel);
kadonotakashi 0:8fdf9a60065b 45 }
kadonotakashi 0:8fdf9a60065b 46
kadonotakashi 0:8fdf9a60065b 47 SPI::~SPI()
kadonotakashi 0:8fdf9a60065b 48 {
kadonotakashi 0:8fdf9a60065b 49 if (_owner == this) {
kadonotakashi 0:8fdf9a60065b 50 _owner = NULL;
kadonotakashi 0:8fdf9a60065b 51 }
kadonotakashi 0:8fdf9a60065b 52 }
kadonotakashi 0:8fdf9a60065b 53
kadonotakashi 0:8fdf9a60065b 54 void SPI::format(int bits, int mode)
kadonotakashi 0:8fdf9a60065b 55 {
kadonotakashi 0:8fdf9a60065b 56 lock();
kadonotakashi 0:8fdf9a60065b 57 _bits = bits;
kadonotakashi 0:8fdf9a60065b 58 _mode = mode;
kadonotakashi 0:8fdf9a60065b 59 // If changing format while you are the owner then just
kadonotakashi 0:8fdf9a60065b 60 // update format, but if owner is changed then even frequency should be
kadonotakashi 0:8fdf9a60065b 61 // updated which is done by acquire.
kadonotakashi 0:8fdf9a60065b 62 if (_owner == this) {
kadonotakashi 0:8fdf9a60065b 63 spi_format(&_spi, _bits, _mode, 0);
kadonotakashi 0:8fdf9a60065b 64 } else {
kadonotakashi 0:8fdf9a60065b 65 _acquire();
kadonotakashi 0:8fdf9a60065b 66 }
kadonotakashi 0:8fdf9a60065b 67 unlock();
kadonotakashi 0:8fdf9a60065b 68 }
kadonotakashi 0:8fdf9a60065b 69
kadonotakashi 0:8fdf9a60065b 70 void SPI::frequency(int hz)
kadonotakashi 0:8fdf9a60065b 71 {
kadonotakashi 0:8fdf9a60065b 72 lock();
kadonotakashi 0:8fdf9a60065b 73 _hz = hz;
kadonotakashi 0:8fdf9a60065b 74 // If changing format while you are the owner then just
kadonotakashi 0:8fdf9a60065b 75 // update frequency, but if owner is changed then even frequency should be
kadonotakashi 0:8fdf9a60065b 76 // updated which is done by acquire.
kadonotakashi 0:8fdf9a60065b 77 if (_owner == this) {
kadonotakashi 0:8fdf9a60065b 78 spi_frequency(&_spi, _hz);
kadonotakashi 0:8fdf9a60065b 79 } else {
kadonotakashi 0:8fdf9a60065b 80 _acquire();
kadonotakashi 0:8fdf9a60065b 81 }
kadonotakashi 0:8fdf9a60065b 82 unlock();
kadonotakashi 0:8fdf9a60065b 83 }
kadonotakashi 0:8fdf9a60065b 84
kadonotakashi 0:8fdf9a60065b 85 SPI *SPI::_owner = NULL;
kadonotakashi 0:8fdf9a60065b 86 SingletonPtr<PlatformMutex> SPI::_mutex;
kadonotakashi 0:8fdf9a60065b 87
kadonotakashi 0:8fdf9a60065b 88 // ignore the fact there are multiple physical spis, and always update if it wasn't us last
kadonotakashi 0:8fdf9a60065b 89 void SPI::aquire()
kadonotakashi 0:8fdf9a60065b 90 {
kadonotakashi 0:8fdf9a60065b 91 lock();
kadonotakashi 0:8fdf9a60065b 92 if (_owner != this) {
kadonotakashi 0:8fdf9a60065b 93 spi_format(&_spi, _bits, _mode, 0);
kadonotakashi 0:8fdf9a60065b 94 spi_frequency(&_spi, _hz);
kadonotakashi 0:8fdf9a60065b 95 _owner = this;
kadonotakashi 0:8fdf9a60065b 96 }
kadonotakashi 0:8fdf9a60065b 97 unlock();
kadonotakashi 0:8fdf9a60065b 98 }
kadonotakashi 0:8fdf9a60065b 99
kadonotakashi 0:8fdf9a60065b 100 // Note: Private function with no locking
kadonotakashi 0:8fdf9a60065b 101 void SPI::_acquire()
kadonotakashi 0:8fdf9a60065b 102 {
kadonotakashi 0:8fdf9a60065b 103 if (_owner != this) {
kadonotakashi 0:8fdf9a60065b 104 spi_format(&_spi, _bits, _mode, 0);
kadonotakashi 0:8fdf9a60065b 105 spi_frequency(&_spi, _hz);
kadonotakashi 0:8fdf9a60065b 106 _owner = this;
kadonotakashi 0:8fdf9a60065b 107 }
kadonotakashi 0:8fdf9a60065b 108 }
kadonotakashi 0:8fdf9a60065b 109
kadonotakashi 0:8fdf9a60065b 110 int SPI::write(int value)
kadonotakashi 0:8fdf9a60065b 111 {
kadonotakashi 0:8fdf9a60065b 112 lock();
kadonotakashi 0:8fdf9a60065b 113 _acquire();
kadonotakashi 0:8fdf9a60065b 114 int ret = spi_master_write(&_spi, value);
kadonotakashi 0:8fdf9a60065b 115 unlock();
kadonotakashi 0:8fdf9a60065b 116 return ret;
kadonotakashi 0:8fdf9a60065b 117 }
kadonotakashi 0:8fdf9a60065b 118
kadonotakashi 0:8fdf9a60065b 119 int SPI::write(const char *tx_buffer, int tx_length, char *rx_buffer, int rx_length)
kadonotakashi 0:8fdf9a60065b 120 {
kadonotakashi 0:8fdf9a60065b 121 lock();
kadonotakashi 0:8fdf9a60065b 122 _acquire();
kadonotakashi 0:8fdf9a60065b 123 int ret = spi_master_block_write(&_spi, tx_buffer, tx_length, rx_buffer, rx_length, _write_fill);
kadonotakashi 0:8fdf9a60065b 124 unlock();
kadonotakashi 0:8fdf9a60065b 125 return ret;
kadonotakashi 0:8fdf9a60065b 126 }
kadonotakashi 0:8fdf9a60065b 127
kadonotakashi 0:8fdf9a60065b 128 void SPI::lock()
kadonotakashi 0:8fdf9a60065b 129 {
kadonotakashi 0:8fdf9a60065b 130 _mutex->lock();
kadonotakashi 0:8fdf9a60065b 131 }
kadonotakashi 0:8fdf9a60065b 132
kadonotakashi 0:8fdf9a60065b 133 void SPI::unlock()
kadonotakashi 0:8fdf9a60065b 134 {
kadonotakashi 0:8fdf9a60065b 135 _mutex->unlock();
kadonotakashi 0:8fdf9a60065b 136 }
kadonotakashi 0:8fdf9a60065b 137
kadonotakashi 0:8fdf9a60065b 138 void SPI::set_default_write_value(char data)
kadonotakashi 0:8fdf9a60065b 139 {
kadonotakashi 0:8fdf9a60065b 140 lock();
kadonotakashi 0:8fdf9a60065b 141 _write_fill = data;
kadonotakashi 0:8fdf9a60065b 142 unlock();
kadonotakashi 0:8fdf9a60065b 143 }
kadonotakashi 0:8fdf9a60065b 144
kadonotakashi 0:8fdf9a60065b 145 #if DEVICE_SPI_ASYNCH
kadonotakashi 0:8fdf9a60065b 146
kadonotakashi 0:8fdf9a60065b 147 int SPI::transfer(const void *tx_buffer, int tx_length, void *rx_buffer, int rx_length, unsigned char bit_width, const event_callback_t &callback, int event)
kadonotakashi 0:8fdf9a60065b 148 {
kadonotakashi 0:8fdf9a60065b 149 if (spi_active(&_spi)) {
kadonotakashi 0:8fdf9a60065b 150 return queue_transfer(tx_buffer, tx_length, rx_buffer, rx_length, bit_width, callback, event);
kadonotakashi 0:8fdf9a60065b 151 }
kadonotakashi 0:8fdf9a60065b 152 start_transfer(tx_buffer, tx_length, rx_buffer, rx_length, bit_width, callback, event);
kadonotakashi 0:8fdf9a60065b 153 return 0;
kadonotakashi 0:8fdf9a60065b 154 }
kadonotakashi 0:8fdf9a60065b 155
kadonotakashi 0:8fdf9a60065b 156 void SPI::abort_transfer()
kadonotakashi 0:8fdf9a60065b 157 {
kadonotakashi 0:8fdf9a60065b 158 spi_abort_asynch(&_spi);
kadonotakashi 0:8fdf9a60065b 159 unlock_deep_sleep();
kadonotakashi 0:8fdf9a60065b 160 #if TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 161 dequeue_transaction();
kadonotakashi 0:8fdf9a60065b 162 #endif
kadonotakashi 0:8fdf9a60065b 163 }
kadonotakashi 0:8fdf9a60065b 164
kadonotakashi 0:8fdf9a60065b 165
kadonotakashi 0:8fdf9a60065b 166 void SPI::clear_transfer_buffer()
kadonotakashi 0:8fdf9a60065b 167 {
kadonotakashi 0:8fdf9a60065b 168 #if TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 169 _transaction_buffer.reset();
kadonotakashi 0:8fdf9a60065b 170 #endif
kadonotakashi 0:8fdf9a60065b 171 }
kadonotakashi 0:8fdf9a60065b 172
kadonotakashi 0:8fdf9a60065b 173 void SPI::abort_all_transfers()
kadonotakashi 0:8fdf9a60065b 174 {
kadonotakashi 0:8fdf9a60065b 175 clear_transfer_buffer();
kadonotakashi 0:8fdf9a60065b 176 abort_transfer();
kadonotakashi 0:8fdf9a60065b 177 }
kadonotakashi 0:8fdf9a60065b 178
kadonotakashi 0:8fdf9a60065b 179 int SPI::set_dma_usage(DMAUsage usage)
kadonotakashi 0:8fdf9a60065b 180 {
kadonotakashi 0:8fdf9a60065b 181 if (spi_active(&_spi)) {
kadonotakashi 0:8fdf9a60065b 182 return -1;
kadonotakashi 0:8fdf9a60065b 183 }
kadonotakashi 0:8fdf9a60065b 184 _usage = usage;
kadonotakashi 0:8fdf9a60065b 185 return 0;
kadonotakashi 0:8fdf9a60065b 186 }
kadonotakashi 0:8fdf9a60065b 187
kadonotakashi 0:8fdf9a60065b 188 int SPI::queue_transfer(const void *tx_buffer, int tx_length, void *rx_buffer, int rx_length, unsigned char bit_width, const event_callback_t &callback, int event)
kadonotakashi 0:8fdf9a60065b 189 {
kadonotakashi 0:8fdf9a60065b 190 #if TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 191 transaction_t t;
kadonotakashi 0:8fdf9a60065b 192
kadonotakashi 0:8fdf9a60065b 193 t.tx_buffer = const_cast<void *>(tx_buffer);
kadonotakashi 0:8fdf9a60065b 194 t.tx_length = tx_length;
kadonotakashi 0:8fdf9a60065b 195 t.rx_buffer = rx_buffer;
kadonotakashi 0:8fdf9a60065b 196 t.rx_length = rx_length;
kadonotakashi 0:8fdf9a60065b 197 t.event = event;
kadonotakashi 0:8fdf9a60065b 198 t.callback = callback;
kadonotakashi 0:8fdf9a60065b 199 t.width = bit_width;
kadonotakashi 0:8fdf9a60065b 200 Transaction<SPI> transaction(this, t);
kadonotakashi 0:8fdf9a60065b 201 if (_transaction_buffer.full()) {
kadonotakashi 0:8fdf9a60065b 202 return -1; // the buffer is full
kadonotakashi 0:8fdf9a60065b 203 } else {
kadonotakashi 0:8fdf9a60065b 204 core_util_critical_section_enter();
kadonotakashi 0:8fdf9a60065b 205 _transaction_buffer.push(transaction);
kadonotakashi 0:8fdf9a60065b 206 if (!spi_active(&_spi)) {
kadonotakashi 0:8fdf9a60065b 207 dequeue_transaction();
kadonotakashi 0:8fdf9a60065b 208 }
kadonotakashi 0:8fdf9a60065b 209 core_util_critical_section_exit();
kadonotakashi 0:8fdf9a60065b 210 return 0;
kadonotakashi 0:8fdf9a60065b 211 }
kadonotakashi 0:8fdf9a60065b 212 #else
kadonotakashi 0:8fdf9a60065b 213 return -1;
kadonotakashi 0:8fdf9a60065b 214 #endif
kadonotakashi 0:8fdf9a60065b 215 }
kadonotakashi 0:8fdf9a60065b 216
kadonotakashi 0:8fdf9a60065b 217 void SPI::start_transfer(const void *tx_buffer, int tx_length, void *rx_buffer, int rx_length, unsigned char bit_width, const event_callback_t &callback, int event)
kadonotakashi 0:8fdf9a60065b 218 {
kadonotakashi 0:8fdf9a60065b 219 lock_deep_sleep();
kadonotakashi 0:8fdf9a60065b 220 _acquire();
kadonotakashi 0:8fdf9a60065b 221 _callback = callback;
kadonotakashi 0:8fdf9a60065b 222 _irq.callback(&SPI::irq_handler_asynch);
kadonotakashi 0:8fdf9a60065b 223 spi_master_transfer(&_spi, tx_buffer, tx_length, rx_buffer, rx_length, bit_width, _irq.entry(), event, _usage);
kadonotakashi 0:8fdf9a60065b 224 }
kadonotakashi 0:8fdf9a60065b 225
kadonotakashi 0:8fdf9a60065b 226 void SPI::lock_deep_sleep()
kadonotakashi 0:8fdf9a60065b 227 {
kadonotakashi 0:8fdf9a60065b 228 if (_deep_sleep_locked == false) {
kadonotakashi 0:8fdf9a60065b 229 sleep_manager_lock_deep_sleep();
kadonotakashi 0:8fdf9a60065b 230 _deep_sleep_locked = true;
kadonotakashi 0:8fdf9a60065b 231 }
kadonotakashi 0:8fdf9a60065b 232 }
kadonotakashi 0:8fdf9a60065b 233
kadonotakashi 0:8fdf9a60065b 234 void SPI::unlock_deep_sleep()
kadonotakashi 0:8fdf9a60065b 235 {
kadonotakashi 0:8fdf9a60065b 236 if (_deep_sleep_locked == true) {
kadonotakashi 0:8fdf9a60065b 237 sleep_manager_unlock_deep_sleep();
kadonotakashi 0:8fdf9a60065b 238 _deep_sleep_locked = false;
kadonotakashi 0:8fdf9a60065b 239 }
kadonotakashi 0:8fdf9a60065b 240 }
kadonotakashi 0:8fdf9a60065b 241
kadonotakashi 0:8fdf9a60065b 242 #if TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 243
kadonotakashi 0:8fdf9a60065b 244 void SPI::start_transaction(transaction_t *data)
kadonotakashi 0:8fdf9a60065b 245 {
kadonotakashi 0:8fdf9a60065b 246 start_transfer(data->tx_buffer, data->tx_length, data->rx_buffer, data->rx_length, data->width, data->callback, data->event);
kadonotakashi 0:8fdf9a60065b 247 }
kadonotakashi 0:8fdf9a60065b 248
kadonotakashi 0:8fdf9a60065b 249 void SPI::dequeue_transaction()
kadonotakashi 0:8fdf9a60065b 250 {
kadonotakashi 0:8fdf9a60065b 251 Transaction<SPI> t;
kadonotakashi 0:8fdf9a60065b 252 if (_transaction_buffer.pop(t)) {
kadonotakashi 0:8fdf9a60065b 253 SPI *obj = t.get_object();
kadonotakashi 0:8fdf9a60065b 254 transaction_t *data = t.get_transaction();
kadonotakashi 0:8fdf9a60065b 255 obj->start_transaction(data);
kadonotakashi 0:8fdf9a60065b 256 }
kadonotakashi 0:8fdf9a60065b 257 }
kadonotakashi 0:8fdf9a60065b 258
kadonotakashi 0:8fdf9a60065b 259 #endif
kadonotakashi 0:8fdf9a60065b 260
kadonotakashi 0:8fdf9a60065b 261 void SPI::irq_handler_asynch(void)
kadonotakashi 0:8fdf9a60065b 262 {
kadonotakashi 0:8fdf9a60065b 263 int event = spi_irq_handler_asynch(&_spi);
kadonotakashi 0:8fdf9a60065b 264 if (_callback && (event & SPI_EVENT_ALL)) {
kadonotakashi 0:8fdf9a60065b 265 unlock_deep_sleep();
kadonotakashi 0:8fdf9a60065b 266 _callback.call(event & SPI_EVENT_ALL);
kadonotakashi 0:8fdf9a60065b 267 }
kadonotakashi 0:8fdf9a60065b 268 #if TRANSACTION_QUEUE_SIZE_SPI
kadonotakashi 0:8fdf9a60065b 269 if (event & (SPI_EVENT_ALL | SPI_EVENT_INTERNAL_TRANSFER_COMPLETE)) {
kadonotakashi 0:8fdf9a60065b 270 // SPI peripheral is free (event happened), dequeue transaction
kadonotakashi 0:8fdf9a60065b 271 dequeue_transaction();
kadonotakashi 0:8fdf9a60065b 272 }
kadonotakashi 0:8fdf9a60065b 273 #endif
kadonotakashi 0:8fdf9a60065b 274 }
kadonotakashi 0:8fdf9a60065b 275
kadonotakashi 0:8fdf9a60065b 276 #endif
kadonotakashi 0:8fdf9a60065b 277
kadonotakashi 0:8fdf9a60065b 278 } // namespace mbed
kadonotakashi 0:8fdf9a60065b 279
kadonotakashi 0:8fdf9a60065b 280 #endif