Frequently Asked Questions

Need help? Please see here first.
  • To help you quickly resolve your issues, we have compiled frequently asked questions and troubleshooting methods below. Please try self-troubleshooting first, as this is usually the most efficient way to solve problems.

  • If you cannot find a solution here, please feel free to contact our after-sales team for further technical support.

Contact us: support@lafvin.cn


Why is my ESP32 board not detected in the Arduino IDE?

If the ESP32 board does not appear in Tools → Port, check the following items:

  • Use a USB data cable and make sure that the cable is firmly connected to the board and the computer.

  • Install the CP2102 USB-to-UART driver. Windows users can verify the driver in Device Manager. macOS usually includes the driver; run ls /dev/cu.* in Terminal to check whether the board is detected.

  • Make sure the ESP32 core package has been installed in the Arduino IDE, then reconnect the board.

  • In Tools → Board, select the correct ESP32 board model and choose the corresponding port in Tools → Port. If several ports are listed, unplug and reconnect the board to identify the correct one.

  • If the port is detected but uploading does not start, hold the BOOT button while clicking Upload, then release it when the upload begins.

For detailed driver installation instructions, see 2. Install Serial Port Tool. For the complete upload procedure, see How To Upload Code To ESP32.


Why does the sketch fail to compile because a library or header file is missing?

This usually means that a required library has not been added to the Arduino IDE.

  • Check the error message and note the missing header name, such as DHT.h, Adafruit_SSD1306.h, or MFRC522.h.

  • Install the matching library through Library Manager, or import the provided ZIP library package.

  • Restart the Arduino IDE after installing the library, then verify the sketch again.

  • Make sure the ESP32 core package is version 3.2.0 or another supported version 3.0.0 or later. Older versions may be incompatible with the examples.

See 4. Add Libraries for the complete library list and installation instructions.


Why does uploading fail even though the board and port are selected?

First click Verify and make sure that the sketch compiles without errors. Then check the following:

  • Close the Serial Monitor and any other program that may be using the selected port.

  • Confirm that the correct ESP32 board model and COM port are selected.

  • Keep the USB cable connected and avoid disconnecting the board during upload.

  • Hold the BOOT button while clicking Upload, and release it when the upload begins.

  • If the upload still fails, press RST once after the upload completes or reconnect the board and try again.

The first upload may take 30 to 60 seconds. Do not disconnect the board while the progress is running.


Why is the Serial Monitor empty or showing unreadable characters?

Open Tools → Serial Monitor after the program has been uploaded and set the baud rate to match the value in the sketch. The examples commonly use Serial.begin(115200), so select 115200 baud.

If no message appears, press RST on the ESP32 board and check that the correct port is still selected. If the output is unreadable, the Serial Monitor baud rate does not match the program.


Why can my phone connect to the ESP32 hotspot but not open the control page?

For the IoT experiments, press RST after flashing the program so that the web server starts. Connect the phone or computer to the hotspot name shown in that experiment, then open http://192.168.4.1 in a browser.

  • Disconnect from mobile data or another Wi-Fi network temporarily if the device switches away from the ESP32 hotspot.

  • Confirm that the hotspot name matches the example program. Different projects use different names.

  • Keep the ESP32 powered while opening the page and wait a few seconds after pressing RST.

  • If the page still does not load, reopen the Serial Monitor at 115200 baud and check the startup messages for the AP address.


Why do a sensor or display show incorrect values or no output?

Check the wiring before changing the program:

  • Connect VCC and GND correctly and make sure all modules share a common ground with the ESP32.

  • Compare every signal wire with the wiring diagram for the selected experiment. Do not assume that two modules use the same GPIO pins.

  • Check that the selected library matches the module used in the example.

  • For I2C devices such as the MPU6050 and OLED, verify the SDA and SCL connections and keep the wiring short when possible.

  • Reset the board after correcting the wiring, then open the Serial Monitor to check the sensor initialization messages.


Why does a motor or relay not work reliably?

Motors and relay-controlled loads can require more current than the ESP32 can safely provide. Check the following:

  • Use the external power supply specified by the experiment and connect its ground to the ESP32 ground.

  • Do not power a motor directly from an ESP32 GPIO pin.

  • Confirm the relay or motor-driver wiring and check that the control GPIO matches the example code.

  • Test the program with the motor disconnected first, then reconnect the load after the relay state is confirmed.

  • If the board resets when the motor starts, switch off the load and check the power supply, wiring, and ground connections before trying again.