This is an automated email from the ASF dual-hosted git repository. erobinet pushed a commit to branch develop in repository https://gitbox.apache.org/repos/asf/plc4x.git
The following commit(s) were added to refs/heads/develop by this push: new 169f53b Update ethernet-ip.adoc 169f53b is described below commit 169f53b185e610fe40e56593b1044bd9519a4539 Author: etiennerobinet <61242848+etiennerobi...@users.noreply.github.com> AuthorDate: Tue May 5 10:36:39 2020 +0200 Update ethernet-ip.adoc --- src/site/asciidoc/users/protocols/ethernet-ip.adoc | 78 ++++++++++++++++++++++ 1 file changed, 78 insertions(+) diff --git a/src/site/asciidoc/users/protocols/ethernet-ip.adoc b/src/site/asciidoc/users/protocols/ethernet-ip.adoc index ea74747..9dd1c85 100644 --- a/src/site/asciidoc/users/protocols/ethernet-ip.adoc +++ b/src/site/asciidoc/users/protocols/ethernet-ip.adoc @@ -18,3 +18,81 @@ :icons: font == EtherNet/IP + +=== Connection String Options +[cols="2,2a,5a"] +|=== +|Name |Value |Description + +|Code +2+|`eip` + +|Name +2+|EtherNet/IP Protocol + +|Maven Dependency +2+| +---- +<dependency> + <groupId>org.apache.plc4x</groupId> + <artifactId>plc4j-driver-eip</artifactId> + <version>{current-last-released-version}</version> +</dependency> +---- + +|Default Transport: +2+|`tcp` + +3+|Supported Operations +| +| `read` +|Read tags from a PLC4X device + +| +| `write` +|Write values to tags on a PLC4X device + +3+|Options + +| +| `backplane` +| `backplane` value for the client (PLC4X device). Mandatory. + +| +| `slot` +| `slot` value for the client (PLC4X device). Mandatory. +|=== + +=== Address Format +To read and write data to a PLC4X device, the EtherNet/IP driver uses symbolic segments. + This is used to refer to objects through their symbolic names. This makes reading data a lot easier, as you do not + need to specify the Datatype for reading. + + +---- + +%{tagname}[{startIndex}]:{numberOfElements} +%{tagname}[{startIndex}]:{numberOfElements}:{DataType} + +---- +[cols="2" ,options="header"] +|=== +|Name |Description +|Tagname |symbolic name of the Data +|Start Index (optional)|if the data is an array, we can specify a starting index from where we want to read +|Number of elements (optional)|if the data is an array, we can specify the number of elements we want to read. Use this in combination with the starting index to get the exact scope you want. +|DataType (writing) |Specify the Data-type of the value you want to write (mandatory) +|=== + +==== Data Types +[cols="2" ,options="header"] +|=== +|To store a|Use this data type +|Bit|BOOL +|Bit array|DWORD (32-bit boolean array) +|8-bit integer|SINT +|16-bit integer|INT +|32-bit integer|DINT +|64-bit integer|LINT +|32-bit float|REAL +|===