Merge branch 'for-2023.07' of https://source.denx.de/u-boot/custodians/u-boot-mpc8xx
[platform/kernel/u-boot.git] / doc / board / amlogic / beelink-gtkingpro.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 U-Boot for Beelink GT-King Pro (S922X)
4 ======================================
5
6 The Shenzen AZW (Beelink) GT-King Pro is based on the Amlogic W400 reference board with
7 an S922X-H chip and the following specifications:
8
9 - 4GB LPDDR4 RAM
10 - 64GB eMMC storage
11 - 10/100/1000 Base-T Ethernet
12 - AP6356S Wireless (802.11 a/b/g/n/ac, BT 4.1)
13 - HDMI 2.1 video
14 - Analogue audio output
15 - 1x RS232 port
16 - 2x USB 2.0 port
17 - 2x USB 3.0 ports
18 - IR receiver
19 - 1x SD card slot
20 - 1x Power on/off button
21
22 Beelink do not provide public schematics, but have been willing to share them with known  
23 distro developers to assist with development.
24
25 U-Boot Compilation
26 ------------------
27
28 .. code-block:: bash
29
30     $ export CROSS_COMPILE=aarch64-none-elf-
31     $ make beelink-gtkingpro_defconfig
32     $ make
33
34 U-Boot Signing with Pre-Built FIP repo
35 --------------------------------------
36
37 .. code-block:: bash
38
39     $ git clone https://github.com/LibreELEC/amlogic-boot-fip --depth=1
40     $ cd amlogic-boot-fip
41     $ mkdir my-output-dir
42     $ ./build-fip.sh beelink-s922x /path/to/u-boot/u-boot.bin my-output-dir
43
44 U-Boot Manual Signing
45 ---------------------
46
47 Beelink released an Amlogic "SDK" dump in their forums, but the U-Boot sources included
48 result in 2GB RAM detected. The following FIPs were generated with newer sources and
49 detect 4GB RAM: https://github.com/LibreELEC/amlogic-boot-fip/tree/master/beelink-s922x
50
51 .. code-block:: bash
52
53     $ wget https://github.com/LibreELEC/amlogic-boot-fip/archive/master.zip
54     $ unzip master.zip
55     $ export FIPDIR=$PWD/amlogic-boot-fip/beelink-s922x
56
57 Go back to the mainline U-Boot source tree then:
58
59 .. code-block:: bash
60
61     $ mkdir fip
62     $ cp $FIPDIR/* fip/
63     $ cp u-boot.bin fip/bl33.bin
64
65     $ sh fip/blx_fix.sh \
66          fip/bl30.bin \
67          fip/zero_tmp \
68          fip/bl30_zero.bin \
69          fip/bl301.bin \
70          fip/bl301_zero.bin \
71          fip/bl30_new.bin \
72          bl30
73
74     $ sh fip/blx_fix.sh \
75          fip/bl2.bin \
76          fip/zero_tmp \
77          fip/bl2_zero.bin \
78          fip/acs.bin \
79          fip/bl21_zero.bin \
80          fip/bl2_new.bin \
81          bl2
82
83     $ fip/aml_encrypt_g12b --bl30sig --input fip/bl30_new.bin \
84                            --output fip/bl30_new.bin.g12a.enc \
85                            --level v3
86     $ fip/aml_encrypt_g12b --bl3sig --input fip/bl30_new.bin.g12a.enc \
87                            --output fip/bl30_new.bin.enc \
88                            --level v3 --type bl30
89     $ fip/aml_encrypt_g12b --bl3sig --input fip/bl31.img \
90                            --output fip/bl31.img.enc \
91                            --level v3 --type bl31
92     $ fip/aml_encrypt_g12b --bl3sig --input fip/bl33.bin --compress lz4 \
93                            --output fip/bl33.bin.enc \
94                            --level v3 --type bl33
95     $ fip/aml_encrypt_g12b --bl2sig --input fip/bl2_new.bin \
96                            --output fip/bl2.n.bin.sig
97     $ fip/aml_encrypt_g12b --bootmk \
98                            --output fip/u-boot.bin \
99                            --bl2 fip/bl2.n.bin.sig \
100                            --bl30 fip/bl30_new.bin.enc \
101                            --bl31 fip/bl31.img.enc \
102                            --bl33 fip/bl33.bin.enc \
103                            --ddrfw1 fip/ddr4_1d.fw \
104                            --ddrfw2 fip/ddr4_2d.fw \
105                            --ddrfw3 fip/ddr3_1d.fw \
106                            --ddrfw4 fip/piei.fw \
107                            --ddrfw5 fip/lpddr4_1d.fw \
108                            --ddrfw6 fip/lpddr4_2d.fw \
109                            --ddrfw7 fip/diag_lpddr4.fw \
110                            --ddrfw8 fip/aml_ddr.fw \
111                            --level v3
112
113 Then write U-Boot to SD or eMMC with:
114
115 .. code-block:: bash
116
117     $ DEV=/dev/boot_device
118     $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
119     $ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=440