USB connectivity is generally one of the first things you want up and running on your phone when porting to a new device. postmarketOS uses USB Networking for every communication between the device and computer.
Power on your device and connect it to your USB port. You should get the IP
172.16.42.2 assigned to your PC, check it with
ip a or
$ ip a 1: enp0s19f2u1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UNKNOWN group default qlen 1000 link/ether aa:bb:cc:dd:ee:ff brd ff:ff:ff:ff:ff:ff inet 172.16.42.2/24 brd 172.16.42.255 scope global dynamic noprefixroute enp0s19f2u1 valid_lft 861920sec preferred_lft 861920sec inet6 fe80::aabb:ccdd:eeff:00aa/64 scope link noprefixroute valid_lft forever preferred_lft forever
When you are past the initramfs, you should be able to connect via
ssh and the username and password you set during the install phase:
$ ssh email@example.com firstname.lastname@example.org's password: Welcome to postmarketOS! This distribution is based on Alpine Linux. Read both our wikis to find a large amount of how-to guides and general information about administrating and development. See <https://wiki.postmarketos.org> and <https://wiki.alpinelinux.org>. You may change this message by editing /etc/motd. localhost:~$
sudo to run commands as
root, it is configured.
Try IPv4 only
Especially while mainlining, getting an IP oftentimes only works with the following command:
$ dhcpcd interface --nohook ipv6
Making sure the USB is detected
In case you don't get an IP address directly, make sure that your PC recognizes the phone after it booted into postmarketOS at all. It should show the following in
[ 6284.442088] usb 1-1: new high-speed USB device number 36 using xhci_hcd [ 6284.627106] usb 1-1: New USB device found, idVendor=18d1, idProduct=d001 [ 6284.627123] usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 [ 6284.627134] usb 1-1: Product: Android [ 6284.627143] usb 1-1: Manufacturer: Android [ 6284.627151] usb 1-1: SerialNumber: 0123456789ABCDEF [ 6284.632322] rndis_host 1-1:1.0 usb0: register 'rndis_host' at usb-0000:00:14.0-1, RNDIS device, b2:c4:1e:03:64:b9 [ 6285.239048] rndis_host 1-1:1.0 enp0s20f0u1: renamed from usb0 [ 6285.287058] IPv6: ADDRCONF(NETDEV_UP): enp0s20f0u1: link is not ready
It should also show up on
lsusb (the name doesn't necessarily match the model):
Bus 001 Device 023: ID 18d1:d001 Google Inc. Nexus 4 (fastboot) Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 005 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
ip link should show an additional entry as well (the last one, in the following list):
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 2: enp3s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP mode DEFAULT group default qlen 1000 link/ether e2:88:85:58:0f:99 brd ff:ff:ff:ff:ff:ff 3: wlp2s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP mode DORMANT group default qlen 1000 link/ether e2:08:85:58:0f:99 brd ff:ff:ff:ff:ff:ff 14: enp0s29f7u3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UNKNOWN mode DEFAULT group default qlen 1000 link/ether 86:11:85:5e:df:fa brd ff:ff:ff:ff:ff:ff
If that's the case and you can't connect, your computer probably just doesn't have an IP address on its side of the link.
If however, nothing shows up (even when Inspecting the initramfs), the most likely reason is a wrong Kernel_configuration. This is highly device-specific, but some hints can be found in #Kernel configuration parameters
Assigning an IP address
If it gets detected, then you probably don't have a network manager installed, that automatically requests IP addresses from new ethernet interfaces. Use the following command to manually start a DHCP client. Replace the interface name with the one on your machine (see
ip a before and after connecting the device via USB). Some Linux distributions have
dhcpcd installed instead of
$ dhclient -v enp0s20f0u1
Some distribution use other tools that might interfere with
dhcpcd. In most cases, you should be able to set an IP address with
# ip address add dev enp0s20f0u1 172.16.42.2/24
If this fails, you may need to first assign an ethernet address to it.
# ip l set enp0s20f0u1 address 12:12:12:12:12:12
Then you can try the above
Kernel configuration parameters
If you think that the kernel configuration may be at fault, first double check with
pmbootstrap kconfig check that the required parameters are all set.
The postmarketOS initramfs is able to configure two different USB systems in the kernel in order to let your PC talk to your phone via networking. One of them has to be enabled (exclusively?):
- This option is usually enabled in Android kernel forks
You can use
grep on your kernel config to check which of these options are enabled or not (
option=y means it is enabled). If you want to change the options, don't modify the file directly, but use
pmbootstrap kconfig edit (usage instructions). Otherwise the dependencies in that configuration file will not get resolved properly and cause other issues.
Related: #1462 linux-postmarketos-qcom: Remove composite usb gadget for networking
Note about HTC devices
- HTC devices seem to be tricky in general, we have a few open issues with HTC devices that seem to be not booting
- The HTC desire does work, and it required this line in the initfs-hook to get USB network
- It was hard to discover: drebrez used the tuning sysfs instructions, but he had to write it as a initfs hook and save it in the
cachepartition of the device, then reboot in TWRP to get that file.
- Without a working display, no USB network and no serial output, you can use the LEDs for debugging and the other partitions to store files.