1BCHARGE(1)                  General Commands Manual                 BCHARGE(1)
2
3
4

NAME

6       bcharge - program to set BlackBerry handhelds to 500mA
7

SYNOPSIS

9       bcharge
10

DESCRIPTION

12       bcharge  is  a program that sends a special handshake to all BlackBerry
13       devices it finds on the USB bus.  This handshake causes the  device  to
14       reset  itself, and then request 500mA instead of the usual 100mA.  This
15       allows proper charging on Linux.
16
17       It is safe to run this command  multiple  times,  as  it  only  changes
18       devices  that  are  not already set to 500mA, or are not in the desired
19       mode.
20
21

OPTIONS

23       -o     For Blackberry Pearl devices, using this switch  causes  bcharge
24              to set the Product ID to 0001.
25
26              When  the  Pearl  is  in  0004 mode, two USB interfaces are pre‐
27              sented: one for database access and one for  mass  storage.   In
28              0001 mode, only the database access is available.
29
30              Before  bcharge  is run, the Pearl shows up with a Product ID of
31              0006, which only gives mass storage functionality.  You must run
32              bcharge for the Pearl before using btool.
33
34       -d     This  switch  is  for  the Blackberry Pearl to switch it back to
35              0004 dual mode after having run  bcharge  with  the  -o  option.
36              Alternately,  newer  devices  (such  as Storm with product ID of
37              8007) will be switched to 0004.  Since a Pearl in mode  0001  is
38              practically  indistinguishable from a classic Blackberry, the -d
39              switch is needed to tell bcharge that  you  really  are  working
40              with a Pearl.
41
42       -g     Guess  whether  Dual mode is needed.  If USB Interface Class 255
43              is not found on the device (the class used for database access),
44              then dual mode is set.  Otherwise, the device is left as-is.
45
46       -h     Help summary.
47
48       -p devpath
49              If  your  system  runs  a kernel with CONFIG_USB_SUSPEND enabled
50              (some Ubuntu kernels have this turned on, as well as some Fedora
51              7  kernels),  then  you also need to adjust the suspend state to
52              avoid going into power saving mode.  This option  is  used  when
53              run from udev, using a rule such as:
54
55              BUS=="usb", SUBSYSTEM=="usb_device", ACTION=="add", SYSFS{idVen‐
56              dor}=="0fca",    SYSFS{idProduct}=="0001",     SYMLINK+="bb-%k",
57              GROUP="plugdev", MODE="0660", RUN="/usr/sbin/bcharge -p %p"
58
59              When using this option, you will almost always need to be root.
60
61       -s path
62              Specify  the mount point for the sysfs filesystem.  On most sys‐
63              tems this is mounted at /sys which is the default.
64
65

AUTHOR

67       bcharge  and  this   manual   page   were   written   by   Chris   Frey
68       <cdfrey@foursquare.net> for the Barry project.
69
70       http://www.netdirect.ca/software/packages/barry
71
72
73
74
75                                October 7, 2010                     BCHARGE(1)
Impressum