== Getting Started with OSSIE-!BeagleBoard using the SD Card Image  ==

'''Contents:'''
 * [wiki:OSSIEBeagleboardSDCardImage#Introduction Introduction]
 * [wiki:OSSIEBeagleboardSDCardImage#Download Download]
 * [wiki:OSSIEBeagleboardSDCardImage#Installation Installation]
 * [wiki:OSSIEBeagleboardSDCardImage#Use Use]
   * [wiki:OSSIEBeagleboardSDCardImage#HardwareSetup Hardware Setup]
   * [wiki:OSSIEBeagleboardSDCardImage#SoftwareSetup Software Setup]
   * [wiki:OSSIEBeagleboardSDCardImage#RunningOSSIE Running OSSIE]
 * [wiki:OSSIEBeagleboardSDCardImage#SeeAlso See Also]
== Introduction ==
The OSSIE-BeagleBoard SD Card Image is provided for our users that wish to quickly get up and running with OSSIE on a standard embedded platform.  The image is analogous to the [wiki:Downloads#LiveDVD OSSIE Live DVDs] available for PCs.  The [http://beagleboard.org/ BeagleBoard] is a low-cost ARM-based platform based on the [http://focus.ti.com/docs/prod/folders/print/omap3530.html Texas Instruments OMAP 3530]. It features an ARM Cortex-A8 GPP and TMS320 DSP.

''Note: This guide currently assumes that you have some familiarity with the OSSIE software and tools.''

== Download ==
''Note: this is an unsupported preview release based on OSSIE pre-0.8.1. An OSSIE 0.8.1-based release is coming soon. Python-based components are currently unsupported.''
 [http://ossie.wireless.vt.edu/download/beagleboard_images/uImage-beagleboard.bin Bootloader Image]

 [http://ossie.wireless.vt.edu/download/beagleboard_images/OSSIE-BB_pre-0.8.1_preview-1.tar.gz Root Filesystem Tarball]

== Installation ==
 * Partition and format your SD Card using the instructions available [http://code.google.com/p/beagleboard/wiki/LinuxBootDiskFormat here].
''Note: these instructions assume that you downloaded the bootloader image and root filesystem tarball to your home directory, called your FAT partition `LABEL1` and your ext2 partition `LABEL2` in the previous step, and that you're using Ubuntu.''
 * Insert the newly-formatted SD Card, which should mount `LABEL1` and `LABEL2` under `/media`

 * Copy the bootloader image to the FAT partition:

{{{
$ cp ~/uImage-beagleboard.bin /media/LABEL1/uImage
}}}

 * Unpack the root filesystem tarball to the ext2 partition (don't forget the 'p' flag):

{{{
$ sudo tar xvzpf ~/OSSIE-BB_pre-0.8.1_preview-1.tar.gz -C /media/LABEL2
}}}

 * Unmount the SD Card from your PC

At this point, you have the bootloader and root filesystem installed on your SD Card. 
== Use ==

=== Hardware Setup ===

The !BeagleBoard only has one USB OTG port used to connect USB peripherals.  It is recommended that you attach powered USB hub so that you can attach multiple USB peripherals such as a keyboard and Ethernet adapter.  Supported hardware is available [http://specialcomp.com/beagleboard/ here].

 * Insert your SD Card into the !BeagleBoard
 * In order to access the terminal, do one of the following: 
   * Use a null-modem cable to connect the !BeagleBoard to your computer over serial.
   * Connect the !BeagleBoard to a monitor using its HDMI port, and a USB keyboard to the USB hub
 * Connect the !BeagleBoard to your network using a USB Ethernet adapter.
 * Power up the !BeagleBoard.

Once Linux loads, you should see the login prompt on your serial terminal or monitor.  

=== Software Setup ===

 * Log in to the !BeagleBoard as root (no password).
 * Make sure that networking is configured.
 * (optional) You can now log in to the !BeagleBoard over SSH.

=== Running OSSIE ===

 * Start the CORBA Naming Service:

{{{
# omniNames.sh
}}}

 * Run nodeBooter:

{{{
# cd / sdr
# nodeBooter -D -d dev/nodes/default_GPP_node/DeviceManager.dcd.xml
}}}

 * At this point, you are ready to load a Waveform:
   * Using c_wavLoader from the console:
{{{
# /sdr/bin/c_wavLoader
}}}
   * Using the ALF GUI and !WaveDash over the network from your PC  (See user guide for details)

 * Refer to the [http://ossie.wireless.vt.edu/download/user_guides/OSSIE_0.8.1_User_Guide.pdf OSSIE User Guide] for additional information.


== See Also ==
[wiki:OSSIEBeagleboardCreatingSDCardImage Cloning a BeagleBoard SD Card]