The UPnP Browser tool allows you to see all UPnP-enabled devices currently plugged in the network.
The tool is started with the browser script located in the bin/tools/upnp folder.
The tool is divided in two. The left side hosts the UPnP devices arranged in a tree structure - the UPnP Device Tree. The right part shows the properties related to the node chosen on the left.
Figure 1: General look over the UPnP Browser tool.
You can use the
mbs.upnp.multicast.port system property to change
the port on which the UPnP Browser listens for newly plugged devices. It must
match with the multicast port used in the UPnP network.
The root of the tree is called UPnP Devices. It is followed by the UPnP devices available on the network, represented by their friendly names. The next levels of the tree contain the UPnP embedded devices and services. Embedded devices are again represented by their friendly names. Services are represented by their service types.
If a UPnP device has its own icon, it is represented by that icon in the tree. Otherwise, UPnP devices are displayed with the default one.
If you select a UPnP device from the device tree, you see the properties of the device on the right.
For each UPnP device the values of the following properties appear (see Figure 1):
Unique Device Name. The UDN of the selected UPnP device.
Friendly Name. The user-friendly name of the UPnP device.
Device type. The type of the UPnP device.
Manufacturer, Model name, Model description, Model number, Serial number, Universal Product Code, Manufacturer URL and Model URL. Human readable information about the UPnP device.
Presentation URL. The URL, which contains the presentation resources of the UPnP device.
Description URL. The URL where the description XML of the UPnP device (its DCPD) is located.
With the Browse buttons you can load the corresponding URL in the Web browser assigned with the Options -> Browser settings menu command or with the tool from the toolbar. Initially, the OS default browser is called (Windows OS only).
The Remove button removes the selected device from the UPnP device tree until the browser searches again for UPnP devices.
If you choose a node that represents a UPnP service, the UPnP Browser tool shows information about the service, its actions and service state variables. The service attributes and their values appear in the right pane:
Figure 2: Service properties.
Service type. The UPnP service type.
Service ID. The ID of the UPnP service.
Service control URL. The URL that can be used for controlling the UPnP service.
Service control protocol document. The URL of the service control protocol document (SCPD) that is in XML format. It declares the variables and the actions of the service. To view this document in a Web browser, click Browse.
Variables. The service state variables and their values, arranged in a table. By using the Query button you can make a query for the current value of a variable.
Actions. The actions declared by the UPnP service. They are displayed together with their arguments, if such are declared. If arguments should be passed to the command, then you can modify the value of each argument in the corresponding field.
To invoke the action, click the Invoke button. You may check the Auto invoke on change option to impose automatic execution of the action when you change the value of its input argument.
Customization options are activated with the Options -> Settings menu command or with the button from the toolbar. There are two kinds of settings that the UPnP Browser tool supports: global for some helpful runtime operations and toolbar for adjusting the visual interface of the tool. They are represented by separate tabs in the issued Settings dialog.
At the Global tab you can choose a Web browser to use for viewing this document and set using the system colors of the local operating system.
The Toolbar tab contains the toolbar settings for customization of the toolbar. You can rearrange the toolbar as well as switch on/off the usage of some helper parts - button labels, toolbar and status bar.
To customize the appearance of the UPnP Browser tools, use the settings loaded with the Options -> Settings menu command.
It seems that some versions of Mozilla-based Web browsers, running on Linux, do not support loading of IPv6 URLs when passed as command line arguments. IPv4 addresses are handled properly.
UPnP is a certification mark of the UPnP Implementers Corporation.