Difference between revisions of "Dummies Guide to Building Angstrom Linux for MinnnowBoard"

From eLinux.org
Jump to: navigation, search
m (Procedure)
m (Added steps instead of just numbers)
Line 15: Line 15:
 
=Procedure=
 
=Procedure=
  
1. Install the pre-requisites by typing the command below in the terminal:
+
'''Step-1:'''
 +
 
 +
Install the pre-requisites by typing the command below in the terminal:
  
 
  sudo apt-get install gawk wget git diffstat unzip build-essential chrpath libsdl1.2-dev xterm unzip texinfo \
 
  sudo apt-get install gawk wget git diffstat unzip build-essential chrpath libsdl1.2-dev xterm unzip texinfo \
Line 21: Line 23:
 
  gcc g++ desktop-file-utils chrpath dosfstools kpartx bitbake
 
  gcc g++ desktop-file-utils chrpath dosfstools kpartx bitbake
  
2. Change the default shell in Ubuntu from dash to bash typing the command below in the terminal::
+
'''Step-2:'''
 +
 
 +
Change the default shell in Ubuntu from dash to bash typing the command below in the terminal::
  
 
  sudo dpkg-reconfigure bash
 
  sudo dpkg-reconfigure bash
  
3. The next step is to download the [https://github.com/Angstrom-distribution/setup-scripts Angstrom setup scripts] which will help us prepare a development environment for building the Angstrom image. Type the following command in your terminal:
+
'''Step-3:'''
 +
 
 +
The next step is to download the [https://github.com/Angstrom-distribution/setup-scripts Angstrom setup scripts] which will help us prepare a development environment for building the Angstrom image. Type the following command in your terminal:
  
 
  git clone git://github.com/Angstrom-distribution/setup-scripts.git
 
  git clone git://github.com/Angstrom-distribution/setup-scripts.git
  
4. Make the necessary changes to the local.conf file as shown below. This file can be found in ~/setup-scripts/conf/local.conf .  
+
'''Step-4:'''
 +
 
 +
Make the necessary changes to the local.conf file as shown below. This file can be found in ~/setup-scripts/conf/local.conf .  
  
 
  # Add this to the bottom:
 
  # Add this to the bottom:
Line 36: Line 44:
 
  NOISO = "1"
 
  NOISO = "1"
  
5. Setup the necessary environment for MinnowBoard by typing the command below in the terminal:
+
'''Explanation:'''
 +
* LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin commercial" is required to prevent the resulting image from including
 +
  anything that might violate the license terms of the packages used to implement the video acceleration feature, such as
 +
  gst-ffmpeg and ffmpeg.
 +
 
 +
'''Step-5:'''
 +
 
 +
Setup the necessary environment for MinnowBoard by typing the command below in the terminal:
  
 
  MACHINE=minnow ./oebb.sh config minnow
 
  MACHINE=minnow ./oebb.sh config minnow
 
   
 
   
6. Build the image by typing the following command in the terminal:
+
'''Step-6:'''
 +
 
 +
Build the image by typing the following command in the terminal:
  
 
  MACHINE=minnow ./oebb.sh bitbake systemd-image
 
  MACHINE=minnow ./oebb.sh bitbake systemd-image
  
7. The resulting image will be located in ~/setup-scripts/build/tmp-angstrom_v2012_12-eglibc/deploy/images/minnow/
+
'''Step-7:'''
 +
 
 +
The resulting image will be located in ~/setup-scripts/build/tmp-angstrom_v2012_12-eglibc/deploy/images/minnow/
  
 
=Troubleshooting=
 
=Troubleshooting=
  
 
[[Category: MinnowBoard]]
 
[[Category: MinnowBoard]]

Revision as of 15:22, 7 January 2014

Mlogo.png Back to the MinnowBoard home page


Angstrom os logo.png

Summary

This guide explains building the Embedded Linux distribution - Angstrom from source in a beginner friendly manner.

Important Notes

1. These instructions have been documented using Ubuntu 12.04 LTS as the reference operating system. It is advised that you also have the same setup.

2. Please make sure that you have at least 18GB of free space available as the source code can take up a lot of space.

3. It took 8 hours to build a systemd-image on a dual core I7 machine with 8GB RAM and only two(out of the possible 4) threads used.

Procedure

Step-1:

Install the pre-requisites by typing the command below in the terminal:

sudo apt-get install gawk wget git diffstat unzip build-essential chrpath libsdl1.2-dev xterm unzip texinfo \
git texi2html subversion ncurses-dev sed cvs coreutils docbook-utils python-pysqlite2 help2man make \
gcc g++ desktop-file-utils chrpath dosfstools kpartx bitbake

Step-2:

Change the default shell in Ubuntu from dash to bash typing the command below in the terminal::

sudo dpkg-reconfigure bash

Step-3:

The next step is to download the Angstrom setup scripts which will help us prepare a development environment for building the Angstrom image. Type the following command in your terminal:

git clone git://github.com/Angstrom-distribution/setup-scripts.git

Step-4:

Make the necessary changes to the local.conf file as shown below. This file can be found in ~/setup-scripts/conf/local.conf .

# Add this to the bottom:
MACHINE ?= "minnow"
LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin commercial" 
NOISO = "1"
Explanation:
* LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin commercial" is required to prevent the resulting image from including 
  anything that might violate the license terms of the packages used to implement the video acceleration feature, such as 
  gst-ffmpeg and ffmpeg.

Step-5:

Setup the necessary environment for MinnowBoard by typing the command below in the terminal:

MACHINE=minnow ./oebb.sh config minnow

Step-6:

Build the image by typing the following command in the terminal:

MACHINE=minnow ./oebb.sh bitbake systemd-image

Step-7:

The resulting image will be located in ~/setup-scripts/build/tmp-angstrom_v2012_12-eglibc/deploy/images/minnow/

Troubleshooting