====== Joystick Research ======

  * [[bsd;freebsd_14.1_xfce|FreeBSD 14.1 (Xfce)]]
  * [[devices;sidewinder_precision_pro|Microsoft Sidewinder Precision Pro (USB)]]

  * :!: Joysticks on FreeBSD need to be at ''/dev/uhid#'' ((''flightgear'', ''neverball'', seemingly ''doomsday'' but it freezes on launch))
  * ''uhidd'' by-default does ''/dev/uvhid#'', that can be symlinked to ''/dev/uhid#'' or be done automatically with ''uhidd -H uhid'' ((it assigns a specific ''uhid#'' automatically))
  * ''uhidd'' has a lot of flags in examples for keyboard/mouse/consumer, but a joystick only needs the virtual generic interface with ''uhidd -h'' (not all of ''-kmohs'')
  * ''uhidd'' has to unbind whatever kernel driver is on the joystick with ''uhidd -u'' to take it over
  * :?: Seemingly once ''uhidd'' takes control of the original ''/dev/input/event#'' device, if it had ''evdev'' or ''joystick'' forced through ''xorg.conf'' that driver gets unloaded according to ''Xorg.0.log'' ((it sounds like causing ''evdev'' to re-probe on the newly-created ''uhid#'' device could work? there's a ''cdev'' mention with ''devd -d'', but FlightGear shows buttons fine without joystick/evdev binding?))
  * USB devices are by-default put into ''/dev/uhid#'' paths with older [[https://man.freebsd.org/cgi/man.cgi?query=uhid&sektion=4&apropos=0&manpath=FreeBSD+14.1-RELEASE+and+Ports|uhid]] and [[https://man.freebsd.org/cgi/man.cgi?query=usb&sektion=4&apropos=0&manpath=FreeBSD+14.1-RELEASE+and+Ports|usb]] drivers ((using these older drivers prevents USB multimedia keys from working and presumably would require ''uhidd'' to solve; hence use the newer ''usbhid'' driver with ''hw.usb.usbhid.enable="1"'' and ''uhidd'' as-needed on game controllers))

  * 2024/09/09: ''uhidd'' is required to move game controllers to ''/dev/uhid#'' when using [[https://man.freebsd.org/cgi/man.cgi?query=usbhid&sektion=4&format=html|usbhid]]

===== uhidd =====

  * https://wiki.freebsd.org/uhidd
  * https://man.freebsd.org/cgi/man.cgi?query=uhidd
  * See ''devd.conf'' rule below to automate this

  su -

  pkg install 'uhidd'

  dmesg | grep 'ugen'

  uhidd -h -H 'uhid' -u '/dev/ugen0.6'

====== devd.conf ======

  * Last updated: 2024/09/13

  su -

  pkg install 'uhidd'

  ee '/usr/local/etc/devd/sidewinder-precision-pro-joystick-uhidd.conf'

<code>
notify 0 {
        match "type" "ATTACH";
        match "ugen" "ugen[0-9]+.[0-9]+";
        match "vendor" "0x045e";
        match "product" "0x0008";
        action "/usr/local/sbin/uhidd -h -H uhid -u /dev/$ugen";
};</code>

===== TODO =====

  * ''ld-elf.so.1 %LIBCUSE%'' error ([[https://forums.freebsd.org/threads/ld-elf-so-1-shared-object-libcuse-not-found.86293/|thread]])

  su -l

  mv '/usr/local/etc/devd/uhidd-devd.conf' '/usr/local/etc/devd/uhidd-devd.conf~'

===== TODO 2 =====

  * This avoids needing ''uhidd'' (connect joystick within 3 seconds)
  * TODO: USB device reset command and devd

  su - root -c "sysctl 'hw.usb.usbhid.enable=0' && sleep 3 && sysctl 'hw.usb.usbhid.enable=1'"