FreeRTOS--消息队列

在任何RTOS中，都具有一个重要的通信机制----消息队列。

队列是任务间通信的主要形式。它们可用于在任务之间、中断和任务之间发送消息。在大多数情况下，它们被用作线程安全的FIFO(先进先出)缓冲区，新数据被发送到队列的后面，不过数据也可以发送到前面。

消息队列的概念及其作用（以下基础内容转载自安富莱电子）

消息队列就是通过RTOS内核提供的服务，任务或中断服务子程序可以将一个消息（注意，FreeRTOS消息队列传递的是实际数据，并不是数据地址，RTX，uCOS-II和uCOS-III是传递的地址）放入到队列。同样，一个或者多个任务可以通过RTOS内核服务从队列中得到消息。通常，先进入消息队列的消息先传给任务，也就是说，任务先得到的是最先进入到消息队列的消息，即先进先出的原则（FIFO），FreeRTOS的消息队列支持FIFO和LIFO两种数据存取方式。 也许有不理解的初学者会问采用消息队列多麻烦，搞个全局数组不是更简单，其实不然。在裸机编程时，使用全局数组的确比较方便，但是在加上RTOS后就是另一种情况了。相比消息队列，使用全局数组主要有如下四个问题： 

♦使用消息队列可以让RTOS内核有效地管理任务，而全局数组是无法做到的，任务的超时等机制需要用户自己去实现。 

♦使用了全局数组就要防止多任务的访问冲突，而使用消息队列则处理好了这个问题，用户无需担心。 

♦使用消息队列可以有效地解决中断服务程序与任务之间消息传递的问题。 

♦FIFO机制更有利于数据的处理。

这里我将创建两个线程，monitor Task和  control Task 。通过monitor Task发送消息，control Task接受消息，根据消息类型打印不同的信息。

1.基于STM32Cube配置FreeRTOS,我这里是用的STM32F103RCT6，首先Enable FreeRTOS,配置RCC外部高速晶振8M HZ

 2.配置打印串口USART1，HAL时钟基准源TIM1,RTOS将systick作为时钟源。

 3.配置时钟树

 4.配置FreeRTOS

 

 5.生成代码配置

 

 生成的main主函数，System,GPIO,USART,FreeRTOS初始化，一旦启动线程调度，Task开始执行，main中的while不会进入。

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration----------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_USART1_UART_Init();
27
  /* Initialize interrupts */
  MX_NVIC_Init();
  /* USER CODE BEGIN 2 */
  printf("Test Message Queue!
");
  /* USER CODE END 2 */

  /* Call init function for freertos objects (in freertos.c) */
  MX_FREERTOS_Init();

  /* Start scheduler */
  osKernelStart();
  
  /* We should never get here as control is now taken by the scheduler */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {

  /* USER CODE END WHILE */

  /* USER CODE BEGIN 3 */

  }
  /* USER CODE END 3 */

}

定义消息结构：

/* USER CODE BEGIN Variables */
typedef enum _Msg_Type_
{
    MSG_TYPE_LED,
    MSG_TYPE_LED_TOGGLE,
    MSG_TYPE_BUZZER,
    MSG_TYPE_MAX
}MsgType;

typedef struct _Msg
{
    MsgType msgType;
    bool    bswitch;
}Msg;

17 /* USER CODE END Variables */

定义Debug_Printf用来打印串口信息

void  Debug_Printf(char *format, ...)
{
    char  buf_str[128];
    va_list   v_args;


    va_start(v_args, format);
   (void)vsnprintf((char       *)&buf_str[0],
                   (size_t      ) sizeof(buf_str),
                   (char const *) format,
                                  v_args);
    va_end(v_args);

    /* 互斥信号量 */
    osMutexWait(Mutex_printfHandle,osWaitForever);
    printf("[%ldms]%s",xTaskGetTickCount(),buf_str);
    osMutexRelease(Mutex_printfHandle);
}

FreeRTOS初始化

/* Init FreeRTOS */

void MX_FREERTOS_Init(void) {
  /* USER CODE BEGIN Init */
       
  /* USER CODE END Init */

  /* Create the mutex(es) */
  /* definition and creation of Mutex_printf */
  osMutexDef(Mutex_printf);
  Mutex_printfHandle = osMutexCreate(osMutex(Mutex_printf));

  /* USER CODE BEGIN RTOS_MUTEX */
  /* add mutexes, ... */
  /* USER CODE END RTOS_MUTEX */

  /* Create the semaphores(s) */

  /* USER CODE BEGIN RTOS_SEMAPHORES */
  /* add semaphores, ... */
  /* USER CODE END RTOS_SEMAPHORES */

  /* USER CODE BEGIN RTOS_TIMERS */
  /* start timers, add new ones, ... */
  /* USER CODE END RTOS_TIMERS */

  /* Create the thread(s) */
  /* definition and creation of vTask1 */
  osThreadDef(vTask1, monitor_task, osPriorityNormal, 0, 256);
  vTask1Handle = osThreadCreate(osThread(vTask1), NULL);

  /* definition and creation of vTaks2 */
  osThreadDef(vTaks2, control_task, osPriorityNormal, 0, 256);
  vTaks2Handle = osThreadCreate(osThread(vTaks2), NULL);

  /* USER CODE BEGIN RTOS_THREADS */
  /* add threads, ... */
  /* USER CODE END RTOS_THREADS */

  /* Create the queue(s) */
  /* definition and creation of msgQueue */
  osMessageQDef(msgQueue, 16, Msg);  //定义消息队列的深度及负载大小
  msgQueueHandle = osMessageCreate(osMessageQ(msgQueue), NULL);

  /* USER CODE BEGIN RTOS_QUEUES */
  /* add queues, ... */
  /* USER CODE END RTOS_QUEUES */
}

/* monitor_task function */
void monitor_task(void const * argument)
{

  /* USER CODE BEGIN monitor_task */
  int cnt = 0;
  Msg msg;

  Debug_Printf("Enter monitor task!
");


  /* Infinite loop */
  for(;;)
  {
    cnt++;
    if(cnt == 1 )
    {
        msg.msgType = MSG_TYPE_LED;
        msg.bswitch = true;
        xQueueSend(msgQueueHandle,&msg,10);
    }
    else if(cnt == 5)
    {
        msg.msgType = MSG_TYPE_LED;
        msg.bswitch = false;
        xQueueSend(msgQueueHandle,&msg,10);
    }
    else if(cnt == 10)
    {
        msg.msgType = MSG_TYPE_LED_TOGGLE;
        msg.bswitch = true;
        xQueueSend(msgQueueHandle,&msg,10);
    }
    osDelay(1000);

  }
  /* USER CODE END monitor_task */
}

/* control_task function */
void control_task(void const * argument)
{
  /* USER CODE BEGIN control_task */
  Msg tempMsg ;

  Debug_Printf("Enter control task!
");
  /* Infinite loop */
  for(;;)
  {
    xQueueReceive(msgQueueHandle,(void*)&tempMsg,osWaitForever);

    switch(tempMsg.msgType)
    {
        case MSG_TYPE_LED:
            if(tempMsg.bswitch)
            {
                Debug_Printf("LED is Open!
");
            }
            else
            {
                Debug_Printf("LED is Closed!
");
            }
            break;

        case MSG_TYPE_LED_TOGGLE:
            if(tempMsg.bswitch)
            {
                Debug_Printf("LED is Toggling!
");
            }
            else
            {
                Debug_Printf("LED is off!
");
            }
            break;

        default:
            break;
    }
    osDelay(10);
  }
  /* USER CODE END control_task */
}

测试结果：通过系统时间戳可以看出，首先monitor Task 发送消息类型MSG_TYPE_LED，

消息负载为Open,过了4秒发送MSG_TYPE_LED，消息负载为Close;再过5秒发送MSG_TYPE_LED_TOGGLE