This is a demonstration project showing the capabilities of the ESP8266 when used in promiscuous mode.
It includes a command line interpretor that can use used via the serial. I have been using it on an ESP01,
but should work on any ESP8266 (or maybe even ESP32) boards.
I am using the project to develop/test code that I will be using in an IOT presence detector using WiFi and Bluetooth.
It currently includes client and beacon scanning, fake beacon creation and deauth.
It is based on lots of existing artifacts and code examples, including (to name a few)
- Ray Burnette's ESP8266 Mini Sniff (MIT) https://www.hackster.io/rayburne/esp8266-mini-sniff-f6b93a
- RandDruid/esp8266-deauth (MIT) https://github.com/RandDruid/esp8266-deauth
- Mark Szabo-Simon https://github.com/markszabo/FakeBeaconESP8266
There are lots more, but these are the main ones.
To use clone the repo, compile in the Arduino IDE, program your ESP and connect via serial - I'm afraid you are on your own with that.
Once running the ESP will start scanning for beacons and clients on all WiFi Channels.
The following commands are available via the serial prompt:
- print_all : display all detected beacons and clients
- print_beacons : display beacons detected
- print_clients : display clients detected
- fake_beacon : Generate a fake ssid for a beacon and start transmitting
- deauth_client : Generate deauthentication packets for the specified client (i.e. kick them off the network)