Blame view

doc/README.arm-relocation 5.78 KB
d41ce506b   Eric Lee   Initial Release, ...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
  To make relocation on arm working, the following changes are done:
  
  At arch level: add linker flag -pie
  
  	This causes the linker to generate fixup tables .rel.dyn and .dynsym,
  	which must be applied to the relocated image before transferring
  	control to it.
  
  	These fixups are described in the ARM ELF documentation as type 23
  	(program-base-relative) and 2 (symbol-relative)
  
  At cpu level: modify linker file and add a relocation and fixup loop
  
  	the linker file must be modified to include the .rel.dyn and .dynsym
  	tables in the binary image, and to provide symbols for the relocation
  	code to access these tables
  
  	The relocation and fixup loop must be executed after executing
  	board_init_f at initial location and before executing board_init_r
  	at final location.
  
  At board level:
  
  	dram_init(): bd pointer is now at this point not accessible, so only
  	detect the real dramsize, and store it in gd->ram_size. Bst detected
  	with get_ram_size().
  
  TODO:	move also dram initialization there on boards where it is possible.
  
  	Setup of the the bd_t dram bank info is done in the new function
  	dram_init_banksize() called after bd is accessible.
  
  At lib level:
  
  	Board.c code is adapted from ppc code
  
  * WARNING ** WARNING ** WARNING ** WARNING ** WARNING ** WARNING ** WARNING *
  
  Boards which are not fixed to support relocation will be REMOVED!
  
  -----------------------------------------------------------------------------
  
  For boards which boot from spl, it is possible to save one copy
  if CONFIG_SYS_TEXT_BASE == relocation address! This prevents that uboot code
  is copied again in relocate_code().
  
  example for the tx25 board booting from NAND Flash:
  
  a) cpu starts
  b) it copies the first page in nand to internal ram
     (spl code)
  c) end executes this code
  d) this initialize CPU, RAM, ... and copy itself to RAM
     (this bin must fit in one page, so board_init_f()
      don;t fit in it ... )
  e) there it copy u-boot to CONFIG_SYS_NAND_U_BOOT_DST and
     starts this image @ CONFIG_SYS_NAND_U_BOOT_START
  f) u-boot code steps through board_init_f() and calculates
     the relocation address and copy itself to it
  
  If CONFIG_SYS_TEXT_BASE == relocation address, the copying of u-boot
  in f) could be saved.
  
  -----------------------------------------------------------------------------
  
  TODO
  
  - fill in bd_t infos (check)
  - adapt all boards
  
  - maybe adapt CONFIG_SYS_TEXT_BASE (this must be checked from board maintainers)
    This *must* be done for boards, which boot from NOR flash
  
    on other boards if CONFIG_SYS_TEXT_BASE = relocation baseaddr, this saves
    one copying from u-boot code.
  
  - new function dram_init_banksize() is actual board specific. Maybe
    we make a weak default function in arch/arm/lib/board.c ?
  
  -----------------------------------------------------------------------------
  
  Relocation with SPL (example for the tx25 booting from NAND Flash):
  
  - cpu copies the first page from NAND to 0xbb000000 (IMX_NFC_BASE)
    and start with code execution on this address.
  
  - The First page contains u-boot code from drivers/mtd/nand/mxc_nand_spl.c
    which inits the dram, cpu registers, reloacte itself to CONFIG_SPL_TEXT_BASE	and loads
    the "real" u-boot to CONFIG_SYS_NAND_U_BOOT_DST and starts execution
    @CONFIG_SYS_NAND_U_BOOT_START
  
  - This u-boot does no RAM init, nor CPU register setup. Just look
    where it has to copy and relocate itself to this address. If
    relocate address = CONFIG_SYS_TEXT_BASE (not the same, as the
    CONFIG_SPL_TEXT_BASE from the spl code), then there is no need
    to copy, just go on with bss clear and jump to board_init_r.
  
  -----------------------------------------------------------------------------
  
  How ELF relocations 23 and 2 work.
  
  TBC
  
  -------------------------------------------------------------------------------------
  
  Debugging u-boot in RAM:
  (example on the qong board)
  
  -----------------
  
  a) start debugger
  
  arm-linux-gdb u-boot
  
  [hs@pollux u-boot]$ arm-linux-gdb u-boot
  GNU gdb Red Hat Linux (6.7-2rh)
  Copyright (C) 2007 Free Software Foundation, Inc.
  License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
  This is free software: you are free to change and redistribute it.
  There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
  and "show warranty" for details.
  This GDB was configured as "--host=i686-pc-linux-gnu --target=arm-linux".
  The target architecture is set automatically (currently arm)
  ..
  (gdb)
  
  -----------------
  
  b) connect to target
  
  target remote bdi10:2001
  
  (gdb) target remote bdi10:2001
  Remote debugging using bdi10:2001
  0x8ff17f10 in ?? ()
  (gdb)
  
  -----------------
  
  c) discard symbol-file
  
  (gdb) symbol-file
  Discard symbol table from `/home/hs/celf/u-boot/u-boot'? (y or n) y
  No symbol file now.
  (gdb)
  
  -----------------
  
  d) load new symbol table:
  
  (gdb) add-symbol-file u-boot 0x8ff08000
  add symbol table from file "u-boot" at
  	.text_addr = 0x8ff08000
  (y or n) y
  Reading symbols from /home/hs/celf/u-boot/u-boot...done.
  (gdb) c
  Continuing.
  ^C
  Program received signal SIGSTOP, Stopped (signal).
  0x8ff17f18 in serial_getc () at serial_mxc.c:192
  192		while (__REG(UART_PHYS + UTS) & UTS_RXEMPTY);
  (gdb)
  
  add-symbol-file u-boot 0x8ff08000
  		       ^^^^^^^^^^
  		       get this address from u-boot bdinfo command
  		       or get it from gd->relocaddr in gdb
  
   => bdinfo
  rch_number = XXXXXXXXXX
  boot_params = XXXXXXXXXX
  DRAM bank   = XXXXXXXXXX
  -> start    = XXXXXXXXXX
  -> size     = XXXXXXXXXX
  ethaddr     = XXXXXXXXXX
  ip_addr     = XXXXXXXXXX
  baudrate    = XXXXXXXXXX
  TLB addr    = XXXXXXXXXX
  relocaddr   = 0x8ff08000
  	      ^^^^^^^^^^
  reloc off   = XXXXXXXXXX
  irq_sp	    = XXXXXXXXXX
  sp start    = XXXXXXXXXX
  FB base     = XXXXXXXXXX
  
  or interrupt execution by any means and re-load the symbols at the location
  specified by gd->relocaddr -- this is only valid after board_init_f.
  
  (gdb) set $s = gd->relocaddr
  (gdb) symbol-file
  (gdb) add-symbol-file u-boot $s
  
  Now you can use gdb as usual :-)