1. 前言

玩过Linux的朋友, 是不是对Linux无所不能的串口Shell命令控制台羡慕不已, 要是自己做的STM32F系列低档次的MCU也有这种控制交互能力, 会给调试/维护和配置省下多少麻烦事呀, 比如启动/关闭调试或自检模式, 打印调试信息, 配置系统参数, 传输文件等等, 也有相当多的朋友凭借自己出色的编程能力可以实现这些功能, 这里提出我的这个解决方案, 以作交流.

本平台(xc_shell)具备以下性能特点:

• 大量主要代码, 和具体硬件无关, 移植性强,代码文件少.

• 只有在处理用户的输入命令时, 才占用CPU资源, 且代码可裁剪到1KB SRAM和4KB Flash;

• 用户可以非常灵活的添加按模板编写的命令脚本文件, 自定义扩张能力强.

• 支持操作系统和非操作系统两种场景应用.

• 支持Ymodem文件传输协议

• 支持将Flash的扇区开辟为参数区, 可实现本地/远程升级。

• 实用Led灯信号管理, 可将65535虚拟信号灯选择输出到1个实体LED灯上, 调试时序和状态非常有用

• 拥有基础的LED管理, 调试模式设置, 命令帮助指令, 复位指令等基础功能

  
  6 _0 q3 Q' ]9 I: ]* ~! _1 j
  7 }  B6 y( d8 {% p+ q5 M* |) i7 L+ l) f

功能越多设计会越复杂, 为了解释清楚代码, 先向大家解释一下以上功能的基础实现原理， 并提供一个最小的的源码工程。

2. xc_shell平台介绍2.1 如何实现硬件无关

类比Linux会发现, 设备的硬件接口往往会被虚拟成一个文件(驱动), 而Linux内核完全与硬件系统无任何字节关联, 不同平台驱动不同而已, 故而本xc_shell的串口驱动也采用了相似的思路:

1） 串口驱动用一个结构体描述, 这样只需在xc_shell.c中用指针指向这个TTYx_HANDLE结构体对象就可以将串口(tty)硬件与内核联系在一起, 聪明的朋友可能会想到, 假如我将带网络的开发板按此结构体,虚拟一个TTY对象, 岂不是就可以实现一个网络远程控制台了!  这点确实是可以的!

2） 当然诸如多TTY串口实现接口互换等， 都是一个指针和step2中的注入回调处理交换的问题。

3）用户在使用api_TxdFrame或api_TxdByte时”bsp_ttyX.c“，会驱动具体MCU的串口将数据发送出去， 收到一帧数据后，若用户设置了inj_RcvFrame回调处理方法，则会在中断中执行用户的回调处理。

1. <i>/*---------------------*
   5 E- v* u7 T; s: K& J! l
2. *     指正函数定义
   ! b0 I/ J, t2 V9 Y
3. *----------------------*/</i>
   
4. typedef void    (*pvFunDummy)(void);
   
5. 
   
6. <i>//输入整行,输出逻辑</i>
   
7. typedef void    (*pvFunVoid) (void);
     B' o2 Y2 w; L6 }0 M6 W
8. typedef void    (*pvFunBool) (bool     bVal);
   
9. typedef void    (*pvFunChar) (uint8_t  cVal);
   # n" d" F& U# P/ V0 j( ^/ N- y
10. typedef void    (*pvFunShort)(uint16_t sVal);
    
11. typedef void    (*pvFunWord) (uint32_t wVal);
    5 E+ j6 H0 [# ~# v
12. 
    $ `3 l: m. f. O) P. L" V
13. <i>//输入整行,输出逻辑</i>
    8 R" U5 K2 o, W# {* S6 L) \) ]# ?2 F
14. typedef bool    (*pbFunVoid) (void);
    + L" ?8 k: e( n  f# [& B& C
15. typedef bool    (*pbFunBool) (bool     bVal);
    
16. typedef bool    (*pbFunChar) (uint8_t  cVal);
    
17. typedef bool    (*pbFunShort)(uint16_t sVal);
    ) K, i$ Q2 N; o  q3 a, P2 Z
18. typedef bool    (*pbFunWord) (uint32_t wVal);
    
19. 
    
20. <i>//输入整形指针,输出逻辑</i>
    
21. typedef bool    (*pbFun_pVoid) (void * pVoid);
    
22. typedef bool    (*pbFun_pChar) (uint8_t  * pStr);
    
23. typedef bool    (*pbFun_pShort)(uint16_t * pShor);
    
24. typedef bool    (*pbFun_pWord) (uint32_t * pWord);
    ; [1 S; [. A/ l$ F, r& `) h1 t
25. 
    
26. <i>//输入数据帧,输出逻辑</i>
    
27. typedef bool    (*pbFun_Buffx)(void * pcBuff, uint16_t len );
    ; i2 l7 K) m( b2 c
28. typedef bool    (*pbFun_Bytex)(uint8_t * pcByte, uint16_t len );
    
29. <i>/*---------------------*
    
30. *    TTYx 句柄结构
    
31. *----------------------*/</i>
      x7 u; ^/ F6 y9 ^
32. typedef struct TTYx_HANDLE_STRUCT
    
33. {
    % ?- ^+ M6 A/ \) q, s$ K5 H
34.     const char  * const name;       <i>//驱动器名</i>
    $ l% }) `6 D+ X) ]! L6 L
35.     const uint16_t      rxSize;     <i>//接收大小</i>
    
36.     const uint16_t      txSize;     <i>//发送大小</i>
    & \& ]9 b# Y) v! @: v4 T+ J
37.    
    : t6 @! a2 D/ @+ |) r2 F5 \
38.     <i>//------------------------------------------------------</i>
    
39.     <i>//step1: 用户可用API</i>
    $ o4 T6 `) h. h, l! ]3 ]* P
40.     const pvFunWord     init;           <i>//初始化.</i>
    
41.     const pbFun_Bytex   api_TxdFrame;   <i>//发送数据帧. (发送帧)</i>
    
42.     const pbFunChar     api_TxdByte;    <i>//发送数据字节</i>
    
43.    
    # m1 ~, ^$ |* V; C. F! U
44.     <i>//------------------------------------------------------</i>
    
45.     <i>//step2: 注入回调函数</i>
    2 b, W4 `4 f; k1 u
46.     pbFun_Bytex         inj_RcvFrame;   <i>//(ISR)接收数据帧. (接收帧)</i>
    4 _. J/ ?2 I! x
47.     pvFunDummy          inj_TxdReady;   <i>//(ISR)发送完毕回调</i>
    & g# K9 e, }/ _! L& H
48.    
    ! r; t  }9 }& H: f+ K
49.     <i>//------------------------------------------------------</i>
    
50.     <i>//step3: 接收回调函数</i>
    7 j1 ]5 G2 O+ ^4 O$ K
51.     struct TTYx_HANDLE_STRUCT * pvNext; <i>//连接到下一个指令 </i>
    ! m# i6 z) g/ n7 A) b% v7 Q# I' w
52. }TTYx_HANDLE;

复制代码

可注入的命令脚本（CLI）实现
+ n+ u# w& M. w2 I, ?! w' v, b$ @

• 命令CLI也是一个结构体对象：
  

. I7 I3 ]. h% N% k1 F# M
. e' T8 Y  s, y0 a7 `
) d) K8 W: V# A" b

1. <i>/*---------------------*
   
2. *       CLI指令
   7 Z( X  [: ^: K1 J
3. *----------------------*/</i>
   8 Z. w6 b+ g* \; p2 v1 Z) d
4. typedef struct
   $ N4 y4 G2 M1 i3 P; m; h4 ]
5. {
   
6. const char * const  pcCmdStr;     <i>//指令字符串(只能为小写字母)</i>
   
7. const char * const  pcHelpStr;     <i>//指令描述,必须以:"\r\n结束". 比如:"help: Returns a list\r\n".</i>
   
8. const pFunHook      pxCmdHook;     <i>//指向回调函数的指针,处理成功返回真否者返回0;</i>
   . d& Y7 B4 u5 j: g5 L
9. uint8_t             ucExpParam;     <i>//指令期望的参数个数</i>
   
10. const MEDIA_HANDLE *phStorage;      <i>//指向存储介质,没有的话填充NULL  </i>
    
11. }Cmd_Typedef_t;

复制代码

各位朋友可能会使用到非常多的自定义CLI命令， 格式诸如这个网卡的命令：

1. const Cmd_Typedef_t CLI_WizMsg=
   4 Z! p) u8 a/ _0 t
2. {
   
3.     <i>//识别关键字</i>
   0 l, z  }# P+ }& I. m
4.     .pcCmdStr   = "wiz",
   
5.     <i>//帮助内容</i>
   
6.     .pcHelpStr  =
   
7.     "[WIZ contorls]\r\n"
   
8. " wiz help\r\n"
   
9. " wiz rd info\r\n"
   ( X$ [+ A* v  s- _% g( |' ]* ]$ h" U
10. " wiz reset\r\n"
    / D$ n7 ?; i( e) x0 a, W
11. " wiz wr ip <D0>.<D1>.<D2>.<D3>\r\n"
    * u& i# o. _- S1 b7 T; M$ G
12. " wiz wr mask <D0>.<D1>.<D2>.<D3>\r\n"
    
13. " wiz wr way <D0>.<D1>.<D2>.<D3>\r\n"
    0 J) z  V" s& v: S, N, c
14. " wiz wr mac <H0>-<H1>-<H2>-<H3>-<H4>-<H5>\r\n"
    5 P6 l; J9 f, s. y* z& s. G3 U- j
15. " wiz wr port <udp> <bak> <vol> <pic>\r\n"
    
16. " wiz wr sip <D0>.<D1>.<D2>.<D3> <port>\r\n"
    6 {6 P; z  h% f: A+ F. ~' R
17. " wiz wr cip <D0>.<D1>.<D2>.<D3> <port>\r\n"
    ! }+ b+ T& s8 @; I
18. " wiz load default\r\n"
    
19. "[WIZ Test mode]\r\n"
    1 q9 [7 ?9 Y' K/ c9 s- Z
20. " wiz loop open\r\n"
    - `* R  {/ _/ B. w1 O
21. " wiz loop close\r\n"
    3 p4 M1 D7 l6 F: {) Z4 c
22. "\r\n",
    , w1 L# r3 ^9 @
23. 
    
24. <i>//处理函数</i>
    , t$ i1 l0 K! P4 t
25. .pxCmdHook  = &Shell_WIZ_Service,        <i>//见实体函数</i>
    
26. 
    + G% E6 [9 c4 ~. f* Z
27. <i>//附带数据</i>
    
28. .ucExpParam = 0,
    ' n% e& ^1 M; L7 X
29. 
    * o5 {8 a! i* ]" w
30.   #ifdef SHELL_USE_YMODEM  
    8 t1 s7 @2 ?( v( ]% I
31.     <i>//存储介质</i>
    
32.     .phStorage  = NULL,
    
33.   #endif
    
34. };
    
35. <i>/*---------------------*
    8 t6 N, W4 X: l: S" W
36. *       CLI 链表节
    
37. *----------------------*/</i>
    6 r, C, F9 u; d* Q% o: ~+ [
38. Cmd_List_t  WizList   = { &CLI_WizMsg,   NULL,}; <i>//Shell指令的头</i>

复制代码

如配置IP地址输入“wiz wr ip 192.168.1.250\r\n”则可以了

3. 环境准备
) w" y' ~3 f/ i( g; N8 A" h0 A3.1 硬件开发环境

• STM32F103系列开发板一块， 带USART1接口。
• USB转串口线一根。
  3 [. t3 R. R+ Z/ C9 ^/ r
  ; a! E. O- v0 `; }" F' Y# r& c" d, }

3.2 软件开发环境

• MDK4.72或以上
• SecureCRT串口超级终端
  
  

3.3 软件配置

在xc_shell使用“/r/n”作为命令的结束符， 而SecureCRT按下Enter不是输入“/r/n”故而需要按下图设置：此外在《终端》/仿真/高级中选取【本地回显】

4. 代码介绍
! A- C3 \. t5 I- t; ?& X) B% g7 o4.1 目录结构□ XC_SHELL

1. ├──┬── BSP_LIB    BSP库，硬件相关驱动代买
     l, }; C7 l3 }
2. │  ├──── bsp_ledx.c   基础LED驱动      
   
3. │  └──── bsp_tty0.c   调试串口驱动
   
4. │
   
5. ├──┬──MDK-ARM     工程文件
   0 c, e7 ^9 R" C' Q( S2 p- f" t
6. │  └──── Project.uvproj
   
7. │
   
8. ├──┬──SHELL_CFG   SHELL配置头文件
   
9. │  └──── user_eval.h
   . s/ T1 o9 `1 _3 `/ W- v9 h; o' l
10. │
    
11. ├──┬──SHELL_CORE  SHELL内核文件
    0 ]$ b% P6 l$ ^. I4 q- R) H8 {- F
12. │  ├──── xc_shell.c   SHELL内核文件
    3 u. Y% A4 v1 c& S% _( o) |
13. │  ├──── xc_ymodem.c  Ymodem传输协议（默认关闭，在xc_shell.h中启动）
    * T6 T7 `4 x1 w0 T
14. │  ├──── xc_iap.c     Flash的IAP操作，需要bsp_flash.c驱动支持
    
15. │  └──── shell_iap.c  shell的用户脚本模板
    
16. │
      M: ^7 ?2 u) U% ~# q) g
17. ├──┬──SHELL_INC   SHELL头文件
    * u* e) y9 U% z( n$ I
18. │  ├──── bsp_type.h   驱动结构定义
    7 c( x+ n' {& @" W
19. │  ├──── xc_shell.h   SHELL头文件
    
20. │  └──── xconfig.h    硬件无关配置文件
    ! R6 g" O/ f& y6 Y# C
21. │
    
22. ├──┬──STM32F10x_StdPeriph_Lib_V3.5.0  STM32的标准外设库
    ( u$ Y$ ~8 s7 y9 r6 Q6 _: _
23. │  └──── ......
    ) @* E4 k; t' I4 T; {6 R) L
24. │
    
25. └──┬──USER        用户文件   
    9 w4 {: e/ Q3 a: z
26.    ├─ .....      
    
27.    └──── main.c        main文件

复制代码

" F0 e9 S5 @6 O3 k/ N3 A: C4.2 工程设置要点

1） 设置使用微库：

2）配置包含和路径，注意使用了“--c99”标准，如图

3） 编译工程，无错误警告后烧写程序到开发板运行。

4.3 最终效果

按图输入一下指令，SHELL平台会回复相关信息。其中输入“led set 0=1”会将信号1分配到物理LED0上；输入“led set 0=2”会将信号2分配到物理LED0上。这样用户编写程序代码时相当于拥有了超级多的LED信号可用，调试时序非常有用。

5. 添加自己的指令脚本5.1 源代码示例

假设我要编写一个自己的指令脚本， 来读取MCU的关键信息，关键字为mcu， 文件命名为shell_mcu.c；当输入“mcu rd 0”时显示MCU的FLASH大小，输入“mcu rd 1”时读取MCU的唯一ID信息。shell_mcu.c源代码：

1. <i>/*********************************Copyright (c)*********************************
   
2. **                              
   
3. **                                 FIVE工作组
   0 g$ p8 ]& i  k- Q
4. **
   
5. **---------------------------------File Info------------------------------------
   : N3 R. t- N( z
6. ** File Name:               shell_mcu.c
   
7. ** Last modified Date:      2017/9/17 15:13:57
   
8. ** Last Version:            V1.0
   
9. ** Description:             shell测试
   
10. **
    ( g+ e& S( b( F
11. **------------------------------------------------------------------------------
    * g4 R* F  |7 C8 q7 k: C
12. ** Created By:              wanxuncpx
    $ h9 D4 I; A7 n3 q4 B
13. ** Created date:            2017/9/17 15:14:08
    
14. ** Version:                 V1.0
    7 v! d6 ?. l* R4 b& @9 K
15. ** Descriptions:            none
    4 z+ O# u+ y5 N6 G) f7 `. b
16. **------------------------------------------------------------------------------
    9 I; C" l1 H. A
17. ** HW_CMU:                  STM32F103
    8 t3 @1 F% H, U4 I1 I
18. ** Libraries:               STM32F10x_StdPeriph_Lib_V3.5.0
    
19. ** version                  V3.5
    
20. *******************************************************************************/</i>
    
21. 
    + m) E) O+ \0 o) g+ r! ~( g% |
22. <i>/******************************************************************************
    0 B% I7 t0 e; a
23. 更新说明:
    
24. ******************************************************************************/</i>
    
25. 
    ; J3 c6 b! Z$ J! z. Q
26. <i>/******************************************************************************
    
27. *********************************  编 译 控 制 ********************************
    & ]5 i' Q- W  R. p. W* w2 i" P
28. ******************************************************************************/</i>
    - M7 I1 K5 ]4 j7 Y% J+ ]# X( F
29. #define MCU_SHELL               //注释掉时屏蔽iap shell功能
    " a1 u  E8 _% R$ _5 R7 C& t0 a
30. 
    - Q6 l8 a8 D# ~
31. #include "xc_shell.h"       //Shell支持文件,含bool,uint8_t..以及串口数据收发操作
      h9 s1 S4 C; @+ E9 @6 b
32. <i>/******************************************************************************
    
33. ********************************* 文件引用部分 ********************************
    $ @. H! E7 r& t3 X: k9 d
34. ******************************************************************************/</i>
    
35. <i>/*---------------------*
    
36. *     模块驱动引用
    
37. *----------------------*/</i>
    * s! b/ b# h8 ?3 R  {
38. <i>//#include "net_w5500.h"</i>
    ) v: K# ]8 h* v  w
39. 
    
40. #ifdef MCU_SHELL
    
41. <i>/******************************************************************************
    
42. ********************************** Shell实例 **********************************
    
43. ******************************************************************************/</i>
    
44. <i>/*---------------------*
    & o" S# q- E2 [: q/ l
45. *      CLI指令服务
    
46. *----------------------*/</i>
    
47. extern bool Shell_MCU_Service(void * pcBuff, uint16_t len );
    # b; x+ i- r$ i
48. 
    & v4 ?2 R) Y# t- B* Y
49. <i>/*---------------------*
    
50. *       CLI 结构
    
51. *----------------------*/</i>
    - F3 @' g# n+ @
52. const Cmd_Typedef_t CLI_McuMsg=
    ; B7 h! J" L# Y/ ?  J& `& u3 }/ M
53. {
    
54.     <i>//识别关键字</i>
    6 n1 S, [' W) ^) R$ ]$ G! x
55.     "mcu",
    6 _. b: o3 Y( r, v. {& O! p0 C
56.    
    
57.     <i>//帮助内容</i>
    ' S1 }7 f4 r! P' a
58. "[mcu contorls]\r\n"
    
59. " mcu rd <d>\t\t- Read FLASH information.\r\n"
    ! L5 Z* V0 ]6 \
60. "\r\n",
    
61. 
    
62. <i>//处理函数</i>
    4 f4 `6 ?9 C6 ~- @! O
63. &Shell_MCU_Service,
    
64. 
    5 I% T% V; E1 X7 o5 F
65. <i>//附带数据</i>
    
66. 0,
    
67.   #ifdef SHELL_USE_YMODEM  
    
68.     <i>//存储介质</i>
    
69.     NULL,
    % Q9 w! A4 ]% x1 J# g
70.   #endif
    0 z8 {. r) |# i" T" K: j
71. };
    " ]3 q1 e% j* l3 A# G  J
72. 
    0 J, H; w/ I1 f7 o: {7 g9 o
73. <i>/*---------------------*
    0 l) O# L: e" K$ b$ c
74. *     CLI链表节(输出)
    
75. *----------------------*/</i>
    
76. Cmd_List_t  McuList  = {&CLI_McuMsg      ,NULL}; <i>//IAP指令链表</i>
    
77. 
    
78. <i>/******************************************************************************
    
79. ********************************* 函 数 声 明 *********************************
    8 v7 e$ A( a0 P: }; W5 H
80. ******************************************************************************/</i>
    
81. <i>/******************************************************************************
    - R7 P; U- _8 }+ z. E/ ^9 Z% o, ]
82. / 函数功能:STM32F103控制函数
    & n- Q9 Y4 ^% @0 o- o7 T
83. / 修改日期:2015/7/14 20:22:02
    9 v* v- t! a8 X1 T+ c: K  q
84. / 输入参数:none
    
85. / 输出参数:none
    
86. / 使用说明:需要执行约10s
    ; R  c% _2 c% y2 p
87. ******************************************************************************/</i>
    
88. static bool FLASH_ioctl(uint8_t cmd,void * param)
    
89. {
    
90.     #define UID_ADDR            0x1FFFF7E0  //闪存容量寄存器,值对应KB单位
    
91.     #define MAC_ADDR            0x1FFFF7E8  //MCU的唯一ID号,共12个字节
    5 ^% M) f6 M4 a" m$ o) m0 y) i7 V0 P
92.     #define UID_SIZE            2           //UID的字节数
    
93.     #define MAC_SIZE            12          //MAC的字节数
    
94. 
    9 ^& s) P0 e4 J& Q
95.     <i>//step1: 检查参数</i>
    & c& H; p' E, C; X! L! d
96.     if(!param)return false;
    4 ^7 v' x. p1 S. {4 e; N7 J; C
97.         
    * s5 _& p  y1 k( f- m' `  B5 a/ E; x3 M
98.     <i>//step2: 处理数据</i>
      A- n2 R5 L4 [
99.     switch(cmd){
    9 v- |+ _% X1 {; N
100.       case 0 : {       <i>//获取FLASH的的UID</i>
     0 J- w" o  K) e: I
101.         uint16_t * ptDst = (uint16_t *)((uint32_t)param+1);
     
102.         
     
103.         *ptDst = *(uint16_t *)UID_ADDR;
     
104.         *(uint8_t  *)param =  UID_SIZE;
     
105.         return true;
     
106.       }
     
107.       case 1 : {       <i>//获取芯片的MAC地址</i>
     4 A7 f# {, U" M
108.         uint32_t * ptDst = (uint32_t *)((uint32_t)param+1);
     
109.         uint32_t * ptSrc = (uint32_t *)MAC_ADDR;
     & y3 w; A; G, B( T8 x0 ]
110.    
     5 U- S/ ~. f3 r7 Y# E5 }, |
111.         *ptDst++ = *ptSrc++;
     
112.         *ptDst++ = *ptSrc++;
     
113.         *ptDst++ = *ptSrc++;
     
114.         *(uint8_t  *)param = MAC_SIZE;
     
115.         return true;
     
116.       }
     0 h% z6 J( n6 s' p
117.       default:return false;
     + H$ g# k! j; C0 x
118.     }
     
119. }
     * m8 Y  ^; s3 J
120. 
     9 b5 X1 Y! ?) |7 S' t# S) A
121. <i>/******************************************************************************
     + U8 e1 y& Y# |
122. / 函数功能:文件系统Shel指令处理
     
123. / 修改日期:2013/9/10 19:04:15
     1 ?2 K$ F& y9 }
124. / 输入参数:输入当前的程序版本
     9 g& l7 V/ R; N! |( X
125. / 输出参数:none
     $ _8 |( N) z2 h3 e8 ]
126. / 使用说明:none
     : ^( m7 v: y( p! |% ^" f2 F
127. ******************************************************************************/</i>
     
128. bool Shell_MCU_Service(void * pcBuff, uint16_t len )
     4 j1 }3 E5 |" X
129. {
     6 ^8 |" M( B7 z1 _/ h4 u1 p
130.     uint8_t    *ptRxd;          <i>//用于接收指令处理</i>
     ) {& B- n$ I2 g& [4 w
131.     int         i;
     2 d% J: U9 G% z4 a# i  b7 M2 s
132.     uint16_t    retval;
     
133.     uint8_t     buff[32];
     
134.    
     1 M. p4 f; j( p( {: Z" x
135.     <i>//处理指令</i>
     
136.     <i>//--------------------------------------------------------------------------</i>
     
137.     ptRxd = (uint8_t *)pcBuff;
     3 [/ f0 K$ L2 t! M* I* K
138.    
     
139.     if(StrComp(ptRxd,"rd ")) <i>//读取FLASH信息</i>
     + n* \8 d! E! X3 r5 H7 ?  ^3 |
140.     {
     ; ~2 A, C, h2 I9 M
141.         int wval;
     
142.         
     
143.         if(1 != sscanf((void *)ptRxd,"%*s%d",&wval) )return false;
     7 e  ~; X2 z  e% U' g( c
144.         if( wval>2 )return false;
     ; N0 H) u6 ^, v! k
145.         if(0==wval) {
     
146.             FLASH_ioctl(0,buff);
     
147.             retval = *(uint16_t *)(buff+1) ;
     1 b8 S- E" a* z. n6 x
148.             printf("->Flash:\t%dKB\r\n",retval);
     4 k+ g2 W7 ~+ G0 A: x3 d
149.             return true;
     
150.         }
     
151.         else if(1==wval) {
     
152.             FLASH_ioctl(1,buff);
     / K1 v) C. m: Z& j2 G# s5 d' Y
153.             printf("->MAC:\t ");
       e; n. f$ J6 L7 E; x: y
154.             for(i=0; i<buff[0]-1; i++){printf("%02X-",buff[i+1]);}
     
155.             printf("%02X\r\n",buff[i+1]);
     6 n+ v) Y$ C1 f* M) B% K! ^
156.             return true;
     # ?5 P( c6 S( }+ V+ G' r# U, X
157.         }
     
158.         else return false;
     7 I/ j  h; y# T0 C+ `8 t9 H
159.     }
     ; [: h$ j/ i; S" W
160.     else if(StrComp(ptRxd,"help\r\n"))      <i>//指令帮助</i>
     
161.     {
     
162.         shell_SendStr((void *)CLI_McuMsg.pcHelpStr);
     % e& h1 S) P; h6 n; i: j2 W
163.         return true;
     
164.     }
     
165.     else return false;
     
166. }
     
167. 
     
168. <i>/******************************************************************************
     
169. ***********************************   END  ************************************
     1 F( r. |  p7 ?1 k
170. ******************************************************************************/</i>
     . N) S% S4 q1 x& y3 K
171. #endif

复制代码

5.2 实现步骤

1） 将该文件添加到工程下。

2） 在main.c中用extern 引用McuList，源代码为：

1. <i>/*---------------------*
   
2. *     Shell指令链表
   4 [' q, `2 E9 \" x1 Z& y
3. *----------------------*/</i>
   / Q" R: K/ n/ A# k7 C3 v+ ]! A/ m1 v
4. extern Cmd_List_t  McuList;

复制代码

3）在main.c初始化时添加：

1. <i>//----------------------------------------------------------</i>
   
2. <i>//step1: shell初始化</i>
   
3. shell_Init(115200,ledx_cfg);        <i>//初始化shell接口</i>
   0 ~1 G% Q* F8 x( k1 i
4. CLI_AddCmd(&McuList);     <i>//添加模块指令到链表</i>

复制代码

" ^9 }0 _3 W. ~0 y# _# L( X

4）编译工程文件。

5）下载到开发板运行即可在终端下看到新支持的CLI指令：

7 B* a1 l1 r" p) r