#!/usr/bin/env python3
"""
Philips Hue Bridge Discovery Script
Finds Hue Bridge Pro devices on your local network
"""
import socket
import time
from typing import Any
import requests
def discover_hue_bridges(timeout: int = 10) -> list[dict[str, Any]]:
"""Discover Philips Hue bridges using SSDP (Simple Service Discovery Protocol)."""
print("Discovering Philips Hue bridges...")
print(f"Timeout: {timeout} seconds")
print("Make sure your Hue Bridge Pro is powered on and connected to the network")
print()
# SSDP M-SEARCH message for Hue bridges
ssdp_request = (
"M-SEARCH * HTTP/1.1\r\n"
"HOST: 239.255.255.250:1900\r\n"
'MAN: "ssdp:discover"\r\n'
"MX: 10\r\n"
"ST: ssdp:all\r\n"
"USER-AGENT: Python/3.8 UPnP/1.1\r\n"
"\r\n"
)
# Create UDP socket
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
sock.setsockopt(socket.IPPROTO_IP, socket.IP_MULTICAST_TTL, 2)
sock.settimeout(timeout)
bridges = []
try:
# Send SSDP discovery message
sock.sendto(ssdp_request.encode(), ("239.255.255.250", 1900))
start_time = time.time()
while time.time() - start_time < timeout:
try:
data, addr = sock.recvfrom(4096)
response = data.decode("utf-8", errors="ignore")
# Check if this is a Hue bridge response
if "hue" in response.lower() or "philips" in response.lower():
bridge_info = parse_ssdp_response(response, addr[0])
if bridge_info and bridge_info not in bridges:
bridges.append(bridge_info)
print(f"FOUND: Hue Bridge at {addr[0]}")
print(f" Model: {bridge_info.get('model', 'Unknown')}")
print(f" Serial: {bridge_info.get('serial', 'Unknown')}")
print()
except TimeoutError:
continue
except Exception as e:
print(f"Discovery error: {e}")
finally:
sock.close()
return bridges
def parse_ssdp_response(response: str, ip: str) -> dict[str, Any]:
"""Parse SSDP response to extract bridge information."""
lines = response.split("\n")
bridge_info = {"ip": ip}
for line in lines:
line = line.strip()
if ":" in line:
key, value = line.split(":", 1)
key = key.strip().lower()
value = value.strip()
if "server" in key and "hue" in value.lower():
bridge_info["model"] = "Hue Bridge"
if "pro" in value.lower():
bridge_info["model"] = "Hue Bridge Pro"
elif "usn" in key:
# Extract serial number from USN
if "uuid:" in value:
uuid_part = value.split("uuid:")[1].split("-")[0]
bridge_info["serial"] = uuid_part
return bridge_info
def test_bridge_connection(ip: str) -> dict[str, Any]:
"""Test connection to a discovered bridge and get detailed information."""
print(f"Testing connection to {ip}...")
try:
# Try to get bridge configuration
url = f"http://{ip}/api/config"
response = requests.get(url, timeout=5)
if response.status_code == 200:
config = response.json()
bridge_details = {
"ip": ip,
"name": config.get("name", "Unknown"),
"model": config.get("modelid", "Unknown"),
"sw_version": config.get("swversion", "Unknown"),
"api_version": config.get("apiversion", "Unknown"),
"bridge_id": config.get("bridgeid", "Unknown"),
"connected": True,
"homeaware_capable": "pro" in config.get("modelid", "").lower(),
}
print("SUCCESS: Bridge details retrieved")
print(f" Name: {bridge_details['name']}")
print(f" Model: {bridge_details['model']}")
print(f" Software: {bridge_details['sw_version']}")
print(f" HomeAware: {'Yes' if bridge_details['homeaware_capable'] else 'No'}")
print()
return bridge_details
except Exception as e:
print(f"Connection test failed: {e}")
return {"ip": ip, "connected": False, "error": str(e)}
def main():
"""Main discovery function."""
print("Philips Hue Bridge Discovery Tool")
print("=" * 40)
print()
# Discover bridges
bridges = discover_hue_bridges()
if not bridges:
print("No Hue bridges found")
print("\nTroubleshooting:")
print("1. Ensure your Hue Bridge Pro is powered on")
print("2. Make sure it's connected to your router via Ethernet")
print("3. Wait 1-2 minutes after powering on")
print("4. Try running this script closer to your router")
print("5. Check if your firewall blocks SSDP (UDP port 1900)")
print("\nAlternative methods:")
print("- Check your router's admin page for connected devices")
print("- Look for device names containing 'hue' or 'philips'")
return
print(f"Found {len(bridges)} potential bridge(s)")
print()
# Test connections and get details
detailed_bridges = []
for bridge in bridges:
details = test_bridge_connection(bridge["ip"])
detailed_bridges.append(details)
# Show results
print("DISCOVERY RESULTS")
print("=" * 40)
for i, bridge in enumerate(detailed_bridges, 1):
print(f"\nBridge #{i}:")
print(f" IP Address: {bridge['ip']}")
if bridge.get("connected"):
print(f" Name: {bridge.get('name', 'Unknown')}")
print(f" Model: {bridge.get('model', 'Unknown')}")
print(f" Software Version: {bridge.get('sw_version', 'Unknown')}")
print(f" HomeAware Capable: {'Yes' if bridge.get('homeaware_capable') else 'No'}")
print(f" Bridge ID: {bridge.get('bridge_id', 'Unknown')}")
print("\n CONFIGURATION FOR ROBOTICS MCP:")
print(" Add this to your config.yaml:")
print(f"""
hue_bridge_pro:
enabled: true
robot_id: "hue_01"
robot_type: "hue"
ip_address: "{bridge["ip"]}"
# API key will be generated on first connection
""")
else:
print(" Status: Connection failed")
print(f" Error: {bridge.get('error', 'Unknown')}")
print(f"\n{'=' * 40}")
print("NEXT STEPS:")
print("1. Add the configuration above to your Robotics MCP config.yaml")
print("2. Run the MCP server")
print(
"3. Test with: python -c \"from robotics_mcp.tools.robot_control import robot_control; import asyncio; asyncio.run(robot_control(robot_id='hue_01', action='hue_get_sensor_status'))\""
)
print("4. Enable HomeAware in the Philips Hue app and wait 24-48 hours for calibration")
if __name__ == "__main__":
main()
