This page documents installation, use, maintenance, and software development using Linux on a BeagleBone.
- 1 Getting Started
- 2 The Angstrom Distribution
- 3 The Linux Kernel
- 4 The U-Boot Bootloader
- 5 The Angstrom Linux Distribution
- 6 Software Development
 has a great started guide which covers the BeagleBone and BeagleBone Black. This guide covers steps from unboxing all the way though installing an image on the SD card (for BeagleBone), or installing a flasher image and flashing the eMMC (for BeagleBone Black).
Making an SD card the hard way
Angstrom BeagleBoard page contains pre built kernels, bootloaders, filesystems, and whole-disk images for the official Angstrom releases, as well as instructions for installation.
The Angstrom Distribution
Building Angstrom from source
Documentation regarding building Angstrom from source can be found on the Angstrom page at the Angstrom website. For BeagleBone, use MACHINE=beaglebone
TODO: Also tell how to get from a built angstrom distro to something installed on the SD card.
Building just the kernel
To build just the kernel, run the following:
MACHINE=beaglebone ./oebb.sh bitbake virtual/kernel
TODO: tell where this kernel shows up and what to do with it (copy to SD card).
Build just the toolchain
TODO: Figure out how to actually do this (nobody seemed to know when I asked last time).
Downloading a prebuilt toolchain
Prebuilt toolchains can be downloaded from the Toolchains page. For BeagleBone, The armv7a-vfp-neon toolchains will work for the BeagleBone.
The Linux Kernel
The modern Linux kernels (version 3.8) for the BeagleBone Black (and also the modern kernel on the BeagleBone), is implemented and maintained as a set of patches ahead of the mainline kernel, along with a script to download a mainline kernel and patch it accordingly. This is the same kernel (mainline and patches) which is in the Angstrom build.
To Build a kernel, check out the beagleboard/kernel Github project, making sure to use branch 3.8. The README.md contains exact steps for building the kernel and copying it to your BeagleBone.
The U-Boot Bootloader
The BeagleBone uses the  bootloader. TODO: What's the official u-boot to use, and how to build it? TODO: Where is the official uEnv.txt? TODO: Is there a list of uEnv.txt variables which work with the installed bootloader? TODO: How to set the HDMI resolution?
The Angstrom Linux Distribution
TODO install packages TODO upgrade distro TODO configure networking TODO links to some basic Unix/Linux resources TODO (plenty of other stuff could go here)
Build software with native toolchian
Build software with a cross toolchain
Talking to hardware
* DeviceTree and Capemgr * Example for each bus * Serial port * SPI * I2C * etc * PRU (optional?)