From 2487bc05e4cb0a386f2c4633b97a5879c170eea1 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sat, 7 Nov 2009 10:48:59 +0000 Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1273 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- os/io/platforms/STM32/adc_lld.c | 119 ++++++++++++++++++++++++++++++++++++++++ os/io/platforms/STM32/adc_lld.h | 119 ++++++++++++++++++++++++++++++++++++++++ os/io/templates/adc_lld.h | 8 +-- 3 files changed, 239 insertions(+), 7 deletions(-) create mode 100644 os/io/platforms/STM32/adc_lld.c create mode 100644 os/io/platforms/STM32/adc_lld.h diff --git a/os/io/platforms/STM32/adc_lld.c b/os/io/platforms/STM32/adc_lld.c new file mode 100644 index 000000000..9581574ec --- /dev/null +++ b/os/io/platforms/STM32/adc_lld.c @@ -0,0 +1,119 @@ +/* + 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 STM32/adc_lld.c + * @brief STM32 ADC subsystem low level driver source + * @addtogroup STM32_ADC + * @{ + */ + +#include +#include + +/*===========================================================================*/ +/* Low Level Driver local functions. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Low Level Driver interrupt handlers. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Low Level Driver exported functions. */ +/*===========================================================================*/ + +/** + * @brief Low level ADC driver initialization. + */ +void adc_lld_init(void) { + +} + +/** + * @brief Configures and activates the ADC peripheral. + * + * @param[in] adcp pointer to the @p ADCDriver object + */ +void adc_lld_start(ADCDriver *adcp) { + + if (adcp->adc_state == ADC_STOP) { + /* Clock activation.*/ + } + /* Configuration.*/ +} + +/** + * @brief Deactivates the ADC peripheral. + * + * @param[in] adcp pointer to the @p ADCDriver object + */ +void adc_lld_stop(ADCDriver *adcp) { + +} + +/** + * @brief Starts an ADC conversion. + * @details Starts a conversion operation, there are two kind of conversion + * modes: + * - LINEAR, this mode is activated when the @p callback + * parameter is set to @p NULL, in this mode the buffer is filled + * once and then the conversion stops automatically. + * - CIRCULAR, when a callback function is defined the + * conversion never stops and the buffer is filled circularly. + * During the conversion the callback function is invoked when + * the buffer is 50% filled and when the buffer is 100% filled, + * this way is possible to process the conversion stream in real + * time. This kind of conversion can only be stopped by explicitly + * invoking @p adcStopConversion(). + * . + * + * @param[in] adcp pointer to the @p ADCDriver object + * @param[in] grpp pointer to a @p ADCConversionGroup object + * @param[out] samples pointer to the samples buffer + * @param[in] depth buffer depth (matrix rows number). The buffer depth + * must be one or an even number. + * @param[in] callback pointer to the conversion callback function + * @return The operation status. + * @retval FALSE the conversion has been started. + * @retval TRUE the driver is busy, conversion not started. + * + * @note The buffer is organized as a matrix of M*N elements where M is the + * channels number configured into the conversion group and N is the + * buffer depth. The samples are sequentially written into the buffer + * with no gaps. + */ +void adc_lld_start_conversion(ADCDriver *adcp, + ADCConversionGroup *grpp, + void *samples, + size_t depth, + adccallback_t callback) { + +} + +/** + * @brief Stops an ongoing conversion. + * + * @param[in] adcp pointer to the @p ADCDriver object + */ +void adc_lld_stop_conversion(ADCDriver *adcp) { + +} + +/** @} */ diff --git a/os/io/platforms/STM32/adc_lld.h b/os/io/platforms/STM32/adc_lld.h new file mode 100644 index 000000000..2dbfd82dd --- /dev/null +++ b/os/io/platforms/STM32/adc_lld.h @@ -0,0 +1,119 @@ +/* + 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 STM32/adc_lld.h + * @brief STM32 ADC subsystem low level driver header + * @addtogroup STM32_ADC + * @{ + */ + +#ifndef _ADC_LLD_H_ +#define _ADC_LLD_H_ + +/*===========================================================================*/ +/* Driver pre-compile time settings. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver constants. */ +/*===========================================================================*/ + +/*===========================================================================*/ +/* Driver data structures and types. */ +/*===========================================================================*/ + +/** + * @brief ADC sample data type. + */ +typedef uint16_t adcsample_t; + +/** + * @brief Channels number in a conversion group. + */ +typedef uint16_t adc_channels_num_t; + +/** + * @brief ADC notification callback type. + * @param[in] buffer pointer to the most recent samples data + * @param[in] n number of buffer rows available starting from @p buffer + */ +typedef void (*adccallback_t)(adcsample_t *buffer, size_t n); + +/** + * @brief Conversion group configuration structure. + * @details This implementation-dependent structure describes a conversion + * operation. + */ +typedef struct { + /** + * @brief Number of the analog channels belonging to the conversion group. + */ + adc_channels_num_t acg_num_channels; +} ADCConversionGroup; + +/** + * @brief Driver configuration structure. + */ +typedef struct { + +} ADCConfig; + +/** + * @brief Structure representing an ADC driver. + */ +typedef struct { + /** + * @brief Driver state. + */ + adcstate_t adc_state; + /** + * @brief Current configuration data. + */ + const ADCConfig *adc_config; + /** + * @brief Semaphore for completion synchronization. + */ + Semaphore adc_sem; + /* End of the mandatory fields.*/ +} ADCDriver; + +/*===========================================================================*/ +/* External declarations. */ +/*===========================================================================*/ + +#ifdef __cplusplus +extern "C" { +#endif + void adc_lld_init(void); + void adc_lld_start(ADCDriver *adcp); + void adc_lld_stop(ADCDriver *adcp); + void adc_lld_start_conversion(ADCDriver *adcp, + ADCConversionGroup *grpp, + void *samples, + size_t depth, + adccallback_t callback); + void adc_lld_stop_conversion(ADCDriver *adcp); +#ifdef __cplusplus +} +#endif + +#endif /* _ADC_LLD_H_ */ + +/** @} */ diff --git a/os/io/templates/adc_lld.h b/os/io/templates/adc_lld.h index db67a65cd..8ae29a521 100644 --- a/os/io/templates/adc_lld.h +++ b/os/io/templates/adc_lld.h @@ -49,18 +49,12 @@ typedef uint16_t adcsample_t; */ typedef uint16_t adc_channels_num_t; -/** - * @brief Samples buffer depth. - */ -typedef uint16_t adc_buffer_depth_t; - /** * @brief ADC notification callback type. * @param[in] buffer pointer to the most recent samples data * @param[in] n number of buffer rows available starting from @p buffer */ -typedef void (*adccallback_t)(adcsample_t *buffer, - adc_buffer_depth_t n); +typedef void (*adccallback_t)(adcsample_t *buffer, size_t n); /** * @brief Conversion group configuration structure. -- cgit v1.2.3