<html>
<head>
<title>Barry Documentation</title>
<link rel="stylesheet" type="text/css" href="default.css">
</head>
<body>
<?
//
// This config is for the static web documentation generated as part
// of the release tarball.
//
$doc_mode = "static";
$extension = ".html";
$barry_page_path = "";
$image_path = "";
$files_path = "";
?>
<? include ("barry.inc"); ?>
<? createHeader("Troubleshooting"); ?>
<? createSubHeader("Common Issues When Working With Barry"); ?>
<p><b>Q:</b> I have one of the newer Pearl devices, such as the 8120.
When I try to run a backup using the GUI, the device resets itself.</p>
<p><b>A:</b> This is a known problem, and is likely a bug in the
Blackberry firmware which gets triggered when both the usb_storage kernel
module and Barry access the device at the same time. When Barry closes
its USB connection, the device gets confused and resets itself.</p>
<p>The only known workaround is to unload the usb_storage module when
accessing the database (such as when syncing or doing backups).</p>
<hr/>
<p><b>Q:</b> When I run btool, it hangs for 30 seconds and then times out on
the USB read call.</p>
<p><b>A:</b> From reports on the mailing list, this appears most likely to be
a bug in the BlackBerry firmware. Sometimes upgrading your
Blackberry will fix this issue.</p>
<p>This is not conclusive, and may be a kernel issue as well.</p>
<p>To verify that you are experiencing the right issue, run
"btool -vl" to get a verbose USB log. At the beginning
the USB configuration and endpoint information is printed.
If the last set of endpoints have 0's in the values, you are
experiencing the problem. The proper set of endpoints will not
be displayed with "lsusb -v" in this case either.</p>
<p>One workaround is to run bcharge twice like this:</p>
<pre>
bcharge
bcharge -o
</pre>
<p>After the second bcharge, btool should work normally.</p>
<hr/>
<p><b>Q:</b> I've installed Barry, and bcharge is set to run automatically,
but as soon as I plug my device into the USB port, the device reboots.</p>
<p><b>A:</b>This is a bug in the udev script, which causes the bcharge program
to be run 7 to 10 times back to back. This confuses the BlackBerry
enough to reset it. As of 2007/07/28, there is a corrected
udev script example in Barry CVS. This corrected script
was included in the Barry 0.8 release, and newer versions.</p>
<p>Alternative issue: You may have the berry_charge kernel module
running, in which case you need to choose which method you wish
to use. Do not run both berry_charge and bcharge.</p>
<hr/>
<p><b>Q:</b> btool is giving me errors, saying it can't find my device, or
can't access it!</p>
<p><b>A:</b> If you have one of the newer BlackBerry devices, such as the Pearl
or the Curve, these devices default to USB Mass Storage mode
when you first plug them in. The Linux kernel detects this,
and on most systems loads the usb_storage module automatically,
sometimes mounting the device as a drive.</p>
<p>If you are running an older version of Barry, please upgrade, as
this issue has been fixed so usb_storage and database access can
coexist in peace.</p>
<hr/>
<p><b>Q:</b> One of the Barry applications crashed, and now I keep getting
a Desktop error message in hex.</p>
<p><b>A:</b> If a Barry application crashes, that means the Desktop mode was
not shutdown properly. Your device will likely appear to still
be "busy" as well. Currently the only way to fix this is to
reset the device, either by unplugging/replugging it, or by
running the program "breset".</p>
<hr/>
<p><b>Q:</b> Everytime I restore a backup with the backup GUI, the database
I need does not get restored. What gives?</p>
<p><b>A:</b> Both the backup and the restore are filtered based on your
configuration. Check your Edit | Config... settings and make
sure the needed database is turned on in <i>both</i> backup and restore.</p>
<hr/>
<p><b>Q:</b> I ran the backup, but can't find my backup files!
Where did they go?</p>
<p><b>A:</b> The backup program saves all backup files as gzip'd tarballs
under your home directory: ~/.barry/backup/pin_number/</p>
<p> Each backup session creates a new file, named with the
pin number, date, and time.</p>
<div class="Copyright">Copyright © <? echo date("Y"); ?> - Net Direct Inc.</div>
</body>
</html>
