後端功能 #11091
進行中
Omni IoT Server
概述
🌐 Omni IoT Server 系統簡介¶
Omni IoT Server 是一款為系統整合商與智慧應用開發者打造的 通訊整合型 IoT 平台。
它提供 MQTT Broker 與 RESTful API 雙通道架構,讓開發者與設備能以最簡單的方式交換資料,而不必深入了解各種通訊協議(如 Modbus、OPC UA、CoAP、BLE、TCP Socket 等)。
Omni Connect IoT Server
「Omni」意指「全方位」,「Connect」代表「連結、整合」。
名稱寓意:讓不同設備、不同通訊協議,都能透過一個統一平台「全方位連結」。
系統架構¶
🚀 核心特點¶
1️⃣ 雙通道架構:MQTT + API¶
MQTT 通訊:支援設備即時上報感測資料與狀態回傳。
API 通訊:提供標準化的 RESTful 介面,系統整合商可透過 API 快速串接資料、控制設備。
2️⃣ 協議屏蔽與統一格式¶
不論設備底層使用何種通訊協議,資料進入 Omni 後皆轉為統一的 JSON 結構。
整合商無需理解設備協議細節(例如 Modbus 位址、RS485 封包),即可直接透過標準 API 或 MQTT Topic 取得資料。
3️⃣ 高擴充性與彈性部署¶
支援 Docker / 雲端 / 本地部署。
可根據專案規模動態擴充節點與設備數量。
4️⃣ 安全與授權¶
MQTT over TLS、API Token 驗證。
支援 JWT 授權機制。
5️⃣ 開發者友善¶
提供 Swagger / OpenAPI 文件。
🧩 典型應用場景¶
| 應用領域 | 範例說明 |
|---|---|
| 智慧工廠 | 整合 PLC、生產機台感測資料,統一上報至雲端監控系統 |
| 智慧建築 | 整合空調、照明、能源管理系統,提供 API 給管理平台 |
| 環境監測 | 集中收集各廠區感測器(PM2.5、溫濕度、水質)數據 |
| 智慧城市 | 整合交通號誌、路燈控制系統,實現資料可視化與遠端控制 |
是由 Sam Wang 於 29 天 前更新
電表 (E1401 - E1405)¶
點數共計 915 點(183 * 5)
MDC-711 (收集電表設置)¶
| No | 收集器位址 MDC-711 |
電表位址 (SMD250-8) |
|---|---|---|
| 1 | 1~344 | 1~344 |
| 2 | 345 | 505(頻率) |
單一設備如下¶
裝置型號: E1401
說明: 8迴路多功能集合式電表點位配置整理
單一設備點數: 共計 183點
1. 系統全域參數 (System Global)¶
點數: 共計 7 點
| 參數代碼 (Key) | 參數名稱 | 單位 | 換算公式 (Scale) | 備註 |
|---|---|---|---|---|
01_Vol_A |
A相電壓 | V | Value / 10 |
|
01_Vol_B |
B相電壓 | V | Value / 10 |
|
01_Vol_C |
C相電壓 | V | Value / 10 |
|
01_Vol_AB |
AB線電壓 | V | Value / 10 |
|
01_Vol_BC |
BC線電壓 | V | Value / 10 |
|
01_Vol_CA |
CA線電壓 | V | Value / 10 |
|
07_Freq |
頻率 | Hz | Value / 10 |
2. 迴路分相數值 (Per-Channel Phase Data)¶
說明:
-
x代表迴路編號:1 ~ 8 (例如 Ch1, Ch2...Ch8) -
y代表相別:A, B, C
點數: 共計 120 點
| 參數代碼格式 | 參數名稱 | 單位 | 換算公式 (Scale) | 小數位 |
|---|---|---|---|---|
02_Chx_Amp_y |
各相電流 (Amp) | A | Value / 1000 |
1 |
03_Chx_Watt_y |
各相功率 (Watt) | kW | Value / 1000 |
1 |
04_Chx_kWh_y |
各相有效電度 (kWh) | kWh | Value / 100 |
2 |
05_Chx_kVarh_y |
各相虛功電度 (kVarh) | kVArh | Value / 100 |
2 |
06_Chx_PF_y |
各相功率因數 (PF) | PF | Value / 1000 |
1 |
注意: 電度類 (
kWh,kVarh) 的除數為 100,其餘瞬時數值多為 1000。
3. 迴路總和與平均 (Per-Channel Totals & Averages)¶
說明:
-
x代表迴路編號:1 ~ 8
點數: 共計 56 點
| 參數代碼格式 | 參數名稱 | 單位 | 換算公式 (Scale) | 小數位 |
|---|---|---|---|---|
07_Chx_Amp_Avg |
平均電流 | A | Value / 1000 |
1 |
07_Chx_Watt_Tot |
功率總和 (Total Watt) | kW | Value / 1000 |
1 |
07_Chx_kVar_Tot |
虛功總和 (Total Var) | kVAr | Value / 1000 |
1 |
07_Chx_kVA_Tot |
視在功率 (Total VA) | kVA | Value / 1000 |
1 |
07_Chx_PF_Avg |
平均功率因數 | PF | Value / 1000 |
1 |
07_Chx_kWh_Tot |
有效電度總和 (Total kWh) | kWh | Value / 100 |
1 |
07_Chx_kVarh_Tot |
虛功電度總和 (Total kVarh) | kVArh | Value / 100 |
1 |
是由 Sam Wang 於 28 天 前更新
空氣品質偵測器 (MODBUS ID: 6)¶
點數共計 6 點
MDC-711 (收集電表設置)¶
| No | 收集器位址 MDC-711 |
空氣品質偵測器 (MIC 98990) |
|---|---|---|
| 1 | 1~7 | 1~7 |
裝置名稱: 空氣品質偵測器
ID: 6
說明: 環境感測數值配置表
監測點位列表 (Sensor Data Points)¶
| 參數代碼 (Key) | 參數名稱 | 單位 | 換算公式 (Scale) | 小數位 | 備註 |
|---|---|---|---|---|---|
01_Temp |
溫度 | ℃ | Value / 10 |
1 | |
01_RH |
濕度 | % | Value / 10 |
1 | |
01_CO2 |
CO2 二氧化碳 | ppm | Value / 10 |
1 | |
01_PM10 |
PM10 懸浮微粒 | μg/m³ | Value / 10 |
1 | |
01_HCHO |
甲醛 | ppm | Value / 100 |
1 | 注意換算比例不同 |
01_PM2.5 |
PM2.5 細懸浮微粒 | μg/m³ | Value / 10 |
1 |
💡 開發提示¶
- 甲醛 (HCHO) 的數值換算除數為 100 (例如讀值 15 代表 0.15 ppm),其餘參數皆為除以 10。
-
單位符號: PM2.5 與 PM10 的單位為
μg/m³(微克/立方公尺)。
是由 Sam Wang 於 24 天 前更新
門禁 (Soyal 701Server)¶
點數共計 104 點(8 * 13)
使用兩個連線,分別為14F、15F 連接 701Server。
輪循設置如下,屆時觀察調整:
- 14F設備輪循: 200ms
- 15F設備輪循: 300ms
對應表¶
| No | 設備名稱 | MODBUS ID | Omni Module ID |
|---|---|---|---|
| 1 | 門禁_14F-001 | 1 | MODBUS 7 |
| 2 | 門禁_14F-002 | 2 | MODBUS 7 |
| 3 | 門禁_14F-003 | 3 | MODBUS 7 |
| 4 | 門禁_14F-004 | 4 | MODBUS 7 |
| 5 | 門禁_14F-005 | 5 | MODBUS 7 |
| 6 | 門禁_14F-006 | 6 | MODBUS 7 |
| 7 | 門禁_14F-007 | 7 | MODBUS 7 |
| 8 | 門禁_14F-008 | 8 | MODBUS 7 |
| 9 | 門禁_15F-001 | 9 | MODBUS 8 |
| 10 | 門禁_15F-002 | 10 | MODBUS 8 |
| 11 | 門禁_15F-003 | 11 | MODBUS 8 |
| 12 | 門禁_15F-004 | 12 | MODBUS 8 |
| 13 | 門禁_15F-005 | 13 | MODBUS 8 |
每台控制器功能¶
以下依據文件,實際功能是否支援待確認。
| ModbusAddress | 功能 | 備註 |
|---|---|---|
| 256 | 門磁狀態 (R/W) Door Sensor | Open:1Close:0 |
| 257 | 警戒狀態 (R/W) Arm Status | |
| 258 | 開門按鈕狀態 Egress | Close:1Open:0 |
| 259 | 強迫開門警報狀態 Alarm Status(Force / Open tool long) | |
| 260 | 開門逾時開門警報狀態 Door Open too long | |
| 261 | 強迫開門觸發警報狀態 Force Open Alarm | |
| 262 | 求援輸出警報狀態 Duress Alarm | |
| 271 | On Line / Off Line |