Merge pull request #430 from arduino/karlsoderby/r4-wifi-review

[UNO-R4-WiFi] WiFi final review

Author: karlsoderby

content/hardware/02.hero/boards/uno-r4-wifi/datasheet/datasheet.md

@@ -8,7 +8,7 @@ type: maker
 
 # Description 
 
-The Arduino® UNO R4 WiFi is the first UNO board to feature a 32-bit microcontroller and an ESP32-S3 Wi-Fi module (ESP32-S3-MINI-1-N8). It features a RA4M1 series microcontroller from Renesas (R7FA4M1AB3CFM#AA0), based on a 48MHz Arm® Cortex®-M4 microprocessor. The UNO R4's memory is much larger than its predecessors, with 256KB Flash & 32KB SRAM.
+The Arduino® UNO R4 WiFi is the first UNO board to feature a 32-bit microcontroller and an ESP32-S3 Wi-Fi module (ESP32-S3-MINI-1-N8). It features a RA4M1 series microcontroller from Renesas (R7FA4M1AB3CFM#AA0), based on a 48MHz Arm® Cortex®-M4 microprocessor. The UNO R4's memory is larger than its predecessors, with 256 kB flash, 32 kB SRAM and 8 kB of EEPROM.
 
 The RA4M1's operating voltage is fixed at 5V, whereas the ESP32-S3 module is 3.3V. Communication between these two MCUs are performed via a logic level translator (TXB0108DQSR).
 
@@ -17,9 +17,7 @@ Maker, beginner, education
 
 # Features
 
-## R7FA4M1AB3CFM#AA0
-
-The R7FA4M1AB3CFM#AA0 is the main MCU on the UNO R4 WiFi, connected to all pin headers on the board as well as all communication buses. Often referred to as RA4M1 in this datasheet.
+The **R7FA4M1AB3CFM#AA0** is the main MCU on the UNO R4 WiFi, connected to all pin headers on the board as well as all communication buses. Often referred to as RA4M1 in this datasheet.
 
 * **Overview**
   * 48MHz Arm® Cortex®-M4 microprocessor with a floating point unit (FPU)
@@ -28,9 +26,9 @@ The R7FA4M1AB3CFM#AA0 is the main MCU on the UNO R4 WiFi, connected to all pin h
   * Memory Protection Unit (MPU)
   * Digital Analog Converter (DAC)
 * **Memory**
-  * 256KB Flash Memory
-  * 32KB SRAM
-  * 8KB Data Memory (EEPROM)
+  * 256 kB Flash Memory
+  * 32 kB SRAM
+  * 8 kB Data Memory (EEPROM)
 * **Peripherals**
   * Capacitive Touch Sensing Unit (CTSU)
   * USB 2.0 Full-Speed Module (USBFS)
@@ -55,11 +53,9 @@ The R7FA4M1AB3CFM#AA0 is the main MCU on the UNO R4 WiFi, connected to all pin h
   * 1x CAN (pin D4, D5, external transceiver is required)
 
 See the full datasheet for the R7FA4M1AB3CFM#AA0 in the link below:
-- [R7FA4M1AB3CFM#AA0 datasheet](assets/ra4m1.pdf)
-
-## ESP32-S3-MINI-1-N8
+- [R7FA4M1AB3CFM#AA0 datasheet](/resources/datasheets/ra4m1.pdf)
 
-The ESP32-S3-MINI-1-N8 is the secondary MCU with a built-in antenna for Wi-Fi & Bluetooth® connectivity. This module operates on 3.3V and communicates with the RA4M1 using a logic level translator (TXB0108DQSR).
+The **ESP32-S3-MINI-1-N8** is the secondary MCU with a built-in antenna for Wi-Fi & Bluetooth® connectivity. This module operates on 3.3V and communicates with the RA4M1 using a logic level translator (TXB0108DQSR).
 
 * **Overview**
   * Xtensa® dual-core 32-bit LX7 microprocessor
@@ -73,19 +69,19 @@ The ESP32-S3-MINI-1-N8 is the secondary MCU with a built-in antenna for Wi-Fi &
   * Bluetooth 5
 
 See the full datasheet for the ESP32-S3-MINI-1-N8 in the link below:
-- [ESP32-S3-MINI-1-N8 datasheet](assets/esp32-s3-mini.pdf)
+- [ESP32-S3-MINI-1-N8 datasheet](/resources/datasheets/esp32-s3-mini.pdf)
 
 # CONTENTS
 
 ## The Board
 
 ### Application Examples
 
-The UNO R4 WiFi is part of the first UNO series of 32-bit development boards, being previously based on 8-bit AVR microcontrollers. There are thousands of guides, tutorials and books written about the UNO board, where UNO R4 WiFi continues it legacy.
+The UNO R4 WiFi is part of the first UNO series of 32-bit development boards, being previously based on 8-bit AVR microcontrollers. There are thousands of guides, tutorials and books written about the UNO board, where the UNO R4 WiFi continues it legacy.
 
-The board features the standard 14 digital I/O ports, 6 analog channels, dedicated pins for I²C, SPI and UART connections. It has compared to its predecessors much larger memory: 8 times more flash memory (256KB) and 16 times more SRAM (32KB).
+The board features 14 digital I/O ports, 6 analog channels, dedicated pins for I²C, SPI and UART connections. It has a significantly larger memory: 8 times more flash memory (256 kB) and 16 times more SRAM (32 kB). With a 48 MHz clock speed, it is also 3x faster than its predecessors.
 
-Additionally, it features an ESP32-S3 module for IoT projects, as well as a built-in 12x8 LED matrix, making it the most visually unique Arduino board to date.
+In addition, it features an ESP32-S3 module for Wi-Fi® & Bluetooth® connectivity, as well as a built-in 12x8 LED matrix, making one of the most visually unique Arduino board to date. The LED matrix is fully programmable, where you can load anything from still frames to custom animations.
 
 **Entry level projects:** If this is your first project within coding and electronics, the UNO R4 WiFi is a good fit. It is easy to get started with, has a lot of online documentation (both official + 3rd party).
 
@@ -96,6 +92,7 @@ Additionally, it features an ESP32-S3 module for IoT projects, as well as a buil
 ### Related Products
 * UNO R3
 * UNO R3 SMD
+* UNO R4 Minima
 
 # Rating
 
@@ -111,8 +108,6 @@ Additionally, it features an ESP32-S3 module for IoT projects, as well as a buil
 
 **Note:** V<sub>DD</sub> controls the logic level and is connected to the 5V power rail. V<sub>AREF</sub> is for the analog logic.
 
-<div style="page-break-after: always;"> </div>
-
 # Functional Overview
 
 ## Block Diagram
@@ -161,10 +156,10 @@ Additionally, it features an ESP32-S3 module for IoT projects, as well as a buil
 
 The UNO R4 WiFi is based on the 32-bit RA4M1 series microcontroller, **R7FA4M1AB3CFM#AA0**, from Renesas, which uses a 48MHz Arm® Cortex®-M4 microprocessor with a floating point unit (FPU).
 
-This microcontroller can operate on a range between 1.6V - 5.5V, but on the UNO R4 WiFi, it is fixed at 5V as to be fully retro compatible with other UNO accessories. 
+This microcontroller can operate on a range between 1.6V - 5.5V, but on the UNO R4 WiFi, it is fixed at 5V as to be hardware compatible with shields, accessories & circuits based on an previous UNO revision. 
 
 The R7FA4M1AB3CFM#AA0 features:
-* 256KB flash / 32KB SRAM / 8KB data flash (EEPROM)
+* 256 kB flash / 32 kB SRAM / 8 kB data flash (EEPROM)
 * Real Time Clock (RTC)
 * 4x Direct Memory Access Controller (DMAC) 
 * 14-bit ADC
@@ -181,8 +176,8 @@ The Wi-Fi / Bluetooth® LE module on the UNO R4 WiFi is from the ESP32-S3 SoCs.
 The ESP32-S3-MINI-1-N8 features:
 * Wi-Fi / Bluetooth® LE support
 * 3.3V operating voltage
-* 384 KB ROM
-* 512 KB SRAM
+* 384  kB ROM
+* 512  kB SRAM
 * Up to 150 Mbps bit rate
 
 This module acts as a secondary MCU on the UNO R4 WiFi, and communicates with the RA4M1 MCU using a logic level translator. Note that this module operates on 3.3V as opposed to the RA4M1's 5V operating voltage. 
@@ -208,7 +203,7 @@ When programming the UNO R4 WiFi, the RA4M1 MCU is programmed via the ESP32-S3 m
 
 ![](assets/usb_switch.png)
 
-Soldering together the `SJ1` pads permanently sets the USB communication directly to the RA4M1, bypassing the ESP32-S3. 
+Soldering together the **SJ1** pads permanently sets the USB communication directly to the RA4M1, bypassing the ESP32-S3.
 
 ## USB Connector
 
@@ -218,7 +213,7 @@ Note that you should not power the board with more than 5V via the USB-C® port.
 
 ## LED Matrix
 
-The UNO R4 WiFi features a 12x8=96 LED matrix (U_LEDMATRIX), connected using the charlieplexing technique. The LEDs are red.
+The UNO R4 WiFi features a 12x8 matrix of red LEDs (**U_LEDMATRIX**), connected using the charlieplexing technique.
 
 The following pins on the RA4M1 MCU is used for the matrix:
 - P003
@@ -243,11 +238,9 @@ This matrix can be used for a number of projects and prototyping purposes, and s
 
 ## Digital Analog Converter (DAC)
 
-The UNO R4 WiFi has one 8-bit & one 12-bit DAC attached to the A0 analog pin. A DAC is used to convert a digital signal to an analog signal. 
+The UNO R4 WiFi has a DAC with up to 12-bit resolution attached to the A0 analog pin. A DAC is used to convert a digital signal to an analog signal.
 
-The DAC is connected to 
-
-<div style="page-break-after: always;"> </div>
+The DAC can be used for signal generation for e.g. audio applications. You can for example generate and alter a sawtooth wave.  
 
 ## I²C Connector
 
@@ -285,11 +278,13 @@ The linear regulator (SGM2205-3.3XKC3G/TR) converts 5V from either the buck conv
 
 The general operating voltage for UNO R4 WiFi is 5V, however the ESP32-S3 module's operating voltage is 3.3V. 
 
+It is **very** important that ESP32-S3's pins (3.3V)do not come in contact with any of the RA4M1's pins (5V), as this may damage the circuits.
+
 ### Pin Current
 
-The GPIOs on the R7FA4M1AB3CFM#AA0 microcontroller can handle up to 20 mA. Never connect devices that draw higher current directly to a GPIO.
+The GPIOs on the R7FA4M1AB3CFM#AA0 microcontroller can safely handle up to 8 mA of current. Never connect devices that draw higher current directly to a GPIO as this may damage the circuit.
 
-For powering e.g. servo motors, use an external power supply.
+For powering e.g. servo motors, always use an external power supply.
 
 # Mechanical Information
 
@@ -318,26 +313,26 @@ For powering e.g. servo motors, use an external power supply.
 
 ### Digital
 
-| Pin | Function  | Type    | Description                                      |
-| --- | --------- | ------- | ------------------------------------------------ |
-| 1   | SCL       | Digital | I²C Serial Clock (SCL)                           |
-| 2   | SDA       | Digital | I²C Serial Datal (SDA)                           |
-| 3   | AREF      | Digital | Analog Reference Voltage                         |
-| 4   | GND       | Power   | Ground                                           |
-| 5   | D13/SCK   | Digital | GPIO 13 / SPI Clock                              |
-| 6   | D12/CIPO  | Digital | GPIO 12 / SPI Controller In Peripheral Out       |
-| 7   | D11/COPI  | Digital | GPIO 11 (PWM) / SPI Controller Out Peripheral In |
-| 8   | D10/CS    | Digital | GPIO 10 (PWM) / SPI Chip Select                  |
-| 9   | D9        | Digital | GPIO 9 (PWM~)                                    |
-| 10  | D8        | Digital | GPIO 8                                           |
-| 11  | D7        | Digital | GPIO 7                                           |
-| 12  | D6        | Digital | GPIO 6 (PWM~)                                    |
-| 13  | D5/CANRX0 | Digital | GPIO 5 (PWM~) / CAN Transmitter (TX)             |
-| 14  | D4/CANTX0 | Digital | GPIO 4 / CAN Receiver (RX)                       |
-| 15  | D3        | Digital | GPIO 3 (PWM~)                                    |
-| 16  | D2        | Digital | GPIO 2                                           |
-| 17  | D1/TX0    | Digital | GPIO 1 / Serial 0 Transmitter (TX)               |
-| 18  | D0/TX0    | Digital | GPIO 0 / Serial 0 Receiver    (RX)               |
+| Pin | Function       | Type    | Description                                            |
+| --- | -------------- | ------- | ------------------------------------------------------ |
+| 1   | SCL            | Digital | I²C Serial Clock (SCL)                                 |
+| 2   | SDA            | Digital | I²C Serial Datal (SDA)                                 |
+| 3   | AREF           | Digital | Analog Reference Voltage                               |
+| 4   | GND            | Power   | Ground                                                 |
+| 5   | D13/SCK/CANRX0 | Digital | GPIO 13 / SPI Clock / CAN Receiver (RX)                |
+| 6   | D12/CIPO       | Digital | GPIO 12 / SPI Controller In Peripheral Out             |
+| 7   | D11/COPI       | Digital | GPIO 11 (PWM) / SPI Controller Out Peripheral In       |
+| 8   | D10/CS/CANTX0  | Digital | GPIO 10 (PWM) / SPI Chip Select / CAN Transmitter (TX) |
+| 9   | D9             | Digital | GPIO 9 (PWM~)                                          |
+| 10  | D8             | Digital | GPIO 8                                                 |
+| 11  | D7             | Digital | GPIO 7                                                 |
+| 12  | D6             | Digital | GPIO 6 (PWM~)                                          |
+| 13  | D5             | Digital | GPIO 5 (PWM~)                                          |
+| 14  | D4             | Digital | GPIO 4                                                 |
+| 15  | D3             | Digital | GPIO 3 (PWM~)                                          |
+| 16  | D2             | Digital | GPIO 2                                                 |
+| 17  | D1/TX0         | Digital | GPIO 1 / Serial 0 Transmitter (TX)                     |
+| 18  | D0/TX0         | Digital | GPIO 0 / Serial 0 Receiver    (RX)                     |
 
 ### OFF
 
@@ -359,29 +354,10 @@ For powering e.g. servo motors, use an external power supply.
 | 5   | RESET    | Internal | Reset                        |
 | 6   | GND      | Internal | Ground                       |
 
-
-### SWD/JTAG
-
-| Pin | Function | Type     | Description        |
-| --- | -------- | -------- | ------------------ |
-| 1   | +5V      | Internal | Power Supply of 5V |
-| 2   | SWDIO    | Internal | Data I/O pin       |
-| 3   | GND      | Internal | Ground             |
-| 4   | SWCLK    | Internal | Clock Pin          |
-| 5   | GND      | Internal | Ground             |
-| 6   | NC       | Internal | Not connected      |
-| 7   | RX       | Internal | Serial Receiver    |
-| 8   | TX       | Internal | Serial Transmitter |
-| 9   | GND      | Internal | Ground             |
-| 10  | NC       | Internal | Not connected      |
-
-
 ## Mounting Holes And Board Outline
 
 ![Mechanical View of Arduino UNO R4 WiFi](assets/mechanicalDrawingwWiFi.svg)
 
-<div style="page-break-after: always;"> </div>
-
 ## Board Operation
 
 ### Getting Started - IDE
@@ -481,10 +457,6 @@ Lors de l’ installation et de l’ exploitation de ce dispositif, la distance
 
 Hereby, Arduino S.r.l. declares that this product is in compliance with essential requirements and other relevant provisions of Directive 201453/EU. This product is allowed to be used in all EU member states.
 
-| Frequency bands      | Maximum output power (ERP) |
-| -------------------- | -------------------------- |
-| 2.4 GHz, 40 channels | TBD                        |
-
 ## Company Information
 
 | Company name    | Arduino SRL                                  |
@@ -507,4 +479,4 @@ Hereby, Arduino S.r.l. declares that this product is in compliance with essentia
 
 | **Date**   | **Changes** |
 | ---------- | ----------- |
-| 25/04/2023 | Release     |
+| 08/06/2023 | Release     |

content/hardware/02.hero/boards/uno-r4-wifi/downloads/ABX00087-datasheet.pdf

@@ -1,10 +1,8 @@
 <FeatureDescription>
 
-The Arduino UNO R4 WiFi is a 32-bit development board based on the high performance Renesas RA4M1 (Arm Cortex®-M4). It has 14 digital input/output pins (of which 6 can be used as PWM outputs), 6 analog inputs, a clock speed of 48 MHz, a USB-C® connection, as well as pins featuring SPI, I2C and one CAN bus.
+The MCU on the board is the high performance Renesas RA4M1 (Arm Cortex®-M4) with a 48 MHz clock speed, 32 kB SRAM and 256 kB flash memory. This MCU features an RTC, a DAC and a CAN bus and has support for HID via USB.
 
-The UNO R4 WiFi features a total of 32 KB of SRAM and an additional 256 KB of flash memory. It also has a DAC pin which can be used to create more complex sound outputs and being part of the UNO family it comes with the perks of having a wide range of compatibilities regarding shields and libraries.
-
-On top of all of this it comes fitted with a secondary microcontroller, the ESP32-S3, that gives the board Wi-Fi® and Bluetooth® functionality, and an 8x12 programmable LED matrix to display anything you want. 
+The UNO R4 WiFi also features an ESP32-S3 for Wi-Fi®/Bluetooth® connectivity, which can also be separately programmed via a specific header.
 
 </FeatureDescription>
 
@@ -15,29 +13,32 @@ A reference to all technical features on this board, with pointers to additional
 <FeatureLink title="Cheat Sheet" url="/tutorials/uno-r4-wifi/cheat-sheet"/>
 </Feature>
 
-<Feature title="Getting Started" image="mcu">
-Get off the ground and upload your first program to your new UNO R4 WiFi board by following this guide.
-<FeatureLink title="Getting Started Guide" url="/tutorials/uno-r4-wifi/r4-wifi-getting-started"/>
+<Feature title="5V Operating Voltage" image="power">
+The RA4M1 and the GPIOs of this board operates on 5V!
 </Feature>
 
 <Feature title="LED Matrix" image="led">
-Learn the basic principles of creating animations and graphics on the UNO R4 WiFi's built in LED matrix with this guide.
-
+Learn how to create animations and graphics on the 12x8 LED matrix.
 <FeatureLink title="LED Matrix Guide" url="/tutorials/uno-r4-wifi/led-matrix"/>
 </Feature>
 
-<Feature title="6-24V" image="power">
-Power your UNO R4 WiFi board through the VIN Pin with any voltage between 6-24V.
+<Feature title="Real-Time Clock (RTC)" image="mcu">
+Keep track of time & date and set alarms with the built-in RTC.
+<FeatureLink title="Documentation" url="/tutorials/uno-r4-wifi/rtc"/>
 </Feature>
 
-<Feature title="ESP32" image="wifi-bluetooth">
-Use the onboard ESP32-S3 to build connected projects using its Bluetooth® and Wi-Fi® features.
-
+<Feature title="Digital-to-Analog Converter (DAC)" image="mcu">
+Use the onboard 12-bit DAC to build sophisticated audio projects.
+<FeatureLink title="Documentation" url="/tutorials/uno-r4-wifi/dac"/>
 </Feature>
-<Feature title="DAC" image="configurability">
-Use the onboard 12bit DAC to build sophisticated audio projects.
 
+<Feature title="Mouse/Keyboard Emulation (HID)" image="usb">
+Build game controllers by emulating a mouse/keyboard.
+<FeatureLink title="Documentation" url="/tutorials/uno-r4-wifi/usb-hid"/>
 </Feature>
 
+<Feature title="Input Voltage" image="power">
+Power your the VIN pin/barrel jack at up to 6-24V.
+</Feature>
 
 </FeatureList>

content/hardware/02.hero/boards/uno-r4-wifi/features.md

@@ -5,6 +5,4 @@ url_guide: /tutorials/uno-r4/uno-r4-getting-started
 core: arduino:renesas
 ---
 
-The Arduino UNO has long been the best board to get started with electronics and coding. And the UNO R4 WiFi brings with it, apart from the upgrades to clock speed, an easy entry point to developing IoT-devices and other connectivity projects thanks to its Wi-Fi® and Bluetooth® functionality.
-
-The UNO is the most used and documented board of the whole Arduino family, and in this flavour the UNO can do more than ever. 
+The Arduino UNO R4 WiFi is designed around the 32-bit microcontroller RA4M1 from [Renesas](https://www.renesas.com/us/en) while also featuring a ESP32 module for Wi-Fi® and Bluetooth® connectivity. Its distinctive 12x8 LED matrix makes it possible to prototype visuals directly on the board, and with a QWIIC connector, you can create projects plug-and-play style.

content/hardware/02.hero/boards/uno-r4-wifi/product.md

@@ -15,13 +15,15 @@ Communication:
   SPI: Yes, 1x
   CAN: Yes 1 CAN Bus
 Power:
-  Circuit operating voltage: 5V
+  Circuit operating voltage: 5V (ESP32-S3 is 3.3V)
   Input voltage (VIN): 6-24V
   DC Current per I/O Pin: 8 mA
 Clock speed:
-  Main core: 48 MHz
+  RA4M1: 48 MHz
+  ESP32-S3: up to 240 MHz
 Memory:
-  RA4M1: 256kB Flash, 32kB RAM
+  RA4M1: 256 kB Flash, 32 kB RAM
+  ESP32-S3: 384 kB ROM, 512 kB SRAM
 Dimensions:
   Width: 68.85 mm
   Length: 53.34 mm