1. 前言

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

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

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

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

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

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

• 支持Ymodem文件传输协议

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

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

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

  
  3 r8 F" @2 V9 ~! d( J3 [) N4 n8 s: Y
  $ M' ]! K2 j% Y

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

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>/*---------------------*
   * o: W+ }1 R: I" N$ F8 V
2. *     指正函数定义
   
3. *----------------------*/</i>
   , |8 \/ z+ h6 `  d1 \  @( \" T
4. typedef void    (*pvFunDummy)(void);
   
5. 
   . I) Z+ X( f( l  L1 ^8 [( a( P
6. <i>//输入整行,输出逻辑</i>
   & W- s- Z$ \* h8 I" q; {
7. typedef void    (*pvFunVoid) (void);
   
8. typedef void    (*pvFunBool) (bool     bVal);
   ) D% T; u, p+ I3 w. x$ m
9. typedef void    (*pvFunChar) (uint8_t  cVal);
   
10. typedef void    (*pvFunShort)(uint16_t sVal);
    & `/ R3 W0 t7 I7 V- j9 j
11. typedef void    (*pvFunWord) (uint32_t wVal);
    9 ^9 m8 }) e, I4 p5 H+ J
12. 
    
13. <i>//输入整行,输出逻辑</i>
    + h# q9 C7 Z6 y1 f( g
14. typedef bool    (*pbFunVoid) (void);
    * N* g+ R  }3 {2 j# l- Z
15. typedef bool    (*pbFunBool) (bool     bVal);
    & E4 z! ~' z6 f
16. typedef bool    (*pbFunChar) (uint8_t  cVal);
    
17. typedef bool    (*pbFunShort)(uint16_t sVal);
    & p3 n, H( e. i% x$ n9 X0 X' J
18. typedef bool    (*pbFunWord) (uint32_t wVal);
    
19. 
    
20. <i>//输入整形指针,输出逻辑</i>
    
21. typedef bool    (*pbFun_pVoid) (void * pVoid);
    - f* F  Y& M; {9 v5 T
22. typedef bool    (*pbFun_pChar) (uint8_t  * pStr);
    
23. typedef bool    (*pbFun_pShort)(uint16_t * pShor);
    3 C6 o5 [4 d5 c2 A, S
24. typedef bool    (*pbFun_pWord) (uint32_t * pWord);
    5 g) b. u! W& x6 E% D3 F
25. 
    , D$ p9 y- D5 Y* U, q* @
26. <i>//输入数据帧,输出逻辑</i>
    
27. typedef bool    (*pbFun_Buffx)(void * pcBuff, uint16_t len );
    
28. typedef bool    (*pbFun_Bytex)(uint8_t * pcByte, uint16_t len );
    
29. <i>/*---------------------*
    
30. *    TTYx 句柄结构
    : l2 ~2 C- \% Q2 F( F9 m0 G
31. *----------------------*/</i>
    
32. typedef struct TTYx_HANDLE_STRUCT
    " b& v" u1 |3 i7 i% s1 E: b' R1 _
33. {
    
34.     const char  * const name;       <i>//驱动器名</i>
    
35.     const uint16_t      rxSize;     <i>//接收大小</i>
    
36.     const uint16_t      txSize;     <i>//发送大小</i>
    
37.    
    ; u2 W* z- v2 \9 u
38.     <i>//------------------------------------------------------</i>
    ' w- e6 O( m9 r* b- N6 y  T
39.     <i>//step1: 用户可用API</i>
    8 G2 q$ p' o8 o  K* f) t
40.     const pvFunWord     init;           <i>//初始化.</i>
    
41.     const pbFun_Bytex   api_TxdFrame;   <i>//发送数据帧. (发送帧)</i>
    
42.     const pbFunChar     api_TxdByte;    <i>//发送数据字节</i>
    
43.    
    + g6 s6 A, U7 \4 E2 d) C
44.     <i>//------------------------------------------------------</i>
    : a* V/ C7 c0 `: s3 q
45.     <i>//step2: 注入回调函数</i>
    
46.     pbFun_Bytex         inj_RcvFrame;   <i>//(ISR)接收数据帧. (接收帧)</i>
    
47.     pvFunDummy          inj_TxdReady;   <i>//(ISR)发送完毕回调</i>
    ; V2 U! \) `, u6 `% v+ c
48.    
    
49.     <i>//------------------------------------------------------</i>
    
50.     <i>//step3: 接收回调函数</i>
    
51.     struct TTYx_HANDLE_STRUCT * pvNext; <i>//连接到下一个指令 </i>
    
52. }TTYx_HANDLE;

复制代码

可注入的命令脚本（CLI）实现

• 命令CLI也是一个结构体对象：
  0 X0 ~% d/ p3 T" u- t( g' b

4 _5 o- k( _2 V/ _5 I  F, ~6 R* d

1. <i>/*---------------------*
   
2. *       CLI指令
   / c! E- X) s. B: r  Z
3. *----------------------*/</i>
   
4. typedef struct
   4 s9 H* ?# X' R+ [
5. {
   ' A& V# e- h: E* i: o; h
6. const char * const  pcCmdStr;     <i>//指令字符串(只能为小写字母)</i>
   - {* z6 W* C" @; X9 F
7. const char * const  pcHelpStr;     <i>//指令描述,必须以:"\r\n结束". 比如:"help: Returns a list\r\n".</i>
   
8. const pFunHook      pxCmdHook;     <i>//指向回调函数的指针,处理成功返回真否者返回0;</i>
   ! s" i5 ~8 k  v* h" \% P6 ]
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=
   - g  i* S" ?; e, i+ x1 Y" r  X4 ?) E
2. {
   
3.     <i>//识别关键字</i>
   & n$ X/ `# [3 N/ P# }+ J$ f
4.     .pcCmdStr   = "wiz",
   & d. ^& n1 P9 h8 `" X/ A
5.     <i>//帮助内容</i>
   
6.     .pcHelpStr  =
     h# R/ y' p7 s) U
7.     "[WIZ contorls]\r\n"
   8 [) m) I3 t* O. F: @+ U: c- h( P  a
8. " wiz help\r\n"
   . r* @* ], @" _5 x; b
9. " wiz rd info\r\n"
   , S1 K4 e- n& P& G, b. i
10. " wiz reset\r\n"
    
11. " wiz wr ip <D0>.<D1>.<D2>.<D3>\r\n"
    
12. " wiz wr mask <D0>.<D1>.<D2>.<D3>\r\n"
    - C4 X6 o! ^+ Q6 @8 P! p$ n
13. " wiz wr way <D0>.<D1>.<D2>.<D3>\r\n"
    
14. " wiz wr mac <H0>-<H1>-<H2>-<H3>-<H4>-<H5>\r\n"
    % e& F* V! \% i" L7 B
15. " wiz wr port <udp> <bak> <vol> <pic>\r\n"
    
16. " wiz wr sip <D0>.<D1>.<D2>.<D3> <port>\r\n"
    ' M! V) |# r3 r1 |3 k1 V
17. " wiz wr cip <D0>.<D1>.<D2>.<D3> <port>\r\n"
    # K8 w. P; e3 e5 T+ F3 d1 E, U, f1 E
18. " wiz load default\r\n"
    
19. "[WIZ Test mode]\r\n"
    . K  s0 F) r, h  x/ N/ H; ^3 D
20. " wiz loop open\r\n"
    
21. " wiz loop close\r\n"
    0 O: K0 m0 y" E' {
22. "\r\n",
    9 e9 j3 I% Q4 m. {& T$ g
23. 
    ( }2 N- p' d/ \9 G$ X% c# Q) {
24. <i>//处理函数</i>
      ]( P" z( {6 t0 I2 F" ^- P5 ^
25. .pxCmdHook  = &Shell_WIZ_Service,        <i>//见实体函数</i>
    + a9 `; X8 A3 `: L7 Z
26. 
    4 d9 A9 _6 ?. q3 o
27. <i>//附带数据</i>
    ! g( ]! v% K  ^
28. .ucExpParam = 0,
    
29. 
    1 Y8 ]/ T5 ]" E' B: [6 N
30.   #ifdef SHELL_USE_YMODEM  
    
31.     <i>//存储介质</i>
    ' M0 X8 g9 p& Q$ S+ n! g
32.     .phStorage  = NULL,
    / G/ ~# Q" J4 e
33.   #endif
    " g) {: K* j' N# Q2 O
34. };
    
35. <i>/*---------------------*
    1 ?# X( Y( B( H" D+ C
36. *       CLI 链表节
    ' t& O* @, e6 V1 @& Y
37. *----------------------*/</i>
    
38. Cmd_List_t  WizList   = { &CLI_WizMsg,   NULL,}; <i>//Shell指令的头</i>

复制代码

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

3. 环境准备
' Y% y0 F/ s1 n5 |$ ?$ a3.1 硬件开发环境

• STM32F103系列开发板一块， 带USART1接口。
• USB转串口线一根。
  
  

3.2 软件开发环境

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

3.3 软件配置

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

4. 代码介绍
* B/ C  [+ s7 _! P; F5 A4.1 目录结构□ XC_SHELL
( `% W: Q7 y; C% t7 U

1. ├──┬── BSP_LIB    BSP库，硬件相关驱动代买
   
2. │  ├──── bsp_ledx.c   基础LED驱动      
   2 E$ x( U/ J" E* F
3. │  └──── bsp_tty0.c   调试串口驱动
     T/ B: P0 n1 B( o2 o
4. │
   
5. ├──┬──MDK-ARM     工程文件
   
6. │  └──── Project.uvproj
   
7. │
   + P1 |4 U. K7 ^. ?4 S4 l
8. ├──┬──SHELL_CFG   SHELL配置头文件
   
9. │  └──── user_eval.h
   $ ~3 ^  N7 B8 p* \9 Y$ ^
10. │
    ' n/ v# N2 Q2 O. ?7 o
11. ├──┬──SHELL_CORE  SHELL内核文件
    
12. │  ├──── xc_shell.c   SHELL内核文件
    ( g! |0 j. ]; H4 V+ B. v
13. │  ├──── xc_ymodem.c  Ymodem传输协议（默认关闭，在xc_shell.h中启动）
    . a8 l2 J) b. |" E8 C
14. │  ├──── xc_iap.c     Flash的IAP操作，需要bsp_flash.c驱动支持
    
15. │  └──── shell_iap.c  shell的用户脚本模板
    # b1 K: O" r$ @' D( Z0 ?: Y
16. │
    2 @% l; @: E2 g6 p* c6 @
17. ├──┬──SHELL_INC   SHELL头文件
    
18. │  ├──── bsp_type.h   驱动结构定义
    2 w4 U# L( g1 U0 p- p
19. │  ├──── xc_shell.h   SHELL头文件
    
20. │  └──── xconfig.h    硬件无关配置文件
    
21. │
    
22. ├──┬──STM32F10x_StdPeriph_Lib_V3.5.0  STM32的标准外设库
    + y' t: d. W3 I( M6 x6 _; C
23. │  └──── ......
    4 H( C& C4 o8 `, X
24. │
    
25. └──┬──USER        用户文件   
      D" m# p1 V  ?) x
26.    ├─ .....      
    8 I1 y" o' M; K2 n' D
27.    └──── main.c        main文件

复制代码

4.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)*********************************
   . @7 d+ n8 O4 g# d! ?
2. **                              
   
3. **                                 FIVE工作组
   : L- \! D5 e* a, X5 o: D7 C
4. **
   ) @* g+ R9 \3 G! j6 P; X* j
5. **---------------------------------File Info------------------------------------
   
6. ** File Name:               shell_mcu.c
   
7. ** Last modified Date:      2017/9/17 15:13:57
   
8. ** Last Version:            V1.0
   & V# }& o! U: U5 s& A7 J6 i
9. ** Description:             shell测试
   
10. **
    2 Y  c! \" I  e4 o& y/ `; f& q; l
11. **------------------------------------------------------------------------------
    
12. ** Created By:              wanxuncpx
    $ H( U' `3 n  G& I" Z
13. ** Created date:            2017/9/17 15:14:08
    ; H# O. ]" |; F; y% w
14. ** Version:                 V1.0
    2 i# ^7 q1 R/ T& p. r
15. ** Descriptions:            none
    " E8 x8 L0 w) D
16. **------------------------------------------------------------------------------
    
17. ** HW_CMU:                  STM32F103
    1 |8 U/ @) m3 g  J& L- @
18. ** Libraries:               STM32F10x_StdPeriph_Lib_V3.5.0
    6 b0 a8 n! ]: v# w: D- B1 p( H
19. ** version                  V3.5
    / k7 Z' V. z) m: e0 R) M! o
20. *******************************************************************************/</i>
    
21. 
    
22. <i>/******************************************************************************
    - D6 \! _+ l! D4 N  w! n
23. 更新说明:
    % E( K( `1 i: {0 @* _
24. ******************************************************************************/</i>
    
25. 
    # y* \. D7 Y5 S3 }' h- U5 O9 t. Y! p
26. <i>/******************************************************************************
    
27. *********************************  编 译 控 制 ********************************
    
28. ******************************************************************************/</i>
    : c  F9 B1 Q3 H! k/ s- |! h1 p
29. #define MCU_SHELL               //注释掉时屏蔽iap shell功能
    
30. 
    
31. #include "xc_shell.h"       //Shell支持文件,含bool,uint8_t..以及串口数据收发操作
      x0 H+ y. e  H5 W
32. <i>/******************************************************************************
    
33. ********************************* 文件引用部分 ********************************
    9 c5 Y" h3 R% N$ U# I
34. ******************************************************************************/</i>
    
35. <i>/*---------------------*
    # Z; C4 C4 b$ c  Q) T& [) ^& n
36. *     模块驱动引用
    ( M! M; L+ s" f! C! S; z
37. *----------------------*/</i>
    
38. <i>//#include "net_w5500.h"</i>
    
39. 
    8 H$ F1 ~, y9 K: b2 |
40. #ifdef MCU_SHELL
    
41. <i>/******************************************************************************
    
42. ********************************** Shell实例 **********************************
    3 K& P3 K  l, ?: D. h  w" A9 R" ~) a
43. ******************************************************************************/</i>
    
44. <i>/*---------------------*
    ; S$ }( J* r! N9 l
45. *      CLI指令服务
    
46. *----------------------*/</i>
    4 K" k) c- O4 J! g6 _8 L- i
47. extern bool Shell_MCU_Service(void * pcBuff, uint16_t len );
    
48. 
    
49. <i>/*---------------------*
    : x" {& W1 ~* e" x" x+ i, l
50. *       CLI 结构
    
51. *----------------------*/</i>
    + {7 t" u# x8 g7 V# S2 s) j
52. const Cmd_Typedef_t CLI_McuMsg=
    $ C6 K0 S9 P! N" q7 i& r
53. {
    ; F1 x5 u. D. A1 g9 n$ m
54.     <i>//识别关键字</i>
    
55.     "mcu",
    
56.    
    
57.     <i>//帮助内容</i>
    
58. "[mcu contorls]\r\n"
    ! L/ S$ a% U+ S( N
59. " mcu rd <d>\t\t- Read FLASH information.\r\n"
    / S( h& J5 k: F4 X5 i/ @
60. "\r\n",
    
61. 
    0 H% \4 m4 F3 l/ ^
62. <i>//处理函数</i>
    
63. &Shell_MCU_Service,
    
64. 
    
65. <i>//附带数据</i>
    4 `, x$ x5 {$ \( p( B
66. 0,
    * G$ f) w/ o; a
67.   #ifdef SHELL_USE_YMODEM  
    9 p- |* ]- M; {3 ~  }
68.     <i>//存储介质</i>
    
69.     NULL,
    ( j$ |- A1 x, J6 G! W  B6 X
70.   #endif
    
71. };
    
72. 
    ; J+ O# x5 {  _5 m9 t/ E+ y7 ]
73. <i>/*---------------------*
    . r& P! H' [6 }6 d7 x
74. *     CLI链表节(输出)
    
75. *----------------------*/</i>
    8 @9 H3 z# O9 \; `3 \  Q0 d) v4 Y
76. Cmd_List_t  McuList  = {&CLI_McuMsg      ,NULL}; <i>//IAP指令链表</i>
    
77. 
    
78. <i>/******************************************************************************
    ; h- c6 C) \9 H9 y- b% K$ N
79. ********************************* 函 数 声 明 *********************************
    ! H8 O1 Y+ w& L  a9 y9 k" \
80. ******************************************************************************/</i>
    ) y( g# C) u# U  A, I5 f# N9 c' S$ T
81. <i>/******************************************************************************
    ( ~& v4 O/ G: d; c0 \
82. / 函数功能:STM32F103控制函数
    + u' K1 _& ]9 _* c/ L! D
83. / 修改日期:2015/7/14 20:22:02
    9 G1 p6 A# d- ?& o& v
84. / 输入参数:none
    
85. / 输出参数:none
    
86. / 使用说明:需要执行约10s
    
87. ******************************************************************************/</i>
    
88. static bool FLASH_ioctl(uint8_t cmd,void * param)
    ; j8 t2 k) A# {+ D& O, _& {
89. {
    & q" V0 R. E0 F0 T2 [  E
90.     #define UID_ADDR            0x1FFFF7E0  //闪存容量寄存器,值对应KB单位
    6 ]0 \* l) ?5 y! [9 i- ?
91.     #define MAC_ADDR            0x1FFFF7E8  //MCU的唯一ID号,共12个字节
    
92.     #define UID_SIZE            2           //UID的字节数
    
93.     #define MAC_SIZE            12          //MAC的字节数
    
94. 
    & l: s/ p6 D* J7 @# ^6 ~
95.     <i>//step1: 检查参数</i>
    
96.     if(!param)return false;
    - a5 f. b" v$ W8 d: U, u
97.         
    + e2 g  Q. j5 N8 b4 j2 q6 X
98.     <i>//step2: 处理数据</i>
    ! H- n3 {* p5 S
99.     switch(cmd){
    6 @$ J4 G) K( [0 _. Z) k6 _% K% R
100.       case 0 : {       <i>//获取FLASH的的UID</i>
     1 h- K  |$ c0 _
101.         uint16_t * ptDst = (uint16_t *)((uint32_t)param+1);
     1 t; O8 M* A2 t& @! j. U3 @/ S
102.         
     8 U  G- g) c; t' A8 F) d7 `7 M1 u* H
103.         *ptDst = *(uint16_t *)UID_ADDR;
     6 b2 i; ?" z1 \
104.         *(uint8_t  *)param =  UID_SIZE;
     ! q% m, |* O' I' e' G$ P1 c: o
105.         return true;
     8 O7 D% B) h8 [! j5 s
106.       }
     * q# G, x) j4 h: Z  v$ T; \
107.       case 1 : {       <i>//获取芯片的MAC地址</i>
       ?" n7 M4 ~8 V" `# }
108.         uint32_t * ptDst = (uint32_t *)((uint32_t)param+1);
     
109.         uint32_t * ptSrc = (uint32_t *)MAC_ADDR;
     : F- a' f3 `( R4 p6 J- `5 B
110.    
     
111.         *ptDst++ = *ptSrc++;
     
112.         *ptDst++ = *ptSrc++;
     
113.         *ptDst++ = *ptSrc++;
     4 u( E* o+ P/ l5 ~  k/ I
114.         *(uint8_t  *)param = MAC_SIZE;
     ! ^( h, e. Y) ]
115.         return true;
     
116.       }
     
117.       default:return false;
     ' w6 o1 O( _9 m  d
118.     }
     
119. }
     
120. 
     
121. <i>/******************************************************************************
     
122. / 函数功能:文件系统Shel指令处理
     
123. / 修改日期:2013/9/10 19:04:15
     
124. / 输入参数:输入当前的程序版本
     + P2 Q0 f% L8 d+ j" e
125. / 输出参数:none
     
126. / 使用说明:none
     3 t$ F8 u1 p- h1 g
127. ******************************************************************************/</i>
     6 k( Y# w( o% B2 L0 n5 K
128. bool Shell_MCU_Service(void * pcBuff, uint16_t len )
     6 l$ l3 y( z6 {1 j
129. {
     
130.     uint8_t    *ptRxd;          <i>//用于接收指令处理</i>
     ! w  K: m# d( W' B( c+ M
131.     int         i;
     
132.     uint16_t    retval;
     ; u; a5 _( f8 K& \9 Y% R* r( ]
133.     uint8_t     buff[32];
     
134.    
     . U7 ]3 O9 u% g9 C8 w" @
135.     <i>//处理指令</i>
     
136.     <i>//--------------------------------------------------------------------------</i>
     
137.     ptRxd = (uint8_t *)pcBuff;
     
138.    
     
139.     if(StrComp(ptRxd,"rd ")) <i>//读取FLASH信息</i>
     
140.     {
     
141.         int wval;
     $ S6 E) [# i6 L" \- T
142.         
     : O8 r" p0 T$ k7 y+ f7 g
143.         if(1 != sscanf((void *)ptRxd,"%*s%d",&wval) )return false;
     $ z8 t" Y+ G' f$ t
144.         if( wval>2 )return false;
     6 Q( D. p1 r0 I, f3 r' l2 j- T
145.         if(0==wval) {
     % H0 f4 Q. a6 k! g; y
146.             FLASH_ioctl(0,buff);
     , K/ v% A" d+ @7 ], K
147.             retval = *(uint16_t *)(buff+1) ;
     
148.             printf("->Flash:\t%dKB\r\n",retval);
     1 S$ I' H) ]3 o1 q- u' Z3 O
149.             return true;
     4 C8 M9 T( F# i  a- ]" r2 o5 ?
150.         }
     
151.         else if(1==wval) {
     
152.             FLASH_ioctl(1,buff);
     
153.             printf("->MAC:\t ");
     
154.             for(i=0; i<buff[0]-1; i++){printf("%02X-",buff[i+1]);}
     6 _/ v8 y' J7 Y
155.             printf("%02X\r\n",buff[i+1]);
     3 M6 o; H3 i5 S3 `- A  [: E
156.             return true;
     - y) n7 Y; K/ |
157.         }
     ( t5 U! U. Q9 j' E: N5 ]
158.         else return false;
     $ b9 n( ^; T) k% K# L) _: d
159.     }
     
160.     else if(StrComp(ptRxd,"help\r\n"))      <i>//指令帮助</i>
     
161.     {
     
162.         shell_SendStr((void *)CLI_McuMsg.pcHelpStr);
     " C. h' k4 g" E7 L
163.         return true;
     
164.     }
     7 x9 u5 U, B8 B' v1 h
165.     else return false;
     2 Z* u; c$ j6 Y7 x: L' v0 @
166. }
     1 s/ @) l2 U. Y& K) ^+ ?, k
167. 
     
168. <i>/******************************************************************************
     ) T7 T; f+ n! Y4 A+ x$ @# D% r0 ^; R% m
169. ***********************************   END  ************************************
     
170. ******************************************************************************/</i>
     0 W9 Y) d7 \# D( X/ m. H" c' _# s/ E
171. #endif

复制代码

5.2 实现步骤

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

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

1. <i>/*---------------------*
   1 N  n. b1 Z' @  d
2. *     Shell指令链表
   
3. *----------------------*/</i>
   ; k# y8 q  z% F4 }' W. |* m5 F' F
4. extern Cmd_List_t  McuList;

复制代码

4 X; I( |& W3 K" A5 K1 b" C

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

1. <i>//----------------------------------------------------------</i>
   
2. <i>//step1: shell初始化</i>
   5 z% N' f* _, Y3 ]. D) |
3. shell_Init(115200,ledx_cfg);        <i>//初始化shell接口</i>
   6 ]/ I8 m' p" T+ Z8 Q
4. CLI_AddCmd(&McuList);     <i>//添加模块指令到链表</i>

复制代码

4）编译工程文件。

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

! |% i, V: }6 k3 Z& F+ n
+ d3 H+ h" r- b/ L