matterbridge-shelly 的安装和配置教程

项目基础介绍

matterbridge-shelly 是一个开源项目，它允许用户将 Shelly Gen 1、Gen 2、Gen 3、Gen 4 和 BLU 设备接入 Matter 协议。通过该插件，用户可以轻松地将 Shelly 设备集成到支持 Matter 的智能家居系统中，实现本地控制，无需依赖云端或 MQTT。

主要编程语言：JavaScript

项目使用的关键技术和框架

• Matter 协议：用于设备发现和控制的智能家居通信协议。
• mDNS (多播 DNS)：用于在本地网络中自动发现 Shelly 设备。
• WebSocket：用于与 Shelly Gen 2 和 Gen 3 设备进行通信。
• CoIoT (CoAP over IoT)：用于与 Shelly Gen 1 设备进行通信。

项目安装和配置准备工作

在开始安装和配置之前，请确保以下准备工作已经完成：

1. 确保您的系统中已经安装了 Node.js。
2. 准备一台可以运行 Matterbridge 的计算机或服务器。
3. 确保您的 Shelly 设备已接入网络，并且能够通过其网页界面进行配置。

详细安装步骤

步骤 1：安装 Matterbridge

首先，您需要在您的系统中全局安装 Matterbridge。打开命令行工具，执行以下命令：

npm install -g matterbridge --omit=dev

如果您使用的是 Linux 系统，可能需要添加 sudo 来获取必要的权限：

sudo npm install -g matterbridge --omit=dev

步骤 2：配置 Matterbridge

安装完成后，您需要配置 Matterbridge。创建一个新的配置文件（例如 matterbridge.yml），并在其中添加以下内容：

config:
  loglevel: debug
  server:
    protocol: tcp
    address: 0.0.0.0
    port: 8080

bridges:
  - name: "shelly"
    protocol: shelly
    server: "localhost:8080"
    enableMdnsDiscover: true
    enableStorageDiscover: true
    devices: []

根据您的网络环境和需求，您可能需要调整上述配置。

步骤 3：安装 matterbridge-shelly 插件

在 Matterbridge 的前端界面中，选择 matterbridge-shelly 插件并点击安装。如果您是通过 Docker 使用 Matterbridge，插件会自动加载。

步骤 4：配置 Shelly 设备

确保您的 Shelly 设备已正确配置，包括：

• 对于 Shelly Gen 1 设备，确保 CoIoT 服务已启用，并且 CoIoT 对等设置为多播。
• 对于 Shelly Gen 2 和 Gen 3 电池供电设备，确保已启用出站 WebSocket，并正确配置服务器地址。
• 对于 Shelly BLU 设备，确保您已选择一个支持 BLE 组件的设备作为 BLE 网关，并在网关设备上启用了蓝牙和蓝牙网关功能。

步骤 5：启动 Matterbridge

配置完成后，启动 Matterbridge。在命令行中执行以下命令：

matterbridge

Matterbridge 将开始运行，并自动发现网络中的 Shelly 设备。

步骤 6：验证设备状态

在 Matterbridge 的前端界面中，查看设备列表以确认 Shelly 设备是否已成功添加和识别。

以上就是 matterbridge-shelly 的安装和配置教程。请按照以上步骤操作，您应该能够成功将 Shelly 设备集成到您的智能家居系统中。