Troubleshooting Device Diagnostics

Troubleshooting: Device Diagnostics

Device diagnostics provide a snapshot of everything Home Assistant knows about your lock — its capabilities, supported features, entity registry entries, and current state. This helps maintainers understand your lock's setup without needing access to your system.

Important: The diagnostics download comes from your lock's integration (e.g., Z-Wave JS), not from Lock Code Manager itself. LCM manages codes on locks provided by other integrations, so we need to see what those integrations expose.

Downloading Device Diagnostics

1. Go to Settings → Devices & Services.
2. Find the integration that provides your lock (e.g., Z-Wave JS).
3. Click on the integration, then click on your lock device.
4. Click the three-dot menu (⋮) in the top-right corner.
5. Select Download diagnostics.
6. Attach the downloaded JSON file to your bug report.

Note: HA automatically redacts sensitive information in diagnostics downloads. If you're concerned about any remaining data, review the JSON before uploading.

What Diagnostics Tell Us

The diagnostics file helps us understand:

• Device capabilities — What features the lock reports (user codes, code slots, etc.)
• Entity details — Which entities exist for the device and their configurations
• State values — Current states that may be relevant to the issue
• Integration-specific data — Protocol-level details (e.g., Z-Wave command classes, node configuration)

Multiple Locks

If you manage multiple locks with LCM and the issue is specific to one lock, download diagnostics for the affected lock. If the issue involves synchronization across locks, download diagnostics for all of them.

← Back to Troubleshooting