物联网与硬件
物联网项目立项前，硬件侧一般需要提供哪些资料？
软件方案高度依赖硬件条件，越早把硬件资料给齐，越能把方案、周期、报价做准。我们一般会要客户在立项前提供这些：设备类型与数量、通信方式、协议文档、指令清单、上报频率、配网方式、故障码定义、测试样机、固件升级方式，以及是否已经有云平台或网关。
下面这份是我们在 IoT 项目启动前会发给硬件方的资料清单：
1. 设备基本信息
- 设备类型、型号、用途
- 一期投放数量、二期/三期预估扩展量
- 设备工作环境（室内/户外、温湿度范围、震动等级）
- 续航与供电方式
2. 通信方式
- 联网方式：4G / NB-IoT / Cat.1 / LoRa / Wi-Fi / 蓝牙 / 有线
- 是否支持双向通信
- 是否需要边缘网关
- 网络环境稳定性（是否会断网/弱网）
3. 通信协议文档
- 协议类型：MQTT / HTTP / Modbus / OPC UA / 私有协议
- 完整的协议文档（消息格式、字段含义、编码方式）
- 心跳机制、超时重连策略
- 鉴权方式（证书 / Token / 用户名密码）
4. 指令清单
- 数据上报的所有消息类型
- 远程控制的所有指令格式
- 指令的执行回执机制
- 异常处理流程
5. 数据上报与采集
- 上报频率（实时/秒级/分钟级/事件触发）
- 数据字段定义（名称、类型、范围、单位）
- 高频数据的压缩或聚合策略
- 历史数据本地缓存能力
6. 配网方式
- 出厂默认状态
- 首次配网流程（蓝牙配网/扫码/AP 模式）
- 重置方式
- 配网失败的处理
7. 故障码与诊断
- 完整的错误码列表
- 每个错误码的含义和处理建议
- 设备状态码（在线/离线/告警/维护中等）
- 日志采集与上报机制
8. 测试与样机
- 至少 2–3 台测试样机（开发期联调用）
- 样机访问的测试环境（IP/端口/证书）
- 联调时硬件工程师的对接人
9. 固件升级 OTA
- 升级包格式与下载方式
- 升级流程（设备触发 vs 服务器推送）
- 升级失败的回滚机制
- 是否支持灰度升级
10. 已有云平台或网关
- 是否已对接阿里云 IoT / 腾讯连连 / 华为 OceanConnect
- 是否已有边缘网关，型号、协议
- 是否要从原有平台迁移数据
为什么这些必须前期就齐
我们见过的拖延案例里，最常见的就是"协议先口头说，方案先做了，开发到一半才发现协议改了"。结果整个数据接入层要重做。所以我们会在立项前把协议、指令、故障码这些落实成文档，作为合同附件。
如果客户的硬件还在选型或自研中，前期可以一起做协议设计，参考 MQTT + JSON 这种通用做法，避免后期返工。我们做过 BMS 电池智能管家、新能源智能充换电、无人机智能充换电 这类涉及多种硬件的项目，对协议规范和接入层设计都有积累，可以直接复用。
总之一句话：硬件资料越完整、软件方案越靠谱，整个项目越不容易翻车。