03 / Make existing devices legible

Matter Bridge

A small bridge that exposes an existing sensor or actuator through a consistent Matter model.

DifficultyAdvanced
TimeSeveral focused sessions
Boards1 recommended

What you’ll build

A bridge prototype with explicit device mapping, commissioning, and recoverable local state.

01

Architecture

Three parts.
One working loop.

01

Adapt

A driver normalizes the legacy device state.

02

Model

Matter endpoints expose a minimal, correct cluster set.

03

Sync

Changes reconcile in both directions without feedback loops.

02

Build stack

Hardware

  • ESP32-S31 board
  • Device to bridge
  • Interface transceiver if required
  • Commissioning controller

Software

  • ESP-IDF
  • ESP-Matter
  • Thread
  • NVS
  • Device-specific driver

Capabilities

  • 802.15.4
  • Wi-Fi
  • Secure storage
  • Stable power
  • Debug interface

Constraints

  • Use the smallest valid Matter model
  • Handle state reconciliation
  • Do not log credentials or fabric data

Recommended boards

Compare boards

03 / Build with AI

Give Codex
a better brief.

Choose a target board and copy a prompt grounded in the project’s hardware, constraints, and architecture.

Includes the goal, hardware capabilities, stack, constraints, architecture, and a safe first milestone.