Skip to content

Latest commit

 

History

History
81 lines (67 loc) · 4.07 KB

README.md

File metadata and controls

81 lines (67 loc) · 4.07 KB
Raw

knx2j

Codacy Badge Build Status

Knx2j is a native Java command line application. It is designed to read knx Temperature and Humidity values from given groupadresses and writes them to a Database using the vz middleware. You need a working java and knx router/gateway installation, including the knxtools to read the groupadress values from the knx bus. Knx2j is also designed to work with the old [eibd]. But I prefer the open source knxd.

Installation and configuration

git clone https://github.com/GeminiServer/knx2j.git
cd knx2j/release

Open the knx2j.json file with a editor of your choice and set your settings:

$ nano knx2j.json

Build

Use ./gradlew assemble to build the project. To copy the JAR and default config to release, run ./gradlew release.

knx2j.json - Configuration Description and file example

Section Setting Description Value
general update-interval Read and write timer in Minutes. Default is 10 minutes. minute
general enable-logging Enables output of debug-log informations. true/false
middleware host FQDN or IP adress of the host. IPv4/url
middleware path Path to the Middleware. ( http://host/middleware.php/data/ path
middleware user-agent User Agent Default is Mozilla/5.0. string
knx groupreadresponse Knx tool path to the groupreadresponse binary path
knx responsemessage Response message identification string. Default: "Write from" string
knx ip IP adress of the knx router/gateway IPv4
knx port Port of the knx router/gateway. Default 6720 port
sensors description Description of the Sensor String
sensors groupadress Groupadress of the sensor to receive the value from. (i.e. 6/0/0) GA
sensors type 'thermal': DPT_Value_Temp - 'humidity': DPT_Value_Humidity 'thermal' or 'humidity'
sensors uuid UUID of the Sensor in VZ. For more Information check VZ Wiki UUID

Here is a example of the knx2j.json file:

{
  "general":[{
    "update-interval": 10,
    "enable-logging": true
  }],

  "middleware":[{
     "host": "kronos",
     "path": "middleware.php/data/",
     "user-agent": "Mozilla/5.0"
  }],

  "knx":[{
     "groupreadresponse_old":    "/usr/lib/knxd/groupreadresponse",
     "groupreadresponse_new":    "/usr/bin/knxtool groupreadresponse",
     "groupreadresponse_cached": "/usr/bin/knxtool groupcacheread",
     "groupreadresponse":        "/usr/bin/knxtool groupcachereadsync",
     "responsemessage":          "rite from",
     "reponseidentifier":        ":",
     "ip": "localhost",
     "port": "6720"
  }],

  "sensors": [
    { "description": "Außen Süden"       ,"groupadress": "6/0/0"   ,"type": "thermal"   ,"uuid": "c8758450-aac3-11e3-ae70-71656855ff53" },
    { "description": "Außen Norden"      ,"groupadress": "6/0/1"   ,"type": "humidity"   ,"uuid": "c3407300-9d4b-11e3-8eb8-99224c3b70e8" }
  ]
}

After your configurations is set, just start the knx2j:

java -jar knx2j.jar