u²pnpd (or u2pnpd) is a micro UPnP tool with the only purpose to announce the device on the network via UPnP. So it becomes visible on Windows(TM) workstations and the user can easily double-click on the device's icon to open the device's web frontend in the browser.
This is useful for devices which come with factory defaults set to DHCP and thus the user would need to check with his/her router to obtain the actual device's IP address.
This daemon is designed to run on OpenWrt, so it has some specifics built-in. However, all defaults detected this way can be overriden by command line arguments. These argument's names match the corresponding XML tags in the UPnP spec, so it should be easy to understand their meaning. If you don't specify one, the tag is omitted in the device descriptor. A special note to the UUID: the UUID should be the same between various invocations. This way a UPnP client can detect changes of e.g. the device's IP address and discard stale (cached) data. So it's best to create a UUID once, and then pass this to u²pnpd via parameter. When this parameter is not passed, then a random UUID is obtained from the kernel (/proc/sys/kernel/random/uuid).
Yes, this isn't really a daemon (yet) - use something like start-stop-daemon to bring this into background. Or in other words: this is left as an exercise to the reader :-)
u²pnpd is released under GPL v2-only.
http://upnp.org/specs/basic/UPnP-basic-Basic-v1-Device.pdf
The shell commands are ./autogen.sh; ./configure; make; make install.
./u2pnpd (u2pnpd 0.5) -- tool to announce this device via UPnP on the network
Usage: ./u2pnpd [<options>]
Options:
-f, --friendlyName a short user-friendly title (default: [manufacturer] [modelName])
-M, --manufacturer manufacturer name
-m, --manufacturerURL URL to manufacturer site
-D, --modelDescription long user-friendly title
-P, --modelName model name
-N, --modelNumber model number
-p, --modelURL URL to manufacturer's product pages
-S, --serialNumber manufacturer's serial number
-u, --uuid UUID of this device
-s, --httpsURL generate a HTTPS URL for the presentation URL (HTTP is used by default)
-i, --interface network interface to use
-V, --version print version and exit
-h, --help print this usage and exit
To report a bug, you can:
- fill a bug report on the issue tracker http://github.com/mhei/u2pnpd/issues
- or send an email to [email protected]
This daemon was heavily inspired by UPnP beacon from DigitalStrom project, see https://gitorious.digitalstrom.org/dss-misc/upnpbeacon
Trade names, trademarks and registered trademarks are used without special marking throughout the source code and/or documentation. All are the property of their respective owners.