Skip to content

Commit 3d5e9cd

Browse files
Jacky Leekartben
Jacky Lee
authored and
kartben
committed
board: Add 'egis_et171' dev board
This is a development board for Egis et171 SOC. It has basic peripherals such as GPIO, I2C, SPI,.. etc and built-in USB. Signed-off-by: Jacky Lee <[email protected]>
1 parent 83afba8 commit 3d5e9cd

File tree

10 files changed

+275
-0
lines changed

10 files changed

+275
-0
lines changed

‎boards/egis/egis_et171/Kconfig.defconfig‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Copyright (c) 2025 Egis Technology Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
DT_CHOSEN_Z_FLASH := zephyr,flash
5+
6+
config FLASH_LOAD_SIZE
7+
default $(dt_chosen_reg_size_hex,$(DT_CHOSEN_Z_FLASH))

‎boards/egis/egis_et171/Kconfig.egis_et171‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Copyright (c) 2025 Egis Technology Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
config BOARD_EGIS_ET171
5+
select SOC_EGIS_ET171

‎boards/egis/egis_et171/board.cmake‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
#
2+
# Copyright (c) 2025 Egis Technology Inc.
3+
#
4+
# SPDX-License-Identifier: Apache-2.0
5+
#
6+
cmake_minimum_required(VERSION 3.20.0)
7+
8+
# To get more info about flashing, please contect https://www.egistec.com
9+
10+
# You must set the private key of the secure boot upgrade from env.
11+
set(EGIS_FW_KEY $ENV{egis_fw_key})
12+
13+
# You can provider extension arguments for flashing firmware from env.
14+
set(EXT_ARG $ENV{et171_fw_upgrade_ext_arg})
15+
16+
find_program(ET171_FLASHER NAMES et171_fw_upgrade)
17+
board_set_flasher_ifnset(misc-flasher)
18+
board_finalize_runner_args(misc-flasher
19+
${ET171_FLASHER}
20+
${EXT_ARG}
21+
-SCAK=${EGIS_FW_KEY}
22+
-FW="${PROJECT_BINARY_DIR}/${CONFIG_KERNEL_BIN_NAME}.bin"
23+
)

‎boards/egis/egis_et171/board.yml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
board:
2+
name: egis_et171
3+
full_name: ET171 Development Board
4+
vendor: egis
5+
socs:
6+
- name: et171

‎boards/egis/egis_et171/doc/img/et171_snapshot.webp‎

49.6 KB
Loading

‎boards/egis/egis_et171/doc/index.rst‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
.. zephyr:board:: egis_et171
2+
3+
Overview
4+
********
5+
6+
The et171 development board is used for development and verification,
7+
and can be used for application development through interfaces such
8+
as UART, GPIO, SPI, and I2C.
9+
10+
Hardware
11+
********
12+
13+
The platform provides following hardware components:
14+
15+
- 32-bit RISC-V CPU
16+
- 384KB embedded SDRAM
17+
- UART
18+
- I2C
19+
- SPI
20+
- GPIO
21+
- PWM
22+
- DMA
23+
- USB
24+
25+
.. figure:: img/et171_snapshot.webp
26+
:align: center
27+
:alt: EGIS_ET171_SOC
28+
29+
Supported Features
30+
==================
31+
32+
.. zephyr:board-supported-hw::
33+
34+
Connections and IOs
35+
===================
36+
37+
The et171 platform has 1 GPIO controller. It providing 17 bits of IO.
38+
It is responsible for pin input/output, pull-up, etc.
39+
40+
The et171 platform has 3 SPI controllers, 2 of which can
41+
additionally support QSPI and XIP mode.
42+
43+
The et171 platform has one USB 2.0 controller that supports up to
44+
USB 2.0 high-speed mode.
45+
46+
Except USB DP/DM, all et171 peripheral I/O devices are mapped to 31
47+
I/O pins through the multiplexer controller.
48+
49+
System Clock
50+
------------
51+
52+
The et171 platform has a multi-stage frequency divider with a maximum
53+
speed of 200 MHz.
54+
55+
Programming and debugging
56+
*************************
57+
58+
.. zephyr:board-supported-runners::
59+
60+
The et171 is compatible with Andes ae350, so you can use Andes ICE
61+
for debugging. For debugging zephyr applications or upload them into
62+
a RAM, you will need to connect ICE from host computer to et171 board
63+
and execute the ICE management software, ICEman, on this host computer.
64+
65+
Connecting Andes ICE (AICE)
66+
===========================
67+
68+
AICE is used for debugging and uploading RAM code to the board.
69+
70+
Building
71+
========
72+
73+
You can build applications in the usual way. Here is an example for
74+
the :zephyr:code-sample:`hello_world` application.
75+
76+
.. zephyr-app-commands::
77+
:zephyr-app: samples/hello_world
78+
:board: egis_et171
79+
:goals: build
80+
81+
Flashing
82+
========
83+
84+
Since this is a B2B prototype, there is no publicly available
85+
flashing tool. If you have any development needs, please contact
86+
the contact window of `Egis Technology Inc. <https://www.egistec.com/>`_
87+
.
88+
89+
If you has a debugger (`AICE-MICRO`_) with ICEman (`Andes Development Kit`_)
90+
, set the ``CONFIG_XIP=n`` to enable running the program in RAM mode via
91+
the ICE debugger.
92+
93+
At first, you should run ICEman before load program.
94+
95+
.. code-block:: console
96+
97+
# Enable execute file permission of ICEman
98+
$ chmod a+x ./ICEman
99+
100+
# Running the ICEman server
101+
$ sudo ./ICEman -Z v5
102+
103+
.. code-block:: console
104+
105+
# When your ICEman server is running
106+
# You can load the program into RAM and execute it via gdb
107+
$ riscv64-zephyr-elf-gdb build/zephyr/zephyr.elf
108+
(gdb) target remote :1111
109+
(gdb) monitor reset halt
110+
(gdb) load
111+
(gdb) quit
112+
113+
References
114+
**********
115+
116+
.. target-notes::
117+
118+
.. _AICE-MICRO: http://www.andestech.com/en/products-solutions/andeshape-platforms/aice-micro/
119+
120+
.. _Andes Development Kit: https://github.com/andestech/Andes-Development-Kit/releases

‎boards/egis/egis_et171/egis_et171.dts‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
/*
2+
* Copyright (c) 2025 Egis Technology Inc.
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
/dts-v1/;
8+
9+
#include <egis/egis_et171.dtsi>
10+
11+
/ {
12+
model = "Egis ET171C";
13+
compatible = "egis,egis_et171";
14+
15+
aliases {
16+
watchdog0 = &wdt;
17+
led0 = &gpio_led0;
18+
led1 = &gpio_led1;
19+
gpio-0 = &gpio0;
20+
counter-0 = &pit0;
21+
};
22+
23+
chosen {
24+
zephyr,console = &uart0;
25+
zephyr,shell-uart = &uart0;
26+
zephyr,sram = &sram;
27+
zephyr,flash = &flash0;
28+
};
29+
30+
leds {
31+
compatible = "gpio-leds";
32+
33+
gpio_led0: led0 {
34+
label = "LED0";
35+
gpios = <&gpio0 0 GPIO_ACTIVE_LOW>;
36+
};
37+
38+
gpio_led1: led1 {
39+
label = "LED1";
40+
gpios = <&gpio0 1 GPIO_ACTIVE_LOW>;
41+
};
42+
};
43+
44+
flash0: flash@80000000 {
45+
compatible = "soc-nv-flash";
46+
reg = <0x80000000 DT_SIZE_K(1024)>;
47+
};
48+
49+
clocks {
50+
clk_mtimer: clk_mtimer {
51+
compatible = "fixed-clock";
52+
clock-frequency = <18037518>;
53+
status = "disabled";
54+
};
55+
};
56+
};
57+
58+
&plic0 {
59+
status = "okay";
60+
};
61+
62+
&uart0 {
63+
status = "okay";
64+
clock-frequency = <18037518>;
65+
current-speed = <38400>;
66+
};
67+
68+
&gpio0 {
69+
status = "okay";
70+
};
71+
72+
&pit0 {
73+
status = "okay";
74+
};
75+
76+
&dma0 {
77+
status = "okay";
78+
};
79+
80+
&wdt {
81+
status = "okay";
82+
};

‎boards/egis/egis_et171/egis_et171.yaml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
identifier: egis_et171
2+
name: Egis ET171
3+
type: mcu
4+
arch: riscv
5+
toolchain:
6+
- zephyr
7+
- cross-compile
8+
ram: 384
9+
supported:
10+
- gpio
11+
- counter
12+
- flash
13+
- watchdog
14+
testing:
15+
ignore_tags:
16+
- bluetooth
17+
- spi
18+
- usb

‎boards/egis/egis_et171/egis_et171_defconfig‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
CONFIG_CONSOLE=y
2+
CONFIG_UART_CONSOLE=y
3+
CONFIG_SERIAL=y
4+
CONFIG_GPIO=y

‎boards/egis/index.rst‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
.. _boards-egis:
2+
3+
Egis Technology Inc.
4+
####################
5+
6+
.. toctree::
7+
:maxdepth: 1
8+
:glob:
9+
10+
**/*

0 commit comments

Comments
 (0)