Matter
The Matter page lets GEM act as both a Matter bridge (exposing GEM zones to Apple Home, Google Home, and other Matter ecosystems) and a Matter controller (commissioning and controlling external Matter devices from GEM).
Tabs
The page has two tabs: Bridge and Controller.
Bridge Tab
The Bridge tab configures GEM as a Matter bridge, making selected GEM zones available to Matter-compatible smart home platforms.
Bridge Status
A status grid at the top shows the current state of the bridge:
| Field | Description |
|---|---|
| Matter Bridge | Running (green), Enabled but not started (yellow), or Disabled (gray). |
| Paired | Whether the bridge is paired with a Matter controller/app: Yes (green) or No (gray). |
| Exposed Zones | The number of GEM zones currently exposed through the bridge. |
| Port | The network port the bridge is listening on. |
Configuration
| Field | Description |
|---|---|
| Enable Matter Bridge | Toggle switch to enable or disable the bridge. When enabled, the bridge starts automatically with GEM. |
| Port | Network port for the Matter bridge. Default: 5540. |
| Bridge Name | The name that appears in Home apps when discovering the bridge (e.g., "GEM Bridge"). |
Click Save & Apply to save the configuration and restart the bridge.
Pairing
The pairing section changes based on the bridge state:
When the bridge is running but not yet paired:
- A QR code is displayed that you can scan with your Home app (Apple Home, Google Home, etc.).
- A manual pairing code is shown alongside the QR code for apps that support manual entry.
- Click Copy Code to copy the manual pairing code to your clipboard.
When the bridge is running and paired:
- A "Paired" badge is shown with a confirmation message.
- A Reset Bridge button is available. Resetting clears all pairing data and restarts the bridge. You will need to remove the old bridge from your Home app and re-pair.
After resetting the bridge, you must remove the old bridge entry from your Home app before re-pairing. The Home app may not automatically detect the change.
Zone Selection
The zone selection area lets you choose which GEM zones to expose through the Matter bridge. It has two panels:
Subsystem Sidebar (left):
- Lists all subsystems that have compatible zones, with the count of selected/total zones for each.
- Click a subsystem name to filter the zone list. Click "All Subsystems" to show all zones.
Zone Panel (right):
- Search field to filter zones by name.
- Select All and Deselect All buttons that apply to the currently filtered view.
- A checkbox list of zones. Each entry shows the zone label and its Matter device type (e.g., Light, Thermostat, Door Lock, Window Covering, Contact Sensor, Fan, Power Outlet).
| Button | Description |
|---|---|
| Save Zone Selection | Saves the selected zones without restarting the bridge. |
| Save & Apply | Saves the selected zones and restarts the bridge to apply changes. |
Compatible subsystems include: Lights, Climate, Doors/Locks, Shades, Gates/Garages, Fans, Power, and Security. Zones from other subsystems are not shown.
Controller Tab
The Controller tab lets GEM act as a Matter controller, commissioning external Matter devices and creating GEM zones for them automatically.
Controller Status
A status grid shows the current state:
| Field | Description |
|---|---|
| Controller | Running (green), Enabled but not started (yellow), or Disabled (gray). |
| Devices | The number of commissioned Matter devices. |
| Port | The network port the controller is using. |
Configuration
| Field | Description |
|---|---|
| Enable Controller | Toggle switch to enable or disable the controller. When enabled, it starts automatically with GEM. |
| Port | Network port for the Matter controller. Default: 5541. |
Click Save & Apply to save the configuration and restart the controller.
Commission Device
This section appears only when the controller is running. It lets you add new Matter devices to GEM.
| Field | Description |
|---|---|
| Method | How to identify the device: Pairing Code (QR code string or 11-digit manual code) or Passcode + Discriminator (enter both values separately). |
| Pairing Code | The QR code string (e.g., MT:Y3.13OTB...) or 11-digit manual pairing code. Shown when Method is "Pairing Code." |
| Passcode | The device passcode (e.g., 20202021). Shown when Method is "Passcode + Discriminator." |
| Discriminator | The device discriminator value (e.g., 3840). Shown when Method is "Passcode + Discriminator." |
Click Commission Device to pair the device. The button changes to "Commissioning..." during the process.
After successful commissioning, a result panel shows:
- The assigned Node ID.
- The Device ID.
- A list of GEM zones that were automatically created for the device, with their labels and subsystems.
Commissioned Devices
A table listing all Matter devices controlled by GEM:
| Column | Description |
|---|---|
| Device | The device label. |
| Node ID | The Matter node identifier (shown in monospace). |
| Status | Online (green) or Offline (gray). |
| Zones | The number of GEM zones associated with this device. |
Each row has a Remove button to decommission the device (removes it from GEM's Matter fabric).
If no devices are commissioned, a message directs you to use the commission form above.
Related Documentation
- Zones - Zone configuration