rtthread-ipc之completion

这是一个较为简单的线程同步通信机制，当然截至写稿之前我也不懂，但是从代码来看，还是比较简单。
一 首先查看completion.h文件
#ifndef COMPLETION_H_
#define COMPLETION_H_
#include 
/**
* Completion
*/
struct rt_completion
{
rt_uint32_t flag;

/* suspended list */
rt_list_t suspended_list;
};
void rt_completion_init(struct rt_completion *completion);
rt_err_t rt_completion_wait(struct rt_completion *completion,rt_int32_t timeout);
void rt_completion_done(struct rt_completion *completion);
#endif
可以看出仅一个结构体描述，flag可以为RT_COMPLETED和RT_UPCOMPLETED两种状态，而suspended_list为挂载在该comletion的线程。

二 completion.c文件
包括以下三个函数：
void rt_completion_init(struct rt_completion *completion);
rt_err_t rt_completion_wait(struct rt_completion *completion,rt_int32_t timeout);
void rt_completion_done(struct rt_completion *completion);
作用也是简洁明了，使用之前先声明一个结构体，然后初始化，当一个线程需要等待另外一个线程完成某件事情的时候，调用wait进行等待，而另外一个线程执行某些操作，结束后调用done函数，使这个completion结束即可唤醒等待的线程继续执行任务。
下面具体看这个三个函数的实现代码
1 rt_completion_init
主要是设置flag为未完成以及将list循环链表的preve和next都指向自身
2 rt_completion_wait
开头定义一个线程指针，并获取调用该函数的线程指针，之后判断completione是否为未完成状态，是的话判断在l->next是否为自身，也即其上没有等待的线程，这些条件都满足后，判断timeout参数是否非零，非零的话设置线程的状态为RT_EOK，调用rt_thread_suspend挂起该线程，并调用rt_list_insert_before将该线程内的链表节点插入到suspended_list的后边（或前边，因为这是一个只有两个成员的双向循环链表），使用RT_DEBUG_NOT_IN_INTERRUPT宏检查不是在中断中调用的该函数，之后重置当前线程的定时计数器，时间设置为timeout，之后启动计数器，然后调用rt_schedule进行线程调度，之后返回，进入被安排执行的线程。
3 rt_completion_done
首先当然是判断是否为完成态，进行参数检查，若未完成态继续往下，设置flag为完成，若completion上存在挂起的线程，调用rt_list_entry获取suspended_list中挂起的list所对于的线程控制块指针，然后调用rt_thread_resume唤醒该线程，然后执行rt_schedule进行一次调度，然后返回到rt_schedule安排的下一个线程。