Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Wiki Markup
This is a page about TI's Cortex-A8 based; BeagleBoard.

...

Table of Contents
indent20px
styledisc

Basic Requirements

...


{hide-comments}
{toc:indent=20px|style=disc}
 
h1. Availability
Boards:
[BeagleBoard xM|https://www.digikey.com/product-search/en?keywords=1777-1000-ND] at Digi-Key
 
h1. 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: [http://

...

www.linaro.org/

...

downloads/]
* Bootloader
** Das U-Boot

...

 -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot

...

]
** Source: [http://git.

...

denx.

...

de/?p=

...

u-boot.git;a=summary

...

]
* Linux Kernel
** Linus's Mainline tree: [https://git.kernel.org/

...

cgit/linux/kernel/git/

...

torvalds/linux

...

.

...

git]
* ARM based rootfs
** Debian: [https://www.debian.org

...

X-Loader

X-Loader Download:

Code Block
git clone git://gitorious.org/x-loader/x-loader.git

X-Loader Configure and Build:

Code Block
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- omap3530beagle_config
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- ift

Bootloader

...

]
** Ubuntu: [http://www.ubuntu.com]
 
h1. 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:title=~/}
wget -c https://releases.linaro.org/components/toolchain/binaries/6.4-2018.05/arm-linux-gnueabihf/gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-6.4.1-2018.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-
{code}
Test Cross Compiler:
{code:title=~/}
${CC}gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 6.4-2018.05) 6.4.1 20180425 [linaro-6.4-2018.05 revision 7b15d0869c096fe39603ad63dc19ab7cf035eb70]
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

...

U-Boot Download:

Download U-Boot Tarball:

Code Block
wget ftp]
eewiki.net patch archive: [https://ftpgithub.denx.decom/pubeewiki/u-boot/u-boot-2011.06.tar.bz2
tar xjf u-boot-2011.06.tar.bz2-patches]
Download:
{code:title=~/}
git clone https://github.com/u-boot/u-boot
cd u-boot-2011.06/

Or via git:

Code Block
git clone git://git.denx.de/u-boot.git
cd u-boot/
git checkout v2011.06 -b tmp

U-Boot Configure and Build:

Code Block
/
git checkout v2018.09-rc2 -b tmp
{code}
Patches:
{code:title=~/u-boot}
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2018.09-rc2/0001-omap3_beagle-uEnv.txt-bootz-n-fixes.patch
 
patch -p1 < 0001-omap3_beagle-uEnv.txt-bootz-n-fixes.patch
{code}
Configure and Build:
{code:title=~/u-boot}
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- ${CC} distclean
make ARCH=arm CROSS_COMPILE=${CC} omap3_beagle_configdefconfig
make ARCH=arm CROSS_COMPILE=${CC}
{code}
 
h1. Linux Kernel
 
Spectre: [https://meltdownattack.com] and [https://developer.arm-linux-gnueabi- 

Linux Kernel

Linux Build Script:

Code Block
git.com/support/arm-security-updates/speculative-processor-vulnerability]
Spectre v2 Migation requires minimal: U-Boot: v2018.07 and Kernel: v4.18.x
{code}
[    0.047363] CPU0: Spectre v2: using BPIALL workaround
{code}
This script will build the kernel, modules, device tree binaries and copy them to the deploy directory.
Download:
{code:title=~/}
git clone https://github.com/RobertCNelson/stable-kernel.git
cd stable-kernel/

Run Build Script:

Code Block
armv7-multiplatform
cd armv7-multiplatform/
{code}
For v4.9.x (Longterm 4.9.x):
{code:title=~/armv7-multiplatform/}
git checkout origin/v4.9.x -b tmp
{code}
For v4.9.x-rt (Longterm 4.9.x + Real-Time Linux):
{code:title=~/armv7-multiplatform/}
git checkout origin/v4.9.x-rt -b tmp
{code}
For v4.14.x (Longterm 4.14.x):
{code:title=~/armv7-multiplatform/}
git checkout origin/v4.14.x -b tmp
{code}
For v4.14.x-rt (Longterm 4.14.x + Real-Time Linux):
{code:title=~/armv7-multiplatform/}
git checkout origin/v4.14.x-rt -b tmp
{code}
For v4.18.x (Stable):
{code:title=~/armv7-multiplatform/}
git checkout origin/v4.18.x -b tmp
{code}
Build:
{code:title=~/armv7-multiplatform/}
./build_kernel.sh

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

Root File System

Code Block

{code}
 
h1. Root File System
h4. Debian 9
|| User || Password ||
| debian | temppwd |
| root | root |
Download:
{code:title=~/}
wget -c httphttps://rcn-ee.netcom/deb/rootfs/squeezeeewiki/squeeze-minfs/debian-9.5-minimal-armelarmhf-20112018-07-1830.tar.xz

verify the image with:

Code Block
md5sum squeeze-minimal-armel-2011-07-18.tar.xz
6354943d33059f36ee902204b825f50d  squeeze-minimal-armel-2011-07-18.tar.xz

Extract Image:

Code Block
tar xJf squeeze-minimal-armel-2011-07-18.tar.xz

Setup microSD card

Erase microSD card: (assuming: /dev/mmcblk0, "sudo fdisk -l" is useful for determining the device id)

Code Block
sudo parted --script /dev/mmcblk0 mklabel msdos

Setup Boot Partition:

fdisk 2.17.x

Code Block

sudo fdisk ${FDISK_DOS} /dev/mmcblk0 << END
n
p
1
1
+64M
t
e
p
w
END

fdisk 2.18.x ->2.19.x

Code Block

sudo fdisk -c=dos -u=cylinders /dev/mmcblk0 << END
n
p
1
1
+64M
t
e
p
w
END

Set Boot Flag
sudo parted --script /dev/mmcblk0 set 1 boot on

Format as fat
sudo mkfs.vfat -F 16 /dev/mmcblk0p1 -n boot

Create Partition Layout:
rootfs: ext3/4, rest of microSD card.

Mount the boot/rootfs partitions

Copy Boot Files:

Copy MLO to the boot partition

Code Block
sudo cp ./MLO /media/boot/MLO

Copy u-boot.bin to the boot partition

Code Block
sudo cp ./u-boot.bin /media/boot/u-boot.bin

Copy U-Boot BootScript:

boot.cmd

Code Block

setenv bootcmd 'fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
setenv bootargs console=ttyO2,115200n8 console=tty0 root=/dev/mmcblk0p2 rootwait ro rootfstype=ext4 omapfb.mode=dvi:1280x720MR-16@60
boot

Run mkimage on boot.cmd to be useable by U-Boot:

Code Block
mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Linux" -d ./boot.cmd ./boot.scr

Copy boot.scr to the boot partition

Code Block
sudo cp ./boot.scr /media/boot/

Copy Kernel uImage:

Code Block
sudo cp ./*.uImage /media/boot/uImage

Copy Root File System:

Code Block
sudo tar xfvp armel-rootfs-201107180925.tar -C /media/rootfs/

Copy Kernel modules:

Code Block
sudo tar xfv *-
{code}
Verify:
{code:title=~/}
sha256sum debian-9.5-minimal-armhf-2018-07-30.tar.xz
9399d649d1ce9910bbfc745f59dc57ee0e1134f57e8cae01c8cd75a8bd9d1e1e  debian-9.5-minimal-armhf-2018-07-30.tar.xz
{code}
Extract:
{code:title=~/}
tar xf debian-9.5-minimal-armhf-2018-07-30.tar.xz
{code}
h4. Ubuntu 18.04 LTS
|| User || Password ||
| ubuntu | temppwd |
Download:
{code:title=~/}
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/ubuntu-18.04.1-minimal-armhf-2018-07-30.tar.xz
{code}
Verify:
{code:title=~/}
sha256sum ubuntu-18.04.1-minimal-armhf-2018-07-30.tar.xz
6b212ee7dd0d5c9c0af49c22cf78b63e6ad20cec641c303232fca9f21a18804c  ubuntu-18.04.1-minimal-armhf-2018-07-30.tar.xz
{code}
Extract:
{code:title=~/}
tar xf ubuntu-18.04.1-minimal-armhf-2018-07-30.tar.xz
{code}
 
h1. Setup microSD card
*For these instruction we are assuming, DISK=/dev/mmcblk0, lsblk is very useful for determining the device id.*
{code}
export DISK=/dev/mmcblk0
{code}
Erase partition table/labels on microSD card:
{code}
sudo dd if=/dev/zero of=${DISK} bs=1M count=20
{code}
Create Partition Layout:
*With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.*
{code}
sudo sfdisk --version
sfdisk from util-linux 2.27.1
{code}
{code:title=sfdisk >= 2.26.x}
sudo sfdisk ${DISK} <<-__EOF__
1M,12M,0xE,*
13M,,,-
__EOF__
{code}
{code:title=sfdisk <= 2.25.x}
sudo sfdisk --unit M ${DISK} <<-__EOF__
1,12,0xE,*
13,,,-
__EOF__
{code}
Format Partition:
{code}
for: DISK=/dev/mmcblk0
sudo mkfs.vfat -F 16 -n BOOT ${DISK}p1
sudo mkfs.ext4 -L rootfs ${DISK}p2
 
for: DISK=/dev/sdX
sudo mkfs.vfat -F 16 -n BOOT ${DISK}1
sudo mkfs.ext4 -L rootfs ${DISK}2
{code}
Mount Partition:
*On most systems these partitions may will be auto-mounted...*
{code}
sudo mkdir -p /media/boot/
sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
sudo mount ${DISK}p1 /media/boot/
sudo mount ${DISK}p2 /media/rootfs/
 
for: DISK=/dev/sdX
sudo mount ${DISK}1 /media/boot/
sudo mount ${DISK}2 /media/rootfs/
{code}
 
h1. Install Bootloader
Copy MLO/u-boot.img to the boot partition
{code:title=~/}
sudo cp -v ./u-boot/MLO /media/boot/
sudo cp -v ./u-boot/u-boot.img /media/boot/
{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}
-----------------------------
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}
export kernel_version=4.X.Y-Z
{code}
h3. Copy Root File System
{code: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 uname_r in /boot/uEnv.txt
{code:title=~/}
sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"
{code}
h3. Copy Kernel Image
Kernel Image:
{code:title=~/}
sudo cp -v ./armv7-multiplatform/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}
{code}
h3. Copy Kernel Device Tree Binaries
{code:title=~/}
sudo mkdir -p /media/rootfs/boot/dtbs/${kernel_version}/
sudo tar xfv ./armv7-multiplatform/deploy/${kernel_version}-dtbs.tar.gz -C /media/rootfs/boot/dtbs/${kernel_version}/
{code}
h3. Copy Kernel Modules
{code:title=~/}
sudo tar xfv ./armv7-multiplatform/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/

...


{code}
 
h3. File Systems Table (/etc/fstab

...

Code Block
)
{code}
sudo nano /media/rootfs/etc/fstab
add: sh -c "echo '/dev/mmcblk0p2  / ext4 auto  errors=remount-ro  0 1

Add Serial Login:

Code Block
sudo nano 1' >> /media/rootfs/etc/inittab

edit last line:

Code Block
from: S:2345:respawn:/sbin/getty 115200
to: S:2345:respawn:/sbin/getty 115200 ttyO2

Remove microSD card:

Code Block
fstab"
sudo sh -c "echo '/dev/mmcblk0p1  /boot/uboot  auto  defaults  0  2' >> /media/rootfs/etc/fstab"
{code}
 
h3. Remove microSD/SD card
{code}
sync
sudo umount /devmedia/mmcblk0p2boot
sudo umount /devmedia/mmcblk0p1

First Boot:

...

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