Adding Matter-Device failed [solved]

I’m trying to add my first Matter device to HA (container)

  1. I reset the device to factory settings
  2. I scan the QR-code
  3. I choose the Home Assistant app
  4. I press “I’m ready”


  5. I don’t know what the device is connected to: the Tado Bridge X or the smartphone?
    I press “Done”
  6. I press “Add device”

This also happened with other devices.

Does anyone have any idea what could be going wrong?

The Home Assistant log file provides the following information

2024-12-23 15:27:39.538 DEBUG (MainThread) [homeassistant.components.tado.device_tracker] Updating Tado mobile device: Pixel 7 (ID: 10314178)
2024-12-23 15:27:39.539 DEBUG (MainThread) [homeassistant.components.tado.device_tracker] Tado device Pixel 7 has geoTracking state False
2024-12-23 15:27:39.540 DEBUG (MainThread) [homeassistant.components.tado.device_tracker] Fetching Tado devices from API for (newly) tracked entities
2024-12-23 15:28:09.553 DEBUG (SyncWorker_15) [homeassistant.components.tado.tado_connector] Dispatching update to 1773759 mobile device: {'name': 'Pixel 7', 'id': 10314178, 'settings': {'geoTrackingEnabled': False, 'specialOffersEnabled': True, 'onDemandLogRetrievalEnabled': False}, 'deviceMetadata': {'platform': 'Android', 'osVersion': '15', 'model': 'Google_Pixel 7 Pro', 'locale': 'de'}}

Is HA in same network as device and using IPv6?

Not sure, the raspberry with the HA container and the thread border router have IPv4 addresses in the same network. But both are supporting also IPv6. How can I check which IP variant is used by HA?

It looks like you have paired it with a matter network, maybe a Google Matter network.
If you want it paired to HA too at the same time, then you need a share code from the Google Matter network.
The QR code on the device can only be used to pair the device with the first Matter network after a factory reset.

No, I don’t have another network. I use a Tado Bridge X as Thread Border Router and several Matter over Thread devices which I want to add to HA. But without success.

Since you already have devices commissioned on Tado Bridge X as TBR, then you should be able to “Share” it to HA’s Matter Server. Somewhere in the Tado App there should be a way to have it “share” a device which causes it to generate a pairing code. Copy this pairing code, then goto HA UI->Settings->Devices->Add Device, choose Matter and then choose “yes its already in use” then choose “other controller” and it should prompt you to paste the code into the box.

See also

To quote from that thread:
“… add the device to the tado app first. From there it can then be shared with the Home Assistant Matter controller (or any other). This seems to be the intended order of operation (and, in fairness, is also what the “Get started” leaflet asks you to do :sweat_smile: )”

My other devices are no Tado devices but from Nanoleaf and Eve. Tado writes the following about 3rd-party devices:

Adding other Thread-enabled devices to a tado° Thread network
Thread-enabled devices like lights, thermostats, outlets, sensors, and more can be connected to your home network via tado° Bridge X, tado° Heat Pump Optimizer X, or tado° Wireless Receiver X. However, they can’t be controlled via the tado° app. They will need to be controlled either on the vendor’s app or a Smart Home platform.

(see Do I need a tado° Bridge X? | Help Center: tado° X)

I have tried unsuccessfully to add the devices in the Tado app. The app does not recognize the QR code.

Factory reset the Eve and Nanoleaf devices and then try to add them again.
If that does not work, then you might need to contact Tado.

I already did factory resets. And as you can see in the pictures above the devices are connected successfully. But adding them to HA failed.

You do not add a device to HA that is already added to somewhere else.
You add the controller to HA and through that you control of the device.

What do you mean with controller? The Tado Bridge X?

Yes, that is a controller.
The Matter server with another word, but here I mean the general term and not the specific Matter server addon for HA, which is just one example of a Matter server.

By adding them to HA, do you mean by having Tado “share” a Tado device to HA?
Sharing is the easiest way to add a Matter-Thread device to HA. This was what was done in the community forum thread I referenced earlier.

I also tried to share it via pairing code and from the Nanoleaf app. But that was not successful either.

I try to share Nanoleaf and Eve devices.

Maybe I misunderstood, but were you able to pair Nanoleaf and Eve to Tado Bridge X? If the answer is no, then you can’t “share” Nanoleaf and Eve to HA.

Yes, I have connected the Nanoleaf devices with the Nanoleaf app to the Threat network of Tado Bridge X.

Ah great!
If sharing didn’t work, it is possibly due to a problem in IPv6 networking. The Tado Bridge should be on the same LAN as Home Assistant, and Home Assistant should have IPv6 enabled and have an IPv6 address that starts with something like fdaf:blah:blah

1 Like

Apparently something is wrong with the IPv6 support in the Docker host network:

# docker network inspect host
[
    {
        "Name": "host",
        "Id": "e90d8c78416b5ff1f8a61ee4831f669e163d6b7c3fddf180b9d61f9d145447fd",
        "Created": "2024-01-28T21:47:23.685580093+01:00",
        "Scope": "local",
        "Driver": "host",
        "EnableIPv6": false,
        "IPAM": {
            "Driver": "default",
            "Options": null,
            "Config": null
        },
        "Internal": false,
        "Attachable": false,
        "Ingress": false,
        "ConfigFrom": {
            "Network": ""
        },
        "ConfigOnly": false,
        "Containers": {
            "9f79f7eab4a62121bbe78fa3c77eff54cec48715f60b275be11e2c96d8479d4d": {
                "Name": "homeassistant",
                "EndpointID": "febb27f4f597c576aae0aba8673748df49e08df541acb1947e874724fbf442e2",
                "MacAddress": "",
                "IPv4Address": "",
                "IPv6Address": ""
            },
            "f360e8d203c241276b785e8cc93ea393999014279f86b3df8436e3a6fba29adb": {
                "Name": "matter-server",
                "EndpointID": "52f61f62270886d1026ecad108189a172e2bd4a09c92b329cb4629593ca4811d",
                "MacAddress": "",
                "IPv4Address": "",
                "IPv6Address": ""
            }
        },
        "Options": {},
        "Labels": {}
    }
]

Does anyone know how to correctly configure IPv6 support for the HA container?

look at this