This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/plc4x-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 4e78f56ae Site checkin for project PLC4X: Jenkins Tools
4e78f56ae is described below
commit 4e78f56ae168ed26e78e64dc4fd76acb3ba7d8b6
Author: jenkins <[email protected]>
AuthorDate: Fri Aug 14 10:30:53 2026 +0000
Site checkin for project PLC4X: Jenkins Tools
---
plc4x/pre-release/users/protocols/eip.html | 92 ++++++++++++++++++++++++++----
search-index.js | 2 +-
2 files changed, 82 insertions(+), 12 deletions(-)
diff --git a/plc4x/pre-release/users/protocols/eip.html
b/plc4x/pre-release/users/protocols/eip.html
index 069f166b8..27b2b30f8 100644
--- a/plc4x/pre-release/users/protocols/eip.html
+++ b/plc4x/pre-release/users/protocols/eip.html
@@ -729,8 +729,10 @@ It consists of pairs of values, each pair begins with
either 1 (Backplane) or 2
</div>
<div class="listingblock">
<div class="content">
-<pre>%{tagname}[{startIndex}]:{numberOfElements}
-%{tagname}[{startIndex}]:{numberOfElements}:{DataType}</pre>
+<pre>{tagname}
+{tagname}:{DataType}
+{tagname}:{numberOfElements}
+{tagname}[{startIndex}]:{DataType}:{numberOfElements}</pre>
</div>
</div>
<table class="tableblock frame-all grid-all stretch">
@@ -747,24 +749,75 @@ It consists of pairs of values, each pair begins with
either 1 (Backplane) or 2
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">Tagname</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">symbolic
name of the Data</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">symbolic
name of the data. May optionally be prefixed with <code>%</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start
Index (optional)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">if the
data is an array, we can specify a starting index from where we want to
read</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">if the
data is an array, we can specify a starting index from where we want to read.
It is appended to the tag name and has to be the last part of it.</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">DataType
(optional)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">the data
type of the value. Defaults to <code>DINT</code> when omitted, so for anything
that is not a 32-bit integer it should be given explicitly - also when
reading.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number of
elements (optional)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">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.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">if the
data is an array, we can specify the number of elements we want to read.
Defaults to <code>1</code>. Use this in combination with the starting index to
get the exact scope you want.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+The data type comes <strong>before</strong> the number of elements. Reading
four DINTs starting at index 0
+ is <code>myArray[0]:DINT:4</code>.
+</td>
+</tr>
+</table>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 1. Examples</caption>
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Address</th>
+<th class="tableblock halign-left valign-top">Meaning</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>myTag</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">a single
element of <code>myTag</code>, decoded as <code>DINT</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>myTag:REAL</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">a single
element of <code>myTag</code>, decoded as <code>REAL</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>myTag:4</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">four
elements of <code>myTag</code>, decoded as <code>DINT</code></p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DataType
(writing)</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Specify
the Data-type of the value you want to write (mandatory)</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>myArray[3]:DINT</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">element 3
of <code>myArray</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>myArray[0]:DINT:4</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">elements 0
to 3 of <code>myArray</code>, returned as a list</p></td>
</tr>
</tbody>
</table>
<div class="sect2">
<h3 id="_data_types"><a class="anchor" href="#_data_types"></a>Data Types</h3>
+<div class="paragraph">
+<p>These are the data types the driver can encode and decode:</p>
+</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
@@ -782,10 +835,6 @@ It consists of pairs of values, each pair begins with
either 1 (Backplane) or 2
<td class="tableblock halign-left valign-top"><p
class="tableblock">BOOL</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Bit
array</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">DWORD
(32-bit boolean array)</p></td>
-</tr>
-<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">8-bit
integer</p></td>
<td class="tableblock halign-left valign-top"><p
class="tableblock">SINT</p></td>
</tr>
@@ -805,8 +854,29 @@ It consists of pairs of values, each pair begins with
either 1 (Backplane) or 2
<td class="tableblock halign-left valign-top"><p class="tableblock">32-bit
float</p></td>
<td class="tableblock halign-left valign-top"><p
class="tableblock">REAL</p></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">64-bit
float</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">LREAL</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Character
string</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">STRING</p></td>
+</tr>
</tbody>
</table>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Other CIP data types are accepted by the address parser but are not encoded or
decoded by the
+ driver; reading such a tag results in a response code of
<code>INTERNAL_ERROR</code> rather than a value.
+</td>
+</tr>
+</table>
+</div>
</div>
</div>
</div>
diff --git a/search-index.js b/search-index.js
index 4e0724fc7..0d12b09d6 100644
--- a/search-index.js
+++ b/search-index.js
@@ -1 +1 @@
-antoraSearch.initSearch(lunr,
{"index":{"version":"2.3.9","fields":["title","name","text","component"],"fieldVectors":[["title/1",[0,68.519]],["name/1",[1,1.515]],["text/1",[]],["component/1",[2,0.399]],["title/2-1",[3,34.481,4,29.733]],["name/2-1",[]],["text/2-1",[]],["component/2-1",[]],["title/2-2",[5,43.171]],["name/2-2",[]],["text/2-2",[]],["component/2-2",[]],["title/2-3",[6,12.058,7,12.725,8,9.567,9,16.261,10,15.556,11,21.004,12,26.143,13,12.121]],["name/2-3",[]],["text/2-3",[]],[
[...]
\ No newline at end of file
+antoraSearch.initSearch(lunr,
{"index":{"version":"2.3.9","fields":["title","name","text","component"],"fieldVectors":[["title/1",[0,68.519]],["name/1",[1,1.515]],["text/1",[]],["component/1",[2,0.399]],["title/2-1",[3,34.481,4,29.733]],["name/2-1",[]],["text/2-1",[]],["component/2-1",[]],["title/2-2",[5,43.171]],["name/2-2",[]],["text/2-2",[]],["component/2-2",[]],["title/2-3",[6,12.058,7,12.725,8,9.567,9,16.261,10,15.556,11,21.004,12,26.143,13,12.121]],["name/2-3",[]],["text/2-3",[]],[
[...]
\ No newline at end of file
