連接 Milesight 感應器

在 Offision 新增閘道,再把四個網址和一個權杖填進閘道自己的網頁主控台——大約 十五分鐘,加上等第一台感應器回報的時間。

更新於 2026年9月4日

Offision 從來不會去找閘道——是我們告訴閘道把數值送到哪裡。所以工作分成兩半:在 Offision 新增閘道,拿到一個網址和一個權杖,再把兩者填進閘道自己的主控台。

事先準備

  • 閘道在你網路上的位址,以及閘道自己的登入資訊
  • 閘道韌體 60.0.0.50 或更新——以及為什麼一定要
  • 每一台感應器都已加入閘道,且閘道已設定好解讀該型號。這兩件事都在 Offision 介入之前,用 Milesight 的工具完成
  • 大約十五分鐘,之後再等第一台感應器回報

1. 在 Offision 新增閘道

開啟市集,選擇 Milesight 磚。

開啟系統整合
市集裡的 Milesight 磚。

市集裡的 Milesight 磚。

選擇 新增 Milesight 閘道。第一個步驟 詳細資料 會問三件事:

欄位要填什麼
名稱這台閘道在 Offision 裡的名字,通常就是它裝在哪裡。三樓東側Gateway 1 有用得多
分支機構管理這台閘道上的感應器屬於公司的哪個部分
API 權杖閘道用來驗證的權杖。還沒有的話,建立 Milesight 權杖 會幫你建一個
第一步——這台閘道叫什麼,以及它用來驗證的權杖。

第一步——這台閘道叫什麼,以及它用來驗證的權杖。

接著進入 連線。那一步是你即將在閘道上填寫的頁面的副本,四個網址和權杖都放在可以直接複製的位置。把它開著——本文接下來講的都是那一頁。

2. 開啟閘道自己的主控台

從這裡到步驟 4 結束,都是在 Milesight 的介面裡操作,不是 Offision 的介面。

Offision 不會安裝、更新或設定這台閘道,你的 Offision 登入資訊在那裡也不管用。如果主控台要的密碼沒有人知道,該問的是當初導入這批硬體的人,不是 Offision 的技術支援。

與閘道同一個網路的瀏覽器上,輸入 http:// 加上閘道的位址。位址有三種找法:

  • 閘道只要回報過一次,Offision 的 連線 步驟就會顯示它
  • 裝置本身的標籤上有
  • 都沒有的話,管網路的同事可以從路由器的裝置清單讀出來

用閘道自己的帳號密碼登入,在選單找到 Network Server,開啟 Applications

3. 開啟 Metadata Details

開啟感應器回報的那個 application,找到 Metadata,把它打開,並在 Metadata Details 勾選:

  • devEUI
  • deviceName
  • applicationID

gatewayTimecellularIP 可以不勾——Offision 不會用到。

devEUI 是唯一不能省的一個。 它是感應器的永久序號,也是訊息裡唯一說明這筆數值來自哪一台感應器的資訊。少了它,每一台感應器看起來都一樣,Offision 會全部丟棄。

Network Server › Applications,Metadata 已開啟,三個細項都已勾選。

Network Server › Applications,Metadata 已開啟,三個細項都已勾選。

如果這一頁上根本沒有 Metadata Details 這一列,代表韌體太舊。請升級閘道,沒有其他辦法。

4. 把 Data Transmission 指向 Offision

還是在同一個 application 裡,找到 Data Transmission

欄位要填什麼
TypeHTTPS
HTTP Header → Header NameAuthorization
HTTP Header → Header Value步驟 1 拿到的權杖

接著是 URL 那幾列。一共四列,每一列各填一個不同的網址——從 Offision 的連線 步驟複製過來:

Data Type帶什麼
Uplink data所有數值。這是最關鍵的一列
Join notification感應器加入網路。設了這一列,感應器一加入就會出現在 Offision,不必等它第一次回報
ACK notification送達確認
Error notification閘道回報的問題

每個網址結尾的字不同,而那個字是唯一告訴 Offision 收到的是哪一種訊息的線索—— 訊息本身不會說。所以請一列一列分開複製,不要用手改結尾。

Offision 這邊的同一頁副本,每個值都可以直接複製。

Offision 這邊的同一頁副本,每個值都可以直接複製。

一個目的地就帶著標頭和四個網址。

一個目的地就帶著標頭和四個網址。

最後按 Save。這一頁不會自動儲存,而填好卻沒存的畫面,跟存好的畫面長得一模一樣。

5. 確認真的通了

兩端都要看,因為其中一端對了,另一端還是可能錯。

閘道這邊,目的地那一列會顯示 Forwarding Status。Offision 接受第一則訊息之後就會變成 Active。在那之前顯示 Inactive,那還不算故障——只是還沒送出任何東西。

Forwarding Status: Active——Offision 已收下上一次送出的資料。

Forwarding Status: Active——Offision 已收下上一次送出的資料。

Offision 這邊,感應器會隨著回報陸續出現在閘道自己的頁面上,名稱沿用閘道上的名稱,並帶著 序號(devEUI)。不需要手動新增任何東西。

然後就是等——而且是一台一台出現,不是一次到齊。空氣感應器幾分鐘內就會回報;空著的辦公桌上的感應器可能好幾個小時不出聲。不想等的話,把一台感應器重新開機:它會立刻重新加入,觸發 Join notification 那一列,幾秒內就能證明線路是通的。

感應器都排出來之後,替它們指定辦公桌或會議室 ——數值要能被 Offision 其他功能使用,是從那一步開始的。

出問題時

你看到的狀況常見原因
Forwarding Status 一直是 Inactive什麼都沒送達。檢查網址有沒有打錯,以及閘道連不連得上網際網路
只出現了一部分感應器其餘的還沒回報。閘道 Device 清單的 Last Seen 會告訴你每一台安靜多久了
閘道顯示 Active,Offision 卻什麼都沒有是權杖。確認標頭名稱剛好是 Authorization,而值是完整的權杖、前後都沒被截掉
閘道上沒有 Metadata Details 這一列韌體比 60.0.0.50 舊,請升級
感應器出現了,卻一直沒有數值閘道沒有在解讀那個型號,等於轉發了沒人看得懂的數值。請替那台感應器設定 payload codec——它是逐台設定,不是逐型號
名稱是一長串英數字它加入了,但還沒回報過。名稱會跟著第一筆數值一起到
同一台感應器出現兩次兩台閘道都在轉發同一台感應器,或它以另一個名稱被重建過。留下還在回報的那一個
移位之後就不再回報感應器是用自己的序號辨識的,不是用位置。換過的機器是另一台感應器,要重新指定給那張辦公桌