特别说明:
! C: j& i% g# L6 S1. 本教程是安富莱电子原创。
4 x& V) ^4 Z4 g; U. S* ~1 h. ]2. 安富莱STM32F407开发板资料已经全部开源,开源地址:地址链接( w0 S8 J1 J* N4 e+ q
3. 当前共配套300多个实例,4套用户手册。 A/ n8 \! P( L
第11章 μCOS-III内核函数分析
, Q2 j* x' ?- V/ W" z* ]7 g 本期教程开始分析μCOS-III的内核函数,源码的分析采用先对源码进行注释,然后讲解函数实现的功能和相关的原理分析,最后是举一个例子(如果这个函数是供外部函数调用的)。内核函数很重要,是学习任务管理,任务间通信机制的基础。希望初学的同学认真学习,这部分应该算是μCOS-III的核心代码。 11.1 系统配置文件 11.2 源码文件 11.3 μCOS-III初始化 11.4 μCOS-III启动 11.5 获取系统版本 11.6 空闲任务 11.7 临界段 11.8 安全关键IEC61508 11.9 任务切换 11.10 调度锁 11.11 Round-Robin调度 11.12 总结
- b2 F# d. D; u3 c! M9 i! E11.1 系统配置文件 下面先简单说明下μCOS-III中几个配置文件的作用,方便分析源码的时候查看,配置文件主要有以下几个:
5 l+ y/ e* d; _: e( _/ K5 K11.1.1 lib_cfg.h配置文件 lib_cfg.h文件内容如下: - /*
0 x8 y' q# g/ D/ X2 J - *********************************************************************************************************
3 ?8 z8 p5 f/ y X) _/ w. o8 K/ O - * MODULE* o5 s/ c) ]' i0 n, J" u( Z. F
- *********************************************************************************************************
# M* J9 I( f' g) S+ P9 ] - */- t0 N9 \% m& i2 }8 t
-
" C/ W/ {; k) m) S1 I& y! ~- G - #ifndef LIB_CFG_MODULE_PRESENT1 k" |! @' @* K
- #define LIB_CFG_MODULE_PRESENT
5 O, Z& o0 s+ ^ p* L& o; {' i - 0 {- X- D; M- R2 u5 C( ~
- /* m* ~. [1 S! g d
- *********************************************************************************************************3 o: v" [8 a* `! w1 D0 e
- * uC/LIB CONFIGURATION
8 z3 ~+ a: e& \1 [( Q - *********************************************************************************************************( P8 j8 z2 ~: \- }" w' t
- */9 w% \. X, E1 C/ V Z
- " {; ^$ p w3 O' v) {
- #define LIB_MEM_CFG_ARG_CHK_EXT_EN DEF_ENABLED
! B2 G9 j+ o$ n3 g - /* DEF_DISABLED Argument check DISABLED */
1 p2 C8 r6 j' e, _% H$ ^1 k* X - /* DEF_ENABLED Argument check ENABLED */
* R7 o7 b. n) \9 J4 X, L9 P -
. \9 p) Q R$ h/ F: m# Z - #define LIB_MEM_CFG_OPTIMIZE_ASM_EN DEF_ENABLED4 d8 {' V: a7 H- x& L* f0 d
- /* DEF_DISABLED Assembly-optimized function(s) DISABLED */
: y3 c1 K, E7 R( N - /* DEF_ENABLED Assembly-optimized function(s) ENABLED */4 w) W/ e( M4 r: M2 R' e
- * d R4 z/ C( S+ F: z/ t. G2 n' i
- #define LIB_MEM_CFG_ALLOC_EN DEF_ENABLED1 t& h+ \6 I3 U0 O0 ]
- /* DEF_DISABLED Memory allocation DISABLED */
& a V j! y/ J$ b+ Y3 w - /* DEF_ENABLED Memory allocation ENABLED */
0 i0 w6 M& m5 ~' @: y - & l. W( J2 h5 J: ?) q4 P% S
- #define LIB_MEM_CFG_HEAP_SIZE 23u * 1024u /* Configure Heap Memory Size */% t: Y) h7 _' o& A" w! r0 x* D
- 5 I" B, }8 ` A
- /*7 |1 Q4 r9 I( F# E' e' v6 Z( F. s
- *********************************************************************************************************! O) ]0 A- {' _7 a$ Q$ C: L- X3 p8 D$ L
- * MODULE END8 y: }( q3 U9 G" C; q
- *********************************************************************************************************
7 v7 w4 g0 w6 L+ S7 M, [, o - */1 A" s* p2 ~2 n; V+ K9 v! m! m
-
7 E" L$ F7 w; a+ ~ - #endif<span lang="EN-US" style="text-indent: 21.2pt; line-height: 12pt; font-size: 9pt; font-family: 新宋体; background-color: rgb(255, 255, 255);"> </span><span lang="EN-US" style="text-indent: 21.2pt; line-height: 12pt; font-family: 微软雅黑, sans-serif; background-color: rgb(255, 255, 255);"> </span>
复制代码 lib_cfg.h是用于给uC/LIB做配置的头文件。如果程序中使用uC/LIB的话,需要调用函数Mem_Init()进行初始化。 11.1.2 os_cfg.h配置文件 os_cfg.h文件中的内容如下: - #ifndef OS_CFG_H6 W" [! m, B7 Z. t( x' F' C' `$ p
- #define OS_CFG_H% r+ q" ^8 C* ]/ f4 d9 d5 Y
- . U6 Q; f0 k. f
-
- g$ v" y& P1 r% v% B- ~ - /* ---------------------------- MISCELLANEOUS -------------------------- */0 o. }( C2 Q4 ]; v
- #define OS_CFG_APP_HOOKS_EN 1u /* Enable (1) or Disable (0) application specific hooks */5 ^9 i' U4 x; ]! K5 t* A. ~
- #define OS_CFG_ARG_CHK_EN 1u /* Enable (1) or Disable (0) argument checking */
' l' U% z! H3 p% j0 f5 ] - #define OS_CFG_CALLED_FROM_ISR_CHK_EN 1u /* Enable (1) or Disable (0) check for called from ISR */
4 O2 G% Z2 b/ b/ K8 o; q - #define OS_CFG_DBG_EN 1u /* Enable (1) debug code/variables */
: i2 W a. C" J( g g$ g" h0 ] - #define OS_CFG_ISR_POST_DEFERRED_EN 0u /* Enable (1) or Disable (0) Deferred ISR posts */5 v6 M( v4 O; C) ]+ C/ r
- #define OS_CFG_OBJ_TYPE_CHK_EN 1u /* Enable (1) or Disable (0) object type checking */
( n3 k. v( ~7 T3 @, m- {6 p - #define OS_CFG_TS_EN 1u /* Enable (1) or Disable (0) time stamping */- _3 l3 e5 X2 C T5 L, ^8 R
- , [5 d( C: H7 T7 k" Y( n( e
- #define OS_CFG_PEND_MULTI_EN 1u /* Enable (1) or Disable (0) code generation for multi-pend feature */& Q3 S2 k7 X8 P+ J$ b! _. z
-
* o7 y* C' P; t/ L7 J - #define OS_CFG_PRIO_MAX 64u /* Defines the maximum number of task priorities (see OS_PRIO data type) */
* Z2 H; l- F" H" L1 j! p# ^1 J6 e3 D7 } -
0 n& Y1 X2 B& T( U, ?& K8 D - #define OS_CFG_SCHED_LOCK_TIME_MEAS_EN 0u /* Include code to measure scheduler lock time */4 |' g. r5 h+ q$ t" T4 f3 D
- #define OS_CFG_SCHED_ROUND_ROBIN_EN 0u /* Include code for Round-Robin scheduling */
6 F- y9 |- K0 I/ v2 G% y1 T: @7 k+ o# u - #define OS_CFG_STK_SIZE_MIN 64u /* Minimum allowable task stack size */# N9 S& U M+ L, T5 M+ d
-
* @* \1 a6 N2 |3 B4 G l; x) _8 N -
1 ^& Y6 |! i" Y6 U - /* ----------------------------- EVENT FLAGS --------------------------- */
0 Z& W8 @ ]& R* a$ H; E) J' S- P7 f - #define OS_CFG_FLAG_EN 1u /* Enable (1) or Disable (0) code generation for EVENT FLAGS */3 t# J, k; M' A/ F. X' S
- #define OS_CFG_FLAG_DEL_EN 1u /* Include code for OSFlagDel() */- k* Z. G- y. _- n
- #define OS_CFG_FLAG_MODE_CLR_EN 1u /* Include code for Wait on Clear EVENT FLAGS */
# Z" y6 p- n7 j+ W8 c" [ - #define OS_CFG_FLAG_PEND_ABORT_EN 1u /* Include code for OSFlagPendAbort() */
6 b5 a5 ~7 _+ k/ R0 I, \+ J6 z - 5 ?4 Z3 B! v8 i+ F/ H
- 6 N% B0 W9 b% H) }; r% f
- /* -------------------------- MEMORY MANAGEMENT ------------------------ */
. u l. N' |& a: J! E; _ - #define OS_CFG_MEM_EN 1u /* Enable (1) or Disable (0) code generation for MEMORY MANAGER */
( R4 N# D) N. _# d7 T3 i -
1 c" m+ x$ [; [/ b2 b; i, F - 0 j- Y `% P. T* w. O+ S& y" {
- /* --------------------- MUTUAL EXCLUSION SEMAPHORES ------------------- */% f9 a' [+ w3 h$ A( O
- #define OS_CFG_MUTEX_EN 1u /* Enable (1) or Disable (0) code generation for MUTEX */
9 [7 y. x+ y3 i4 @) }2 H0 i4 c - #define OS_CFG_MUTEX_DEL_EN 1u /* Include code for OSMutexDel() */& a5 T Z2 F b! j
- #define OS_CFG_MUTEX_PEND_ABORT_EN 1u /* Include code for OSMutexPendAbort() */
; U: y3 [) S( u; ? - * E. G" S+ J& q8 G" u% W# G
- " u' b- j% w+ ]+ N
- /* --------------------------- MESSAGE QUEUES -------------------------- */
! Z( s$ W0 P9 e' V7 O - #define OS_CFG_Q_EN 1u /* Enable (1) or Disable (0) code generation for QUEUES */
& H( g% G% C3 u, p - #define OS_CFG_Q_DEL_EN 1u /* Include code for OSQDel() */
. p2 k/ B8 R! A$ k - #define OS_CFG_Q_FLUSH_EN 1u /* Include code for OSQFlush() */
& S* C, U- \% I q. r - #define OS_CFG_Q_PEND_ABORT_EN 1u /* Include code for OSQPendAbort() */7 \7 |8 m A. Q0 t) S. z
- $ _8 j/ u, F' O4 Z8 S
- 7 u$ _7 u5 x, z
- /* ----------------------------- SEMAPHORES ---------------------------- */
8 {' d$ n% s0 c* ~; O- p. L - #define OS_CFG_SEM_EN 1u /* Enable (1) or Disable (0) code generation for SEMAPHORES */
3 T' z) n! \$ O- s! C4 Z - #define OS_CFG_SEM_DEL_EN 1u /* Include code for OSSemDel() */" D0 _4 o& u' n
- #define OS_CFG_SEM_PEND_ABORT_EN 1u /* Include code for OSSemPendAbort() */
: C) K; U$ ]# o& a+ A0 o* \ - #define OS_CFG_SEM_SET_EN 1u /* Include code for OSSemSet() */6 @! C6 E( W2 M, Q4 x
- 3 y- ^( ^; m2 z. b; K; @ A( w
-
6 p" @) j* E: D) d7 q2 `7 L - /* -------------------------- TASK MANAGEMENT -------------------------- */5 E+ ^3 t5 i: i G! A) ]. v5 T8 ] d5 d
- #define OS_CFG_STAT_TASK_EN 1u /* Enable (1) or Disable(0) the statistics task */
/ R4 C# L1 R* d8 w, w% @& f - #define OS_CFG_STAT_TASK_STK_CHK_EN 1u /* Check task stacks from statistic task */
6 s1 X6 Z# u2 G# z: k" l \ -
4 q A0 u+ L/ s" h% o - #define OS_CFG_TASK_CHANGE_PRIO_EN 1u /* Include code for OSTaskChangePrio() */
. g! y- W. U4 a - #define OS_CFG_TASK_DEL_EN 1u /* Include code for OSTaskDel() */0 c7 d4 ]3 W9 V- h
- #define OS_CFG_TASK_Q_EN 1u /* Include code for OSTaskQXXXX() */
9 Z! L# r" `6 t2 l% u( t - #define OS_CFG_TASK_Q_PEND_ABORT_EN 1u /* Include code for OSTaskQPendAbort() */% j6 ~5 k. p1 ~
- #define OS_CFG_TASK_PROFILE_EN 1u /* Include variables in OS_TCB for profiling */
8 ^8 c) k9 p5 I6 C# S - #define OS_CFG_TASK_REG_TBL_SIZE 1u /* Number of task specific registers */
3 h4 s# z; h: `$ ^/ C - #define OS_CFG_TASK_SEM_PEND_ABORT_EN 1u /* Include code for OSTaskSemPendAbort() */5 C; a9 l) ^- f% r t
- #define OS_CFG_TASK_SUSPEND_EN 1u /* Include code for OSTaskSuspend() and OSTaskResume() */) Z: p7 \" r4 L8 f( |5 R7 ]
-
0 z( k; x) z/ J' G5 f! W - ( h% I" M0 G& v5 ~/ p- S" ?
- /* -------------------------- TIME MANAGEMENT -------------------------- */1 ^, r3 y8 J# U
- #define OS_CFG_TIME_DLY_HMSM_EN 1u /* Include code for OSTimeDlyHMSM() */
+ n, N9 Y+ U7 y6 ^ V) ? N8 u. a - #define OS_CFG_TIME_DLY_RESUME_EN 1u /* Include code for OSTimeDlyResume() */
& z, F0 _& t T, N2 O j. W% e -
1 B2 e! Q( y; g; b) S2 e" }3 U -
" Z% D/ P1 H+ q2 G! F - /* ------------------------- TIMER MANAGEMENT -------------------------- */1 M* ]- S. l. }" z0 ]
- #define OS_CFG_TMR_EN 1u /* Enable (1) or Disable (0) code generation for TIMERS */
7 g$ _1 M5 T3 _+ \' O# p - #define OS_CFG_TMR_DEL_EN 1u /* Enable (1) or Disable (0) code generation for OSTmrDel() */
, y; \; s" s* y8 u) [! U+ F -
* E6 I1 k# A' b+ L( F, } - #endif
复制代码 这个配置文件比较的重要,主要用于μCOS-III源码中相关函数的配置。
& [$ q! U* v/ i" J- ? |
11.7 临界段& w; a/ Y$ b( ^
2 Q8 e) h$ \2 b. c/ a9 e- V
11.7.1 临界段基本概念
. _. B2 p) g& ] K! R) x/ q0 L j2 N
5 k. u) j7 r/ p& ~1 H
+ }& \6 v% k6 x
11.3.2 初始化函数OSInit()
11.9.2 中断级任务切换OSIntExit()
11.9.3 函数使用举例
11.1.3 os_cfg_app.h配置文件
11.1.5 cpu_cfg.h配置文件
6 t& E+ L& V' B' Z3 Q
9 d- l# s- R: t. t0 [4 [7 i' s5 n P
11.4.1 启动
8 i4 z+ G7 A2 I% A
5. 可接受凤险 (ACCeptable risk)
" g. L" Z1 [0 m6 }
' L+ u& F: x! ^0 z* s" H
11.10.2 调度器解锁OSSchedUnlock
11.10.3 调度器被锁时间测量OS_SchedLockTimeMeas
11.10.4 函数使用举例
5 V4 J3 R# `9 b- G