Home | History | Annotate | only in /external/libusb/android
Up to higher level directory
NameDateSize
config.h05-Oct-20172.5K
jni/05-Oct-2017
README05-Oct-20173.5K

README

      1 libusb for Android
      2 ==================
      3 
      4 Building:
      5 ---------
      6 
      7 To build libusb for Android do the following:
      8 
      9  1. Download the latest NDK from:
     10     http://developer.android.com/tools/sdk/ndk/index.html
     11 
     12  2. Extract the NDK.
     13 
     14  3. Open a shell and make sure there exist an NDK global variable
     15     set to the directory where you extracted the NDK.
     16 
     17  4. Change directory to libusb's "android/jni"
     18 
     19  5. Run "$NDK/ndk-build".
     20 
     21 The libusb library, examples and tests can then be found in:
     22     "android/libs/$ARCH"
     23 
     24 Where $ARCH is one of:
     25     armeabi
     26     armeabi-v7a
     27     mips
     28     mips64
     29     x86
     30     x86_64
     31 
     32 Installing:
     33 -----------
     34 
     35 If you wish to use libusb from native code in own Android application
     36 then you should add the following line to your Android.mk file:
     37 
     38   include $(PATH_TO_LIBUSB_SRC)/android/jni/libusb.mk
     39 
     40 You will then need to add the following lines to the build
     41 configuration for each native binary which uses libusb:
     42 
     43   LOCAL_C_INCLUDES += $(LIBUSB_ROOT_ABS)
     44   LOCAL_SHARED_LIBRARIES += libusb1.0
     45 
     46 The Android build system will then correctly include libusb in the
     47 application package (APK) file, provided ndk-build is invoked before
     48 the package is built.
     49 
     50 
     51 For a rooted device it is possible to install libusb into the system
     52 image of a running device:
     53 
     54  1. Enable ADB on the device.
     55 
     56  2. Connect the device to a machine running ADB.
     57 
     58  3. Execute the following commands on the machine
     59     running ADB:
     60 
     61     # Make the system partition writable
     62     adb shell su -c "mount -o remount,rw /system"
     63 
     64     # Install libusb
     65     adb push obj/local/armeabi/libusb1.0.so /sdcard/
     66     adb shell su -c "cat > /system/lib/libusb1.0.so < /sdcard/libusb1.0.so"
     67     adb shell rm /sdcard/libusb1.0.so
     68 
     69     # Install the samples and tests
     70     for B in listdevs fxload xusb sam3u_benchmark hotplugtest stress
     71     do
     72       adb push "obj/local/armeabi/$B" /sdcard/
     73       adb shell su -c "cat > /system/bin/$B < /sdcard/$B"
     74       adb shell su -c "chmod 0755 /system/bin/$B"
     75       adb shell rm "/sdcard/$B"
     76     done
     77 
     78     # Make the system partition read only again
     79     adb shell su -c "mount -o remount,ro /system"
     80 
     81     # Run listdevs to
     82     adb shell su -c "listdevs"
     83 
     84  4. If your device only has a single OTG port then ADB can generally
     85     be switched to using Wifi with the following commands when connected
     86     via USB:
     87 
     88     adb shell netcfg
     89     # Note the wifi IP address of the phone
     90     adb tcpip 5555
     91     # Use the IP address from netcfg
     92     adb connect 192.168.1.123:5555
     93 
     94 Runtime Permissions:
     95 --------------------
     96 
     97 The default system configuration on most Android device will not allow
     98 access to USB devices. There are several options for changing this.
     99 
    100 If you have control of the system image then you can modify the
    101 ueventd.rc used in the image to change the permissions on
    102 /dev/bus/usb/*/*. If using this approach then it is advisable to
    103 create a new Android permission to protect access to these files.
    104 It is not advisable to give all applications read and write permissions
    105 to these files.
    106 
    107 For rooted devices the code using libusb could be executed as root
    108 using the "su" command. An alternative would be to use the "su" command
    109 to change the permissions on the appropriate /dev/bus/usb/ files.
    110 
    111 Users have reported success in using android.hardware.usb.UsbManager
    112 to request permission to use the UsbDevice and then opening the
    113 device. The difficulties in this method is that there is no guarantee
    114 that it will continue to work in the future Android versions, it
    115 requires invoking Java APIs and running code to match each
    116 android.hardware.usb.UsbDevice to a libusb_device.
    117