uboot 官方帮助文档 -- 移植手册部分

robe.zhang

uboot  READER 文档，关于如何移植，一共只有两部分信息，截取出来，第一部分如下：

1. If the system board that you have is not listed, then you will need
   
2. to port U-Boot to your hardware platform. To do this, follow these
   
3. steps:
   
4. 
   
5. 1.  Create a new directory to hold your board specific code. Add any
   
6.     files you need. In your board directory, you will need at least
   
7.     the "Makefile" and a "<board>.c".
   
8. 2.  Create a new configuration file "include/configs/<board>.h" for
   
9.     your board.
   
10. 3.  If you're porting U-Boot to a new CPU, then also create a new
    
11.     directory to hold your CPU specific code. Add any files you need.
    
12. 4.  Run "make <board>_defconfig" with your new name.
    
13. 5.  Type "make", and you should get a working "u-boot.srec" file
    
14.     to be installed on your target system.
    
15. 6.  Debug and solve any problems that might arise.
    
16.     [Of course, this last step is much harder than it sounds.]
    

复制代码

第二部分如下：典型的 c 代码，我加了注释：

1. U-Boot Porting Guide:
   
2. ----------------------
   
3. 
   
4. [Based on messages by Jerry Van Baren in the U-Boot-Users mailing
   
5. list, October 2002]
   
6. 
   
7. 
   
8. int main(int argc, char *argv[])
   
9. {
   
10.         sighandler_t no_more_time;
    
11. 
    
12.         signal(SIGALRM, no_more_time);
    
13.         alarm(PROJECT_DEADLINE - toSec (3 * WEEK));
    
14. 
    
15.         if (available_money > available_manpower) {
    
16.                 Pay consultant to port U-Boot;
    
17.                 return 0;
    
18.         }
    
19. 
    
20.         Download latest U-Boot source;                                     # 下载源码
    
21. 
    
22.         Subscribe to u-boot mailing list;                                  # 订阅邮件
    
23. 
    
24.         if (clueless)
    
25.                 email("Hi, I am new to U-Boot, how do I get started?");
    
26. 
    
27.         while (learning) {
    
28.                 Read the README file in the top level directory;               # 读文档
    
29.                 Read http://www.denx.de/twiki/bin/view/DULG/Manual;
    
30.                 Read applicable doc/*.README;
    
31.                 Read the source, Luke;
    
32.                 /* find . -name "*.[chS]" | xargs grep -i <keyword> */
    
33.         }
    
34. 
    
35.         if (available_money > toLocalCurrency ($2500))
    
36.                 Buy a BDI3000;
    
37.         else
    
38.                 Add a lot of aggravation and time;
    
39. 
    
40.         if (a similar board exists) {        /* hopefully... */
    
41.                 cp -a board/<similar> board/<myboard>                           # 创建板子
    
42.                 cp include/configs/<similar>.h include/configs/<myboard>.h      # 创建配置
    
43.         } else {
    
44.                 Create your own board support subdirectory;
    
45.                 Create your own board include/configs/<myboard>.h file;
    
46.         }
    
47.         Edit new board/<myboard> files                                      # 编辑文件
    
48.         Edit new include/configs/<myboard>.h                                # 编辑配置
    
49. 
    
50.         while (!accepted) {
    
51.                 while (!running) {               
    
52.                         do {
    
53.                                 Add / modify source code;                               # 改源码先编译通过
    
54.                         } until (compiles);
    
55.                         Debug;
    
56.                         if (clueless)
    
57.                                 email("Hi, I am having problems...");
    
58.                 }                                                               # 改源码运行起来
    
59.                 Send patch file to the U-Boot email list;
    
60.                 if (reasonable critiques)
    
61.                         Incorporate improvements from email list code review;
    
62.                 else
    
63.                         Defend code as written;
    
64.         }                                                                   # 改源码直到自己满意
    
65. 
    
66.         return 0;
    
67. }
    
68. 
    
69. void no_more_time (int sig)
    
70. {
    
71.       hire_a_guru();
    
72. }
    

复制代码

两部分都是笼统的讲了一下，其实两部分的内容是一样的，第一部分还详细点，第二部分代入了工作场景。
大牛看一看就知道怎么移植，小鸟看了跟没看一样，还是云里雾里。
其实这个移植指导手册也对，只是太笼统了，细节一点没有，需要对 uboot 代码和结构等等都很熟悉，并且对单板也很熟悉，这样就容易移植了。
官方移植文档就这么多信息，剩下的我来慢慢写，可能很久也写不完，但是不是特别特别详细的话，也很快。所以还是需要有基础。但是门槛肯定比 uboot 官方的门槛低得多了。

以下是本人读 uboot 做的笔记，原汁原味，内容还是比较多，后续整理发帖出来可能还没有笔记全。
https://github.com/robe-zhang/mys_y6ulx/tree/master/note_robe/note_uboot