boards/weact/esp32c6_mini/doc/index.rst - third_party/github/zephyrproject-rtos/zephyr - Git at Google

 .. zephyr:board:: weact_esp32c6_mini

 Overview
 ********

 WeAct ESP32-C6 Mini is a compact development board based on ESP32-C6FH4 chip with integrated
 4 MB flash. This board integrates complete Wi-Fi, Bluetooth LE, Zigbee, and Thread functions.

 For more information, check `WeAct ESP32-C6 Mini`_.

 Hardware
 ********

 ESP32-C6 is Espressif's first Wi-Fi 6 SoC integrating 2.4 GHz Wi-Fi 6, Bluetooth 5.3 (LE) and the
 802.15.4 protocol. It consists of a high-performance (HP) 32-bit RISC-V processor, which can be
 clocked up to 160 MHz, and a low-power (LP) 32-bit RISC-V processor, which can be clocked up to 20 MHz.
 It has a 320KB ROM, a 512KB SRAM, and works with external flash.

 The WeAct ESP32-C6 Mini is a compact board with the ESP32-C6FH4 chip directly mounted, featuring
 a 4 MB SPI flash. The board includes a USB Type-C connector, boot and reset buttons, and an RGB LED.

 ESP32-C6FH4 is part of the ESP32-C6 series in a QFN32 (5x5 mm) package with in-package flash.

 Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing.

 ESP32-C6 includes the following features:

 - 32-bit core RISC-V microcontroller with a clock speed of up to 160 MHz
 - 400 KB of internal RAM
 - WiFi 802.11 ax 2.4GHz
 - Fully compatible with IEEE 802.11b/g/n protocol
 - Bluetooth LE: Bluetooth 5.3 certified
 - Internal co-existence mechanism between Wi-Fi and Bluetooth to share the same antenna
 - IEEE 802.15.4 (Zigbee and Thread)

 Digital interfaces:

 - 22x GPIOs
 - 2x UART
 - 1x Low-power (LP) UART
 - 1x SPI (SPI2)
 - 1x I2C
 - 1x Low-power (LP) I2C
 - 1x I2S
 - 1x Pulse counter
 - 1x USB Serial/JTAG controller
 - 1x TWAI® controllers, compatible with ISO 11898-1 (CAN Specification 2.0)
 - 1x SDIO 2.0 slave controller
 - LED PWM controller, up to 6 channels
 - 1x Motor control PWM (MCPWM)
 - 1x Remote control peripheral
 - 1x Parallel IO interface (PARLIO)
 - General DMA controller (GDMA), with 3 transmit channels and 3 receive channels
 - Event task matrix (ETM)

 Analog interfaces:

 - 1x 12-bit SAR ADCs, up to 7 channels
 - 1x temperature sensor

 Timers:

 - 1x 52-bit system timer
 - 1x 54-bit general-purpose timers
 - 3x Watchdog timers
 - 1x Analog watchdog timer

 Low Power:

 - Four power modes: Active, Modem-sleep, Light-sleep, Deep-sleep

 Security:

 - Secure boot
 - Flash encryption
 - 4-Kbit OTP, up to 1792 bits for users
 - Cryptographic hardware acceleration: (AES-128/256, ECC, HMAC, RSA, SHA, Digital signature, Hash)
 - Random number generator (RNG)

 For more information, check the datasheet at `ESP32-C6 Datasheet`_ or the technical reference
 manual at `ESP32-C6 Technical Reference Manual`_.

 Supported Features
 ==================

 .. zephyr:board-supported-hw::

 System Requirements
 *******************

 Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command
 below to retrieve those files.

 .. code-block:: console

    west blobs fetch hal_espressif

 .. note::

    It is recommended running the command above after :file:`west update`.

 Programming and Debugging
 *************************

 .. zephyr:board-supported-runners::

 .. include:: ../../../espressif/common/building-flashing.rst
    :start-after: espressif-building-flashing

 Debugging
 =========

 .. include:: ../../../espressif/common/openocd-debugging.rst
    :start-after: espressif-openocd-debugging

 Low-Power CPU (LP CORE)
 ***********************

 The ESP32-C6 SoC has two RISC-V cores: the High-Performance Core (HP CORE) and the Low-Power Core (LP CORE).
 The LP Core features ultra low power consumption, an interrupt controller, a debug module and a system bus
 interface for memory and peripheral access.

 The LP Core is in sleep mode by default. It has two application scenarios:

 - Power insensitive scenario: When the High-Performance CPU (HP Core) is active, the LP Core can assist the HP CPU with some speed and efficiency-insensitive controls and computations.
 - Power sensitive scenario: When the HP CPU is in the power-down state to save power, the LP Core can be woken up to handle some external wake-up events.

 The LP Core support is fully integrated with :ref:`sysbuild`. The user can enable the LP Core by adding
 the following configuration to the project:

 .. code:: cfg

    CONFIG_ULP_COPROC_ENABLED=y

 See :zephyr:code-sample-category:`lp-core` folder as code reference.

 References
 **********

 .. target-notes::

 .. _`WeAct ESP32-C6 Mini`: https://github.com/WeActStudio/WeActStudio.ESP32C6-MINI
 .. _`ESP32-C6 Datasheet`: https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf
 .. _`ESP32-C6 Technical Reference Manual`: https://espressif.com/sites/default/files/documentation/esp32-c6_technical_reference_manual_en.pdf
 .. _`OpenOCD ESP32`: https://github.com/espressif/openocd-esp32/releases
	.. zephyr:board:: weact_esp32c6_mini

	Overview
	********

	WeAct ESP32-C6 Mini is a compact development board based on ESP32-C6FH4 chip with integrated
	4 MB flash. This board integrates complete Wi-Fi, Bluetooth LE, Zigbee, and Thread functions.

	For more information, check `WeAct ESP32-C6 Mini`_.

	Hardware
	********

	ESP32-C6 is Espressif's first Wi-Fi 6 SoC integrating 2.4 GHz Wi-Fi 6, Bluetooth 5.3 (LE) and the
	802.15.4 protocol. It consists of a high-performance (HP) 32-bit RISC-V processor, which can be
	clocked up to 160 MHz, and a low-power (LP) 32-bit RISC-V processor, which can be clocked up to 20 MHz.
	It has a 320KB ROM, a 512KB SRAM, and works with external flash.

	The WeAct ESP32-C6 Mini is a compact board with the ESP32-C6FH4 chip directly mounted, featuring
	a 4 MB SPI flash. The board includes a USB Type-C connector, boot and reset buttons, and an RGB LED.

	ESP32-C6FH4 is part of the ESP32-C6 series in a QFN32 (5x5 mm) package with in-package flash.

	Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing.

	ESP32-C6 includes the following features:

	- 32-bit core RISC-V microcontroller with a clock speed of up to 160 MHz
	- 400 KB of internal RAM
	- WiFi 802.11 ax 2.4GHz
	- Fully compatible with IEEE 802.11b/g/n protocol
	- Bluetooth LE: Bluetooth 5.3 certified
	- Internal co-existence mechanism between Wi-Fi and Bluetooth to share the same antenna
	- IEEE 802.15.4 (Zigbee and Thread)

	Digital interfaces:

	- 22x GPIOs
	- 2x UART
	- 1x Low-power (LP) UART
	- 1x SPI (SPI2)
	- 1x I2C
	- 1x Low-power (LP) I2C
	- 1x I2S
	- 1x Pulse counter
	- 1x USB Serial/JTAG controller
	- 1x TWAI® controllers, compatible with ISO 11898-1 (CAN Specification 2.0)
	- 1x SDIO 2.0 slave controller
	- LED PWM controller, up to 6 channels
	- 1x Motor control PWM (MCPWM)
	- 1x Remote control peripheral
	- 1x Parallel IO interface (PARLIO)
	- General DMA controller (GDMA), with 3 transmit channels and 3 receive channels
	- Event task matrix (ETM)

	Analog interfaces:

	- 1x 12-bit SAR ADCs, up to 7 channels
	- 1x temperature sensor

	Timers:

	- 1x 52-bit system timer
	- 1x 54-bit general-purpose timers
	- 3x Watchdog timers
	- 1x Analog watchdog timer

	Low Power:

	- Four power modes: Active, Modem-sleep, Light-sleep, Deep-sleep

	Security:

	- Secure boot
	- Flash encryption
	- 4-Kbit OTP, up to 1792 bits for users
	- Cryptographic hardware acceleration: (AES-128/256, ECC, HMAC, RSA, SHA, Digital signature, Hash)
	- Random number generator (RNG)

	For more information, check the datasheet at `ESP32-C6 Datasheet`_ or the technical reference
	manual at `ESP32-C6 Technical Reference Manual`_.

	Supported Features
	==================

	.. zephyr:board-supported-hw::

	System Requirements
	*******************

	Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command
	below to retrieve those files.

	.. code-block:: console

	west blobs fetch hal_espressif

	.. note::

	It is recommended running the command above after :file:`west update`.

	Programming and Debugging
	*************************

	.. zephyr:board-supported-runners::

	.. include:: ../../../espressif/common/building-flashing.rst
	:start-after: espressif-building-flashing

	Debugging
	=========

	.. include:: ../../../espressif/common/openocd-debugging.rst
	:start-after: espressif-openocd-debugging

	Low-Power CPU (LP CORE)
	***********************

	The ESP32-C6 SoC has two RISC-V cores: the High-Performance Core (HP CORE) and the Low-Power Core (LP CORE).
	The LP Core features ultra low power consumption, an interrupt controller, a debug module and a system bus
	interface for memory and peripheral access.

	The LP Core is in sleep mode by default. It has two application scenarios:

	- Power insensitive scenario: When the High-Performance CPU (HP Core) is active, the LP Core can assist the HP CPU with some speed and efficiency-insensitive controls and computations.
	- Power sensitive scenario: When the HP CPU is in the power-down state to save power, the LP Core can be woken up to handle some external wake-up events.

	The LP Core support is fully integrated with :ref:`sysbuild`. The user can enable the LP Core by adding
	the following configuration to the project:

	.. code:: cfg

	CONFIG_ULP_COPROC_ENABLED=y

	See :zephyr:code-sample-category:`lp-core` folder as code reference.

	References
	**********

	.. target-notes::

	.. _`WeAct ESP32-C6 Mini`: https://github.com/WeActStudio/WeActStudio.ESP32C6-MINI
	.. _`ESP32-C6 Datasheet`: https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf
	.. _`ESP32-C6 Technical Reference Manual`: https://espressif.com/sites/default/files/documentation/esp32-c6_technical_reference_manual_en.pdf
	.. _`OpenOCD ESP32`: https://github.com/espressif/openocd-esp32/releases