From 8ae6acd7456e601597676239d34bc5a3c3f4d7fd Mon Sep 17 00:00:00 2001 From: Andrei Emeltchenko Date: Wed, 19 Jul 2023 16:39:38 +0300 Subject: [PATCH] doc: boards: up_squared: Reuse net_boot.rst Reuse net_boot.rst for network boot, moving extra docs to notes. Signed-off-by: Andrei Emeltchenko --- boards/x86/up_squared/doc/index.rst | 103 ++++------------------------ 1 file changed, 13 insertions(+), 90 deletions(-) diff --git a/boards/x86/up_squared/doc/index.rst b/boards/x86/up_squared/doc/index.rst index 006bf7a722e3e0..35dc68ac533383 100644 --- a/boards/x86/up_squared/doc/index.rst +++ b/boards/x86/up_squared/doc/index.rst @@ -97,104 +97,27 @@ Booting the UP Squared Board using UEFI Booting the UP Squared Board over network ========================================= -Build Zephyr image ------------------- +.. include:: ../../common/net_boot.rst -#. Follow `Build Zephyr application`_ steps to build Zephyr image. - -Prepare Linux host ------------------- - -#. Install DHCP, TFTP servers. For example ``dnsmasq`` - - .. code-block:: console - - $ sudo apt-get install dnsmasq - -#. Configure DHCP server. Configuration for ``dnsmasq`` is below: - - .. code-block:: console - - # Only listen to this interface - interface=eno2 - dhcp-range=10.1.1.20,10.1.1.30,12h - -#. Configure TFTP server. - - .. code-block:: console - - # tftp - enable-tftp - tftp-root=/srv/tftp - dhcp-boot=zephyr.efi - - ``zephyr.efi`` is a Zephyr EFI binary created above. - -#. Copy the Zephyr EFI image :file:`zephyr/zephyr.efi` to the - :file:`/srv/tftp` folder. - - .. code-block:: console - - $ sudo cp zephyr/zephyr.efi /srv/tftp - - -#. TFTP root should be looking like: - - .. code-block:: console - - $ tree /srv/tftp - /srv/tftp - └── zephyr.efi - -#. Restart ``dnsmasq`` service: - - .. code-block:: console - - $ sudo systemctl restart dnsmasq.service - -Prepare UP Squared board for network boot ------------------------------------------ - -#. Enable PXE network from BIOS settings. - - .. code-block:: console - - Advanced -> Network Stack Configuration -> Enable Network Stack -> Enable Ipv4 PXE Support - -#. Make network boot as the first boot option. - - .. code-block:: console - - Boot -> Boot Option #1 : [Network] - -Booting UP Squared ------------------- - -#. Connect the board to the host system using the serial cable and - configure your host system to watch for serial data. See - https://wiki.up-community.org/Serial_console. - -#. Power on the UP Squared board. +.. note:: + Refer to the `UP Squared Serial Console Wiki page + `_ for instructions on how to + connect serial console. -#. Verify that the board got an IP address: +.. note:: + To enable PXE boot for Up Squared board do the following: - .. code-block:: console + #. Enable network from BIOS settings. - $ journalctl -f -u dnsmasq - dnsmasq-dhcp[5386]: DHCPDISCOVER(eno2) 00:07:32:52:25:88 - dnsmasq-dhcp[5386]: DHCPOFFER(eno2) 10.1.1.28 00:07:32:52:25:88 - dnsmasq-dhcp[5386]: DHCPREQUEST(eno2) 10.1.1.28 00:07:32:52:25:88 - dnsmasq-dhcp[5386]: DHCPACK(eno2) 10.1.1.28 00:07:32:52:25:88 + .. code-block:: console -#. Verify that network booting is started: + Advanced -> Network Stack Configuration -> Enable Network Stack -> Enable Ipv4 PXE Support - .. code-block:: console + #. Make network boot as the first boot option. - $ journalctl -f -u dnsmasq - dnsmasq-tftp[5386]: sent /srv/tftp/zephyr.efi to 10.1.1.28 + .. code-block:: console -#. When the boot process completes, you have finished booting the - Zephyr application image. + Boot -> Boot Option #1 : [Network] .. _UP Squared: https://www.up-board.org/upsquared/specifications