# SPDX-License-Identifier: GPL-2.0+
#
# (C) Copyright 2017 Jorge Ramirez-Ortiz <jorge.ramirez-ortiz@linaro.org>

================================================================================
             What is working (enough to boot a distro from SD card)
================================================================================
   - UART
   - SD card
   - PSCI reset
   - Environment in EXT4 partition 1 in SD card (check defconfig for details)
         dont forget to insert the card in the SD slot before booting if you
         are going to make mods to the environment

================================================================================
                     Build & Run instructions
================================================================================

1) Install mkbootimg

2) Setup CROSS_COMPILE to aarch64 compiler or if you use ccache just do
   CROSS_COMPILE="ccache aarch64-linux-gnu-"

3) cd to the u-boot tree

  $ make dragonboard820c_config
  $ make -j `nproc`

4) generate fake, empty ramdisk (can have 0 bytes)

   $ touch rd

5) Append the dtb to the u-boot binary discarding the internal dtb.

   $ gzip u-boot-nodtb.bin
   $ cat u-boot.dtb >> u-boot-nodtb.bin.gz

6) Generate Android boot image with mkbootimg:

   $ mkbootimg --kernel=u-boot-nodtb.bin.gz          \
               --output=u-boot.img                 \
               --pagesize 4096                     \
               --base 0x80000000                   \
               --ramdisk=rd                        \
               --cmdline=""

7) Reboot the board into fastboot mode
   - plug the board micro-usb to your laptop usb host.
   - reboot the board with vol- button pressed

8) Boot the uboot image using fastboot

   $ fastboot boot u-boot.img

   or flash it to the UFS drive boot partition:

   $ fastboot flash boot u-boot.img
   $ fastboot reboot


================================================================================
      To boot a linux kernel from SDHCI with the ROOTFS on an NFS share:
================================================================================

1) create an EXT4 partition on the SD card (must be partition #1)

2) build the kernel image and dtb  (documented extensively somewhere else)

3) copy the drivers to the NFS partition (ie: 192.168.1.2 /exports/db820c-rootfs)

4) add the u-boot headers to the image:

    $ mkimage -A arm64                                     \
              -O linux                                     \
              -C none                                      \
              -T kernel                                    \
              -a 0x80080000                                \
              -e 0x80080000                                \
              -n Dragonboard820c                           \
              -d $kernel/arch/arm64/boot/Image             \
              uImage

5) copy the generated uImage and the device tree binary to the SD card EXT4
   partition

    $ cp uImage /mnt/boot/
    $ cp apq8096-db820c.dtb /mnt/boot/

6) on the SD card create /extlinux/extlinux.conf  as follows:

   default nfs
   prompt 1
   timeout 10

   LABEL nfs
      MENU NFS entry
      LINUX /uImage
      FDT /apq8096-db820c.dtb
      APPEND root=/dev/nfs rw                                         \
             nfsroot=192.168.1.2:/exports/db829c-rootfs,v3,tcp        \
             rootwait                                                 \
             ip=dhcp consoleblank=0                                   \
             console=tty0                                             \
             console=ttyMSM0,115200n8                                 \
             earlyprintk earlycon=msm_serial_dm,0x75b0000             \
             androidboot.bootdevice=624000.ufshc                      \
             androidboot.verifiedbootstate=orange                     \
             androidboot.ver0

7) remove the SD card from the laptop and insert it back to the db820 board.
   the SD card EXT4 partition#1 should contain:
      /uImage
      /apq8096-db820c.dtb
      /extlinux/extlinux.conf

8) reboot the db820 board

================================================================================
                    Successful boot sequence
================================================================================

Format: Log Type - Time(microsec) - Message - Optional Info
Log Type: B - Since Boot(Power On Reset),  D - Delta,  S - Statistic
S - QC_IMAGE_VERSION_STRING=BOOT.XF.1.0-00301
S - IMAGE_VARIANT_STRING=M8996LAB
S - OEM_IMAGE_VERSION_STRING=crm-ubuntu68
S - Boot Interface: UFS
S - Secure Boot: Off
S - Boot Config @ 0x00076044 = 0x000001c9
S - JTAG ID @ 0x000760f4 = 0x4003e0e1
S - OEM ID @ 0x000760f8 = 0x00000000
S - Serial Number @ 0x00074138 = 0x2e8844ce
S - OEM Config Row 0 @ 0x00074188 = 0x0000000000000000
S - OEM Config Row 1 @ 0x00074190 = 0x0000000000000000
S - Feature Config Row 0 @ 0x000741a0 = 0x0050000010000100
S - Feature Config Row 1 @ 0x000741a8 = 0x00fff00001ffffff
S - Core 0 Frequency, 1228 MHz
B -         0 - PBL, Start
B -     10412 - bootable_media_detect_entry, Start
B -     47480 - bootable_media_detect_success, Start
B -     47481 - elf_loader_entry, Start
B -     49027 - auth_hash_seg_entry, Start
B -     49129 - auth_hash_seg_exit, Start
B -     82403 - elf_segs_hash_verify_entry, Start
B -     84905 - PBL, End
B -     86955 - SBL1, Start
B -    182969 - usb: hs_phy_nondrive_start
B -    183305 - usb: PLL lock success - 0x3
B -    186294 - usb: hs_phy_nondrive_finish
B -    190442 - boot_flash_init, Start
D -        30 - boot_flash_init, Delta
B -    197548 - sbl1_ddr_set_default_params, Start
D -        30 - sbl1_ddr_set_default_params, Delta
B -    205509 - boot_config_data_table_init, Start
D -    200659 - boot_config_data_table_init, Delta - (60 Bytes)
B -    410713 - CDT Version:3,Platform ID:24,Major ID:1,Minor ID:0,Subtype:0
B -    415410 - Image Load, Start
D -     22570 - PMIC Image Loaded, Delta - (37272 Bytes)
B -    437980 - pm_device_init, Start
B -    443744 - PON REASON:PM0:0x200000061 PM1:0x200000021
B -    480161 - PM_SET_VAL:Skip
D -     40016 - pm_device_init, Delta
B -    482083 - pm_driver_init, Start
D -      2928 - pm_driver_init, Delta
B -    488671 - pm_sbl_chg_init, Start
D -        91 - pm_sbl_chg_init, Delta
B -    495442 - vsense_init, Start
D -         0 - vsense_init, Delta
B -    505171 - Pre_DDR_clock_init, Start
D -       396 - Pre_DDR_clock_init, Delta
B -    509045 - ddr_initialize_device, Start
B -    512766 - 8996 v3.x detected, Max frequency = 1.8 GHz
B -    522373 - ddr_initialize_device, Delta
B -    522404 - DDR ID, Rank 0, Rank 1, 0x6, 0x300, 0x300
B -    526247 - Basic DDR tests done
B -    594994 - clock_init, Start
D -       274 - clock_init, Delta
B -    598349 - Image Load, Start
D -      4331 - QSEE Dev Config Image Loaded, Delta - (46008 Bytes)
B -    603808 - Image Load, Start
D -      5338 - APDP Image Loaded, Delta - (0 Bytes)
B -    612409 - usb: UFS Serial - 2f490ecf
B -    616801 - usb: fedl, vbus_low
B -    620431 - Image Load, Start
D -     55418 - QSEE Image Loaded, Delta - (1640572 Bytes)
B -    675849 - Image Load, Start
D -      2013 - SEC Image Loaded, Delta - (4096 Bytes)
B -    683413 - sbl1_efs_handle_cookies, Start
D -       457 - sbl1_efs_handle_cookies, Delta
B -    691892 - Image Load, Start
D -     14396 - QHEE Image Loaded, Delta - (254184 Bytes)
B -    706319 - Image Load, Start
D -     14061 - RPM Image Loaded, Delta - (223900 Bytes)
B -    721111 - Image Load, Start
D -      3233 - STI Image Loaded, Delta - (0 Bytes)
B -    727913 - Image Load, Start
D -     34709 - APPSBL Image Loaded, Delta - (748716 Bytes)
B -    762713 - SBL1, End
D -    680028 - SBL1, Delta
S - Flash Throughput, 94000 KB/s  (2959024 Bytes,  31250 us)
S - DDR Frequency, 1017 MHz
Android Bootloader - UART_DM Initialized!!!

[0] BUILD_VERSION=
[0] BUILD_DATE=16:07:51 - Nov 17 2017
[0] welcome to lk
[10] platform_init()
[10] target_init()
[10] RPM GLink Init
[10] Opening RPM Glink Port success
[10] Opening SSR Glink Port success
[20] Glink Connection between APPS and RPM established
[20] Glink Connection between APPS and RPM established
[40] UFS init success
[80] Qseecom Init Done in Appsbl
[80] secure app region addr=0x86600000 size=0x2200000[90] TZ App region notif returned with status:0 addr:86600000 size:35651584
[100] TZ App log region register returned with status:0 addr:916d4000 size:4096
[100] Qseecom TZ Init Done in Appsbl
[120] Loading cmnlib done
[120] qseecom_start_app: Loading app keymaster for the first time
[150] <8>keymaster: "\"KEYMASTER Init \""
[160] Selected panel: none
Skip panel configuration
[160] pm8x41_get_is_cold_boot: cold boot
[170] boot_verifier: Device is in ORANGE boot state.
[180] Device is unlocked! Skipping verification...
[180] Loading (boot) image (348160): start
[190] Loading (boot) image (348160): done
[190] use_signed_kernel=1, is_unlocked=1, is_tampered=0.
[200] Your device has been unlocked and cant be trusted.
Wait for 5 seconds before proceeding

[5200] mdtp: mdtp_img loaded
[5210] mdtp: is_test_mode: test mode is set to 1
[5210] mdtp: read_metadata: SUCCESS
[5230] LK SEC APP Handle: 0x1
[5230] Return value from recv_data: 14
[5240] Return value from recv_data: 14
[5250] Return value from recv_data: 14
[5260] DTB Total entry: 1, DTB version: 3
[5260] Using DTB entry 0x00000123/00000000/0x00000018/0 for device 0x00000123/00030001/0x00010018/0
[5270] cmdline:  androidboot.bootdevice=624000.ufshc androidboot.verifiedbootstate=orange androidboot.veritymode=enforcing androidboot.serialno=2f490ecf androidboot.baseband=apq mdss_mdp.panel=0
[5290] Updating device tree: start
[5290] Updating device tree: done
[5290] Return value from recv_data: 14
[5300] RPM GLINK UnInit
[5300] Qseecom De-Init Done in Appsbl
[5300] booting linux @ 0x80080000, ramdisk @ 0x82200000 (0), tags/device tree @ 0x82000000
[5310] Jumping to kernel via monitor

U-Boot 2025.04-rc5-00020-g40a61ca0e7eb-dirty (Apr 07 2025 - 09:37:03 +0200)
Qualcomm-DragonBoard 820C

DRAM:  3.5 GiB (effective 3 GiB)
Core:  136 devices, 18 uclasses, devicetree: board
MMC:   Bulk clocks not available (-19), trying core clock
mmc@74a4900: 0
Loading Environment from EXT4... OK
In:    serial@75b0000
Out:   serial@75b0000
Err:   serial@75b0000
Net:   No ethernet found.
Hit any key to stop autoboot:  0
switch to partitions #0, OK
mmc0 is current device
Scanning mmc 0:1...
Found /extlinux/extlinux.conf
Retrieving file: /extlinux/extlinux.conf
1:      nfs root
Enter choice: 1:        nfs root
Retrieving file: /uImage
append: root=/dev/nfs rw nfsroot=192.168.1.6:/home/jramirez/Src/qualcomm-lt/db820c/rootfs,v3,tcp rootwait ip=dhcp consoleblank=0 console=tty0 console=ttyMSM0,115200n8 earlyprintk earlyco0
Retrieving file: /apq8096-db820c.dtb
## Booting kernel from Legacy Image at 155000000 ...
   Image Name:   Dragonboard820c
   Image Type:   AArch64 Linux Kernel Image (uncompressed)
   Data Size:    19397120 Bytes = 18.5 MiB
   Load Address: 80080000
   Entry Point:  80080000
   Verifying Checksum ... OK
## Flattened Device Tree blob at 148600000
   Booting using the fdt blob at 0x148600000
Working FDT set to 148600000
   Loading Kernel Image to 80080000
   Using Device Tree in place at 0000000148600000, end 000000014860c4f5
Working FDT set to 148600000

Starting kernel ...

[    0.000000] Booting Linux on physical CPU 0x0
[    0.000000] Linux version 4.11.3-30039-g5a922a1 (jramirez@igloo) (gcc version 6.3.1 20170404 (Linaro GCC 6.3-2017.05) ) #1 SMP PREEMPT Wed Oct 18 10:21:11 CEST 2017
[    0.000000] Boot CPU: AArch64 Processor [511f2112]
[    0.000000] earlycon: msm_serial_dm0 at MMIO 0x00000000075b0000 (options '')
[    0.000000] bootconsole [msm_serial_dm0] enabled
[    0.000000] efi: Getting EFI parameters from FDT:
[    0.000000] efi: UEFI not found.
[    0.000000] OF: reserved mem: OVERLAP DETECTED!
[    0.000000] adsp@8ea00000 (0x000000008ea00000--0x0000000090400000) overlaps with gpu@8f200000 (0x000000008f200000--0x000000008f300000)
[    0.000000] Reserved memory: created DMA memory pool at 0x000000008f200000, size 1 MiB
[    0.000000] OF: reserved mem: initialized node gpu@8f200000, compatible id shared-dma-pool
[    0.000000] Reserved memory: created DMA memory pool at 0x0000000090400000, size 8 MiB
[    0.000000] OF: reserved mem: initialized node venus@90400000, compatible id shared-dma-pool
[    0.000000] cma: Reserved 128 MiB at 0x00000000b8000000
[    0.000000] NUMA: No NUMA configuration found
[    0.000000] NUMA: Faking a node at [mem 0x0000000000000000-0x00000000bfffffff]
[    0.000000] NUMA: Adding memblock [0x80000000 - 0x857fffff] on node 0
[    0.000000] NUMA: Adding memblock [0x91800000 - 0xbfffffff] on node 0
[    0.000000] NUMA: Initmem setup node 0 [mem 0x80000000-0xbfffffff]
[    0.000000] NUMA: NODE_DATA [mem 0xb7fb6680-0xb7fb817f]
[    0.000000] Zone ranges:
[    0.000000]   DMA      [mem 0x0000000080000000-0x00000000bfffffff]
[    0.000000]   Normal   empty
[    0.000000] Movable zone start for each node
[    0.000000] Early memory node ranges
[    0.000000]   node   0: [mem 0x0000000080000000-0x00000000857fffff]
[    0.000000]   node   0: [mem 0x0000000091800000-0x00000000bfffffff]
[    0.000000] Initmem setup node 0 [mem 0x0000000080000000-0x00000000bfffffff]
[    0.000000] psci: probing for conduit method from DT.
[    0.000000] psci: PSCIv1.0 detected in firmware.
[    0.000000] psci: Using standard PSCI v0.2 function IDs
[    0.000000] psci: MIGRATE_INFO_TYPE not supported.
[    0.000000] percpu: Embedded 23 pages/cpu @ffff8000de9a3000 s57240 r8192 d28776 u94208
[    0.000000] pcpu-alloc: s57240 r8192 d28776 u94208 alloc=23*4096
[    0.000000] pcpu-alloc: [0] 0 [0] 1 [0] 2 [0] 3
[    0.000000] Detected PIPT I-cache on CPU0
[    0.000000] Built 1 zonelists in Node order, mobility grouping on.  Total pages: 720293
[    0.000000] Policy zone: Normal
[    0.000000] Kernel command line: root=/dev/nfs rw nfsroot=192.168.1.2:/db820c/rootfs,v3,tcp rootwait ip=dhcp consoleblank=0
console=tty0 console=ttyMSM0,115200n8 earlyprintk earlycon=msm_serial_dm,0x75b0000 androidboot.bootdevice=624000.ufshc androidboot.verifiedbootstate=orange a
ndroidboot.ver0
[    0.000000] PID hash table entries: 4096 (order: 3, 32768 bytes)
[    0.000000] software IO TLB [mem 0xd3fff000-0xd7fff000] (64MB) mapped at [ffff800053fff000-ffff800057ffefff]
[    0.000000] Memory: 2644172K/2926908K available (11196K kernel code, 1470K rwdata, 5132K rodata, 1088K init, 449K bss, 151664K reserved, 131072K cma-reser
ved)
[    0.000000] Virtual kernel memory layout:
[    0.000000]     modules : 0xffff000000000000 - 0xffff000008000000   (   128 MB)
[    0.000000]     vmalloc : 0xffff000008000000 - 0xffff7dffbfff0000   (129022 GB)
[    0.000000]       .text : 0xffff000008080000 - 0xffff000008b70000   ( 11200 KB)
[    0.000000]     .rodata : 0xffff000008b70000 - 0xffff000009080000   (  5184 KB)
[    0.000000]       .init : 0xffff000009080000 - 0xffff000009190000   (  1088 KB)
[    0.000000]       .data : 0xffff000009190000 - 0xffff0000092ffa00   (  1471 KB)
[    0.000000]        .bss : 0xffff0000092ffa00 - 0xffff00000937014c   (   450 KB)
[    0.000000]     fixed   : 0xffff7dfffe7fd000 - 0xffff7dfffec00000   (  4108 KB)
[    0.000000]     PCI I/O : 0xffff7dfffee00000 - 0xffff7dffffe00000   (    16 MB)
[    0.000000]     vmemmap : 0xffff7e0000000000 - 0xffff800000000000   (  2048 GB maximum)
[    0.000000]               0xffff7e0000000000 - 0xffff7e00037a93c0   (    55 MB actual)
[    0.000000]     memory  : 0xffff800000000000 - 0xffff8000dea4f000   (  3562 MB)
[    0.000000] SLUB: HWalign=128, Order=0-3, MinObjects=0, CPUs=4, Nodes=1
[    0.000000] Preemptible hierarchical RCU implementation.
[    0.000000]  Build-time adjustment of leaf fanout to 64.
[    0.000000]  RCU restricting CPUs from NR_CPUS=64 to nr_cpu_ids=4.
[    0.000000] RCU: Adjusting geometry for rcu_fanout_leaf=64, nr_cpu_ids=4
[    0.000000] NR_IRQS:64 nr_irqs:64 0
[    0.000000] GICv3: CPU0: found redistributor 0 region 0:0x0000000009c00000
[    0.000000] GICv2m: range[mem 0x09bd0000-0x09bd0fff], SPI[544:639]
[    0.000000] arm_arch_timer: Architected cp15 and mmio timer(s) running at 19.20MHz (virt/virt).
[    0.000000] clocksource: arch_sys_counter: mask: 0xffffffffffffff max_cycles: 0x46d987e47, max_idle_ns: 440795202767 ns
[    0.000002] sched_clock: 56 bits at 19MHz, resolution 52ns, wraps every 4398046511078ns

[....]


Some kernel information:

root@linaro-developer:~# cat /proc/cpuinfo
processor       : 0
BogoMIPS        : 38.40
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
CPU implementer : 0x51
CPU architecture: 8
CPU variant     : 0x1
CPU part        : 0x211
CPU revision    : 2

processor       : 1
BogoMIPS        : 38.40
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
CPU implementer : 0x51
CPU architecture: 8
CPU variant     : 0x1
CPU part        : 0x211
CPU revision    : 2

processor       : 2
BogoMIPS        : 38.40
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
CPU implementer : 0x51
CPU architecture: 8
CPU variant     : 0x1
CPU part        : 0x205
CPU revision    : 2

processor       : 3
BogoMIPS        : 38.40
Features        : fp asimd evtstrm aes pmull sha1 sha2 crc32 cpuid
CPU implementer : 0x51
CPU architecture: 8
CPU variant     : 0x1
CPU part        : 0x205
CPU revision    : 2

root@linaro-developer:~# uname -a
Linux linaro-developer 4.11.3-30039-g5a922a1 #1 SMP PREEMPT Wed Oct 18 10:21:11 CEST 2017 aarch64 GNU/Linux

root@linaro-developer:~# cat /proc/cmdline
root=/dev/nfs rw nfsroot=192.168.1.2:/db820c/rootfs,v3,tcp rootwait ip=dhcp consoleblank=0 console=tty0 console=ttyMSM0,115200n8 earlyprintk earlycon=msm_serial_dm,0x75b0000 androidboot.bootdevice=624000.ufshc androidboot.verifiedbootstate=orange androidboot.ver0

root@linaro-developer:~# cat /proc/meminfo
MemTotal:        2776332 kB
MemFree:         2593696 kB
MemAvailable:    2561432 kB
Buffers:               0 kB
Cached:            94744 kB
SwapCached:            0 kB
Active:            43888 kB
Inactive:          72972 kB
Active(anon):      22968 kB
Inactive(anon):    24616 kB
Active(file):      20920 kB
Inactive(file):    48356 kB
Unevictable:           0 kB
Mlocked:               0 kB
SwapTotal:             0 kB
SwapFree:              0 kB
Dirty:                 0 kB
Writeback:             0 kB
AnonPages:         22120 kB
Mapped:            29284 kB
Shmem:             25468 kB
Slab:              32876 kB
SReclaimable:      12924 kB
SUnreclaim:        19952 kB
KernelStack:        2144 kB
PageTables:          928 kB
NFS_Unstable:          0 kB
Bounce:                0 kB
WritebackTmp:          0 kB
CommitLimit:     1388164 kB
Committed_AS:     204192 kB
VmallocTotal:   135290290112 kB
VmallocUsed:           0 kB
VmallocChunk:          0 kB
AnonHugePages:      2048 kB
ShmemHugePages:        0 kB
ShmemPmdMapped:        0 kB
CmaTotal:         131072 kB
CmaFree:          130356 kB
HugePages_Total:       0
HugePages_Free:        0
HugePages_Rsvd:        0
HugePages_Surp:        0
Hugepagesize:       2048 kB
