|
但当一个项目软件代码多了以后,尤其是分了很多模块后,这样打印就不方便了,因为有时我只想看本模块的打印的信息,而又不想被其他模块信息干扰,怎么办呢?: w% w, p, E' R
一种简单直观的方法是为本模块单独写一个打印信息的函数来调用。然而当模块很多时,这样做就效率就不高了,并显得冗余。下面介绍我设计的一个可配置的模块打印信息的方法(此适用于裸机程序) 。
# `! F1 g- X6 t9 Q, z1 J
1 Y. S9 l, ?8 Q在此我单独写了一个 debug 模块,包含 debug.c 和 debug.h 两文件,.c 定义了所要调用打印信息函数等,.h 可配置,以方便地选择性打印你需要的模块信息。 : _* R9 q6 w& B# I) G* u( z
如我一个工程中包含有系统模块、温度检测模块、电机控制模块,则首先在 debug.c 中定义如下字符串数组
9 {0 P/ }9 o; P3 f9 j1 r. U- char *DEBUG_MODULE_MSG[] =
% }2 x% J9 \# w: }8 d [ - {8 e$ v1 M: }* Z" G$ t7 H; |: o4 x$ T
- "NOTHING",
% |7 E: S/ O T7 n" P - "SYS",, Y; C' }. T+ s" I2 O2 I. M- X
- "TEMP",; U6 p& e8 A( Q3 e
- "MOTOR",
! r" P& {* I" ~ - };
复制代码 8 D: d' `' O/ Y9 ^) b
在.h 中作如下定义 - #if 1; d; n& R( K- T C
- #define SYS_DEBUG" C3 L3 }2 ]" R
- #define TEMP_DEBUG4 H+ Q4 q; ~2 M( s0 {( j
- #define MOTOR_DEBUG
. q" b; a$ h- Q( W7 }+ Y - #endif
4 r& R E2 c: }, M - //-------, X/ K; o8 j1 P! s5 B; o; q' _
- #ifdef SYS_DEBUG
& ^4 O. E8 A' r# ^4 S- V - #define SYS (1<<0)" _; O. R) K/ {9 M8 s0 T, b
- #else6 Z# `! x- O7 _4 A
- #define SYS 0- o( X% h# \" S1 @2 A* v2 N" [1 G
- #endif! \& m8 H( e' g: T4 R& U
- //-------
4 S# [2 k$ t, f - #ifdef TEMP_DEBUG
$ j" ^3 s: q5 _6 H- z# R - #define TEMP (1<<1)
9 h8 c3 b$ M4 j - #else
1 S& ?$ C* B+ n& s, E" B - #define TEMP 0
/ q6 B. X8 d% j$ W& W/ k - #endif" k4 i( R( j! G# s( Q3 m9 G; e
- //-------; }, `: K. u3 b. \
- #ifdef MOTOR_DEBUG- b5 G' a. Q0 U* N$ s
- #define MOTOR (1<<2) U% }2 Z d5 Z2 G- N1 I
- #else
, y7 g$ {5 N$ a# A/ P - #define MOTOR 0
7 k0 i0 T, F0 J; M6 n - #endif+ d, e' B* u5 s; ~/ e2 \
- #define DEBUG_MODULE_NUM 3' @6 t _6 K+ ~) z& s+ k
- //-------
复制代码 # B3 F* m1 M X4 ?1 I7 y
其中通过最上面几个宏定义你就可以选择性地打印需要的模块的调试信息,不要打印的直接屏蔽掉就好了,如果再增加模块,只需再多定义一个宏,然把模块数量增加,并在字符串数组里依次添加此模块要打印出名称。 5 z% b( \. S% H- s: z" _/ w
下面介绍如何对以上配置进行解析并按要求打印出来,在.c 里如下实现代码8 R: d6 H5 `, v4 H7 ?
- /**
9 N( o) I$ }5 W/ L: T - * @brief 检测询要打印的模块
/ Z6 `& k* u1 p7 p - * @param module: 宏定义模块名- k( c3 G- ~, z6 x
- * @retval 对应模块字符串偏移量
* c1 d# i+ D Z" F- z - */ E9 W5 c2 v9 N; A1 d5 T) p
- static u16 check_debug_sw(u module) ) x; s( h% V( j9 D1 Y
- {6 n! R5 o" v- K, r+ p/ f3 p
- u16 i ;) G, D3 ]5 O& t
-
2 j5 n, Z" P- w- L3 c - if (0 == module)
) s+ E) m$ p/ B - {1 i: Z: ~% F0 u
- return 0;' h3 a6 ]4 s4 z6 n; q5 [
- }, ~) D0 w& {/ g3 y
- else# x v6 L# ^# U5 L/ o8 Q
- {4 C; J8 j0 e" R- s Z4 \$ G. t- T! J
- for (i = 0; i < DEBUG_MODULE_NUM ; i++)
. ]; u9 T J7 g8 U8 i - {* Z, t- [3 g8 s2 [( d6 X W
- if (module & (1 << i))
" N* n, n: [( ]% g; H - {
$ E" y+ _5 f, p: A! J6 F o6 i6 } - return (i + 1);
- S0 Y" H3 S! i4 }; ` - }2 v6 W7 x4 c) Z1 G8 n( m9 I9 o
- }
$ u$ z/ ?- O/ t9 D$ _ - }, L0 A \/ B& ~/ ~' r' [2 N6 M' j
-
7 [4 W j! W7 C* v/ N, t1 S9 u - return 0;# d8 W, i0 }( V: o! a$ G3 ^$ {
- }
复制代码 5 X2 M! w" F; |& [6 z3 E) n' R
此函数用于检测要打印的模块是否开启,如开启则返回模块对应的偏移量,以方便打印字符串数组中对应的模块名,若没找到,则返回 0。
! b6 L( C' B2 T! |' ?7 _ ^: _, `+ O
下面就是调试信息打印函数了,其实只需模仿 printf 函数的实现,并作简单的修改就可实现模块化打印。如下
6 J3 `: c7 O% A6 q- /*** C. O" x( r# S( T9 ]
- * @brief 可进行模块选择的可变参数的打印调试函数
+ s% I, L6 P& a. W7 F) P7 x3 M5 l9 ~ - * @param module: 宏定义模块名 ...
) X) _* ?# q7 x - * @retval None
! n* M/ R" {/ g2 U - */8 `! B) s" O* c" A# P+ E
- void Debug_Msg_Module_Printf(u16 module, char *fmt, ...)
# J+ u; ?& E9 h6 g! O+ a, Q" R - {
* i! G1 x2 m" t: G3 s3 }: F - va_list ap;* W5 @ J/ a7 o T
- char *p = NULL , *sval = NULL;) ]: r- u4 \. q
- int ival;
) l+ x$ M! h) G+ B- ~5 o/ C - unsigned uval;
5 j# ^& `! f8 B% Y U - double dval;
% @5 p8 O. U& ~+ w7 Z5 ? - u16 flag = 0 ;
H. w ]7 y7 ? -
# z' S5 Z6 e6 `# ?! E - if (0 != (flag = check_debug_sw(module)))
, S! q5 B6 d0 N) a& n3 O. |! z - {
/ W# a1 n* o% r% c6 v8 ? - printf("[ %s ]", DEBUG_MODULE_MSG[flag]);
# G: H0 V7 T' a2 ~ - va_start(ap, fmt);' d' Z# z# ]9 D F
-
; u# m& ^. X% V( i2 G/ S - for (p = fmt; *p; p++)
) h7 N5 c' A, e. S& y& _9 u% K - {
9 @' z- ~; t6 d8 J* o: p - if (*p != '%'). ?* b" q! m" H
- {
! \ p$ H( H% U; `* ~! z - putchar(*p);
" d7 u7 W' E+ J - continue;4 v4 Y% H& `- f: g! t0 h; L
- }
: A5 [8 U6 ~( O/ ?- l2 |2 j" E - ; K9 E% ~7 K- m8 z( |. q O
- switch (*++p). y' |6 Z- b+ H* K S" s3 |+ D A
- {5 Y: S. f! U$ o2 H" @) G4 R
- case 'd':
; ?% \. L) w$ V% O6 ] - case 'i': C9 q1 ?( Q1 c" K" [9 x
- ival = va_arg(ap, int);$ C5 X0 v- X' i5 E8 k
- printf("%d", ival);9 e! E5 E$ o" O0 ]) f& T. r
- break;8 P8 g2 ?2 \# ]3 M6 N4 g! p3 }
- % P8 x; }" A/ T; t, U" P; ~
- case 'c':# d0 T) w9 p) A: r. u! A5 M
- ival = va_arg(ap, int);
. }( S. B- y2 U - putchar(ival);$ b- I' N" k3 O. k, g1 U b8 g
- break;
) h9 y- ^/ a5 k; A/ m -
% ]( N/ f! U7 C - case 'u':
' V, A. I4 C% @3 u- y - uval = va_arg(ap, unsigned);3 R& H6 L. A% Q3 r1 T' y/ B
- printf("%u", uval);# ^* A% [3 y# l a4 K
- break;- O c! e/ x2 r |
-
9 \& L8 d4 H, D3 X8 ] - case 'x':# C* r, A% B& u! u
- uval = va_arg(ap, unsigned);
6 P) U. M; o0 K2 \9 K+ _! ` - printf("%x", uval);) o3 j) j r1 T* J7 Z
- break;8 j5 | g4 m. V$ `
- 7 j& S y4 Y7 [0 ^( r' T
- case 'X':* @' I) h$ a6 P* u- p& @
- uval = va_arg(ap, unsigned);. z! Z$ V! |% `4 J: m/ z! h3 H% L
- printf("%X", uval);7 l5 K/ u9 Y& N$ W$ u8 A4 q
- break;
3 f7 {5 ~$ O* O" a9 `" b -
* O i8 v7 _' E2 | - case 'o':
/ F' A3 s! ]6 F$ L2 w: H - uval = va_arg(ap, unsigned);' H; _- Q1 r: o$ o# q D4 I- d
- printf("%o", uval);& ^: A. y G- u' X$ h9 V$ I2 Y3 A
- break;/ O) r b+ W+ {
-
' I3 ?2 O3 w4 D' ? - case 'e':
9 f8 j) T( z0 A9 V7 E7 T* e S, `* O - dval = va_arg(ap, double);
) b, \; M! G; {5 [- L - printf("%e", dval);8 I( {7 c7 Y6 v/ L6 [: Q' E K
- break;
; y9 l1 C$ `0 b4 v0 h _1 T - 2 R Q& t4 [ p# Y& b8 c4 E9 ]! |
- case 'f':
7 W$ e2 {' N# x# d8 i: p - dval = va_arg(ap, double);
6 {) \) d/ _" k( T! G' ]3 a1 S - printf("%f", dval);
- q( K" r% Y3 B3 K+ I0 D$ X. w2 X - break;
3 m7 m/ G7 Q( ^4 Z1 ~. a -
% J9 Y2 q7 I8 i6 o% N - case 'g':; _ S7 K5 e" {/ i
- dval = va_arg(ap, double);
) V) T/ b7 ]7 {* ^ Y - printf("%g", dval);2 {4 Q0 B" V. m; s0 x" ?( T
- break;/ S1 e8 B: {8 W+ r4 L7 x( a
- $ r: G: H: S* n/ h, ?
- case 's':2 P {, a" W+ j
- for (sval = va_arg(ap, char *); *sval; sval++)6 i1 v+ j! ^3 W0 z2 J: b" Z$ ^! z Z
- {
% O9 S1 O: a3 h - putchar(*sval);6 E6 _5 G% i, ~3 ] p
- }1 M- Q! n( Y4 Q& m% I- C
- 4 Y( p, ~* e8 \! p7 k: N2 K6 j
- break;
( Z7 D2 c3 s7 D6 z9 E: o1 B( J& z - ) }7 J1 W Y! Q+ J' h4 U1 w' V
- default :
+ n8 c7 V% S" h$ A- I - putchar(*p);
1 v; a1 {( c: R f. U - break;/ s0 y4 ]! O. q* _) \$ H
- }( _: V5 m" C1 k h
- }
. F& f7 C; b4 d# V( O - 4 ~+ U- [- [: w
- va_end(ap);' c9 B- W! _$ F( `- S
- }& ^* e- c8 W( i5 b. f5 Y2 y
- }
复制代码
! |; O( h) c' S! |( i至此,模块化信息打印方法就实现了。
* [: u! r x& w$ ~: R1 f
/ Q3 ? }7 i' T K5 g1 ]要进行打印信息调试,如温度检测模块可以如下调用4 T. x, e/ x. C9 }% y
- Debug_Msg_Module_Printf(TEMP,"Temp is %d \n",temp);
复制代码电机控制模块可如此调用:
+ k8 e( S9 y. D& F( ? - Debug_Msg_Module_Printf(MOTOR,"Motor Running \n");
) q2 P7 e/ M0 r( a7 f+ c/ B( F - Debug_Msg_Module_Printf(MOTOR,"Motor Stopped \n");
复制代码 # B Z# T D! B8 A- c
如若要屏蔽掉所有的电机模块打印消息,只需要.h 文件中作如下修改: - #if 1
) ]: T8 f* S! Z9 S! ~0 | - #define SYS_DEBUG( f3 d5 B6 O; P1 W0 X; R. `4 z- j4 h H
- #define TEMP_DEBUG
3 Q# b( f; G+ K# Q - //#define MOTOR_DEBUG //注释掉此行宏定义2 v/ d3 Y" G9 d. B5 q3 w' b
- #endif
复制代码 5 e/ n% i [/ b
转载自:以太快跑 |