blob: 96c43b9dc0a4dac1a4bd3f501879fb4a6f0cb6ac [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<title>PLC4X &#x2013; </title>
<script src="../js/jquery.slim.min.js" type="text/javascript"></script>
<!--script src="../js/popper.min.js" type="javascript"></script-->
<script src="../js/bootstrap.bundle.min.js" type="text/javascript"></script>
<!-- The tooling for adding images and links to Apache events -->
<script src="https://www.apachecon.com/event-images/snippet.js" type="text/javascript"></script>
<!-- FontAwesome -->
<link rel="stylesheet" href="../css/all.min.css" type="text/css"/>
<!-- Bootstrap -->
<link rel="stylesheet" href="../css/bootstrap.min.css" type="text/css"/>
<!-- Some Maven Site defaults -->
<link rel="stylesheet" href="../css/maven-base.css" type="text/css"/>
<link rel="stylesheet" href="../css/maven-theme.css" type="text/css"/>
<!-- The PLC4X version of a bootstrap theme -->
<link rel="stylesheet" href="../css/themes/plc4x.css" type="text/css" id="pagestyle"/>
<!-- A custom style for printing content -->
<link rel="stylesheet" href="../css/print.css" type="text/css" media="print"/>
<meta http-equiv="Content-Language" content="en"/>
</head>
<body class="composite">
<nav class="navbar navbar-light navbar-expand-md bg-faded justify-content-center border-bottom">
<!--a href="/" class="navbar-brand d-flex w-50 mr-auto">Navbar 3</a-->
<a href="https://plc4x.apache.org/" id="bannerLeft"><img src="../images/apache_plc4x_logo_small.png" alt="Apache PLC4X"/></a>
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#collapsingNavbar3">
<span class="navbar-toggler-icon"></span>
</button>
<div class="navbar-collapse collapse w-100" id="collapsingNavbar3">
<ul class="navbar-nav w-100 justify-content-center">
<li class="nav-item">
<a class="nav-link" href="../index.html">Home</a>
</li>
<li class="nav-item active">
<a class="nav-link" href="../users/index.html">Users</a>
</li>
<li class="nav-item">
<a class="nav-link" href="../developers/index.html">Developers</a>
</li>
<li class="nav-item">
<a class="nav-link" href="../apache/index.html">Apache</a>
</li>
</ul>
<ul class="nav navbar-nav ml-auto justify-content-end">
<li class="nav-item row valign-middle">
<a class="acevent" data-format="wide" data-mode="light" data-event="random" style="width:240px;height:60px;"></a>
</li>
</ul>
</div>
</nav>
<div class="container-fluid">
<div class="row h-100">
<nav class="col-sm-push col-md-2 pt-3 sidebar">
<div class="sidebar-sticky">
<ul class="nav flex-column">
<li class="nav-item">
<a href="../users/index.html" class="nav-link">Section Home</a>
</li>
<li class="nav-item">
<strong class="nav-link">Download</strong>
</li>
<li class="nav-item">
<a href="../users/adopters.html" class="nav-link">Adopters</a>
</li>
<li class="nav-item">
<a href="../users/commercial-support.html" class="nav-link">Commercial support</a>
</li>
<li class="nav-item">
<a href="../users/gettingstarted.html" class="nav-link">Getting Started</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
<a href="../users/getting-started/plc4go.html" class="nav-link">Go</a>
</li>
<li class="nav-item">
<a href="../users/getting-started/plc4j.html" class="nav-link">Java</a>
</li>
<li class="nav-item">
<a href="../users/getting-started/using-snapshots.html" class="nav-link">Using SNAPSHOTS</a>
</li>
<li class="nav-item">
<a href="../users/getting-started/general-concepts.html" class="nav-link">General Concepts</a>
</li>
<li class="nav-item">
<a href="../users/getting-started/virtual-modbus.html" class="nav-link">Virtual Modbus</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../users/blogs-videos-and-slides.html" class="nav-link">Blogs, Videos and Slides</a>
</li>
<li class="nav-item">
<a href="../users/protocols/index.html" class="nav-link">Protocols</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
<a href="../users/protocols/ab-eth.html" class="nav-link">AB-ETH</a>
</li>
<li class="nav-item">
<a href="../users/protocols/ads.html" class="nav-link">ADS/AMS</a>
</li>
<li class="nav-item">
<a href="../users/protocols/bacnetip.html" class="nav-link">BACnet/IP</a>
</li>
<li class="nav-item">
<a href="../users/protocols/canopen.html" class="nav-link">CANopen</a>
</li>
<li class="nav-item">
<a href="../users/protocols/deltav.html" class="nav-link">DeltaV</a>
</li>
<li class="nav-item">
<a href="../users/protocols/df1.html" class="nav-link">DF1</a>
</li>
<li class="nav-item">
<a href="../users/protocols/ethernet-ip.html" class="nav-link">EtherNet/IP</a>
</li>
<li class="nav-item">
<a href="../users/protocols/firmata.html" class="nav-link">Firmata</a>
</li>
<li class="nav-item">
<a href="../users/protocols/knxnetip.html" class="nav-link">KNXnet/IP</a>
</li>
<li class="nav-item">
<a href="../users/protocols/modbus.html" class="nav-link">Modbus</a>
</li>
<li class="nav-item">
<a href="../users/protocols/opc-ua.html" class="nav-link">OPC UA</a>
</li>
<li class="nav-item">
<a href="../users/protocols/plc4x.html" class="nav-link">PLC4X (Proxy)</a>
</li>
<li class="nav-item">
<a href="../users/protocols/s7.html" class="nav-link">S7 (Step7)</a>
</li>
<li class="nav-item">
<a href="../users/protocols/simulated.html" class="nav-link">Simulated</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../users/transports/index.html" class="nav-link">Transports</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
<a href="../users/transports/tcp.html" class="nav-link">TCP</a>
</li>
<li class="nav-item">
<a href="../users/transports/udp.html" class="nav-link">UDP</a>
</li>
<li class="nav-item">
<a href="../users/transports/serial.html" class="nav-link">Serial</a>
</li>
<li class="nav-item">
<a href="../users/transports/socketcan.html" class="nav-link">SocketCAN</a>
</li>
<li class="nav-item">
<a href="../users/transports/raw-socket.html" class="nav-link">Raw Socket</a>
</li>
<li class="nav-item">
<a href="../users/transports/pcap-replay.html" class="nav-link">PCAP Replay</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../users/integrations/index.html" class="nav-link">Integrations</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
<a href="../users/integrations/apache-calcite.html" class="nav-link">Apache Calcite</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-camel.html" class="nav-link">Apache Camel</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-edgent.html" class="nav-link">Apache Edgent</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-iotdb.html" class="nav-link">Apache IoTDB</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-kafka.html" class="nav-link">Apache Kafka</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-nifi.html" class="nav-link">Apache NiFi</a>
</li>
<li class="nav-item">
<a href="../users/integrations/apache-streampipes.html" class="nav-link">Apache StreamPipes</a>
</li>
<li class="nav-item">
<a href="../users/integrations/eclipse-ditto.html" class="nav-link">Eclipse Ditto</a>
</li>
<li class="nav-item">
<a href="../users/integrations/eclipse-milo.html" class="nav-link">Eclipse Milo OPC UA Server</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../users/tools/index.html" class="nav-link">Tools</a>
<ul class="flex-column pl-4 nav">
<li class="nav-item">
<a href="../users/tools/capture-replay.html" class="nav-link">Capture Replay</a>
</li>
<li class="nav-item">
<a href="../users/tools/connection-pool.html" class="nav-link">Connection Pool</a>
</li>
<li class="nav-item">
<a href="../users/tools/connection-cache.html" class="nav-link">Connection Cache</a>
</li>
<li class="nav-item">
<a href="../users/tools/opm.html" class="nav-link">Object PLC Mapping (OPM)</a>
</li>
<li class="nav-item">
<a href="../users/tools/scraper.html" class="nav-link">Scraper</a>
</li>
<li class="nav-item">
<a href="../users/tools/testing.html" class="nav-link">PLC4X without a PLC and Unit Testing</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../users/industry40.html" class="nav-link">Industry 4.0 with Apache</a>
</li>
<li class="nav-item">
<a href="../users/security.html" class="nav-link">Security</a>
</li>
</ul>
</div>
</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="download">Download</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Be sure to verify your downloads by these <a href="https://www.apache.org/info/verification">procedures</a> using these <a href="https://downloads.apache.org/plc4x/KEYS">KEYS</a> for any Apache release.</p>
</div>
<div class="sect2">
<h3 id="current_releases">Current Releases</h3>
<div class="sect3">
<h4 id="0_9_1_official_source_release_sha512_asc">0.9.1 Official <a href="https://www.apache.org/dyn/closer.lua/plc4x/0.9.1/apache-plc4x-0.9.1-source-release.zip">source release</a> [ <a href="https://downloads.apache.org/plc4x/0.9.1/apache-plc4x-0.9.1-source-release.zip.sha512">SHA512</a> ] [ <a href="https://downloads.apache.org/plc4x/0.9.1/apache-plc4x-0.9.1-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is a bugfix release aiming at directly fixing CVE-2021-43083 as well as updating the dependency to Log4J 2.14.0 which was affected by CVE-2021-44228</p>
</div>
<div class="paragraph">
<p>Please note that CVE-2021-43083 only affects the PLC4C part of PLC4X.</p>
</div>
<div class="sect4">
<h5 id="bug_fixes">Bug Fixes</h5>
<div class="paragraph">
<p>CVE-2021-43083 Apache PLC4X 0.9.0 Buffer overflow in PLC4C via crafted server response</p>
</div>
</div>
</div>
</div>
<div class="sect2">
<h3 id="previous_releases">Previous Releases</h3>
<div class="sect3">
<h4 id="release-0_9_0">0.9.0 Official <a href="https://archive.apache.org/dist/plc4x/0.9.0/apache-plc4x-0.9.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.9.0/apache-plc4x-0.9.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.9.0/apache-plc4x-0.9.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is an ordinary PLC4X release, containing changes that
accumulated over time. It doesn&#8217;t have an explicit focus on
a particular topic.</p>
</div>
<div class="sect4">
<h5 id="new_features">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>The OPC UA driver has been replaced with a native driver. Previously
Eclipse Milo was being used.</p>
</li>
<li>
<p>Permit customized package names for code generation</p>
</li>
<li>
<p>Added an initial draft of a Discover and Browse API to PLC4J</p>
</li>
<li>
<p>PLC4Go now supports many more drivers</p>
</li>
<li>
<p>PLC4Go received a huge internal refactoring and cleanup</p>
</li>
<li>
<p>Major cleanup of PLC4C</p>
</li>
<li>
<p>S7 Driver now supports event and alarm handling on some S7 models</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes">Incompatible changes</h5>
</div>
<div class="sect4">
<h5 id="bug_fixes_2">Bug Fixes</h5>
<div class="paragraph">
<p>PLC4X-200 OPC-UA Driver not connecting if params string is not provided
PLC4X-201 OPC-UA PlcList underlying type not compatible with Eclipse Milo
PLC4X-202 OPC-UA Driver cannot write Unsigned Types
PLC4X-276 [S7] The most of the supported types don&#8217;t work correctly
PLC4X-278 Double Reading Error
PLC4X-279 nioEventLoopGroup thread proliferation
PLC4X-280 ADS route request swapped positions of route name and address
PLC4X-291 DefaultPlcSubscriptionField cannot be cast to class OpcuaField
PLC4X-298 [S7] When writing REAL values the Write
operation fails with an internal error
PLC4X-299 Modbus - Kafka Connect Configuration
PLC4X-312 CAN NOT READ STRING FROM S7 PLC
PLC4X-314 CAN NOT WRITING MANY DATA TO S7 ONE TIME</p>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_8_0">0.8.0 Official <a href="https://archive.apache.org/dist/plc4x/0.8.0/apache-plc4x-0.8.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.8.0/apache-plc4x-0.8.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.8.0/apache-plc4x-0.8.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is an ordinary PLC4X release, containing changes that
accumulated over time. It doesn&#8217;t have an explicit focus on
a particular topic.</p>
</div>
<div class="sect4">
<h5 id="new_features_2">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>The KNXnet/IP Driver now supports writing of values.</p>
</li>
<li>
<p>The Modbus driver now supports more common notations of Modbus addresses using a pure-numeric notation.</p>
</li>
<li>
<p>The ADS, KNX, Modbus, S7 and simulated drivers have been updated to support the IEC 61131-3 data-types.</p>
</li>
<li>
<p>We are now including PLC4Go as PLC4X implementation in the programming language Go(lang)</p>
</li>
<li>
<p>Integration with the Milo OPC UA Server is now available.</p>
</li>
<li>
<p>Kafka Connect workers have been updated source and sink connectors are now included.</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_2">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>The syntax of the S7 addresses changed slightly allowing to provide a string length. Without this, a STRING datatype will read 254 characters, by adding the size in round brackets to the type name will use the specified number.</p>
<div class="literalblock">
<div class="content">
<pre>Examples:</pre>
</div>
</div>
<div class="literalblock">
<div class="content">
<pre>Read one String which is max 10 chars long:
%DB2:30:STRING(10)</pre>
</div>
</div>
<div class="literalblock">
<div class="content">
<pre>Read an array of 3 Strings where each is max 10 chars long:
%DB2:30:STRING(10)[3]</pre>
</div>
</div>
</li>
<li>
<p>The PLCValue types have been refactored to align with the types defined in IEC 61131-3 (<a href="https://en.wikipedia.org/wiki/IEC_61131-3" class="bare">https://en.wikipedia.org/wiki/IEC_61131-3</a>) directly using the older Java types (PlcBoolean) is no longer possible.</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_3">Bug Fixes</h5>
<div class="paragraph">
<p>A lot of testing was done regarding the IEC 61131-3 data-types.
This resulted in numerous bugfixes in many protocols.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>PLC4X-132 [S7] Communication to S7 PLC dies in some situations</p>
</li>
<li>
<p>PLC4X-206 When writing short values exceptions are thrown while preparing the write request.</p>
</li>
<li>
<p>PLC4X-207 No registered handler found for message TPKTPacket[], using default decode method - Communication with S7 and Modbus device hangs</p>
</li>
<li>
<p>PLC4X-209 [S7] When writing INT and DINT values the Write operation fails with an internal error</p>
</li>
<li>
<p>PLC4X-210 [KNX] When running a KNX Tunneling Subscription for a longer time there are packets that kill the connection</p>
</li>
<li>
<p>PLC4X-211 PlcValues seem to always return "true" on the isXYZ" checks.</p>
</li>
<li>
<p>PLC4X-212 When writing multiple values in one request the item status is not correctly set</p>
</li>
<li>
<p>PLC4X-213 [Modbus] The Modbus driver doesn&#8217;t handle error responses gracefully</p>
</li>
<li>
<p>PLC4X-214 [Modbus] Holding register addresses have an offset of 1 (Not reading the correct address)</p>
</li>
<li>
<p>PLC4X-215 Drivers using the BaseOptimizer (SingleFieldOptimizer) don&#8217;t handle error responses gracefully</p>
</li>
<li>
<p>PLC4X-218 [Scraper] After stopping the scraper still the statistics are logged and the application doesn&#8217;t terminate</p>
</li>
<li>
<p>PLC4X-239 Read DTL (Date and Time)</p>
</li>
<li>
<p>PLC4X-240 Protocol error in reading string</p>
</li>
<li>
<p>PLC4X-246 S7 driver hangs on read</p>
</li>
<li>
<p>PLC4X-245 [Modbus] Apache NiFi processor throws java.io.IOException after a while</p>
</li>
<li>
<p>PLC4X-255 Kafka Connector Source Task doesn&#8217;t block within poll() resulting in high CPU usage.</p>
</li>
<li>
<p>PLC4X-261 Pooled connection manager returns a connection that isn&#8217;t connected in some situations.</p>
</li>
<li>
<p>PLC4X-272 When splitting up large requests, too big sub-requests are generated (S7)</p>
</li>
<li>
<p>PLC4X-256 ReadBuffer truncate last byte of even small payloads</p>
</li>
<li>
<p>PLC4X-262 Error in reading Array</p>
</li>
<li>
<p>PLC4X-270 Ads driver does not accept double-digit array indexes</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_7_0">0.7.0 Official <a href="https://archive.apache.org/dist/plc4x/0.7.0/apache-plc4x-0.7.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.7.0/apache-plc4x-0.7.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.7.0/apache-plc4x-0.7.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This version is the first after a major refactoring of the driver
core. All previous driver versions are now considered deprecated
and have been replaced by versions using the new driver structure
and generated driver codebase.</p>
</div>
<div class="sect4">
<h5 id="new_features_3">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>Drivers now support structured types using PlcValues</p>
</li>
<li>
<p>The EIP (EtherNet/IP) driver no longer requires an external
library and is implemented fully in the PLC4X project</p>
</li>
<li>
<p>The Modbus driver no longer requires an external library
and is implemented fully in the PLC4X project</p>
</li>
<li>
<p>The new S7 Driver supports writing multiple entries in one
request (The API allowed this from the beginning now not
every item is wrapped in a single request. It should bring
significant performance gains when writing multiple vlaues)</p>
</li>
<li>
<p>S7 Driver now supports String datatypes.</p>
</li>
<li>
<p>OSGi : Implementation of Drivers/Transports as OSGi services
to be able to use them in an OSGi container.</p>
</li>
<li>
<p>New Firmata protocol driver</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_3">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>Due to the refactoring of the driver core there might be issues
running drivers built against older core versions.</p>
</li>
<li>
<p>This version doesn&#8217;t provide a Beckhoff AMS/ADS driver as this
driver is still being ported to the new mspec format.</p>
</li>
<li>
<p>All drivers connection strings now follow the same pattern:
{protocol-code:(transport-code:)?//{transport-config}(?{params})?
Please check the drivers documentation on our website:
<a href="https://plc4x.apache.org/users/protocols/s7.html" class="bare">https://plc4x.apache.org/users/protocols/s7.html</a></p>
</li>
<li>
<p>The karaf-feature modules are removed as the drivers now all
provide both a feature.xml as well as a <code>kar</code> bundled archive</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_4">Bug Fixes</h5>
<div class="ulist">
<ul>
<li>
<p>PLC4X-174 UDP Transport does not accept ports containing 0</p>
</li>
<li>
<p>PLC4X-134 S7 is terminating the connection during handshake</p>
</li>
<li>
<p>PLC4X-192 Support for conversion of complex connection string parameters</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_6_0">0.6.0 Official <a href="https://archive.apache.org/dist/plc4x/0.6.0/apache-plc4x-0.6.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.6.0/apache-plc4x-0.6.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.6.0/apache-plc4x-0.6.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is the last release of PLC4X with the "handwritten" drivers.
This Minor release will thus receive updates and fixes until
most users have switched to 0.7 and above (with generated drivers).</p>
</div>
<div class="paragraph">
<p>If you are using the S7 Driver you should update to this Version
as the critical (memory leak) bug PLC4X-163 is fixed.</p>
</div>
<div class="sect4">
<h5 id="new_features_4">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>PLC4X-168 A shorter S7 Field Syntax is Introduced.
This release contains no further features and mostly stabilization.</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_4">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>Moved the C++, C# and Python drivers into the <code>sandbox</code></p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_5">Bug Fixes</h5>
<div class="ulist">
<ul>
<li>
<p>Fixed Promise Chain for InternalPlcWriteRequest</p>
</li>
<li>
<p>PLC4X-45 Add float support to Modbus Protocol</p>
</li>
<li>
<p>PLC4X-164 Fix wrong NOT FOUND exception in OPC UA Driver</p>
</li>
<li>
<p>PLC4X-166 Fixed Download Page</p>
</li>
<li>
<p>PLC4X-163 Fixed Netty ByteBuf Leaks for S7 Driver</p>
</li>
<li>
<p>PLC4X-158 Added Warning if no Pooled Driver is used for Scraper</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_5_0">0.5.0 Official <a href="https://archive.apache.org/dist/plc4x/0.5.0/apache-plc4x-0.5.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.5.0/apache-plc4x-0.5.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.5.0/apache-plc4x-0.5.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is the first release containing our new generated drivers (AB-ETH)</p>
</div>
<div class="sect4">
<h5 id="new_features_5">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>Implemented a new Apache Kafka Connect integration module</p>
</li>
<li>
<p>Implemented a new Apache NiFi integration module</p>
</li>
<li>
<p>Implemented a new Logstash integration module</p>
</li>
<li>
<p>Implemented a driver for the AB-ETH protocol</p>
</li>
<li>
<p>Implemented Apache Karaf features for S7 OSGI drivers</p>
</li>
<li>
<p>PLC4X-121 Develop Code Generation to allow Generated Drivers in multiple Languages</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Sandbox (Beta-Features)
- Implemented a new BACnet/IP passive mode driver
- Implemented a new Serial DF1 driver</p>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_5">Incompatible changes</h5>
</div>
<div class="sect4">
<h5 id="bug_fixes_6">Bug Fixes</h5>
<div class="ulist">
<ul>
<li>
<p>PLC4X-104 S7 Driver Datatype TIME_OF_DAY causes ArrayOutOfBoundException</p>
</li>
<li>
<p>PLC4X-134 S7 is terminating the connection during handshake</p>
</li>
<li>
<p>PLC4X-139 PLC4X leaks sockets in case of connection problems</p>
</li>
<li>
<p>PLC4X-141 String with real length of greater 127 throw an exception</p>
</li>
<li>
<p>PLC4X-144 When requesting invalid addresses, the DefaultS7MessageProcessor produces errors</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_4_0">0.4.0 Official <a href="https://archive.apache.org/dist/plc4x/0.4.0/apache-plc4x-0.4.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/plc4x/0.4.0/apache-plc4x-0.4.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/plc4x/0.4.0/apache-plc4x-0.4.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="paragraph">
<p>This is the first release of Apache PLC4X as top-level project.</p>
</div>
<div class="sect4">
<h5 id="new_features_6">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>The PlcConnection now supports a <code>ping</code> method to allow checking if an existing connection is still alive.</p>
</li>
<li>
<p>Support of the OPC-UA protocol with the <code>opc-ua-driver</code>.</p>
</li>
<li>
<p>Other Languages Support:&#8201;&#8212;&#8201;Added first versions of a C# .Net PLC4X API (<code>plc4net</code>)&#8201;&#8212;&#8201;Added first versions of a Python PLC4X API (<code>plc4py</code>)</p>
</li>
<li>
<p>Added an Interop server which allows to relay requests from other languages to a Java Server</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_6">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>ElasticSearch example was updated to use ElasticSearch 7.0.1, this might cause problems with older Kibana versions.</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_7">Bug Fixes</h5>
</div>
</div>
</div>
<div class="sect2">
<h3 id="incubating_releases">Incubating Releases</h3>
<div class="sect3">
<h4 id="0_3_1_incubating_official_source_release_sha512_asc">0.3.1 (incubating) Official <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.1-incubating/apache-plc4x-incubating-0.3.1-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.1-incubating/apache-plc4x-incubating-0.3.1-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.1-incubating/apache-plc4x-incubating-0.3.1-source-release.zip.asc">ASC</a> ]</h4>
<div class="sect4">
<h5 id="new_features_7">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>No new features</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_7">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>No incompatible changes.</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_8">Bug Fixes</h5>
<div class="ulist">
<ul>
<li>
<p>The S7 driver didn&#8217;t correctly handle "fill-bytes" in multi-item read-responses and multi-item write-requests</p>
</li>
<li>
<p>Fixed NPE when reading odd-length array of one-byte base types</p>
</li>
<li>
<p>Renamed flags "F" to Siemens Standard "M" (Marker)</p>
</li>
<li>
<p>Fixed a bug in the DefaultS7MessageProcessor which didn&#8217;t correctly merge together split up items</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_3_0">0.3.0 (incubating) Official <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.0-incubating/apache-plc4x-incubating-0.3.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.0-incubating/apache-plc4x-incubating-0.3.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.3.0-incubating/apache-plc4x-incubating-0.3.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="sect4">
<h5 id="new_features_8">New Features</h5>
<div class="ulist">
<ul>
<li>
<p>Object PLC Mapping (OPM) now has a Alias Registry to allow
variable substitution at runtime and write support</p>
</li>
<li>
<p>New module <code>plc-scraper</code> for applications that have to
scrape a lot of sps fields with high frequency</p>
</li>
<li>
<p>New integration <code>apache-karaf</code> to enable plc4j in a karaf
runtime environment</p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="incompatible_changes_8">Incompatible changes</h5>
<div class="ulist">
<ul>
<li>
<p>The 'plc4j-core' module has been merged into 'plc4j-api'.
So there is no 'plc4j-core' module anymore. Just remove that
dependency.</p>
</li>
<li>
<p>The driver artifact names have changed so if you were using
a <code>plc4j-protocol-{name}</code> you now need to change this to
<code>plc4j-driver-{name}</code></p>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="bug_fixes_9">Bug Fixes</h5>
<div class="ulist">
<ul>
<li>
<p>Fixing dependency to the wrap url-handler</p>
</li>
<li>
<p>When receiving responses with more than 512 byte, the IsoOnTcp protocol doesn&#8217;t work</p>
</li>
<li>
<p>When the last item in a request is a DINT, the DefaultS7MessageProcessor dies</p>
</li>
<li>
<p>Write operations seem to fail</p>
</li>
<li>
<p>Fixed a Bug where S7 was not able to read arrays.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_2_0">0.2.0 (incubating) Official <a href="https://archive.apache.org/dist/incubator/plc4x/0.2.0-incubating/apache-plc4x-incubating-0.2.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.2.0-incubating/apache-plc4x-incubating-0.2.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.2.0-incubating/apache-plc4x-incubating-0.2.0-source-release.zip.asc">ASC</a> ]</h4>
<div class="sect4">
<h5 id="changes">Changes:</h5>
<div class="ulist">
<ul>
<li>
<p>Changed API: instead of passing request object to <code>read({read-request})</code>, <code>write({write-request})</code> or <code>subscribe({subscribe-request})</code> methods now the <code>execute()</code> method is called on the request itself</p>
</li>
<li>
<p>New Connection Pool component</p>
</li>
<li>
<p>New OPM (Object PLC Mapping) component (JPA for PLCs)</p>
</li>
<li>
<p>Bug fixes</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="release-0_1_0">0.1.0 (incubating) Official <a href="https://archive.apache.org/dist/incubator/plc4x/0.1.0-incubating/apache-plc4x-incubating-0.1.0-source-release.zip">source release</a> [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.1.0-incubating/apache-plc4x-incubating-0.1.0-source-release.zip.sha512">SHA512</a> ] [ <a href="https://archive.apache.org/dist/incubator/plc4x/0.1.0-incubating/apache-plc4x-incubating-0.1.0-source-release.zip.asc">ASC</a> ]</h4>
</div>
</div>
</div>
</div>
</main>
<footer class="pt-4 my-md-5 pt-md-5 w-100 border-top">
<div class="row justify-content-md-center" style="font-size: 13px">
<div class="col col-6 text-center">
Copyright &#169; 2017&#x2013;2022 <a href="https://www.apache.org/">The Apache Software Foundation</a>.
All rights reserved.<br/>
Apache PLC4X, PLC4X, Apache, the Apache feather logo, and the Apache PLC4X project logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
<br/><div style="text-align:center;">Home screen image taken from <a
href="https://flic.kr/p/chEftd">Flickr</a>, "Tesla Robot Dance" by Steve Jurvetson, licensed
under <a href="https://creativecommons.org/licenses/by/2.0/">CC BY 2.0 Generic</a>, image cropped
and blur effect added.</div>
</div>
</div>
</footer>
</div>
</div>
<!-- Bootstrap core JavaScript
================================================== -->
<!-- Placed at the end of the document so the pages load faster -->
<script src="../js/jquery.slim.min.js"></script>
<script src="../js/popper.min.js"></script>
<script src="../js/bootstrap.min.js"></script>
<script type="text/javascript">
$('.carousel .carousel-item').each(function(){
var next = $(this).next();
if (!next.length) {
next = $(this).siblings(':first');
}
next.children(':first-child').clone().appendTo($(this));
for (let i = 0; i < 3; i++) {
next=next.next();
if (!next.length) {
next = $(this).siblings(':first');
}
next.children(':first-child').clone().appendTo($(this));
}
});
</script>
</body>
</html>