Skip to content

nimbuscontrols/EIPScanner

Repository files navigation

EIPScanner

Build Status GitHub release (latest by date)

Free implementation of Ethernet/IP scanner in C++.

Features

  • Explicit messaging
  • Implicit messaging (only point-to-point)
  • Discovery

CIP Standard objects:

  • File Object (upload only)
  • Parameter Object (read only)
  • Identity Object

Vendor specific objects:

  • RA DPI Fault Object

Requirements

  • CMake 3.5 and higher
  • C++20 compiler (tested with GCC and MinGW)
  • Linux, MacOS, and Windows

Installing

$ mkdir build && cd build
$ cmake ..
$ cmake --build . --target install

Usage

To see how to work with the library, look into examples directory

Contribution

We welcome outside contributions for any improvements, features, or new devices (see below) to the library. Please create a pull request with unit/mock tests

Vendor specific objects & devices

Our goal is to maintain an active device catalog of all EtherNet/IP devices and their objects that we encounter. We encourage others to contribute to this communal device catalog in /src/vendor/.

All vendor source files are automatically enabled. If you'd like to disable vendor files, you can disable with any of the below options.

  1. set this option in CMakeLists.txt
option(ENABLE_VENDOR_SRC "Enable vendor source" OFF)
  1. set the cmake build flag
-DENABLE_VENDOR_SRC=OFF
  1. manually comment needed files in src/vendor/CMakeLists.txt

Authors

Aleksey Timin

Adam Roth