Imagelibrary/rt-thread
1
0
Fork 0
mirror of https://github.com/RT-Thread/rt-thread.git synced 2025-12-05 15:15:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

[doxygen][audio] Fix doxygen comments for audio component

Browse Source 
Added comments for data structure and rt_audio_ops in dev_audio.h.
Enriched comments for macro group. Moved and renamed folder audio.

Signed-off-by: 1078249029 <1078249029@qq.com>
This commit is contained in:
1078249029
2025-03-04 20:07:36 +08:00
committed by Rbb666
parent e75c49a17b
commit ed8d0bc36b
5 changed files with 69 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
components/drivers/audio/dev_audio.c
View File

@@ -7,6 +7,7 @@
* Date Author Notes
* 2017-05-09 Urey first version
* 2019-07-09 Zero-Free improve device ops interface and data flows
* 2025-03-04 wumingzi add doxygen comments.
*/
#include <stdio.h>
@@ -23,7 +24,7 @@
#endif
/**
* @addtogroup group_AudioPipe
* @addtogroup group_Audio
*/
/** @{ */

1
components/drivers/audio/dev_audio_pipe.c
View File

@@ -6,6 +6,7 @@
* Change Logs:
* Date Author Notes
* 2012-09-30 Bernard first version.
* 2025-03-04 wumingzi add doxygen comments.
*/
#include <rthw.h>

1
components/drivers/audio/dev_audio_pipe.h
View File

@@ -5,6 +5,7 @@
*
* Change Logs:
* Date Author Notes
* 2025-03-04 wumingzi add doxygen comments.
*/
#ifndef __DEV_AUDIO_PIPE_H__
#define __DEV_AUDIO_PIPE_H__

122
components/drivers/include/drivers/dev_audio.h
View File

@@ -7,7 +7,7 @@
* Date Author Notes
* 2017-05-09 Urey first version
* 2019-07-09 Zero-Free improve device ops interface and data flows
*
* 2025-03-04 wumingzi add doxygen comments.
*/
#ifndef __DEV_AUDIO_H__
@@ -21,10 +21,7 @@
* @ingroup group_Drivers RT-Thread Drivers
*
* @brief Audio driver API.
*/
/**
* @addtogroup group_Audio
*
* @{
*/
@@ -32,10 +29,7 @@
* @defgroup audio_control AUDIO_CTL
*
* @brief Control audio device.
*/
/**
* @addtogroup audio_control
*
* @{
*/
@@ -60,10 +54,7 @@
* @defgroup audio_type AUDIO_TYPE
*
* @brief Audio Device Types
*/
/**
* @addtogroup audio_type
*
* @{
*/
#define AUDIO_TYPE_QUERY 0x00 /**< Query audio device type */
@@ -76,10 +67,7 @@
* @defgroup audio_samp_rates AUDIO_SAMP_RATES
*
* @brief Supported audio sample rates for the audio device.
*/
/**
* @addtogroup audio_samp_rates
*
* @{
*/
#define AUDIO_SAMP_RATE_8K 0x0001 /**< Set audio device sample rate to 8K */
@@ -100,10 +88,7 @@
* @defgroup audio_bit_rates AUDIO_BIT_RATES
*
* @brief Supported bit rates for the audio device.
*/
/**
* @addtogroup audio_bit_rates
*
* @{
*/
#define AUDIO_BIT_RATE_22K 0x01 /**< Set audio device bit rates to 22K */
@@ -120,11 +105,9 @@
/**
* @defgroup audio_dsp AUDIO_DSP
*
* @brief Support Dsp(input/output) Units controls
*/
/**
* @addtogroup audio_dsp
* @brief Support Dsp(input/output) Units controls. The macro group from application level, can
* set audio mixer parameters including samplerate, channels etc.
*
* @{
*/
#define AUDIO_DSP_PARAM 0 /**< get/set all params */
@@ -136,11 +119,9 @@
/**
* @defgroup audio_mixer AUDIO_MIXER
*
* @brief Supported Mixer Units controls
*/
/**
* @addtogroup audio_mixer
* @brief Supported Mixer Units controls. The macro group from driver level, can set audio mixer
* parameters including volume, frequence db, microphone etc.
*
* @{
*/
#define AUDIO_MIXER_QUERY 0x0000 /**< Query mixer capabilities */
@@ -181,24 +162,35 @@ enum
*/
struct rt_audio_buf_info
{
rt_uint8_t *buffer;
rt_uint16_t block_size;
rt_uint16_t block_count;
rt_uint32_t total_size;
rt_uint8_t *buffer; /**< Audio buffer information */
rt_uint16_t block_size; /**< Audio block_size information for replay function */
rt_uint16_t block_count; /**< Audio block_count information for replay function */
rt_uint32_t total_size; /**< Audio total_size which is equal to block_size multiplying
* block_count information for replay function */
};
struct rt_audio_device;
struct rt_audio_caps;
struct rt_audio_configure;
/**
* @brief Aduio device operators
*/
struct rt_audio_ops
{
/** Get audio capabilities information */
rt_err_t (*getcaps)(struct rt_audio_device *audio, struct rt_audio_caps *caps);
/** Configure audio devices */
rt_err_t (*configure)(struct rt_audio_device *audio, struct rt_audio_caps *caps);
/** Initialize audio device */
rt_err_t (*init)(struct rt_audio_device *audio);
/** Turn on the audio device */
rt_err_t (*start)(struct rt_audio_device *audio, int stream);
/** Turn off the audio device */
rt_err_t (*stop)(struct rt_audio_device *audio, int stream);
/** Transmit data between application and device */
rt_ssize_t (*transmit)(struct rt_audio_device *audio, const void *writeBuf, void *readBuf, rt_size_t size);
/* get page size of codec or private buffer's info */
/** Get page size of codec or private buffer's info */
void (*buffer_info)(struct rt_audio_device *audio, struct rt_audio_buf_info *info);
};
@@ -211,9 +203,9 @@ struct rt_audio_ops
*/
struct rt_audio_configure
{
rt_uint32_t samplerate;
rt_uint16_t channels;
rt_uint16_t samplebits;
rt_uint32_t samplerate; /**< Audio samplerate information */
rt_uint16_t channels; /**< Audio channels information */
rt_uint16_t samplebits; /**< Audio samplebits information */
};
/**
@@ -221,15 +213,15 @@ struct rt_audio_configure
*/
struct rt_audio_caps
{
int main_type;
int sub_type;
int main_type; /**< Audio main type, one value of @ref audio_type */
int sub_type; /**< Audio sub type, one value of @ref audio_dsp @ref audio_mixer */
union
{
rt_uint32_t mask;
int value;
struct rt_audio_configure config;
} udata;
rt_uint32_t mask; /**< Capabilities mask */
int value; /**< Capabilities value */
struct rt_audio_configure config; /**< Audio samplebits information */
} udata; /**< User data */
};
/**
@@ -237,17 +229,19 @@ struct rt_audio_caps
*/
struct rt_audio_replay
{
struct rt_mempool *mp;
struct rt_data_queue queue;
struct rt_mutex lock;
struct rt_completion cmp;
struct rt_audio_buf_info buf_info;
rt_uint8_t *write_data;
rt_uint16_t write_index;
rt_uint16_t read_index;
rt_uint32_t pos;
rt_uint8_t event;
rt_bool_t activated;
struct rt_mempool *mp; /**< Memory pool for audio replay */
struct rt_data_queue queue; /**< Replay data queue */
struct rt_mutex lock; /**< Replay mutex lock */
struct rt_completion cmp; /**< Replay completion, it will be */
struct rt_audio_buf_info buf_info; /**< Replay buffer information */
rt_uint8_t *write_data; /**< Pointer to the data to be written into data queue */
rt_uint16_t write_index; /**< Index of pointer write_data.It records how much data
* has been written in currently being played block */
rt_uint16_t read_index; /**< Index of replaying data for audio device, it indicates index
* of replay in the blocks which is currently being played */
rt_uint32_t pos; /**< Global position of audio replay */
rt_uint8_t event; /**< Event flag */
rt_bool_t activated; /**< Activaty flag */
};
/**
@@ -264,10 +258,10 @@ struct rt_audio_record
*/
struct rt_audio_device
{
struct rt_device parent;
struct rt_audio_ops *ops;
struct rt_audio_replay *replay;
struct rt_audio_record *record;
struct rt_device parent; /**< Audio device parents */
struct rt_audio_ops *ops; /**< Audio device operator */
struct rt_audio_replay *replay; /**< Pointer to audio replay structure */
struct rt_audio_record *record; /**< Pointer to audio record structure */
};
rt_err_t rt_audio_register(struct rt_audio_device *audio, const char *name, rt_uint32_t flag, void *data);
@@ -277,11 +271,9 @@ void rt_audio_rx_done(struct rt_audio_device *audio, rt_uint8_t *pbuf, rt
/**
* @defgroup audio_codec_cmd CODEC_CMD
*
* @brief Device Control Commands
*/
/**
* @addtogroup audio_codec_cmd
* @brief Device Control Commands. The macro group from hardware level, can set codec
* parametes including volume, EQ and 3D etc.
*
* @{
*/
#define CODEC_CMD_RESET 0 /**< Reset audio device by codec */

0
documentation/device/adudio/audio.md → documentation/5.device/audio/audio.md
View File