【RTX操作系统教程】第16章 消息邮箱

席萌0209

第16章    消息邮箱

    前面几个章节主要给大家讲解了任务间的同步和资源共享机制，本章节为大家讲解任务间的通信机制消息邮箱，RTX的消息邮箱其实就是消息队列，注意和uCOS-II中的消息邮箱区分开，uCOS-II的消息邮箱只能实现一个数据的传递。这里的消息邮箱可以实现多个数据的传递。
    本章教程配套的例子含Cortex-M3内核的STM32F103和Cortex-M4内核的STM32F407。
16.1 消息邮箱
16.2 消息邮箱API函数
16.3 实验例程说明（任务间通信）
16.4 实验例程说明（中断方式通信）
16.5      总结

16.1 消息邮箱

16.1.1  消息邮箱的概念及其作用

    RTX的消息邮箱实际上就是消息队列，通过内核提供的服务，任务或中断服务子程序可以将一个消息（注意，RTX消息邮箱传递的是消息的地址而不是实际的数据）放入到消息队列。同样，一个或者多个任务可以通过内核服务从消息队列中得到消息。通常，先进入消息队列的消息先传给任务，也就是说，任务先得到的是最先进入到消息队列的消息，即先进先出的原则（FIFO）。
    也许有不理解的初学者会问采用消息邮箱多麻烦，搞个全局数组不是更简单，其实不然。在裸机编程时，使用全局数组的确比较方便，但是在加上RTOS后就是另一种情况了。使用全局数组相比消息邮箱主要有如下四个问题：
u 使用消息邮箱可以让RTOS内核有效的管理任务，全局数组是无法做到的，任务的超时等机制需要用户自己去实现。
u 使用了全局数组就要防止多任务的访问冲突，使用消息邮箱已经处理好了这个问题。用户无需担心。
u 使用消息邮箱可以有效的解决中断服务程序跟任务之间消息传递的问题。
u FIFO机制更有利于数据的处理。

16.1.2 RTX任务间消息邮箱的实现

    任务间消息邮箱的实现是指各个任务之间使用消息邮箱实现任务间的通信。下面我们通过如下的框图来说明一下RTX消息邮箱的实现，让大家有一个形象的认识。

运行条件：
u  创建消息邮箱，可以存放10个消息。
u  创建2个任务Task1和Task2，任务Task1向消息邮箱放数据地址，任务Task2从消息邮箱取数据地址。
u  RTX的消息读取和存放仅支持FIFO方式。
运行过程主要有以下两种情况：
u 任务Task1 向消息邮箱放数据地址，任务Task2从消息邮箱取数据地址，如果放数据地址的速度快于取数据的速度，那么会出现消息邮箱存放满的情况，RTX的消息存放函数os_mbx_send支持超时等待，可以设置超时等待，直到有位置可以存放消息放或者设置时间超时。
u 任务Task1 向消息邮箱放数据地址，任务Task2从消息邮箱取数据地址，如果放数据地址的速度慢于取数据的速度，那么会出现消息邮箱为空的情况，RTX的消息获取函数os_mbx_wait支持超时等待，可以设置超时等待，直到消息邮箱中有消息放或者设置时间超时。

上面就是一个简单的RTX任务间消息邮箱通信过程。

16.1.3 RTX中断方式消息邮箱的实现

    RTX中断方式消息邮箱的实现是指中断函数和RTX任务之间使用消息邮箱。下面我们通过如下的框图来说明一下RTX消息邮箱的实现，让大家有一个形象的认识。

运行条件：
u  创建消息邮箱，可以存放10个消息。
u  创建1个任务Task1和一个串口接收中断。
u  RTX的消息读取和存放仅支持FIFO方式。
运行过程主要有以下两种情况：
u 中断服务程序向消息邮箱放数据地址，任务Task1从消息邮箱取数据地址，如果放数据地址的速度快于取数据的速度，那么会出现消息邮箱存放满的情况。由于中断服务程序里面的消息邮箱发送函数isr_mbx_send不支持超时设置，所有发送前要通过函数isr_mbx_check检测邮箱是否满。
u 中断服务程序向消息邮箱放数据地址，任务Task1从消息邮箱取数据地址，如果放数据地址的速度慢于取数据的速度，那么会出现消息邮箱存为空的情况。在RTX的任务中可以通过函数os_mbx_wait获取消息，因为此函数可以设置超时等待，直到消息邮箱中有消息存放或者设置时间超时。

上面就是一个简单RTX消息邮箱通信过程。实际应用中，中断方式的消息机制切记注意以下四个问题：
u  中断函数的执行时间越短越好，防止其它低于这个中断优先级的异常不能得到及时响应。
u  实际应用中，建议不要在中断中实现消息处理，用户可以在中断服务程序里面发送消息通知任务，在任务中实现消息处理，这样可以有效的保证中断服务程序的实时响应。同时此任务也需要设置为高优先级，以便退出中断函数后任务可以得到及时执行。
u  中断服务程序中一定要调用专用于中断的消息邮箱函数isr_mbx_send，isr_mbx_receive和isr_mbx_check。
u  在RTX操作系统中实现中断函数和裸机编程是一样的。
    l  另外强烈推荐用户将Cortex-M3内核的STM32F103和Cortex-M4内核的STM32F407的NVIC优先级分组设置为4,即：NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);这样中断优先级的管理将非常方便。
    l  用户要在RTX多任务开启前就设置好优先级分组，一旦设置好切记不可再修改。

席萌0209

16.2    消息邮箱API函数


    使用如下8个函数可以实现RTX消息邮箱：
u os_mbx_check
u os_mbx_declare
u os_mbx_init
u os_mbx_send
u os_mbx_wait
u  isr_mbx_check
u isr_mbx_receive
u  isr_mbx_send
关于这8个函数的讲解及其使用方法可以看教程第3章3.3小节里面说的参考资料rlarm.chm文件

这里我们重点的说一下函数os_mbx_declare，os_mbx_init，os_mbx_send，os_mbx_wait，isr_mbx_check和isr_mbx_send。

16.2.1 函数os_mbx_declare


函数原型：

1. #define os_mbx_declare( \\
2.     name,               \\ /* 消息邮箱名 */
3.     cnt )               \\ /* 消息个数 */
4. U32 name [4 + cnt]

复制代码

函数描述：
函数os_mbx_declare定义了消息邮箱的大小和消息邮箱名，用于消息邮箱的初始化。其实就是通过宏定义的方式定义了一个数组U32类型的数组name[4 + cnt]。定义成32位数组是因为CM3/CM4是32位机，地址也就是32位的，从而指针变量也就是固定的32位变量。RTX的消息邮箱传递的是变量的地址，而不是变量的内容，所以要将邮箱定义成32位数组。
u 第1个参数表示定义的消息邮箱名。
u 第2个参数是邮箱支持的消息个数。
一般的应用中，消息邮箱支持20个消息就够了。
使用举例：

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);

复制代码

16.2.2 函数os_mbx_init


函数原型：

1. void os_mbx_init (
2.     OS_ID mailbox,       /* 消息邮箱的ID标识 */
3.     U16   mbx_size );    /* 邮箱大小，单位字节 */

复制代码

函数描述：
函数os_mbx_init用于消息邮箱的初始化。其实就是将函数os_mbx_declare定义的数组进行初始化用于消息邮箱的FIFO。
u 第1个参数填写消息邮箱的ID标识，即函数os_mbx_declare第一个参数。
u 第2个参数填写函数os_mbx_declare定义的邮箱大小，单位字节。
使用举例：

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. /*
7. *********************************************************************************************************
8. *   函 数 名: AppObjCreate
9. *   功能说明: 创建任务通信机制
10. *   形    参: 无
11. *   返 回 值: 无
12. *********************************************************************************************************
13. */
14. static void AppObjCreate (void)
15. {
16.       /* 创建消息邮箱 */
17.       os_mbx_init (&mailbox, sizeof(mailbox));
18. }

复制代码

16.2.3 函数os_mbx_send


函数原型：

1. OS_RESULT os_mbx_send (
2.     OS_ID mailbox,        /* 消息邮箱ID标识 */
3.     void* message_ptr,    /* 消息指针，即数据的地址 */
4.     U16   timeout );      /* 超时时间设置 */

复制代码

函数描述：
函数os_mbx_send用于向消息邮箱存放数据指针，或者说数据地址。如果消息邮箱已经满了，调用此函数的任务将被挂起，等待消息邮箱可用，直到消息邮箱有空间可用或者超时时间溢出才会返回。
u 第1个参数填写消息邮箱的ID标识，即函数os_mbx_declare第一个参数。
u 第2个参数填写消息指针，即数据的地址。
u 第3个参数表示设置的等待时间，范围0-0xFFFF，当参数设置为0-0xFFFE时，表示等待这么多个时钟节拍，参数设置为0xFFFF时表示无限等待直到消息邮箱有可用的空间。
u 返回值OS_R_OK，表示消息指针成功放到消息邮箱中。
    返回值OS_R_TMO，表示消息邮箱已经满了，在设置的超时时间范围内也没有等到可用的空间。
使用这个函数要注意以下问题：
1.     使用此函数前一定要调用函数os_mbx_init进行初始化。
2.     此函数用于往消息邮箱放消息指针，另一个函数os_mbx_wait用于从消息邮箱取出消息指针，取出后相应的位置也就释放出来了，方便下次存放数据。
使用举例：

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. /*
7. *********************************************************************************************************
8. *   函 数 名: AppObjCreate
9. *   功能说明: 创建任务通信机制
10. *   形    参: 无
11. *   返 回 值: 无
12. *********************************************************************************************************
13. */
14. static void AppObjCreate (void)
15. {
16.       /* 创建消息邮箱 */
17.       os_mbx_init (&mailbox, sizeof(mailbox));
18. }
20. /*
21. *********************************************************************************************************
22. *    函 数 名: AppTaskUserIF
23. *    功能说明: 按键消息处理     
24. *    形    参: 无
25. *    返 回 值: 无
26. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
27. *********************************************************************************************************
28. */
29. __task void AppTaskUserIF(void)
30. {
31.      uint8_t ucMsg = 0;
32.      uint8_t ucKeyCode;
34.     while(1)
35.     {
36.          ucKeyCode = bsp_GetKey();
37.         
38.          if (ucKeyCode != KEY_NONE)
39.          {
40.               switch (ucKeyCode)
41.               {
42.                    /* K1键按下，打印调试说明 */
43.                    case KEY_DOWN_K1:
44.                        printf("K1键按下，使用MDK中自带的RTX调试组件，请务必使用MDK4.74版本进行调试\\r\\n");
45.                        break;  
47.                    /* K2键按下，向消息邮箱发送数据 */
48.                    case KEY_DOWN_K2:
49.                        ucMsg++;
50.    
51.                        /* 向消息邮箱发数据，如果消息邮箱满了，等待100个时钟节拍 */
52.                        if(os_mbx_send (&mailbox, &ucMsg, 100) != OS_R_OK)
53.                        {
54.                             /* 发送失败，即使等待了100个时钟节拍 */
55.                             printf("K2键按下，向消息邮箱发送数据失败，即使等待了100个时钟节拍\\r\\n");
56.                        }
57.                        else
58.                        {
59.                             /* 发送成功 */
60.                             printf("K2键按下，向消息邮箱发送数据成功\\r\\n");                          
61.                        }
63.                        break;
65.                    /* 其他的键值不处理 */
66.                    default:                    
67.                        break;
68.               }
69.          }
70.         
71.          os_dly_wait(20);
72.      }
73. }

复制代码

16.2.4 函数os_mbx_wait


函数原型：

1. OS_RESULT os_mbx_wait (
2.     OS_ID  mailbox,      /* 消息邮箱的ID标识 */
3.     void** message,      /* 存放消息指针的变量地址 */
4.     U16    timeout );    /* 超时时间设置 */

复制代码

函数描述：
函数os_mbx_wait用于从消息邮箱中获取消息。如果消息邮箱为空，调用此函数的任务将被挂起，直到消息邮箱有消息可用或是设置的超时时间溢出才会返回。
u 第1个参数填写消息邮箱的ID标识，即函数os_mbx_declare第一个参数。
u 第2个参数填写从消息邮箱中获取消息后，存放消息的指针变量。
u 第3个参数表示设置的等待时间，范围0-0xFFFF，当参数设置为0-0xFFFE时，表示等待这么多个时钟节拍，参数设置为0xFFFF时表示无限等待直到消息邮箱有消息。
u 返回值OS_R_OK，表示从消息邮箱中有消息，立即从消息邮箱中获得消息，无需等待。。
    返回值OS_R_TMO，表示消息邮箱为空，在设置的超时时间范围内也没有等到消息。
    返回值OS_R_MBX，表示在设置的超时时间范围内收到消息。
使用这个函数要注意以下问题：
1.     使用此函数前一定要调用函数os_mbx_init进行初始化。
2.     此函数用于往消息邮箱放消息指针，另一个函数os_mbx_wait用于从消息邮箱取出消息指针，取出后相应的位置也就释放出来了，方便下次存放数据。
使用举例：

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. /*
7. *********************************************************************************************************
8. *   函 数 名: AppObjCreate
9. *   功能说明: 创建任务通信机制
10. *   形    参: 无
11. *   返 回 值: 无
12. *********************************************************************************************************
13. */
14. static void AppObjCreate (void)
15. {
16.       /* 创建消息邮箱 */
17.       os_mbx_init (&mailbox, sizeof(mailbox));
18. }
20. /*
21. *********************************************************************************************************
22. *    函 数 名: AppTaskMsgPro
23. *    功能说明: 消息处理，等待任务AppTaskUserIF发来的消息邮箱数据
24. *    形    参: 无
25. *    返 回 值: 无
26. *   优 先 级: 3
27. *********************************************************************************************************
28. */
29. __task void AppTaskMsgPro(void)
30. {
31.      uint8_t *pMsg;
32.      OS_RESULT xResult;
33.      const uint16_t usMaxBlockTime = 200; /* 延迟周期 */
34.    
35.     while(1)
36.     {
37.          xResult = os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime);
38.         
39.          switch (xResult)
40.          {
41.               /* 无需等待接受到消息邮箱数据 */
42.               case OS_R_OK:
43.                    printf("无需等待接受到消息邮箱数据，pMsg = %d\\r\\n", *pMsg);
44.                    break;  
46.               /* 消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据 */
47.               case OS_R_MBX:
48.                    printf("消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据，pMsg = %d\\r\\n", *pMsg);
49.                    break;
51.               /* 超时 */
52.               case OS_R_TMO:
53.                    bsp_LedToggle(1);
54.                    bsp_LedToggle(4);
55.                    break;
56.             
57.               /* 其他值不处理 */
58.               default:                    
59.                    break;
60.          }   
61.     }
62. }

复制代码

这里对函数os_mbx_wait的第二个参数再做一下解释。
u  定义一个指针变量uint8_t *pMsg，含义：pMsg是指向uint8_t型变量的指针变量。
u  指针变量pMsg（注意，这里说的是pMsg，不是*pMsg，前面没有*号）在内存中也是要占空间的，对于CM3/CM4内核来说是占用4个字节。指针变量pMsg里面存储的就是从消息邮箱中获取的消息指针，或者说消息地址。从而*pMsg就是pMsg所指向存储单元的实际内容。
u  由于函数os_mbx_wait第二个参数是void **message，有两级指针，所以填写的时候要填写成
os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime)。&pMsg就是表示指针变量在内存所在的地址。
u  这里再说说void 指针类型，使用void指针类型可定义一个指针变量，但不指定它是指向哪一种类型的数据。用户在使用这种类型指针变量时可以用来指向一个抽象的类型的数据，在将它的值赋值给另一个指针变量时要进行强制类型转换使之适合于被赋值的变量的类型。比如：
      char *p1;
       void *p2;
      p1 = (char *)p2
     如果细心的同学会发现，邮箱发送函数os_mbx_send和接收函数os_mbx_wait消息指针传递都是用的void指针类型，这样就给消息数据传递带来了极大的方便，方便在哪里了呢？这样的话使用消息邮箱传递任意数据类型变量都变的十分方便，用户只需做一下强制类型转换即可。

16.2.5 函数isr_mbx_check


函数原型：

1. OS_RESULT isr_mbx_check (
2.     OS_ID mailbox );    /*消息邮箱的ID标识*/

复制代码

函数描述：
函数isr_mbx_check用来检测消息邮箱剩余空间可以存储的消息个数。建议配合函数isr_mbx_send一起使用。
u 第1个参数填写消息邮箱的ID标识，即函数os_mbx_declare第一个参数。
u 函数返回消息邮箱剩余空间可以存储的消息个数。
使用这个函数要注意以下问题：
1.     使用此函数前一定要调用函数os_mbx_init进行初始化。
2.     此函数只能在中断服务程序中调用。
使用举例：
u 在中断服务程序中仅发一个消息

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. static void AppObjCreate (void)
7. {
8.     /* 创建消息邮箱 */
9.     os_mbx_init (&mailbox, sizeof(mailbox));
10. }
12. void EXTI0_IRQHandler (void){
13.    ..
14. if (isr_mbx_check (&mailbox) != 0) {
15.       isr_mbx_send (&mailbox, msg);
16.    }
17.    ..
18. }

复制代码

u 在中断服务程序中发多个消息

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. static void AppObjCreate (void)
7. {
8.     /* 创建消息邮箱 */
9.     os_mbx_init (&mailbox, sizeof(mailbox));
10. }
12. void EXTI0_IRQHandler (void){
13.   int i,free;
14.    ..
15.   free = isr_mbx_check (&mailbox1);
16.   for (i = 0; i < 16; i++) {
17.     if (free > 0) {
18.       free--;
19.       isr_mbx_send (&mailbox1, msg);
20.     }
21.   }
22.    ..
24. }

复制代码

16.2.6 函数isr_mbx_send


函数原型：  

1. void isr_mbx_send (
2.     OS_ID mailbox,          /*消息邮箱的ID标识*/
3.     void* message_ptr );    /* 消息指针，即数据的地址*/

复制代码

函数描述：
函数isr_mbx_send用于向消息邮箱存放数据指针，或者说数据地址。如果消息邮箱已经满了，再次调用此函数会造成消息邮箱溢出。所以调用此函数前，强烈建议调用函数isr_mbx_check进行检测，检测是否还有空间可用。
u 第1个参数填写消息邮箱的ID标识，即函数os_mbx_declare第一个参数。
u 第2个参数填写消息指针，即数据的地址。
使用这个函数要注意以下问题：
1.     使用此函数前一定要调用函数os_mbx_init进行初始化。
2.     为了防止消息邮箱溢出，强烈建议调用此函数前，先调用函数isr_mbx_check进行检测，检测是否还有空间可用。
使用举例：
u 在中断服务程序中仅发一个消息

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. static void AppObjCreate (void)
7. {
8.     /* 创建消息邮箱 */
9.     os_mbx_init (&mailbox, sizeof(mailbox));
10. }
12. void EXTI0_IRQHandler (void){
13.    ..
14. if (isr_mbx_check (&mailbox) != 0) {
15.       isr_mbx_send (&mailbox, msg);
16.    }
17.    ..
18. }

复制代码

u 在中断服务程序中发多个消息

1. #include <rtl.h>
3. /* 声明一个支持10个消息的消息邮箱 */
4. os_mbx_declare (mailbox, 10);
6. static void AppObjCreate (void)
7. {
8.     /* 创建消息邮箱 */
9.     os_mbx_init (&mailbox, sizeof(mailbox));
10. }
12. void EXTI0_IRQHandler (void){
13.   int i,free;
14.    ..
15.   free = isr_mbx_check (&mailbox1);
16.   for (i = 0; i < 16; i++) {
17.     if (free > 0) {
18.       free--;
19.       isr_mbx_send (&mailbox1, msg);
20.     }
21.   }
22.    ..
24. }

复制代码

席萌0209

16.3   实验例程说明(任务间通信)

16.3.1 STM32F103开发板实验

配套例子：
    V4-414_RTX实验_消息邮箱
实验目的：
    1.     学习RTX的消息邮箱。
    2.     RTX的消息邮箱等同于uCOS的消息队列，uCOS的消息邮箱仅支持一个消息的收发。
实验内容：
    1. K1按键按下，串口打印。
    2. K2键按下，向消息邮箱发送数据。任务AppTaskMsgPro接收到消息后进行消息处理。
    3. 各个任务实现的功能如下：
      AppTaskUserIF任务   ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：消息处理，等待任务AppTaskUserIF发来的消息邮箱数据。
      AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
RTX配置：
    RTX配置向导详情如下：

u  Task Configuration
l Number of concurrent running tasks
    允许创建4个任务，实际创建了如下四个任务
                    AppTaskUserIF任务   ：按键消息处理。
                    AppTaskLED任务     ：LED闪烁。
                    AppTaskMsgPro任务 ：消息处理，等待任务AppTaskUserIF发来的消息邮箱数据。
                    AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
l Number of tasks with user-provided stack
    创建的4个任务都是采用自定义堆栈方式。
RTX任务调试信息：

程序设计：
u  任务栈大小分配：
    staticuint64_t AppTaskUserIFStk[512/8];   /* 任务栈 */
    staticuint64_t AppTaskLEDStk[256/8];      /* 任务栈 */
    staticuint64_t AppTaskMsgProStk[512/8];  /* 任务栈 */
    staticuint64_t AppTaskStartStk[512/8];     /* 任务栈 */
      将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数，浮点运算和uint64_t类型数据运算会出问题。
u  系统栈大小分配：

u  RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,             /* 任务函数 */
16.                        4,                        /* 任务优先级 */
17.                        &AppTaskStartStk,         /* 任务栈 */
18.                        sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

u  RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25. }

复制代码

u  创建消息邮箱：

1. /* 声明一个支持10个消息的消息邮箱 */
2. os_mbx_declare (mailbox, 10);
4. /*
5. *********************************************************************************************************
6. *    函 数 名: AppObjCreate
7. *    功能说明: 创建任务通信机制
8. *    形    参: 无
9. *    返 回 值: 无
10. *********************************************************************************************************
11. */
12. static void AppObjCreate (void)
13. {
14.      /* 创建消息邮箱 */
15.       os_mbx_init (&mailbox, sizeof(mailbox));
17. }

复制代码

u  四个RTX任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskUserIF
4. *    功能说明: 按键消息处理     
5. *    形    参: 无
6. *    返 回 值: 无
7. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
8. *********************************************************************************************************
9. */
10. __task void AppTaskUserIF(void)
11. {
12.      uint8_t ucMsg = 0;
13.      uint8_t ucKeyCode;
15.     while(1)
16.     {
17.          ucKeyCode = bsp_GetKey();
18.         
19.          if (ucKeyCode != KEY_NONE)
20.          {
21.               switch (ucKeyCode)
22.               {
23.                    /* K1键按下，打印调试说明 */
24.                    case KEY_DOWN_K1:
25.                        printf("K1键按下，使用MDK中自带的RTX调试组件，请务必使用MDK4.74版本进行调试\\r\\n");
26.                        break;  
28.                    /* K2键按下，向消息邮箱发送数据 */
29.                    case KEY_DOWN_K2:
30.                        ucMsg++;
31.    
32.                        /* 向消息邮箱发数据，如果消息邮箱满了，等待100个时钟节拍 */
33.                        if(os_mbx_send (&mailbox, &ucMsg, 100) != OS_R_OK)
34.                        {
35.                             /* 发送失败，即使等待了100个时钟节拍 */
36.                             printf("K2键按下，向消息邮箱发送数据失败，即使等待了100个时钟节拍\\r\\n");
37.                        }
38.                         else
39.                        {
40.                             /* 发送成功 */
41.                             printf("K2键按下，向消息邮箱发送数据成功\\r\\n");                          
42.                        }
44.                        break;
46.                    /* 其他的键值不处理 */
47.                    default:                    
48.                        break;
49.               }
50.          }
51.         
52.          os_dly_wait(20);
53.      }
54. }
56. /*
57. *********************************************************************************************************
58. *    函 数 名: AppTaskLED
59. *    功能说明: LED闪烁。
60. *    形    参: 无
61. *    返 回 值: 无
62. *   优 先 级: 2
63. *********************************************************************************************************
64. */
65. __task void AppTaskLED(void)
66. {
67.      const uint16_t usFrequency = 200; /* 延迟周期 */
68.    
69.      /* 设置延迟周期 */
70.      os_itv_set(usFrequency);
71.    
72.     while(1)
73.     {
74.          bsp_LedToggle(2);
75.          bsp_LedToggle(3);
77.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
78.          os_itv_wait();
79.     }
80. }
82. /*
83. *********************************************************************************************************
84. *    函 数 名: AppTaskMsgPro
85. *    功能说明: 消息处理，等待任务AppTaskUserIF发来的消息邮箱数据
86. *    形    参: 无
87. *    返 回 值: 无
88. *   优 先 级: 3
89. *********************************************************************************************************
90. */
91. __task void AppTaskMsgPro(void)
92. {
93.      uint8_t *pMsg;
94.      OS_RESULT xResult;
95.      const uint16_t usMaxBlockTime = 200; /* 延迟周期 */
96.    
97.     while(1)
98.     {
99.          xResult = os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime);
100.         
101.          switch (xResult)
102.          {
103.               /* 无需等待接受到消息邮箱数据 */
104.               case OS_R_OK:
105.                    printf("无需等待接受到消息邮箱数据，pMsg = %d\\r\\n", *pMsg);
106.                    break;  
108.               /* 消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据 */
109.               case OS_R_MBX:
110.                    printf("消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据，pMsg = %d\\r\\n", *pMsg);
111.                    break;
113.               /* 超时 */
114.               case OS_R_TMO:
115.                    bsp_LedToggle(1);
116.                    bsp_LedToggle(4);
117.                    break;
118.             
119.               /* 其他值不处理 */
120.               default:                    
121.                    break;
122.          }   
123.     }
124. }
126. /*
127. *********************************************************************************************************
128. *    函 数 名: AppTaskStart
129. *    功能说明: 启动任务，也就是最高优先级任务。这里实现按键扫描。
130. *    形    参: 无
131. *    返 回 值: 无
132. *   优 先 级: 4
133. *********************************************************************************************************
134. */
135. __task void AppTaskStart(void)
136. {
137.      /* 创建任务 */
138.      AppTaskCreate();
139.    
140.      /* 创建任务通信机制 */
141.      AppObjCreate();
142.    
143.     while(1)
144.     {
145.         /* 按键扫描 */
146.         bsp_KeyScan();
147.         os_dly_wait(10);
148.     }
149. }

复制代码

16.3.2 STM32F407开发板实验

配套例子：
    V5-414_RTX实验_消息邮箱
实验目的：
    1.     学习RTX的消息邮箱。
    2.     RTX的消息邮箱等同于uCOS的消息队列，uCOS的消息邮箱仅支持一个消息的收发。
实验内容：
    1. K1按键按下，串口打印。
    2. K2键按下，向消息邮箱发送数据。任务AppTaskMsgPro接收到消息后进行消息处理。
    3. 各个任务实现的功能如下：
      AppTaskUserIF任务   ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：消息处理，等待任务AppTaskUserIF发来的消息邮箱数据。
      AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
RTX配置：
    RTX配置向导详情如下：

u  Task Configuration
l Number of concurrent running tasks
    允许创建4个任务，实际创建了如下四个任务
                    AppTaskUserIF任务   ：按键消息处理。
                    AppTaskLED任务     ：LED闪烁。
                    AppTaskMsgPro任务 ：消息处理，等待任务AppTaskUserIF发来的消息邮箱数据。
                    AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
l Number of tasks with user-provided stack
     创建的4个任务都是采用自定义堆栈方式。
RTX任务调试信息：

程序设计：
u  任务栈大小分配：
    staticuint64_t AppTaskUserIFStk[512/8];   /* 任务栈 */
    staticuint64_t AppTaskLEDStk[256/8];      /* 任务栈 */
    staticuint64_t AppTaskMsgProStk[512/8];  /* 任务栈 */
    staticuint64_t AppTaskStartStk[512/8];     /* 任务栈 */
      将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数，浮点运算和uint64_t类型数据运算会出问题。
u  系统栈大小分配：

u  RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,             /* 任务函数 */
16.                        4,                        /* 任务优先级 */
17.                        &AppTaskStartStk,         /* 任务栈 */
18.                        sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

u  RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25. }

复制代码

u  创建消息邮箱：

1. /* 声明一个支持10个消息的消息邮箱 */
2. os_mbx_declare (mailbox, 10);
4. /*
5. *********************************************************************************************************
6. *    函 数 名: AppObjCreate
7. *    功能说明: 创建任务通信机制
8. *    形    参: 无
9. *    返 回 值: 无
10. *********************************************************************************************************
11. */
12. static void AppObjCreate (void)
13. {
14.      /* 创建消息邮箱 */
15.       os_mbx_init (&mailbox, sizeof(mailbox));
17. }

复制代码

u  四个RTX任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskUserIF
4. *    功能说明: 按键消息处理     
5. *    形    参: 无
6. *    返 回 值: 无
7. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
8. *********************************************************************************************************
9. */
10. __task void AppTaskUserIF(void)
11. {
12.      uint8_t ucMsg = 0;
13.      uint8_t ucKeyCode;
15.     while(1)
16.     {
17.          ucKeyCode = bsp_GetKey();
18.         
19.          if (ucKeyCode != KEY_NONE)
20.          {
21.               switch (ucKeyCode)
22.               {
23.                    /* K1键按下，打印调试说明 */
24.                    case KEY_DOWN_K1:
25.                        printf("K1键按下，使用MDK中自带的RTX调试组件，请务必使用MDK4.74版本进行调试\\r\\n");
26.                        break;  
28.                    /* K2键按下，向消息邮箱发送数据 */
29.                    case KEY_DOWN_K2:
30.                        ucMsg++;
31.    
32.                        /* 向消息邮箱发数据，如果消息邮箱满了，等待100个时钟节拍 */
33.                        if(os_mbx_send (&mailbox, &ucMsg, 100) != OS_R_OK)
34.                        {
35.                             /* 发送失败，即使等待了100个时钟节拍 */
36.                             printf("K2键按下，向消息邮箱发送数据失败，即使等待了100个时钟节拍\\r\\n");
37.                        }
38.                        else
39.                        {
40.                             /* 发送成功 */
41.                             printf("K2键按下，向消息邮箱发送数据成功\\r\\n");                          
42.                        }
44.                        break;
46.                    /* 其他的键值不处理 */
47.                    default:                    
48.                        break;
49.               }
50.          }
51.         
52.          os_dly_wait(20);
53.      }
54. }
56. /*
57. *********************************************************************************************************
58. *    函 数 名: AppTaskLED
59. *    功能说明: LED闪烁。
60. *    形    参: 无
61. *    返 回 值: 无
62. *   优 先 级: 2
63. *********************************************************************************************************
64. */
65. __task void AppTaskLED(void)
66. {
67.      const uint16_t usFrequency = 200; /* 延迟周期 */
68.    
69.      /* 设置延迟周期 */
70.      os_itv_set(usFrequency);
71.    
72.     while(1)
73.     {
74.          bsp_LedToggle(2);
75.          bsp_LedToggle(3);
77.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
78.          os_itv_wait();
79.     }
80. }
82. /*
83. *********************************************************************************************************
84. *    函 数 名: AppTaskMsgPro
85. *    功能说明: 消息处理，等待任务AppTaskUserIF发来的消息邮箱数据
86. *    形    参: 无
87. *    返 回 值: 无
88. *   优 先 级: 3
89. *********************************************************************************************************
90. */
91. __task void AppTaskMsgPro(void)
92. {
93.      uint8_t *pMsg;
94.      OS_RESULT xResult;
95.      const uint16_t usMaxBlockTime = 200; /* 延迟周期 */
96.    
97.     while(1)
98.     {
99.          xResult = os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime);
100.         
101.          switch (xResult)
102.          {
103.               /* 无需等待接受到消息邮箱数据 */
104.               case OS_R_OK:
105.                    printf("无需等待接受到消息邮箱数据，pMsg = %d\\r\\n", *pMsg);
106.                    break;  
108.               /* 消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据 */
109.               case OS_R_MBX:
110.                    printf("消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据，pMsg = %d\\r\\n", *pMsg);
111.                    break;
113.               /* 超时 */
114.               case OS_R_TMO:
115.                    bsp_LedToggle(1);
116.                    bsp_LedToggle(4);
117.                    break;
118.             
119.               /* 其他值不处理 */
120.               default:                    
121.                    break;
122.          }   
123.     }
124. }
126. /*
127. *********************************************************************************************************
128. *    函 数 名: AppTaskStart
129. *    功能说明: 启动任务，也就是最高优先级任务。这里实现按键扫描。
130. *    形    参: 无
131. *    返 回 值: 无
132. *   优 先 级: 4
133. *********************************************************************************************************
134. */
135. __task void AppTaskStart(void)
136. {
137.      /* 创建任务 */
138.      AppTaskCreate();
139.    
140.      /* 创建任务通信机制 */
141.      AppObjCreate();
142.    
143.     while(1)
144.     {
145.         /* 按键扫描 */
146.         bsp_KeyScan();
147.         os_dly_wait(10);
148.     }
149. }

复制代码

席萌0209

16.4 实验例程说明（中断方式通信）

16.4.1 STM32F103开发板实验

配套例子：
      V4-415_RTX实验_消息邮箱（中断方式）
实验目的：
    1.     学习RTX的消息邮箱（中断方式）
实验内容：
    1.K1按键按下，串口打印。
    2.K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消息邮箱数据。任务AppTaskMsgPro接收到消息后进行消息处理。
     3.各个任务实现的功能如下：
      AppTaskUserIF任务  ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：消息处理，等待定时器中断发来的消息邮箱数据。
      AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
RTX配置：
     RTX配置向导详情如下：

u  Task Configuration
l Number of concurrent running tasks
    允许创建4个任务，实际创建了如下四个任务
                    AppTaskUserIF任务   ：按键消息处理。
                    AppTaskLED任务     ：LED闪烁。
                    AppTaskMsgPro任务 ：消息处理，等待定时器中断发来的消息邮箱数据。
                    AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
l Number of tasks with user-provided stack
    创建的4个任务都是采用自定义堆栈方式。
RTX任务调试信息：

程序设计：
u  任务栈大小分配：
    staticuint64_t AppTaskUserIFStk[512/8];   /* 任务栈 */
    staticuint64_t AppTaskLEDStk[256/8];      /* 任务栈 */
    staticuint64_t AppTaskMsgProStk[512/8];  /* 任务栈 */
    staticuint64_t AppTaskStartStk[512/8];     /* 任务栈 */
      将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数，浮点运算和uint64_t类型数据运算会出问题。
u  系统栈大小分配：

u  RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,             /* 任务函数 */
16.                        4,                        /* 任务优先级 */
17.                        &AppTaskStartStk,         /* 任务栈 */
18.                        sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

u  RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25. }

复制代码

u  创建消息邮箱：

1. /* 声明一个支持10个消息的消息邮箱 */
2. os_mbx_declare (mailbox, 10);
4. /*
5. *********************************************************************************************************
6. *    函 数 名: AppObjCreate
7. *    功能说明: 创建任务通信机制
8. *    形    参: 无
9. *    返 回 值: 无
10. *********************************************************************************************************
11. */
12. static void AppObjCreate (void)
13. {
14.      /* 创建消息邮箱 */
15.       os_mbx_init (&mailbox, sizeof(mailbox));
17. }

复制代码

u  四个RTX任务的实现：

1. /*
2. /*
3. *********************************************************************************************************
4. *    函 数 名: AppTaskUserIF
5. *    功能说明: 按键消息处理     
6. *    形    参: 无
7. *    返 回 值: 无
8. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
9. *********************************************************************************************************
10. */
11. __task void AppTaskUserIF(void)
12. {
13.      uint8_t ucKeyCode;
15.     while(1)
16.     {
17.          ucKeyCode = bsp_GetKey();
18.         
19.          if (ucKeyCode != KEY_NONE)
20.          {
21.               switch (ucKeyCode)
22.               {
23.                    /* K1键按下，打印调试说明 */
24.                    case KEY_DOWN_K1:
25.                        printf("K1键按下，使用MDK中自带的RTX调试组件，请务必使用MDK4.74版本进行调试\\r\\n");
26.                        break;  
27.                   
28.                    /* K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消息邮箱数据 */
29.                    case KEY_DOWN_K2:
30.                        printf("K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消
31. 息邮箱数据\\r\\n");
32.                        bsp_StartHardTimer(1 ,50000, (void *)TIM_CallBack1);
33.                        break;
35.                    /* 其他的键值不处理 */
36.                    default:                     
37.                        break;
38.               }
39.          }
40.         
41.          os_dly_wait(20);
42.      }
43. }
45. /*
46. *********************************************************************************************************
47. *    函 数 名: AppTaskLED
48. *    功能说明: LED闪烁。
49. *    形    参: 无
50. *    返 回 值: 无
51. *   优 先 级: 2
52. *********************************************************************************************************
53. */
54. __task void AppTaskLED(void)
55. {
56.      const uint16_t usFrequency = 200; /* 延迟周期 */
57.    
58.      /* 设置延迟周期 */
59.      os_itv_set(usFrequency);
60.    
61.     while(1)
62.     {
63.          bsp_LedToggle(2);
64.          bsp_LedToggle(3);
66.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
67.          os_itv_wait();
68.     }
69. }
71. /*
72. *********************************************************************************************************
73. *    函 数 名: AppTaskMsgPro
74. *    功能说明: 消息处理，等待定时器中断发来的消息邮箱数据
75. *    形    参: 无
76. *    返 回 值: 无
77. *   优 先 级: 3
78. *********************************************************************************************************
79. */
80. __task void AppTaskMsgPro(void)
81. {
82.      uint8_t *pMsg;
83.      OS_RESULT xResult;
84.      const uint16_t usMaxBlockTime = 200; /* 延迟周期 */
85.    
86.     while(1)
87.     {
88.          xResult = os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime);
89.         
90.          switch (xResult)
91.          {
92.               /* 无需等待接受到消息邮箱数据 */
93.               case OS_R_OK:
94.                    printf("无需等待接受到消息邮箱数据，pMsg = %d\\r\\n", *pMsg);
95.                    break;  
97.               /* 消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据 */
98.               case OS_R_MBX:
99.                    printf("消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据，pMsg = %d\\r\\n", *pMsg);
100.                    break;
102.               /* 超时 */
103.               case OS_R_TMO:
104.                    bsp_LedToggle(1);
105.                    bsp_LedToggle(4);
106.                    break;
107.             
108.               /* 其他值不处理 */
109.               default:                    
110.                    break;
111.          }   
112.     }
113. }
115. /*
116. *********************************************************************************************************
117. *    函 数 名: AppTaskStart
118. *    功能说明: 启动任务，也就是最高优先级任务。这里实现按键扫描。
119. *    形    参: 无
120. *    返 回 值: 无
121. *   优 先 级: 4
122. *********************************************************************************************************
123. */
124. __task void AppTaskStart(void)
125. {
126.      /* 创建任务 */
127.      AppTaskCreate();
128.    
129.      /* 创建任务通信机制 */
130.      AppObjCreate();
131.    
132.     while(1)
133.     {
134.          /* 按键扫描 */
135.          bsp_KeyScan();
136.         os_dly_wait(10);
137.     }
138. }

复制代码

u  定时器中断回调函数中实现消息邮箱数据发送：
    定时器中断的初始化和中断函数在bsp_timer.c文件中实现，这个不是教程的重点，故不作介绍。这里主要关心RTX的消息邮箱函数在中断服务程序中的使用方法。

1. /* 特别注意，RTX消息邮箱传递的是地址。
2.    所以不要将变量定义放在中断程序中，退出中断后变量空间会释放给系统堆栈。
3. */
4. static uint8_t s_ucCount = 0;
5. static void TIM_CallBack1(void)
6. {
7.      /* 如果消息邮箱还有空间，向消息邮箱发送数据 */
8.      if (isr_mbx_check (&mailbox) != 0)
9.      {
10.          s_ucCount++;
11.          isr_mbx_send (&mailbox, &s_ucCount);     
12.      }
13. }

复制代码

16.4.2 STM32F407开发板实验

配套例子：
     V5-415_RTX实验_消息邮箱（中断方式）
实验目的：
    1.     学习RTX的消息邮箱（中断方式）
实验内容：
    1.K1按键按下，串口打印。
    2.K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消息邮箱数据。任务AppTaskMsgPro接收到消息后进行消息处理。
    3.各个任务实现的功能如下：
      AppTaskUserIF任务  ：按键消息处理。
      AppTaskLED任务     ：LED闪烁。
      AppTaskMsgPro任务 ：消息处理，等待定时器中断发来的消息邮箱数据。
      AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
RTX配置：
RTX配置向导详情如下：

u  Task Configuration
l Number of concurrent running tasks
    允许创建4个任务，实际创建了如下四个任务
                    AppTaskUserIF任务   ：按键消息处理。
                    AppTaskLED任务     ：LED闪烁。
                    AppTaskMsgPro任务 ：消息处理，等待定时器中断发来的消息邮箱数据。
                    AppTaskStart任务    ：启动任务，也是最高优先级任务，这里实现按键扫描。
l Number of tasks with user-provided stack
    创建的4个任务都是采用自定义堆栈方式。
RTX任务调试信息：

程序设计：
u  任务栈大小分配：
    staticuint64_t AppTaskUserIFStk[512/8];   /* 任务栈 */
    staticuint64_t AppTaskLEDStk[256/8];      /* 任务栈 */
    staticuint64_t AppTaskMsgProStk[512/8];  /* 任务栈 */
    staticuint64_t AppTaskStartStk[512/8];     /* 任务栈 */
      将任务栈定义成uint64_t类型可以保证任务栈是8字节对齐的，8字节对齐的含义就是数组的首地址对8求余等于0。如果不做8字节对齐的话，部分C语言库函数，浮点运算和uint64_t类型数据运算会出问题。
u  系统栈大小分配：

u  RTX初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
13.    
14.      /* 创建启动任务 */
15.      os_sys_init_user (AppTaskStart,             /* 任务函数 */
16.                        4,                        /* 任务优先级 */
17.                        &AppTaskStartStk,         /* 任务栈 */
18.                        sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
19.      while(1);
20. }

复制代码

u  RTX任务创建：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskCreate
4. *    功能说明: 创建应用任务
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. static void AppTaskCreate (void)
10. {
11.      HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
12.                                            1,                         /* 任务优先级 */
13.                                            &AppTaskUserIFStk,         /* 任务栈 */
14.                                            sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
15.    
16.      HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
17.                                         2,                       /* 任务优先级 */
18.                                         &AppTaskLEDStk,          /* 任务栈 */
19.                                         sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
20.    
21.      HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
22.                                            3,                         /* 任务优先级 */
23.                                            &AppTaskMsgProStk,         /* 任务栈 */
24.                                            sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
25. }

复制代码

u  创建消息邮箱：

1. /* 声明一个支持10个消息的消息邮箱 */
2. os_mbx_declare (mailbox, 10);
4. /*
5. *********************************************************************************************************
6. *    函 数 名: AppObjCreate
7. *    功能说明: 创建任务通信机制
8. *    形    参: 无
9. *    返 回 值: 无
10. *********************************************************************************************************
11. */
12. static void AppObjCreate (void)
13. {
14.      /* 创建消息邮箱 */
15.       os_mbx_init (&mailbox, sizeof(mailbox));
17. }

复制代码

u  四个RTX任务的实现：

1. /*
2. /*
3. *********************************************************************************************************
4. *    函 数 名: AppTaskUserIF
5. *    功能说明: 按键消息处理     
6. *    形    参: 无
7. *    返 回 值: 无
8. *   优 先 级: 1  (数值越小优先级越低，这个跟uCOS相反)
9. *********************************************************************************************************
10. */
11. __task void AppTaskUserIF(void)
12. {
13.      uint8_t ucKeyCode;
15.     while(1)
16.     {
17.          ucKeyCode = bsp_GetKey();
18.         
19.          if (ucKeyCode != KEY_NONE)
20.          {
21.               switch (ucKeyCode)
22.               {
23.                    /* K1键按下，打印调试说明 */
24.                    case KEY_DOWN_K1:
25.                        printf("K1键按下，使用MDK中自带的RTX调试组件，请务必使用MDK4.74版本进行调试\\r\\n");
26.                        break;  
27.                   
28.                    /* K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消息邮箱数据 */
29.                    case KEY_DOWN_K2:
30.                        printf("K2键按下，启动单次定时器中断，50ms后在定时器中断给任务AppTaskMsgPro发送消
31. 息邮箱数据\\r\\n");
32.                        bsp_StartHardTimer(1 ,50000, (void *)TIM_CallBack1);
33.                        break;
35.                    /* 其他的键值不处理 */
36.                    default:                    
37.                        break;
38.               }
39.          }
40.         
41.          os_dly_wait(20);
42.      }
43. }
45. /*
46. *********************************************************************************************************
47. *    函 数 名: AppTaskLED
48. *    功能说明: LED闪烁。
49. *    形    参: 无
50. *    返 回 值: 无
51. *   优 先 级: 2
52. *********************************************************************************************************
53. */
54. __task void AppTaskLED(void)
55. {
56.      const uint16_t usFrequency = 200; /* 延迟周期 */
57.    
58.      /* 设置延迟周期 */
59.      os_itv_set(usFrequency);
60.    
61.     while(1)
62.     {
63.          bsp_LedToggle(2);
64.          bsp_LedToggle(3);
66.          /* os_itv_wait是绝对延迟，os_dly_wait是相对延迟。*/
67.          os_itv_wait();
68.     }
69. }
71. /*
72. *********************************************************************************************************
73. *    函 数 名: AppTaskMsgPro
74. *    功能说明: 消息处理，等待定时器中断发来的消息邮箱数据
75. *    形    参: 无
76. *    返 回 值: 无
77. *   优 先 级: 3
78. *********************************************************************************************************
79. */
80. __task void AppTaskMsgPro(void)
81. {
82.      uint8_t *pMsg;
83.      OS_RESULT xResult;
84.      const uint16_t usMaxBlockTime = 200; /* 延迟周期 */
85.    
86.     while(1)
87.     {
88.          xResult = os_mbx_wait(&mailbox, (void *)&pMsg, usMaxBlockTime);
89.         
90.          switch (xResult)
91.          {
92.               /* 无需等待接受到消息邮箱数据 */
93.               case OS_R_OK:
94.                    printf("无需等待接受到消息邮箱数据，pMsg = %d\\r\\n", *pMsg);
95.                    break;  
97.               /* 消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据 */
98.               case OS_R_MBX:
99.                    printf("消息邮箱空，usMaxBlockTime等待时间从消息邮箱内获得数据，pMsg = %d\\r\\n", *pMsg);
100.                   break;
102.               /* 超时 */
103.               case OS_R_TMO:
104.                    bsp_LedToggle(1);
105.                    bsp_LedToggle(4);
106.                    break;
107.             
108.               /* 其他值不处理 */
109.               default:                    
110.                    break;
111.          }   
112.     }
113. }
115. /*
116. *********************************************************************************************************
117. *    函 数 名: AppTaskStart
118. *    功能说明: 启动任务，也就是最高优先级任务。这里实现按键扫描。
119. *    形    参: 无
120. *    返 回 值: 无
121. *   优 先 级: 4
122. *********************************************************************************************************
123. */
124. __task void AppTaskStart(void)
125. {
126.      /* 创建任务 */
127.      AppTaskCreate();
128.    
129.      /* 创建任务通信机制 */
130.      AppObjCreate();
131.    
132.     while(1)
133.     {
134.          /* 按键扫描 */
135.          bsp_KeyScan();
136.         os_dly_wait(10);
137.     }
138. }

复制代码

u  定时器中断回调函数中实现消息邮箱数据发送：
定时器中断的初始化和中断函数在bsp_timer.c文件中实现，这个不是教程的重点，故不作介绍。这里主要关心RTX的消息邮箱函数在中断服务程序中的使用方法。

1. /* 特别注意，RTX消息邮箱传递的是地址。
2.    所以不要将变量定义放在中断程序中，退出中断后变量空间会释放给系统堆栈。
3. */
4. static uint8_t s_ucCount = 0;
5. static void TIM_CallBack1(void)
6. {
7.      /* 如果消息邮箱还有空间，向消息邮箱发送数据 */
8.      if (isr_mbx_check (&mailbox) != 0)
9.      {
10.          s_ucCount++;
11.          isr_mbx_send (&mailbox, &s_ucCount);     
12.      }
13. }

复制代码

席萌0209

16.5 总结

    本章节就为大家讲解了消息邮箱的使用，在实际项目中，消息邮箱用到的地方非常多，希望初学者认真学习并掌握。