Raspberry Pi 4 USB Gadget

rpi4-usb.sh

#!/bin/bash
# Set up a Raspberry Pi 4 as a USB-C Ethernet Gadget
# Based on:
#     - https://www.hardill.me.uk/wordpress/2019/11/02/pi4-usb-c-gadget/
#     - https://pastebin.com/VtAusEmf

if ! $(grep -q dtoverlay=dwc2 /boot/config.txt) ; then
    echo "Add the line dtoverlay=dwc2 to /boot/config.txt"
    exit
fi

if ! $(grep -q modules-load=dwc2 /boot/cmdline.txt) ; then
    echo "Add the line modules-load=dwc2 to /boot/cmdline.txt"
    exit
fi

if ! $(grep -q libcomposite /etc/modules) ; then
    echo "Add the line libcomposite to /etc/modules"
    exit
fi

if ! $(grep -q "denyinterfaces usb0" /etc/dhcpcd.conf) ; then
    echo "Add the line denyinterfaces usb0 to /etc/dhcpcd.conf"
    exit
fi

if [[ ! -e /usr/sbin/dnsmasq ]] ; then
    echo "Install dnsmasq"
    exit
fi

if [[ ! -e /etc/dnsmasq.d/usb ]] ; then
    echo "interface=usb0" > /etc/dnsmasq.d/usb
    echo "dhcp-range=10.55.0.2,10.55.0.6,255.255.255.248,1h" >> /etc/dnsmasq.d/usb
    echo "dhcp-option=3" >> /etc/dnsmasq.d/usb
    echo "leasefile-ro" >> /etc/dnsmasq.d/usb
    echo "Created /dnsmasq.d/usb"
fi

if [[ ! -e /etc/network/interfaces.d/usb0 ]] ; then
    echo "auto usb0" > /etc/network/interfaces.d/usb0
    echo "allow-hotplug usb0" >> /etc/network/interfaces.d/usb0
    echo "iface usb0 inet static" >> /etc/network/interfaces.d/usb0
    echo "  address 10.55.0.1" >> /etc/network/interfaces.d/usb0
    echo "  netmask 255.255.255.248" >> /etc/network/interfaces.d/usb0
    echo "Created /etc/network/interfaces.d/usb0"
fi

if [[ ! -e /root/usb.sh ]] ; then
    cat << 'USBSETUP' > /root/usb.sh
#!/bin/bash

gadget=/sys/kernel/config/usb_gadget/pi4

usb_version="0x0200" # USB 2.0
device_class="0xEF"
device_subclass="0x02"
bcd_device="0x0100" # v1.0.0
device_protocol="0x01"
vendor_id="0x1d50"
product_id="0x60c7"
#vendor_id="0x1d6b" # Linux Foundation
#product_id="0x0104" # Multifunction composite gadget
manufacturer="Ian"
product="RPi4 USB Gadget"
serial="fedcba9876543211"
attr="0x80" # Bus powered
power="250"
config1="RNDIS"
config2="CDC"
ms_vendor_code="0xcd" # Microsoft
ms_qw_sign="MSFT100" # also Microsoft (if you couldn't tell)
ms_compat_id="RNDIS" # matches Windows RNDIS Drivers
ms_subcompat_id="5162001" # matches Windows RNDIS 6.0 Driver
mac="01:23:45:67:89:ab"
dev_mac="02$(echo ${mac} | cut -b 3-)"
host_mac="12$(echo ${mac} | cut -b 3-)"

mkdir -p ${gadget}
echo "${usb_version}" > ${gadget}/bcdUSB
echo "${device_class}" > ${gadget}/bDeviceClass
echo "${device_subclass}" > ${gadget}/bDeviceSubClass
echo "${vendor_id}" > ${gadget}/idVendor
echo "${product_id}" > ${gadget}/idProduct
echo "${bcd_device}" > ${gadget}/bcdDevice
echo "${device_protocol}" > ${gadget}/bDeviceProtocol

mkdir -p ${gadget}/strings/0x409
echo "${manufacturer}" > ${gadget}/strings/0x409/manufacturer
echo "${product}" > ${gadget}/strings/0x409/product
echo "${serial}" > ${gadget}/strings/0x409/serialnumber

mkdir ${gadget}/configs/c.1
echo "${attr}" > ${gadget}/configs/c.1/bmAttributes
echo "${power}" > ${gadget}/configs/c.1/MaxPower
mkdir -p ${gadget}/configs/c.1/strings/0x409
echo "${config1}" > ${gadget}/configs/c.1/strings/0x409/configuration

mkdir -p ${gadget}/os_desc
echo "1" > ${gadget}/os_desc/use
echo "${ms_vendor_code}" > ${gadget}/os_desc/b_vendor_code
echo "${ms_qw_sign}" > ${gadget}/os_desc/qw_sign

mkdir -p ${gadget}/functions/rndis.usb0
echo "${dev_mac}" > ${gadget}/functions/rndis.usb0/dev_addr
echo "${host_mac}" > ${gadget}/functions/rndis.usb0/host_addr
echo "${ms_compat_id}" > ${gadget}/functions/rndis.usb0/os_desc/interface.rndis/compatible_id
echo "${ms_subcompat_id}" > ${gadget}/functions/rndis.usb0/os_desc/interface.rndis/sub_compatible_id

#mkdir ${gadget}/configs/c.2
#echo "${attr}" > ${gadget}/configs/c.2/bmAttributes
#echo "${power}" > ${gadget}/configs/c.2/MaxPower
#mkdir -p ${gadget}/configs/c.2/strings/0x409
#echo "${config2}" > ${gadget}/configs/c.2/strings/0x409/configuration

#mkdir -p ${gadget}/functions/ecm.usb0
#echo "${dev_mac}" > ${gadget}/functions/ecm.usb0/dev_addr
#echo "${host_mac}" > ${gadget}/functions/ecm.usb0/host_addr

ln -s ${gadget}/configs/c.1 ${gadget}/os_desc
ln -s ${gadget}/functions/rndis.usb0 ${gadget}/configs/c.1
#ln -s ${gadget}/functions/ecm.usb0 ${gadget}/configs/c.2

ls /sys/class/udc > ${gadget}/UDC

udevadm settle -t 5 || :
ifup usb0
service dnsmasq restart
USBSETUP
    chmod 750 /root/usb.sh
    echo "Created /root/usb.sh"
fi

if ! $(grep -q /root/usb.sh /etc/rc.local) ; then
    echo "Add the command /root/usb.sh to /etc/rc.local"
fi

Thanks for your script because everyone is doing pizero and it wasn't working for my raspberry pi4.

strangely with your script, there are 2 network range given to my usb0. Maybe it's not your script at all which cause this, maybe it's the classic behavior of the RNDIS but 169.254 range and 10.55 was attributed to usb0. I've only applied 10.55 range like in his tutorial: https://www.hardill.me.uk/wordpress/2019/11/02/pi4-usb-c-gadget/

So the logical consequences is that the dhcp leases aren't appointed since 169.254 is taking over. Did you see this behavior too?

No it's okey I found my problem it was with my dnsmasq configuration.
sorry for the disturbance.
Did you try to add other function than the ethernet link?

Thanks.....
But I made some changes that you can add if you want to. Have a look at https://github.com/kmpm/rpi-usb-gadget

Works with latest Windows 10 and Raspberry Pi OS on a pi0. Tested many scripts but this works out of the box. Thank you. Also @kmpm changes are quite nice!

Hi, it's great .sh file for RaspiOS to Raspberry Pi, and did you have any idea for Ubuntu to Raspberry Pi?