FAQ & Troubleshooting

Common Issues

Robot doesn't move but screen is on

Possible Cause: Battery switch is off, or low battery.

Solution: Check the physical switch on the UniBase. Ensure the battery icon shows a charged state.

Compilation Error: "UniBase.h: No such file"

Possible Cause: Library not installed correctly.

Solution: Verify that the UNI folder is inside your Arduino/libraries directory. Restart Arduino IDE.

UART commands are ignored

Possible Cause: Wiring issue or incorrect baud rate.

Solution:

  • Ensure RX connects to TX, and TX connects to RX.
  • Check if you are calling robot.UniBaseControl() in the ESP32 loop.
  • Verify GND is shared between boards.

Debug Tips

  • Use robot.displayPrint("Debug Info") to show status on the OLED if Serial monitor is unavailable.
  • In UART mode, the ESP32 logs received commands to its main Serial monitor (USB) if DEBUG_MODE is enabled in `UniBase.h`.