Merge branch '2021-09-30-whitespace-cleanups' into next
[platform/kernel/u-boot.git] / board / freescale / ls2080ardb / README
1 Overview
2 --------
3 The LS2080A Reference Design (RDB) is a high-performance computing,
4 evaluation, and development platform that supports the QorIQ LS2080A, LS2088A
5 Layerscape Architecture processor.
6
7 The LS2081A Reference Design (RDB) is a high-performance computing,
8 evaluation, and development platform that supports the QorIQ LS2081A
9 Layerscape Architecture processor.More details in below sections
10
11 LS2080A, LS2088A, LS2081A SoC Overview
12 --------------------------------------
13 Please refer arch/arm/cpu/armv8/fsl-layerscape/doc/README.soc for LS2080A,
14 LS2081A, LS2088A SoC overview.
15
16  LS2080ARDB board Overview
17  -----------------------
18  - SERDES Connections, 16 lanes supporting:
19       - PCI Express - 3.0
20       - SATA 3.0
21       - 10GBase-R
22  - DDR Controller
23      - Two ports of 72-bits (8-bits ECC) DDR4. Each port supports four
24        chip-selects and two DIMM connectors. Support is up to 2133MT/s.
25      - One port of 40-bits (8-bits ECC) DDR4 which supports four chip-selects
26        and two DIMM connectors. Support is up to 1600MT/s.
27  -IFC/Local Bus
28     - IFC rev. 2.0 implementation supporting Little Endian connection scheme.
29     - 128 MB NOR flash 16-bit data bus
30     - One 2 GB NAND flash with ECC support
31     - CPLD connection
32  - USB 3.0
33     - Two high speed USB 3.0 ports
34     - First USB 3.0 port configured as Host with Type-A connector
35     - Second USB 3.0 port configured as OTG with micro-AB connector
36  - SDHC adapter
37     - SD Card Rev 2.0 and Rev 3.0
38  - DSPI
39     - 128 MB high-speed flash Memory for boot code and storage (up to 108MHz)
40  - 4 I2C controllers
41  - Two SATA onboard connectors
42  - UART
43  - ARM JTAG support
44
45  LS2081ARDB board Overview
46  -------------------------
47  LS2081ARDB board is similar to LS2080ARDB board
48  with few differences like
49   - Hosts LS2081A SoC
50   - Default boot source is QSPI-boot
51   - Does not have IFC interface
52   - RTC and QSPI flash devices are different
53   - Provides QIXIS access via I2C
54
55 Memory map from core's view
56 ----------------------------
57 0x00_0000_0000 .. 0x00_000F_FFFF        Boot Rom
58 0x00_0100_0000 .. 0x00_0FFF_FFFF        CCSR
59 0x00_1800_0000 .. 0x00_181F_FFFF        OCRAM
60 0x00_2000_0000 .. 0x00_2FFF_FFFF        QSPI region #1
61 0x00_3000_0000 .. 0x00_3FFF_FFFF        IFC region #1
62 0x00_8000_0000 .. 0x00_FFFF_FFFF        DDR region #1
63 0x05_1000_0000 .. 0x05_FFFF_FFFF        IFC region #2
64 0x80_8000_0000 .. 0xFF_FFFF_FFFF        DDR region #2
65
66 Other addresses are either reserved, or not used directly by U-Boot.
67 This list should be updated when more addresses are used.
68
69 IFC region map from core's view
70 -------------------------------
71 During boot i.e. IFC Region #1:-
72   0x30000000 - 0x37ffffff : 128MB : NOR flash
73   0x3C000000 - 0x40000000 : 64MB  : CPLD
74
75 After relocate to DDR i.e. IFC Region #2:-
76   0x5_1000_0000..0x5_1fff_ffff  Memory Hole
77   0x5_2000_0000..0x5_3fff_ffff  IFC CSx (CPLD, NAND and others 512MB)
78   0x5_4000_0000..0x5_7fff_ffff  ASIC or others 1GB
79   0x5_8000_0000..0x5_bfff_ffff  IFC CS0 1GB (NOR/Promjet)
80   0x5_C000_0000..0x5_ffff_ffff  IFC CS1 1GB (NOR/Promjet)
81
82 Booting Options
83 ---------------
84 a) NOR boot
85 b) NAND boot
86 c) QSPI boot
87
88 Memory map for NOR boot
89 -------------------------
90 Image                           Flash Offset
91 RCW+PBI                         0x00000000
92 Boot firmware (U-Boot)          0x00100000
93 Boot firmware Environment       0x00300000
94 PPA firmware                    0x00400000
95 Secure Headers                  0x00600000
96 Cortina PHY firmware            0x00980000
97 DPAA2 MC                        0x00A00000
98 DPAA2 DPL                       0x00D00000
99 DPAA2 DPC                       0x00E00000
100 Kernel.itb                      0x01000000
101
102 cfg_rcw_src switches needs to be changed for booting from different option.
103 Refer to board documentation for correct switch setting.
104
105 QSPI boot details
106 ===================
107 Supported only for
108  LS2088ARDB RevF board with LS2088A SoC.
109
110 Images needs to be copied to QSPI flash
111 as per memory map given below.
112
113 Memory map for QSPI flash
114 -------------------------
115 Image                           Flash Offset
116 RCW+PBI                         0x00000000
117 Boot firmware (U-Boot)          0x00100000
118 Boot firmware Environment       0x00300000
119 PPA firmware                    0x00400000
120 Cortina PHY firmware            0x00980000
121 DPAA2 MC                        0x00A00000
122 DPAA2 DPL                       0x00D00000
123 DPAA2 DPC                       0x00E00000
124 Kernel.itb                      0x01000000
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'