6.邮箱的使用

邮箱

​ 使用消息队列可以传递各类大小的消息，它使用 memcpy 的方式写入消息、读出消息。如果我们只是传递很小的数据，比如一些数值，可以使用邮箱：它的效率更高。邮箱的本质是环形缓冲区，邮箱中的每一封邮件，只能容纳 4 字节内容。

​ 邮箱的创建有两种方法：动态分配内存：rt_mb_create()；静态分配内存：rt_mb_init()

rt_mb_create()的函数原型如下：

rt_mailbox_t rt_mb_create (const char* name, rt_size_t size, rt_uint8_t flag);

rt_mb_init()的内存事先分配好，可以是数组，在msgpool指向该数组，函数原型如下：

 rt_err_t rt_mb_init(rt_mailbox_t mb,const char* name,void* msgpool,rt_size_t size,rt_uint8_t flag)

​ 同样邮箱的删除/脱离也有两种方法：rt_mb_delete()，rt_mb_detach()

删除邮箱的函数为rt_mb_delete()，它会释放内存删除邮箱时，如果有线程在等待该邮箱，则内核先唤醒这些线程（线程返回值是 -

RT_ERROR），然后再释放邮箱使用的内存，最后删除邮箱对象。

rt_err_t rt_mb_delete (rt_mailbox_t mb);

脱离邮箱将使邮箱对象被从内核对象管理器中脱离。原型如下：

rt_err_t rt_mb_detach(rt_mailbox_t mb)

发邮件有三个函数：rt_mb_send() 发送邮件，rt_mb_send_wait() 等待方式发送邮件，rt_mb_urgent() 发送紧急邮件。发送的邮件，可以是 32 位的任意格式数据，可以是一个整型值或者一个指向某块内存的指针，这三个函数的用法和消息队列的相同。在这就不多做说明。

收邮件的函数为rt_err_t rt_mb_recv，当邮箱有邮件时，使用收邮件函数，可以从邮箱接收邮件。如果没有邮件，根据指定的 timeout 参数等待，直到超时结束。函数原型如下：

rt_err_t rt_mb_recv (rt_mailbox_t mb, rt_uint32_t* value, rt_int32_t timeout);