Mainline kernel support

Patch submitted to enable basic support for ?OpenPandora in the Debian linux packages: https://bugs.debian.org/835893

Enabled in in debian linux package in 4.7.4-1.

Boots with linux 4.7.x/4.8.x and Debian stretch. SD card, NAND, LCD (xserver-xorg-video-fbdev works, fbconsole doesn't), keyboard (fn-key broken). Broken or missing support for USB, wifi, and "mouse" nubs.

U-boot

The omap3_pandora target was enabled in the u-boot-omap package in version 2016.09~rc2+dfsg1-1. Only works with serial console, so debugging can be difficult without a serial console cable.

Installing Wheezy on the Open Pandora

What You will need

An Open Pandora (I have the 1 Ghz Model)
- - Note: I have been told this can make a different for which port you can use. I have been able to use armhf, but I wouldn't mind someone trying it out....
A PC with Debian installed
An SD Card (I am using a 16 GB card, but I imagine that you can install it on an 8 GB Card)

Notes

As of now, 3D acceleration does not work. I cannot get the omap drivers to work
I have only been able to get the pandora kernel to play nicely with Debian.
I am NOT trying to get the PND system to work. You are welcome to attempt it, and there is some documention here: http://pandorawiki.org/Debian_On_SD.
The Wifi Drivers are non-free software.

On The PC

Format the SD card to have an ext3 partition (I used gparted to do this)
Install debootstrap
```
# apt-get install debootstrap
```
Now run debootstrap. I choose to use the armel port, even though Open Pandora has a hardware FPU. Others have successfully gotten the armel working, so I will do that then work on the armhf
```
#debootstrap --arch armel --foreign wheezy /tmp/pandora-debian http://ftp.us.debian.org/debian/
```

Note: If you want to try the armhf port, run this instead:

#debootstrap --arch armhf --foreign wheezy /tmp/pandora-debian http://ftp.us.debian.org/debian/

Now copy that directory you just made into the SD card, unmount it, and put it into your Pandora.
```
# cd /tmp/pandora-debian
# cp -R -v * /media/chris/Debian/ 
# umount /media/chris/Debian/
```

On The Pandora

Now on your Pandora, you will have to do the second stage. This will take a little bit of time:
```
# sudo chroot /media/Debian
# /debootstrap/deboostrap --second-stage
```
After that, you need to add your repositories into this new install.
```
# nano /etc/apt/sources.list
```

Contents of /etc/apt/sources.list

# wheezy
deb http://ftp.us.debian.org/debian/ wheezy main contrib non-free
deb-src http://ftp.us.debian.org/debian/ wheezy main contrib

# wheezy updates
deb http://ftp.us.debian.org/debian/ wheezy-updates main contrib non-free
deb-src http://ftp.us.debian.org/debian/ wheezy-updates main contrib

# Wheezy Backports
deb http://ftp.us.debian.org/debian/ wheezy-backports main contrib non-free
deb-src http://ftp.us.debian.org/debian/ wheezy-backports main contrib

Now update and upgrade. I don't think you will get anything for the upgrade, but it doesn't hurt.
```
# apt-get update
# apt-get dist-upgrade
```

Making the Pandora boot

You must also create a boot.txt or autoboot.txt in order for u-boot to recognize and boot the kernel. If you make a boot.txt, you must manually load it from the bootmenu, but autoboot.txt will boot this before the NAND image:
```
# nano /boot.txt
```

```
# nano /autoboot.txt
```

Contents of boot.txt/autoboot.txt:

setenv bootargs root=/dev/mmcblk0p1 rw rootwait vram=6272K omapfb.vram=0:3000K mmc_core.removable=0
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

NOTE: Refer to boot setup for how I did this. If you make multiple partitions on the card, the ezt2load will be different: http://pandorawiki.org/Boot_setup

Using the Pandora Kernel

From Angstrom:

$ sudo cp -R /lib/modules/* /media/Debian/lib/modules
$ sudo cp -R /lib/firmware/* /media/Debian/lib/firmware
$ sudo cp -R /boot/* /media/Debian/boot

Chroot with Debian:

# chown root:root -hR /boot/
# chown root:root -hR /lib/firmware/
# chown root:root -hR /lib/modules/

With that, you can now boot from the pandora directly to your new Debian installation!

Making a Debian Kernel

NOTE: This is only possible with armhf. However, upon boot, you will only see a blank screen. I suspect a kernel recompile is needed for both armel and armhf.
Install the kernel from apt-get (NOTE: The firmware-ti-connectivity is non-free):

On Debian:

# apt-get install linux-image-omap linux-headers-omap firmware-ti-connectivity

Now to make the pandora boot into it, we must make a bootable image for it to boot from.

On Debian:

# mkimage -A arm -O linux -T kernel -C none -a 0x80008000 -e 0x80008000 -n Linux -d /boot/vmlinuz-3.2.0-4-omap /boot/uImage

As of now, it says it boots from the Uboot, but you will see nothing on the screen. To work on.....

Xorg

When you install xxerver, be sure to install xserver-xorg-video-omap3 and xserver-xorg-video-fbdev. I chose to install xfce, but you are welcome to install what you wish.

On Debian

# apt-get install xfce4 xserver-xorg-video-omap3 xserver-xorg-video-fbdev

I also install xfce4-goodies

```
# apt-get install xfce4-goodies
```

=== armel===

This is my xorg.conf

/etc/X11/xorg.conf

Section "Module"
    Load    "extmod"
    Load    "dbe"
    Disable    "glx"
    Disable    "dri"
    Load    "dri2"
EndSection

Section "ServerLayout"
    Identifier    "DefaultLayout"
    Screen        "Screen0"
EndSection

Section "Screen"
    Identifier        "Screen0"
    Device            "OMAPFB"
    Monitor            "Monitor0"
    DefaultDepth    16
    SubSection "Display"
        Depth    16
        Modes    "800x480"
    EndSubSection
EndSection

Section "Monitor"
    Identifier        "Monitor0"
EndSection

Section "Device"
    Identifier        "OMAPFB"
    Driver            "omapfb"
    Option            "fb"        "/dev/fb0"
EndSection

Right now I have only attempted with root.

armhf

Note: I have only gotten fbdev to work. omap3 does not seem to want to work.

This is my xorg.conf

/etc/X11/xorg.conf

# Taken from Pandian
Section "ServerLayout"
        Identifier      "DefaultLayout"
        Screen          "Screen0"
EndSection

Section "Screen"
        Identifier      "Screen0"
        Device          "FBDEV"
        Monitor         "Monitor0"
        DefaultDepth    16
        SubSection "Display"
                Depth   16
                Modes   "800x480"
        EndSubSection
EndSection



Section "Device"
        Identifier      "OMAPFB"
        Driver          "omapfb"
        Option          "fb"    "/dev/fb0"
EndSection

Section "Device"
        Identifier      "FBDEV"
        Driver          "fbdev"
        Option          "ShadowFB"              "false"
        Option          "fbdev"                 "/dev/fb0"
EndSection   

Section "Files"
        FontPath        "/usr/share/fonts/X11/misc"
        FontPath        "/usr/share/fonts/X11/Type1"
        FontPath        "/usr/share/fonts/X11/Speedo"
        FontPath        "/usr/share/fonts/X11/100dpi"
        FontPath        "/usr/share/fonts/X11/75dpi"
EndSection

Keymap

On Angstrom:

sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc
sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel

This script needs to run anytime you start X, right now I have it in /etc/skel/.xinitrc. Depending on if you use gdm, kdm, etc, it will have to go somewhere else

.xinitrc

xmodmap /etc/skel/.pndXmodmap
loadkeys /etc/keymap-extension-2.6.map

Battery Monitoring

Nothing really to it....

Debian

```
# apt-get install apmd
```

Also install the DM's power manager. I use xfce, so I just installed that.

Credits:

Unofficial Package Repository

There's an armhf repository with a linux-image package based on wheezy kernel sources with openpandora patches applied, as well as a pandora-hacks package which includes keymap and cpu frequency configurations specific to the pandora. To use, add to sources.list:

deb http://cascadia.debian.net/~vagrant/debian wheezy-pandora main

CategoryHandheld

DebianOnHandheldsOpenPandora