OpENer Ethernet/IP Stack 开源项目安装与使用教程

1. 项目目录结构及介绍

OpENer 是一个专为I/O适配器设备设计的EtherNet/IP堆栈。项目遵循ODVA规范，支持多路I/O和明确连接，并提供构建符合EtherNet/IP标准产品的对象和服务。下面是其主要的目录结构：

• bin: 包含不同平台的编译结果和make文件。

  • posix: 针对POSIX兼容系统（如Linux）的编译脚本和可执行文件。
  • win32: Windows平台下的编译设置和输出。
  • mingw, cygwin: 分别对应于MinGW和Cygwin环境的编译资源。

• doc: 存放Doxygen生成的代码文档（需手动生成）以及编码规则文档。

• data: 提供默认应用的EDS文件。

• source: 主要源代码文件夹，包括：

  • cip: CIP层代码，实现控制与信息协议的核心逻辑。
  • cip_objects: 扩展CIP对象集。
  • enet_encap: 处理以太网封装的层。
  • ports: 平台特定代码，确保跨平台运行。
  • utils: 辅助函数集合。
  • tests: 测试代码。

• tests: 含有针对特定功能和模块的测试案例。

• docs/api_doc: 自动生成的功能文档存放处，对于SVN版本可用。

2. 项目的启动文件介绍

对于POSIX系统 (如Linux):

• 启动命令示例: 在正确配置并编译后，使用如下命令启动OpENer服务:

  /src/ports/POSIX/OpENer eth1
  

  其中eth1是你的网络接口名。

对于Windows:

• 使用Visual Studio或MinGW编译后，根据配置（Debug或Release），在对应的输出目录找到OpENer.exe，通过指定网络接口索引来启动程序。例如，在Windows环境下，可以通过以下步骤：

  cd bin\win32\src\ports\WIN32\
  OpENer [interface_index]
  

实时(RT)模式注意:

对于需要实时能力的场景，OpENer提供了OpENer_RT选项，但要求操作系统内核具有完全预emption RT补丁，并需要手动赋予相应的权限。

3. 项目的配置文件介绍

OpENer的配置更多地依赖于CMakeLists.txt文件和编译时的参数。不像传统项目拥有单一的配置文件，其配置过程体现在编译阶段的选择上，比如是否作为库安装(-DOPENER_INSTALL_AS_LIB)，是否开启调试模式，以及在特定平台上的编译选项等。

• 编译时配置: 使用CMake进行项目配置时，通过命令行参数来设定这些配置项，例如使用 -DOPENER_TRACES:BOOL=TRUE 来启用追踪功能。

• 运行时配置: OpENer的运行取决于编译时选择的端口配置和可能的环境变量，而不是传统的配置文件。特定的运行时行为可以通过传递给可执行文件的参数或环境配置间接调整。

为了针对具体需求调整行为，开发者应当深入阅读项目的source/CMakeLists.txt文件，了解如何通过CMake的参数定制编译选项，从而达到配置目的。