Skip to content

Commit f44324d

Browse files
RtkFPcaiyi_zhong
RtkFP
authored and
caiyi_zhong
committed
boards: realtek: add rts5817_maa_evb board
Add support for rts5817_maa_evb board Signed-off-by: Darcy Lu <darcy_lu@realsil.com.cn>
1 parent 203884e commit f44324d

File tree

11 files changed

+249
-0
lines changed

11 files changed

+249
-0
lines changed

‎boards/realtek/rts5817_maa_evb/Kconfig.defconfig

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
if BOARD_RTS5817_MAA_EVB
5+
6+
config BOARD
7+
default "rts5817_maa_evb"
8+
9+
endif

‎boards/realtek/rts5817_maa_evb/Kconfig.rts5817_maa_evb

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
config BOARD_RTS5817_MAA_EVB
5+
select SOC_RTS5817

‎boards/realtek/rts5817_maa_evb/board.cmake

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
set_property(TARGET runners_yaml_props_target PROPERTY bin_file zephyr.rts5817.bin)
4+
5+
board_set_flasher_ifnset(rtsflash)
6+
board_runner_args(rtsflash "--pid=0bda:5817" "--alt=0")
7+
board_finalize_runner_args(rtsflash)

‎boards/realtek/rts5817_maa_evb/board.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
board:
5+
name: rts5817_maa_evb
6+
vendor: realtek
7+
socs:
8+
- name: rts5817

‎boards/realtek/rts5817_maa_evb/doc/img/rts5817_maa_evb.jpg

81.4 KB
Loading

‎boards/realtek/rts5817_maa_evb/doc/index.rst

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
.. rts5817_maa_evb:
2+
3+
rts5817_maa_evb
4+
#################
5+
6+
Overview
7+
********
8+
9+
rts5817 is a high-performance MCU based on Realtek Real-M300 ARMv8-M architecture with Cortex-M33 instruction set compatible.
10+
11+
.. figure:: img/rts5817_maa_evb.jpg
12+
:width: 400px
13+
:align: center
14+
:alt: rts5817_maa_evb
15+
16+
Hardware
17+
********
18+
19+
- 240MHz single-core 32-bit CPU with I-cache 32KB, D-cache 16KB
20+
- 48KB boot ROM
21+
- 256KB on-chip SRAM
22+
- 1KB PUFrt OTP
23+
- 2MB Flash
24+
- USB2.0 full speed/high speed device
25+
- Up tp 11 GPIO
26+
- 2 x UART
27+
- 2 x Timer
28+
- 2 x SPI, one can support slave mode
29+
- Watchdog
30+
- DMA
31+
- Temperature sensor
32+
- Cryptographic hardware acceleration (RNG, SHA, AES)
33+
- Fingerprint mataching hardware acceleration (MAC, popcount, convolution, etc.)
34+
- SWD for debug
35+
36+
Supported Features
37+
==================
38+
39+
For now, the following board hardware features are supported by implemented drivers:
40+
41+
+-------------------+------------+----------------------+
42+
| Interface | Controller | Driver/Component |
43+
+===================+============+======================+
44+
| CLOCK | on-chip | clock_control |
45+
+-------------------+------------+----------------------+
46+
| FLASH | on-chip | flash |
47+
+-------------------+------------+----------------------+
48+
| GPIO | on-chip | gpio |
49+
+-------------------+------------+----------------------+
50+
| SPI(M/S) | on-chip | spi |
51+
+-------------------+------------+----------------------+
52+
| UART | on-chip | serial |
53+
+-------------------+------------+----------------------+
54+
| USB | on-chip | USB device |
55+
+-------------------+------------+----------------------+
56+
| WDT | on-chip | watchdog |
57+
+-------------------+------------+----------------------+
58+
| PUF | on-chip | puf |
59+
+-------------------+------------+----------------------+
60+
| Temperature sensor| on-chip | sensor |
61+
+-------------------+------------+----------------------+
62+
63+
Programming and Debugging
64+
*************************
65+
66+
Building
67+
========
68+
69+
#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
70+
71+
#. The file ``zephyr.rts5817.bin`` will be created if the build system can build successfully.
72+
This binary image can be found under file "build/zephyr/".
73+
74+
Flashing
75+
========
76+
77+
#. Short the two pins of ``J6`` to enter force rom mode (see `RTS5817MAA_EVB_User_Guide`_).
78+
#. Connect the board to your host computer using USB.
79+
#. Use ``west flash`` command to flash the image.
80+
#. Disconnect the two pins of ``J6`` and reboot, The :zephyr:code-sample:`hello_world` application is running.
81+
82+
References
83+
**********
84+
85+
.. target-notes::
86+
87+
.. _RTS5817MAA_EVB_User_Guide:
88+
https://github.com/RtkFP/Doc/blob/main/RTS5817MAA_EVB%20User%20Guide_V1.0.pdf

‎boards/realtek/rts5817_maa_evb/rts5817_maa_evb-pinctrl.dtsi

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
/*
2+
* Copyright (c) 2024 Realtek Semiconductor, Inc.
3+
* SPDX-License-Identifier: Apache-2.0
4+
*/
5+
6+
#include <zephyr/dt-bindings/pinctrl/rts5817_pinctrl.h>
7+
8+
&pinctrl {
9+
uart0_default: uart0_default {
10+
group0 {
11+
pinmux = <P_SCL0_F_UART0_RX>, <P_SDA0_F_UART0_TX>;
12+
};
13+
};
14+
15+
/omit-if-no-ref/ sensor_spi_default: sensor_spi_default {
16+
group0 {
17+
pinmux = <P_SNR_MISO_F_SNR_MISO>, <P_SNR_MOSI_F_SNR_MOSI>,
18+
<P_SNR_CLK_F_SNR_CLK>;
19+
power-source = <IO_POWER_1V8>;
20+
bias-pull-down;
21+
};
22+
group1 {
23+
pinmux = <P_SNR_CS_F_SNR_CS>, <P_SNR_RST_F_SNR_RST>;
24+
power-source = <IO_POWER_1V8>;
25+
bias-pull-up;
26+
};
27+
};
28+
/omit-if-no-ref/ ssi_master_default: ssi_master_default {
29+
group0 {
30+
pinmux = <P_SSI_M_MISO_F_SSI_M_MISO>, <P_SSI_M_MOSI_F_SSI_M_MOSI>,
31+
<P_SSI_M_CS_F_SSI_M_CS>, <P_SSI_M_SCK_F_SSI_M_CLK>;
32+
bias-pull-down;
33+
};
34+
};
35+
};

‎boards/realtek/rts5817_maa_evb/rts5817_maa_evb.dts

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
/*
2+
* Copyright (c) 2024 Realtek Semiconductor, Inc.
3+
* SPDX-License-Identifier: Apache-2.0
4+
*/
5+
6+
/dts-v1/;
7+
#include <realtek/fingerprint/rts5817/rts5817.dtsi>
8+
#include "rts5817_maa_evb-pinctrl.dtsi"
9+
10+
/ {
11+
model = "Realtek rts5817_maa_evb";
12+
compatible = "realtek,rts5817_maa_evb";
13+
#address-cells = <1>;
14+
#size-cells = <1>;
15+
16+
chosen {
17+
zephyr,console = &uart0;
18+
zephyr,shell-uart = &uart0;
19+
};
20+
};
21+
22+
&clks {
23+
status = "okay";
24+
};
25+
26+
&reset {
27+
status = "okay";
28+
};
29+
30+
&watchdog {
31+
status = "okay";
32+
};
33+
34+
&uart0 {
35+
pinctrl-names = "default";
36+
pinctrl-0 = <&uart0_default>;
37+
current-speed = <57600>;
38+
status = "okay";
39+
};
40+
41+
&uart1 {
42+
status = "disabled";
43+
};

‎boards/realtek/rts5817_maa_evb/rts5817_maa_evb.yaml

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
identifier: rts5817_maa_evb
5+
name: RTS5817 Platform for fingerprint
6+
type: mcu
7+
arch: arm
8+
ram: 256
9+
flash: 2048
10+
toolchain:
11+
- zephyr
12+
- gnuarmemb
13+
testing:
14+
default: true
15+
vendor: realtek

‎boards/realtek/rts5817_maa_evb/rts5817_maa_evb_defconfig

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Copyright (c) 2024 Realtek Semiconductor, Inc.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
# enable clocks
5+
CONFIG_CLOCK_CONTROL=y
6+
7+
# enable reset
8+
CONFIG_RESET=y
9+
10+
# enable serial console
11+
CONFIG_SERIAL=y
12+
CONFIG_CONSOLE=y
13+
CONFIG_UART_CONSOLE=y
14+
15+
# enable watchdog
16+
CONFIG_WATCHDOG=y
17+
CONFIG_WDT_DISABLE_AT_BOOT=y

0 commit comments

Comments
 (0)