Matter integration

[waltervl]

But in the end it would be great is it was a stand-alone application like zigbee2mqtt / zwavejs-ui that works with MQTT Auto Discovery, with it's web interface to include/exclude nodes, etc.
That way it could work with other home automation systems as well.

Domoticz is the only one missing a Matter integration so that someone created a python plugin is just great!

[fleinze]

@fleinze
Great that communication part is working!
Do you also combine temp+hum / temp+hum+baro sensors? Energy+Power (kWh) sensors?

Currently not, but this is one of the next things I want to add.

I hope you are using Claude code to assist you. If yes, maybe you could include the project folder/CLAUDE.md file
If not, consider moving to Clause code (not the web page) asap and follow some youtube guides about coding and review agents

I did use Claude web, but I am considering moving to Claude code.

Maybe also consider using type names, also easier for non developers

I am actually using type names, except for the electricity counter without Power.

Code: Select all

TypeDB = {
(0x0402,0x0000): {'DomoType': 'Temperature',     'Multiplier': 0.01},
(0x0405,0x0000): {'DomoType': 'Humidity',        'Multiplier': 0.01},
(0x0006,0x0000): {'DomoType': 'Switch',          'Multiplier': 1.}, # On/Off cluster
(0x003b,0x0001): {'DomoType': 'Switch',          'Multiplier': 1.}, # Switch cluster
(0x0045,0x0000): {'DomoType': 'Switch',          'Multiplier': 1.}, # boolean state cluster
(0x0008,0x0000): {'DomoType': 'Dimmer',          'Multiplier': 0.392},
(0x0090,0x0004): {'DomoType': 'Voltage',         'Multiplier': 0.001},
(0x0090,0x0005): {'DomoType': 'Current (Single)','Multiplier': 0.001},
(0x0090,0x0008): {'DomoType': 'Usage',           'Multiplier': 0.001},
(0x0091,0x0001): {'DomoType': '113;0;0',         'Multiplier': 1.0},
}

And if possible also a docker compose setup on your main readme as it is more easier (and practical) to use docker compose
(with a local data folder instead of the home directory)

Done

How are you c++ skills? As it might be useful to have this natively in Domoticz (also for QR code related stuff), I know someone is already looking into this (and supporting MQTT-AD), but I think it can be easily done natively as well
I will create a C++ websocket client that Domoticz hardware can easily use (currently it is only build into libwebem and python)

I know some c++, but I never did a larger project. At the current stage of developement I would prefer staying in python as I do not need to compile and it is thus much faster.

[gizmocuz]

@Walter,

- Domoticz is the only one missing a Matter integration so that someone created a python plugin is just great!
The reason was that there was not many hardware available for this, and I was hoping for a Zigbee2MQTT project that supported Matter.
I suspect this might still happen in the feature... who knows.

I had some Matter hardware at home waiting.. And at the exact same time that 'fleinze' was working on a python implementation, there was internally already a project going on and ideas for making it stand-alone/mqtt based.
But matter-js seems the way to go.

That being said:

@fleinze,
Compilation of modified files in Domoticz (once you done the initial build) takes seconds and it gives a much better control.

If you can/want, please have a look here:

https://github.com/domoticz/domoticz/bl ... Matter.cpp

So far tested is the Tado thermostat, Ikea temp+hum, and the Ikea wall-plug (switch/power/energy).
Tomorrow I have a bunch of other hardware to test, but I expect them to work.
Supporting RGB/W/WW will take some extra minutes.

Currently the OpenZWave implementation allows adding/removing nodes, and displaying the neighbours display, this is something that is on the todo list.

Would be great if we can team up to get this enhanced.

I am almost done with the Dynamic Dashboard implementation and can devote some time to this.

[heggink]

The Tado integration works great. Time to move away from the legacy interface.

[fleinze]

@gizmocuz
of course I will work on the c++ Matter integration from now on. Just sent the first small PR because commands did not work in my setup.

Some thought after my first look:
The Ikea remote does not work because they need cluster 59 / attribute 1. Should be an easy addon, I can do this if you want.
The battery percentage is updated on my temperature sensor, but not on my water leak sensor (binary cluster).
I think it would be great if the json attribute "available" from server is used to set devices as timed out.

[gizmocuz]

@gizmocuz
of course I will work on the c++ Matter integration from now on. Just sent the first small PR because commands did not work in my setup.

Some thought after my first look:
The Ikea remote does not work because they need cluster 59 / attribute 1. Should be an easy addon, I can do this if you want.
The battery percentage is updated on my temperature sensor, but not on my water leak sensor (binary cluster).
I think it would be great if the json attribute "available" from server is used to set devices as timed out.

Great! But check the latest code first as I made some changes this morning.

And indeed use the new matterjs-server and not the deprecated one.

ghcr.io/matter-js/matterjs-server:latest

[fleinze]

@gizmocuz
Very good. The pushbutton-Remote now works.
For the battery-percentage I sent a PR.

Edit:
Color light bulb (Ikea KAJPLATS CWS) works as well!

[gizmocuz]

Yes I tested them all. (RGB/WW/CW)

Latest beta has some nice additions:
- Setup button next to the hardware in Domoticz
- Possible to include/exclude a node from within Domoticz
- Node list
- Neighbor list / graph

Basically how the deprecated Openzwave displayed

[BartSr]

Which tx/rx device (what is name? Coördinator?) is advised for matter?

[fleinze]

Which tx/rx device (what is name? Coördinator?) is advised for matter?

For the matter plugin to work you need a running matter-js-server (setup with docker: https://github.com/matter-js/matterjs-s ... /docker.md)
Matter alone can run on your local network, e.g. with Tasmota32-nodes.

If you want to use the wireless standard thread, that is needed for e.g. the new Ikea devices, you need a Thread-border-router.
There are many thread border routers available.
The commercial ones:

• Apple TV

• Apple Homepod

• Google Nest Hub

• Amazon Echo dot

• Ikea dirigera (newest version)

just to name a few
Then there the open source ones:

• Home Assistant ZBT-2

• Openthread border router (ESP)

I use the Openthread ESP router https://openthread.io/guides/border-rou ... ssif-esp32 myself, which I ordered from Aliexpress. But this has no housing and needs you to compile the firmware yourself.

[fleinze]

Yes I tested them all. (RGB/WW/CW)

Latest beta has some nice additions:
- Setup button next to the hardware in Domoticz
- Possible to include/exclude a node from within Domoticz
- Node list
- Neighbor list / graph

Basically how the deprecated Openzwave displayed

I run the latest beta (17774, docker) but sadly do not get the setup-button. Can you please check if there is something missing?
It looks like Hardware.js is looking for a version, that is currently not set in Matter.cpp

[fleinze]

With latest beta (17783) the setup-page works! Looks great, thanks gizmocuz

[gizmocuz]

Thanks, I am working on more changes... but I will make a new version tomorrow

[harrykausl]

I'm very happy about your efforts to integrate matter. What is the state, there's a longer time, that there was nothing written in this thread. Can it be testet and how. What is the docker compose image (python or java-js) which has to be installed. For the integration itself, I think it is in the beta domoticz?

[gizmocuz]

Sure it can be tested.
It is in the beta version (and will be in the stable)

I have no new devices to test, and most should be handled.

I am using docker compose, and this is my docker-compose.yml file for the matterjs-server:

Code: Select all

services:
  matterjs-server:
    container_name: matterjs-server
    image: ghcr.io/matter-js/matterjs-server:latest
    read_only: true
    network_mode: host
    restart: unless-stopped
    volumes:
      - ./data:/data

That's all there is to it

In Domoticz when adding the Matter hardware all that needs to be configured is the IP/Port (192.168.0.123:5580)

I am using a Apple TV as my main Matter Router/Gateway, so I include all matter devices here. And in the Apple Home application you can press the settings icon for each device and re-share it. You get a QR code that you need to use in Domoticz

There is a setup button next to the hardware in Domoticz that you can use, and you can also use the native web interface of the matterjs-server docker container (http://192.168.0.123:5580)

[harrykausl]

And which matter server do you use, the new beta?

[waltervl]

I have added a preliminary wiki page. Work in progress as I am not using Matter, just merged some instructions read in this thread.
https://wiki.domoticz.com/Matter

Feel free to comment on this or modify it yourself.

[gizmocuz]

@Walter, thank you for this!

@harry, ghcr.io/matter-js/matterjs-server:latest

[harrykausl]

Thanks to all who helped to make this integration. I installed the matterjs-server, the latest domoticz-beta and the plugin, and included my 3 tado x thermostats, which I included before via a home assistant interface to my domoticz. I have now both types of integrations in my domoticz, so I can see in a easy way what works.

Here are my results:

1. Changing setpoint in domoticz works.
2. Changing setpoint on the thermostat or in tado or in home assistant doesn't show the correct setpoint. It isn't changed in the new domoticz thermostats.
3. Changing the mode of the thermostat works in both directions. I have to use in my scripts heat / off instead of on / off.
4. The Control Sequence device can be hidden, if there is only heating?

One additional point. It would be very nice, if in the matter-js server the device names could be changed. I didn't find that point.

The only point which is important for me, is the point 2. Perhaps anyone can test this.

[gizmocuz]

Thanks!

You can set any device unused that you like.

Yes, the renaming you have to request at the matterjs-servers github page, maybe on the same page where we also requested this