协议规格

Thu, 18 Jun 2026 12:44:47 +0800

连接参数

参数	值
协议	MQTT v3.1.1
Broker	由平台提供
端口	`1883`
Payload	Protobuf

认证方式

支持两种 MQTT 认证方式：

方式	clientId	username	password
Access Token	任意	Access Token	留空
Basic	deviceId	username	password

认证凭据在平台创建设备后获取。clientId 建议使用 deviceId。

主题结构

主题	方向	QoS	说明
`strain/{deviceId}/telemetry`	上行	0	遥测数据（高频应变值）
`strain/{deviceId}/attributes`	上行	1	设备属性上报
`strain/{deviceId}/attributes/subscribe`	下行	1	平台下发配置指令

Protobuf 定义

设备端编译以下 .proto 文件生成对应语言的代码：

syntax = "proto3";

package shm.strain.v1;

// 遥测上报消息
message StrainTelemetry {
 StrainBatch strainBatch = 1;

 message StrainBatch {
 uint64 timestamp = 1; // 首样本设备时间戳（毫秒）
 uint32 ch_no = 2; // 通道编号（从 1 开始）
 uint32 sample_interval_ms = 3; // 采样间隔（ms），100Hz=10, 50Hz=20, 20Hz=50
 repeated sint32 values = 4; // 该通道的应变值数组（με）
 optional float temperature = 5; // 该通道温度值（℃）
 optional uint32 battery = 6; // 电池电量 0-100%
 optional uint32 mode = 7; // 设备工作模式
 optional uint32 status = 8; // 状态码，0=正常
 }
}

// 属性上报消息
message StrainDeviceAttributes {
 string firmware_version = 1; // 固件版本
 string serial_number = 2; // 设备序列号
 string device_model = 3; // 设备型号
 uint32 channel_count = 4; // 通道数
 uint32 sample_interval_ms = 5; // 采样间隔（ms），所有通道统一
}

遥测字段

遥测数据封装在 StrainTelemetry.strainBatch 中，每个通道独立一包。

应变读数仪 on Inteagle 开发者文档

协议规格

连接参数

认证方式

主题结构

Protobuf 定义

遥测字段