diff --git a/components/drivers/src/dataqueue.c b/components/drivers/src/dataqueue.c index be4883d954..4e51d72865 100644 --- a/components/drivers/src/dataqueue.c +++ b/components/drivers/src/dataqueue.c @@ -22,16 +22,16 @@ struct rt_data_item }; /** - * @brief This function will initialize a data queue.Calling this function will + * @brief This function will initialize a data queue.Calling this function will * initialize the data queue control block and set the notification callback function. - * + * * @param queue The data queue object * @param size The maximum number of data in the data queue * @param lwm Low water mark, when the number of data in the data queue is less than this value, * will wake up the thread waiting for write data. * @param evt_notify The notification callback function - * - * @return the operation status, RT_EOK on successful, + * + * @return the operation status, RT_EOK on successful, * RT_ENOMEM on insufficient memory allocation failed. */ rt_err_t @@ -45,7 +45,7 @@ rt_data_queue_init(struct rt_data_queue *queue, queue->evt_notify = evt_notify; - queue->magic = DATAQUEUE_MAGIC; + queue->magic = DATAQUEUE_MAGIC; queue->size = size; queue->lwm = lwm; @@ -70,13 +70,13 @@ RTM_EXPORT(rt_data_queue_init); /** * @brief This function will write data to the data queue. If the data queue is full, * the thread will suspend for the specified amount of time. - * + * * @param queue The data queue object * @param data_ptr The buffer pointer of the data to be written * @param size The size in bytes of the data to be written * @param timeout The waiting time - * - * @return the operation status, RT_EOK on successful + * + * @return the operation status, RT_EOK on successful */ rt_err_t rt_data_queue_push(struct rt_data_queue *queue, const void *data_ptr, @@ -180,15 +180,15 @@ RTM_EXPORT(rt_data_queue_push); /** * @brief This function will pop data from the data queue. If the data queue is empty, * the thread will suspend for the specified amount of time. - * + * * @attention when the number of data in the data queue is less than lwm(low water mark), * will wake up the thread waiting for write data. - * + * * @param queue The data queue object * @param data_ptr The buffer pointer of the data to be fetched * @param size The size in bytes of the data to be fetched * @param timeout The waiting time - * + * * @return Operation status, RT_EOK on successful, RT_ETIMEOUT on timeout. */ rt_err_t rt_data_queue_pop(struct rt_data_queue *queue, @@ -304,12 +304,12 @@ RTM_EXPORT(rt_data_queue_pop); /** * @brief This function will fetching but retaining data in the data queue. - * + * * @param queue The data queue object * @param data_ptr The buffer pointer of the data to be fetched * @param size The size in bytes of the data to be fetched - * - * @return The operation status, RT_EOK on successful + * + * @return The operation status, RT_EOK on successful */ rt_err_t rt_data_queue_peek(struct rt_data_queue *queue, const void** data_ptr, @@ -339,7 +339,7 @@ RTM_EXPORT(rt_data_queue_peek); /** * @brief Reset a data queue. Calling this function will wake up all threads on the data queue * that are hanging and waiting. - * + * * @param queue The data queue object */ void rt_data_queue_reset(struct rt_data_queue *queue) @@ -417,9 +417,9 @@ RTM_EXPORT(rt_data_queue_reset); /** * @brief Deinit a data queue. - * + * * @param queue The data queue object - * + * * @return operation status, RT_EOK on successful. */ rt_err_t rt_data_queue_deinit(struct rt_data_queue *queue) @@ -444,9 +444,9 @@ RTM_EXPORT(rt_data_queue_deinit); /** * @brief This function get the number of data in the data queue. - * + * * @param queue The data queue object - * @return The number of data in the data queue + * @return The number of data in the data queue */ rt_uint16_t rt_data_queue_len(struct rt_data_queue *queue) {