debian man page for bcharge

BCHARGE(1)						      General Commands Manual							BCHARGE(1)

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.  Alter-
	      nately, 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 ker-
	      nels),  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)