Troubleshooting

Camera not initializing → Check PSRAM is set to OPI PSRAM in Arduino IDE Tools menu. This is required.

Wi-Fi not connecting → Confirm 2.4GHz network. ESP32 does not support 5GHz. Check SSID and password are correct.

App not finding device → Make sure ESP32 is powered on. Look for "Omi" in Bluetooth scan. Restart both app and device.

No transcription appearing → Check Deepgram API key in .env. Verify backend is running and API_BASE_URL is set correctly in the app.

Short battery life → Reduce capture frequency. Enable deep sleep between captures. Lower camera resolution.

Build errors in Arduino IDE → Ensure ESP32 board package version 2.9.0 is installed. Use exact version — other versions may break camera driver.