"""Expose an adbd TCP endpoint through a remote ADB smart socket server.""" import argparse import logging import select import socket import socketserver def read_exact(sock, size): data = bytearray() while len(data) < size: chunk = sock.recv(size - len(data)) if not chunk: raise ConnectionError('ADB server closed the connection') data.extend(chunk) return bytes(data) def request(sock, service): payload = service.encode('utf-8') if len(payload) > 65535: raise ValueError('ADB service name is too long') sock.sendall(f'{len(payload):04x}'.encode('ascii') + payload) status = read_exact(sock, 4) if status == b'FAIL': size = int(read_exact(sock, 4), 16) raise ConnectionError(read_exact(sock, size).decode('utf-8', 'replace')) if status != b'OKAY': raise ConnectionError(f'Invalid ADB response: {status!r}') def open_device(host, port, serial, device_port, timeout=10): sock = socket.create_connection((host, port), timeout=timeout) try: request(sock, f'host:transport:{serial}') # This TCP connection is opened by adbd on the PHONE, not by the PC. request(sock, f'tcp:{device_port}') sock.settimeout(None) sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1) return sock except BaseException: sock.close() raise def relay(left, right): """Preserve TCP half-close so responses can finish after a request EOF.""" peers = {left: right, right: left} while peers: readable, _, _ = select.select(list(peers), [], [], 1) for source in readable: data = source.recv(65536) target = peers[source] if data: target.sendall(data) else: del peers[source] try: target.shutdown(socket.SHUT_WR) except OSError: pass class BridgeHandler(socketserver.BaseRequestHandler): def handle(self): args = self.server.config try: with open_device(args.remote_host, args.remote_port, args.serial, args.device_port) as upstream: logging.info('Connected client %s to %s', self.client_address, args.serial) relay(self.request, upstream) except (OSError, ValueError) as exc: logging.warning('Connection ended: %s', exc) class BridgeServer(socketserver.ThreadingTCPServer): allow_reuse_address = True daemon_threads = True def main(): parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('--remote-host', default='192.168.5.222') parser.add_argument('--remote-port', type=int, default=5037) parser.add_argument('--serial', default='192.168.100.141:5555') parser.add_argument('--device-port', type=int, default=5555, help='adbd TCP listening port on the phone') parser.add_argument('--listen-port', type=int, default=15555) parser.add_argument('--check', action='store_true', help='check upstream only, then exit') args = parser.parse_args() logging.basicConfig(level=logging.INFO, format='%(asctime)s %(levelname)s %(message)s') try: with open_device(args.remote_host, args.remote_port, args.serial, args.device_port): logging.info('Upstream ADB transport and phone TCP port are reachable') if args.check: return 0 with BridgeServer(('127.0.0.1', args.listen_port), BridgeHandler) as server: server.config = args logging.info('Listening on 127.0.0.1:%d; keep this window open', args.listen_port) logging.info('Run locally: adb connect 127.0.0.1:%d', args.listen_port) server.serve_forever() except KeyboardInterrupt: return 0 except (OSError, ValueError) as exc: logging.error('%s', exc) return 1 if __name__ == '__main__': raise SystemExit(main())