aboutsummaryrefslogtreecommitdiffstats
path: root/include/gaudin/gaudin.h
diff options
context:
space:
mode:
authorJoel Bodenmann <joel@unormal.org>2013-03-10 20:17:24 +0100
committerJoel Bodenmann <joel@unormal.org>2013-03-10 20:17:24 +0100
commit426a12de6b6de40e576424b0a6391f528dc8a1ed (patch)
tree1a4a745e73bcf33714ead537206677b8f05d3922 /include/gaudin/gaudin.h
parent2088f0fe67c2137c7feddd682639b32497569e76 (diff)
downloaduGFX-426a12de6b6de40e576424b0a6391f528dc8a1ed.tar.gz
uGFX-426a12de6b6de40e576424b0a6391f528dc8a1ed.tar.bz2
uGFX-426a12de6b6de40e576424b0a6391f528dc8a1ed.zip
doxygen fixes
Diffstat (limited to 'include/gaudin/gaudin.h')
-rw-r--r--include/gaudin/gaudin.h17
1 files changed, 11 insertions, 6 deletions
diff --git a/include/gaudin/gaudin.h b/include/gaudin/gaudin.h
index d9111dae..3cf29d09 100644
--- a/include/gaudin/gaudin.h
+++ b/include/gaudin/gaudin.h
@@ -76,7 +76,8 @@ typedef struct GEventAudioIn_t {
* @brief The buffer containing the audio samples
*/
audin_sample_t *buffer;
- } GEventAudioIn;
+} GEventAudioIn;
+/** @} */
/*===========================================================================*/
/* External declarations. */
@@ -90,11 +91,11 @@ extern "C" {
* @brief Initialise (but not start) the Audio Input Subsystem.
* @details Returns FALSE for an invalid channel or other invalid parameter.
*
- * @param[in] channel The channel to convert. Can be set from 0 to GAUDIN_NUM_CHANNELS - 1.
- * @param[in] frequency The sample frequency
- * @param[in] buffer The static buffer to put the samples into.
- * @param[in] bufcount The total number of conversions that will fit in the buffer.
- * @param[in] countPerEvent The number of conversions to do before returning an event.
+ * @param[in] channel The channel to convert. Can be set from 0 to GAUDIN_NUM_CHANNELS - 1.
+ * @param[in] frequency The sample frequency
+ * @param[in] buffer The static buffer to put the samples into.
+ * @param[in] bufcount The total number of conversions that will fit in the buffer.
+ * @param[in] samplesPerEvent The number of conversions to do before returning an event.
*
* @note Only one channel is active at a time. If an audio input is running it will be stopped.
* The Event subsystem is disconnected from the audio subsystem and any binary semaphore
@@ -119,6 +120,8 @@ extern "C" {
* a block of samples containing less than countPerEvent samples when it reaches the
* end of the buffer.
*
+ * @return FALSE if invalid channel or parameter
+ *
* @api
*/
bool_t gaudinInit(uint16_t channel, uint32_t frequency, audin_sample_t *buffer, size_t bufcount, size_t samplesPerEvent);
@@ -135,6 +138,8 @@ bool_t gaudinInit(uint16_t channel, uint32_t frequency, audin_sample_t *buffer,
* @note The audio input is capable of signalling via this method and a binary semaphore
* at the same time.
*
+ * @return The GSourceHandle
+ *
* @api
*/
GSourceHandle gaudinGetSource(void);