Troubleshooting

PSRAM Not Detected

• Ensure PSRAM is enabled in your Arduino IDE board configuration:

  • Tools > PSRAM: "Enabled"

• Add this to your setup function to verify PSRAM:

  if (psramFound()) {
    Serial.printf("PSRAM size: %d bytes\n", ESP.getPsramSize());
  } else {
    Serial.println("No PSRAM detected!");
  }

Memory Allocation Failures

• When using large allocations, check available memory first:

  Serial.printf("Free PSRAM: %d bytes\n", ESP.getFreePsram());

• Try reducing buffer sizes or using multiple smaller buffers

Performance Issues

• HIMEM access is slower than PSRAM or RAM
• For frequently accessed data, prefer RAM > PSRAM > HIMEM
• Use the appropriate container for your use case