This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.
Important
The adapter can NOT be installed via GitHub: The adapter must be installed via the ioBroker repository (stable or latest).
A detailed description of the configuration and use of the ioBroker Matter adapter is described in the 🇩🇪 german Wiki and 🇬🇧 english Wiki.
Please read the Important notes before using the adapter.
With the ioBroker Matter Adapter it is possible to map the following use cases:
- Matter-based devices can be linked directly to ioBroker and thus read in / controlled
- Provision of multiple ioBroker devices as a Matter Bridge: Matter Bridges can contain multiple devices and are the easiest way to integrate ioBroker devices into a Matter-compatible ecosystem.
- ioBroker provides individual virtual Matter devices based on ioBroker devices / ioBroker states, which can be taught to a Matter-compatible ecosystem (currently only bridges are possible for Amazon Alexa)
- Texts are partially in english
- Sync min/max from Matter into ioBroker objects
- Cleanup objects when devices/states are removed
- ioBroker device types
- (3+) vacuumCleaner
- (3) volume, volumeGroup
- (-3) airCondition
- (2+) fireAlarm
- (-2) mediaPlayer
- warning - how?
- gate - aka blinds?
- windowTilt - how?
- levelSlider - how?
- Matter device types
- (7) Fan -> airCondition?
- (4+) Air Quality Sensor -> ???
- (4+) Air Purifier -> ???
- (4) Pump -> ???
- (4) Pressure Sensor -> ??? DEF
- (3+) Robot Vacuum cleaner -> vacuumCleaner
- (3) Flow Sensor -> ??? DEF
- (3) Room Air Conditioner -> airCondition
- (2+) Smoke & CO Alarm -> fireAlarm? warning?
- (2+) Dishwasher-> ???
- (2) Basic Video Player -> mediaPlayer
- (2) Laundry Washer -> ???
- (2) Refrigerator -> ???
- (2) Temperature Controlled Cabinet -> ???
- (2) Water Freeze Detector -> warning?
- (2) Rain Sensor -> warning?
- (2) Water Valve -> ???
- (2) Laundry Dryer -> ???
- (2) Oven -> ???
- (2) Cooktop -> ???
- (2) Cook Surface -> ???
- (2) Extractor Hood -> ???
- (2) Microwave Oven -> ???
- (1+) Electrical Vehicle Supply Equipment -> ???
- (0) Water Heater -> ???
- (0) Solar Power -> ???
- (0) Battery Storage -> ???
- (0) Heat Pump -> ???
- (@Apollon77) "SET" states are no longer updated when Actual states are present and get updated!
- (@Apollon77) Initializes states also with "ack=false" states because better than no initial values
- (@Apollon77) Added Device support for Window Coverings (Blinds, Blindbuttons), Color Lights (Cie, Hie, Rgb, Rgbw, RgbSingle, RgbwSingle) and Thermostats
- (@Apollon77) Makes sure to track state values also when disabled and update state to Matter when enabled again
- (@Apollon77) Makes sure to also subscribe to write-only states for controller cases
- (@Apollon77) Only exposes remaining battery percentage attribute when value is present
- (@Apollon77) Corrected error display and pushing to UI in case of initialization errors of bridged devices
- (@Apollon77) Added RSSI value also for Thread devices
- (@Apollon77) Optimized and fixed multiple things
- (@GermanBluefox) Showed the device name in paring dialog
- (@GermanBluefox/Apollon77) Adjusts connection type icons
- (@Apollon77) Optimized the discovery dialog handling
- (@Apollon77) Fixed Thermostat for Controller to update temperatures
- (@Apollon77) Gives Energy sensors a dedicated icon
- (@Apollon77) Optimized and fixed multiple things
- (@GermanBluefox) Fixed GUI errors
- (@GermanBluefox/@Apollon77) Added possibility to enable/disable controlled nodes
- (@Apollon77) Added Information on battery and rssi for DM tile
- (@Apollon77) Added controller support for Color Lights, Speaker, Thermostats and Window coverings
- (@Apollon77) Optimized and fixed multiple things
- (@GermanBluefox) Fixed GUI errors
- (@GermanBluefox) Added
Controller fabric labelto configuration - (@GermanBluefox) Added solution for QR-Code scanning on non HTTPS pages
- (@Apollon77) Fixed Generic Switch Device type for controller
- (@Apollon77) Fixed Controller BLE initialization and activation
- (@Apollon77) Added serialNumber to all devices and bridges for better device re-detection by controllers
- (@Apollon77) Updates matter.js to address several issues
- (@bluefox) Optimized UI
- (@Apollon77) Allows triggering commands via matter also when the state already matches the value
- (@Apollon77) Sets and updates the fabric label for paired devices (default is "ioBroker matter.X")
- (@Apollon77) Detects state deletion for ioBroker devices and updates a device in UI to show device state
- (@Apollon77) Several optimizations on commissioning
- (@Apollon77) Do not show commissioning QR codes in ioBroker log
- (@Apollon77) Use Fabric label to try to detect if ioBroker is the controller
- (@Apollon77) Fixes displaying error details for devices and bridges
- (@Apollon77) Fixes the device and type detection logic
- (@Apollon77) Fixes several discovery issues
- (@Apollon77) Fixes bridge/device icon display in UI
- (@Apollon77) Prevents displaying warning dialogs when nothing is wrong
- (@Apollon77) Adjusts some logs
- BREAKING: Please re-enter your ioBroker Pro Cloud Password!
- (@Apollon77) Made sure the adapter is stopped before being updated
- (@Apollon77) Optimizes device discovery and allows to stop it again
- (@bluefox) Makes the Adapter UI also available as standalone tab
- (@bluefox) Added error details when adding the same state twice to a bridge or device
- (@Apollon77) Fixes discovery start in UI
- (@Apollon77) When Get and set states are separated then also update set state with new values
- (@Apollon77) Node details dialog in controller now exposes some more Battery information
- (@Apollon77) Also exposes the battery states when features are set wrong on the device
- (@Apollon77) Fixes LightSensor state mapping
- (@Apollon77) Prevents errors when only some energy states exist
- (@Apollon77) Uses the IP provided by Android when commissioning devices if possible
- (@Apollon77) Restructure discovery to run in the background and not block the UI
- (@Apollon77) Exposes States for Enums for Matter nodes
- (@Apollon77) Prevent storage to delete wrong data when a node gets removed
- (@bluefox) Fixes progress dialog for DM - used when deleting a node
- (@bluefox) Synchronizes the "do not ask again on delete" time with admin and set to 5 minutes
- (@bluefox) Optimizes bridges display for different color schemes
- (@bluefox) Allows to collapse the information blocks at the top of the pages
- (@bluefox) Adds an ioBroker Logo when display commissioned controllers
- (@bluefox/@apollon77) Adds additional details and error state also for devices and bridged devices
- (@bluefox/@apollon77) Always display QR code to allow additional pairing for device and bridges from adapter UI
- (@bluefox) Optimizes several messages nd approval dialogs
- (@bluefox) Adds a welcome dialog for new users
- (@bluefox) Adds user guidance for big unpaired bridges
- (@Apollon77) Adds Illuminance and Button/ButtonSensor (Switch) device type
- (@Apollon77) Changes/Optimizes naming structure for paired devices and sub-endpoints
- (@Apollon77) Adds information when Matter device types are not yet supported to look into objects for details
- (@Apollon77) Resets connection status when a controller node is disconnected, also on adapter stop
- (@Apollon77) Cleans up internal data structures when a node gets deleted for controller
- (@Apollon77) Uses the configured device type when finding multiple types in the backend
- (@Apollon77) Adjusts UI device type detection to differentiate between supported and other types
- (@Apollon77) Makes sure that controller configuration changes are executed sequentially
- (@Apollon77) Added Transition Time handling for Dimmer and Ct device types in both directions
- (@Apollon77) Added Low-Battery and Battery-percent for all device types in both directions
- (@Apollon77) Added Ethernet Network Commissioning Cluster to prevent issues with Tuya
- (@Apollon77) Cleans up objects when a controller node is deleted
- (@Apollon77) Prevents controller configuration changes to be executed in parallel
- (@Apollon77) Fixes ColorTemperature light initialization because of matter.js update
- (@Apollon77) Sets the "no-compose" flag correctly to normally use composed if needed and adds it to a missing dialog
- (@Apollon77) Allows using null values if needed
- (@Apollon77) Fixes UNREACH handling for devices
- (@Apollon77) Fixes object change handling for controller
- (@Apollon77) Allows Bridges to expose its name as a device name
- (@Apollon77) Allows to rename controller nodes and devices
- (@Apollon77) Shows a progress indicator when deleting controller nodes
- (@Apollon77) Cuts names and labels to 32 or 64 characters as needed by Matter
- (@Apollon77) Improves error handling on devices and bridges
- (@Apollon77) Clear storage when removing a bridged device
- (@Apollon77) Processes changed objects with a 5s delay to prevent too many changes at once
- (@Apollon77) Fixes version determination
- (@Apollon77) Initializes Device objects more lazily
- (@Apollon77) Makes sure to delete all objects and stop device when a device is deleted in UI
- (@Apollon77) When a devices/bridge object is deleted and adapter runs we try to detect this and stop the device/bridge
- (@Apollon77) Optimizes close handling of adapter
- (@Apollon77) Uses adapter version as Software and Hardware versions in the exposed Matter devices
- (@Apollon77) Fixes "auto" flags in backend when make no sense in objects
- (@Apollon77) Fixes "auto" flag in UI
- (@Apollon77) Prevents cyclic state updates when a state is updated by the adapter to matter
- (@Apollon77) Log warnings when device optional device states are not mapped
- (@Apollon77) Hides Product-ID and VendorId fields in UI when adding devices into a bridge
- (@Apollon77) Uses plain matter.js logs for better readability
- (@Apollon77) Prevents ghost connection entries in the UI
- (@Apollon77) Adds some missing implementations for Controller of Door, Window, FloodAlarm and Motion
- (@Apollon77) Adds Color Temperature conversion if unit is "mireds"
- (@Apollon77) Fixes Color Temperature cluster initialization
- (@Apollon77) Fixes Min/Max calculation when unit conversion is used
- IMPORTANT: Breaking change!! Please decommission ALL devices and do a full factory reset of the adapter Matter storage before installing this version. Pair the devices new afterward.
- (@Apollon77) Finalizes Devices, Bridges and Controller functionality with a first set of 11 device types
- (@Apollon77) Upgrades to new Matter.js version and API (breaks storage structure)
- (@GermanBluefox) Moved build process of GUI to vite
- (@GermanBluefox) Added possibility to group devices in the GUI
- (@GermanBluefox) Working on the controller
- (@GermanBluefox) Implemented the factory reset and re-announcing
- (@GermanBluefox) Devices were implemented
- (@GermanBluefox) Fixed names under linux
- (@GermanBluefox) used library
@iobroker/type-detector
- (@GermanBluefox) Initial commit
Apache-2.0
Copyright (c) 2023-2025 Denis Haev [email protected]
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
