RockpiS/dev/usbnet - Revision history

Stephen at 12:49, 23 July 2020

2020-07-23T12:49:24Z

Stephen: /* Setup USB Network */

2020-04-14T10:14:30Z

‎Setup USB Network

Stephen: /* Load kernel module */

2020-04-14T10:11:29Z

‎Load kernel module

Stephen at 08:16, 13 April 2020

2020-04-13T08:16:58Z

Stephen at 08:16, 13 April 2020

2020-04-13T08:16:43Z

Stephen: /* Setup USB Network */

2020-04-13T08:16:23Z

‎Setup USB Network

Stephen: /* Load kernel module */

2020-04-13T08:15:05Z

‎Load kernel module

Stephen: Created page with "{{rockpiS_header}} {{Languages|rockpiS/dev/usbnet}} ROCK Pi S > Development > USB Device Network ROCK Pi S has..."

2020-04-13T08:13:57Z

Created page with "{{rockpiS_header}} {{Languages|rockpiS/dev/usbnet}} ROCK Pi S > Development > USB Device Network ROCK Pi S has..."

New page

{{rockpiS_header}}

{{Languages|rockpiS/dev/usbnet}}

[[rockpiS | ROCK Pi S]] > [[rockpiS/dev | Development]] > [[rockpiS/dev/usbnet | USB Device Network]]

ROCK Pi S has one USB OTG port, which can be configured as USB devices with the Linux USB gadget driver, supporting multiple functions as a USB device such as Massive Storage Device and USB networking. We describe how to configure USBNET with a HOST PC.

=== Requirements ===

* ROCK Pi S
* USB 3.0 or 2.0 male type A to type C cable
* Host PC running Linux OS

=== Kernel version ===

USB gadget driver must be enabled to configure usb net. You need to update the kernel to at least version 4.4.143-46-rockchip.

=== Load kernel module===

* Connect the ROCK Pi S to PC with a USB C to USB A cable.

* Install kernel module on ROCK Pi S

<pre>
root@rockpis:~# modprobe g_ether
</pre>

dmesg shoule output the folowing:
<pre>
root@rockpis:~# dmesg -c
[ 25.792177] using random self ethernet address
[ 25.792239] using random host ethernet address
[ 25.794179] usb0: HOST MAC fe:fc:51:10:b2:fa
[ 25.794444] usb0: MAC 82:21:a8:1b:f3:4a
[ 25.794539] using random self ethernet address
[ 25.794589] using random host ethernet address
[ 25.794787] g_ether gadget: Ethernet Gadget, version: Memorial Day 2008
[ 25.794819] g_ether gadget: g_ether ready
[ 25.797133] dwc2 ff400000.usb: bound driver g_ether
[ 25.988410] dwc2 ff400000.usb: new device is high-speed
[ 26.068210] dwc2 ff400000.usb: new device is high-speed
[ 26.132742] dwc2 ff400000.usb: new address 39
[ 26.154634] g_ether gadget: high-speed config #1: CDC Ethernet (ECM)
</pre>

Bring up the usb0 device

<pre>
root@rockpis:~# ifconfig usb0 up
</pre>

Now you should have usb0 on ROCK Pi S enabled.

On the host PC Ubuntu 16.04, the '''dmesg''' gives something like below:

<pre>
jenkins@x86_64_pc:~$ sudo dmesg -c
[974637.533636] usb 1-4.1: new high-speed USB device number 121 using xhci_hcd
[974637.635515] usb 1-4.1: New USB device found, idVendor=0525, idProduct=a4a2
[974637.635520] usb 1-4.1: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[974637.635523] usb 1-4.1: Product: RNDIS/Ethernet Gadget
[974637.635525] usb 1-4.1: Manufacturer: Linux 4.4.143-46-rockchip-gef70dd2c725e with ff400000.usb
[974637.636655] cdc_subset: probe of 1-4.1:1.0 failed with error -22
[974637.637971] cdc_ether 1-4.1:1.0 usb0: register 'cdc_ether' at usb-0000:00:14.0-4.1, CDC Ethernet Device, 8a:11:bc:e7:60:26
[974637.650141] cdc_ether 1-4.1:1.0 enp0s20f0u4u1: renamed from usb0
[974637.678705] IPv6: ADDRCONF(NETDEV_UP): enp0s20f0u4u1: link is not ready
[974637.694633] IPv6: ADDRCONF(NETDEV_UP): enp0s20f0u4u1: link is not ready
</pre>

'''enp0s20f0u4u1''' is the "USB network card" for ROCK Pi S. '''Ifconfig enp0s20f0u4u1''' gives us the info about it.

=== Setup USB Network ===

On ROCK Pi S.

<pre>
root@rockpis:~# IP=10.0.1.1
root@rockpis:~# HOST_IP=10.0.1.2
root@rockpis:~# ifconfig usb0 $IP netmask 255.255.255.0
root@rockpis:~# route
</pre>

On host PC

<pre>
jenkins@x86_64_pc:~$ HOST_IP=10.0.1.2
jenkins@x86_64_pc:~$ sudo ifconfig enp0s20f0u4u1 $HOST_IP netmask 255.255.255.0
</pre>

Test the network, on ROCK Pi S

<pre>
root@rockpis:~# ping $HOST_IP
</pre>

Test network traffic, on host PC

<pre>
jenkins@x86_64_pc:~$ iperf -s
------------------------------------------------------------
Server listening on TCP port 5001
TCP window size: 128 KByte (default)
------------------------------------------------------------
[ 4] local 10.0.1.2 port 5001 connected with 10.0.1.1 port 48264
[ ID] Interval Transfer Bandwidth
[ 4] 0.0-10.0 sec 113 MBytes 94.6 Mbits/sec
</pre>

Test network traffic, on ROCK Pi S:

<pre>
root@rockpis:~# iperf -c $HOST_IP
------------------------------------------------------------
Client connecting to 10.0.1.2, TCP port 5001
TCP window size: 85.0 KByte (default)
------------------------------------------------------------
[ 3] local 10.0.1.1 port 48264 connected with 10.0.1.2 port 5001
[ ID] Interval Transfer Bandwidth
[ 3] 0.0-10.0 sec 113 MBytes 94.8 Mbits/sec
</pre>

@@ Line 84: / Line 84: @@
 <pre>
-jenkins@x86_64_pc:~$ HOST_IP=10.0.1.2
+radxa@x86_64_pc:~$ HOST_IP=10.0.1.2
-jenkins@x86_64_pc:~$ sudo ifconfig enp0s20f0u4u1 $HOST_IP netmask 255.255.255.0
+radxa@x86_64_pc:~$ sudo ifconfig enp0s20f0u4u1 $HOST_IP netmask 255.255.255.0
 </pre>
@@ Line 97: / Line 97: @@
 <pre>
-jenkins@x86_64_pc:~$ iperf -s
+radxa@x86_64_pc:~$ iperf -s
 ------------------------------------------------------------
 Server listening on TCP port 5001

← Older revision		Revision as of 08:16, 13 April 2020
Line 120:		Line 120:
	[ 3] 0.0-10.0 sec 113 MBytes 94.8 Mbits/sec		[ 3] 0.0-10.0 sec 113 MBytes 94.8 Mbits/sec
	</pre>		</pre>
		+
		+	=== Troubleshooting ===
		+	* Refer [[RockpiS/getting_started/troubleshooting \| Troubleshooting page]]
		+	* Post your issue on the forum: https://forum.radxa.com/c/rockpiS

@@ Line 7: / Line 7: @@
 ROCK Pi S has one USB OTG port, which can be configured as USB devices with the Linux USB gadget driver, supporting multiple functions as a USB device such as Massive Storage Device and USB networking. We describe how to configure USBNET with a HOST PC.
-=== Requirements ===
+=== Hardware required ===
 * ROCK Pi S
@@ Line 13: / Line 13: @@
 * Host PC running Linux OS
-=== Kernel version ===
+=== Software preparation ===
 USB gadget driver must be enabled to configure usb net. You need to update the kernel to at least version 4.4.143-46-rockchip.
 === Load kernel module===

@@ Line 55: / Line 55: @@
 <pre>
-jenkins@x86_64_pc:~$ sudo dmesg -c
+radxa@x86_64_pc:~$ sudo dmesg -c
 [974637.533636] usb 1-4.1: new high-speed USB device number 121 using xhci_hcd
 [974637.635515] usb 1-4.1: New USB device found, idVendor=0525, idProduct=a4a2

@@ Line 8: / Line 8: @@
 === Requirements ===
 * ROCK Pi S
 * USB 3.0 or 2.0 male type A to type C cable
@@ Line 13: / Line 14: @@
 === Kernel version ===
 USB gadget driver must be enabled to configure usb net. You need to update the kernel to at least version 4.4.143-46-rockchip.
 === Load kernel module===
 * Connect the ROCK Pi S to PC with a USB C to USB A cable.
 * Install kernel module on ROCK Pi S
@@ Line 68: / Line 71: @@
 === Setup USB Network ===
 On ROCK Pi S.
@@ Line 117: / Line 121: @@
 === Troubleshooting ===
 * Refer [[RockpiS/getting_started/troubleshooting | Troubleshooting page]]
 * Post your issue on the forum: https://forum.radxa.com/c/rockpiS

@@ Line 69: / Line 69: @@
 </pre>
-'''enp0s20f0u4u1''' is the "USB network card" for ROCK Pi S. '''Ifconfig enp0s20f0u4u1''' gives us the info about it.
+'''enp0s20f0u4u1''' is the "USB network card" for ROCK Pi S. '''ifconfig enp0s20f0u4u1''' gives us the info about it.
 === Setup USB Network ===