設備管理

產品自動納管機制

在進行產品自動納管機制說明之前,要先確認是否擁有產品登錄管理的權限,若擁有產品登錄管理權限者,於網站上方工具列會顯示產品登錄功能按鈕;若無產品登錄管理權限者,可與中華電信數據分公司IoT大平台業務申請。 產品自動納管機制目的是將廠商生產的終端設備能有一套機制於應用商或使用者在啟用時,能自動於IoT平台取得存取金鑰權限,建立設備與感測器,並將感測數據上傳至平台。 首先於產品登錄建立一產品,步驟如下:

新增產品

IoT智慧聯網大平台帳號登入之後,可透過IoT智慧聯網大平台網站右上方專案管理頁面的【專案精靈】、【增加專案】兩種方式新增專案,並在【基本資料】的頁籤中,輸入專案名稱以及專案描述,另外在【權限資料】的頁籤中,相關的設定預設會自動產生,您就可以獲取18碼英數字組合之 Project Key,這把金鑰將在您呼叫 API 時需要代入參數之中;當然,您也可以調整它所擁有的權限,預設是 Admin (完整權限) ,以下為流程操作圖,以及各個欄位之簡要說明:

1.產品登錄頁面

2.新增產品

3.當系統中有重複序號會新增失敗

4.產品登錄頁面出現新增之產品

(1)編輯樣板按鈕:進入產品預設設備與感測器頁面

(2)編輯產品按鈕:可修改產品名稱、產品描述、圖像、類型

(3)刪除產品按鈕

(4)點選產品名稱進入產品流水號登錄頁面

5.產品預設設備與感測器頁面

6.新增設備

7.可新增設備之擴充屬性

8.新增之設備出現在產品預設設備與感測器頁面

9.新增感測器

10.新增之感測器出現在產品預設設備與感測器頁面

11.產品流水號登錄頁面

接者講輸入產品序號 > 登入產品序號後可以獲得驗證代碼,同時會產一個QRCode方便使用者納管掃描使用

12.序號.csv

13.批次匯入產品序號

14.批次匯入產品序號訊息確認

15.批次匯入產品序號後產品流水號登錄頁面

16.新增產品序號

17.新增產品序號訊息確認

18.新增產品序號後產品流水號登錄頁面

19.條碼輸出頁面

設備納管方式

目前設備納管僅提供透過API納管,以下提供使用畫面,API參數設定請詳見API文件
新增設備(平台納管產品)API
在您新增專案成功後,可於專案管理的頁面中點擊「專案名稱」,即可進入到下一層的裝置管理頁面, 此時就能著手於新增裝置,在新增時所必填的資訊為裝置名稱,其它皆為彈性填寫之欄位, 其中Key / Value的設計,讓裝置可以自行增加想要的屬性;而裝置金鑰(Device Key)則是在您呼叫API時所需填入的參數,流程以及各個欄位詳細說明如下:

1.使用新增設備(平台納管產品)API

2.API Response

3.設備管理頁面

要求設備主動於平台建立組態資料API

1.要求設備主動於平台建立組態資料API

2.設備管理頁面

要求已建立組態資料之設備變更其所屬的設備編號API

1.要求已建立組態資料之設備變更其所屬的設備編號API

IoT APP 設備納管

1.IoT 應用服務APP請至中華電信IoT大平台【開發者中心】→【相關下載】→【行動裝置APP】

(1)APP提供QR Code掃描服務,透過掃描產品QR Code進行設備納管

(2)已完成納管之設備可以於我的設備中檢視

(3)APP允許檢視設備與感測器資訊

(4)APP允許設備感測器(例如:開關燈泡)

2.IoT APP 設備納管的使用情境

設備納管資訊

目前設備納管僅提供透過API納管,以下提供使用畫面,API參數設定請詳見API文件
取得專案底下所有納管產品設備資訊

1.取得專案底下所有納管產品設備資訊API

取得專案底下指定納管產品設備流水號的設備資訊

1.取得專案底下指定納管產品設備流水號的設備資訊API

MQTT訂閱裝置組態設定異動通知
允許實體裝置(例如 Gateway )訂閱裝置組態設定異動通知。當用戶透過自動化裝置納管流程 Registry RESTful API時,實體裝置將會收到裝置組態資訊(例如存取協定的金鑰或裝置編號)。

1.MQTT連線設定

2.未建立產品樣板

只登入序號的產品設備在經過設備納管流程,終端設備會獲取納管專案的專案金鑰,可使用這把金鑰呼叫平台建立設備API與建立感測器API後上傳數據。

(1)MQTT訂閱產品代碼和流水號

(2)要求設備主動於平台建立組態資料API

(3)MQTT收到專案金鑰

3.已建立產品樣板

如果產品有建立樣版,則在經過納管流程,平台會依據樣版建立專案設備,並透過MQTT通知終端設備所給予的設備編號與設備金鑰資訊,並可用來上傳感測數據。

(1)MQTT訂閱產品代碼和流水號

(2)要求已建立組態資料之設備變更其所屬的設備編號API

(3)MQTT收到Device ID和Device Key