https://github.com/riking/joycon

Joy-Con input driver for Linux
https://github.com/riking/joycon

Last synced: 6 days ago
JSON representation

Joy-Con input driver for Linux

• Host: GitHub
• URL: https://github.com/riking/joycon
• Owner: riking
• Created: 2017-03-27T22:23:23.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2020-09-28T18:46:06.000Z (over 4 years ago)
• Last Synced: 2024-12-24T02:47:59.644Z (8 days ago)
• Language: Go
• Size: 256 KB
• Stars: 289
• Watchers: 21
• Forks: 31
• Open Issues: 46
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# joycon

Joy-Con input driver for Linux

The current main code, written in Go, lives in the `prog4/jcdriver` folder, as it was the fourth attempt at making this program.

## Compiling

```

sudo apt install libudev-dev go git

go get -u github.com/riking/joycon/prog4/jcdriver # Download and build the program

cp $(go env GOBIN)/jcdriver ./jcdriver # Copy the binary out of where Go drops it

sudo ./jcdriver # Run the driver

```

If an old Go version is installed and it complains about `GOPATH not set`, run:

    export GOPATH=$HOME/go

and try again.

## Basic Instructions

After starting the program as root, connect the Joy-Cons over Bluetooth. Once the program has picked them

up, the player lights will begin flashing. Press L+R on the joycons to "pair" them up as a single controller device,

which is then available to the rest of the system.

If you want the joycons to function as a pair of controllers with analog sticks, press the SL + SR buttons to pair as a single controller.

If your game needs a stick axis to be inverted, specify --invert LV (or LH, RV, RH) when running jcdriver.

TODO: Interface to switch between the modes / drop controllers for re-pairing

## Limitations

The code will not actively scan and connect to the joycons. When the code is run on Mac, the "press button to

reconnect" works due to the OS bluetooth driver (though the code cannot provide the device to other programs,

as that requires a kext).

TODO: Scan and reconnect mode for bluez.

## TODO List

PRs and help for any of this is appreciated!

If I neglect your contributions, try pinging me on Twitter (@riking27); I may have missed the notification.

 - Output codes for "Held down HOME" and "Held down CAPTURE", and possibly "Pressed HOME" / "Pressed CAPTURE"

   - Ref: [Subcommand 4](https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/bluetooth_hid_subcommands_notes.md#subcommand-0x04-trigger-buttons-elapsed-time)

 - Graphical controller management interface

   - Programmatic interface, so someone else can build the graphical interface

   - custom Capture button handling, possibly?

 - Linux: accept reconnect requests from the controllers

 - "Active scanning" mode to pick up new controllers without holding down SYNC button

 - Configuration storage - save calibration data so it doesn't need to be pulled on every connection

 - Button remapping

 - Motion control support

    - Figure out how to work the insane system Linux has of delivering gyro data. Consider requiring use of a custom protocol.

 - Implement as a C++ library

    - Implement as a C library

    - Linux kernel driver to remove the suppressed devices so games don't try to use them

    - Mac kernel driver to present the combined controller to other programs

    - Windows kernel driver to do anything at all with the controllers