Binding Eve Thermo Thermostat and Matter Temperature sensor

[lboue]

Binding Eve Thermo Valve and Matter Temperature sensor

Thermostat (cluster 513) will be binded to Temperature sensor (cluster 1026). In this way, it is possible to have a temperature sensor remote from the thermostat.

Setup

• 1 * Eve Thermo Valve
• 1 * Temperature sensor
• 1 * python-matter-server instance
• 1 * Websocket client

Doc

• Nordicsemi Access Control Guide

Steps

1. Pair your Eve Thermo in HomeAssistant Matter fabric
2. Pair your Temperature sensor in HomeAssistant Matter fabric
3. Identify the Matter HomeAssistant fabric ID
4. Create an ACL on the Temperature sensor device
5. Create a binding on the Eve Thermo device
6. Testing

Matter device pairing

1. Pair your devices
2. Read node number in Home Assistant web interface for the two devices:

• Eve Thermo Valve
• Temperature sensor

Temperature sensor

Read MeasuredValue attribute (0) from Temperature sensor

Note

In this example, TemperatureMeasurement Cluster belongs to Endpoint 2

Request

{
   "message_id": "2",
   "command":"read_attribute",
   "args":{
      "node_id":[TempNodeID],
      "attribute_path":"[TempEpID]/1026/0"
   }
}

Response

{
    "message_id": "2",
    "result": {
        "[TempEpID]/1026/0": 1056
    }
}

Read Temperature sensor FabricID

{
   "message_id": "1",
   "command":"read_attribute",
   "args":{
      "node_id":[TempNodeID],
      "attribute_path":"0/62/5"
   }
}

Response

{
  "message_id": "1",
  "result": {
    "0/62/5": 4
  }
}

Thermostat

Read LocalTemperature attribute (0) from Thermostat

{
   "message_id": "2",
   "command":"read_attribute",
   "args":{
      "node_id":[ThermostatNodeID],
      "attribute_path":"1/513/0"
   }
}

Response

{
  "message_id": "2",
  "result": {
    "1/513/0": 1950
  }
}

Identify the Matter HomeAssistant fabric ID

Read Thermostat FabricID

{
   "message_id": "1",
   "command":"read_attribute",
   "args":{
      "node_id":[ThermostatNodeID],
      "attribute_path":"0/62/5"
   }
}

Response

{
   "message_id": "1",
   "command":"read_attribute",
   "args":{
      "node_id":[ThermostatNodeID],
      "attribute_path":"0/62/5"
   }
}

Note

In this example, the index value is: 4

Create an ACL on the temperature sensor device

You need to modify the Access Control List (ACL) of your Matter temperature sensor device. This list determines which device in the network your Matter temperature sensor device will react to.

Write Acl attribute to temperature sensor device

Note

• Replace [fabricID] by the fabric ID from previous step
• Replace [ThermostatNodeID] by the ThermostatNodeID node ID
• Replace [TempNodeID] by the ThermostatNodeID node ID
• Replace [TempEpID] by the ThermostatNodeID endpoint ID

{
   "message_id": "2",
   "command":"write_attribute",
   "args":{
      "node_id":[TempNodeID],
      "attribute_path":"0/31/0",
      "value": [{"fabricIndex": [fabricID], "privilege": 5, "authMode": 2, "subjects": [112233], "targets": null}, {"fabricIndex": [fabricID], "privilege": 3, "authMode": 2, "subjects": [[ThermostatNodeID]], "targets": [{"cluster": 1026, "endpoint": [TempEpID], "deviceType": null}, {"cluster": 8, "endpoint": [TempEpID], "deviceType": null}]}]
   }
}

Request

{
   "message_id": "2",
   "command":"write_attribute",
   "args":{
      "node_id":[TempNodeID],
      "attribute_path":"0/31/0",
      "value": [{"fabricIndex": 4, "privilege": 5, "authMode": 2, "subjects": [112233], "targets": null}, {"fabricIndex": 4, "privilege": 3, "authMode": 2, "subjects": [16], "targets": [{"cluster": 1026, "endpoint": 2, "deviceType": null}]}]
   }
}

Response

{
  "message_id": "2",
  "result": [
    {
      "Path": {
        "EndpointId": 0,
        "ClusterId": 31,
        "AttributeId": 0
      },
      "Status": 0
    }
  ]
}

Create a binding in the Thermostat device

Write Unicast binding to Thermostat

Add 1 entry in the Thermostat binding table:

1. Cluster 1026 for the TemperatureMeasurement cluster

Note

• Replace [FabricID] by the fabric ID from previous step
• Replace [ThermostatNodeID] by the Thermostat node ID
• Replace [TempNodeID] by the Thermostat node ID
• Replace [TempEpID] by the Temperature sensor Endpoint ID

Request

{
   "message_id": "3",
   "command":"write_attribute",
   "args":{
      "node_id": [ThermostatNodeID],
      "attribute_path":"1/30/0",
      "value": [
          {"fabricIndex": [FabricID], "node": [TempNodeID], "endpoint": [TempEpID], "cluster": 1026}
        ]
   }
}

Response

{
  "message_id": "3",
  "result": [
    {
      "Path": {
        "EndpointId": 1,
        "ClusterId": 30,
        "AttributeId": 0
      },
      "Status": 0
    }
  ]
}

Read Unicast binding from Thermostat

Request

{
   "message_id": "4",
   "command":"read_attribute",
   "args":{
      "node_id": [ThermostatNodeID],
      "attribute_path":"1/30/0"
   }
}

Response

{
  "message_id": "4",
  "result": {
    "1/30/0": [
      {
        "1": [TempNodeID],
        "3": [TempEpID],
        "4": 1026,
        "254": [FabricID]
      }
    ]
  }
}

Testing

Now we can check that:

• RemoteSensing is enabled on the valve/thermostat
• the temperature is synchronized between the temperature sensor and the valve/thermostat.

Read RemoteSensing attribute (26) from Thermostat

Request

{
   "message_id": "5",
   "command":"read_attribute",
   "args":{
      "node_id": [ThermostatNodeID],
      "attribute_path":"1/513/26"
   }
}

Response

{
  "message_id": "5",
  "result": {
    "1/513/26": 1
  }
}

Note

RemoteSensing is now enabled

Verify reported temperature

Read MeasuredValue attribute (0) from Temperature sensor

Request

{
   "message_id": "6",
   "command":"read_attribute",
   "args":{
      "node_id":[TempNodeID],
      "attribute_path":"2/1026/0"
   }
}

Response

{
  "message_id": "6",
  "result": {
    "2/1026/0": 1980
  }
}

Thermostat

Read LocalTemperature attribute (0) from Thermostat

Request

{
   "message_id": "7",
   "command":"read_attribute",
   "args":{
      "node_id":[ThermostatNodeID],
      "attribute_path":"1/513/0"
   }
}

Response

{
  "message_id": "7",
  "result": {
    "1/513/0": 1980
  }
}

[judahrand]

There are a few things that I think could be better in these instructions:

• It was not clear to me what FabricId to use. The answer is of course the FabricId of the Matter Server but that is not necessarily the value of the CurrentFabricId for either the Temperature sensor or the Thermostat. It is probably easiest to get this from the Matter Server UI like we get the NodeIds. In any case the value which is passed is ignored and the correct value forced.
• There is a copy-pasta error in the ACL instructions where cluster 8 is included as well as cluster 1026. I think this is left over from the light switch instructions.
• I don't think "privileged": 3 (Operate) is needed to read the Temperature sensor. I believe, we only need "privileged": 1 (View).
• I'm not sure that it should have been needed but I also had to write to the RemoteSensing attribute to set it to 1 (well technically current_value | 1).

[judahrand]

Oddly, my binding has stopped working and it isn't clear to me why or how to get it back. I wonder if the issue is that I'm using bridged non-Matter temperature sensors via https://github.com/t0bst4r/home-assistant-matter-hub