Tarball tree for barry-0.17.0.tar.bz2
[barry.git] / doc / www / troubleshooting.html
blob333bf3fe5c9799e769c0296a8d14207076ba2aa1
1 <html>
3 <head>
4 <title>Barry Documentation</title>
5 <link rel="stylesheet" type="text/css" href="default.css">
7 </head>
9 <body>
12 <div class='pageHeader'>Troubleshooting</div><img src='nothing.jpg' width='100%' height='5' alt=''><br><div class='linearNav'>
13 <div class="subHeader">Common Issues When Working With Barry</div>
15 <p><b>Q:</b> When I run btool, it hangs for 30 seconds and then times out on
16 the USB read call.</p>
18 <p><b>A:</b> To verify that you are experiencing the right issue, run
19 "btool -vl" to get a verbose USB log. At the beginning
20 the USB configuration and endpoint information is printed.
21 If the last set of endpoints have 0's in the values, you are
22 experiencing the problem. The proper set of endpoints will not
23 be displayed with "lsusb -v" in this case either.</p>
25 <p>One workaround is to run bcharge twice like this:</p>
27 <pre>
28 bcharge
29 bcharge -o
30 </pre>
32 <p>After the second bcharge, btool should work normally.</p>
35 <hr/>
38 <p><b>Q:</b> I've installed Barry, and bcharge is set to run automatically,
39 but as soon as I plug my device into the USB port, the device reboots.</p>
41 <p><b>A:</b>Make sure you're running a recent version of Barry, at least
42 0.16 or 0.17.</p>
44 <p>Depending on the age of your kernel (older than 2.6.34?), you may have
45 the berry_charge kernel module running, in which case you need to choose
46 which method you wish to use. Do not run both berry_charge and bcharge.</p>
49 <hr/>
52 <p><b>Q:</b> One of the Barry applications crashed, and now I keep getting
53 a Desktop error message in hex.</p>
55 <p><b>A:</b> If a Barry application crashes, that means the Desktop mode was
56 not shutdown properly. Your device will likely appear to still
57 be "busy" as well. Currently the only way to fix this is to
58 reset the device, either by unplugging/replugging it, or by
59 running the program "breset".</p>
62 <hr/>
65 <p><b>Q:</b> Everytime I restore a backup with the backup GUI, the database
66 I need does not get restored. What gives?</p>
68 <p><b>A:</b> Both the backup and the restore are filtered based on your
69 configuration. Check your Edit | Config... settings and make
70 sure the needed database is turned on in <i>both</i> backup and restore.</p>
73 <hr/>
76 <p><b>Q:</b> I ran the backup, but can't find my backup files!
77 Where did they go?</p>
79 <p><b>A:</b> The backup program saves all backup files as gzip'd tarballs
80 under your home directory: ~/.barry/backup/pin_number/</p>
82 <p> Each backup session creates a new file, named with the
83 pin number, date, and time.</p>
86 <div class="Copyright">Copyright &copy; 2011 - Net Direct Inc.</div>
88 </body>
89 </html>