> 通用框架，適用于聚英電子、OneNET、阿里云IoT、ThingsBoard、EMQX等平臺，分為平臺側配置、設備側通信參數、業務與數據參數、安全參數四大塊。

一、云平臺側提前創建獲取(必須先拿到)

1. 產品信息

- 產品ID / ProductKey

- 產品秘鑰 ProductSecret(部分平臺)

- 產品通信協議：MQTT / HTTP / Modbus網關 / CoAP

2. 設備身份憑證(設備級)

- 設備ID / DeviceName

- 設備秘鑰 DeviceSecret(阿里云/OneNET)

- 或者：ClientID、用戶名Username、密碼Password(MQTT傳統鑒權，EMQX常用)

- 部分網關支持：IMEI、SN序列號作為設備標識

3. 接入端點地址

- MQTT接入域名/IP、端口：標準MQTT 1883，MQTT TLS加密 8883

- HTTP接入地址、API路徑

- WS/WebSocket端口(網頁調試)

二、設備/網關通信參數(硬件模塊配置，如4G網關、485采集模塊)

1. 基礎網絡參數

- 網卡：DHCP自動獲取IP / 靜態IP、子網掩碼、網關、DNS

- 4G模塊：APN、撥號用戶名密碼

2. MQTT核心連接參數(最常用)

- Broker地址：云平臺域名或IP

- Broker端口：1883(明文)/8883(TLS加密，生產環境必用)

- ClientID：客戶端ID，云平臺一般要求和設備ID綁定，不可重復

- MQTT用戶名、密碼：平臺下發，或由產品密鑰通過算法生成

- KeepAlive心跳時長：通常30~120s，斷連檢測

- CleanSession：清理會話標志(0保留會話/1新會話)

3. Topic主題配置(上報+下發)

- 設備上報上行Topic：采集數據、狀態上報

- 平臺下發下行Topic：指令下發、遠程控制

- 設備影子Topic(阿里云IoT)：設備期望狀態同步

4. Modbus網關類額外參數(485傳感器/變送器)

- 串口參數：波特率、數據位、停止位、校驗位

- 從站地址、寄存器起始地址、寄存器數量、數據類型(16位/32位，高低字節序)

- 采集周期：多久讀一次傳感器數據并上傳云平臺

三、數據業務參數

1. 點位定義(物模型)

- 屬性：電壓、電流、溫濕度、開關狀態等

- 標識符(物模型ID)、數據類型(int/float/bool/string)、單位、數據精度

- 讀寫類型：只讀(采集上報)/讀寫(平臺下發控制)

2. 上報策略

- 定時上報：固定周期上傳

- 變化上報：閾值觸發(數值變化超過XX才上傳，節省流量)

- 離線緩存：斷網本地緩存數據，聯網補發

3. 遠程控制參數

- 下發指令解析規則：Modbus寫寄存器、IO繼電器輸出、開關量控制

- 指令應答：設備收到指令后返回ACK確認

四、安全參數(生產環境必配)

1. 傳輸加密

- TLS/SSL證書：CA根證書，用于8883端口加密，防止報文竊聽篡改

2. 鑒權方式

- 密鑰鑒權、X.509證書鑒權(高安全場景)

3. 白名單：部分平臺支持設備SN/IP白名單

4. 設備在線/離線事件：設置離線消息推送規則

五、調試輔助參數

- 日志級別：開關調試日志，查看連接、收發報文

- 重連策略：斷開后重試間隔，最大重試次數

- NTP時間同步：設備校時，保證上報數據時間戳準確

最簡接入核對清單(快速檢查)

? 產品+設備三元組(ProductKey/DeviceName/DeviceSecret)

? MQTT broker地址、端口

? ClientID、MQTT賬號密碼

? 上下行Topic

? 串口/Modbus采集參數(采集類設備)

? TLS證書(生產環境)

? 物模型點位定義

? 心跳、上報周期、重連策略

?聚英云設備采用掃描設備的二維碼標簽，即可獲取當前設備信息，添加設備。

注意：點擊掃描按鈕，進入的掃描界面為黑色，無法顯示掃描界面時，需要在手機的設置里，打開應用程序管理，選擇app應用，將相機的使用權限開放給app軟件即可。