QUsb2Snes is a websocket server that provide an unified protocol for accessing hardware/software that act like a SNES (or are a SNES). A classic usage is to use the FileViewer client to upload roms to your SD2SNES. But it allows for more advanced usage like reading/writing the memory of the SNES.
Look at the docs/Protocol.md
file to have a detailed view of the command of websocket protocol.
This repository only have QUsb2Snes and a file viewer application. If you want the full experience go Usb2Snes project. Otherwise, download the latest release of QUsb2Snes.
You need to install the last Usb2Snes firmware by Redguyyy (https://github.com/RedGuyyyy/sd2snes/releases/) . Just follows the instruction provided. Don't start usb2snes.exe since QUsb2snes do the same thing that the original software. Your sd2snes device should show up on the Devices menu when connected.
Multitroid provide a patched version of Snes9x with a lua script that allow for external software to communicate with it. Get the emulator on http://multitroid.com/. Activate the Lua bridge on the device menu of QUsb2Snes then run the multibridge.lua scripts on Snes9x.
You can use Snex9x or bsnes-mercury cores. You must first edit your retroarch.cfg
file (can be found in %appData%\RetroArch) to set network_cmd_enable = "true"
(default is false). Then you need to activate the RetroArch virtual device on the devices menu. Any flavor of bsnes-mercury is prefered as we can access the ROM data.
Snex9x core : For software needing to the patch the ROM (multitroid for example) you etheir need to patch the rom manually with the IPS file or put the IPS file along side the rom with the same name for retroarch to auto patch it.
You can connect to a remote RetroArch by adding a RetroArchHost=YourOwnHost in the config.ini file
Only tested with Super Metroid.
Enable the SNES classic support on the device menu.
You need to 'hack' your SNES classic with the Hakchi2 CE version (https://github.com/TeamShinkansen/hakchi2/releases/) then remove the covershell mod (as explained in https://github.com/TeamShinkansen/hakchi2/releases/tag/v3.4.0). Install the serverstuff
mod provided by QUsb2snes: copy the serverstuff.hmod
to the user_mods
directory on Hakchi2, then install the mod with Hakchi2
Start the game and check if the SNES classic appear on the Devices menu, it should display something like SNES classic : no client connected
. If not, try restarting the game.
It will not work with the 'normal' Hakchi2 version as the Hakchi2 CE provide a more stable way to access the SNES Classic.
QUsb2snes project follow the GPL version 3 licence, you can find the full version of the licence on the LICENCE file.