EtherNet/IP

通用协议：CIP

工控行业的各个厂商一起制定了一个通用的面向工控领域的应用层协议，取名为Common Industrial Protocol，缩写为CIP，使用CIP可以不用太关心网络通信各个环节的问题，降低了编程的复杂度和难度，实现了厂商间设备的互联，提高开发效率。

EtherNet/IP

CIP只是一个应用层协议，它需要传输通道来实现数据的收发，例如CAN总线、TCP/IP协议栈（包括Ethernet链路层和物理层），EtherNet/IP就是用TCP/IP协议栈来传输CIP协议的一种标准方案，也是由各个厂商一起制定的，此外还制定了其他传输方式，例如基于CAN总线的DeviceNet。

实现

协议只是标准
制定的通信协议只是纸面上的标准和规范，要让设备实际使用这种协议进行通信，还需要具体的实现，可以通过硬件也可以通过软件。

开源实现
由于EtherNet/IP是基于TCP/IP协议栈，所以可以利用现有的通用网络基础设施来实际传输数据，例如网卡、交换机，而应用层则可以通过软件编程实现，并且目前已经有基本的开源实现，使用时只需要调用接口来完成CIP中定义的各种功能，不需要自己创建和管理连接。

使用

基本套路
站在API使用的角度上看，EtherNet/IP（后续简称为EIP）所有接口都是围绕对象进行操作（这里的对象是跟具体编程语言无关的），所有网络中的设备也都用对象的实例进行表示，每个对象都可以通过ID进行唯一标识。

例如，创建一个会话对象（IP地址和端口号是参数），然后创建一个消息路由器对象绑定到会话对象，然后就可以调用该对象接口对网络上的其他对象（用指定的ID）发送请求，并得到回复，示例代码片段：

// 创建 EIP 会话对象
auto si = std::make_shared(“192.168.1.22”, 0xAF12);

// 创建消息路由对象
MessageRouter messageRouter;

// 想要请求的服务的ID
const CipUsint PLUS_ON_SERVICE = 0x01;

// 想要请求的对象的类ID和实例ID
const EPath EPATH_TO_WIDGET_INSTANCE(0xf0, 0x5);

// 请求的服务的参数
Buffer buffer;
CipInt arg = 7;
buffer << arg;

// 发送请求
auto response = messageRouter.sendRequest(si,
PLUS_ON_SERVICE,
EPATH_TO_WIDGET_INSTANCE,
buffer.data());

// 处理回复
if (response.getGeneralStatusCode() == GeneralStatusCodes::SUCCESS)
{
Buffer buffer(response.getData());
CipInt result;
buffer >> result;
Logger(LogLevel::INFO) << result;
}

定期收发

EIP的数据传输方式主要有两种：显式消息和隐式消息，显式消息一般用于时间延迟不紧急的数据传输，一般也就是在需要的时候发一次回一次，上一节中的示例代码片段就是发送显式消息。隐式消息一般用于延迟紧急的数据，例如定期（30ms间隔）获取设备的某个状态值，两种方式的区别体现在对象的类型和用法上，示例代码片段：

// 创建会话对象
auto si = std::make_shared(“192.168.1.22”, 0xAF12);

// 创建连接管理器对象
ConnectionManager connectionManager;

// 连接参数
ConnectionParameters parameters;

// 这里是CIP里定义的读取的目标数据的ID：config Assm151, output Assm150, intput Assm100
parameters.connectionPath = {0x20, 0x04,0x24, 151, 0x2C, 150, 0x2C, 100};

// 其他配置参数
parameters.o2tRealTimeFormat = true;
parameters.originatorVendorId = 342;
parameters.originatorSerialNumber = 32423;

parameters.t2oNetworkConnectionParams |= NetworkConnectionParams::P2P;
parameters.t2oNetworkConnectionParams |= NetworkConnectionParams::SCHEDULED_PRIORITY;
parameters.t2oNetworkConnectionParams |= 32; //每次通信目标设备发送给自己的数据长度

parameters.o2tNetworkConnectionParams |= NetworkConnectionParams::P2P;
parameters.o2tNetworkConnectionParams |= NetworkConnectionParams::SCHEDULED_PRIORITY;
parameters.o2tNetworkConnectionParams |= 32; //每次通信自己发送到目标设备的数据长度

parameters.originatorSerialNumber = 0x12345;
parameters.o2tRPI = 1000000; //自己定期发送数据到目标设备的时间间隔
parameters.t2oRPI = 1000000; //目标定期设备发送数据到自己的时间间隔
parameters.transportTypeTrigger |= NetworkConnectionParams::CLASS1;

// 打开连接
auto io = connectionManager.forwardOpen(si, parameters);
if (auto ptr = io.lock())
{
std::vector<uint8_t> myData;
for(int i=1; i<=32; ++i)
{
myData.push_back(i);
}

// 设置要定期向目标发送的数据
ptr->setDataToSend(myData);

// 注册收到目标定期发来的数据时的处理回调
ptr->setReceiveDataListener([](auto realTimeHeader, auto sequence, auto data) {
	std::ostringstream ss;
	ss << "secNum=" << sequence << " data=";
	for (auto &byte : data) {
		ss << "[" << std::hex << (int) byte << "]";
	}

	Logger(LogLevel::INFO) << "Received: " << ss.str();
});

// 注册连接关闭时的处理回调
ptr->setCloseListener([]() {
	Logger(LogLevel::INFO) << "Closed";
});

}

// 保持连接的处理
while (connectionManager.hasOpenConnections() && !flag_exit) {
connectionManager.handleConnections(std::chrono::milliseconds(100));
}

常用术语

在使用开源库之前，需要了解一些基本术语，它们经常出现在文档中：
【显式消息】(Explicit Messaging)
基于TCP，用于非时间紧迫数据，例如读写配置参数。
【隐式消息】(Implicit Messaging)
基于UDP，用于实时数据 I/O数据，例如I/O设备的控制数据。
【显式消息服务器】(Server)
服务器回应显式消息客户端的请求。
服务器的例子：条码扫描器。
【显式消息客户端】(Client)
客户端向其他设备发起请求并获取回应。
客户端的例子：HMI设备、PC。
【I/O 适配器】(Adapter)
适配器从扫描器接收隐式通信连接请求，并以指定的速率生成I/O数据。
适配器同时也是一个显式消息服务器。
适配器可以是简单的数字输入设备，也可以是更复杂的设备。
适配器的例子：模块化气动阀系统。
【I/O 扫描器】(Scanner)
扫描器向适配器发起隐式通信，并配置适配器，而且也可以发起显式消息。
扫描器的例子：PLC。
【最小显式消息服务器】
所有设备都必须支持最小量的显式消息服务器能力，从而回应设备识别和配置的请求。

使用 OpENer

OpENer是一个Adapter的实现。

代码库
https://github.com/EIPStackGroup/OpENer

Windows上构建
需要安装

Visual Studio
CMake (安装中选择把cmake的路径加到PATH环境变量)
官方文档也集成在源代码里，如果需要生成文档，还需要安装doxygen，graphviz

构建步骤

打开一个cmd窗口
cd 到代码目录下的\bin\win32\
执行setup_windows.bat文件，如果执行失败可以直接复制文件内容粘贴到cmd运行
正常情况下会生成OpENer.sln文件，用Visual Studio打开，生成解决方案

调试的时候先在cmd中运行 route print -4找到物理网卡序号，并填到命令行参数中：

工程中集成了一个示例，当收到Scanner发来的消息是，将会在这里处理：