KnxTool

LinuxJohannes edited this page Mar 18, 2017 · 20 revisions

KnxTool

is a command line program to communicate with the knxd.

Usage

You might want to read the list of applets are included:

$ knxtool list
$ on off write swrite read if readtemp dimup log 
$ busmonitor1 busmonitor2 readindividual progmodeon progmodeoff progmodetoggle progmodestatus maskver 
$ writeaddress vbusmonitor1 vbusmonitor2 mprogmodeon mprogmodeoff mprogmodetoggle mprogmodestatus mmaskver 
$ mpeitype madcread mread mwrite mpropread mpropwrite mpropdesc mpropscan groupread groupswrite groupwrite 
$ msetkey grouplisten groupresponse groupsresponse groupsocketlisten groupsocketread mpropscanpoll 
$ vbusmonitor1poll groupreadresponse groupcacheenable groupcachedisable groupcacheclear groupcacheremove 
$ groupcachereadsync groupcacheread mwriteplain mrestart groupsocketwrite groupsocketswrite 
$ xpropread xpropwrite groupcachelastupdates busmonitor3 vbusmonitor3 eibread-cgi eibwrite-cgi 
$ vbusmonitor1time

Commands, where tunneling is possible

For this examples below, Knxd is running on a another device. In this case a Raspery pi 3 with ROT-Extension. Ip-adress from the Raspberry is 192.168.178.103. If the knxd running localy, you have to replace the Ip-adress to "ip:localhost".

usage: knxtool app url eibaddr

On

Switching on the group 0.0.25

$ knxtool on ip:192.168.178.103 0.0.25

Off

Switching off the group 0.0.25

$ knxtool off ip:192.168.178.103 0.0.25

Busmonitor1

$ knxtool busmonitor1 ip:192.168.178.103
$ LPDU: BC 11 17 00 19 E1 00 81 3C :L_Data low from 1.1.23 to 0/0/25 hops: 06 T_DATA_XXX_REQ A_GroupValue_Write (small) 01 
$ LPDU: CC :ACK

Stop with "ctrl c"

Busmonitor2

$ knxtool busmonitor2 ip:192.168.178.103
$ BC 11 17 00 19 E1 00 81 3C 
$ CC 

Stop with "ctrl c"

vbusmonitor1

$ knxtool vbusmonitor1 ip:192.168.178.103
$ LPDU: BC 11 17 00 19 E1 00 81 3C :L_Data low from 1.1.23 to 0/0/25 hops: 06 T_DATA_XXX_REQ A_GroupValue_Write (small) 01 
$ LPDU: BC 11 17 00 19 E1 00 80 3D :L_Data low from 1.1.23 to 0/0/25 hops: 06 T_DATA_XXX_REQ A_GroupValue_Write (small) 00 
$ ^C  <- from user to stop it

Progmodeon

Switching a knx device in progmode.

$ knxtool  progmodeon ip:192.168.178.103 1.1.5

Progmodeoff

Switching progmode off from a knx device.

$ knxtool  progmodeon ip:192.168.178.103 1.1.5

Progmodetoggle

Togge progmode from a knx device.

$ knxtool  progmodetoggle ip:192.168.178.103 1.1.5

Progmodestatus

Reads the programing mode of a knx device.

$ knxtool progmodestatus ip:192.168.178.103 1.1.5                                                      
$ in programming mode     

Maskver

Reads the maskversion of a knx device.

$ knxtool maskver ip:192.168.178.103 1.1.5                                                      
$ Mask: 0012  
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.