Skip to content

Commit 9a6654a

Browse files
finikorgjhedberg
authored andcommitted
doc: boards: ehl_crb: Reuse net_boot.rst
Reuse net_boot.rst for network boot, moving extra docs to notes. Signed-off-by: Andrei Emeltchenko <andrei.emeltchenko@intel.com>
1 parent ff3cdfc commit 9a6654a

File tree

1 file changed

+16
-88
lines changed

1 file changed

+16
-88
lines changed

boards/x86/ehl_crb/doc/index.rst

Lines changed: 16 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -60,100 +60,28 @@ Booting the Elkhart Lake CRB Board using UEFI
6060
Booting the Elkhart Lake CRB Board over network
6161
===============================================
6262

63-
Build Zephyr image
64-
------------------
63+
.. include:: ../../common/net_boot.rst
6564

66-
#. Follow `Build Zephyr application`_ steps to build Zephyr image.
67-
68-
Prepare Linux host
69-
------------------
70-
71-
#. Install DHCP, TFTP servers. For example ``dnsmasq``
72-
73-
.. code-block:: console
74-
75-
$ sudo apt-get install dnsmasq
76-
77-
#. Configure DHCP server. Configuration for ``dnsmasq`` is below:
78-
79-
.. code-block:: console
80-
81-
# Only listen to this interface
82-
interface=eno2
83-
dhcp-range=10.1.1.20,10.1.1.30,12h
84-
85-
#. Configure TFTP server.
86-
87-
.. code-block:: console
88-
89-
# tftp
90-
enable-tftp
91-
tftp-root=/srv/tftp
92-
dhcp-boot=zephyr.efi
93-
94-
``zephyr.efi`` is a Zephyr EFI binary created above.
95-
96-
#. Copy the Zephyr EFI image :file:`zephyr/zephyr.efi` to the
97-
:file:`/srv/tftp` folder.
98-
99-
.. code-block:: console
100-
101-
$ cp zephyr/zephyr.efi /srv/tftp/
102-
103-
#. Restart ``dnsmasq`` service:
104-
105-
.. code-block:: console
106-
107-
$ sudo systemctl restart dnsmasq.service
108-
109-
Prepare Elkhart Lake CRB board for network boot
110-
-----------------------------------------------
111-
112-
#. Enable boot from PXE. Go to EFI shell and make sure that the first boot
113-
option is ``UEFI PXEv4``.
114-
115-
.. code-block:: console
116-
117-
Shell> bcfg boot dump
118-
Option: 00. Variable: Boot0007
119-
Desc - UEFI PXEv4 (MAC:6805CABC1997)
120-
DevPath - PciRoot(0x0)/Pci(0x1C,0x0)/Pci(0x0,0x0)/MAC(6805CABC1997,0x0)/IPv4(0.0.0.0)
121-
Optional- Y
122-
...
123-
124-
#. If UEFI PXEv4 is not the first boot option use ``bcfg boot mv`` command to
125-
change boot order
126-
127-
.. code-block:: console
128-
129-
Shell> bcfg boot mv 7 0
130-
131-
Booting Elkhart Lake CRB
132-
------------------------
133-
134-
#. Connect the board to the host system using the serial cable and
135-
configure your host system to watch for serial data.
136-
137-
#. Power on the Elkhart Lake CRB board.
138-
139-
#. Verify that the board got an IP address:
65+
.. note::
66+
To enable PXE boot for Elkhart Lake CRB board do the following:
14067

141-
.. code-block:: console
68+
#. Enable boot from PXE. Go to EFI shell and make sure that the first boot
69+
option is ``UEFI PXEv4``.
14270

143-
$ journalctl -f -u dnsmasq
144-
dnsmasq-dhcp[5386]: DHCPDISCOVER(eno2) 00:07:32:52:25:88
145-
dnsmasq-dhcp[5386]: DHCPOFFER(eno2) 10.1.1.28 00:07:32:52:25:88
146-
dnsmasq-dhcp[5386]: DHCPREQUEST(eno2) 10.1.1.28 00:07:32:52:25:88
147-
dnsmasq-dhcp[5386]: DHCPACK(eno2) 10.1.1.28 00:07:32:52:25:88
71+
.. code-block:: console
14872
149-
#. Verify that network booting is started:
73+
Shell> bcfg boot dump
74+
Option: 00. Variable: Boot0007
75+
Desc - UEFI PXEv4 (MAC:6805CABC1997)
76+
DevPath - PciRoot(0x0)/Pci(0x1C,0x0)/Pci(0x0,0x0)/MAC(6805CABC1997,0x0)/IPv4(0.0.0.0)
77+
Optional- Y
78+
...
15079
151-
.. code-block:: console
80+
#. If UEFI PXEv4 is not the first boot option use ``bcfg boot mv`` command to
81+
change boot order
15282

153-
$ journalctl -f -u dnsmasq
154-
dnsmasq-tftp[5386]: sent /srv/tftp/zephyr.efi to 10.1.1.28
83+
.. code-block:: console
15584
156-
#. When the boot process completes, you have finished booting the
157-
Zephyr application image.
85+
Shell> bcfg boot mv 7 0
15886
15987
.. _EHL: https://www.intel.com/content/www/us/en/products/docs/processors/embedded/enhanced-for-iot-platform-brief.html

0 commit comments

Comments
 (0)