1.. _intel_ehl_crb:
2
3Elkhart Lake CRB
4################
5
6Overview
7********
8Elkhart Lake Reference Board (EHL CRB) is an example implementation of a
9compact single board computer with high performance for IoT edge devices.
10
11This board configuration enables kernel support for the `EHL`_ board.
12
13.. note::
14   This board configuration works on the variant of `EHL`_
15   boards containing Intel |reg| Atom |trade| SoC.
16
17Hardware
18********
19
20General information about the board can be found at the `EHL`_ website.
21
22.. include:: ../../../../soc/intel/elkhart_lake/doc/supported_features.txt
23
24
25Connections and IOs
26===================
27
28Refer to the `EHL`_ website for more information.
29
30Programming and Debugging
31*************************
32Use the following procedures for booting an image on a EHL CRB board.
33
34.. contents::
35   :depth: 1
36   :local:
37   :backlinks: top
38
39Build Zephyr application
40========================
41
42#. Build a Zephyr application; for instance, to build the ``hello_world``
43   application on Elkhart Lake CRB:
44
45   .. zephyr-app-commands::
46      :zephyr-app: samples/hello_world
47      :board: intel_ehl_crb
48      :goals: build
49
50   .. note::
51
52      A Zephyr EFI image file named :file:`zephyr.efi` is automatically
53      created in the build directory after the application is built.
54
55Booting the Elkhart Lake CRB Board using UEFI
56=============================================
57
58.. include:: ../../../intel/common/efi_boot.rst
59   :start-after: start_include_here
60
61Booting the Elkhart Lake CRB Board over network
62===============================================
63
64.. include:: ../../../intel/common/net_boot.rst
65   :start-after: start_include_here
66
67.. note::
68   To enable PXE boot for Elkhart Lake CRB board do the following:
69
70   #. Enable boot from PXE. Go to EFI shell and make sure that the first boot
71      option is ``UEFI PXEv4``.
72
73      .. code-block:: console
74
75         Shell> bcfg boot dump
76         Option: 00. Variable: Boot0007
77           Desc    - UEFI PXEv4 (MAC:6805CABC1997)
78           DevPath - PciRoot(0x0)/Pci(0x1C,0x0)/Pci(0x0,0x0)/MAC(6805CABC1997,0x0)/IPv4(0.0.0.0)
79           Optional- Y
80         ...
81
82   #. If UEFI PXEv4 is not the first boot option use ``bcfg boot mv`` command to
83      change boot order
84
85      .. code-block:: console
86
87         Shell> bcfg boot mv 7 0
88
89.. _EHL: https://www.intel.com/content/www/us/en/products/docs/processors/embedded/enhanced-for-iot-platform-brief.html
90