產(chǎn)品模塊

什么是產(chǎn)品

FastBee提供了一種漸進(jìn)式的設(shè)備接入模式，如果您只需要簡單的設(shè)備數(shù)據(jù)上報和消息下發(fā)，則并不需要創(chuàng)建產(chǎn)品，也可以運(yùn)行良好。

而一旦您希望建立自己的物聯(lián)網(wǎng)產(chǎn)品或解決方案，并使用 FastBee 提供的高級功能，則需要創(chuàng)建設(shè)備類型。

產(chǎn)品不僅可以對設(shè)備進(jìn)行功能定義和消息合法性驗(yàn)證，還可以將一系列增強(qiáng)的能力附加給綁定到設(shè)備類型的所有設(shè)備。

產(chǎn)品定義了如下內(nèi)容：

• 產(chǎn)品分類
• 設(shè)備類型
• 通訊協(xié)議
• 傳輸協(xié)議
• 聯(lián)網(wǎng)方式
• MQTT認(rèn)證方式
• 產(chǎn)品物模型
• Modbus配置
• 固件管理

創(chuàng)建產(chǎn)品

創(chuàng)建產(chǎn)品時，有如下幾個選項(xiàng)需要了解。

選擇產(chǎn)品分類

產(chǎn)品分類是產(chǎn)品的一個品類，如智能開關(guān)屬于一個品類，銀爾達(dá)智能開關(guān)是一個產(chǎn)品。

設(shè)備類型

表示設(shè)備通過哪種方式接入云平臺，有以下四種類型：

• 直連設(shè)備：設(shè)備自帶網(wǎng)絡(luò)模組，例如：WiFi模組、4G模組等，可直接通過互聯(lián)網(wǎng)接入云平臺。
• 網(wǎng)關(guān)子設(shè)備：設(shè)備無法直接連接物聯(lián)網(wǎng)，而需要通過網(wǎng)關(guān)來間接接入云平臺。
• 網(wǎng)關(guān)：獨(dú)立的網(wǎng)關(guān)設(shè)備，充當(dāng)網(wǎng)關(guān)子設(shè)備和云平臺的橋梁，實(shí)現(xiàn)各類協(xié)議解析和消息轉(zhuǎn)發(fā)。
• 監(jiān)控設(shè)備：視頻監(jiān)控設(shè)備，支持如?？禂z像頭，螢石云等國標(biāo)協(xié)議設(shè)備

通訊協(xié)議

指的是硬件設(shè)備的通訊報文，云平臺只關(guān)心設(shè)備與平臺交互的通訊協(xié)議。

如：4G/WIFI模組、DTU等通過485接口接入子設(shè)備，如果DTU支持協(xié)議轉(zhuǎn)換，

如Modbus轉(zhuǎn)Json，那么與云平臺交互的協(xié)議就是就是DTU定義的JSON協(xié)議

如DTU，模組是進(jìn)行透傳，則與云平臺交互的協(xié)議就是Modbus協(xié)議。

協(xié)議類型大致可分為：

1. 通用協(xié)議

2. 私有協(xié)議

3. DTU轉(zhuǎn)換JSON協(xié)議

傳輸協(xié)議

是指網(wǎng)絡(luò)傳輸協(xié)議

目前支持：

• MQTT
• TCP
• COAP
• GB28281
• HTTP

設(shè)備通信方式

這里的設(shè)備通信方式主要指設(shè)備連接物理層協(xié)議，例如：WiFI、2G/3G/4G/5G、BLE（低功耗藍(lán)牙）、Zigbee、LoRa、RS485、以太網(wǎng)等。

在一些情況下，選擇通信方式并不影響正常運(yùn)行，但對于一些需要配網(wǎng)或特定網(wǎng)關(guān)來實(shí)現(xiàn)接入的設(shè)備，需要選擇正確的通信方式

MQTT認(rèn)證方式

FastBee平臺，基于MQTT協(xié)議客戶端連接平臺的認(rèn)證方式

一般使用：簡單認(rèn)證 方式

客戶端認(rèn)證連接的方式可以在設(shè)備詳情-右下角認(rèn)證方式獲取

產(chǎn)品物模型

1.物模型的定義

物模型是物聯(lián)網(wǎng)平臺為產(chǎn)品定義的數(shù)據(jù)模型，用于描述產(chǎn)品的功能。

2.物模型功能

物模型是物理空間中的實(shí)體（如傳感器、網(wǎng)關(guān)、樓宇、工廠等）在云端的數(shù)字化表示。從屬性、服務(wù)和事件三個維度，分別描述了該實(shí)體是什么、能做什么、可以對外提供哪些信息。定義了物模型的這三個維度，即完成了產(chǎn)品功能的定義。

2.1 物模型的屬性

用于描述設(shè)備運(yùn)行時具體信息和狀態(tài)。例如，環(huán)境監(jiān)測設(shè)備所讀取的當(dāng)前環(huán)境溫度、智能燈開關(guān)狀態(tài)、電風(fēng)扇風(fēng)力等級等。屬性可分為讀寫和只讀兩種類型。讀寫類型支持讀取和設(shè)置屬性值，只讀類型僅支持讀取屬性值。

2.2 物模型的服務(wù)

指設(shè)備可供外部調(diào)用的指令或方法。服務(wù)調(diào)用中可設(shè)置輸入和輸出參數(shù)。輸入?yún)?shù)是服務(wù)執(zhí)行時的參數(shù)，輸出參數(shù)是服務(wù)執(zhí)行后的結(jié)果。相比于屬性，服務(wù)可通過一條指令實(shí)現(xiàn)更復(fù)雜的業(yè)務(wù)邏輯，例如執(zhí)行某項(xiàng)特定的任務(wù)。服務(wù)分為異步和同步兩種調(diào)用方式。

2.3 物模型的事件

設(shè)備運(yùn)行時，主動上報給云端的信息，一般包含需要被外部感知和處理的信息、告警和故障。事件中可包含多個輸出參數(shù)。例如，某項(xiàng)任務(wù)完成后的通知信息；設(shè)備發(fā)生故障時的溫度、時間信息；設(shè)備告警時的運(yùn)行狀態(tài)等。事件可以被訂閱和推送。

Modbus配置

當(dāng)設(shè)備類型的接入?yún)f(xié)議選擇 Modbus RTU 透傳 時，便可以在產(chǎn)品詳情頁中顯示 Modbus 配置，用于將設(shè)備屬性和 Modbus 寄存器進(jìn)行綁定，實(shí)現(xiàn)設(shè)備屬性和 Modbus 消息之間的自動轉(zhuǎn)換，例如：

• 當(dāng)云平臺對設(shè)備下發(fā)一個DI DO屬性，由于這個屬性綁定了一個設(shè)備上的讀寫類 IO 寄存器，那么實(shí)際下發(fā)到設(shè)備的消息，是一個 Modbus 寫入寄存器的消息報文。
• 當(dāng)云平臺通過任務(wù)向設(shè)備下發(fā) Modbus 查詢消息后，設(shè)備立即回應(yīng) Modbus 響應(yīng)消息，這時候云平臺通過配置好的 Modbus 寄存器，將自動解析 Modbus 消息，生成相應(yīng)的屬性值。

1.配置默認(rèn)屬性

包含：

1. 設(shè)備狀態(tài)判斷：設(shè)備數(shù)據(jù)/網(wǎng)關(guān)
2. 采集方式：云端輪訓(xùn)/邊緣采集
3. 默認(rèn)子設(shè)備地址

2.IO寄存器

IO 寄存器包括線圈、離散寄存器，可以和開關(guān)量屬性綁定

• 屬性：即是產(chǎn)品的物模型
• 從機(jī)地址：該產(chǎn)品的子設(shè)備從機(jī)地址
• 寄存器地址：modbus寄存器地址值
• 是否只讀：只讀對應(yīng)功能碼02、 讀寫對應(yīng)功能碼01
• 位偏移量：是針對數(shù)據(jù)寄存器，存儲16位BIT數(shù)據(jù)，需要解析成為16個位IO的情況，例如寄存器01的值，對應(yīng)16個IO值

3. 數(shù)據(jù)寄存器

   數(shù)據(jù)寄存器包括輸入寄存器、保持寄存器，可以和數(shù)值型屬性綁定

   • 屬性：即是產(chǎn)品的物模型
   • 從機(jī)地址：該產(chǎn)品的子設(shè)備從機(jī)地址
   • 寄存器地址：modbus寄存器地址值
   • 是否只讀：只讀對應(yīng)功能碼04、 讀寫對應(yīng)功能碼03
   • 數(shù)據(jù)類型：參考下圖：數(shù)據(jù)肌醇奇遇數(shù)據(jù)類型關(guān)系
   • 讀取個數(shù)：該物模型對應(yīng)值，讀取寄存器的個數(shù)。如該數(shù)值需要轉(zhuǎn)32位浮點(diǎn)數(shù)，則需要讀取兩位寄存器值，2個字節(jié)
   

   數(shù)值寄存器數(shù)據(jù)類型

   FastBee對 Modbus 數(shù)值寄存器進(jìn)行消息生成和自動解析時，支持以下數(shù)據(jù)類型：

   數(shù)據(jù)類型	寄存器個數(shù)	字節(jié)數(shù)	位數(shù)	支持字節(jié)序
   16 位整數(shù)	1	2	16	AB/BA
   16 位無符號整數(shù)	1	2	16	AB/BA
   32 位整數(shù)	2	4	32	ABCD/CDAB
   32 位無符號整數(shù)	2	4	32	ABCD/CDAB
   32 位浮點(diǎn)數(shù)	2	4	32	ABCD/CDAB

   寄存器讀寫類型

   在配置寄存器時，需要為寄存器選擇準(zhǔn)確的讀寫類型，那么如何選擇呢？

   • 對于 IO 寄存器，讀寫類型表示以下含義：

   讀寫類型	寄存器類型	讀取功能碼	寫入功能碼	用途
   只讀	離散輸入狀態(tài)寄存器	02	不支持	讀取開關(guān)輸入狀態(tài)，例如：行程開關(guān)、按鍵開關(guān)。
   讀寫	線圈狀態(tài)寄存器	01	05	讀取繼電器狀態(tài)，控制繼電器通斷。

   • 對于 數(shù)據(jù)寄存器，讀寫類型表示以下含義：

   讀寫類型	寄存器類型	讀取功能碼	寫入功能碼	用途
   只讀	輸入寄存器	04	不支持	讀取傳感器數(shù)值，例如：溫濕度、大氣壓、光照強(qiáng)度。
   讀寫	保持寄存器	03	06	寫入或讀取配置數(shù)值，例如：修改溫度恒定值、本地報警閾值。

   固件管理

   OTA升級固件管理，下個版本補(bǔ)充