BeagleBoardDebian
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.
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.
Contents
Help
If you need any help:
- Kernel related help:
- Email Beagleboard user group *Recommended method
- #beagle: Beagle irc on freenode, accessible also by web interface (logs)
- Kernel Tree's
- 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)
Recommended Beagle Software
X-loader/MLO (1.4.4ss) & U-Boot (2010.03) (Zippy1 & Zippy2 Support)
- All Bx, C2/3/4 Boards are required to upgrade to atleast these MLO and U-Boot versions.
- XM Boards have no NAND, so u-boot.bin is always required on the first partition
- Directions: Upgrade X-loader and U-Boot
Debian NetInstall
You will need a 1GB SD card or greater.
Standard System : ~455MB + Desktop environment (GNOME) : ~2.9GB
Debian Squeeze
git clone git://github.com/RobertCNelson/netinstall.git cd netinstall
Quick Install script for "board"
sudo ./mk_mmc.sh --mmc /dev/sdX --uboot "board" --distro squeeze
"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:
sudo ./mk_mmc.sh --mmc /dev/sdX --uboot beagle_xm --distro squeeze
- Options:
- --uboot : beagle, panda, bone
- --distro : squeeze
- --firmware : installs firmware
- --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..
Beagleboard: NetInstall
Choose a language C - No localization English - English
Configure the network: usb0: USB net <- (usually the OTG port, but could also be the smsc95xx adapter on the beagle and panda) usb1: USB net <- (usually the smsc95xx adapter on the beagle and panda, when usb0 exist) eth0: Ethernet <- Your usb-ethernet device 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.. --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>
Beagleboard: Install Latest Kernel
Script File:
Lenny: wget http://rcn-ee.net/deb/lenny/v2.6.39.3-old3/install-me.sh sudo /bin/bash install-me.sh Squeeze: export DIST=squeeze export ARCH=armel Beagle/Panda export BOARD=omap BeagleBone export BOARD=omap-psp wget http://rcn-ee.net/deb/${DIST}-${ARCH}/LATEST-${BOARD} wget $(cat ./LATEST-${BOARD} | grep STABLE | awk '{print $3}') /bin/bash install-me.sh
Reboot with your new Kernel
Debian armhf port
Port Details: http://wiki.debian.org/ArmHardFloatPort
Status: http://wiki.debian.org/ArmHardFloatTodo
Demo Image
Debian Wheezy snapshot
Default username/password:
- username: debian
- password: temppwd
Default root user/password
- user: root
- password: root
Image Updated:
- March 29th: 2012-03-29
- Beagle/Panda: v3.2.13-x7 kernel (panda bluetooth now works "sudo apt-get install bluetooth" + "uim" to get all the userspace programs)
- uim: git clone git://gitorious.org/uim/uim.git ; cd uim ; make ; sudo make install
- Beagle/Panda: v3.2.13-x7 kernel (panda bluetooth now works "sudo apt-get install bluetooth" + "uim" to get all the userspace programs)
add: /etc/udev/rules.d/bluetooth.rules
ACTION=="add", SUBSYSTEM=="platform", ENV{MODALIAS}=="platform:kim", RUN+="/sbin/initctl emit enable-ti-bt"
- Bone: v3.2.0-psp6 kernel (for users with usb problems, still no good solution yet..)
- March 8th: 2012-03-08
- Beagle/Panda: fix serial omap regression in v3.2.9 kernel
- March 6th: 2012-03-06
- Beagle/Panda: v3.2.9 kernel
- fixed missing dhclient package (backport from sid)
- March 2nd: 2012-03-02
- Beagle/Panda: v3.2.7 kernel
- Feb 5th: 2012-02-05
- Beagle: v3.2.3 kernel with sgx driver fix (bug in 2012-02-03 tar file)
- Feb 3rd: 2012-02-03
- Switched image to wheezy from sid..
- Beagle/Panda: v3.2.2 kernel, ulcd now aligned and touch works
- BeagleBone: v3.2 kernel, usb works much better, dvi cape works (thanks koen)
- Dec 7:
- Switched image to sid from ports/unstable..
Services Active:
Note: Depending on your internal network these may work out the box SSH, Port 22: ssh ubuntu@omap Getty, Serial Port
Get prebuilt image:
wget http://rcn-ee.net/deb/rootfs/wheezy/debian-wheezy-minimal-armhf-2012-03-29.tar.xz mirrors (will take some time to update): wget http://ynezz.ibawizard.net/beagleboard/wheezy/debian-wheezy-minimal-armhf-2012-03-29.tar.xz
Verify Image with:
md5sum debian-wheezy-minimal-armhf-2012-03-29.tar.xz 02bddec85f416ab1ece42f16b9eb46e2 debian-wheezy-minimal-armhf-2012-03-29.tar.xz
Unpack Image:
tar xJf debian-wheezy-minimal-armhf-2012-03-29.tar.xz cd debian-wheezy-minimal-armhf-2012-03-29
Install Image:
Quick Install script for "board"
sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot "board"
"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:
sudo ./setup_sdcard.sh --mmc /dev/sdX --uboot beagle_xm
- Additional Options
- --rootfs <ext4 default>
- --swap_file <swap file size in MB's>
- --addon pico <ti pico projector>
- --addon ulcd <CircuitCo 7 inch lcd>
- --svideo-ntsc <use ntsc over dvi for video)
- --svideo-pal <use pal over dvi for video)
Debian Configuration
Serial Ports
Lenny
edit /etc/inittab and add:
S:2345:respawn:/sbin/getty 115200 ttyS2
For root access over the serial port add ttyS2 to /etc/securetty
Squeeze
edit /etc/inittab and add:
S:2345:respawn:/sbin/getty 115200 ttyO2
WiFi
See BeagleBoard Debian WiFi install info.
SGX Video Acceleration
Requirements: 2.6-stable from launchpad or 2.6.35.3-x1+ deb's from rcn-ee.net. (the Demo Images hosted on rcn-ee.net meet this requirement)
https://github.com/RobertCNelson/stable-kernel
Note: An older version of these instructions was adapted for the IGEPv2 platform - if you are following this tutorial and have an IGEPv2, consider using http://wiki.jmaustin.org/wiki/IgepSGXUbuntu instead
SDK unPackage Script
Download the latest version of the "create_sgx_package.sh" script
2.6.37 wget https://github.com/RobertCNelson/stable-kernel/raw/master/create_sgx_package_2.6.37.sh 2.6.38+ wget https://github.com/RobertCNelson/stable-kernel/raw/master/create_sgx_package.sh
Make script executable
chmod a+x ./create_sgx_package.sh
Run script
./create_sgx_package.sh
After Successfully running:
:~/temp$ ls 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
tar xf GFX_4_00_00_01_libs.tar.gz (extracts install-SGX.sh and run-SGX.sh) ./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:
Stopping PVR Starting PVR Starting SGX fixup for ES2.x (or ES3.x) (or ES5.x xM)
Reboot for good measure
sudo reboot
Beagle: GFX_Linux_SDK.tar.gz
tar xf GFX_Linux_SDK.tar.gz cd GFX_Linux_SDK tar xf OGLES.tar.gz
Test SGX with a DEMO
cd OGLES/SDKPackage/Binaries/CommonX11/Demos/EvilSkull ./OGLESEvilSkull
Trouble Shooting
sudo rm /etc/powervr-esrev sudo depmod -a omaplfb sudo /etc/init.d/pvr restart
DSP
gst-dsp
Seems to work on all Beagle's, with atleast 2.6.38+ now...
Requirements: 2.6-stable from launchpad or 2.6.38+ deb's from rcn-ee.net. (the Demo Images hosted on rcn-ee.net meet this requirement)
https://github.com/RobertCNelson/stable-kernel
Download the latest version of the "create_dsp_package.sh" script
wget https://github.com/RobertCNelson/stable-kernel/raw/master/create_dsp_package.sh
Make script executable
chmod a+x ./create_dsp_package.sh
Package script:
./create_dsp_package.sh
Copy DSP_Install_libs.tar.gz to beagle
Setup network...
Extract:
tar xf DSP_Install_libs.tar.gz
Install
./install-DSP.sh
Build gst-dsp stuff..
./install-gst-dsp.sh
Playbin:
sudo gst-launch playbin2 uri=file://(file)
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..
/etc/X11/xorg.conf:
Section "Device" Identifier "Configured Video Device" Option "UseFBDev" "true" Driver "fbdev" EndSection
cat /var/log/Xorg.0.log | grep FBDEV
(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..
xvinfo -display :0.0
X-Video Extension version 2.2 screen #0 no adaptors present
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)
Lenny:
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:
sudo apt-get install xserver-xorg-video-omap3
xorg.conf
/etc/X11/xorg.conf
Section "Monitor" 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:
cat /var/log/Xorg.0.log | grep omapfb
(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
https://github.com/RobertCNelson/stable-kernel
Download SRC
git clone git://github.com/RobertCNelson/stable-kernel.git
Build Kernel
./build_kernel.sh
Optional Building Deb File
./build_deb.sh
Upgrading from Debian 5 to Debian 6
Upgrading from Debian 5 to Debian 6 report and tutorial.