GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  K8055 (1)

NAME

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

CONTENTS

Synopsis
Description
Options
Output
Examples
Diagnostics
Bugs
Author

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
Search for    or go to Top of page |  Section 1 |  Main Index


Linux K8055 (1) September 2005

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.