Home

BedJet Matter Bridge Wiki

Welcome to the BedJet Matter Bridge wiki.

This project runs on an ESP32 and exposes a BedJet (indirectly) as Matter devices on your LAN:

• Matter Thermostat endpoint (mode + heating/cooling setpoints + local temperature)
• Matter Fan endpoint (0–100% speed, mapped to BedJet fan steps)

Important: This bridge does not connect to the BedJet over BLE. It talks to an existing BedJetWebSchedule instance over HTTP. BedJetWebSchedule owns the BLE connection.

High-level flow

Matter controller (HomeKit/Google/etc)
        |
        v
ESP32 BedJet Matter Bridge  ----HTTP---->  BedJetWebSchedule  ----BLE----> BedJet
        ^
        |
  Poll /api/state

What you can do with it

• Pair the ESP32 bridge into your Matter ecosystem
• Use voice assistants or UI tiles to:
  • Turn BedJet on/off (via thermostat mode or fan OFF)
  • Set heat/cool setpoint (translated to BedJet target temp)
  • Set fan speed (translated to BedJet fan step)

Pages

Start here:

• Getting Started: flashing, setup portal, pairing
• Architecture: modules + data flow
• BedJetWebSchedule API: endpoints and expected fields
• Matter Behavior & Mappings: how thermostat/fan map to BedJet
• Configuration & Recovery: NVS keys, BOOT behaviors
• Status UI & Local Control: built-in HTTP status page
• Security: assumptions + segmentation guidance
• Troubleshooting: common failures and fixes
• Development: build tips + contributing
• FAQ