2007/07/26
[barry.git] / man / bcharge.1
blob4b22f7412559941e0176d3ce1329ba8b4df1c904
1 .\"                                      Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH BCHARGE 1 "April 19, 2007"
6 .\" Please adjust this date whenever revising the manpage.
7 .\"
8 .\" Some roff macros, for reference:
9 .\" .nh        disable hyphenation
10 .\" .hy        enable hyphenation
11 .\" .ad l      left justify
12 .\" .ad b      justify to both left and right margins
13 .\" .nf        disable filling
14 .\" .fi        enable filling
15 .\" .br        insert line break
16 .\" .sp <n>    insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .SH NAME
19 bcharge \- program to set BlackBerry handhelds to 500mA
20 .SH SYNOPSIS
21 .B bcharge
22 .SH DESCRIPTION
23 .PP
24 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
25 .\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
26 .\" respectively.
27 \fBbcharge\fP is a program that sends a special handshake to all BlackBerry
28 devices it finds on the USB bus.  This handshake causes the device to reset
29 itself, and then request 500mA instead of the usual 100mA.  This allows
30 proper charging on Linux.
31 .PP
32 It is safe to run this command multiple times, as it only changes devices
33 that are not already set to 500mA.
35 .SH OPTIONS
36 .TP
37 .B \-o
38 For Blackberry Pearl devices, using this switch causes bcharge to set the
39 Product ID to 0001.  Otherwise, the default is to use Product ID 0004.
40 When the Pearl is in 0004 mode, two USB interfaces are presented:
41 one for database access and one for mass storage.  In 0001 mode, only
42 the database access is available.
44 Before bcharge is run, the Pearl shows up with a Product ID of 0006,
45 which only gives mass storage functionality.  You must run bcharge
46 for the Pearl before using btool.
47 .TP
48 .B \-d
49 Again, this switch is for the Blackberry Pearl to switch it back to
50 0004 dual mode after having run bcharge with the -o option.  Since
51 a Pearl in mode 0001 is practically indistinguishable from a classic
52 Blackberry, the -d switch is needed to tell bcharge that you really
53 are working with a Pearl.
55 .SH AUTHOR
56 bcharge and this manual page were written by Chris Frey <cdfrey@foursquare.net>
57 for the Barry project.
58 .PP
59 http://www.netdirect.ca/software/packages/barry/index.php