DragonFly On-Line Manual Pages

k8055(1)                         User Manuals                         k8055(1)

NAME
       k8055 - read from/write to the velleman k8055 USB I/O board

SYNOPSIS
       k8055 [-p: board_address ] [ option1 ] [ option2 ] ...

DESCRIPTION
       k8055 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

EXAMPLES
       k8055 -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.
              Otherwise 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=Velleman" 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
       actually 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)