Skip to content

Commit 0d1392f

Browse files
committed
source: linux: Add documentation of Ethernet boot for J722S
Ethernet boot support has been added to J722s SoC, add documentation for the same. Signed-off-by: Chintan Vankar <[email protected]>
1 parent 3801866 commit 0d1392f

File tree

3 files changed

+53
-6
lines changed

3 files changed

+53
-6
lines changed

configs/J722S/J722S_linux_toc.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@ linux/Foundational_Components/U-Boot/UG-NOR
3333
linux/Foundational_Components/U-Boot/UG-UART
3434
linux/Foundational_Components/U-Boot/UG-SATA
3535
linux/Foundational_Components/U-Boot/UG-DDRSS-J7
36+
linux/Foundational_Components/U-Boot/UG-Network-K3
3637
linux/Foundational_Components/U-Boot/UG-HyperBus
3738
linux/Foundational_Components/U-Boot/UG-RemoteProc
3839
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
@@ -391,12 +391,12 @@ Build U-Boot
391391

392392
.. ifconfig:: CONFIG_part_variant in ('J722S')
393393

394-
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------+------------------------------------+
395-
| Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | USB MSC |
396-
+============================+=================================+================================+================================+====================================+====================================+
397-
| J722S EVM | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_usbdfu.config | j722s\_evm\_r5\_usbmsc.config |
398-
| | j722s\_evm\_a53\_defconfig | j722s\_evm\_a53\_defconfig | j722s\_evm\_a53\_defconfig | j722s\_evm\_a53\_defconfig | j722s\_evm\_a53\_defconfig |
399-
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------+------------------------------------+
394+
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------+------------------------------------+------------------------------------------+
395+
| Board | SD/eMMC Boot | UART boot | OSPI boot | USB DFU | USB MSC | Ethernet Boot |
396+
+============================+=================================+================================+================================+====================================+====================================+==========================================+
397+
| J722S EVM | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_defconfig | j722s\_evm\_r5\_usbdfu.config | j722s\_evm\_r5\_usbmsc.config | j722s\_evm\_r5\_ethboot\_defconfig |
398+
| | 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 |
399+
+----------------------------+---------------------------------+--------------------------------+--------------------------------+------------------------------------+------------------------------------+------------------------------------------+
400400

401401
.. ifconfig:: CONFIG_part_variant in ('J721E','J7200','J721S2','J784S4','J742S2')
402402

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

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ binaries files to be sent over TFTP are listed in the table below.
2626
| | ``am64x_evm_a53_defconfig`` | | :file:`tiboot3.bin` | :file:`tispl.bin` | :file:`u-boot.img` |
2727
+------------------+------------------------------+------------------------+------------------------+---------------------------+---------------------------+
2828

29+
For instructions to build the bootloader images please refer to :ref:`Build-U-Boot-label`.
30+
2931
.. important::
3032

3133
- Ethernet RGMII boot is supported over RGMII2 (Second port) on AM64x SoC.
@@ -50,6 +52,24 @@ binaries files to be sent over TFTP are listed in the table below.
5052
- Disable link info Bootmode pin so that ROM can identify the PHY and establishes link with the supported speed and duplex mode.
5153
- Please note that due to MDIO corruption (Errata i2329), booting over Ethernet is not recommended for production purposes.
5254

55+
.. ifconfig:: CONFIG_part_variant in ('J722S')
56+
57+
+------------------+--------------------------------------+-----------------------+------------------------+---------------------------+----------------------------+
58+
| Board | Defconfigs | Supported interfaces | ROM | R5 SPL | A53 SPL |
59+
+==================+======================================+=======================+========================+===========================+============================+
60+
| J722s EVM | ``j722s_evm_r5_ethboot_defconfig`` | CPSW NUSS Ethernet | VCI: TI K3 Bootp Boot | VCI: J722S U-Boot R5 SPL | VCI: J722S U-Boot A53 SPL |
61+
| | ``j722s_evm_a53_ethboot_defconfig`` | | :file:`tiboot3.bin` | :file:`tispl.bin` | :file:`u-boot.img` |
62+
+------------------+--------------------------------------+-----------------------+------------------------+---------------------------+----------------------------+
63+
64+
Build tiboot3.bin using ``j722s_evm_r5_ethboot_defconfig``. Build tispl.bin and u-boot.img using ``j722s_evm_a53_ethboot_defconfig``. For instructions to build the bootloader images please refer to :ref:`Build-U-Boot-label`.
65+
66+
.. important::
67+
68+
- Ethernet RGMII boot is supported over RGMII on J722s SoC.
69+
- CPSW PHYs should be strapped as per ROM's expectation described in part's TRM.
70+
- 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.
71+
- Disable link info Bootmode pin so that ROM can identify the PHY and establishes link with the supported speed and duplex mode.
72+
5373
.. ifconfig:: CONFIG_part_variant in ('AM64X')
5474

5575
If using ISC dhcpd an example host entry would look like this:
@@ -102,5 +122,31 @@ binaries files to be sent over TFTP are listed in the table below.
102122
next-server 10.0.0.1;
103123
}
104124
125+
.. ifconfig:: CONFIG_part_variant in ('J722S')
126+
127+
If using ISC dhcpd an example host entry would look like this:
128+
129+
.. code-block:: text
130+
131+
subnet 10.0.0.0 netmask 255.0.0.0
132+
{
133+
range dynamic-bootp 10.0.0.2 10.0.0.16;
134+
if substring (option vendor-class-identifier, 0, 16) = "TI K3 Bootp Boot"
135+
{
136+
filename "tiboot3.bin";
137+
} elsif substring (option vendor-class-identifier, 0, 20) = "J722S U-Boot R5 SPL"
138+
{
139+
filename "tispl.bin";
140+
} elsif substring (option vendor-class-identifier, 0, 21) = "J722S U-Boot A53 SPL"
141+
{
142+
filename "u-boot.img";
143+
}
144+
145+
range 10.0.0.17 10.0.0.25;
146+
default-lease-time 60000;
147+
max-lease-time 720000;
148+
next-server 10.0.0.1;
149+
}
150+
105151
A walk through of these steps to setup isc-dhcp-server on Ubuntu can be found at `here
106152
<https://help.ubuntu.com/community/isc-dhcp-server>`__.

0 commit comments

Comments
 (0)