User Tools

Site Tools


Installing USB Drivers

  1. A Quick Start for installing a USB drive is available. This solves the very common case of installing a single USB drive onto your LEDE device.
  2. If the Quick Start doesn't address your question, you can install USB drivers manually. Background information about the different USB host controller interfaces (OHCI, UHCO, EHCI) is given in a Wikipedia article. Please refer to you device documentation to find out which USB driver version your device needs.
  3. There is a more complete USB Drives page
  4. There is also a USB Troubleshooting page

To install USB Drivers Manually

  1. Start with refreshing the list of available packages
    opkg update
  2. Obtain a list of already installed USB packages:
    opkg list-installed | grep usb


    kmod-usb-core - 4.9.58-1
    kmod-usb-storage - 4.9.58-1
    kmod-usb3 - 4.9.58-1
  3. Install the USB core package (all USB versions), if the previous list-output does not list it:
    opkg install kmod-usb-core
    insmod usbcore
  4. Install the USB storage package (all USB versions), if the previous list-output does not list it:
    opkg install kmod-usb-storage
  5. To install USB 1.1 drivers, first try the UHCI driver:
    opkg install kmod-usb-uhci
    insmod usb-ohci

    If this fails with an error “No such device”, try installing the alternative OHCI driver for USB 1.1:

    opkg install kmod-usb-ohci
    insmod uhci

    (to remove non-working drivers, use opkg remove. Note: If both OHCI And UHCI drivers fail, then you do not have USB 1.1)

  6. To install USB 2.0 drivers:
    opkg install kmod-usb2
    insmod ehci-hcd
  7. to install USB 3.0 drivers:
    opkg install kmod-usb3
    insmod xhci-hcd


  • Some devices (e.g. Asus WL-500g router, brcm47xx) additionally need the kmod-usb2 module (even though they only have an USB 1.1 controller)
  • Some devices (e.g. NLSU2) additionally need the following packages:
    opkg install kmod-usb-ohci-pci
    opkg install kmod-usb2-pci
docs/guide-user/storage/usb-installing.txt · Last modified: 2018/03/03 20:56 by bobafetthotmail