Having now had to install and configure Ubuntu on the PandaBoard three times I thought I would make a blog post about the setup procedure. If nothing else this will serve as a reference to myself should I have to do it again. I am using an Ubuntu 12.04 Desktop build.
Installing Ubuntu 12.04 Desktop on an SD card:
The first step is to install Ubuntu on an SD card. For this I followed the instructions provided at the Ubuntu Wiki, which I will briefly go through here for a Linux-based host computer (the Wiki provides instructions for doing this on other OSs). You do not need a serial cable as some guides suggest.
1. Download the Texas Instruments OMAP4 (Hard-Float) preinstalled desktop image from the official site.
2. Insert the SD card into the host computer and make a note of its device interface. You can find the device’s name using the GUI (it should appear at the top of the file explorer window when you navigate into the disk). Knowing this you can then find the associated device interface using the command:
and finding the device’s name in the list. The device interface usually looks like /dev/sdX (where X is a single letter, ignoring any subsequent numbers). Once you have found this, unmount the disk. This can be done with the GUI by hitting the eject button.
3. Next run the following commands to unextract the image, copy it over and flush the system buffers. Make sure to replace /dev/sdX with the device interface identified in the previous step:
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/sdX sudo sync
This will take some time (around 30 minutes).
Configuring the installation:
Once the image is written to the SD card it can be removed from the host computer and inserted into the Pandaboard. At this stage the Pandaboard will need a 5V power supply, an ethernet cable, a monitor, a keyboard and optionally a mouse (I am making do without one).
1. Turn on the Pandaboard (by simply connecting the power cable) and it should begin booting (it takes a while for anything to appear on the display). When it has finished (it takes about 5 minutes) it will begin installing Ubuntu which takes around 50 minutes to complete.
2. Once Ubuntu has finished installing, update the system to the latest version using the commands:
sudo apt-get update sudo apt-get upgrade
This again will take a while to complete.
3. After updating I chose to install an ssh server so that I would be able to control it from my desktop computer. This is achieved by using the command:
sudo apt-get install openssh-server
The default configuration should work fine, however it can be changed if necessary by editing the file /etc/ssh/sshd_config. From this point on everything can be performed over ssh.
Installing the Kinect Drivers:
Finally, to install the Kinect Drivers I followed the instructions provided by Pansenti, which are simple to follow and highly detailed so I don’t feel it necessary to repeat them here. I shall, however, point out a couple of deviations I made from their instructions:
1. The bulk-install method mentioned on Pansenti’s site did not work for me (both times I tried it the PandaBoard hung up unexpectedly half way through). Instead I had to install all the drivers separately, like so:
sudo apt-get install gcc-multilib sudo apt-get install libusb-1.0.0-dev sudo apt-get install git-core sudo apt-get install build-essential sudo apt-get install doxygen sudo apt-get install graphviz sudo apt-get install default-jdk sudo apt-get install freeglut3-dev sudo apt-get install libopencv-dev
This step takes a considerable amount of time (at least an hour and a half, more depending on your internet connection): many of the libraries listed are very large (they total nearly 1GB) and heavily compressed.
2. I did not find it necessary to alter the MAKE_ARGS to change the threading flag.
3. Once I had finished the installation the tests mentioned did not work. After some head-scratching I realised this was, as very briefly mentioned at the bottom of the article, because the installation removes a kernel module – gspca_kinect – which comes with Ubuntu 12.04 and otherwise stops the Kinect from being visible to the rest of the system. For this removal to take effect the PandaBoard has to be restarted, after which the tests will function as the guide says: allowing a default test to be run as follows:
cd ~/kinect/OpenNI/Platform/Linux/Redist/OpenNI-Bin-Dev-Linux-Arm-v126.96.36.199/Samples/Bin/Arm-Release ./Sample-NiSimpleRead