com.github.zgmnkv:zwave4j

ZWave4J is a Java wrapper for Open-ZWave library


Licenses
GPL-3.0/CERN-OHL-P-2.0

Documentation

ZWave4J

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

Usage

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.

Build

Requirements

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

Build configuration

  1. Copy example.gradle.properties into gradle.properties.
  2. Edit properties in gradle.properties:
    • 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.

Build

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"

Development

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