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

5
Last change on this file since e52906b was e52906b, checked in by Sebastian Huber <sebastian.huber@…>, on 01/09/19 at 15:14:06

Simplify SPDX-License-Identifier comment

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