Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 59 Next »

This is a page about TI's BeagleBoard and BeagleBoard xM.


BeagleBoard Cx at Digi-Key
BeagleBoard xM at Digi-Key
CircuitCo 7inch LCD at Digi-Key

Basic Requirements

GCC Toolchain

tar xjf gcc-linaro-arm-linux-gnueabi-2012.04-20120426_linux.tar.bz2
export CC=`pwd`/gcc-linaro-arm-linux-gnueabi-2012.04-20120426_linux/bin/arm-linux-gnueabi-


Das U-Boot – the Universal Boot Loader

U-Boot Download:

Download U-Boot via git:

git clone git://
cd u-boot/
git checkout v2013.01 -b tmp

U-Boot Patches:


patch -p1 < 0001-enable-bootz-and-generic-load-features.patch
patch -p1 < 0002-ti-convert-to-uEnv.txt-n-fixes.patch

U-Boot Configure and Build:

make ARCH=arm CROSS_COMPILE=${CC} distclean
make ARCH=arm CROSS_COMPILE=${CC} omap3_beagle_config

Linux Kernel

Linux Build Script:

git clone git://
cd stable-kernel/

For Mainline v3.7.x

git checkout origin/v3.7.x -b v3.7.x

Run Build Script:


The kernel zImage and modules will be under the deploy directory.

Debian Squeeze 6.0.6 (armel/armv4t based) Root File System

Default User: debian
Password: temppwd

Root User: root
Root Password: root

wget -c

verify the image with:

md5sum debian-6.0.6-minimal-armel-2013-01-14.tar.xz
ccafe7556104a0ef5d166765fe01d17f  debian-6.0.6-minimal-armel-2013-01-14.tar.xz

Extract Image:

tar xJf debian-6.0.6-minimal-armel-2013-01-14.tar.xz

Debian Wheezy (snapshot) (armhf based) Root File System

Default User: debian
Password: temppwd

Root User: root
Root Password: root

wget -c

verify the image with:

md5sum debian-wheezy-minimal-armhf-2013-01-14.tar.xz
b388c77957d7333ee439160c3308c8ff  debian-wheezy-minimal-armhf-2013-01-14.tar.xz

Extract Image:

tar xJf debian-wheezy-minimal-armhf-2013-01-14.tar.xz

Ubuntu 12.10 (Quantal) (armhf based) Root File System

Default User: ubuntu
Password: temppwd

wget -c

verify the image with:

md5sum ubuntu-12.10-minimal-armhf-2013-01-14.tar.xz
983fa66e22e565ac15d58920f39b8f3b  ubuntu-12.10-minimal-armhf-2013-01-14.tar.xz

Extract Image:

tar xJf ubuntu-12.10-minimal-armhf-2013-01-14.tar.xz

Setup microSD card

For these instruction, we are assuming: DISK=/dev/mmcblk0, "sudo fdisk -l" is useful for determining the device id..

export DISK=/dev/mmcblk0

Erase microSD card:

sudo parted --script ${DISK} mklabel msdos

Setup Boot Partition:

sudo fdisk ${DISK} << __EOF__


Set Boot Flag

sudo parted --script ${DISK} set 1 boot on

Format Boot Partition as vfat:

sudo mkfs.vfat -F 16 ${DISK}p1 -n boot
sudo mkfs.vfat -F 16 ${DISK}1 -n boot

Setup Root File System Partition:

sudo fdisk ${DISK} << __EOF__


Format rootfs as ext4:

sudo mkfs.ext4 ${DISK}p2 -L rootfs
sudo mkfs.ext4 ${DISK}2 -L rootfs

Mount the Boot & Root File System Partitions:

Install Bootloaders:

Copy MLO to the boot partition

sudo cp -v ./u-boot/MLO /media/boot/

Copy u-boot.img to the boot partition

sudo cp -v ./u-boot/u-boot.img /media/boot/

Create U-Boot "uEnv.txt" boot script: (nano uEnv.txt)


#Camera: Uncomment to enable:

#SPI: enable for userspace spi access on expansion header

#LSR COM6L Adapter Board
#First production run has unprogramed eeprom:

#LSR COM6L Adapter Board + TiWi5

#These are now set by default: uncomment/change if you need something else

mmcroot=/dev/mmcblk0p2 ro
mmcrootfstype=ext4 rootwait fixrtc


mmc_load_image=fatload mmc 0:1 0x80300000 zImage
mmc_load_initrd=fatload mmc 0:1 0x81600000 initrd.img; setenv initrd_size ${filesize}
mmc_load_dtb=fatload mmc 0:1 0x815f0000 /dtbs/${dtb_file}

deviceargs=setenv device_args buddy=${buddy} buddy2=${buddy2} wl12xx_clk=${wl12xx_clk}
mmcargs=setenv bootargs console=${console} ${optargs} vram=${vram} omapfb.mode=${defaultdisplay}:${dvimode} omapdss.def_disp=${defaultdisplay} root=${mmcroot} rootfstype=${mmcrootfstype} ${device_args}

#Just: zImage
xyz_mmcboot=run mmc_load_image; echo Booting from mmc ...
loaduimage=run xyz_mmcboot; run deviceargs; run mmcargs; bootz 0x80300000

#zImage and initrd
#xyz_mmcboot=run mmc_load_image; run mmc_load_initrd; echo Booting from mmc ...
#loaduimage=run xyz_mmcboot; run deviceargs; run mmcargs; bootz 0x80300000 0x81600000:${initrd_size}

Copy uEnv.txt to the boot partition:

sudo cp -v ./uEnv.txt /media/boot/

Copying Kernel and related files

Note: This repo tree is under active development, so the Kernel version can change on a daily basis...
Copy Kernel zImage:

sudo cp -v ./stable-kernel/deploy/3.7.1-x4.zImage /media/boot/zImage

Copy Kernel dtbs:

sudo mkdir -p /media/boot/dtbs/
sudo tar xfv ./stable-kernel/deploy/3.7.1-x4-dtbs.tar.gz -C /media/boot/dtbs/

Copy Root File System:

sudo tar xfvp ./*-*-minimal-arm*-*/arm*-rootfs-*.tar -C /media/rootfs/

Copy Kernel modules:

sudo tar xfv ./stable-kernel/deploy/3.7.1-x4-modules.tar.gz -C /media/rootfs/

Tweak "/etc/fstab", the defaults should work for most boards:

sudo nano /media/rootfs/etc/fstab


/dev/mmcblk0p2   /           auto   errors=remount-ro   0   1
/dev/mmcblk0p1   /boot/uboot auto   defaults            0   0
Enable Networking on Bootup:
  • Note: Boards without ethernet interfaces will have delays on bootup.
sudo nano /media/rootfs/etc/network/interfaces

From: (uncomment)

#auto eth0
#iface eth0 inet dhcp


auto eth0
iface eth0 inet dhcp
Enable Serial Login:


sudo nano /media/rootfs/etc/inittab

Add at end of file:

T2:23:respawn:/sbin/getty -L ttyO2 115200 vt102


sudo nano /media/rootfs/etc/init/serial.conf


start on stopped rc RUNLEVEL=[2345]
stop on runlevel [!2345]

exec /sbin/getty 115200 ttyO2

Remove microSD card:

sudo umount /media/boot
sudo umount /media/rootfs


No Ethernet:

  1. Check Power (aka use 5Volt DC Plug): The USB bus allows up to 100mA on initial connection and up to a max of 500mA can be requested by the end USB device. On the xM this is not enough to power the whole device and on the xM C there is an actual hardware switch to disable the smsc95xx usb hub/ethernet when powered by OTG (to prevent out of power crashes seen on the xM A/B with when users powered by OTG).
  2. Check Ethernet Cable/Plug: Is the Ethernet Cable actually plugged into the Beagle and Router?
  3. Check Modules: The smsc95xx kernel driver is usually built as an external module, double check that your kernel modules for this device are installed.
    debian@devel:~$ find /lib/modules/`uname -r`/kernel/ | grep smsc95xx
    debian@devel:~$ lsmod | grep smsc95xx
    smsc95xx               11302  0
  4. Reload smsc95xx kernel module (Checked all the above and the LAN LED's are still off)
    sudo rmmod smsc95xx
    sudo modprobe smsc95xx
    sudo /etc/init.d/networking restart


Comments, feedback, and questions can be sent to

  • No labels