Skip to content

Commit 7b38bca

Browse files
chintanv133StaticRocket
chintanv133
authored and
StaticRocket
committed
feat(u-boot): Add documentation of Ethernet boot for J722s SoC
Ethernet boot support has been added to J722s SoC, add documentation for the same. Signed-off-by: Chintan Vankar <[email protected]>
1 parent 9d31bbf commit 7b38bca

File tree

4 files changed

+38
-30
lines changed

4 files changed

+38
-30
lines changed

‎configs/J722S/J722S_linux_config.txt‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,10 @@ Replacement Variables
3232
'__FEATURINGMATRIX__' : \
3333
'__SYSFW_CORE_NAME__' : 'TIFS'
3434
'__IMAGE_TYPE__' : 'adas'
35+
'__SPL_VCI_STRING_LEN__' : '19'
36+
'__SPL_VCI_STRING__' : 'J722S U-Boot R5 SPL'
37+
'__UBOOT_VCI_STRING_LEN__' : '20'
38+
'__UBOOT_VCI_STRING__' : 'J722S U-Boot A53 SPL'
3539

3640
Configuration Values
3741
--------------------

‎configs/J722S/J722S_linux_toc.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ linux/Foundational_Components/U-Boot/UG-NOR
3131
linux/Foundational_Components/U-Boot/UG-UART
3232
linux/Foundational_Components/U-Boot/UG-SATA
3333
linux/Foundational_Components/U-Boot/UG-DDRSS-J7
34+
linux/Foundational_Components/U-Boot/UG-Network-K3
3435
linux/Foundational_Components/U-Boot/UG-HyperBus
3536
linux/Foundational_Components/U-Boot/UG-RemoteProc
3637
linux/Foundational_Components/U-Boot/Applications

‎source/linux/Foundational_Components/U-Boot/UG-General-Info.rst‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -393,12 +393,12 @@ Build U-Boot
393393

394394
.. ifconfig:: CONFIG_part_variant in ('J722S')
395395

396-
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+
397-
| Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | USB MSC |
398-
+============================+=================================+================================+================================+======================================================+=======================================================+
399-
| J722S EVM | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``j722s_evm_r5_defconfig am62x_r5_usbmsc.config`` |
400-
| | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` |
401-
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+
396+
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+------------------------------------------+
397+
| Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | USB MSC | Ethernet boot |
398+
+============================+=================================+================================+================================+======================================================+=======================================================+==========================================+
399+
| J722S EVM | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig`` | | ``j722s_evm_r5_defconfig am62x_r5_usbdfu.config`` | | ``j722s_evm_r5_defconfig am62x_r5_usbmsc.config`` | j722s\_evm\_r5\_ethboot\_defconfig |
400+
| | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | | ``j722s_evm_a53_defconfig`` | j722s\_evm\_a53\_ethboot\_defconfig |
401+
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------------------------+-------------------------------------------------------+------------------------------------------+
402402

403403
.. ifconfig:: CONFIG_part_variant in ('J721E','J7200','J721S2','J784S4','J742S2')
404404

‎source/linux/Foundational_Components/U-Boot/UG-Network-K3.rst‎

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -19,38 +19,39 @@ binaries files to be sent over TFTP are listed in the table below.
1919

2020
.. ifconfig:: CONFIG_part_variant in ('AM64X')
2121

22-
+------------------+------------------------------+------------------------+------------------------+---------------------------+---------------------------+
23-
| Board | Defconfigs | Supported interfaces | ROM | R5 SPL | A53 SPL |
24-
+==================+==============================+========================+========================+===========================+===========================+
25-
| AM64x GP EVM | ``am64x_evm_r5_defconfig`` | CPSW NUSS Ethernet | VCI: TI K3 Bootp Boot | VCI: AM64X U-Boot R5 SPL | VCI: AM64X U-Boot A53 SPL |
26-
| | ``am64x_evm_a53_defconfig`` | | :file:`tiboot3.bin` | :file:`tispl.bin` | :file:`u-boot.img` |
27-
+------------------+------------------------------+------------------------+------------------------+---------------------------+---------------------------+
22+
Build tiboot3.bin using ``am64x_evm_r5_defconfig``. Build tispl.bin and u-boot.img using ``am64x_evm_a53_defconfig``.
2823

29-
.. important::
24+
.. important::
3025

31-
- Ethernet RGMII boot is supported over RGMII2 (Second port) on AM64x SoC.
32-
- RGMII boot is only supported on AM64x SK EVM and not supported on AM64x GP EVM as port is muxed to ICSSG by default
33-
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
34-
- Link info Bootmode pin needs to be ON along with RGMII boot mode selection Bootmode pins.
26+
- Ethernet RGMII boot is supported over RGMII2 (Second port) on AM64x SoC.
27+
- RGMII boot is only supported on AM64x SK EVM and not supported on AM64x GP EVM as port is muxed to ICSSG by default
28+
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
29+
- Link info Bootmode pin needs to be ON along with RGMII boot mode selection Bootmode pins.
3530

3631
.. ifconfig:: CONFIG_part_variant in ('AM62X')
3732

38-
+------------------+-----------------------------------------+------------------------+------------------------+---------------------------+---------------------------+
39-
| Board | Defconfigs | Supported interfaces | ROM | R5 SPL | A53 SPL |
40-
+==================+=========================================+========================+========================+===========================+===========================+
41-
| AM62x SK | ``am62x_evm_r5_ethboot_defconfig`` | CPSW NUSS Ethernet | VCI: TI K3 Bootp Boot | VCI: AM62X U-Boot R5 SPL | VCI: AM62X U-Boot A53 SPL |
42-
| | ``am62x_evm_a53_ethboot_defconfig`` | | :file:`tiboot3.bin` | :file:`tispl.bin` | :file:`u-boot.img` |
43-
+------------------+-----------------------------------------+------------------------+------------------------+---------------------------+---------------------------+
33+
Build tiboot3.bin using ``am62x_evm_r5_ethboot_defconfig``. Build tispl.bin and u-boot.img using ``am62x_evm_a53_ethboot_defconfig``.
4434

45-
.. important::
35+
.. important::
4636

47-
- Ethernet RGMII boot is supported over RGMII1 (First port) on AM62x SoC.
48-
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
49-
- When the link info Bootmode pin is enabled, this means no auto-negotiation or reading of the Ethernet PHY is needed since the ROM will assume the link is up at 1Gbps, full duplex mode.
50-
- Disable link info Bootmode pin so that ROM can identify the PHY and establishes link with the supported speed and duplex mode.
51-
- Please note that due to MDIO corruption (Errata i2329), booting over Ethernet is not recommended for production purposes.
37+
- Ethernet RGMII boot is supported over RGMII1 (First port) on AM62x SoC.
38+
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
39+
- When the link info Bootmode pin is enabled, this means no auto-negotiation or reading of the Ethernet PHY is needed since the ROM will assume the link is up at 1Gbps, full duplex mode.
40+
- Disable link info Bootmode pin so that ROM can identify the PHY and establishes link with the supported speed and duplex mode.
41+
- Please note that due to MDIO corruption (Errata i2329), booting over Ethernet is not recommended for production purposes.
5242

53-
.. ifconfig:: CONFIG_part_variant in ('AM64X','AM62X')
43+
.. ifconfig:: CONFIG_part_variant in ('J722S')
44+
45+
Build tiboot3.bin using ``j722s_evm_r5_ethboot_defconfig``. Build tispl.bin and u-boot.img using ``j722s_evm_a53_ethboot_defconfig``.
46+
47+
.. important::
48+
49+
- Ethernet RGMII boot is supported over RGMII on J722s SoC.
50+
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
51+
- When the link info Bootmode pin is enabled, this means no auto-negotiation or reading of the Ethernet PHY is needed since the ROM will assume the link is up at 1Gbps, full duplex mode.
52+
- Disable link info Bootmode pin so that ROM can identify the PHY and establishes link with the supported speed and duplex mode.
53+
54+
.. ifconfig:: CONFIG_part_variant in ('AM64X','AM62X','J722S')
5455

5556
If using ISC dhcpd an example host entry would look like this:
5657

@@ -76,5 +77,7 @@ binaries files to be sent over TFTP are listed in the table below.
7677
next-server 10.0.0.1;
7778
}
7879
80+
For instructions to build the bootloader images please refer to :ref:`Build-U-Boot-label`.
81+
7982
A walk through of these steps to setup isc-dhcp-server on Ubuntu can be found at `here
8083
<https://help.ubuntu.com/community/isc-dhcp-server>`__.

0 commit comments

Comments
 (0)