Software:Update Your BUG Memory Card

From BUGwiki

Jump to: navigation, search



BUG ships with its GNU/Linux operating system on the memory card. The Bug Labs team is always working on updates and fixes, and it's generally a good idea to keep up to date with the latest release. The latest root filesystem images are available on our website. We typically announce new updates on our blog and forums.


The process described below completely overwrites your SD card with the newly built release. If you have unsaved data, applications, or modifications you'd like to save, we recommend using a separate SD card. To proceed, make sure to have your BUG memory card and an MMC or SD drive with appropriate usb cable.

Booting into Linux

Linux users can skip below to #Upgrading_The_Root_Filesystem. OS X and Windows users will need to download and boot into a linux environment. This can be done without affecting the machine. You will need a cd burner and blank cd.

  1. Download the latest version of the LiveCD from
  2. Burn the CD image to disk.
  3. Ensure that your MMC or SD card is NOT plugged in yet.
  4. Boot your computer from the CD you just created. Instead of your regular OS (Windows or OS X) loading, you should see the live cd's boot screen.
    • Mac: You will need to hold down the C key on your keyboard while your Mac boots in order to force it to boot from CD.
    • Windows: You may need to press a special key to boot the computer from a CD rather than the hard drive (F12,F10,ESC)
  5. Type `wizard` and hit enter to start the graphical gui, which will automatically get you up and running on the network and give you a root terminal

Upgrading the Root filesystem

Step 0: Back Up Existing Data

This is an optional step. If you have data on your existing BUG you'll want to get it off before proceeding. To backup the entire image onto your desktop or laptop machine:

$ dd if=/dev/sdb1 of=/tmp/BUG_backup.ext3.bin

When this completes a file, /tmp/BUG_backup.ext3.bin will be created with the complete contents of the BUG memory card.

Step 1: Mount the MMC or SD device

  1. From a terminal, as root or via sudo check to see that the card is mounted:
$ sudo fdisk -l
Disk /dev/sdb: 513 MB, 513802240 bytes
32 heads, 32 sectors/track, 980 cylinders
Units = cylinders of 1024 * 512 = 524288 bytes
Disk identifier: 0x00000000 

   Device Boot      Start         End      Blocks   Id  System
/dev/sdb1               1         980      501744    6  Linux

Make sure you see that it contains a valid partition table. i.e. you see "Linux" in the System column. If you do not, you will need to reformat your card. If you do not see Linux under system, use the following command to write an ext3 partition and partition table, substituting /dev/sdb with the dev name you saw above:

sudo fdisk /dev/sdb 
(enter for default beginning)
(enter for default size)

Of course, you may skip this step if it already is of type Linux. After it writes, you should run the

sudo fdisk -l

again and verify that "System" is now Linux, and proceed.

You now need to create a ext3 file system on the newly created primary partition:

mkfs -t ext3 /dev/sdb1

If you see another device name other than /dev/sdb1 then substitute that device name for sdb1 in the following steps.

Step 2: Download the BUG Root Filesystem

You can either use a web browser to navigate to our download page to download or download the image using wget from the command-line:

--2011-06-07 10:12:21--
Connecting to||:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 104986182 (100M) [application/x-bzip2]
Saving to: `Angstrom-bug-image-production-glibc-ipk-2011.03-bug20.rootfs.tar.bz2'

0% [                                                                                                                             ] 3,896       --.-K/s  eta 26h 56m

Step 3: Write the Image to the Memory Card

Now we can use dd to write the partition image to the memory card:

$ pmount /dev/sdX#  <--where /dev/sdX# is your SD card
$ cd /media/sdX#
$ sudo tar xvfj /path/to/Angstrom-bug-image-production-glibc-ipk-2011.03-bug20.rootfs.tar.bz2

You'll see the tarball unpack the contents of the root file system.

Step 4: Boot Your BUG

Now remove the memory card from your computer and put it back into BUG. Turn it on and you should see the familiar BUG logo boot-up sequence. Note that when booting for the first time after a fresh install, the BUG boot-up takes several seconds longer.

That's it! We hope you enjoy using your updated BUG.

Personal tools