MQTT Thing EX 原始碼 請我喝珍奶
繁體中文

你的 MQTT 裝置，
直接進「家庭」App。

一個 Homebridge 外掛，把 MQTT 主題變成 HomeKit 配件：燈、感應器、門鎖、恆溫器等等。它是 homebridge-mqttthing 持續維護的後繼版本，現有設定不用改就能用。

在 Homebridge 安裝 在 GitHub 查看

免費、開放原始碼。支援 Homebridge 1.8 以上，包括 2.x。

客廳檯燈
MQTT 訊息

    試試看：分別開啟和關閉發布佇列，再拖動亮度滑桿。

    直接換過來，不必從頭再來

    從 homebridge-mqttthing 轉過來嗎？config.json 完全不用動。配件區塊照樣寫 "accessory": "mqttthing"，codec 檔案和 apply 運算式也都照常運作。

    1. 移除 homebridge-mqttthing

      兩個外掛都使用 mqttthing 這個名稱，同時只能安裝其中一個。

    2. 安裝 MQTT Thing EX

      從 Homebridge UI 安裝，或使用 npm。

    3. 重新啟動 Homebridge 一次

      一次做完，只重新啟動一次。配件的身分不變，房間、場景和自動化都會保留。

    不需要重新配對。Homebridge 是以配件名稱來辨識配件，而不是外掛，名稱沒變，配件就還是同一個。

    config.json
    {
  "accessory": "mqttthing",
  "type": "lightbulb",
  "name": "Living Room Lamp",
  "url": "mqtt://broker.local:1883",
  "topics": {
    "setOn": "living/lamp/setOn",
    "getOn": "living/lamp/getOn",
    "setBrightness": "living/lamp/setBrightness",
    "getBrightness": "living/lamp/getBrightness"
  }
}

    每個 broker 一條連線，而不是每個裝置一條

    原本的外掛會替每個配件各開一條 MQTT 連線。選用的平台模式把所有裝置放進同一個區塊，共用一條連線：同一個 broker 上的二十四盞燈，只要一條連線，而不是二十四條。

    配件模式

    12 個裝置，12 條連線

    MQTT

    平台模式

    12 個裝置，1 條連線

    MQTT

    • 放心改名

      每個裝置都有固定的 id，名稱只是標籤，想改就改。

    • 設定出錯也不會弄丟配置

      設定有誤的裝置，會在 HomeKit 中保留原本的位置，房間和自動化都在，等你修好。錯誤會在啟動時寫進日誌。

    • 準備好再搬

      設定頁面會替你把配件搬到平台模式，並保留它們在 HomeKit 中的身分。配件模式也會持續完整支援。

    你會得到什麼

    homebridge-mqttthing 能做的都在，用 TypeScript 為 Homebridge 2 重新打造，並修好長久以來的問題。

    • 為大量裝置設計的設定頁面

      可搜尋的裝置清單、懂得每種類型有哪些主題的編輯器、可以安全編輯的 apply 函式、連線測試，以及即時主題探測。

    • 對小型裝置更溫和

      選用的發布佇列會控制訊息節奏，每個主題只保留最新的值，場景切換或拖動滑桿時，不會把低功耗裝置淹沒。

    • 訊息格式隨你

      codec 檔案、apply 運算式和 JSONPath（topic$.path）都照常運作，格式特殊的裝置也不必另外寫橋接程式。

    • Eve App 歷史紀錄

      溫度、濕度、氣壓、用電量等數據會記錄下來，顯示在 Eve App 的歷史圖表中。

    • 修好上游的問題

      啟動時多送的顏色訊息、自適應照明把燈打開、萬用字元訂閱、空訊息造成當機等等。

    • 為 Homebridge 2 準備好了

      採用新版 HomeKit API 與 ES 模組。可在 Homebridge 1.8 以上與 2.x 執行，npm audit 零弱點。

    HomeKit 有的，幾乎都能接

    37 種配件類型，從單一開關，到把多個服務組合在一起的自訂配件。

    燈光
    燈泡，支援亮度、彩色、白光與色溫，以及自適應照明
    開關與插座
    開關插座無狀態可程式化開關
    感應器
    動作有人偵測光線溫度濕度氣壓氣象站接觸煙霧漏水空氣品質二氧化碳一氧化碳
    空調
    恆溫器冷暖氣機除濕機風扇風扇 v2空氣清淨機
    安全與門禁
    保全系統門鈴車庫門門鎖窗簾窗戶門
    用水
    閥門灑水系統
    影音與其他
    電視麥克風揚聲器電池自訂：一個配件包含多個服務

    每種類型的主題與選項都列在說明文件中。 所有配件類型（英文）

    幾分鐘就能設定好

    1. 安裝外掛

      在 Homebridge UI 開啟外掛頁面，搜尋 MQTT Thing EX 並安裝。

    2. 加入裝置

      開啟外掛設定，選擇新增，挑選裝置類型，填入 broker 和主題，當場就能測試連線。

    3. 重新啟動 Homebridge

      裝置會出現在「家庭」App 中，可以分配房間、加入場景，也能用 Siri 控制。

    需要 Homebridge 1.8 以上（支援 2.x）與 Node.js 18.17 以上。 完整設定說明（英文）

    讓它維持免費

    這個外掛沒有廣告，也沒有付費版。如果它讓你的裝置順利接上 Apple「家庭」，一杯珍奶或一點贊助，能幫我持續跟上 Homebridge 的新版本，也更快處理大家回報的問題。

    請我喝珍奶 用 PayPal 贊助

    珍奶贊助直接刷卡，不需要 PayPal 帳號。