QNAP 物聯網應用 QIoT 詳細介紹

作者：旅行中 3月 25, 2019

QNAP 物聯網應用 QIoT 詳細介紹

線上說明選單

總覽

QIoT Suite Lite 是完善實用的 IoT 私有雲平台，可幫助您在 QNAP NAS 上建置和管理 IoT 應用。

QIoT Suite Lite 的主要元件包括裝置閘道、規則引擎，以及儀表板。入門套件（包括 Arduino、Raspberry Pi 以及 Intel Edison）可搭配多個感應器使用，並透過裝置閘道將遙測資料推送至 QIoT Suite Lite。裝置閘道支援多種通訊協定，例如 MQTT、HTTP 和 CoAP。功能強大的規則引擎會處理這些資料並採取相應的動作。儀表板則讓您可於單一介面監測與控制 IoT 系統。

首頁

本頁顯示 QIoT Suite Lite 各類資訊

首頁簡介

左方區塊提供各頁面之連結。

頂端區塊提供 IoT 應用程式、IoT 裝置、IoT 裝置類型和其總數的連結。可點擊的 IoT 應用程式圖示旁邊的三角形會顯示執行數量和停止的處理數量。

下方區塊提供 QNAP NAS 的詳細狀態，包括 CPU 及記憶體用量。另也提供 NAS 所有網路介面的目前網路輸送量詳細資訊。

快速設定精靈

快速設定精靈可以幫助您快速建立 IoT 之應用服務，並推送範例程式碼、裝置組態設定、MQTTS 連線設定檔以及 SSL 憑證金鑰至您的裝置上。

步驟 1：點擊右上角的［快速設定精靈］。

步驟 2：建立新的 IoT 應用程式

此步驟是建立一個 IoT 應用程式，其中包含規則、儀表板和 IoT 裝置。 IoT 應用程式是由單一規則、單一儀表板和多個 IoT 裝置組合而成。

下方可輸入 IoT 應用程式名稱和描述。儀表板則可以輸入規則。

步驟 3：新增 IoT 裝置

此步驟是建立 IoT 裝置，也就是您的裝置來源。

點擊［新增］後，可選擇現有的 IoT 裝置或建立新的 IoT 裝置。

IoT 裝置名稱：輸入名稱。
描述：輸入描述。
IoT 裝置類型：您可以從下列選項中選擇此裝置的類別。各類別的描述如下：
- QIoT 支援：此為 QIoT Suite Lite 完全支援以及測試過的開發板/裝置。 QIoT 支援的 IoT 裝置具有預先定義的 IoT 裝置類型屬性，且會將目前 IoT 裝置適合的範例程式碼推送到裝置。（Arduino Yun:\"Python\"、Raspberry Pi:\"Node.js\"、Intel Edison:\"Node.js\"）
- 自訂：自訂開發板/裝置類型。
屬性（選填）：您可以使用 IoT 裝置屬性來說明裝置的識別與功能。每個屬性皆為金鑰/值的組合。

輸入 IoT 裝置的 IP 位址、使用者名稱和密碼，然後點擊［連線］以測試連線。連線成功後，執行下一步。

步驟 4：新增資源

IoT 裝置資源代表偵測器、週邊設備、交換器或其他需要傳輸或接收之資料通道和組態。建立資源即是建立與 QIoT Suite Lite 連線之資料通道 ID （MQTT → 主題、HTTP 及 CoAP → URL）。請將這些資源新增至裝置並依需求設定。

資源名稱：輸入資源名稱
資源描述：輸入資源描述：
資源 ID：輸入資源 ID（註：此資源 ID 將用於建立 QIoT 代理程式中的主題。裝置的此組 ID 必須唯一，相同裝置不能有重複的 ID，裝置上的範例程式碼或自行開發程式碼內必須填入相應 ID 才能傳輸資料。請參考範例程式碼內之說明以及連線資訊檔 (resourceinfo.json)。
資源類型：選擇資源類型
資料類型：選擇由資源傳送或接收的資料類型
單位：選擇資料單位
設定範圍（最大值與最小值）與預設值

步驟 5：新增 API 金鑰（選填）

可在此步驟新增第三方應用程式存取 QIoT Suite Lite API 的 API 金鑰。若要將 QIoT Suite Lite 儀表板小工具嵌入網頁，可以使用 API 金鑰。

步驟 6：按下完成後，會開始把範例程式碼、裝置組態設定、連線資訊檔和 SSL 憑證金鑰傳輸至裝置上，成功後會顯示上傳路徑，可以在這路徑找到範例程式碼和連線資訊檔以及 SSL 憑證金鑰。

使用者設定

編輯使用者設定（管理員帳號無法編輯。若要變更密碼，必須前往 QTS 控制台）。

您可以輸入名字、姓氏、電子郵件，並會顯示帳戶角色，也可以變更密碼。

API 參考文件

QIoT Suite Lite 相關的 API 文件可至右上角 API 檔案連結中查詢。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

IoT 應用程式

IoT 應用程式包含規則、儀表板和所有 IoT 裝置。 IoT 應用程式是由單一規則、單一儀表板和多個 IoT 裝置組合而成。

新增 IoT 應用程式

若要新增 IoT 應用程式，請輸入 IoT 應用程式名稱和描述，並透過儀表板輸入規則。

匯入 IoT 應用程式

您可使用［匯入］按鈕匯入先前建立的 IoT 應用程式（包含 IoT 裝置、規則和儀表板）。

匯出 IoT 應用程式

此操作會儲存 IoT 應用程式的組態設定以供備份或遷移使用。點擊要匯出的 IoT 應用程式（一次只能匯出一個），接著依序點擊［動作］>［匯出］，然後將檔案另存成新檔。

IoT 應用程式資訊

可顯示 IoT 應用程式相關資訊並編輯 IoT 應用程式名稱及描述。

停止 IoT 應用程式

此項操作會停止 IoT 應用程式。需要使用該 IoT 應用程式的服務將受到影響。

刪除 IoT 應用程式

此項操作會刪除 IoT 應用程式。

注意： IoT 應用程式下的 IoT 裝置將不會被刪除，。並可被其他 IoT 應用程式重複使用。如需刪除，可參考 IoT 裝置章節。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

儀表板

儀表板以圖形化方式呈現資訊。

如何建立儀表板

使用者可以選擇從規則引擎［QBroker］節點匯入資料。

QBroker 有兩種使用方式：從 IoT 裝置資源或從規則引擎匯入資料：

方法 1：從 IoT 裝置資源匯入資料

前往儀表板
點擊［編輯］
新增窗格
點擊並選擇小工具類型
輸入資訊。在［值］中選擇您的 IoT 裝置資源（例如 qiotsupported_）
點擊［儲存］
點擊［完成編輯］

方法 2：從規則引擎匯入資料

在規則引擎中：

前往規則引擎
新增 QBroker 節點，然後在這個節點上點擊滑鼠兩下以編輯設定
選擇［自訂主題］，然後在［主題］欄位輸入您的自定義名稱（例如：儀表板）
（注意：若有其他 IoT 應用程式使用相同名稱，它也會收到相同資料)
點擊［完成］並連線資料以輸出到此 QBroker
點擊［儲存］

在儀表板中：

前往儀表板
點擊［編輯］
新增窗格
點擊並選擇小工具類型
輸入資訊。在［值］中，選擇您的自定義名稱（例如 qiotrule_Dashboard）
點擊［儲存］
點擊［完成編輯］

編輯小工具

若要設定小工具，點選右上角［編輯］編輯小工具，結束後再點選［編輯］完成編輯。

匯出小工具

此步驟可以使用已建立的 API，將儀表板資料輸出到自訂網頁上。

步驟 1

點擊右上角的［編輯］，然後點擊紅色方塊中的圖示（如下方的螢幕擷取畫面所示）。

步驟 2

選擇 API 金鑰以產生下列程式碼。此段程式碼可內嵌到網頁。

分享儀表板

點擊

並選擇［分享公開連結］和［複製公開連結］，藉此與其他使用者分享儀表板。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

規則

我們根據 Node-RED 建立規則引擎。如需詳細資訊，請造訪 https://nodered.org/

QIoT 有四個自訂的節點: QDashboard、QBroker(in)、QBroker(out) 和 QHistoricData。

QDashboard：此節點提供 Live Data API 端點
QBroker：該項節點是接收及傳送 IoT 裝置資料
QHistoricData：此節點是取出儲存在資料庫中的最大值、最小值和平均值。

請參考節點中的資訊以瞭解使用方式。 QBroker 接收的資料值必須為 JSON 格式。例如：傳輸到 IoT 裝置的資料必須為 {"值": XXX}。請參考 QIoT Suite Lite 範例程式碼以瞭解更多使用詳情。

QNAP 自訂規則節點

QDashboard：此節點提供 Live Data API 端點。第三方應用程式或儀表板可用此 API 接收此節點所傳輸的資料。

1. 輸入節點名稱

2. 選擇資源類型

3. Live Data API（可用於外部服務存取儀表板中的資訊）

4. 選取欲匯入資源類型資料屬性（預設勾選）

5. 格式化匯入儀表板資料（維持預設）
（如果您使用預設格式資料，則待傳輸的資料必須位在 msg.payload.value）

6. 點擊［完成］以儲存設定

7. 點擊［儲存］部署節點

QBroker In：此項節點是接收 IoT 裝置資料

1. 取消選擇［使用自訂主題］

2. 選擇 IoT 裝置

3. 新增資源

4. 選擇資源

5. 點擊［完成］以儲存設定

6. 點擊［儲存］部署節點

QBroker Out：此項節點是傳送 IoT 裝置資料

1. 選擇［使用自訂主題］

2. 選擇 IoT 裝置

3. 選擇資源

4. QoS 設定

QoS 設為 0 會降低資料可靠度。

0：最多傳送一次（at most once）

1：至少傳送一次（at least once）

5. 保留設定
True： MQTT Broker 將保留此主題訊息。其後如有新的訂閱者，或者之前斷線的訂閱者重新連線，都能收到最後一則保留訊息（若使用 HTTP、HTTPS 和 CoAP 協定接收資料，則此選項必須設為 True）。

False： MQTT Broker 將不會保留此主題訊息。若有新的訂閱者，或者先前中斷連線的訂閱者重新連線，都無法接收到最後一則訊息

6. 點擊［完成］以儲存設定

7. 點擊［儲存］部署節點

QHistoricData：此節點是取出儲存在資料庫中的最大值、最小值和平均值。

1. 選擇 IoT 裝置

2. 選擇資源

3. 選擇解析度

4. 選擇間隔

5. 選擇範圍

6. 選擇 API 金鑰

7. 閱讀範例程式碼以了解如何使用範圍日期查詢

8. 點擊［完成］以儲存設定

9. 點擊［儲存］部署節點

除錯訊息

偵錯節點及頁籤顯示所有在規則裡面出現的訊息及錯誤訊息。

下列是幾個常見錯誤問題:

QBroker In 接收的資料不是 {"值": XXX} 格式

如果 QIoT 接收到的資料不是 {"值": XXX} 格式，QBroker In 將無法解析傳入資料

錯誤:

正確:

（注意：如果 QBroker Out 的傳送目的地為 QIoT 所提供的範例程式碼，則外傳資料必須以 {"值": XXX} 包裝；請參見「範例程式碼」）

當 QoS 設定為 0，規則引擎無法正確剖析資料。 QoS 設為 0 會降低資料可靠度。

QoS 層級設定：

0：最多傳送一次（at most once）

1：至少傳送一次（at least once）

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

IoT 裝置

此頁面管理 IoT 裝置。 IoT 裝置是 QIoT Suite Lite 中代表實體裝置的虛擬物件。您可以新增、修改和刪除 IoT 裝置。

IoT 裝置是連結數個週邊設備（感測器、致動器及 LED 燈等）的裝置。 IoT 裝置可使用多種網路連線（例如 Wi-Fi 和 LAN）連接 QIoT Suite Lite。 IoT 裝置可以使用 MQTT、HTTP、CoAP 傳送遙測資料到 QIoT 閘道（發佈資料到 QIoT 閘道/代理程式中的相應主題）。 IoT 裝置可訂閱數個主題，藉此接收多個指示或更新特定週邊設備的值。

在 QIoT Suite Lite中，週邊設備（感測器、致動器及 LED 燈等）稱為資源。這些資源連接至 IoT 裝置。

IoT 裝置功能

QIoT Suite Lite 將單一 IoT 裝置視為 IoT 裝置通用庫的成員。單一使用者的所有 IoT 裝置會列在［IoT 裝置］區塊中。
IoT 應用程式是 IoT 裝置、規則和儀表板的邏輯組合。如果使用者將 IoT 裝置新增到特定的 IoT 應用程式，則該 IoT 裝置與應用程式之間只會建立一條連結。 IoT 裝置不屬於 IoT 應用程式所擁有。
IoT 裝置僅可提供 IoT 應用程式參考。
單一 IoT 裝置可能是多項 IoT 應用的一部分。
如果使用者從任一處建立 IoT 裝置，則所有參照該 IoT 裝置的位置都會反映此項更新。
如果使用者從 IoT 應用中移除 IoT 裝置，則僅會移除該 IoT 裝置與應用的參照關係/連結，但該 IoT 裝置仍存在於 IoT 裝置區段的通用庫中。
下列是 IoT 裝置在 QIoT 閘道/代理程式中的表示方式：
qiot/things/user1/MyThing1
此處：
- user1 是 IoT 裝置的已登入使用者
- MyThing1 是 IoT 裝置的使用者定義名稱
- qiot/things/user1/ 是 user1 使用者的命名空間。使用者所有 IoT 裝置都將列在此命名空間下。

資源功能

由於資源與 IoT 裝置連接，因此多個 IoT 裝置無法共用同一個資源。

如果使用者刪除 IoT 裝置的資源，則所有參照該 IoT 裝置的位置都會反映此項變動
下列是資源在 QIoT 閘道/代理程式中的表示方式：
qiot/things/user1/MyThing1/TempSensor1
其中：
- user1 是 IoT 裝置的已登入使用者
- MyThing1 是 IoT 裝置的使用者定義名稱
- qiot/things/user1/ 是 user1 使用者的命名空間。使用者所有 IoT 裝置都將列在此命名空間下。
- TempSensor1 是使用者定義的資源名稱。 IoT 裝置可將資料值發佈到此主題，亦可訂閱主題，以便接收代理程式/QIoT 閘道中有關此主題的更新

新增 IoT 裝置

IoT 裝置名稱：輸入名稱

描述：輸入描述

IoT 裝置類型：您可以從下列選項中選擇此裝置的類別。各類別的描述如下：

QIoT 支援：此為 QIoT Suite Lite 完全支援以及測試過的開發板/裝置。 QIoT 支援的 IoT 裝置具有預先定義的 IoT 裝置類型屬性，且會將目前 IoT 裝置適合的範例程式碼推送到裝置。（Arduino Yun:"Python"、Raspberry Pi:"Node.js"、Inetl Edison:"Node.js"）
自訂：自訂開發板/裝置類型。
屬性（選填）：您可以使用 IoT 裝置屬性來說明裝置的識別與功能。每個屬性皆為金鑰/值的組合。

IoT 裝置資訊

IoT 裝置的各種詳細資訊會顯示於下方，包括裝置憑證、連線設定檔和 IoT 裝置連線權限管理。

詳細資料頁面會列出 IoT 裝置的詳細資料、IoT 裝置類型、IoT 屬性和裝置憑證。

IoT 裝置詳細資料會列出 IoT 裝置名稱、說明、建立時間、REST API 端點（本地）、REST API端點（myQNAPcloud）和 MQTT 主題。

裝置憑證可以管理 SSL 憑證金鑰。

裝置連線頁面會針對每個通訊協定產生連線檔案 (resourceinfo.json)。 MQTTS 將額外產生 SSL 憑證金鑰。產生的檔案（resourceinfo.json；MQTTS 需要額外的 SSL 憑證金鑰）必須上傳到裝置（若使用範例程式碼，放置在：resourceinfo.json -> res /，SSL 憑證金鑰 -> ssl /），並使用這些設定檔與 QIoT Suite Lite 通訊。

產生出三個檔案都必須下載。

點擊［下載JSON檔案］以下載連線檔 (resourceinfo.json)。

QIoT Suite Lite 在規則頁面中定義 IoT 裝置的授權層級（IoT 裝置存取相同使用者所有其他裝置和主題的權限）。使用者可以使用規則控制裝置存取權限。規則與 IoT 裝置密切相關，且隨裝置憑證自動建立。

規則建立之後，系統預設選擇控制項。受規則約束的 IoT 裝置在訂閱和發佈到使用者的所有其他裝置與主題時，具有完整的權限控制。如果使用者只授予特定裝置的部分權限，可選擇［選擇性控制］並配置所需的設定。

大量部署

大量部署可讓您透過 SSH 上傳資訊、resourceinfo.json 和命令到多個裝置（僅限支援 SSH 且使用埠號 22 的裝置）。

設定裝置連線

選擇您要設定的 IoT 裝置，然後點擊［設定］。

輸入裝置連線資訊：

您可以點擊［測試連線］以測試連線。完成後，請點擊［儲存］。

設定部署資訊

點擊［部署］按鈕：

部署程式碼到 IoT 裝置有兩種方式：

範例程式碼：使用您選擇的通訊協定，將包含 QNAP 所提供範例程式碼的檔案上傳到您指定的［目的地資料夾］。設定完畢後，請點擊［部署］。

自訂程式碼：上傳自訂的程式碼到您的裝置
［名稱］：輸入程式碼名稱
［目的地資料夾］：輸入目的地路徑
［原始碼套件］：上傳含有您程式碼的壓縮檔（不得超過 50MB）。上傳檔案到 QIoT Suite Lite 並點擊部署後，檔案會自動解壓縮且上傳到您的裝置。
點擊［部署］。

在［資源資訊與憑證］中：設定將 resourceinfo.json 檔案部署至 IoT 裝置

目的資料夾：輸入目的路徑
選擇通訊協定：選擇 MQTT、MQTTS、HTTP、HTTPS 或 COAP（如果您選擇 MQTTS，必須設定 SSH 憑證並上傳憑證到目的資料夾。您可以使用現有憑證或建立新的憑證）

點擊［部署］

在［命令執行］中：您可以從遠端執行命令以啟動您 IoT 裝置的服務功能。命令與記錄將儲存在您的主目錄路徑（例如： ~/bundle）
點擊［執行］以傳送命令到您的裝置。

大量部署

選擇多個［IoT 裝置］並點擊［部署］以同時設定所有的 IoT 裝置部署資訊（所有 IoT 裝置皆必須完成［連線設定］）

刪除 IoT 裝置

點擊要刪除的 IoT 裝置，然後點擊 [刪除]。已與 IoT 應用程式連結的 IoT 裝置無法刪除，必須先取消連結後才能刪除。

搜尋 IoT 裝置

若要搜尋 IoT 裝置，輸入關鍵字後將會列出相關的 IoT 裝置。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

IoT 裝置類型

您可以新增、修改和刪除 IoT 裝置。 IoT 裝置類型可幫助您整理自訂的 IoT 裝置類型。 QIoT Suite Lite 內預設的支援類型無法移除。

新增 IoT 裝置類型

在以下輸入 IoT 裝置類型名稱、描述和 IoT 裝置類型屬性。

刪除 IoT 裝置類型

點擊要刪除的 IoT 裝置類型，然後點擊［刪除］。

搜尋 IoT 裝置類型

輸入關鍵字後將會列出相關的 IoT 裝置類型。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

使用者

您可以新增、編輯、刪除及列出所有使用者（僅限 QIoT Suite Lite）。

每個使用者有不同的 IoT 應用程式（規則、儀表板、IoT 裝置）、IoT 裝置與 IoT 裝置類型。

預設管理者是 QTS Admin 帳號，僅有此帳號擁有權限可以新增、刪除、修改使用者。

新增使用者

新增使用者至 QIoT Suite Lite。使用者將具備不同權限（管理員權限除外）。

各個使用者 IoT 應用程式（規則、儀表板、IoT 裝置）、IoT 裝置、IoT 裝置型態皆為分開。

輸入使用者名稱、名字（選填）、姓氏（選填），以及電子郵件地址（選填）。

新使用者一開始會獲派隨機密碼。您必須在初次登入時變更此組密碼。

編輯使用者資訊

您可以重設名字和姓氏，並設定新密碼。

刪除使用者

點擊要刪除的使用者，然後點擊［刪除］。

搜尋使用者

輸入關鍵字後將會列出相關的使用者。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/

設定

設定頁面提供 QIoT API 金鑰管理、QIoT 安全設定、QIoT 伺服器網路組態以及 myQNAPcloud 服務設定

API 金鑰

您可以為新增三方應用程式的 API 金鑰以存取 QIoT API。若要將 QIoT 儀表板小工具嵌入網頁，您可使用 API 金鑰（［adminSystemKeyForDashboard］是儀表板的預設金鑰名稱且無法變更）。

管理者設定

配置 QIoT 裝置閘道設定： QIoT 伺服器網路組態與 myQNAPcloud 服務設定。

QIoT 裝置閘道設定

您可以在裝置閘道設定啟用或停止強制使用 SSL 通訊協定；如果您選擇啟用，IoT 裝置將只能透過 MQTTS 和 HTTPS 連線。

QIoT 伺服器網路組態

伺服器網路組態列出 QIoT Suite Lite 的 QNAP NAS 所有網路介面 IP。 QIoT Suite Lite 使用所有可用的 IP 位址產生 MQTTS 的裝置憑證，同時也在連線資訊檔 (resourceinfo.json) 中用這些 IP 位址作為主機位址。如果QNAP NAS 更換 IP 位址，則必須在此重新更新新的 IP 作為 QIoT 連線使用。

myQNAPcloud 服務設定

您可以使用 myQNAPcloud DDNS 位址，將裝置連至此 NAS 管理的 QIoT Suite Lite。

您可以搭配支援的通訊協定（例如 MQTT、HTTP、HTTPS、CoAP）使用由 myQNAPcloud 產生的這組網際網路位址。但如果您要採用 MQTTS，QIoT Suite Lite 伺服器必須使用裝置閘道更新這組網際網路位址，從而產生物體的裝置憑證（使用 MQTTS 的必備條件）。

備份 QIoT Suite Lite：

QIoT Suite Backup 可建立 QIoT Suite Lite 完整系統的備份副本，包含 IoT 應用程式、裝置資訊及所有已儲存的感測器資料。您可以使用 QIoT Suite 還原功能來還原完整的 QIoT 系統。

還原 QIoT Suite Lite:

從 QIoT Suite Backup 還原完整系統。請注意，您只可將 QIoT Suite Lite 還原至相同的 NAS。

系統服務

此清單列出閘道模組以及每個模組使用的對應通訊埠。您可以編輯和測試通訊埠，以免發生通訊埠衝突。

選擇您的閘道模組、點擊

編輯通訊埠，然後點擊［測試］以檢查通訊埠目前是否使用中。如果通訊埠可供使用，請點擊［套用］。 QIoT Suite Lite 可能需要重新啟動才能完成設定。

關於

顯示已安裝的 QIoT Suite Lite 版本，並讓您下載偵錯記錄以協助排解技術問題。

如需詳細資訊，請造訪 QIoT Suite Lite 部落格： https://qiot.qnap.com/blog/