ANY Arduino build for ESP32-s2 for board = lolin_s2_mini fails with USBSerial not declared in scope of HardwareSerial.h (IDFGH-11650)

[peteDDD]

Board

ESP32-S2 lolin_s2_mini

Device Description

(Wemos) lolin_s2_mini

Hardware Configuration

Not relevant to the issue.

Version

v2.0.14

IDE Name

Visual Studio Code with Platformio

Operating System

Windows 10

Flash frequency

does not matter

PSRAM enabled

no

Upload speed

does not matter

Description

ANY CODE built with espidf @ 3.50102.0 (5.1.2)/arduinoespressif32 @ 3.0.0 specifying lolin_s2_mini as the board and with CONFIG_AUTOSTART_ARDUINO=y fails in
HardwareSerial.h:360:16: with error: 'USBSerial' was not declared in this scope

Sketch

#include <Arduino.h>

void setup()
{}

void loop()
{}

Debug Message

In file included from C:/Users/peted/.platformio/packages/framework-arduinoespressif32-src-16f16f9b46f255eba682607449bb3231/cores/esp32/Arduino.h:196,
                 from C:/Users/peted/.platformio/packages/framework-arduinoespressif32-src-16f16f9b46f255eba682607449bb3231/cores/esp32/chip-debug-report.cpp:17:
C:/Users/peted/.platformio/packages/framework-arduinoespressif32-src-16f16f9b46f255eba682607449bb3231/cores/esp32/chip-debug-report.cpp: In function 'void printBeforeSetupInfo()':     
C:/Users/peted/.platformio/packages/framework-arduinoespressif32-src-16f16f9b46f255eba682607449bb3231/cores/esp32/HardwareSerial.h:360:16: error: 'USBSerial' was not declared in this scope; did you mean 'Serial'?
  360 | #define Serial USBSerial
      |                ^~~~~~~~~
C:/Users/peted/.platformio/packages/framework-arduinoespressif32-src-16f16f9b46f255eba682607449bb3231/cores/esp32/chip-debug-report.cpp:260:3: note: in expansion of macro 'Serial'

Other Steps to Reproduce

Using

• framework-arduinoespressif32 @ 3.0.0
• framework-espidf @ 3.50102.0 (5.1.2)
  which was downloaded clean on 9 December 2023 at 13:00 UTC

Platformio.ini:

[env:lolin_s2_mini]
platform = espressif32
board = lolin_s2_mini
framework = espidf, arduino

sdkconfig includes:
CONFIG_AUTOSTART_ARDUINO=y

Proceed to build the most simple of sketches using platformio build button or command

(For the record, no issue doing the same with esp32-s3-devkitc-1 including using printf and ESP_LOG).

I have checked existing issues, online documentation and the Troubleshooting Guide

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[lbernstone]

Are you using the sdkconfig from arduino-esp32?
Note that in >3.0 it will be located at https://github.com/espressif/esp32-arduino-libs/blob/idf-release/v5.1/esp32s2/sdkconfig

[peteDDD]

Are you using the sdkconfig from arduino-esp32?
Note that in >3.0 it will be located at https://github.com/espressif/esp32-arduino-libs/blob/idf-release/v5.1/esp32s2/sdkconfig

@lbernstone Thank you for this information.

As you likely know, Platformio is in charge of loading the "correct" sdkconfig file for each project. And in fact "forces" the one it thinks is correct for the framework and board specified.

I did a diff on the one from the link you provided and it is quite different, with about 340 more lines, compared to the one that platformio is loading.

I tried:
1: Copying the "new" sdkconfig file to sdkconfig_lolin_S2_mini in my project directory. As soon as the build starts, platformio replaces the file with the same one it was loading before.
2: Copying the "new" sdkconfig file to sdkconfig in my project directory. As soon as the build starts, platformio replaces sdkconfig_lolin_S2_mini file with the same one it was loading before.

So it appears the problem may be that with platformio loading the following tools, it is not loading the correct sdkconfig files (or may be not even loading esp32-arduino-libs ... is that what is happening here?

 framework-arduinoespressif32 @ 3.0.0
 framework-espidf @ 3.50102.0 (5.1.2)

do not load the correct sdkconfig files.

How to fix that? Is there a platformio.ini setting I can use for now to force the use of the esp32-arduino-libs? Or is there an installation of esp32-arduino-libs that I need to do beyond just specifying the following in my platformio.ini?

[env:lolin_s2_mini]
platform = espressif32
board = lolin_s2_mini
framework = espidf, arduino

This is odd because, for example, my same projects build just fine when I specify
board = esp32-s3-devkitc-1

[peteDDD]

further... I tried the following platformio.ini per the installation instructions

[env:lolin_s2_mini]
platform = https://github.com/platformio/platform-espressif32.git
board = lolin_s2_mini
framework = arduino
platform_packages =
    framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master

and got the following errors

CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/lolin_s2_mini.html
PLATFORM: Espressif 32 (6.4.0+sha.ff6ec88) > WEMOS LOLIN S2 Mini
HARDWARE: ESP32S2 240MHz, 320KB RAM, 4MB Flash
DEBUG: Current (cmsis-dap) External (cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa)
PACKAGES: 
 - framework-arduinoespressif32 @ 3.0.0+sha.51cb927 
 - tool-esptoolpy @ 1.40501.0 (4.5.1) 
 - toolchain-riscv32-esp @ 8.4.0+2021r2-patch5 
 - toolchain-xtensa-esp32s2 @ 8.4.0+2021r2-patch5
KeyError: 'framework-arduinoespressif32-libs':
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\builder\main.py", line 173:
    env.SConscript("$BUILD_SCRIPT")
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 598:
    return _SConscript(self.fs, *files, **subst_kw)
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 285:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "C:\Users\peted\.platformio\platforms\espressif32@src-5f117260f75b328038ec9d3fd0e14a68\builder\main.py", line 346:
    target_elf = env.BuildProgram()
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Util\envs.py", line 242:
    return self.method(*nargs, **kwargs)
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\builder\tools\piobuild.py", line 61:
    env.ProcessProgramDeps()
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Util\envs.py", line 242:
    return self.method(*nargs, **kwargs)
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\builder\tools\piobuild.py", line 121:
    env.BuildFrameworks(env.get("PIOFRAMEWORK"))
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Util\envs.py", line 242:
    return self.method(*nargs, **kwargs)
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\builder\tools\piobuild.py", line 342:
    SConscript(env.GetFrameworkScript(name), exports="env")
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 662:
    return method(*args, **kw)
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 598:
    return _SConscript(self.fs, *files, **subst_kw)
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 285:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "C:\Users\peted\.platformio\platforms\espressif32@src-5f117260f75b328038ec9d3fd0e14a68\builder\frameworks\arduino.py", line 41:
    SConscript(
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 662:
    return method(*args, **kw)
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 598:
    return _SConscript(self.fs, *files, **subst_kw)
  File "C:\Users\peted\.platformio\packages\tool-scons\scons-local-4.5.2\SCons\Script\SConscript.py", line 285:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "C:\Users\peted\.platformio\packages\framework-arduinoespressif32\tools\platformio-build.py", line 40:
    FRAMEWORK_LIBS_DIR = platform.get_package_dir("framework-arduinoespressif32-libs")
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\platform\_packages.py", line 32:
    pkg = self.get_package(name)
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\platform\_packages.py", line 29:
    return self.pm.get_package(spec or self.get_package_spec(name))
  File "C:\Users\peted\.platformio\penv\Lib\site-packages\platformio\platform\_packages.py", line 21:
    owner=self.packages[name].get("owner"),
========================== [FAILED] Took 1.22 seconds ==========================

[peteDDD]

UPDATE:

1- I uninstalled ALL espressif platforms from Platformio/Visual Code Studio.
2- Set platformio.ini as follows

[env:lolin_s2_mini]
platform = espressif32
board = lolin_s2_mini
framework = arduino

3- When I saved the platformio, tool manager took over, as usual, and indicated:
Tool Manager: Installing platformio/framework-arduinoespressif32 @ ~3.20014.0
4- Build now works!

BUT NOW... my ESP32-S3 projects won't build...
stdini.h, stdio.h, string.h, stdlib.h, and others not found...

[lbernstone]

All the platformio glue is maintained at https://github.com/platformio/platform-espressif32. They will be able to address your problem better than we can.

[SuGlider]

@Jason2866 is one of the Tasmota maintainers.
He has tons of experience with PlatformIO.
I think that he can guide you.

[peteDDD]

Yes, indeed, @Jason2866 is brilliant and generous with his advice.

[VojtechBartoska]

Hello @peteDDD, probably we will be not able to help you.

Please ask in PIO issue tracker, you can also take a look on PIO docs here

[Jason2866]

@peteDDD Can you upload a complete failing setup to your github in a new repo?
Will have a look, it is better to have everything together, than talking about pieces. Probably just a small detail.