Skip to content
No description, website, or topics provided.
C++ Java
Branch: master
Clone or download
Latest commit 10a4abb Aug 1, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Update to gradle 2.13 May 3, 2016
src/main Merge pull request #42 from tek1974/association Aug 1, 2016
.gitignore Build script improvements May 3, 2016
LICENSE Change license to MIT Nov 7, 2015 Readme update May 3, 2016
build.gradle Multi-platform build Jul 5, 2016
gradlew Update to gradle 2.13 May 3, 2016
gradlew.bat Update to gradle 2.13 May 3, 2016
settings.gradle Initial commit. Apr 18, 2013


ZWave4J - java wrapper for OpenZWave library.

The goal is to provide to java the same API as OpenZWave has. Besides the wrapper ZWave4J has a simple executable Main class which demonstrates how to work with ZWave4J.

Supported platforms:

  • Windows: x86, amd64
  • Linux: x86, amd64, arm
  • OS X: x86, amd64


You can download the latest ZWave4J release from GitHub or from Maven Central, or unstable snapshot from sonatype.

To execute sample Main class, run:

java -cp zwave4j-X.jar org.zwave4j.Main "open-zwave/config" "/dev/ttyUSB0"

  • First argument is path to OpenZWave configuration directory.
  • Second argument is path to serial device, which Z-Wave controller is connected to, e.g. /dev/ttyUSB0 for Linux or //./COM1 for Windows.



  1. JDK 1.7+
  2. GCC (MinGW for Windows)
  3. OpenZWave sources

Build configuration

  1. Copy into
  2. Edit properties in
  • openZWaveDir - path to OpenZWave library source directory, needed compile.
  • openZWaveConfigDir - path to OpenZWave configuration directory, needed for OpenZWave library in runtime.
  • zWaveControllerPort - path to serial device, which Z-Wave controller is connected to.


Run ./gradlew build (gradlew build for Windows) in console. It will compile native JNI binaries and java classes, assemble jar archive and put it into build/libs directory. Native binaries for platforms supported by your host will be built. To include native binaries for other platforms into compiled jar, put native_libs directory from other ZWave4J jars in the project root directory.

After build

If you have built a library from sources, you can use several options:

  • Run ./gradlew install to install library into local maven repository for using ZWave4J as a library in your other projects.
  • Run ./gradlew run in console. It will execute sample Main class.
  • Run ./gradlew installApp to install application with start scripts into build/install/zwave4j, then you can start it manually from build/install/zwave4j/bin: zwave4j.bat "open-zwave/config" "/dev/ttyUSB0"
  • Execute ZWave4J Main class manually from build/libs directory: java -cp zwave4j-X.jar org.zwave4j.Main "open-zwave/config" "/dev/ttyUSB0"


You can generate IntelliJ IDEA project files running ./gradlew idea task. You can use C/C++ plugin to work with native sources.

You can’t perform that action at this time.