You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@plc4x.apache.org by cd...@apache.org on 2021/09/18 16:09:58 UTC

svn commit: r50000 - in /dev/plc4x/rc2: ./ README RELEASE_NOTES apache-plc4x-0.9.0-source-release.zip apache-plc4x-0.9.0-source-release.zip.asc apache-plc4x-0.9.0-source-release.zip.sha512

Author: cdutz
Date: Sat Sep 18 16:09:58 2021
New Revision: 50000

Log:
Staging rc2 of PLC4x 0.9.0

Added:
    dev/plc4x/rc2/
    dev/plc4x/rc2/README
    dev/plc4x/rc2/RELEASE_NOTES
    dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip   (with props)
    dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.asc
    dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.sha512

Added: dev/plc4x/rc2/README
==============================================================================
--- dev/plc4x/rc2/README (added)
+++ dev/plc4x/rc2/README Sat Sep 18 16:09:58 2021
@@ -0,0 +1,305 @@
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+  -->
+[![Maven central](https://img.shields.io/maven-central/v/org.apache.plc4x/plc4j-api.svg)](https://img.shields.io/maven-central/v/org.apache.plc4x/plc4j-api.svg)
+[![License](https://img.shields.io/github/license/apache/plc4x.svg)](http://www.apache.org/licenses/LICENSE-2.0)
+[![Last commit](https://img.shields.io/github/last-commit/apache/plc4x.svg)]()
+[![Twitter](https://img.shields.io/twitter/follow/ApachePLC4X.svg?label=Follow&style=social)](https://twitter.com/ApachePLC4X)
+
+
+<h1 align="center">
+  <br>
+   <img src="https://plc4x.apache.org/images/apache_plc4x_logo.png" 
+   alt="Apache PLC4X Logo" title="Apache PLC4X Logo"/>
+  <br>
+</h1>
+<h3 align="center">The Industrial IoT adapter</h3>
+<h4 align="center">The ultimate goal of PLC4X is to create a set of libraries, that allow unified access to any type of
+ PLC</h4>
+
+***
+
+# Table of contents
+
+  * [About PLC4X](#about-apache-plc4x)
+  * [Getting Started](#getting-started)
+  * [Developers](#developers)
+  * [Community](#community)
+  * [Contributing](#contributing)
+  * [Licensing](#licensing)
+
+***
+
+## About Apache PLC4X
+
+Apache PLC4X is an effort to create a set of libraries for communicating with industrial grade programmable logic controllers (PLCs) in a uniform way.
+We are planning on shipping libraries for usage in:
+
+1. Java
+2. Go
+3. C/C++ (not ready for usage)
+4. Python (not ready for usage)
+5. C# (.Net) (not ready for usage)
+
+PLC4X also integrates with other Apache projects, such as:
+
+* [Apache Calcite](https://calcite.apache.org/)
+* [Apache Camel](https://camel.apache.org/)
+* [Apache Edgent](https://edgent.apache.org/)
+* [Apache Kafka-Connect](https://kafka.apache.org)
+* [Apache Karaf](https://karaf.apache.org/)
+* [Apache NiFi](https://nifi.apache.org/)
+
+## Getting started
+
+Depending on the programming language, the usage will differ, therefore please go to the 
+[Getting Started](https://plc4x.apache.org/users/gettingstarted.html) on the PLC4X website to look up 
+the language of choice.
+
+### Java
+
+NOTE: Currently the Java version which supports building of all parts of Apache PLC4X is exactly Java 11
+(Higher versions can't build the Logstash integration and lower versions can't build the CMake dependent parts).
+
+See the PLC4J user guide on the website to start using PLC4X in your Java application:
+[https://plc4x.apache.org/users/getting-started/plc4j.html](https://plc4x.apache.org/users/getting-started/plc4j.html)
+
+## Developers
+
+### Environment
+
+Currently, the project is configured to require the following software:
+
+1. Java 8 JDK: For running Maven in general as well as compiling the Java and Scala modules `JAVA_HOME` configured to
+ point to that.
+2. libpcap/WinPcap for raw socket tests in Java or use of `passive-mode` drivers
+3. (Optional) [Graphviz](https://www.graphviz.org/) : For generating the graphs in the documentation
+4. Git (even when working on the source distribution)
+
+With this setup you will be able to build the Java part of PLC4X excluding the "proxy" drivers and servers.
+For a full build of PLC4X with all options the following has to be provided:
+
+#### Linux
+
+On a clean Ubuntu 18.04 the following software needs to be installed:
+
+```
+    sudo apt install python-setuptools gcc g++ make libpcap-dev
+```
+
+If you're building a source-distribution and haven't installed git yet, be sure to do so:
+
+```
+    sudo apt install git
+```
+
+In order to build the .Net version, please install the .Net package according to this guide:
+
+https://dev.to/carlos487/installing-dotnet-core-in-ubuntu-1804-7lp
+
+#### Mac
+
+Make sure `Homebrew` ist installed in order to update `Bison` to a newer version (the version 2.3 installed per default is too old)
+
+```
+    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+```
+
+Then update `Bison`:
+
+```
+    brew install bison
+    brew link bison --force
+    echo 'export PATH="/usr/local/opt/bison/bin:$PATH"' >> ~/.bash_profile
+```
+
+Install `Python 2.7`:
+
+```
+    brew install python@2
+```
+
+Be sure to re-open the command window or the changes will not apply.
+
+If you're going to build the `with-dotnet` profile you also need to install DotNet.
+Please download it from: https://dotnet.microsoft.com/download and run the installer.
+
+LibPCAP is also installed via Homebrew:
+
+```
+    brew install libpcap
+```
+
+#### Windows
+
+Some tools need to be installed before being able to build on Windows:
+
+* WinBuilds (for `with-cpp`, `with-proxies` profiles)
+* Bison (for `with-cpp` profiles)
+* Flex (for `with-cpp` profiles)
+* Python 2.7 (for `with-python`, `with-proxies` profiles)
+* Dotnet (for `with-dotnet` profiles)
+* WinPCAP
+* OpenSSL
+
+We have tested `WinBuilds` with the bundle of: http://win-builds.org/doku.php/download_and_installation_from_windows
+Run the installer as "Administrator" or you won't be able to install it to every location.
+Please install it to a location, for which the path doesn't contain any whitespaces.
+When running the installer, make sure to select the options:
+* Native Windows
+* x86_64
+Not quite sure which elements are really needed, better just install all of them.
+If the installer fails to do something complaining about having to use a different mirror, enter "http://win-builds.org/1.5.0" as mirror address.
+
+WARNING: If you don't use the installer version of the distribution. The build will probably fail and it will be pretty
+impossible to see the problem. When manually executing the command, a popup will appear complaining about not being able
+to find some DLL. So if you are having these problems, please try using the installer instead of manually unpacking
+the archive.
+
+For `Bison`, please download the Setup installer version from here: http://gnuwin32.sourceforge.net/packages/bison.htm (When using the zip version the bison.exe couldn't find some DLL files)
+It seems the official 2.4.1 version has issues when installed in a directory which's path contains spaces. Please make sure you replace the exe with a patched version form here: http://marin.jb.free.fr/bison/bison-2.4.1-modified.zip
+(More infos on this issue here: https://sourceforge.net/p/gnuwin32/bugs/473/)
+
+Please download the `Flex` compiler from here: http://gnuwin32.sourceforge.net/packages/flex.htm (Ideally download the binary zip distribution)
+
+You can get `Python` from here: https://www.python.org/downloads/release/python-2716/
+
+For `.Net`, you need the `Developer Pack` in order to build .Net applications. So be sure to get a reasonably fresh installation from https://dotnet.microsoft.com
+
+If you're building a source-distribution and haven't installed git yet, be sure to do so.
+
+The Windows version of the PCAP library can be found here: https://sourceforge.net/projects/winpcap413-176/
+(In order to read PCAPNG files we require a libpcap version 1.1.0 or greater. The default
+Windows version is 1.0. At this location there is a patched version based on libpcap 1.7.4)
+
+Last not least we need to install OpenSSL, which is available from here: https://indy.fulgan.com/SSL/
+The letter at the end of the version is sort of a "sub-minor" version, so I usually just take the version with the highest letter.
+
+Make sure the `bin` directories of containing the executables `mingw32-make.exe`, `bison.exe` and `flex.exe` are all on your systems `PATH` as well as the directory containing the `openssl.exe`.
+
+### Building with Docker
+
+If you don't want to bother setting up the environment on your normal system and you have Docker installed, you can also build everything in a Docker container:
+
+```
+   docker build -t plc4x .
+```
+
+### Getting Started
+
+You must have at least Java 8 installed on your system and connectivity to Maven Central
+(for downloading external third party dependencies). However in order to build all parts
+of PLC4X exactly Java 11 is required. Maven 3.6 is required to build, so be sure it's installed and available on your system. 
+
+NOTE: There is a convenience Maven-Wrapper installed in the repo, when used, this automatically downloads and installs Maven. If you want to use this, please use `./mvnw` or `mvnw` instead of the normal `mvn` command.
+
+NOTE: When running from sources-zip, the `mvnw` might not be executable on `Mac` or `Linux`. This can easily be fixed by running the following command in the directory.
+
+```
+$ chmod +x mvnw
+```
+
+NOTE: If you are working on a `Windows` system, please use `mvnw.cmd` instead of `./mvnw` in the following build commands.
+
+Build PLC4X Java jars and install them in your local maven repository
+
+```
+./mvnw install # add -DskipTests to omit running the tests
+```
+
+You can now construct Java applications that use PLC4X. The PLC4X examples
+are a good place to start and are available inside the `plc4j/examples`
+directory.
+
+The `Go` drivers can be built by enabling the `with-go` profile:
+
+```
+./mvnw -P with-go install  # add -DskipTests to omit running the tests
+```
+
+NOTE: The C++ build is considered experimental and currently not working properly.
+
+The `C++` drivers are still under development and still not really usable. 
+Therefore, they are located in the so-called `sandbox`. Also does it rely on a 
+library called, `boost`, which needs to also be built.
+
+If you want to build them, this has to be enabled by activating the `with-boost`, `with-sandbox` and `with-cpp` maven profiles:
+
+```
+./mvnw -P with-boost,with-sandbox,with-cpp install  # add -DskipTests to omit running the tests
+```
+
+The `C# / .Net` implementation is currently in a `work in progress` state.
+In order to be able to build the `C# / .Net` module, you currently need to activate the:
+`with-sandbox` and `with-dotnet` profiles.
+
+```
+./mvnw -P with-sandbox,with-dotnet install  # add -DskipTests to omit running the tests
+```
+
+The Python implementation is currently in a somewhat unclean state and still needs refactoring.
+In order to be able to build the Python module, you currently need to activate the:
+`with-sandbox` and `with-python` profiles.
+
+```
+./mvnw -P with-sandbox,with-python install  # add -DskipTests to omit running the tests
+```
+
+In order to build everything the following command should work:
+
+```
+./mvnw -P with-c,with-dotnet,with-go,with-python,with-sandbox install
+```
+
+## Community
+
+Join the PLC4X community by using one of the following channels. We'll be glad to help!
+
+### Mailing Lists
+
+Subscribe to the following mailing lists: 
+* Apache PLC4X Developer List: [dev-subscribe@plc4x.apache.org](mailto:dev-subscribe@plc4x.apache.org)
+* Apache PLC4X Commits List: [commits-subscribe@plc4x.apache.org](mailto:commits-subscribe@plc4x.apache.org)
+* Apache PLC4X Jira Notification List: [issues-subscribe@plc4x.apache.org](mailto:issues-subscribe@plc4x.apache.org)
+
+See also: [https://plc4x.apache.org/mailing-lists.html](https://plc4x.apache.org/mailing-lists.html)
+
+### Twitter
+
+Get the latest PLC4X news on Twitter: [https://twitter.com/ApachePlc4x](https://twitter.com/ApachePlc4x)
+
+## Contributing
+
+There are multiple forms in which you can become involved with the PLC4X project.
+
+These usually are, but are not limited to:
+
+* Submitting Pull Requests
+* Filing Bug-Reports
+* Active communication on our mailing lists
+* Promoting the project (articles, blog posts, talks at conferences)
+* Documentation
+
+We are a very friendly bunch and don’t be afraid to step forward.
+If you'd like to contribute to PLC4X, have a look at our 
+[contribution guide](https://plc4x.apache.org/developers/contributing.html)!
+
+
+## Licensing
+
+Apache PLC4X is released under the Apache License Version 2.0.

Added: dev/plc4x/rc2/RELEASE_NOTES
==============================================================================
--- dev/plc4x/rc2/RELEASE_NOTES (added)
+++ dev/plc4x/rc2/RELEASE_NOTES Sat Sep 18 16:09:58 2021
@@ -0,0 +1,433 @@
+==============================================================
+Apache PLC4X 0.9.0
+==============================================================
+
+New Features
+------------
+
+- The OPC UA driver has been replaced with a native driver. Previously
+  Eclipse Milo was being used.
+
+- Permit customized package names for code generation
+
+- Added an initial draft of a Discover and Browse API to PLC4J
+
+- Replaced the OPC-UA driver using Eclipse Milo with a our own, fully
+  generated, version
+
+- PLC4Go now supports many more drivers
+
+- PLC4Go received a huge internal refactoring and cleanup
+
+- Major cleanup of PLC4C
+
+- S7 Driver now supports event and alarm handling on some S7 models
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+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'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
+
+==============================================================
+Apache PLC4X 0.8.0
+==============================================================
+
+This is an ordinary PLC4X release, containing changes that
+accumulated over time. It doesn't have an explicit focus on
+a particular topic.
+
+New Features
+------------
+
+- The KNXnet/IP Driver now supports writing of values.
+
+- The Modbus driver now supports more common notations of
+  Modbus addresses using a pure-numeric notation.
+
+- The ADS, KNX, Modbus, S7 and simulated drivers have been
+  updated to support the IEC 61131-3 data-types.
+
+- We are now including PLC4Go as PLC4X implementation in
+  the programming language Go(lang)
+
+- Integration with the Milo OPC UA Server is now available.
+
+- Kafka Connect workers have been updated source and sink connectors
+  are now included.
+
+Incompatible changes
+--------------------
+
+- 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.
+
+  Examples:
+
+  Read one String which is max 10 chars long:
+  %DB2:30:STRING(10)
+
+  Read an array of 3 Strings where each is max 10 chars long:
+  %DB2:30:STRING(10)[3]
+
+- The PLCValue types have been refactored to align with the types
+  defined in IEC 61131-3 (https://en.wikipedia.org/wiki/IEC_61131-3)
+  directly using the older Java types (PlcBoolean) is no longer
+  possible.
+
+Bug Fixes
+---------
+
+A lot of testing was done regarding the IEC 61131-3 data-types.
+This resulted in numerous bugfixes in many protocols.
+
+PLC4X-132   [S7] Communication to S7 PLC dies in some situations
+PLC4X-206   When writing short values exceptions are thrown
+            while preparing the write request.
+PLC4X-207   No registered handler found for message TPKTPacket[],
+            using default decode method - Communication with S7
+            and Modbus device hangs
+PLC4X-209   [S7] When writing INT and DINT values the Write
+            operation fails with an internal error
+PLC4X-210   [KNX] When running a KNX Tunneling Subscription
+            for a longer time there are packets that kill
+            the connection
+PLC4X-211   PlcValues seem to always return "true" on the
+            isXYZ" checks.
+PLC4X-212   When writing multiple values in one request the
+            item status is not correctly set
+PLC4X-213   [Modbus] The Modbus driver doesn't handle error
+            responses gracefully
+PLC4X-214   [Modbus] Holding register addresses have an offset
+            of 1 (Not reading the correct address)
+PLC4X-215   Drivers using the BaseOptimizer
+            (SingleFieldOptimizer) don't handle error responses
+            gracefully
+PLC4X-218   [Scraper] After stopping the scraper still the
+            statistics are logged and the application doesn't
+            terminate
+PLC4X-239   Read DTL (Date and Time)
+PLC4X-240   Protocol error in reading string
+PLC4X-246	S7 driver hangs on read
+PLC4X-245   [Modbus] Apache NiFi processor throws
+            java.io.IOException after a while
+PLC4X-255   Kafka Connector Source Task doesn't block within poll()
+            resulting in high CPU usage.
+PLC4X-261   Pooled connection manager returns a connection that isn't
+            connected in some situations.
+PLC4X-272   When splitting up large requests, too big sub-requests
+            are generated (S7)
+PLC4X-256	ReadBuffer truncate last byte of even small payloads
+PLC4X-262	Error in reading Array
+PLC4X-270	Ads driver does not accept double-digit array indexes
+
+==============================================================
+Apache PLC4X 0.7.0
+==============================================================
+
+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.
+
+New Features
+------------
+
+- Drivers now support structured types using PlcValues
+- The EIP (EtherNet/IP) driver no longer requires an external
+  library and is implemented fully in the PLC4X project
+- The Modbus driver no longer requires an external library
+  and is implemented fully in the PLC4X project
+- 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)
+- S7 Driver now supports String datatypes.
+- OSGi : Implementation of Drivers/Transports as OSGi services
+  to be able to use them in an OSGi container.
+- New Firmata protocol driver
+
+Incompatible changes
+--------------------
+
+- Due to the refactoring of the driver core there might be issues
+  running drivers built against older core versions.
+- This version doesn't provide a Beckhoff AMS/ADS driver as this
+  driver is still being ported to the new mspec format.
+- All drivers connection strings now follow the same pattern:
+  {protocol-code:(transport-code:)?//{transport-config}(?{params})?
+  Please check the drivers documentation on our website:
+  https://plc4x.apache.org/users/protocols/s7.html
+- The karaf-feature modules are removed as the drivers now all
+  provide both a feature.xml as well as a `kar` bundled archive
+
+Bug Fixes
+---------
+
+PLC4X-174	UDP Transport does not accept ports containing 0
+PLC4X-134   S7 is terminating the connection during handshake
+PLC4X-192   Support for conversion of complex connection string
+            parameters
+
+==============================================================
+Apache PLC4X 0.6.0
+==============================================================
+
+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).
+
+If you are using the S7 Driver you should update to this Version
+as the critical (memory leak) bug PLC4X-163 is fixed.
+
+New Features
+------------
+- PLC4X-168 A shorter S7 Field Syntax is Introduced.
+This release contains no further features and mostly stabilization.
+
+Incompatible changes
+--------------------
+- Moved the C++, C# and Python drivers into the `sandbox`
+
+Bug Fixes
+---------
+- Fixed Promise Chain for InternalPlcWriteRequest
+- PLC4X-45 Add float support to Modbus Protocol
+- PLC4X-164 Fix wrong NOT FOUND exception in OPC UA Driver
+- PLC4X-166 Fixed Download Page
+- PLC4X-163 Fixed Netty ByteBuf Leaks for S7 Driver
+- PLC4X-158 Added Warning if no Pooled Driver is used for Scraper
+
+==============================================================
+Apache PLC4X 0.5.0
+==============================================================
+
+This is the first release containing our new generated drivers (AB-ETH)
+
+New Features
+------------
+
+- Implemented a new Apache Kafka Connect integration module
+- Implemented a new Apache NiFi integration module
+- Implemented a new Logstash integration module
+- Implemented a driver for the AB-ETH protocol
+- Implemented Apache Karaf features for S7 OSGI drivers
+- PLC4X-121	Develop Code Generation to allow Generated Drivers in multiple Languages
+
+Sandbox (Beta-Features)
+- Implemented a new BACnet/IP passive mode driver
+- Implemented a new Serial DF1 driver
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+- PLC4X-104	S7 Driver Datatype TIME_OF_DAY causes ArrayOutOfBoundException
+- PLC4X-134	S7 is terminating the connection during handshake
+- PLC4X-139	PLC4X leaks sockets in case of connection problems
+- PLC4X-141	String with real length of greater 127 throw an exception
+- PLC4X-144	When requesting invalid addresses, the DefaultS7MessageProcessor produces errors
+
+==============================================================
+Apache PLC4X 0.4.0
+==============================================================
+
+This is the first release of Apache PLC4X as top-level project.
+
+New Features
+------------
+
+- The PlcConnection now supports a `ping` method to allow checking if an existing connection is still alive.
+- Support of the OPC-UA protocol with the `opc-ua-driver`.
+- Other Languages Support:
+-- Added first versions of a C# .Net PLC4X API (`plc4net`)
+-- Added first versions of a Python PLC4X API (`plc4py`)
+- Added an Interop server which allows to relay requests from other languages to a Java Server
+
+Incompatible changes
+--------------------
+
+- ElasticSearch example was updated to use ElasticSearch 7.0.1, this might cause problems with older Kibana versions.
+
+Bug Fixes
+---------
+
+
+==============================================================
+Apache PLC4X (incubating) 0.3.1
+==============================================================
+
+This is a bugfix-release, that fixes some problems with S7 driver.
+
+Bug Fixes
+---------
+
+- The S7 driver didn't correctly handle "fill-bytes" in multi-item read-responses and multi-item write-requests
+- PLC4X-83: fixed NPE when reading odd-length array of one-byte base types
+- PLC4X-82: renamed flags "F" to Siemens Standard "M" (Marker)
+- PLC4X-84: Fixed a bug in the DefaultS7MessageProcessor which didn't correctly merge together split up items
+
+
+==============================================================
+Apache PLC4X (incubating) 0.3.0
+==============================================================
+
+This is the third official release of Apache PLC4X.
+
+Some new features have been added (e.g. plc-scraper) multiple
+new integrations are included (apache-karaf, apache-calcite)
+and a lot of (technical) refactoring has been done to prepare
+future work on adapters in different languages.
+
+New Features
+------------
+
+- Object PLC Mapping (OPM) now has a Alias Registry to allow
+  variable substitution at runtime and write support
+- New module `plc-scraper` for applications that have to
+  scrape a lot of sps fields with high frequency
+- New integration `apache-karaf` to enable plc4j in a karaf
+  runtime environment
+
+Incompatible changes
+--------------------
+- The 'plc4j-core' module has been merged into 'plc4j-api'.
+  So there is no 'plc4j-core' module anymore. Just remove that
+  dependency.
+- The driver artifact names have changed so if you were using
+  a `plc4j-protocol-{name}` you now need to change this to
+  `plc4j-driver-{name}`
+
+Bug Fixes
+---------
+
+PLC4X-75    Fixing dependency to the wrap url-handler
+PLC4X-76    When receiving responses with more than 512 byte,
+            the IsoOnTcp protocol doesn't work
+PLC4X-77    When the last item in a request is a DINT, the
+            DefaultS7MessageProcessor dies
+PLC4X-78    Write operations seem to fail
+-           Fixed a Bug where S7 was not able to read arrays.
+
+
+==============================================================
+Apache PLC4X (incubating) 0.2.0
+==============================================================
+
+This is the second official release of Apache PLC4X.
+
+Especially have we addressed all issues reported during
+our first release, that were of non-technical nature.
+These were tracked in:
+
+PLC4X-60	Fix findings by the last release
+
+New Features
+------------
+A new connection-pool was added, which allows automatic
+pooling and reuse of PLC connections.
+
+A new OPM module was added, which allows JPA like read-
+communication using POJOs, very similar to JPA.
+
+A stub of a new driver for the Emerson DeltaV protocol
+has been added, but is not yet a fully functional PLC4X
+driver. This is also a first test of our new `passive-
+mode-driver` concept.
+
+Incompatible changes
+--------------------
+
+We have refactored the API in order to eliminate the
+need of passing `x-requests` to `x-methods` and added
+an `execute` method to each request type. This greatly
+simplifies the client code. However this requires
+refactoring of applications using the direct PLC4X API.
+
+Miscellaneous changes
+---------------------
+
+We have increased the test coverage greatly and fixed
+a lot of little errors we found on the way.
+
+Known Issues
+------------
+
+Bug Fixes
+---------
+
+PLC4X-56	[S7] S7Field does not recognize addresses
+            with numElements present
+PLC4X-57	[S7] Response for address with numElements
+            contains only first item
+PLC4X-61	Installation fails plc4j-protocoll-ethernetip
+            needs license
+PLC4X-62	Modbus results deliver null-Value due to missing
+            implementation of getShort, getLong ...
+
+
+
+==============================================================
+Apache PLC4X (incubating) 0.1.0
+==============================================================
+
+This is the first official release of Apache PLC4X.
+It contains drivers for the following protocols:
+- Siemens S7comm (0x32)
+- Beckhoff ADS
+- Modbus
+- EtherNet/IP
+
+However the Siemens driver definitely is the most
+mature driver, the rest should be treated experimental.
+
+New Features
+------------
+
+PLC4X-29	[S7] Implement PDU Fragmentation
+PLC4X-39	Extend the Edgent integration with the new Subscription features of PLC4X
+
+Incompatible changes
+--------------------
+
+- NONE -
+
+Miscellaneous changes
+---------------------
+
+- NONE -
+
+Known Issues
+------------
+
+- NONE -
+
+Most drivers should be treated experimental and are not near production ready.
+The S7 driver is probably the furthest implemented and tested driver and hereby can be
+considered to be the most mature.
+
+Bug Fixes
+---------
+
+PLC4X-20	Jacoco doesn't seem to be working at all
+PLC4X-21	Code coverage doesn't seem to work
+PLC4X-47	S7 driver silently ignores surplus ReadRequestItems
+PLC4X-48	S7 driver failes to parse response with multiple items

Added: dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip
==============================================================================
Binary file - no diff available.

Propchange: dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.asc
==============================================================================
--- dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.asc (added)
+++ dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.asc Sat Sep 18 16:09:58 2021
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEE8VaBP/MVAH42umwTCJEnwVxg1rkFAmFGCCEACgkQCJEnwVxg
+1rk5HA//UNFumAaxs3FJGRy9bYY2kAt+niIb5MH2PCKG5up4uIRB+4RQakuZ4Jl8
+6SStSgoA8ThaTHgu48KiN2wKvOlbiapDh+eKDlTrDJT8bFAfrBbs1uasH3QQEYsM
+88JH7BLlCIA/zS8BWkjAA04j9BWSb6c580wcNJFn2Ii32audQuv8LysoEpzU7juA
+9AmY2/2UI1Qlh0hTTQCXtq3XvvWTepTyMvrDX2MQNi4iPu2sZym4zoojkAxDB0I7
+zpLZEHl7WhKFd6RgPzzKTx3EUoJeBRpA9TpXkuP/1IucCRsLBpG9n1GIWB2RmPrK
+kizycoywaJ4V28vosYA6fqK4PYmdzZ3LXGav6BpghkXuJf3dKixcI7z0gqaQPUPq
+MLp7BxRPP3Krb7BMsnSbhElwxid8j/H6sHvgiGH/25T1aFIQw/LVa4hGwRTyOAJo
+lT8s8D7540iETgpqAm13beuZ+HP2FaCY/awISHIcuxmxlZeWertsCnRv251TeiAi
+Bpk7PWqM8iEFytCfD6NF8JgQMGb0ZpkbXuyq4SpA9n2bHOrQHjHFIFaJ/4skSuXW
+WlwXJ8YioBeJMWxPqj7eE9P+9UnJUJH9ZQevcmUd64DFF/lxOK4Gp/GZRLVtFlf1
+IxF/rCzhoRK2wtEkEsYEb5ZGcXhpvtuGBmfge9QbLIow0TWeozk=
+=zG2s
+-----END PGP SIGNATURE-----

Added: dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.sha512
==============================================================================
--- dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.sha512 (added)
+++ dev/plc4x/rc2/apache-plc4x-0.9.0-source-release.zip.sha512 Sat Sep 18 16:09:58 2021
@@ -0,0 +1 @@
+419c95839c8708a8ed6757be11aa2080cccda509cef938a9f51c62b151ddea82804cad0090645f470ca121a7069adbe622d7ec5076a51b79d0b316cff63b0efe
\ No newline at end of file