breeze2 / dsu-controller-guides

A mobile app to simulate some game controllers.
https://dsu-controller-guides.vercel.app
76 stars 2 forks source link

DSUController Guides

DSUController (means DualShock UDP controller) is a mobile app based on cemuhook-protocol to simulate some game controllers. It can be used with Cemu using Cemuhook, Citra, Dolphin, Yuzu and other more game console emulators.

Download

Get it on Google Play Download on the App Store

Screenshots

Controller Page Settings Page

Run with Dolphin

  1. Open Controller Settings on Dolphin.

  2. Click Alternate Input Sources.

  3. Check Enable.

  4. Click Add..., input the DSUController's IP address and port number (find them on the settings page).

    Add DSU Client
  5. Select Emulated Wii Remote as Wii Remote 1 and click Configure.

  6. Select DSUClient/1/ as Device.

  7. Download DSUController.ini into the Dolphin Config folder:

    • windows: ~/Documents/Dolphin\ Emulator/Config/Profiles/Wiimote/
    • macOS: ~/Library/Application\ Support/Dolphin/Config/Profiles/Wiimote/
  8. Select DSUController as Profile, and click load.

    Configure Controller
  9. Close Controller Settings and start some games to have fun.

FAQ

  1. Why doesn't DSUClient/x/ appear on Dolphin's Devices list?

    Try to restart the DSU server or relaunch the app.
    Make sure the app and emulator are on the same Wi-Fi network, and Local Network Access is enabled on the app.

  2. Can it rumble?

    Yes, but the PR for this feature is not merged currently.
    You can download the trial version of Dolphin Emulator from the artifacts.
    Click Motor, and select Motor 0 or Motor 1 on Configure Output window. The phone will vibrate when you click Test.

    Configure Motor
  3. Can it simulate Wii Nunchuk?

    Yes, but you need two smartphones.
    First, download DSUController_with_Nunchuk.ini into the Dolphin Config folder.
    Then select DSUController_with_Nunchuk as Profile on Dolphin Emulator controller settings window and load it.
    Make sure the phone DSUClient/1/ uses layout Wii Remote and the phone DSUClient/0/ uses layout Wii Nunchuk on DSUController settings page.

    Controller Page Settings Page
  4. Can it simulate Wii Classic Controller?

    Yes.
    First, download DSUController_with_Classic.ini into the Dolphin Config folder.
    Then select DSUController_with_Classic as Profile on Dolphin Emulator controller settings window and load it.

    Controller Page Settings Page

Run with Cemu 2.0

  1. Open Input settings on Cemu 2.0,
  2. Select Wii U GamePad as Emulated controller (suppose you select Wii Classic as Controller Layout on DSUController app).
    Controller Searching
  3. Click the + button next to the Controller dropdown, select DSUController as API and input the ip and port (you can find them on DSUController app).
    Controller Searching
  4. Wait for the searching, select Controller 2 as Controller and click the Add button.
    Controller Searching Controller Searched
  5. Click Settings and check Use motion.
    Controller Settings
  6. Configure key mappings:
    • Click the A button on Cemu and then press the a button on DSUController app.
    • Click the click button of Left Axis and then double press the left stick on DSUController app.
    • And more...
      Controller Key Mapping
  7. Close Input settings and start some games to have fun.

Run with DSU Manager (on Windows)

Only supports windows at present

  1. Download and install latest ViGEmBus.
  2. Download and install latest DSU Manager.
  3. Open DSU Manager, and click Start, you will get a QRCode.
    DSU Manager Start DSU Manager QRCode
  4. Open the settings page on DSU Controller (v2.0 at least), click Connect DSU Manager, and then scan the QRCode.
    Scan QRCode Device List
  5. Now you get a virtual XInput controller, you can use it to play any games on your PC πŸŽ‰πŸŽ‰πŸŽ‰.

FAQ

  1. How to press JoyStick (trigger l3 or r3) ?

    Within half a second (0.5s), double tap the joystick on DSUController (v2.3.0 at least), will trigger the joystick pressing.

  2. After scanning the QR code, nothing happened?

    Make sure DSUManager can communicate through Windows Firewall, please refer to this video, How to Allow a program to communicate through Windows Firewall for Microsoft.

Run with yuzu (on Windows)

  1. Similarly, you need to have ViGEmBus and DSU Manager installed first.
  2. Make sure DSU Controller is connected with DSU Manager.
  3. Open the settings page on DSU Controller, select Xbox 360 or JoyCon Left as Controller Layout.
  4. Open the yuzu Configuration window, select Controls tab, select Pro Controller or Left JoyCon as Connect Controller, and select Xbox 360 Controller 0 as Input Device, then yuzu will complete button mappings automatically.
    Configure Controls
  5. Check the Vibration.
  6. Check the Motion, Click Motion Configure.
  7. Open the Configure Motion/Touch window, add CemuhookUDP server (you can find the ip and port on DSU Manager), then click OK to close this window.
    Configure Motion Device Ip and Port
  8. Click Motion1 [not set] or Motion1 [mouse], shake your phone, it will change to Motion1 [cemuhookudp].
  9. Next just enjoy your game on yuzu πŸŽ‰πŸŽ‰πŸŽ‰.

Run with Ryujinx (on Windows)

  1. Similarly, you need to have ViGEmBus and DSU Manager installed first.
  2. Make sure DSU Controller is connected with DSU Manager.
  3. Open the settings page on DSU Controller, select Xbox 360 or JoyCon Left as Controller Layout.
  4. Open the Ryujinx Settings window, select Input tab, select Pro Controller or Left JoyCon as Controller Type, and select Xbox 360 Controller (0) as Input Device, then Ryujinx will complete button mappings automatically.
    Configure Controls
  5. Check the Rumble.
  6. Check the Motion, Click Configure.
  7. Open the Motion Control Settings window, check the Use CemuHook compatible motion, input the ip and port of the server host (you can find the ip and port on DSU Manager), input 1 as Controller Slot.
    Configure Motion
  8. Click Save and click OK.
  9. Next just enjoy your game on Ryujinx πŸŽ‰πŸŽ‰πŸŽ‰.

Magic combination Keys

  1. Select one magic layout, like Xbox 360 Lite Magic, or JoyCon Left Magic (v2.1 at least).
  2. Configure combination keys.
  3. For example, configure as shown, then press the πŸ”Ό button and move, it will trigger the L(move to right) or ZL(move to left) pressing.
    Configure Motion Device Ip and Port

Use the game controller connected with your phone

See #12

Lock buttons

See #25

Privacy & Terms