# ESP32 compilation error triggered by recommended PSRAM type

**URL:** <https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680>\
**Category:** ESP32\
**Created:** [February 28, 2025, 7:25am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680 "2025-02-28T07:25:09Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [February 28, 2025, 7:25am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/1 "2025-02-28T07:25:09Z")

</div>

I use SparkFun Thing Plus - ESP32-S3 board with next SW environment:  
Arduino IDE: 2.3.4  
Installed boards support:  
Arduino ESP32 Boards v2.0.18 - arduino.5 by Arduino  
esp32 v3.2.0-RC1 by Espressif

If I choose _PSRAM: QSPI PSRAM_ option according to [Hookup guide](https://docs.sparkfun.com/SparkFun_Thing_Plus_ESP32-S3/arduino_example/#board-settings).  
During compilation of RGB\_LED.ino example I get next compilation error:

> In file included from …/Arduino15/packages/esp32/tools/esp-x32/2411/xtensa-esp-elf/include/sys/reent.h:34,  
> from …\Arduino15\packages\esp32\tools\esp32-arduino-libs\idf-release\_v5.4-bcb3c32d-v1\esp32s3/include/newlib/platform\_include/sys/reent.h:13,  
> from …/Arduino15/packages/esp32/tools/esp-x32/2411/xtensa-esp-elf/include/stdio.h:60,  
> from…\Arduino15\packages\esp32\hardware\esp32\3.2.0-RC1\cores\esp32/Arduino.h:27,  
> from …\AppData\Local\arduino\sketches\F2D0A6956F0C0D1ADC2714C276F620B6\sketch\RGB\_LED.ino.cpp:1:  
> …\Arduino15\packages\esp32\tools\esp32-arduino-libs\idf-release\_v5.4-bcb3c32d-v1\esp32s3/include/newlib/platform\_include/sys/lock.h:9:10: fatal error: sdkconfig.h: No such file or directory  
> 9 | #include “sdkconfig.h”  
> | ^ ~~~~~~~~~~~~  
> compilation terminated

Choosing option “OPI PSRAM” for PSRAM prevents the error.  
This problem may be reproduced with last stable release of esp32 library by Expressif: 3.1.3

After compiling examples with PSRAM option “OPI PSRAM” download is successful but applications do not run.

The monitor output, read by external terminal is

> ESP-ROM:esp32s3-20210327  
> Build:Mar 27 2021  
> rst:0x15 (USB\_UART\_CHIP\_RESET),boot:0x18 (SPI\_FAST\_FLASH\_BOOT)  
> Saved PC:0x4038531a  
> SPIWP:0xee  
> mode:DOUT, clock div:1  
> load:0x3fce2810,len:0x1074  
> load:0x403c8700,len:0x4  
> load:0x403c8704,len:0xac0  
> load:0x403cb700,len:0x2e58  
> entry 0x403c8890

---

<div class="post-metadata">

**Author:** ![TS-Russell](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/ts-russell/32/6092_2.png) [@TS-Russell](https://community.sparkfun.com/u/TS-Russell)\
**Post date:** [February 28, 2025, 11:21pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/2 "2025-02-28T23:21:03Z")

</div>

It might be worth seeing if an issue for this has already been filed and if not go ahead and file one [GitHub · Where software is built](https://github.com/espressif/esp-idf/issues)

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 1, 2025, 5:47pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/3 "2025-03-01T17:47:37Z")

</div>

Thank you for your response, @TS-Russell.

The issue you mentioned was not described in the ESP-IDF repository you suggested, so I have opened a [new one](https://github.com/espressif/esp-idf/issues/15502). However, I doubt it will receive much attention since the problem seems to be specific to the Arduino IDE environment rather than ESP-IDF.

In the meantime, I have the following questions:

1. Based on the UART log and the absence of LED activity, it appears that the RGB\_LED application is loaded but not running. Could this be caused by using _OPI PSRAM_ instead of the recommended _QSPI PSRAM_?
2. Do you know which versions of the _Arduino IDE_ and _Espressif ESP32 board library_ were used when the _SparkFun Thing Plus - ESP32-S3 Hookup Guide_ was written?
3. If your company has an Arduino IDE setup that successfully compiles and runs the _SparkFun\_Thing\_Plus\_ESP32-S3_ repository examples, could you please provide the version of the IDE and board support package used, along with the chosen configuration?

Thank you in advance.

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 2, 2025, 6:01am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/4 "2025-03-02T06:01:05Z")

</div>

Update:

While checking different versions of Espressif’s ESP32 board support, I discovered that the problem can be reproduced starting from version _3.1.0-RC1_ and onward. It does not occur in the previous version, _3.0.7_.

It may be worth verifying this, and if my findings are confirmed, updating the Thing Plus - ESP32-S3 Hookup Guide accordingly.

---

<div class="post-metadata">

**Author:** ![TS-Russell](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/ts-russell/32/6092_2.png) [@TS-Russell](https://community.sparkfun.com/u/TS-Russell)\
**Post date:** [March 3, 2025, 7:33pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/5 "2025-03-03T19:33:47Z")

</div>

Alrighty; thanks for the heads-up

I’ll forward this along to the relevant parties 🙂

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 3, 2025, 9:00pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/6 "2025-03-03T21:00:27Z")

</div>

Please add to you message that [reference to ESP32-S3 specific documentation](https://docs.espressif.com/projects/esp-idf/en/stable/esp32S3/index.html) at Hookup Guide leads to the page that does not exist now.

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 20, 2025, 4:31pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/7 "2025-03-20T16:31:54Z")

</div>

Hi @TS-Russell ,  
Do we have any news about ability to set PSRAM to value QSPI PSRAM for ESP32-S3 Thing Plus board?

Look like that wrong PSRAM settings cause board to restart constantly. See [dedicated discussion.](https://community.sparkfun.com/t/what-could-be-causing-the-constant-restarts-when-using-the-arduino-ide/64088)

---

<div class="post-metadata">

**Author:** ![TS-Russell](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/ts-russell/32/6092_2.png) [@TS-Russell](https://community.sparkfun.com/u/TS-Russell)\
**Post date:** [March 22, 2025, 1:04am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/8 "2025-03-22T01:04:00Z")

</div>

For now my recommendation would be to not use the release candidate and instead go with the stable release

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 23, 2025, 10:48am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/9 "2025-03-23T10:48:31Z")

</div>

Can you please specify which stable release of the ESP32 board support you are referring to?

For the recent stable releases—3.1.0, 3.1.1, 3.1.2, and 3.1.3—compilation fails when PSRAM: _QSPI PSRAM_ is selected. Please see the attached compilation logs for versions 3.1.0 and 3.1.3.

However, in version 3.0.7, the compilation succeeds, but running the following simple sketch results in no output on the Serial Monitor and causes the board to reset every few seconds. The same boards function correctly when using the _IDF-ESP v5.4 IDE_  
[esp32\_3.1.0\_log.txt](https://community.sparkfun.com/uploads/short-url/qUWDtge8TkwPLKboKw56xm5uKTu.txt) (6.9 KB)  
[esp32\_3.1.3\_log.txt](https://community.sparkfun.com/uploads/short-url/y24g2HSn9gjdRrIcABG0kVqZb7S.txt) (6.8 KB)

Here is my example sketch:

> void setup() {  
> Serial.begin(9600);  
> while (!Serial); // Corrected the while condition  
> Serial.print(“Setup”);  
> }
> 
> void loop() {  
> Serial.print(“Loop”);  
> }

In all cases I specify _ESP32S3 Dev Module Octal (WROOM2)_ as target board.

---

<div class="post-metadata">

**Author:** ![paulvha](https://avatars.discourse-cdn.com/v4/letter/p/65b543/32.png) [@paulvha](https://community.sparkfun.com/u/paulvha)\
**Post date:** [March 23, 2025, 3:53pm UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/10 "2025-03-23T15:53:52Z")

</div>

Not that i have the answer, but i have tried to compile the RGB-LED.ino on with the ESP32S3 Dev Module Octal (WROOM2) and it **compiles without an errors.**  
I have ESP32 version 3.1.3 and there is also a variant now “Sparkfun ESP32-S3 Thing Plus”. That compiles **without changes and without errors as well.**

The sdkconfig.h file is automatically generated and contains information about the SOC capabilities and setting.

I am using the same IDF library version as in one of your logs files : idf-release\_v5.3-489d7a2b-v1.  
**Could it be that it is damaged? Maybe try a complete reinstall of the ESP32 library, because changing the library version does NOT change everything.**

- Close down Arduino-IDE
- Remove the ESP32 board library: the folder  
C:\Users\baruch\AppData\Local\Arduino15\packages\esp32
- Restart Arduino-IDE and re-install ESP32 version 3.1.3. Now all will be new.

see what happens

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 24, 2025, 4:24am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/11 "2025-03-24T04:24:19Z")

</div>

Hi @paulvha,

You wrote:

> I have ESP32 version 3.1.3 and there is also a variant now “Sparkfun ESP32-S3 Thing Plus”

Just to clarify, do you mean the ESP32 board support package by Espressif, version 3.1.3?

On the other hand, “Sparkfun ESP32-S3 Thing Plus” is the name of a board. So, I am not sure I correctly understood your sentence.

Is there board support specifically for the “Sparkfun ESP32-S3 Thing Plus”?

---

<div class="post-metadata">

**Author:** ![paulvha](https://avatars.discourse-cdn.com/v4/letter/p/65b543/32.png) [@paulvha](https://community.sparkfun.com/u/paulvha)\
**Post date:** [March 24, 2025, 8:36am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/12 "2025-03-24T08:36:50Z")

</div>

yes: the Espressif ESP32 version 3.1.3

As a variant where you had selected the “ESP32S3 Dv module Octal(WROOM2)”", you can also select instead the “Sparkfun ESP32-S3 Thing plus”. Seems it was added in the ESP32 Espressif .

Have you tried the steps to re-install ?

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 24, 2025, 9:13am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/13 "2025-03-24T09:13:11Z")

</div>

Dear @paulvha,

You had made my week (ro couple of them)! 🙏 😀  
Re-install of board support library did not helped, but defining correct board certainly did!

Dear @TS-Russell,  
If would help tremendously if you will update your [documentation](https://docs.sparkfun.com/SparkFun_Thing_Plus_ESP32-S3/arduino_example/#thing-plus-esp32-s3-github-repository)

![FixSparkFunManual](https://canada1.discourse-cdn.com/sparkfun/optimized/2X/0/059bfe629449eb56c8f1be0c10b124b5af9ef1e7_2_690x79.jpeg)

---

<div class="post-metadata">

**Author:** ![paulvha](https://avatars.discourse-cdn.com/v4/letter/p/65b543/32.png) [@paulvha](https://community.sparkfun.com/u/paulvha)\
**Post date:** [March 24, 2025, 9:26am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/14 "2025-03-24T09:26:29Z")

</div>

Good to hear.

Does it solve your other issue ([What could be causing the constant restarts when using the Arduino IDE?](https://community.sparkfun.com/t/what-could-be-causing-the-constant-restarts-when-using-the-arduino-ide/64088)) as well ?

---

<div class="post-metadata">

**Author:** ![Baruch\_Lifshitz](https://yyz1.discourse-cdn.com/sparkfun/user_avatar/community.sparkfun.com/baruch_lifshitz/32/7804_2.png) [@Baruch\_Lifshitz](https://community.sparkfun.com/u/Baruch_Lifshitz)\
**Post date:** [March 24, 2025, 9:41am UTC](https://community.sparkfun.com/t/esp32-compilation-error-triggered-by-recommended-psram-type/63680/15 "2025-03-24T09:41:54Z")

</div>

Yes,  
Restart, most probably, has been cause by wrong PSRAM type.  
I had updated the thread.
