接入物联网云平台需要哪些参数设置

> 通用框架，适用于聚英电子、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软件即可。