Troubleshooting

Solve common issues with the Flipper Zero companion app

On this page

Connection Issues

App Can’t Connect to GhostESP

  • Verify serial wiring (TX, RX, GND)
  • Check that GhostESP device is powered on
  • Try restarting both devices
  • Check serial port configuration in app settings

Connection Drops During Use

  • Check wiring connections for loose connections
  • Verify power supply is stable
  • Move away from sources of electrical interference
  • Try reducing baud rate if using high-speed connection

Feature Not Working

Wi-Fi Scan Returns No Results

  • Ensure GhostESP firmware supports Wi-Fi operations
  • Check that device is not in a restricted regulatory region
  • Verify antenna is properly connected
  • Try scanning from a different location

GPS Not Working

  • Verify GPS module is connected and powered
  • Ensure GPS has clear view of sky
  • Wait for GPS to acquire satellite lock (may take 1-2 minutes)
  • Check GPS module wiring and configuration

BLE Scan Shows No Devices

  • Ensure BLE is enabled in GhostESP settings
  • Move closer to target devices
  • Check that target devices are advertising (not in sleep mode)
  • Verify BLE antenna connection

File Export Issues

PCAP Files Not Saving

  • Ensure Flipper Zero SD card is inserted
  • Check SD card has free space
  • Verify SD card is properly formatted (FAT32)
  • Check file path permissions

CSV Export Fails

  • Verify SD card is mounted
  • Check available storage space
  • Ensure GPS data is being received (for GPS-related exports)

App Crashes or Freezes

App Freezes During Operation

  • Restart the Flipper Zero
  • Update to latest app version
  • Check for firmware compatibility issues
  • Reduce capture size or scan duration

App Won’t Launch

  • Verify .fap file is compatible with your Flipper firmware version
  • Reinstall the app from the Flipper app catalog or the latest release
  • Check Flipper Zero has sufficient memory
  • Update Flipper Zero firmware if outdated

Support and Resources

Credits