STF (or Smartphone Test Farm) is an application for controlling smartphones, smartwatches and other Android gadgets remotely. Two modes are supported: 1. Local Connection Mode: The Android device is connected directly to the LCMD MicroServer. This is the default mode and does not support hot-plugging. Please ensure the Android device is connected before starting the application, or restart the application after connecting a new device. (Technical Note: The application mounts the /dev/bus/usb path using the --device flag; the underlying mechanism does not support hot-plug recognition.) 2. Remote Connection Mode: The Android device is connected to a different device. You will need to deploy the ADB service on that device yourself and configure the connection by modifying the application's deployment parameters. This mode supports hot-plugging. You can refer to this ADB service example: https://github.com/DeviceFarmer/stf/blob/master/docker-compose.yaml Instructions to Use: 1. Open Developer Options on the Android device and enable USB Debugging. 2. Connect the Android device to the LCMD MicroServer using a USB cable (if using Remote Connection Mode, connect the Android device to the machine where the ADB service is deployed). 3. Open the application on the LCMD MicroServer. For the first connection, you must allow USB Debugging on the Android device. Troubleshooting: 1. Xiaomi phones require "USB Debugging (Security Settings)" to be enabled, and you must agree to the installation of STFService on the phone. Reference: https://github.com/openstf/stf/issues/603 2. Some Android devices require selecting "File Transfer" (MTP mode) after connecting. 3. Some USB cables do not support data transfer and cannot be used to connect devices. 4. If using Remote Connection Mode, ensure the LCMD MicroServer can reach the ADB service. 5. For other issues, please refer to https://github.com/DeviceFarmer/stf/?tab=readme-ov-file#troubleshooting
