mirror of
https://github.com/cathery/sys-con.git
synced 2024-11-16 23:11:25 +00:00
78 lines
4.0 KiB
Markdown
78 lines
4.0 KiB
Markdown
# sys-con-plus-mitm
|
|
|
|
#### Adding man-in-the-middle support to the sys-con sysmodule
|
|
|
|
## Description
|
|
This sysmodule aims to add **Wireless** support for third-party controllers to the Nintendo Switch. This will be useless once sys-con sysmodule achieves the direct bluetooth support.
|
|
|
|
This sysmodule is inspired by the hid-mitm sysmodule (https://github.com/jakibaki/hid-mitm) which is now obsolete.
|
|
|
|
The **USB** support provided by the original sys-con is intended to remain untouched so that both wireless and wired controllers can work together.
|
|
|
|
## Example setup
|
|
|
|
🎮 ))) Bluetooth ((( RaspberryPI ))) WiFi ((( NintendoSwitch
|
|
|
|
# sys-con
|
|
|
|
#### A Nintendo Switch custom sysmodule for third-party controller support. No man-in-the-middle required!
|
|
###### \[Switch FW 5.0.0+\] [Atmosphère only]
|
|
|
|
|
|
|
|
## Description
|
|
This sysmodule aims to provide complete functionality for most popular game controllers not supported by Nintendo Switch.
|
|
At the current moment, **only USB connection** is supported.
|
|
|
|
This app is missing a lot of features. For more information, see the [issues page](https://github.com/cathery/sys-con/issues).
|
|
|
|
### ⚠ I can't support your generic 3rd party HID controller yet.
|
|
It is a limitation of the firmware and I'm looking to work around it.
|
|
|
|
|
|
## Install
|
|
|
|
Grab the latest zip from the [releases page](https://github.com/cathery/sys-con/releases). Extract it in your SD card and boot/reboot your switch.
|
|
|
|
## Config
|
|
|
|
sys-con comes with a config folder located at `sdmc:/config/sys-con/`. It contains options for adjusting stick/trigger deadzone, as well as remapping inputs. For more information, see `example.ini` in the same folder. All changes to the files will be updated in real time.
|
|
|
|
## Progress roadmap
|
|
- [x] **~~Docked USB Support~~**
|
|
- [x] **~~\[5.0.0-7.0.0\] FW Version Support~~**
|
|
- [x] **~~Xbox 360 Controller Support~~**
|
|
- [x] **~~Xbox One X/S Controller Support~~**
|
|
- [x] **~~Dualshock 3 Support~~**
|
|
- [x] **~~Undocked USB Support~~** Works with a USB-C OTG adapter. Some knock-off brands may not support OTG.
|
|
- [x] **~~Xbox 360 Wireless adapter~~**
|
|
- [x] **~~Dualshock 4 Support~~**
|
|
- [ ] **[Rumble Support](https://github.com/cathery/sys-con/issues/1)**
|
|
- [ ] **~~[Bluetooth Support]~~** See ndeadly's [MissionControl](https://github.com/ndeadly/MissionControl)
|
|
- [ ] **[Motion Controls Support](https://github.com/cathery/sys-con/issues/9)**
|
|
- [ ] **Config application**
|
|
|
|
## Building (For developers)
|
|
|
|
Don't download the project as ZIP. It doesn't copy the submodules correctly and you will be left with empty folders.
|
|
|
|
Instead, clone the repository **recursively** using any git client you have. (Git Bash, Git GUI, Github Desktop, etc.)
|
|
|
|
Like all other switch projects, you need to have [devkitA64](https://switchbrew.org/wiki/Setting_up_Development_Environment) set up on your system.
|
|
|
|
For compatibility with the Atmosphere-libs dependency, this project currently uses a version of libnx at commit **[b35d42f](https://github.com/switchbrew/libnx/commit/b35d42faaa60b02662aaaf0702614f6e4afcbbbc)**. Clone the repository, checkout to that commit, and run `make install` to set it up.
|
|
|
|
If you have **Visual Studio Code**, you can open the project as a folder and run the build tasks from inside the program. It also has Intellisense configured for switch development, if you have DEVKITPRO correctly defined in your environment variables. Handy!
|
|
|
|
Otherwise, you can open the console inside the project directory and use one of the following commands:
|
|
|
|
`make -j8`: Builds the project and its dependencies (libstratosphere) and places the resulting files in the output folder (out/). The -j8 means it will create 8 separate threads to speed up the building process. Make it lower if it freezes up your system.
|
|
|
|
`make clean`: Cleans the project files (but not the dependencies).
|
|
|
|
`make mrproper`: Cleans the project files and the dependencies.
|
|
|
|
For an in-depth explanation of how sys-con works, see [here](source).
|
|
|
|
[](https://ko-fi.com/H2H316ZQV)
|