doc: boards: amlogic: update documentation for Beelink GT-King

Improve documentation.

Signed-off-by: Christian Hewitt <christianshewitt@gmail.com>
Link: https://lore.kernel.org/r/20230320114609.930145-5-christianshewitt@gmail.com
[narmstrong: fixed doc build]
Signed-off-by: Neil Armstrong <neil.armstrong@linaro.org>
This commit is contained in:
Christian Hewitt 2023-03-20 11:45:40 +00:00 committed by Neil Armstrong
parent 9e5559458e
commit f459e9033e

View File

@ -1,10 +1,10 @@
.. SPDX-License-Identifier: GPL-2.0+
U-Boot for Beelink GT-King
==========================
U-Boot for Beelink GT-King (S922X)
==================================
The Shenzen AZW (Beelink) GT-King is based on the Amlogic W400 reference
board with an S922X-H chip.
The Shenzen AZW (Beelink) GT-King is based on the Amlogic W400 reference board with an
S922X-H chip and the following specifications:
- 4GB LPDDR4 RAM
- 64GB eMMC storage
@ -18,10 +18,10 @@ board with an S922X-H chip.
- IR receiver
- 1x micro SD card slot
Beelink do not provide public schematics, but have been willing
to share them with known distro developers on request.
Beelink do not provide public schematics, but have been willing to share them with known
distro developers to assist with development.
U-Boot compilation
U-Boot Compilation
------------------
.. code-block:: bash
@ -30,21 +30,22 @@ U-Boot compilation
$ make beelink-gtking_defconfig
$ make
Image creation
--------------
U-Boot Signing with Pre-Built FIP repo
--------------------------------------
Amlogic does not provide sources for the firmware and for tools needed
to create the bootloader image. Beelink have provided the Amlogic "SDK"
in their forums, but the u-boot sources included result in 2GB RAM being
detected. The following FIPs were generated with newer private sources
and give correct (4GB) RAM detection:
.. code-block:: bash
https://github.com/LibreELEC/amlogic-boot-fip/tree/master/beelink-s922x
$ git clone https://github.com/LibreELEC/amlogic-boot-fip --depth=1
$ cd amlogic-boot-fip
$ mkdir my-output-dir
$ ./build-fip.sh beelink-s922x /path/to/u-boot/u-boot.bin my-output-dir
NB: Beelink use a common board config for GT-King, GT-King Pro and the
GS-King-X model, hence the "beelink-s922x" name.
U-Boot Manual Signing
---------------------
For simplified usage, pleaser refer to :doc:`pre-generated-fip` with codename `beelink-s922x`
Beelink released an Amlogic "SDK" dump in their forums, but the U-Boot sources included
result in 2GB RAM detected. The following FIPs were generated with newer sources and
detect 4GB RAM: https://github.com/LibreELEC/amlogic-boot-fip/tree/master/beelink-s922x
.. code-block:: bash
@ -108,10 +109,10 @@ Go back to the mainline U-Boot source tree then:
--ddrfw8 fip/aml_ddr.fw \
--level v3
and then write the image to SD with:
Then write U-Boot to SD or eMMC with:
.. code-block:: bash
$ DEV=/dev/your_sd_device
$ DEV=/dev/boot_device
$ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=512 skip=1 seek=1
$ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=444
$ dd if=fip/u-boot.bin.sd.bin of=$DEV conv=fsync,notrunc bs=1 count=440