Skip to content

cloofsiu/ESP32-mac-address-scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Repository: ESP32 MAC Address Scanner

Welcome to the ESP32 MAC Address Sniffer project! This project is designed to help you scan and display MAC addresses of Bluetooth Low Energy (BLE) devices using an ESP32-WROOM module. The data is presented on a 1602 LCD module, making it a handy tool for robotics applications and BLE device management.

Logo


Components Used

  • ESP32-WROOM: The core microcontroller for this project.
  • 1602 LCD Module: For displaying the scanned device information.
  • Two Breadboards: For cable expansion and easy prototyping.
  • Wires and Connectors: To connect all components together.


Features

BLE Scanning: Scans for nearby BLE devices and retrieves their MAC addresses and names.
LCD Display: Displays the device information on a 1602 LCD module.
Button Navigation: Use the BOOT button to cycle through the list of detected devices.


Demo video

Demonstration Youtube video


How to Use

1. Hardware Setup:

  • Connect the ESP32-WROOM to the breadboards.
  • Connect the 1602 LCD module to the ESP32 using an I2C interface.
  • Connect the BOOT button to the ESP32.

2. Software Setup:

  • Clone this repository.
  • Upload the provided code to your ESP32 using the Arduino IDE or another suitable development environment.
  • Make sure to install the necessary libraries (Wire.h, LiquidCrystal_I2C.h, BLEDevice.h).

3. Running the Scanner:

  • Power up the ESP32.
  • The ESP32 will scan for BLE devices for 5 seconds.
  • Detected devices will be displayed on the LCD. Use the BOOT button to navigate through the list.

Applications in Robotics

This MAC Address Scanner Sniffer can be particularly useful in robotics for identifying and managing BLE devices such as sensors and controllers. It simplifies the process of troubleshooting and device management, making it an essential tool for any robotics enthusiast.


Contributing

Feel free to fork this repository and contribute by adding new features or improving the existing code. Pull requests are welcome!


License

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


Contact

For any questions or suggestions, please feel free to contact me via GitHub or email [email protected]



Happy building,

Cloof Siu

Releases

No releases published

Packages

No packages published

Languages