Denkovi 1-Wire Command Line Tool is Linux/Windows software for controlling Denkovi 1-wire relay boards from command line promt

 

 

We have created as well special command line utility for all our 1-wire relay boards. The main goal of this project is to help you to use our 1-Wire relay boards easily and without any specific knowledge how do they work. It works on Windows/Linux.

 

• Multiplatform software: supported by Windows (32/64) and Linux 32/64 bit
• Simple and user friendly commands
• Supports large number of relay boards connected to the host computer
• Typical applications for this software are:
  • Create desktop icons to turn particular relays
  • Create BAT/BASH files to make more complex logic (like timers for example)
  • The commands can be executed from PHP script
  • Control our 1-wire relay boards from Android / iPhone mobile devices
  • The 1-wire relays can be controlled from each software/platform which can run external executable files or commands in command line promt

 

Quick links

• Who can use the software
• List with currently supported 1-wire relay boards
• Current version download
• System requirements
• How to run it
• Available commands
• Typical applications

 

 

Who can use Denkovi 1-Wire Command Line Tool

Denkovi 1-Wire Command Line Tool may be used by anyone who has at least one of Denkovi 1-wire relay boards from the current version supported list.

It is not allowed to use Denkovi 1-Wire Relay Control Software with relay boards which are not manufactured by Denkovi Assembly Electronics LTD.

 

 [back to top]

 

List with currently supported Denkovi relay boards 

Order number	Relay board name and link
DAE-8RELAYS-1WIRE	1-Wire Eight Channel Relay Board

 

 [back to top]

 

Current version download

Version	Release date	Windows/Linux (.rar)
1.1	22 Oct 2013	DenkoviOneWireCommandLineTool.zip

 

 [back to top]

 

System requirements

Operating systems:

• Windows (tested on Windows XP, Windows Vista, Windows 7 and Windows 8)
• Linux (tested on Ububtu and OpenSuse)

Requires: Java - the recommended is Oracale Java 8 Java SE Runtime Environment (JRE) / Java SE Development Kit (JDK), but other JRE / JDK builds and versions (8 or above) also should work;
Requires: One Wire Drivers

It also requires internet connection when it is started for first time on particular computer in order to verify and license the 1-wire relay board if it is by denkovi.

 

 [back to top]

How to run it

Open CMD (on Windows), Terminal/Console (on Linux/BSD) and type:

java -Djava.library.path="path/to/the/library/directory" -jar "path/to/the/directory/of/this/tool/DenkoviRelayCommandLineTool.jar"

Without any parameters, it simple prints help instructions and shows the current version.

The -Djava.library.path="path/to/the/library/directory" is showing where the path of the native libraries. The exact name of the directory is "native libs". It won't work if this is not pointed. The libraries are included in the main directory of the tool. The coresponding directory x86 or x64 must be selected depending on the OS. So for example if you download and unzip the tool in:

D:\OneWireCommandLineTool-1.0\

Then running of the command line tool for windows x86 would be:

java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar"

 

The running of the command line tool for windows x64 would be:

java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x64" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar"

 [back to top]

 

Available commands

• LIST COMMAND - lists all DS2408 relay boards connected to the selcted 1-wire adapter.

Expected answer:
[DEVICE SERIAL NUMBER] (Description)

Examples:
Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" list

Output:
1B00000001234567 (1-Wire 8 Channel Addressable Switch)
1B00000001234568 (1-Wire 8 Channel Addressable Switch)
1B00000001234569 (1-Wire 8 Channel Addressable Switch)

 

• STATUS COMMAND - displays relay(s) status(es).

Expected results: 1 – for ON relay and 0 – for OFF relay.

Examples:

If you want to get status for all relays, type:

Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567

Output:
00001111

If you want to get status for single relay, type:

Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 1

Output:
0

 

• SET COMMAND - sets relay(s) state(s).

If you want to set status for single relay, type:

             Expected results:  returns the status of all relays if the command is successful.

Examples:

To set single relay # 2 ON, type:
Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 2 1

Output:
11110000

To set all relays at a time, type:

Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 turn 11110000

Output:
11110000

After executing relay 1,2,3 and 4 will be ON and the rest OFF.
 

To set all relays On/OFF you can use also this command:
Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 all 1
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 all 0

Output:
11111111
0000000

• SETUP COMMAND - setup the defualt com port. By default the application uses the Dallas default adapter. It is possible to change the serial port number. This can be changed with the following command:

Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" setup DS9097U COM2

To restore the dfault settings use:

Input:
java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" setup defaults

 

 [back to top]

 

Typical applications:

• Run it from the command promt
  The commands are the same for Windows / Linux.

 

• Create shortcut in Windows

Now type the java command. For example:

java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireTool-1.0.jar" 1B00000001234567 all 1

Name it "ON". When you click it if all the settings are correct, the relays should be all ON.

Now, you can create the same way OFF command or whatever shortcut you need.

 

• How to use it with BAT / BASH files.

Very often for many applications it is required some relay to be turned on, wait several seconds and then off. This is so called timer function. With our command line tool this can be done in several easy steps in Windows:

1. Create new text file and save it as .BAT file. For example "Pulse5.BAT".
2. Open the file and type the following commands (USB 16, work with relay 1) and save it.
   • java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 1 1
   • PING 1.1.1.1 -n 1 -w 5000 >NUL
   • java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireCLT-1.0.jar" 1B00000001234567 1 0
3. Now you can just click it. Relay 1 will be turned ON for 5 seconds and then will be turned OFF.

 

It is the same story for Linux:

1. Create new text file and save it as .VIM file. For example "Pulse5.VIM".
2. Open the file and type the following commands (USB 16, work with relay 1) and save it.
   • #!/bin/bash
   • java -Djava.library.path='/root/Downloads/DenkoviOneWireCommandLineTool/native libs/x64' -jar '/root/Downloads/DenkoviOneWireCommandLineTool/DenkoviOneWireTool-1.0.jar' 1B00000007240329 all 1
   • sleep 5
   • java -Djava.library.path='/root/Downloads/DenkoviOneWireCommandLineTool/native libs/x64' -jar '/root/Downloads/DenkoviOneWireCommandLineTool/DenkoviOneWireTool-1.0.jar' 1B00000007240329 all 0
3. Now you can just click it. Relay 1 will be turned ON for 5 seconds and then will be turned OFF.

 

• Call it from PHP script:

Just use the function shell_exec() :

<?php

$output = shell_exec('java -Djava.library.path="D:\OneWireCommandLineTool\native libs\x86" -jar "D:\OneWireCommandLineTool\DenkoviOneWireTool-1.0.jar" 1B00000001234567 1 1');

?>

 

 [back to top]