Beagleboard:BeagleBoneBlack Debian

This page is about running the armhf port of Debian distribution at BeagleBoard. The latest beagleboard.org image can be found at: http://beagleboard.org/latest-images

= Checking The Debian Image Version =

You should check the version of the image on the microSD/eMMC by opening the ID.txt file in the FAT partition.

root@beaglebone:~# cat /etc/dogtag BeagleBoard.org BeagleBone Debian Image 2014-03-19

This file can also be accessed via a PC (Windows/Mac/Linux) via either mounting the FAT partition directly off the microSD card or via the usb interface (flash drive).

= Installing =

Oracle Java 8
Information: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-arm-downloads-2187472.html

debian repo: https://github.com/rcn-ee/repos/tree/master/oracle-java8-installer

Install: sudo apt-get update sudo apt-get install oracle-java8-installer

Verify: debian@beaglebone:~$ java -version java version "1.8.0_33" Java(TM) SE Runtime Environment (build 1.8.0_33-b05) Java HotSpot(TM) Client VM (build 25.33-b05, mixed mode)

Older rootfs (when above package doesn't exist): wget https://repos.rcn-ee.net/debian/pool/main/o/oracle-java8-installer/oracle-java8-installer_8u31%2b8u33arm-1~bpo70%2b20150121%2b1_all.deb sudo dpkg -i oracle-java8-installer_8u31%2b8u33arm-1~bpo70%2b20150121%2b1_all.deb

TI PRU Code Generation Tools
http://software-dl.ti.com/codegen/non-esd/downloads/download.htm#PRU

Install: sudo apt-get update sudo apt-get install ti-pru-cgt-installer

Older rootfs (when above package doesn't exist): wget http://downloads.ti.com/codegen/esd/cgt_public_sw/PRU/2.1.0/ti_cgt_pru_2.1.0_armlinuxa8hf_busybox_installer.sh chmod +x ti_cgt_pru_2.1.0_armlinuxa8hf_busybox_installer.sh sudo ./ti_cgt_pru_2.1.0_armlinuxa8hf_busybox_installer.sh

= FAQ =

Expanding File System Partition On A microSD
By default the microSD image is only about 2GB in size, to fully expand the partition to the full size of your microSD card simple run.

cd /opt/scripts/tools/ git pull sudo ./grow_partition.sh sudo reboot

On the next reboot, [df -h] should show the full microSD card size.

Flashing eMMC
To setup the standalone microSD image to automatically flash the eMMC on powerup.

In /boot/uEnv.txt:
 * 1) enable BBB: eMMC Flasher:
 * 2) cmdline=init=/opt/scripts/tools/eMMC/init-eMMC-flasher-v3.sh

Change to: cmdline=init=/opt/scripts/tools/eMMC/init-eMMC-flasher-v3.sh
 * 1) enable BBB: eMMC Flasher:

and reboot the system, it'll flash the eMMC on the next bootup. (make sure to remove the microSD after flashing is complete)

Kernel Upgrade
We can't ship support for everything on release day, so we push out new kernels as fixes, support for new capes, etc are posted on the beagleboard.org mainline list.

cd /opt/scripts/tools/ git pull sudo ./update_kernel.sh sudo reboot

Loading custom capes
Due to limitations in debian wheezy's userspace, the use of an initramfs, and having firmware builtin to the kernel. It is currently not possible to load "custom" capes via: capemgr.enable_partno=xyz. Instead an init script has been setup to load the cape/capes as soon as possible.

Built-in Cape: capemgr.enable_partno=BB-SPIDEV1 slot #7: Requesting part number/version based 'BB-SPIDEV1-00A0.dtbo slot #7: Requesting firmware 'BB-SPIDEV1-00A0.dtbo' for board-name 'Override Board Name', version '00A0' slot #7: dtbo 'BB-SPIDEV1-00A0.dtbo' loaded; converting to live tree

Custom External Cape: capemgr.enable_partno=BB-SPI1-01 slot #7: Requesting part number/version based 'BB-SPI1-01-00A0.dtbo slot #7: Requesting firmware 'BB-SPI1-01-00A0.dtbo' for board-name 'Override Board Name', version '00A0' failed to load firmware 'BB-SPI1-01-00A0.dtbo' loader: failed to load slot-7 BB-SPI1-01:00A0 (prio 0)

Workaround: add "CAPE=BB-SPI1-01" to /etc/default/capemgr

Privileged echo
As a normal user, you can not "sudo echo 'something' >> /etc/privilegedfile"

sudo sh -c "echo 'something' >> /etc/privilegedfile"

Timezone
By default this image is setup to display time in utc mode. If you would like to change this to your local region.

dpkg-reconfigure tzdata

or: echo "Europe/Zurich" > /etc/timezone dpkg-reconfigure -f noninteractive tzdata

Jessie Timezone
List of available timezones: timedatectl list-timezones

Set timezone: sudo timedatectl set-timezone America/North_Dakota/Center

W: GPG error: http://debian.beagleboard.org wheezy-bbb
W: GPG error: http://debian.beagleboard.org wheezy-bbb Release: The following signatures were invalid: KEYEXPIRED 1418840246 KEYEXPIRED 1418840304 KEYEXPIRED 1418840246 KEYEXPIRED 1418840246 KEYEXPIRED 1418840304

Note this directions are version dependent, so double check your version:

debian@beaglebone:~$ cat /etc/dogtag BeagleBoard.org BeagleBone Debian Image 2014-05-14

2014-05-14 GPG error: Disable: http://debian.beagleboard.org repo:
sudo nano /etc/apt/sources.list

Change: deb [arch=armhf] http://debian.beagleboard.org/packages wheezy-bbb main
 * 1) deb-src [arch=armhf] http://debian.beagleboard.org/packages wheezy-bbb main

To:
 * 1) deb [arch=armhf] http://debian.beagleboard.org/packages wheezy-bbb main
 * 2) deb-src [arch=armhf] http://debian.beagleboard.org/packages wheezy-bbb main

sudo apt-get update

2014-05-14 GPG error: Optional enable: http://repos.rcn-ee.net/
Download archive-keyring: wget https://repos.rcn-ee.net/debian/pool/main/r/rcn-ee-archive-keyring/rcn-ee-archive-keyring_2015.01.28~bpo70%2b20150213%2b1_all.deb sudo dpkg -i rcn-ee-archive-keyring_2015.01.28~bpo70%2b20150213%2b1_all.deb

Add repo to /etc/apt/sources.list sudo sh -c "echo 'deb [arch=armhf] http://repos.rcn-ee.net/debian wheezy main' >> /etc/apt/sources.list" sudo sh -c "echo '#deb-src [arch=armhf] http://repos.rcn-ee.net/debian wheezy main' >> /etc/apt/sources.list"

Update packages: sudo apt-get update sudo apt-get upgrade sudo apt-get install npm --reinstall

= Debian Build Instructions =

You'll want a fairly beefy ARM system to run this script.

git clone git://github.com/beagleboard/image-builder.git cd image-builder ./beagleboard.org_image.sh

= Debian Releases = http://beagleboard.org/latest-images

= Debian Image Testing Snapshots =

2015-03-01 Release Notes
* U-Boot: v2015.01 ** U-Boot UMS (USB Mass Storage) enabled [ums 0 mmc 1] * Kernel: 3.8.13-bone70

Simpler Kernel Upgrades: sudo apt-get install linux-image-3.8.13-bone70 ; sudo reboot

Kernel Headers included: sudo apt-get install linux-headers-3.8.13-bone70

3rd party module list: sudo apt-get install mt7601u-modules-3.8.13-bone70

3rd party repo added: https://github.com/rcn-ee/repos am335x-pru-package ap-hotspot dart-1.8 (stable 1.8 branch) dart-edge (git master branch) oracle-java8-installer ti-pru-cgt-installer xenomai-runtime cloud9-installer

BBB Rev C (4GB eMMC)
Flasher: (lxde-4gb) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxde-4gb/BBB-eMMC-flasher-debian-7.8-lxde-4gb-armhf-2015-03-01-4gb.img.xz md5sum: 38bedfc81de00907ff2913b04bdc6fe9

BBB (All Revs) eMMC Flashers
Flasher: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxde/BBB-eMMC-flasher-debian-7.8-lxde-armhf-2015-03-01-2gb.img.xz md5sum: 66b613cbbde282520f940a12ecf7f6a8

Flasher: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/console/BBB-eMMC-flasher-debian-7.8-console-armhf-2015-03-01-2gb.img.xz md5sum: 81585efeaf183106d6dcc6d39127e190

BBW/BBB (All Revs)
microSD/Standalone: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxde-4gb/bone-debian-7.8-lxde-4gb-armhf-2015-03-01-4gb.img.xz md5sum: c848627722b7a5f7bc89791cc8949e3b

microSD/Standalone: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/console/bone-debian-7.8-console-armhf-2015-03-01-2gb.img.xz md5sum: 10823cb21e6fc4536ff87605dc50ea6e

BBW/BBB (All Revs) Machinekit
microSD/Standalone: (machinekit) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/machinekit/bone-debian-7.8-machinekit-armhf-2015-03-01-4gb.img.xz md5sum: f25ab3adce76c9d4e694ed421634d694

Jessie Snapshot
Flasher: (lxqt-4gb) (BeagleBone Black 4GB eMMC) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxqt-4gb/BBB-eMMC-flasher-debian-jessie-lxqt-4gb-armhf-2015-03-01-4gb.img.xz md5sum: 7e5071e2c23d8ec97252d9fb9216772a

microSD/Standalone: (lxqt-4gb) (BeagleBone/BeagleBone Black) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxqt-4gb/bone-debian-jessie-lxqt-4gb-armhf-2015-03-01-4gb.img.xz md5sum: b6da90c92486a55415d7fc411b7976e9

microSD/Standalone: (lxqt-4gb) (BeagleBoard-X15) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxqt-4gb/bbx15-debian-jessie-lxqt-4gb-armhf-2015-03-01-4gb.img.xz md5sum: f70d025555666507b6575b851a1af722

microSD/Standalone: (lxqt-4gb) (omap5-uevm) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-03-01/lxqt-4gb/omap5-uevm-debian-jessie-lxqt-4gb-armhf-2015-03-01-4gb.img.xz md5sum: ebf768cf91132c6f47c8b21151849958

2015-02-22 Release Notes
* U-Boot: v2015.01 ** U-Boot UMS (USB Mass Storage) enabled [ums 0 mmc 1] * Kernel: 3.8.13-bone70

Simpler Kernel Upgrades: sudo apt-get install linux-image-3.8.13-bone70 ; sudo reboot

Kernel Headers included: sudo apt-get install linux-headers-3.8.13-bone70

3rd party module list: sudo apt-get install mt7601u-modules-3.8.13-bone70

3rd party repo added: https://github.com/rcn-ee/repos am335x-pru-package ap-hotspot dart-1.8 (stable 1.8 branch) dart-edge (git master branch) oracle-java8-installer ti-pru-cgt-installer xenomai-runtime cloud9-installer

BBB Rev C (4GB eMMC)
Flasher: (lxde-4gb) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxde-4gb/BBB-eMMC-flasher-debian-7.8-lxde-4gb-armhf-2015-02-22-4gb.img.xz md5sum: e674c063f1510692eccf969070717cce

BBB (All Revs) eMMC Flashers
Flasher: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxde/BBB-eMMC-flasher-debian-7.8-lxde-armhf-2015-02-22-2gb.img.xz md5sum: e110f5ad90e078768fd5d8c89b7ff564

Flasher: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/console/BBB-eMMC-flasher-debian-7.8-console-armhf-2015-02-22-2gb.img.xz md5sum: 8837296f7b05d8f741192f36639a8d6a

BBW/BBB (All Revs)
microSD/Standalone: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxde-4gb/bone-debian-7.8-lxde-4gb-armhf-2015-02-22-4gb.img.xz md5sum: 40a44137c2ba63f58255818042165de9

microSD/Standalone: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/console/bone-debian-7.8-console-armhf-2015-02-22-2gb.img.xz md5sum: 5c2e5a8b51a42574c175f650059e628f

BBW/BBB (All Revs) Machinekit
microSD/Standalone: (machinekit) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/machinekit/bone-debian-7.8-machinekit-armhf-2015-02-22-4gb.img.xz md5sum: 91f21687c063013946b792e7f5364564

Jessie Snapshot
Flasher: (lxqt-4gb) (BeagleBone Black 4GB eMMC) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxqt-4gb/BBB-eMMC-flasher-debian-jessie-lxqt-4gb-armhf-2015-02-22-4gb.img.xz md5sum: 9fc74a0402056b7f0a6636449b403e3a

microSD/Standalone: (lxqt-4gb) (BeagleBone/BeagleBone Black) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxqt-4gb/bone-debian-jessie-lxqt-4gb-armhf-2015-02-22-4gb.img.xz md5sum: cff7ebe827f739777031d2d995227bea

microSD/Standalone: (lxqt-4gb) (BeagleBoard-X15) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxqt-4gb/bbx15-debian-jessie-lxqt-4gb-armhf-2015-02-22-4gb.img.xz md5sum: 64b206e4e53d268add7cb23e5fa29596

microSD/Standalone: (lxqt-4gb) (omap5-uevm) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-22/lxqt-4gb/omap5-uevm-debian-jessie-lxqt-4gb-armhf-2015-02-22-4gb.img.xz md5sum: 1be55b613054d66d51bdcdac63675268

2015-02-15 Release Notes
* U-Boot: v2015.01 ** U-Boot UMS (USB Mass Storage) enabled [ums 0 mmc 1] * Kernel: 3.8.13-bone70

Simpler Kernel Upgrades: sudo apt-get install linux-image-3.8.13-bone70 ; sudo reboot

Kernel Headers included: sudo apt-get install linux-headers-3.8.13-bone70

3rd party module list: sudo apt-get install mt7601u-modules-3.8.13-bone70

3rd party repo added: https://github.com/rcn-ee/repos am335x-pru-package ap-hotspot dart-1.8 (stable 1.8 branch) dart-edge (git master branch) oracle-java8-installer ti-pru-cgt-installer xenomai-runtime cloud9-installer

BBB Rev C (4GB eMMC)
Flasher: (lxde-4gb) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxde-4gb/BBB-eMMC-flasher-debian-7.8-lxde-4gb-armhf-2015-02-15-4gb.img.xz md5sum: 7e4d96e08226d1e5a0abf11d0a6458a2

BBB (All Revs) eMMC Flashers
Flasher: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxde/BBB-eMMC-flasher-debian-7.8-lxde-armhf-2015-02-15-2gb.img.xz md5sum: 85e208127dc73f49843a7e7ddaedf154

Flasher: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/console/BBB-eMMC-flasher-debian-7.8-console-armhf-2015-02-15-2gb.img.xz md5sum: 5bf68216850ff73d23998cf8d6c14ced

BBW/BBB (All Revs)
microSD/Standalone: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxde-4gb/bone-debian-7.8-lxde-4gb-armhf-2015-02-15-4gb.img.xz md5sum: 7653ddbbc7575005c3fa920fdfb1f497

microSD/Standalone: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/console/bone-debian-7.8-console-armhf-2015-02-15-2gb.img.xz md5sum: c78f7f377c6aeddc5f7d7fa20bc0102b

BBW/BBB (All Revs) Machinekit
microSD/Standalone: (machinekit) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/machinekit/bone-debian-7.8-machinekit-armhf-2015-02-15-4gb.img.xz md5sum: 79ca23e60fc31602ee974cf585855ea1

Jessie Snapshot
Flasher: (lxqt-4gb) (BeagleBone Black 4GB eMMC) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxqt-4gb/BBB-eMMC-flasher-debian-jessie-lxqt-4gb-armhf-2015-02-15-4gb.img.xz md5sum: a8e8cb156e71c2d128a432f391235320

microSD/Standalone: (lxqt-4gb) (BeagleBone/BeagleBone Black) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxqt-4gb/bone-debian-jessie-lxqt-4gb-armhf-2015-02-15-4gb.img.xz md5sum: 5ab6aeae7e9c399403c7216b8f4781c6

microSD/Standalone: (lxqt-4gb) (BeagleBoard-X15) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxqt-4gb/bbx15-debian-jessie-lxqt-4gb-armhf-2015-02-15-4gb.img.xz md5sum: 4d4ba5ce3b13512e000c7003727600e9

microSD/Standalone: (lxqt-4gb) (omap5-uevm) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-15/lxqt-4gb/omap5-uevm-debian-jessie-lxqt-4gb-armhf-2015-02-15-4gb.img.xz md5sum: 1ebe451ddbac931da32a1cbad1424da8

2015-02-01 Release Notes
* U-Boot: v2015.01 ** U-Boot UMS (USB Mass Storage) enabled [ums 0 mmc 1] * Kernel: 3.8.13-bone70

Simpler Kernel Upgrades: sudo apt-get install linux-image-3.8.13-bone70 ; sudo reboot

Kernel Headers included: sudo apt-get install linux-headers-3.8.13-bone70

3rd party module list: sudo apt-get install mt7601u-modules-3.8.13-bone70

3rd party repo added: https://github.com/rcn-ee/repos am335x-pru-package ap-hotspot dart-1.8 (stable 1.8 branch) dart-edge (git master branch) oracle-java8-installer ti-pru-cgt-installer xenomai-runtime cloud9-installer

BBB Rev C (4GB eMMC)
Flasher: (lxde-4gb) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxde-4gb/BBB-eMMC-flasher-debian-7.8-lxde-4gb-armhf-2015-02-01-4gb.img.xz md5sum: 3f1b3b99b49d05ca0211b37c25351125

BBB (All Revs) eMMC Flashers
Flasher: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxde/BBB-eMMC-flasher-debian-7.8-lxde-armhf-2015-02-01-2gb.img.xz md5sum: baa62258bfd6984c2d73288f1d0c0248

Flasher: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/console/BBB-eMMC-flasher-debian-7.8-console-armhf-2015-02-01-2gb.img.xz md5sum: 3d9a82681c986eeb8dcc0b74ed1c273e

BBW/BBB (All Revs)
microSD/Standalone: (lxde) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxde-4gb/bone-debian-7.8-lxde-4gb-armhf-2015-02-01-4gb.img.xz md5sum: b094b44cfcc84c8ff7c4259e21d8db3b

microSD/Standalone: (console) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/console/bone-debian-7.8-console-armhf-2015-02-01-2gb.img.xz md5sum: c7d09b1ba6753ddb053b5174000dcf33

BBW/BBB (All Revs) Machinekit
microSD/Standalone: (machinekit) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/machinekit/bone-debian-7.8-machinekit-armhf-2015-02-01-4gb.img.xz md5sum: 77a0d7bef5017f7f80b7f1be7896314c

Jessie Snapshot
Flasher: (lxqt-4gb) (BeagleBone Black 4GB eMMC) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxqt-4gb/BBB-eMMC-flasher-debian-jessie-lxqt-4gb-armhf-2015-02-01-4gb.img.xz md5sum: 178b7ec4f0bea92fcdf421e45b96d40d

microSD/Standalone: (lxqt-4gb) (BeagleBone/BeagleBone Black) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxqt-4gb/bone-debian-jessie-lxqt-4gb-armhf-2015-02-01-4gb.img.xz md5sum: 62dbd5467e1e5f39a05ec5ca2db619c7

microSD/Standalone: (lxqt-4gb) (BeagleBoard-X15) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxqt-4gb/bbx15-debian-jessie-lxqt-4gb-armhf-2015-02-01-4gb.img.xz md5sum: b74de3f01960017e31246d7cf0bff16c

microSD/Standalone: (lxqt-4gb) (omap5-uevm) wget https://rcn-ee.net/rootfs/bb.org/testing/2015-02-01/lxqt-4gb/omap5-uevm-debian-jessie-lxqt-4gb-armhf-2015-02-01-4gb.img.xz md5sum: b7da0900309b0d3b2e8bbb279d976b9d

2014-05-14
Flasher: wget https://s3.amazonaws.com/debian.beagleboard.org/images/BBB-eMMC-flasher-debian-7.5-2014-05-14-2gb.img.xz (mirror) https://rcn-ee.net/deb/testing/2014-05-14/BBB-eMMC-flasher-debian-7.5-2014-05-14-2gb.img.xz md5sum BBB-eMMC-flasher-debian-7.5-2014-05-14-2gb.img.xz 74615fb680af8f252c034d3807c9b4ae BBB-eMMC-flasher-debian-7.5-2014-05-14-2gb.img.xz

microSD/Standalone: wget https://s3.amazonaws.com/debian.beagleboard.org/images/bone-debian-7.5-2014-05-14-2gb.img.xz (mirror) https://rcn-ee.net/deb/testing/2014-05-14/bone-debian-7.5-2014-05-14-2gb.img.xz md5sum bone-debian-7.5-2014-05-14-2gb.img.xz 35877ce21e8ed0eb1bdc6819ad71c317 bone-debian-7.5-2014-05-14-2gb.img.xz