[go: nahoru, domu]

Skip to content

Discover devices and IPs of active devices on your LAN , on ESP-IDF ESP32/ESP8266, lwIP

License

Notifications You must be signed in to change notification settings

agentzex/ESP_network_ip_scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ESP_network_ip_scanner

This tool can be used to scan a local network (LAN) for any live devices (like computers, smartphones, routers, IoT devices and more), in order to get their IP address, MAC address, vendor and other information.
I tested it on Espressif ESP32 but it should also work on other ESP-IDF microchips using the lwIP stack. In order to use it, clone and set the EXAMPLE_ESP_WIFI_SSID and EXAMPLE_ESP_WIFI_PASS on wifi_connect.c to your WIFI SSID and password.

The way it works is by sending ARP requests packets to all of the network possible addresses (currently it assumes the network's subnet mask is 255.255.255.0 as most home networks are) and then trying to read from the lwIP ARP table in batches of 10 (this is because the default MAX_SIZE of lwIP ARP table is 10 entries, so in order to not mess around with the default configs I preferred to use this solution).
When the scan is finished, all of the found IPs are printed to stdout of the device. The found devices list is stored in a cJSON object which can be sent later to server-side.
This tool now also tries to translate found MAC addresses to vendor name using "api.macaddress.io" API. I used this one because it has a free plan but you can also set it to any other similar API by changing "MAC_LOOKUP_SERVER_ADDRESS" header or disable this functionality completely.
If you do choose to use this API, you can just create a free account, get your API token and replace it in the "MAC_LOOKUP_SERVER_ADDRESS" header.
If this tool doesn't discover all of your devices, you can also try to use ICMP echo request (aka ping) and then try to read the ARP table again for any changes.

A ping lib functionality will be added soon.

alt text

About

Discover devices and IPs of active devices on your LAN , on ESP-IDF ESP32/ESP8266, lwIP

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages