Skip to content

Supported Functions

What the integration does โ€” and does not โ€” do for each OpenWebNet subsystem (WHO) and Home Assistant platform. Hardware and gateway models are listed in Hardware Compatibility; the wire-level conformance corpus is in the Protocol Conformance Matrix. Things that are deliberately not supported, and why, are in Known Limitations.

Legend: โœ… supported ยท ๐Ÿ‘๏ธ read-only ยท โš™๏ธ via a service, not an entity ยท โŒ not supported

Subsystems

WHO Subsystem Platform(s) Status Notes
0 Scenarios (scenario modules) โ€” โš™๏ธ Send *0*<what>*<where>## with myhome.send_message; no entity is created.
1 Lighting light, switch, binary_sensor, sensor โœ… See the platform table below.
2 Automation (shutters, blinds) cover โœ… Timed and position-reporting actuators.
4 Thermoregulation climate, sensor โœ… Zone thermostats, central units 3550 (#0) and 4695 (#0#1), probes.
5 Burglar alarm alarm_control_panel ๐Ÿ‘๏ธ Central unit status (read-only); arm/disarm through installer-programmed AUX frames โ€” see alarm.
6 Door entry lock, event bus โœ… Door strikes (*6*10*<where>##), lock release status, and doorbell events. Requires a gateway whose firmware routes WHO 6 and that sees the door-entry riser: MH200, MH202, F453 (firmware-verified); F453AV, F452, F452V, H4684, H4890, MH201, MH200N (unverified). Not routed by F454 / F459 (WHO 8 only) or by MyHomeServer1, F455, F461, F450, and F460.
8 Video door entry / intercom event bus ๐Ÿ‘๏ธ Entrance panel doorbell events (*8*1#<1..4>#<mm>*<where>##) from a gateway that sees the door-entry riser: F454, F459; F453AV, F452, F452V (unverified); or MH200 / MH200N / MH202 when the riser reaches their bus (e.g. through an F422).
9 Auxiliary channels binary_sensor ๐Ÿ‘๏ธ AUX 1โ€“9 as binary sensors.
13 Gateway management โ€” โš™๏ธ Clock sync (myhome.sync_time), firmware / model / identity for the device registry and diagnostics.
14 Actuator lock button โœ… Lock / unlock buttons on every light, switch and cover device.
15 CEN scenario pushbuttons device triggers โœ… Short / long press and release, rotary dials.
16 Sound system media_player, number, button โœ… F441 / F441M matrices, F500 / F500N FM radio tuners, streaming proxy for network decoders.
18 Energy management sensor โœ… Instantaneous power, total / daily / monthly energy.
22 Sound diffusion (audio matrix & FM tuner) media_player, number, button โœ… F500 / F500N FM tuner control and telemetry (5#2#S / 2#S) on dual-stack and WHO 22-only gateways (MyHomeServer1, F459, F460, F461, H/L4684 FW โ‰ฅ 6.0).
24 Lighting management (commercial) โ€” โŒ BMNE500 / BMview controllers; out of residential scope.
25 CEN+ pushbuttons and dry contacts device triggers, binary_sensor โœ… Short / long press, release; F482 / 3477 dry contacts.

Platforms

light (WHO 1)

Function Status Notes
On / off โœ… Relay and dimmer actuators, including F422 private-bus addresses (#4#<interface>).
Brightness โœ… Dimmers (dimmable: true or learned from a level frame).
Transitions โœ… software_stepped (default) or the actuator's native fade โ€” gateway option.
Flash โœ…
Colour temperature (DALI DT8) โœ… Dimension 14, 2000โ€“6535 K; learned from the first colour frame.
HS / RGB colour โœ… Learned from the first colour frame; modes accumulate, they never replace each other.
Hardware timer โœ… myhome.turn_on_timed: the actuator switches off by itself.
Group / area / general commands from wall switches ๐Ÿ‘๏ธ Frames are seen, but entities only update when the actuator reports its own status โ€” see limitations.

switch (WHO 1)

Function Status Notes
On / off โœ… Device class switch or outlet from myhome.yaml.
Hardware timer โœ… myhome.turn_on_timed.

cover (WHO 1 / WHO 2)

Function Status Notes
Open / close / stop โœ… Standard WHO 2 shutter actuators.
Impulse cover (WHO 1) โœ… Pulse-driven gates and garage doors: direct pulses with deadband and sensor feedback by default, and an optional access: workflow with phone approval, pre-warning, and watchdog.
Position (position-reporting actuators) โœ… Requires advanced_shutter: true in myhome.yaml; it is not learned from the bus.
Position (timed actuators) โœ… Virtual position from the travel time: travel_time in YAML, measured with myhome.calibrate_cover, or set by hand with myhome.set_cover_travel_time.
Tilt โŒ Slat commands are parsed by OWNd but not exposed.
Echo suppression โœ… The gateway's relay of our own command is not mistaken for a keypad press.

lock (WHO 6)

Function Status Notes
Door entry lock (WHO 6) โœ… Door entry strikes from myhome.yaml with optional constant-time PIN authentication and auto-relock. Never created from bus traffic; who: 1 relays are rejected (motorized gates and garage doors are impulse covers). Requires a gateway that routes WHO 6 and sees the door-entry riser, or Shared Bus โ†’ Secondary WHO 6 delegation to one (such as an MH202 on the riser); F454 / F459 route only WHO 8. If the gateway rejects *6*10*<where>## with *#*0## (e.g. MyHomeServer1, F455, F461, F454), lock.unlock raises HomeAssistantError and leaves the entity locked; an unlock not confirmed within 15 s is withdrawn if it has not been sent yet.
Doorbell event (WHO 6 / WHO 8) โœ… myhome_doorbell_event for an entrance panel ringing (WHO 8 call kinds 1-4, WHO 6 call), not for handset-to-handset calls or pager broadcasts. Fired by the gateway that owns the subsystem only (delegatable via WHO 6 / WHO 8 on a shared bus). The WHO 6 chime (WHAT 20) is unverified: it is not in the published WHO 6 table and has no capture.

climate (WHO 4)

Function Status Notes
Current temperature โœ…
Target temperature โœ… Manual set-point.
HVAC modes โœ… heat, cool, auto, off; heating / cooling support per zone from YAML.
Fan speed (3-speed fancoil) โœ… Auto-detected from dimension 11/20 frames, or explicit fan: true.
Current humidity โœ… Auto-detected from dimension 60 frames, restored across restarts, or explicit humidity: true.
Central unit modes โœ… Central unit 3550 (#0) and 4695 (#0#1) as central: true zones; seasonal propagation. Central units operate via autonomous events and are exempt from point-to-point status polling.
Weekly programs / scenarios โŒ Program selection frames (*4*11xx*#0##) can be sent with myhome.send_message.
Temperature-only probes ๐Ÿ‘๏ธ sensor platform (see below).

alarm_control_panel (WHO 5)

Function Status Notes
State (disarmed / armed away / triggered) ๐Ÿ‘๏ธ Central units 3485 / 3486.
Arm away / arm home / disarm โŒ The central unit rejects WHO 5 arm/disarm over SCS (#564); send the AUX frames it is programmed for with myhome.send_message, e.g. from a template alarm panel (alarm).
Trigger (panic) โŒ Not sent; no capture shows the central unit accepting it.
Zone status ๐Ÿ‘๏ธ The panel follows the central unit and the zone-0 broadcast; individual zones are not entities (limitations).

binary_sensor (WHO 1 / 9 / 25)

Function Status Notes
Dry contacts (CEN+, WHO 25) โœ… F428 / 3477 / 3480 / F482; device class selectable in UI (Show As) or YAML.
Auxiliary channels (WHO 9) โœ… AUX 0โ€“9.
Motion / presence (WHO 1) โœ… Motion frames of lighting sensors; a timeout restores off.
Inverted contacts โœ… Per-device Invert state configuration switch (EntityCategory.CONFIG) on WHO 25 and WHO 9 devices, or inverted: true in myhome.yaml.

sensor (WHO 1 / 4 / 18)

Function Status Notes
Instantaneous power (W) โœ… Push-driven; myhome.start_sending_instant_power requests a burst of readings.
Energy total / today / month (Wh) โœ… Today and month are disabled by default.
Temperature (zones and probes) โœ… Zones are polled every 5 min; probes (WHERE โ‰ฅ 100) are push-driven and only polled when silent.
Illuminance (lux) โœ… WHO 1 light sensors.
Humidity ๐Ÿ‘๏ธ Shown as the climate entity's current_humidity when the zone reports it; no separate sensor.

button (WHO 14 / 2 / 16 / 22)

Function Status Notes
Lock / unlock actuator โœ… On every light, switch and cover device (EntityCategory.CONFIG).
Calibrate travel time โœ… On every timed cover device, plus Calibrate all covers on the gateway device.
FM tuner seek up / down โœ… Companion Seek up and Seek down buttons on every declared F500 / F500N Audio Source device (WHO 16 *16*5000/5100*10S## or WHO 22 *22*5/6*2#S##).

number (WHO 16 / 22)

Function Status Notes
FM tuner manual frequency โœ… number.<source>_frequency (87.50โ€“108.00 MHz, 0.05 MHz step, NumberMode.BOX) on every declared F500 / F500N Audio Source device (*#16*10S*#6*0*<kHz>## or *#22*2#S*#5*1*<10kHz>##).

media_player (WHO 16 / 22)

Function Status Notes
On / off, volume, mute, source 1โ€“4 โœ… Per zone / amplifier.
FM radio tuner sources (F500 / F500N) โœ… Power on/off, stored presets (Station 1โ€“15), RDS programme text, Media Browser (BROWSE_MEDIA), direct frequency tuning (myhome.tuner_set_frequency / play_media), hardware seek (myhome.tuner_seek_up / tuner_seek_down), and preset storage (myhome.tuner_store_station) across both WHO 16 and WHO 22 gateways.
Streaming (play, pause, next, previous) โœ… Only when decoders are mapped in the options flow: the zone becomes a Music Assistant / Spotify target and routes the matrix to a free decoder.
Media metadata ๐Ÿ‘๏ธ Mirrored from the decoder while a stream is active, or decoded from live FM RDS on tuner sources.
Speaker groups โœ… Home Assistant join / unjoin and Music Assistant sync groups: rooms of a group share one decoder and one source. See Multi-Room Audio Grouping.

Device triggers (WHO 15 / 25)

Trigger CEN CEN+
Short press / short release โœ… โœ…
Long press / long release โœ… โœ…
Rotary dial clockwise / counter-clockwise, slow and fast โœ… โœ…

Buttons 0โ€“31 per device; every trigger carries the gateway MAC so multi-gateway plants do not cross-fire.

Services

All services are documented in the Services Reference: send_message, turn_on_timed, sync_time, start_sending_instant_power, stop_sending_instant_power, sweep_bus, calibrate_cover, stop_cover_calibration, set_cover_travel_time, reset_cover_travel_time, tuner_seek_up, tuner_seek_down, tuner_set_frequency, tuner_store_station, send_scenario_plus_command, cancel_cover_request, acknowledge_cover_fault.

Diagnostics and tooling

Function Status Notes
Config-entry diagnostics download โœ… Gateway identity, profile, queue depth, bus-monitor ring buffer; credentials redacted.
Bus monitor Lovelace card โœ… Live trace, sweep, export, raw send (administrators only).
Repair issues โœ… Gateway model contradicted by the WHO 13 device type; password rejected (native reauth).
Gateway diagnostic entities (latency, reconnects) โŒ Not exposed as entities; use the diagnostics download and the card.