From 82984e1b5543228cfc3bd8bb40aa69046bc613e8 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Tue, 13 Mar 2012 15:41:46 +0000 Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4038 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/src/i2s.c | 194 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 os/hal/src/i2s.c (limited to 'os/hal/src/i2s.c') diff --git a/os/hal/src/i2s.c b/os/hal/src/i2s.c new file mode 100644 index 000000000..4eecfffbf --- /dev/null +++ b/os/hal/src/i2s.c @@ -0,0 +1,194 @@ +/* + ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010, + 2011,2012 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 . +*/ + +/** + * @file i2s.c + * @brief I2S Driver code. + * + * @addtogroup I2S + * @{ + */ + +#include "ch.h" +#include "hal.h" + +#if HAL_USE_I2S || defined(__DOXYGEN__) + +/*===========================================================================*/ +/* Driver local definitions. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver exported variables. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver local variables. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver local functions. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver exported functions. */ +/*===========================================================================*/ + +/** + * @brief I2S Driver initialization. + * @note This function is implicitly invoked by @p halInit(), there is + * no need to explicitly initialize the driver. + * + * @init + */ +void i2sInit(void) { + + i2s_lld_init(); +} + +/** + * @brief Initializes the standard part of a @p I2SDriver structure. + * + * @param[out] i2sp pointer to the @p I2SDriver object + * + * @init + */ +void i2sObjectInit(I2SDriver *i2sp) { + + i2sp->state = I2S_STOP; + i2sp->config = NULL; +} + +/** + * @brief Configures and activates the I2S peripheral. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * @param[in] config pointer to the @p I2SConfig object + * + * @api + */ +void i2sStart(I2SDriver *i2sp, const I2SConfig *config) { + + chDbgCheck((i2sp != NULL) && (config != NULL), "i2sStart"); + + chSysLock(); + chDbgAssert((i2sp->state == I2S_STOP) || (i2sp->state == I2S_READY), + "i2sStart(), #1", "invalid state"); + i2sp->config = config; + i2s_lld_start(i2sp); + i2sp->state = I2S_READY; + chSysUnlock(); +} + +/** + * @brief Deactivates the I2S peripheral. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * + * @api + */ +void i2sStop(I2SDriver *i2sp) { + + chDbgCheck(i2sp != NULL, "i2sStop"); + + chSysLock(); + chDbgAssert((i2sp->state == I2S_STOP) || (i2sp->state == I2S_READY), + "i2sStop(), #1", "invalid state"); + i2s_lld_stop(i2sp); + i2sp->state = I2S_STOP; + chSysUnlock(); +} + +/** + * @brief Starts a I2S transmission. + * @details The transmission is started and it is executes until the specified + * buffer has entirely transmitted. + * @post A callback is invoked when the buffer has been fully transmitted. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * @param[in] n number of samples to send + * @param[in] txbuf the pointer to the transmit buffer + * + * @api + */ +void i2sStartSendOnce(I2SDriver *i2sp, size_t n, + const i2ssample_t *txbuf) { + + chDbgCheck((i2sp != NULL) && (n > 0) && (txbuf != NULL), + "i2sStartSendOnce"); + + chSysLock(); + chDbgAssert(i2sp->state == I2S_READY, "i2sStartSendOnce(), #1", + "not ready"); + i2sStartSendOnceI(i2sp, n, txbuf); + chSysUnlock(); +} + +/** + * @brief Starts a continuous I2S transmission. + * @details The transmission is started and it is executes continuously + * until @p i2sStopSend() has been explicitly invoked . + * @post A callback is invoked when the buffer has been half transmitted + * and fully transmitted. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * @param[in] n number of samples to send + * @param[in] txbuf the pointer to the transmit buffer + * + * @api + */ +void i2sStartSendContinuous(I2SDriver *i2sp, size_t n, + const i2ssample_t *txbuf) { + + chDbgCheck((i2sp != NULL) && (n > 0) && (txbuf != NULL), + "i2sStartSendContinuous"); + + chSysLock(); + chDbgAssert(i2sp->state == I2S_READY, "i2sStartSendContinuous(), #1", + "not ready"); + i2sStartSendContinuousI(i2sp, n, txbuf); + chSysUnlock(); +} + +/** + * @brief Stops the ongoing transmission. + * @details The ongoing transmission, if any, is stopped, if the driver + * was not transmitting the function does nothing. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * + * @api + */ +void i2sStopSend(I2SDriver *i2sp) { + + chDbgCheck((i2sp != NULL), "i2sStopSend"); + + chSysLock(); + chDbgAssert((i2sp->state == I2S_READY) || + (i2sp->state == I2S_ACTIVE) || + (i2sp->state == I2S_COMPLETE), + "i2sStopSend(), #1", "not ready"); + i2sStopSendI(i2sp); + chSysUnlock(); +} + +#endif /* HAL_USE_I2S */ + +/** @} */ -- cgit v1.2.3 From 3534921f053bb9ea25413e8b10424ad06ff9b677 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sat, 17 Mar 2012 14:21:45 +0000 Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4047 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/src/i2s.c | 58 ++++++++++++-------------------------------------------- 1 file changed, 12 insertions(+), 46 deletions(-) (limited to 'os/hal/src/i2s.c') diff --git a/os/hal/src/i2s.c b/os/hal/src/i2s.c index 4eecfffbf..e0c547847 100644 --- a/os/hal/src/i2s.c +++ b/os/hal/src/i2s.c @@ -117,75 +117,41 @@ void i2sStop(I2SDriver *i2sp) { } /** - * @brief Starts a I2S transmission. - * @details The transmission is started and it is executes until the specified - * buffer has entirely transmitted. - * @post A callback is invoked when the buffer has been fully transmitted. + * @brief Starts a I2S data exchange. * * @param[in] i2sp pointer to the @p I2SDriver object - * @param[in] n number of samples to send - * @param[in] txbuf the pointer to the transmit buffer * * @api */ -void i2sStartSendOnce(I2SDriver *i2sp, size_t n, - const i2ssample_t *txbuf) { +void i2sStartExchange(I2SDriver *i2sp) { - chDbgCheck((i2sp != NULL) && (n > 0) && (txbuf != NULL), - "i2sStartSendOnce"); + chDbgCheck(i2sp != NULL "i2sStartExchange"); chSysLock(); - chDbgAssert(i2sp->state == I2S_READY, "i2sStartSendOnce(), #1", - "not ready"); - i2sStartSendOnceI(i2sp, n, txbuf); + chDbgAssert(i2sp->state == I2S_READY, "i2sStartExchange(), #1", "not ready"); + i2sStartExchangeI(i2sp); chSysUnlock(); } /** - * @brief Starts a continuous I2S transmission. - * @details The transmission is started and it is executes continuously - * until @p i2sStopSend() has been explicitly invoked . - * @post A callback is invoked when the buffer has been half transmitted - * and fully transmitted. + * @brief Stops the ongoing data exchange. + * @details The ongoing data exchange, if any, is stopped, if the driver + * was not active the function does nothing. * * @param[in] i2sp pointer to the @p I2SDriver object - * @param[in] n number of samples to send - * @param[in] txbuf the pointer to the transmit buffer * * @api */ -void i2sStartSendContinuous(I2SDriver *i2sp, size_t n, - const i2ssample_t *txbuf) { +void i2sStopExchange(I2SDriver *i2sp) { - chDbgCheck((i2sp != NULL) && (n > 0) && (txbuf != NULL), - "i2sStartSendContinuous"); - - chSysLock(); - chDbgAssert(i2sp->state == I2S_READY, "i2sStartSendContinuous(), #1", - "not ready"); - i2sStartSendContinuousI(i2sp, n, txbuf); - chSysUnlock(); -} - -/** - * @brief Stops the ongoing transmission. - * @details The ongoing transmission, if any, is stopped, if the driver - * was not transmitting the function does nothing. - * - * @param[in] i2sp pointer to the @p I2SDriver object - * - * @api - */ -void i2sStopSend(I2SDriver *i2sp) { - - chDbgCheck((i2sp != NULL), "i2sStopSend"); + chDbgCheck((i2sp != NULL), "i2sStopExchange"); chSysLock(); chDbgAssert((i2sp->state == I2S_READY) || (i2sp->state == I2S_ACTIVE) || (i2sp->state == I2S_COMPLETE), - "i2sStopSend(), #1", "not ready"); - i2sStopSendI(i2sp); + "i2sStopExchange(), #1", "not ready"); + i2sStopExchangeI(i2sp); chSysUnlock(); } -- cgit v1.2.3 From e5c320a0d1a00915f88b379f27e981b89a787e33 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sun, 18 Mar 2012 20:30:06 +0000 Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4050 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/src/i2s.c | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) (limited to 'os/hal/src/i2s.c') diff --git a/os/hal/src/i2s.c b/os/hal/src/i2s.c index e0c547847..99e4246ad 100644 --- a/os/hal/src/i2s.c +++ b/os/hal/src/i2s.c @@ -128,11 +128,30 @@ void i2sStartExchange(I2SDriver *i2sp) { chDbgCheck(i2sp != NULL "i2sStartExchange"); chSysLock(); - chDbgAssert(i2sp->state == I2S_READY, "i2sStartExchange(), #1", "not ready"); + chDbgAssert(i2sp->state == I2S_READY, + "i2sStartExchange(), #1", "not ready"); i2sStartExchangeI(i2sp); chSysUnlock(); } +/** + * @brief Starts a I2S data exchange in continuous mode. + * + * @param[in] i2sp pointer to the @p I2SDriver object + * + * @api + */ +void i2sStartExchangeContinuous(I2SDriver *i2sp) { + + chDbgCheck(i2sp != NULL "i2sStartExchangeContinuous"); + + chSysLock(); + chDbgAssert(i2sp->state == I2S_READY, + "i2sStartExchangeContinuous(), #1", "not ready"); + i2sStartExchangeContinuousI(i2sp); + chSysUnlock(); +} + /** * @brief Stops the ongoing data exchange. * @details The ongoing data exchange, if any, is stopped, if the driver -- cgit v1.2.3 From 184a71345c6a36a9a8664eda8fbcc3ea728267a8 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sat, 2 Feb 2013 10:58:09 +0000 Subject: Updated license years. git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@5102 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/src/i2s.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'os/hal/src/i2s.c') diff --git a/os/hal/src/i2s.c b/os/hal/src/i2s.c index 99e4246ad..f9ed8177c 100644 --- a/os/hal/src/i2s.c +++ b/os/hal/src/i2s.c @@ -1,6 +1,6 @@ /* ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010, - 2011,2012 Giovanni Di Sirio. + 2011,2012,2013 Giovanni Di Sirio. This file is part of ChibiOS/RT. -- cgit v1.2.3 From 01f971ba1d63d8568789adf51cde22fb35f69e73 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Thu, 28 Feb 2013 16:23:19 +0000 Subject: Adjusted C file templates. git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@5339 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/src/i2s.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'os/hal/src/i2s.c') diff --git a/os/hal/src/i2s.c b/os/hal/src/i2s.c index f9ed8177c..e43d51ab2 100644 --- a/os/hal/src/i2s.c +++ b/os/hal/src/i2s.c @@ -40,7 +40,7 @@ /*===========================================================================*/ /*===========================================================================*/ -/* Driver local variables. */ +/* Driver local variables and types. */ /*===========================================================================*/ /*===========================================================================*/ -- cgit v1.2.3