From 84235c1c49ca8e65182e88254070193cb310ca5c Mon Sep 17 00:00:00 2001 From: gdisirio Date: Mon, 21 Dec 2009 08:12:34 +0000 Subject: Documentation fixes, old SSP driver removed. git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1451 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/hal/platforms/LPC214x/lpc214x_ssp.c | 132 --------------------------------- os/hal/platforms/LPC214x/lpc214x_ssp.h | 54 -------------- os/hal/platforms/LPC214x/platform.dox | 11 ++- 3 files changed, 5 insertions(+), 192 deletions(-) delete mode 100644 os/hal/platforms/LPC214x/lpc214x_ssp.c delete mode 100644 os/hal/platforms/LPC214x/lpc214x_ssp.h (limited to 'os/hal/platforms/LPC214x') diff --git a/os/hal/platforms/LPC214x/lpc214x_ssp.c b/os/hal/platforms/LPC214x/lpc214x_ssp.c deleted file mode 100644 index 273c0b6eb..000000000 --- a/os/hal/platforms/LPC214x/lpc214x_ssp.c +++ /dev/null @@ -1,132 +0,0 @@ -/* - 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 . -*/ - -/** - * @file LPC214x/lpc214x_ssp.c - * @brief LPC214x SSP driver code. - * @addtogroup LPC214x_SSP - * @{ - */ - -#include "ch.h" -#include "hal.h" - -#include "lpc214x_ssp.h" - -#if LPC214x_SSP_USE_MUTEX -static Semaphore me; -#endif - -/** - * @brief Aquires access to the SSP bus. - * @note This function also handles the mutual exclusion on the SSP bus if - * the @p LPC214x_SSP_USE_MUTEX option is enabled. - */ -void sspAcquireBus(void) { - -#if LPC214x_SSP_USE_MUTEX - chSemWait(&me); -#endif - palClearPad(IOPORT1, 20); -} - -/** - * @brief Releases the SSP bus. - * @note This function also handles the mutual exclusion on the SSP bus if - * the @p LPC214x_SSP_USE_MUTEX option is enabled. - */ -void sspReleaseBus(void) { - - palClearPad(IOPORT1, 20); -#if LPC214x_SSP_USE_MUTEX - chSemSignal(&me); -#endif -} - -/** - * @brief Synchronous SSP transfer. - * @param[in] in pointer to the incoming data buffer, if this parameter is set - * to @p NULL then the incoming data is discarded - * @param[out] out pointer to the outgoing data buffer, if this parameter is - * set to @p NULL then 0xFF bytes will be output - * @param[in] n the number of bytes to be transferred - * @note The transfer is performed in a software loop and is not interrupt - * driven for performance reasons, this function should be invoked - * by a low priority thread in order to "play nice" with the - * rest of the system. This kind of peripheral would really need a - * dedicated DMA channel. - */ -void sspRW(uint8_t *in, uint8_t *out, size_t n) { - int icnt, ocnt; - - SSP *ssp = SSPBase; - icnt = ocnt = n; - while (icnt) { - - if (ssp->SSP_SR & SR_RNE) { - if (in) - *in++ = ssp->SSP_DR; - else - ssp->SSP_DR; - icnt--; - continue; /* Priority over transmission. */ - } - - if (ocnt && (ssp->SSP_SR & SR_TNF)) { - if (out) - ssp->SSP_DR = *out++; - else - ssp->SSP_DR = 0xFF; - ocnt--; - } - } -} - -/** - * @brief SSP setup. - * @param[in] cpsr the value for the @p CPSR register - * @param[in] cr0 the value for the @p CR0 register - * @param[in] cr1 the value for the @p CR1 register - */ -void ssp_setup(int cpsr, int cr0, int cr1) { - - SSP *ssp = SSPBase; - ssp->SSP_CR1 = 0; - ssp->SSP_CR0 = cr0; - ssp->SSP_CPSR = cpsr; - ssp->SSP_CR1 = cr1 | CR1_SSE; -} - -/** - * @brief SSP subsystem initialization. - */ -void ssp_init(void) { - - /* Enables the SPI1 clock */ - PCONP = (PCONP & PCALL) | PCSPI1; - - /* Clock = PCLK / 2 (fastest). */ - ssp_setup(2, CR0_DSS8BIT | CR0_FRFSPI | CR0_CLOCKRATE(0), 0); - -#if LPC214x_SSP_USE_MUTEX - chSemInit(&me, 1); -#endif -} - -/** @} */ diff --git a/os/hal/platforms/LPC214x/lpc214x_ssp.h b/os/hal/platforms/LPC214x/lpc214x_ssp.h deleted file mode 100644 index 3ad25b37a..000000000 --- a/os/hal/platforms/LPC214x/lpc214x_ssp.h +++ /dev/null @@ -1,54 +0,0 @@ -/* - 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 . -*/ - -/** - * @file LPC214x/lpc214x_ssp.h - * @brief LPC214x SSP driver macros and structures. - * @addtogroup LPC214x_SSP - * @{ - */ - -#ifndef _LPC214x_SSP_H_ -#define _LPC214x_SSP_H_ - -/** - * @brief SSP bus mutual exclusion control. - * @details Configuration parameter, if set to @p TRUE enforces mutual - * exclusion when invoking @p sspAcquireBus() and @p sspReleaseBus(). - * @note The internally used synchronization mechanism is a @p Semaphore. - */ -#if !defined(LPC214x_SSP_USE_MUTEX) || defined(__DOXYGEN__) -#define LPC214x_SSP_USE_MUTEX TRUE -#endif - -#ifdef __cplusplus -} -#endif - void ssp_init(void); - void ssp_setup(int cpsr, int cr0, int cr1); - void sspAcquireBus(void); - void sspReleaseBus(void); - void sspRW(uint8_t *in, uint8_t *out, size_t n); -#ifdef __cplusplus -} -#endif - -#endif /* _LPC214x_SSP_H_*/ - -/** @} */ diff --git a/os/hal/platforms/LPC214x/platform.dox b/os/hal/platforms/LPC214x/platform.dox index ce86dc171..b429793ec 100644 --- a/os/hal/platforms/LPC214x/platform.dox +++ b/os/hal/platforms/LPC214x/platform.dox @@ -24,12 +24,10 @@ * - VIC support code. * - I/O ports driver. * - Buffered, interrupt driven, serial driver. - * - SSP driver. - * - A MMC/SD demo driver. - * - A timer driven buzzer demo driver. - * - A minimal demo, useful as project template. + * - SPI driver. * - A demo supporting the kernel test suite. * - A C++ demo supporting the kernel test suite. + * - A demo integrating ChibiOS/RT with FatFS. * . * @ingroup ARM7 */ @@ -83,9 +81,10 @@ */ /** - * @defgroup LPC214x_SSP LPC214x SSP Support + * @defgroup LPC214x_SPI LPC214x SPI Support * @brief SSP peripheral support. - * @details This SPI driver supports the LPC214x SSP peripheral. + * @details The SPI driver supports the LPC214x SSP, the driver works in + * polling mode. * * @ingroup LPC214x */ -- cgit v1.2.3