NAME

       bcharge - program to set BlackBerry handhelds to 500mA

SYNOPSIS

       bcharge

DESCRIPTION

       bcharge  is  a  program that sends a special handshake to all BlackBerry devices it finds on the USB bus.
       This handshake causes the device to reset itself, and then request 500mA  instead  of  the  usual  100mA.
       This allows proper charging on Linux.

       It  is  safe  to  run this command multiple times, as it only changes devices that are not already set to
       500mA, or are not in the desired mode.

OPTIONS

       -o     For Blackberry Pearl devices, using this switch causes bcharge to set the Product ID to 0001.

              When the Pearl is in 0004 mode, two USB interfaces are presented: one for database access and  one
              for mass storage.  In 0001 mode, only the database access is available.

              Before bcharge is run, the Pearl shows up with a Product ID of 0006, which only gives mass storage
              functionality.  You must run bcharge for the Pearl before using btool.

       -d     This  switch  is  for  the  Blackberry  Pearl to switch it back to 0004 dual mode after having run
              bcharge with the -o option.  Alternately, newer devices (such as Storm with product  ID  of  8007)
              will  be  switched  to  0004.   Since a Pearl in mode 0001 is practically indistinguishable from a
              classic Blackberry, the -d switch is needed to tell bcharge that you really  are  working  with  a
              Pearl.

       -g     Guess  whether  Dual  mode  is needed.  If USB Interface Class 255 is not found on the device (the
              class used for database access), then dual mode is set.  Otherwise, the device is left as is.

       -h     Help summary.

       -p devpath
              If your system runs a kernel with CONFIG_USB_SUSPEND enabled (some Ubuntu kernels have this turned
              on, as well as some Fedora 7 kernels), then you also need to adjust the  suspend  state  to  avoid
              going into power saving mode.  This option is used when run from udev, using a rule such as:

              BUS=="usb",         SUBSYSTEM=="usb_device",        ACTION=="add",        SYSFS{idVendor}=="0fca",
              SYSFS{idProduct}=="0001", SYMLINK+="bb-%k", GROUP="plugdev",  MODE="0660",  RUN="/usr/sbin/bcharge
              -p %p"

              When using this option, you will almost always need to be root.

       -s path
              Specify  the  mount point for the sysfs filesystem.  On most systems this is mounted at /sys which
              is the default.

AUTHOR

       bcharge and this manual page were written by Chris Frey <cdfrey@foursquare.net> for the Barry project.

       http://www.netdirect.ca/software/packages/barry

                                                 October 7, 2010                                      BCHARGE(1)