doc/TroubleShooting.txt

   1 A list of common issues when working with Barry:
   2 ------------------------------------------------
   3
   4 -------------------------------------------------------------------------------
   5 Q:      When I run btool, it hangs for 30 seconds and then times out on the
   6         USB read call.
   7
   8 A:      From reports on the mailing list, this appears most likely to be
   9         a bug in the BlackBerry firmware.  Sometimes upgrading your
  10         Blackberry will fix this issue.
  11
  12         This is not conclusive, and may be a kernel issue as well.
  13
  14         To verify that you are experiencing the right issue, run
  15         "btool -vl" to get a verbose USB log.  At the beginning
  16         the USB configuration and endpoint information is printed.
  17         If the last set of endpoints have 0's in the values, you are
  18         experiencing the problem.  The proper set of endpoints will not
  19         be displayed with "lsusb -v" in this case either.
  20
  21         One workaround is to run bcharge twice like this:
  22
  23                 bcharge
  24                 bcharge -o
  25
  26         After the second bcharge, btool should work normally.
  27
  28
  29 -------------------------------------------------------------------------------
  30 Q:      I'm running Ubuntu Feisty Fawn and bcharge appears to work, but
  31         then the charge icon goes out.
  32
  33 A:      This is a known problem, and unfortunately the real solution has
  34         not yet been found.  You might try compiling your own kernel,
  35         or upgrading to a different kernel.  Keep an eye on the Barry
  36         mailing list for the latest developments.
  37
  38
  39 -------------------------------------------------------------------------------
  40 Q:      I've installed Barry, and bcharge is set to run automatically,
  41         but as soon as I plug my device into the USB port, the device
  42         reboots.
  43
  44 A:      This is a bug in the udev script, which causes the bcharge program
  45         to be run 7 to 10 times back to back.  This confuses the BlackBerry
  46         enough to reset it.  As of 2007/07/28, there is a corrected
  47         udev script example in Barry CVS.  This corrected script
  48         will be included in the Barry 0.8 release.
  49
  50
  51 -------------------------------------------------------------------------------
  52 Q:      btool is giving me errors, saying it can't find my device, or
  53         can't access it!
  54
  55 A:      If you have one of the newer BlackBerry devices, such as the Pearl
  56         or the Curve, these devices default to USB Mass Storage mode
  57         when you first plug them in.  The Linux kernel detects this,
  58         and on most systems loads the usb_storage module automatically,
  59         sometimes mounting the device as a drive.
  60
  61         As only one program can control a USB device at once, you must
  62         remove this module before btool can find your BlackBerry.
  63
  64         Run as root:     rmmod usb_storage
  65
  66         Alternately, you can setup your system to run bcharge with the -o
  67         command line switch.  This will disable USB Mass Storage on
  68         your BlackBerry until the next time you plug it in, and
  69         without USB Mass Storage, usb_storage won't load.
  70
  71
  72 -------------------------------------------------------------------------------
  73 Q:      One of the Barry applications crashed, and now I keep getting
  74         a Desktop error message in hex.
  75
  76 A:      If a Barry application crashes, that means the Desktop mode was
  77         not shutdown properly.  Your device will likely appear to still
  78         be "busy" as well.  Currently the only way to fix this is to
  79         reset the device, either by unplugging/replugging it, or by
  80         running the program "breset".
  81
  82
  83 -------------------------------------------------------------------------------
  84 Q:      Everytime I restore a backup with the backup GUI, the database
  85         I need does not get restored.  What gives?
  86
  87 A:      Both the backup and the restore are filtered based on your
  88         configuration.  Check your Edit | Config... settings and make
  89         sure the needed database is turned on in both backup and restore.
  90
  91
  92 -------------------------------------------------------------------------------
  93 Q:      I ran the backup, but can't find my backup files!  Where did they go?
  94
  95 A:      The backup program saves all backup files as gzip'd tarballs
  96         under your home directory:  ~/.barry/backup/<pin>/
  97         Each backup session creates a new file, named with the
  98         pin number, date, and time.
  99