Difference between revisions of "Prepare a bootable SD card to run Balsa"

From LSDevLinux
Jump to: navigation, search
(Step 3: Initialize the SD card: Emphasise 'can be omitted' statement)
m (Step 1: Build BALSA: Improve link wording)
Line 11: Line 11:
  
 
====Step 1: Build BALSA====
 
====Step 1: Build BALSA====
See [[BALSA Prototype#Running the builder]]
+
See [[BALSA Prototype#Running the builder|BALSA Prototype]] instructions.
  
 
====Step 2: Decompress the BALSA tarball====
 
====Step 2: Decompress the BALSA tarball====

Revision as of 15:13, 2 February 2010

Introduction

This set of instructions tells you how to install a BALSA Prototype onto a SD card

The BALSA build finishes with the set of BALSA files in a bzip2 tarball in the .../balsa-builder/builder directory. These are instructions for loading those files onto an SD card. The goal is to build a bootable BALSA SD card.

The user must have access to sudo privileges.

In the case of initializing multiple SD cards, Steps 1 and 2 below only need to be performed once.

The Procedure

Step 1: Build BALSA

See BALSA Prototype instructions.

Step 2: Decompress the BALSA tarball

This step decompresses the BALSA tarball into an intermediate directory. The intermediate directory must be on a Linux filesystem (e.g. ext2 or ext3; not FAT or NTFS). The code below assumes that the intermediate directory is named built and is a sibling directory to the balsa-builder directory. If you want to put it elsewhere, replace built and ../balsa-builder/builder/ with a paths/directories of your choice. Open a terminal and use cd to get to the parent of the balsa-builder directory you made in Step 1. Run these commands:

mkdir built
sudo chown root:root built
cd built
sudo tar --numeric-owner -xpjf ../balsa-builder/builder/latest.tbz2

Step 3: Initialize the SD card

If the SD card has a BALSA build on it already, this step can be omitted.

You will need a Linux system with gparted installed that can read a SD card.

WARNING!! gparted is a partition editor. It is a powerful and dangerous tool. If you don't know what a partition is, you shouldn't be doing this. Read the instructions below and understand them. Follow them closely.

  1. This procedure will destroy all the data on the SD card. Back up any data you want to keep.
  2. Plug in the SD card.
  3. Start gparted. You will see a screen that looks like this:
    600px
  4. Choose the SD card in gparted device window. (Red Circle 1)
  5. Turn on View|Device Information and check that you're working on the right device. (Blue Circle 2)
  6. Select the mounted partition. (Green Circle 3)
  7. In the menu, select Partition|Unmount
  8. If there are more than 1 partition on the SD card use the previous two instructions to unmount them all.
  9. In the menu, select Device|Create Partition Table.
  10. (use msdos partition) click create button
  11. select unallocated
  12. Create New Partition Partition | Create New Partition You will see this dialogue box Fill it out as specified below:
    500px
    Create as: Primary Partition (Red Circle 1)
    File System: ext3 (Blue Circle 2)
    Label: OLPCRoot (Green Circle 3)
  13. Click on the Add button.
  14. The main gparted screen will come back. It won't create the partition until you click the green checkmark (Red Circle below)
    600px
  15. gparted will create the partition with an empty file system. When you mount the SD, it should look like this:
    600px

Step 4: copy/update the BALSA build onto the SD card

need commands to mount SD card and cd to built directory.
sudo rsync --delete -axHAX ./ /media/OLPCRoot

If you want to monitor the progress of the rsync replace the last command above with:

sudo rsync --delete -axHAX --progress ./ /media/OLPCRoot

To do

This article needs updating with instructions on how to initialize an SD card for BALSA.