Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
2345VOR
rt-thread
提交
2c2a1fe6
R
rt-thread
项目概览
2345VOR
/
rt-thread
与 Fork 源项目一致
Fork自
RT-Thread / rt-thread
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
R
rt-thread
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
2c2a1fe6
编写于
11月 24, 2021
作者:
O
ousugo
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update annotation format
上级
afdbee97
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
54 addition
and
39 deletion
+54
-39
components/drivers/src/dataqueue.c
components/drivers/src/dataqueue.c
+54
-39
未找到文件。
components/drivers/src/dataqueue.c
浏览文件 @
2c2a1fe6
...
...
@@ -22,17 +22,21 @@ struct rt_data_item
};
/**
* @brief This function will initialize a data queue.Calling this function will
* initialize the data queue control block and set the notification callback function.
* @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
* @param queue is a pointer to a data queue object.
*
* @return the operation status, RT_EOK on successful,
* RT_ENOMEM on insufficient memory allocation failed.
* @param size is the maximum number of data in the data queue.
*
* @param lwm is 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 is the notification callback function.
*
* @return Return the operation status. When the return value is RT_EOK, the initialization is successful.
* When the return value is RT_ENOMEM, it means insufficient memory allocation failed.
*/
rt_err_t
rt_data_queue_init
(
struct
rt_data_queue
*
queue
,
...
...
@@ -68,15 +72,18 @@ rt_data_queue_init(struct rt_data_queue *queue,
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.
* @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
* @param queue is a pointer to a data queue object.
* .
* @param data_ptr is the buffer pointer of the data to be written.
*
* @return the operation status, RT_EOK on successful
* @param size is the size in bytes of the data to be written.
*
* @param timeout is the waiting time.
*
* @return Return the operation status. When the return value is RT_EOK, the operation is successful.
*/
rt_err_t
rt_data_queue_push
(
struct
rt_data_queue
*
queue
,
const
void
*
data_ptr
,
...
...
@@ -178,18 +185,21 @@ __exit:
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.
* @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.
*
* @note 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.
*
* @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 is a pointer to a data queue object.
*
* @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
* @param data_ptr is the buffer pointer of the data to be fetched.
*
* @return Operation status, RT_EOK on successful, RT_ETIMEOUT on timeout.
* @param size is the size in bytes of the data to be fetched.
*
* @param timeout is the waiting time.
*
* @return Return the operation status. When the return value is RT_EOK, the operation is successful.
*/
rt_err_t
rt_data_queue_pop
(
struct
rt_data_queue
*
queue
,
const
void
**
data_ptr
,
...
...
@@ -303,13 +313,15 @@ __exit:
RTM_EXPORT
(
rt_data_queue_pop
);
/**
* @brief This function will fetching but retaining data in the data queue.
* @brief This function will fetching but retaining data in the data queue.
*
* @param queue is a pointer to a data queue object.
*
* @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 data_ptr is the buffer pointer of the data to be fetched.
*
* @return The operation status, RT_EOK on successful
* @param size is the size in bytes of the data to be fetched.
*
* @return Return the operation status. When the return value is RT_EOK, the operation is successful.
*/
rt_err_t
rt_data_queue_peek
(
struct
rt_data_queue
*
queue
,
const
void
**
data_ptr
,
...
...
@@ -337,10 +349,12 @@ rt_err_t rt_data_queue_peek(struct rt_data_queue *queue,
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.
* @brief This function will reset a data queue.
*
* @note Calling this function will wake up all threads on the data queue
* that are hanging and waiting.
*
* @param
queue The data queue object
* @param
queue is a pointer to a data queue object.
*/
void
rt_data_queue_reset
(
struct
rt_data_queue
*
queue
)
{
...
...
@@ -416,11 +430,11 @@ void rt_data_queue_reset(struct rt_data_queue *queue)
RTM_EXPORT
(
rt_data_queue_reset
);
/**
* @brief
D
einit a data queue.
* @brief
This function will d
einit a data queue.
*
* @param
queue The data queue object
* @param
queue is a pointer to a data queue object.
*
* @return
operation status, RT_EOK on
successful.
* @return
Return the operation status. When the return value is RT_EOK, the operation is
successful.
*/
rt_err_t
rt_data_queue_deinit
(
struct
rt_data_queue
*
queue
)
{
...
...
@@ -443,10 +457,11 @@ rt_err_t rt_data_queue_deinit(struct rt_data_queue *queue)
RTM_EXPORT
(
rt_data_queue_deinit
);
/**
* @brief This function get the number of data in the data queue.
* @brief This function will get the number of data in the data queue.
*
* @param queue is a pointer to a data queue object.
*
* @param queue The data queue object
* @return The number of data in the data queue
* @return Return the number of data in the data queue.
*/
rt_uint16_t
rt_data_queue_len
(
struct
rt_data_queue
*
queue
)
{
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录