Matter Server in home assistant

If you want to get started with Matter in Home Assistant, it is really important that you read the updated Matter documentation.
https://www.home-assistant.io/integrations/matter/


The Matter integration allows you to control Matter devices on your local Wi-Fi or Thread network.

For communicating with Matter devices, the Home Assistant integration runs its own “Matter controller” as add-on.

Matter Server add-on
This Matter Server add-on runs the controller software as a separate process。
This Matter Server add-on connects your Matter network (called Fabric in technical terms) and Home Assistant.

Matter integration
The Home Assistant Matter integration connects to this server via a WebSocket connection.



Each Matter network is called a fabric.


Step 1: Matter Wi-Fi Prerequisites

Before running the Matter Wi-Fi demo or developing for Wi-Fi make sure that you have all the required hardware and software for each use case.

Matter Hardware Requirements

Matter Software Requirements


Software and hardware requirements

requires 64bit Raspberry Pi.

requires 64bit Home Assistant OS

requires ipv6

requires bluetooth 5.0

Home Assistant INSTALLATION TYPES requirements

Running Matter on a Home Assistant OS installation : supported
Running Matter on a Home Assistant supervised installation : supported


Running Matter on a Home Assistant Docker installation : supported
Running Matter on a Home Assistant Core installation :Not supported.

It is recommended to run the Matter add-on on Home Assistant OS. This is currently the best-supported option.

If you run Home Assistant in a container, you can run a Docker image of the Matter server. The requirements and instructions for your host setup are described on that GitHub page.https://github.com/home-assistant-libs/python-matter-server

Running Matter on a Home Assistant Core installation is not supported.

detail:https://www.home-assistant.io/integrations/matter

目前只有 hassos 能比较容易运行起来 matter。
其实可以考虑用物理机跑hassos，也可以用虚拟机跑 hassos，网络配置成桥接，就到同一网段了


Only HAOS and HA supervised is supported

IPv6
IPV6 needs to be enabled on the network adapter used!

Homeassistant the you need to have IPv6 ON or Automatic. Mine was OFF. Turned it on and it worked like a charm!


Userul links
https://smarthomecircle.com/add-matter-devices-to-home-assistant


Matter over Thread http://localhost:4999/boards/topic/14558/matter-server-in-home-assistant/page/3
Bluetooth http://localhost:4999/boards/topic/14558/matter-server-in-home-assistant/page/6

Matter server网络拓扑结构



Matter可以同时支持Wi-Fi/Thread/Ethernet，也就是说Matter可以让不同网络中的设备进行互联互通通信，这个主要是指Thread board router 可以实现Wi-Fi和Thread通信互转。

Matter允许接入其他网络设备，比如ZigBee设备，主要通过一个Matter bridge设备来实现。

Matter controller
在Matter拓扑结构中，一个节点非常重要：Matter controller，Matter controller用来完成配网和远程控制设备.

比如苹果的HomePod mini和Home app就是一个典型的Matter controller节点。

Home Assistant Add-on: Matter Server
Matter Python WebSocket Server for Home Assistant Core. Matter (formerly known as Connected Home over IP or CHIP) is an IPv6 based smart home standard. This add-on provides a Matter Controller which allows you to commission and control of Matter devices. The matching Home Assistant Core integration communicates via WebSocket with this server.
https://github.com/home-assistant/addons/tree/master/matter_server

Matter 组成部分




Bluetooth adapter
Although your Home Assistant server might have a Bluetooth adapter on board that the controller can use to commission devices, Home Assistant does not utilize that adapter. Mainly to prevent issues with the built-in Bluetooth integration but also because it is easier to bring your mobile devices close to the Matter device than bringing the device near your server.

Matter网络 -Fabric

Each Matter network is called a fabric.

一个Matter网络称为一个Fabric，共享同一个根操作证书的所有节点可以归为同一个Fabric.

简单来说，一个生态就是一个Fabric（当然也可以包含多个），比如家里同时有苹果Google亚马逊的音箱，那么你可以认为你家里有三个Matter fabric，每个fabric是独立的，但这里要强调的是，Matter支持一个设备接入多个fabric，也就是可以同时用苹果Google亚马逊控制同一个Matter设备，比如门锁。


Matter Fabric 可以跨越家中基于不同通信协议的物理网络，包括 Wi-Fi、Thread 和以太网

{
  "fabric_id": 2,
  "compressed_fabric_id": 3713564249536204000,
  "schema_version": 8,
  "min_supported_schema_version": 5,
  "sdk_version": "2024.3.2",
  "wifi_credentials_set": false,
  "thread_credentials_set": false
}

Multi fabric
you can join the same device to multiple controllers. For example, simultaneously add it to Google Home, Apple Home, and Home Assistant. The standard describes that each device should be able to at least support 5 different fabrics simultaneously.

Home Assistant 2022.12

The Matter (BETA) integration was introduced in Home Assistant 2022.12

The Matter integration allows you to control Matter devices on your local Wi-Fi or Thread
network.

https://www.home-assistant.io/integrations/matter

Home Assistant 2023.3

The Thread border router in Home Assistant is operational  integrated in  Home Assistant 2023.3.

matter终端设备种类

Matter over Wi-Fi
Matter over Thread
Matter over Ethernet
Matter over Bridge

pip3 install python-matter-server

https://pypi.org/project/python-matter-server/

Python Matter WebSocket Server

Apple Home/HomeKit for example will create a Matter Fabric for its own use (you can think of this as an Apple HomeKit ecosystem) and that a Matter Device can pair with Apple’s Matter Fabric.

That same Matter Device can also pair with a Google Matter Fabric (Google Ecosystem) and thus that device will work with both Apple and Google Matter Fabrics.

Similarly a Matter Device paired with Apple HomeKit Matter Fabric can also be paired with Home Assistant’s Matter Fabric and thus that device will work in both HomeKit and HA Matter Fabrics.

Make sure your device meets all requirements to support Matter.
Update Android to the latest version and the Google Home and Home Assistant Companion app.

To quickly verify if your device meets all requirements to support Matter, on your Android device go to Settings >Google >Devices & Sharing . There should be an entry there for Matter devices .

Homeassistant needs to have an ipv6 adress for matter to function.
Not only do I have IPv6 enabled, but it’s even a static address. So this is clearly not the case.

After enabling ipv6 in the hassio network settings it started to work as expected.
And the homekit device must be added to hassio by the owner of the homekit home and not by a user.

For Android you need Matter Support