Set up the working environment

USB NET setup

To use USB networking, we enabled CDC-NCM and DHCP by default on the system.

tip

The USB network used by firmware before V1.1.2 is RNDIS. If you are using an older version, please update to V1.1.2 or a newer system image.

CDC-NCM is driver-free on Linux, macOS, and the latest Windows systems. You can log in to Duo's terminal directly using ssh [email protected].

Windows

If your Windows system is older, you need to manually install the CDC-NCM driver as follows:

1. Connect Duo, Duo256M or DuoS to your computer via a Type-C cable.

2. The CDC NCM device appears in the Device Manager with a yellow exclamation mark indicating that the driver is not installed.

   

3. Select CDC NCM and right-click to select Update Driver.

   

4. Select Browse my computer for drivers.

   

5. Select Let me pick from a list of available drivers on my computer.

   

6. Select Network Adapters.

   

7. Select Microsoft in Manufacturer and UsbNcm Host Device in Model.

   

8. Ignore the warning message.

   

9. The driver was installed successfully.

   

10. Check Network Adapter, UsbNcm Host Device is displayed normally.

    

11. Use the ping command to test.

    

Linux & macOS

Open the terminal and use the ping command to test:

ubuntu@linux:~$ ping 192.168.42.1 -c 5
PING 192.168.42.1 (192.168.42.1) 56(84) bytes of data.
64 bytes from 192.168.42.1: icmp_seq=1 ttl=64 time=2.00 ms
64 bytes from 192.168.42.1: icmp_seq=2 ttl=64 time=2.13 ms
64 bytes from 192.168.42.1: icmp_seq=3 ttl=64 time=2.13 ms
64 bytes from 192.168.42.1: icmp_seq=4 ttl=64 time=2.01 ms
64 bytes from 192.168.42.1: icmp_seq=5 ttl=64 time=2.13 ms

--- 192.168.42.1 ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 4006ms
rtt min/avg/max/mdev = 2.003/2.081/2.132/0.059 ms

SSH

Windows

1. Open the terminal and enter ssh [email protected]. The following prompt will appear for the first connection. Just enter yes.

   

2. Enter the password milkv (the password will not be displayed) and log in successfully.

   

Others

Modify the IP address of the USB network

The default IP address of USB network is 192.168.42.1. If you need to modify this address, for example, when the same computer is connected to multiple Duo devices, the IP of each Duo needs to be set to a different one. This can be achieved by modifying the following two files in the Duo device:

/mnt/system/usb-ncm.sh

#!/bin/sh

/etc/uhubon.sh device >> /tmp/ncm.log 2>&1
/etc/run_usb.sh probe ncm >> /tmp/ncm.log 2>&1
if test -e /usr/bin/burnd; then
  /etc/run_usb.sh probe acm >> /tmp/ncm.log 2>&1
fi
/etc/run_usb.sh start ncm >> /tmp/ncm.log 2>&1

sleep 0.5
ifconfig usb0 192.168.42.1

count=`ps | grep dnsmasq | grep -v grep | wc -l`
if [ ${count} -lt 1 ] ;then
  echo "/etc/init.d/S80dnsmasq start" >> /tmp/ncm.log 2>&1
  /etc/init.d/S80dnsmasq start >> /tmp/ncm.log 2>&1
fi

/etc/dnsmasq.conf

interface=usb0
dhcp-range=192.168.42.2,192.168.42.242,1h
dhcp-option=3
dhcp-option=6

Enable Swap

What is Swap

Swap, also known as virtual RAM, is used to support storing data in hard disk when physical memory (RAM) is full. Sometimes Swap is also used in parallel to increase cache capacity even if the physical memory is not used up yet.

caution

This may cause wear and tear on your microSD card leading to a shorter drive lifespan! It is strongly recommended to enable swap functionality only when there is insufficient memory available!

How to enable Swap on Duo

tip

There are two ways to enable Swap, one is to use Swap partition, the other is to use Swap file. In versions before v1.1.3, Duo's image reserves a 256M partition as a Swap partition. In v1.1.3 and later versions, the Swap file method is used uniformly.

Use the latest system image:

https://github.com/milkv-duo/duo-buildroot-sdk/releases

Execute the following command in the Duo terminal to create a 256M Swap file (the file size and location can be customized):

fallocate -l 256M /mnt/swapfile
chmod 600 /mnt/swapfile
mkswap /mnt/swapfile
swapon /mnt/swapfile

Then run the swapon --show or free -h command to check if swap is enabled (256M):

swapon --show

[root@milkv-duo]~# swapon --show
NAME          TYPE   SIZE USED PRIO
/mnt/swapfile file 255.8M   0B   -2

free -h

[root@milkv-duo]~# free -h
              total        used        free      shared  buff/cache   available
Mem:          28.3M       14.3M        3.7M       76.0K       10.3M       11.2M
Swap:        255.8M           0      255.8M

If you need to automatically load Swap at startup, you can use this command to configure:

echo "/mnt/swapfile swap swap defaults 0 0" >> /etc/fstab && sync

After restarting, use the swapon --show or free -h command to check that Swap has been automatically loaded.