Difference between revisions of "BeagleBoardDebian"

From eLinux.org
Jump to: navigation, search
(this is under the previous header..)
 
(170 intermediate revisions by 12 users not shown)
Line 3: Line 3:
 
[[Category:Development Boards]]
 
[[Category:Development Boards]]
 
[[Category: BeagleBoard]]
 
[[Category: BeagleBoard]]
This page is about running a (ARM EABI) [http://www.debian.org/ Debian] distribution at [[BeagleBoard]]. BeagleBoard will boot the (ARM EABI) Debian distribution from [[BeagleBoard#MMC.2FSD_boot|SD card]]. Debian's NetInstall will be used to install Debian onto your Beagle.
+
This page is about running a (ARM EABIhf) [https://www.debian.org/ Debian] distribution at [[BeagleBoard]]. BeagleBoard will boot the (ARM EABIhf) Debian distribution from [[BeagleBoard#MMC.2FSD_boot|SD card]]. Debian's NetInstall will be used to install Debian onto your Beagle.
  
Note: Debian armel deb's are compiled for armv4t, this allows debian to support a larger number of arm devices with a single port, at only the sacrifice of speed.
+
Note: Original Beagleboards work with the Debian Console image booted via holding user button down. Last tested 05/2020. Ref: https://github.com/beagleboard/Latest-Images/issues/48
 
 
*armhf
 
** Port Details: http://wiki.debian.org/ArmHardFloatPort
 
** Status: http://wiki.debian.org/ArmHardFloatTodo
 
  
 
= Help =
 
= Help =
Line 16: Line 12:
  
 
*Kernel related help:
 
*Kernel related help:
** [http://groups.google.com/group/beagleboard Email Beagleboard user group] *Recommended method
+
** [https://groups.google.com/group/beagleboard Email Beagleboard user group] *Recommended method
 
** ''#beagle'': Beagle irc on freenode, accessible also by [http://beagleboard.org/discuss web interface] ([http://www.beagleboard.org/irclogs/index.php logs])
 
** ''#beagle'': Beagle irc on freenode, accessible also by [http://beagleboard.org/discuss web interface] ([http://www.beagleboard.org/irclogs/index.php logs])
** Kernel Tree's
+
** Kernel Trees
*** [https://github.com/RobertCNelson/stable-kernel/tree/v3.7.x Stable (3.7.x) branch]
+
*** [https://github.com/RobertCNelson/armv7-multiplatform/ v5.4.x kernel branch]
 +
*** [https://github.com/RobertCNelson/bb-kernel/ BeagleBone]
 
*** [https://github.com/RobertCNelson/linux-dev Development Kernel source code]
 
*** [https://github.com/RobertCNelson/linux-dev Development Kernel source code]
  
Line 27: Line 24:
 
** pastebin dmesg
 
** pastebin dmesg
 
*** Copy from serial port or use "dmesg | pastebinit" (sudo apt-get install pastebinit)
 
*** Copy from serial port or use "dmesg | pastebinit" (sudo apt-get install pastebinit)
 +
 +
= Official BeagleBoard.org Images for shipping with BeagleBone Black =
 +
* http://beagleboard.org/source
  
 
= Recommended Beagle Software =  
 
= Recommended Beagle Software =  
Line 36: Line 36:
  
 
= Debian NetInstall =  
 
= Debian NetInstall =  
 +
 +
Scripts:
 +
git clone https://github.com/RobertCNelson/netinstall.git
 +
cd netinstall
 +
 +
Device Options:
 +
BeagleBoard --dtb omap3-beagle
 +
BeagleBoard-xM --dtb omap3-beagle-xm
 +
BeagleBoard-X15 --dtb am57xx-beagle-x15
 +
BeagleBone (serial) --dtb am335x-bone-serial
 +
BeagleBone (video via cape) --dtb am335x-bone-video
 +
BeagleBone Black --dtb am335x-boneblack
 +
PandaBoard (A1->A3) --dtb omap4-panda
 +
PandaBoard (A4->Ax) --dtb omap4-panda-a4
 +
PandaBoard ES  --dtb omap4-panda-es
  
 
You will need a 1GB SD card or greater.
 
You will need a 1GB SD card or greater.
 
  Standard System : ~455MB
 
  Standard System : ~455MB
+ Desktop environment (GNOME) : ~2.9GB
 
 
== Debian Squeeze ==
 
  
git clone git://github.com/RobertCNelson/netinstall.git
+
== Debian 10 (buster) ==
cd netinstall
 
  
 
Quick Install script for "board"
 
Quick Install script for "board"
  sudo ./mk_mmc.sh --mmc /dev/sdX --uboot "board" --distro squeeze
+
  sudo ./mk_mmc.sh --mmc /dev/sdX --dtb "board" --distro stretch
 
 
"board" Options:
 
*BeagleBoard Ax/Bx - beagle_bx
 
*BeagleBoard Cx    - beagle_cx
 
*BeagleBoard xMA/B/C    - beagle_xm
 
*BeagleBone Ax    - bone
 
*PandaBoard Ax - panda
 
*PandaBoard ES - panda_es
 
  
 
So For the BeagleBoard xM:
 
So For the BeagleBoard xM:
  sudo ./mk_mmc.sh --mmc /dev/sdX --uboot beagle_xm --distro squeeze
+
  sudo ./mk_mmc.sh --mmc /dev/sdX --dtb omap3-beagle-xm --distro stretch
  
 
*Options:
 
*Options:
**--uboot : beagle, panda, bone
 
**--distro : squeeze
 
 
**--firmware : installs firmware
 
**--firmware : installs firmware
 
**--serial-mode : debian-installer uses Serial Port
 
**--serial-mode : debian-installer uses Serial Port
  
NOTE: There is a bug in the USB Keyboard mapping, the debian-installer will initially fail, if and when the error occurs switch to the option "kernel keymap" and continue installing..
+
= Demo Image =
  
==Beagleboard: NetInstall==
+
* '''Advanced Users only''': BeagleBoard xM: Kernel source, used in these demo images: https://github.com/RobertCNelson/armv7-multiplatform
 
+
git clone https://github.com/RobertCNelson/armv7-multiplatform.git
Choose a language
+
cd armv7-multiplatform
  C - No localization
+
git checkout origin/v5.4.x -b tmp
  English - English
+
  ./build_kernel.sh
 
+
* '''Advanced Users only''': BeagleBone/BeagleBone Black/PocketBeagle: Kernel v4.19.x source, used in these demo images: https://github.com/RobertCNelson/ti-linux-kernel-dev/tree/ti-linux-4.19.y
Configure the network:
+
  git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
  usb0: USB net <- (usually the OTG port, but could also be the smsc95xx adapter on the beagle and panda)
+
  cd ti-linux-kernel-dev
  usb1: USB net <- (usually the smsc95xx adapter on the beagle and panda, when usb0 exist)
+
  git checkout origin/ti-linux-4.19.y -b tmp
  eth0: Ethernet <- Your usb-ethernet device
+
  ./build_kernel.sh
  wlan0: Wifi <- Your usb-wifi device.. See [[BeagleBoardDebianWifiInstallInfo]] for my hack to set it up.
 
 
 
===usb0 howto===
 
There's a lot of question on irc about this, it might make sense to add a wiki page going thru with linux/winxp etc.. --[[User:RobertCNelson|RobertCNelson]] 00:55, 23 April 2010 (UTC)
 
 
 
  Configuring usb0 network bridge for 2.6.29:
 
  While you chose your keyboard layout, setup a bridge with ethX and usbX.
 
  # ifconfig ethX 0.0.0.0
 
  # ifconfig usbX 0.0.0.0
 
  # brctl addbr brX
 
  # brctl addif brX ethX
 
  # brctl addif brX usbX
 
  # ifconfig brX up
 
  # dhclient brX
 
  ''*Sometimes the first beagle DHCP will fail(probably due PC trying autoconnect), just run the auto configuration again and it will configure it right.''
 
 
 
Continue the install without loading kernel modules? : <yes>
 
 
 
  Partition disks: This partitioner doesn't have the inform.....? : <yes>
 
  Logical Volume Manager not available: <Continue>
 
 
 
  Partition disks:
 
  Guided - Use the largest continuous free space
 
 
 
  Partitioning scheme....
 
 
 
Example:
 
  MMC/SD card #1 (mmcblk0) - 2.0 GB Unknown
 
>  #1 primary  57.5 MB    fat32
 
  >  #2 primary  1.8 GB B f ext3  /
 
>  #5 logical 148.0 MB  f swap  swap
 
Finish partitioning and write changes to disk
 
  Write the changes to disk? : <yes>
 
 
 
No installable kernel was found in the defined APT sources? :
 
  Continue without installing a kernel? : <yes>
 
 
 
Standard System
 
 
 
No BootLoader: <ok>
 
 
 
= Demo Image =
 
  
== Debian Wheezy snapshot ==
+
== Debian (buster) ==
  
Default username/password:  
+
Default username/password:
 
*username: debian
 
*username: debian
 
*password: temppwd
 
*password: temppwd
 
Default root user/password
 
*user: root
 
*password: root
 
  
 
Image Updated:
 
Image Updated:
*2013-03-28:
+
*2020-03-12
** Beagle/Panda/Panda ES: v3.7.10-x10 kernel
+
** BeagleBoard xM: v5.4.24-armv7-x20 kernel
** Bone: v3.2.33-psp26 kernel (--uboot bone_dtb = v3.8.4-bone9)
+
** All BeagleBone Variants and PocketBeagle: v4.19.94-ti-r36 kernel
*2013-02-16:
+
** BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
** Beagle/Panda/Panda ES: v3.7.8-x8 kernel
+
*2019-04-10
** Bone: v3.2.33-psp26 kernel (--uboot bone_dtb = v3.8-rc7-bone4)
+
** BeagleBoard xM: v4.19.31-armv7-x31 kernel
*2013-01-12
+
** All BeagleBone Variants and PocketBeagle: v4.14.108-ti-r104 kernel
** Beagle/Panda/Panda ES: v3.7.2-x6
+
** BeagleBoard-X15: v4.14.108-ti-r104 kernel
** Bone: v3.2.33-psp26 kernel (next release should be v3.7.x based)
+
*2018-12-10
 +
** BeagleBoard xM: v4.19.8-armv7-x11 kernel
 +
** All BeagleBone Variants and PocketBeagle: v4.14.79-ti-r84 kernel
 +
** BeagleBoard-X15: v4.14.79-ti-r84 kernel
  
 
Services Active:
 
Services Active:
  Note: Depending on your internal network these may work out the box
+
  Note: Depending on your internal network these may work out of the box
  Apache, Port 80: http://arm/
+
  Apache, Port 80: http://arm.local/ (Bone: via usb) (Windows/Linux) http://192.168.7.2, (Mac/Linux) http://192.168.6.2
  SSH, Port 22: ssh ubuntu@arm
+
  SSH, Port 22: ssh debian@arm.local (Bone: via usb) (Windows/Linux) debian@192.168.7.2, (Mac/Linux) debian@192.168.6.2
 
  Getty, Serial Port
 
  Getty, Serial Port
 +
 +
Default user: debian pass: temppwd
  
 
Get prebuilt image:
 
Get prebuilt image:
 +
wget https://rcn-ee.com/rootfs/2020-03-12/elinux/debian-10.3-console-armhf-2020-03-12.tar.xz
  
  wget http://rcn-ee.net/deb/rootfs/wheezy/debian-wheezy-console-armhf-2013-03-28.tar.xz
+
Verify Image with:
 +
  sha256sum debian-10.3-console-armhf-2020-03-12.tar.xz
 +
b6f1ca53d67554d0381ca59fe9ecd50b5013a073abd2b2e133aa8be1784cdbc6  debian-10.3-console-armhf-2020-03-12.tar.xz
  
Verify Image with:  
+
Unpack Image:
  md5sum debian-wheezy-console-armhf-2013-03-28.tar.xz  
+
  tar xf debian-10.3-console-armhf-2020-03-12.tar.xz
  935b9d97669d6c84e54d5445da2f4506  debian-wheezy-console-armhf-2013-03-28.tar.xz
+
  cd debian-10.3-console-armhf-2020-03-12
  
Unpack Image:
+
If you don't know the location of your SD card:
  tar xJf debian-wheezy-console-armhf-2013-03-28.tar.xz
+
  sudo ./setup_sdcard.sh --probe-mmc
cd debian-wheezy-console-armhf-2013-03-28
 
  
Install Image:
+
You should see something like:
  
Quick Install script for "board"
+
Are you sure? I don't see [/dev/idontknow], here is what I do see...
  sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot "board"
+
 +
  fdisk -l:
 +
Disk /dev/sda: 500.1 GB, 500107862016 bytes '''<- x86 Root Drive'''
 +
Disk /dev/sdd: 3957 MB, 3957325824 bytes '''<- MMC/SD card'''
 +
 +
lsblk:
 +
NAME  MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
 +
sda      8:0    0 465.8G  0 disk
 +
├─sda1  8:1    0 446.9G  0 part /  '''<- x86 Root Partition'''
 +
├─sda2  8:2    0    1K  0 part
 +
└─sda5  8:5    0  18.9G  0 part [SWAP]
 +
sdd      8:48  1  3.7G  0 disk
 +
├─sdd1  8:49  1    64M  0 part
 +
└─sdd2  8:50  1  3.6G  0 part
  
"board" options:
+
* In this example, we can see via mount, '''/dev/sda1''' is the x86 rootfs, therefore '''/dev/sdd''' is the other drive in the system, which is the MMC/SD card that was inserted and should be used by ./setup_sdcard.sh...
*BeagleBoard Ax/Bx - beagle_bx
 
*BeagleBoard Cx/Dx - beagle_cx
 
*BeagleBoard xM    - beagle_xm
 
*BeagleBone Ax    - bone
 
*BeagleBone Ax    - bone_dtb (for v3.8.x testing)
 
*PandaBoard Ax    - panda
 
*PandaBoard ES    - panda_es
 
  
So For the BeagleBoard xM:
+
Install Image:
sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot beagle_xm
 
  
*Additional Options
+
Quick install script for [board]
** --rootfs <ext4 default>
+
sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb board
** --swap_file <swap file size in MB's>
 
** --addon pico <ti pico projector>
 
** --svideo-ntsc <use ntsc over dvi for video)
 
** --svideo-pal <use pal over dvi for video)
 
  
= Debian Configuration =
+
board options:
 +
*BeagleBoard Ax/Bx/Cx/Dx          - omap3-beagle
 +
*BeagleBoard xM                  - omap3-beagle-xm
 +
*All BeagleBone Variants          - beaglebone
 +
*OMAP5432 uEVM                    - omap5-uevm
 +
*BeagleBoard-X15 (BeagleBone AI)  - am57xx-beagle-x15
  
== Serial Ports ==
+
So for the BeagleBoard xM:
 +
sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb omap3-beagle-xm
  
Lenny
+
Advanced: Build Image:
  
edit /etc/inittab and add:
+
git clone https://github.com/RobertCNelson/omap-image-builder.git
  S:2345:respawn:/sbin/getty 115200 ttyS2
+
cd omap-image-builder
 +
  git checkout v2020.03 -b tmp
  
For root access over the serial port add ttyS2 to /etc/securetty
+
Stable:
  
 +
./RootStock-NG.sh -c rcn-ee_console_debian_buster_armhf
  
 +
= Flasher =
  
Squeeze
+
== eMMC: All BeagleBone Variants with eMMC ==
  
edit /etc/inittab and add:
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io  First press and hold the boot select button (next to the microSD card), then apply power. On boot-up the board should indicate it has started the flashing procedure visually via a Cylon Sweep pattern shown on the 4 LED's next to the Ethernet jack. Progress is reported on both the serial debug and HDMI connectors, once completed all 4 LED's should be full ON.  Simply remove power, remove the microSD card and Debian will now boot directly from eMMC.
S:2345:respawn:/sbin/getty 115200 ttyO2
 
  
== WiFi ==
+
Script for reference: (this is the script that writes to the eMMC)
 +
https://github.com/RobertCNelson/boot-scripts/blob/master/tools/eMMC/init-eMMC-flasher-v3.sh
  
See [[BeagleBoardDebianWifiInstallInfo|BeagleBoard Debian WiFi install info]].
+
This script will only take about 5-6 Minutes after power on.
  
== SGX Video Acceleration ==
+
Notes:
 +
* If only two LED's stay lit and nothing happens, the board has crashed due to lack of power. Retry with a 5Volt DC power supply connected.
 +
* If the 4 LED's blink a constant pattern, the eMMC write has failed. First REMOVE ALL capes, then retry again.
  
=== SGX armel/armhf v3.4.x+ ===
+
User: debian
* Note: This is a still a work in progress, but so far all the basic sgx demos seem to work on my Beagle xM C...  Thanks to TI for the special armhf binaries!!! --[[User:RobertCNelson|RobertCNelson]] 19:48, 17 July 2012 (UTC)
+
pass: temppwd
  
* Test with: Precise/12.04 armhf demo image with v3.4.5-x1, desktop was lxde via: "sudo apt-get install lxde lxde-core lxde-icon-theme"
+
Image Updated:
 +
*2020-03-12
 +
** All BeagleBone Variants with eMMC: v4.19.94-ti-r36 kernel
 +
*2019-04-10
 +
** All BeagleBone Variants with eMMC: v4.14.108-ti-r104 kernel
 +
*2018-12-10
 +
** All BeagleBone Variants with eMMC: v4.14.79-ti-r84 kernel
  
==== Re-Build Kernel and SGX Kernel Modules ====
+
Get prebuilt image:
  git clone git://github.com/RobertCNelson/stable-kernel.git
+
  wget https://rcn-ee.com/rootfs/2020-03-12/flasher/bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
cd stable-kernel
 
git checkout origin/v3.6.x -b v3.6.x
 
./build_kernel.sh (and then follow the directions as the script runs...)
 
  
Build kernel
+
Verify Image with:
  ./build_kernel.sh
+
  sha256sum bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb*
 +
12a449c3426d811765e8ef0236ae3ddc74fc645a482640984435452929ebf55d  bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  
Build SGX modules
+
Windows/Mac/Linux gui
  ./sgx_build_modules.sh
+
  http://etcher.io
  
Insert SD card, make sure to modify MMC in system.sh
+
Linux: (dd)
  ./tools/install_image.sh
+
  xzcat bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX
  
Place SD card into the device and boot...
+
== eMMC: BeagleBoard-X15 and BeagleBone AI ==
cd /opt/sgx
 
sudo tar xf GFX_4.0*_libs.tar.gz
 
sudo ./install-sgx.sh
 
  
Reboot, check modules (lsmod):
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io First press and hold the boot select button (next to the microSD card), then apply power. On boot-up the board should indicate it has started the flashing procedure visually via a Cylon Sweep pattern shown on the 4 LED's next to the Ethernet jack. Progress is reported on both the serial debug and HDMI connectors, once completed all 4 LED's should be full ON. Simply remove power, remove the microSD card and Debian will now boot directly from eMMC.
  Module                  Size  Used by
 
bufferclass_ti          5727  0
 
omaplfb                11512  0
 
pvrsrvkm              165208 2 bufferclass_ti,omaplfb
 
  
Blit Test:
+
Script for reference: (this is the script that writes to the eMMC)
ubuntu@omap:/usr/bin/armhf/es5.0$ ./sgx_blit_test
+
  https://github.com/RobertCNelson/boot-scripts/blob/master/tools/eMMC/init-eMMC-flasher-v3.sh
------------------ SGX 3D Blit test -----------------
 
----------------------- Start -----------------------
 
Call PVRSRVConnect with a valid argument:
 
  OK
 
Get number of devices from PVRSRVEnumerateDevices:
 
  OK
 
.... Reported 1 devices
 
.... Device Number  | Device Type
 
            0000    | PVRSRV_DEVICE_ID_SGX
 
Attempt to acquire device 0:
 
  OK
 
Getting SGX Client info
 
  OK
 
.... ui32ProcessID:1133
 
Display Class API: enumerate devices
 
  OK
 
PVRSRVEnumerateDeviceClass() returns 1 display device(s)
 
  OK
 
Display Class API: open device
 
  OK
 
Display Class API: Get display info
 
  OK
 
.... Name:PowerVR OMAP Linux Display Driver
 
.... MaxSwapChains:1
 
.... MaxSwapChainBuffers:1
 
.... MinSwapInterval:0
 
.... MaxSwapInterval:1
 
Display Class API: enumerate display formats
 
  OK
 
  OK
 
.... Display format 0 - Pixelformat:1
 
Display Class API: enumerate display dimensions
 
  OK
 
  OK
 
.... Display dimensions 0 - ByteStride:2560 Width:1280 Height:720
 
Attempt to create memory context for SGX:
 
  OK
 
.... Shared heap 0 - HeapID:0x7000000 DevVAddr:0x1000 Size:0x87fe000 Attr:0x2014200
 
.... Shared heap 1 - HeapID:0x7000001 DevVAddr:0xc800000 Size:0xfff000 Attr:0x2024200
 
.... Shared heap 2 - HeapID:0x7000002 DevVAddr:0xe400000 Size:0x7f000 Attr:0x2024200
 
.... Shared heap 3 - HeapID:0x7000003 DevVAddr:0xf000000 Size:0x3ff000 Attr:0x2024200
 
.... Shared heap 4 - HeapID:0x7000004 DevVAddr:0xf400000 Size:0x4ff000 Attr:0x2014200
 
.... Shared heap 5 - HeapID:0x7000005 DevVAddr:0xfc00000 Size:0x1ff000 Attr:0x2014200
 
.... Shared heap 6 - HeapID:0x7000006 DevVAddr:0xdc00000 Size:0x7ff000 Attr:0x2014200
 
.... Shared heap 7 - HeapID:0x7000007 DevVAddr:0xe800000 Size:0x7ff000 Attr:0x2014200
 
.... Shared heap 8 - HeapID:0x7000008 DevVAddr:0xd800000 Size:0x3ff000 Attr:0x2024200
 
.... Shared heap 9 - HeapID:0x7000009 DevVAddr:0x8800000 Size:0x0 Attr:0x2024200
 
.... Shared heap 10 - HeapID:0x700000a DevVAddr:0x8800000 Size:0x3fff000 Attr:0x2014200
 
Display Class API: get the system (primary) buffer
 
  OK
 
Display Class API: map display surface to SGX
 
  OK
 
Attempt to create transfer context for SGX:
 
  OK
 
Do a SRCCOPY blit to the bottom right quadrant of the display:
 
(bottom right quadrant should be red on blue background):
 
  OK
 
  OK
 
  Do a SRCCOPY blit to the top left quadrant of the display:
 
(top left quadrant should be striped (r/g/b/w) on blue background):
 
  OK
 
  OK
 
Do a CUSTOMSHADER blit to the top right quadrant of the display:
 
(top right quadrant should be yellow):
 
0xb6acd000 (host) 0xf407000 (device): Device mem for custom shader program
 
0xb6acb000 (host) 0xf408000 (device): Device mem for texture
 
USE custom shader program: 0x28841001.c0000000 mov.end o0, sa0
 
  OK
 
Do a SRCCOPY blit with COLOUR DOWNSAMPLING from ARGB8888 to RGB565
 
and then present the RGB565 to the bottom right quadrant of the screen
 
(bottom right quadrant should be a red gradient):
 
  OK
 
  OK
 
  OK
 
  OK
 
Free the off screen surfaces:
 
  OK
 
  OK
 
  OK
 
  OK
 
Destroy the transfer context:
 
  OK
 
Display Class API: unmap display surface from SGX
 
  OK
 
Destroy Device Memory Context
 
Display Class API: close the device
 
  OK
 
Release SGX Client Info:
 
  OK
 
Disconnect from services:
 
  OK
 
------------------ SGX 3D Blit test -----------------
 
------------------------ End ------------------------
 
  
=== SGX Legacy armel only upto v3.2.x ===
+
This script will only take about 5-6 Minutes after power on.
NOTE: this only works on BeagleBoard hardware, BeagleBone stuff is in development..
 
  
Requirements: stable-kernel (the Demo Images hosted on rcn-ee.net meet this requirement)
+
Notes:
  https://github.com/RobertCNelson/stable-kernel
+
* If only two LED's stay lit and nothing happens, the board has crashed due to lack of power. Retry with a 5Volt DC power supply connected.
 +
* If the 4 LED's blink a constant pattern, the eMMC write has failed. First REMOVE ALL capes, then retry again.
  
Note: Due to a bug (seems to only effect older Beagle Bx/Cx boards, use v3.0.8-x3 based kernels)
+
User: debian
https://github.com/RobertCNelson/stable-kernel/issues/8
+
pass: temppwd
oneiric:
 
wget http://rcn-ee.net/deb/oneiric/v3.0.8-x3/install-me.sh
 
/bin/bash install-me.sh
 
  
==== SDK unPackage Script ====
+
Image Updated:
 +
*2020-03-12
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
 +
*2019-04-10
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.14.108-ti-r104 kernel
 +
*2018-12-10
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.14.79-ti-r84 kernel
  
Download the latest version of the "create_sgx_package.sh" script
+
Get prebuilt image:
2.6.37
+
  wget https://rcn-ee.com/rootfs/2020-03-12/flasher/am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  wget https://raw.github.com/RobertCNelson/tools/master/x86/ti_omap/create_sgx_package_2.6.37.sh
 
2.6.38->3.2.x
 
wget https://raw.github.com/RobertCNelson/tools/master/x86/ti_omap/create_sgx_package_3.2.x.sh
 
  
Make script executable
+
Verify Image with:
  chmod a+x ./create_sgx_package_*.sh
+
  sha256sum am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb*
 +
b2d4600cfbeaad90e9d634f8f9671be1223d235e6581aac82897d3f28076d338  am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  
Run script
+
Windows/Mac/Linux gui
  ./create_sgx_package_*.sh
+
  http://etcher.io
  
After Successfully running:
+
Linux: (dd)
 +
xzcat am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX
  
:~/temp$ ls
+
= raw microSD img =
create_sgx_package.sh
 
GFX_X_XX_XX_XX_libs.tar.gz                      : -> Copy to Beagle (System Libs)
 
GFX_Linux_SDK.tar.gz                            : -> Copy to Beagle (DEMO's)
 
Graphics_SDK_setuplinux_X_XX_XX_XX.bin
 
SDK
 
SDK_BIN
 
  
==== Beagle: GFX_*_libs.tar.gz ====
+
== BeagleBoard xM ==
  
tar xf GFX_4_00_00_01_libs.tar.gz  (extracts install-SGX.sh and run-SGX.sh)
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io
./install-SGX.sh (copies necessary SGX libs and startup script)
 
./run-SGX.sh (force run the new init script, or you can just reboot...)
 
  
On successful install:
+
User: debian
Stopping PVR
+
pass: temppwd
Starting PVR
 
Starting SGX fixup for ES2.x (or ES3.x) (or ES5.x xM)
 
  
Reboot for good measure
+
Auto partition resize:
 +
cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 
  sudo reboot
 
  sudo reboot
  
==== Beagle: GFX_Linux_SDK.tar.gz ====
+
Image Updated:
 +
*2020-03-12
 +
** BeagleBoard xM: v5.4.24-armv7-x20 kernel
 +
*2019-04-10
 +
** BeagleBoard xM: v4.19.31-armv7-x31 kernel
 +
*2018-12-10
 +
** BeagleBoard xM: v4.19.8-armv7-x11 kernel
  
  tar xf GFX_Linux_SDK.tar.gz
+
Get prebuilt image:
cd GFX_Linux_SDK
+
  wget https://rcn-ee.com/rootfs/2020-03-12/microsd/bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
tar xf OGLES.tar.gz
 
  
==== Test SGX with a DEMO ====
+
Verify Image with:
 +
sha256sum bbxm-debian-10.3-console-armhf-2020-03-12-2gb*
 +
864cd6a45179e87c68087150597e18a1c12c81621da7735ee8d5c35094423845  bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  
cd OGLES/SDKPackage/Binaries/CommonX11/Demos/EvilSkull
+
Windows/Mac/Linux gui
./OGLESEvilSkull
+
http://etcher.io
  
==== Trouble Shooting ====
+
Linux: (dd)
 +
xzcat bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX
  
sudo rm /etc/powervr-esrev
+
== All BeagleBone Variants and PocketBeagle==
sudo depmod -a omaplfb
 
sudo /etc/init.d/pvr restart
 
  
== DSP ==
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io
  
=== gst-dsp ===
+
User: debian
 +
pass: temppwd
  
The following Gstreamer elements will be installed:
+
Auto partition resize:
 +
cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 +
sudo reboot
  
  $ gst-inspect | grep dsp
+
Image Updated:
  dvdspu: dvdspu: Sub-picture Overlay
+
*2020-03-12
  dsp:  dspdummy: DSP dummy element
+
** All BeagleBone Variants and PocketBeagle: v4.19.94-ti-r36 kernel
  dsp: dspvdec: DSP video decoder
+
*2019-04-10
  dsp:  dspadec: DSP audio decoder
+
** All BeagleBone Variants and PocketBeagle: v4.14.108-ti-r104 kernel
  dsp: dsph263enc: DSP video encoder
+
*2018-12-10
  dsp:  dspmp4venc: DSP MPEG-4 video encoder
+
** All BeagleBone Variants and PocketBeagle: v4.14.79-ti-r84 kernel
  dsp:  dspjpegenc: DSP video encoder
 
  dsp:  dsph264enc: DSP video encoder
 
  dsp:  dspvpp: DSP VPP filter
 
  dsp:  dspipp: DSP IPP
 
  
Please note that h264 encoder (dsph264enc) will not work because of missing h264venc_sn.dll64P DSP part. [http://groups.google.com/group/omapdiscuss/msg/76d928726656c5fe According to this message], it is not available due to a licensing restriction.
+
Get prebuilt image:
 +
wget https://rcn-ee.com/rootfs/2020-03-12/microsd/bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  
Requirements: Kernel built with: "CONFIG_TIDSPBRIDGE=m", for reference, here is what rcn-ee.net's image/deb's are configured for:
+
Verify Image with:
  ubuntu@arm:~$ zcat /proc/config.gz | grep TIDSP
+
  sha256sum bone-debian-10.3-console-armhf-2020-03-12-2gb*
  CONFIG_TIDSPBRIDGE=m
+
  6d898c473edc8a50597ed7da8342c899d88e07b8a6b4c7c143257e947cb5f52d bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  CONFIG_TIDSPBRIDGE_MEMPOOL_SIZE=0x600000
 
CONFIG_TIDSPBRIDGE_RECOVERY=y
 
# CONFIG_TIDSPBRIDGE_CACHE_LINE_CHECK is not set
 
# CONFIG_TIDSPBRIDGE_NTFY_PWRERR is not set
 
# CONFIG_TIDSPBRIDGE_BACKTRACE is not set
 
  
On the xM: if 3.2.x is too jerky, try 3.4.x and use the create_dsp_package.sh script, as the module changed..
+
Windows/Mac/Linux gui
 +
http://etcher.io
  
Download the latest version of the "create_dsp_package.sh" script
+
Linux: (dd)
  wget https://raw.github.com/RobertCNelson/tools/master/x86/ti_omap/create_dsp_package.sh
+
  xzcat bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX
  
Make script executable
+
== BeagleBoard-X15 and BeagleBone AI==
chmod a+x ./create_dsp_package.sh
 
  
Package script:
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io
./create_dsp_package.sh
 
  
Copy DSP_Install_libs.tar.gz to Beagle
+
User: debian
 +
pass: temppwd
  
Setup network...
+
Auto partition resize:
 +
cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 +
sudo reboot
  
Extract:
+
Image Updated:
ubuntu@arm:~$ tar xf DSP_Install_libs.tar.gz
+
*2020-03-12
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
 +
*2019-04-10
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.14.108-ti-r104 kernel
 +
*2018-12-10
 +
** BeagleBoard-X15 (and BeagleBone AI): v4.14.79-ti-r84 kernel
  
Install:
+
Get prebuilt image:
  ubuntu@arm:~$ ./install-DSP.sh
+
  wget https://rcn-ee.com/rootfs/2020-03-12/microsd/am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
  
What got installed:
+
Verify Image with:
  ubuntu@arm:~$ ls -lh /lib/dsp/
+
  sha256sum am57xx-debian-10.3-console-armhf-2020-03-12-2gb*
total 7.1M
+
  24bfaeac8d90ebd36790ba4c04a4117fe8c2e7aa28de5d1ff0a5ab164e32bb90 am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz
-rwxr-xr-x 1 root root 1.3M Dec  3 10:56 baseimage.dof
 
-rwxr-xr-x 1 root root  51K Dec  3 10:56 conversions.dll64P
 
-rwxr-xr-x 1 root root  13K Dec  3 10:56 dctn_dyn.dll64P
 
-rwxr-xr-x 1 root root 2.5M Dec  3 10:56 h264vdec_sn.dll64P
 
-rwxr-xr-x 1 root root 481K Dec  3 10:56 jpegdec_sn.dll64P
 
-rwxr-xr-x 1 root root 229K Dec  3 10:56 jpegenc_sn.dll64P
 
-rwxr-xr-x 1 root root 767K Dec  3 10:56 m4venc_sn.dll64P
 
-rwxr-xr-x 1 root root 890K Dec  3 10:56 mp4vdec_sn.dll64P
 
  -rwxr-xr-x 1 root root 707K Dec  3 10:56 mpeg4aacdec_sn.dll64P
 
  -rwxr-xr-x 1 root root  15K Dec  3 10:56 qosdyn_3430.dll64P
 
-rwxr-xr-x 1 root root  14K Dec  3 10:56 ringio.dll64P
 
-rwxr-xr-x 1 root root 9.1K Dec  3 10:56 TSPA_Object_Code_Software_License_Agreement.txt
 
-rwxr-xr-x 1 root root  53K Dec  3 10:56 usn.dll64P
 
-rwxr-xr-x 1 root root 245K Dec  3 10:56 vpp_sn.dll64P
 
  
Building gst-dsp stuff:
+
Windows/Mac/Linux gui
 +
http://etcher.io
  
If you installed this image via the demo images or netinstall, the gst-dsp build script is installed:
+
Linux: (dd)
 +
xzcat am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX
  
Update arm tools directory to the latest:
 
ubuntu@arm:~$ cd /boot/uboot/tools/
 
ubuntu@arm:/boot/uboot/tools$ sudo ./update.sh
 
  
Otherwise, install via git:
+
= Debian Configuration =
git clone git://github.com/RobertCNelson/tools.git
 
  
Change to the pkgs directory
+
==Install Latest Kernel Image==
ubuntu@arm:~$ cd /boot/uboot/tools/pkgs
 
(or if just cloned)
 
ubuntu@arm:~$ cd ~/tools/pkgs
 
  
Build gst-dsp stuff..
+
General apt syntax for searching and installing a specific kernel:
  ./ti-tidspbridge.sh
+
  sudo apt-get update
 
+
  sudo apt-cache search linux-image | grep <branch>
Start dspbridge (or just reboot)
+
  sudo apt-get install linux-image-<specific version>
  sudo /etc/init.d/dsp_init start
+
  sudo reboot
 
 
Test dspbridge
 
  sudo dsp-test
 
 
 
Playbin:
 
  sudo gst-launch playbin2 uri=file://(file)
 
  
Example: (using http://www.bigbuckbunny.org/index.php/download/ 854x480 mp4 )
+
Latest kernel script
  Note: it seems broken in Ubuntu precise armhf...
+
cd /opt/scripts/tools/
 +
  git pull
 +
sudo ./update_kernel.sh <OPTIONS>
  
sudo gst-launch playbin2 uri=file:///home/USER/big_buck_bunny_480p_surround-fix.avi
+
== 4.19.x-ti ==
 +
beagleboard.org patchset: https://github.com/beagleboard/linux/tree/4.19
 +
Based on: http://git.ti.com/gitweb/?p=ti-linux-kernel/ti-linux-kernel.git;a=shortlog;h=refs/heads/ti-linux-4.19.y
  
== Xorg omapfb Drivers ==
+
4.19.x-ti BeagleBone/BeagleBone Black/BeagleBoard-X15
 +
--ti-channel --lts-4_19
  
By default Debian will try* to use the FBDEV video driver, however for the beagleboard we can take advantage of a more software optimized driver (still not using the sgx video hardware) using the NEON extensions of the Cortex-A8 core.
+
4.19.x-ti BeagleBone/BeagleBone Black/BeagleBoard-X15 + RT
 +
--ti-rt-channel --lts-4_19
  
Lenny might need this xorg.conf, but it's best to use omapfb later in this guide..
+
== Mainline (4.19.x lts) ==
  
/etc/X11/xorg.conf:
+
4.19.x BeagleBone/BeagleBone Black
Section "Device"
+
  --bone-kernel --lts-4_19
Identifier "Configured Video Device"
 
Option "UseFBDev" "true"
 
Driver "fbdev"
 
  EndSection
 
  
cat /var/log/Xorg.0.log | grep FBDEV
+
4.19.x BeagleBone/BeagleBone Black + RT
(II) FBDEV: driver for framebuffer: fbdev
+
  --bone-rt-kernel --lts-4_19
(II) FBDEV(0): using default device
 
(II) FBDEV(0): Creating default Display subsection in Screen section
 
(==) FBDEV(0): Depth 16, (==) framebuffer bpp 16
 
  (==) FBDEV(0): RGB weight 565
 
  
Login into Debian and open a new terminal, xorg has to be running..
+
== Debian 9: stretch ==
 +
sudo apt-get install linux-image-armmp
  
xvinfo -display :0.0
+
Reboot with your new Kernel Image.
X-Video Extension version 2.2
 
screen #0
 
  no adaptors present
 
  
=== Drivers ===
+
== Xorg Drivers ==
  
Note: These are built with neon optimizations: http://git.debian.org/?p=collab-maint/xf86-video-omapfb.git;a=blob;f=debian/rules;h=c2f0d5391c96c5abb60b1e691ad86bb27e0c17d8;hb=HEAD (line 48/49)
+
Script:
 +
cd /opt/scripts/tools/
 +
  git pull
  
Lenny:
+
BeagleBoard/PandaBoard:
  wget -c http://rcn-ee.homeip.net:81/dl/deb-sbuild/lenny/xorg-drivers/xserver-xorg-video-omap3_0.1.1-2_armel.deb
+
  cd /opt/scripts/tools/graphics/
  sudo dpkg -i xserver-xorg-video-omap3_0.1.1-2_armel.deb
+
  ./ti-omapdrm.sh
  
Squeeze/Sid:
+
BeagleBone/BeagleBone Black:
  sudo apt-get install xserver-xorg-video-omap3
+
  cd /opt/scripts/tools/graphics/
 +
./ti-tilcdc.sh
  
=== xorg.conf ===
+
== SGX Drivers ==
/etc/X11/xorg.conf
 
  
Section "Monitor"
+
=== SGX BeagleBone/BeagleBone Black ===
    Identifier "Configured Monitor"
 
EndSection
 
 
Section "Screen"
 
    Identifier "Default Screen"
 
    Device "Configured Video Device"
 
    #Limited by SGX?
 
    DefaultDepth 16
 
EndSection
 
 
Section "Device"
 
    Identifier "Configured Video Device"
 
    Driver "omapfb"
 
    Option "fb" "/dev/fb0"
 
EndSection
 
  
To verify it was correctly installed, reboot and:
+
[[BeagleBoneBlack/SGX_%2B_Qt_EGLFS_%2B_Weston|A page is dedicated for the installation and use of the graphics accelerator]].
  
cat /var/log/Xorg.0.log | grep omapfb
+
= Building Kernel =
(II) LoadModule: "omapfb"
 
(II) Loading /usr/lib/xorg/modules/drivers//omapfb_drv.so
 
(II) Module omapfb: vendor="X.Org Foundation"
 
(II) omapfb: Driver for OMAP framebuffer (omapfb) and external LCD controllers:
 
(WW) Error opening /sys/devices/platform/omapfb/ctrl/name: No such file or directory
 
(II) omapfb(0): VideoRAM: 1800KiB (SDRAM)
 
(II) omapfb(0): Creating default Display subsection in Screen section
 
(**) omapfb(0): Depth 16, (--) framebuffer bpp 16
 
(==) omapfb(0): RGB weight 565
 
(==) omapfb(0): Default visual is TrueColor
 
(--) omapfb(0): Virtual size is 1280x720 (pitch 1280)
 
(**) omapfb(0):  Built-in mode "current"
 
(==) omapfb(0): DPI set to (96, 96)
 
(II) omapfb(0): DPMS enabled
 
(II) omapfb(0): Video plane capabilities:
 
(II) omapfb(0): Video plane supports the following image formats:
 
(II) omapfb(0): XVideo extension initialized
 
 
 
Login into Debian and open a new terminal, xorg has to be running..
 
 
 
xvinfo -display :0.0
 
X-Video Extension version 2.2
 
screen #0
 
  Adaptor #0: "OMAP XV adaptor"
 
    number of ports: 1
 
    port base: 56
 
    operations supported: PutImage
 
    supported visuals:
 
      depth 16, visualID 0x21
 
    number of attributes: 1
 
    etc..
 
 
 
== Building Kernel ==
 
  
 
Note, this section use to have a lot of details, but maintenance of the two wiki's became a pain, so for now on we will just link to my other pages:
 
Note, this section use to have a lot of details, but maintenance of the two wiki's became a pain, so for now on we will just link to my other pages:
  
=== Beagle/Beagle xM ===
+
== Beagle/Beagle xM ==
 
  http://eewiki.net/display/linuxonarm/BeagleBoard
 
  http://eewiki.net/display/linuxonarm/BeagleBoard
  
=== BeagleBone ===
+
== BeagleBone ==
 
  http://eewiki.net/display/linuxonarm/BeagleBone
 
  http://eewiki.net/display/linuxonarm/BeagleBone
  
=== Panda/Panda ES ===
+
== BeagleBone Black ==
 +
http://eewiki.net/display/linuxonarm/BeagleBone+Black
 +
 
 +
== Panda/Panda ES ==
 
  http://eewiki.net/display/linuxonarm/PandaBoard
 
  http://eewiki.net/display/linuxonarm/PandaBoard
  
Line 612: Line 425:
  
 
[http://www.jeremycole.com/blog/2011/03/09/beagleboard-upgrading-from-debian-5-to-debian-6/ Upgrading] from Debian 5 to Debian 6 report and tutorial.
 
[http://www.jeremycole.com/blog/2011/03/09/beagleboard-upgrading-from-debian-5-to-debian-6/ Upgrading] from Debian 5 to Debian 6 report and tutorial.
 +
 +
= Upgrading from Debian 6 (Squeeze) to Debian 7 (Wheezy) =
 +
 +
Note, this only goes over "armel" -> "armel"... For users wishing to switch from "armel" -> "armhf" just re-install...
 +
 +
sudo apt-get update ; sudo apt-get upgrade
 +
sudo sed -i -e "s/squeeze/wheezy/g" /etc/apt/sources.list
 +
sudo apt-get update ; sudo apt-get install -y apt aptitude udev dpkg
 +
sudo aptitude update ; sudo aptitude -y safe-upgrade ; sudo aptitude -y dist-upgrade

Latest revision as of 22:01, 29 May 2020

This page is about running a (ARM EABIhf) Debian distribution at BeagleBoard. BeagleBoard will boot the (ARM EABIhf) Debian distribution from SD card. Debian's NetInstall will be used to install Debian onto your Beagle.

Note: Original Beagleboards work with the Debian Console image booted via holding user button down. Last tested 05/2020. Ref: https://github.com/beagleboard/Latest-Images/issues/48

Help

If you need any help:

  • When asking for help, please provide some debugging information:
    • U-Boot Version installed on board
    • Kernel Version: uname -a
    • pastebin dmesg
      • Copy from serial port or use "dmesg | pastebinit" (sudo apt-get install pastebinit)

Official BeagleBoard.org Images for shipping with BeagleBone Black

Recommended Beagle Software

Mainline U-Boot:

  • All old Ax, Bx, Cx and Dx boards are required to upgrade to at least these U-Boot versions.
  • XM Boards have no NAND, so MLO/u-boot.img is always required on the first partition
  • Directions: Upgrade X-loader and U-Boot

Debian NetInstall

Scripts:

git clone https://github.com/RobertCNelson/netinstall.git
cd netinstall

Device Options:

BeagleBoard --dtb omap3-beagle
BeagleBoard-xM --dtb omap3-beagle-xm
BeagleBoard-X15 --dtb am57xx-beagle-x15
BeagleBone (serial) --dtb am335x-bone-serial
BeagleBone (video via cape) --dtb am335x-bone-video
BeagleBone Black --dtb am335x-boneblack
PandaBoard (A1->A3) --dtb omap4-panda
PandaBoard (A4->Ax) --dtb omap4-panda-a4
PandaBoard ES  --dtb omap4-panda-es

You will need a 1GB SD card or greater.

Standard System : ~455MB

Debian 10 (buster)

Quick Install script for "board"

sudo ./mk_mmc.sh --mmc /dev/sdX --dtb "board" --distro stretch

So For the BeagleBoard xM:

sudo ./mk_mmc.sh --mmc /dev/sdX --dtb omap3-beagle-xm --distro stretch
  • Options:
    • --firmware : installs firmware
    • --serial-mode : debian-installer uses Serial Port

Demo Image

git clone https://github.com/RobertCNelson/armv7-multiplatform.git
cd armv7-multiplatform
git checkout origin/v5.4.x -b tmp
./build_kernel.sh
git clone https://github.com/RobertCNelson/ti-linux-kernel-dev.git
cd ti-linux-kernel-dev
git checkout origin/ti-linux-4.19.y -b tmp
./build_kernel.sh

Debian (buster)

Default username/password:

  • username: debian
  • password: temppwd

Image Updated:

  • 2020-03-12
    • BeagleBoard xM: v5.4.24-armv7-x20 kernel
    • All BeagleBone Variants and PocketBeagle: v4.19.94-ti-r36 kernel
    • BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
  • 2019-04-10
    • BeagleBoard xM: v4.19.31-armv7-x31 kernel
    • All BeagleBone Variants and PocketBeagle: v4.14.108-ti-r104 kernel
    • BeagleBoard-X15: v4.14.108-ti-r104 kernel
  • 2018-12-10
    • BeagleBoard xM: v4.19.8-armv7-x11 kernel
    • All BeagleBone Variants and PocketBeagle: v4.14.79-ti-r84 kernel
    • BeagleBoard-X15: v4.14.79-ti-r84 kernel

Services Active:

Note: Depending on your internal network these may work out of the box
Apache, Port 80: http://arm.local/ (Bone: via usb) (Windows/Linux) http://192.168.7.2, (Mac/Linux) http://192.168.6.2
SSH, Port 22: ssh debian@arm.local (Bone: via usb) (Windows/Linux) debian@192.168.7.2, (Mac/Linux) debian@192.168.6.2
Getty, Serial Port

Default user: debian pass: temppwd

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/elinux/debian-10.3-console-armhf-2020-03-12.tar.xz

Verify Image with:

sha256sum debian-10.3-console-armhf-2020-03-12.tar.xz
b6f1ca53d67554d0381ca59fe9ecd50b5013a073abd2b2e133aa8be1784cdbc6  debian-10.3-console-armhf-2020-03-12.tar.xz

Unpack Image:

tar xf debian-10.3-console-armhf-2020-03-12.tar.xz
cd debian-10.3-console-armhf-2020-03-12

If you don't know the location of your SD card:

sudo ./setup_sdcard.sh --probe-mmc

You should see something like:

Are you sure? I don't see [/dev/idontknow], here is what I do see...

fdisk -l:
Disk /dev/sda: 500.1 GB, 500107862016 bytes <- x86 Root Drive
Disk /dev/sdd: 3957 MB, 3957325824 bytes <- MMC/SD card

lsblk:
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
sda      8:0    0 465.8G  0 disk 
├─sda1   8:1    0 446.9G  0 part /  <- x86 Root Partition
├─sda2   8:2    0     1K  0 part 
└─sda5   8:5    0  18.9G  0 part [SWAP]
sdd      8:48   1   3.7G  0 disk 
├─sdd1   8:49   1    64M  0 part 
└─sdd2   8:50   1   3.6G  0 part 
  • In this example, we can see via mount, /dev/sda1 is the x86 rootfs, therefore /dev/sdd is the other drive in the system, which is the MMC/SD card that was inserted and should be used by ./setup_sdcard.sh...

Install Image:

Quick install script for [board]

sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb board

board options:

  • BeagleBoard Ax/Bx/Cx/Dx - omap3-beagle
  • BeagleBoard xM - omap3-beagle-xm
  • All BeagleBone Variants - beaglebone
  • OMAP5432 uEVM - omap5-uevm
  • BeagleBoard-X15 (BeagleBone AI) - am57xx-beagle-x15

So for the BeagleBoard xM:

sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb omap3-beagle-xm

Advanced: Build Image:

git clone https://github.com/RobertCNelson/omap-image-builder.git
cd omap-image-builder
git checkout v2020.03 -b tmp

Stable:

./RootStock-NG.sh -c rcn-ee_console_debian_buster_armhf

Flasher

eMMC: All BeagleBone Variants with eMMC

This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io First press and hold the boot select button (next to the microSD card), then apply power. On boot-up the board should indicate it has started the flashing procedure visually via a Cylon Sweep pattern shown on the 4 LED's next to the Ethernet jack. Progress is reported on both the serial debug and HDMI connectors, once completed all 4 LED's should be full ON. Simply remove power, remove the microSD card and Debian will now boot directly from eMMC.

Script for reference: (this is the script that writes to the eMMC)

https://github.com/RobertCNelson/boot-scripts/blob/master/tools/eMMC/init-eMMC-flasher-v3.sh

This script will only take about 5-6 Minutes after power on.

Notes:

  • If only two LED's stay lit and nothing happens, the board has crashed due to lack of power. Retry with a 5Volt DC power supply connected.
  • If the 4 LED's blink a constant pattern, the eMMC write has failed. First REMOVE ALL capes, then retry again.

User: debian pass: temppwd

Image Updated:

  • 2020-03-12
    • All BeagleBone Variants with eMMC: v4.19.94-ti-r36 kernel
  • 2019-04-10
    • All BeagleBone Variants with eMMC: v4.14.108-ti-r104 kernel
  • 2018-12-10
    • All BeagleBone Variants with eMMC: v4.14.79-ti-r84 kernel

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/flasher/bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Verify Image with:

sha256sum bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb*
12a449c3426d811765e8ef0236ae3ddc74fc645a482640984435452929ebf55d  bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Windows/Mac/Linux gui

http://etcher.io

Linux: (dd)

xzcat bone-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX

eMMC: BeagleBoard-X15 and BeagleBone AI

This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io First press and hold the boot select button (next to the microSD card), then apply power. On boot-up the board should indicate it has started the flashing procedure visually via a Cylon Sweep pattern shown on the 4 LED's next to the Ethernet jack. Progress is reported on both the serial debug and HDMI connectors, once completed all 4 LED's should be full ON. Simply remove power, remove the microSD card and Debian will now boot directly from eMMC.

Script for reference: (this is the script that writes to the eMMC)

https://github.com/RobertCNelson/boot-scripts/blob/master/tools/eMMC/init-eMMC-flasher-v3.sh

This script will only take about 5-6 Minutes after power on.

Notes:

  • If only two LED's stay lit and nothing happens, the board has crashed due to lack of power. Retry with a 5Volt DC power supply connected.
  • If the 4 LED's blink a constant pattern, the eMMC write has failed. First REMOVE ALL capes, then retry again.

User: debian pass: temppwd

Image Updated:

  • 2020-03-12
    • BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
  • 2019-04-10
    • BeagleBoard-X15 (and BeagleBone AI): v4.14.108-ti-r104 kernel
  • 2018-12-10
    • BeagleBoard-X15 (and BeagleBone AI): v4.14.79-ti-r84 kernel

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/flasher/am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Verify Image with:

sha256sum am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb*
b2d4600cfbeaad90e9d634f8f9671be1223d235e6581aac82897d3f28076d338  am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Windows/Mac/Linux gui

http://etcher.io

Linux: (dd)

xzcat am57xx-eMMC-flasher-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX

raw microSD img

BeagleBoard xM

This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io

User: debian pass: temppwd

Auto partition resize:

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

Image Updated:

  • 2020-03-12
    • BeagleBoard xM: v5.4.24-armv7-x20 kernel
  • 2019-04-10
    • BeagleBoard xM: v4.19.31-armv7-x31 kernel
  • 2018-12-10
    • BeagleBoard xM: v4.19.8-armv7-x11 kernel

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/microsd/bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Verify Image with:

sha256sum bbxm-debian-10.3-console-armhf-2020-03-12-2gb*
864cd6a45179e87c68087150597e18a1c12c81621da7735ee8d5c35094423845  bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Windows/Mac/Linux gui

http://etcher.io

Linux: (dd)

xzcat bbxm-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX

All BeagleBone Variants and PocketBeagle

This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io

User: debian pass: temppwd

Auto partition resize:

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

Image Updated:

  • 2020-03-12
    • All BeagleBone Variants and PocketBeagle: v4.19.94-ti-r36 kernel
  • 2019-04-10
    • All BeagleBone Variants and PocketBeagle: v4.14.108-ti-r104 kernel
  • 2018-12-10
    • All BeagleBone Variants and PocketBeagle: v4.14.79-ti-r84 kernel

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/microsd/bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Verify Image with:

sha256sum bone-debian-10.3-console-armhf-2020-03-12-2gb*
6d898c473edc8a50597ed7da8342c899d88e07b8a6b4c7c143257e947cb5f52d  bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Windows/Mac/Linux gui

http://etcher.io

Linux: (dd)

xzcat bone-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX

BeagleBoard-X15 and BeagleBone AI

This image can be written to a 2GB (or larger) microSD card, via 'dd' on Linux or on Windows/Mac/Linux: https://etcher.io

User: debian pass: temppwd

Auto partition resize:

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

Image Updated:

  • 2020-03-12
    • BeagleBoard-X15 (and BeagleBone AI): v4.19.94-ti-r36 kernel
  • 2019-04-10
    • BeagleBoard-X15 (and BeagleBone AI): v4.14.108-ti-r104 kernel
  • 2018-12-10
    • BeagleBoard-X15 (and BeagleBone AI): v4.14.79-ti-r84 kernel

Get prebuilt image:

wget https://rcn-ee.com/rootfs/2020-03-12/microsd/am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Verify Image with:

sha256sum am57xx-debian-10.3-console-armhf-2020-03-12-2gb*
24bfaeac8d90ebd36790ba4c04a4117fe8c2e7aa28de5d1ff0a5ab164e32bb90  am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz

Windows/Mac/Linux gui

http://etcher.io

Linux: (dd)

xzcat am57xx-debian-10.3-console-armhf-2020-03-12-2gb.img.xz | sudo dd of=/dev/sdX


Debian Configuration

Install Latest Kernel Image

General apt syntax for searching and installing a specific kernel:

sudo apt-get update
sudo apt-cache search linux-image | grep <branch>
sudo apt-get install linux-image-<specific version>
sudo reboot

Latest kernel script

cd /opt/scripts/tools/
git pull
sudo ./update_kernel.sh <OPTIONS>

4.19.x-ti

beagleboard.org patchset: https://github.com/beagleboard/linux/tree/4.19
Based on: http://git.ti.com/gitweb/?p=ti-linux-kernel/ti-linux-kernel.git;a=shortlog;h=refs/heads/ti-linux-4.19.y
4.19.x-ti BeagleBone/BeagleBone Black/BeagleBoard-X15
--ti-channel --lts-4_19
4.19.x-ti BeagleBone/BeagleBone Black/BeagleBoard-X15 + RT
--ti-rt-channel --lts-4_19

Mainline (4.19.x lts)

4.19.x BeagleBone/BeagleBone Black
--bone-kernel --lts-4_19
4.19.x BeagleBone/BeagleBone Black + RT
--bone-rt-kernel --lts-4_19

Debian 9: stretch

sudo apt-get install linux-image-armmp

Reboot with your new Kernel Image.

Xorg Drivers

Script:

cd /opt/scripts/tools/
git pull

BeagleBoard/PandaBoard:

cd /opt/scripts/tools/graphics/
./ti-omapdrm.sh

BeagleBone/BeagleBone Black:

cd /opt/scripts/tools/graphics/
./ti-tilcdc.sh

SGX Drivers

SGX BeagleBone/BeagleBone Black

A page is dedicated for the installation and use of the graphics accelerator.

Building Kernel

Note, this section use to have a lot of details, but maintenance of the two wiki's became a pain, so for now on we will just link to my other pages:

Beagle/Beagle xM

http://eewiki.net/display/linuxonarm/BeagleBoard

BeagleBone

http://eewiki.net/display/linuxonarm/BeagleBone

BeagleBone Black

http://eewiki.net/display/linuxonarm/BeagleBone+Black

Panda/Panda ES

http://eewiki.net/display/linuxonarm/PandaBoard

Upgrading from Debian 5 to Debian 6

Upgrading from Debian 5 to Debian 6 report and tutorial.

Upgrading from Debian 6 (Squeeze) to Debian 7 (Wheezy)

Note, this only goes over "armel" -> "armel"... For users wishing to switch from "armel" -> "armhf" just re-install...

sudo apt-get update ; sudo apt-get upgrade
sudo sed -i -e "s/squeeze/wheezy/g" /etc/apt/sources.list
sudo apt-get update ; sudo apt-get install -y apt aptitude udev dpkg
sudo aptitude update ; sudo aptitude -y safe-upgrade ; sudo aptitude -y dist-upgrade