Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reverse engineered hue zigbee format #67

Merged
merged 4 commits into from
Jan 29, 2025
Merged

Conversation

chrivers
Copy link
Owner

Philips hue lights support zigbee frames in a manufacturer-specific format, on cluster 0xFC03.

This type of message is necessary to support many of the advanced features in Hue lights, such as:

  • Multiple colors ("gradient") in LED strips
  • Light Effects ("Candle", "Fireplace", etc)
  • Combining effects with color settings

Several attempts have been made to reverse this format before, but none have
managed to get everything decoded, although many attempts and techniques have
been employed. A few examples of the ongoing work:

The best (and newest) work so far, is probably Krzysztof Jagiełło's "Hue Gradient Command Wizard":

This one gets much right, but is still missing quite a few details.

This MR completely documents the format, leaving no stone unturned

@chrivers chrivers merged commit eb9e38d into master Jan 29, 2025
1 check passed
@chrivers chrivers deleted the chrivers/zigbee-format-doc branch January 29, 2025 20:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant