Connect from Mac or Linux - retrogamehandheld/OpenDingux GitHub Wiki

This page is a guide on how to connect your OpenDingux device to a Macbook or Linux. This is meant primarily for power users, and specifically those with some knowledge/experience in linux, or at least a desire to learn it, but newer users may also benefit from messing with this.

Also refer to the Connect from your PC for other useful information.

MacOS

Note: This was tested on a Macbook running Mojave

  1. MacOS does not come with the RNDIS (Remote Network Driver Interface Specification) drivers needed to support the network connection over USB. You can get these drivers, called HoRNDIS, from here. Make sure to download the correct drivers for your system. For example 9.2 requires MacOS 10.11 and up. When installing the package, you may have to reboot the system.

  2. MacOS already has a SSH and SFTP client that you can use from the command line. If you prefer a graphical client there are many to choose from.

  3. On your Handheld, open the Network app in the Settings tab. Note the IP address if listed (it defaults to 10.1.1.2). Since this device doesn't have any WiFi, you can comfortably set this to "Allow logon without password" (unless of course you add WiFI later).

  4. Connect your Handhel via USB cable to your PC. If you're using an RG-350, use the rightmost USB port labeled USB2. Open your client of choice and configure it to connect to 10.1.1.2 with username root and leave the password blank. If you're a beginner, stick with using SFTP, advanced users can also open an SSH console and use Linux shell commands. FTP and Telnet are also supported, but SFTP and SSH work better anyway.

  5. When connected via SFTP, most directories will be read-only. This is normal, and is part of what makes OpenDingux relatively safe to mess with. Refer to the PC guide for a listing of directories and what they are used for.

$ ssh [email protected]
 _________________________
< Welcome to OpenDingux ! >
 -------------------------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

opendingux:/media/data/local/home #

$ sftp [email protected]
sftp> pwd
Remote working directory: /media/data/local/home
sftp> ls /media
/media/data    /media/home    /media/sdcard

Linux

Note: This was tested on Ubuntu 18.04.2 LTS. Other linux flavors could be different.

  1. Linux already comes with the RNDIS (Remote Network Driver Interface Specification) drivers needed to support the network connection over USB.

  2. Linux will already have a ssh and sftp client that you can use from the command line. If you prefer a graphical client there are many to choose from.

  3. On your device, open the Network app in the Settings tab. Note the IP address if listed (it defaults to 10.1.1.2). Since this device doesn't have any WiFi, you can comfortably set this to "Allow logon without password" (unless of course you add WiFI later).

  4. Connect your device via USB cable to your PC. If you're using an RG-350, use the rightmost USB port labeled USB2. Open your client of choice and configure it to connect to 10.1.1.2, username root, password leave blank. If you're a beginner, stick with using SFTP, advanced users can also open an SSH console and type Linux shell commands. FTP and Telnet are also listed, but SFTP and SSH work better respectively anyway, so I don't see much point to them.

  5. When connected via SFTP, most directories will be read-only. This is normal, and is part of what makes OpenDingux relatively safe to mess with. Refer to the PC guide for a listing of directories and what they are used for.