USB Networking - retrofw/retrofw.github.io GitHub Wiki

Setup

RetroFW 2.0 supports simple networking over USB. Connecting to a PC with the device on, and choosing Charger, will enable the USB Ethernet gadget.

It may just work without any configuration, as it uses the APIA IP range. RetroFW sets itself to 169.254.1.1, and seeing that your PC may choose one similar (169.254.1.X). If that's the case, the below should just work.

If you are unable to telnet in, you may need to set an IP for the new network connection.

Windows

  1. Go to Network Connections.
  2. Right-click the connection that says "USB Ethernet/RNDIS Gadget" and go to Properties.
  3. Click Internet Protocol Version 4 and hit the Properties button.
  4. Select "use the following IP address" and in the IP address field put 169.254.1.2.
  5. Use 255.255.255.0 for the subnet mask.
  6. Hit Ok.

Linux (iproute2)

  1. Find the new network device (eg, from dmesg or ip link, for example "enp7s0f3u1i1" or "usb0").
  2. Add the APIA IP address and netmask (sudo ip addr add 169.254.1.2/24 dev enp7s0f3u1i1)
  3. Bring the link up (sudo ip link set enp7s0f3u1i1 up)

macOS

  1. telnet 169.254.1.1
  2. There is no step 3!

Telnet

Once you're properly connected, open a console/command prompt and type telnet 169.254.1.1. When prompted enter root as the user, and you're in. All of this should work while using the device, and does not require you to be in the menu.

Windows 10 doesn't install the telnet client by default, install it by following this guide.

Capturing in-game screenshots:

  1. cd /media/mmcblk1p1/ - switch to external SD card (or save them wherever).
  2. fbgrab whatever.png - will save a screenshot named whatever.png.

FTP

FTP also works via this connection. Any client should work, I recommend FileZilla.

IP: 169.254.1.1 Port: 21 Username: root