arch/arm/cpu/armv8/fsl-lsch3/README

   1 #
   2 # Copyright 2014 Freescale Semiconductor
   3 #
   4 # SPDX-License-Identifier:      GPL-2.0+
   5 #
   6
   7 Freescale LayerScape with Chassis Generation 3
   8
   9 This architecture supports Freescale ARMv8 SoCs with Chassis generation 3,
  10 for example LS2085A.
  11
  12 DDR Layout
  13 ============
  14 Entire DDR region splits into two regions.
  15  - Region 1 is at address 0x8000_0000 to 0xffff_ffff.
  16  - Region 2 is at 0x80_8000_0000 to the top of total memory,
  17    for example 16GB, 0x83_ffff_ffff.
  18
  19 All DDR memory is marked as cache-enabled.
  20
  21 When MC and Debug server is enabled, they carve 512MB away from the high
  22 end of DDR. For example, if the total DDR is 16GB, it shrinks to 15.5GB
  23 with MC and Debug server enabled. Linux only sees 15.5GB.
  24
  25 The reserved 512MB layout looks like
  26
  27    +---------------+ <-- top/end of memory
  28    |    256MB      |  debug server
  29    +---------------+
  30    |    256MB      |  MC
  31    +---------------+
  32    |     ...       |
  33
  34 MC requires the memory to be aligned with 512MB, so even debug server is
  35 not enabled, 512MB is reserved, not 256MB.
  36
  37 Flash Layout
  38 ============
  39
  40 (1) A typical layout of various images (including Linux and other firmware images)
  41    is shown below considering a 32MB NOR flash device present on most
  42    pre-silicon platforms (simulator and emulator):
  43
  44         -------------------------
  45         |       FIT Image       |
  46         | (linux + DTB + RFS)   |
  47         ------------------------- ----> 0x0120_0000
  48         |       Debug Server FW |
  49         ------------------------- ----> 0x00C0_0000
  50         |       AIOP FW         |
  51         ------------------------- ----> 0x0070_0000
  52         |       MC FW           |
  53         ------------------------- ----> 0x006C_0000
  54         |       MC DPL Blob     |
  55         ------------------------- ----> 0x0020_0000
  56         |       BootLoader + Env|
  57         ------------------------- ----> 0x0000_1000
  58         |       PBI             |
  59         ------------------------- ----> 0x0000_0080
  60         |       RCW             |
  61         ------------------------- ----> 0x0000_0000
  62
  63         32-MB NOR flash layout for pre-silicon platforms (simulator and emulator)
  64
  65 (2) A typical layout of various images (including Linux and other firmware images)
  66     is shown below considering a 128MB NOR flash device present on QDS and RDB
  67     boards:
  68         ----------------------------------------- ----> 0x5_8800_0000 ---
  69         |       .. Unused .. (7M)               |                       |
  70         ----------------------------------------- ----> 0x5_8790_0000   |
  71         | FIT Image (linux + DTB + RFS) (40M)   |                       |
  72         ----------------------------------------- ----> 0x5_8510_0000   |
  73         |       PHY firmware (2M)               |                       |
  74         ----------------------------------------- ----> 0x5_84F0_0000   | 64K
  75         |       Debug Server FW (2M)            |                       | Alt
  76         ----------------------------------------- ----> 0x5_84D0_0000   | Bank
  77         |       AIOP FW (4M)                    |                       |
  78         ----------------------------------------- ----> 0x5_8490_0000 (vbank4)
  79         |       MC DPC Blob (1M)                |                       |
  80         ----------------------------------------- ----> 0x5_8480_0000   |
  81         |       MC DPL Blob (1M)                |                       |
  82         ----------------------------------------- ----> 0x5_8470_0000   |
  83         |       MC FW (4M)                      |                       |
  84         ----------------------------------------- ----> 0x5_8430_0000   |
  85         |       BootLoader Environment (1M)     |                       |
  86         ----------------------------------------- ----> 0x5_8420_0000   |
  87         |       BootLoader (1M)                 |                       |
  88         ----------------------------------------- ----> 0x5_8410_0000   |
  89         |       RCW and PBI (1M)                |                       |
  90         ----------------------------------------- ----> 0x5_8400_0000 ---
  91         |       .. Unused .. (7M)               |                       |
  92         ----------------------------------------- ----> 0x5_8390_0000   |
  93         | FIT Image (linux + DTB + RFS) (40M)   |                       |
  94         ----------------------------------------- ----> 0x5_8110_0000   |
  95         |       PHY firmware (2M)               |                       |
  96         ----------------------------------------- ----> 0x5_80F0_0000   | 64K
  97         |       Debug Server FW (2M)            |                       | Bank
  98         ----------------------------------------- ----> 0x5_80D0_0000   |
  99         |       AIOP FW (4M)                    |                       |
 100         ----------------------------------------- ----> 0x5_8090_0000 (vbank0)
 101         |       MC DPC Blob (1M)                |                       |
 102         ----------------------------------------- ----> 0x5_8080_0000   |
 103         |       MC DPL Blob (1M)                |                       |
 104         ----------------------------------------- ----> 0x5_8070_0000   |
 105         |       MC FW (4M)                      |                       |
 106         ----------------------------------------- ----> 0x5_8030_0000   |
 107         |       BootLoader Environment (1M)     |                       |
 108         ----------------------------------------- ----> 0x5_8020_0000   |
 109         |       BootLoader (1M)                 |                       |
 110         ----------------------------------------- ----> 0x5_8010_0000   |
 111         |       RCW and PBI (1M)                |                       |
 112         ----------------------------------------- ----> 0x5_8000_0000 ---
 113
 114         128-MB NOR flash layout for QDS and RDB boards
 115
 116 Environment Variables
 117 =====================
 118 mcboottimeout:  MC boot timeout in milliseconds. If this variable is not defined
 119                 the value CONFIG_SYS_LS_MC_BOOT_TIMEOUT_MS will be assumed.
 120
 121 mcmemsize:      MC DRAM block size. If this variable is not defined, the value
 122                 CONFIG_SYS_LS_MC_DRAM_BLOCK_MIN_SIZE will be assumed.
 123
 124 Booting from NAND
 125 -------------------
 126 Booting from NAND requires two images, RCW and u-boot-with-spl.bin.
 127 The difference between NAND boot RCW image and NOR boot image is the PBI
 128 command sequence. Below is one example for PBI commands for QDS which uses
 129 NAND device with 2KB/page, block size 128KB.
 130
 131 1) CCSR 4-byte write to 0x00e00404, data=0x00000000
 132 2) CCSR 4-byte write to 0x00e00400, data=0x1800a000
 133 The above two commands set bootloc register to 0x00000000_1800a000 where
 134 the u-boot code will be running in OCRAM.
 135
 136 3) Block Copy: SRC=0x0107, SRC_ADDR=0x00020000, DEST_ADDR=0x1800a000,
 137 BLOCK_SIZE=0x00014000
 138 This command copies u-boot image from NAND device into OCRAM. The values need
 139 to adjust accordingly.
 140
 141 SRC             should match the cfg_rcw_src, the reset config pins. It depends
 142                 on the NAND device. See reference manual for cfg_rcw_src.
 143 SRC_ADDR        is the offset of u-boot-with-spl.bin image in NAND device. In
 144                 the example above, 128KB. For easy maintenance, we put it at
 145                 the beginning of next block from RCW.
 146 DEST_ADDR       is fixed at 0x1800a000, matching bootloc set above.
 147 BLOCK_SIZE      is the size to be copied by PBI.
 148
 149 RCW image should be written to the beginning of NAND device. Example of using
 150 u-boot command
 151
 152 nand write <rcw image in memory> 0 <size of rcw image>
 153
 154 To form the NAND image, build u-boot with NAND config, for example,
 155 ls2085aqds_nand_defconfig. The image needed is u-boot-with-spl.bin.
 156 The u-boot image should be written to match SRC_ADDR, in above example 0x20000.
 157
 158 nand write <u-boot image in memory> 200000 <size of u-boot image>
 159
 160 With these two images in NAND device, the board can boot from NAND.
 161
 162 Another example for RDB boards,
 163
 164 1) CCSR 4-byte write to 0x00e00404, data=0x00000000
 165 2) CCSR 4-byte write to 0x00e00400, data=0x1800a000
 166 3) Block Copy: SRC=0x0119, SRC_ADDR=0x00080000, DEST_ADDR=0x1800a000,
 167 BLOCK_SIZE=0x00014000
 168
 169 nand write <rcw image in memory> 0 <size of rcw image>
 170 nand write <u-boot image in memory> 80000 <size of u-boot image>
 171
 172 Notice the difference from QDS is SRC, SRC_ADDR and the offset of u-boot image
 173 to match board NAND device with 4KB/page, block size 512KB.