同林云电力数据转发协议技术说明
一、项目概述
本协议用于将分布式电站的电力数据转发至同林云平台，实现电站数据的远程监控与管理。协议支持班组就地设备的数据对接，通过安全的网络通道将现场采集到的发电数据实时上传到云端。
二、应用场景
本协议主要应用于光伏电站的数据采集与上传场景。在分布式电站中，现场设备会实时采集发电相关的数据，包括发电量、上网电量等，本协议的核心作用是将这些数据自动上传到同林云平台。
对于拥有多个电站的企业来说，可以通过本协议将所有站点的数据统一汇总到同一个平台，实现集中监控和管理，大幅提升运维效率。
上传到平台的数据还可以用于生成日报、周报、月报等统计报表，帮助管理人员分析电站的发电效率、设备运行状态等，为决策提供数据支撑。
三、主要功能
身份认证机制：系统会自动向同林云平台进行身份认证，获取访问权限。认证成功后会获得一个有效的访问令牌，令牌有效期为30分钟，系统会在30分钟后自动重新认证以保证连接持续有效。
定时数据上传支持两种模式：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 整点上传模式 | 每小时的整点时刻自动上传一次数据 | 需要按小时统计的场景 |
| 固定周期上传模式 | 按照用户设定的时间间隔上传数据 | 需要更频繁监控的场景 |
即时首次上传：系统启动后会立即执行第一次上传，不必等待下一个整点或周期，确保数据及时上传。
自动增量计算：系统会自动计算两个上传周期之间的发电量增量和上网电量增量，通过记录上次上传时的累计数值，每次上传时自动计算差值，避免重复统计，确保数据准确性。
批量打包传输：为了提高传输效率，系统会将多个设备的数据打包后一起上传，每次最多可以打包100个数据点，当数据量超过限制时，会自动分成多个包依次发送。
智能重试机制：当网络不稳定或服务器暂时不可用时，系统会自动进行重试，重试采用指数退避策略，即每次重试的间隔时间会逐渐增加，最长可达100秒，避免对服务器造成过大压力。
心跳保活：系统会每分钟在通道监测发送一次心跳信息，表明服务正常运行。如果发生时间更改导致错过整点，超过一小时没有成功上传数据，系统会自动触发补偿机制，确保不会遗漏数据。
四、协议特点
- HTTPS加密传输：本协议采用HTTPS加密传输，确保数据在网络传输过程中的安全性
- 密钥认证：通过密钥认证机制，只有授权的设备才能访问平台，访问令牌会定期自动刷新，避免令牌过期带来的安全风险
- 主备双链路：协议支持主备双链路，当主链路故障时可以自动切换到备用链路，数据上传失败后会自动重试，确保数据最终能够送达
- 增量传输：差量传输机制减少了网络请求次数，提高了传输效率
- 灵活上传周期：用户可以根据实际需求选择整点上传或固定周期上传模式，上传周期可以灵活设置，从1分钟到1小时
- 自动时间戳：每次上传都会携带准确的时间戳，便于数据追溯和分析
- 去重机制：系统会记录每个设备的发送状态，确保数据不会重复上传或遗漏
五、数据内容
系统上传的数据包含以下核心指标：
| 数据项 | 说明 | 单位 |
|---|---|---|
| 累计发电量 | 从电站投运以来的总发电量 | 千瓦时（kWh） |
| 发电增量 | 本次上传周期内新增的发电量 | 千瓦时（kWh） |
| 上网累计电量 | 输送到电网的总电量 | 千瓦时（kWh） |
| 上网增量 | 本次上传周期内新增的上网电量 | 千瓦时（kWh） |
| 装机容量 | 电站的总装机功率 | 千瓦（kW） |
| 等效时长 | 本次上传周期的时间长度 | 小时（h） |
六、注意事项
使用本协议时需确保：
- 设备能够正常访问同林云平台的服务器地址，网络防火墙需要开放HTTPS端口
- 设备的系统时间需要与实际时间保持一致，否则会影响数据的时间戳准确性
- 需要正确配置授权地址、数据上传地址、应用密钥等参数，否则无法完成认证和数据上传
- 设备的测点描述需要按照平台规定的物模型名称填写，否则平台无法正确识别数据
- 首次上传时，由于没有历史数据作为参考，增量数据会显示为0，这是正常现象
七、支持设备信息
| 项目 | 详情 |
|---|---|
| CPU架构 | x86 / Cortex-A7 / Cortex-A53 / Cortex-A9 |
| 系统版本 | GNU/Linux 4.1.15 |
| 运行时长 | 7×24小时连续稳定运行 |
核心能力：
- 本机型配置方式，可简单将所需的现场数据转发给主站
- 支持多种协议：支持Modbus RTU、DL/T 645-2007、DL/T 6845-2017、IEC 60870系列等协议
- 支持多路采集转发
- 7×24小时连续稳定运行
FAQ
Q1：同林云电力数据转发协议支持哪些通讯协议？
A：该协议支持Modbus RTU、DL/T 645-2007、DL/T 6845-2017、IEC 60870系列等多种主流工业通讯协议，可对接不同厂家的现场设备。
Q2：数据上传失败时系统如何处理？
A：系统采用指数退避策略自动重试，重试间隔最长可达100秒。同时支持主备双链路切换，当主链路故障时自动切换至备用链路，确保数据最终送达。超过一小时未成功上传时还会触发补偿机制。
Q3：上传周期可以灵活设置吗？
A：可以。系统支持整点上传和固定周期上传两种模式，固定周期模式可设置从1分钟到1小时的任意间隔，用户可根据实际监控需求灵活选择。
Q4：系统如何保证数据安全性？
A：采用HTTPS加密传输确保数据安全，通过密钥认证机制限制只有授权设备才能访问平台，访问令牌每30分钟自动刷新，避免令牌过期风险。
Q5：首次上传时增量数据为什么显示为0？
A：首次上传时由于没有历史数据作为参考基准，增量数据会显示为0，这是正常现象。后续上传周期将自动计算准确的增量值。
400-001-8882
