About SSDP
Section titled “About SSDP”SSDP (Simple Service Discovery Protocol) is the discovery protocol of UPnP. It is supported on Windows out of the box: the board is shown in the Network section of the file explorer, and a double click opens the web interface.
It needs SSDP_FEATURE, MDNS_FEATURE and HTTP_FEATURE in configuration.h.
SSDP is only started in station mode (WiFi client or Ethernet) when the HTTP server is running, not in access point mode.
To find your board from a computer, see SSDP Discovery.
Its state is reported by [ESP420] as SSDP (ESP32 only) with the IP address used, and by mDNS as ssdp TXT record, see mDNS.
Device description
Section titled “Device description”The board answers the SSDP search requests as upnp:rootdevice, and the device description is available at http://(board ip)/description.xml.
| Field | Value |
|---|---|
| Friendly name | hostname |
| Serial number | chip id |
| Presentation URL | / |
| Model name | ESP_MODEL_NAME |
| Model number | ESP_MODEL_NUMBER |
| Model URL | ESP_MODEL_URL |
| Model description | ESP_MODEL_DESCRIPTION (optional, not used by Windows) |
| Manufacturer | ESP_MANUFACTURER_NAME |
| Manufacturer URL | ESP_MANUFACTURER_URL |
Customization
Section titled “Customization”The model and manufacturer fields can be changed in configuration.h:
/* Model name * Modele name of device */#define ESP_MODEL_NAME "ESP Board"
/* Model number * Modele number of device */#define ESP_MODEL_NUMBER "ESP3D 3.0"
/* Model url * Modele url of device */#define ESP_MODEL_URL "https://www.espressif.com/en/products/devkits"
/* Manufacturer name * Manufacturer name of device */#define ESP_MANUFACTURER_NAME "Espressif Systems"
/* Manufacturer url * Manufacturer url of device */#define ESP_MANUFACTURER_URL "https://www.espressif.com"