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         Alternative issue: You may have the berry_charge kernel module
  51         running, in which case you need to choose which method you wish
  52         to use.  Do not run both berry_charge and bcharge.
  53
  54
  55 -------------------------------------------------------------------------------
  56 Q:      btool is giving me errors, saying it can't find my device, or
  57         can't access it!
  58
  59 A:      If you have one of the newer BlackBerry devices, such as the Pearl
  60         or the Curve, these devices default to USB Mass Storage mode
  61         when you first plug them in.  The Linux kernel detects this,
  62         and on most systems loads the usb_storage module automatically,
  63         sometimes mounting the device as a drive.
  64
  65         As only one program can control a USB device at once, you must
  66         remove this module before btool can find your BlackBerry.
  67
  68         Run as root:     rmmod usb_storage
  69
  70         Alternately, you can setup your system to run bcharge with the -o
  71         command line switch.  This will disable USB Mass Storage on
  72         your BlackBerry until the next time you plug it in, and
  73         without USB Mass Storage, usb_storage won't load.
  74
  75
  76 -------------------------------------------------------------------------------
  77 Q:      One of the Barry applications crashed, and now I keep getting
  78         a Desktop error message in hex.
  79
  80 A:      If a Barry application crashes, that means the Desktop mode was
  81         not shutdown properly.  Your device will likely appear to still
  82         be "busy" as well.  Currently the only way to fix this is to
  83         reset the device, either by unplugging/replugging it, or by
  84         running the program "breset".
  85
  86
  87 -------------------------------------------------------------------------------
  88 Q:      Everytime I restore a backup with the backup GUI, the database
  89         I need does not get restored.  What gives?
  90
  91 A:      Both the backup and the restore are filtered based on your
  92         configuration.  Check your Edit | Config... settings and make
  93         sure the needed database is turned on in both backup and restore.
  94
  95
  96 -------------------------------------------------------------------------------
  97 Q:      I ran the backup, but can't find my backup files!  Where did they go?
  98
  99 A:      The backup program saves all backup files as gzip'd tarballs
 100         under your home directory:  ~/.barry/backup/<pin>/
 101         Each backup session creates a new file, named with the
 102         pin number, date, and time.
 103