Troubleshooting

Troubleshooting

Debug logging (every TX/RX byte)

logger:
  logs:
    custom_components.htd_lync_pro: debug

Runtime alternative (resets on restart): Developer Tools → Actions → logger.set_level with custom_components.htd_lync_pro: debug.

Diagnostics

Integration entry → ⋮ → Download diagnostics: model, firmware, options, every zone's state, raw status bytes (gateway IP redacted). Attach it to bug reports.

Common questions

Symptom	Explanation
Zone shows "Zone N" instead of its name	Name query hadn't answered yet; syncs within seconds. Manual HA renames always win.
Selecting a source turned the zone on	Hardware behavior — the Lync powers a zone on for any source-select command.
Lync reported: … range error in the log	The unit rejected a tone/volume value — check the tone-encoding option.
Volume moves by itself after the doorbell	Doorbell restore putting zones back; disable in Options if unwanted.
Integration unavailable after gateway power cycle	The gateway got a new IP — set a DHCP reservation; use ⋮ → Reconfigure to update.
Everything froze after adding a second HA/app connection	The GW-SL1 serves one TCP client. Remove the second consumer.

Reporting issues

Open an issue with the diagnostics file and (for protocol oddities) a debug-log excerpt: the RX/TX lines around the problem.