Services

Services

All services live in the htd_lync_pro domain (Developer Tools → Actions).

Zone control

set_zones — party scenes

Turn on a set of zones, one source, base volume with per-zone offsets:

action: htd_lync_pro.set_zones
data:
  zones: [3, 4, 5, 6, 8]
  source: "Sonos"        # name or number
  volume: 30             # keypad 0-60
  offsets: { "3": 10, "6": -8 }
  others_off: true

party_mode

Hardware party mode — every zone follows one source:

action: htd_lync_pro.party_mode
data: { source: "TV" }

all_on / all_off

Whole-house power. No parameters.

follow_me

Move the playing music to another zone:

action: htd_lync_pro.follow_me
data:
  to_zone: 5
  exclude_zones: [6, 10]   # never followed from or into
  turn_off_source: true
  copy_volume: true
  volume_offset: -5        # dB relative to the source zone

If several zones are playing and from_zone isn't given, the lowest-numbered playing zone is used (a warning is logged).

State

snapshot / restore

Save all zone power/source/volume, put it back later. Only zones that changed receive commands. The snapshot is in-memory (lost on HA restart).

- action: htd_lync_pro.snapshot
- ... do anything ...
- action: htd_lync_pro.restore

refresh

Full poll: all zone statuses, names, source names, MP3 state.

Announcements

announce

TTS or media through the announcement player (see Automation Cookbook):

action: htd_lync_pro.announce
data:
  message: "Dinner is ready!"
  volume_level: 0.6
  restore_volume: true

Fields: message (TTS) or media_url, optional media_player / tts_entity overrides, volume_level 0-1, restore_volume.

Unit configuration

recall_preset / save_preset

Hardware presets 1–4 stored in the unit itself.

set_zone_name / set_source_name

Rename zones/sources on the unit (max 10 ASCII chars). HA device names sync automatically.

Events

Event	Data
htd_lync_pro_doorbell	entry_id, doorbell_input (1/2)