faq.html

<!DOCTYPE html>
<!--
 | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/apt/faq.apt.vm at 2018-10-21
 | Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="Date-Revision-yyyymmdd" content="20181021" />
    <meta http-equiv="Content-Language" content="en" />
    <title>usb4java &#x2013; FAQ</title>
    <link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
    <link rel="stylesheet" href="./css/site.css" />
    <link rel="stylesheet" href="./css/print.css" media="print" />
    <script type="text/javascript" src="./js/apache-maven-fluido-1.7.min.js"></script>
<link href="favicon.ico" rel="SHORTCUT ICON" />
  </head>
  <body class="topBarDisabled">
    <a href="https://github.com/usb4java">
      <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
        src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"
        alt="Fork me on GitHub">
    </a>
    <div class="container-fluid">
      <div id="banner">
        <div class="pull-left"><a href="./" id="bannerLeft"><img src="images/logo.png"  alt="usb4java"/></a></div>
        <div class="pull-right"></div>
        <div class="clear"><hr/></div>
      </div>

      <div id="breadcrumbs">
        <ul class="breadcrumb">
        <li id="publishDate">Last Published: 2018-10-21<span class="divider">|</span>
</li>
          <li id="projectVersion">Version: 1.3.0<span class="divider">|</span></li>
      <li class=""><a href="./" title="usb4java">usb4java</a><span class="divider">/</span></li>
    <li class="active ">FAQ</li>
      <li class="pull-right"><span class="divider">|</span>
<a href="http://libusb.info/" class="externalLink" title="libusb">libusb</a></li>
      <li class="pull-right"><a href="http://javax-usb.sourceforge.net/" class="externalLink" title="javax-usb">javax-usb</a></li>
        </ul>
      </div>
      <div class="row-fluid">
        <div id="leftColumn" class="span2">
          <div class="well sidebar-nav">
    <ul class="nav nav-list">
      <li class="nav-header">usb4java</li>
    <li><a href="index.html" title="About"><span class="none"></span>About</a></li>
    <li><a href="quickstart/index.html" title="Quick start"><span class="icon-chevron-right"></span>Quick start</a></li>
    <li class="active"><a href="#"><span class="none"></span>FAQ</a></li>
    <li><a href="configuration.html" title="Configuration"><span class="none"></span>Configuration</a></li>
    <li><a href="nativelibs.html" title="Native libs"><span class="none"></span>Native libs</a></li>
      <li class="nav-header">Project Documentation</li>
    <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
    <li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
</ul>
          <hr />
          <div id="poweredBy">
            <div class="clear"></div>
            <div class="clear"></div>
            <div class="clear"></div>
            <div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
            </div>
          </div>
        </div>
        <div id="bodyColumn"  class="span10" >
<div class="section">
<h2><a name="Frequently_asked_questions"></a>Frequently asked questions</h2>
<p>If you have a question which is not answered here please ask the <a class="externalLink" href="mailto:usb4java@googlegroups.com">usb4java mailing list</a> (<a class="externalLink" href="http://groups.google.com/group/usb4java">Google group</a>). You can subscribe to it via email by sending a mail to <a class="externalLink" href="mailto:usb4java+subscribe@googlegroups.com">usb4java+subscribe@googlegroups.com</a>.</p>
<div class="section">
<h3><a name="I_can.27t_open_my_USB_device_on_Linux._Why.3F"></a>I can't open my USB device on Linux. Why?</h3>
<p>On Linux you need write permissions on the device file of the USB device you want to communicate with. Check if the devices are accessible when running your program as root. If this works then it is recommended to configure <i>udev</i> to give your user write permissions when the device is attached. You can do this by creating a file like <i>/etc/udev/rules.d/99-userusbdevices.rules</i> with content like this:</p>
<div>
<pre>  SUBSYSTEM==&quot;usb&quot;,ATTR{idVendor}==&quot;89ab&quot;,ATTR{idProduct}==&quot;4567&quot;,MODE=&quot;0660&quot;,GROUP=&quot;plugdev&quot;</pre></div>
<p>This means that whenever a USB device with vendor id <i>0x89ab</i> and product id <i>0x4567</i> is attached then the group <i>plugdev</i> is permitted to write to the device. So make sure your user is in that group (or use a different group).</p>
<p>If your device uses a shared vendor/product id then you might want to filter for the manufacturer and product name. This can be done by checking the ATTR properties <i>manufacturer</i> and <i>product</i>.</p>
<p>To activate this new configuration you may need to re-attach the USB device or run the command <tt>udevadm trigger</tt>.</p></div>
<div class="section">
<h3><a name="I_can.27t_open_my_USB_device_on_Windows._Why.3F"></a>I can't open my USB device on Windows. Why?</h3>
<p>On Windows you need to create a driver for your USB device. Read the <a class="externalLink" href="https://github.com/libusb/libusb/wiki/Windows#wiki-How_to_use_libusb_on_Windows">How to use libusb on Windows</a> article from the <a class="externalLink" href="http://libusb.info">libusb project</a> for more information.</p></div>
<div class="section">
<h3><a name="My_program_crashes._What_can_I_do.3F"></a>My program crashes. What can I do?</h3>
<p>If the program crashes with a Java stack trace then it is most likely a problem in your own program. If you can't find it you may find some help on the <a href="./mail-lists.html">mailinglist</a>.</p>
<p>If the JVM crashes the hard way because of a segfault in the native code then it is more likely a problem of usb4java or libusb and you should file a <a href="./issue-tracking.html">bugreport</a> with as much information as possible (Full stack trace, full crash log, example code how to reproduce the crash).</p>
<p>If usb4java crashes on Windows then please first of all make sure you have created a proper device driver as explained in the previous FAQ entry. Also consider creating a new up-to-date device driver with the latest Zadig tool.</p>
<p>If you have experience in C programming then it would be very helpful when you could try to reproduce the problem in C by directly using libusb. If this works but the same USB communication doesn't work with usb4java then it would be nice if you could give us your C source and Java source so we can track down the difference which causes the crash. If the C program also crashes then your problem is located in libusb and not in usb4java and you should consult the libusb mailinglist or bug tracker instead. Never report a problem in the libusb bug tracker or the libusb mailing list if you can't reproduce the problem with a native C program!</p></div></div>
        </div>
      </div>
    </div>
    <hr/>
    <footer>
      <div class="container-fluid">
        <div class="row-fluid">
            <p>Copyright &copy;2011&#x2013;2018
<a href="http://usb4java.org/">usb4java Team</a>.
All rights reserved.</p>
        </div>
      </div>
    </footer>
  </body>
</html>