Rayrun: Casambi Matter Bridge Gateway Introduction

The Rayrun Matter Bridge MTB10 is a Casambi Ecosystem device designed to integrate Casambi lighting networks to Matter smart-home ecosystems such as : 

  • Apple Home, including Siri
  • Google Home, including Google Assistant
  • Amazon Alexa

This device is USB-C powered and enables Matter compatibility without the need for custom drivers or local cloud integrations. 



How it works


Casambi BLE Mesh Network 

  1. Lighting devices are commissioned and controlled via the Casambi App using Bluetooth. 
  2. Casambi remains the source of the network configuration (groups, scenes, profiles).


MTB10 Bridge Function 

  1. Listens to the Casambi network and mirrors appropriate lighting states to Matter. 
  2. Translates control commands from Matter controllers into Casambi actions. 


Matter Control 

  1. A Matter controller (e.g., Apple Homepod) sees imported devices. 
  2. Users can control lights via the controller or voice assistants. Scenes can be created for group controls and presets.



Setup and Configuration


Hardware Setup

  1. USB Type-C Power Input
    1.  Connect to a standard USB power supply (not included) using the provided USB cable. The power source must deliver a stable 5 V / 1A DC output.
  2. Status Indicator
    1. A status indicator will light up with green, yellow or red colour. The different indicator colour displays working status as below:
      1. Green: Normal operation.
      2. Yellow: Not connected to Matter.
      3. Red: Matter reset in progress.


Setup Guide

  1. Add the MTB10 to a Casambi network
    1. Use the Casambi app to add the MTB10 as a gateway device, just like any other Casambi node. Once added, it will appear in the Gateway section of your network settings.
  2. The MTB10 will automatically map all compatible Casambi devices in the network to Matter—no further action is required within Casambi.
  3. Pair with a third-party ecosystem (Matter Setup)
    1. Your smartphone is connected to a 2.4 GHz Wi-Fi network. The MTB10 is only compatible with a 2.4GHz Wi-Fi network.
    2. Set up your Matter-compatible smart speaker or hub (e.g., HomePod, Nest Hub, or Echo) with your smart phone on the same 2.4GHz wifi network to act as a Matter controller.
    3. Open your smart home app (e.g., Apple’s Home, Google Home, or Amazon Alexa), select “Add Accessory,” and scan the QR code on the MTB10’s label.
    4. For optimal performance, install the MTB10 in a location with strong Wi-Fi and Casambi signal coverage.
  4. Complete integration
    1. Once the smart home app is opened, the MTB10 will begin mapping Casambi devices into the new ecosystem.
    2. You will observe the luminaires and sensors populate the main devices page of your smart home app. 
      1. The time taken for the import process is proportionate to the number of nodes of the Casambi network.
    3. Proceed to identify and name your devices accordingly based on the instructions given on your smart home app.


* Please note:

  • Device names, groups, and scenes defined in Casambi are not transferred. You’ll need to reassign names and room locations on the smart home platform. Scenes where desired will need to be programmed on the smart home app. 
  • Automations and scenes must be recreated in the target ecosystem. While Casambi and Matter automations can run in parallel, conflicting commands should be avoided. 
  • Casambi network pairing for the MTB10 persists after a Matter reset. To fully remove the network, please unpair the MTB10 from the Casambi app.



Limitations and Known Behaviours


The following limitations and device behaviours are important when planning and commissioning lighting systems: 

  1. 150-Device Import Limit 
    • The bridge will import up to 150 Casambi devices per Casambi network. 
    • If more than 150 devices are present, only the first 150 discovered/imported will be exposed to Matter. 
  2. Battery-Powered Devices Not Imported 
    • Battery-powered Casambi devices (e.g., wireless sensors and switches) will NOT be imported to Matter. 
  3. Dual-Purpose Devices 
    • Devices that combine multiple functions (for example, a luminaire controller and a sensor in one unit) may be presented in Matter as two separate devices. 
    • This will be considered within the 150 devices limit of the Matter bridge.

 


Support & Documentation

 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article