You are viewing outdated content for BUG. If you have a BUG Y.T. edition or 2.0 series device, please visit our updated wiki:

BUG Troubleshooting

From BUG Wiki

Jump to: navigation, search


Normal BUG Behavior

Come see us in IRC

The easiest way to get real-time help from bug developers is to drop into our IRC channel. #buglabs on freenode.

Observable boot sequence behavior:

  1. Engage the power switch
  2. Front (blue) LEDs will flash (go on and off) momentarily
  3. BUGbase LCD backlight will illuminate, and the Bug logo will display:
    Image: BUGBase-BootAnimation2.gif
  4. If the LCD module is attached, it will power up at kernel/redboot load time, so the LCD's backlight will be on. There will be no display on the LCD module. This is normal.
  5. After approximately 10 seconds the backlight on the BUGbase LCD will shut off momentarily, then the animation on the front LCD will change to a dynamic image to indicate boot activity.
  6. The LCD backlight may remain on.
  7. The base LCD animation will stop after approximately 30 seconds, when the java libraries are loading. At this point Xserver and Xeyes will appear on the LCD module (if attached), the clock will display on the BUGbase LCD along with the attached modules' icons. The display on the BUGbase LCD, if all modules are attached, should resemble this:
  8. The LCD module should display this:

The sequence of the BUG booting:

  1. Power on->Redboot->Load Kernel->mount rootfs on Memory Card->load OS->load OSGi.
  2. Steps 1 and 2 regard power. If there is a failure here, it is likely a fail in power.
  3. Steps 3 and 4 regard Redboot and the Kernel loading. If BUG hangs, it is likely that the Root file system on your Memory Card is corrupted.

Typical BUG problems


Problem: I can telnet/ping/ssh into my BUG, but I can't see it in Eclipse.

Solution: This may mean that your BUG libraries aren't loaded properly. Please shutdown your BUG and restart it. If the problem is persistent, you can telnet/ssh into BUG and cat /var/log/concierge.log. If there are many exceptions, this most likely indicates that the Memory card is corrupted. Please follow these instructions to upgrade your BUG Memory card.

Problem: I can't connect to my BUG.

Solution: Verify that the boot procedure is proceeding as normal, and make sure you follow the instructions on the start page to the letter.

Problem: I don't know the password for telnet/ssh on my BUG.

Solution: It is defaulted to root/root.

Problem: What is my BUG's IP?

Solution: If attempting to connect by Ethernet via USB by following the instructions on the start page, the BUG's IP will be, and is accessible from the Host machine. If attempting to connect via WIFI, you can follow the instructions [here] to connect to a network and find your IP.

Problem: I can telnet into my BUG, but my BUG cannot access the internet.

Solution: Presently, connection bridging is only supported on Linux systems. The instructions on the start page show you how to forward incoming traffic on the host system to your BUG. To verify that your BUG can access the internet, telnet/ssh into the command line, and ping If the host is unreachable, please double check that the instructions were followed correctly. Please note: Ubuntu/debian based Linux systems are the target for our instructions. If you are using other distributions you may have slightly varied instructions, and are welcome to post in the discussion forums about their success.


Problem: My bug won't boot.

Solution: Try to find out at what state the boot failure is occurring.

  1. If BUG freezes with blue-lights on steady (steps 1-2 in normal boot behavior above), this is a power problem and you should contact our support team.
  2. If BUG freezes after the blue lights flash and the Bug logo is displayed, this usually indicates that the Memory card is corrupted and needs to be flashed. Please follow these instructions to upgrade your BUG Memory card.
  3. If BUG freezes at any other point, it means that the Memory card may have been corrupted in the /opt/concierge folder. You can telnet/ssh into BUG and cat /var/log/concierge.log. If there are many exceptions, this most likely indicates that the Memory card is corrupted. Please follow these instructions to upgrade your BUG Memory card.

Problem: My BUG won't charge.

Solution: More than likely this is a problem with the AC adapter. Please fully discharge your BUG (leaving it on with all modules attached), attach the power supply, and look for a red LED at the rear of your BUG near the power plug. If there is no red LED, try to gently jostle the AC adapter. If the LED intermittently illuminates, this is an indication that you have a bad AC adapter. If no amount of jostling results in a red LED, this may be an indication that the BUGbase has a power problem. Either way you should contact our support team.


Problem: I can't get a GPS fix.

Solution: This is due to the large amount of EM noise generated by the BUGbase. We are in the process of choosing an appropriate external antenna to ship to all users who have bought the Hiro P edition of the BUGbundle.


Problem: I don't see my Java Apps when BUGview is in Slots 1 or 3.

Solution: Java Apps now render on Slots 0 & 2. In R1.3 and earlier, BUG apps would display on slots 1 or 3 (X DISPLAY 1), but in R1.4 they are now display on slots 0 or 2 (X DISPLAY 0). This relates to the video overlay feature, which is currently only available on X DISPLAY 0.

Problem: My LCD module is doing the flash-light in some or all slots.

Solution: This is a problem we've been trying to track down. Preliminarily, it looks like a problem with the BUGbase and you should contact our support team.


Problem: I need high-resolution accelerometer data. The API doesn't support it.

Solution: The old BUG API (R1.1, SDK had an elementary Accelerometer API. It is now much more robust. Please refer to BUGlevel application for an example of how to access the hardware at very high resolutions. Also see: Accelerometer API Specification

Handylink Connector

Problem: Network access with handylink?

Solution: We are trying to get some of these cables made for our more dev-oriented customers. We have posted some DIY instructions here.


Problem: My application won't start.

Solution: Ensure that they you have networking set up, that you sent the application to in the Dragonfly (the BUG SDK), and that the required modules for the application are attached to your BUG. A great resource for any application or programming questions is to check out our discussion forums.

Problem: My application is 'Dead'.

If you install an app and it doesn't seem to run, and check the concierge log, you might see something like this: Ignoring dead app /usr/share/java/apps/MyApp.jar

Solution: You'll need to reset Concierge. A component called UserAppManager tracks applications, and if an application fails to start twice it tags it as "dead" and does not allow it to start again.


Problem: I installed or upgraded Firefox 3 on my Linux machine and now my Eclipse Browser doesn't work.

Solution: From the command line execute: sudo apt-get install xulrunner