From 1f951f1a3a85377fbcecc6c10aba462517fdab9e Mon Sep 17 00:00:00 2001 From: Romain Vimont Date: Tue, 22 Feb 2022 19:08:15 +0100 Subject: [PATCH] Update FAQ to match the latest version --- FAQ.md | 44 ++++++++++++++++++++++++++------------------ 1 file changed, 26 insertions(+), 18 deletions(-) diff --git a/FAQ.md b/FAQ.md index 5829136d..9f22b8ba 100644 --- a/FAQ.md +++ b/FAQ.md @@ -4,23 +4,16 @@ Here are the common reported problems and their status. +If you encounter any error, the first step is to upgrade to the latest version. + ## `adb` issues `scrcpy` execute `adb` commands to initialize the connection with the device. If `adb` fails, then scrcpy will not work. -In that case, it will print this error: - -> ERROR: "adb get-serialno" returned with value 1 - This is typically not a bug in _scrcpy_, but a problem in your environment. -To find out the cause, execute: - -```bash -adb devices -``` ### `adb` not found @@ -32,11 +25,9 @@ in the release, so it should work out-of-the-box. ### Device unauthorized - -> error: device unauthorized. -> This adb server's $ADB_VENDOR_KEYS is not set -> Try 'adb kill-server' if that seems wrong. -> Otherwise check for a confirmation dialog on your device. +> ERROR: Device is unauthorized: +> ERROR: --> (usb) 0123456789abcdef unauthorized +> ERROR: A popup should open on the device to request authorization. When connecting, a popup should open on the device. You must authorize USB debugging. @@ -48,10 +39,16 @@ If it does not open, check [stackoverflow][device-unauthorized]. ### Device not detected -> error: no devices/emulators found +> ERROR: Could not find any ADB device Check that you correctly enabled [adb debugging][enable-adb]. +Your device must be detected by `adb`: + +``` +adb devices +``` + If your device is not detected, you may need some [drivers] (on Windows). There is a separate [USB driver for Google devices][google-usb-driver]. [enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling @@ -63,12 +60,23 @@ If your device is not detected, you may need some [drivers] (on Windows). There If several devices are connected, you will encounter this error: -> error: more than one device/emulator +ERROR: Multiple (2) ADB devices: +ERROR: --> (usb) 0123456789abcdef device Nexus_5 +ERROR: --> (tcpip) 192.168.1.5:5555 device GM1913 +ERROR: Select a device via -s (--serial), -d (--select-usb) or -e (--select-tcpip) -the identifier of the device you want to mirror must be provided: +In that case, you can either provide the identifier of the device you want to +mirror: ```bash -scrcpy -s 01234567890abcdef +scrcpy -s 0123456789abcdef +``` + +Or request the single USB (or TCP/IP) device: + +```bash +scrcpy -d # USB device +scrcpy -e # TCP/IP device ``` Note that if your device is connected over TCP/IP, you might get this message: