01. 概述
7 r/ M  [" g' u8 [, o1 T任务挂起和恢复，当某个任务要停止运行一段时间就可以将这个任务挂起，当要重新运行这个任务的话就恢复这个任务的运行。FreeRTOS的任务挂起和恢复API函数如下表所示：


6 E6 o% ?5 z. @4 h& ~7 x. l
; o+ A+ v: e) O8 ]02. vTaskSuspend函数
. q. K" H5 {0 r+ D) {" g

1. void vTaskSuspend( TaskHandle_t xTaskToSuspend )
   
2. 功能：
   5 g  D" q( z' r& g0 [$ m  K
3.     将某个任务设置为挂起状态，进入挂起状态的任务永远都不会进入运行态。退出挂起状态的唯一的方法就是调用任务恢复函数。
   
4. 
   % m0 _7 d* U" O1 s8 B
5. 参数：
   
6.     xTaskToSuspend 要挂起的任务句柄。为NULL表示挂起当前任务。
   
7. 
   
8. 返回值：
   
9.    无

复制代码

6 @, r( s) H/ V. {' x* S温馨提示：

调用vTaskSuspend函数是不会累计的：即使多次调用vTaskSuspend ()函数将一个任务挂起，也只需调用一次vTaskResume ()函数就能使挂起的任务解除挂起状态。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend必须设置成1，此函数才有效。

: U' p! N, D( J8 }8 q应用示例：
- G$ ~2 g" w/ B
  n* a. M3 k" t

1. void vFunction( void )
   
2. {
   5 B1 @# v; B' c8 I$ n" ]& L
3.      xTaskHandlexHandle;
   , g  @! N, A' Y* I6 h
4.      // 创建任务，保存任务句柄.
   4 ~/ N+ ]8 _6 @8 N; N
5.      xTaskCreate( vTaskCode, "TASK_NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   
6.      // ...
   
7.      // 使用句柄挂起创建的任务.
   ; P% V7 x* W* X+ @* z
8.      vTaskSuspend( xHandle );
   6 B3 U" M+ i( ~$ V2 a
9.      // ...
   
10.      // 任务不再运行，除非其它任务调用了vTaskResume(xHandle )
    9 y9 v# \. ?3 P
11.      //...
    
12.      // 挂起本任务.
    - q. }4 ]9 l" F
13.      vTaskSuspend( NULL );
    . `, w0 S2 V- G7 F  h
14.      // 除非另一个任务使用handle调用了vTaskResume，否则永远不会执行到这里
    * G" y! U1 c% ^5 B, O3 q  ^
15. }

复制代码

8 w: X( m/ t& R: _" Q$ S03. vTaskResume函数

1. void vTaskResume( TaskHandle_t xTaskToResume )
   
2. 功能：
   
3.      恢复挂起的任务
   ' ]0 o- k2 c) Y0 d0 q
4. 参数：
   
5.     xTaskToResume 要恢复运行的任务句柄
   1 ~+ A( o' y6 B, m0 c
6. 返回值：
   ; _& }  G7 z. W- v1 x
7.     无
   + [, n5 K0 b0 l, E1 e  P; `' F

复制代码

  x& H. m3 ~+ K5 i4 i1 t9 E% x温馨提示：

& g  ]$ k( ~) J0 {$ H, x0 \- R通过调用一次或多次vTaskSuspend()挂起的任务，可以调用一次vTaskResume ()函数来再次恢复运行。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend必须置1，此函数才有效。

0 U3 j6 X: u; r  W* k7 h! _应用示例:
2 h, ~& {! b2 R# b/ Z3 u, H% p! W
' U' k3 q4 z. h

1. void vFunction( void )
   
2. {
   . r) b5 u( ^7 ~! s( u+ }
3.      xTaskHandle xHandle;
   2 }6 f1 W( b( O+ s* S' ?
4.      // 创建任务，保存任务句柄
   
5.      xTaskCreate( vTaskCode, "TASK_NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   5 @, h& x, Y2 z7 _" H
6.      // ...
   , _5 O7 f' N8 t# R; q2 C9 e8 {
7.      // 使用句柄挂起创建的任务
   
8.      vTaskSuspend( xHandle );
   
9.      // ...
   
10.      //任务不再运行，除非其它任务调用了vTaskResume(xHandle )   
    $ A2 L) c& B1 X# F( M. r" [
11.           //...
    
12.      // 恢复挂起的任务.
    . X$ D8 ?- c& m" v7 q3 K
13.      vTaskResume( xHandle );
    $ b  p6 i& W9 C* ~7 N9 [
14.      // 任务再一次得到处理器时间
    - a6 @& v, l3 a7 b# W/ A
15.      // 任务优先级与之前相同
    : N7 b/ E" q# s6 U
16. }

复制代码

04. xTaskResumeFromISR函数
% y, f) c* e2 A

1. BaseType_t xTaskResumeFromISR(TaskHandle_t xTaskToResume )
   
2. 功能：
   ) ^/ B5 o1 F" d; K6 T( L
3.     用于恢复一个挂起的任务，用在ISR中
   ' y* v2 ]7 y3 O1 X
4. 参数：
   
5.     xTaskToResume 要恢复运行的任务句柄
   4 w2 r& X% y3 U5 \9 {
6. 返回值：
   / ]/ p7 d, ?+ m) g) F& j
7.     如果恢复任务后需要上下文切换返回pdTRUE，否则返回pdFALSE。由ISR确定是否需要上下文切换。

复制代码

- ^3 c  ^9 Q1 ]温馨提示：
9 i" f# E7 r, {  l8 j+ c
通过调用一次或多次vTaskSuspend()函数而挂起的任务，只需调用一次xTaskResumeFromISR()函数即可恢复运行。
3 U  U7 s! Z# o6 W2 o
xTaskResumeFromISR()不可用于任务和中断间的同步，如果中断恰巧在任务被挂起之前到达，这就会导致一次中断丢失（任务还没有挂起，调用xTaskResumeFromISR()函数是没有意义的，只能等下一次中断）。这种情况下，可以使用信号量作为同步机制。在文件FreeRTOSConfig.h中，宏INCLUDE_vTaskSuspend 和 INCLUDE_xTaskResumeFromISR 必须设置成1，此函数才有效。

/ P, V( i* {+ w/ f% r0 k) S应用示例:
0 K% r9 x* j6 m* g1 \

1. xTaskHandle xHandle;               //注意这是一个全局变量
   / a' A% f3 J% \( [0 L9 s; q
2. 
   8 N2 J; P' I5 r
3. void vAFunction( void )
   - l: Z8 z1 A' M/ K8 E# n
4. {
   
5.      // 创建任务并保存任务句柄
   8 _6 x6 z2 W5 D4 F/ }' X
6.      xTaskCreate( vTaskCode, "NAME",STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
   2 }4 d4 Q4 n* f  ^
7. 
   
8.      // ... 剩余代码.
   8 S% E7 ?" o* L" O
9. }
   
10. 
    
11. void vTaskCode( void *pvParameters )
    6 Z" ?7 b/ f4 y; h7 D' k: `3 y
12. {
    8 L8 v  G9 y" F8 X1 B; h1 w
13.      for( ;; )
    $ A) F, b* i: |/ [  k/ n
14.      {
    
15.          // ... 在这里执行一些其它功能
    4 N' P2 ^* z1 [
16. 
    6 K8 u* u& r' X# y. q! `, U
17.          // 挂起自己
    2 F! L& f4 Z1 E1 g
18.          vTaskSuspend( NULL );
    
19. 
    ' [7 j4 P7 o* J1 h0 V& y1 p
20.          //直到ISR恢复它之前，任务会一直挂起
    
21.      }
    . f. l/ _. H# r
22. }
    
23. 
    
24. void vAnExampleISR( void )
    
25. {
    
26.      portBASE_TYPExYieldRequired;
    ' m9 ?" o7 c- b- B% N2 m
27. 
    ) f; d* M- S6 l, I/ k# F; f
28.      // 恢复被挂起的任务
    
29.      xYieldRequired = xTaskResumeFromISR(xHandle );
    # C- }: j, P7 V% M
30. 
    4 w# p0 n5 }* T  n' s" ?
31.      if( xYieldRequired == pdTRUE )
    
32.      {
    
33.          // 我们应该进行一次上下文切换
    , i8 Y: }# U: `/ O
34.          // 注:  如何做取决于你具体使用，可查看说明文档和例程
    
35.          portYIELD_FROM_ISR();
    
36.      }
    
37. }
    5 W) Z, w( V0 u; v# i! v+ _
38. 
    : f% Z# j' N2 s* C7 L0 p1 d3 V

复制代码