-- coding: utf-8 --
.. title: pandaboard
##Ubuntu installation This guide is written following this guides
If you have problems installing Ubuntu on your Pandaboard refer to those guides
- sd-card more than 4GB,
- internal or external card reader (USB 3.0 pref.).
- internet connection (LAN or wifi)
You need to install hard-float version of Ubuntu: version 12.04. This because OF is configured for hard float for better performance.
You must download the zipped .img desktop from here
##Installing Ubuntu on the SDCard:
Place the SD card at your host computer.
Make sure the SD card is not mounted (just umount it if needed)
Identify the correct raw device name (like /dev/sde - not /dev/sde1). To know what the name of your (sd-card) launch in a terminal:
or use the utility disk application from the Desktop. Pay attention any wrongs could be dangerous here!
Run the following command from a terminal: (replacing sde with the right values )
zcat ./ubuntu-12.04-preinstalled-desktop-armhf+omap4.img.gz | sudo dd bs=4M of=/dev/sde ; sudo sync
Some people have reported issues with this method. If this doesn't work, try the following commands:
gunzip ubuntu-12.04-preinstalled-desktop-armhf+omap4.img.gz sudo dd bs=4M if=ubuntu-12.04-preinstalled-desktop-armhf+omap4.img of=/dev/sde sudo sync
locate the SD Card (look for /dev/diskN):
Unmount the disk where "N" is the number of the disk taken from the above command:
diskutil unmountDisk /dev/diskN
Use the following code to write the image to diskN:
dd bs=4m if=ubuntu-12.04-preinstalled-desktop-armhf+omap4.img of=/dev/diskN
- Download the image and extract it using WinZip or some other archive utility. Then use Win32ImageWriter to write the unzipped img file to your flash device.
- Follow the instruction on the help reference to burn the mage in the sdcard.
- You can download Win32ImageWriter from here.
##Installing Ubuntu from the sdcard
After copying ubuntu on the sdcard from your computer, eject your sd-card, insert it in your pandaboard, plug a keyboard and a mouse, plug a monitor on you hdmi. As you plug the voltage Ubuntu will start the booting process and loading the kernel. After that it will autoresize and create automatically the partition on your disk. In a few seconds you will see a window in your screen asking for the installation language . The configuration setup is started! follow all the instructions this part is super friendly. At the end it will ask to reboot. Do it and follow the next steps.
##Install OMAP4 addons Once the Pandaboard finished booting, follow those instruction to configure it.
Add TI OMAP release PPA
sudo su add-apt-repository ppa:tiomap-dev/release
Perform the upgrade
apt-get update apt-get dist-upgrade apt-get install ubuntu-omap4-extras
You can re-run a dist-upgrade for safety at the end, then reboot.
##Post Installation Important Information
After the installation/update, it is advised to log as default user and to execute:
On Panda 4430:
/usr/bin/alsaucm -c Panda set _verb HiFi
On PandaES 4460:
/usr/bin/alsaucm -c PandaES set _verb HiFi
Install new bootloaders: You need to force installation of new bootloaders (if any) through command:
sudo /usr/sbin/flash-kernel --update-bootloader
Change Ubuntu desktop: it is advised to use Ubuntu 2D instead of Ubuntu (3D) default UI. (Nevertheless, main compiz issues have been fixed)
Check dkms installation: in some cases, you might need to re-install dkms packages: after reboot, check if omapdrm_pvr module is loaded, you can run in a console:
if it's not there execute following command before to reboot:
sudo apt-get install --reinstall pvr-omap4-dkms
Change the boot args: you must modify the boot/boot.script as suggested in the Pandaboard google group:
Open terminal and go to boot directory
cd /boot sudo nano boot.script
"vram=40M mem=456M@0x80000000 mem=512M@0xA0000000" (or any vram or split mem settings)
We advise following bootargs:
ro elevator=noop console=ttyO2,115200n8 mem=1G@0x80000000 root=<UUID or LABEL root> fixrtc splash
(even if you are not using minicom, it is wise to add the "console" as well: if you install minicom in the future, you won't need to remodify the boot args).
Save it and then run the following command to apply the changes:
(this generate the new boot.scr and copy it to boot partition)
Download openFrameworks for armv7 if you haven't done it before, uncompress it somewhere in your sdcard, usually in your home folder, documents or desktop
Run the install_dependencies.sh and install_codecs.sh scripts in scripts/linux/ubuntu
Compile and run any of the examples, for example:
cd $(OF_ROOT)/examples/graphics/polygonExample make make run
The first time you compile a example it'll take a while to compile since it needs to compile all of openFrameworks. Next times it'll just need to compile you example code and it'll be much faster.
You can edit your source files using gedit, the default text editor on linux which has great syntax highliting.
##Troubleshooting .. A good idea is to check from time to time the Pandaboard Google group to keep yourself updated about new versions of TI OMAP. https://groups.google.com/forum/?fromgroups#!forum/pandaboard
###Repository fetch error: If you got an error after apt-get update: cannot fetch some repository ("armhf" packages). You first need to add the PPA repository before running "apt-get update".
###Mouse cursor flashing: Mouse cursor flash is consequence of HWcursor, you can fix that by disabling HWcursor in xorg.conf file, edit file /usr/share/X11/xorg.conf.d/99-omap.conf and add the bold line:
Section "Device" Identifier "Video Device" Driver "omap" Option "Debug" "false" Option "HWcursor" "false" EndSection
###Screen flickering After reboot, the screen flicker in black when moving the mouse at on the desktop elements. Then logout and in front of the user name, click on the ubuntu symbol. Then select "Ubuntu 2D".
##Optionals Install Xubuntu Using a lightweight desktop environment like Xfce will speed up the pandaboard. Xubuntu is also a derivative of Ubuntu but with Xfce as the desktop environment and some other applications.
Install Xubuntu on top of Ubuntu:
sudo apt-get update sudo apt-get install xubuntu-desktop