AV Switch — av_switch v1

Anything that routes signal: an HDMI matrix, a distribution amp, a video switcher. The crosspoint capabilities below are what the pathfinder uses to derive internal edges from each input to each output.

A receiver is not this — it is receiver, which switches and has volume and a room association. Use this for devices that only move signal.

Capabilities

Declared in the driver manifest under [[proxy]] capabilities. Anything not declared takes the default below.

Capability	Type	Default	Meaning
audio_consumer_count	u32	0	Audio inputs
audio_provider_count	u32	0	Audio outputs
can_switch_separately	bool	false	Audio and video may be routed to different destinations
is_matrix	bool	false	Any input can reach any output. If false, outputs mirror one selected input.
requires_separate_switching	bool	false	They MUST be routed separately; the pathfinder solves two paths
supports_disconnect	bool	true	An output can be switched off rather than always carrying something
switch_delay_ms	u32	0	Settle time after a crosspoint change
video_consumer_count	u32	0
video_provider_count	u32	0

Commands

disconnect_output

Only present when supports_disconnect is declared true.

Parameter	Type	Notes
output	u32

off

No parameters.

on

No parameters.

pulse_input

Cycle inputs — for switches with no discrete selection

No parameters.

set_input

Route an input to the default/only output

Parameter	Type	Notes
input	u32	Signal connection id

set_output_input

Only present when is_matrix is declared true.

Route input to output. The matrix command.

Parameter	Type	Notes
input	u32
output	u32

Notifications

online_changed

Parameter	Type	Notes
online	bool

power_changed

Parameter	Type	Notes
on	bool

route_changed

One crosspoint changed. Emitted once per affected output.

Parameter	Type	Notes
input	u32
output	u32

State

Last-known values core keeps for a binding of this proxy.

Key	Type	Meaning
on	bool
online	bool