source: rtems-docs/user/bsps/bsps-powerpc.rst @ a00052a

5
Last change on this file since a00052a was a00052a, checked in by Sebastian Huber <sebastian.huber@…>, on 05/27/19 at 08:37:20

user: Document boot image generation

Update #3727.

  • Property mode set to 100644
File size: 3.3 KB
Line 
1.. SPDX-License-Identifier: CC-BY-SA-4.0
2
3.. Copyright (C) 2018 embedded brains GmbH
4
5powerpc (PowerPC)
6*****************
7
8beatnik
9=======
10
11TODO.
12
13gen5200
14=======
15
16TODO.
17
18gen83xx
19=======
20
21TODO.
22
23haleakala
24=========
25
26TODO.
27
28motorola_powerpc
29================
30
31Boot Image Generation
32---------------------
33
34The application executable file (ELF file) must be converted to a boot
35image.  Use the following commands:
36
37.. code-block:: none
38
39    powerpc-rtems5-objcopy -O binary -R .comment -S ticker.exe rtems
40    gzip -9 -f rtems
41    powerpc-rtems5-ld -o ticker.boot bootloader.o --just-symbols=ticker.exe -b binary rtems.gz -T ppcboot.lds -no-warn-mismatch
42    powerpc-rtems5-objcopy -O binary ticker.boot ticker.bin
43
44mpc55xxevb
45==========
46
47TODO.
48
49mpc8260ads
50==========
51
52TODO.
53
54mvme3100
55========
56
57TODO.
58
59mvme5500
60========
61
62TODO.
63
64psim
65====
66
67TODO.
68
69qemuppc
70=======
71
72TODO.
73
74qoriq (QorIQ)
75=============
76
77The BSP for the `QorIQ <https://en.wikipedia.org/wiki/QorIQ>`_ chip family
78offers three variants.  The `qoriq_e500` variant supports the P-series chips
79such as P1020, P2010 and P2020.  The `qoriq_e6500_32` (32-bit ISA) and
80`qoriq_e6500_64` (64-bit ISA) variants support the T-series chips such as T2080
81and T4240.  The basic hardware initialization is not performed by the BSP.  A
82boot loader with device tree support must be used to start the BSP, e.g.
83U-Boot.
84
85The BSP is known to run on these boards:
86
87* NXP P1020RDB
88
89* MicroSys miriac MPX2020 (System on Module)
90
91* Artesyn MVME2500 (VME64x SBC)
92
93* NXP T2080RDB
94
95* NXP T4240RDB
96
97* MEN G52A (CompactPCI Serial)
98
99The `qoriq_core_0` and `qoriq_core_1` variants should be used with care.  They
100are inteded for a `RTEMS_MULTIPROCESSING` configuration on the P1020.
101
102Boot via U-Boot
103---------------
104
105The application executable file (ELF file) must be converted to an U-Boot
106image.  Use the following commands:
107
108.. code-block:: none
109
110    powerpc-rtems5-objcopy -O binary app.exe app.bin
111    gzip -9 -f -c app.bin > app.bin.gz
112    mkimage -A ppc -O linux -T kernel -a 0x4000 -e 0x4000 -n RTEMS -d app.bin.gz app.img
113
114Use the following U-Boot commands to boot an application via TFTP download:
115
116.. code-block:: none
117
118    tftpboot ${loadaddr} app.img && run loadfdt && bootm ${loadaddr} - ${fdt_addr} ; reset
119
120Clock Driver
121------------
122
123The clock driver uses two MPIC global timer (``QORIQ_CLOCK_TIMER`` and
124``QORIQ_CLOCK_TIMECOUNTER``).  In case ``QORIQ_IS_HYPERVISOR_GUEST`` is
125defined, then the PowerPC decrementer is used.
126
127Console Driver
128--------------
129
130The console driver supports the on-chip NS16550 compatible UARTs.  In case
131``QORIQ_IS_HYPERVISOR_GUEST`` is defined, then the EPAPR byte channel is used
132for the console device.
133
134Network Interface Driver
135------------------------
136
137The network interface driver is provided by the `libbsd`.  The DPAA is
138supported including 10Gbit/s Ethernet.
139
140Topaz Hypervisor Guest
141----------------------
142
143For a Topaz hypervisor guest configuration use:
144
145::
146
147    ../configure --enable-rtemsbsp=qoriq_e6500_32 \
148        QORIQ_IS_HYPERVISOR_GUEST=1 \
149        QORIQ_UART_0_ENABLE=0 \
150        QORIQ_UART_1_ENABLE=0 \
151        QORIQ_TLB1_ENTRY_COUNT=16
152
153You may have to adjust the linker command file according to your partition
154configuration.
155
156ss555
157=====
158
159TODO.
160
161t32mppc
162=======
163
164TODO.
165
166tqm8xx
167======
168
169TODO.
170
171virtex
172======
173
174TODO.
175
176virtex4
177=======
178
179TODO.
180
181virtex5
182=======
183
184TODO.
Note: See TracBrowser for help on using the repository browser.