Upnp Presentation URL

[xoseperez]

Originally reported by: Peter (Bitbucket: PG1234, GitHub: PG1234)

---

Hi, can you please add the Upnp presentation Url function. With that it's possible to find the devices in the Windows Network Neighborhood and with Upnp tools. It's small, only some lines of code and helps a lot during commissioning or with DHCP configured devices.

Peter

[xoseperez]

Do you have a sample code? There is already an SSDP implementation (see #282) but I cannot test it.

[xoseperez]

Original comment by Peter (Bitbucket: PG1234, GitHub: PG1234):

---

Two things are nessesary:

1. a multi(broad)cast

2. a presentation webside
   server.on("/description.xml", .......
   );

A full example you can find here:
https://github.com/esp8266/Arduino/blob/master/libraries/ESP8266SSDP/ESP8266SSDP.cpp

For the beginning please take a UUID from an example !

[xoseperez]

Original comment by Peter (Bitbucket: PG1234, GitHub: PG1234):

---

Or: Parts from my code

#!arduino


server.on("/description.xml", HTTP_GET, [](AsyncWebServerRequest * request) {
    StreamString output;
    if (output.reserve(1024))
    {
      uint32_t ip = WiFi.localIP();
      uint32_t chipId = ESP.getChipId();
      output.printf(ssdpTemplate,
                    IP2STR(&ip),
                    hostName,
                    chipId,
                    modelName,
                    modelNumber,
                    (uint8_t) ((chipId >> 16) & 0xff),
                    (uint8_t) ((chipId >>  8) & 0xff),
                    (uint8_t)   chipId        & 0xff
                   );
      request->send(200, "text/xml", (String)output);
    }
    else
    {
      request->send(500);
    }
  });

static const char* ssdpTemplate =
  "<?xml version=\"1.0\"?>"
  "<root xmlns=\"urn:schemas-upnp-org:device-1-0\">"
  "<specVersion>"
  "<major>1</major>"
  "<minor>0</minor>"
  "</specVersion>"
  "<URLBase>http://%u.%u.%u.%u:80/</URLBase>"
  "<device>"
  "<deviceType>upnp:rootdevice</deviceType>"
  "<friendlyName>%s</friendlyName>"
  "<presentationURL>/</presentationURL>"
  "<serialNumber>%u</serialNumber>"
  "<modelName>%s</modelName>"
  "<modelNumber>%s</modelNumber>"
  "<modelURL>http://www.espressif.com</modelURL>"
  "<manufacturer>Espurna</manufacturer>"
  "<manufacturerURL>https://bitbucket.org/xoseperez/espurna/</manufacturerURL>"
  "<UDN>uuid:38323636-4558-4dda-9188-cda0e6%02x%02x%02x</UDN>"
  "</device>"
  "</root>\r\n"
  "\r\n";

setup_upnp();

void setup_upnp()
{
  Serial.printf("Starting Upnp...\n");

  SSDP.setSchemaURL("description.xml");
  SSDP.setHTTPPort(80);
  SSDP.setName("Espurna");
  SSDP.setSerialNumber(String(ESP.getChipId()));
  SSDP.setURL("/");
  SSDP.setModelName("Espurna S on off Touch Sensor");
  SSDP.setModelNumber("929000226503");
  SSDP.setModelURL("http://www.sonoxxf.de/");
  SSDP.setManufacturer("sonoxxf");
  SSDP.setManufacturerURL("https://bitbucket.org/xoseperez/espurna/");
  SSDP.setDeviceType("upnp:rootdevice"); //https://github.com/esp8266/Arduino/issues/2283
  SSDP.begin();

  Serial.println("OK");
}

[xoseperez]

Will be released with 1.12.2

[ghost]

Hi - it works well !
Looks like this in Win7:

Two things:

1. It's no tnessesary to report each relay/switch. Only the hole device.
2. Something is wrong with the data (mayby one parameter missing) the simple double click on the icon doesn't open the browser. I will check this.

(The Sonoff GW has no Upnp enabled ?)

Additional a description field in the Espurna Settings would be interesting. Like 'Switch in the Kitchen'. This could than also be visible in the Upnp Properties.

Peter

[philbowles]

I know I'm a year too late, but if you would prefer them to look like this:

..then let me know: it's pretty easy change...

[mcspr]

If you mean Belkin names from the screenshot above, I think those are from Alexa (back when it was announcing as Belkin Wemo and not Hue bridge)
Stuff that was added is enabled via SSDP_SUPPORT=1 define:
https://github.com/xoseperez/espurna/blob/master/code/espurna/ssdp.ino