USB Mouse support under 4.0 Release

USB Mouse support under 4.0 Release

Benn Bollay originally placed this article in the Reader Forum, but I thought it deserved an article of its own.  Thanks Benn.

4.0-R: Quick and Dirty USB Mouse support

Gentlebeings —

For your quick and dirty USB Mouse support, please following these easy steps:

1. Add the appropriate entries to your kernel configuration file:
   
   device uhci
   device ohci
   device usb
   device ums
   
2. Add the appropriate lines to your /etc/rc.conf file:
   
   moused_enable="NO"
   moused_flags="/dev/ums0"
   usbd_enable="YES"
   usbd_flags="" (though I like -vv personally, just for the scroll factor)
   
3. Make sure your /etc/usbd.conf has these lines in it:
   
   device "Mouse"
   devname "ums[0-9]+"
   attach "/usr/sbin/moused -p /dev/${DEVNAME} -I
                  /var/run/moused.${DEVNAME}.pid"
   
4. Create the device entry
   
   cd /dev
   ./MAKEDEV ums0
   
5. Rebuild your kernel and reboot.  As always, I would recommend saving /kernel to /kernel.stable before trying out the new kernel.  It’s a handy thing to have around anyways.
   
6. Add the following line to /etc/rc.conf which enables the mouse on all virtual terminals:
   
   allscreens_flags="-m on"

I don’t think I forgot anything, but if I did please let me know 🙂

— Benn

References and man pages

Benn recommends the following man pages:

• usb(4)
• usbd(8)
• usbd.conf(5)
• usbdevs(8)
• ums(4)

If you have X11 pointed at sysmouse, then this will work just fine.  And it will support plugging/unplugging the mouse at runtime without the need of a manual HUP.

Addenda

You have to do this:

vidcontrol -m on

to actually enable it on the terminal.  Alexander Anderson said he found this piece of info on the man page for moused(8) by accident.  He also suggested step 6 above.