ESP8266-Network-Scanner

A MicroPython-based network scanner for ESP8266 chips.

Description

The ESP8266 Network Scanner is a versatile and efficient tool for monitoring and scanning wireless Access Point (AP) networks using ESP8266 microcontroller-based chips. This project allows you to easily scan for available Wi-Fi AP networks in your vicinity and collect essential information such as SSID, signal strength (RSSI), encryption type, and channel. The collected data is stored in a JSON file for analysis and further use.

Features

• Continuous scanning of nearby Wi-Fi networks.
• Data collection for SSID, RSSI, encryption type, and channel.
• JSON-based database for storing network information.
• Simple and intuitive MicroPython codebase.
• Easily adaptable for various IoT and network monitoring applications.

Getting Started

Prepare your board first, follow https://docs.micropython.org/en/latest/esp8266/tutorial/intro.html and install the necessary firmware.

1. Clone the Repository:

2. Upload Code to ESP8266:

• Use se ampy to upload the main.py and db.py files to your ESP8266 device.

  Install ampy first by running:

  sudo pip install adafruit-ampy
  

  then, you can upload files by running:

  sudo ampy --port /dev/ttyUSB0 put main.py
  sudo ampy --port /dev/ttyUSB0 put db.py
  

3. Run the Scanner:

• Power up your ESP8266 and let it run the scanning script.
• The collected network data will be stored in a JSON file called networks.json.

4. View and Analyze Data:

• Retrieve the JSON file from the ESP8266 or access it remotely, depending on your setup.

  You can retrieve "networks.json" by running:

  sudo ampy --port /dev/ttyUSB0 get networks.json
  

  or write the output to data.json

  sudo ampy --port /dev/ttyUSB0 get networks.json > data.json
  

• Analyze the collected data to gain insights into nearby Wi-Fi networks.

License

This project is licensed under the MIT License - see the LICENSE file for details.