k8055(1) User Manuals k8055(1)NAMEk8055 - read from/write to the velleman k8055 USB I/O board
SYNOPSISk8055 [-p: board_address ] [ option1 ] [ option2 ] ...
DESCRIPTIONk8055 is a commandline util for the velleman k8055 USB I/O board. Use
this tool to read all inputs and counters or to set digital outputs,
analog outputs, reset timers or set debounce time for the two timers.
The command can be run by root or any other user with access to use
USB. The k8055 require libusb-0.1.9 or newer and kernel 2.4.18 or
never.
OPTIONS
-p: number
the address of the k8055 board. A number between 0 and 3.
-d: value
set digital output value 0-255 (8bits in decimal)
-a1: value
set the 8-bit analog output 1. Valid value 0-255 (0=min,
255=max)
-a2: value
set the 8-bit analog output 2. Valid value 0-255 (0=min,
255=max)
-num: number
set number of measurements to return.
-delay:
number
set delay between two measures in milliseconds. Use together
with -num option.
-dpt1: value
set the value of the debounce time for timer1 in milliseconds
(0-5000). Debounce time is the time that the counter input need
to be active before it counts the value.
-dpt2: value
set the value of the debounce time for timer2 in milliseconds
(0-5000).
-reset1
reset counter 1 value to 0.
-reset2
reset counter 2 value to 0.
-debug start debug mode. Print debug information.
OUTPUT
the k8055 dumps the result to stdout.
Output :(timestamp);(digital);(analog1);(analog2);(counter1);(counter2)
Note : timestamp is the number of msec when data is read since program
start
Example: 499;16;128;230;9;8
499 : Measure done 499 msec after program start
16 : Digital input value is 10000 (I5=1, all other are 0)
128 : Analog 1 input value is 128
230 : Analog 2 input value is 230
9 : Counter 1 value is 9
8 : Counter 2 value is 8
EXAMPLESk8055 -p:1 -d:147 -a1:25 -a2:203
this sets digital outputs 8,5,2,1 (binary 1001 0011), analog
output 1 to value 25 and analog output 2 to 203.
k8055 -p:0 -num:5 -delay:500
this will read the inputs 5 times with 500ms interval producing
following output (input2/timer2 activade for 1 second):
20;0;109;190;0;0
513;0;109;190;0;0
1020;2;109;190;0;1
1515;2;109;190;0;1
2011;0;109;190;0;1
DIAGNOSTICS
The following diagnostics may be issued on stderr:
Could not open the k8055 (port:1)
Please ensure that the device is correctly connected.
The k8055 board was not found at card address 1. Check the
jumpers on the board and verify your own board address. Other‐
wise you need to verify that the board is found by your linux at
an USB port. You can do this by listing the usb devices in proc
with "cat /proc/bus/usb/devices | grep "S: Manufacturer=Velle‐
man" Leave out the grep part if you wish. Note: the command can
run slow for some reason since the k8055 sends an huge amount of
data to the USB bus...
Another problem might be if you use hotplug, then sometimes the
HID driver is loaded and reserves the device. Try with ´rmmod
hid´ (if you don't have a usb keyboard/mouse!) and see if the
board can be accessed. If it worked then either disable hid in
hotplug or setup hotplug correctly...
BUGS
The debounce timer values are not accurate by the millisecond. The
0-7450ms (0-5000ms according to the velleman dll-manual but they actu‐
ally use 0-7450) is split along an exponetial scale in 255 sections.
The tolerance of the debounce time is within +-4% and down to +-2% in
200-4000ms range.
AUTHOR
Sven Lindberg <k8055@k8055.mine.nu>
SEE ALSO
/usr/share/doc/libk8055.x.x/README
Linux September 2005 k8055(1)