Differences

This shows you the differences between two versions of the page.

--- manual:demos:usb_driver_install [2016/04/08 12:21]
voorburg [OpenBLT USB Driver Installation Instructions]
+++ manual:demos:usb_driver_install [2023/06/27 10:02] (current)
voorburg
@@ Line 1: / Line 1: @@
 ====== OpenBLT USB Driver Installation Instructions ======
+This page contains step-by-step instructions for the USB driver installation and additional background information regarding the USB driver.
-This page contains step-by-step instructions for the USB driver installation and additional background information regarding the USB driver
+===== USB Driver Installation on Windows =====
-.
+----
+**New**: Starting with OpenBLT version 1.16, you no longer need to install the USB driver. This applies to all demo programs that are configured to support firmware updates via USB. Therefore, you can skip the information in this section.
-===== Step-by-step Installation =====
+Here's how it works: During USB enumeration, a Microsoft 2.0 descriptor set is now sent to the PC, which automatically enters the WinUSB Device Interface GUID into the registry and links it to OpenBLT's VID/PID.
+----
+Before installing the USB driver, make sure the USB device that runs the OpenBLT USB bootloader is not connected to your PC. If a prior version of the USB driver was installed, it is recommended to first uninstall this driver.
+The installation of the USB driver is performed using the Zadig tool. You can download the necessary files here: {{:manual:openblt_usb_driver.zip?linkonly|OpenBLT USB Driver Package}}. After downloading the OpenBLT USB Driver Package, unzip the archive to **c:\openblt_usb_driver\** and start the program **zadig_2.2.exe**. Note that users reported issues with the USB driver, if they used a different directory to unzip to, so make sure to use the c:\openblt_usb_driver\ directory.
-The following illustrates the driver installation in Windows XP. The procedure on Windows Vista and 7 is quite similar.
+From the program menu, select **Device -> Load Preset Device** and select the file **openblt.cfg**, which is found in the same directory as where **zadig_2.2.exe** is located. Next, click the **Install Driver** button to install the USB driver for the OpenBLT bootloader:
+{{:manual:openblt_usb_driver_install.png?|}}
+After successfully completion of the USB driver installation, you can plug in the USB device that runs the OpenBLT USB bootloader. Windows will automatically detect the USB device and map it to the newly installed USB driver. You can verify the correct USB driver installation and USB device detection using the Device Manager in Windows. You should see an entry for **WinUSB Bulk Device**, without a yellow exclamation mark in the icon:
-When prompted by Windows to install the driver, hit cancel and go to the Device Manager instead. Right-click the entry "**WinUSB Bulk Device**" and select "**Update Driver...**" from the popup menu:
+{{:manual:openblt_usb_device_manager.png?|}}
+==== Troubleshooting ====
+If for some reason, the USB driver installation fails and the **WinUSB Bulk Device** still shows up with a yellow exclamation mark in the Device Manager, try the following:
+  - Right-click the **WinUSB Bulk Device** entry in the Windows Device Manager and select "Uninstall Device" from the pop-up menu. If the confirmation dialog offers a checkbox to also uninstall the driver, go ahead and check that one as well.
+  - Unplug the USB device and then plug it back into your PC. Attempt the USB driver installation again, if it does not yet support the automatic WinUSB driver install (OpenBLT >= 1.16).
-{{:manual:demos:dev_mngr_update_driver.gif?|}}
+If it still doesn't work, repeat steps one and two, but before moving on to step two, do this:
+  * Using the Window Registry Editor, locate the key: ''HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\'' and remove all entries that start with OpenBLT's VID/PID: ''1D5060AC''.
+  * Using the Window Registry Editor, locate the key: ''HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\'' and remove the OpenBLT VID/PID entry: ''VID_1D50&PID_60AC''.
-By default, Windows want to search for the driver online, which can be a length process and it won't find it anyways. Instead, select "**No, not this time**" and click "**Next >**":
+==== Windows Compatibility ====
+The USB driver makes use of the WinUSB user mode driver. Support for WinUSB is available in versions starting with Windows XP. The USB driver for OpenBLT is configured to run on Windows Vista, 7, 8 and 10. Both 32- and 64-bit operating system versions are supported.
+===== USB Driver Installation on Linux =====
-{{:manual:demos:update_driver_not_online.gif?|}}
+On Linux, all that has to be done is install the libusb-1.0 package. Example for Ubuntu based distributions:
+<code>sudo apt-get install libusb-1.0-0</code>
+To verify that the OpenBLT USB device is recognized by the system, run the following command:
+<code>lsusb</code>
+{{:manual:demos:openblt_usb_device_linux.png?nolink&|}}
-On the next screen, select "**Install from a list or specific location (Advanced)**" and click "**Next >**":
+Typically only the super user has access to the OpenBLT USB device. To give all users access, create the following UDEV rules file and store it in **/etc/udev/rules.d/60-openblt.rules**. After a re-boot all users will have access:
+<code>ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="1d50", ATTR{idProduct}=="60ac", MODE="0666"</code>
-{{:manual:demos:update_driver_specific_location.gif?|}}
-Select "**Include this location in the search:**", browse and select the folder "**<OpenBLT path>\Host\Drivers\USB**" and click "**Next >**":
-{{:manual:demos:update_driver_select_folder.gif?|}}
-Windows now installs the driver. When ready, the following screen is presented. Click "**Finish**" to conclude the driver installation.
-{{:manual:demos:update_driver_finish.gif?|}}
-===== Windows Compatibility =====
-The USB driver makes use of the WinUSB user mode driver. Support for WinUSB is available in versions starting with Windows XP. The USB driver for OpenBLT is configured to run on Windows Vista, 7 and 8. Both 32- and 64-bit operating system versions are supported.

OpenBLT Bootloader

User Tools

Site Tools

Differences

Page Tools