{"repo":"raspberrypi/rpi-usb-gadget","free":true,"listed":false,"github":"https://github.com/raspberrypi/rpi-usb-gadget","clone":"git clone https://github.com/raspberrypi/rpi-usb-gadget.git","description":"Turn your Raspberry Pi into a USB Ethernet gadget (CDC-ECM/RNDIS) for headless networking, Internet sharing, and remote development over a single USB cable.","language":"C","stars":277,"topics":["cdc-ecm","raspberrypi","rndis","usb-gadget","raspberry-pi","raspberry-pi-zero","raspberry-pi-zero-2","raspberry-pi-zero-2-w","raspberry-pi-zero-w","usb-ethernet"],"license":"Apache-2.0","category":"self-hosted-apps","readme_excerpt":"Raspberry Pi USB Gadget This package turns your Raspberry Pi into a USB Ethernet gadget using the kernel’s g ether driver. On the host it appears as: CDC-ECM on Linux and macOS RNDIS on Windows (use the included Raspberry Pi USB RNDIS driver for fastest onboarding) It’s designed for headless setups and for places where Wi-Fi isn’t available or communication between network devices is restricted. With a single Micro USB or USB-C cable you get a network link that’s ideal for SSH, file copy, and remote dev (e.g. VS Code), with very low latency . What’s new / how it behaves Auto client/shared switching (NetworkManager): We install two NM profiles on the gadget interface (default usb0 ) and run a small watcher service: USB Gadget (client): Pi is a DHCP client of the host (used when host Internet Connection Sharing is detected; typical host gateways: 192.168.137.1 , 192.168.2.1 , 10.42.0.1 ). USB Gadget (shared): Pi provides DHCP + NAT to the host at 10.12.194.1/28 . The watcher automatically flips between these modes based on whether an ICS gateway is reachable. USB Ethernet only by default: We do not enable a serial gadget ( /dev/ttyGS0 ) by default. Host support: Windows (with RNDIS driver), macOS, and Linux hosts. Make sure to have any VPNs disabled on the host, as they can interfere with the local networking! Features Plug-and-play : Just connect a Micro USB or USB-C cable; NM profiles and the watcher handle networking. Headless operation : No Wi-Fi, monitor, or keyboard requi","default_branch":null,"files":null,"tree":[],"storefront":"/r/raspberrypi","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/raspberrypi/rpi-usb-gadget/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}