amlogic: g12a: Add support for the S905X2 (G12A) platform
[project/bcm63xx/atf.git] / docs / plat / meson-g12a.rst
1 Amlogic Meson S905X2 (G12A)
2 ==========================
3
4 The Amlogic Meson S905X2 is a SoC with a quad core Arm Cortex-A53 running at
5 ~1.8GHz. It also contains a Cortex-M3 used as SCP.
6
7 This port is a minimal implementation of BL31 capable of booting mainline U-Boot
8 and Linux:
9
10 - SCPI support.
11 - Basic PSCI support (CPU_ON, CPU_OFF, SYSTEM_RESET, SYSTEM_OFF). Note that CPU0
12 can't be turned off, so there is a workaround to hide this from the caller.
13 - GICv2 driver set up.
14 - Basic SIP services (read efuse data, enable/disable JTAG).
15
16 In order to build it:
17
18 .. code:: shell
19
20 CROSS_COMPILE=aarch64-linux-gnu- make DEBUG=1 PLAT=g12a
21
22 This port has been tested on a SEI510 board. After building it, follow the
23 instructions in the `gxlimg repository` or `U-Boot repository`_, replacing the
24 mentioned **bl31.img** by the one built from this port.
25
26 .. _gxlimg repository: https://github.com/repk/gxlimg/blob/master/README.g12a
27 .. _U-Boot repository: https://github.com/u-boot/u-boot/blob/master/board/amlogic/sei510/README