7 S& _% H9 v( m
2 s$ m! A- G' Q, a* w

够用的硬件
能用的代码
" v' k9 E7 `9 s# d) C, Z: E' v. H实用的教程
屋脊雀工作室编撰 -20180418
官网：www.wujique.com
github:http://github.com/wujique/stm32f407
资料下载：https://pan.baidu.com/s/1pQrKr2_Jufd-cEYV4ZYAFw
本文章资料在stm32f407\4 教程--其他系统模块\移植uboot命令行目录

---

今天开始移植uboot中的命令行功能到STM32上，使用的是MDK(KEIL)编译器。
其实以前移植过一次，平台是K21+IAR。由于代码中有部分与编译器有关，折腾了半天才实现。特地记录。

UBOOT CMD

UBOOT CMD的代码中，有一个比较特殊的定义。
命令的定义通过一个宏声明一个结构体，这个结构体如下

1. #define REGISTER_CMD(name,maxargs,rep,cmd,usage,help) \      __root  const cmd_tbl_t strcmd_##name @ ".cmd" =  {#name, maxargs, rep, cmd, usage,help}

复制代码

0 ~1 E, M/ K4 a7 t4 p

我们先分析这个宏的功能
2 f" {1 v% g; k+ Q# `( J3 t# e2 u- __root:
! w  T3 t" C. O1 R5 I被修饰的变量或者函数在用户程序里面没有显式调用情况下，也不会被优化掉。
# \4 m7 a6 `/ N- @1 x  L7 W# |- const:
1 e' A+ y: K7 `  D: f1 M+ ]$ U& S* s这个大家应该常用，就是将变量定义为常量，保存在FLASH，不占用RAM。
3 K% `$ p! t% a7 b- cmd_tbl_t：
结构体定义
. X. `7 k5 b2 J: M- strcmd_##name：
! Q  K4 q. _6 I. S7 M+ e宏名字，例如宏第一个参数是test，编译后得结构体名字就是strcmd__test
4 T0 K' P# s. {# D1 W" e' m8 r- @ ".cmd":
定义的结构体保存在.cmd段，这个段是在IAR工程的.icf文件中定义。

剩下的就是赋值给结构体了。

这样定义的结果就是：

定义了一个放在.cmd段的结构体，就算这个结构体没有显式调用，也不会被程序优化。

MDK(KEIL)定义

那么在MDK下要怎么定义呢？
3 J& D2 I8 L$ n" i9 o, Y% L/ k- 首先是如下，通过attribute 关键字将结构体放到cmd段中。

1. #define REGISTER_CMD(name,maxargs,rep,cmd,usage,help) \            const cmd_tbl_t strcmd_##name __attribute__ ((section ("cmd"))) =  {#name, maxargs, rep, cmd, usage,help}

复制代码

• 第二，就是要使用自定义的分散加载文件
  
  / ]% e# c0 _. r) l" [把左上角的use memory layout from target Dialog前面的勾去掉。
  然后点击右边中间的Edit按钮，关掉窗口，就可以编辑.sct文件了。
  

# }1 a% ]( M- T6 p+ Y

1. LR_IROM1 0x08000000 0x00100000  {    ; load region size_region
   - T/ z9 J: m* h0 F
2.   ER_IROM1 0x08000000 0x000ff000  {  ; load address = execution address
   : t& H' E1 q; B
3.    *.o (RESET, +First)
   
4.    *(InRoot$Sections)
   6 v9 ?% k+ E4 b, ]) M7 u9 {
5.    .ANY (+RO)
   
6.   }
   0 ]# K! c0 ~' j' {: l5 C
7. 
   ! p! L$ k$ p% z6 P! R- a
8.   cmdreg +0
   
9.   {
   # [6 D2 ^" l( z- L$ d# z
10.         .ANY(cmd)
    & n- x: h4 P' I$ Z
11.   }
    
12.   RW_IRAM1 0x20000000 0x00020000  {  ; RW data
    / n# L* {) }, V' o% Y+ t! j
13.    .ANY (+RW +ZI)
    . f% j" B3 h9 ]& p
14.   }
    
15. }

复制代码

中间一段就是增加的
, p9 Z. j: L$ g1 Kcmdreg区域名字。
+0的意思是紧跟着其他代码段。
# g# A, A- h; m! H* m" h.ANY(cmd) 这个比较关键，跟代码中的(section ("cmd"))对应。

也可以指定这个段的起始地址跟长度
cmdreg 0x080ff000 0x1000
4 Y9 q9 l4 o( ^- D  z0 g6 a: r{
.ANY(cmd)
}

• 第三，就是要防止这些变量被优化
  & D: t: C) |0 s; }8 ^, _# a% F在option中设置
  
  ; P1 D# W, @; O0 {4 H( J看下面，Misc controls中，添加一个宏“--keep=strcmd_*”,意思是所有strcmd_开头的变量跟函数，都不会被优化。
  

确认结果

编译后，查看.map文件（通常在工程下的Listings文件夹下）

1. Execution Region cmdreg (Exec base: 0x08048efc, Load base: 0x08048efc, Size: 0x000000a8, Max: 0xffffffff, ABSOLUTE)
   . v' D& Y9 P; S4 J+ v4 a6 y5 B8 l
2. 
   # h! r: X8 n6 ]% [  p+ H3 r$ F
3. Exec Addr    Load Addr    Size         Type   Attr      Idx    E Section Name        Object
   - C9 A% H9 O$ K. W' S2 s; q, ]
4. 
   0 c4 H0 P' q+ |$ r+ A+ K
5. 0x08048efc   0x08048efc   0x0000001c   Data   RO        16605    cmd                 cmd_sys.o
   
6. 0x08048f18   0x08048f18   0x0000001c   Data   RO        16606    cmd                 cmd_sys.o
   
7. 0x08048f34   0x08048f34   0x0000001c   Data   RO        16607    cmd                 cmd_sys.o
   ' b8 c& H- W, s8 f
8. 0x08048f50   0x08048f50   0x0000001c   Data   RO        16608    cmd                 cmd_sys.o
   
9. 0x08048f6c   0x08048f6c   0x0000001c   Data   RO        16685    cmd                 commnad.o
   - l, h8 t1 \8 |/ i0 Y2 O# l
10. 0x08048f88   0x08048f88   0x0000001c   Data   RO        16686    cmd                 commnad.o

复制代码

从中也可以看到我们前面定义的意思
cmdreg是Execution Region名字
Base: 0x080ff000, Size: 0x000000a8, Max: 0x00001000
我们现在只用了0x000000a8字节
cmd 是E Section Name

代码中使用段地址跟长度

好的，前面我们已经定义了一个命令段，那代码中怎么用这个段呢？
% a2 A# ?/ N: |, i像下面这样使用即可。

1. extern unsigned char Load$cmdreg$Base[];
   
2. extern unsigned char Load$cmdreg$Length[];
   ) J0 a: u6 J0 t3 y5 K
3. 
   / A. Q# z2 Z2 k# n4 i
4. unsigned long add = (unsigned long)Load$cmdreg$Base;
   / i3 J; `( m2 I  Y& p  m) p9 W. u
5. unsigned long len = (unsigned long)Load$cmdreg$Length;
   
6. 
   . U4 H5 P( C; a, W9 r8 p2 h; ?
7.         uart_printf("cmd addr:%08x, limit:%08x\r\n", add, len);

复制代码

在网上查找如何引用段地址时，找到了这个网页：
http://www.cnblogs.com/Dreamxi/p/3507932.html
大家可以参考这个网页的做法。

问题

--keep是在MDK设置中定义，能不能直接在代码中定义？
--keep=cmd_*会有匹问题，如果以后其他模块定义类似的变量或者函数，就同样不会被优化了。
2 E. e1 v( r& E# Y* @能不能在代码中直接指定不优化的内容？不使用通配符。
不管了，暂时能用先。

通过shell交互

安装Xshell 5软件，配置一个串口链接。

系统启动后，敲下回车，出现命令行，输入help，查看有多少命令。
0 o% h* H2 N/ `: P! M( }5 `输入命令systeminfo，查看系统信息。

增加命令

可以随意添加命令，按照下面的个是注册命令就可以了，

REGISTER_CMD(    systeminfo,2,1,do_system_info,    "systeminfo",    "\t display system info ");说明

• 1
  本次测试命令行基于freertos。
  0 l7 B% U$ q# H$ H+ j# y; o  A- K因为命令行程序内部是while(1)死循环，如果没有操作系统任务调度，很难实现。
  $ N, G3 \0 }0 ]除非只有命令行功能，并且其他功能全部通过命令行调用或者是中断。
• 2
  代码托管在github：http://github.com/wujique/stm32f407/tree/sw_arch
  

总结

本文档指说明了移植过在MDK的细节，对于UBOOT命令行的具体实现，有兴趣自行研究。

& y# i8 G6 ]2 F8 a

大神

学习了

最新的代码请到github上获取，仓库会持续更新修正BUG优化性能
http://github.com/wujique/stm32f407