1.. zephyr:board:: khadas_edgev
2
3Overview
4********
5
6See <https://www.khadas.com/edge-v>
7
8Hardware
9********
10
11See <https://docs.khadas.com/linux/edge/Hardware.html#Edge-V-1>
12
13Supported Features
14==================
15
16Khadas Edge-V board default configuration supports the following
17hardware features:
18
19+-----------+------------+--------------------------------------+
20| Interface | Controller | Driver/Component                     |
21+===========+============+======================================+
22| GIC-500   | on-chip    | GICv3 interrupt controller           |
23+-----------+------------+--------------------------------------+
24| ARM TIMER | on-chip    | System Clock                         |
25+-----------+------------+--------------------------------------+
26| UART      | on-chip    | Synopsys DesignWare 8250 serial port |
27+-----------+------------+--------------------------------------+
28
29Other hardware features have not been enabled yet for this board.
30
31The default configuration can be found in (NON-SMP)
32:zephyr_file:`boards/khadas/edgev/khadas_edgev_defconfig`
33
34There are multiple serial ports on the board: Zephyr is using
35uart2 as serial console.
36
37Programming and Debugging
38*************************
39
40Use the following configuration to run basic Zephyr applications and
41kernel tests on Khadas Edge-V board. For example, with the :zephyr:code-sample:`hello_world`:
42
431. Non-SMP mode
44
45.. zephyr-app-commands::
46   :zephyr-app: samples/hello_world
47   :host-os: unix
48   :board: khadas_edgev
49   :goals: build
50
51This will build an image with the synchronization sample app.
52
53Build the zephyr image:
54
55.. code-block:: console
56
57	mkimage -C none -A arm64 -O linux -a 0x10000000 -e 0x10000000 -d build/zephyr/zephyr.bin build/zephyr/zephyr.img
58
59Use u-boot to load and kick Zephyr.bin to CPU Core0:
60
61.. code-block:: console
62
63	tftpboot ${pxefile_addr_r} zephyr.img; bootm start ${pxefile_addr_r}; bootm loados; bootm go
64
65It will display the following console output:
66
67.. code-block:: console
68
69	*** Booting Zephyr OS build XXXXXXXXXXXX  ***
70	Hello World! khadas_edgev
71
72Flashing
73========
74
75Zephyr image can be loaded in DDR memory at address 0x10000000 from SD Card,
76EMMC, QSPI Flash or downloaded from network in uboot.
77
78References
79==========
80
81`Documentation: <https://docs.khadas.com/linux/edge/>`_
82