Connect from a computer
Use the USB link to open a root shell, run commands, copy files with an integrity check and type with your computer’s keyboard. Check support status and your phone page for USB support. The cable used to load FPLinux stays connected as a private link between your computer and the phone.
Start the phone first, as described in Run FPLinux or, for a downloaded archive, in Standalone archive. The commands on this page work once that run reports a ready session.
What the USB link is
Section titled “What the USB link is”The phone appears on your computer as a small USB Ethernet device. Your computer receives its address automatically; do not set addresses by hand or reuse an address from an earlier run. The link carries the shell, file copies and the keyboard bridge described below.
It is not an Internet connection. The phone gets no gateway or DNS over USB and does not forward traffic for your computer. Supported UMS9117 phones can use a Bluetooth PAN connection for Internet access. Bluetooth is unsupported on the SC9820E Xiaomi Qin 1s+.
The phone is always the USB device on this cable. It cannot act as a USB host, so USB keyboards, drives and other peripherals cannot be plugged into the phone.
Open a shell
Section titled “Open a shell”./fplinux console <target>sh Run.sh --reconnectRun.cmd --reconnectpython3.14 -I fplinux.py run --reconnectYou get a root shell. It is authenticated with a key created for the current session. Password login, port forwarding, agent forwarding and X11 forwarding are disabled. Leaving the shell with exit, or with the OpenSSH escape ~., closes only the shell. Linux keeps running.
Reconnect after unplugging
Section titled “Reconnect after unplugging”Linux keeps running after you unplug the cable only while the phone has another power source, such as a battery. Plug the cable back in and run the same command as above. FPLinux checks that the phone still runs the same session and image before it opens the shell. Do not load the phone again just to restore the link.
Without a battery, unplugging the cable cuts the phone’s power. Before you unplug, follow End the session safely.
A power-off or a new load starts a new session, and the connection details of the old one no longer apply. Commands and file copies that were interrupted are not repeated automatically.
Run one command
Section titled “Run one command”Use --exec when you do not need an interactive shell. The command runs on the phone; its output and exit status come back to your computer.
./fplinux console <target> --exec 'uname -r'sh Run.sh --reconnect --exec 'uname -r'Run.cmd --reconnect --exec "uname -r"python3.14 -I fplinux.py run --reconnect --exec 'uname -r'Stopping the local --exec client can leave a silent command running on the phone. Use bounded commands where possible. If you interrupt one, reconnect and stop that command explicitly before ending the session.
Copy files
Section titled “Copy files”On a Linux PC, upload a file to the phone or pull one from it. The Windows launcher does not support file transfer.
./fplinux console <target> --upload ./song.wav /tmp/song.wav./fplinux console <target> --pull /tmp/recording.wav ./recording.wavsh Run.sh --reconnect --upload ./song.wav /tmp/song.wavsh Run.sh --reconnect --pull /tmp/recording.wav ./recording.wavpython3.14 -I fplinux.py run --reconnect --upload ./song.wav /tmp/song.wavpython3.14 -I fplinux.py run --reconnect --pull /tmp/recording.wav ./recording.wavUse these commands rather than a separate SFTP client when the result matters. They guarantee that:
- the complete file’s size and SHA-256 are checked before it appears at the destination;
- the destination file appears whole, never partially written;
- if any step fails, the destination is left unchanged.
The source must be a regular file. On the phone, give an absolute path in a directory that already exists and has enough free space. On your computer, the destination directory must already exist. A pull also checks that the phone’s source file did not change during the transfer.
Limits:
- A copy does not resume after an interruption; start it again.
- Only regular files can be copied, not directories or raw devices.
- A destination in RAM, such as
/tmp, uses the phone’s limited memory and disappears when the phone powers off. To keep files, copy them to a mounted microSD card.
Files for graphical applications
Section titled “Files for graphical applications”Open Files → My files on the phone first to create its folder. Upload your file to /home/fplinux/Files/, using its full destination path, such as /home/fplinux/Files/program.jar.
Uploads belong to root, while graphical applications use the fplinux account. After uploading, run this command in the phone’s SSH shell so the application can read and update the file:
chown fplinux:fplinux /home/fplinux/Files/program.jarReplace program.jar with your file’s name and repeat this step for any companion files you uploaded. Then open the file in Files.
Type with your computer’s keyboard
Section titled “Type with your computer’s keyboard”The bridge is available on supported UMS9117 phones; use it only where your phone checklist lists support for the current profile. The SC9820E Xiaomi Qin 1s+ uses SSH for PC command input and does not support this bridge.
The PC keyboard tool is supplied by a source build or a Linux system-card export. RAM ZIPs do not include it.
The keyboard bridge forwards one keyboard from your computer to the phone. On the phone it behaves like any other keyboard: it controls the graphical interface and types into its text fields, or into direct-display applications such as TyrQuake when the graphical session is stopped.
sudo timeout 60s ./fplinux console <target> --keyboard /dev/input/eventNsudo timeout 60s ./host/fplinux-usb-keyboard \ --interface 0 --keyboard /dev/input/eventNReplace /dev/input/eventN with the input device of the keyboard to forward. On most Linux computers, ls -l /dev/input/by-id/ lists keyboards under names ending in -event-kbd, and you can pass that path instead. Root privileges are usually needed to open the keyboard and the USB interface.
The bridge can run alongside a shell, a single command or a file copy. If the cable or the keyboard is disconnected, the phone releases all forwarded keys, so no modifier stays held. Stopping the bridge releases the keyboard on your computer.
Saved connection files
Section titled “Saved connection files”FPLinux keeps private keys and an OpenSSH configuration for the current session in its working data directory. Use the reconnect command for your checkout or archive to select the right configuration and check that the target and running image still match.
Keep these files in place while the phone is running. They are specific to that session; copying them to another installation or a later session does not create a general phone login.