doc/www/requirements.html

   1 <html>
   2
   3 <head>
   4         <title>Barry Documentation</title>
   5         <link rel="stylesheet" type="text/css" href="default.css">
   6
   7 </head>
   8
   9 <body>
  10
  11
  12 <div class='pageHeader'>barry - Requirements</div><img src='nothing.jpg' width='100%' height='5' alt=''><br><div class='linearNav'>
  13 <div class="subHeader">::::::: Linux ::::::::::::::</div>
  14 <div class="subHeader">Charging and the Kernel</div>
  15 <p>One of the main features of Barry is the ability to control the charging
  16 modes of the Blackberry, as well as changing configuration modes on
  17 Pearl-like devices.</p>
  18
  19 <p>In order to achieve proper charging, udev is setup to run the bcharge
  20 program every time you plug in your Blackberry.</p>
  21
  22 <p>Kernels older than 2.6.34 have a module called berry_charge, which does
  23 similar things from the kernel level.  These two methods can conflict if both
  24 run at the same time.</p>
  25
  26 <p>Due to this conflict, the binary packages are setup to install
  27 a blacklist file under /etc/modprobe.d, which will disable berry_charge
  28 as long as you have the barry-util package installed.</p>
  29
  30 <p>If you are not using the binary packages, you can use the sample
  31 blacklist file that comes with the source tarball.</p>
  32
  33
  34
  35
  36 <div class="subHeader">Power and the Kernel</div>
  37 <p>Recent kernels also have the ability to put the USB bus and its devices
  38 into suspend mode.  Distros often have this turned on by default.</p>
  39
  40 <p>When bcharge runs, it successfully changes the Blackberry to use 500mA
  41 (its normal power level for charging), but then the kernel puts the device
  42 into suspend mode.  This can have various undefined effects, such as
  43 the charge icon disappearing on the device, or having your device lose
  44 its charge in an accelerated manner.</p>
  45
  46 <p>Bcharge attempts to work around this by writing to the
  47 control files under <code>/sys/class/usb_device/.../device/power/</code>
  48 to turn autosuspend off.  Depending on your kernel version or kernel
  49 config, these files may not be available, but in most cases at
  50 least one of the needed files are there.</p>
  51
  52 <p>If you continue to experience trouble charging your Blackberry:
  53 <ul>
  54         <li> consider upgrading your kernel (Ubuntu 7.10 Gutsy
  55                 patches their 2.6.22 kernel to fix this,
  56                 for example) </li>
  57         <li> recompile your kernel with CONFIG_USB_SUSPEND disabled </li>
  58 </ul>
  59 </p>
  60
  61
  62 <div class="subHeader">Device Ownership and Permissions</div>
  63 <p>The Barry toolset performs all its actions through the /proc and/or
  64 /sysfs filesystems, using the libusb library.  This requires that you
  65 have permissions to write to the USB device files setup by the kernel.</p>
  66
  67 <p>This is handled differently on various systems:</p>
  68
  69 <ul>
  70         <li>On Debian based systems, there is a group called plugdev, which
  71                 is used to control permissions for pluggable devices.
  72                 When the barry-util deb package is installed, udev is
  73                 configured to set Blackberry device permissions to
  74                 the plugdev group.  Make sure your user is in the plugdev
  75                 group.</li>
  76         <li>On Fedora based systems, ownership is controlled by the
  77                 ConsoleKit package.  This changes ownership of pluggable
  78                 devices to the user currently logged into the console,
  79                 on the theory that anyone at the console should have
  80                 control of the devices he plugs in. </li>
  81 </ul>
  82
  83
  84
  85 <div class="subHeader">::::::: OpenBSD ::::::::::::::</div>
  86 <div class="subHeader">Uberry Module and Ugen</div>
  87 <p>The uberry kernel module conflicts with the ugen interface that
  88 libusb uses to talk to the device.  To work around this, you will
  89 need to boot your kernel with "boot -c" and disable the uberry module.<p>
  90
  91 <p>Suggestions for better ways to work around this conflict are welcome.</p>
  92
  93
  94 <div class="Copyright">Copyright &copy; 2011 - Net Direct Inc.</div>
  95
  96 </body>
  97 </html>
  98