第16章 消息邮箱

RTX任务调试信息：

RTX任务调试信息：

RTX初始化：
复制代码
/*
*********************************************************************************************************
*    函 数 名: main
*    功能说明: 标准c程序入口。
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
int main (void)
{  
     /* 初始化外设 */
     bsp_Init();
   
     /* 创建启动任务 */
     os_sys_init_user (AppTaskStart,             /* 任务函数 */
                       4,                        /* 任务优先级 */
                       &AppTaskStartStk,         /* 任务栈 */
                       sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
     while(1);
}

RTX任务创建：
复制代码
/*
*********************************************************************************************************
*    函 数 名: AppTaskCreate
*    功能说明: 创建应用任务
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
static void AppTaskCreate (void)
{
     HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
                                           1,                         /* 任务优先级 */
                                           &AppTaskUserIFStk,         /* 任务栈 */
                                           sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
   
     HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
                                        2,                       /* 任务优先级 */
                                        &AppTaskLEDStk,          /* 任务栈 */
                                        sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
   
     HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
                                           3,                         /* 任务优先级 */
                                           &AppTaskMsgProStk,         /* 任务栈 */
                                           sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
}

创建消息邮箱：
复制代码
/* 声明一个支持10个消息的消息邮箱 */
os_mbx_declare (mailbox, 10);
/*
*********************************************************************************************************
*    函 数 名: AppObjCreate
*    功能说明: 创建任务通信机制
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
static void AppObjCreate (void)
{
     /* 创建消息邮箱 */
      os_mbx_init (&mailbox, sizeof(mailbox));
}

定时器中断回调函数中实现消息邮箱数据发送：
    定时器中断的初始化和中断函数在bsp_timer.c文件中实现，这个不是教程的重点，故不作介绍。这里主要关心RTX的消息邮箱函数在中断服务程序中的使用方法。
复制代码
/* 特别注意，RTX消息邮箱传递的是地址。
   所以不要将变量定义放在中断程序中，退出中断后变量空间会释放给系统堆栈。
*/
static uint8_t s_ucCount = 0;
static void TIM_CallBack1(void)
{
     /* 如果消息邮箱还有空间，向消息邮箱发送数据 */
     if (isr_mbx_check (&mailbox) != 0)
     {
         s_ucCount++;
         isr_mbx_send (&mailbox, &s_ucCount);   
     }
}

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  系统栈大小分配：

RTX初始化：
复制代码
/*
*********************************************************************************************************
*    函 数 名: main
*    功能说明: 标准c程序入口。
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
int main (void)
{  
     /* 初始化外设 */
     bsp_Init();
   
     /* 创建启动任务 */
     os_sys_init_user (AppTaskStart,             /* 任务函数 */
                       4,                        /* 任务优先级 */
                       &AppTaskStartStk,         /* 任务栈 */
                       sizeof(AppTaskStartStk)); /* 任务栈大小，单位字节数 */
     while(1);
}

RTX任务创建：
复制代码
/*
*********************************************************************************************************
*    函 数 名: AppTaskCreate
*    功能说明: 创建应用任务
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
static void AppTaskCreate (void)
{
     HandleTaskUserIF = os_tsk_create_user(AppTaskUserIF,             /* 任务函数 */
                                           1,                         /* 任务优先级 */
                                           &AppTaskUserIFStk,         /* 任务栈 */
                                           sizeof(AppTaskUserIFStk)); /* 任务栈大小，单位字节数 */
   
     HandleTaskLED = os_tsk_create_user(AppTaskLED,              /* 任务函数 */
                                        2,                       /* 任务优先级 */
                                        &AppTaskLEDStk,          /* 任务栈 */
                                        sizeof(AppTaskLEDStk));  /* 任务栈大小，单位字节数 */
   
     HandleTaskMsgPro = os_tsk_create_user(AppTaskMsgPro,             /* 任务函数 */
                                           3,                         /* 任务优先级 */
                                           &AppTaskMsgProStk,         /* 任务栈 */
                                           sizeof(AppTaskMsgProStk)); /* 任务栈大小，单位字节数 */
}

创建消息邮箱：
复制代码
/* 声明一个支持10个消息的消息邮箱 */
os_mbx_declare (mailbox, 10);
/*
*********************************************************************************************************
*    函 数 名: AppObjCreate
*    功能说明: 创建任务通信机制
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
static void AppObjCreate (void)
{
     /* 创建消息邮箱 */
      os_mbx_init (&mailbox, sizeof(mailbox));
}

定时器中断回调函数中实现消息邮箱数据发送：
定时器中断的初始化和中断函数在bsp_timer.c文件中实现，这个不是教程的重点，故不作介绍。这里主要关心RTX的消息邮箱函数在中断服务程序中的使用方法。
复制代码
/* 特别注意，RTX消息邮箱传递的是地址。
   所以不要将变量定义放在中断程序中，退出中断后变量空间会释放给系统堆栈。
*/
static uint8_t s_ucCount = 0;
static void TIM_CallBack1(void)
{
     /* 如果消息邮箱还有空间，向消息邮箱发送数据 */
     if (isr_mbx_check (&mailbox) != 0)
     {
         s_ucCount++;
         isr_mbx_send (&mailbox, &s_ucCount);   
     }
}

16.5 总结

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

分享完成，，，，，，，，，，，，