Skip to content

Latest commit

 

History

History
194 lines (141 loc) · 21.4 KB

ECOSYSTEMS.md

File metadata and controls

194 lines (141 loc) · 21.4 KB

Overview of the Matter Ecosystems

Device types tested on various Ecosystems

This list is a compilation of published information and own community tests. Many updates in the ecosystems happen without big announcements, so the information here can be a bit outdated and more device types are supported. If you find errors or added device types please open a PR or issue to report them. Please note: The content of this table is collected from various public sources, our own experiments, and community feedback which mean it might be outdated or not accurate.

Table Legend:

  • "X" means supported
  • "-" means not supported from current knowledge
  • "?" means unknown
  • "MDL Section" column identifies the relevant section in the Matter Device Library Specification Version 1.2 (Oct. 18, 2023).
  • "ID" refers to the device type ID as set out in each device type's "Classification" section in the the MDL.
MDL Section Matter Device type and Class Apple
iOS 17.1
Google Amazon SmartThings LG ThinQ Tuya Home Assisitant
2024.5.2
flic
Bridge Support X X X X - - X X
Composed Devices Support X X X(1) - - - X ?
4 Lighting Device Types
4.1 On/Off Light
(ID: 0x0100)
X X X X X X X X
4.2 Dimmable Light
(ID: 0x0101)
X X X X - X X X
4.3 Color Temperature Light
(ID: 0x010C)
X X X X - X X X
4.4 Extended Color Light
(ID: 0x010D)
X X X ? - ? X X
5 Smart Plugs/Outlets/Actuators
5.1 On/Off Plug-in Unit
(ID: 0x010A)
X X X X X X X X
5.2 Dimmable Plug-in Unit
(ID: 0x010B)
? ? ? ? - ? ? X
5.3 Pump
(ID: 0x0303)
- - - - - - - ?
6 Switches and Control Device Types
6.1 On/Off Light Switch
(ID: 0x0103)
x x ? ? ? ? X ?
6.2 Dimmer Switch
(ID: 0x0104)
X x ? ? ? ? X ?
6.3 Color Dimmer Switch
(ID: 0x0105)
? ? ? ? ? ? X ?
6.4 Control Bridge
(ID: 0x0840)
? ? X ? ? ? ? ?
6.5 Pump Controller
(ID: 0x0304)
? ? ? ? ? ? ? ?
6.6 Generic Switch
(ID: 0x000F)
X (Latching Switch only) - ? ? ? ? X ?
7 Sensor Device Types
7.1 Contact Sensor
(ID: 0x0015)
X X X X ? ? X -(2)
7.2 Light Sensor
(ID: 0x0106)
X X - X ? ? X -(2)
7.3 Occupancy Sensor
(ID: 0x0107)
X X X ? ? ? X -(2)
7.4 Temperature Sensor
(ID: 0x0302)
X X X X ? ? X -(2)
7.5 Pressure Sensor
(ID: 0x0305)
- X ? ? ? ? X -(2)
7.6 Flow Sensor
(ID: 0x0306)
- X - X ? ? X -(2)
7.7 Humidity Sensor
(ID: 0x0307)
X X X X ? ? X -(2)
7.8 On/Off Sensor
(ID: 0x0850)
? ? ? ? ? ? ? -(2)
7.9 Smoke CO Alarm
(ID: 0x0076)
? ? ? ? ? ? ? -(2)
8 Closure Device Types
8.1 Door Lock
(ID: 0x000A)
X X X X ? ? X X
8.2 Door Lock Controller
(ID: 0x000B)
? -
8.3 Window Covering
(ID: 0x0202)
X X (Lift only) - ? ? ? X X
8.4 Window Covering Controller
(ID: 0x0203)
? ? ? ? ? ? ? -
9 HVAC Device Types
9.1 Heating/Cooling-Unit
(ID: 0x0300)
- - - - ? ? ? ?
9.2 Thermostat
(ID: 0x0301)
X X X ? ? ? X X
9.3 Fan
(ID: 0x002B)
- - - - ? ? ? ?
9.4 Air Purifier
(ID: 0x002D)
? ? ? ? ? ? ? ?
9.5 Air Quality Sensor
(ID: 0x002C)
? ? - ? ? ? ? ?
10 Media Devices
10.1 Video Player Architecture - - - - ? - ? ?
10.2 Basic Video Player
(ID: 0x0028)
- - - - ? - ? ?
10.3 Casting Video Player
(ID: 0x0023)
- - - - ? - ? ?
10.4 Speaker
(ID: 0x0022)
X - - ? - ? ?
10.5 Content App
(ID: 0x0024)
- - - - ? - ? ?
10.6 Casting Video Client
(ID: 0x0029)
? ? ? ? ? ? ? ?
10.7 Video Remote Control
(ID: 0x002A)
? ? ? ? ? ? ? ?
11 Generic Devices
11.1 Mode Select
(ID: 0x0027)
- - X - ? - ? ?
12 Robotic Device Types
12.1 Robotic Vacuum Cleaner Device Type
(ID: 0x0074)
? ? ? ? ? ? ? ?
13 Appliance Device Types
13.1 Laundry Washer
(ID: 0x0073)
? ? ? ? ? ? ? ?
13.2 Refrigerator
(ID: 0x0070)
? ? ? ? ? ? ? ?
13.3 Room Air Conditioner
(ID: 0x0072)
? ? ? ? ? ? ? ?
13.4 Temperature Controlled Cabinet
(ID: 0x0071)
? ? ? ? ? ? ? ?
13.5 Dishwasher
(ID: 0x0075)
? ? ? ? ? ? ? ?

(1) See the section below on Composed devices and Alexa (2) See note on Flic sensors

Pairing and Usage Information

It should work with any Matter-compatible home automation app when Matter will be released. We tested the Library with a few common ones and can provide additional information.

Apple

Minimum OS Required for iOS and tvOS devices: iOS 16.2 or later, with latest iOS version recommended.

Apple has two guides that can help you get setup:

When pairing with matter.js the operating system will ask you to allow to pair an "uncertified device" which you need to allow. After that the device will be added to the Home app, and you can control it from there.

Google Home Ecosystem

Minimum Version Required for the "Google Home" app:2.62.1.15 or later.

Also for Google you need to have a Hub device (Android or Google Nest smart speakers/display) out of the list of supported devices to control your Matter devices.

When pairing with matter.js the operating system will ask you to allow to pair an "uncertified device" which you need to allow. If you want to avoid this message you optionally can register the relevant details for your uncertified devices in your Google Account. For this open the Google Developer Console to add an Integration and setup the device there. Please use 0xFFF1 as Vendor ID and 0x8000 as product id because matter.js uses this by the current example scripts by default.

If you have issues with pairing please refer to the Troubleshootling pages from Google.

Google supports several Matter device types already.

Amazon Alexa Ecosystem

Minimum Version Required for the "Amazon Alexa" app:2.2.491118.0 or later.

For Amazon Alexa Usage you also need one Alexa device as Matter hub in your local network.

For Alexa no special setup is needed to pair with matter.js as development device.

The list of supported device types is basic currently, but will get enhanced in the future.

Alexa currently has a few non-standard requirements:

  • Matter devices need to use port 5540 only, else they will not be discovered by Alexa at all
  • The device needs to have an Endpoint 1 beside the root endpoint. This needs to either be the main device endpoint or an aggregator endpoint.

Composed Devices: devices that are composed under a BridgedNodeEndpoint are recognised as separate devices by the Alexa ecosystem. So a temperature and humidity sensor that is established under a BridgedNodeEndpoint is seen as three devices: (a) a "head" device and (b) the two sensors (not in the same UI). However the ecosystem does not tolerate an end device with clusters that are not specified in the Matter specs as mandatory or optional. For example, a temperature sensor that has the cluster for RelativeHumidityMeasurementServer added will be recognised by Alexa only as a temperature device. Idem for any power controller/source information added to an endpoint where that cluster is not specified as mandatory or optional. If you want to add power source info then it needs to be at the BridgedNodeEndpoint level. Advice is to create these virtual devices as separate children of the aggregator endpoint or, if a composed device is necessary, use a BridgedNodeEndpoint as the parent of these endpoints.

Tuya Smart (SmartLife) Ecosystem

Should work but no more detailed information here as of yet. The device types are limited and bridges are not supported based on the latest information.

Samsung SmartThings Ecosystem

Samsung is building its SmartThings hub software into 2022 Samsung Smart TVs, Smart Monitors, and Family Hub refrigerators, allowing them to control Matter smart home devices. Currently, Samsung SmartThings Station or Samsung SmartThings Hub v2 and later are needed as a hub for Matter.

  • Samsung "Samsung SmartThings Station" does support Matter devices over LAN, Wi-Fi, and over Thread radio (Thread Border Router).
  • "Aeotec Smart Home Hub" (rebranded Samsung SmartThings Hub v3) will be getting an update to supports Matter over Wi-Fi.
  • "Samsung SmartThings Hub v3" (ETH-ETH-300 from 2018) has been updated to support Matter over Wi-Fi.
  • "Samsung SmartThings Hub v2" (ETH-ETH-250 from 2016) has been updated to support Matter over Wi-Fi.
  • "Samsung SmartThings Hub v2" (ETH-ETH-200 from 2015) has been updated to support Matter over Wi-Fi.
  • "SmartThings Family Hub" smart fridge might or might not get updated to support Matter at a later date.
  • "SmartThings Hub v1" (F-H-ETH-001 and STH-ETH-001) has been discontinued and will not get updated to support Matter.
  • "Samsung SmartThings Link" (USB dongle) for Nvidia Shield has been discontinued and will not get updated to support Matter.

Home Assistant - Matter integration

Home Assistant's official Matter integration is in Beta-stage however it is fully working and compatible with the Matter 1.2 standard. To connect Thread based devices you also need an Thread Border Router radio that is compatible with Home Assistant's official Thread integration, that includes their official Home Assistant Yellow hub and their Home Assistant SkyConnect Zigbee/Thread USB dongle.

flic

Flic offers a Matter controller with their Hub products, that allows the flic buttons to control Matter devices.

Their implementation is interesting as it exposes a lower level of Matter detail than most other platform, they have basic configuration for Lights and Plug In units allowing features such as on/off, dimming etc. However for all other devices they have a generic matter control which then lists the clusters with commands and attributes on each. This means that they can offer control of any device type without having to build their own UI for each, but it does require a but more understanding of the protocol.

When it comes to sensor devices however there are no commands or attributes to update so the flic method doesn't really work for these devices, all you can do with a temperature sensor for example is turn on & off the identify, there is no way to get the value into the flic app.

chip-tool

Compile chip-tool from project-chip

Provisioning the device:

chip-tool pairing onnetwork 222 20202021

Controlling the device:

chip-tool onoff toggle 222 1

Clearing the data:

chip-tool pairing unpair 222

and/or

chip-tool storage clear-all

Android mobile app

You can also control it with Matter test app: https://github.com/project-chip/connectedhomeip/tree/master/src/android/CHIPTest You can find a compiled apk in /matter-test-apk in this repository.

Provisioning the device: click "provision with WiFi" > "Input DeviceNode address" > type IP address of the machine running matter.js

Controlling the device: click "Light on/of" and you can control the light