diff --git a/dts/bindings/adc/espressif,esp32-adc.yaml b/dts/bindings/adc/espressif,esp32-adc.yaml index d3907dba640..9e49bbad83f 100644 --- a/dts/bindings/adc/espressif,esp32-adc.yaml +++ b/dts/bindings/adc/espressif,esp32-adc.yaml @@ -3,7 +3,8 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Espressif ESP32 ADC + ESP32 ADC. + Possible available resolutions depends on the used chip. - ESP32 < 9,10,11,12 > - ESP32-S2 < 12 > diff --git a/dts/bindings/can/espressif,esp32-twai.yaml b/dts/bindings/can/espressif,esp32-twai.yaml index cf0d19c23ae..cc77536a701 100644 --- a/dts/bindings/can/espressif,esp32-twai.yaml +++ b/dts/bindings/can/espressif,esp32-twai.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2022 Henrik Brix Andersen # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP32 Two-Wire Automotive Interface (TWAI) +description: ESP32 Two-Wire Automotive Interface (TWAI) compatible: "espressif,esp32-twai" diff --git a/dts/bindings/counter/espressif,esp32-rtc-timer.yaml b/dts/bindings/counter/espressif,esp32-rtc-timer.yaml index a8bc1c1165f..9e07c064166 100644 --- a/dts/bindings/counter/espressif,esp32-rtc-timer.yaml +++ b/dts/bindings/counter/espressif,esp32-rtc-timer.yaml @@ -3,7 +3,7 @@ description: | - Espressif's Counter Driver based on RTC Main Timer. + ESP32 Counter Driver based on RTC Main Timer. Any reset/sleep mode, except for the power-up reset, will not stop or reset the RTC Timer. This behavior may be handy when diff --git a/dts/bindings/counter/espressif,esp32-timer.yaml b/dts/bindings/counter/espressif,esp32-timer.yaml index 6b0056e8f34..af425a36524 100644 --- a/dts/bindings/counter/espressif,esp32-timer.yaml +++ b/dts/bindings/counter/espressif,esp32-timer.yaml @@ -2,7 +2,8 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Espressif's general-purpose Timers. + ESP32 general-purpose timers. + Each Timer is part of a Timer Group and the number of available Timers is SoC-dependent. diff --git a/dts/bindings/cpu/espressif,xtensa-lx6.yaml b/dts/bindings/cpu/espressif,xtensa-lx6.yaml index bf6d93f26ef..898a5e7cb26 100644 --- a/dts/bindings/cpu/espressif,xtensa-lx6.yaml +++ b/dts/bindings/cpu/espressif,xtensa-lx6.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif Xtensa CPU +description: Espressif Xtensa LX6 CPU compatible: "espressif,xtensa-lx6" diff --git a/dts/bindings/cpu/espressif,xtensa-lx7.yaml b/dts/bindings/cpu/espressif,xtensa-lx7.yaml index 3a2e33ff393..a91cd037ac9 100644 --- a/dts/bindings/cpu/espressif,xtensa-lx7.yaml +++ b/dts/bindings/cpu/espressif,xtensa-lx7.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif Xtensa CPU +description: Espressif Xtensa LX7 CPU compatible: "espressif,xtensa-lx7" diff --git a/dts/bindings/dac/espressif,esp32-dac.yaml b/dts/bindings/dac/espressif,esp32-dac.yaml index 39c63d7642e..18f24c1f209 100644 --- a/dts/bindings/dac/espressif,esp32-dac.yaml +++ b/dts/bindings/dac/espressif,esp32-dac.yaml @@ -2,8 +2,9 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Espressif Digital to Analog converter (DAC) control node - is part of the RTC low-power domain and belongs to the SENSE + ESP32 Digital to Analog converter (DAC) + + Part of the RTC low-power domain and belongs to the SENSE peripherals set. RTC peripherals has GPIOs controlled by the RTCIO mux, which is separated from the main IO mux. diff --git a/dts/bindings/dma/espressif,esp32-gdma.yaml b/dts/bindings/dma/espressif,esp32-gdma.yaml index f50745dd842..18f328234e1 100644 --- a/dts/bindings/dma/espressif,esp32-gdma.yaml +++ b/dts/bindings/dma/espressif,esp32-gdma.yaml @@ -2,7 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Espressif's GDMA (General Direct Memory Access) Node + ESP32 GDMA (General Direct Memory Access) General Direct Memory Access (GDMA) is a feature that allows peripheral-to-memory, memory-to-peripheral, and memory-to-memory diff --git a/dts/bindings/flash_controller/espressif,esp32-flash-controller.yaml b/dts/bindings/flash_controller/espressif,esp32-flash-controller.yaml index c1bfa3bf696..0416405e0f7 100644 --- a/dts/bindings/flash_controller/espressif,esp32-flash-controller.yaml +++ b/dts/bindings/flash_controller/espressif,esp32-flash-controller.yaml @@ -1,4 +1,4 @@ -description: ESP32 Family flash controller +description: ESP32 flash controller compatible: "espressif,esp32-flash-controller" diff --git a/dts/bindings/input/espressif,esp32-touch-sensor.yaml b/dts/bindings/input/espressif,esp32-touch-sensor.yaml index 5bea6081b97..f646563b856 100644 --- a/dts/bindings/input/espressif,esp32-touch-sensor.yaml +++ b/dts/bindings/input/espressif,esp32-touch-sensor.yaml @@ -2,7 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Zephyr input touch sensor parent node + ESP32 touch sensor input This defines a group of touch sensors that can generate input events. Each touch sensor is defined in a child node of the touch-sensor node and defines a specific key diff --git a/dts/bindings/mdio/espressif,esp32-mdio.yaml b/dts/bindings/mdio/espressif,esp32-mdio.yaml index d869d656da5..1ffa77e55f0 100644 --- a/dts/bindings/mdio/espressif,esp32-mdio.yaml +++ b/dts/bindings/mdio/espressif,esp32-mdio.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2022 Grant Ramsay # SPDX-License-Identifier: Apache-2.0 -description: ESP32 MDIO Driver node +description: ESP32 MDIO controller compatible: "espressif,esp32-mdio" diff --git a/dts/bindings/memory-controllers/espressif,esp32-psram.yaml b/dts/bindings/memory-controllers/espressif,esp32-psram.yaml index d79a0723ff3..cdfede604dd 100644 --- a/dts/bindings/memory-controllers/espressif,esp32-psram.yaml +++ b/dts/bindings/memory-controllers/espressif,esp32-psram.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2025 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: ESP32 Family pseudo-static RAM controller +description: ESP32 pseudo-static RAM controller compatible: "espressif,esp32-psram" diff --git a/dts/bindings/pinctrl/espressif,esp32-pinctrl.yaml b/dts/bindings/pinctrl/espressif,esp32-pinctrl.yaml index c55372094ae..5fe2c5e8f42 100644 --- a/dts/bindings/pinctrl/espressif,esp32-pinctrl.yaml +++ b/dts/bindings/pinctrl/espressif,esp32-pinctrl.yaml @@ -2,6 +2,8 @@ # SPDX-License-Identifier: Apache-2.0 description: | + ESP32 pin controller + Espressif's pin controller is in charge of controlling pin configurations, pin functionalities and pin properties as defined by pin states. In its turn, pin states are composed by groups of pre-defined pin muxing definitions and user diff --git a/dts/bindings/pwm/espressif,esp32-ledc.yaml b/dts/bindings/pwm/espressif,esp32-ledc.yaml index e46a7c78760..c41efc3cfb7 100644 --- a/dts/bindings/pwm/espressif,esp32-ledc.yaml +++ b/dts/bindings/pwm/espressif,esp32-ledc.yaml @@ -3,7 +3,7 @@ description: | - Espressif's LEDC controller Node + ESP32 LED Control (LEDC) The LEDC controller is primarily designed to control the intensity of LEDs, although it can be used to generate PWM signals for other purposes as well. diff --git a/dts/bindings/pwm/espressif,esp32-mcpwm.yaml b/dts/bindings/pwm/espressif,esp32-mcpwm.yaml index d39e4ff95ea..fe2697deeed 100644 --- a/dts/bindings/pwm/espressif,esp32-mcpwm.yaml +++ b/dts/bindings/pwm/espressif,esp32-mcpwm.yaml @@ -3,7 +3,7 @@ description: | - Espressif's Motor Control Pulse Width Modulator (MCPWM) controller Node + ESP32 Motor Control Pulse Width Modulator (MCPWM) The MCPWM peripheral is intended for motor and power control. It provides six PWM outputs that can be set up to operate in several topologies diff --git a/dts/bindings/rng/espressif,esp32-trng.yaml b/dts/bindings/rng/espressif,esp32-trng.yaml index 78c3fd1e1ec..45f13d42e82 100644 --- a/dts/bindings/rng/espressif,esp32-trng.yaml +++ b/dts/bindings/rng/espressif,esp32-trng.yaml @@ -2,7 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 description: | - Espressif ESP32 TRNG (True Random Number Generator). + ESP32 TRNG (True Random Number Generator). The TRNG uses the noise in the Wi-Fi/BT RF system. When Wi-Fi and BT are disabled, the random number generator will give out pseudo-random numbers. diff --git a/dts/bindings/sdhc/espressif,esp32-sdhc-slot.yaml b/dts/bindings/sdhc/espressif,esp32-sdhc-slot.yaml index ff743a2ad2c..284ed1f929f 100644 --- a/dts/bindings/sdhc/espressif,esp32-sdhc-slot.yaml +++ b/dts/bindings/sdhc/espressif,esp32-sdhc-slot.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP32 SDHC controller slot +description: ESP32 SDHC controller slot compatible: "espressif,esp32-sdhc-slot" diff --git a/dts/bindings/sdhc/espressif,esp32-sdhc.yaml b/dts/bindings/sdhc/espressif,esp32-sdhc.yaml index b7cfabcdbbb..335ab6bf82b 100644 --- a/dts/bindings/sdhc/espressif,esp32-sdhc.yaml +++ b/dts/bindings/sdhc/espressif,esp32-sdhc.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP32 SDHC controller +description: ESP32 SDHC controller compatible: "espressif,esp32-sdhc" diff --git a/dts/bindings/sensor/espressif,esp32-pcnt.yaml b/dts/bindings/sensor/espressif,esp32-pcnt.yaml index f022206f0c4..78a7384d150 100644 --- a/dts/bindings/sensor/espressif,esp32-pcnt.yaml +++ b/dts/bindings/sensor/espressif,esp32-pcnt.yaml @@ -3,7 +3,7 @@ description: | - Espressif's Pulse Counter Mode (PCNT) controller Node + ESP32 Pulse Counter (PCNT) The pulse counter module is designed to count the number of rising and/or falling edges of an input signal. diff --git a/dts/bindings/sensor/espressif,esp32-temp.yaml b/dts/bindings/sensor/espressif,esp32-temp.yaml index 31509f40251..dc63d37e7ec 100644 --- a/dts/bindings/sensor/espressif,esp32-temp.yaml +++ b/dts/bindings/sensor/espressif,esp32-temp.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2022 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: ESP32 family temperature sensor node +description: ESP32 temperature sensor compatible: "espressif,esp32-temp" diff --git a/dts/bindings/timer/espressif,esp32-systimer.yaml b/dts/bindings/timer/espressif,esp32-systimer.yaml index bc08df7e39c..f9289886b4c 100644 --- a/dts/bindings/timer/espressif,esp32-systimer.yaml +++ b/dts/bindings/timer/espressif,esp32-systimer.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2021 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP32 Systimer peripheral +description: ESP32 System Timer compatible: "espressif,esp32-systimer" diff --git a/dts/bindings/video/espressif,esp32-cam.yaml b/dts/bindings/video/espressif,esp32-cam.yaml index 309c1e954f7..2aaef707354 100644 --- a/dts/bindings/video/espressif,esp32-cam.yaml +++ b/dts/bindings/video/espressif,esp32-cam.yaml @@ -4,7 +4,7 @@ # SPDX-License-Identifier: Apache-2.0 # -description: esp32 LCD CAM Peripheral interface +description: ESP32 LCD CAM Peripheral interface compatible: "espressif,esp32-lcd-cam" diff --git a/dts/bindings/watchdog/espressif,esp32-watchdog.yaml b/dts/bindings/watchdog/espressif,esp32-watchdog.yaml index 87997e291ad..9f134359c3a 100644 --- a/dts/bindings/watchdog/espressif,esp32-watchdog.yaml +++ b/dts/bindings/watchdog/espressif,esp32-watchdog.yaml @@ -2,7 +2,9 @@ # SPDX-License-Identifier: Apache-2.0 description: | - ESP32 watchdog. ESP32 contains 3x Watchdog timers, 2x Main System Watchdog + ESP32 watchdog. + + ESP32 contains 3x Watchdog timers, 2x Main System Watchdog Timer (MWDT), 1x RTC Watchdog Timer (RWDT). RWDT is not supported yet. compatible: "espressif,esp32-watchdog" diff --git a/dts/bindings/watchdog/espressif,esp32-xt-wdt.yaml b/dts/bindings/watchdog/espressif,esp32-xt-wdt.yaml index c20a4234cab..4dec4f39f57 100644 --- a/dts/bindings/watchdog/espressif,esp32-xt-wdt.yaml +++ b/dts/bindings/watchdog/espressif,esp32-xt-wdt.yaml @@ -2,6 +2,8 @@ # SPDX-License-Identifier: Apache-2.0 description: | + ESP32 XT Watchdog Timer. + This watchdog timer can detect oscillation failure of the RTC_SLOW_CLK_SRC_XTAL32K. When such a failure is detected the hardware automatically switch to ESP32_RTC_SLOW_CLK_SRC_RC_SLOW. diff --git a/dts/bindings/wifi/espressif,esp-at.yaml b/dts/bindings/wifi/espressif,esp-at.yaml index 33f9a492bfe..b1f0ea23c77 100644 --- a/dts/bindings/wifi/espressif,esp-at.yaml +++ b/dts/bindings/wifi/espressif,esp-at.yaml @@ -1,7 +1,7 @@ # Copyright (c) 2019 Tobias Svehagen # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP8266/ESP32 WiFi modem (AT Commands) +description: ESP8266/ESP32 WiFi modem (AT Commands) compatible: "espressif,esp-at" diff --git a/dts/bindings/wifi/espressif,esp32-wifi.yaml b/dts/bindings/wifi/espressif,esp32-wifi.yaml index af84531812b..9a1bf691c42 100644 --- a/dts/bindings/wifi/espressif,esp32-wifi.yaml +++ b/dts/bindings/wifi/espressif,esp32-wifi.yaml @@ -1,6 +1,6 @@ # Copyright (c) 2022 Espressif Systems (Shanghai) Co., Ltd. # SPDX-License-Identifier: Apache-2.0 -description: Espressif ESP32 SoC WiFi +description: ESP32 SoC Wi-Fi compatible: "espressif,esp32-wifi"