xled / xled-docs

📖 Unofficial documentation of API reference, protocol details and hardware of Twinkly - Smart Decoration LED lights for Christmas.

Home Page:https://xled-docs.readthedocs.io/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Query strings for gestalt

scrool opened this issue · comments

In 2.8.3 (maybe earlier?) app sends requests like: /xled/v1/gestalt?filter=prod_infos&filter2=group and a device responds with

{
"product_name": "Twinkly",
"hardware_version": "100",
"bytes_per_led": 3,
"hw_id": "1cc190",
"flash_size": 64,
"led_type": 14,
"product_code": "TWS250STP",
"fw_family": "F",
"device_name": "Twinkly_1CC190",
"uptime": "1499371",
"mac": "98:f4:ab:1c:c1:90",
"uuid": "E103C5A3-3398-4B77-AE1A-9D8998A5EB62",
"max_supported_led": 510,
"number_of_led": 250,
"led_profile": "RGB",
"frame_rate": 24,
"measured_frame_rate": 25,
"movie_capacity": 5397,
"serial": "000000",
"production_date": 1586909241,
"production_site": 4,
"group": {
"mode": "none",
"compat_mode": 0
},
"copyright": "LEDWORKS 2021",
"code": 1000
}

where uuid, mac, device_name, hw_id were redacted by me. Also serial (which seems to be new) - I kept length.

Copyright seems to be bumped to this year.

If you have a group, the group info will appear in here as well. However it's not super-useful because gen 1 doesn't support it.

I had a look into this for my own project.

mode seems to have 3 values:

  • none = no group
  • master = main light to control
  • slave = all other lights in group

If you have an active group then size will be added. This is the total size of all the lights combined.
Additionally offset is added when mode=slave

I had a look into this for my own project.

mode seems to have 3 values:

  • none = no group
  • master = main light to control
  • slave = all other lights in group

If you have an active group then size will be added. This is the total size of all the lights combined. Additionally offset is added when mode=slave

I only see this in the v2 api (meaning pro devices). I am unable to reproduce this on wifi consumer devices.