Prepare v2023.10
[platform/kernel/u-boot.git] / board / freescale / ls2080aqds / README
1 Overview
2 --------
3 The LS2080A Development System (QDS) is a high-performance computing,
4 evaluation, and development platform that supports the QorIQ LS2080A
5 and LS2088A Layerscape Architecture processor. The LS2080AQDS provides
6 validation and SW development platform for the Freescale LS2080A, LS2088A
7 processor series, with a complete debugging environment.
8
9 LS2080A, LS2088A SoC Overview
10 --------------------
11 Please refer arch/arm/cpu/armv8/fsl-layerscape/doc/README.soc for LS2080A,
12 LS2088A SoC overview.
13
14  LS2080AQDS board Overview
15  -----------------------
16  - SERDES Connections, 16 lanes supporting:
17       - PCI Express - 3.0
18       - SGMII, SGMII 2.5
19       - QSGMII
20       - SATA 3.0
21       - XAUI
22       - 10GBase-R
23  - DDR Controller
24      - Two ports of 72-bits (8-bits ECC) DDR4. Each port supports four
25        chip-selects and two DIMM connectors. Support is up to 2133MT/s.
26      - One port of 40-bits (8-bits ECC) DDR4 which supports four chip-selects
27        and two DIMM connectors. Support is up to 1600MT/s.
28  -IFC/Local Bus
29     - IFC rev. 2.0 implementation supporting Little Endian connection scheme.
30     - One in-socket 128 MB NOR flash 16-bit data bus
31     - One 512 MB NAND flash with ECC support
32     - IFC Test Port
33     - PromJet Port
34     - FPGA connection
35  - USB 3.0
36     - Two high speed USB 3.0 ports
37     - First USB 3.0 port configured as Host with Type-A connector
38     - Second USB 3.0 port configured as OTG with micro-AB connector
39  - SDHC: PCIe x1 Right Angle connector for supporting following cards
40     - 1/4-/8-bit SD/MMC Legacy CARD supporting 3.3V devices only
41     - 1-/4-/8-bit SD/MMC Card supporting 1.8V devices only
42     - 4-bit eMMC Card Rev 4.4 (1.8V only)
43     - 8-bit eMMC Card Rev 4.5 (1.8V only)
44     - SD Card Rev 2.0 and Rev 3.0
45  - DSPI: 3 high-speed flash Memory for storage
46     - 16 MB high-speed flash Memory for boot code and storage (up to 108MHz)
47     - 8 MB high-speed flash Memory (up to 104 MHz)
48     - 512 MB low-speed flash Memory (up to 40 MHz)
49  - QSPI: via NAND/QSPI Card
50  - 4 I2C controllers
51  - Two SATA onboard connectors
52  - UART
53    - Two 4-pin (HW control) or four 2-pin (SW control) serial ports at up to 115.2 Kbit/s
54    - Two DB9 D-Type connectors supporting one Serial port each
55  - ARM JTAG support
56
57 Memory map from core's view
58 ----------------------------
59 0x00_0000_0000 .. 0x00_000F_FFFF        Boot Rom
60 0x00_0100_0000 .. 0x00_0FFF_FFFF        CCSR
61 0x00_1800_0000 .. 0x00_181F_FFFF        OCRAM
62 0x00_3000_0000 .. 0x00_3FFF_FFFF        IFC region #1
63 0x00_8000_0000 .. 0x00_FFFF_FFFF        DDR region #1
64 0x05_1000_0000 .. 0x05_FFFF_FFFF        IFC region #2
65 0x80_8000_0000 .. 0xFF_FFFF_FFFF        DDR region #2
66
67 Other addresses are either reserved, or not used directly by U-Boot.
68 This list should be updated when more addresses are used.
69
70 IFC region map from core's view
71 -------------------------------
72 During boot i.e. IFC Region #1:-
73   0x30000000 - 0x37ffffff : 128MB : NOR flash
74   0x38000000 - 0x3BFFFFFF : 64MB  : Promjet
75   0x3C000000 - 0x40000000 : 64MB  : FPGA etc
76
77 After relocate to DDR i.e. IFC Region #2:-
78   0x5_1000_0000..0x5_1fff_ffff  Memory Hole
79   0x5_2000_0000..0x5_3fff_ffff  IFC CSx (FPGA, NAND and others 512MB)
80   0x5_4000_0000..0x5_7fff_ffff  ASIC or others 1GB
81   0x5_8000_0000..0x5_bfff_ffff  IFC CS0 1GB (NOR/Promjet)
82   0x5_C000_0000..0x5_ffff_ffff  IFC CS1 1GB (NOR/Promjet)
83
84 Booting Options
85 ---------------
86 a) Promjet Boot
87 b) NOR boot
88 c) NAND boot
89 d) SD boot
90 e) QSPI boot
91
92 Memory map for NOR boot
93 -------------------------
94 Image                           Flash Offset
95 RCW+PBI                         0x00000000
96 Boot firmware (U-Boot)          0x00100000
97 Boot firmware Environment       0x00300000
98 PPA firmware                    0x00400000
99 Secure Headers                  0x00600000
100 DPAA2 MC                        0x00A00000
101 DPAA2 DPL                       0x00D00000
102 DPAA2 DPC                       0x00E00000
103 Kernel.itb                      0x01000000
104
105 Memory map for SD boot
106 -------------------------
107 Image                           Flash Offset    SD Card
108                                                 Start Block No.
109 RCW+PBI                         0x00000000      0x00008
110 Boot firmware (U-Boot)          0x00100000      0x00800
111 Boot firmware Environment       0x00300000      0x01800
112 PPA firmware                    0x00400000      0x02000
113 DPAA2 MC                        0x00A00000      0x05000
114 DPAA2 DPL                       0x00D00000      0x06800
115 DPAA2 DPC                       0x00E00000      0x07000
116 Kernel.itb                      0x01000000      0x08000
117
118 Environment Variables
119 ---------------------
120 - mcboottimeout: MC boot timeout in milliseconds. If this variable is not defined
121   the value CFG_SYS_LS_MC_BOOT_TIMEOUT_MS will be assumed.
122
123 - mcmemsize: MC DRAM block size. If this variable is not defined
124   the value CFG_SYS_LS_MC_DRAM_BLOCK_MIN_SIZE will be assumed.
125
126 Booting Linux flavors which do not support 48-bit VA (< Linux 3.18)
127 -------------------------------------------------------------------
128 One needs to use appropriate bootargs to boot Linux flavors which do
129 not support 48-bit VA (for e.g. < Linux 3.18) by appending mem=2048M, as shown
130 below:
131
132 => setenv bootargs 'console=ttyS1,115200 root=/dev/ram
133    earlycon=uart8250,mmio,0x21c0600,115200 default_hugepagesz=2m hugepagesz=2m
134    hugepages=16 mem=2048M'
135
136
137 X-QSGMII-16PORT riser card
138 ----------------------------
139 The X-QSGMII-16PORT is a 4xQSGMII/8xSGMII riser card with eighth SerDes
140 interfaces implemented in PCIe form factor board.
141 It supports following:
142  - Card can operate with up to 4 QSGMII lane simultaneously
143  - Card can operate with up to 8 SGMII lane simultaneously
144
145 Supported card configuration
146         - CSEL  : ON ON ON ON
147         - MSEL1 : ON ON ON ON OFF OFF OFF OFF
148         - MSEL2 : OFF OFF OFF OFF ON ON ON ON
149
150 To enable this card: modify hwconfig to add "xqsgmii" variable.
151
152 Supported PHY addresses during SGMII:
153 #define XQSGMII_CARD_PHY1_PORT0_ADDR 0x0
154 #define XQSGMII_CARD_PHY1_PORT2_ADDR 0x2
155 #define XQSGMII_CARD_PHY2_PORT0_ADDR 0x4
156 #define XQSGMII_CARD_PHY2_PORT2_ADDR 0x6
157 #define XQSGMII_CARD_PHY3_PORT0_ADDR 0x8
158 #define XQSGMII_CARD_PHY3_PORT2_ADDR 0xa
159 #define XQSGMII_CARD_PHY4_PORT0_ADDR 0xc
160 #define XQSGMII_CARD_PHY4_PORT2_ADDR 0xe
161
162 Mapping DPMACx to PHY during SGMII
163 DPMAC1 -> PHY1-P0
164 DPMAC2 -> PHY2-P0
165 DPMAC3 -> PHY3-P0
166 DPMAC4 -> PHY4-P0
167 DPMAC5 -> PHY3-P2
168 DPMAC6 -> PHY1-P2
169 DPMAC7 -> PHY4-P1
170 DPMAC8 -> PHY2-P2
171 DPMAC9 -> PHY1-P0
172 DPMAC10 -> PHY2-P0
173 DPMAC11 -> PHY3-P0
174 DPMAC12 -> PHY4-P0
175 DPMAC13 -> PHY3-P2
176 DPMAC14 -> PHY1-P2
177 DPMAC15 -> PHY4-P1
178 DPMAC16 -> PHY2-P2
179
180
181 Supported PHY address during QSGMII
182 #define XQSGMII_CARD_PHY1_PORT0_ADDR 0x0
183 #define XQSGMII_CARD_PHY1_PORT1_ADDR 0x1
184 #define XQSGMII_CARD_PHY1_PORT2_ADDR 0x2
185 #define XQSGMII_CARD_PHY1_PORT3_ADDR 0x3
186 #define XQSGMII_CARD_PHY2_PORT0_ADDR 0x4
187 #define XQSGMII_CARD_PHY2_PORT1_ADDR 0x5
188 #define XQSGMII_CARD_PHY2_PORT2_ADDR 0x6
189 #define XQSGMII_CARD_PHY2_PORT3_ADDR 0x7
190 #define XQSGMII_CARD_PHY3_PORT0_ADDR 0x8
191 #define XQSGMII_CARD_PHY3_PORT1_ADDR 0x9
192 #define XQSGMII_CARD_PHY3_PORT2_ADDR 0xa
193 #define XQSGMII_CARD_PHY3_PORT3_ADDR 0xb
194 #define XQSGMII_CARD_PHY4_PORT0_ADDR 0xc
195 #define XQSGMII_CARD_PHY4_PORT1_ADDR 0xd
196 #define XQSGMII_CARD_PHY4_PORT2_ADDR 0xe
197 #define XQSGMII_CARD_PHY4_PORT3_ADDR 0xf
198
199 Mapping DPMACx to PHY during QSGMII
200 DPMAC1 -> PHY1-P3
201 DPMAC2 -> PHY1-P2
202 DPMAC3 -> PHY1-P1
203 DPMAC4 -> PHY1-P0
204 DPMAC5 -> PHY2-P3
205 DPMAC6 -> PHY2-P2
206 DPMAC7 -> PHY2-P1
207 DPMAC8 -> PHY2-P0
208 DPMAC9 -> PHY3-P0
209 DPMAC10 -> PHY3-P1
210 DPMAC11 -> PHY3-P2
211 DPMAC12 -> PHY3-P3
212 DPMAC13 -> PHY4-P0
213 DPMAC14 -> PHY4-P1
214 DPMAC15 -> PHY4-P2
215 DPMAC16 -> PHY4-P3