This thermostat sample demonstrates the usage of the :ref:`Matter <ug_matter>` application layer to build a thermostat device for monitoring temperature values and controlling the temperature. This device works as a Matter accessory device, meaning it can be paired and controlled remotely over a Matter network built on top of a low-power, 802.15.4 Thread network or on top of a Wi-Fi® network.
Additionally, this example allows you to connect to a temperature sensor device that can also be used for temperature measurement.
The sample supports the following development kits:
.. table-from-sample-yaml::
Similarly, if you want to test the sample with :ref:`matter_thermostat_sample_sensor`, you need additional hardware that incorporates a temperature sensor. For example, Nordic Thingy:53, used for the :ref:`Matter weather station <matter_weather_station_app>` application.
The sample can operate in one of the following modes:
Simulated temperature sensor mode - In this mode, the thermostat sample generates simulated temperature measurements and prints it to the terminal. This is the default mode, in which the sample provides simulated temperature values.
Real temperature sensor mode - In this mode, the thermostat sample is bound to a remote Matter temperature sensor, which provides real temperature measurements. This mode requires :ref:`matter_thermostat_sample_sensor`.
Real temperature sensor mode setup
The sample automatically logs the temperature measurements with a defined interval and it uses buttons for printing the measurement results to the terminal.
You can test the sample in the following ways:
- Standalone, using a single DK that runs the thermostat application.
- Remotely over the Thread or the Wi-Fi protocol, which in either case requires more devices, including a Matter controller that you can configure either on a PC or a mobile device.
The thermostat sample implements the following features:
- Temperature measurement - The thermostat sample can measure the temperature and print it to the terminal.
- Temperature control - The thermostat sample can control the temperature of the connected devices.
- :ref:`Binding <matter_thermostat_sample_binding>` - The thermostat sample can bind with the temperature sensor to be able to control it.
The sample supports the following build configurations:
.. toggle:: The thermostat sample lets you connect to an external temperature sensor, for example :ref:`Matter weather station application on Nordic Thingy:53 <matter_weather_station_app>`. This establishes the :ref:`matter_thermostat_sample_binding` to Matter's temperature measurement cluster. By default, the thermostat sample generates simulated temperature measurements that simulate local temperature changes. Additionally, you can enable periodic outdoor temperature measurements by binding the thermostat with an external temperature sensor device. To test this feature, follow the steps listed in the :ref:`matter_thermostat_sensor_testing` section.
- First LED:
- First Button:
- Second Button:
- Prints the most recent thermostat data to terminal.
|matter_ble_advertising_auto|
Complete the following steps to test the Thermostat device using CHIP Tool:
.. rst-class:: numbered-step
Read the simulated temperature by running the following command:
./chip-tool temperaturemeasurement read measured-value <node_id> 1
The received output will look similar to the following:
[1755081048.320] [99348:99350] [TOO] Endpoint: 1 Cluster: 0x0000_0402 Attribute 0x0000_0000 DataVersion: 1994139940
[1755081048.320] [99348:99350] [TOO] MeasuredValue: 9Complete the following steps to test communication between the thermostat and the temperature sensor:
.. rst-class:: numbered-step
Follow the steps in the :ref:`matter_thermostat_sample_testing_start` section During the commissioning process, write down the values for the thermostat node ID, the temperature sensor node ID, and the temperature sensor endpoint ID. These IDs are going to be used in the next steps (<thermostat_node_ID>, <temperature_sensor_node_ID>, and <temperature_sensor_endpoint_ID>, respectively).
.. rst-class:: numbered-step
Use the :doc:`CHIP Tool <matter:chip_tool_guide>` ("Writing ACL to the accesscontrol cluster" section) to add proper ACL for the temperature sensor device.
Use the following command, with <thermostat_node_ID>, <temperature_sensor_node_ID>, and <temperature_sensor_endpoint_ID> values from the previous step about commissioning:
chip-tool accesscontrol write acl '[{"fabricIndex": 1, "privilege": 5, "authMode": 2, "subjects": [112233], "targets": null}, {"fabricIndex": 1, "privilege": 1, "authMode": 2, "subjects": [<thermostat_node_ID>], "targets": [{"cluster": 1026, "endpoint": <temperature_sensor_endpoint_ID>, "deviceType": null}]}]' <temperature_sensor_node_ID> 0
.. rst-class:: numbered-step
Write a binding table to the thermostat to inform the device about the temperature sensor endpoint by running the following command, with <thermostat_node_ID>, <temperature_sensor_node_ID>, and <temperature_sensor_endpoint_ID> values from the previous step about commissioning:
chip-tool binding write binding '[{"fabricIndex": 1, "node": <temperature_sensor_node_ID>, "endpoint": <temperature_sensor_endpoint_ID>, "cluster": 1026}]' <thermostat_node_ID> 1
(You can read more about this step in the "Adding a binding table to the binding cluster" in the :doc:`CHIP Tool <matter:chip_tool_guide>` guide.)
The thermostat is now able to read the real temperature data from the temperature sensor device. The connection is ensured by :ref:`matter_thermostat_sample_binding` to Matter's temperature measurement cluster.
.. rst-class:: numbered-step
Press the |Second Button| to print the most recent temperature data from the thermostat device to the UART terminal.