android/README

   1 Building:
   2 =========
   3
   4 To build for android, run make with the "android-binaries" target with
   5 the "ndk-build" tool in the path. For example:
   6
   7     make android-binaries
   8
   9 The "ndk-build" tool is part of the Android NDK, which can be found at:
  10 http://developer.android.com/sdk/ndk/index.html
  11
  12
  13 Installing:
  14 ===========
  15
  16 The easiest way to install Barry on an Android device is by using adb,
  17 which is part of the Android SDK.
  18
  19 These instructions assume the Android device has been configured to
  20 support the root user by default. For Android Open Source Project
  21 (AOSP) devices this should be the case. Other device ROMs may have
  22 different mechanism for attaining root access, e.g. Cyanogenmod based
  23 ROMs make use of the "sudo" utility.
  24
  25 To install Barry to the system partition on a device run:
  26
  27     adb remount
  28     for F in libs/armeabi/*.so ; do adb push $F /system/lib; done
  29     for F in libs/armeabi/b* libs/armeabi/lsusb libs/armeabi/pppob libs/armeabi/upldif ; \
  30         do adb push $F /system/bin; done
  31
  32 To install Barry to a single directory on a device run:
  33
  34     adb shell mkdir /data/Barry
  35     for F in libs/armeabi/* ; do adb push $F /data/Barry; done
  36
  37
  38 Running:
  39 ========
  40
  41 Before running Barry tools it may be necessary to grant the
  42 user running Barry access to the USB bus devices. This can be achieved by
  43 running the following:
  44
  45    adb shell "for B in /dev/bus/usb/* ; do for D in \$B/* ; do chmod 0666 \$D ; done; done"
  46
  47 Note: this grants access to the USB devices for all users and therefore is
  48 not secure for a system running arbitary software. Alternate security
  49 mechanisms should be employeed by such systems.
  50
  51 If Barry was installed to the system partition then the tools can be run
  52 directly:
  53
  54     adb shell btool
  55
  56 However if Barry was installed to a single directory then the library
  57 path will need to be specified:
  58
  59     adb shell "LD_LIBRARY_PATH=/data/Barry /data/Barry/btool"
  60