Skip to content

Commit acaf762

Browse files
JasonLin-RealTeknordicjm
JasonLin-RealTek
authored and
nordicjm
committed
[nrf fromtree] boards: realtek: Add rts5912_evb board
Add support for Realtek rts5912_evb board Signed-off-by: Adam Kondraciuk <[email protected]> (cherry picked from commit 7762d3e) Signed-off-by: Lin Yu-Cheng <[email protected]>
1 parent f796c26 commit acaf762

File tree

10 files changed

+199
-0
lines changed

10 files changed

+199
-0
lines changed

‎boards/realtek/index.rst‎

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

‎boards/realtek/rts5912_evb/Kconfig.defconfig‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# SPDX-License-Identifier: Apache-2.0
2+
#
3+
# Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
4+
#

‎boards/realtek/rts5912_evb/Kconfig.rts5912_evb‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# SPDX-License-Identifier: Apache-2.0
2+
#
3+
# Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
4+
#
5+
6+
config BOARD_RTS5912_EVB
7+
select SOC_RTS5912

‎boards/realtek/rts5912_evb/board.cmake‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# SPDX-License-Identifier: Apache-2.0
2+
#
3+
# Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
4+
#
5+
6+
include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)

‎boards/realtek/rts5912_evb/board.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
board:
2+
name: rts5912_evb
3+
vendor: realtek
4+
socs:
5+
- name: rts5912

‎boards/realtek/rts5912_evb/doc/rts5912_evb.rst‎

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
.. _rts5912_evb:
2+
3+
Realtek RTS5912 Evaluation Board
4+
################################
5+
6+
Overview
7+
********
8+
9+
The RTS5912 EVB is a development platform to evaluate the Realtek RTS5912 embedded controller.
10+
11+
.. figure:: rts5912evb.webp
12+
:width: 800px
13+
:align: center
14+
:alt: RTS5912-GR EVB
15+
16+
Hardware
17+
********
18+
19+
- Realtek-M300 Processor (compatible to Cortex-M33)
20+
- Memory:
21+
22+
- 384 KB SRAM
23+
- 64 KB ROM
24+
- 512 KB Flash(MCM)
25+
- 256 B Battery SRAM
26+
- PECI interface 3.1
27+
- FAN, PWM and TACHO pins
28+
- 6x I2C instances
29+
- eSPI header
30+
- 1x PS/2 ports
31+
- Keyboard interface headers
32+
33+
For more information about the evb board please see `RTS5912_EVB_Schematics`_ and `RTS5912_DATASHEET`_
34+
35+
The board is powered through the +5V USB Type-C connector or adaptor.
36+
37+
Supported Features
38+
==================
39+
40+
The ``rts5912_evb`` supports the following hardware features:
41+
42+
+-----------+------------+-------------------------------------+
43+
| Interface | Controller | Driver/Component |
44+
+===========+============+=====================================+
45+
| NVIC | on-chip | nested vector interrupt controller |
46+
+-----------+------------+-------------------------------------+
47+
| UART | on-chip | serial |
48+
+-----------+------------+-------------------------------------+
49+
| GPIO | on-chip | gpio |
50+
+-----------+------------+-------------------------------------+
51+
| PINCTRL | on-chip | pinctrl |
52+
+-----------+------------+-------------------------------------+
53+
| SCCON | on-chip | clock_control |
54+
+-----------+------------+-------------------------------------+
55+
| RTMR | on-chip | timer |
56+
+-----------+------------+-------------------------------------+
57+
58+
Other hardware features are not currently supported by Zephyr.
59+
60+
Programming and Debugging
61+
*************************
62+
63+
Building
64+
========
65+
66+
#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
67+
68+
#. The file ``zephyr.rts5912.bin`` will be created if the build system can build successfully.
69+
This binary image can be found under file "build/zephyr/".
70+
71+
Flashing
72+
========
73+
74+
#. Connect Dediprog into header ``J81`` and ``J82``.
75+
#. Use Dediprog SF600 programmer to write the binary into the external flash ``U10`` at the address 0x0.
76+
#. Power off the board.
77+
#. Set the strap pin ``GPIO108`` to high and power on the board.
78+
79+
Debugging
80+
=========
81+
82+
Using SWD or JTAG with ULINPRO.
83+
84+
References
85+
**********
86+
87+
.. target-notes::
88+
89+
.. _RTS5912_EVB_Schematics:
90+
https://github.com/JasonLin-RealTek/Realtek_EC/blob/main/RTS5912_EVB_Schematic_Ver%201.1_20240701_1407.pdf
91+
92+
.. _RTS5912_DATASHEET:
93+
https://github.com/JasonLin-RealTek/Realtek_EC/blob/main/RTS5912_datasheet_brief.pdf

‎boards/realtek/rts5912_evb/doc/rts5912evb.webp‎

81 KB
Loading

‎boards/realtek/rts5912_evb/rts5912_evb.dts‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
/*
2+
* SPDX-License-Identifier: Apache-2.0
3+
*
4+
* Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
5+
*
6+
*/
7+
8+
/dts-v1/;
9+
#include <realtek/ec/rts5912.dtsi>
10+
#include <realtek/ec/rts5912-pinctrl.dtsi>
11+
#include <zephyr/dt-bindings/gpio/gpio.h>
12+
/ {
13+
model = "Realtek RTS5912 Evaluation Board";
14+
compatible = "realtek,rts5912-evb";
15+
16+
chosen {
17+
zephyr,sram = &sram0;
18+
zephyr,console = &uart0;
19+
zephyr,flash = &flash0;
20+
};
21+
};
22+
23+
&uart0 {
24+
status = "okay";
25+
current-speed = <115200>;
26+
};
27+
28+
&uart0_wrapper {
29+
status = "okay";
30+
pinctrl-0 = <&uart_rx_gpio113 &uart_tx_gpio114>;
31+
pinctrl-names = "default";
32+
};
33+
34+
&swj_port {
35+
status = "okay";
36+
};

‎boards/realtek/rts5912_evb/rts5912_evb.yaml‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# SPDX-License-Identifier: Apache-2.0
2+
#
3+
# Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
4+
#
5+
6+
identifier: rts5912_evb
7+
name: RTS5912-EVB
8+
type: mcu
9+
arch: arm
10+
toolchain:
11+
- zephyr
12+
- gnuarmemb
13+
- xtools
14+
ram: 64
15+
flash: 320
16+
supported:
17+
- gpio
18+
- pinmux
19+
vendor: realtek

‎boards/realtek/rts5912_evb/rts5912_evb_defconfig‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# SPDX-License-Identifier: Apache-2.0
2+
#
3+
# Copyright (c) 2024 Realtek Semiconductor Corporation, SIBG-SD7
4+
#
5+
6+
# Enable RTS5912 image tool
7+
CONFIG_REALTEK_RTS5912_BOOTROM_HEADER=y
8+
9+
# Serial Driver
10+
CONFIG_SERIAL=y
11+
CONFIG_UART_NS16550=y
12+
CONFIG_UART_INTERRUPT_DRIVEN=y
13+
14+
# Console
15+
CONFIG_CONSOLE=y
16+
CONFIG_UART_CONSOLE=y
17+
18+
# Enable GPIO
19+
CONFIG_GPIO=y

0 commit comments

Comments
 (0)