Google Git
Sign in
apache / plc4x / 0c7d02422c3267df9f23bc183f90a4fef3869931
commit0c7d02422c3267df9f23bc183f90a4fef3869931[log] [tgz]
authordependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>Mon Jul 21 11:10:06 2025 +0200
committerGitHub <noreply@github.com>Mon Jul 21 11:10:06 2025 +0200
tree3db336d62d221cce296f6a386c18d6e382580374
parentbc055619df8e01f89c92a989eb24edc48ce4e3ed [diff]
build(deps): bump jackson.version from 2.19.1 to 2.19.2 (#2187)

---
updated-dependencies:
- dependency-name: com.fasterxml.jackson.core:jackson-annotations
  dependency-version: 2.19.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-core
  dependency-version: 2.19.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-databind
  dependency-version: 2.19.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.dataformat:jackson-dataformat-xml
  dependency-version: 2.19.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.dataformat:jackson-dataformat-yaml
  dependency-version: 2.19.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
1 file changed
tree: 3db336d62d221cce296f6a386c18d6e382580374
  1. .github/
  2. .idea/
  3. .mvn/
  4. code-generation/
  5. images/
  6. licenses/
  7. media/
  8. plc4c/
  9. plc4go/
  10. plc4j/
  11. plc4net/
  12. plc4py/
  13. protocols/
  14. src/
  15. tools/
  16. website/
  17. .asf.yaml
  18. .dockerignore
  19. .editorconfig
  20. .gitignore
  21. build-reproducible.sh
  22. CHANGELOG.md
  23. compare-reproducible.sh
  24. CONTRIBUTING.md
  25. DEVELOPMENT.md
  26. docker-compose.yaml
  27. Dockerfile
  28. jenkins.pom
  29. Jenkinsfile
  30. LICENSE
  31. mvnw
  32. mvnw.cmd
  33. NOTICE
  34. pom.xml
  35. README.md
  36. RELEASE_NOTES
README.md

Maven central License Jenkins Build Status Last commit Twitter Java Platform compatibility Go Platform compatibility C Platform compatibility Python Platform Compatibility

Table of contents

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 (not ready for usage)
  4. Python (not ready for usage)
  5. C# (.Net) (not ready for usage - abandoned)

PLC4X also integrates with other Apache projects, such as:

And brings stand-alone (Java) utils such as:

  • OPC-UA Server: Enables you to communicate with legacy devices using PLC4X with OPC-UA.
  • PLC4X Server: Enables you to communicate with a central PLC4X Server which then communicates with devices via PLC4X.

It also provides (Java) tools for usage inside an application:

  • Connection Cache: New implementation of our framework for re-using and sharing PLC-connections
  • OPM: Object-Plc-Mapping: Allows binding PLC fields to properties in java POJOs similar to JPA
  • Scraper: Utility to do scheduled and repeated data collection.

Getting started

Depending on the programming language, the usage will differ, therefore please go to the Getting Started on the PLC4X website to look up the language of choice.

Java

NOTE: Currently the minimum Java version is Java 11, and we have tested it up to Java 24. The project is currently split up into 3 repositories, the plc4x-extras repository.
When building the plc4x-extras repo, in order to be able to build all parts, at least Java 17 is required.

See the PLC4J user guide on the website to start using PLC4X in your Java application: https://plc4x.apache.org/plc4x/latest/users/getting-started/plc4j.html

Developers

Environment

Currently, the project is configured to require the following software:

  1. Java 11 JDK: For running Maven in general as well as compiling the Java and Scala modules JAVA_HOME configured to point to that.
  2. Git (even when working on the source distribution)
  3. (Optional, for running all tests) libpcap/Npcap for raw socket tests in Java or use of passive-mode drivers
  4. (Optional, for running all tests) Docker for running some tests making use of Testcontainers
  5. (Optional, for building the website) Graphviz : For generating the graphs in the documentation

WARNING: The code generation uses a utility which requires some additional VM settings. When running a build from the root, the settings in the .mvn/jvm.config are automatically applied. When building only a sub module, it is important to set the vm args: --add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED. In Intellij for example set these in the IDE settings under: Preferences | Build, Execution, Deployment | Build Tools | Maven | Runner: JVM Options.

The when doing a build, we automatically run a prerequisite check and fail the build with an explanation, if not all requirements are meet.

A more detailed description is available on our website:

https://plc4x.apache.org/plc4x/latest/developers/preparing/index.html

For building PLC4C we also need:

All requirements are retrieved by the build itself

For building PLC4Go we also need:

All requirements are retrieved by the build itself

For building PLC4Py we also need:

  1. Python 3.8 or higher
  2. Python pyenv

For building PLC4Net we also need:

  1. DotNet SDK 6.0 or above

Building with Docker

Part of the build requires quite a bit of ram. Before running the Docker build, please ensure that the Docker runtime has at least 12GB of ram available.

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 compose up

This will build a local Docker container able to build all parts of PLC4X and will run a maven build of the local directory inside this container.

The default build will run a local release-build, so it can also be used to ensure reproducible builds when releasing.

Per default will it store files locally:

  • Downloaded maven artifacts will go to out/.repository

The reason for this is, that otherwise the artifacts would be packaged in with the source-release artifact, resulting in a 12GB or more zip archive. However, saving it in the main target directory would make the build delete the local repo every time a mvn clean is run. The out directory however is excluded per default from the assembly descriptor, and therefore it is not included in the source zim.

Getting Started

You must have at least Java 11 installed on your system and connectivity to Maven Central (for downloading external third party dependencies). 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 -P with-java install

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, which is part of the plc4x-extras repository.

The Go drivers can be built by enabling the with-go profile:

./mvnw -P with-go install

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-dotnet profiles.

./mvnw -P with-dotnet install

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-python profiles.

./mvnw -P with-python install

In order to build everything the following command should work:

./mvnw -P with-c,with-dotnet,with-go,with-java,with-python,enable-all-checks 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:

LinkedIn

Get the latest PLC4X news on LinkedIn: https://www.linkedin.com/company/apache-plc4x/posts

Contributing

There are multiple forms in which you can become involved with the PLC4X project.

These are, but are not limited to:

  • Providing information and insights
  • Testing PLC4X and providing feedback
  • 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 so don’t be afraid to step forward. If you'd like to contribute to PLC4X, have a look at our contribution guide!

Licensing

Apache PLC4X is released under the Apache License Version 2.0.