""" This module will attempt to open a port in your router for Home Assistant. For more details about UPnP, please refer to the documentation at https://home-assistant.io/components/upnp/ """ import logging import voluptuous as vol from homeassistant.const import (EVENT_HOMEASSISTANT_STOP) _LOGGER = logging.getLogger(__name__) DEPENDENCIES = ['api'] DOMAIN = 'upnp' CONFIG_SCHEMA = vol.Schema({ DOMAIN: vol.Schema({}), }, extra=vol.ALLOW_EXTRA) # pylint: disable=import-error, no-member, broad-except def setup(hass, config): """Register a port mapping for Home Assistant via UPnP.""" import miniupnpc upnp = miniupnpc.UPnP() upnp.discoverdelay = 200 upnp.discover() try: upnp.selectigd() except Exception: _LOGGER.exception("Error when attempting to discover a UPnP IGD") return False upnp.addportmapping(hass.config.api.port, 'TCP', hass.config.api.host, hass.config.api.port, 'Home Assistant', '') def deregister_port(event): """De-register the UPnP port mapping.""" upnp.deleteportmapping(hass.config.api.port, 'TCP') hass.bus.listen_once(EVENT_HOMEASSISTANT_STOP, deregister_port) return True