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

Update README.md with more Zigbee information #500

Open
wants to merge 26 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
c549f7a
Add Zigbee2MQTT section
th3w1zard1 Apr 2, 2023
653c1c8
chore(docs): update TOC
th3w1zard1 Apr 2, 2023
897e400
Update README.md
th3w1zard1 Apr 2, 2023
834209b
Merge branch 'debug-zigbee-lights' of https://github.com/th3w1zard1/a…
th3w1zard1 Apr 2, 2023
3831c53
Update README.md
th3w1zard1 Apr 2, 2023
10ace0c
chore(docs): update TOC
th3w1zard1 Apr 2, 2023
c2b04d8
Update README.md
th3w1zard1 Apr 2, 2023
8a9af95
Merge branch 'debug-zigbee-lights' of https://github.com/th3w1zard1/a…
th3w1zard1 Apr 2, 2023
e40446a
Update README.md
th3w1zard1 Apr 2, 2023
30fe6cd
Update README.md
th3w1zard1 Apr 2, 2023
112b641
Update README.md
th3w1zard1 Apr 2, 2023
ed3ec1b
Update README.md
th3w1zard1 Apr 2, 2023
ffba128
Update README.md
th3w1zard1 Apr 2, 2023
a7586c4
Update README.md
th3w1zard1 Apr 2, 2023
0cfbe70
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Apr 2, 2023
59f3d61
Correct newlines before `pre-commit`
th3w1zard1 Apr 2, 2023
0ef2fc1
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Apr 2, 2023
499cbfa
I give in
th3w1zard1 Apr 2, 2023
717635a
Update README.md
th3w1zard1 Apr 2, 2023
299be90
Added a zigbee2mqtt guide for AL
th3w1zard1 Apr 3, 2023
e0453e2
Merge branch 'main' into debug-zigbee-lights
th3w1zard1 Apr 3, 2023
d4c236d
Merge branch 'main' into debug-zigbee-lights
th3w1zard1 Apr 3, 2023
d579e64
Merge branch 'main' into debug-zigbee-lights
th3w1zard1 Apr 6, 2023
fb6d498
Merge branch 'main' into debug-zigbee-lights
basnijholt Apr 27, 2023
804b736
Merge branch 'main' into debug-zigbee-lights
th3w1zard1 Jan 9, 2024
d1ef1fc
chore(docs): update TOC
th3w1zard1 Jan 9, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 23 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,11 +59,12 @@ The `adaptive_lighting.manual_control` event is fired when a light is marked as
- [:robot: Automation examples](#robot-automation-examples)
- [Additional Information](#additional-information)
- [:sos: Troubleshooting](#sos-troubleshooting)
- [:exclamation: Common Problems & Solutions](#exclamation-common-problems--solutions)
- [:bulb: Lights Not Responding or Turning On by Themselves](#bulb-lights-not-responding-or-turning-on-by-themselves)
- [:signal_strength: WiFi Networks](#signal_strength-wifi-networks)
- [:spider_web: Zigbee, Z-Wave, and Other Mesh Networks](#spider_web-zigbee-z-wave-and-other-mesh-networks)
- [:rainbow: Light Colors Not Matching](#rainbow-light-colors-not-matching)
- [Zigbee2MQTT](#zigbee2mqtt)
- [ZHA](#zha)
- [:rainbow: Light Colors Not Matching](#rainbow-light-colors-not-matching)
- [:bulb: Bulb-Specific Issues](#bulb-bulb-specific-issues)
- [:bar_chart: Graphs!](#bar_chart-graphs)
- [:sunny: Sun Position](#sunny-sun-position)
Expand Down Expand Up @@ -353,7 +354,7 @@ logger:

After the issue occurs, create a new issue report with the log (`/config/home-assistant.log`).

### :exclamation: Common Problems & Solutions
Please include your [Adaptive Lighting Configuration](https://github.com/basnijholt/adaptive-lighting/discussions/503)

#### :bulb: Lights Not Responding or Turning On by Themselves

Expand Down Expand Up @@ -389,9 +390,26 @@ This sends a single broadcast command to adjust all bulbs, improving response ti
As a rule of thumb, if you always control lights together (e.g., bulbs in a ceiling fixture), they should be in a Zigbee group.
Expose only the group (not individual bulbs) in Home Assistant Dashboards and external systems like Google Home or Apple HomeKit.

> :warning: **If you control lights individually, `manual_control` cannot behave correctly! If you need to control lights individually as well, use a [Home Assistant Light Group](https://www.home-assistant.io/integrations/group/).**
##### Zigbee2MQTT
[Ensure your Zigbee2MQTT is configured correctly to work with Adaptive Lighting](https://github.com/basnijholt/adaptive-lighting/discussions/506).

Still need help? Please check out the following resources:
- [Zigbee2MQTT | FAQ](https://www.zigbee2mqtt.io/guide/faq/)
- [Zigbee2MQTT | Configuration](https://www.zigbee2mqtt.io/guide/configuration/)
- [Zigbee2MQTT | Device-Specific Configurations](https://www.zigbee2mqtt.io/supported-devices/)

##### ZHA
We recommend Zigbee2MQTT as it's widely considered to be the best performer.
However if you'd like to debug ZHA check out the following articles:

#### :rainbow: Light Colors Not Matching
https://www.home-assistant.io/integrations/zha/#troubleshooting specifically [ZHA EXCEPTION AND DEVIATION HANDLING](https://www.home-assistant.io/integrations/zha/#zha-exception-and-deviation-handling)

For ZHA we recommend the following addons:
1. [ZHA-Toolkit](https://github.com/mdeweerd/zha-toolkit)
2. [ZHA-Device-Handlers](https://github.com/zigpy/zha-device-handlers) also available [here](https://pypi.org/project/zha-quirks/)

### :rainbow: Light Colors Not Matching
> :warning: **If you control lights individually, `manual_control` cannot behave correctly! If you need to control lights individually as well, use a [Home Assistant Light Group](https://www.home-assistant.io/integrations/group/).**

Bulbs from different manufacturers or models may have varying color temperature specifications. For instance, if you have two Adaptive Lighting configurations—one with only Philips Hue White Ambiance bulbs and another with a mix of Philips Hue White Ambiance and Sengled bulbs—the Philips Hue bulbs may appear to have different color temperatures despite having identical settings.

Expand Down