board/theobroma-systems/puma_rk3399/README

   1 Introduction
   2 ============
   3
   4 The RK3399-Q7 (Puma) is a system-on-module featuring the Rockchip
   5 RK3399 in a Qseven-compatible form-factor.
   6
   7 RK3399-Q7 features:
   8         * CPU: ARMv8 64bit Big-Little architecture,
   9                 * Big: dual-core Cortex-A72
  10                 * Little: quad-core Cortex-A53
  11                 * IRAM: 200KB
  12         * DRAM: 4GB-128MB dual-channel
  13         * eMMC: onboard eMMC
  14         * SD/MMC
  15         * GbE (onboard Micrel KSZ9031) Gigabit ethernet PHY
  16         * USB:
  17                 * USB3.0 dual role port
  18                 * 2x USB3.0 host, 1x USB2.0 host via onboard USB3.0 hub
  19         * Display: HDMI/eDP/MIPI
  20         * Camera: 2x CSI (one on the edge connector, one on the Q7 specified CSI ZIF)
  21         * NOR Flash: onboard SPI NOR
  22         * Companion Controller: onboard additional Cortex-M0 microcontroller
  23                 * RTC
  24                 * fan controller
  25                 * CAN
  26
  27 Here is the step-by-step to boot to U-Boot on rk3399.
  28
  29 Get the Source and build ATF/Cortex-M0 binaries
  30 ===============================================
  31
  32   > git clone git://git.theobroma-systems.com/arm-trusted-firmware.git
  33   > git clone git://git.theobroma-systems.com/rk3399-cortex-m0.git
  34
  35 Compile the ATF
  36 ===============
  37
  38   > cd arm-trusted-firmware
  39   > make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 bl31
  40   > cp build/rk3399/release/bl31.bin ../u-boot/bl31-rk3399.bin
  41
  42 Compile the M0 firmware
  43 =======================
  44
  45   > cd ../rk3399-cortex-m0
  46   > make CROSS_COMPILE=arm-cortex_m0-eabi-
  47   > cp rk3399m0.bin ../u-boot
  48
  49 Compile the U-Boot
  50 ==================
  51
  52   > cd ../u-boot
  53   > make CROSS_COMPILE=aarch64-linux-gnu- puma-rk3399_defconfig all
  54
  55 Package the image
  56 =================
  57
  58 Creating a SPL image for SD-Card/eMMC
  59   > tools/mkimage -n rk3399 -T rksd -d spl/u-boot-spl.bin spl_mmc.img
  60 Creating a SPL image for SPI-NOR
  61   > tools/mkimage -n rk3399 -T rkspi -d spl/u-boot-spl.bin spl_nor.img
  62 Create the FIT image containing U-Boot proper, ATF, M0 Firmware, devicetree
  63   > make CROSS_COMPILE=aarch64-linux-gnu- u-boot.itb
  64
  65 Flash the image
  66 ===============
  67
  68 Copy the SPL to offset 32k for SD/eMMC, offset 0 for NOR-Flash and the FIT
  69 image to offset 256k card.
  70
  71 SD-Card
  72 -------
  73
  74   > dd if=spl_mmc.img of=/dev/sdb seek=64
  75   > dd if=u-boot.itb of=/dev/sdb seek=512
  76
  77 eMMC
  78 ----
  79
  80 rkdeveloptool allows to flash the on-board eMMC via the USB OTG interface with
  81 help of the Rockchip loader binary.
  82
  83   > git clone https://github.com/rockchip-linux/rkdeveloptool
  84   > cd rkdeveloptool
  85   > autoreconf -i && ./configure && make
  86   > git clone https://github.com/rockchip-linux/rkbin.git
  87   > ./rkdeveloptool db rkbin/rk33/rk3399_loader_v1.08.106.bin
  88   > ./rkdeveloptool wl 64 ../spl_mmc.img
  89   > ./rkdeveloptool wl 512 ../u-boot.itb
  90
  91 NOR-Flash
  92 ---------
  93
  94 Writing the SPI NOR Flash requires a running U-Boot. For the sake of simplicity
  95 we assume you have a SD-Card with a partition containing the required files
  96 ready.
  97
  98   > load mmc 1:1 ${kernel_addr_r} spl_nor.img
  99   > sf probe
 100   > sf erase 0 +$filesize
 101   > sf write $kernel_addr_r 0 ${filesize}
 102   > load mmc 1:1 ${kernel_addr_r} u-boot.itb
 103   > sf erase 0x40000 +$filesize
 104   > sf write $kernel_addr_r 0x40000 ${filesize}
 105
 106
 107 Reboot the system and you should see a U-Boot console on UART0 (115200n8).