终极IEC104协议开发指南：从入门到精通的Java实现方案

🌟 什么是IEC104协议？为什么选择这个开源项目？

IEC104协议是电力系统自动化领域广泛使用的远程监控通信标准，而 IEC104开源项目 则是基于Netty框架打造的轻量级通信解决方案。它支持主站客户端与从站服务端双模式，轻松实现电力数据采集与终端模拟，已集成S帧/U帧处理、总召唤指令、沾包拆包等核心功能，让协议开发不再从零开始！

📋 项目核心优势与架构解析

✨ 四大核心特性

✅ 双模式支持：既可以作为主站采集数据，也能作为从站模拟终端设备
✅ 完整协议栈：实现S帧确认、U帧控制、总召唤等关键通信机制
✅ 高性能网络：基于Netty的NIO架构，轻松应对高并发数据传输
✅ 灵活扩展：预留业务对象转换接口，可根据硬件厂商点表自定义解析规则

🧩 项目架构概览

该项目采用分层设计思想，核心模块包括：

src/main/java/com/iot/protocol/iec104/
├── common/        // 基础指令与常量定义
├── config/        // 配置类管理
├── core/          // 编解码核心逻辑
├── enums/         // 协议枚举类型
├── message/       // 消息结构定义
└── server/        // 主从站服务实现
    ├── handler/   // 信道处理器链
    ├── master/    // 主站客户端
    └── slave/     // 从站服务端

🚀 快速上手：5分钟启动你的第一个IEC104应用

🔧 环境准备

• JDK 8+
• Maven 3.6+
• Git

📥 一键安装步骤

git clone https://gitcode.com/gh_mirrors/iec/IEC104
cd IEC104
mvn clean package -Dmaven.test.skip=true

🎮 主站客户端启动示例

// 创建配置对象
Iec104Config config = new Iec104Config();
config.setFrameAmountMax((short) 1);  // 每接收1帧回复S帧
config.setTerminnalAddress((short) 1); // 终端地址（需与从站一致）

// 启动主站并设置数据处理器
Iec104MasterFactory.createTcpClientMaster("127.0.0.1", 2404)
    .setDataHandler(new SysDataHandler())
    .setConfig(config)
    .run();

🛡️ 从站服务端启动示例

// 创建配置对象
Iec104Config config = new Iec104Config();
config.setFrameAmountMax((short) 1);
config.setTerminnalAddress((short) 1);

// 启动从站服务
Iec104SlaveFactory.createTcpServerSlave(2404)
    .setDataHandler(new SysDataHandler())
    .setConfig(config)
    .run();

⚙️ 深度定制：数据处理与业务扩展

📊 自定义数据处理器

通过实现DataHandler接口，轻松对接业务逻辑：

public class CustomDataHandler implements DataHandler {
    @Override
    public void channelRead(ChannelHandler ctx, MessageDetail msg) {
        // 收到消息后的业务处理逻辑
        System.out.println("接收数据: " + msg);
        // 回复总召唤结束指令
        ctx.writeAndFlush(BasicInstruction104.getEndGeneralCallDetail104());
    }
}

⚙️ 核心配置项说明

配置参数	作用说明	默认值
frameAmountMax	S帧确认阈值（接收N帧后回复）	1
terminnalAddress	终端地址（主从站必须一致）	1
timeout	连接超时时间（秒）	30

📚 进阶应用与最佳实践

🔍 协议调试技巧

1. 抓包分析：使用Wireshark过滤tcp.port == 2404监控通信过程
2. 日志配置：调整log_level为DEBUG，查看详细编解码过程
3. 异常处理：通过ChannelHandler的exceptionCaught方法捕获通信错误

📈 性能优化建议

• 合理设置frameAmountMax参数，高并发场景建议设为5-10
• 业务处理逻辑放入独立线程池，避免阻塞IO线程
• 定期清理Iec104ThreadLocal缓存，防止内存泄漏

📄 规约解析与文档支持

项目提供详细的协议实现说明文档：
📑 规约解析细则

该文档详细定义了协议帧结构、数据类型与通信流程，是对接硬件设备的重要参考资料。

🙏 致谢与开源协议

本项目基于 mujave/iec 进行二次开发，采用Apache-2.0开源协议，感谢所有贡献者的辛勤付出！

📮 技术支持与联系

遇到问题？欢迎通过以下方式交流：

• Issue提交：项目GitHub仓库
• 邮件咨询：[e-mail]

---

提示：实际部署时需根据硬件厂商提供的点表定义，在message模块中实现业务对象转换逻辑。项目通讯层已通过严格测试，建议优先使用默认配置参数进行初次调试。