# Matter (Beta) Devices

CUBE OS has a built-in Matter Hub (Controller) feature, allowing you to add supported Matter devices to your home locally.

{% hint style="info" %}
For compatibility, check the **Supported Accessory** [article](https://cube.ewelink.cc/compatibility-check/matter).
{% endhint %}

## 1. For New/Factory Reset Devices

{% stepper %}
{% step %}

### Find Onboarding Code

Locate the Matter onboarding code on your product, packaging, or manual. It will look similar to the demo shown below:

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmVM05hXvF8cXB8ipjdut%2Fimage.png?alt=media&#x26;token=c53e46b0-e336-4862-a0a7-914634eec38d" alt="" data-size="original">

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FU6z4Dga1ZHT0BVVOrIfn%2Fimage.png?alt=media&#x26;token=6ddb487f-934b-4cac-abd3-a56b230d9559" alt="" data-size="original">

*Credit: Connectivity Standards Alliance*

{% hint style="info" %}
Some devices must first be paired with specific apps to generate the code.

For instance, older models of Wiz, and most Matter bridges require this step. In such cases, follow the vendor’s guide to obtain the Matter Onboarding Code.
{% endhint %}
{% endstep %}

{% step %}
Visit your CUBE OS home page.

![](https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F9cLuIPqw91LXZAsccdxE%2FScreenshot%202024-11-29%20at%2016.07.21.png?alt=media\&token=e19c896c-0f62-4c95-b723-455f6fb2066a)

Click on the `+` button, and select `Add Device`.

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FoMq708ByqmNLH6zTE98t%2FScreenshot%202024-11-29%20at%2016.07.30.png?alt=media&#x26;token=898fcd03-7ebe-467f-b4a4-b748418e214f" alt="" data-size="original">
{% endstep %}

{% step %}

### 3.1 Auto Option

Power on your Matter devices and ensure they are in pairing mode following the manufacturer's guides. Then click `Start Setup`.

Available devices would be listed on this interface. Select the one you want to add.

### 3.2 Manual Option

Click `AddMatter Devices`
{% endstep %}

{% step %}
Enter the onboarding code of your devices obtained from [step 1](#for-new-factory-reset-devices).

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FNNBEjQWTYTzinjH1Nz8l%2FScreenshot%202024-11-29%20at%2017.32.54.png?alt=media&#x26;token=af9a4876-62bc-40ab-a941-5d1a1bd62b10" alt="" data-size="original">
{% endstep %}

{% step %}
Fill in your Wi-Fi credentials if you are prompted to do so.&#x20;

Then click `Next`.

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FrHIix1mLPbR8dz1xtYxv%2FScreenshot%202024-11-29%20at%2017.33.16.png?alt=media&#x26;token=c4d0ffde-b0a2-4944-9159-7b01cd8b1ac3" alt="" data-size="original">
{% endstep %}

{% step %}
CUBE OS will start to talk with your devices for setups.

<img src="https://67406449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fhc8R8pJEwqNTq2XLOY7w%2FScreenshot%202024-11-29%20at%2017.35.44.png?alt=media&#x26;token=64e2504a-ca32-4c0e-aa8a-2312af88f2a3" alt="" data-size="original">
{% endstep %}

{% step %}
When finishing adding your device, CUBE OS will promote a window to name it and assign it to a room.&#x20;
{% endstep %}
{% endstepper %}

## 2. For Devices From Other Apps

For Matter devices already in use, follow these steps to enable pairing and get the onboarding codes:

### **2.1 Apple Home**

#### **2.1.1 Native Matter Devices (e.g. Matter Wi-Fi Plugs)**

{% stepper %}
{% step %}
Open the Home app and find the tile of the device you want to share.
{% endstep %}

{% step %}
Open the device's control panel and tap the gear icon.
{% endstep %}

{% step %}
In the device settings page, scroll to the bottom and tap “Turn On Pairing Mode.”
{% endstep %}

{% step %}
Copy the code and follow the pairing guide on the CUBE OS page.

![](https://appcms.coolkit.cn/wp-content/uploads/2024/06/image2.png)&#x20;
{% endstep %}
{% endstepper %}

#### **2.1.2 For bridged devices like&#x20;*****Philips Hue lights with Hue Bridge*****:**

{% stepper %}
{% step %}
Open the Home app and find the tile of the device you want to share.
{% endstep %}

{% step %}
Open the device's control panel and tap the gear icon.
{% endstep %}

{% step %}
In the **device settings** page, **scroll down** to “**Bridge**” and tap it.
{% endstep %}

{% step %}
This will lead you to the settings page of the bridge that connects your devices, scroll to the bottom and tap “Turn On Pairing Mode.”

![](https://appcms.coolkit.cn/wp-content/uploads/2024/06/Apple-%E2%80%93-Bridge-2-1.png)&#x20;
{% endstep %}

{% step %}
Copy the code and follow the pairing guide on the CUBE OS page.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Please Note: This will bring all supported devices attached to the bridge to your CUBE OS.
{% endhint %}

### **2.2 Google Home**

#### **2.2.1 Native Matter Devices (e.g. Matter Wi-Fi Plugs)**

{% stepper %}
{% step %}
Open the Google Home app.
{% endstep %}

{% step %}
Select the device you want to add to eWeLink.
{% endstep %}

{% step %}
Tap the gear icon for the settings page.
{% endstep %}

{% step %}
Tap “Linked Matter apps & services.”
{% endstep %}

{% step %}
Wait for it to load and press “Link Matter apps & services.”
{% endstep %}

{% step %}
Copy the code and follow the pairing guide in the eWeLink app.
{% endstep %}
{% endstepper %}

<figure><img src="https://appcms.coolkit.cn/wp-content/uploads/2024/06/image6.png" alt=""><figcaption></figcaption></figure>

#### **2.2.2 For bridged devices like&#x20;*****Philips Hue lights with Hue Bridge*****:**

For bridged devices, the steps are identical to those in the above section.

### **2.3 Alexa & SmartThings**

Alexa and SmartThings provide official guides to follow:

[How to Set Up an Alexa Connected Matter Device with Another Assistant](https://www.amazon.com/gp/help/customer/display.html?nodeId=T6iLWTtbZygaBJnQhg)&#x20;

[SmartThings x Matter Integration](https://support.smartthings.com/hc/en-us/articles/11219700390804-SmartThings-x-Matter-Integration) &#x20;

<br>
