Module: RUPNP::SSDP

Defined in:

lib/rupnp/ssdp.rb,
lib/rupnp/ssdp/http.rb

Overview

SSDP module. This a discovery part of UPnP.

Author:

• Sylvain Daubert

Defined Under Namespace

Modules: HTTP, SearchResponder Classes: Listener, MSearchResponder, MulticastConnection, Notifier, Searcher, USearchResponder

Constant Summary

KNOWN_TARGETS =

Some shorcut for common targets

{
  :all  => 'ssdp:all',
  :root => 'upnp:rootdevice'
}

Class Method Summary

• .listen(options = {}) ⇒ Object

  Listen for devices’ announces.

• .notify(type, stype, options = {}) ⇒ Object

  Notify announces.

• .search(target = :all, options = {}) ⇒ Object

  Search devices.

Class Method Details

.listen(options = {}) ⇒ Object

Listen for devices’ announces

Parameters:

• options (Hash) (defaults to: {}) —

  see RUPNP::SSDP::Listener#initialize

# File 'lib/rupnp/ssdp.rb', line 34

def self.listen(options={})
  EM.open_datagram_socket(MULTICAST_IP, DISCOVERY_PORT,
                          SSDP::Listener, options)
end

.notify(type, stype, options = {}) ⇒ Object

Notify announces

Parameters:

• options (Hash) (defaults to: {}) —

  see RUPNP::SSDP::Notifier#initialize

# File 'lib/rupnp/ssdp.rb', line 41

def self.notify(type, stype, options={})
  EM.open_datagram_socket(MULTICAST_IP, DISCOVERY_PORT,
                          SSDP::Notifier, type, stype, options)
end

.search(target = :all, options = {}) ⇒ Object

Search devices

Parameters:

• target (Symbol, String) (defaults to: :all)
• options (Hash) (defaults to: {}) —

  see RUPNP::SSDP::Searcher#initialize

# File 'lib/rupnp/ssdp.rb', line 27

def self.search(target=:all, options={})
  options[:search_target] =  KNOWN_TARGETS[target] || target
  EM.open_datagram_socket '0.0.0.0', 0, SSDP::Searcher, options
end