產品管理
頁面導讀
使用入口與推薦流程
- 進入 設備管理 → 產品管理，先確認產品分類、設備類型、傳輸協定、通訊協定和認證方式。
- 新增產品後進入產品詳情，依設備能力設定物模型、Modbus、SIP、子產品、應用設定或組態應用。
- 完成設定後發佈產品，再進入設備管理新增或匯入設備。
- 設備上線後回到產品和物模型頁面複核資料、指令、事件、規則和告警是否都能正常聯動。
一、產品管理介紹
產品是設備的集合，通常是對同類型、同型號實體設備的描述。 你可以透過本文了解 產品 相關的功能。
1、概述
產品具備批次管理相同設備的傳輸協定、通訊協定、物模型、modbus設定，相同的設備所屬同一個產品，實現設備的統一管理的能力。基於產品還可設定場景聯動、組態畫面等。
2、產品設定項
| 設定項 | 說明 |
|---|---|
| 產品名稱 | 必填，產品名，自訂 |
| 產品分類 | 必填，單選下拉選單，現在產品分類選單下設定，多個產品可以歸為一個分類， |
| 設備類型 | 必填，單選下拉選單，監控直接選擇監控設備，其餘設備類型參考閘道器與子設備文件（简体中文） |
| 通訊協定 | 必填，單選下拉選單，對設備上報資料的編解碼，必須選擇合適的，已有的協定參考協定管理選單 |
| 傳輸協定 | 必填，單選下拉選單，設備連線物聯網平台的方式，必須選擇合適的 |
| 韌體類型 | 必填，單選下拉選單，選擇合適的，參考設備OTA升級文件（简体中文） |
| 連網方式 | 可選，單選下拉選單，就是一個標籤，根據設備連網方式自行選擇 |
| 私有產品 | 開關，設定為私有後下級不能查看 |
| 設備授權 | 開關，設備授權功能，預設不啟用，產品啟用設備授權碼後，需要為設備分配授權碼，設備認證時使用 |
| 認證方式 | 必填，設備接入認證方式，單選下拉選單，可參考設備接入下不同協定設備接入的文件 |
| 定位方式 | 必填，單選下拉選單 自動定位：設備認證時平台會自動取得設備定位； 設備定位：設備透過/info/post主題主動上報經緯度位址資訊； 自訂位置：設備詳情自行設定經緯度位址資訊 |
| 產品編號 | 系統自動產生 |
| 認證帳號 | 必填，新增時系統自動產生，可自行修改 |
| 認證密碼 | 必填，新增時系統自動產生，可自行修改 |
| 認證金鑰 | 必填，新增時系統自動產生，可自行修改 |
| 產品圖片 | 可選，自行修改 |
| 備註資訊 | 非必填輸入框 |
3、產品清單
3.1、新增
點擊 "+ 新增" 按鈕，開啟新增產品視窗，點擊確定之後可以看到清單已經存在該產品了
提示
注意：產品設備類型選擇閘道器設備，通訊協定選擇ModbusRtu協定、Modbus轉Json解析協定-華普物聯、ModbusTcp協定、JSON閘道器解析協定會有一個子產品設定按鈕，選中後可直接匯入子產品，具體設定方式參考閘道器與子設備文件（简体中文）
3.2、複製
點擊 "複製" 按鈕，開啟選擇產品視窗，選擇對應的產品，點擊確定即可複製出一個完全一樣的產品出來 
3.3、匯入
點擊 "匯入" 按鈕，開啟匯入產品視窗，先下載json範本檔案，然後編輯json檔案，然後點擊上傳檔案，最後點擊確定即可匯入
3.4、顯示上級機構產品
勾選後會把上級機構的產品查詢出來，但是不支援編輯
4、產品詳情
產品詳情頁面包括基本資訊、產品模型、Modbus設定、設備授權、組態應用、應用設定等
提示
注意：除了子產品、輪詢任務、應用設定，其它功能都需要先把產品取消發佈，才可進行編輯
4.1、基本資訊
可以進行一些基本資訊的修改
4.2、產品模型
物模型是設備在雲端的描述，從屬性、功能、事件、標籤四個維度定義一個真實設備
- 匯入物模檔案：點擊後進入批次匯入視窗，先下載產品物模型匯入範本檔案，編輯好後點擊上傳檔案，最後點確定即可匯入
- 匯入通用物模型：點擊後進入匯入通用物模型視窗，選擇合適的通用物模型，最後點匯入
- 查看物模：點擊後進入物模型視窗，可以查看整個物模型的資料結構
4.2、應用設定
行動端狀態模式介面支援自訂，可在產品應用設定點擊設定，在設定介面根據自己需求自訂介面，設定好後點擊啟用
4.3、設備授權
可選功能，啟用後主要用於設備認證，需要為設備分配授權碼
4.4、SIP設定
SIP 協定設定項，對應國標 GB28181 協定（公共安全影像監控聯網系統的國家標準），主要作用是讓該產品（通常是影像設備，如攝影機）能透過 SIP 協定接入國標 GB28181 的影像監控平台，實現設備註冊、影像串流傳輸、設備控制等功能
4.5、子產品
閘道器設備類型，部分通訊協定支援設定子產品
- 新增：點擊後進入選擇產品視窗，選擇對應子產品，最後點確定進行綁定
- 設定位址：點擊後即可編輯子產品預設的子設備位址，不能重複；
4.6、Modbus設定
產品協定為Modbus相關協定的需要設定，modbus設備中閘道器自身屬性或者閘道器子設備的設定，具體設定方式參考閘道器與子設備文件（简体中文）
4.7、輪詢任務
Modbus相關協定的需要設定輪詢任務才能主動採集資料，產品Modbus設定-閘道器/子設備設定-採集方式必須勾選雲端輪詢，新增設備時設備繼承
4.8、指令下發
產品通訊協定選擇了ModbusTcp協定，設定一些指令，新增設備時設備繼承，可在設備側點擊下發
4.9、組態應用
針對產品進行組態頁面設計，該產品下的設備都能查看該組態頁面，並即時展示設備上報資料或進行指令下發
5、發佈產品
新建產品預設為未發佈狀態，參考產品詳情完成產品定義後，點擊 "發佈產品" 按鈕啟用之後可以建立對應該產品的設備
提示
注意：產品如果是未發佈狀態，設備認證時會失敗
6、多租戶
租戶隔離，上級機構能使用和編輯下級機構的產品；下級機構能查看使用但不能編輯上級機構的產品；
7、設定決策表
建立產品時最容易選錯的是設備類型、通訊協定、傳輸協定和認證方式。建議依下面表格先判斷，再建立產品。
| 情境 | 設備類型 | 傳輸協定 | 通訊協定 | 說明 |
|---|---|---|---|---|
| 普通 MQTT 感測器 | 直連設備 | MQTT | JSON 解析或自訂協定 | 最常見接入方式，適合快速上手 |
| HTTP 主動上報設備 | 直連設備 | HTTP | JSON 解析或自訂協定 | 適合低頻上報、已有 HTTP 能力的設備 |
| TCP 私有協定設備 | 直連設備 | TCP | 自訂協定 | 需要伺服端編解碼適配 |
| Modbus RTU 閘道器 | 閘道器設備 | 依現場鏈路選擇 | ModbusRtu 或閘道器協定 | 需要設定子產品、暫存器和輪詢任務 |
| Modbus TCP 設備 | 直連設備或閘道器設備 | Modbus TCP | ModbusTcp 協定 | 需要明確設備作為用戶端還是伺服端 |
| GB28181 攝影機 | 監控設備 | SIP/GB28181 | SIP/影像協定 | 需要設定 SIP 和串流媒體服務 |
| 車載定位終端 | 直連設備 | TCP/JT808 | JT808 協定 | 需要規劃終端門號和設備編號對應 |
發佈前驗收清單
發佈產品前建議逐項檢查：
| 檢查項 | 正常狀態 |
|---|---|
| 產品基礎資訊 | 產品名稱、分類、設備類型、協定、認證方式已確認 |
| 物模型 | 屬性、功能、事件識別碼唯一，資料型別正確 |
| 認證資訊 | MQTT/HTTP/TCP 帳號、密碼、金鑰已產生 |
| 設備授權 | 若啟用授權，已準備授權碼分配方式 |
| Modbus 設定 | 暫存器、從站位址、功能碼、輪詢任務已確認 |
| 子產品 | 閘道器產品已綁定需要管理的子產品 |
| SIP 設定 | 影像產品已設定 SIP 資訊和串流媒體服務 |
| 應用設定 | 行動端狀態模式或組態應用已依需求啟用 |
| 發佈狀態 | 產品最終狀態為已發佈 |
常見問題
產品發佈失敗
檢查必填欄位是否完整，物模型識別碼是否重複，協定設定是否缺失。部分設定需要先取消發佈才能修改。
設備認證失敗
優先檢查產品是否已發佈，設備端使用的產品 ID、設備編號、認證帳號、認證密碼是否與目前產品一致。
設備上報後頁面不顯示資料
檢查物模型識別碼是否與上報訊息中的 id 完全一致，資料型別是否匹配，產品是否發佈後再建立設備。
下級機構看不到產品
檢查產品是否為私有產品、機構資料權限、目前角色權限以及是否勾選顯示上級機構產品。
二次開發入口
| 類型 | 路徑或介面 | 說明 |
|---|---|---|
| Vue3 頁面 | vue3/src/views/iot/product | 產品清單、產品詳情、產品模型和應用設定 |
| Vue3 API | vue3/src/api/iot | 產品、模型、協定等介面封裝 |
| 後端介面 | /iot/product | 產品管理介面 |
| 後端介面 | /iot/model | 產品物模型介面 |
| 後端介面 | /iot/protocol | 協定管理介面 |
| 協定模組 | springboot/fastbee-protocol | 設備協定編解碼 |
| 業務模組 | springboot/fastbee-open-api | 產品相關 Controller |
| SQL 指令碼 | springboot/sql | 產品、物模型、協定相關資料表結構和升級指令碼 |
關聯文件
- 產品到設備的完整閉環（简体中文）
- 通用物模型（简体中文）
- 設備管理（简体中文）
- MQTT 協定設備接入
- 設備接入排錯清單（简体中文）