BeagleBoneSoftware

This page needs lots of help



This page documents installation, use, maintenance, and software development using Linux on a BeagleBone.

The BeagleBoard.org site has a great getting 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).

Angstrom
The official distribution shipped with the BeagleBone is |Angstrom. Angstrom is built upon |OpenEmbedded, and has targets for many popular embedded Linux boards.

Angstrom images
|The Angstrom BeagleBoard page contains prebuilt kernels, bootloaders, filesystems, and whole-disk images for the official Angstrom releases, as well as instructions for installation.

Angstrom from source
Documentation regarding building Angstrom from source can be found on the |Building 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 |Angstrom 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 |U-Boot 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?

Talking to hardware
* DeviceTree and Capemgr * Example for each bus * Serial port * SPI * I2C * etc * PRU (optional?)