Configuring a new USB Connection - kwsch/SysBot.NET GitHub Wiki

usb-botbase can be used instead of sys-botbase if you are having trouble maintaining a stable Wi-Fi connection. Keep in mind that Wi-Fi can be unstable even if your internet speed is excellent.

Important

You must follow every step in EXACTLY THE RIGHT ORDER. Do not skip any steps or hop around. If you go out of order, uninstall what you have installed and start over.

Setup

To use usb-botbase:

  1. Download the usb-botbase .7z file from Koi-3088's fork.
  2. Download and use Zadig to install the libusbK driver for your Switch.
  3. Download and install libusb filters.
  4. Copy the contents of the extracted .7z file to the root of your SD card. The atmosphere folder should be copied to where you see an existing atmosphere folder in root. Look in your SD card at the atmosphere/contents/430000000000000B directory to check that you did it correctly.
    image
  5. Reboot to payload, boot back into Atmosphere.
  6. Connect your Switch via a USB cable to your computer. Wait until the right JoyCon flashes blue to indicate usb-botbase has initialized. (If it does not blink blue, you haven't installed usb-botbase correctly. Try step 4 again.)
  7. Open Zadig, click on "Options" -> "List all devices".
  8. Select "Nintendo Switch", choose libusbK, click "Replace/Reinstall". Your driver should now be libusbK instead of WinUSB.
  9. Open the libusb filter wizard, click "Install a device filter", select your Nintendo Switch.
  10. On your computer, go to Start > Device Manager, scroll down until you see libusbK Devices, right click your device, select Properties, and make note of your USB port without the leading zeroes. This should be added to the configuration when setting up a bot.

Note: If you are only using usb-botbase instead of sys-botbase, it is recommended to remove ldn_mitm. This sys-module is unnecessary since it is for Wi-Fi communications.

Troubleshooting

If you are having an issue, chances are you did not follow every step in the correct order.

Start with opening Zadig and looking at what it shows.

  1. There's no funnel icon underneath the green arrow.
    You do not have a libusb filter installed (Step 3). Open the libusb filter wizard and install it.
    image

  2. Driver is showing as "WinUSB".
    You haven't installed the libusbK driver (Step 6-7). Make sure you are using usb-botbase, then boot into sysNAND with Atmosphere. Connect a USB cable and wait until the right JoyCon flashes blue. Install the driver.

  3. USB ID is showing 2000 instead of 3000.
    You installed the libusbK driver without usb-botbase initialized or you are using sys-botbase. Remove libusb filters, revert to the WinUSB driver, reboot your Switch, then go back to Step 3.
    image

  4. My Switch keeps discharging.
    Due to how USB works, you need a USB data port capable of supplying 1.5A over 5V (7.5W). In other words, your computer either needs to have a native USB-C port, or you need to use a powered USB hub.

  5. My Switch does not appear in Device Manager.
    Make sure your Switch is powered on, not asleep, and that you're using a compatible USB-A to USB-C, or a USB-C to USB-C cable.

No, it will not work with the Nintendo Switch dock.
No, various USB-A to USB-C adapters will not work. Native ports and compatible powered hubs only.

I am unable to get anything here to work.

  • If these still don't resolve your issue, come to the ALM Discord linked on the repository's main page. Please show the results of the above steps when asking for help. This means show photos/screenshots, not only tell us in text that everything is right.
  • You can unlock access to the help channels by reading very carefully. Asking for help in any channel is a confirmation that you know what is on this page. Please state what you have already tried from the Wiki.
    • Ask any SysBot.NET questions in #sysbot-net-help.
    • Ask any PKHeX-Plugins questions in #alm-livehex-help.
    • The unlock word for SysBot.NET is tulips but spelled backwards. The unlock word for PKHeX-Plugins is world but spelled backwards. Use the !unlock command in the #bot-testing channel with the secret word to gain access. (e.g. If you think the secret word is hawks, you would type !unlock hawks.)