Using Angstrom

Introduction

Starting with the 14.1 Release, the Golden System Reference Design (GSRD) User Manuals is based on the Angstrom distribution.

Angstrom offers a simple-to-use tool to manage packages installed on the target platform. This tool is called opkg and is similar with other package management tools such as:

• yum - available on RedHat/CentOS
• apt-get - available on Debian/Ubuntu

This page contains instructions on:

• How to get started using the Angstrom package management features,
• How to install the Golden System Reference Design (GSRD) User Manuals on top of a generic Angstrom image

Angstrom Getting Started

This section presents a few examples on how to use the package manager from the Angstrom distribution.

In order to use the opkg package manager, you will need to run the Angstrom distribution on your target, and you will also need an Internet connection on the target. This is because the packages are downloaded from the Angstrom servers.

Sample Command	Description
opkg update	Updates the lists of currently available packages
opkg install <pkgs>	Installs one or more packages
opkg upgrade <pkgs>	Upgrade one or more packages
opkg remove <pkgs>	Removes one or more packages
opkg --help	Display all available options

For example the following commands installs the gcc and mcpackages:

opkg install gcc mc

And the following command removes the gcc package:

opkg remove gcc

Installing GSRD From Angstrom

This section presents how to install the Golden System Reference Design (GSRD) User Manuals packagesby using the Angstrom package manager. This allows the Golden System Reference Design (GSRD) User Manuals to be installed on a Linux target that is Angstrom based.

The prerequisites are:

• A target platform running Angstrom, but not having the Golden System Reference Design (GSRD) User Manuals packages
• Internet connection for the target to download the Golden System Reference Design (GSRD) User Manuals packages

The steps are:

1. Boot the target

2. Edit the file /etc/opkg/socfpga_cyclone5-feed.conf using vim or any other available editor, to replace http:// with

• http://angstrom.rocketboards.org/feeds/v2013.12/ipk/eglibc/armv7a-vfp-neon/gsrd/14.1/socfpga-3.10-ltsi/machine/socfpga_cyclone5/ (for cyclone5)
• http://angstrom.rocketboards.org/feeds/v2013.12/ipk/eglibc/armv7a-vfp-neon/gsrd/14.1/socfpga-3.10-ltsi/machine/socfpga_arria5/ (for arria5)

3. Update the list of packages

$ opkg update

4. Install the Golden System Reference Design (GSRD) User Manuals packages:

$ opkg install altera-gsrd-apps
$ opkg install altera-gsrd-initscripts
$ opkg install altera-gsrd-pio-interrupt
$ opkg install lighttpd
$ opkg install lighttpd-module-cgi
$ opkg install altera-gsrd-webcontent
$ opkg install altera-lighttpd-conf --force-overwrite
$ opkg install bash
$ opkg install update-alternatives 

5. Reboot target

References

• http://www.angstrom-distribution.org/