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