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