[PATCH v2 2/2] doc: board: phytec: Add phyCORE-AM64x

[Wadim Egorov]

Am 28.02.24 um 06:45 schrieb Dhruva Gole:
> Hi,
>
> On Feb 26, 2024 at 13:23:41 +0100, Wadim Egorov wrote:
>> Add documentation for PHYTEC phyCORE-AM64x SoM.
>>
>> Signed-off-by: Wadim Egorov <w.egorov at phytec.de>
>> ---
>>   doc/board/phytec/index.rst         |   1 +
>>   doc/board/phytec/phycore-am64x.rst | 159 +++++++++++++++++++++++++++++
>>   2 files changed, 160 insertions(+)
>>   create mode 100644 doc/board/phytec/phycore-am64x.rst
>>
>> diff --git a/doc/board/phytec/index.rst b/doc/board/phytec/index.rst
>> index fea0b07620..99848a9e95 100644
>> --- a/doc/board/phytec/index.rst
>> +++ b/doc/board/phytec/index.rst
>> @@ -9,5 +9,6 @@ PHYTEC
>>      imx8mm-phygate-tauri-l
>>      imx93-phyboard-segin
>>      phycore-am62x
>> +   phycore-am64x
>>      phycore-imx8mm
>>      phycore-imx8mp
>> diff --git a/doc/board/phytec/phycore-am64x.rst b/doc/board/phytec/phycore-am64x.rst
>> new file mode 100644
>> index 0000000000..202b756dc4
>> --- /dev/null
>> +++ b/doc/board/phytec/phycore-am64x.rst
>> @@ -0,0 +1,159 @@
>> +.. SPDX-License-Identifier: GPL-2.0+
>> +.. sectionauthor:: Wadim Egorov <w.egorov at phytec.de>
>> +
>> +phyCORE-AM64x
>> +=============
>> +
>> +The `phyCORE-AM64x <https://www.phytec.com/product/phycore-am64x>`_ is a
>> +SoM (System on Module) featuring TI's AM64x SoC. It can be used in combination
>> +with different carrier boards. This module can come with different sizes and
>> +models for DDR, eMMC, SPI NOR Flash and various SoCs from the AM64x family.
>> +
>> +A development Kit, called `phyBOARD-Lyra <https://www.phytec.com/product/phyboard-am64x>`_
>> +is used as a carrier board reference design around the AM64x SoM.
>> +
>> +Quickstart
>> +----------
>> +
>> +* Download sources and TI firmware blobs
>> +* Build Trusted Firmware-A
>> +* Build OP-TEE
>> +* Build U-Boot for the R5
>> +* Build U-Boot for the A53
>> +* Create bootable uSD Card
>> +* Boot
>> +
>> +Sources
>> +-------
>> +
>> +.. include::  ../ti/k3.rst
>> +    :start-after: .. k3_rst_include_start_boot_sources
>> +    :end-before: .. k3_rst_include_end_boot_sources
>> +
>> +Build procedure
>> +---------------
>> +
>> +Setup the environment variables:
>> +
>> +.. include::  ../ti/k3.rst
>> +    :start-after: .. k3_rst_include_start_common_env_vars_desc
>> +    :end-before: .. k3_rst_include_end_common_env_vars_desc
>> +
>> +.. include::  ../ti/k3.rst
>> +    :start-after: .. k3_rst_include_start_board_env_vars_desc
>> +    :end-before: .. k3_rst_include_end_board_env_vars_desc
>> +
>> +Set the variables corresponding to this platform:
>> +
>> +.. include::  ../ti/k3.rst
>> +    :start-after: .. k3_rst_include_start_common_env_vars_defn
>> +    :end-before: .. k3_rst_include_end_common_env_vars_defn
>> +.. code-block:: bash
>> +
>> + $ export UBOOT_CFG_CORTEXR=phycore_am64x_r5_defconfig
>> + $ export UBOOT_CFG_CORTEXA=phycore_am64x_a53_defconfig
>> + $ export TFA_BOARD=lite
>> + $ # we don't use any extra TFA parameters
>> + $ unset TFA_EXTRA_ARGS
>> + $ export OPTEE_PLATFORM=k3-am64x
>> + # we don't use any extra OPTEE parameters
>> + unset OPTEE_EXTRA_ARGS
>> +
>> +.. include::  ../ti/am62x_sk.rst
>> +    :start-after: .. am62x_evm_rst_include_start_build_steps
>> +    :end-before: .. am62x_evm_rst_include_end_build_steps
>> +
>> +uSD Card creation
>> +-----------------
>> +
>> +Use fdisk to partition the uSD card. The layout should look similar to:
>> +
>> +.. code-block:: bash
>> +
>> + $ sudo fdisk -l /dev/mmcblk0
>> + Disk /dev/mmcblk0: 7.56 GiB, 8120172544 bytes, 15859712 sectors
>> + Units: sectors of 1 * 512 = 512 bytes
>> + Sector size (logical/physical): 512 bytes / 512 bytes
>> + I/O size (minimum/optimal): 512 bytes / 512 bytes
>> + Disklabel type: dos
>> + Disk identifier: 0x6583d9a3
>> +
>> + Device         Boot  Start     End Sectors   Size Id Type
>> + /dev/mmcblk0p1 *      2048  264191  262144   128M  c W95 FAT32 (LBA)
>> + /dev/mmcblk0p2      264192 1934953 1670762 815.8M 83 Linux
>> +
>> +
>> +Once partitioned, the boot partition has to be formatted with a FAT filesystem.
>> +Assuming the uSD card is `/dev/mmcblk0`:
>> +
>> +.. code-block:: bash
>> +
>> + $ mkfs.vfat /dev/mmcblk0p1
>> +
>> +To boot from a micro SD card on a HSFS device simply copy the following
>> +artifacts to the FAT partition:
>> +
>> +* tiboot3.bin from R5 build as tiboot3.bin
>> +* tispl.bin_unsigned from Cortex-A build as tispl.bin
>> +* u-boot.img_unsigned from Cortex-A build as u-boot.img
> Is the _unsigned really required? I guess the regular tispl and
> u-boot.img should also work right? It will just skip auth I guess.

No, it is not required. Copy&pasted it from phycore-am62x.rst.
Thanks, I will update both doc files.


>
> [...]
>
> Mostly looks good, thanks!
> Reviewed-by: Dhruva Gole <d-gole at ti.com>
>