Back to home page

OSCL-LXR

 
 

    


0001 =============================
0002 Infinity Usb Unlimited Readme
0003 =============================
0004 
0005 Hi all,
0006 
0007 
0008 This module provide a serial interface to use your
0009 IUU unit in phoenix mode. Loading this module will
0010 bring a ttyUSB[0-x] interface. This driver must be
0011 used by your favorite application to pilot the IUU
0012 
0013 This driver is still in beta stage, so bugs can
0014 occur and your system may freeze. As far I now,
0015 I never had any problem with it, but I'm not a real
0016 guru, so don't blame me if your system is unstable
0017 
0018 You can plug more than one IUU. Every unit will
0019 have his own device file(/dev/ttyUSB0,/dev/ttyUSB1,...)
0020 
0021 
0022 
0023 How to tune the reader speed?
0024 =============================
0025 
0026  A few parameters can be used at load time
0027  To use parameters, just unload the module if it is
0028  already loaded and use modprobe iuu_phoenix param=value.
0029  In case of prebuilt module, use the command
0030  insmod iuu_phoenix param=value.
0031 
0032  Example::
0033 
0034         modprobe iuu_phoenix clockmode=3
0035 
0036  The parameters are:
0037 
0038 clockmode:
0039         1=3Mhz579,2=3Mhz680,3=6Mhz (int)
0040 boost:
0041         overclock boost percent 100 to 500 (int)
0042 cdmode:
0043         Card detect mode
0044         0=none, 1=CD, 2=!CD, 3=DSR, 4=!DSR, 5=CTS, 6=!CTS, 7=RING, 8=!RING (int)
0045 xmas:
0046         xmas color enabled or not (bool)
0047 debug:
0048         Debug enabled or not (bool)
0049 
0050 -  clockmode will provide 3 different base settings commonly adopted by
0051    different software:
0052 
0053         1. 3Mhz579
0054         2. 3Mhz680
0055         3. 6Mhz
0056 
0057 -  boost provide a way to overclock the reader ( my favorite :-)  )
0058    For example to have best performance than a simple clockmode=3, try this::
0059 
0060       modprobe boost=195
0061 
0062    This will put the reader in a base of 3Mhz579 but boosted a 195 % !
0063    the real clock will be now : 6979050 Hz ( 6Mhz979 ) and will increase
0064    the speed to a score 10 to 20% better than the simple clockmode=3 !!!
0065 
0066 
0067 -  cdmode permit to setup the signal used to inform the userland ( ioctl answer )
0068    if the card is present or not. Eight signals are possible.
0069 
0070 -  xmas is completely useless except for your eyes. This is one of my friend who was
0071    so sad to have a nice device like the iuu without seeing all color range available.
0072    So I have added this option to permit him to see a lot of color ( each activity change the color
0073    and the frequency randomly )
0074 
0075 -  debug will produce a lot of debugging messages...
0076 
0077 
0078 Last notes
0079 ==========
0080 
0081  Don't worry about the serial settings, the serial emulation
0082  is an abstraction, so use any speed or parity setting will
0083  work. ( This will not change anything ).Later I will perhaps
0084  use this settings to deduce de boost but is that feature
0085  really necessary ?
0086  The autodetect feature used is the serial CD. If that doesn't
0087  work for your software, disable detection mechanism in it.
0088 
0089 
0090  Have fun !
0091 
0092  Alain Degreffe
0093 
0094  eczema(at)ecze.com