FreeBSD 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 out- puts, 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 fol- lowing 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)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OUTPUT | EXAMPLES | DIAGNOSTICS | BUGS | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=k8055&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>