You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@plc4x.apache.org by jf...@apache.org on 2019/01/28 08:45:14 UTC
svn commit: r32158 - in /dev/incubator/plc4x/0.3.0-incubating/rc2: ./ README
RELEASE_NOTES apache-plc4x-incubating-0.3.0-source-release.zip
apache-plc4x-incubating-0.3.0-source-release.zip.asc
apache-plc4x-incubating-0.3.0-source-release.zip.sha512
Author: jfeinauer
Date: Mon Jan 28 08:45:14 2019
New Revision: 32158
Log:
Added rc2 artifacts for plc4x
Added:
dev/incubator/plc4x/0.3.0-incubating/rc2/
dev/incubator/plc4x/0.3.0-incubating/rc2/README
dev/incubator/plc4x/0.3.0-incubating/rc2/RELEASE_NOTES
dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip (with props)
dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.asc
dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.sha512
Added: dev/incubator/plc4x/0.3.0-incubating/rc2/README
==============================================================================
--- dev/incubator/plc4x/0.3.0-incubating/rc2/README (added)
+++ dev/incubator/plc4x/0.3.0-incubating/rc2/README Mon Jan 28 08:45:14 2019
@@ -0,0 +1,89 @@
+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) Scala
+3) C/C++
+
+As well as provide direct integration into other Apache projects, such as:
+
+1) Apache Calcite
+2) Apache Camel
+3) Apache Edgent
+4) Apache Kafka-Connect
+5) Apache Karaf
+6) Apache NiFi
+
+
+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
+3) (Optional) Graphwiz: For generating the graphs in the documentation (http://www.graphviz.org/)
+
+
+Getting Started
+---------------
+
+You must have Java 8 installed on your system and connectivity to Maven Central
+(for downloading external third party dependencies). Maven will be automatically
+downloaded and installed by the maven wrapper `mvnw`.
+
+Build PLC4X jars and install them in your local maven repository
+
+$ ./mvnw install # add -DskipTests to omit running the tests
+
+You can now construct applications that use PLC4X. The PLC4X samples
+are a good place to start and are available inside the `examples`
+directory.
+
+
+Installing libpcap/WinPcap
+--------------------------
+
+Some parts of PLC4X, especially the raw socket support, require installed versions
+of libpcap/WinPcap.
+
+You can download the Mac/Linux version from: http://www.tcpdump.org/
+The windows version 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 is a patched version based on libpcap 1.7.4)
+
+
+Building the C++ libraries
+--------------------------
+
+When building the C++ libraries we require an installed `gcc` compiler.
+On Mac and Linux this is usually the case.
+On a minimal Ubuntu Linux system the following modules needed to be installed
+manually:
+
+- gcc
+- g++
+- make
+
+On Windows the required compiler is generally not available per default.
+The build is optimized for using a gcc-port called MinGW, available from
+http://win-builds.org/doku.php/download_and_installation_from_windows
+Make sure the `bin` directory containing the executable `mingw32-make.exe`
+is on your systems `PATH`.
+
+
+Licensing
+---------
+
+Apache PLC4X is released under the Apache License Version 2.0.
+
+Apache PLC4X is an effort undergoing incubation at The Apache Software Foundation (ASF),
+sponsored by the Incubator PMC. Incubation is required of all newly accepted
+projects until a further review indicates that the infrastructure, communications,
+and decision making process have stabilized in a manner consistent with other
+successful ASF projects. While incubation status is not necessarily a reflection
+of the completeness or stability of the code, it does indicate that the project
+has yet to be fully endorsed by the ASF.
Added: dev/incubator/plc4x/0.3.0-incubating/rc2/RELEASE_NOTES
==============================================================================
--- dev/incubator/plc4x/0.3.0-incubating/rc2/RELEASE_NOTES (added)
+++ dev/incubator/plc4x/0.3.0-incubating/rc2/RELEASE_NOTES Mon Jan 28 08:45:14 2019
@@ -0,0 +1,145 @@
+==============================================================
+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/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip
==============================================================================
Binary file - no diff available.
Propchange: dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.asc
==============================================================================
--- dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.asc (added)
+++ dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.asc Mon Jan 28 08:45:14 2019
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEErb1CjLW/bJ/8d7kHwzbgFDpVO4kFAlxOKVEACgkQwzbgFDpV
+O4la5hAAg2IZ4jV2+WdgpudnMblUTmv1FXGKgeEOg7bc4bXxZ1iMvoiEcBqnzfRT
+NEuopAhvXe/MauiHSWUyA/UuAzflLDUxPpFuLQooIZVVps0B+dj+FEjlanJg5/ML
+V1B1/LcNW6ej2VNMi5RQLOoHlrCTFsKGZQnp3TQkYP2B2QiJNId96GT2qVPiC2XT
+hxZMZzQSVzBOyTo7q+Xg6q/NlXcvI/Y7UwY1L14lo5jfZqn4ARgy4FYjFjkR53bx
+jwwGKRq5w0rew3//caRgnHuyaVipS1tFyAW3FMjzf/JzG5qbIZtktEb44YnFTFXe
+di9c3AXhmGd3Vj3kO29GLA2mgZiDu7HBBhUORb5Cib/+3SFuw4FQJDaU6VLWXraG
+u8x4AxC56pv9y3Y3SBcqzdi/y6egb4u1IhsM6idima7za55L1W8BCk+ZuQ/AkGX8
+v5L+q5y0xxhGUgB51FcQDVWQUiGc8cz7u32nK5lLEq6/j4EsQus1Rh3u4jUrPzW9
+bnvbvDHKzJS2z+qLT4PWjMr1A0LS9m1sw6rwODpdYd998j2kwxolRFqYYtusAnlZ
+xqxJUgZ2qc517HWrwlb7R5+roguLj+WvhQ2Ze1asPBkqtLYRjX7DeTMt25Tmt56U
+InRDqZfztAxMXjTSQDi0KUfzOBbVu3Nkt0+k4r+KBc1sBHDCk+w=
+=TajX
+-----END PGP SIGNATURE-----
Added: dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.sha512
==============================================================================
--- dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.sha512 (added)
+++ dev/incubator/plc4x/0.3.0-incubating/rc2/apache-plc4x-incubating-0.3.0-source-release.zip.sha512 Mon Jan 28 08:45:14 2019
@@ -0,0 +1 @@
+3797406e764e3fe7cc908803add470f010e61bb8618d6086f038c414ab1d21acff0cac4e93f8d085c23f610382b2e2135d83e4cf9d100eaecaa049a0eecd885c
\ No newline at end of file