THIS IS THE LINUX-USBIOMKII-24 IO Module Configuration
AND RUNNING THE JUSBIOMKII-24 IO API example.

My current configuration is 
x86 machine - P3 600mhz
running linux kernel 2.6.X-
with gnome-desktop installed.
on jdk1.4 Sun Microsystems
RXTX-linux-release rxtx-2.1-7pre17-x86


current-linux-tested-releases
  Ubuntu-5.10
  Fedora Core 4
  CentOS 4.2 final


i already tested some linux-jdk on:
  jdk1.5 from Sun x86
  jdk1.4 from IBM x86 
  jdk1.5 from BEA x86


it will work on all windows OS with JVM 1.4+ installed


current-macintosh-tested-release
  MacOS X 10.4.7 with RXTX * (tested by Randy Glenn)


please let me know or email me 
if someone tried it under GCJ 1.4
so that i can update this documentation


Quick Steps on RXTX-installation-2.1-7pre17 
(you can find docu and howto on rxtx.org)

[path_to_jdk_installation]/jre/lib/i386
  .libs
  librxtxI2C.so
  librxtxParallel.so
  librxtxRaw.so
  librxtxRS485.so
  librxtxSerial.so

[path_to_jdk_installation]/jre/lib/ext
  RXTXcomm.jar


Quick Steps on Installing the USBIO MKII 24 IO Linux

first check your kernel if it is 2.4.20 or higher
by typing a command under a terminal
#uname -r

Important:
driver details on other linux-kernels can be found at
ftdichip.com

after checking your linux-kernel 
if it does pass on the requirement above.

plug-in the USBIO-MKII 24 IO Module
after this
you can issue a command dmesg on your terminal

#dmesg

you can see a message like this "FTDI FT232BM Compatible converter now attached to ttyUSB0"

on my current config it is attached on ttyUSB0
on some systems it could be ttyUSB1 or ttyUSB2 or ttyUSBXX
where XX are numbers created if the usb-module is attached..


after this issue a command by typing
#ls /dev/ttyS*

there will be serial device listing
e.g below

/dev/ttyS0   /dev/ttyS17  /dev/ttyS25  /dev/ttyS33  /dev/ttyS41  /dev/ttyS7
/dev/ttyS1   /dev/ttyS18  /dev/ttyS26  /dev/ttyS34  /dev/ttyS42  /dev/ttyS8
/dev/ttyS10  /dev/ttyS19  /dev/ttyS27  /dev/ttyS35  /dev/ttyS43  /dev/ttyS9
/dev/ttyS11  /dev/ttyS2   /dev/ttyS28  /dev/ttyS36  /dev/ttyS44
/dev/ttyS12  /dev/ttyS20  /dev/ttyS29  /dev/ttyS37  /dev/ttyS45
/dev/ttyS13  /dev/ttyS21  /dev/ttyS3   /dev/ttyS38  /dev/ttyS46
/dev/ttyS14  /dev/ttyS22  /dev/ttyS30  /dev/ttyS39  /dev/ttyS47
/dev/ttyS15  /dev/ttyS23  /dev/ttyS31  /dev/ttyS4   /dev/ttyS5
/dev/ttyS16  /dev/ttyS24  /dev/ttyS32  /dev/ttyS40  /dev/ttyS6


now as you can see with my current configuration my Serial Dev Listing is ttyS0-ttyS47
but usually i always use blank Serial device address like ttyS50

now we create a dummy link from usb - serial by typing the following command

" ln -b /dev/ttyUSB[YOUR_USBIO_MODULE_NO] /ttyS[YOUR_DUMMY_BLANK_SERIAL_DEVICE] "

e.g. on my current configuration i do like this.

on deb (debian, ubuntu) command
#sudo ln -b /dev/ttyUSB0 /dev/ttyS50

on rh-base (fedora 4)
First login as root using su on the terminal
#ln -b /dev/ttyUSB0 /dev/ttyS50


Now running the example application..

download the zip file from http://www50.brinkster.com/iiping/usbio24mkii.zip

you can use wget, by typing the command on the terminal

#wget http://www50.brinkster.com/iiping/usbio24mkii.zip

extract the file by a zip-decompressor aka unzip,
you can also use jar utility from your jdk,
or your favorite zip-decompressor utility

on jar, 
#[path_to_jdk_installation]/bin/jar -xvf usbio24mkii.zip

on unzip, 
#unzip usbio24mkii.zip


after this type ls on the terminal
#ls

the ff listing will be found

license.txt   rxtxParallel.dll  src              usbio24mkii.jar
RXTXcomm.jar  rxtxSerial.dll    usbio24mkii.exe  usbio24mkii.zip


now we are one-step closer to the finish-line
type the following command to the terminal

#[path_to_jdk_installation]/bin/java -jar usbio24mkii.jar





on the gui

there is a Port Location Text Box
input /dev/ttyS[YOUR_USBIO_MODULE_NO]

on my current configuration I link it to ttyS50
so in the input Text Box i typed /dev/ttyS50 

then click connect button.

now you can do something.... on the IO Module...


note: I've tried this under Gnome-Desktop 
I've never tried it on X, KDE, XFCE,JavaDesktop and etc. - 
pls. email me if you have tried it on other desktop, 
so that i can update this docu, and even better if you have a screenshot.


Happy Hacking...

BTW.. pls. feel free to email me dbx0001(at)gmail(dot)com 
about how to use the api... I'm quite busy right now
to update the webpage and to upload the documentation...

If someone would like to contribute I'm happy to accept anything... 
like: 
html-docu's....
specs.... 
implementation.. 
new toy to play with.. 



I would like to thank the ff. persons

Michael Alexandersen
Francois Pilay
Michael Romero
Edwiedge Casi
Marc Lawrence Gallego
Frederick Mutia
Randy Glenn
JMDZ
and other people i forgot their names....