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

...

This

...

is

...

a

...

page

...

about

...

TI's

...

Cortex-A8

...

based;

...

BeagleBone

...

Black.

...

hide-comments

...

Table of Contents

...

indent

...

20px

...

style

...

disc

Availability

Boards:
BeagleBone Black at Digi-Key
BeagleBone Green at Digi-Key
Embest BeagleBone Black at Digi-Key
BeagleBone Black Wireless at Digi-Key
BeagleBone Green Wireless at Digi-Key

Power Supplies:
USB Micro for BeagleBone Green at Digi-Key

Cables:
(USB to serial adapter) TTL-232R-3V3 at Digi-Key
HDMI-A Male to HDMI-D Male (1.5M) at Digi-Key
HDMI-A Male to HDMI-D Male (1.5M) at Digi-Key
HDMI-A Male to HDMI-D Male (2M) 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.4-2017.08/arm-linux-gnueabihf/gcc-linaro-6.4.1-2017.08-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-6.4.1-2017.08-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-6.4.1-2017.08-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-
{code}

Test

...

Cross

...

Compiler:

...

:=}
Code Block
title
~/
${CC}gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 6.4-2017.08) 6.4.1 20170707
Copyright (C) 2017 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.
{code}
 
h1. 

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 -b tmp
{code}

Patches:

...

:=}
Code Block
title
~/u-boot
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.09/0001-am335x_evm-uEnv.txt-bootz-n-fixes.patch
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2017.09/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
{code}

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}
{code}
 
h1. Linux Kernel
This script will build the kernel, modules, device tree binaries and copy them to the deploy directory.
h3. Mainline
see: [BeagleBone 

Linux Kernel

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

Mainline

see: BeagleBone Black#capemgr:v4.4.x+

...

for

...

overlay

...

building

...

on

...

target

...


Download:

...

:=}
Code Block
title
~/
git clone https://github.com/RobertCNelson/bb-kernel
cd bb-kernel/
{code}

For

...

am33x-v4.4

...

(Longterm

...

4.4.x):

...

:=}
Code Block
title
~/bb-kernel/
git checkout origin/am33x-v4.4 -b tmp
{code}

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
{code}

For

...

am33x-v4.9

...

(Longterm

...

4.9.x):

...

:=}
Code Block
title
~/bb-kernel/
git checkout origin/am33x-v4.9 -b tmp
{code}

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
{code}

For

...

am33x-v4.14

...

(Longterm

...

4.14.x):

...

:=}
Code Block
title
~/bb-kernel/
git checkout origin/am33x-v4.14 -b tmp
{code}

For

...

am33x-v4.13

...

(Stable):

...

:=}
Code Block
title
~/bb-kernel/
git checkout origin/am33x-v4.13 -b tmp
{code}

Build:

...

:=}
Code Block
title
~/bb-kernel/
./build_kernel.sh
{code}
 
h3. TI BSP
Download:
{code:title=~/}

TI BSP

Download:

Code Block
title~/
git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
cd ti-linux-kernel-dev/
{code}

For

...

TI

...

v4.4.x:

...

:=}
Code Block
title
~/ti-linux-kernel-dev/
git checkout origin/ti-linux-4.4.y -b tmp
{code}

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
{code}

For

...

TI

...

v4.9.x:

...

:=}
Code Block
title
~/ti-linux-kernel-dev/
git checkout origin/ti-linux-4.9.y -b tmp
{code}

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
{code}

For

...

TI

...

v4.14.x:

...

:=}
Code Block
title
~/ti-linux-kernel-dev/
git checkout origin/ti-linux-4.14.y -b tmp
{code}

Build:

...

:=}
Code Block
title
~/ti-linux-kernel-dev/
./build_kernel.sh
{code}
 
h1. Root File System
h4. Debian 9
|| User || Password ||
| debian | temppwd |
| root | root |
Download:
{code:title=~/}

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.2-minimal-armhf-2017-10-07.tar.xz
{code}

Verify:

...

:=}
Code Block
title
~/
sha256sum debian-9.2-minimal-armhf-2017-10-07.tar.xz
84278f084b16d24ef369df3ee46ece2307720567cd7f87015496c9d9cf7d1f8d  debian-9.2-minimal-armhf-2017-10-07.tar.xz
{code}

Extract:

...

:=}
Code Block
title
~/
tar xf debian-9.2-minimal-armhf-2017-10-07.tar.xz
{code}
h4. Ubuntu 

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-10-07.tar.xz
{code}

Verify:

...

:=}
Code Block
title
~/
sha256sum ubuntu-16.04.3-minimal-armhf-2017-10-07.tar.xz
7f4e7a0ebf280fc442e91b1b4de83e85c7dd656a5b8ec6ee16f23df44d3c697d  ubuntu-16.04.3-minimal-armhf-2017-10-07.tar.xz
{code}

Extract:

...

:=}
Code Block
title
~/
tar xf ubuntu-16.04.3-minimal-armhf-2017-10-07.tar.xz
{code}
 
h1. Setup microSD card
*For these instruction we are assuming, 

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
{code}

Erase

...

partition

...

table/labels

...

on

...

microSD

...

card:

...

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

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
{code}

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}
{code:title=sfdisk 
}
Code Block
titlesfdisk >=
2.26.x
sudo sfdisk ${DISK} <<-__EOF__
4M,,L,*
__EOF__
{code}
{code:title=sfdisk 
}
Code Block
titlesfdisk <=
2.25.x
sudo sfdisk --unit M ${DISK} <<-__EOF__
4,,L,*
__EOF__
{code}

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}
 
{code:title=
}
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}
{code:title=
}
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
{code}

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/
{code}
 
h3. Backup Bootloader
This version of 

Backup Bootloader

This version of MLO/u-boot.img

...

will

...

be

...

used

...

on

...

the

...

"eMMC"

...

flasher

...

script

...

on

...

this

...

page.

...

:=}
Code Block
title
~/
sudo mkdir -p /media/rootfs/opt/backup/uboot/
sudo cp -v ./u-boot/MLO /media/rootfs/opt/backup/uboot/
sudo cp -v ./u-boot/u-boot.img /media/rootfs/opt/backup/uboot/
{code}
 
h3. Dealing with old Bootloader in eMMC
If you 

Dealing with old Bootloader in eMMC

If you don't

...

want

...

to

...

clear

...

out

...

the

...

old

...

Bootloader

...

in

...

eMMC

...

add

...

this

...

uEnv.txt

...

to

...

/media/rootfs/

...

:=}
Code Block
title
~/uEnv.txt
##This will work with: Angstrom's 2013.06.20 u-boot.
 
loadaddr=0x82000000
fdtaddr=0x88000000
rdaddr=0x88080000
 
initrd_high=0xffffffff
fdt_high=0xffffffff
 
#for single partitions:
mmcroot=/dev/mmcblk0p1
 
loadximage=load mmc 0:1 ${loadaddr} /boot/vmlinuz-${uname_r}
loadxfdt=load mmc 0:1 ${fdtaddr} /boot/dtbs/${uname_r}/${fdtfile}
loadxrd=load mmc 0:1 ${rdaddr} /boot/initrd.img-${uname_r}; setenv rdsize ${filesize}
loaduEnvtxt=load mmc 0:1 ${loadaddr} /boot/uEnv.txt ; env import -t ${loadaddr} ${filesize};
loadall=run loaduEnvtxt; run loadximage; run loadxfdt;
 
mmcargs=setenv bootargs console=tty0 console=${console} ${optargs} ${cape_disable} ${cape_enable} root=${mmcroot} rootfstype=${mmcrootfstype} ${cmdline}
 
uenvcmd=run loadall; run mmcargs; bootz ${loadaddr} - ${fdtaddr};
{code}
 
{code:title=~/}
Code Block
title~/
sudo cp -v ./uEnv.txt /media/rootfs/
{code}
 
h1. 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}

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]
-----------------------------
{code}

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
{code}
h3. Copy Root File System
{code:title=~/}

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/
{code}
h3. Set 

Set uname_r

...

in

...

/boot/uEnv.txt

...

:=}
Code Block
title
~/
sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"
{code}
h3. Copy Kernel Image
Kernel Image:
{code:title=~/}

Copy Kernel Image

Kernel Image:

Code Block
title~/
sudo cp -v ./bb-kernel/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}
{code}
h3. Copy Kernel Device Tree Binaries
{code:title=~/}

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}/
{code}
h3. Copy Kernel Modules
{code:title=~/}

Copy Kernel Modules

Code Block
title~/
sudo tar xfv ./bb-kernel/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/
{code}
 
h3. File Systems Table 

File Systems Table (/etc/fstab)

...

}
Code Block
sudo sh -c "echo '/dev/mmcblk0p1  /  auto  errors=remount-ro  0  1' >> /media/rootfs/etc/fstab"
{code}
 
h3. Networking

Networking

Edit:

...

/etc/network/interfaces

...

}
Code Block
sudo nano /media/rootfs/etc/network/interfaces
{code}

Add:

...

:=}
Code Block
title
/etc/network/interfaces
auto lo
iface lo inet loopback
 
auto eth0
iface eth0 inet dhcp
{code}
 
h3. 

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
{code}

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"
{code}
 
h3. Remove 

Remove microSD/SD

...

card

...

}
Code Block
sync
sudo umount /media/rootfs
{code}
 
h3. usb gadget
Provides http access to beaglebone black over usb.
Install udhcpd
{code}

usb gadget

Provides http access to beaglebone black over usb.
Install udhcpd

Code Block
sudo apt-get install udhcpd
{code}
 

Edit:

...

/etc/network/interfaces

...

and

...

add:

...

:=}
Code Block
title
/etc/network/interfaces
# Ethernet/RNDIS gadget (g_ether)
# ... or on host side, usbnet and random hwaddr
iface usb0 inet static
        address 192.168.7.2
        netmask 255.255.255.252
        network 192.168.7.0
        gateway 192.168.7.1
{code}
 
Temp 

Temp Script:

...

}
Code Block
wget -c https://raw.github.com/RobertCNelson/tools/master/scripts/beaglebone-black-g-ether-load.sh
chmod +x beaglebone-black-g-ether-load.sh
sudo ./beaglebone-black-g-ether-load.sh
{code}
 
h3. HDMI
This sections assumes you have already installed your favorite xorg based window manager, such as lxde, xfce, kde, gnome, 

HDMI

This sections assumes you have already installed your favorite xorg based window manager, such as lxde, xfce, kde, gnome, etc...

...

These

...

are

...

packages

...

that

...

need

...

to

...

be

...

installed

...

on

...

top

...

of

...

your

...

selected

...

windows

...

manager

...

and

...

an

...

xorg.conf

...

needed

...

to

...

correctly

...

setup

...

the

...

video

...

interface.

...


Note:

...

If

...

the

...

cursor

...

doesn\'t

...

show

...

up

...

right

...

away,

...

first

...

hit:

...

ctlr-alt-f1

...

then:

...

ctrl-alt-f7

...

after

...

which

...

it

...

\'should\'

...

show

...

up...

...


Make

...

sure

...

to

...

install,

...

fbdev

...

driver

...

and

...

xrandr

...

utilities:

...

}
Code Block
sudo apt-get update
sudo apt-get install read-edid xserver-xorg-video-fbdev x11-xserver-utils
{code}
 
{code:title=
}
Code Block
title/etc/X11/xorg.conf
Section "Monitor"
        Identifier      "Builtin Default Monitor"
EndSection
Section "Device"
        Identifier      "Builtin Default fbdev Device 0"
        Driver          "fbdev"
EndSection
Section "Screen"
        Identifier      "Builtin Default fbdev Screen 0"
        Device          "Builtin Default fbdev Device 0"
        Monitor         "Builtin Default Monitor"
EndSection
Section "ServerLayout"
        Identifier      "Builtin Default Layout"
        Screen          "Builtin Default fbdev Screen 0"
EndSection
{code}
 

xrandr:

...

}
Code Block
xrandr
xrandr --output HDMI-0 --mode 1024x768 --rate 60
{code}
 
xrandr \

xrandr (over

...

serial/ssh

...

)

...

}
Code Block
xrandr -display :0.0 -q
xrandr -display :0.0 --output HDMI-0 --mode 1024x768 --rate 60
{code}
 
h3. eMMC
Script to copy your microSD card to eMMC: (this will need these packages installed: initramfs-tools dosfstools rsync)
{code}

eMMC

Script to copy your microSD card to eMMC: (this will need these packages installed: initramfs-tools dosfstools rsync)

Code Block
wget https://raw.githubusercontent.com/RobertCNelson/boot-scripts/master/tools/eMMC/bbb-eMMC-flasher-eewiki-ext4.sh
chmod +x bbb-eMMC-flasher-eewiki-ext4.sh
sudo /bin/bash ./bbb-eMMC-flasher-eewiki-ext4.sh
{code}
 
h3. SGX
Build SGX 

SGX

Build SGX modules/userspace

...

(must

...

be

...

done

...

on

...

an

...

x86,

...

due

...

to

...

the

...

TI

...

5.01.01.02

...

blob

...

extractor)

...

:=}
Code Block
title
~/bb-kernel/
./sgx_build_modules.sh
{code}

Copy

...

./deploy/GFX_5.01.01.02.tar.gz

...

to

...

BeagleBone/BeagleBone

...

Black

...

and

...

install

...

}
Code Block
sudo tar xfv GFX_5.01.01.02.tar.gz -C /
cd /opt/gfxinstall/
sudo ./sgx-install.sh
sudo reboot
{code}

Verify

...

omaplfb

...

&

...

pvrsrvkm

...

loaded

...

}
Code Block
debian@arm:~$ lsmod | grep omaplfb
omaplfb                12065  0 
pvrsrvkm              178782  1 omaplfb
{code}
 
h3. 

capemgr:

...

v4.4.x+

...

Full

...

Documentation:

...

readme
Download:

Code Block
title~/
git clone https://github.com/beagleboard/bb.org-overlays
cd ./bb.org-overlays/
{code}

Install

...

*.dtbo:

...

:=}
Code Block
title
~/bb.org-overlays/
./install.sh
{code}

BBB

...

compatibility

...

issues:

...

:=}
Code Block
title
/boot/uEnv.txt
dtb=am335x-boneblack-overlay.dtb
{code}

capemgr:

...

enable/disable

...

capes

...

on

...

kernel

...

cmdline:

...

}
Code Block
Comma delimited list of PART-NUMBER[:REV] of [enabled/disabled] capes
{code}
{code:title=
}
Code Block
title/boot/uEnv.txt
cape_disable=bone_capemgr.disable_partno=
cape_enable=bone_capemgr.enable_partno=
{code}

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---
{code}
 
h1. Comments

Comments

Comments,

...

feedback,

...

and

...

questions

...

can

...

be

...

sent

...

to:

...

eewiki@digikey.com

...


Please use the Digi-Key's

...

TechForum:

...

TechForum

...