Magic Home / Surp Life / flux_led
This is a utility for controlling stand-alone Magic Home and Surp Life devices manufactured by Zengge. The protocol was reverse-engineered by studying packet captures between a bulb and the controlling "Magic Home" mobile app. The code here dealing with the network protocol is littered with magic numbers, and ain't so pretty. But it does seem to work!
So far most of the functionality of the apps is available here via the CLI and/or programmatically.
The classes in this project could very easily be used as an API, and incorporated into a GUI app written in PyQt, Kivy, or some other framework.
Minimum python version
3.7
Available:
- Discovering bulbs on LAN
- Turning on/off bulb
- Get state information
- Setting "warm white" mode
- Setting single color mode
- Setting preset pattern mode
- Setting custom pattern mode
- Reading timers
- Setting timers
- Sync clock
- Music Mode for devices with a built-in microphone (asyncio version only)
- Remote access administration (asyncio version only)
- Device configuration including wiring order, ic type, pixels, etc (asyncio version only)
Some missing pieces:
- Initial administration to set up WiFi SSID and passphrase/key.
Cool feature:
- Specify colors with names or web hex values. Requires that python "webcolors" package is installed. (Easily done via pip, easy_install, or apt-get, etc.) Use --listcolors to show valid color names.
Installation:
- Flux_led package available at https://pypi.python.org/pypi/flux-led/
pip install flux_led
Examples:
Scan network:
flux_led -s
Scan network and show info about all:
flux_led -sSti
Turn on:
flux_led 192.168.1.100 --on
flux_led 192.168.1.100 -192.168.1.101 -1
Turn on all bulbs on LAN:
flux_led -sS --on
Turn off:
flux_led 192.168.1.100 --off
flux_led 192.168.1.100 --0
flux_led -sS --off
Set warm white, 75%
flux_led 192.168.1.100 -w 75 -1
Set fixed color red :
flux_led 192.168.1.100 -c Red
flux_led 192.168.1.100 -c 255,0,0
flux_led 192.168.1.100 -c "#FF0000"
Set preset pattern #35 with 40% speed:
flux_led 192.168.1.100 -p 35 40
Set custom pattern 25% speed, red/green/blue, gradual change:
flux_led 192.168.1.100 -C gradual 25 "red green (0,0,255)"
Sync all bulb's clocks with this computer's:
flux_led -sS --setclock
Set timer #1 to turn on red at 5:30pm on weekdays:
flux_led 192.168.1.100 -T 1 color "time:1730;repeat:12345;color:red"
Deactivate timer #4:
flux_led 192.168.1.100 -T 4 inactive ""
Use --timerhelp for more details on setting timers
Show help:
$ flux_led -h
Usage: usage: __main__.py [-sS10cwpCiltThe] [addr1 [addr2 [addr3] ...].
A utility to control Flux WiFi LED Bulbs.
Options:
-h, --help show this help message and exit
-s, --scan Search for bulbs on local network
-S, --scanresults Operate on scan results instead of arg list
-i, --info Info about bulb(s) state
--getclock Get clock
--setclock Set clock to same as current time on this computer
-t, --timers Show timers
-T NUM MODE SETTINGS, --settimer=NUM MODE SETTINGS
Set timer. NUM: number of the timer (1-6). MODE:
inactive, poweroff, default, color, preset, or
warmwhite. SETTINGS: a string of settings including
time, repeatdays or date, and other mode specific
settings. Use --timerhelp for more details.
Program help and information option:
-e, --examples Show usage examples
--timerhelp Show detailed help for setting timers
-l, --listpresets List preset codes
--listcolors List color names
Power options (mutually exclusive):
-1, --on Turn on specified bulb(s)
-0, --off Turn off specified bulb(s)
Mode options (mutually exclusive):
-c COLOR, --color=COLOR
Set single color mode. Can be either color name, web
hex, or comma-separated RGB triple
-w LEVEL, --warmwhite=LEVEL
Set warm white mode (LEVEL is percent)
-p CODE SPEED, --preset=CODE SPEED
Set preset pattern mode (SPEED is percent)
-C TYPE SPEED COLORLIST, --custom=TYPE SPEED COLORLIST
Set custom pattern mode. TYPE should be jump, gradual,
or strobe. SPEED is percent. COLORLIST is a space-
separated list of color names, web hex values, or
comma-separated RGB triples
Supported Models
The following models have been tested with library.
Model | Description | Microphone | Notes |
---|---|---|---|
0x01 | Legacy RGB Controller | no | Original protocol |
0x03 | Legacy CCT Controller | no | Original protocol |
0x04 | UFO Controller RGBW | no | |
0x06 | Controller RGBW | no | |
0x07 | Controller RGBCW | no | |
0x08 | Controller RGB with MIC | yes | |
0x09 | Ceiling Light CCT | no | |
0x0E | Floor Lamp RGBCW | no | |
0x10 | Christmas Light | no | |
0x16 | Magnetic Light CCT | no | |
0x17 | Magnetic Light Dimmable | no | |
0x1A | Christmas Light | no | |
0x1C | Table Light CCT | no | |
0x1E | Ceiling Light RGBCW | no | |
0x21 | Bulb Dimmable | no | |
0x25 | Controller RGB/WW/CW | no | Supports RGB, RGBW, RGBWW, CW, DIM |
0x33 | Controller RGB | no | |
0x35 | Bulb RGBCW | no | |
0x41 | Controller Dimmable | no | |
0x44 | Bulb RGBW | no | |
0x52 | Bulb CCT | no | |
0x54 | Downlight RGBW | no | |
0x62 | Controller CCT | no | |
0x93 | Switch 1 Channel | no | |
0x97 | Socket | no | |
0xA1 | Addressable v1 | no | Supports UCS1903, SM16703, WS2811, WS2812B, SK6812, INK1003, WS2801, LB1914 |
0xA2 | Addressable v2 | yes | Supports UCS1903, SM16703, WS2811, WS2811B, SK6812, INK1003, WS2801, WS2815, APA102, TM1914, UCS2904B |
0xA3 | Addressable v3 | yes | Supports WS2812B, SM16703, SM16704, WS2811, UCS1903, SK6812, SK6812RGBW (WS2814), INK1003, UCS2904B |
0xA4 | Addressable v4 | no | Supports WS2812B, SM16703, SM16704, WS2811, UCS1903, SK6812, SK6812RGBW (WS2814), INK1003, UCS2904B |
0xA6 | Addressable v6 | yes | Supports WS2812B, SM16703, SM16704, WS2811, UCS1903, SK6812, SK6812RGBW (WS2814), INK1003, UCS2904B |
0xA7 | Addressable v7 | yes | Supports WS2812B, SM16703, SM16704, WS2811, UCS1903, SK6812, SK6812RGBW (WS2814), INK1003, UCS2904B |
0xE1 | Ceiling Light CCT | no | |
0xE2 | Ceiling Light Assist | no | Auxiliary Switch not supported |
Untested Models
The following models have not been tested with the library but may work.
Model | Description | Microphone | Notes |
---|---|---|---|
0x02 | Legacy Dimmable Controller | no | Original protocol, discontinued |
Unsupported Models
The following models are confirmed to be unsupported.
Model | Description | Microphone | Notes |
---|---|---|---|
0x18 | Plant Grow Light | no | |
0x19 | Socket with 2 USB | no | |
0x1B | Aroma Fragrance Lamp | no | |
0x1D | Fill Light | no | |
0x94 | Switch 1c Watt | no | |
0x95 | Switch 2 Channel | no | |
0x96 | Switch 4 Channel | no | |
0xD1 | Digital Time Lamp | no |
Known Vendors
- Aislan
- Allkeys
- Apobob
- Arilux
- Aubric
- BERENNIS
- BHGY
- Brizled
- Bunpeon
- Chichin
- Comoyda
- dalattin
- DALS RGBW / Armacost Lighting / MyLED
- DARKPROOF
- Daybetter
- deerdance
- DIAMOND
- Diode Dynamics
- Flux LED
- FVTLED
- GEV LIG
- GEYUEYA Home
- GIDEALED
- GIDERWEL
- GMK
- Goldwin
- Hakkatronics
- HaoDeng
- Heissner
- HDDFL
- illume RGBW
- Illumination FX
- INDARUN
- iNextStation
- Koopower
- Lallumer
- LEDENET
- LiteWRX
- Lytworx
- Magic Ambient
- Magic Home
- Magic Hue
- Magic Light
- Miheal
- Mowelai
- Nexlux
- OBSESS
- Offdarks
- PH LED
- PHOPOLLO
- Pin Stadium Pinball Lights
- POV Lamp
- PROTEAM Europe Pool Lights
- Rimikon
- SMFX
- Sumaote
- Superhome
- SurpLife
- SuperlightingLED
- Svipear
- Tommox
- Vanance
- Yetaida
- YHW
- Zengge
- Zombber
File Structure
device.py -> contains code to manipulate device as well as get any information from device that's needed.
fluxled.py -> command line code for flux_led.
pattern.py -> contains code to identify pattern as well as set patterns.
protocol.py -> contains communication protocol to communicate with differnt devices.
scanner.py -> contins scanner to scan network and identify devices on network.
sock.py -> contains code to communicate on network.
timer.py -> contains code to support setting timers on devices and getting timer information from devices.
utils.py -> contains helpers to calculate differnt parameters such as color, cct, brightness etc.