1.. zephyr:board:: fpb_rx261
2
3Overview
4********
5
6The FPB-RX261 is a Fast Prototyping Board for the Renesas RX261 MCU Group, designed to
7evaluate features of the RX261 family and accelerate embedded system development. The board
8includes native MCU pin access, integrated debugger, power flexibility, and expansion connectors.
9
10The key features of the FPB-RX261 board are categorized in two groups:
11
12**MCU Native Pin Access**
13
14- R5F52618BGFP MCU
15- 64 MHz Renesas RXv3-based RX261 MCU in 100-pin LFQFP package
16- 512 KB Code Flash, 8 KB Data Flash, 128 KB RAM
17- Native pin access through 2 x 50-pin male headers (not fitted)
18- MCU current measurement point for precision current consumption measurement
19- RX MCU on-chip oscillators as main clock
20- Providing 32.768 kHz crystal oscillator as sub clock
21
22**System Control and Ecosystem Access**
23
24- 5V input sources:
25
26  - USB (USB DEBUG1 - J5)
27  - External 5V via 2-pin header (J8)
28
29- On-board debugger via E2 Emulator OB (FINE interface)
30
31- User LEDs:
32
33  - 2 Green User LEDs (PJ1, PC5)
34  - 1 Green Power LED
35  - 1 Yellow Debug LED
36
37- User Buttons:
38
39  - 1 User Switch (S1 - P32)
40  - 1 Reset Switch (S2)
41
42- Popular expansion connectors:
43
44  - 2x Digilent Pmod connectors (J13, J14 - UART/SPI/I2C)
45  - Arduino Uno R3-compatible header (J9-J12)
46
47Hardware
48********
49
50Detailed hardware features can be found at:
51- RX261 MCU: `RX261 Group User's Manual Hardware`_.
52- FPB-RX261 board: `FPB-RX261 - User's Manual`_.
53
54Supported Features
55==================
56
57.. zephyr:board-supported-hw::
58
59Other hardware features are currently not supported by the port.
60
61Programming and Debugging
62*************************
63
64.. zephyr:board-supported-runners::
65
66Applications for the ``fpb_rx261`` board can be built, flashed, and debugged using standard Zephyr workflows.
67Refer to :ref:`build_an_application` and :ref:`application_run` for more details.
68
69**Note:** Currently, the RX261 is built and programmed using the Renesas GCC RX toolchain.
70Please follow the steps below to program it onto the board:
71
72  - Download and install GCC for RX toolchain:
73
74    https://llvm-gcc-renesas.com/rx-download-toolchains/
75
76  - Set env variable:
77
78   .. code-block:: console
79
80      export ZEPHYR_TOOLCHAIN_VARIANT=cross-compile
81      export CROSS_COMPILE=<Path/to/your/toolchain>/bin/rx-elf-
82
83  - Build the Blinky Sample for FPB-RX261
84
85   .. code-block:: console
86
87      cd ~/zephyrproject/zephyr
88      west build -p always -b fpb_rx261 samples/basic/blinky
89
90Flashing
91========
92
93The program can be flashed to FPB-RX261 via the on-board **E2 Emulator OB**.
94
95- **Renesas Flash Programmer (RFP)** can be used with the on-board debugger
96  https://www.renesas.com/software-tool/renesas-flash-programmer-programming-gui
97
981. **Connect the board:**
99
100   - Use USB DEBUG1 (J5) to connect the on-board E2 Emulator to the PC
101
1022. **Configure jumpers for flashing:**
103
104   - J4: Jumper on pins **2-3** (enable E2 OB)
105   - J7: Jumper on pins **1-2** (3.3V system voltage)
106
1073. **Run flashing command:**
108
109   .. code-block:: console
110
111      west flash
112
113   Or use Renesas Flash Programmer with settings:
114   - Debugger: E2 Emulator Lite
115   - Interface: FINE
116   - MCU: R5F52618
117
118Debugging
119=========
120
121Debugging is supported via:
122
123- **On-board E2 Emulator OB** using USB DEBUG1 (J5)
124
125To use debugger:
126
127- J4: Jumper on pins **2-3** (enable E2 OB)
128- J7: Jumper on pins **1-2** (3.3V)
129- LED4 (Yellow) indicates debugger status
130
131**Note:** Only one FPB-RX261 board can be debugged per PC at a time using E2 OB.
132
133References
134**********
135- `FPB-RX261 Website`_
136- `RX261 MCU group Website`_
137
138.. _FPB-RX261 Website:
139   https://www.renesas.com/en/design-resources/boards-kits/fpb-rx261
140
141.. _RX261 MCU group Website:
142   https://www.renesas.com/en/products/rx261
143
144.. _FPB-RX261 - User's Manual:
145   http://renesas.com/en/document/mat/fpb-rx261-v1-users-manual?r=25565483
146
147.. _RX261 Group User's Manual Hardware:
148   https://www.renesas.com/en/document/mah/rx260-group-rx261-group-users-manual-hardware?r=25565707
149