什么是產(chǎn)品
FastBee提供了一種漸進(jìn)式的設(shè)備接入模式，如果您只需要簡(jiǎn)單的設(shè)備數(shù)據(jù)上報(bào)和消息下發(fā)，則并不需要?jiǎng)?chuàng)建產(chǎn)品，也可以運(yùn)行良好。
而一旦您希望建立自己的物聯(lián)網(wǎng)產(chǎn)品或解決方案，并使用 FastBee 提供的高級(jí)功能，則需要?jiǎng)?chuàng)建設(shè)備類型。
產(chǎn)品不僅可以對(duì)設(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)品時(shí)，有如下幾個(gè)選項(xiàng)需要了解。
選擇產(chǎn)品分類
產(chǎn)品分類是產(chǎn)品的一個(gè)品類，如智能開關(guān)屬于一個(gè)品類，銀爾達(dá)智能開關(guān)是一個(gè)產(chǎn)品。
設(shè)備類型
表示設(shè)備通過哪種方式接入云平臺(tái)，有以下四種類型：
- 直連設(shè)備：設(shè)備自帶網(wǎng)絡(luò)模組，例如：WiFi模組、4G模組等，可直接通過互聯(lián)網(wǎng)接入云平臺(tái)。
- 網(wǎng)關(guān)子設(shè)備：設(shè)備無法直接連接物聯(lián)網(wǎng)，而需要通過網(wǎng)關(guān)來間接接入云平臺(tái)。
- 網(wǎng)關(guān)：獨(dú)立的網(wǎng)關(guān)設(shè)備，充當(dāng)網(wǎng)關(guān)子設(shè)備和云平臺(tái)的橋梁，實(shí)現(xiàn)各類協(xié)議解析和消息轉(zhuǎn)發(fā)。
- 監(jiān)控設(shè)備：視頻監(jiān)控設(shè)備，支持如?？禂z像頭，螢石云等國(guó)標(biāo)協(xié)議設(shè)備
通訊協(xié)議
指的是硬件設(shè)備的通訊報(bào)文，云平臺(tái)只關(guān)心設(shè)備與平臺(tái)交互的通訊協(xié)議。
如：4G/WIFI模組、DTU等通過485接口接入子設(shè)備，如果DTU支持協(xié)議轉(zhuǎn)換，
如Modbus轉(zhuǎn)Json，那么與云平臺(tái)交互的協(xié)議就是就是DTU定義的JSON協(xié)議
如DTU，模組是進(jìn)行透?jìng)?，則與云平臺(tái)交互的協(xié)議就是Modbus協(xié)議。
協(xié)議類型大致可分為：
通用協(xié)議
私有協(xié)議
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)行，但對(duì)于一些需要配網(wǎng)或特定網(wǎng)關(guān)來實(shí)現(xiàn)接入的設(shè)備，需要選擇正確的通信方式
MQTT認(rèn)證方式
FastBee平臺(tái)，基于MQTT協(xié)議客戶端連接平臺(tái)的認(rèn)證方式
一般使用：簡(jiǎn)單認(rèn)證 方式
客戶端認(rèn)證連接的方式可以在設(shè)備詳情-右下角認(rèn)證方式獲取
產(chǎn)品物模型
1.物模型的定義
物模型是物聯(lián)網(wǎng)平臺(tái)為產(chǎn)品定義的數(shù)據(jù)模型，用于描述產(chǎn)品的功能。
2.物模型功能
物模型是物理空間中的實(shí)體（如傳感器、網(wǎng)關(guān)、樓宇、工廠等）在云端的數(shù)字化表示。從屬性、服務(wù)和事件三個(gè)維度，分別描述了該實(shí)體是什么、能做什么、可以對(duì)外提供哪些信息。定義了物模型的這三個(gè)維度，即完成了產(chǎn)品功能的定義。
2.1 物模型的屬性
用于描述設(shè)備運(yùn)行時(shí)具體信息和狀態(tài)。例如，環(huán)境監(jiān)測(cè)設(shè)備所讀取的當(dāng)前環(huán)境溫度、智能燈開關(guān)狀態(tài)、電風(fēng)扇風(fēng)力等級(jí)等。屬性可分為讀寫和只讀兩種類型。讀寫類型支持讀取和設(shè)置屬性值，只讀類型僅支持讀取屬性值。
2.2 物模型的服務(wù)
指設(shè)備可供外部調(diào)用的指令或方法。服務(wù)調(diào)用中可設(shè)置輸入和輸出參數(shù)。輸入?yún)?shù)是服務(wù)執(zhí)行時(shí)的參數(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í)，主動(dòng)上報(bào)給云端的信息，一般包含需要被外部感知和處理的信息、告警和故障。事件中可包含多個(gè)輸出參數(shù)。例如，某項(xiàng)任務(wù)完成后的通知信息；設(shè)備發(fā)生故障時(shí)的溫度、時(shí)間信息；設(shè)備告警時(shí)的運(yùn)行狀態(tài)等。事件可以被訂閱和推送。
Modbus配置
當(dāng)設(shè)備類型的接入?yún)f(xié)議選擇 Modbus RTU 透?jìng)?/strong> 時(shí)，便可以在產(chǎn)品詳情頁(yè)中顯示 Modbus 配置，用于將設(shè)備屬性和 Modbus 寄存器進(jìn)行綁定，實(shí)現(xiàn)設(shè)備屬性和 Modbus 消息之間的自動(dòng)轉(zhuǎn)換，例如：
- 當(dāng)云平臺(tái)對(duì)設(shè)備下發(fā)一個(gè)DI DO屬性，由于這個(gè)屬性綁定了一個(gè)設(shè)備上的讀寫類 IO 寄存器，那么實(shí)際下發(fā)到設(shè)備的消息，是一個(gè) Modbus 寫入寄存器的消息報(bào)文。
- 當(dāng)云平臺(tái)通過任務(wù)向設(shè)備下發(fā) Modbus 查詢消息后，設(shè)備立即回應(yīng) Modbus 響應(yīng)消息，這時(shí)候云平臺(tái)通過配置好的 Modbus 寄存器，將自動(dòng)解析 Modbus 消息，生成相應(yīng)的屬性值。
1.配置默認(rèn)屬性
包含：
- 設(shè)備狀態(tài)判斷：設(shè)備數(shù)據(jù)/網(wǎng)關(guān)
- 采集方式：云端輪訓(xùn)/邊緣采集
- 默認(rèn)子設(shè)備地址
2.IO寄存器
IO 寄存器包括線圈、離散寄存器，可以和開關(guān)量屬性綁定
- 屬性：即是產(chǎn)品的物模型
- 從機(jī)地址：該產(chǎn)品的子設(shè)備從機(jī)地址
- 寄存器地址：modbus寄存器地址值
- 是否只讀：只讀對(duì)應(yīng)功能碼02、 讀寫對(duì)應(yīng)功能碼01
- 位偏移量：是針對(duì)數(shù)據(jù)寄存器，存儲(chǔ)16位BIT數(shù)據(jù)，需要解析成為16個(gè)位IO的情況，例如寄存器01的值，對(duì)應(yīng)16個(gè)IO值
數(shù)據(jù)寄存器
數(shù)據(jù)寄存器包括輸入寄存器、保持寄存器，可以和數(shù)值型屬性綁定
- 屬性：即是產(chǎn)品的物模型
- 從機(jī)地址：該產(chǎn)品的子設(shè)備從機(jī)地址
- 寄存器地址：modbus寄存器地址值
- 是否只讀：只讀對(duì)應(yīng)功能碼04、 讀寫對(duì)應(yīng)功能碼03
- 數(shù)據(jù)類型：參考下圖：數(shù)據(jù)肌醇奇遇數(shù)據(jù)類型關(guān)系
- 讀取個(gè)數(shù)：該物模型對(duì)應(yīng)值，讀取寄存器的個(gè)數(shù)。如該數(shù)值需要轉(zhuǎn)32位浮點(diǎn)數(shù)，則需要讀取兩位寄存器值，2個(gè)字節(jié)
數(shù)值寄存器數(shù)據(jù)類型
FastBee對(duì) Modbus 數(shù)值寄存器進(jìn)行消息生成和自動(dòng)解析時(shí)，支持以下數(shù)據(jù)類型：
數(shù)據(jù)類型 寄存器個(gè)數(shù) 字節(jié)數(shù) 位數(shù) 支持字節(jié)序 16 位整數(shù) 1 2 16 AB/BA 16 位無符號(hào)整數(shù) 1 2 16 AB/BA 32 位整數(shù) 2 4 32 ABCD/CDAB 32 位無符號(hào)整數(shù) 2 4 32 ABCD/CDAB 32 位浮點(diǎn)數(shù) 2 4 32 ABCD/CDAB 寄存器讀寫類型
在配置寄存器時(shí)，需要為寄存器選擇準(zhǔn)確的讀寫類型，那么如何選擇呢？
- 對(duì)于 IO 寄存器，讀寫類型表示以下含義：
讀寫類型 寄存器類型 讀取功能碼 寫入功能碼 用途 只讀 離散輸入狀態(tài)寄存器 02 不支持 讀取開關(guān)輸入狀態(tài)，例如：行程開關(guān)、按鍵開關(guān)。 讀寫 線圈狀態(tài)寄存器 01 05 讀取繼電器狀態(tài)，控制繼電器通斷。 - 對(duì)于 數(shù)據(jù)寄存器，讀寫類型表示以下含義：
讀寫類型 寄存器類型 讀取功能碼 寫入功能碼 用途 只讀 輸入寄存器 04 不支持 讀取傳感器數(shù)值，例如：溫濕度、大氣壓、光照強(qiáng)度。 讀寫 保持寄存器 03 06 寫入或讀取配置數(shù)值，例如：修改溫度恒定值、本地報(bào)警閾值。 固件管理
OTA升級(jí)固件管理，下個(gè)版本補(bǔ)充