Difference between revisions of "BeagleBoardDebian"

From eLinux.org
Jump to: navigation, search
m (Debian Lenny: goodbye lenny..)
m (copy/paste error on md5sum)
(152 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]]. 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.
 
  
 
= 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 Stable Kernel 2.6.36 src]
+
*** [https://github.com/RobertCNelson/armv7-multiplatform/ v3.14.x kernel branch]
*** [https://code.launchpad.net/~beagleboard-kernel/+junk/2.6.38-devel Development Kernel src]
+
*** [https://github.com/RobertCNelson/linux-dev Development Kernel source code]
** [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 24: 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 =  
  
X-loader/MLO (1.4.4ss) & U-Boot (2010.03) (Zippy1 & Zippy2 Support)
+
Mainline U-Boot:
* All Bx, C2/3/4 Boards are required to upgrade to atleast these MLO and U-Boot versions.
+
* 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 u-boot.bin is always required on the first partition
+
* XM Boards have no NAND, so MLO/u-boot.img is always required on the first partition
 
* Directions: [http://elinux.org/BeagleBoardUbuntu#Upgrade_X-loader_and_U-boot Upgrade X-loader and U-Boot]
 
* Directions: [http://elinux.org/BeagleBoardUbuntu#Upgrade_X-loader_and_U-boot Upgrade X-loader and U-Boot]
  
 
= 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
 +
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 38: Line 52:
 
  + Desktop environment (GNOME) : ~2.9GB
 
  + Desktop environment (GNOME) : ~2.9GB
  
== Debian Squeeze ==
+
== Debian Wheezy ==
  
  git clone git://github.com/RobertCNelson/netinstall-omap.git
+
Quick Install script for "board"
cd netinstall-omap
+
  sudo ./mk_mmc.sh --mmc /dev/sdX --dtb "board" --distro wheezy-armhf
  ./mk_mmc.sh --mmc /dev/sdX --uboot beagle --distro squeeze --firmware
+
 
 +
So For the BeagleBoard xM:
 +
  sudo ./mk_mmc.sh --mmc /dev/sdX --dtb omap3-beagle-xm --distro wheezy-armhf
  
 
*Options:
 
*Options:
**--uboot : beagle, (panda only serial, display not working)
 
**--distro : squeeze
 
 
**--firmware : installs firmware
 
**--firmware : installs firmware
 
**--serial-mode : debian-installer uses Serial Port
 
**--serial-mode : debian-installer uses Serial Port
**--usb-rootfs : (uImage on /dev/mmcblkp0 and rootfs on external usb drive /dev/sda1)
 
  
Note: The default options work for most people, but if you'd like to tweak boot settings, edit these before running the script.
+
= Demo Image =
 
NetInstall boot Settings:
 
gedit ./netinstall-omap/scripts/dvi.cmd
 
gedit ./netinstall-omap/scripts/serial.cmd
 
 
Normal Boot Settings:
 
gedit ./netinstall-omap/scripts/dvi-normal-squeeze.cmd
 
gedit ./netinstall-omap/scripts/serial-normal-squeeze.cmd
 
  
==Beagleboard: NetInstall==
+
== Debian Stable (wheezy)  ==
  
Choose a language
+
Default username/password:
  C - No localization
+
*username: debian
  English - English
+
*password: temppwd
  
Configure the network:
+
Image Updated:
  usb0: USB net <- See below for 2.6.29. Could not find usb0 with B7 installing 2.6.28.
+
*2014-07-06
  eth0: Ethernet <- Your usb-ethernet device
+
** repo now enabled (repos.rcn-ee.net/debian)
  wlan0: Wifi <- Your usb-wifi device.. See [[BeagleBoardDebianWifiInstallInfo]] for my hack to set it up.
+
** Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
 +
** OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
 +
*2014-06-05
 +
** Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
 +
** OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel
 +
*2014-05-06
 +
** Beagle/Beagle xM: v3.14.2-armv7-x5 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone49 kernel
  
===usb0 howto===
+
Services Active:
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)
+
Note: Depending on your internal network these may work out of the box
 +
Apache, Port 80: http://arm.local/ (Bone: via usb) http://192.168.7.2
 +
SSH, Port 22: ssh debian@arm.local (Bone: via usb) debian@192.168.7.2
 +
Getty, Serial Port
  
Configuring usb0 network bridge for 2.6.29:
+
Default user: debian pass: temppwd
  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>
+
Get prebuilt image:
 +
  wget https://rcn-ee.net/deb/rootfs/wheezy/debian-7.5-console-armhf-2014-07-06.tar.xz
  
  Partition disks: This partitioner doesn't have the inform.....? : <yes>
+
Verify Image with:
  Logical Volume Manager not available: <Continue>
+
  md5sum debian-7.5-console-armhf-2014-07-06.tar.xz
 +
a21ea24a1b58a940e87074eee7cc6c09  debian-7.5-console-armhf-2014-07-06.tar.xz
  
  Partition disks:
+
Unpack Image:
  Guided - Use the largest continuous free space
+
  tar xf debian-7.5-console-armhf-2014-07-06.tar.xz
 +
cd debian-7.5-console-armhf-2014-07-06
  
Partitioning scheme....
+
Install Image:
  
Example:
+
Quick install script for [board]
  MMC/SD card #1 (mmcblk0) - 2.0 GB Unknown
+
  sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb board
>  #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? :  
+
board options:
  Continue without installing a kernel? : <yes>
+
*BeagleBoard Ax/Bx/Cx/Dx    - omap3-beagle
 +
*BeagleBoard xM            - omap3-beagle-xm
 +
*BeagleBone/Black          - beaglebone
 +
*OMAP5432 uEVM              - omap5-uevm
  
  Standard System
+
So for the BeagleBoard xM:
 +
  sudo ./setup_sdcard.sh --mmc /dev/sdX --dtb omap3-beagle-xm
  
No BootLoader: <ok>
+
Advanced: Build Image:
  
==Development PC: Setup U-boot for Normal Boot==
+
Built with a fork of project-rootstock (ARM native mode, runs directly on BeagleBoard), using a script from omap-image-builder:
  
(IGNORE WITH SQUEEZE)
+
git clone https://github.com/RobertCNelson/omap-image-builder.git
 +
cd omap-image-builder
 +
git checkout v2014.07 -b tmp
  
Planning to remove this section, pending Squeeze's Release...  I moved the relevant data to: http://elinux.org/BeagleBoardDebian#U-boot_Scripts
+
Stable:
  
Create a U-boot normal boot script:
+
./RootStock-NG.sh -c rcn-ee_console_debian_stable_armhf
  
DVI Port
+
Testing:
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
+
  ./RootStock-NG.sh -c rcn-ee_console_debian_testing_armhf
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:
+
== Debian Testing (jessie) ==
  
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./normal.cmd ./boot.scr
+
Image Updated:
 +
*2014-07-06
 +
** repo now enabled (repos.rcn-ee.net/debian)
 +
** Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
 +
** OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
 +
*2014-06-05
 +
** Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
 +
** OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel
 +
*2014-05-06
 +
** Beagle/Beagle xM: v3.14.2-armv7-x5 kernel
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone49 kernel
  
Debian will fix the ext3 partition, it'll try to reboot, after halting remove and reapply power.
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/rootfs/jessie/debian-jessie-console-armhf-2014-07-06.tar.xz
  
==Beagleboard: Install Latest Kernel==
+
Verify Image with:
 +
md5sum debian-jessie-console-armhf-2014-07-06.tar.xz
 +
21bffa6ea4fb6242a684a507f2f54518  debian-jessie-console-armhf-2014-07-06.tar.xz
  
Script File:
+
Unpack image:
 +
tar xf debian-jessie-console-armhf-2014-07-06.tar.xz
 +
cd debian-jessie-console-armhf-2014-07-06
  
Lenny:
+
Then follow the directions shown above with the other images...
wget http://rcn-ee.net/deb/kernel/beagle/lenny/v2.6.32.11-x13/install-me.sh
 
sudo /bin/bash install-me.sh
 
 
Squeeze:
 
export DIST=squeeze
 
wget http://rcn-ee.net/deb/${DIST}/LATEST
 
wget $(cat ./LATEST | grep STABLE | awk '{print $3}')
 
/bin/bash install-me.sh
 
  
Reboot with your new Kernel
+
= Flasher =
  
= Debian Configuration =
+
== 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/eMMC/init-eMMC-flasher-v2.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
  
== U-boot Scripts ==
+
Image Updated:
 +
*2014-07-06
 +
** repo now enabled (repos.rcn-ee.net/debian)
 +
** BeagleBone Black: v3.8.13-bone59 kernel
 +
** NOTE: You'll need to hold the BOOT button on powerup...
 +
*2014-06-05
 +
** BeagleBone Black: v3.8.13-bone56 kernel
 +
*2014-05-06
 +
** BeagleBone Black: v3.8.13-bone49 kernel
  
Create a U-boot normal boot script:
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/flasher/wheezy/BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
DVI Port
+
Verify Image with:
  sudo nano normal.cmd
+
  md5sum BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
+
  0881f59320e9d5e8ab515efd7f74ff7c BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  setenv bootargs 'console=tty0 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro omapfb.mode=dvi:1280x720MR-16@60'
 
boot
 
  
Serial Port
+
Follow the "standard" update procedure.
sudo nano normal.cmd
+
  http://elinux.org/Beagleboard:Updating_The_Software
  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:
+
Linux:
 +
unxz BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
sudo dd if=./BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img of=/dev/sdX
  
sudo mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Debian Lenny" -d ./normal.cmd ./boot.scr
+
= raw microSD img =
  
Debian will fix the ext3 partition, it'll try to reboot, after halting remove and reapply power.
+
== BeagleBoard xM ==
  
== Serial Ports ==
+
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
 +
pass: temppwd
  
edit /etc/inittab and add:
+
Auto partition resize:
  S:2345:respawn:/sbin/getty 115200 ttyS2
+
cd /opt/scripts/tools
 +
git pull
 +
  ./grow_partition.sh
 +
sudo reboot
  
For root access over the serial port add ttyS2 to /etc/securetty
+
Image Updated:
 +
*2014-07-06
 +
** repo now enabled (repos.rcn-ee.net/debian)
 +
** Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
 +
*2014-06-05
 +
** Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
 +
*2014-05-06
 +
** Beagle/Beagle xM: v3.14.2-armv7-x5 kernel
  
== WiFi ==
+
Get prebuilt image:
 +
wget https://rcn-ee.net/deb/microsd/wheezy/bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
See [[BeagleBoardDebianWifiInstallInfo|BeagleBoard Debian WiFi install info]].
+
Verify Image with:
 +
md5sum bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
ef740693e15f4a1d64f799464ca64301  bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
== SGX Video Acceleration ==
+
Linux:
 +
unxz bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
sudo dd if=./bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img of=/dev/sdX
  
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)
+
== BeagleBone/BeagleBone Black ==
  https://code.launchpad.net/~beagleboard-kernel/+junk/2.6-stable
 
  
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''
+
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.
  
=== SDK unPackage Script ===
+
User: debian
 +
pass: temppwd
  
Download the latest version of the "create_sgx_package.sh" script
+
Auto partition resize:
  wget http://rcn-ee.homeip.net:81/dl/updates/2.6-stable/create_sgx_package.sh
+
  cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 +
sudo reboot
  
Make script executable
+
Image Updated:
chmod a+x ./create_sgx_package.sh
+
*2014-07-06
 +
** repo now enabled (repos.rcn-ee.net/debian)
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
 +
** Black: NOTE: You'll need to hold the BOOT button on powerup...
 +
*2014-06-05
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
 +
*2014-05-06
 +
** BeagleBone/BeagleBone Black: v3.8.13-bone49 kernel
  
Run script
+
Get prebuilt image:
  ./create_sgx_package.sh
+
  wget https://rcn-ee.net/deb/microsd/wheezy/bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
After Successfully running:
+
Verify Image with:
 +
md5sum bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
8a9eacc38febbbdf62e9b73fad725f25  bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
:~/temp$ ls
+
Linux:
  create_sgx_package.sh
+
  unxz bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
GFX_4_00_00_01_libs.tar.gz                      : -> Copy to Beagle (System Libs)
+
  sudo dd if=./bone-debian-7.5-console-armhf-2014-07-06-2gb.img of=/dev/sdX
  GFX_Linux_SDK.tar.gz                            : -> Copy to Beagle (DEMO's)
 
Graphics_SDK_setuplinux_4_00_00_01.bin
 
SDK
 
SDK_BIN
 
  
=== Beagle: GFX_*_libs.tar.gz ===
+
== OMAP5432 uEVM ==
  
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 the win32 image program linked to on CircuitCo's wiki pageFirst 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.
./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 (Maverick's Alpha-1 needs this....)
+
Auto partition resize:
 +
cd /opt/scripts/tools
 +
git pull
 +
./grow_partition.sh
 
  sudo reboot
 
  sudo reboot
  
=== Beagle: GFX_Linux_SDK.tar.gz ===
+
Image Updated:
 +
*2014-07-06
 +
** repo now enabled (repos.rcn-ee.net/debian)
 +
** OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
 +
*2014-06-05
 +
** OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel
  
  tar xf GFX_Linux_SDK.tar.gz
+
Get prebuilt image:
cd GFX_Linux_SDK
+
  wget https://rcn-ee.net/deb/microsd/wheezy/omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
tar xf OGLES.tar.gz
 
  
=== Test SGX with a DEMO ===
+
Verify Image with:
 +
md5sum omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
0db89db84fea0e5f3a533cc0f55a974f  omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
  
  cd OGLES/SDKPackage/Binaries/CommonX11/Demos/ChameleonMan
+
Linux:
  ./OGLESChameleonMan
+
  unxz omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
 +
  sudo dd if=./omap5-uevm-debian-7.5-console-armhf-2014-07-06-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 ==
+
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
  
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.
+
To start a console on the USB ACM device, add the following to /etc/inittab,
 +
GS0:23:respawn:/sbin/getty -L ttyGS0 115200 vt102
  
Lenny might need this xorg.conf, but it's best to use omapfb later in this guide..
+
==Install Latest Kernel Image==
  
/etc/X11/xorg.conf:
+
Script:
Section "Device"
+
cd /opt/scripts/tools
Identifier "Configured Video Device"
+
  git pull
Option "UseFBDev" "true"
 
Driver "fbdev"
 
  EndSection
 
  
cat /var/log/Xorg.0.log | grep FBDEV
+
Stable:
(II) FBDEV: driver for framebuffer: fbdev
+
  ./update_kernel.sh
  (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..
+
Testing:
 +
./update_kernel.sh --beta-kernel
  
xvinfo -display :0.0
+
Custom: (has to be on rcn-ee.net)
  X-Video Extension version 2.2
+
  ./update_kernel.sh --kernel v3.8.13-bone59
screen #0
 
  no adaptors present
 
  
=== Drivers ===
+
Reboot with your new Kernel Image.
  
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)
+
== Xorg Drivers ==
  
Lenny:
+
Script:
  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/
  sudo dpkg -i xserver-xorg-video-omap3_0.1.1-2_armel.deb
+
  git pull
  
Squeeze/Sid:
+
BeagleBoard/PandaBoard:
  sudo apt-get install xserver-xorg-video-omap3
+
  cd /opt/scripts/tools/graphics/
 +
./ti-omapdrm.sh
  
=== xorg.conf ===
+
BeagleBone/BeagleBone Black:
/etc/X11/xorg.conf
+
cd /opt/scripts/tools/graphics/
 +
./ti-tilcdc.sh
  
Section "Monitor"
+
== SGX Drivers ==
    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:
+
=== SGX BeagleBone/BeagleBone Black ===
  
cat /var/log/Xorg.0.log | grep omapfb
+
Note, these are FBDEV only, no xorg/x11/etc...
(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..
+
Install "special" Kernel
 +
cd /opt/scripts/tools
 +
git pull
 +
sudo ./update_kernel.sh --kernel v3.13.11-bone12
  
xvinfo -display :0.0
+
Build SGX modules/userspace (must be done on an x86, due to the TI 5.01.01.01 blob extractor)
  X-Video Extension version 2.2
+
  git clone https://github.com/RobertCNelson/bb-kernel.git
  screen #0
+
  cd bb-kernel/
  Adaptor #0: "OMAP XV adaptor"
+
git checkout origin/am33x-v3.13 -b tmp-sgx
    number of ports: 1
+
./build_kernel.sh
    port base: 56
+
./sgx_build_modules.sh
    operations supported: PutImage
 
    supported visuals:
 
      depth 16, visualID 0x21
 
    number of attributes: 1
 
    etc..
 
  
== DSP ==
+
Copy ./deploy/GFX_5.01.01.01.tar.gz to BeagleBone/BeagleBone Black and install
 +
sudo tar xfv GFX_5.01.01.01.tar.gz -C /
 +
cd /opt/gfxinstall/
 +
sudo ./sgx-install.sh
 +
sudo reboot
  
= Kernel Build =
+
Verify omaplfb & pvrsrvkm loaded
 +
debian@arm:~$ lsmod | grep omaplfb
 +
omaplfb                12065  0
 +
pvrsrvkm              178782  1 omaplfb
  
https://launchpad.net/~beagleboard-kernel
+
SGX Demos
 +
cd /opt/gfxsdkdemos/ogles2/
 +
./OGLES2ChameleonMan
  
Register on launchpad.net, install bzr
+
= Building Kernel =
sudo apt-get install bzr
 
  
Download SRC
+
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:
bzr branch lp:~beagleboard-kernel/+junk/2.6-stable
 
  
Build Kernel
+
== Beagle/Beagle xM ==
  ./build_kernel.sh
+
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 =
 +
 
 +
[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...
  
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 14:59, 9 July 2014

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.

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-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
    • OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
  • 2014-06-05
    • Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
    • OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel
  • 2014-05-06
    • Beagle/Beagle xM: v3.14.2-armv7-x5 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone49 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) http://192.168.7.2
SSH, Port 22: ssh debian@arm.local (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.5-console-armhf-2014-07-06.tar.xz

Verify Image with:

md5sum debian-7.5-console-armhf-2014-07-06.tar.xz
a21ea24a1b58a940e87074eee7cc6c09  debian-7.5-console-armhf-2014-07-06.tar.xz

Unpack Image:

tar xf debian-7.5-console-armhf-2014-07-06.tar.xz
cd debian-7.5-console-armhf-2014-07-06

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
  • BeagleBone/Black - beaglebone
  • OMAP5432 uEVM - omap5-uevm

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.07 -b tmp

Stable:

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

Testing:

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

Debian Testing (jessie)

Image Updated:

  • 2014-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
    • OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
  • 2014-06-05
    • Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
    • OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel
  • 2014-05-06
    • Beagle/Beagle xM: v3.14.2-armv7-x5 kernel
    • BeagleBone/BeagleBone Black: v3.8.13-bone49 kernel

Get prebuilt image:

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

Verify Image with:

md5sum debian-jessie-console-armhf-2014-07-06.tar.xz
21bffa6ea4fb6242a684a507f2f54518  debian-jessie-console-armhf-2014-07-06.tar.xz

Unpack image:

tar xf debian-jessie-console-armhf-2014-07-06.tar.xz
cd debian-jessie-console-armhf-2014-07-06

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/eMMC/init-eMMC-flasher-v2.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-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • BeagleBone Black: v3.8.13-bone59 kernel
    • NOTE: You'll need to hold the BOOT button on powerup...
  • 2014-06-05
    • BeagleBone Black: v3.8.13-bone56 kernel
  • 2014-05-06
    • BeagleBone Black: v3.8.13-bone49 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/flasher/wheezy/BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Verify Image with:

md5sum BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
0881f59320e9d5e8ab515efd7f74ff7c  BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Follow the "standard" update procedure.

http://elinux.org/Beagleboard:Updating_The_Software

Linux:

unxz BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
sudo dd if=./BBB-eMMC-flasher-debian-7.5-console-armhf-2014-07-06-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-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • Beagle/Beagle xM: v3.15.3-armv7-x4 kernel
  • 2014-06-05
    • Beagle/Beagle xM: v3.14.5-armv7-x8 kernel
  • 2014-05-06
    • Beagle/Beagle xM: v3.14.2-armv7-x5 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/microsd/wheezy/bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Verify Image with:

md5sum bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
ef740693e15f4a1d64f799464ca64301  bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Linux:

unxz bbxm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
sudo dd if=./bbxm-debian-7.5-console-armhf-2014-07-06-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-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • BeagleBone/BeagleBone Black: v3.8.13-bone59 kernel
    • Black: NOTE: You'll need to hold the BOOT button on powerup...
  • 2014-06-05
    • BeagleBone/BeagleBone Black: v3.8.13-bone56 kernel
  • 2014-05-06
    • BeagleBone/BeagleBone Black: v3.8.13-bone49 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/microsd/wheezy/bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Verify Image with:

md5sum bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
8a9eacc38febbbdf62e9b73fad725f25  bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Linux:

unxz bone-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
sudo dd if=./bone-debian-7.5-console-armhf-2014-07-06-2gb.img of=/dev/sdX

OMAP5432 uEVM

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-07-06
    • repo now enabled (repos.rcn-ee.net/debian)
    • OMAP5432 uEVM: v3.15.3-armv7-lpae-x5 kernel
  • 2014-06-05
    • OMAP5432 uEVM: v3.15.0-rc8-armv7-lpae-x4 kernel

Get prebuilt image:

wget https://rcn-ee.net/deb/microsd/wheezy/omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Verify Image with:

md5sum omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
0db89db84fea0e5f3a533cc0f55a974f  omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz

Linux:

unxz omap5-uevm-debian-7.5-console-armhf-2014-07-06-2gb.img.xz
sudo dd if=./omap5-uevm-debian-7.5-console-armhf-2014-07-06-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-bone59

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

Note, these are FBDEV only, no xorg/x11/etc...

Install "special" Kernel

cd /opt/scripts/tools
git pull
sudo ./update_kernel.sh --kernel v3.13.11-bone12

Build SGX modules/userspace (must be done on an x86, due to the TI 5.01.01.01 blob extractor)

git clone https://github.com/RobertCNelson/bb-kernel.git
cd bb-kernel/
git checkout origin/am33x-v3.13 -b tmp-sgx
./build_kernel.sh
./sgx_build_modules.sh

Copy ./deploy/GFX_5.01.01.01.tar.gz to BeagleBone/BeagleBone Black and install

sudo tar xfv GFX_5.01.01.01.tar.gz -C /
cd /opt/gfxinstall/
sudo ./sgx-install.sh
sudo reboot

Verify omaplfb & pvrsrvkm loaded

debian@arm:~$ lsmod | grep omaplfb
omaplfb                12065  0 
pvrsrvkm              178782  1 omaplfb

SGX Demos

cd /opt/gfxsdkdemos/ogles2/
./OGLES2ChameleonMan

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