libiec61850 开源项目使用教程

1. 项目的目录结构及介绍

libiec61850 是一个用于 IEC 61850 协议的开源库，实现 MMS、GOOSE 和 SV 协议。以下是其主要目录结构及其介绍：

核心源码目录 (src/)

• iec61850/ - IEC 61850 协议核心实现
• mms/ - MMS (Manufacturing Message Specification) 协议的实现
• goose/ - GOOSE (Generic Object Oriented Substation Event) 协议的实现
• sampled_values/ - SV (Sampled Values) 协议的实现
• common/ - 通用工具和辅助函数
• r_session/ - R-session 协议实现（BETA）
• sntp/ - 简单 SNTP 客户端代码（BETA）
• logging/ - 日志服务实现

示例代码目录 (examples/) 包含丰富的使用示例，分为客户端和服务器端：

• server_example_* - 各种服务器端示例
• iec61850_client_example_* - 各种客户端示例
• goose_publisher/ - GOOSE 发布示例
• goose_subscriber/ - GOOSE 订阅示例
• sv_publisher/ - SV 发布示例
• sv_subscriber/ - SV 订阅示例

配置文件目录 (config/)

• stack_config.h - 栈配置头文件
• stack_config.h.cmake - CMake 构建配置

其他重要目录

• dotnet/ - C#/.NET 包装器和示例
• hal/ - 硬件抽象层
• pyiec61850/ - 实验性 Python 绑定
• third_party/ - 第三方依赖库

2. 项目的启动文件介绍

项目的启动文件主要位于 examples/ 目录下，以下是一些重要的启动文件：

服务器端启动文件

• server_example_basic_io/server_example_basic_io.c - 基础 I/O 服务器示例
• server_example_simple/server_example_simple.c - 简单服务器示例
• server_example_control/server_example_control.c - 控制功能服务器示例

客户端启动文件

• iec61850_client_example1/client_example1.c - 基础客户端示例
• iec61850_client_example_async/client_example_async.c - 异步客户端示例
• iec61850_client_example_control/client_example_control.c - 控制功能客户端示例

协议特定示例

• goose_publisher/goose_publisher_example.c - GOOSE 发布示例
• sv_publisher/sv_publisher_example.c - SV 发布示例

3. 项目的配置文件介绍

主要配置文件

• config/stack_config.h - 栈配置头文件，包含库的全局配置选项
• config/stack_config.h.cmake - CMake 版本的配置模板

模型配置文件 示例目录中包含多个 CID/ICD 文件，用于定义数据模型：

• simpleIO_direct_control.cid - 简单 I/O 控制配置
• simpleIO_direct_control.icd - IED 能力描述文件
• wtur.cid - 风力涡轮机配置

构建配置文件

• CMakeLists.txt - 主要的 CMake 构建脚本
• Makefile - 传统的 Makefile 构建配置

4. 构建和运行指南

使用 Make 构建

make examples
cd examples/server_example_basic_io
sudo ./server_example_basic_io

使用 CMake 构建

mkdir build
cd build
cmake ..
make

启用 TLS 支持

make WITH_MBEDTLS=1   # 使用 mbedtls 2.28
# 或
make WITH_MBEDTLS3=1  # 使用 mbedtls 3.6

5. 主要功能特性

• MMS 客户端/服务器通信
• GOOSE 协议支持（IEC 61850-8-1）
• 采样值（SV）协议支持（IEC 61850-9-2）
• 带缓冲和无缓冲报告
• 在线报告控制块配置
• 数据访问服务（获取/设置数据）
• 日志服务（支持 SQLite）
• 文件服务（COMTRADE 文件下载）
• 设置组处理
• TLS 支持（IEC 62351-3/4）

libiec61850 提供了完整的 IEC 61850 协议栈实现，支持嵌入式系统和 PC 平台，是开发智能电网和变电站自动化应用的理想选择。