From afa08bc4016917a686571ff8b264d218b9f9183d Mon Sep 17 00:00:00 2001 From: Alexei Chetroi Date: Sat, 9 May 2020 06:37:26 -0400 Subject: [PATCH] Add directions to enable ZHA debug logging (#13365) --- source/_integrations/zha.markdown | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 7aacddb1096..010f96e35b1 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -157,6 +157,36 @@ Reset your Zigbee devices according to the device instructions provided by the m ## Troubleshooting +### Reporting issues + +When reporting issues, please provide the following information in addition to information requested by issue template: + +1. Debug logs for the issue, see [debug logging](#debug-logging) +2. Model of Zigbee radio being used +3. If issue is related to a specific Zigbee device, provide device Zigbee signature. Signature is available at +`Configuration` Panel -> `Zigbee Home Automation` -> Pick your Device -> `Zigbee Information` + +### Debug logging + +To enable debug logging for ZHA component ard radio libraries, add the following [logger](https://www.home-assistant.io/integrations/logger/) configuration to `configuration.yaml`: + +```yaml +logger: + default: info + logs: + homeassistant.core: debug + homeassistant.components.zha: debug + bellows.zigbee.application: debug + bellows.ezsp: debug + zigpy: debug + zigpy_cc: debug + zigpy_deconz.zigbee.application: debug + zigpy_deconz.api: debug + zigpy_xbee.zigbee.application: debug + zigpy_xbee.api: debug + zigpy_zigate: debug +``` + ### Add Philips Hue bulbs that have previously been added to another bridge Philips Hue bulbs that have previously been added to another bridge won't show up during search. You have to restore your bulbs back to factory settings first. To achieve this, you basically have the following options.