This is an automated email from the ASF dual-hosted git repository.
git-site-role 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 ebe8d90ea Site checkin for project PLC4X: Jenkins Tools
ebe8d90ea is described below
commit ebe8d90ead0fd22f3d90c1abfd376e33901cea28
Author: jenkins <[email protected]>
AuthorDate: Sun Aug 7 14:19:18 2022 +0000
Site checkin for project PLC4X: Jenkins Tools
---
images/users/protocols/ads_banner.png | Bin 0 -> 32795 bytes
images/users/protocols/bacnet_banner.png | Bin 0 -> 35191 bytes
images/users/protocols/can_banner.png | Bin 0 -> 32528 bytes
images/users/protocols/knx_banner.png | Bin 0 -> 32859 bytes
users/protocols/ads.html | 104 ++++++++++++++++++++++++++++---
users/protocols/bacnetip.html | 86 +++++++++++++++++++++++--
users/protocols/can.html | 5 ++
users/protocols/canopen.html | 5 ++
users/protocols/knxnetip.html | 5 ++
9 files changed, 191 insertions(+), 14 deletions(-)
diff --git a/images/users/protocols/ads_banner.png
b/images/users/protocols/ads_banner.png
new file mode 100644
index 000000000..e8ee13159
Binary files /dev/null and b/images/users/protocols/ads_banner.png differ
diff --git a/images/users/protocols/bacnet_banner.png
b/images/users/protocols/bacnet_banner.png
new file mode 100644
index 000000000..75832b212
Binary files /dev/null and b/images/users/protocols/bacnet_banner.png differ
diff --git a/images/users/protocols/can_banner.png
b/images/users/protocols/can_banner.png
new file mode 100644
index 000000000..53eeb66a5
Binary files /dev/null and b/images/users/protocols/can_banner.png differ
diff --git a/images/users/protocols/knx_banner.png
b/images/users/protocols/knx_banner.png
new file mode 100644
index 000000000..4bd8c4bd9
Binary files /dev/null and b/images/users/protocols/knx_banner.png differ
diff --git a/users/protocols/ads.html b/users/protocols/ads.html
index 16f49ef01..0dd35b650 100644
--- a/users/protocols/ads.html
+++ b/users/protocols/ads.html
@@ -292,25 +292,113 @@
</nav>
<main role="main"
class="ml-sm-auto px-4 col-sm-pull col-md-9 col-lg-10 h-100">
<div class="sect1">
-<h2 id="adsams">ADS/AMS</h2>
+<h2 id="ads_automation_device_specification">ADS (Automation Device
Specification)</h2>
<div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<img src="../../images/users/protocols/ads_banner.png" alt="banner"
width="512" height="167"/>
+</div>
+</div>
+<div class="paragraph">
+<p>The ADS (automation device specification) describes a device-independent
and fieldbus independent interface for communication between Beckhoff
automation devices running TwinCAT and other devices implementing this
interface. <a href="https://www.home-assistant.io/integrations/ads/";
class="bare">https://www.home-assistant.io/integrations/ads/</a> Source
(accessed 7 August 2022)</p>
+</div>
+<div class="paragraph">
+<p>ADS device concept: <a
href="https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=";
class="bare">https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=</a>
Source (accessed 7 August 2022)</p>
+</div>
+<div class="paragraph">
+<p>Specifcation for ADS devices: <a
href="https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=";
class="bare">https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=</a>
Source (accessed 7 August 2022)</p>
+</div>
<div class="sect2">
<h3 id="structure_amstcp_packet">Structure AMS/TCP Packet</h3>
+<div class="paragraph">
+<p>ADS (Automation Device Specification) is the TwinCAT communication protocol
that specifies the interaction between two ADS devices. For example, it defines
what operations can be executed on another ADS device, what parameters are
necessary for that and what return value is sent after execution.</p>
+</div>
+<div class="paragraph">
+<p>AMS (Automation Message Specification) specifies the exchange of the ADS
data. A major component of the communication protocol is the AmsNetId. This is
specified in the AMS/ADS package for the source and target device. An ADS
device can be explicitly addressed using the AmsNetId.
+Source <a
href="https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=";
class="bare">https://infosys.beckhoff.com/english.php?content=../content/1033/ams_nat/4275563275.html&id=</a>
(accessed 7 August 2022)</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="connection_string_options">Connection String Options</h3>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
-<col style="width: 100%;"/>
+<col style="width: 22.2222%;"/>
+<col style="width: 22.2222%;"/>
+<col style="width: 55.5556%;"/>
</colgroup>
<thead>
<tr>
-<th class="tableblock halign-left valign-top">AMS/TCP Header</th>
+<th class="tableblock halign-left valign-top">Name</th>
+<th class="tableblock halign-left valign-top">Value</th>
+<th class="tableblock halign-left valign-top">Description</th>
</tr>
</thead>
<tbody>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">AMS
Header</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Code</p></td>
+<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="paragraph">
+<p><code>ADS</code></p>
+</div></div></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">ADS
Data</p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Name</p></td>
+<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="paragraph">
+<p>ADS Protocol</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Maven
Dependency</p></td>
+<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="listingblock">
+<div class="content">
+<pre><dependency>
+ <groupId>org.apache.plc4x</groupId>
+ <artifactId>plc4j-driver-ads</artifactId>
+ <version>{current-last-released-version}</version>
+</dependency></pre>
+</div>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Default
Transport:</p></td>
+<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="paragraph">
+<p> <code>tcp</code></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="3"><p
class="tableblock">Supported Operations</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p><code>read</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top" colspan="3"><p
class="tableblock">Options</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">AmsNetId</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>getTargetAmsNetId()</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>setTargetAmsNetId(AmsNetId targetAmsNetId)</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">AmsNetIdConverter</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">targetAmsPort</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>getDefaultPort(48898)</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Defaults to 48898</p>
+</div></div></td>
</tr>
</tbody>
</table>
@@ -349,10 +437,8 @@
<div class="sect2">
<h3 id="more_details_on">More details on</h3>
<div class="paragraph">
-<p>For details about the protocol look here: <a
href="http://www.beckhoff.com/"; class="bare">http://www.beckhoff.com/</a></p>
-</div>
-<div class="paragraph">
-<p>Source: <a
href="https://infosys.beckhoff.com/english.php?content=../content/1033/tcadsamsspec/html/tcadsamsspec_intro.htm";>Structure
AMS/TCP Packet</a></p>
+<p>For details about the protocol look here: <a
href="http://www.beckhoff.com/"; class="bare">http://www.beckhoff.com/</a>
+& (German Handbook: <a
href="https://download.beckhoff.com/download/Document/automation/twincat3/TwinCAT_3_ADS_INTRO_DE.pdf";
class="bare">https://download.beckhoff.com/download/Document/automation/twincat3/TwinCAT_3_ADS_INTRO_DE.pdf</a>)</p>
</div>
</div>
</div>
diff --git a/users/protocols/bacnetip.html b/users/protocols/bacnetip.html
index 1173e7b05..6a1c0bd57 100644
--- a/users/protocols/bacnetip.html
+++ b/users/protocols/bacnetip.html
@@ -294,6 +294,11 @@
<div class="sect1">
<h2 id="bacnetip">BACnet/IP</h2>
<div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<img src="../../images/users/protocols/bacnet_banner.png" alt="banner"
width="512" height="167"/>
+</div>
+</div>
<div class="sect2">
<h3 id="bacnet_building_automation_and_control_networks">BACnet (Building
Automation and Control Networks)</h3>
<table class="tableblock frame-all grid-all stretch">
@@ -326,7 +331,11 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">Maven
Dependency</p></td>
<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="listingblock">
<div class="content">
-<pre>to be updated (tbu)</pre>
+<pre><dependency>
+ <groupId>org.apache.plc4x</groupId>
+ <artifactId>plc4j-driver-bacnet</artifactId>
+ <version>{current-last-released-version}</version>
+</dependency></pre>
</div>
</div></div></td>
</tr>
@@ -337,12 +346,15 @@
</div></div></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Compatible
Transports:</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Supported
Transport:</p></td>
<td class="tableblock halign-left valign-top" colspan="2"><div
class="content"><div class="ulist">
<ul>
<li>
<p><code>tcp</code></p>
</li>
+<li>
+<p><code>udp</code></p>
+</li>
</ul>
</div></div></td>
</tr>
@@ -352,13 +364,79 @@
<tr>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
-<p><code>tbu</code></p>
+<p><code>read</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="3"><p
class="tableblock">Options</p></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">getFilter() / setFilter(String)</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>"filter"</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>StringDefaultValue("")</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>BACNET_IP_PORT(47808)</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Defaults to 47808</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>getProtocolId</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">getPcapPacketHandler()</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">getEdeDirectoryPath() / setEdeDirectoryPath(String
edeDirectoryPath)</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+<td class="tableblock halign-left valign-top"><div class="content"></div></td>
+</tr>
+</tbody>
+</table>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 33.3333%;"/>
+<col style="width: 33.3333%;"/>
+<col style="width: 33.3334%;"/>
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Data array</th>
+<th class="tableblock halign-left valign-top">Size</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
</tbody>
</table>
</div>
@@ -367,8 +445,6 @@
<div class="paragraph">
<p><a href="http://www.bacnet.org/";>BACnet - A Data Communication Protocol for
Building Automation and Control Networks</a></p>
</div>
-<table class="tableblock frame-all grid-all stretch">
-</table>
</div>
</div>
</div>
diff --git a/users/protocols/can.html b/users/protocols/can.html
index 3516709a4..3559772f1 100644
--- a/users/protocols/can.html
+++ b/users/protocols/can.html
@@ -294,6 +294,11 @@
<div class="sect1">
<h2 id="can_bus_driver_adapter">CAN Bus Driver Adapter</h2>
<div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<img src="../../images/users/protocols/can_banner.png" alt="banner"
width="512" height="167"/>
+</div>
+</div>
<div class="paragraph">
<p>The CAN Bus driver is a special kind of driver which does not bring any
logic.
Its responsibility is to combine <a href="../transports/can.html">CAN
transport facade</a> and custom application layer protocols.
diff --git a/users/protocols/canopen.html b/users/protocols/canopen.html
index 44d66a05f..c14363cd6 100644
--- a/users/protocols/canopen.html
+++ b/users/protocols/canopen.html
@@ -294,6 +294,11 @@
<div class="sect1">
<h2 id="canopen">CANopen</h2>
<div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<img src="../../images/users/protocols/can_banner.png" alt="banner"
width="512" height="167"/>
+</div>
+</div>
<div class="sect2">
<h3 id="can_in_automation">CAN in Automation</h3>
<div class="paragraph">
diff --git a/users/protocols/knxnetip.html b/users/protocols/knxnetip.html
index 8b3a68a2e..be7176b88 100644
--- a/users/protocols/knxnetip.html
+++ b/users/protocols/knxnetip.html
@@ -294,6 +294,11 @@
<div class="sect1">
<h2 id="knxnetip">KNXnet/IP</h2>
<div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<img src="../../images/users/protocols/knx_banner.png" alt="banner"
width="512" height="167"/>
+</div>
+</div>
<div class="sect2">
<h3 id="connection_string_options">Connection String Options</h3>
<table class="tableblock frame-all grid-all stretch">
