Skip to content

Conversation

ep1cman
Copy link
Contributor

@ep1cman ep1cman commented Jan 13, 2025

This pull request add support for ADB (Android Debug Bridge) devices in labgrid.

  • It supports USB (remote and local) and TCP adb devices.
  • It adds two new client commands
    • adb for interfacing with the device by the adb cli
    • scrcpy for remote screen/touch/keyboard/clipboard/etc. sharing

Checklist

  • Documentation for the feature
  • Tests for the feature
  • The arguments and description in doc/configuration.rst have been updated
  • Add a section on how to use the feature to doc/usage.rst
  • Add a section on how to use the feature to doc/development.rst
  • PR has been tested
  • Man pages have been regenerated

@ep1cman ep1cman force-pushed the adb branch 2 times, most recently from d234f34 to 15a4ce4 Compare January 13, 2025 12:18
Copy link

codecov bot commented Jan 13, 2025

Codecov Report

❌ Patch coverage is 29.89130% with 129 lines in your changes missing coverage. Please review.
✅ Project coverage is 45.1%. Comparing base (e9e43aa) to head (65102d5).
✅ All tests successful. No failed tests found.

Files with missing lines Patch % Lines
labgrid/remote/client.py 6.8% 54 Missing ⚠️
labgrid/remote/exporter.py 0.0% 45 Missing ⚠️
labgrid/driver/adb.py 51.6% 30 Missing ⚠️
Additional details and impacted files
@@           Coverage Diff            @@
##           master   #1564     +/-   ##
========================================
- Coverage    45.4%   45.1%   -0.3%     
========================================
  Files         172     174      +2     
  Lines       13500   13681    +181     
========================================
+ Hits         6130    6183     +53     
- Misses       7370    7498    +128     
Flag Coverage Δ
3.10 45.1% <29.8%> (-0.3%) ⬇️
3.11 45.1% <29.8%> (-0.3%) ⬇️
3.12 45.1% <29.8%> (-0.3%) ⬇️
3.13 45.1% <29.8%> (-0.3%) ⬇️
3.9 45.2% <29.8%> (-0.3%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@ep1cman ep1cman force-pushed the adb branch 4 times, most recently from e346334 to 892693a Compare January 14, 2025 12:26
Copy link
Member

@Emantor Emantor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some minor comments in regard to subcommand handling and attribute naming.

if resource.extra.get("proxy_required") or self.args.proxy:
proxy = resource.extra.get("proxy")
scrcpy_cmd.append(f"--tunnel-host={ip_addr}")
scrcpy_cmd.append(f"--tunnel-port={sshmanager.request_forward(proxy, host, 27183)}")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this always the same port? How will this interact with multiple devices connected over ADB to the same host?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, I had not tested multiple simultaneous screen sharing sessions. I have added some code to find a free port on the exporter and use that. It is based on the "get_free_port" code within labgrid that gets a free port on the client machine.

Is this worth moving into a more general location? Maybe within SSHConnection?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

get_free_port should already be in util.helper, so you should be able to import it directly.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That returns a free port on the machine running the labgrid client, I require a free port on the exporter. The way scrcpy works is that it runs a server on the android device and creates a port forward between it and the ADB host (the exporter in this case)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You might be able to handle that within the remote resource for the exporter, the SerialPortExport does something similar to choose a free port for ser2net.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is an additional complication to the scrcpy command.

I already use get_free_port in the ADBExport to get a port for the ADB server, which is started by the ADBExport.

The scrcpy server is not setup at this time, it is started by the scrcpy client when it connects to the device. It first connects via ADB, transfers over the binaries, starts the server, then uses ADB to create a port forward between the device and the ADB host (the exporter).

I am unable to know at the time of starting the exporter what ports will be available at the time scrcpy is launched, which could be weeks later.

@alextercete
Copy link
Contributor

Any updates on this? It would be great to get this merged.

@ep1cman ep1cman force-pushed the adb branch 3 times, most recently from 8b27627 to 33c3683 Compare September 16, 2025 14:56
Some forms of reset can reset the device into different modes. For example:
- Reboot
- Reboot into bootloader mode
- Reboot into recovery mode

Signed-off-by: Sebastian Goscik <[email protected]>
ADB is expected to be installed and working on the exporter and client machines.
For screensharing "scrcpy" needs to be installed on the client.

Signed-off-by: Sebastian Goscik <[email protected]>
@ep1cman
Copy link
Contributor Author

ep1cman commented Sep 16, 2025

@Emantor I believe there was one remaining comment thread, I provided an explanation for why I did things that way, awaiting your feedback. I have update the PR to resolve merge conflicts with the latest master branch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants