/usr/include/sys/usb/usbai.h. Therefore, I am not disclosing any private information; merely organizing existing public information into a more easily comprehensible form.
Note2: the v2 driver works directly with Xsun and solaris 8+ with no additional Xsun module required.
Note3: in very very rare cases, the pointer locks up and refuses to respond. Need someone to provide me with a reliable test case. I've only seen it once so far, in months of use.
|S9/sparc:||112785-17 or later|
|S9/x86:||112786-07 or later|
|S8/sparc:||108652-68 or later|
|S8/x86:||108653-57 or later|
Source to both the low-level driver, and the Xsun module is available. However, it is most tested on Solaris x86, since that is my primary development platform.
Use any of these drivers at your own risk No warantee, implied or explicit, is given. Author not responsible for damages stemming from use or misuse of the software. Warning: you may go blind from reading type this small.
Xsun module (historical only)You will not need this part any more. But for historical "how do I write an Xsun module?" information, I am still keeping this available. Note, however, that it has bugs anyways. Using the standard (patched) Sun Xsun module works much better.
This will both install the driver, and an openwindows config file. On x86, that means you will be able to just run kdmconfig and select "USB mouse (Scrollwheel)" and have things work.
On sparc, you'll have to also manually edit /etc/openwin/server/etc/OWconfig, and add these lines:
class="XINPUT" name="IMOUSE" ddxHandler="ddxSUNWmouse.so.1" ddxInitFunc="ddxSUNWmouseProc" dev="/dev/usb/usbsm0";
[Mouse] XButton1MapsTo=1 XButton2MapsTo=2 XButton3MapsTo=3 XButton4MapsTo=4 XButton5MapsTo=5
Xsun lockups when starting gtk apps
It has been noted that when using newer patched versions of Xsun (later than patchlevel -10 or so) starting gtk based apps like mozilla or some window manageres, may lock up the server.
This may be due to having "extra" mouse entries laying around. Look through /usr/openwin/server/etc/OWconfig and see if there is a non-commented section for XINPUT that uses ddxSUNWmouseProc. If so, remove it or comment it out. This should fix the problem.
Mouse compatibilty issues
Unfortunately, not ALL USB wheel mice seem to work, even though there is some USB hid standard for this sort of thing. For example, the pseudo-mouse with a wacom tablet, does not work with this driver.
Fine-tuning: Adjusting packetsizeIf the mouse doesnt work, you should start by downloading the usbsm.tar source, and compiling the "tester" program. "
make tester" will compile either sun4u/tester, or i86pc/tester for you. Run the program on your console, by doingand you should see reasonable output to your manipulation of the mouse. If you see warnings like "
ignoring data of len ..." then edit the usbsm.conf file, and set the packetsize to whatever len was reported on the console. Reload the driver, rerun the tester program, and see if it works.
If it does work, then please let me know your mouse type, and the packetsize needed. [also, please let me know if there is a "maxtransfer size" value on your console].
If it does not work, then please let me know anyway, so I can add it to the list of "does not work" mice. If you feel lucky, you might try using packetoffset at value 1 or 2 before giving up completely.
Hopefully, most USB mice should work. But in case you want to be 100% sure before buying a new mouse, here's the start of a list
- Logitech "First Mouse" (Optical, with wheel obviously :-)
- Logitech Wheel Mouse Optical ("Black Limited Edition", PN930808-0403)
- Targus USB-PS2 Optical Mini Mouse
- Micro Innovations Wheel Mouse
- Microsoft Basic Optical Mouse
- Microsoft 3button mouse with Intellieye
- Microsoft Trackball Explorer 1.0
- [Logitech MX310 can work, with a packet size tweak]
- Logitech MX300 (configure packetsize=5 )
- Logitech "MX700 Cordless Optical Mouse" (configure packetsize=6 )
- Kensington PocketMousePro Wireless (Model#72117)
- Targus Notebook Wireless Optical Mouse (Model PAWM10U)
- Logitech "Cordless MouseMan, Optical" (configure packetsize=5 )
- Microsoft Wireless Optical Mouse 2.0 (configure packetsize=6, packetoffset=1)
(perhaps people can retest the above mice, with my new packetsize adjustment, and report back to me?)
- Logitech TrackMan Wheel (PN 804360) [But people say it can work now..?]
- Logitech [MouseMan?] M-BA47 (PN 830357)
- microsoft wireless optical mouse