01. 概述
任务挂起和恢复，当某个任务要停止运行一段时间就可以将这个任务挂起，当要重新运行这个任务的话就恢复这个任务的运行。FreeRTOS的任务挂起和恢复API函数如下表所示：
9 l' w7 B/ E$ P2 B! ?: g0 x- m
- k. {3 c% W$ ~+ r/ }

4 E4 \( a( j7 F02. vTaskSuspend函数
6 W9 I, m! |7 v. M5 k

1. void vTaskSuspend( TaskHandle_t xTaskToSuspend )
   
2. 功能：
   4 s+ N9 X; I. V# Q# K: G* H
3.     将某个任务设置为挂起状态，进入挂起状态的任务永远都不会进入运行态。退出挂起状态的唯一的方法就是调用任务恢复函数。
   $ ~3 d9 T1 H: ^
4. 
   
5. 参数：
   
6.     xTaskToSuspend 要挂起的任务句柄。为NULL表示挂起当前任务。
   
7. 
   5 J# i+ ^# V# L5 _& t0 e
8. 返回值：
   & X4 e, c: A' X# g" q
9.    无

复制代码

温馨提示：
7 }1 V/ L% e# m
) ?% l  ^3 N8 J& h调用vTaskSuspend函数是不会累计的：即使多次调用vTaskSuspend ()函数将一个任务挂起，也只需调用一次vTaskResume ()函数就能使挂起的任务解除挂起状态。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend必须设置成1，此函数才有效。
3 X, {9 O8 s% D. k4 \4 r5 J
应用示例：

1. void vFunction( void )
   
2. {
   
3.      xTaskHandlexHandle;
   
4.      // 创建任务，保存任务句柄.
   
5.      xTaskCreate( vTaskCode, "TASK_NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   ) c. ^6 [' y0 e4 Y6 }
6.      // ...
   + `* p+ ?" Q) [( e
7.      // 使用句柄挂起创建的任务.
   # [  e# I' b5 f& Y
8.      vTaskSuspend( xHandle );
   
9.      // ...
   4 e  r, D! \1 D7 C
10.      // 任务不再运行，除非其它任务调用了vTaskResume(xHandle )
    $ j/ d( a) A. R0 ]; [7 m5 s
11.      //...
    # M: z* P0 P' B3 w" F
12.      // 挂起本任务.
    
13.      vTaskSuspend( NULL );
    
14.      // 除非另一个任务使用handle调用了vTaskResume，否则永远不会执行到这里
    - H) d3 f/ q6 R- x" M. g3 g
15. }

复制代码

/ \* @0 C; J9 `/ T03. vTaskResume函数
! {/ A  k9 S; y0 [! j. q; }/ o

1. void vTaskResume( TaskHandle_t xTaskToResume )
   ' k) ^' U% e! p/ [: C, p
2. 功能：
   * y' n5 p5 H: j
3.      恢复挂起的任务
   
4. 参数：
   5 S1 K' g1 ^) W2 V1 s8 H6 B1 r! R
5.     xTaskToResume 要恢复运行的任务句柄
   
6. 返回值：
   ; v$ ^2 P* L! F9 m. C8 L9 d) [5 H
7.     无

复制代码

温馨提示：

/ ]7 v5 N: F' X' H7 t通过调用一次或多次vTaskSuspend()挂起的任务，可以调用一次vTaskResume ()函数来再次恢复运行。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend必须置1，此函数才有效。
8 E$ m9 ~' ]4 b6 x2 t2 R- O+ ?
应用示例:

; L6 }# P( Q0 v1 ], R

1. void vFunction( void )
   ! e& j6 G5 z5 V
2. {
   6 L3 |( x- P8 F( v5 d
3.      xTaskHandle xHandle;
   ) N! t1 B2 {; k/ k" G+ p- {
4.      // 创建任务，保存任务句柄
   
5.      xTaskCreate( vTaskCode, "TASK_NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   
6.      // ...
   / C% J4 T" O$ R0 A( E7 E
7.      // 使用句柄挂起创建的任务
   
8.      vTaskSuspend( xHandle );
   
9.      // ...
   - ?1 R( E/ ?) E( U, N) U
10.      //任务不再运行，除非其它任务调用了vTaskResume(xHandle )   
    
11.           //...
    
12.      // 恢复挂起的任务.
    
13.      vTaskResume( xHandle );
    
14.      // 任务再一次得到处理器时间
    5 [! D( k- X9 t2 M9 p
15.      // 任务优先级与之前相同
    ; A9 n0 z7 K* @  b: d
16. }

复制代码

04. xTaskResumeFromISR函数
BaseType_t xTaskResumeFromISR(TaskHandle_t xTaskToResume )
功能：
* ]) }( V3 X0 h( ?5 `( P2 l    用于恢复一个挂起的任务，用在ISR中
$ j" z6 N" q+ L1 }- {: \参数：
    xTaskToResume 要恢复运行的任务句柄
返回值：
    如果恢复任务后需要上下文切换返回pdTRUE，否则返回pdFALSE。由ISR确定是否需要上下文切换。

温馨提示：
# j- h3 c. o) o
3 a5 l" @9 P& k9 E% K通过调用一次或多次vTaskSuspend()函数而挂起的任务，只需调用一次xTaskResumeFromISR()函数即可恢复运行。
  m! Z, s, H' f  y$ w* `4 G( F
xTaskResumeFromISR()不可用于任务和中断间的同步，如果中断恰巧在任务被挂起之前到达，这就会导致一次中断丢失（任务还没有挂起，调用xTaskResumeFromISR()函数是没有意义的，只能等下一次中断）。这种情况下，可以使用信号量作为同步机制。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend 和 INCLUDE_xTaskResumeFromISR 必须设置成1，此函数才有效。
  Z+ Y+ B2 Z& a
应用示例:

1. xTaskHandle xHandle;               //注意这是一个全局变量
   
2. 
   
3. void vAFunction( void )
   
4. {
   8 a* m- V: Y) E' f( e" S
5.      // 创建任务并保存任务句柄
   
6.      xTaskCreate( vTaskCode, "NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   
7. 
   
8.      // ... 剩余代码.
   ' `* U# n$ K" |5 Q. ~
9. }
   
10. 
    
11. void vTaskCode( void *pvParameters )
    ' ^$ P9 r% S/ F
12. {
    ' \7 H- q5 C+ C6 y$ ^6 G
13.      for( ;; )
    & O+ R  V# d' x( b) ]/ x: C8 w
14.      {
    
15.          // ... 在这里执行一些其它功能
    2 x9 P! C4 o2 ]0 j
16. 
    1 E& D3 ~7 E+ M* B$ n8 ]; L- Q
17.          // 挂起自己
    5 q+ b" c! J0 y. w/ _: c8 g  c
18.          vTaskSuspend( NULL );
    
19. 
    
20.          //直到ISR恢复它之前，任务会一直挂起
    ' z" k5 U7 K! O8 q5 Z
21.      }
    4 k$ a, n' ^* p; a' B2 S; B6 Q
22. }
    7 G/ B; x" H7 G" @
23. 
    
24. void vAnExampleISR( void )
    2 E: [6 }' k  [) _- `4 r
25. {
    
26.      portBASE_TYPExYieldRequired;
    
27. 
    ' X7 R( B. V7 |2 [! G
28.      // 恢复被挂起的任务
    
29.      xYieldRequired = xTaskResumeFromISR(xHandle );
    5 e" O7 d. H; U- t. N) S8 ^
30. 
    
31.      if( xYieldRequired == pdTRUE )
    0 [; J/ o& f+ {8 ]/ s1 c
32.      {
    
33.          // 我们应该进行一次上下文切换
    $ |* \% }9 ?# d9 _3 u5 x5 l
34.          // 注:  如何做取决于你具体使用，可查看说明文档和例程
    
35.          portYIELD_FROM_ISR();
    9 M0 ~) v6 r4 ^
36.      }
    5 J& j) M1 O  d7 Q2 z, p6 J* C1 G  u
37. }

复制代码

1 f( k3 e; G2 y+ ]( q, F
9 g. b& Y0 L1 ]! q4 p, I% N