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

【经验分享】实用STM32的串口控制平台的实现!

[复制链接]
STMCU小助手 发布时间:2022-1-5 21:00
1. 前言

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

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

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

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

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

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

  • 支持Ymodem文件传输协议

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

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

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

    2 }8 s; g3 b6 x, a) T% W+ Q) K8 u

    3 T; U7 t! k' u+ k7 J5 H

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


# L/ [5 s2 E, p, l& L  e

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>/*---------------------* 4 t2 I( H# o* g, p+ ~
  2. *     指正函数定义
    1 o& _, J- `9 v
  3. *----------------------*/</i>
    4 Z0 ?* p* N7 n9 m3 u( T! z* N* u
  4. typedef void    (*pvFunDummy)(void);) _4 D$ v0 q7 n1 f- H
  5. 8 M& k+ F6 ]3 e8 {1 P
  6. <i>//输入整行,输出逻辑</i>
    3 I4 w4 h2 G5 x
  7. typedef void    (*pvFunVoid) (void);
    - d$ M! \& B, I# ?/ J
  8. typedef void    (*pvFunBool) (bool     bVal);
    ( _+ m  m% u/ O: c; Y$ Z
  9. typedef void    (*pvFunChar) (uint8_t  cVal);
    ! Z; F( K4 X, b8 m8 q" c( x( L4 d
  10. typedef void    (*pvFunShort)(uint16_t sVal);/ I1 {+ b+ V, B+ Q- i
  11. typedef void    (*pvFunWord) (uint32_t wVal);9 i0 G; d* T8 i# ~# E! G
  12. 8 F. @. D% f  h9 Y3 `
  13. <i>//输入整行,输出逻辑</i>
    1 \) x. u- ]( i" X( I* ]) J: M5 `
  14. typedef bool    (*pbFunVoid) (void);
    : g! h+ v0 k2 p; y
  15. typedef bool    (*pbFunBool) (bool     bVal);1 B& m* m% G' S  P
  16. typedef bool    (*pbFunChar) (uint8_t  cVal);' P! V$ C6 i; Y
  17. typedef bool    (*pbFunShort)(uint16_t sVal);3 s' `1 v4 _. m% w0 b
  18. typedef bool    (*pbFunWord) (uint32_t wVal);
    , v* \% h5 n$ \. J0 T% m3 I
  19. 4 O5 D, x& I$ z4 t$ F) b
  20. <i>//输入整形指针,输出逻辑</i>5 l0 }" [- O1 h' m; z+ D6 r
  21. typedef bool    (*pbFun_pVoid) (void * pVoid);$ I& h" M2 K4 R4 ]/ D0 T
  22. typedef bool    (*pbFun_pChar) (uint8_t  * pStr);8 t# K6 t! y$ D7 E1 l! X5 p
  23. typedef bool    (*pbFun_pShort)(uint16_t * pShor);
    / a- Y& I& q0 k6 g
  24. typedef bool    (*pbFun_pWord) (uint32_t * pWord);9 \2 A* d3 [! z# h

  25. 8 J2 V7 E$ v  ]5 U  ]
  26. <i>//输入数据帧,输出逻辑</i>
    + K/ h* D: @, W( Q, m" v9 c1 f$ }+ g
  27. typedef bool    (*pbFun_Buffx)(void * pcBuff, uint16_t len );$ V' \9 y0 }5 ?8 [$ N- H
  28. typedef bool    (*pbFun_Bytex)(uint8_t * pcByte, uint16_t len );
    ) x- g+ F; q% ?4 T
  29. <i>/*---------------------*
      b7 w) c, @) w8 |  s; E4 w+ i
  30. *    TTYx 句柄结构
    " x$ c+ A: E" v. F" V, S7 X
  31. *----------------------*/</i>. m8 Y: j$ f7 _0 e
  32. typedef struct TTYx_HANDLE_STRUCT
    - b: {& ~8 \5 v) S" J- b0 @7 ^
  33. {4 s5 @2 c$ a$ }' @+ f, _  t
  34.     const char  * const name;       <i>//驱动器名</i>
    0 `- T2 a1 t. w% ]+ l) b0 D
  35.     const uint16_t      rxSize;     <i>//接收大小</i>
    ) ]! t% q! O" \% Y, A& n
  36.     const uint16_t      txSize;     <i>//发送大小</i>
    $ C- k5 U4 N2 v% d' f0 z( o
  37.    
    8 Y$ p: R7 L8 V% K, Y9 T; y$ P1 Q" ?
  38.     <i>//------------------------------------------------------</i>
    , v. O+ ^9 m. t! ]  B3 B
  39.     <i>//step1: 用户可用API</i>
    , |# W6 u, h' T+ A! r) M0 d$ F' _5 D" ?/ E
  40.     const pvFunWord     init;           <i>//初始化.</i>
    " c* d6 S( \! g( M# r
  41.     const pbFun_Bytex   api_TxdFrame;   <i>//发送数据帧. (发送帧)</i>
    0 o# X0 e# I9 `
  42.     const pbFunChar     api_TxdByte;    <i>//发送数据字节</i>
    ! g1 Z* W/ ^* B
  43.     ; w0 y  U! s' K; z7 \+ K( s
  44.     <i>//------------------------------------------------------</i>
    ; j$ L2 M9 G/ e0 o3 t
  45.     <i>//step2: 注入回调函数</i>
    ; c7 v8 y% u$ Y% F! l
  46.     pbFun_Bytex         inj_RcvFrame;   <i>//(ISR)接收数据帧. (接收帧)</i>
    1 \% S& p! [  F/ o: Y
  47.     pvFunDummy          inj_TxdReady;   <i>//(ISR)发送完毕回调</i>
    ) g( h! y5 h+ ]$ r! H4 W7 W5 U# E
  48.    
    7 H4 u& w2 p8 Q( d" Y0 u- g
  49.     <i>//------------------------------------------------------</i>, B& G' W6 N3 n
  50.     <i>//step3: 接收回调函数</i># Y9 c0 t/ N( q% l& Z3 Y
  51.     struct TTYx_HANDLE_STRUCT * pvNext; <i>//连接到下一个指令 </i>( D& ?5 s' r0 Q0 q0 {
  52. }TTYx_HANDLE;
复制代码
可注入的命令脚本(CLI)实现
. W: ?. v( j' H! r6 a2 h, C
  • 命令CLI也是一个结构体对象:
    9 y) O- h9 O% m+ o0 @( s; q3 r

  I$ Q+ j+ ^5 v. r# n: P

. ]3 Y& W" J) E. C( }) |8 t

: w$ G- h7 {4 O+ U2 w3 P4 O
  1. <i>/*---------------------*
    2 T! a/ ^1 _) P
  2. *       CLI指令1 e3 e1 a8 o4 A
  3. *----------------------*/</i>
    . |7 C" i; R9 M0 e. k) D
  4. typedef struct
    6 m) ^2 f( }7 U% M
  5. {: C) \6 X9 N/ G0 U
  6. const char * const  pcCmdStr;     <i>//指令字符串(只能为小写字母)</i>
    " y2 D4 f0 t* J6 K
  7. const char * const  pcHelpStr;     <i>//指令描述,必须以:"\r\n结束". 比如:"help: Returns a list\r\n".</i>" s% W) P. i8 F, Y
  8. const pFunHook      pxCmdHook;     <i>//指向回调函数的指针,处理成功返回真否者返回0;</i>  v2 a3 }! R4 D5 B( r
  9. uint8_t             ucExpParam;     <i>//指令期望的参数个数</i>' [. O' T8 r1 Q. d7 A
  10. const MEDIA_HANDLE *phStorage;      <i>//指向存储介质,没有的话填充NULL  </i>
    , b; V4 k5 O& ?
  11. }Cmd_Typedef_t;
复制代码
) g  C' \+ u/ {1 G6 p3 V

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

  1. const Cmd_Typedef_t CLI_WizMsg=
      N0 r0 u1 R; v5 }" a  }! X# q
  2. {
    $ n$ F7 r$ Q3 X
  3.     <i>//识别关键字</i>
    - k  W5 g" T7 o9 d5 Z! q& y) i
  4.     .pcCmdStr   = "wiz",5 K' m# t& h( ^% M
  5.     <i>//帮助内容</i>1 o4 W% `) z( q
  6.     .pcHelpStr  =6 s# t. V' M8 g: F+ U
  7.     "[WIZ contorls]\r\n": m: O0 o; R7 i$ B( Y
  8. " wiz help\r\n"5 [" `9 g& h5 y4 y2 p
  9. " wiz rd info\r\n"
    1 f: A+ _2 O6 c0 F( G$ @' Q
  10. " wiz reset\r\n"  }; R, o% ~' h! ]( K, H
  11. " wiz wr ip <D0>.<D1>.<D2>.<D3>\r\n"
    ! m8 p4 t$ \: a9 }$ O
  12. " wiz wr mask <D0>.<D1>.<D2>.<D3>\r\n"4 m- z3 e4 ?1 `+ N- W" ^& c8 ~
  13. " wiz wr way <D0>.<D1>.<D2>.<D3>\r\n"6 r6 Z' p8 V/ S- c$ K/ s
  14. " wiz wr mac <H0>-<H1>-<H2>-<H3>-<H4>-<H5>\r\n"$ p- j/ r1 t3 M
  15. " wiz wr port <udp> <bak> <vol> <pic>\r\n"4 {" ?2 w) u8 P% f  P
  16. " wiz wr sip <D0>.<D1>.<D2>.<D3> <port>\r\n", Z/ |$ Y7 r+ P/ V
  17. " wiz wr cip <D0>.<D1>.<D2>.<D3> <port>\r\n"
    ' T) k: ~9 b: I: c, N+ P4 K
  18. " wiz load default\r\n", _, t' N& r2 B. }' x
  19. "[WIZ Test mode]\r\n"
    5 O* O" D% k5 V$ ]2 ?
  20. " wiz loop open\r\n"
    . \* p% Q4 D( i& |9 Z1 C. O- X
  21. " wiz loop close\r\n"/ ~* t2 _! @5 t0 M
  22. "\r\n",$ u3 D" e7 C0 ]' M- y5 a

  23. 2 ]/ F/ H( c1 s; i0 k) }4 Z
  24. <i>//处理函数</i>
    ) n" t/ Q' ~( m' V, {* J: o
  25. .pxCmdHook  = &Shell_WIZ_Service,        <i>//见实体函数</i>2 |1 D6 p/ s+ z6 v
  26. ( O- T& S6 M4 l% E- k
  27. <i>//附带数据</i>
    # G% I8 o# n8 \+ q9 w
  28. .ucExpParam = 0,0 B; e+ A& m; Q/ ^
  29. 0 V' g- h+ S% \! z( k
  30.   #ifdef SHELL_USE_YMODEM  / r1 Q1 f7 |- b8 q  }9 \$ \
  31.     <i>//存储介质</i>6 c, t/ ?- f0 k( t. U. a
  32.     .phStorage  = NULL,3 K1 G3 X- G* j
  33.   #endif( I- w1 U! r# X9 y$ W, i
  34. };# F5 F3 A+ i4 m
  35. <i>/*---------------------* 9 ^0 v! t, h' j8 J" B3 @
  36. *       CLI 链表节* u' @3 I5 `+ i7 h3 d/ x
  37. *----------------------*/</i>
    7 g. r- d9 |& T) n* s4 m" d
  38. Cmd_List_t  WizList   = { &CLI_WizMsg,   NULL,}; <i>//Shell指令的头</i>
复制代码
, \# V3 W$ H) \" N4 X/ V

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

3. 环境准备9 {. A- l9 N' C4 d3 f
3.1 硬件开发环境
  • STM32F103系列开发板一块, 带USART1接口。
  • USB转串口线一根。. m% ]: r& |1 l2 R

    4 n5 [5 I1 S' D# S
3.2 软件开发环境
  • MDK4.72或以上
  • SecureCRT串口超级终端7 D( I+ n+ o+ N7 {9 h

    2 J5 V. Y: Z! _$ }# L- r
3.3 软件配置

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

4. 代码介绍
+ ^4 H1 w( A( F4.1 目录结构□ XC_SHELL1 a* N3 i( Y+ N) ^2 [7 [
  1. ├──┬── BSP_LIB    BSP库,硬件相关驱动代买+ N# W4 `3 B! l1 |
  2. │  ├──── bsp_ledx.c   基础LED驱动      
    , p  P  \# t9 I
  3. │  └──── bsp_tty0.c   调试串口驱动& _) z7 j" i2 m* D
  4. │% n6 c8 @- \. f( z# o
  5. ├──┬──MDK-ARM     工程文件# w% s  O: W& _! @! I3 r
  6. │  └──── Project.uvproj
    2 F5 u5 ?0 w1 r6 w
  7. │2 f/ |( n( R5 x; m9 m
  8. ├──┬──SHELL_CFG   SHELL配置头文件3 u& r9 z, p" V. P& w
  9. │  └──── user_eval.h
    2 v4 E. n! O% b9 ~+ }
  10. │
    9 X" Q5 U% k# J' |. x! T5 x
  11. ├──┬──SHELL_CORE  SHELL内核文件
    4 w9 v# L6 t' z2 B. j1 }' P
  12. │  ├──── xc_shell.c   SHELL内核文件
    8 L; ~9 y3 w1 Z$ Y% z% t8 A
  13. │  ├──── xc_ymodem.c  Ymodem传输协议(默认关闭,在xc_shell.h中启动)
    9 j7 `' g: G3 ^7 `
  14. │  ├──── xc_iap.c     Flash的IAP操作,需要bsp_flash.c驱动支持# e% v0 E2 ^; ?8 \! \# S& s
  15. │  └──── shell_iap.c  shell的用户脚本模板7 i: H  k4 O3 [: |. C1 h- e
  16. │2 W- J. t. s/ g+ }) ~
  17. ├──┬──SHELL_INC   SHELL头文件
    ! `; C  P. Q; I# h5 `6 h1 S
  18. │  ├──── bsp_type.h   驱动结构定义
    & K, [: P2 m. D( X5 W3 ?
  19. │  ├──── xc_shell.h   SHELL头文件3 z8 b6 A7 `; K9 V& H# p
  20. │  └──── xconfig.h    硬件无关配置文件! z+ o) T* F3 f/ }+ D- p
  21. │
    2 W- U/ m9 N- P' l  o
  22. ├──┬──STM32F10x_StdPeriph_Lib_V3.5.0  STM32的标准外设库! P, _* L& B- F1 E" y9 ?! ^
  23. │  └──── ......; G2 V$ L) e! [/ ]: q
  24. │
    * V; I$ u0 s  j$ Y( K9 E! A
  25. └──┬──USER        用户文件   
    6 X- ?# g! B. V- j1 t4 y1 s
  26.    ├─ .....       5 O/ I5 Y  \7 y7 h1 E
  27.    └──── main.c        main文件
复制代码

  o9 L* {& ?- P; H6 F& Q& |" g& _" x4.2 工程设置要点

1) 设置使用微库:

J{@]PI_A)431TG@)75W{_CX.png

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

Z2X3(U{9WKNBTW`PJ@9{P3K.png

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

4.3 最终效果

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

}S7`(NS`D2R$]Q]@3I_{O9U.png
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)*********************************
    3 K# \  z, s: q# b/ @! q) h
  2. **                               8 ?" d1 a' M& y9 j: C7 e2 K( v
  3. **                                 FIVE工作组
      ?# R: z8 a4 c5 g5 l
  4. **
    1 ~5 u4 E: i# o
  5. **---------------------------------File Info------------------------------------- K% U1 c3 @- o3 j# q; T
  6. ** File Name:               shell_mcu.c# g1 Y5 ?: p- Y& q! ]% U
  7. ** Last modified Date:      2017/9/17 15:13:57  a! Q1 D% G; @
  8. ** Last Version:            V1.0  z+ m$ S9 }+ X& u. e
  9. ** Description:             shell测试
    3 o: y, \; i0 X8 L
  10. **! z3 t6 \, G$ `% C
  11. **------------------------------------------------------------------------------
    : x& R" i! X, X! @/ G
  12. ** Created By:              wanxuncpx
    + t" u: X, h0 K" r9 M. R
  13. ** Created date:            2017/9/17 15:14:08  Q5 `' V/ J- r. O# q7 B
  14. ** Version:                 V1.09 q3 Y! {# p# g% G' c. Y4 ?" ^
  15. ** Descriptions:            none2 U$ t- B. P# M2 d& @
  16. **------------------------------------------------------------------------------6 X- x$ o" Q, b6 [0 w% O, x
  17. ** HW_CMU:                  STM32F103! e3 T+ d- R3 N
  18. ** Libraries:               STM32F10x_StdPeriph_Lib_V3.5.01 y0 t6 S- j3 ^, G# \0 T
  19. ** version                  V3.5
    & I: h/ t1 l' Y6 S
  20. *******************************************************************************/</i>
    , w5 H6 x- q! X* ?( f" U7 c5 i* E

  21. # Z: H! C$ A- b+ Z5 c: N" n$ b
  22. <i>/******************************************************************************9 e( m% O( w7 `
  23. 更新说明:
    # g# w* i6 \; \! }& o% \
  24. ******************************************************************************/</i>
    , c3 m2 r$ K$ E" ~

  25. 9 ?4 x/ e9 H1 o4 w/ L
  26. <i>/******************************************************************************1 m2 `- [& T: c; e# _$ X$ }& h
  27. *********************************  编 译 控 制 ********************************* @. R' d) Y0 c  q0 W' [5 b0 p
  28. ******************************************************************************/</i>5 a9 ~1 U( q" N! t. D
  29. #define MCU_SHELL               //注释掉时屏蔽iap shell功能+ t* @& U- m; z

  30. * {8 M. u, N9 u* m7 G& F0 g
  31. #include "xc_shell.h"       //Shell支持文件,含bool,uint8_t..以及串口数据收发操作
    + i3 f4 U% V' R, S1 H, L
  32. <i>/******************************************************************************# J0 I) {4 R8 r6 n9 C
  33. ********************************* 文件引用部分 ********************************5 Z8 e3 _4 d/ D1 Z6 P# W* i' x! _
  34. ******************************************************************************/</i>$ G( q6 L1 T+ d, @( u1 \) P
  35. <i>/*---------------------*
    . m( I- `7 f! U! _% j
  36. *     模块驱动引用
    & ~. E9 J1 W" s' C1 r
  37. *----------------------*/</i>! W+ v0 h6 O- c  s9 q0 ^# ~
  38. <i>//#include "net_w5500.h"</i>! N% q) @9 [7 I. U% n+ g1 K

  39. ; _; m: n. e* j# w* I" j
  40. #ifdef MCU_SHELL) X6 i  v6 E4 K, Z
  41. <i>/******************************************************************************
    1 y, R! ~" F, @
  42. ********************************** Shell实例 **********************************& n+ ^1 z5 c, k1 t; a& W- \
  43. ******************************************************************************/</i># h* Y! Z" @1 m9 w! ]  K
  44. <i>/*---------------------* ; w' q  p! k7 n# p) u' f
  45. *      CLI指令服务
    9 E- S0 Z2 f8 \9 ]/ M! b! H
  46. *----------------------*/</i>
    / @: N9 [- b- I. T% v1 V" y
  47. extern bool Shell_MCU_Service(void * pcBuff, uint16_t len );3 b; w8 U  ]  }, L3 ~! u7 c
  48. - G* P% _7 f8 ~
  49. <i>/*---------------------* 2 E. ^9 U+ Q# f/ Q% P, e0 L% Z9 g
  50. *       CLI 结构4 c" x  A6 P7 Y- p7 y0 K
  51. *----------------------*/</i>
    # _7 p9 Z: F/ L% w- h' M
  52. const Cmd_Typedef_t CLI_McuMsg=
    * Y5 [$ X9 z4 X5 b2 J; e" [
  53. {1 J; a" _, g2 Z/ D2 e% u
  54.     <i>//识别关键字</i>
    2 C$ k2 [! p1 V  O
  55.     "mcu",, a0 ]' f* F, I, a
  56.    
    ( o, S/ m+ l/ t8 [9 d
  57.     <i>//帮助内容</i>
      r$ T& U' y( \4 v+ u
  58. "[mcu contorls]\r\n"3 `- h8 G- J7 F' W0 d  S
  59. " mcu rd <d>\t\t- Read FLASH information.\r\n"
    5 \- p# J7 L$ n" C8 ?
  60. "\r\n",
    * K3 g: }) F, R4 g. J4 v8 a7 G+ ?
  61. 8 z+ `3 f4 \; ]+ O6 L$ }$ ?* L4 L
  62. <i>//处理函数</i>: }* E( j  M8 G5 I
  63. &Shell_MCU_Service,% _, c/ M* P' z2 Z' l5 ^, I

  64. ! [% Q1 x' ?$ W/ [) R: N9 Y
  65. <i>//附带数据</i>! A$ s* F$ i& i* ^
  66. 0,
    ( v( m2 [! ~, }. m
  67.   #ifdef SHELL_USE_YMODEM  7 P" K4 Q1 o' `- d7 S
  68.     <i>//存储介质</i>
      x' m2 |" ~& @2 C0 u# E! k
  69.     NULL,
    7 k2 e( i: o% Z9 a, b; j
  70.   #endif
    7 x, v: [* N" w
  71. };
    ; m6 r# C+ [0 S3 v

  72. 4 P3 P5 U# y! \( L! |8 }0 o9 x
  73. <i>/*---------------------*
    . h! t- ?$ _0 N( F; R3 A& x! e
  74. *     CLI链表节(输出)
    7 o& j! X% f) _& B
  75. *----------------------*/</i>1 U5 b5 `$ K4 w4 I- w
  76. Cmd_List_t  McuList  = {&CLI_McuMsg      ,NULL}; <i>//IAP指令链表</i>
    $ M( K) \( O8 [8 o* c  y6 B- J
  77. ' W2 i/ I! x$ E
  78. <i>/******************************************************************************' T! a& Y% `, t3 q* t3 Z+ v1 d
  79. ********************************* 函 数 声 明 *********************************
    9 R, g& Y3 f( x2 F0 |2 A
  80. ******************************************************************************/</i>4 F/ E+ t) Q; _9 l
  81. <i>/******************************************************************************; |% x% ?9 a! s7 S. {
  82. / 函数功能:STM32F103控制函数1 c/ L' e3 h$ D% V( O
  83. / 修改日期:2015/7/14 20:22:02
    : s% `, V1 N# A9 P: C/ t
  84. / 输入参数:none. X+ A5 T3 b: Y  }
  85. / 输出参数:none
    ( ~* w9 K! L7 ?) b9 `7 A
  86. / 使用说明:需要执行约10s3 w# X( x! e8 I$ t- u% p, g9 m
  87. ******************************************************************************/</i>
    " y( {2 d6 r6 m3 A; b, B
  88. static bool FLASH_ioctl(uint8_t cmd,void * param); N: [* d. C( s9 @9 n
  89. {) L/ T3 C2 n& r% T
  90.     #define UID_ADDR            0x1FFFF7E0  //闪存容量寄存器,值对应KB单位
      s; H' V4 L+ o5 D6 w- i
  91.     #define MAC_ADDR            0x1FFFF7E8  //MCU的唯一ID号,共12个字节
    , n2 |$ V. G* t9 F. {) T: C6 }9 C
  92.     #define UID_SIZE            2           //UID的字节数5 Y" E- j9 f3 B+ C/ u! b/ g/ z
  93.     #define MAC_SIZE            12          //MAC的字节数- u: N; B9 I4 c8 o( I4 z2 P* T1 C

  94. ) r/ C- n* E$ Y! V! _
  95.     <i>//step1: 检查参数</i>
    6 r: H- U$ c# l8 B0 ?
  96.     if(!param)return false;
    ! N" f8 M0 F- Q, S0 }
  97.         " ?- \' ~9 H  A7 R! [
  98.     <i>//step2: 处理数据</i>' C) d- X  s2 k: b5 [, Z
  99.     switch(cmd){
    ) C6 b2 Y. [% D/ P6 g
  100.       case 0 : {       <i>//获取FLASH的的UID</i>: I# Z: n. ^! o' p
  101.         uint16_t * ptDst = (uint16_t *)((uint32_t)param+1);
    ( \7 Q, F: g- o
  102.         
    * _( e" v, e; m
  103.         *ptDst = *(uint16_t *)UID_ADDR;, N/ k  {2 f( K5 x5 l, t5 }& k
  104.         *(uint8_t  *)param =  UID_SIZE;
    , F4 ~2 M  o0 j* S/ E
  105.         return true;) Y) o5 ?* B9 v; E5 W! r
  106.       }) q  }- K$ f( K
  107.       case 1 : {       <i>//获取芯片的MAC地址</i>
    0 z( P/ t7 U% ?) n; w
  108.         uint32_t * ptDst = (uint32_t *)((uint32_t)param+1);8 Z3 H8 W, }$ w& J
  109.         uint32_t * ptSrc = (uint32_t *)MAC_ADDR;
    7 q5 f! `& a3 u# \
  110.    
    & f% x0 j# Q% l( T, A7 U+ X
  111.         *ptDst++ = *ptSrc++;
    8 l: g( `( E; S  m# l* o
  112.         *ptDst++ = *ptSrc++;4 \* P6 X9 j1 U' Z/ U
  113.         *ptDst++ = *ptSrc++;
    & y' ~9 ?. \1 ?" \$ H8 ^: G
  114.         *(uint8_t  *)param = MAC_SIZE;
    ( C% j3 C1 _2 O( X+ u' s0 r0 L
  115.         return true;5 x. Q4 r8 E/ A0 q# X# w" p
  116.       }! J6 x. a- N+ e6 C( E2 j& o
  117.       default:return false;
    ( E4 D, S6 F* G, L- \
  118.     }/ c% O7 f, q3 p$ t: U; f3 _
  119. }
    % h1 d. v$ n/ o3 K
  120. ; w6 G9 X  u" Y% s/ U1 i
  121. <i>/******************************************************************************5 c2 {, f- D! M4 [; c: E
  122. / 函数功能:文件系统Shel指令处理, ]) _: X4 Q" O) |' P" \) \
  123. / 修改日期:2013/9/10 19:04:15
    9 q$ i9 j1 c. P) Y) b# z- o
  124. / 输入参数:输入当前的程序版本
    . l) O0 J. e, _$ A2 C, A
  125. / 输出参数:none8 ~. E$ g( y) Q! H. J6 o
  126. / 使用说明:none, l7 r7 c. J- H! |4 u
  127. ******************************************************************************/</i>
    ! C6 k/ T# V1 ~$ f
  128. bool Shell_MCU_Service(void * pcBuff, uint16_t len )
    ( t' N- L# |0 ~. P" O
  129. {
    8 J& b* T- y, u6 k
  130.     uint8_t    *ptRxd;          <i>//用于接收指令处理</i>
    ) p5 n- T# y9 t9 D3 d- R6 ^) o# _
  131.     int         i;+ j1 P0 x# k* P
  132.     uint16_t    retval;
    . b& q9 H: R' y% g6 r/ ?; d
  133.     uint8_t     buff[32];
    " l+ w' m8 r6 z  M% _
  134.    
    5 k6 _9 _/ L: h* F# ]  u
  135.     <i>//处理指令</i>" _" A+ z* a7 l' H
  136.     <i>//--------------------------------------------------------------------------</i>( y1 x4 V) q4 _; L! L
  137.     ptRxd = (uint8_t *)pcBuff;3 L. }3 c# U* i
  138.     # I6 H; I7 G1 }! Q
  139.     if(StrComp(ptRxd,"rd ")) <i>//读取FLASH信息</i>
      Y& P; L# c# N, B7 O; A& y; {
  140.     {4 H+ X( e* I+ [  l; E) b7 _
  141.         int wval;
    0 O. O4 ?9 F1 p
  142.         
    6 k6 U7 I6 J3 v8 G3 `6 c
  143.         if(1 != sscanf((void *)ptRxd,"%*s%d",&wval) )return false;( \# g$ W& F8 N. C
  144.         if( wval>2 )return false;
    8 w/ x+ X8 y- E- R) ]$ n: m* I
  145.         if(0==wval) {
    8 e% U7 j1 i0 j: f' @; g4 k( j
  146.             FLASH_ioctl(0,buff);/ q' B4 j" |! y! r
  147.             retval = *(uint16_t *)(buff+1) ;  c5 Y$ ^1 h- T2 C
  148.             printf("->Flash:\t%dKB\r\n",retval);: L9 m6 A5 O4 f' P0 {  ~
  149.             return true;0 {. M) p! ?& H
  150.         }+ o: T0 n, z: r/ @2 Z
  151.         else if(1==wval) {( @9 Q; @- r% U" I5 b( E% S
  152.             FLASH_ioctl(1,buff);
    + H/ T) r6 ~# U3 [! Q
  153.             printf("->MAC:\t ");
    ! [! K1 z* n+ G* v/ A* b
  154.             for(i=0; i<buff[0]-1; i++){printf("%02X-",buff[i+1]);}; P. b6 r1 a8 R6 b/ l9 {" J2 G% B
  155.             printf("%02X\r\n",buff[i+1]);
    4 c( ~( r8 r( @. h& O
  156.             return true;
    8 f- Y# P; Q4 z
  157.         }) }" B3 x, \! b9 q
  158.         else return false;
    4 H" x" z9 g+ d
  159.     }
    5 r7 p! s% M$ J0 x9 P/ i  W1 K
  160.     else if(StrComp(ptRxd,"help\r\n"))      <i>//指令帮助</i>- }" c& z7 s5 q; G. K; B5 c
  161.     {! A" n+ g" c9 r# d$ W- c
  162.         shell_SendStr((void *)CLI_McuMsg.pcHelpStr);
    ( C# d& v) ?5 \+ _1 P. F
  163.         return true;+ p) j5 B' X& `8 A2 j) H
  164.     }
    # v, q8 [; P3 l7 C, P3 b; R
  165.     else return false;
    * N+ B) ]) @% D$ n
  166. }2 u* c3 P& O3 f5 S  ~

  167. ; E' o% t4 f" t
  168. <i>/******************************************************************************# X$ a5 Z9 T3 @9 a7 ^: E
  169. ***********************************   END  ************************************
    * ~& D: N' a9 N  {5 Z0 i9 t3 b
  170. ******************************************************************************/</i>2 I+ x8 _4 G3 u  ]
  171. #endif
复制代码

  J3 C: g/ ^. L6 O- w3 j5.2 实现步骤

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

2) 在main.c中用extern 引用McuList,源代码为:

  1. <i>/*---------------------* , F3 |( A. ]  Z4 ]8 ]. e6 r
  2. *     Shell指令链表7 H4 a; Q0 _+ Z0 u3 L0 B2 K
  3. *----------------------*/</i>! l; f  p8 t1 K" }* m
  4. extern Cmd_List_t  McuList;
复制代码
3 N# l* ]) C+ E& u7 |+ t" @" z; |

3)在main.c初始化时添加:

  1. <i>//----------------------------------------------------------</i>
    6 _3 n* o1 n  R$ j* \5 a' ?
  2. <i>//step1: shell初始化</i>
    , {$ z' I2 N, @+ k
  3. shell_Init(115200,ledx_cfg);        <i>//初始化shell接口</i>3 ?! R: l0 {, o
  4. CLI_AddCmd(&McuList);     <i>//添加模块指令到链表</i>
复制代码
' l+ D9 S( v! y* s

4)编译工程文件。

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

]8CYLJBFL{SSIG7D7`T.png

4 f, \9 A2 k- _! k1 P: w- F+ |6 }5 C3 P  A2 X  Z
$ N# D: ^) _/ _' ?# ^
赞 收藏 评论0 发布时间:2022-1-5 21:00

举报

0个回答

所属标签

相似技术帖

官网相关资源

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