Title: Run a Full Environment Sweep
Description: Collect nearby Wi-Fi, BLE, 802.15.4, and GPS observations into a CSV file
URL: /latest/wifi/environment-sweep/
Version: latest
Section: Wi-Fi
Search index: /search-index.json

# Run a Full Environment Sweep

> Collect nearby Wi-Fi, BLE, 802.15.4, and GPS observations into a CSV file

## On this page

- [Running a sweep](#running-a-sweep)
- [Troubleshooting](#troubleshooting)
- [Related tasks](#related-tasks)

---

An environment sweep runs a sequence of wireless observations and saves the results to the SD card. The data you get depends on the board, connected hardware, and enabled radios: 802.15.4 capture is available on ESP32-C5 and C6 only, and GPS fields require a connected GPS module. Start with a mounted SD card that has free space.
## Running a sweep
- Open Menu → Wi-Fi → Monitor → Environment Sweep.
- Wait for each phase to finish. Progress appears on screen. The phases are: Wi-Fi AP scan, Wi-Fi station scan, BLE Flipper scan, BLE GATT scan, BLE raw packet scan, and (ESP32-C5/C6 only) 802.15.4 scan.
- Open /mnt/ghostesp/sweeps/sweep_N.csv on the SD card to review the export.
From the CLI, run sweep to use the default 10-second timing for each phase. Run sweep -w 15 to use a 15-second Wi-Fi scan, or sweep -b 20 for a 20-second BLE scan, and combine options such as sweep -w 15 -b 20. Run sweep -h to view all options.
Sweep phases
1
Wi-Fi AP scanBeacons and probe responses
2
Wi-Fi station scanClients seen while hopping channels
3
BLE Flipper scanFlipper Zero advertisements
4
BLE GATT scanConnectable devices and their services
5
BLE raw scanRaw advertising packets
6
802.15.4 scan (ESP32-C5/C6 only)Zigbee/Thread-style frames
Each phase runs for the configured time; the results land in one CSV.
The export contains available Wi-Fi access points and clients, BLE observations, optional 802.15.4 packets, and optional GPS coordinates.
## Troubleshooting
- No CSV is created: Confirm that the SD card is mounted and has free space.
- A radio type is missing: Check that the board supports it and that no conflicting Wi-Fi or BLE task is active.
- GPS fields are empty: Confirm the GPS module is connected and has a location fix before starting the sweep.
## Related tasks
- [Scan nearby Wi-Fi networks](/latest/wifi/survey/)
- [GPS and Wardriving](/latest/gps/)