projects / linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 60a8fc01 AD |
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 |