1.. _ek_ra4w1:
2
3RA4W1 Evaluation Kit
4####################
5
6Overview
7********
8
9The Renesas RA4W1 is the first Bluetooth® 5.0 Low Energy fully compliant with 2Mbit High-Throughput
10(HT) and Long Range support in a single chip MCU of Renesas RA4  product series for IoT applications
11that require a high-performance Arm® Cortex®-M4 core at a very attractive price point. The RA4W1 MCU
12has full function support for Bluetooth 5.0 Low Energy long-range and mesh networking, and provides
13excellent reception performance. RA4W1 is geared towards IoT application requiring Security, large
14embedded RAM and low power consumption.
15
16**MCU Native Pin Access**
17- R7FA4W1AD2CNG
18- QFN-56 package
19- On-chip memory: 512-KB ROM, 96-KB RAM, 8-KB data flash memory
20
21**Power-supply voltage**
22- USB connector: 5-V input
23- Power-supply IC: 5-V input, 3.3-V output
24- External power-supply header*1: 3.3-V input, 2 pins x 1
25
26**Main clock**
27- Crystal oscillator (surface-mount technology (SMT)) for the main system clock
28- Crystal oscillator or ceramic resonator (lead type) for the main system clock
29
30**Sub-clock**
31- Crystal oscillator (SMT) for the sub-clock
32
33**Bluetooth Low Energy**
34- Bluetooth Low Energy (BLE) circuit x1
35- Range of frequency: 2402 to 2480 MHz
36- Maximum transmission output power: 4 dBm (in 4-dBm output mode)
37- Output variation: +2 dB
38
39**Push switches**
40- Reset switch x 1
41- User switch x 1
42
43**LED**
44- Power indicator: green x 1
45- User: green x 2
46- ACT LED: green x 1
47
48**Conetivity**
49- Connector for an on-board emulator: USB Micro-B
50- Connector for a USB serial-conversion interface: USB Micro-B
51- Pmod™ connector: Angle type, 12 pins
52- Arduino™ UNO connectors
53
54- Emulator reset switch
55
56.. figure:: ek_ra4w1.webp
57	:align: center
58	:alt: RA4W1 Evaluation Kit
59
60	EK-RA4W1 Board Functional Area Definitions (Credit: Renesas Electronics Corporation)
61
62Hardware
63********
64Detail Hardware feature for the RA4W1 MCU group can be found at `RA4W1 Group User's Manual Hardware`_
65
66.. figure:: ra4w1_block_diagram.webp
67	:width: 442px
68	:align: center
69	:alt: RA4W1 MCU group feature
70
71	RA4W1 Block diagram (Credit: Renesas Electronics Corporation)
72
73Detail Hardware feature for the EK-RA4W1 MCU can be found at `EK-RA4W1 - User's Manual`_
74
75Supported Features
76==================
77
78The below features are currently supported on Zephyr OS for EK-RA4W1 board:
79
80+-----------+------------+----------------------+
81| Interface | Controller | Driver/Component     |
82+===========+============+======================+
83| GPIO      | on-chip    | gpio                 |
84+-----------+------------+----------------------+
85| MPU       | on-chip    | arch/arm             |
86+-----------+------------+----------------------+
87| NVIC      | on-chip    | arch/arm             |
88+-----------+------------+----------------------+
89| UART      | on-chip    | serial               |
90+-----------+------------+----------------------+
91| CLOCK     | on-chip    | clock control        |
92+-----------+------------+----------------------+
93| SPI       | on-chip    | spi                  |
94+-----------+------------+----------------------+
95| COUNTER   | on-chip    | counter              |
96+-----------+------------+----------------------+
97| ENTROPY   | on-chip    | entropy              |
98+-----------+------------+----------------------+
99| ADC       | on-chip    | adc                  |
100+-----------+------------+----------------------+
101| PWM       | on-chip    | pwm                  |
102+-----------+------------+----------------------+
103| I2C       | on-chip    | i2c                  |
104+-----------+------------+----------------------+
105
106Other hardware features are currently not supported by the port.
107
108Programming and Debugging
109*************************
110
111Applications for the ``ek_ra4w1`` board target configuration can be
112built, flashed, and debugged in the usual way. See
113:ref:`build_an_application` and :ref:`application_run` for more details on
114building and running.
115
116Flashing
117========
118
119Program can be flashed to EK-RA4W1 via the on-board SEGGER J-Link debugger.
120SEGGER J-link's drivers are avaialbe at https://www.segger.com/downloads/jlink/
121
122To flash the program to board
123
124  1. Connect to J-Link OB via USB port to host PC
125
126  2. Make sure J-Link OB jumper is in default configuration as describe in `EK-RA4W1 - User's Manual`_
127
128  3. Execute west command
129
130	.. code-block:: console
131
132		west flash -r jlink
133
134Debugging
135=========
136
137You can use Segger Ozone (`Segger Ozone Download`_) for a visual debug interface
138
139Once downloaded and installed, open Segger Ozone and configure the debug project
140like so:
141
142* Target Device: R7FA4W1AD
143* Target Interface: SWD
144* Target Interface Speed: 4 MHz
145* Host Interface: USB
146* Program File: <path/to/your/build/zephyr.elf>
147
148**Note:** It's verified that we can debug OK on Segger Ozone v3.30d so please use this or later
149version of Segger Ozone
150
151References
152**********
153- `EK-RA4W1 Website`_
154- `RA4W1 MCU group Website`_
155
156.. _EK-RA4W1 Website:
157   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra4w1-evaluation-kit-ra4w1-mcu-group
158
159.. _RA4W1 MCU group Website:
160   https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra4w1-low-energy-single-chip-32-bit-microcontrollers-48mhz-bluetooth-50
161
162.. _EK-RA4W1 - User's Manual:
163   https://www.renesas.com/us/en/document/man/ek-ra4w1-users-manual
164
165.. _RA4W1 Group User's Manual Hardware:
166   https://www.renesas.com/us/en/document/man/renesas-ra4w1-group-users-manual-hardware
167
168.. _Segger Ozone Download:
169   https://www.segger.com/downloads/jlink#Ozone
170