# ViXEn
**Vi**ta **X**-input **En**abler

PSVita kernel driver for x-input gamepads (e.g. xbox360)

## Features

* Support for up to 4 wired usb x-input/dinput/hid, original xbox and ps3 devices.
* Support for up to 4 wireless Xbox 360 gamepads via 1 wired usb receiver.
* Auto turn-off wireless controllers on suspend.

For full list of supported devices see [here](src/devicelist.c)

## Notes:
* xbox 360 wireless receiver takes over all 4 gamepad ports, so you can't use wired and wireless gamepads simultaniously.
* 8bitdo adapter requires setting it's mode to Dinput mode (see it's manual)

## Read this carefully
There two versions of plugins: `vixen.skprx` and `vixen_ds3.skprx`. Second one supports wired ds3-alike pads.  
If you use `vixen_ds3.skprx` you
1. need to make sure it's first plugin under `*KERNEL`
2. **will** lose ability to pair wireless ds3 via usb on pstv. So if you need to - temporarily comment-out plugin.
3. ds3 support is very unstable atm.
Tl;dr if you don't use anything, that presents itself as ds3 (except wireless ds3 itself) - use `vixen.skprx`. Otherwise you may try `vixen_ds3.skprx`

## Installing
* Copy `vixen.skprx` or `vixen_ds3.skprx` into `ur0:tai` folder
* Add `ur0:tai/vixen.skprx` or `ur0:tai/vixen.skprx` line under `*KERNEL` in tai config and reboot.
* For vita you need usb Y-cable and external power. See [this](https://github.com/isage/vita-usb-ether#hardware) for example.
* For pstv it is **highly** recommended to use usb-hub with external power for gamepads with force-feedback.

## FAQ
* **Does it support joycon, xbox one s, _insert another wireless controller here_?**  
  Kinda. It supports **wired USB** controllers only. Yes, Xbox 360 is also wired (because you need receiver).  
  For wireless (bluetooth) use [ds34vita](https://github.com/MERLev/ds34vita), [VitaControl](https://github.com/Hydr8gon/VitaControl) or [MiniVitaTV](https://github.com/TheOfficialFloW/MiniVitaTV)  
  Alternatively, it supports 8bitdo adapter for bluetooth pads (only ver2 tested).
* **Can i connect my Xbox 360 pad via charge'n'play?**  
  No. Because it's more charge than play. It doesn't support data. You need wireless receiver.
* **Does it support _insert controller name here_?**  
  Currently it supports plenty of x-input devices, original xbox devices (via xbox->usb adapter) and some wired HID gamepads. See [here](src/devicelist.c)
  If your device isn't in that list (or doesn't present itself as ds3 or xbox or xbox360 pad), see [that list](https://github.com/xboxdrv/xboxdrv/blob/stable/src/xpad_device.cpp#L29)
  If it's in that list - i can add support. If it isn't - i, most likely, can't (yet) without having such device.
* **Can i install it alongside another input plugin?**
  Generally that isn't recommended. Most input plugins (ds34vita/vitacontrol) hook same functions, conflicts will definitely arise.  
  You can use it with ds4touch/ds4motion.
* **There's no guide/home/ps button on my pad**
  Use L+R+Start combo instead

## Requesting support for new controllers
See [ViXEn Helper](https://github.com/isage/vixen-helper)

## Building

* Install [vitasdk](https://vitasdk.org)
* `mkdir build && cmake -DCMAKE_BUILD_TYPE=Release .. && make`

## License

MIT, see LICENSE.md

## Credits

* [xboxdrv](https://github.com/xboxdrv/xboxdrv) - for vid/pid pairs and protocol description
* [xerpi](https://github.com/xerpi) - for ds3vita
* **CBPS discord** - for support and stupid ideas
* **rem** - for being lazy/buzy to do the same :P
* [Graphene](https://github.com/GrapheneCt) - for testing and ideas
* [Paddel06](https://github.com/paddel06) - for testing og xbox support
* **null** for requesting and testing mini diva controller support and adrenaline bug
* [Raphaël Assenat](https://github.com/raphnet) for providing Raphnet Technologies PSX to USB report description