After releasing some projects with the ESP32-CAM, some readers reported issues when trying to use the ESP32-CAM. This guide is a compilation with the most common errors when using the ESP32-CAM and how to fix them.
We’ve released the following projects with the ESP32-CAM:
- Video Streaming, Face Detection and Face Recognition
- ESP32 IP CAM – Video Streaming [Home Assistant and Node-RED]
- Take Photo and Save to MicroSD Card
- PIR Motion Detector with Photo Capture
- Take Photo, Save to SPIFFS and Display in Web Server
Note: some of our readers reported errors when trying to follow the ESP32-CAM project with Home Assistant. We’ve modified some lines on the code, so most of the problems related with that project should be fixed.
Please note that we couldn’t reproduce some of the errors on our end. However, we’ve gathered all the information given by our readers to get answers to the most common issues.
If you have a different problem or a different solution to these issues, you can share your tips by writing a comment below.
Most common errors:
- Failed to connect to ESP32: Timed out waiting for packet header
- Camera init failed with error 0x20001 or similar
- Brownout detector or Guru meditation error
- Sketch too big error – Wrong partition scheme selected
- Board at COMX is not available – COM Port Not Selected
- Psram error: GPIO isr service is not installed
- Weak Wi-Fi Signal
- No IP Address in Arduino IDE Serial Monitor
- Can’t open web server
- The image lags/shows lots of latency
- esp_camera_fb_get[]: Failed to get the frame on time!
1. Failed to connect to ESP32: Timed out waiting for packet header
This error means that the ESP32-CAM is not in flashing mode or it is not connected properly to the FTDI programmer.
Double-check the steps to upload code
Double-check that you’ve followed the exact steps to put your ESP32-CAM in flashing mode. Failing to complete one of the steps may result in that error. Here’s the steps you need to follow:
Connect the ESP32-CAM board to your computer using an FTDI programmer. Follow the next schematic diagram:
Important: GPIO 0 needs to be connected to GND so that you’re able to upload code.
Many FTDI programmers have a jumper that allows you to select 3.3V or 5V. Make sure the jumper is in the right place to select 5V.
Important: GPIO 0 needs to be connected to GND so that you’re able to upload code.
ESP32-CAMFTDI ProgrammerGNDGND5VVCC [5V]U0RTXU0TRXGPIO 0GND
To upload the code, follow the next steps:
- Go to Tools > Board and select AI-Thinker ESP32-CAM.
- Go to Tools > Port and select the COM port the ESP32 is connected to.
- Then, click the upload button to upload the code.
- When you start to see these dots on the debugging window as shown below, press the ESP32-CAM on-board RST button.
After a few seconds, the code should be successfully uploaded to your board.
GPIO 0 must be connected to GND
Important: if you can’t upload the code, double-check that GPIO 0 is connected to GND and that you selected the right settings in the Tools menu. You should also press the on-board Reset button to restart your ESP32 in flashing mode. Also, check that you have the FTDI programmer jumper cap set to 5V.
Check the FTDI programmer you are using
One of our readers reported the following: “found out that you can program the board with a USB-to-TTL module model CP2102 and that the CH340 model does NOT work“. This is the FTDI programmer we’re using.
Power the ESP32-CAM with 5V
Some of our readers reported that they could only upload code when the ESP32 was powered with 5V. So, power the ESP32-CAM with 5V.
FTDI Programmer 5V
Measure the output voltage of your FTDI programmer [VCC and GND] using a Multimeter to ensure it’s providing 5V to your ESP32-CAM.
2. Camera init failed with error 0x20001 or similar
If you get this exact error, it means that your camera OVX is not connected properly to your ESP32 board or you have the wrong pin assignment in the code.
Sometimes, unplugging and plugging the FTDI programmer multiple times or restart the board multiple times, might solve the issue.
Camera not connected properly
The camera has a tiny connector and you must ensure it’s connected in the the right away and with a secure fit, otherwise it will fail to establish a connection.
Wrong pin assignment in the code
When you get this error, it might also mean that you didn’t select the right board in the define section or the pin definition is wrong for your board.
Make sure you select the right camera module in your projects. You just need to uncomment the right camera module and comment all the others:
//
# define CAMERA_MODEL_WROVER_KIT
//
# define CAMERA_MODEL_M5STACK_PSRAM
# define CAMERA_MODEL_AI_THINKER
In this example, we’re using the CAMERA_MODEL_AI_THINKER, so it’s the one that is enabled. Otherwise, it will fail the pin assignment and the camera will fail to init.
There are many esp32-cam boards being released [“fake boards”] that the wiring between the ESP32 and the OV camera might be different, so selecting the camera module, might not be enough. You might need to check each gpio declaration with your board pinout.
For example, M5Stack board without PSRAM has a different pin assignment than the M5STACK with PSRAM [defined on the code by default]. So, you need to change the pin definition in the code accordingly to the board pinout.
Not enough power through USB source
If you’re powering your ESP32 through a USB port on your computer, it might not be supplying enough power.
Faulty FTDI programmer
Some readers also reported this problem was solved by replacing their actual FTDI programmer with this one.
The camera/connector is broken
If you get this error, it might also mean that your camera or the camera ribbon is broken. If that is the case, you may get a new OV2640 camera probe.
3. Brownout detector or Guru meditation error
When you open your Arduino IDE Serial monitor and the error message “Brownout detector was triggered” is constantly being printed over and over again. It means that there’s some sort of hardware problem.
It’s often related to one of the following issues:
- Poor quality USB cable;
- USB cable is too long;
- Board with some defect [bad solder joints];
- Bad computer USB port;
- Or not enough power provided by the computer USB port.
Solution:
- try a different shorter USB cable [with data wires]
- use a different computer USB port or use a USB hub with an external power supply
- some readers reported that when powering the ESP32-CAM with 5V, the issue was fixed.
Also, follow the suggestions described in issue 2.
4. Sketch too big error – Wrong partition scheme selected
When you get the following error:
Sketch too big; see //www.arduino.cc/en/Guide/Troubleshooting
# size for tips on reducing it.
Error compiling for board ESP32 Dev Module.
It means that you haven’t selected the right partition scheme. Make sure you select the right partition scheme. In your Arduino IDE, go to Tools > Partition Scheme, select “Huge APP [3MB No OTA]“.
5. Board at COMX is not available – COM Port Not Selected
If you get the following error or similar:
serial.serialutil.SerialException: could not open port 'COM8': WindowsError[2, 'The system cannot find the file specified.']
Failed to execute script esptool
the selected serial port Failed to execute script esptool
does not exist or your board is not connected
Board at COM8 is not available
It means that you haven’t selected the COM port in the Tools menu. In your Arduino IDE, go to Tools > Port and select the COM port the ESP32 is connected to.
It might also mean that the ESP32-CAM is not establishing a serial connection with your computer or it is not properly connected to the USB connector.
6. Psram error: GPIO isr service is not installed
You are using a board without PSRAM and you get the following error or similar:
E [161] gpio: gpio_isr_handler_remove[380]: GPIO isr service is not installed, call gpio_install_isr_service[] first
Camera init failed with error 0x101
when the board was initialized with the following settings:
config.frame_size = FRAMESIZE_UXGA;
config.jpeg_quality = 10;
config.fb_count = 2;
Adding the following fixes the issues [it lowers the image resolution so it won’t need so much space to store images. However, as a result, you cannot get some high resolution formats due to the limited memory]:
if[psramFound[]]{
config.frame_size = FRAMESIZE_UXGA;
config.jpeg_quality = 10;
config.fb_count = 2;
} else {
config.frame_size = FRAMESIZE_SVGA;
config.jpeg_quality = 12;
config.fb_count = 1;
}
Note: face recognition and detection doesn’t work with boards without PSRAM. However, you can still use all the other functionalities of the board. For example, although you can’t use the face recognition and detection features of this project [ESP32-CAM Video Streaming and Face Recognition with Arduino IDE], you can still play with the example and explore the board features as long as you have the right pin assignment in the code.
7. Weak Wi-Fi Signal
Some readers reported that after powering the ESP32-CAM with 5V, they’ve gotten a more stable Wi-Fi signal. You can read this dedicated guide to learn how to connect an external antenna to the ESP32-CAM and extend Wi-Fi coverage.
The ESP32-CAM has the option to use either the built-in antenna or an external antenna. If your ESP32-CAM AI-Thinker has no Wi-Fi connection or poor connection, it might have the external antenna enabled. If you connect an external antenna to the connector, it should work fine.
Check if the jumper 0K resistor by the antenna connector is in the proper position for the desired antenna. There are 3 little white squares laid out like a “width > 400]{ if[fb->format != PIXFORMAT_JPEG]{ bool jpeg_converted = frame2jpg[fb, 80, &_jpg_buf, &_jpg_buf_len]; esp_camera_fb_return[fb]; fb = NULL; if[!jpeg_converted]{ Serial.println["JPEG compression failed"]; res = ESP_FAIL; } } else { _jpg_buf_len = fb->len; _jpg_buf = fb->buf; } } } if[res == ESP_OK]{ size_t hlen = snprintf[[char *]part_buf, 64, _STREAM_PART, _jpg_buf_len]; res = httpd_resp_send_chunk[req, [const char *]part_buf, hlen]; } if[res == ESP_OK]{ res = httpd_resp_send_chunk[req, [const char *]_jpg_buf, _jpg_buf_len]; } if[res == ESP_OK]{ res = httpd_resp_send_chunk[req, _STREAM_BOUNDARY, strlen[_STREAM_BOUNDARY]]; } if[fb]{ esp_camera_fb_return[fb]; fb = NULL; _jpg_buf = NULL; } else if[_jpg_buf]{ free[_jpg_buf]; _jpg_buf = NULL; } if[res != ESP_OK]{ break; } //Serial.printf["MJPG: %uB\n",[uint32_t][_jpg_buf_len]]; } return res; } void startCameraServer[]{ httpd_config_t config = HTTPD_DEFAULT_CONFIG[]; config.server_port = 80; httpd_uri_t index_uri = { .uri = "/", .method = HTTP_GET, .handler = stream_handler, .user_ctx = NULL }; //Serial.printf["Starting web server on port: '%d'\n", config.server_port]; if [httpd_start[&stream_httpd, &config] == ESP_OK] { httpd_register_uri_handler[stream_httpd, &index_uri]; } } void setup[] { WRITE_PERI_REG[RTC_CNTL_BROWN_OUT_REG, 0]; //disable brownout detector Serial.begin[115200]; Serial.setDebugOutput[false]; camera_config_t config; config.ledc_channel = LEDC_CHANNEL_0; config.ledc_timer = LEDC_TIMER_0; config.pin_d0 = Y2_GPIO_NUM; config.pin_d1 = Y3_GPIO_NUM; config.pin_d2 = Y4_GPIO_NUM; config.pin_d3 = Y5_GPIO_NUM; config.pin_d4 = Y6_GPIO_NUM; config.pin_d5 = Y7_GPIO_NUM; config.pin_d6 = Y8_GPIO_NUM; config.pin_d7 = Y9_GPIO_NUM; config.pin_xclk = XCLK_GPIO_NUM; config.pin_pclk = PCLK_GPIO_NUM; config.pin_vsync = VSYNC_GPIO_NUM; config.pin_href = HREF_GPIO_NUM; config.pin_sscb_sda = SIOD_GPIO_NUM; config.pin_sscb_scl = SIOC_GPIO_NUM; config.pin_pwdn = PWDN_GPIO_NUM; config.pin_reset = RESET_GPIO_NUM; config.xclk_freq_hz = 20000000; config.pixel_format = PIXFORMAT_JPEG; if[psramFound[]]{ config.frame_size = FRAMESIZE_UXGA; config.jpeg_quality = 10; config.fb_count = 2; } else { config.frame_size = FRAMESIZE_SVGA; config.jpeg_quality = 12; config.fb_count = 1; } // Camera init esp_err_t err = esp_camera_init[&config]; if [err != ESP_OK] { Serial.printf["Camera init failed with error 0x%x", err]; return; } // Connect to Wi-Fi network with SSID and password Serial.print["Setting AP [Access Point]…"]; // Remove the password parameter, if you want the AP [Access Point] to be open WiFi.softAP[ssid, password]; IPAddress IP = WiFi.softAPIP[]; Serial.print["Camera Stream Ready! Connect to the ESP32 AP and go to: //"]; Serial.println[IP]; // Start streaming web server startCameraServer[]; } void loop[] { delay[1]; }
View raw code
To better understand how it works, you can read the next tutorial:
- ESP32 Access Point [AP] for Web Server
Wrapping Up
We hope you’ve found this troubleshooting guide useful and you were able to make your ESP32-CAM work with our projects.
If you have any other issues or suggestions on how to fix them, please post a comment below.
If you like this project, you may also like other projects with the ESP32-CAM:
- ESP32-CAM AI-Thinker Pinout Guide: GPIOs Usage Explained
- Video Streaming, Face Detection and Face Recognition
- Build ESP32-CAM Projects [eBook]
- Read all our ESP32-CAM Projects, Tutorials and Guides
Thank you for reading.
P.S. It is very difficult to understand what’s wrong with your project when we can’t reproduce the error on our end. However, if you post the error, there might be other readers with the same issue/solution, so we encourage you to interact in the comment’s section.