OS specific preparations - GallusMax/JkbdRF GitHub Wiki

Serial port config

The reader hardware comes as USB or ethernet device. Connecting an ethernet device is easy once you have figured out its IP. May your DHCP help you :-) In order to connect the USB it has to be recognized as USB serial by the OS.

Linux

Since 3.13 the kernel accepts the Tagsys devices as serial devices. The device appears as /dev/ttyUSBn on attaching.

Using older kernels is possible with an appropriate modprobe.conf extension defining 0x403/0xf0e9 as serial device:

# file /etc/modprobe.d/tagsys.conf
#options ftdi_sio vendor=0x403 product=0xf0e9 debug
options ftdi_sio vendor=0x403 product=0xf0e9
#options ftdi_sio vendor=0x403 product=0xf0ee

Other/newer models will still have to be attached this way.

OSX

http://www.ftdichip.com/Drivers/VCP.htm has the necessary drivers to enable the USB2serial connection.

librxtxSerial

More than that you will need to copy a valid librxtxSerial.jnilib into your path, e.g. to /Library/Java/Extensions A "file librxtxSerial.jnilib" should then read as follows - and should include your machine's architecture:

/Library/Java/Extensions/librxtxSerial.jnilib: Mach-O universal binary with 4 architectures
/Library/Java/Extensions/librxtxSerial.jnilib (for architecture x86_64):        Mach-O 64-bit bundle x86_64
/Library/Java/Extensions/librxtxSerial.jnilib (for architecture i386):  Mach-O bundle i386
/Library/Java/Extensions/librxtxSerial.jnilib (for architecture ppc7400):       Mach-O bundle ppc
/Library/Java/Extensions/librxtxSerial.jnilib (for architecture ppc64): Mach-O 64-bit bundle ppc64

Look for a working librxtySerial.jnilib at: http://blog.iharder.net/2009/08/18/rxtx-java-6-and-librxtxserial-jnilib-on-intel-mac-os-x/

Other ways to load a .jnilib: http://www.chilkatsoft.com/java-loadLibrary-MacOSX.asp

DOS aka Windows

Bundled with the Reader comes the installation (CD). First you will have to install the serial "driver" and after that the Tagsys "driver". So two installations later the Reader may shine up in the Hardware Galley as COMx. Beware: after the next boot it may be COMy..