git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1248 35acf78f-673a-0410-8e92-d51de3d6d3f4

2 files changed, 235 insertions, 0 deletions

diff --git a/os/io/spi.c b/os/io/spi.c
new file mode 100644
index 000000000..7060c693d
--- /dev/null
+++ b/os/io/spi.c
@@ -0,0 +1,184 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file spi.c

+ * @brief SPI Driver code.

+ * @addtogroup SPI

+ * @{

+ */

+

+#include <ch.h>

+#include <spi.h>

+

+/*

+ * The following macros are used to enforce a correct sequence of operations

+ * when the OS asserts are enabled. The overhead is removed when not in debug

+ * mode.
+ */

+#ifdef CH_DBG_ENABLE_ASSERTS

+#define SPI_SET_STATE(spip, sts) (spip)->spd_state = (sts)

+#else

+#define SPI_SET_STATE(spip, sts)

+#endif

+

+/**

+ * @brief SPI Driver initialization.

+ */

+void spiInit(void) {

+

+  spi_lld_init();

+}

+

+/**

+ * @brief Initializes the standard part of a @p SPIDriver structure.

+ *

+ * @param[in] spip pointer to the @p SPIDriver object

+ */

+void spiObjectInit(SPIDriver *spip) {

+

+  SPI_SET_STATE(spip, SPI_IDLE);

+#if CH_USE_MUTEXES

+  chMtxInit(&spip->spd_mutex);

+#elif CH_USE_SEMAPHORES

+  chSemInit(&spip->spd_semaphore, 1);

+#endif

+  spip->spd_config = NULL;

+}

+

+/**

+ * @brief Configures the SPI bus.

+ *

+ * @param[in] spip pointer to the @p SPIDriver object

+ * @param config pointer to the @p SPIConfig object

+ */

+void spiSetup(SPIDriver *spip, const SPIConfig *config) {

+

+  chDbgAssert(spip->spd_state == SPI_IDLE,

+              "spiSetup(), #1",

+              "not idle");

+

+  spip->spd_config = config;

+  spi_lld_setup(spip);

+}

+

+/**

+ * @brief Asserts the chip select signal and prepares for transfers.

+ * @details The SPI bus is configured and a peripheral selected.

+ *
+ * @param[in] spip pointer to the @p SPIDriver object

+ * @param config pointer to the @p SPIConfig object
+ */

+void spiSelect(SPIDriver *spip) {

+

+  chSysLock();

+

+  chDbgAssert(spip->spd_state == SPI_IDLE,

+              "spiSelect(), #1",

+              "not idle");

+

+  spi_lld_select(spip);

+  SPI_SET_STATE(spip, SPI_ACTIVE);

+  chSysUnlock();

+}

+

+/**

+ * @brief De-asserts the chip select signal.

+ * @details The previously selected peripheral is unselected.

+ *
+ * @param[in] spip pointer to the @p SPIDriver object

+ */

+void spiUnselect(SPIDriver *spip) {

+

+  chSysLock();

+

+  chDbgAssert(spip->spd_state == SPI_ACTIVE,

+              "spiUnselect(), #1",

+              "not locked");

+

+  spi_lld_unselect(spip);

+  SPI_SET_STATE(spip, SPI_IDLE);

+  chSysUnlock();

+}

+

+/**

+ * @brief Exchanges data on the SPI bus.

+ * @details This function performs a simultaneous transmit/receive operation.

+ *
+ * @param[in] spip pointer to the @p SPIDriver object

+ * @param n number of words to be exchanged
+ * @param rxbuf the pointer to the receive buffer, if @p NULL is specified then

+ *              the input data is discarded.

+ *              Note that the buffer is organized as an uint8_t array for

+ *              data sizes below or equal to 8 bits else it is organized as

+ *              an uint16_t array.

+ * @param txbuf the pointer to the transmit buffer, if @p NULL is specified all

+ *              ones are transmitted.

+ *              Note that the buffer is organized as an uint8_t array for

+ *              data sizes below or equal to 8 bits else it is organized as

+ *              an uint16_t array.
+ */

+void spiExchange(SPIDriver *spip, size_t n, void *rxbuf, void *txbuf) {

+

+  chDbgAssert(spip->spd_state == SPI_ACTIVE,

+              "spiExchange(), #1",

+              "not active");

+

+  spi_lld_exchange(spip, n, rxbuf, txbuf);

+}

+

+#if SPI_USE_MUTUAL_EXCLUSION || defined(__DOXYGEN__)

+/**

+ * @brief Gains exclusive access to the SPI bus.

+ * @details This function tries to gain ownership to the SPI bus, if the bus

+ *          is already being used then the invoking thread is queued.

+ *

+ * @param[in] spip pointer to the @p SPIDriver object

+ *

+ * @note This function is only available when the @p SPI_USE_MUTUAL_EXCLUSION

+ *       option is set to @p TRUE.

+ */

+void spiAcquireBus(SPIDriver *spip) {

+

+#if CH_USE_MUTEXES

+  chMtxLock(&spip->spd_mutex);

+#elif CH_USE_SEMAPHORES

+  chSemWait(&spip->spd_semaphore);

+#endif

+}

+

+/**

+ * @brief Releases exclusive access to the SPI bus.

+ *

+ * @param[in] spip pointer to the @p SPIDriver object

+ *

+ * @note This function is only available when the @p SPI_USE_MUTUAL_EXCLUSION

+ *       option is set to @p TRUE.

+ */

+void spiReleaseBus(SPIDriver *spip) {

+

+#if CH_USE_MUTEXES

+  chMtxUnlock();

+#elif CH_USE_SEMAPHORES

+  chSemSignal(&spip->spd_semaphore);

+#endif

+}

+#endif /*SPI_USE_MUTUAL_EXCLUSION */

+

+/** @} */

diff --git a/os/io/spi.h b/os/io/spi.h
new file mode 100644
index 000000000..bb4244944
--- /dev/null
+++ b/os/io/spi.h
@@ -0,0 +1,51 @@
+/*

+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.

+

+    This file is part of ChibiOS/RT.

+

+    ChibiOS/RT is free software; you can redistribute it and/or modify

+    it under the terms of the GNU General Public License as published by

+    the Free Software Foundation; either version 3 of the License, or

+    (at your option) any later version.

+

+    ChibiOS/RT is distributed in the hope that it will be useful,

+    but WITHOUT ANY WARRANTY; without even the implied warranty of

+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+    GNU General Public License for more details.

+

+    You should have received a copy of the GNU General Public License

+    along with this program.  If not, see <http://www.gnu.org/licenses/>.

+*/

+

+/**

+ * @file spi.h

+ * @brief SPI Driver macros and structures.

+ * @addtogroup SPI

+ * @{

+ */

+

+#ifndef _SPI_H_

+#define _SPI_H_

+

+#include "spi_lld.h"

+

+#ifdef __cplusplus

+extern "C" {

+#endif

+  void spiInit(void);

+  void spiObjectInit(SPIDriver *spip);

+  void spiSetup(SPIDriver *spip, const SPIConfig *config);

+  void spiSelect(SPIDriver *spip);

+  void spiUnselect(SPIDriver *spip);

+  void spiExchange(SPIDriver *spip, size_t n, void *rxbuf, void *txbuf);

+#if SPI_USE_MUTUAL_EXCLUSION

+  void spiAcquireBus(SPIDriver *spip);

+  void spiReleaseBus(SPIDriver *spip);

+#endif /* SPI_USE_MUTUAL_EXCLUSION */

+#ifdef __cplusplus

+}

+#endif

+

+#endif /* _SPI_H_ */

+

+/** @} */