Difference between revisions of "BeagleBoardDebian"

From eLinux.org
Jump to: navigation, search
m (Debian Squeeze: s/errors/hours/)
(Use https where possible)
(155 intermediate revisions by 10 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 EABI) [https://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.
 
 
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.
 
  
 
= Help =
 
= Help =
Line 12: Line 10:
  
 
*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])
** [https://launchpad.net/~beagleboard-kernel Launchpad Project "Beagleboard Kernel"]
+
** Kernel Tree's
*** [https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-stable Launchpad Stable Kernel 2.6.32 src]
+
*** [https://github.com/RobertCNelson/armv7-multiplatform/ v3.13.x kernel branch]
*** [https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-dev Launchpad Development Kernel 2.6.32 src]
+
*** [https://github.com/RobertCNelson/linux-dev Development Kernel source code]
*** [https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-mainline Launchpad Mainline Kernel git src] *Unless you know what your doing, do NOT use the 2.6-mainline branch...
 
** [http://elinux.org/BeagleBoardUbuntuKernel Kernel Testing Results]
 
  
 
*When asking for help, please provide some debugging information:
 
*When asking for help, please provide some debugging information:
Line 25: Line 21:
 
** 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 =  
* Recent x-loader/MLO (1.4.4ss)
 
** All Bx C2/3/4 Boards should upgrade there MLO from here: [http://elinux.org/BeagleBoardUbuntu#Upgrade_X-loader_and_U-boot Upgrade X-loader and U-boot]
 
  
* Recent U-Boot (2010.03-rc1)
+
Mainline U-Boot:
** u-boot.bin from here: http://www.angstrom-distribution.org/beagleboard-demo-image-available
+
* All old Ax, Bx, Cx and Dx boards are required to upgrade to at least these U-Boot versions.
** Or this one I've archived: [http://elinux.org/BeagleBoardUbuntu#Upgrade_X-loader_and_U-boot Upgrade X-loader and U-boot]
+
* XM Boards have no NAND, so MLO/u-boot.img is always required on the first partition
*** Version 2009.01 (factory installed on C2/3's) and earlier will not work with this guide
+
* Directions: [http://elinux.org/BeagleBoardUbuntu#Upgrade_X-loader_and_U-boot Upgrade X-loader and U-Boot]
*** Version 2009.11-rc1-00601-g3aa4b51 (factory installed on C4's) should be upgraded
 
*** 'mmc init' change [http://git.denx.de/?p=u-boot.git;a=commit;h=a85693b3bd4431b05b7df608b6f7733c0f80c53e]
 
  
= Native Net Install =  
+
= Debian NetInstall =  
  
==Development PC: Format SD Card==
+
Scripts:
 +
git clone https://github.com/RobertCNelson/netinstall.git
 +
cd netinstall
  
Planning to remove this section, pending Squeeze's Release...
+
Device Options:
 +
BeagleBoard --dtb omap3-beagle
 +
BeagleBoard xM --dtb omap3-beagle-xm
 +
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.
Line 47: Line 52:
 
  + Desktop environment (GNOME) : ~2.9GB
 
  + Desktop environment (GNOME) : ~2.9GB
  
Starting with an empty SD card and using gparted, create:
+
== Debian Wheezy ==
50 MiB Primary Partition, fat32
 
Leave remaining space for the Debian-Installer
 
  
==Development PC: Setup SD U-boot Partition==
+
Quick Install script for "board"
 +
sudo ./mk_mmc.sh --mmc /dev/sdX --dtb "board" --distro wheezy-armhf
  
Mount your SD card fat32 partition. (/media/disk/)
+
So For the BeagleBoard xM:
 
+
  sudo ./mk_mmc.sh --mmc /dev/sdX --dtb omap3-beagle-xm --distro wheezy-armhf
=== Debian Lenny ===
 
cd /media/disk/
 
sudo wget http://rcn-ee.net/deb/kernel/CC-beagle-v2.6.29-58cf2f1-oer44.1.uImage
 
  sudo wget http://ftp.debian.org/debian/dists/lenny/main/installer-armel/current/images/versatile/netboot/initrd.gz
 
sudo mv CC-beagle-v2.6.29-58cf2f1-oer44.1.uImage uImage
 
sudo gzip -d initrd.gz
 
sudo dd if=initrd of=initrd.pad ibs=8388608 conv=sync
 
 
 
Create U-boot boot script for netinstall:
 
 
 
Debian Install over DVI Port
 
sudo nano netinstall.cmd
 
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; fatload mmc 0:1 0x81600000 initrd.pad; bootm 0x80300000'
 
setenv bootargs 'console=tty0 ramdisk_size=8192 root=/dev/ram0 rw rootfstype=ext2 initrd=0x81600000,8M omapfb.mode=dvi:1280x720MR-16@60'
 
boot
 
 
 
Debian Install over the Serial Port
 
sudo nano netinstall.cmd
 
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; fatload mmc 0:1 0x81600000 initrd.pad; bootm 0x80300000'
 
setenv bootargs 'console=ttyS2,115200n8 ramdisk_size=8192 root=/dev/ram0 rw rootfstype=ext2 initrd=0x81600000,8M'
 
boot
 
 
 
Create U-boot *.scr file:
 
 
 
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./netinstall.cmd ./boot.scr
 
 
 
Sync and Unmount your mmc card and boot the beagle, it should find the 'boot.scr' file on your first partition while booting.
 
 
 
=== Debian Squeeze ===
 
(Testing Release Summer 2010?)
 
 
 
Note: Squeeze hasn't been released, so if you get an error, retry in a couple hours..
 
 
 
https://code.launchpad.net/~beagleboard-kernel/+junk/debian-di
 
 
bzr branch lp:~beagleboard-kernel/+junk/debian-di
 
cd debian-di
 
./mk_mmc.sh --mmc /dev/sdX --distro squeeze
 
  
 
*Options:
 
*Options:
**--distro : squeeze, lucid
 
 
**--firmware : installs firmware
 
**--firmware : installs firmware
 
**--serial-mode : debian-installer uses Serial Port
 
**--serial-mode : debian-installer uses Serial Port
  
Note: The default options work for most people, but if you'd like to tweak boot settings, edit these before running the script.
 
 
NetInstall boot Settings:
 
gedit ./scripts/dvi.cmd
 
gedit ./scripts/serial.cmd
 
 
Normal Boot Settings:
 
gedit ./scripts/dvi-normal-squeeze.cmd
 
gedit ./scripts/serial-normal-squeeze.cmd
 
  
==Beagleboard: NetInstall==
+
= Demo Image =
 +
 
 +
== Debian Stable (wheezy)  ==
  
Choose a language
+
Default username/password:
  C - No localization
+
*username: debian
  English - English
+
*password: temppwd
  
Configure the network:
+
Default root user/password
  usb0: USB net <- See below for 2.6.29. Could not find usb0 with B7 installing 2.6.28.
+
*user: root
  eth0: Ethernet <- Your usb-ethernet device
+
*password: root
  wlan0: Wifi <- Your usb-wifi device.. See [[BeagleBoardDebianWifiInstallInfo]] for my hack to set it up.
 
  
===usb0 howto===
+
Image Updated:
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)
+
*2014-02-16
 +
** Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** Beagle/Beagle xM: v3.13.0-armv7-x9 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
 +
*2013-12-17
 +
** Beagle xM (ONLY): v3.12.5-armv7-x10 kernel (--dtb dt-beagle-xm)
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel
 +
** Beagle/Panda/Panda ES: v3.7.10-x13 kernel
  
  Configuring usb0 network bridge for 2.6.29:
+
Services Active:
  While you chose your keyboard layout, setup a bridge with ethX and usbX.
+
  Note: Depending on your internal network these may work out of the box
  # ifconfig ethX 0.0.0.0
+
Apache, Port 80: http://arm/ (Bone: via usb) http://192.168.7.2
  # ifconfig usbX 0.0.0.0
+
SSH, Port 22: ssh debian@arm (Bone: via usb) debian@192.168.7.2
  # brctl addbr brX
+
Getty, Serial Port
  # 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>
+
Default user: debian pass: temppwd
  
  Partition disks: This partitioner doesn't have the inform.....? : <yes>
+
Get prebuilt image:
  Logical Volume Manager not available: <Continue>
+
  wget https://rcn-ee.net/deb/rootfs/wheezy/debian-7.4-console-armhf-2014-02-16.tar.xz
  
  Partition disks:
+
Verify Image with:
  Guided - Use the largest continuous free space
+
  md5sum debian-7.4-console-armhf-2014-02-16.tar.xz
 +
bd3609c5c644d516ac399fca52aeb9a2  debian-7.4-console-armhf-2014-02-16.tar.xz
  
  Partitioning scheme....
+
Unpack Image:
 +
  tar xf debian-7.4-console-armhf-2014-02-16.tar.xz
 +
cd debian-7.4-console-armhf-2014-02-16
  
Example:
+
Install Image:
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? :
+
Quick install script for [board]
  Continue without installing a kernel? : <yes>
+
  sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot board
  
Standard System
+
[board] options:
 +
*BeagleBone/Black    - bone
  
  No BootLoader: <ok>
+
So for the BeagleBone:
 +
  sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot bone
  
==Development PC: Setup U-boot for Normal Boot==
+
Quick install script for [board] (using new --dtb option)
 +
sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb board
  
Planning to remove this section, pending Squeeze's Release...  I moved the relevant data to: http://elinux.org/BeagleBoardDebian#U-boot_Scripts
+
board options:
 +
*BeagleBoard Ax/Bx/Cx/Dx    - omap3-beagle
 +
*BeagleBoard xM            - omap3-beagle-xm
  
Create a U-boot normal boot script:
+
So for the BeagleBoard xM:
 +
sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb omap3-beagle-xm
  
DVI Port
+
Advanced: Build Image:
sudo nano normal.cmd
 
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
 
setenv bootargs 'console=tty0 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro omapfb.mode=dvi:1280x720MR-16@60'
 
boot
 
  
Serial Port
+
Built with a fork of project-rootstock (ARM native mode, runs directly on BeagleBoard), using a script from omap-image-builder:
sudo nano normal.cmd
 
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
 
setenv bootargs 'console=ttyS2,115200n8 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro'
 
boot
 
  
Create U-boot *.scr file:
+
git clone https://github.com/RobertCNelson/omap-image-builder.git
 +
cd omap-image-builder
 +
git checkout v2014.02 -b tmp
 +
touch release
 +
./rcn-ee_image.sh
  
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./normal.cmd ./boot.scr
+
== Debian Testing (jessie) ==
  
Debian will fix the ext3 partition, it'll try to reboot, after halting remove and reapply power.
+
Image Updated:
 +
*2014-02-16
 +
** Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** Beagle/Beagle xM: v3.13.0-armv7-x9 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
 +
*2013-12-17
 +
** Beagle xM (ONLY): v3.12.5-armv7-x10 kernel (--dtb dt-beagle-xm)
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel
 +
** Beagle/Panda/Panda ES: v3.7.10-x13 kernel
  
==Beagleboard: Install Latest Kernel==
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/rootfs/jessie/debian-jessie-console-armhf-2014-02-16.tar.xz
  
Script File:
+
Verify Image with:
 +
md5sum debian-jessie-console-armhf-2014-02-16.tar.xz
 +
12550b29231c51e76475ec5f37000c5b  debian-jessie-console-armhf-2014-02-16.tar.xz
  
Lenny:
+
Unpack image:
  wget http://rcn-ee.net/deb/kernel/beagle/lenny/v2.6.32.11-x13/install-me.sh
+
  tar xf debian-jessie-console-armhf-2014-02-16.tar.xz
  sudo /bin/bash install-me.sh
+
  cd debian-jessie-console-armhf-2014-02-16
 
Squeeze:
 
wget http://rcn-ee.net/deb/kernel/beagle/squeeze/v2.6.32.11-x13/install-me.sh
 
sudo /bin/bash install-me.sh
 
  
Reboot with your new Kernel
+
Then follow the directions shown above with the other images...
  
= Debian Configuration =
+
= Flasher =
  
== U-boot Scripts ==
+
== eMMC: BeagleBone Black ==
  
Create a U-boot normal boot script:
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on linux or the win32 image program linked to on CircuitCo's wiki page.  First press and hold the boot select button (next to the microSD card), then apply power (same procedure as the official CircuitCo images). The board should boot into Debian and begin flashing the eMMC, 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.
  
DVI Port
+
Script for reference: (this is the script that writes to the eMMC)
sudo nano normal.cmd
+
  https://github.com/RobertCNelson/boot-scripts/blob/master/tools/beaglebone-black-eMMC-flasher.sh
  setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
 
setenv bootargs 'console=tty0 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro omapfb.mode=dvi:1280x720MR-16@60'
 
boot
 
  
Serial Port
+
BTW: we are only writing about 500 megabytes to the eMMC, so the script will only take about 5-6 Minutes after power on.
sudo nano normal.cmd
 
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
 
setenv bootargs 'console=ttyS2,115200n8 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro'
 
boot
 
  
Create U-boot *.scr file:
+
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.
 +
** (error -84: which may mean you've reached the max number of erase/write cycles...)
  
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./normal.cmd ./boot.scr
+
User: debian
 +
pass: temppwd
  
Debian will fix the ext3 partition, it'll try to reboot, after halting remove and reapply power.
+
root: root/root
  
== Serial Ports ==
+
Image Updated:
 +
*2014-02-16
 +
** BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** BeagleBone Black: v3.8.13-bone37 kernel
 +
*2013-12-17
 +
** BeagleBone Black: v3.8.13-bone32 kernel
  
Lenny
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/flasher/wheezy/BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
  
edit /etc/inittab and add:
+
Verify Image with:
  S:2345:respawn:/sbin/getty 115200 ttyS2
+
  md5sum BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
 +
75593faa4338380f6e2b94e82376dc95  BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
  
For root access over the serial port add ttyS2 to /etc/securetty
+
Follow the "standard" update procedure.
 +
http://circuitco.com/support/index.php?title=Updating_The_Software
  
== WiFi ==
+
Linux:
 +
unxz BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
 +
sudo dd if=./BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img of=/dev/sdX
  
See [[BeagleBoardDebianWifiInstallInfo|BeagleBoard Debian WiFi install info]].
+
= raw microSD img =
  
== SGX Video Acceleration ==
+
== BeagleBoard xM ==
  
Use a "corporate email" and download the latest (3.01.00.02):
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on linux or the win32 image program linked to on CircuitCo's wiki page.  First press and hold the boot select button (next to microSD card), then apply power (same procedure as the official CircuitCo images)The board should boot into Debian.
  http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/gfxsdk/latest/index_FDS.html
 
  
=== Kernel Modules ===
+
User: debian
 +
pass: temppwd
  
Use the "build_sgx_module.sh" script in 2.6-stable, module source is now in the *.bin
+
root: root/root
  
  https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-stable
+
Auto partition resize:
 +
  cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 +
sudo reboot
  
Copy uImage and modules from the deploy directory to your SD card.
+
Image Updated:
 +
*2014-02-16
 +
** Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
  
Copy the GFX_Linux_SDK.tar.gz examples to either your SD card or another media (large file) then boot your omap board.
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/microsd/wheezy/bbxm-debian-7.4-2014-02-16-2gb.img.xz
  
Run depmod:
+
Verify Image with:
  sudo depmod -a omaplfb
+
  md5sum bbxm-debian-7.4-2014-02-16-2gb.img.xz
 +
a118de7b1500489ecd4d7263dc06b037  bbxm-debian-7.4-2014-02-16-2gb.img.xz
  
Tweak System Libraries:
+
Linux:
  sudo ln -sf /usr/lib/libXdmcp.so.6.0.0 /usr/lib/libXdmcp.so.0
+
  unxz bbxm-debian-7.4-2014-02-16-2gb.img.xz
  sudo ln -sf /usr/lib/libXau.so.6.0.0 /usr/lib/libXau.so.0
+
  sudo dd if=./bbxm-debian-7.4-2014-02-16-2gb.img of=/dev/sdX
  
=== Startup Script ===
+
== BeagleBone/BeagleBone Black ==
  
For 3.01.00.02
+
This image can be written to a 2GB (or larger) microSD card, via 'dd' on linux or the win32 image program linked to on CircuitCo's wiki page. First press and hold the boot select button (next to microSD card), then apply power (same procedure as the official CircuitCo images). The board should boot into Debian.
  
Lenny:
+
User: debian
sudo nano /etc/rcS.d/S60pvr.sh
+
pass: temppwd
sudo chmod +x /etc/rcS.d/S60pvr.sh
 
  
Squeeze: (probally lenny too)
+
root: root/root
sudo nano /etc/init.d/pvr
 
sudo chmod +x /etc/init.d/pvr
 
sudo update-rc.d pvr defaults
 
  
Contents of S60pvr.sh/pvr
+
Auto partition resize:
#!/bin/sh
+
  cd /opt/scripts/tools
+
  git pull
if [ "$1" = "" ]; then
+
  ./grow_partition.sh
echo PVR-INIT: Please use start, stop, or restart.
+
  sudo reboot
exit 1
 
fi
 
 
if [ "$1" = "stop" -o  "$1" = "restart" ]; then
 
echo Stopping PVR
 
rmmod omaplfb 2>/dev/null
 
rmmod pvrsrvkm 2>/dev/null
 
fi
 
 
if [ "$1" = "stop" ]; then
 
exit 0
 
fi
 
 
echo Starting PVR
 
modprobe omaplfb
 
 
pvr_maj=`grep "pvrsrvkm$" /proc/devices | cut -b1,2,3`
 
 
if [ -e /dev/pvrsrvkm ] ; then
 
rm -f /dev/pvrsrvkm
 
fi
 
 
mknod /dev/pvrsrvkm c $pvr_maj 0
 
  chmod 666 /dev/pvrsrvkm
 
 
touch /etc/powervr-esrev
 
   
 
  SAVED_ESREVISION="$(cat /etc/powervr-esrev)"
 
ES_REVISION="$(cat /proc/cpuinfo | grep "CPU revision" | awk -F: '{print $2}')"
 
 
if [ "${ES_REVISION}" != "${SAVED_ESREVISION}" ] ; then
 
echo -n "Starting SGX fixup for"
 
if [ "${ES_REVISION}" = " 3" ] ; then
 
echo " ES3.x"
 
cp -a /usr/lib/ES3.0/* /usr/lib
 
cp -a /usr/bin/ES3.0/* /usr/bin
 
else
 
echo " ES2.x"
 
cp -a /usr/lib/ES2.0/* /usr/lib
 
cp -a /usr/bin/ES2.0/* /usr/bin
 
fi
 
 
echo "${ES_REVISION}" > /etc/powervr-esrev
 
fi
 
 
  /usr/bin/pvrsrvinit
 
  
=== Test SGX with a DEMO ===
+
Image Updated:
 +
*2014-02-16
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
 +
*2013-12-17
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel
  
In GFX_Linux_SDK:
+
Get prebuilt image:
  cd OGLES/SDKPackage/Binaries/CommonX11/Demos/ChameleonMan
+
  wget https://rcn-ee.net/deb/microsd/wheezy/bone-debian-7.4-2014-02-16-2gb.img.xz
./OGLESChameleonMan
 
  
=== Trouble Shooting ===
+
Verify Image with:
 +
md5sum bone-debian-7.4-2014-02-16-2gb.img.xz
 +
de60cb007a51d74ebe27411d3da76edf  bone-debian-7.4-2014-02-16-2gb.img.xz
  
  sudo rm /etc/powervr-esrev
+
Linux:
sudo depmod -a omaplfb
+
  unxz bone-debian-7.4-2014-02-16-2gb.img.xz
  sudo /etc/init.d/pvr restart
+
  sudo dd if=./bone-debian-7.4-2014-02-16-2gb.img of=/dev/sdX
  
== Xorg omapfb Drivers ==
+
= Debian Configuration =
  
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.
+
== Serial Ports ==
  
Lenny might need this xorg.conf, but it's best to use omapfb later in this guide..
+
To start a login console on ttyO2 (the serial header next to P9), edit /etc/inittab and add:
 +
T0:23:respawn:/sbin/getty -L ttyO2 115200 vt102
  
/etc/X11/xorg.conf:
+
To start a console on the USB ACM device, add the following to /etc/inittab,
  Section "Device"
+
  GS0:23:respawn:/sbin/getty -L ttyGS0 115200 vt102
Identifier "Configured Video Device"
 
Option "UseFBDev" "true"
 
Driver "fbdev"
 
EndSection
 
  
cat /var/log/Xorg.0.log | grep FBDEV
+
==Install Latest Kernel Image==
(II) FBDEV: driver for framebuffer: fbdev
 
(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..
+
Script:
 +
cd /opt/scripts/tools
 +
git pull
  
xvinfo -display :0.0
+
Stable:
  X-Video Extension version 2.2
+
  ./update_kernel.sh
screen #0
 
  no adaptors present
 
  
=== Drivers ===
+
Testing:
 +
./update_kernel.sh --beta-kernel
  
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)
+
Custom: (has to be on rcn-ee.net)
 +
./update_kernel.sh --kernel v3.8.13-bone37
  
Lenny:
+
Reboot with your new Kernel Image.
wget -c http://rcn-ee.homeip.net:81/dl/deb-sbuild/lenny/xorg-drivers/xserver-xorg-video-omap3_0.1.1-2_armel.deb
 
sudo dpkg -i xserver-xorg-video-omap3_0.1.1-2_armel.deb
 
  
Squeeze/Sid:
+
== Xorg Drivers ==
sudo apt-get install xserver-xorg-video-omap3
 
  
=== xorg.conf ===
+
Script:
/etc/X11/xorg.conf
+
cd /opt/scripts/tools/
 +
git pull
  
Section "Monitor"
+
BeagleBoard/PandaBoard:
    Identifier "Configured Monitor"
+
  cd /opt/scripts/tools/graphics/
  EndSection
+
  ./ti-omapdrm.sh
 
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:
+
BeagleBone/BeagleBone Black:
 +
cd /opt/scripts/tools/graphics/
 +
./ti-tilcdc.sh
  
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..
+
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:
  
xvinfo -display :0.0
+
== Beagle/Beagle xM ==
  X-Video Extension version 2.2
+
  http://eewiki.net/display/linuxonarm/BeagleBoard
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..
 
  
== DSP ==
+
== BeagleBone ==
 +
http://eewiki.net/display/linuxonarm/BeagleBone
  
= Kernel Build =
+
== BeagleBone Black ==
 +
http://eewiki.net/display/linuxonarm/BeagleBone+Black
  
https://launchpad.net/~beagleboard-kernel
+
== Panda/Panda ES ==
 +
http://eewiki.net/display/linuxonarm/PandaBoard
  
Register on launchpad.net, install bzr
+
= Upgrading from Debian 5 to Debian 6 =
sudo apt-get install bzr
 
  
Download SRC
+
[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.
bzr branch lp:~beagleboard-kernel/+junk/2.6-stable
 
bzr branch lp:~beagleboard-kernel/+junk/2.6-dev
 
  
Build Kernel
+
= Upgrading from Debian 6 (Squeeze) to Debian 7 (Wheezy) =
. build_kernel.sh
 
  
Build SGX Modules
+
Note, this only goes over "armel" -> "armel"... For users wishing to switch from "armel" -> "armhf" just re-install...
. build_sgx_modules.sh
 
  
Build Deb File
+
sudo apt-get update ; sudo apt-get upgrade
  . build_deb.sh
+
  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

Revision as of 07:51, 12 April 2014

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

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
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
+ Desktop environment (GNOME) : ~2.9GB

Debian Wheezy

Quick Install script for "board"

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

So For the BeagleBoard xM:

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


Demo Image

Debian Stable (wheezy)

Default username/password:

  • username: debian
  • password: temppwd

Default root user/password

  • user: root
  • password: root

Image Updated:

  • 2014-02-16
    • Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • Beagle/Beagle xM: v3.13.0-armv7-x9 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
  • 2013-12-17
    • Beagle xM (ONLY): v3.12.5-armv7-x10 kernel (--dtb dt-beagle-xm)
    • BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel
    • Beagle/Panda/Panda ES: v3.7.10-x13 kernel

Services Active:

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

Default user: debian pass: temppwd

Get prebuilt image:

wget https://rcn-ee.net/deb/rootfs/wheezy/debian-7.4-console-armhf-2014-02-16.tar.xz

Verify Image with:

md5sum debian-7.4-console-armhf-2014-02-16.tar.xz
bd3609c5c644d516ac399fca52aeb9a2  debian-7.4-console-armhf-2014-02-16.tar.xz

Unpack Image:

tar xf debian-7.4-console-armhf-2014-02-16.tar.xz
cd debian-7.4-console-armhf-2014-02-16

Install Image:

Quick install script for [board]

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

[board] options:

  • BeagleBone/Black - bone

So for the BeagleBone:

sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot bone

Quick install script for [board] (using new --dtb option)

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

board options:

  • BeagleBoard Ax/Bx/Cx/Dx - omap3-beagle
  • BeagleBoard xM - omap3-beagle-xm

So for the BeagleBoard xM:

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

Advanced: Build Image:

Built with a fork of project-rootstock (ARM native mode, runs directly on BeagleBoard), using a script from omap-image-builder:

git clone https://github.com/RobertCNelson/omap-image-builder.git
cd omap-image-builder
git checkout v2014.02 -b tmp
touch release
./rcn-ee_image.sh

Debian Testing (jessie)

Image Updated:

  • 2014-02-16
    • Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • Beagle/Beagle xM: v3.13.0-armv7-x9 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
  • 2013-12-17
    • Beagle xM (ONLY): v3.12.5-armv7-x10 kernel (--dtb dt-beagle-xm)
    • BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel
    • Beagle/Panda/Panda ES: v3.7.10-x13 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/rootfs/jessie/debian-jessie-console-armhf-2014-02-16.tar.xz

Verify Image with:

md5sum debian-jessie-console-armhf-2014-02-16.tar.xz
12550b29231c51e76475ec5f37000c5b  debian-jessie-console-armhf-2014-02-16.tar.xz

Unpack image:

tar xf debian-jessie-console-armhf-2014-02-16.tar.xz
cd debian-jessie-console-armhf-2014-02-16

Then follow the directions shown above with the other images...

Flasher

eMMC: BeagleBone Black

This image can be written to a 2GB (or larger) microSD card, via 'dd' on linux or the win32 image program linked to on CircuitCo's wiki page. First press and hold the boot select button (next to the microSD card), then apply power (same procedure as the official CircuitCo images). The board should boot into Debian and begin flashing the eMMC, 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/beaglebone-black-eMMC-flasher.sh

BTW: we are only writing about 500 megabytes to the eMMC, so the 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.
    • (error -84: which may mean you've reached the max number of erase/write cycles...)

User: debian pass: temppwd

root: root/root

Image Updated:

  • 2014-02-16
    • BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • BeagleBone Black: v3.8.13-bone37 kernel
  • 2013-12-17
    • BeagleBone Black: v3.8.13-bone32 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/flasher/wheezy/BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz

Verify Image with:

md5sum BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
75593faa4338380f6e2b94e82376dc95  BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz

Follow the "standard" update procedure.

http://circuitco.com/support/index.php?title=Updating_The_Software

Linux:

unxz BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img.xz
sudo dd if=./BBB-eMMC-flasher-debian-7.4-2014-02-16-2gb.img 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 the win32 image program linked to on CircuitCo's wiki page. First press and hold the boot select button (next to microSD card), then apply power (same procedure as the official CircuitCo images). The board should boot into Debian.

User: debian pass: temppwd

root: root/root

Auto partition resize:

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

Image Updated:

  • 2014-02-16
    • Beagle/Beagle xM: v3.13.3-armv7-x10 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/microsd/wheezy/bbxm-debian-7.4-2014-02-16-2gb.img.xz

Verify Image with:

md5sum bbxm-debian-7.4-2014-02-16-2gb.img.xz
a118de7b1500489ecd4d7263dc06b037  bbxm-debian-7.4-2014-02-16-2gb.img.xz

Linux:

unxz bbxm-debian-7.4-2014-02-16-2gb.img.xz
sudo dd if=./bbxm-debian-7.4-2014-02-16-2gb.img of=/dev/sdX

BeagleBone/BeagleBone Black

This image can be written to a 2GB (or larger) microSD card, via 'dd' on linux or the win32 image program linked to on CircuitCo's wiki page. First press and hold the boot select button (next to microSD card), then apply power (same procedure as the official CircuitCo images). The board should boot into Debian.

User: debian pass: temppwd

root: root/root

Auto partition resize:

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

Image Updated:

  • 2014-02-16
    • BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
  • 2013-12-17
    • BeagleBone/BeagleBone Black: v3.8.13-bone32 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/microsd/wheezy/bone-debian-7.4-2014-02-16-2gb.img.xz

Verify Image with:

md5sum bone-debian-7.4-2014-02-16-2gb.img.xz
de60cb007a51d74ebe27411d3da76edf  bone-debian-7.4-2014-02-16-2gb.img.xz

Linux:

unxz bone-debian-7.4-2014-02-16-2gb.img.xz
sudo dd if=./bone-debian-7.4-2014-02-16-2gb.img of=/dev/sdX

Debian Configuration

Serial Ports

To start a login console on ttyO2 (the serial header next to P9), edit /etc/inittab and add:

T0:23:respawn:/sbin/getty -L ttyO2 115200 vt102

To start a console on the USB ACM device, add the following to /etc/inittab,

GS0:23:respawn:/sbin/getty -L ttyGS0 115200 vt102

Install Latest Kernel Image

Script:

cd /opt/scripts/tools
git pull

Stable:

./update_kernel.sh

Testing:

./update_kernel.sh --beta-kernel

Custom: (has to be on rcn-ee.net)

./update_kernel.sh --kernel v3.8.13-bone37

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

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