bcharge - program to set BlackBerry handhelds to 500mA
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.
-o For Blackberry Pearl devices, using this switch causes bcharge
to set the Product ID to 0001. Otherwise, the default is to use
Product ID 0004. 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
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 Again, this switch is for the Blackberry Pearl to switch it back
to 0004 dual mode after having run bcharge with the -o option.
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.
-h Help summary.
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",
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.
Specify the mount point for the sysfs filesystem. On most
systems this is mounted at /sys which is the default.
bcharge and this manual page were written by Chris Frey
<firstname.lastname@example.org> for the Barry project.
August 17, 2007