Difference between revisions of "BeagleBoardDebian"

From eLinux.org
Jump to: navigation, search
m (Debian Squeeze: more then ralink)
m (2014-04-18)
(168 intermediate revisions by 11 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]]. To prepare the SD card and install (ARM EABI) Debian on it, [http://bellard.org/qemu/ QEMU] on host PC will be used, following Aurélien Jarno's excellent [http://www.aurel32.net/info/debian_arm_qemu.php Debian on an emulated ARM machine] howto.
+
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]
+
= Debian NetInstall =  
  
= Native Net Install =
+
Scripts:
 +
git clone https://github.com/RobertCNelson/netinstall.git
 +
cd netinstall
  
==Development PC: Format SD Card==
+
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 45: 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 ===
+
*Options:
cd /media/disk/
+
**--firmware : installs firmware
sudo wget http://rcn-ee.net/deb/kernel/CC-beagle-v2.6.29-58cf2f1-oer44.1.uImage
+
**--serial-mode : debian-installer uses Serial Port
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:
+
= Demo Image =
  
Debian Install over DVI Port
+
== Debian Stable (wheezy) ==
  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
+
Default username/password:
sudo nano netinstall.cmd
+
*username: debian
setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; fatload mmc 0:1 0x81600000 initrd.pad; bootm 0x80300000'
+
*password: temppwd
setenv bootargs 'console=ttyS2,115200n8 ramdisk_size=8192 root=/dev/ram0 rw rootfstype=ext2 initrd=0x81600000,8M'
 
boot
 
  
Create U-boot *.scr file:
+
Image Updated:
 +
*2014-04-18
 +
** Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
 +
*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
  
  sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./netinstall.cmd ./boot.scr
+
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
  
Sync and Unmount your mmc card and boot the beagle, it should find the 'boot.scr' file on your first partition while booting.
+
Default user: debian pass: temppwd
  
=== Debian Squeeze ===
+
Get prebuilt image:
(Testing Release Summer 2010?)
+
  wget https://rcn-ee.net/deb/rootfs/wheezy/debian-7.4-console-armhf-2014-04-18.tar.xz
  https://code.launchpad.net/~beagleboard-kernel/+junk/debian-di
 
 
bzr branch lp:~beagleboard-kernel/+junk/debian-di
 
cd debian-dl
 
./mk_mmc.sh --mmc /dev/sdX --distro squeeze
 
  
*Options:
+
Verify Image with:
**--distro : lucid, sid, squeeze
+
md5sum debian-7.4-console-armhf-2014-04-18.tar.xz
**--firmware : installs firmware
+
e189927a635c90f462c55a74f9e05337  debian-7.4-console-armhf-2014-04-18.tar.xz
**--dvi-mode : default, debian-installer uses DVI monitor
 
**--serial-mode : debian-installer uses Serial Port
 
  
==Beagleboard: netinstall==
+
Unpack Image:
 +
tar xf debian-7.4-console-armhf-2014-04-18.tar.xz
 +
cd debian-7.4-console-armhf-2014-04-18
  
Choose a language
+
Install Image:
  C - No localization
 
  English - English
 
  
  Configure the network:
+
Quick install script for [board]
  usb0: USB net <- See below for 2.6.29. Could not find usb0 with B7 installing 2.6.28.
+
  sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot board
  eth0: Ethernet <- Your usb-ethernet device
 
  wlan0: Wifi <- Your usb-wifi device.. See [[BeagleBoardDebianWifiInstallInfo]] for my hack to set it up.
 
  
Configuring usb0 network bridge for 2.6.29:
+
[board] options:
  While you chose your keyboard layout, setup a bridge with ethX and usbX.
+
*BeagleBone/Black    - bone
  # 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>
+
So for the BeagleBone:
 +
sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot bone
  
  Partition disks: This partitioner doesn't have the inform.....? : <yes>
+
Quick install script for [board] (using new --dtb option)
  Logical Volume Manager not available: <Continue>
+
  sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb board
  
Partition disks:
+
board options:
  Guided - Use the largest continuous free space
+
*BeagleBoard Ax/Bx/Cx/Dx    - omap3-beagle
 +
*BeagleBoard xM            - omap3-beagle-xm
  
  Partitioning scheme....
+
So for the BeagleBoard xM:
 +
  sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb omap3-beagle-xm
  
Example:
+
Advanced: Build 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? :
+
Built with a fork of project-rootstock (ARM native mode, runs directly on BeagleBoard), using a script from omap-image-builder:
  Continue without installing a kernel? : <yes>
 
  
  Standard System
+
  git clone https://github.com/RobertCNelson/omap-image-builder.git
 +
cd omap-image-builder
 +
git checkout v2014.04.1 -b tmp
 +
touch release
 +
./rcn-ee_image.sh
  
No BootLoader: <ok>
+
== Debian Testing (jessie) ==
  
==Development PC: Setup U-boot for Normal Boot==
+
Image Updated:
 +
*2014-04-18
 +
** Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
 +
*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
  
Create a U-boot normal boot script:
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/rootfs/jessie/debian-jessie-console-armhf-2014-04-18.tar.xz
  
DVI Port
+
Verify Image with:
  sudo nano normal.cmd
+
  md5sum debian-jessie-console-armhf-2014-04-18.tar.xz
  setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
+
  5d445652d214d00a0892268ea4dcaec3 debian-jessie-console-armhf-2014-04-18.tar.xz
  setenv bootargs 'console=tty0 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro omapfb.mode=dvi:1280x720MR-16@60'
 
boot
 
  
Serial Port
+
Unpack image:
  sudo nano normal.cmd
+
  tar xf debian-jessie-console-armhf-2014-04-18.tar.xz
  setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
+
  cd debian-jessie-console-armhf-2014-04-18
setenv bootargs 'console=ttyS2,115200n8 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro'
 
boot
 
  
Create U-boot *.scr file:
+
Then follow the directions shown above with the other images...
  
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./normal.cmd ./boot.scr
+
= Flasher =
  
Debian will fix the ext3 partition, it'll try to reboot, after halting remove and reapply power.
+
== eMMC: BeagleBone Black ==
  
==Beagleboard: install kernel-image==
+
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 File===
+
Script for reference: (this is the script that writes to the eMMC)
Every Kernel upload going further on rcn-ee.net will now have an 'install-me.sh' file in the same directory..
+
https://github.com/RobertCNelson/boot-scripts/blob/master/tools/beaglebone-black-eMMC-flasher.sh
  
example: http://www.rcn-ee.net/deb/kernel/beagle/lenny/v2.6.32.6-x6.2/
+
BTW: we are only writing about 500 megabytes to the eMMC, so the script will only take about 5-6 Minutes after power on.
 
wget http://rcn-ee.net/deb/kernel/beagle/lenny/v2.6.32.6-x6.2/install-me.sh
 
sudo /bin/bash install-me.sh
 
  
Reboot with your new uImage
+
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...)
  
= Debian Configuration =
+
User: debian
 +
pass: temppwd
  
== Serial Ports ==
+
Image Updated:
 +
*2014-04-18
 +
** BeagleBone Black: v3.8.13-bone47 kernel
 +
*2014-02-16
 +
** BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** BeagleBone Black: v3.8.13-bone37 kernel
  
Lenny
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/flasher/wheezy/BBB-eMMC-flasher-debian-7.4-2014-04-18-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-04-18-2gb.img.xz
 +
a87a9d10203047c522f37a8ad4518952  BBB-eMMC-flasher-debian-7.4-2014-04-18-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-04-18-2gb.img.xz
 +
sudo dd if=./BBB-eMMC-flasher-debian-7.4-2014-04-18-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
+
Auto partition resize:
 +
cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 +
sudo reboot
  
https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-stable
+
Image Updated:
 +
*2014-04-18
 +
** Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
 +
*2014-02-16
 +
** Beagle/Beagle xM: v3.13.3-armv7-x10 kernel
  
Copy uImage and modules from the deploy directory to your SD card.
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/microsd/wheezy/bbxm-debian-7.4-2014-04-18-2gb.img.xz
  
Copy the GFX_Linux_SDK.tar.gz examples to either your SD card or another media (large file) then boot your omap board.
+
Verify Image with:
 +
md5sum bbxm-debian-7.4-2014-04-18-2gb.img.xz
 +
fab897c791cbca729d1516d52fdc9ac0  bbxm-debian-7.4-2014-04-18-2gb.img.xz
  
Run depmod:
+
Linux:
  sudo depmod -a omaplfb
+
unxz bbxm-debian-7.4-2014-04-18-2gb.img.xz
 +
  sudo dd if=./bbxm-debian-7.4-2014-04-18-2gb.img of=/dev/sdX
  
Tweak System Libraries:
+
== BeagleBone/BeagleBone Black ==
sudo ln -sf /usr/lib/libXdmcp.so.6.0.0 /usr/lib/libXdmcp.so.0
 
sudo ln -sf /usr/lib/libXau.so.6.0.0 /usr/lib/libXau.so.0
 
  
=== Startup 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 microSD card), then apply power (same procedure as the official CircuitCo images).  The board should boot into Debian.
  
For 3.01.00.02
+
User: debian
 +
pass: temppwd
  
Lenny:
+
Auto partition resize:
  sudo nano /etc/rcS.d/S60pvr.sh
+
  cd /opt/scripts/tools
  sudo chmod +x /etc/rcS.d/S60pvr.sh
+
git pull
 +
./grow_partition.sh
 +
  sudo reboot
  
Squeeze: (probally lenny too)
+
Image Updated:
sudo nano /etc/init.d/pvr
+
*2014-04-18
sudo chmod +x /etc/init.d/pvr
+
** BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
sudo update-rc.d pvr defaults
+
*2014-02-16
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
 +
*2014-01-24
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel
  
Contents of S60pvr.sh/pvr
+
Get prebuilt image:
  #!/bin/sh
+
  wget https://rcn-ee.net/deb/microsd/wheezy/bone-debian-7.4-2014-04-18-2gb.img.xz
 
if [ "$1" = "" ]; then
 
echo PVR-INIT: Please use start, stop, or restart.
 
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 ===
+
Verify Image with:
 +
md5sum bone-debian-7.4-2014-04-18-2gb.img.xz
 +
23d5d6490b3a0f0447a866349d3c4ff2  bone-debian-7.4-2014-04-18-2gb.img.xz
  
In GFX_Linux_SDK:
+
Linux:
  cd OGLES/SDKPackage/Binaries/CommonX11/Demos/ChameleonMan
+
  unxz bone-debian-7.4-2014-04-18-2gb.img.xz
  ./OGLESChameleonMan
+
  sudo dd if=./bone-debian-7.4-2014-04-18-2gb.img of=/dev/sdX
  
=== Trouble Shooting ===
+
= Debian Configuration =
  
sudo rm /etc/powervr-esrev
+
== Serial Ports ==
sudo depmod -a omaplfb
 
sudo /etc/init.d/pvr restart
 
 
 
== Xorg omapfb Drivers ==
 
 
 
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.
 
  
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 19:01, 18 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

Image Updated:

  • 2014-04-18
    • Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
  • 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

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-04-18.tar.xz

Verify Image with:

md5sum debian-7.4-console-armhf-2014-04-18.tar.xz
e189927a635c90f462c55a74f9e05337  debian-7.4-console-armhf-2014-04-18.tar.xz

Unpack Image:

tar xf debian-7.4-console-armhf-2014-04-18.tar.xz
cd debian-7.4-console-armhf-2014-04-18

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.04.1 -b tmp
touch release
./rcn-ee_image.sh

Debian Testing (jessie)

Image Updated:

  • 2014-04-18
    • Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
  • 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

Get prebuilt image:

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

Verify Image with:

md5sum debian-jessie-console-armhf-2014-04-18.tar.xz
5d445652d214d00a0892268ea4dcaec3  debian-jessie-console-armhf-2014-04-18.tar.xz

Unpack image:

tar xf debian-jessie-console-armhf-2014-04-18.tar.xz
cd debian-jessie-console-armhf-2014-04-18

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

Image Updated:

  • 2014-04-18
    • BeagleBone Black: v3.8.13-bone47 kernel
  • 2014-02-16
    • BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • BeagleBone Black: v3.8.13-bone37 kernel

Get prebuilt image:

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

Verify Image with:

md5sum BBB-eMMC-flasher-debian-7.4-2014-04-18-2gb.img.xz
a87a9d10203047c522f37a8ad4518952  BBB-eMMC-flasher-debian-7.4-2014-04-18-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-04-18-2gb.img.xz
sudo dd if=./BBB-eMMC-flasher-debian-7.4-2014-04-18-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

Auto partition resize:

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

Image Updated:

  • 2014-04-18
    • Beagle/Beagle xM: v3.13.10-armv7-x11 kernel
  • 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-04-18-2gb.img.xz

Verify Image with:

md5sum bbxm-debian-7.4-2014-04-18-2gb.img.xz
fab897c791cbca729d1516d52fdc9ac0  bbxm-debian-7.4-2014-04-18-2gb.img.xz

Linux:

unxz bbxm-debian-7.4-2014-04-18-2gb.img.xz
sudo dd if=./bbxm-debian-7.4-2014-04-18-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

Auto partition resize:

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

Image Updated:

  • 2014-04-18
    • BeagleBone/BeagleBone Black: v3.8.13-bone47 kernel
  • 2014-02-16
    • BeagleBone/BeagleBone Black: v3.8.13-bone40 kernel
  • 2014-01-24
    • BeagleBone/BeagleBone Black: v3.8.13-bone37 kernel

Get prebuilt image:

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

Verify Image with:

md5sum bone-debian-7.4-2014-04-18-2gb.img.xz
23d5d6490b3a0f0447a866349d3c4ff2  bone-debian-7.4-2014-04-18-2gb.img.xz

Linux:

unxz bone-debian-7.4-2014-04-18-2gb.img.xz
sudo dd if=./bone-debian-7.4-2014-04-18-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