legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively

[vincenzosuraci]

I'm using a Atom S3R + Echo base in ESPHome. When I compile the code I get this error that seems to be related to the Power_Class.hpp file.
Honestly I do not know what to do, since it does not seem to be related to my .yaml file, but to some sort of deprectation to be solved in this library.

Any help or suggestion would be more than appreciated!

Thanks,
Vincenzo

INFO ESPHome 2026.2.2
INFO Reading configuration atom-s3r-bccc40.yaml...
INFO Updating https://github.com/krcarneiro/M5AtomS3-EchoBase-Esphome@main
INFO Detected timezone 'Europe/Berlin'
INFO Generating C++ source...
INFO Applying optimized lwip settings: 65KB TCP windows, 64 mailbox sizes
INFO Applying optimized WiFi settings: 64 RX buffers, 64 TX buffers
INFO Setting CONFIG_LWIP_MAX_SOCKETS to 11 (registered: api=4, captive_portal=4, mdns=2, ota=1)
INFO Compiling app... Build path: C:\Users\enzoc\ESPHome\.esphome\build\atom-s3r-bccc40
Processing atom-s3r-bccc40 (board: esp32-s3-devkitc1-n8r8; framework: espidf; platform: https://github.com/pioarduino/platform-espressif32/releases/download/55.03.37/platform-espressif32.zip)
--------------------------------------------------------------------------------
HARDWARE: ESP32S3 240MHz, 320KB RAM, 8MB Flash
 - contrib-piohome @ 3.4.4 
 - framework-espidf @ 3.50502.0 (5.5.2) 
 - tool-cmake @ 4.0.3 
 - tool-esp-rom-elfs @ 2024.10.11 
 - tool-esptoolpy @ 5.1.2 
 - tool-ninja @ 1.13.1 
 - tool-scons @ 4.40801.0 (4.8.1) 
 - toolchain-xtensa-esp-elf @ 14.2.0+20251107
Reading CMake configuration...
Dependency Graph
|-- M5Unified @ 0.2.13
|-- noise-c @ 0.1.10
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\board_m5atoms3r\board_m5atoms3r.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\i2s_audio\i2s_audio.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\i2s_audio\microphone\i2s_audio_microphone.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\i2s_audio\speaker\i2s_audio_speaker.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\logger\logger.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\logger\logger_esp32.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\logger\task_log_buffer_esp32.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\logger\task_log_buffer_zephyr.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\m5atoms3_audio\m5atoms3_audio.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\m5atoms3_audio\speaker\i2s_audio_speaker.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\m5atoms3_display\m5atoms3_display.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\md5\md5.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\mdns\mdns_component.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\mdns\mdns_esp32.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\media_player\media_player.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\microphone\microphone.cpp.o
Compiling .pioenvs\atom-s3r-bccc40\src\esphome\components\microphone\microphone_source.cpp.o
In file included from .piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:30,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.hpp:59,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.h:5,
                 from src/esphome/components/board_m5atoms3r/board_m5atoms3r.h:5,
                 from src/esphome/components/board_m5atoms3r/board_m5atoms3r.cpp:2:
C:/Users/enzoc/.platformio/packages/framework-espidf/components/driver/deprecated/driver/adc.h:19:2: warning: #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively" [-Wcpp]
   19 | #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively"
      |  ^~~~~~~
.piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:31:10: fatal error: esp_adc_cal.h: No such file or directory

***************************************************************************
* Looking for esp_adc_cal.h dependency? Check our library registry!
*
* CLI  > platformio lib search "header:esp_adc_cal.h"
* Web  > https://registry.platformio.org/search?q=header:%1B%5Bm%1B%5BKesp_adc_cal.h
*
***************************************************************************

   31 | #include <esp_adc_cal.h>
      |          ^~~~~~~~~~~~~~~
compilation terminated.
*** [.pioenvs\atom-s3r-bccc40\src\esphome\components\board_m5atoms3r\board_m5atoms3r.cpp.o] Error 1
In file included from .piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:30,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.hpp:59,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.h:5,
                 from src/esphome/components/m5atoms3_audio/speaker/i2s_audio_speaker.cpp:6:
C:/Users/enzoc/.platformio/packages/framework-espidf/components/driver/deprecated/driver/adc.h:19:2: warning: #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively" [-Wcpp]
   19 | #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively"
      |  ^~~~~~~
.piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:31:10: fatal error: esp_adc_cal.h: No such file or directory

***************************************************************************
* Looking for esp_adc_cal.h dependency? Check our library registry!
*
* CLI  > platformio lib search "header:esp_adc_cal.h"
* Web  > https://registry.platformio.org/search?q=header:%1B%5Bm%1B%5BKesp_adc_cal.h
*
***************************************************************************

   31 | #include <esp_adc_cal.h>
      |          ^~~~~~~~~~~~~~~
compilation terminated.
*** [.pioenvs\atom-s3r-bccc40\src\esphome\components\m5atoms3_audio\speaker\i2s_audio_speaker.cpp.o] Error 1
In file included from .piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:30,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.hpp:59,
                 from .piolibdeps/atom-s3r-bccc40/M5Unified/src/M5Unified.h:5,
                 from src/esphome/components/m5atoms3_display/m5atoms3_display.cpp:7:
C:/Users/enzoc/.platformio/packages/framework-espidf/components/driver/deprecated/driver/adc.h:19:2: warning: #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively" [-Wcpp]
   19 | #warning "legacy adc driver is deprecated, please migrate to use esp_adc/adc_oneshot.h and esp_adc/adc_continuous.h for oneshot mode and continuous mode drivers respectively"
      |  ^~~~~~~
.piolibdeps/atom-s3r-bccc40/M5Unified/src/utility/Power_Class.hpp:31:10: fatal error: esp_adc_cal.h: No such file or directory

***************************************************************************
* Looking for esp_adc_cal.h dependency? Check our library registry!
*
* CLI  > platformio lib search "header:esp_adc_cal.h"
* Web  > https://registry.platformio.org/search?q=header:%1B%5Bm%1B%5BKesp_adc_cal.h
*
***************************************************************************

   31 | #include <esp_adc_cal.h>
      |          ^~~~~~~~~~~~~~~
compilation terminated.
*** [.pioenvs\atom-s3r-bccc40\src\esphome\components\m5atoms3_display\m5atoms3_display.cpp.o] Error 1
========================== [FAILED] Took 9.28 seconds ==========================

[ainyan03]

Triage note (not a maintainer):

M5Unified migrated the battery ADC to the esp_adc oneshot API in commit 0360b63, first released in v0.1.17 (2024-09-23). The legacy driver/adc.h is only included when <esp_adc/adc_oneshot.h> is unavailable:

https://github.com/m5stack/M5Unified/blob/2fe93c0/src/utility/Power_Class.hpp#L24-L30

So on ESP-IDF 5.x with a current M5Unified, Power_Class.hpp does not pull in the deprecated header. Two things worth checking on your side:

1. Which M5Unified version your ESPHome build actually resolves to (ESPHome may pin an older release).
2. The message is a #warning emitted by Arduino's own deprecated driver/adc.h, so it can also be triggered by another component in the same build, not necessarily by M5Unified.

[ainyan03]

Thank you for your patience — an update addressing this has just been released as 0.2.20. Please update.

The battery ADC no longer initializes the legacy driver on current cores: Arduino builds read through the Arduino-owned ADC API, and ESP-IDF builds use adc_oneshot (#312). The legacy path remains only for old cores that predate the oneshot driver.