你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【安富莱STM32F407之uCOS-III教程】第9章 μCOS-III系统移植文...

[复制链接]
baiyongbin2009 发布时间:2014-12-22 16:52
本帖最后由 baiyongbin2009 于 2014-12-22 16:54 编辑
$ J* L) P' g$ I, Q- m3 h6 Y$ B5 d4 {/ @4 g6 H
特别说明:
7 s3 B0 k9 l  }& U1.  本教程是安富莱电子原创。
2 i& [$ K! O( a+ b1 ?2.  安富莱STM32F407开发板资料已经全部开源,开源地址:地址链接
7 O3 l; x4 r# L
3.  当前共配套300多个实例,4套用户手册。

; P7 F7 I/ u' B* [( i" e0 g- f
第9章  μCOS-III系统移植文件详解
7 `* x( I5 a5 o2 l2 |
    本期教程主要主要跟大家讲解μCOS-III系统的官方移植文件,理解这几个移植文件很重要,如果这几个文件理解的比较深入的话,对于后面学习源码大有裨益。这几个文件主要就是实现任务切换的功能,关于任务切换咱们在前面几期已经详细讲解了工作原理(没有看的同学一定要看第4章和第5章,要不理解学习本章教程依然吃力),本期教程就是结合前面讲解,进一步讲解μCOS-III中任务切换实现的原理。
    9.1 移植文件
    9.2 os_cpu.h文件讲解
    9.3 os_cpu_c.c文件讲解
    9.4 os_cpu_a.asm文件讲解
    9.5 总结
9.1  移植文件
    官方提供的uCOS-III,uC-LIB,uC-CPU文件中都有Ports文件夹,咱们主要关心的是uCOS-III中的Ports文件夹。Ports文件夹中含有如下三个版本的移植文档:
9.1.png
) T4 O7 d. V! R- z( h5 S7 o/ `
    RealView就是用MDK编译器的移植文件,其余两个文件夹中的移植文件是用IAR和GUN的。咱们就以RealView中的移植文件为例跟大家详细的讲解下。RealView中的文件如下:
9.2.png

. o8 _+ r0 s  X, ^+ o2 W4 q  U* [
    os_cpu.h,os_cpu_c.c,os_cpu_a.asm这三个文件在移植过程中最重要,下面主要的就是把这三个文件中的内容详细讲解一下。
9.1  os_cpu.h文件讲解
    此头文件的内容比较少,下面就将里面的内容说明一下
9.2.1      宏定义
  1. #ifdef   OS_CPU_GLOBALS
      t% C: k+ ?6 u
  2. #define  OS_CPU_EXT
    2 H8 t) F( H% m! j: J- F
  3. #else0 m  G) K! l& G" {
  4. #define  OS_CPU_EXT  extern   
    8 t4 `: w4 p+ Z
  5. #endif/ R0 h$ D8 m/ k5 d5 z6 E. E0 u7 a8 r

  6. : B& r6 `* h6 M1 e
  7. /*
    * o# \+ o; e) `' p$ I. |$ O
  8. *********************************************************************************************************7 ^' @3 W; M; ^/ Z& O+ n! \& ~
  9. *                                               MACROS' y, f* {: G" j/ t7 k
  10. *********************************************************************************************************. s/ @( w3 M6 N; n) P" d
  11. */! ~: l6 T# ]7 }' N  r' Z1 |
  12. # P. K2 H: _( V0 c. l% T! W
  13. #define  OS_TASK_SW()               OSCtxSw()
复制代码

1 s% A5 L$ Z. `) r3 r
  l  由于工程中没有声明OS_CPU_GLOBALS,所以使用的都是#define  OS_CPU_EXT  extern源码的头文件中使用OS_CPU_EXT的地方很多,大家要记住这个的含义。
  l  #define OS_TASK_SW()     OSCtxSw()
    这个是任务级的任务切换函数,后面还有个中断级的任务切换。函数实体在os_cpu_a.asm文件中。此函数的主要功能就是实现任务的切换。
  1. /*
    2 w1 B+ Z" Y% g$ S# _% y' G" G' H' ^
  2. *********************************************************************************************************9 x$ a) I0 ?' F
  3. *                              OS TICK INTERRUPT PRIORITY CONFIGURATION% X- |- u! p7 f" {+ e# X  H" @
  4. *
    - J3 ]2 b2 m* R% o& f) X% E
  5. * Note(s) : (1) For systems that don't need any high, real-time priority interrupts; the tick interrupt
    ) @9 J+ m' W# k8 K! \
  6. *               should be configured as the highest priority interrupt but won't adversely affect system! b3 k( [( u+ o3 y+ E/ i0 W
  7. *               operations.
    6 z* X9 b7 e6 B. C
  8. *1 K5 ^) t7 k4 x8 M3 R+ J
  9. *           (2) For systems that need one or more high, real-time interrupts; these should be configured( J; x4 z# b, P4 h8 U( C9 p  E
  10. *               higher than the tick interrupt which MAY delay execution of the tick interrupt.4 M4 e7 |3 x2 h
  11. *! I0 `+ Z1 V( K5 F3 z+ q
  12. *               (a) If the higher priority interrupts do NOT continually consume CPU cycles but only
    1 m3 K  Y' y1 A
  13. *                   occasionally delay tick interrupts, then the real-time interrupts can successfully
    5 l! Q! y- w$ p# E) O0 L7 N2 z
  14. *                   handle their intermittent/periodic events with the system not losing tick interrupts
    8 Y& X' i3 ?# r( N8 z/ M, a
  15. *                   but only increasing the jitter./ u- U' e- h" k- m1 p
  16. *
    0 i+ _1 i+ B  q9 D- E& P, N
  17. *               (b) If the higher priority interrupts consume enough CPU cycles to continually delay the
    5 r9 z: v: X& H8 T* F8 U
  18. *                   tick interrupt, then the CPU/system is most likely over-burdened & can't be expected
    : s. x$ C& U1 U( a; U
  19. *                   to handle all its interrupts/tasks. The system time reference gets compromised as a
    . j0 e" R3 ~  E! l3 z9 P
  20. *                   result of losing tick interrupts.$ ]- s6 b$ d1 ^- d8 `) s* Y
  21. *********************************************************************************************************/ P: @7 q% N3 s$ [  z
  22. */3 s' m* ^8 I. b% E: ^  G
  23. 4 j8 E- m: |$ O0 a
  24. #define  OS_CPU_CFG_SYSTICK_PRIO           0u
复制代码
l OS_CPU_CFG_SYSTICK_PRIO 用于配制嘀嗒定时器的优先级。关于嘀嗒定时器优先级的配置还是很讲究的,也就是上面注释所写的。
  Ø 对于那些不需要高优先级中断的系统,嘀嗒定时器中断要配置成最高优先级的中断,但是不能影响系统操作。
  Ø 如果系统中多个高优先级的中断,而且优先级比嘀嗒定时器的优先级高,那么就可能会延迟嘀嗒定时器中断。
    u 如果高优先级的中断不会持续的占有CPU,只是偶尔的延迟嘀嗒定时器中断,那么实时中断可以间歇性或者周期性的处理系统事件而不丢失嘀嗒定时器中断,只是增加抖动(因为高优先级中断的执行会抢占嘀嗒定时器中断的执行或者高优先级中断执行的时候嘀嗒定时器中断会一直得不到执行从而造成嘀嗒定时器中断在执行时间上的抖动)。
    u 如果高优先级的任务长时间的占有CPU时间会造成系统超负荷运行,而不能执行嘀嗒定时器中断,任务也不能得到及时的执行。这种情况可以认为系统丢失了几次嘀嗒定时器的执行。
6 S: \9 [3 ^9 ?0 N" u+ J2 o1 B* p
赞 收藏 评论11 发布时间:2014-12-22 16:52

举报

11个回答
baiyongbin2009 回答时间:2014-12-22 16:58:09
本帖最后由 baiyongbin2009 于 2014-12-22 17:00 编辑 ; e3 u8 P# h0 s

6 d1 m8 s  r+ H3 k1 `7 b* U+ ~  w(续)9.2  os_cpu.h文件讲解+ e. }- V- }# W- h9 [
" z3 P( R; @7 U8 ?3 Y6 V  Y
9.2.2      时间戳配置
  1. /*4 j' }7 C9 z$ Y' d- p
  2. *********************************************************************************************************
    ) ^$ J8 \# h' \! J) a9 R2 c
  3. *                                       TIMESTAMP CONFIGURATION7 }( a* H( O" i& A* |
  4. *
    5 y3 a# {9 Q/ k& c8 z
  5. * Note(s) : (1) OS_TS_GET() is generally defined as CPU_TS_Get32() to allow CPU timestamp timer to be of
    4 t) G2 C, N6 E; K2 \6 c9 c. t
  6. *               any data type size.
    # w7 V7 P% u0 W0 O4 u) _
  7. *& S  _: Z- b: l& W2 O* U! [
  8. *           (2) For architectures that provide 32-bit or higher precision free running counters: a, W, G% n8 @, c
  9. *               (i.e. cycle count registers):
    2 b1 ^( q3 [7 p$ D. F3 D9 I
  10. *
    ( w8 g9 D2 k' G' l* E! ]2 R! `
  11. *               (a) OS_TS_GET() may be defined as CPU_TS_TmrRd() to improve performance when retrieving
    : }; r6 B' o7 j! r% b
  12. *                   the timestamp.
    8 u! f9 w/ J5 R$ Y
  13. *2 _3 i4 J9 ~, a) D
  14. *               (b) CPU_TS_TmrRd() MUST be configured to be greater or equal to 32-bits to avoid
    4 _( c5 F8 P( E  ]9 }' n
  15. *                   truncation of TS.7 h* F8 x5 {# W1 w! P9 R3 q% H
  16. *********************************************************************************************************1 i4 H( I5 S- l' J7 z! J4 t
  17. */
    ! m5 x( H/ z7 p, l2 v3 o+ Z! `
  18. ; b: O  m* I. h% L% Q' {
  19. #if      OS_CFG_TS_EN == 1u- l7 u5 I3 P$ n  d! j/ v
  20. #define  OS_TS_GET()               (CPU_TS)CPU_TS_TmrRd() /* See Note #2a.                     */+ D- d4 Y% k8 E/ E
  21. #else5 @* c9 }# t% ^- b. x; L
  22. #define  OS_TS_GET()               (CPU_TS)0u
    $ Q- z& K9 o) D% b
  23. #endif: n3 D+ U; R8 _6 Q5 Y0 z. Y

  24. ; s' o" i, m8 I- z' i+ p% W/ Y
  25. #if (CPU_CFG_TS_32_EN    == DEF_ENABLED) && \
    9 J2 D" n. }: o, V
  26.     (CPU_CFG_TS_TMR_SIZE  < CPU_WORD_SIZE_32)8 Y% Y8 C9 }/ `: y+ K; ]; }
  27.                                                    /* CPU_CFG_TS_TMR_SIZE MUST be >= 32-bit (see Note #2b).  */
    + _6 y8 Z# p; A! e3 K& }
  28. #error  "cpu_cfg.h, CPU_CFG_TS_TMR_SIZE MUST be >= CPU_WORD_SIZE_32"& p, z, ^, {7 |
  29. #endif
复制代码

, J% w& j1 Z" D( f4 S% Q
l OS_CFG_TS_EN在函数os_cfg.h里面进行了宏定义:
#defineOS_CFG_TS_EN                    1u   //用于使能或者禁止时间戳,这里1表示使能        
//时间戳,0表示禁止时间戳
       下面重点说一下函数CPU_TS_TmrRd(),相对来说此函数比较的重要。这个函数在μCOS-III中主要用于任务利用率的测量,和信号量、邮箱、事件标志组等执行时间的测量。这个函数不属于μCOS-III源码部分,确切的说应该是属于μC/CPU。此函数的内容需要用户根据自己使用的处理器进行实现,以提供更高精度的时间基准,至少要高于系统的时钟节拍精度,这样才能获得更准确的函数执行时间和任务利用率的测量。使用这个函数前需要先做初始化(在文件bsp.c里面):
  1. /*( I2 \5 V, t) v/ |" X; k9 h6 ?  g
  2. *********************************************************************************************************
    3 S& J2 I: P# }8 u
  3. *                                          CPU_TS_TmrInit()
    2 d0 S! w( X1 \1 b7 {
  4. ** {+ `$ x, C, }& F1 y2 f
  5. * Description : Initialize & start CPU timestamp timer.$ r" Y* M& ?0 x2 f' H6 S' f
  6. *
    8 U: a! J  V/ Q  A3 D5 B, Y' |% D
  7. * Argument(s) : none.
    ! X" d$ s( B- g! a; [7 m; p- {
  8. *
    7 ]7 ?2 \. {! j! f4 X  L% I
  9. * Return(s)   : none.. J. R- K5 f) ]4 |3 X9 ^
  10. *
    / M: `0 s7 S  }8 K
  11. * Caller(s)   : CPU_TS_Init().6 }4 p8 Y5 ]0 q$ i: n
  12. *7 x( x- U7 G$ ?& @
  13. *               This function is an INTERNAL CPU module function & MUST be implemented by application/
    ) t. j+ u6 m2 V& B# ]. b
  14. *               BSP function(s) [see Note #1] but MUST NOT be called by application function(s).9 q4 ~( |, Z5 z* C' d1 |# B
  15. *8 H2 g& a9 _4 {# `
  16. * Note(s)     : (1) CPU_TS_TmrInit() is an application/BSP function that MUST be defined by the developer
    6 k* _) u; q: N. u2 M
  17. *                   if either of the following CPU features is enabled :9 j6 T( |$ P5 q* q, T/ g# I
  18. *
    ) D4 n7 z; F2 {, D+ Z
  19. *                   (a) CPU timestamps  Y& g  P1 n0 e4 V% e
  20. *                   (b) CPU interrupts disabled time measurements4 f2 }" L4 h- ?7 J: a; j* X. ]( s
  21. *
    * O" H( e6 ?8 M. a$ v: m  B* L
  22. *                   See 'cpu_cfg.h  CPU TIMESTAMP CONFIGURATION  Note #1'. }* @$ u/ `9 T: C5 l. Q7 s, k
  23. *                     & 'cpu_cfg.h  CPU INTERRUPTS DISABLED TIME MEASUREMENT CONFIGURATION  Note #1a'.
    6 c4 n( @1 F3 h/ N
  24. *! m1 y5 V, n9 w% b2 |7 m
  25. *               (2) (a) Timer count values MUST be returned via word-size-configurable 'CPU_TS_TMR'& J# z8 k1 Z5 T( ?! W  O+ Z
  26. *                       data type.  e7 s3 I! ]) o1 e
  27. *& m* R1 Q2 h/ H+ l' `
  28. *                       (1) If timer has more bits, truncate timer values' higher-order bits greater2 e4 A1 }, ~& c9 }
  29. *                           than the configured 'CPU_TS_TMR' timestamp timer data type word size.; C: j' k/ T* x1 w( \+ h
  30. *
    * w2 Q! Z2 P* C! I- h
  31. *                       (2) Since the timer MUST NOT have less bits than the configured 'CPU_TS_TMR'+ V( x4 O1 P7 j! ~
  32. *                           timestamp timer data type word size; 'CPU_CFG_TS_TMR_SIZE' MUST be2 R) S+ A( B. N' b' [* T  U3 i
  33. *                           configured so that ALL bits in 'CPU_TS_TMR' data type are significant.
    ( j, c: c: T" M" m/ M/ [
  34. ** z1 H1 E" C$ G% |
  35. *                           In other words, if timer size is not a binary-multiple of 8-bit octets
    7 q9 w/ O2 |/ M  f7 H
  36. *                           (e.g. 20-bits or even 24-bits), then the next lower, binary-multiple
    ; `. X/ \% Y: a# R" ]! A; ^
  37. *                           octet word size SHOULD be configured (e.g. to 16-bits).  However, the
    0 F2 E' v0 y) ?# ^, Q
  38. *                           minimum supported word size for CPU timestamp timers is 8-bits.
    2 n* T  A$ b5 M1 r! G
  39. *
    1 h* W! m- Y  l: A+ O6 M
  40. *                       See also 'cpu_cfg.h   CPU TIMESTAMP CONFIGURATION  Note #2'
    $ D# V/ f; ]4 p9 k) {5 E5 N6 `. H
  41. *                              & 'cpu_core.h  CPU TIMESTAMP DATA TYPES     Note #1'.
    # h! t7 L- K6 _: Z  A; T# E
  42. *
    5 I* {; H4 d* N7 o# `
  43. *                   (b) Timer SHOULD be an 'up'  counter whose values increase with each time count.6 P/ {* a8 a% N% X
  44. *
    + k8 V0 F2 G& s% W& V2 d
  45. *                   (c) When applicable, timer period SHOULD be less than the typical measured time% f# h; }8 [) s" p
  46. *                       but MUST be less than the maximum measured time; otherwise, timer resolution
    7 ~- W4 k2 m" k$ Z- c
  47. *                       inadequate to measure desired times.
    3 r3 |8 y/ p; T
  48. ** `0 G: v' w% m2 m, W& N; b
  49. *                   See also 'CPU_TS_TmrRd()  Note #2'.; H0 t( O9 o$ |3 t1 N; Q6 Q2 F$ s
  50. *********************************************************************************************************+ z% X2 m5 S& Z5 N$ ~* q
  51. */
    ( a6 ?7 n2 I$ ]2 m) A! G

  52. 8 s# k& }% _- N* g
  53. #if (CPU_CFG_TS_TMR_EN == DEF_ENABLED)
    - e' d- A. X  e9 h3 E
  54. void  CPU_TS_TmrInit (void)6 I5 e9 U2 c$ ?* j
  55. {
    9 L3 @1 w1 [* g5 ?
  56.     CPU_INT32U  fclk_freq;- o' \& F! M/ l/ L* ?% ?1 I

  57. ! e6 T% [6 B3 h) P2 E- B

  58. # }* v! a6 I1 s! S, {; r+ G9 }
  59.     fclk_freq = BSP_CPU_ClkFreq();8 L8 n8 ?4 @  J& H$ K7 D$ w0 Z) q
  60. 3 z1 D' i3 J# R3 N2 b
  61.     BSP_REG_DEM_CR     |= (CPU_INT32U)BSP_BIT_DEM_CR_TRCENA;   /* Enable Cortex-M4's DWT CYCCNT reg.  */
      O* S, P0 m1 g( Z( d
  62.     BSP_REG_DWT_CYCCNT  = (CPU_INT32U)0u;
    2 c9 n/ P' ?1 c1 X2 l1 f9 p
  63.     BSP_REG_DWT_CR     |= (CPU_INT32U)BSP_BIT_DWT_CR_CYCCNTENA;
    & m/ v1 n  U2 m5 l/ v
  64.   L$ u9 p6 V, {& L& k$ `$ W
  65.     CPU_TS_TmrFreqSet((CPU_TS_TMR_FREQ)fclk_freq);+ c$ Y% l+ D+ I* ?* l
  66. }
    , b$ w1 j; k1 \( H) V' |& t$ P
  67. #endif
复制代码
  Ø 这个函数不需要用户调用,用户可以通过调用函数CPU_Init();(在文件cpu_core.c里面)来调用这个函数。
  Ø 这里时基的实现是使用Cortex-M3/M4中自带的时钟周期计数器,关于时钟周期计数器的知识,大家需要查阅相关的技术手册进行了解,这里只需要知道每计数一次就是一个时钟周期,比如主频是168MHz的话,那么时钟周期就是1/168000000秒。除了μCOS-III是使用的时钟周期计数器作为时基以外,embOS也是使用的这个计数器作为时基。FreeRTOS是用的定时器做的时基。
  Ø 关于此函数的其它信息,需要大家看一下上面的英文说明,看看了解一下即可。

# v8 k# h* x3 W( m8 h, k5 b# r& H/ Z, b$ {

# S. u; G% G  S' e$ @4 t: ]& ~% b% P
baiyongbin2009 回答时间:2014-12-22 16:59:18

( D8 j$ Y, @% r. K
(续)9.2.2  时间戳配置
- |7 c# H6 n0 L; G
说完了时间戳的初始化,下面说一下时钟周期计数器时间的读取,相关的函数还是位于bsp.c文件里面。
  1. /*
    & b$ q, y+ D+ i4 O3 m- v* B
  2. *********************************************************************************************************
    ' T8 j. y1 H4 _7 y+ I
  3. * CPU_TS_TmrRd()2 s- `9 g, M0 |! G
  4. *- |( S% c9 Q  |! t$ C
  5. * Description : Get current CPU timestamp timer count value.
      i0 h$ Z; L  z/ y2 \4 L9 g6 u
  6. *
    $ S9 b# V7 R& f9 E5 l: I. ^
  7. * Argument(s) : none.
    3 p& Z5 P6 v6 V' ?  N
  8. *
    . a0 x6 r& c% [9 }
  9. * Return(s) : Timestamp timer count (see Notes #2a & #2b).3 r2 C  f, D1 X$ T- [
  10. *5 c/ \8 Z7 j, G
  11. * Caller(s) : CPU_TS_Init(),
    3 N6 w! p8 m1 ~1 C
  12. * CPU_TS_Get32(),
    7 \+ j! r$ q! @# l3 S6 f0 q& H
  13. * CPU_TS_Get64(),0 F- B. Y; v7 s0 p9 Y" y
  14. * CPU_IntDisMeasStart(),
    4 m+ S0 f$ S' U& y8 y0 L/ u# [
  15. * CPU_IntDisMeasStop().
    & C- k2 u& z$ j0 ~  ~/ Q
  16. *
    " @+ |( f# t6 z2 l6 l0 }2 a
  17. * This function is an INTERNAL CPU module function & MUST be implemented by application/
    ; X5 ]; e2 i: J# w. y( {7 c
  18. * BSP function(s) [see Note #1] but SHOULD NOT be called by application function(s).
    3 y% U+ C1 x" l$ N" r1 p( P) U
  19. *
    $ q' C1 k$ L. c! H& ]  Q# u
  20. * Note(s) : (1) CPU_TS_TmrRd() is an application/BSP function that MUST be defined by the developer
    8 o/ g1 g$ F% e) b2 Y8 t; [% @! Q
  21. * if either of the following CPU features is enabled :% I" w: L3 z, a, S/ G
  22. *
    - k: d* t! T7 i' M* U6 I1 |7 C
  23. * (a) CPU timestamps
    8 Q" S. j( p' S  E, j$ c
  24. * (b) CPU interrupts disabled time measurements) R" e" E0 U8 v
  25. *( c* Q) ?. W9 p, N0 }) \$ }: M) Q
  26. * See 'cpu_cfg.h CPU TIMESTAMP CONFIGURATION Note #1'! V+ O/ [* H1 G  U; Q- \
  27. * & 'cpu_cfg.h CPU INTERRUPTS DISABLED TIME MEASUREMENT CONFIGURATION Note #1a'.
    1 k* ~& S- U8 Q+ [
  28. *
    - G  s. Z5 P* {4 D
  29. * (2) (a) Timer count values MUST be returned via word-size-configurable 'CPU_TS_TMR'
    $ o/ T! A9 j0 E1 c1 j0 n
  30. * data type.8 G8 q" v' b2 Y: F2 m1 s
  31. *
    % J) ?( |4 D* Y" }: o5 [6 W2 ~8 s7 Z
  32. * (1) If timer has more bits, truncate timer values' higher-order bits greater3 P. J4 }2 l" p8 T5 W
  33. * than the configured 'CPU_TS_TMR' timestamp timer data type word size., K1 ~! A# \6 c
  34. *4 W$ Y: M& {$ ~' N$ h' R
  35. * (2) Since the timer MUST NOT have less bits than the configured 'CPU_TS_TMR'& Q$ j. d; t) [+ k2 X' e
  36. * timestamp timer data type word size; 'CPU_CFG_TS_TMR_SIZE' MUST be; |' I2 ?# d3 ]" ~
  37. * configured so that ALL bits in 'CPU_TS_TMR' data type are significant.
    5 I2 ^) U; n* m8 g
  38. *1 M  h7 d; L: T" M) a+ L" L
  39. * In other words, if timer size is not a binary-multiple of 8-bit octets
    ; s/ c9 S) T: v3 m5 `( T
  40. * (e.g. 20-bits or even 24-bits), then the next lower, binary-multiple
    : A$ p4 C$ i  W
  41. * octet word size SHOULD be configured (e.g. to 16-bits). However, the; V5 T/ A: g5 ]2 Q4 O! U& e
  42. * minimum supported word size for CPU timestamp timers is 8-bits.5 w' M3 D" m0 M( @/ P2 \; t
  43. *& W' }/ e6 ?( w. M0 i0 r
  44. * See also 'cpu_cfg.h CPU TIMESTAMP CONFIGURATION Note #2'
    # a) l- Y- r9 @* D8 J9 W% S
  45. * & 'cpu_core.h CPU TIMESTAMP DATA TYPES Note #1'.2 ^- ~4 \' {" t. i
  46. *
    5 f1 Y4 o# o$ q$ `. K/ P
  47. * (b) Timer SHOULD be an 'up' counter whose values increase with each time count.: `! B' j# F) G9 d% i
  48. ** W4 E9 f! m! [) |2 Q1 h
  49. * (1) If timer is a 'down' counter whose values decrease with each time count,. ^6 Q* r. P) x0 D' B* ^% m1 E
  50. * then the returned timer value MUST be ones-complemented.
    ' Q% U: \/ j; b1 [% Z8 I
  51. *# U* E1 i  U9 R* N
  52. * (c) (1) When applicable, the amount of time measured by CPU timestamps is
    $ Y! A4 X5 y$ l5 C: U
  53. * calculated by either of the following equations :( t0 C0 \& K/ ~
  54. *
    8 P" L2 s% g6 y" Z6 W
  55. * (A) Time measured = Number timer counts * Timer period
    . |; e# M! z+ L+ z1 X0 S
  56. *( x5 B! T9 m% a4 ^3 H8 S4 o) G1 r
  57. * where
    : X- s0 x" D" l0 A4 s& w' r3 ^8 C
  58. *
    ' |! H3 U: Q4 t% D+ ~; _
  59. * Number timer counts Number of timer counts measured' X" u5 R) R. F& c
  60. * Timer period Timer's period in some units of
    & [' ]& `. \' z
  61. * (fractional) seconds
    0 l( D5 d" E9 E/ r0 w
  62. * Time measured Amount of time measured, in same/ @- \1 b7 e+ {7 Z
  63. * units of (fractional) seconds
    3 j' ~; {* V# m* H, }/ Q
  64. * as the Timer period" k2 ?) _! I/ @/ q8 \8 t7 ~
  65. *
    9 `$ ]/ A0 Q& k
  66. * Number timer counts# A3 z8 l9 {* x9 q- E; e3 r4 V
  67. * (B) Time measured = ---------------------
    / ?$ g& [, k0 ]% [! j4 W$ c
  68. * Timer frequency
    & i' G0 q# ?( D$ M
  69. *
    , A$ F9 d' {& X
  70. * where  K! E5 K& _3 F3 k3 L3 B6 r
  71. *  c5 y% z% s6 p1 d
  72. * Number timer counts Number of timer counts measured( O0 e% `9 ?) a
  73. * Timer frequency Timer's frequency in some units
    3 W( Q* P: `# B  ?$ n
  74. * of counts per second& A3 q* K+ `; p+ [7 y% I+ w, a
  75. * Time measured Amount of time measured, in seconds2 T& L. @. t+ i. Y3 X8 @( M: r
  76. *
    1 }% m& ?* N0 m2 M9 x5 |
  77. * (2) Timer period SHOULD be less than the typical measured time but MUST be less- D, L1 j) Z( [4 z8 M2 J2 x
  78. * than the maximum measured time; otherwise, timer resolution inadequate to) i: U1 i/ g" K! ^
  79. * measure desired times.
    4 v: H) F% V$ T
  80. *********************************************************************************************************
    ( ]. v1 r# f* K3 W8 ~) r* P% H
  81. */
    1 r$ \8 C/ P& `; ^9 u! U4 e; Y" @

  82. 5 x" @( ?4 y3 I/ t0 h
  83. #if (CPU_CFG_TS_TMR_EN == DEF_ENABLED)! O' Q" Z# U$ G2 A! P$ ?6 Y
  84. CPU_TS_TMR CPU_TS_TmrRd (void)
    6 o+ n8 `/ A& R/ B
  85. {, R: U8 u8 ^; m$ m4 l- c# Q& q
  86. CPU_TS_TMR ts_tmr_cnts;
    ) ]+ V5 I  n( Q  Q" ~

  87. 0 ^8 v5 b& ]. t5 J, O

  88. - b$ `3 |5 p3 Z: @8 ]- K
  89. ts_tmr_cnts = (CPU_TS_TMR)BSP_REG_DWT_CYCCNT;& X* z/ [3 q3 j7 _* A

  90. 6 x5 x6 j$ `+ k4 A5 Q! I
  91. return (ts_tmr_cnts);
    9 p# q& |$ A6 X* d
  92. }
    3 v/ N7 _# |( d& n
  93. #endif
    4 K/ N1 C5 R8 P# a( N  D7 \' N0 D

  94. : x# U4 ~& b/ Q& b) e$ f3 D1 O3 W, O
  95. /*
    2 y$ T8 H' n7 A8 u5 ]9 Q4 n  X' A8 p
  96. *********************************************************************************************************
    & K, Y. n6 Q# B' g  Q
  97. * CPU_TSxx_to_uSec()$ b$ C, c4 j" O
  98. *
    ) H% B  P/ B% M' X3 z
  99. * Description : Convert a 32-/64-bit CPU timestamp from timer counts to microseconds./ D; Q+ S; g1 L' t4 \& r
  100. *
    " e. T: l0 z7 Z( M% F3 ]  S
  101. * Argument(s) : ts_cnts CPU timestamp (in timestamp timer counts [see Note #2aA]).
    2 U9 A" v" |! c( W- q0 G
  102. *
    % k, z2 y+ m. }9 a/ _
  103. * Return(s) : Converted CPU timestamp (in microseconds [see Note #2aD]).* n+ ^6 }) R3 H3 w- v- v
  104. *
    # x+ W. R3 P% Q# x0 `! x
  105. * Caller(s) : Application.
    / P  f& q) i* A5 N( B
  106. *
    . s9 H7 z/ Z+ w* t" r
  107. * This function is an (optional) CPU module application programming interface (API)# [6 l- P( I5 X, V6 D. _2 i
  108. * function which MAY be implemented by application/BSP function(s) [see Note #1] &
    2 ]8 {$ ~! S) |/ v
  109. * MAY be called by application function(s).* V' M  Z5 A. i" J% E8 s
  110. *0 B( r3 p8 ~5 f/ f- n
  111. * Note(s) : (1) CPU_TS32_to_uSec()/CPU_TS64_to_uSec() are application/BSP functions that MAY be
    / @: Z- k+ h0 ^" C, Q' t. X
  112. * optionally defined by the developer when either of the following CPU features is% Q$ [: X1 [8 _0 [  F
  113. * enabled :. G* Q4 E+ P; d# j  V
  114. *
    . z4 q& y) l4 d8 `0 ~4 F
  115. * (a) CPU timestamps  U  L* u2 H- g
  116. * (b) CPU interrupts disabled time measurements" B5 Z% O6 E" Q6 D0 J
  117. *+ Q# @2 n7 v9 `# i  H6 c0 {
  118. * See 'cpu_cfg.h CPU TIMESTAMP CONFIGURATION Note #1'2 i' v5 |6 U9 p
  119. * & 'cpu_cfg.h CPU INTERRUPTS DISABLED TIME MEASUREMENT CONFIGURATION Note #1a'.3 b- M2 A* s8 m, L
  120. *& V3 @% W9 K# R4 W0 }+ c' |; X* S
  121. * (2) (a) The amount of time measured by CPU timestamps is calculated by either of+ ~! ~2 B: O  z
  122. * the following equations :
      R$ H$ o$ J* X7 ^' Z# T7 L
  123. *
    8 l, j5 e# R7 B! I( H2 r* m* p
  124. * 10^6 microseconds
    8 n" [9 O% H$ n4 q
  125. * (1) Time measured = Number timer counts * ------------------- * Timer period; a) B: N& n1 G( ?$ X2 d
  126. * 1 second1 |' G! {% H& `# I
  127. *& i, p, o! p  u8 p3 O* I" S/ }  S1 p
  128. * Number timer counts 10^6 microseconds
      W9 @+ |- _8 M% N! Z8 O$ I
  129. * (2) Time measured = --------------------- * -------------------
    ; {( U% D! l$ j" s# ?4 z2 @. p
  130. * Timer frequency 1 second  a9 [) }8 a1 J$ O$ ?
  131. *
    / j% K7 r8 \- b( n  s. V
  132. * where3 P' b/ m; ~6 _7 u# }% R7 p  @
  133. *
      Y; o0 ?  \  ~8 C
  134. * (A) Number timer counts Number of timer counts measured
    6 q) B6 z# X, f* o& v% z7 c. P
  135. * (B) Timer frequency Timer's frequency in some units' |7 y4 J/ ?( s+ o
  136. * of counts per second9 p6 o( k+ [5 u' {# Y3 a+ B3 }) t
  137. * (C) Timer period Timer's period in some units of
    * O# P6 a$ K/ ]0 N( v5 ?. L
  138. * (fractional) seconds
    # X# _1 V9 z6 ?$ V' J7 R
  139. * (D) Time measured Amount of time measured," B) B: d: ~+ t$ I
  140. * in microseconds! D' |! ?0 Q( ~, J& k( q
  141. *! y3 E5 a, p: ]/ U5 M1 k
  142. * (b) Timer period SHOULD be less than the typical measured time but MUST be less/ q7 W1 b4 W, }" Q% F! A
  143. * than the maximum measured time; otherwise, timer resolution inadequate to* v  L) Q3 r# n, U7 X; z
  144. * measure desired times.
    / N$ s5 n; V$ W. F
  145. *
    - b: O0 y, I, C( T
  146. * (c) Specific implementations may convert any number of CPU_TS32 or CPU_TS64 bits% q4 c- n2 d( u" w+ B& ?! a" u- j% M
  147. * -- up to 32 or 64, respectively -- into microseconds., D+ [3 g: C7 x3 u
  148. *********************************************************************************************************
    , _+ j: a& O" }9 ], N  y
  149. */& y) M% {2 Y! ^0 C6 y9 |" c
  150. * k' f1 q/ ?. N6 a, O0 r( Q4 s
  151. #if (CPU_CFG_TS_32_EN == DEF_ENABLED)
    , k( R* W  L( R& `1 t
  152. CPU_INT64U CPU_TS32_to_uSec (CPU_TS32 ts_cnts)% [! I. C2 V0 y+ z, P
  153. {
    8 H+ r) H5 b" Z' N
  154. CPU_INT64U ts_us;
    * T- `7 x/ j; B6 j" N; V& i
  155. CPU_INT64U fclk_freq;
    3 ]' u' x) v% \
  156. % M. S$ \( ~1 }9 u$ ^5 D
  157. ' q$ Q1 }, [, i! d9 ~8 V1 U8 g
  158. fclk_freq = BSP_CPU_ClkFreq();
    + o( v. |9 T8 a$ M4 ~# u
  159. ts_us = ts_cnts / (fclk_freq / DEF_TIME_NBR_uS_PER_SEC);( Q* h2 y6 u  O+ {" d# B  w6 Q4 {

  160. 4 C+ R) v" [/ L6 |4 Y
  161. return (ts_us);
    $ n* |. u8 c7 {( ]$ m0 M
  162. }- G% k: z2 R& b/ E; @
  163. #endif
    7 v2 G1 c- s+ ~- e) b0 P9 ]

  164. / k1 V8 g9 G# C; l+ D1 F0 m: ~) t

  165. ) f' k* h: @9 F
  166. #if (CPU_CFG_TS_64_EN == DEF_ENABLED)" H: u9 N9 D- R! o
  167. CPU_INT64U CPU_TS64_to_uSec (CPU_TS64 ts_cnts)" b5 y9 t$ `- o4 `3 J
  168. {
    " c, s) g9 h* \$ h. h2 J8 {) w
  169. CPU_INT64U ts_us;! V7 c' s+ }: L
  170. CPU_INT64U fclk_freq;" t6 i+ x$ l( @2 P8 o' Q
  171. 2 w* O( `( A6 @
  172. , p/ H' m7 f5 G7 T! U
  173. fclk_freq = BSP_CPU_ClkFreq();
      c2 E' l5 L' i* Y# B
  174. ts_us = ts_cnts / (fclk_freq / DEF_TIME_NBR_uS_PER_SEC);3 g8 {3 s/ Y/ t- S& M! g! ?
  175. 6 X0 \: \6 B5 Q! U# k( @5 T
  176. return (ts_us);
    % `* h3 Z! K( }7 [
  177. }. ]( t0 h& Z2 _: W( N
  178. #endif
复制代码
    从上面的函数可以看出时钟周期计数器时间的获取还是很容易的,直接读取相应寄存器就能获得当前的计数。下面的两个函数CPU_TS32_to_uSec和CPU_TS32_to_uSec用于将时钟周期的数值转换成us为单位。函数还是很容易看懂,上面的英文说明反倒搞得挺复杂,大家读读了解些即可。

; y( `5 A+ X( b- s0 X' g0 d
baiyongbin2009 回答时间:2014-12-22 17:01:20
9.2.3      函数声明
  1. /*
    ! e; H! E4 x5 [; Y
  2. *********************************************************************************************************
    ( P( r5 k9 K/ X7 C$ L) `
  3. *                                          GLOBAL VARIABLES% K3 a+ Z+ j% [
  4. *********************************************************************************************************
    0 L2 B  J3 m/ M( p( n! Z- c
  5. */
    2 e) h% W( g0 h  k) ?2 V& N
  6. # J" q) H( e' I
  7. OS_CPU_EXT  CPU_STK  *OS_CPU_ExceptStkBase;
    * F2 ^/ V4 @( N" d. ~. \
  8. % d+ C9 @7 P1 s* o) e1 C2 l* ?
  9. /*( ?3 V) B6 q' J/ {1 P5 H/ _8 D: f: v
  10. *********************************************************************************************************
    ' i; o  e. }5 d
  11. *                                         FUNCTION PROTOTYPES
      k7 y+ H8 v' {
  12. *********************************************************************************************************' |2 J( g* _( J8 k% b8 \5 E  l
  13. */
    9 E: w9 S) @: K; I
  14. / O% t; \1 `$ \
  15. void  OSCtxSw              (void);8 D' o- t) I( g8 b6 |
  16. void  OSIntCtxSw           (void);
    + Q4 {6 f7 ?. f
  17. void  OSStartHighRdy       (void);
    ' l0 A# V7 I8 g2 Y

  18. 6 q+ H/ r: l4 a# H! s2 {
  19. void  OS_CPU_PendSVHandler (void);4 Y6 I4 W: _3 S! C, Y' q& R  V

  20. $ E# I' N' e+ e: {; Z9 ~: A) s
  21.   i& A3 m6 }! b6 I2 J+ n  U6 H+ a
  22. void  OS_CPU_SysTickHandler(void);
    4 E2 u( E  ]# @0 y
  23. void  OS_CPU_SysTickInit   (CPU_INT32U  cnts);
复制代码

& j' T& s, }( \% r% {  m6 g, X
l *OS_CPU_ExceptStkBase  异常堆栈指针,后面讲源码的时候在跟大家讲。
l  void  OSCtxSw              (void);
    void OSIntCtxSw           (void);
    void OSStartHighRdy       (void);
    void OS_CPU_PendSVHandler (void);
这四个函数在文件os_cpu_a.asm里面,主要用于实现任务切换。
l  void  OS_CPU_SysTickHandler(void);
    void  OS_CPU_SysTickInit   (CPU_INT32U cnts);
这两个函数的实体在文件os_cpu_c.c文件里面。

/ H2 L9 M% u& Z# B
baiyongbin2009 回答时间:2014-12-22 17:05:35
本帖最后由 baiyongbin2009 于 2014-12-22 17:11 编辑 6 |& l4 F: K# O: W+ y
$ _0 ~& r& k/ S) \1 L
9.3  os_cpu_c.c文件讲解
    这文件里面主要是一些钩子函数,任务堆栈初始化和嘀嗒定时器的初始化。下面就详细的把这三个部分说明一下。
9.3.1      钩子函数
    钩子函数的主要功能就是扩展函数的功能,用户可以根据自己的需要往里面添加相关的测试函数,这个文件里面的钩子函数一共有个,下面就分别的讲解下。
  1. /*
    4 u5 A: D0 g, t/ _  H
  2. *********************************************************************************************************
      M# L1 Q& f$ C/ G( }7 ]' R7 C0 V
  3. *                                           IDLE TASK HOOK1 p; h( a. w# G, b# ?* o$ N
  4. *6 l7 D8 `4 F8 b
  5. * Description: This function is called by the idle task.  This hook has been added to allow you to do8 l4 U: W7 J4 G  o# X5 ~" {
  6. *              such things as STOP the CPU to conserve power.: j8 e$ g. _2 ~+ E# J" n3 S
  7. *
    ) d' ^) W1 Z; m& D# ]! T
  8. * Arguments  : None./ |! l3 C/ y0 h/ t$ f' a( U
  9. *' x8 H5 v: {8 ^) e; d/ l! X
  10. * Note(s)    : None.
    + s" \% S2 L+ \) o4 k: q+ A- f8 M& F
  11. *********************************************************************************************************' ~& ~" H0 `  V# ~! E
  12. */
    . g3 a$ E9 S: \, O( p

  13. / T0 ^1 ]3 h- K  d4 Z' L% ^' g; h" r
  14. void  OSIdleTaskHook (void)3 O7 B* g: v# w2 l
  15. {
    0 r: J: b5 w1 j8 |
  16. #if OS_CFG_APP_HOOKS_EN > 0u) Z- ]1 t& v- n' o0 S
  17.     if (OS_AppIdleTaskHookPtr != (OS_APP_HOOK_VOID)0) {
    9 Z& _9 K3 r/ d/ Y1 ]/ o7 G" [8 E
  18.         (*OS_AppIdleTaskHookPtr)();' n0 T$ F" J1 L0 H$ R1 Z
  19.     }
    / w0 D2 ~  F5 F$ g9 _2 Q' g
  20. #endif6 m9 B6 K; L" q
  21. }
复制代码
l OSIdleTaskHook是空闲任务的钩子函数
    此函数被空闲任务调用,用户可以通过函数指针变量*OS_AppIdleTaskHookPtr指向用户设计的函数来实现用户所想实现的任务。这个函数主要用于实现低功耗。
  1. /*8 \" Y& O) r" _/ n5 t. w  N5 X$ {" V+ }
  2. *********************************************************************************************************
    1 M3 k! ~: C& c$ A9 k
  3. *                                       OS INITIALIZATION HOOK
    ' K7 C9 I, L- A/ @+ g
  4. *! I3 t4 H0 @; |6 m2 U. X, k
  5. * Description: This function is called by OSInit() at the beginning of OSInit().
    5 ?0 X. u  |& E% \% P# v5 y/ d
  6. *
    ' Q* v& G: c  s# A& I% w5 g: k
  7. * Arguments  : None.
    / D( j7 w2 b3 q6 o
  8. *
    # s. W. {8 [( Z6 _. J
  9. * Note(s)    : None.
    ! V- h4 T0 T9 {3 J3 F* ]' s
  10. *********************************************************************************************************) g  C" m& {* D6 m  N! V1 ~( R
  11. */
    1 \1 r% F3 H& j$ d
  12. - ~' `* U* L+ s  N
  13. void  OSInitHook (void)
    8 z, y# q$ _* r3 N3 `, h
  14. {
    8 Z$ t1 g& p& b. K* N
  15.                                                 /* 8-byte align the ISR stack.     */   
    1 H: x" V1 a" f
  16.     OS_CPU_ExceptStkBase = (CPU_STK *)(OSCfg_ISRStkBasePtr + OSCfg_ISRStkSize);
    : Y' \$ M1 {- x& S. D6 e
  17.     OS_CPU_ExceptStkBase = (CPU_STK *)((CPU_STK)(OS_CPU_ExceptStkBase) & 0xFFFFFFF8);2 g! S2 R2 f* u6 ~- X
  18. }
复制代码
l OSInitHook是OS初始化的钩子函数
    这个函数主要用于获取异常堆栈的基地址。这里这特别注意:这个异常堆栈是用于MSP(主堆栈空间),这样可以很方便的查询主堆栈的使用情况。针对Cortex-M4/M3内核的MCU,在使用RTOS的情况下,主堆栈主要用在中断服务程序中。
  1. /*8 o. {. J8 N1 d4 u* u* I8 D: [
  2. *********************************************************************************************************! i) Y1 C8 ]7 Z* @. \' l; E# F
  3. *                                         STATISTIC TASK HOOK8 G: ?+ w5 ~8 j1 k4 l) t( x' h. q0 q
  4. *
    ) I3 x. r- [0 p  P& [: j/ k
  5. * Description: This function is called every second by uC/OS-III's statistics task.  This allows your7 G+ A7 k( }3 G! E4 I% U5 {
  6. *              application to add functionality to the statistics task.
    ; F7 g  Y9 I9 g0 k) p1 T- q$ Y
  7. *' v8 o* S/ i  E
  8. * Arguments  : None.
    - i5 \1 H) f# R4 v/ G
  9. *
    : \9 A$ T8 E9 k. Z' \
  10. * Note(s)    : None.- V' o2 g' ^4 s# E6 \
  11. *********************************************************************************************************, w& ]; P0 u  t
  12. */
    ; R0 C' {* _8 K1 S1 t( \# o% Z
  13. 3 o1 Q3 R3 O: w- f# j- D: E' Z
  14. void  OSStatTaskHook (void)' H3 T2 x8 t# Y, t; @7 x
  15. {
    - w- }1 F3 K8 h( y
  16. #if OS_CFG_APP_HOOKS_EN > 0u9 R+ z& T( K0 F3 b; Q
  17.     if (OS_AppStatTaskHookPtr != (OS_APP_HOOK_VOID)0) {* J9 M. [( O, s8 L* B# Q& v; v$ k/ I7 a
  18.         (*OS_AppStatTaskHookPtr)();
    ! J% Y+ N4 X, `+ e7 P% I( _
  19.     }
    ' l% P$ {! \. W$ c1 W* u, p
  20. #endif4 [# Z* A8 f' q
  21. }
复制代码
l OSStatTaskHook是统计任务的钩子函数
    使用方法和前面的空闲任务钩子函数一样。
  1. /*
    4 l% [% w0 \& u1 W
  2. *********************************************************************************************************) x# a, e/ }( W' r6 d/ f
  3. *                                          TASK CREATION HOOK
    0 F! v3 {+ R+ N' |+ Y, S& e- n
  4. *
    " D( E# I/ W& @5 e9 D& H- [
  5. * Description: This function is called when a task is created.
    3 o1 @! e9 [, y  E
  6. *
    $ y0 z7 v% K0 U
  7. * Arguments  : p_tcb        Pointer to the task control block of the task being created.
    , j: n/ A# c1 g# s" a/ X9 T
  8. *5 P7 w1 A9 X- |% @) t1 Q; d3 Q
  9. * Note(s)    : None.
    ! V9 W& u# T1 l7 E3 Z9 c* {/ A0 s
  10. *********************************************************************************************************1 n1 `  T: A  S' j: p) K& D
  11. */
    ! o4 c0 q  Q8 S+ g5 |8 u
  12. 7 F. ?; ~5 g- T& T( M" W  J+ f
  13. void  OSTaskCreateHook (OS_TCB  *p_tcb)
    ) j' z7 B4 @" a8 Q4 k& I
  14. {
    & C& @( X- k1 n2 z/ J4 f- E
  15. #if OS_CFG_APP_HOOKS_EN > 0u) U8 J( p8 d2 }
  16.     if (OS_AppTaskCreateHookPtr != (OS_APP_HOOK_TCB)0) {
    5 h+ i8 H5 V) j- K
  17.         (*OS_AppTaskCreateHookPtr)(p_tcb);
    + p2 }9 t& D! f. y4 o
  18.     }
    % i2 h% ?( C& \3 i# C
  19. #else! j! v6 f6 C' |5 Z. C% w
  20.     (void)p_tcb;                                            /* Prevent compiler warning                               */
    5 y* u7 A5 X- r2 ]6 R
  21. #endif
    . p2 p) W5 }9 A# R! o, F6 v
  22. }
复制代码
l OSTaskCreateHook是创建任务时的钩子函数
    使用方法和前面的空闲任务钩子函数基本一样,只是多了个函数参数。
  1. /*
    % N( Z: K4 x! i
  2. ********************************************************************************************************** {2 s; Y$ S% I1 d2 \
  3. *                                           TASK DELETION HOOK7 a7 K2 k% b/ R# F: Z/ u8 y
  4. *2 W  ?( n& K2 [; T' J; \' T
  5. * Description: This function is called when a task is deleted.) ?, l6 `8 f5 m) R0 H* p
  6. *
    ! ]4 x3 ^3 n, ^3 u
  7. * Arguments  : p_tcb        Pointer to the task control block of the task being deleted.
    5 B9 s, v1 K; x6 `- H; }- O
  8. *
    5 b2 [! ~3 g, y& F7 e0 E. }
  9. * Note(s)    : None.
    , Z) o# d1 a  n. N
  10. *********************************************************************************************************
    - v$ ~' o3 `  m' f' l7 E
  11. */
    $ V7 ]9 Q4 V* J6 `; r0 ~# g

  12. , l5 t4 P8 ^% e* K( u- W
  13. void  OSTaskDelHook (OS_TCB  *p_tcb)
    7 [% T( u' T4 H/ E5 F; }. O
  14. {
    - m/ [$ y  e$ C9 {/ l* W7 r
  15. #if OS_CFG_APP_HOOKS_EN > 0u% ~* V9 r+ T0 U
  16.     if (OS_AppTaskDelHookPtr != (OS_APP_HOOK_TCB)0) {6 C( ?9 \, p* x& P) f, p
  17.         (*OS_AppTaskDelHookPtr)(p_tcb);
    ! V* N3 j, L& O/ Y4 G
  18.     }
    # S" E0 o0 h" e& }+ G
  19. #else
    6 q( B* t4 d2 R: x2 w" x8 {
  20.     (void)p_tcb;                                            /* Prevent compiler warning                               */4 l! O  W# F& Y5 b+ r# K' W
  21. #endif
    8 |! x$ P- X7 U3 p6 C
  22. }
复制代码
l OSTaskDelHook 是任务删除的钩子函数
    使用方法和前面的创建任务钩子函数一样。
. l- {7 |  U' r! i3 c" Q1 A; g
baiyongbin2009 回答时间:2014-12-22 17:10:44
(续)9.3.1  钩子函数+ X) \) D6 {4 L
  1. /*
    * y  r# ?9 m' r- Q& ]
  2. *********************************************************************************************************" ?0 |8 G( f# W6 y7 K6 [+ c
  3. *                                            TASK RETURN HOOK4 Q8 z  G9 S% P# i' h* s- w8 v0 `
  4. *" ?/ J, L5 b: O2 {8 F( K
  5. * Description: This function is called if a task accidentally returns.  In other words, a task should
    / m( J+ w# [% e; a. X8 `$ I. y! A
  6. *              either be an infinite loop or delete itself when done.
    % p3 }) R$ P- c. j8 O
  7. *
    6 I# a% a. L5 J# M) X2 O5 Q. E
  8. * Arguments  : p_tcb        Pointer to the task control block of the task that is returning.
    9 R. f" I' |8 A9 E7 a# Q8 D
  9. *5 c' r# R. P* a& S
  10. * Note(s)    : None.
    ! i1 H; |! l5 X0 g
  11. *********************************************************************************************************
      {( }9 r& ~7 ^% J, @. k
  12. */
      v! a$ B5 o0 m. K

  13. / [# z8 V. K' s5 r& X% z+ ~
  14. void  OSTaskReturnHook (OS_TCB  *p_tcb)- J/ c) F0 F5 }' p3 }
  15. {
    2 C4 w  E  W' J
  16. #if OS_CFG_APP_HOOKS_EN > 0u
    3 z: U' q. F, P! m" b
  17.     if (OS_AppTaskReturnHookPtr != (OS_APP_HOOK_TCB)0) {
    1 u# A3 |( [( n7 m
  18.         (*OS_AppTaskReturnHookPtr)(p_tcb);
    # }( f+ v6 W+ Q% g) u0 K- R( N- G0 H* E
  19.     }( a% W8 Y+ E" |4 {# L0 N5 g
  20. #else+ r8 Y+ L, R# h& N
  21.     (void)p_tcb;                                            /* Prevent compiler warning                               */3 O. D6 c' e# A0 ?* Y& }2 y  [
  22. #endif4 O: Y4 K) N5 M, I1 @* f
  23. }
复制代码
l OSTaskReturnHook是任务返回的钩子函数
    这个函数的使用方面和前面的创建任务钩子函数是一样的。在RTOS中,任务必须得是超级循环的形式,如果任务只执行一次或者任务中有返回函数,系统就会调用异常返回函数将这个任务挂起或者删除(用户可以自行配置)。在异常返回函数中调用钩子函数。
  1. /*- [1 _8 p8 O% q! W
  2. *********************************************************************************************************
    0 ~2 Q* P7 l. Q: O
  3. *                                           TASK SWITCH HOOK
    : z, V. ]5 y4 b
  4. *$ @8 m/ r/ d9 P( v& K/ o6 v
  5. * Description: This function is called when a task switch is performed.  This allows you to perform other% t1 I9 {! a& @5 c. m. J. H$ l& Q) ]* A
  6. *              operations during a context switch.
    ( _0 c' e/ K) u. a) T
  7. *& j% p8 ^$ v; S9 m
  8. * Arguments  : None.
    8 t- ~& _* {" {! Y
  9. *
    8 q8 C. ~2 m- x5 c
  10. * Note(s)    : 1) Interrupts are disabled during this call.2 r5 n9 z+ D3 V# ]! u
  11. *              2) It is assumed that the global pointer 'OSTCBHighRdyPtr' points to the TCB of the task7 S; v) w7 ]  ]5 \. y
  12. *                 that will be 'switched in' (i.e. the highest priority task) and, 'OSTCBCurPtr' points+ }) o- c0 f2 B
  13. *                 to the task being switched out (i.e. the preempted task).+ b# [5 P% R+ I' C; F& L  i6 ^  W* C
  14. *********************************************************************************************************
    2 I& G4 ?" q# d' R; e: T8 D5 H
  15. */
    7 S) l1 I3 P* q) ]
  16. 5 C6 ^' F4 q* o( U- j$ j
  17. void  OSTaskSwHook (void)5 x8 r  s/ N3 u  o# H
  18. {
    ! M# h& S, b: c' E& X
  19. #if OS_CFG_TASK_PROFILE_EN > 0u
    $ e/ g/ ?3 s) [. h: |( G/ ^
  20.     CPU_TS  ts;3 J2 z1 c& V4 ~/ h
  21. #endif
      U- E# }9 r0 p/ N$ R' e
  22. #ifdef  CPU_CFG_INT_DIS_MEAS_EN
    . y8 T) G' u9 ^/ y
  23.     CPU_TS  int_dis_time;
    * n/ k3 [& s/ Q+ ?0 f3 \0 }
  24. #endif; t' Y7 J* q9 v  e# J+ ~
  25. ! I* ?- H  s7 Q) T

  26. 9 m8 U+ E) w0 |" s

  27. . {0 s" d8 i% i  K- b+ z
  28. #if OS_CFG_APP_HOOKS_EN > 0u: @+ |0 F. X, ]3 i& Q0 a
  29.     if (OS_AppTaskSwHookPtr != (OS_APP_HOOK_VOID)0) {
    $ S; k; N+ e3 }
  30.         (*OS_AppTaskSwHookPtr)();
    ( I' X: N/ }0 S  u7 S
  31.     }# f5 p! |  V- ]
  32. #endif, ~9 F" v, {$ ?1 l5 v1 F
  33. 9 b( v- ]! t" H
  34. #if OS_CFG_TASK_PROFILE_EN > 0u6 e5 ~, D5 e& U* i% W$ O/ {3 `- W
  35.     ts = OS_TS_GET();
    ' H0 c8 r2 d  v0 A3 s
  36.     if (OSTCBCurPtr != OSTCBHighRdyPtr) {
    4 |$ Q" n) o$ Y) y, X2 `3 N
  37.         OSTCBCurPtr->CyclesDelta  = ts - OSTCBCurPtr->CyclesStart;
    6 q( i1 F" K& i% a& L
  38.         OSTCBCurPtr->CyclesTotal += (OS_CYCLES)OSTCBCurPtr->CyclesDelta;! W# h) S& J/ [  @% F7 P
  39.     }
    ' S8 [$ F7 \( a/ w' S
  40. - O+ P& E3 n3 s" v. p
  41.     OSTCBHighRdyPtr->CyclesStart = ts;2 ], G8 z" M3 ]  P
  42. #endif3 s- N1 S4 c% B* O) N$ N
  43. & P0 K* {# \0 Q5 [
  44. #ifdef  CPU_CFG_INT_DIS_MEAS_EN9 S( R, Z% C- c; ?# l
  45.     int_dis_time = CPU_IntDisMeasMaxCurReset();  /* Keep track of per-task interrupt disable time  *// z4 z8 L/ R5 W. M: i! I
  46.     if (OSTCBCurPtr->IntDisTimeMax < int_dis_time) {
    : B6 \2 e3 W7 w* k. a3 q2 }9 W" G) B
  47.         OSTCBCurPtr->IntDisTimeMax = int_dis_time;
    & Z' u5 t/ z! x( e5 _
  48.     }9 L0 R9 T! Q6 E3 Z
  49. #endif
    ! ]" B% a1 j0 A/ \
  50. 3 b9 t' g0 s0 C; ]: o, u
  51. #if OS_CFG_SCHED_LOCK_TIME_MEAS_EN > 0u
    - f, k5 V' P; C8 x& e- H" P* U8 K
  52.                                                /* Keep track of per-task scheduler lock time    */; A! m2 D0 L/ v9 H/ |1 j
  53.     if (OSTCBCurPtr->SchedLockTimeMax < OSSchedLockTimeMaxCur) {  o! t) P. ?+ [1 c7 k/ A6 P6 Q3 O
  54.         OSTCBCurPtr->SchedLockTimeMax = OSSchedLockTimeMaxCur;1 G7 q+ G' N) E' n8 I, x" X
  55.     }
    3 Y6 i0 B7 P6 u) u
  56.     OSSchedLockTimeMaxCur = (CPU_TS)0;         /* Reset the per-task value                     */0 |/ n5 x- m- `8 T3 P. ?
  57. #endif
    # [1 D8 L+ ?7 W
  58. }
复制代码
l OSTaskSwHook 是任务切换的钩子函数
    这个函数里面也有用到函数指针,使用方法和前面的函数是一样的。函数里面还有一些执行时间的测量,这些内容会在后面源码讲解的时候再跟大家分析。
  1. /*2 C9 x  G( o, j% r: S" \' F
  2. *********************************************************************************************************
    , ^- y7 V# N+ t; v# F6 K0 H- Q' A
  3. *                                              TICK HOOK7 R! ~7 \+ ~6 r$ v. V
  4. *
    * q0 a' [6 i, P% f2 T
  5. * Description: This function is called every tick.  G/ I) b0 x# E8 a6 n+ x6 ]! @% Z
  6. *
    " G! q9 h/ C0 \) P9 B
  7. * Arguments  : None.
      |/ q& K6 }, w# B$ j
  8. *" [! m, {: l' x
  9. * Note(s)    : 1) This function is assumed to be called from the Tick ISR.
    ( j5 J- x; h) I' d/ ~) W
  10. *********************************************************************************************************$ n9 C3 T" \# Q3 T; J
  11. */
    $ s1 w# w; p5 ~6 L' Y
  12. ) R  J+ n. a& E# r
  13. void  OSTimeTickHook (void)' Q8 p9 z5 n' F
  14. {
    4 R4 A6 x( I; n3 j0 g
  15. #if OS_CFG_APP_HOOKS_EN > 0u
    2 b0 n3 c- i& |7 Q3 l# Y4 q
  16.     if (OS_AppTimeTickHookPtr != (OS_APP_HOOK_VOID)0) {7 }5 `6 o# r% W& [8 B7 X2 J, x
  17.         (*OS_AppTimeTickHookPtr)();
    % ?# T% N' h0 \8 Z  t
  18.     }7 Z9 E6 q" x8 ~+ T' I! S
  19. #endif, B8 ~7 J7 ^1 k) a5 e9 _. v
  20. }
复制代码
l OSTimeTickHook 是嘀嗒定时器钩子函数
    这个函数的用法和前面的函数一样,被嘀嗒定时器中断服务程序所调用。

2 [) ]: h' m3 S
baiyongbin2009 回答时间:2014-12-22 17:12:27
9.3.2      嘀嗒定时器配置
    关于嘀嗒定时器在V5开发板用户手册第10章:SysTick实验里面有详细的讲解。这里就不再详细的赘述了,这里特别注意咱们已经在前面的os_cpu.h文件里面配置了嘀嗒定时器的优先级为0,也就是最高优先级。
  1. /*
    6 P" H( D! k, f0 y
  2. *********************************************************************************************************, w0 p8 P) a4 c
  3. *                                          SYS TICK HANDLER
    + I& t  |% k; L, h) V* ^
  4. *
    9 Q# l/ Y9 l9 b. a2 O1 s; b3 H
  5. * Description: Handle the system tick (SysTick) interrupt, which is used to generate the uC/OS-II tick
    2 m7 c3 h' M# G( K5 Y  W/ n3 N& U
  6. *              interrupt., H( M, p9 z: @5 x
  7. *: \/ M0 s, B( X$ i. c
  8. * Arguments  : None.
    " U  \8 ~* t" H) {4 M
  9. *
    / B  V7 d/ D* p6 D5 E
  10. * Note(s)    : 1) This function MUST be placed on entry 15 of the Cortex-M3 vector table.
    $ q; @  B# R" d. i% Q6 I' M2 J
  11. *********************************************************************************************************( T0 u( v5 i* k. {7 B* Q
  12. */
    + K/ t& L: Y0 a- z

  13. , k# D6 k) ]4 f) F# `
  14. void  OS_CPU_SysTickHandler (void), |$ o* H( h5 g! D# N& E9 r
  15. {# S  K1 U0 G4 _
  16.     CPU_SR_ALLOC();2 B  Y1 N! C( J  m( O! d

  17. 2 U4 ]9 s  I1 y2 M
  18. - _' G# ^1 |! y
  19.     CPU_CRITICAL_ENTER();
    * T- G4 Y( v& Z/ t- v' A
  20.     OSIntNestingCtr++;                                      /* Tell uC/OS-III that we are starting an ISR             */+ r6 H  W# C8 H; {, k
  21.     CPU_CRITICAL_EXIT();
    4 A/ y2 X$ C8 u* `& i, W. M- a' J

  22.   [. q& I4 g; e; j2 i
  23.     OSTimeTick();                                           /* Call uC/OS-III's OSTimeTick()                          */
    $ z% b9 y2 J9 |& @6 d% T
  24. 6 @, K5 ?3 ]( s4 m  e
  25.     OSIntExit();                                            /* Tell uC/OS-III that we are leaving the ISR             */8 X, m2 Y% |9 a. V9 `
  26. }5 p% E  q3 |3 o7 I) ]
  27. " l: x  F4 ^' M  z/ J
  28. /*( b0 Y5 J- k* l, A/ W8 y
  29. *********************************************************************************************************
    9 P& V3 i2 m6 ^
  30. *                                         INITIALIZE SYS TICK
    , K8 T) e) P. b2 N* L
  31. *
    " Z3 i- O* l" H4 s7 B
  32. * Description: Initialize the SysTick.
    + P# M/ Q6 y9 o1 f" K: g
  33. *
    8 M8 w7 D" S2 n2 x8 `% j5 ]
  34. * Arguments  : cnts         Number of SysTick counts between two OS tick interrupts.) D" E6 f4 k. {2 ]. q3 e# R0 M7 {
  35. *
    & ~0 l. s7 e8 M8 }6 {
  36. * Note(s)    : 1) This function MUST be called after OSStart() & after processor initialization.
    - k3 L. a% c2 W# f3 y1 b2 w
  37. *********************************************************************************************************
    , A2 ]2 |& a% u+ i; H1 ?
  38. */$ k$ [. A" {0 S4 Q3 @

  39. # V3 k3 j, ?5 d; N9 v+ {1 z" ~
  40. void  OS_CPU_SysTickInit (CPU_INT32U  cnts)* {* n$ j4 b! s. \7 K1 A* b
  41. {
    ; S1 j! w8 O% _' i0 o+ ?; A6 A% W
  42.     CPU_INT32U  prio;
    , J1 Y/ V/ w/ f& [+ V; D  S0 b" l
  43. * j, u. M( x9 F# h

  44. . z+ C4 ]) w1 U# t) g' p( u9 I: T
  45.     CPU_REG_NVIC_ST_RELOAD = cnts - 1u;
    " Q# D/ U  Q- v4 c% P8 {2 R

  46. 2 a1 S0 m. e5 j3 M  W+ ^2 I3 [; G' K
  47.                                                             /* Set SysTick handler prio.                              */. Q* j3 H5 v8 R4 ]) K6 n. T
  48.     prio                   = CPU_REG_NVIC_SHPRI3;
    0 r4 [* \8 B& q- r! E% S7 j
  49.     prio                  &= DEF_BIT_FIELD(24, 0);: R& P: R" h* U' k, w8 a" D9 X& Y5 H
  50.     prio                  |= DEF_BIT_MASK(OS_CPU_CFG_SYSTICK_PRIO, 24);
      ]# i& S2 N# I/ o# N& W1 \; \

  51. / Q) |1 y% r6 L! H2 _1 |$ |! d
  52.     CPU_REG_NVIC_SHPRI3    = prio;
    - n3 ]1 d, J$ u, L0 Z
  53. 7 r5 {2 T. {5 x. B
  54.                                                             /* Enable timer.                                          */! h! R7 r6 y% x4 t' W
  55.     CPU_REG_NVIC_ST_CTRL  |= CPU_REG_NVIC_ST_CTRL_CLKSOURCE |
    7 Z5 R3 o% \9 T2 b( V
  56.                              CPU_REG_NVIC_ST_CTRL_ENABLE;
    . u5 f7 R5 N5 E! D) A+ E
  57.                                                             /* Enable timer interrupt.                                */! G/ B) F2 v' u  @
  58.     CPU_REG_NVIC_ST_CTRL  |= CPU_REG_NVIC_ST_CTRL_TICKINT;
    1 L$ l. r# U/ z2 T" S- V
  59. }
复制代码
( |' y9 V/ C* `; {+ q
baiyongbin2009 回答时间:2014-12-22 17:13:46
9.3.3      任务堆栈初始化
    每个任务创建时都会调用这个函数,主要用于初始化任务的堆栈,以便于第一次切换到各个任务时能正确的切换(特别注意这句话,用心体会)。
  1. /*
    * R8 p. c# ~6 a% }# k: l$ t: f
  2. **********************************************************************************************************
    - z: Z3 ~9 T6 R6 |. |) i
  3. *                                       INITIALIZE A TASK'S STACK
    + |- k) T9 ^( w% Y
  4. *5 ~0 n  x( J$ k6 }' Y" ^( u
  5. * Description: This function is called by OS_Task_Create() or OSTaskCreateExt() to initialize the stack  N( ?8 o, T& D6 [2 Q
  6. *              frame of the task being created. This function is highly processor specific.3 ^1 g$ a: o9 ^% K" [
  7. *% t* F, w# N! T$ n6 @, f4 L* r
  8. * Arguments  : p_task       Pointer to the task entry point address.$ F0 Y6 |5 h8 [' @/ t+ P% C
  9. *5 r  ]* }& M, K4 {9 P
  10. *              p_arg        Pointer to a user supplied data area that will be passed to the task
    # J& i0 m2 Q4 d2 M# m# L
  11. *                               when the task first executes.
    9 m$ q4 `$ d- Q9 M7 @) ~
  12. *
    " ?  }, S) E  b8 l# \4 m2 ~8 ]
  13. *              p_stk_base   Pointer to the base address of the stack.
    5 ~2 Y: F9 _  G& z9 Q1 @8 C6 ]( c
  14. *# i2 x0 J( J6 d$ E
  15. *              stk_size     Size of the stack, in number of CPU_STK elements.; T4 V# ^( {6 C& p% v6 ]
  16. *
    1 L. h/ i- d2 l( I9 j7 }2 p
  17. *              opt          Options used to alter the behavior of OS_Task_StkInit().2 P. _/ D4 N6 R, ~6 y& N' T
  18. *                            (see OS.H for OS_TASK_OPT_xxx)./ R8 i' S1 h3 u# ^1 N% w, ]0 w
  19. *
    2 P$ ~8 V+ v& {: c
  20. * Returns    : Always returns the location of the new top-of-stack' once the processor registers have' n$ o" ]' H* ?5 [5 ]
  21. *              been placed on the stack in the proper order.  c' E. m1 v. R# R. R; f! b8 K
  22. *
    4 B: S8 E- s# ^. Z8 ], ?6 I0 T  c
  23. * Note(s)    : 1) Interrupts are enabled when task starts executing.5 e2 A% s2 |% P+ R. j) o
  24. *1 g/ ^9 @$ F, o- H8 u* S
  25. *              2) All tasks run in Thread mode, using process stack.3 c3 z3 P2 Y+ _2 |
  26. **********************************************************************************************************1 Y3 y. n8 ~- V  M: s
  27. */3 t5 O" Q9 D& M# h- x$ s7 A
  28. / {$ T3 W7 z# q
  29. CPU_STK  *OSTaskStkInit (OS_TASK_PTR    p_task,1 y1 C* d; |# S( a
  30.                          void          *p_arg,) c- t) K& g% Q! u  |
  31.                          CPU_STK       *p_stk_base,
    3 E6 s" l2 v. m7 I6 i  ~0 k# f# C
  32.                          CPU_STK       *p_stk_limit,% w8 h/ n! a8 q! I0 y% T0 i* u
  33.                          CPU_STK_SIZE   stk_size,, m+ p3 M! |5 s- I- n5 h
  34.                          OS_OPT         opt): x/ ^7 t. }3 Q' H  K
  35. {
    ! _3 M2 C1 V8 }, O
  36.     CPU_STK  *p_stk;1 A. N9 V1 t; Q* T
  37. & w" S8 k1 p. X  P; @, a
  38. 0 U! V, M( T" G- K8 o/ H
  39.     (void)opt;                             /* Prevent compiler warning                               */9 J; ~/ [" J. j# Z3 T8 _6 p8 ^+ u
  40. 8 X6 w/ _. P# u6 t/ `5 l& V5 q& j
  41.     p_stk = &p_stk_base[stk_size];         /* Load stack pointer                                     */
    6 `; [; p7 a0 I
  42.                                            /* Align the stack to 8-bytes.                            */1 R6 I3 z, U9 c# B+ \$ V
  43.     p_stk = (CPU_STK *)((CPU_STK)(p_stk) & 0xFFFFFFF8);  `3 ~# Z3 e6 }8 h5 @
  44.                                            /* Registers stacked as if auto-saved on exception        */- f+ Z. @0 b9 b4 e0 q0 }
  45.     *--p_stk = (CPU_STK)0x01000000u;       /* xPSR                                                   */
    3 e5 o( b  Y2 @$ Q( b/ C# a9 K& o" r
  46.     *--p_stk = (CPU_STK)p_task;            /* Entry Point                                            */
    2 J( ^  U" b. [- c# g6 H& i
  47.     *--p_stk = (CPU_STK)OS_TaskReturn;     /* R14 (LR)                                               */0 t3 n. a% q. E8 r* R7 `
  48.     *--p_stk = (CPU_STK)0x12121212u;       /* R12                                                    */
    * o& \8 u! e! x* }* x9 U
  49.     *--p_stk = (CPU_STK)0x03030303u;       /* R3                                                     */- U, ^+ Y6 [: v) p/ {
  50.     *--p_stk = (CPU_STK)0x02020202u;       /* R2                                                     */3 O6 Z, I  W3 i8 k
  51.     *--p_stk = (CPU_STK)p_stk_limit;       /* R1                                                     */& m$ ]6 T2 v( n" E, g
  52.     *--p_stk = (CPU_STK)p_arg;               /* R0 : argument                                          */
    & p# j0 O, ~3 J6 b% m& L2 O
  53.                                              /* Remaining registers saved on process stack             */; h/ p' k, ?8 p0 z6 ?6 U
  54.     *--p_stk = (CPU_STK)0x11111111u;         /* R11                                                    */8 v0 [1 S) s" F/ {
  55.     *--p_stk = (CPU_STK)0x10101010u;         /* R10                                                    */
    2 w) {- M, c9 _% B% J
  56.     *--p_stk = (CPU_STK)0x09090909u;         /* R9                                                     */- z! U+ v) L$ O: o
  57.     *--p_stk = (CPU_STK)0x08080808u;         /* R8                                                     */% K; F, q. S: P8 u& w. G
  58.     *--p_stk = (CPU_STK)0x07070707u;         /* R7                                                     *// K9 e" O: q0 g
  59.     *--p_stk = (CPU_STK)0x06060606u;         /* R6                                                     */
    * F5 ]( p5 R2 Y" u% [
  60.     *--p_stk = (CPU_STK)0x05050505u;         /* R5                                                     */6 j! ~9 D/ p; H* k) H
  61.     *--p_stk = (CPU_STK)0x04040404u;         /* R4                                                     */
    : C( K6 c0 z# j3 X  W, H

  62. ! D2 |8 P- i* l6 s5 S
  63.     return (p_stk);
    $ d, |" W' B' c4 U
  64. }
复制代码
    看似简单的初始化,信息量还是很大的。
  l 任务堆栈空间的8字节对齐。
  l 任务堆栈的初始化顺序,先是自动入栈的8个寄存器xPSR、PC、LR、R14、R12、R3、R2、R1、R0,然后是手动入栈的8个寄存器R4-R11。
  l 由于M4内核的堆栈生长方向是向下生长的满栈,所以初始化的时候先获得任务堆栈的末地址,然后依次递减存储这些寄存器。
  l 特别注意这句初始化:*--p_stk = (CPU_STK)OS_TaskReturn; 它的作用就是防止用户写的任务不是超级循环,而出现任务返回的情况,如果任务返回的话就会返回到OS_TaskReturn这个函数里面。
    假如任务1的堆栈控件是uint32_t  stack[1024],那么堆栈初始化后寄存器在堆栈中的排列如下:
9.3.png

) \6 H* P' @7 m/ v) g# t- w
baiyongbin2009 回答时间:2014-12-22 17:15:35
本帖最后由 baiyongbin2009 于 2014-12-22 17:17 编辑
- E8 \# [! y) q* z  x# y0 V$ `% V3 V
: d* h: h5 o7 N! ~2 U( m4 n3 y# E
9.4  os_cpu_a.asm文件讲解
    这个文件中函数的主要作用是实现任务切换,如果大家第5章的教程学懂了,这里面的函数要简单很多,μCOS-III中没有使用到SVC,只是使用了PendSV。所以大家只需懂得PendSV的使用即可。
9.4.1      开启多任务
' ?5 }/ V  T/ N% ?
NVIC_INT_CTRL   EQU     0xE000ED04                              ; Interruptcontrol state register.
NVIC_SYSPRI14   EQU     0xE000ED22                              ; System priorityregister (priority 14).
NVIC_PENDSV_PRI EQU          0xFF                              ; PendSV priority value (lowest).
NVIC_PENDSVSET  EQU     0x10000000                              ; Value totrigger PendSV exception.
# H* h# J* x: v  B
;********************************************************************************************************
;                                        START MULTITASKING
;                                     void OSStartHighRdy(void)
;
; Note(s) : 1) This function triggers a PendSV exception (essentially,causes a context switch) to cause
;              the first task tostart.
;
;           2) OSStartHighRdy()MUST:
;              a) Setup PendSVexception priority to lowest;
;              b) Set initial PSP to0, to tell context switcher this is first run;
;              c) Set the main stackto OS_CPU_ExceptStkBase
;              d) Trigger PendSVexception;
;              e) Enable interrupts(tasks will run with interrupts enabled).
;********************************************************************************************************

  I. j" t) X0 o! P5 n
OSStartHighRdy
    LDR     R0, =NVIC_SYSPRI14                          ; Set the PendSVexception priority
    LDR     R1, =NVIC_PENDSV_PRI
    STRB    R1, [R0]
% a2 Y' |, @9 ^0 }5 t/ E7 z
    MOVS    R0, #0                                      ; Set the PSP to 0 forinitial context switch call
    MSR     PSP, R0
# Y# H4 q1 E7 |& j+ {7 W9 C5 q& ]
    LDR     R0, =OS_CPU_ExceptStkBase                   ; Initialize the MSP to theOS_CPU_ExceptStkBase
    LDR     R1, [R0]
    MSR     MSP, R1   

6 x3 t, c" }9 {4 b% n
    LDR     R0, =NVIC_INT_CTRL                          ; Trigger the PendSVexception (causes context switch)
    LDR     R1, =NVIC_PENDSVSET
    STR     R1, [R0]

& S& f, O+ [* \8 m) o; M4 J. E  }. p
    CPSIE   I                                           ;Enable interrupts at processor level
+ u* o+ C) P3 Y- m
OSStartHang
    B       OSStartHang                                 ; Should never get here
6 ]: c. E# t" s; m" {% }
下面说一下上面的汇编代码都实现了什么操作。
l LDR     R0, =NVIC_SYSPRI14                             
    LDR     R1, =NVIC_PENDSV_PRI
    STRB    R1, [R0]
    这三段代码的主要功能设置PendSV,这里将其设置位最低优先级,为什么要设置位最低优先级?在前面的教程中已经说得很清楚了,这里就不再赘述了。
1 E* b4 N% o! a% T
l MOVS    R0, #0                                       
    MSR     PSP, R0
    设置PSP = 0,是告诉具体的任务切换程序(OS_CPU_PendSVHandler()),这是第一次任务切换。做过切换后PSP就不会为0了,后面讲OS_CPU_PendSVHandler()时会看到。

! c  z0 D8 p8 i2 Q5 W+ T, m/ G
l LDR     R0, =OS_CPU_ExceptStkBase                 
    LDR     R1, [R0]
    MSR     MSP,R1   
    设置MSP = OS_CPU_ExceptStkBase,开启多任务后MSP主要用于中断服务程序。

- c0 ?8 A+ O5 N  `6 T4 l5 x
l LDR     R0, =NVIC_INT_CTRL                                
    LDR     R1,=NVIC_PENDSVSET
    STR     R1, [R0]
    这里是使能PendSV中断。

# j. `! U5 X+ ^2 ]& N
l CPSIE   I                                                
    OSStartHang
    B      OSStartHang  
    这里主要是使能全局中断,使能后如果没有其它高优先级的中断需要执行,就会立即响应PendSV中断。所以说如果程序运行到了B    OSStartHang,说明多任务启动失败了。
. F6 _+ Y9 }! c
baiyongbin2009 回答时间:2014-12-22 17:18:05
9.4.2      任务切换使能
    主要有两个任务切换的函数,一个是任务级的任务切换,另一个是中断级的任务切换。这两个函数都只是使能PendSV中断,任务切换的实际工作是在PendSV中完成的。
  1. ;********************************************************************************************************! @8 m% t4 u$ n
  2. ;                       PERFORM A CONTEXT SWITCH (From task level) - OSCtxSw()% U5 i: J# J3 h( O  m* u
  3. ;
    , o: E0 U& m& J! W% H
  4. ; Note(s) : 1) OSCtxSw() is called when OS wants to perform a task context switch.  This function# {/ i) i, U3 m5 s
  5. ;              triggers the PendSV exception which is where the real work is done.
    8 b; H7 R8 ?2 k  M/ G
  6. ;********************************************************************************************************* i' O$ T% T) V: C
  7. 0 j) {7 s/ Y1 z7 G  L. F
  8. OSCtxSw7 L3 ]- X3 @' B, d3 t
  9.     LDR     R0, =NVIC_INT_CTRL                           ; Trigger the PendSV exception (causes context switch)! L/ ~2 O; g. r
  10.     LDR     R1, =NVIC_PENDSVSET
    * f, u9 H. v& X1 X
  11.     STR     R1, [R0]8 T  v1 C7 t; f
  12.     BX      LR0 z- V! }2 j* U, Q0 p7 ?

  13. 4 R8 e# ~6 u# V' p
  14. ;********************************************************************************************************
    $ G! U0 P1 m2 h& M+ {2 u
  15. ;                   PERFORM A CONTEXT SWITCH (From interrupt level) - OSIntCtxSw()0 P5 s7 u6 c; i7 ]
  16. ;
    ' p! @/ |' j0 U' o2 P) Z6 v! @
  17. ; Note(s) : 1) OSIntCtxSw() is called by OSIntExit() when it determines a context switch is needed as; X6 J5 b8 n/ q$ H
  18. ;              the result of an interrupt.  This function simply triggers a PendSV exception which will" q8 S: K1 c7 k- J- |* Z3 l
  19. ;              be handled when there are no more interrupts active and interrupts are enabled.
    # O: J1 f% r: {& e3 H( X* Q
  20. ;********************************************************************************************************
      o( Z7 L$ e: v( c5 B4 x7 H( q
  21. 3 j. A/ d/ T8 c6 [$ d  K
  22. OSIntCtxSw
    6 u1 e& c$ ?5 e6 y
  23.     LDR     R0, =NVIC_INT_CTRL                          ; Trigger the PendSV exception (causes context switch)
    ! m% R- ]5 U% A3 w2 Q' S
  24.     LDR     R1, =NVIC_PENDSVSET
    + j- \8 d" Y9 D! D! V0 c: M5 u
  25.     STR     R1, [R0]
    ! B/ T' z/ h; ]0 k8 R7 t
  26.     BX      LR
复制代码

6 C& I1 h7 D3 E0 x: D8 q+ g
% j/ q1 l: U& z4 B# W  _3 @
baiyongbin2009 回答时间:2014-12-22 17:19:38
9.4.3      PendSV中断
    关于PendSV中断,我们在第4章和第5章已经非常详细的讲解了,这里主要是给大家分析一下任务切换的处理过程,这个中断函数的前面有英文的注释说的非常好,大家有必要看一下。
  1. ;********************************************************************************************************
    3 N" u3 G; w: _: L, i$ t) r: i# f# b
  2. ;                                       HANDLE PendSV EXCEPTION
    3 W8 ~$ ]. u+ C
  3. ;                                   void OS_CPU_PendSVHandler(void)
    6 v, m: R/ @6 I8 m  y9 W$ |8 J
  4. ;
    % y. g1 L2 K" O* Y; f8 I( w! G
  5. ; Note(s) : 1) PendSV is used to cause a context switch.  This is a recommended method for performing
    - F3 W4 Q2 a( p* o
  6. ;              context switches with Cortex-M3.  This is because the Cortex-M3 auto-saves half of the% {2 N6 ^4 i9 ~( [# \/ J* n) @2 y
  7. ;              processor context on any exception, and restores same on return from exception.  So only0 D& v$ B/ G; c. E. k, v7 Q9 n' j
  8. ;              saving of R4-R11 is required and fixing up the stack pointers.  Using the PendSV exception9 E- V6 p- d( D% e! E3 O
  9. ;              this way means that context saving and restoring is identical whether it is initiated from
    9 b4 I- T9 B; G& c6 Q1 c5 O' f' g& d
  10. ;              a thread or occurs due to an interrupt or exception.% U$ h/ i/ ?$ C/ K2 D$ T3 W
  11. ;& e: ~! _& P! i$ ?2 N8 `' {1 t8 O
  12. ;           2) Pseudo-code is:2 P" B& D& G9 k& i1 c0 C
  13. ;              a) Get the process SP, if 0 then skip (goto d) the saving part (first context switch);
    . Z; x  q# g1 ^+ k# {1 e
  14. ;              b) Save remaining regs r4-r11 on process stack;- m( ^/ }' v- U1 H% X: X
  15. ;              c) Save the process SP in its TCB, OSTCBCurPtr->OSTCBStkPtr = SP;. I2 r0 W/ q7 F! _. c
  16. ;              d) Call OSTaskSwHook();
    ! q+ E' L* f. G2 o
  17. ;              e) Get current high priority, OSPrioCur = OSPrioHighRdy;
    9 v0 a; m% s. Y; t0 z1 A& u
  18. ;              f) Get current ready thread TCB, OSTCBCurPtr = OSTCBHighRdyPtr;7 H* G+ a- M3 ]0 R4 a
  19. ;              g) Get new process SP from TCB, SP = OSTCBHighRdyPtr->OSTCBStkPtr;
    * E* c( Y! y# S  X- p6 Q
  20. ;              h) Restore R4-R11 from new process stack;/ S# s: X% C+ l, b, n
  21. ;              i) Perform exception return which will restore remaining context.8 T: G0 z+ E7 }. ]5 U/ e+ r
  22. ;/ s" Q' j, U$ Q
  23. ;           3) On entry into PendSV handler:6 A: Q  ?$ o2 E" o0 F! q
  24. ;              a) The following have been saved on the process stack (by processor):
    # ^8 L6 M3 X  d2 J
  25. ;                 xPSR, PC, LR, R12, R0-R3  x6 T4 {; K1 M: ?& ^/ Z) R& p- y
  26. ;              b) Processor mode is switched to Handler mode (from Thread mode); b' v( d5 H2 G* x$ J
  27. ;              c) Stack is Main stack (switched from Process stack)
    & ^5 ]& I! O/ z
  28. ;              d) OSTCBCurPtr      points to the OS_TCB of the task to suspend+ `% G* [% R# U: a" @* J$ P
  29. ;                 OSTCBHighRdyPtr  points to the OS_TCB of the task to resume. Q' T/ q9 o+ B. V
  30. ;! G" L/ {/ G3 \' K
  31. ;           4) Since PendSV is set to lowest priority in the system (by OSStartHighRdy() above), we' d3 r7 f9 p( r9 V
  32. ;              know that it will only be run when no other exception or interrupt is active, and
    8 R% X) S  E/ P
  33. ;              therefore safe to assume that context being switched out was using the process stack (PSP).
    ! Y7 z$ r' v) L9 l. [) ^  z
  34. ;********************************************************************************************************
    9 O4 p  p, _0 N& C, ]; E

  35. ' z7 o5 h5 c% o) @
  36. OS_CPU_PendSVHandler
    ; t1 P3 A/ W! a! k
  37.     CPSID   I                                           ; Prevent interruption during context switch. a" d8 f' x6 o
  38.     MRS     R0, PSP                                     ; PSP is process stack pointer
    ; c: r$ i. E! F3 t9 ]
  39.     CBZ     R0, OS_CPU_PendSVHandler_nosave             ; Skip register save the first time
    + Q& F8 l) e+ q0 m! v# @% ~1 ?

  40. # T3 d( C1 v; x1 D
  41.     SUBS    R0, R0, #0x20                               ; Save remaining regs r4-11 on process stack' h; Q. K0 ^: t! V2 ?, u( N  W/ E
  42.     STM     R0, {R4-R11}+ N" _' i; C0 p- q2 z- r  u/ d

  43. ! \2 X8 X5 r$ L6 ]* X: m
  44.     LDR     R1, =OSTCBCurPtr                            ; OSTCBCurPtr->OSTCBStkPtr = SP;& s( L+ S' O+ }" @- L1 [) p
  45.     LDR     R1, [R1]
    6 `1 K$ T" e! I# O5 E& j& W) P
  46.     STR     R0, [R1]                                     ; R0 is SP of process being switched out- X. S% D( J* x9 Q; S& s6 b' ?

  47. 8 W7 L  W# C' u6 S8 H
  48.                                                      ; At this point, entire context of process has been saved
    ) ~7 ^5 \$ Z$ Y# I
  49. OS_CPU_PendSVHandler_nosave" M9 W# \. f  Y
  50.     PUSH    {R14}                                               ; Save LR exc_return value
    ; ^2 Z" o. o( m; ^5 }
  51.     LDR     R0, =OSTaskSwHook                                   ; OSTaskSwHook();
    0 U1 S% F/ R0 m3 _* Q
  52.     BLX     R02 |7 O4 [, V% ~5 U6 `* X% l
  53.     POP     {R14}! F4 p$ f- G# ]( \- n% W8 U
  54. & T# N; x8 ]5 s9 X6 O9 C' p
  55.     LDR     R0, =OSPrioCur                                      ; OSPrioCur   = OSPrioHighRdy;
    " |: S3 B3 @! P+ S: {6 q. N
  56.     LDR     R1, =OSPrioHighRdy
    1 Z) e7 k7 Q/ W6 j) U3 Y3 ?0 C/ _
  57.     LDRB    R2, [R1]
    - r8 z/ I& K5 n0 v
  58.     STRB    R2, [R0]7 W7 _- g2 Z+ ?7 l* c$ X

  59. , g4 J$ J' G$ N' B, w$ A
  60.     LDR     R0, =OSTCBCurPtr                                    ; OSTCBCurPtr = OSTCBHighRdyPtr;
    : o' A+ J9 |, f, S1 x  B7 w6 c9 p
  61.     LDR     R1, =OSTCBHighRdyPtr3 \2 P) b1 C0 C: B8 D! a, c% K3 u
  62.     LDR     R2, [R1]  D3 H  P4 w( [) V
  63.     STR     R2, [R0]
    8 Q4 ^) \) ~% ^' o0 s

  64. ( z0 `! X% r3 Q$ ]
  65.     LDR     R0, [R2]                                            ; R0 is new process SP; SP = OSTCBHighRdyPtr->StkPtr;
    3 I; `8 |: |% f* i9 I- P/ T9 w0 j& s
  66.     LDM     R0, {R4-R11}                                        ; Restore r4-11 from new process stack
    : x) l$ i. h! C7 |& z/ L
  67.     ADDS    R0, R0, #0x20
    ( U2 _4 V; R) M' R; Y% V
  68.     MSR     PSP, R0                                             ; Load PSP with new process SP
    8 u* _0 \1 Y6 B) u8 T8 ]. L( r" ]
  69.     ORR     LR, LR, #0x04                                       ; Ensure exception return uses process stack
    ; ?9 n' Y, j: L! x, Z8 P; Q
  70.     CPSIE   I
    ) D# N& j( D* @7 d2 [8 h* X& W
  71.     BX      LR                                                  ; Exception return will restore remaining context2 w) S  L$ K$ X

  72. $ s' ]5 _& |9 ^  K& C* S
  73.     END
复制代码
    这里PendSV中断的主要作用就是保存当前任务的现场,恢复下一个任务的寄存器,从而切换到下一个任务中执行程序,并保证退出PendSV后使用的是PSP (任务堆栈指针)。下面先把这些汇编代码解释一下:
  1. OS_CPU_PendSVHandler                       ;xPSR, PC, LR, R12, R0-R3已自动保存入栈8 |" Z" s+ R* L1 l3 i; i9 ]
  2. CPSID   I                                  ;任务切换期间需要关中断
    8 T* m+ J. d6 z) |$ A" r/ D. h
  3. MRS     R0, PSP                            ;R0 = PSP
    5 Y& H7 m( ]4 ]& ~
  4. CBZ     R0, OS_CPU_PendSVHandler_nosave    ;如果PSP==0跳转到OS_CPU_PendSVHandler_nosave去执行 在多任务# k) Q" x. U; R, h# v. ~. K6 O
  5. ;的初始化时PSP被初始化为0,表示任务是第一次运行,不需要压栈9 F* i: V$ M) i) z- z; r% ^
  6. 3 t9 J, w+ ~. O
  7. /********************************将当前的任务寄存器入栈*********************************************/$ j- |: C: G6 _( E+ q# H
  8. SUBS    R0, R0, #0x20        ;R0 -= 0x20 保存R4-R11到任务堆栈 共32个字节            ) r% ~/ Y/ m) ~) `  X
  9. STM     R0, {R4-R11}         ;压栈R4-R11
    8 H5 ^1 b" z: m& [3 o
  10. LDR     R1, =OSTCBCur        ;获取OSTCBCur->OSTCBStkPtr,
    : ?6 z2 q& [' B. C8 A
  11. ;OSTCBStkPtr是OSTCBCur 中的第一个变量                           
    ; B( }% n( k* S) i; U5 ?/ _6 q
  12. LDR     R1, [R1]             ;R1 = *R1 (R1 = OSTCBCur)3 a% O6 v1 b5 G; d" j9 q, h% _
  13. STR     R0, [R1]             ;*R1 = R0 (*OSTCBCur = SP)
    9 a) g4 g1 d' Y
  14.                              ;将当前任务的堆栈保存到自己的任务控制块
    5 G+ B/ Q& O$ y2 `0 G5 ]- c
  15. ;OSTCBCur->OSTCBStkPtr = PSP
    6 N  f+ m4 B1 ]; R( V7 w& h2 V5 |; W
  16. ;程序运行此位置,已经保存了当前任务的寄存器。
    / v' C/ w8 J2 _4 e' A- B  y/ B
  17.                            
    ' _# j4 B) r% a( e0 y1 K
  18. OS_CPU_PendSVHandler_nosave7 J3 N+ g% \/ U, h. M  O
  19. PUSH    {R14}                ;R14 入栈
    " P/ y+ J5 X- b$ }- y7 r8 ~
  20. LDR     R0, =OSTaskSwHook    ;OSTaskSwHook(); R0 = &OSTaskSwHook( H' x7 x2 t5 L
  21. BLX     R0                   ;调用OSTaskSwHook()2 R4 ?$ e" f4 E; z, M
  22. POP     {R14}                ;恢复R14
    ; M8 X1 K: @0 F' V" k5 g( Y

  23. / P* M3 I, B4 I- w0 _
  24. /********************************加载要执行任务的寄存器*********************************************/* j% d) m- T- B& R
  25. LDR     R0, =OSPrioCur      ;R0 = &OSPrioCur3 ?8 O* H9 o8 p* X0 W5 s$ P8 k) u
  26. LDR     R1, =OSPrioHighRdy  ;R1 = &OSPrioHighRdy6 P$ h+ f4 b9 k7 C* _* ]
  27. LDRB    R2, [R1]            ;R2 = *R1
    * _/ P5 I8 q! O6 `- s8 w3 ?
  28. STRB    R2, [R0]            ;*R0 = R2' N  X/ s  ~1 w$ X2 s, ~5 V" W, x
  29.                             ;上面这四句函数的功能就是OSPrioCur = OSPrioHighRdy
    9 g9 ]' m/ f* [" s4 ?4 I* M0 |

  30. ( ^3 O+ S# N1 x5 s
  31. LDR     R0, =OSTCBCur       ;R0 = &OSTCBCur4 s& C% J% q! b, Q  A1 N
  32. LDR     R1, =OSTCBHighRdy   ;R1 = &OSTCBHighRdy
    ' `7 T6 M$ Q3 |& _4 O, M4 e
  33. LDR     R2, [R1]            ;R2 = *R1
    . U2 c/ b( {/ C* ^
  34. STR     R2, [R0]            ;*R0 = R2
    ) q3 A* b6 ^" t6 a
  35. ;上面这四句函数的功能就是OSTCBCur = OSTCBHighRdy( Q5 M# T, t0 J& g

  36. 9 J0 N2 u0 J/ \" {
  37. LDR     R0, [R2]            ;R0 = *R2 也就是R0 = OSTCBHighRdy又因为SP = OSTCBHighRdy->OSTCBStkPtr
    8 a1 `5 Z, B& J% B9 E) W
  38.                             ;这条指令的含义就是R0=PSP。+ N) l7 d( A% [; ]
  39. LDM     R0, {R4-R11}        ;从任务堆栈恢复R4-R11
    % \# k, }  m' X
  40. ADDS    R0, R0, #0x20       ;调整R0 += 0x20
    ; q8 S& R3 g6 s: D
  41. MSR     PSP, R0             ;PSP = R0
    ' ]) O6 _% z$ f& M
  42. ORR     LR, LR, #0x04     ; 确保LR位2为1,返回后使用进程堆栈PSP
    $ f2 A, s% I# ~( J5 X
  43. CPSIE   I                 ; 开中断
    7 R! M5 R. ?" l6 z: z6 c) J& R1 ]- B# N1 U
  44. BX      LR                ; 中断返回,剩下的8个寄存器会自动的出栈。4 ^' Q9 f6 I9 ]2 {0 I
  45. END
复制代码
    为了帮助大家更好的理解这个过程,这里举一个简单的例子:
  l 第一步:开始多任务后,系统就会从咱们上面说的OSStartHighRdy进入到PendSV中断,进入中断前使用的是MSP,也就是说自动入栈的8个寄存器被压入到MSP所指向的堆栈空间。
  l 第二步:进入中断后开始MSP(因为中断程序中只能使用MSP,而不能使用PSP)。由于是第一次进入执行PendSV,剩下的8个需要手动入栈的寄存器不需要执行入栈操作(为什么不需要入栈操作? 因为第一次执行PendSV前的函数只是μCOS-III的初始化,而不是需要执行的任务,所以现场不需要保存)。
  l 第三步:获得当前需要执行的最高优先级任务A后,程序就会从任务A的堆栈空间恢复需要手动入栈的8个寄存器R4-R11,在退出PendSV后,剩下的8个寄存器内容会自动得到恢复。由于前面初始化任务堆栈的时候,已经指定了任务的地址,所以这时就能正确的切换到任务A中。
  l 第四步:当任务A被挂起或者其它的原因,系统再次进入到PendSV中断,进入中断前自动入栈的8个寄存器已经被保存到任务A的堆栈空间,进入中断后再将剩余8个需要手动入栈的8个寄存器推入任务A的堆栈空间,并保存PSP到任务A的TCB控制块,剩下执行的操作就和第三步相同了,获取另一个需要执行的高优先级任务B。初学的同学一定要不这个过程分析透,并牢记。这个过程很重要,要不任务怎么切换的都不知道。
1 ~' W' N" _& N4 S
baiyongbin2009 回答时间:2014-12-22 17:20:39
9.5  总结
    希望初学的同学将文章所讲的三个文件自行分析一下,特别是PendSV中断函数的内容。本期教程的内容理解透了,对于后面学习源码大有裨益。
) g& y. X/ D+ K. e$ z/ ?
参考资料:
1.       www.micrium.com

' d" J" D* K5 n& Y3 J' K& s0 N& b

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版