mirror of
https://github.com/mjg59/python-broadlink.git
synced 2024-11-10 18:00:12 +01:00
334 lines
10 KiB
Python
334 lines
10 KiB
Python
#!/usr/bin/env python3
|
|
"""The python-broadlink library."""
|
|
import socket
|
|
from typing import Generator, List, Optional, Tuple, Union
|
|
|
|
from . import exceptions as e
|
|
from .const import DEFAULT_BCAST_ADDR, DEFAULT_PORT, DEFAULT_TIMEOUT
|
|
from .alarm import S1C
|
|
from .climate import hvac, hysen
|
|
from .cover import dooya, dooya2, wser
|
|
from .device import Device, ping, scan
|
|
from .hub import s3
|
|
from .light import lb1, lb2
|
|
from .remote import rm, rm4, rm4mini, rm4pro, rmmini, rmminib, rmpro
|
|
from .sensor import a1, a2
|
|
from .switch import bg1, ehc31, mp1, mp1s, sp1, sp2, sp2s, sp3, sp3s, sp4, sp4b
|
|
|
|
SUPPORTED_TYPES = {
|
|
sp1: {
|
|
0x0000: ("SP1", "Broadlink"),
|
|
},
|
|
sp2: {
|
|
0x2717: ("NEO", "Ankuoo"),
|
|
0x2719: ("SP2-compatible", "Honeywell"),
|
|
0x271A: ("SP2-compatible", "Honeywell"),
|
|
0x2720: ("SP mini", "Broadlink"),
|
|
0x2728: ("SP2-compatible", "URANT"),
|
|
0x273E: ("SP mini", "Broadlink"),
|
|
0x7530: ("SP2", "Broadlink (OEM)"),
|
|
0x7539: ("SP2-IL", "Broadlink (OEM)"),
|
|
0x753E: ("SP mini 3", "Broadlink"),
|
|
0x7540: ("MP2", "Broadlink"),
|
|
0x7544: ("SP2-CL", "Broadlink"),
|
|
0x7546: ("SP2-UK/BR/IN", "Broadlink (OEM)"),
|
|
0x7547: ("SC1", "Broadlink"),
|
|
0x7549: ("SP mini 3", "Broadlink (OEM)"),
|
|
0x7918: ("SP2", "Broadlink (OEM)"),
|
|
0x7919: ("SP2-compatible", "Honeywell"),
|
|
0x791A: ("SP2-compatible", "Honeywell"),
|
|
0x7D0D: ("SP mini 3", "Broadlink (OEM)"),
|
|
},
|
|
sp2s: {
|
|
0x2711: ("SP2", "Broadlink"),
|
|
0x2716: ("NEO PRO", "Ankuoo"),
|
|
0x271D: ("Ego", "Efergy"),
|
|
0x2736: ("SP mini+", "Broadlink"),
|
|
},
|
|
sp3: {
|
|
0x2733: ("SP3", "Broadlink"),
|
|
0x7D00: ("SP3-EU", "Broadlink (OEM)"),
|
|
},
|
|
sp3s: {
|
|
0x9479: ("SP3S-US", "Broadlink"),
|
|
0x947A: ("SP3S-EU", "Broadlink"),
|
|
},
|
|
sp4: {
|
|
0x7568: ("SP4L-CN", "Broadlink"),
|
|
0x756B: ("SP4M-JP", "Broadlink"),
|
|
0x756C: ("SP4M", "Broadlink"),
|
|
0x756F: ("MCB1", "Broadlink"),
|
|
0x7579: ("SP4L-EU", "Broadlink"),
|
|
0x757B: ("SP4L-AU", "Broadlink"),
|
|
0x7583: ("SP mini 3", "Broadlink"),
|
|
0x7587: ("SP4L-UK", "Broadlink"),
|
|
0x7D11: ("SP mini 3", "Broadlink"),
|
|
0xA4F9: ("WS4", "Broadlink (OEM)"),
|
|
0xA569: ("SP4L-UK", "Broadlink"),
|
|
0xA56A: ("MCB1", "Broadlink"),
|
|
0xA56B: ("SCB1E", "Broadlink"),
|
|
0xA56C: ("SP4L-EU", "Broadlink"),
|
|
0xA576: ("SP4L-AU", "Broadlink"),
|
|
0xA589: ("SP4L-UK", "Broadlink"),
|
|
0xA5D3: ("SP4L-EU", "Broadlink"),
|
|
0xA6F4: ("SP4D-US", "Broadlink"),
|
|
},
|
|
sp4b: {
|
|
0x5115: ("SCB1E", "Broadlink"),
|
|
0x51E2: ("AHC/U-01", "BG Electrical"),
|
|
0x6111: ("MCB1", "Broadlink"),
|
|
0x6113: ("SCB1E", "Broadlink"),
|
|
0x618B: ("SP4L-EU", "Broadlink"),
|
|
0x6489: ("SP4L-AU", "Broadlink"),
|
|
0x648B: ("SP4M-US", "Broadlink"),
|
|
0x648C: ("SP4L-US", "Broadlink"),
|
|
0x6494: ("SCB2", "Broadlink"),
|
|
},
|
|
rmmini: {
|
|
0x2737: ("RM mini 3", "Broadlink"),
|
|
0x278F: ("RM mini", "Broadlink"),
|
|
0x27B7: ("RM mini 3", "Broadlink"),
|
|
0x27C2: ("RM mini 3", "Broadlink"),
|
|
0x27C7: ("RM mini 3", "Broadlink"),
|
|
0x27CC: ("RM mini 3", "Broadlink"),
|
|
0x27CD: ("RM mini 3", "Broadlink"),
|
|
0x27D0: ("RM mini 3", "Broadlink"),
|
|
0x27D1: ("RM mini 3", "Broadlink"),
|
|
0x27D3: ("RM mini 3", "Broadlink"),
|
|
0x27DC: ("RM mini 3", "Broadlink"),
|
|
0x27DE: ("RM mini 3", "Broadlink"),
|
|
},
|
|
rmpro: {
|
|
0x2712: ("RM pro/pro+", "Broadlink"),
|
|
0x272A: ("RM pro", "Broadlink"),
|
|
0x273D: ("RM pro", "Broadlink"),
|
|
0x277C: ("RM home", "Broadlink"),
|
|
0x2783: ("RM home", "Broadlink"),
|
|
0x2787: ("RM pro", "Broadlink"),
|
|
0x278B: ("RM plus", "Broadlink"),
|
|
0x2797: ("RM pro+", "Broadlink"),
|
|
0x279D: ("RM pro+", "Broadlink"),
|
|
0x27A1: ("RM plus", "Broadlink"),
|
|
0x27A6: ("RM plus", "Broadlink"),
|
|
0x27A9: ("RM pro+", "Broadlink"),
|
|
0x27C3: ("RM pro+", "Broadlink"),
|
|
},
|
|
rmminib: {
|
|
0x5F36: ("RM mini 3", "Broadlink"),
|
|
0x6507: ("RM mini 3", "Broadlink"),
|
|
0x6508: ("RM mini 3", "Broadlink"),
|
|
},
|
|
rm4mini: {
|
|
0x51DA: ("RM4 mini", "Broadlink"),
|
|
0x5209: ("RM4 TV mate", "Broadlink"),
|
|
0x520C: ("RM4 mini", "Broadlink"),
|
|
0x520D: ("RM4C mini", "Broadlink"),
|
|
0x5211: ("RM4C mate", "Broadlink"),
|
|
0x5212: ("RM4 TV mate", "Broadlink"),
|
|
0x5216: ("RM4 mini", "Broadlink"),
|
|
0x521C: ("RM4 mini", "Broadlink"),
|
|
0x6070: ("RM4C mini", "Broadlink"),
|
|
0x610E: ("RM4 mini", "Broadlink"),
|
|
0x610F: ("RM4C mini", "Broadlink"),
|
|
0x62BC: ("RM4 mini", "Broadlink"),
|
|
0x62BE: ("RM4C mini", "Broadlink"),
|
|
0x6364: ("RM4S", "Broadlink"),
|
|
0x648D: ("RM4 mini", "Broadlink"),
|
|
0x6539: ("RM4C mini", "Broadlink"),
|
|
0x653A: ("RM4 mini", "Broadlink"),
|
|
},
|
|
rm4pro: {
|
|
0x520B: ("RM4 pro", "Broadlink"),
|
|
0x5213: ("RM4 pro", "Broadlink"),
|
|
0x5218: ("RM4C pro", "Broadlink"),
|
|
0x6026: ("RM4 pro", "Broadlink"),
|
|
0x6184: ("RM4C pro", "Broadlink"),
|
|
0x61A2: ("RM4 pro", "Broadlink"),
|
|
0x649B: ("RM4 pro", "Broadlink"),
|
|
0x653C: ("RM4 pro", "Broadlink"),
|
|
},
|
|
a1: {
|
|
0x2714: ("A1", "Broadlink"),
|
|
},
|
|
a2: {
|
|
0x4F60: ("A2", "Broadlink"),
|
|
},
|
|
mp1: {
|
|
0x4EB5: ("MP1-1K4S", "Broadlink"),
|
|
0x4F1B: ("MP1-1K3S2U", "Broadlink (OEM)"),
|
|
0x4F65: ("MP1-1K3S2U", "Broadlink"),
|
|
},
|
|
mp1s: {
|
|
0x4EF7: ("MP1-1K4S", "Broadlink (OEM)"),
|
|
},
|
|
lb1: {
|
|
0x5043: ("SB800TD", "Broadlink (OEM)"),
|
|
0x504E: ("LB1", "Broadlink"),
|
|
0x606D: ("SLA22RGB9W81/SLA27RGB9W81", "Luceco"),
|
|
0x606E: ("SB500TD", "Broadlink (OEM)"),
|
|
0x60C7: ("LB1", "Broadlink"),
|
|
0x60C8: ("LB1", "Broadlink"),
|
|
0x6112: ("LB1", "Broadlink"),
|
|
0x644B: ("LB1", "Broadlink"),
|
|
0x644C: ("LB27 R1", "Broadlink"),
|
|
0x644E: ("LB26 R1", "Broadlink"),
|
|
0x6488: ("LB27 C1", "Broadlink"),
|
|
},
|
|
lb2: {
|
|
0xA4F4: ("LB27 R1", "Broadlink"),
|
|
0xA5F7: ("LB27 R1", "Broadlink"),
|
|
0xA6EF: ("EFCF60WSMT", "Luceco"),
|
|
},
|
|
S1C: {
|
|
0x2722: ("S2KIT", "Broadlink"),
|
|
},
|
|
s3: {
|
|
0xA59C: ("S3", "Broadlink"),
|
|
0xA64D: ("S3", "Broadlink"),
|
|
},
|
|
hvac: {
|
|
0x4E2A: ("HVAC", "Licensed manufacturer"),
|
|
},
|
|
hysen: {
|
|
0x4EAD: ("HY02/HY03", "Hysen"),
|
|
},
|
|
dooya: {
|
|
0x4E4D: ("DT360E-45/20", "Dooya"),
|
|
},
|
|
dooya2: {
|
|
0x4F6E: ("DT360E-45/20", "Dooya"),
|
|
},
|
|
wser: {
|
|
0x4F6C: ("WSER", "Wistar"),
|
|
},
|
|
bg1: {
|
|
0x51E3: ("BG800/BG900", "BG Electrical"),
|
|
},
|
|
ehc31: {
|
|
0x6480: ("EHC31", "BG Electrical"),
|
|
},
|
|
}
|
|
|
|
|
|
def gendevice(
|
|
dev_type: int,
|
|
host: Tuple[str, int],
|
|
mac: Union[bytes, str],
|
|
name: str = "",
|
|
is_locked: bool = False,
|
|
) -> Device:
|
|
"""Generate a device."""
|
|
for dev_cls, products in SUPPORTED_TYPES.items():
|
|
try:
|
|
model, manufacturer = products[dev_type]
|
|
|
|
except KeyError:
|
|
continue
|
|
|
|
return dev_cls(
|
|
host,
|
|
mac,
|
|
dev_type,
|
|
name=name,
|
|
model=model,
|
|
manufacturer=manufacturer,
|
|
is_locked=is_locked,
|
|
)
|
|
|
|
return Device(host, mac, dev_type, name=name, is_locked=is_locked)
|
|
|
|
|
|
def hello(
|
|
ip_address: str,
|
|
port: int = DEFAULT_PORT,
|
|
timeout: int = DEFAULT_TIMEOUT,
|
|
) -> Device:
|
|
"""Direct device discovery.
|
|
|
|
Useful if the device is locked.
|
|
"""
|
|
try:
|
|
return next(
|
|
xdiscover(
|
|
timeout=timeout,
|
|
discover_ip_address=ip_address,
|
|
discover_ip_port=port,
|
|
)
|
|
)
|
|
except StopIteration as err:
|
|
raise e.NetworkTimeoutError(
|
|
-4000,
|
|
"Network timeout",
|
|
f"No response received within {timeout}s",
|
|
) from err
|
|
|
|
|
|
def discover(
|
|
timeout: int = DEFAULT_TIMEOUT,
|
|
local_ip_address: Optional[str] = None,
|
|
discover_ip_address: str = DEFAULT_BCAST_ADDR,
|
|
discover_ip_port: int = DEFAULT_PORT,
|
|
) -> List[Device]:
|
|
"""Discover devices connected to the local network."""
|
|
responses = scan(
|
|
timeout, local_ip_address, discover_ip_address, discover_ip_port
|
|
)
|
|
return [gendevice(*resp) for resp in responses]
|
|
|
|
|
|
def xdiscover(
|
|
timeout: int = DEFAULT_TIMEOUT,
|
|
local_ip_address: Optional[str] = None,
|
|
discover_ip_address: str = DEFAULT_BCAST_ADDR,
|
|
discover_ip_port: int = DEFAULT_PORT,
|
|
) -> Generator[Device, None, None]:
|
|
"""Discover devices connected to the local network.
|
|
|
|
This function returns a generator that yields devices instantly.
|
|
"""
|
|
responses = scan(
|
|
timeout, local_ip_address, discover_ip_address, discover_ip_port
|
|
)
|
|
for resp in responses:
|
|
yield gendevice(*resp)
|
|
|
|
|
|
# Setup a new Broadlink device via AP Mode. Review the README to see how to enter AP Mode.
|
|
# Only tested with Broadlink RM3 Mini (Blackbean)
|
|
def setup(
|
|
ssid: str,
|
|
password: str,
|
|
security_mode: int,
|
|
ip_address: str = DEFAULT_BCAST_ADDR,
|
|
) -> None:
|
|
"""Set up a new Broadlink device via AP mode."""
|
|
# Security mode options are (0 - none, 1 = WEP, 2 = WPA1, 3 = WPA2, 4 = WPA1/2)
|
|
payload = bytearray(0x88)
|
|
payload[0x26] = 0x14 # This seems to always be set to 14
|
|
# Add the SSID to the payload
|
|
ssid_start = 68
|
|
ssid_length = 0
|
|
for letter in ssid:
|
|
payload[(ssid_start + ssid_length)] = ord(letter)
|
|
ssid_length += 1
|
|
# Add the WiFi password to the payload
|
|
pass_start = 100
|
|
pass_length = 0
|
|
for letter in password:
|
|
payload[(pass_start + pass_length)] = ord(letter)
|
|
pass_length += 1
|
|
|
|
payload[0x84] = ssid_length # Character length of SSID
|
|
payload[0x85] = pass_length # Character length of password
|
|
payload[0x86] = security_mode # Type of encryption
|
|
|
|
checksum = sum(payload, 0xBEAF) & 0xFFFF
|
|
payload[0x20] = checksum & 0xFF # Checksum 1 position
|
|
payload[0x21] = checksum >> 8 # Checksum 2 position
|
|
|
|
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) # Internet # UDP
|
|
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
|
sock.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
|
|
sock.sendto(payload, (ip_address, DEFAULT_PORT))
|
|
sock.close()
|