# SSDP Control

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/ssdp-control/

The SSDP (Simple Service Discovery Protocol) control module allows searching for UPnP devices in the network.
SSDP is a UDP-based protocol that allows UPnP devices to identify themselves in the network and communicate only the most important information. These include, for example, device name, device type, or a URL describing the device.

> **Note:** Further information can be found for example on [Wikipedia](https://en.wikipedia.org/wiki/Simple_Service_Discovery_Protocol)

### Installation

The SSDP Control is automatically installed as a core instance. This can be found in the object tree under core instances.

### Configuration

The module does not require any further configuration. By default it uses port 1900 to search for devices.

## YC_SearchDevices

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/ssdp-control/yc-searchdevices/

`array YC_SearchDevices(int $InstanceID, string $SearchTarget)`

_Requires Symcon >= 5.3_

sends a request to the local network

**Parameters**

- `$InstanceID` (int): ID of the SSDP control to be requested
- `$SearchTarget` (string): .

**Returns** (array): Returns all information about found devices as an array.

.

**Example**

```php
YC_SearchDevices(27253, "ssdp:all");

// Sample output
var_dump(YC_SearchDevices(27253, "ssdp:all"));
/*
array(97) {
[...]
    [11]=>
    array(9) {
        ["CacheControl"]=>
        string(14) "max-age = 1800"
        ["Date"]=>
        string(0) ""
        ["Ext"]=>
        string(0) ""
        ["Location"]=>
        string(52) "http://172.17.31.142:1400/xml/device_description.xml"
        ["Server"]=>
        string(38) "Linux UPnP/1.0 Sonos/53.2-70210 (ZPS5)"
        ["ST"]=>
        string(47) "urn:schemas-upnp-org:service:DeviceProperties:1"
        ["USN"]=>
        string(78) "uuid:RINCON_000E58507DEA01400::urn:schemas-upnp-org:service:DeviceProperties:1"
        ["Fields"]=>
        array(5) {
            [0]=>
            string(52) "X-RINCON-HOUSEHOLD: HHID_tZkieK2lkPYES3tycishsbwfXIz"
        [1]=>
        string(21) "X-RINCON-BOOTSEQ: 636"
        [2]=>
        string(20) "X-RINCON-WIFIMODE: 0"
        [3]=>
        string(19) "X-RINCON-VARIANT: 0"
        [4]=>
        string(83) "HOUSEHOLD.SMARTSPEAKER.AUDIO: HHID_tZkieK2lkPYES3tycishsbwfXIz.hPqvaa7W35eMY2P3XidJ"
    }
    ["IPv4"]=>
    string(13) "172.17.31.142"
    )
[...]
}
*/
```