| Alain Degreffe | 60a8fc0 | 2007-10-26 13:51:49 +0200 | [diff] [blame] | 1 | Infinity Usb Unlimited Readme |
| 2 | ----------------------------- |
| 3 | |
| 4 | Hi all, |
| 5 | |
| 6 | |
| 7 | This module provide a serial interface to use your |
| 8 | IUU unit in phoenix mode. Loading this module will |
| 9 | bring a ttyUSB[0-x] interface. This driver must be |
| 10 | used by your favorite application to pilot the IUU |
| 11 | |
| 12 | This driver is still in beta stage, so bugs can |
| 13 | occur and your system may freeze. As far I now, |
| 14 | I never had any problem with it, but I'm not a real |
| 15 | guru, so don't blame me if your system is unstable |
| 16 | |
| 17 | You can plug more than one IUU. Every unit will |
| 18 | have his own device file(/dev/ttyUSB0,/dev/ttyUSB1,...) |
| 19 | |
| 20 | |
| 21 | |
| 22 | How to tune the reader speed ? |
| 23 | |
| 24 | A few parameters can be used at load time |
| 25 | To use parameters, just unload the module if it is |
| 26 | already loaded and use modprobe iuu_phoenix param=value. |
| 27 | In case of prebuilt module, use the command |
| 28 | insmod iuu_phoenix param=value. |
| 29 | |
| 30 | Example: |
| 31 | |
| 32 | modprobe iuu_phoenix clockmode=3 |
| 33 | |
| 34 | The parameters are: |
| 35 | |
| 36 | parm: clockmode:1=3Mhz579,2=3Mhz680,3=6Mhz (int) |
| 37 | parm: boost:overclock boost percent 100 to 500 (int) |
| 38 | parm: cdmode:Card detect mode 0=none, 1=CD, 2=!CD, 3=DSR, 4=!DSR, 5=CTS, 6=!CTS, 7=RING, 8=!RING (int) |
| 39 | parm: xmas:xmas color enabled or not (bool) |
| 40 | parm: debug:Debug enabled or not (bool) |
| 41 | |
| 42 | - clockmode will provide 3 different base settings commonly adopted by |
| 43 | different software: |
| 44 | 1. 3Mhz579 |
| 45 | 2. 3Mhz680 |
| 46 | 3. 6Mhz |
| 47 | |
| 48 | - boost provide a way to overclock the reader ( my favorite :-) ) |
| 49 | For example to have best performance than a simple clockmode=3, try this: |
| 50 | |
| 51 | modprobe boost=195 |
| 52 | |
| 53 | This will put the reader in a base of 3Mhz579 but boosted a 195 % ! |
| 54 | the real clock will be now : 6979050 Hz ( 6Mhz979 ) and will increase |
| 55 | the speed to a score 10 to 20% better than the simple clockmode=3 !!! |
| 56 | |
| 57 | |
| 58 | - cdmode permit to setup the signal used to inform the userland ( ioctl answer ) |
| 59 | if the card is present or not. Eight signals are possible. |
| 60 | |
| 61 | - xmas is completely useless except for your eyes. This is one of my friend who was |
| 62 | so sad to have a nice device like the iuu without seeing all color range available. |
| 63 | So I have added this option to permit him to see a lot of color ( each activity change the color |
| 64 | and the frequency randomly ) |
| 65 | |
| 66 | - debug will produce a lot of debugging messages... |
| 67 | |
| 68 | |
| 69 | Last notes: |
| 70 | |
| 71 | Don't worry about the serial settings, the serial emulation |
| 72 | is an abstraction, so use any speed or parity setting will |
| 73 | work. ( This will not change anything ).Later I will perhaps |
| 74 | use this settings to deduce de boost but is that feature |
| 75 | really necessary ? |
| 76 | The autodetect feature used is the serial CD. If that doesn't |
| 77 | work for your software, disable detection mechanism in it. |
| 78 | |
| 79 | |
| 80 | Have fun ! |
| 81 | |
| 82 | Alain Degreffe |
| 83 | |
| 84 | eczema(at)ecze.com |