redmatic-homekit 4.0.0

v4.0.0

on Node.js NPM

Release-Notes (Deutsch). RedMatic-HomeKit läuft wieder auf aktuellen
Systemen: RedMatic 9 / Node-RED 4 und 5 / Node.js ≥ 22.12, installiert
über den Node-RED-Palettenmanager (Suche nach redmatic-homekit) ohne
Binärabhängigkeiten. Bestehende Kopplungen bleiben erhalten – nach dem
Update von 3.3.0 muss nichts neu gekoppelt werden, Räume, Namen, Szenen
und Automationen bleiben (auf einer CCU3 mit gekoppeltem 3.3.0 geprüft).
Neu ist die generische Geräteerkennung: jedes Homematic-Gerät, dessen
Kanäle eine bekannte Rolle haben, erscheint in der Geräteliste, auch ohne
eigenes Modul – damit sind unter anderem HmIP-DLD, HmIP-DLS, HmIP-DRDI3,
HmIP-eTRV-E/-C-2/-B-2, HmIP-WTH-1, HmIPW-STHD, HmIP-SRD, HmIP-SCTH230,
HmIP-WRC6/WRC2 und die meisten anderen Taster und Fernbedienungen dabei.
Behoben wurden lang bekannte Probleme: der Status von HmIP-Aktoren wird
jetzt auch dann aktualisiert, wenn sie per Programm, Direktverknüpfung
oder Gerätetaste geschaltet wurden; Thermostate springen beim Einstellen
nicht mehr auf 21 °C und melden 4,5 °C als „Aus“; ein nicht erreichbares
Gerät reißt nicht mehr alle anderen mit; HmIP-Taster melden ihre
Tastendrücke auch ohne CCU-Programm; Eingänge von HmIPW-DRI16/DRI32,
HmIP-FCI und Co. richten sich nach ihrer Betriebsart (Taster/Schalter →
programmierbarer Schalter, Kontakt → Kontaktsensor). Entfallen sind der
Kamera-Node (braucht ffmpeg, das RedMatic 9 nicht mehr mitbringt) und der
Zigbee-Node (Upstream seit 2022 tot, native Abhängigkeiten); Alternativen
stehen in der README. Wer 4.0.0 einsetzt und ein Gerät vermisst oder
falsch abgebildet sieht: Issue mit Gerätetyp öffnen, die generische
Erkennung lässt sich meist ohne Code erweitern.

Release notes (English summary). 4.0.0 makes redmatic-homekit
installable again on RedMatic 9 / Node-RED 4–5 / Node ≥ 22.12 through the
palette manager, with no native dependencies. Pairings survive the
upgrade from 3.3.0: no re-pairing, rooms, names, scenes and automations
are kept (verified on a CCU3 with a paired 3.3.0). Device support is now
generic: every device whose channels have a known role is listed, module
or not (HmIP-DLD/DLS, DRDI3, eTRV-E/C-2/B-2, WTH-1, HmIPW-STHD, SRD,
SCTH230, wall buttons and remotes, …). Fixed: state updates for HmIP
actuators switched by programs, links or their own key; thermostat
setpoint jumps and the 4.5 °C = off convention; one unreachable device no
longer marks all others unresponsive; HmIP buttons report presses without
a CCU program; multi-mode inputs follow their operating mode. Removed:
the camera node (needs ffmpeg) and the zigbee node (dead native upstream).

Breaking release. See ROADMAP.md for the plan and the
decisions (D-n) referenced below.

Added

• Generic device mapping (ROADMAP task 7, D-5): Homematic devices
  without a per-type module are now mapped from their channel roles, which
  the runtime derives from the paramset descriptions the CCU reports
  (CONTROL hints, channel types, datapoint names). Switches, dimmers,
  colour lights (HmIP-RGBW), blinds, contacts, rotary handles, motion and
  presence sensors, smoke, water and rain detectors, CO₂ and
  temperature/humidity/light sensors, buttons (as programmable switches),
  HmIP door locks (HmIP-DLD, HmIP-DLS) and batteries get HomeKit services
  without any code; HmIP thermostats, locks, garage modules and blinds
  reuse the existing modules. Covers, among the requested types, HmIP-DLD
  (#328, #330, #377), HmIP-DRDI3 (#333, #374), HmIP-eTRV-E/-C-2/-B-2
  (#343, #340, #357), HmIP-WTH-1, HmIPW-STHD (#341), HmIP-SRD (#311),
  HmIP-DSD-PCB (#377), HmIP-SCTH230 (#325), HmIP-DLS (#337), HmIP-WRC6
  and other wall buttons (#361), HM-LC-Ja1PBU-FM (#71) and HM-Sen-RD-O
  (#279). The editor lists these devices with the same options as the
  hand-written ones (accessory type per channel, SingleAccessory, Battery,
  HumiditySensor/LightSensor, opt-in virtual channels and buttons).
• German inline help for every node in the editor (bridge, homematic,
  switch, pseudobutton, programmable switch, universal, tv; garage and
  irrigation had help before) (#112).
• Test suite with device fixtures for 383 device types (from the pydevccu
  catalogue), role and service snapshots, and an end-to-end harness (fake
  Node-RED and fake ccu-connection against the real HAP-NodeJS).

Fixed

• HmIP actuators (switches, dimmers, blinds, shutters, HmIPW DIN-rail
  actuators): HomeKit now shows the state the device actually has, not the
  last value HomeKit itself wrote. Every HmIP actuator has a transmitter
  channel that reports the real output and three virtual receiver channels
  that are control inputs; HomeKit, direct links, CCU programs and the
  device's own button each use their own receiver, and a receiver only
  reflects its own last command. Accessories used to read their state from
  the receiver HomeKit writes to, so a lamp dimmed by a program, a wall
  button or the local key kept its old value in the Home app. State reads
  now come from the transmitter for every module and for the generic
  mapping (homematic-devices/lib/state-source.js), writes still go to
  the receiver (#319, #369, #252, #294). Found on an HmIP-PDT in the
  OpenCCU hardware test and verified there.
• HmIP wall buttons and remotes (HmIP-WRC2/WRC6/BRC2/KRC4/RC8, keys on
  actuators): every key channel now reports its presses. HmIP devices only
  send a key press to the CCU once the datapoint has been declared "in
  use" by a program, a direct link or an XML-RPC client; a button that no
  CCU program used stayed silent in HomeKit. The generic mapping now
  declares PRESS_SHORT/PRESS_LONG of every key channel it maps
  (reportValueUsage). Found with the second button of an HmIP-WRC2 in the
  OpenCCU hardware test.
• HmIP multi-mode inputs (HmIPW-DRI16/DRI32/FIO6, HmIP-FCI1/FCI6,
  HmIP-DSD-PCB, HmIP-MIO16-PCB, keys of HmIP-DRDI3/DRSI/DRBLI): an input
  is mapped by its operating mode. In the factory-default key mode such
  an input only sends key presses and never a STATE, so the contact sensor
  3.3.0 created for it stayed "closed" forever (found on an HmIPW-DRI16).
  The node now reads CHANNEL_OPERATION_MODE from the channel's MASTER
  paramset when publishing: key mode ("Taster") → StatelessProgrammableSwitch
  with single and long press, switch mode ("Schalter", one short press per
  flip, no STATE either) → StatelessProgrammableSwitch with single press,
  binary-sensor mode ("Binärsensor") → ContactSensor, Door or Window as
  before, inactive → nothing; key channels get the usage report above. A
  mode changed in the WebUI is picked up at the next deploy or restart.
  For a DRI16 whose inputs
  were never switched to a contact mode this replaces the dead contact
  sensors by buttons in the Home app.
• Buttons: a held key produces exactly one long press in HomeKit. The CCU
  repeats PRESS_LONG every few hundred milliseconds for as long as a key
  is down, and every repeat used to become another long-press event (a
  toggle switch on a key-mode DRI16 input produced eight of them per
  flip). Only the first PRESS_LONG of a hold is forwarded; the hold
  ends with PRESS_LONG_RELEASE or after 1.5 s without a repeat. Applies
  to every generic key channel and the DRI16/DRI32 inputs.
• Bridge name: the bridge keeps exactly the name configured in the bridge
  node. hap-nodejs 2.x appends four hex digits by default ("RedMatic
  Bridge 25F0"); 3.3.0 did not, and the upgrade test showed the changed
  name as the only difference on the bridge accessory.
• The CCU's own virtual remote (HmIP-RCV-50, HM-RCV-50) is opt-in: it
  mapped to a 50-button accessory on every bridge, which is noise for most
  homes. Tick it in the device list to publish it (useful to trigger
  HomeKit automations from CCU programs by "pressing" a virtual key).
• First deploy: the homematic node no longer publishes "0 devices" when it
  is deployed together with a new ccu-connection node or on a box without
  cached CCU metadata. The ccu-connection reports its interfaces as
  connected before it has fetched the device list, and the node used to
  publish at that moment, so nothing appeared in HomeKit until Node-RED
  was restarted. It now waits until the device list and the channel names
  have arrived and stopped changing (status "waiting for devices", a few
  seconds, at most a minute) before publishing. Reproduced on both lab
  boxes.
• Universal node: writes from HomeKit are forwarded to the node output
  again. The migration to hap-nodejs 2.x had silently broken this (the
  change event no longer carries the old request context; the node now
  forwards on the event's write reason). Found in the OpenCCU hardware
  test, covered by a test now.
• Thermostats (HmIP-WTH/-BWTH/-STH/-eTRV, HmIP-HEATING groups, HM-CC-RT-DN,
  HM-TC-IT-WM-W-EU, HM-CC-VG-1): changing the temperature in the Home app
  no longer makes the thermostat jump to 21 °C first (#245, #225). The
  setpoint HomeKit restores when switching to HEAT is the one last read or
  written, the mode write waits for a temperature write from the same
  request, and a setpoint that was just written is never overridden. A
  setpoint at the off temperature (4.5 °C) is reported as OFF in every mode
  instead of "heating to 4.5 °C" after a restart (#335). Shared logic lives
  in homematic-devices/lib/thermostat.js with tests.
• One unreachable device no longer takes every accessory of the bridge
  down with it (#312, #194): HAP-NodeJS 2.x answers batched reads with a
  status per characteristic, so only the unreachable accessory shows
  "No Response".
• HmIPW-DRD3: the three dimmer outputs can be split into one accessory
  per output (SingleAccessory off), each named after its channel; the
  brightness bookkeeping is per output instead of shared (PR #353 idea,
  re-implemented on the existing module so the default layout stays
  identical for paired homes).
• TV node: default port stored as a string so Node-RED ≥ 1.3 validates it
  (PR #345, #344).

Changed

• Bridge mDNS: new auto default that advertises through a running
  avahi-daemon (OpenCCU) over D-Bus and falls back to hap-nodejs' own
  responder on hosts without one (official CCU firmware), so both
  firmwares work without configuration; ciao, bonjour-hap and avahi
  can still be forced.
• HAP library: hap-nodejs 0.4.52 (2019) → @homebridge/hap-nodejs 2.x
  (D-2). Pairings, accessory identities and service numbering are kept
  (storage stays in <userDir>/homekit, UUIDs are still derived from the
  bridge MAC and the CCU addresses), so controllers do not need to re-pair
  and rooms/automations survive. Internally: HAPStorage instead of
  hap.init, Categories/HAPStatus/HapStatusError instead of the
  removed Accessory.Categories/HAPServer.Status, Battery instead of
  the removed BatteryService (same service UUID), async publish().
• Bridge: the mDNS advertiser is configurable (see above) for network
  setups where the default does not work (#348); the
  accessory limit follows hap-nodejs (149 per bridge) with a hint to use a
  second bridge; the bridge label in the editor shows the bridge name
  (#224). A failed publish now reports the error instead of leaving the
  bridge half-published.
• Homematic device editor: the device list and the per-channel options are
  now served by the runtime (homematic-devices/options.json +
  homematic-devices/lib/catalogue.js) instead of a 500-line hard-coded
  table inside the editor; the stored configuration format is unchanged.
  Devices that are missing from the list can no longer disagree with what
  the runtime supports. Fixes the two ZEL (Roto) device types, which the
  old editor spelled differently from the runtime and therefore never
  listed. Settings of devices that are temporarily not listed (interface
  down) are kept instead of being dropped on save.
• TV node: uses the accessory paired/unpaired events instead of the
  removed HAP server events.
• Supported platforms: Node.js ≥ 22.12 and Node-RED ≥ 4 (engines and
  node-red.version are declared now; the palette manager refuses older
  runtimes instead of failing later).
• Tooling: xo replaced by ESLint 9 + Prettier (also linting the editor
  scripts in the node .html files), node --test unit tests, GitHub
  Actions CI (lint, Node 22/24 × Node-RED 4/5, native-dependency scan) and a
  tag-driven release workflow with npm provenance. The published package is
  reduced to nodes/, homematic-devices/ and this changelog.
• A guard (tools/check-native.js, run in CI) fails the build if any
  production dependency needs a compiler, an install script or ships a
  binary — the package must stay installable on a CCU (ROADMAP D-1).

Removed

• Camera node (redmatic-homekit-camera) and the
  homebridge-camera-ffmpeg dependency (D-7). It needed an ffmpeg binary
  that RedMatic 9 no longer ships and a rewrite against the hap-nodejs 2.x
  CameraController API. Use Homebridge with homebridge-camera-ffmpeg or
  Scrypted for cameras. Existing flows keep importing; the node shows up as
  an unknown type and must be deleted.
• Zigbee node (redmatic-homekit-zigbee-devices) and the
  zigbee-devices/ adapters (D-6). Its upstream node-red-contrib-zigbee has
  been unmaintained since 2022 and depends on native serialport code that
  cannot be installed on a CCU. zigbee2mqtt plus the universal node is the
  supported way to bring Zigbee devices into HomeKit.
• create-todo.js maintainer leftover.