dcsimg

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

Wiki MarkupThis is a page about TI's Cortex-A8 based; BeagleBone. {

hide-comments

...

Table of Contents

...

indent

...

20px

...

style

...

disc

Availability

Boards:
BeagleBone at Digi-Key

Basic Requirements

  • Running a recent release of Debian, Fedora or Ubuntu; without OS Virtualization Software.
  • ARM Cross Compiler – Linaro: http://www.linaro.org

...

    • Linaro

...

    • Toolchain

...

    • Binaries:

...

...

  • Bootloader
    • Das U-Boot

...

    • the

...

    • Universal

...

    • Boot

...

    • Loader:

...

...

    • Source:

...

...

  • Linux

...

  • Kernel

...

    • Linus's

...

    • Mainline

...

    • tree:

...

...

  • ARM

...

  • based

...

  • rootfs

...

    • Debian:

...

...

    • Ubuntu:

...

...

ARM Cross Compiler:

...

GCC

...

This is a pre-built (64bit) version of Linaro GCC that runs on generic linux, sorry (32bit) x86 users, it's time to upgrade...
Download/Extract: {

Code Block

...

title

...

~/

...


wget -c https://releases.linaro.org/components/toolchain/binaries/6.3-2017.05/arm-linux-gnueabihf/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-

...

Test Cross Compiler: {

Code Block

...

title

...

~/

...


${CC}gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 6.3-2017.05) 6.3.1 20170404
Copyright (C) 2016 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

...

Bootloader:

...

U-Boot

...

Das U-Boot -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot]
eewiki.net patch archive: [https://github.com/eewiki/u-boot-patches]
Download: {

Code Block

...

title

...

~/

...


git clone https://github.com/u-boot/u-boot
cd u-boot/
git checkout v2017.09-rc2 -b tmp

...

Patches: {

Code Block

...

title

...

~/u-boot

...


wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.09-rc2/0001-am335x_evm-uEnv.txt-bootz-n-fixes.patch
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.09-rc2/0002-U-Boot-BeagleBone-Cape-Manager.patch
 
patch -p1 < 0001-am335x_evm-uEnv.txt-bootz-n-fixes.patch
patch -p1 < 0002-U-Boot-BeagleBone-Cape-Manager.patch

...

Configure and Build: {

Code Block

...

title

...

~/u-boot

...


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

...

Linux Kernel

This script will build the kernel, modules, device tree binaries and copy them to the deploy directory.

Mainline

see: BeagleBone#capemgr:v4.4.x+|:BeagleBone#capemgr:v4.4.x+] for overlay building on target
Download: {

Code Block

...

title

...

~/

...


git clone https://github.com/RobertCNelson/bb-kernel
cd bb-kernel/

...

For am33x-v4.4 (Longterm 4.4.x): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-v4.4 -b tmp

...

For am33x-rt-v4.4 (Longterm 4.4.x + Real-Time Linux): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-rt-v4.4 -b tmp

...

For am33x-v4.9 (Longterm 4.9.x): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-v4.9 -b tmp

...

For am33x-rt-v4.9 (Longterm 4.9.x + Real-Time Linux): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-rt-v4.9 -b tmp

...

For am33x-v4.12 (Stable): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-v4.12 -b tmp

...

For am33x-v4.13 (Prepatch): {

Code Block

...

title

...

~/bb-kernel/

...


git checkout origin/am33x-v4.13 -b tmp

...

Build: {

Code Block

...

title

...

~/bb-kernel/

...


./build_kernel.sh

...

TI BSP

Download:

Code Block
title~/

git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
cd ti-linux-kernel-dev/

...

For TI v4.4.x: {

Code Block

...

title

...

~/ti-linux-kernel-dev/

...


git checkout origin/ti-linux-4.4.y -b tmp

...

For TI v4.4.x: Real-Time {

Code Block

...

title

...

~/ti-linux-kernel-dev/

...


git checkout origin/ti-linux-rt-4.4.y -b tmp

...

For TI v4.9.x: {

Code Block

...

title

...

~/ti-linux-kernel-dev/

...


git checkout origin/ti-linux-4.9.y -b tmp

...

For TI v4.9.x: Real-Time {

Code Block

...

title

...

~/ti-linux-kernel-dev/

...


git checkout origin/ti-linux-rt-4.9.y -b tmp

...

Build: {

Code Block

...

title

...

~/ti-linux-kernel-dev/

...


./build_kernel.sh

...

Root File System

Debian 9

User

Password

debian

temppwd

root

root

Download:

Code Block
title~/

wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-9.1-minimal-armhf-2017-08-08.tar.xz

...

Verify: {

Code Block

...

title

...

~/

...


sha256sum debian-9.1-minimal-armhf-2017-08-08.tar.xz
ba8f801ee1907f362c61b1c10e7fa1a4c59d766eecfe32803588f33f29f69dd4  debian-9.1-minimal-armhf-2017-08-08.tar.xz

...

Extract: {

Code Block

...

title

...

~/

...


tar xf debian-9.1-minimal-armhf-2017-08-08.tar.xz

...

Ubuntu 16.04

...

LTS

...

User

Password

ubuntu

temppwd

Download:

Code Block
title~/

wget -c https://rcn-ee.com/rootfs/eewiki/minfs/ubuntu-16.04.3-minimal-armhf-2017-08-08.tar.xz

...

Verify: {

Code Block

...

title

...

~/

...


sha256sum ubuntu-16.04.3-minimal-armhf-2017-08-08.tar.xz
cc2689fc2d7cd9457f1b5fd2beff2a19123b4c95fb62848584f06c7158ecfe34  ubuntu-16.04.3-minimal-armhf-2017-08-08.tar.xz

...

Extract: {

Code Block

...

title

...

~/

...


tar xf ubuntu-16.04.3-minimal-armhf-2017-08-08.tar.xz

...

Setup microSD card

For these instruction we are assuming, DISK=/dev/mmcblk0, lsblk is very useful for determining the device id.* {

Code Block

...


export DISK=/dev/mmcblk0

...

Erase partition table/labels on microSD card: {

Code Block

...


sudo dd if=/dev/zero of=${DISK} bs=1M count=10

...

Install Bootloader: {

Code Block

...

title

...

~/

...


sudo dd if=./u-boot/MLO of=${DISK} count=1 seek=1 bs=128k
sudo dd if=./u-boot/u-boot.img of=${DISK} count=2 seek=1 bs=384k

...

Create Partition Layout: *
With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.* {

Code Block

...


sudo sfdisk --version
sfdisk from util-linux 2.27.1

...

Code Block
titlesfdisk >=

...

2.26.x

...


sudo sfdisk ${DISK} <<-__EOF__
4M,,L,*
__EOF__

...

Code Block
titlesfdisk <=

...

2.25.x

...


sudo sfdisk --unit M ${DISK} <<-__EOF__
4,,L,*
__EOF__

...

Format Partition: *
With mkfs.ext4 1.43, we need to make sure metadata_csum and 64bit are disabled.*
As U-Boot CAN NOT currently handle reading files with these newer ext4 options and so Debian 8 (armel/armhf) and Ubuntu 16.04 (armhf) fsck tools will operate correctly. {

Code Block

...

title

...

mkfs.ext4

...

-V

...


sudo mkfs.ext4 -V
mke2fs 1.43-WIP (15-Mar-2016)
        Using EXT2FS Library version 1.43-WIP

...

Code Block
titlemkfs.ext4

...

>=

...

1.43

...


for: DISK=/dev/mmcblk0
sudo mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}p1
 
for: DISK=/dev/sdX
sudo mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}1

...

Code Block
titlemkfs.ext4

...

<=

...

1.42

...


for: DISK=/dev/mmcblk0
sudo mkfs.ext4 -L rootfs ${DISK}p1
 
for: DISK=/dev/sdX
sudo mkfs.ext4 -L rootfs ${DISK}1

...

Mount Partition: *
On most systems these partitions may will be auto-mounted...* {

Code Block

...


sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
sudo mount ${DISK}p1 /media/rootfs/
 
for: DISK=/dev/sdX
sudo mount ${DISK}1 /media/rootfs/

...

Install Kernel and Root File System

To help new users, since the kernel version can change on a daily basis. The kernel building scripts listed on this page will now give you a hint of what kernel version was built.

Code Block

-----------------------------
Script Complete
eewiki.net: [user@localhost:~$ export kernel_version=4.X.Y-Z]
-----------------------------

...

Copy and paste that "export kernel_version=4.X.Y-Z" exactly as shown in your own build/desktop environment and hit enter to create an environment variable to be used later. {

Code Block

...


export kernel_version=4.X.Y-Z

...

Copy Root File System

Code Block
title~/

sudo tar xfvp ./*-*-*-armhf-*/armhf-rootfs-*.tar -C /media/rootfs/
sync
sudo chown root:root /media/rootfs/
sudo chmod 755 /media/rootfs/

...

Set uname_r

...

in

...

/boot/uEnv.txt

...

Code Block

...

title

...

~/

...


sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"

...

Copy Kernel Image

Kernel Image:

Code Block
title~/

sudo cp -v ./bb-kernel/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}

...

Copy Kernel Device Tree Binaries

Code Block
title~/

sudo mkdir -p /media/rootfs/boot/dtbs/${kernel_version}/
sudo tar xfv ./bb-kernel/deploy/${kernel_version}-dtbs.tar.gz -C /media/rootfs/boot/dtbs/${kernel_version}/

...

Copy Kernel Modules

Code Block
title~/

sudo tar xfv ./bb-kernel/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/

...

File Systems Table (/etc/fstab)

...

Code Block

...


sudo sh -c "echo '/dev/mmcblk0p1  /  auto  errors=remount-ro  0  1' >> /media/rootfs/etc/fstab"

...

Networking

Edit: /etc/network/interfaces {

Code Block

...


sudo nano /media/rootfs/etc/network/interfaces

...

Add: {

Code Block

...

title

...

/etc/network/interfaces

...


auto lo
iface lo inet loopback
 
auto eth0
iface eth0 inet dhcp

...

Networking:

...

Using

...

a

...

shared

...

SD

...

card

...

with

...

Multiple

...

BeagleBone

...

To always enable the Ethernet interface as eth0.
Edit: /etc/udev/rules.d/70-persistent-net.rules {

Code Block

...


sudo nano /media/rootfs/etc/udev/rules.d/70-persistent-net.rules

...

Add: {

Code Block

...

title

...

/etc/udev/rules.d/70-persistent-net.rules

...


# BeagleBone: net device ()
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"

...

Remove microSD/SD

...

card

...

Code Block

...


sync
sudo umount /media/rootfs

...

capemgr:

...

v4.4.x+

...

Full Documentation: [readme|https://github.com/beagleboard/bb.org-overlays/blob/master/readme.md] Download: {code:title=~/} readme
Download:

Code Block
title~/

git clone https://github.com/beagleboard/bb.org-overlays
cd ./bb.org-overlays/

...

Install *.dtbo: {

Code Block

...

title

...

~/bb.org-overlays/

...


./install.sh

...

capemgr: enable/disable capes on kernel cmdline: {

Code Block

...


Comma delimited list of PART-NUMBER[:REV] of [enabled/disabled] capes

...

Code Block
title/boot/uEnv.txt

...


cape_disable=bone_capemgr.disable_partno=
cape_enable=bone_capemgr.enable_partno=

...

slots: {

Code Block

...


debian@beaglebone:~$ cat /sys/devices/platform/bone_capemgr/slots
 0: 54:P---L BeagleBone RS232 CAPE,00A1,Beagleboardtoys,BB-BONE-SERL-03
 1: 55:PF---
 2: 56:PF---
 3: 57:PF---

...

Comments

Comments, feedback, and questions can be sent to: [eewiki@digikey.com|mailto:eewiki@digikey.com?subject=BeagleBone] Please use the
Please use the Digi-Key's TechForum: [TechForum|https://forum.digikey.com/c/linux-on-arm/]