Pandora Wiki - User contributions [en]

GLESGAE

2012-02-02T12:40:56Z

Stuckie: Added Evaluation Chapters

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* [[GLESGAE:Making a Mesh]]
* [[GLESGAE:Fixed Function Rendering Contexts]]
* [[GLESGAE:Shader Based Contexts]]
* [[GLESGAE:The Transform Stack]]
* [[GLESGAE:Fixed Function Transformations]]
* [[GLESGAE:Shader Based Transformations]]
* [[GLESGAE:Dealing with Textures]]
* [[GLESGAE:Making another Mesh with Vertex Buffers]]
Part Three - Manage my Stuff!
* [[GLESGAE:Managing Resources Overview]]
* [[GLESGAE:The Resource Manager]]
* [[GLESGAE:State Management Overview]]
* [[GLESGAE:Implementing The Game States]]
Part Four - The First Evaluation
* [[GLESGAE:First Evaluation Overview]]
* [[GLESGAE:First Evaluation Graphics]]
* [[GLESGAE:First Evaluation Resources]]
Part Five - Make it do Stuff!
* [[GLESGAE:Logic Processing Overview]]
* [[GLESGAE:Dealing with Entities]]
* [[GLESGAE:Playing with Scripts]]
Part Six - Push Stuff around!
* [[GLESGAE:Physics Processing Overview]]
* [[GLESGAE:Implementing Box2D Physics]]
* [[GLESGAE:Implementing Bullet Physics]]
Part Seven - Make Stuff squeak!
* [[GLESGAE:Sound Processing Overview]]
* [[GLESGAE:Implementing OpenAL]]
Part Eight - The Second Evaluation
* [[GLESGAE:Second Evaluation Overview]]
* [[GLESGAE:Second Evaluation Logic]]
* [[GLESGAE:Second Evaluation Physics]]
* [[GLESGAE:Second Evaluation Sound]]
Part Nine - Poke Stuff from afar!
* [[GLESGAE:Networking Overview]]
* [[GLESGAE:A Basic Networking System]]
Part Ten - Advanced Stuff!
* [[GLESGAE:Library Stubs]]
Part Eleven - Tool Stuff!
* [[GLESGAE:Tools Overview]]
* [[GLESGAE:Mesh Converter]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

'''NOTE:''''' This is a bit old, now.. and may have somewhat dodgy WiFi, but I'll get round to fixing this soon ( hopefully by 13th May. )'''''

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

GLESGAE

2011-07-20T09:00:54Z

Stuckie: Adding Tools Stuff! to the big Table of Contents to get to... eventually...

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* [[GLESGAE:Making a Mesh]]
* [[GLESGAE:Fixed Function Rendering Contexts]]
* [[GLESGAE:Shader Based Contexts]]
* [[GLESGAE:The Transform Stack]]
* [[GLESGAE:Fixed Function Transformations]]
* [[GLESGAE:Shader Based Transformations]]
* [[GLESGAE:Dealing with Textures]]
* [[GLESGAE:Making another Mesh with Vertex Buffers]]
Part Three - Manage my Stuff!
* [[GLESGAE:Managing Resources Overview]]
* [[GLESGAE:The Resource Manager]]
* [[GLESGAE:State Management Overview]]
* [[GLESGAE:Implementing The Game States]]
Part Four - Make it do Stuff!
* [[GLESGAE:Logic Processing Overview]]
* [[GLESGAE:Dealing with Entities]]
* [[GLESGAE:Playing with Scripts]]
Part Five - Push Stuff around!
* [[GLESGAE:Physics Processing Overview]]
* [[GLESGAE:Implementing Box2D Physics]]
* [[GLESGAE:Implementing Bullet Physics]]
Part Six - Make Stuff squeak!
* [[GLESGAE:Sound Processing Overview]]
* [[GLESGAE:Implementing OpenAL]]
Part Seven - Poke Stuff from afar!
* [[GLESGAE:Networking Overview]]
* [[GLESGAE:A Basic Networking System]]
Part Eight - Advanced Stuff!
* [[GLESGAE:Library Stubs]]
Part Nine - Tool Stuff!
* [[GLESGAE:Tools Overview]]
* [[GLESGAE:Mesh Converter]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

'''NOTE:''''' This is a bit old, now.. and may have somewhat dodgy WiFi, but I'll get round to fixing this soon ( hopefully by 13th May. )'''''

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

GLESGAE

2011-06-29T01:03:55Z

Stuckie: /* Table of Contents */ Re-ordered Textures and VBOs

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* [[GLESGAE:Making a Mesh]]
* [[GLESGAE:Fixed Function Rendering Contexts]]
* [[GLESGAE:Shader Based Contexts]]
* [[GLESGAE:The Transform Stack]]
* [[GLESGAE:Fixed Function Transformations]]
* [[GLESGAE:Shader Based Transformations]]
* [[GLESGAE:Dealing with Textures]]
* [[GLESGAE:Making another Mesh with Vertex Buffers]]
Part Three - Manage my Stuff!
* [[GLESGAE:Managing Resources Overview]]
* [[GLESGAE:The Resource Manager]]
* [[GLESGAE:State Management Overview]]
* [[GLESGAE:Implementing The Game States]]
Part Four - Make it do Stuff!
* [[GLESGAE:Logic Processing Overview]]
* [[GLESGAE:Dealing with Entities]]
* [[GLESGAE:Playing with Scripts]]
Part Five - Push Stuff around!
* [[GLESGAE:Physics Processing Overview]]
* [[GLESGAE:Implementing Box2D Physics]]
* [[GLESGAE:Implementing Bullet Physics]]
Part Six - Make Stuff squeak!
* [[GLESGAE:Sound Processing Overview]]
* [[GLESGAE:Implementing OpenAL]]
Part Seven - Poke Stuff from afar!
* [[GLESGAE:Networking Overview]]
* [[GLESGAE:A Basic Networking System]]
Part Eight - Advanced Stuff!
* [[GLESGAE:Library Stubs]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

'''NOTE:''''' This is a bit old, now.. and may have somewhat dodgy WiFi, but I'll get round to fixing this soon ( hopefully by 13th May. )'''''

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

Extend Utils

2011-06-28T16:50:47Z

Stuckie: /* Part 1: the 1GB home extend */ Fixed the check as /tmp/1gb.overlay mounts to /home, and not the user's home folder.. see the thread for how this can cause confusion ;)

= Overview =

[[Extend Utils]] provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Bug Reports =
In order for a bug report to be useful, I need the following information from you: 
Output from "dmesg | tail", "mount" and your preMount script. 
A description of the error.

Just PM me them on the GP32X boards, or post in the relevant threads - Links at the bottom of this page.

= Available Files =

The current ExtendUtils will always be on my website here:
[http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/ExtendUtils.pnd Extend Utils]

For support, please direct questions to this forum thread: [http://www.gp32x.com/board/index.php?/topic/59740-extend-utils/ Extend Utils on GP32X] 
Older threads where all this came from are at the bottom of this page for the interested.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in Extend Utils, but are available here as well as they're just loop files and can therefore be used with other things:
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/4GBExtend.zip 4GB Extend]

== Dev Extends ==
All Angstrom-based Dev Extends are currently deprecated as of 26th June 2011.

Please see the Lenny Debian OS Extend instead.

== OS Extends ==
=== Debian ===
Lenny Dev Extend
* [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/debian.lennydev.20110626.zip 512mb Lenny Extend]

The Lenny Dev Extend has a Debian bootstrap with dev tools ( enough for the Wakebreaker GL ES example plus gtk 1.2 dev ) 
There's about a hundred meg left in the extend for additional libraries, or you can transfer it to a bigger extend via '''''cp -a oldExtend/* newExtend/'''''

Alternatively, check the [[Debian On SD]] project for booting Debian directly from SD card.

====Step-by-step guide====
In this guide, you will mount a Lenny Dev Extend (to give you a protected dev environment), in conjunction with a 1gb overlay extend (to give you room in which to place your files).

=====Part 1: the 1GB home extend=====
#Download [http://stuckiegamez.co.uk/apps/pandora/ExtendUtils/ExtendUtils.pnd ExtendUtils.pnd] to your Pandora (see [[User_manual#Installing_a_PND_file_.28an_application.29|here]] for instructions on where to place PNDs)
#Run it. It's called "Extend Utils" and is in "System" category.
#Select "New Extend/Overlay/Swap"
#Select "New Overlay File"
#Select a size (for example, 1gb) .. if you select "Custom", prepare for a long wait.
#Place the file somewhere on your SD card (the default folder it suggests is a good choice, because it always looks there first) and give it a name. For example, "1gb"... you don't need to add .overlay or .extend, as it does it for you.
#It'll now either extract a premade empty file, or if you selected "Custom" it'll DD a new file, taking forever, and probably raping your SD in the process.. you have been warned ;)
#You'll be pushed back to the main menu now.
#Select "New Pre-Mount"
#Select "New Overlay Mount Script"
#Select "Standard Home Overlay"
#Choose your file ("1gb.overlay" in our example) that you saved on your SD card in the previous stage
#Save the mount script anywhere you like, calling it anything you like... for our purposes, save it on the SD card and name it "1gb"
#Back to the main menu.
#Select "Mount Existing Pre-Mount". Note: If your SD card is formatted to anything other than ext/2/3/4 (for example, if it uses FAT32 or NTFS), you can't run it directly from the Terminal. You'll need to run it through Extend Utils or type <code>/bin/bash /my/mount/script.preMount</code> instead.
#Choose the script you saved in the previous part ("1gb.premount")
#Type your sudo password (your password to log in to your Pandora at startup)
#That should be it.

'''For checking purposes:'''

#Launch a Terminal.
#Type <code>mount</code>
#Look for a line at the bottom reading something like "aufs on /home type aufs (rw, si=xxxxxxxx)"
#Type <code>cd /tmp/NAMEOFOVERLAY.overlay/YOURUSERNAME</code> (for our example, if we were stuckie: <code>cd /tmp/1gb.overlay/stuckie</code>)
#We'll put a random file here to ensure it works. Type it <code>touch testfile</code>. This will create an empty file named "testfile". Type <code>ls</code> and it should be among the files listed. Now type <code>ls ~</code>, and it should also show up.

=====Part 2: Debian Dev Extend=====
#Download [http://stuckiegamez.co.uk/apps/pandora/ExtendUtils/DebianDevExtend.pnd DebianDevExtend.pnd] to your Pandora.
#Download the [http://www.stuckiegamez.co.uk/apps/pandora/ExtendUtils/debian.lennydev.20110626.zip 512mb Lenny Dev Extend], unzip it (for example, using Squeeze), place the debian.lennydev.20110626.extend file into the directory <code>/media/yourSDcard/pandora/appdata/DebianDevExtend</code> (it doesn't matter where you put it, but this is easier because it's the default directory it will look in)
#Launch Debian Dev Extend. It's in the "System" category.
#Click "Ok" past the notifications.
#Select the debian.lennydev.20110626.extend file.
#Type your sudo password if prompted (you may be quick enough to still be in the sudo cache that it doesn't ask)
#In the Debian Dev Extend terminal, type <code>gcc</code> to ensure that it works. If it says <code>gcc: no input files</code>, all is well.
#Type <code>cd</code> to jump directly to your home folder. Type <code>ls</code> to ensure our test file is there. If it is, you're good to go.

=====How it all links together=====
You can open a file manager (for example Thunar, or Xfe) and verify that everything is as it should be. Here's how it should look:
*The contents of <code>/home</code> and <code>/tmp/1gb.overlay</code> should be almost identical
*The contents of the following three directories should be identical:
**<code>/home/username</code>
**<code>/tmp/debextend/home/username</code>
**<code>/tmp/1gb.overlay/username</code>
("username" represents your username)

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
# Start up Extend Utils.
# Select New Extend/Overlay/Swap.
# Select New Swap File.
# Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
# Save the file anywhere you like.
# It will extract the appropriate zip to where you selected.
# Back at the Main Menu, select New Pre-Mount.
# Select New Swap Mount Script.
# Find your Swap File you just created.
# Select a location for your Pre-Mount script to be saved to.
# Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
# Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
# Start up Extend Utils.
# Select New Overlay.
# Select New Overlay File.
# Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
# Save the file anywhere you like.
# It will extract the appropriate zip to where you selected.
# Back at the Main Menu, select New Pre-Mount.
# Select New Overlay Mount Script.
# Select either Standard Home Overlay or Standard Root Overlay.
# Find your Overlay that you created.
# Select where you want to save the Pre-Mount script.
# Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
# Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
# Start Extend Utils.
# Select New Pre-Mount.
# Select New Extend Mount.
# Select OS Extend. This is where you need to start paying attention as to what you're doing. For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay. The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.
# Move the slider to select 1 Read-Only Extend.
# Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
# We don't want any Read-Write Extends, so Cancel or select 0.
# We do want an Overlay, so select 1 Read-Write Overlay.
# Choose the Overlay you want to use.
# Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
# You'll then be asked where you want to save the PreMount script. Again, we need to pay attention as to what we want here. For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom. You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.
# Select the Terminal option.
# You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
# Select your Pre-Mount Script you've just created.
# After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
# Start Extend Utils.
# Select New Pre-Mount.
# Select New Extend Mount.
# Select OS Extend. As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues. Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.
# We don't want any Read-Only Extends, so Cancel or select 0.
# We do want a Read-Write Extend...so move the slider to 1 and find your Extend file.
# Again, we don't want an Overlay, so select 0 or Cancel it.
# Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
# You'll then be asked where you want to save the PreMount script. Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.
# We'll assume we've got GDM present, so select GDM.
# You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
# Select your Pre-Mount Script you've just created.
# After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
# Start Extend Utils.
# Select New Pre-Mount.
# Select New Extend Mount.
# Select Dev Extend.
# Select 0 Read-Only Extends.
# Select 1 Read-Write Extend.
# Find your Dev Extend.
# Select 0 Read-Write Overlays.
# Come up with a mount point.
# Save your Pre-Mount somewhere.
# You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]
[[Category:Filesystem]]
[[Category:Operating System]]
[[Category:Tutorials]]

Extend Utils

2011-06-26T18:55:33Z

Stuckie: Taking out deprecated bits and pieces

GLESGAE

2011-05-26T09:11:34Z

Stuckie: /* Table of Contents */ Adding page on The Transform Stack - so important, it gets it's own page before I even touch dealing with matrices! Removed Chapter Numbers, and Reogranised/Added some bits

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* [[GLESGAE:Making a Mesh]]
* [[GLESGAE:Fixed Function Rendering Contexts]]
* [[GLESGAE:Shader Based Contexts]]
* [[GLESGAE:The Transform Stack]]
* [[GLESGAE:Fixed Function Transformations]]
* [[GLESGAE:Shader Based Transformations]]
* [[GLESGAE:Making another Mesh with Vertex Buffers]]
* [[GLESGAE:Dealing with Textures]]
Part Three - Manage my Stuff!
* [[GLESGAE:Managing Resources Overview]]
* [[GLESGAE:The Resource Manager]]
* [[GLESGAE:State Management Overview]]
* [[GLESGAE:Implementing The Game States]]
Part Four - Make it do Stuff!
* [[GLESGAE:Logic Processing Overview]]
* [[GLESGAE:Dealing with Entities]]
* [[GLESGAE:Playing with Scripts]]
Part Five - Push Stuff around!
* [[GLESGAE:Physics Processing Overview]]
* [[GLESGAE:Implementing Box2D Physics]]
* [[GLESGAE:Implementing Bullet Physics]]
Part Six - Make Stuff squeak!
* [[GLESGAE:Sound Processing Overview]]
* [[GLESGAE:Implementing OpenAL]]
Part Seven - Poke Stuff from afar!
* [[GLESGAE:Networking Overview]]
* [[GLESGAE:A Basic Networking System]]
Part Eight - Advanced Stuff!
* [[GLESGAE:Library Stubs]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

'''NOTE:''''' This is a bit old, now.. and may have somewhat dodgy WiFi, but I'll get round to fixing this soon ( hopefully by 13th May. )'''''

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

GLESGAE

2011-05-11T09:01:41Z

Stuckie: /* I'm Lazy, Give Me A Pre-Configured Thing! */ Adding note about the premade rootfs being a bit out of date and buggy.

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* Chapter 01 - [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* Chapter 02 - [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* Chapter 03 - [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* Chapter 04 - [[GLESGAE:Setting Up A Window and Context]]
* Chapter 05 - [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* Chapter 06 - [[GLESGAE:Making a Mesh]]
* Chapter 07 - [[GLESGAE:Fixed Function Rendering Contexts]]
* Chapter 08 - [[GLESGAE:Shader Based Contexts]]
* Chapter 09 - [[GLESGAE:Dealing with Textures]]
* Chapter 10 - [[GLESGAE:Making another Mesh with Vertex Buffers]]
* Chapter 11 - [[GLESGAE:Dealing with Matrices]]
* Chapter 12 - [[GLESGAE:Fun with Maths]]
Part Three - Manage my Stuff!
* Chapter 13 - [[GLESGAE:Managing Resources]]
* Chapter 14 - [[GLESGAE:State Management]]
Part Four - Make it do Stuff!
* Chapter 15 - [[GLESGAE:Logic Processing Overview]]
* Chapter 16 - [[GLESGAE:Dealing with Entities]]
* Chapter 17 - [[GLESGAE:Playing with Scripts]]
Part Five - Push Stuff around!
* Chapter 18 - [[GLESGAE:Physics Processing Overview]]
* Chapter 19 - [[GLESGAE:Implenting Box2D Physics]]
* Chapter 20 - [[GLESGAE:Implenting Bullet Physics]]
Part Six - Make Stuff squeak!
* Chapter 21 - [[GLESGAE:Sound Processing Overview]]
* Chapter 22 - [[GLESGAE:Implementing OpenAL]]
Part Seven - Poke Stuff from afar!
* Chapter 23 - [[GLESGAE:Networking Overview]]
* Chapter 24 - [[GLESGAE:A Basic Networking System]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

'''NOTE:''''' This is a bit old, now.. and may have somewhat dodgy WiFi, but I'll get round to fixing this soon ( hopefully by 13th May. )'''''

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

GLESGAE

2011-05-10T23:41:27Z

Stuckie: Organising stuff into Chapters and Parts, and added a "done when done" type disclaimer.

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
These will be written when I have time.. the uncreated ones below being an indicator of what's to come. 
Unwritten parts may be split up, moved, or otherwise manipulated before actually going live, so don't take the following as set in stone till the link turns blue!

== Table of Contents ==
Part One - Setup Stuff!
* Chapter 01 - [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* Chapter 02 - [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* Chapter 03 - [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* Chapter 04 - [[GLESGAE:Setting Up A Window and Context]]
* Chapter 05 - [[GLESGAE:The Event and Input Systems]]
Part Two - Show me Stuff!
* Chapter 06 - [[GLESGAE:Making a Mesh]]
* Chapter 07 - [[GLESGAE:Fixed Function Rendering Contexts]]
* Chapter 08 - [[GLESGAE:Shader Based Contexts]]
* Chapter 09 - [[GLESGAE:Dealing with Textures]]
* Chapter 10 - [[GLESGAE:Making another Mesh with Vertex Buffers]]
* Chapter 11 - [[GLESGAE:Dealing with Matrices]]
* Chapter 12 - [[GLESGAE:Fun with Maths]]
Part Three - Manage my Stuff!
* Chapter 13 - [[GLESGAE:Managing Resources]]
* Chapter 14 - [[GLESGAE:State Management]]
Part Four - Make it do Stuff!
* Chapter 15 - [[GLESGAE:Logic Processing Overview]]
* Chapter 16 - [[GLESGAE:Dealing with Entities]]
* Chapter 17 - [[GLESGAE:Playing with Scripts]]
Part Five - Push Stuff around!
* Chapter 18 - [[GLESGAE:Physics Processing Overview]]
* Chapter 19 - [[GLESGAE:Implenting Box2D Physics]]
* Chapter 20 - [[GLESGAE:Implenting Bullet Physics]]
Part Six - Make Stuff squeak!
* Chapter 21 - [[GLESGAE:Sound Processing Overview]]
* Chapter 22 - [[GLESGAE:Implementing OpenAL]]
Part Seven - Poke Stuff from afar!
* Chapter 23 - [[GLESGAE:Networking Overview]]
* Chapter 24 - [[GLESGAE:A Basic Networking System]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:GLESGAE]]
[[Category:Tutorials]]

Software projects

2011-04-24T11:22:38Z

Stuckie: /* Operating systems */ - removing the "1.0.4" version as that's my version number, rather than Debian's.. specifically, I target Squeeze, though the guide can have Lenny working too.

''These lists were last updated on 2011-04-22 to include the latest files from [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps], the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive], the [http://repo.openpandora.org/?page=all&s=new Repo], and the [[Software_projects#Forums|community forums]].''

This is a list of '''all software projects''' for the Pandora ''excluding'' emulators (see: [[Emulator list]]), games (see: [[Games]]), and development tools (see: [[Development Tools]]). However, this list ''does'' include the development apps that can be used on the Pandora itself.

See the [[Port Requests]] article for open-source projects which ''could'' be ported but have not been taken on by anyone yet.

==Released software==
If you would like to add something, you could edit the wiki or [http://www.gp32x.com/board/index.php?/topic/54923-the-pandora-apps-thread/ post in this forum thread]. If different versions of a software were released, please make sure the "release date" is the most recent one.

Please click on the little squares to sort by different categories (such as Release date, Type, etc.)

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[AbiWord]]
|2011-01-17
|sebt3 (packaging)
|Office - word processor
|[http://sebt3.openpandora.org/pnd/abiword.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__919843 Discussion]
|-
|Alarm Clock ('''beta''')
|2011-02-01
|sebt3 (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,303 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/ Discussion]
|-
|[[Anki]] 1.2.8-drack3
|2011-04-20
|Drack (port)
|Office - memory aid
|[http://repo.openpandora.org/?page=detail&app=anki Download]
|Discussion [http://www.gp32x.com/board/index.php?/topic/58929-anki-friendly-intelligent-flashcards/page__view__findpost__p__946781 1] [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/ 2]
|-
|[[Arora]] (for [[Minimenu]])
|2010-05-26
|Skeezix (quick hack)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,69 Archive]
|Needed to run Arora from Minimenu
|-
|[[Audacious]] 2.4.4
|2011-03-07
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/audacious.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54792-audacious/page__view__findpost__p__942175 Discussion]
|-
|[[Audacity]] 1.3.12
|2011-04-21
|slaeshjag (port)
|Audio - audio editor, recorder
|[http://stuffs.slaeshjag.org/pnd/audacity.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/59301-audacity-1-3-12/ GP32X] [http://boards.openpandora.org/index.php?/topic/3016-audacity-1312/ OP]
|-
|[[b7zip]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Background killer
|2010-06-07
|Notaz
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/background_killer.inf Apps]
|Kill background tasks in minimenu. {{HideableNotes|"[http://www.gp32x.com/board/index.php?/topic/56008-zelda-classic-for-pandora/page__st__15__p__907940&#entry907940 Not needed]" since Hotfix 3, but still useful as a quick way to make sure all other tasks are closed.}}
|-
|[[Banshee]]
|2010-10-23
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/banshee.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57144-portrequest-banshee/ Discussion]
|-
|Better battery charging ('''beta''')
|2011-03-13
|WizardStan
|System
|[http://www.rebirthofxeen.com/files/pandora/chargeHack1 Download]
|[http://boards.openpandora.org/index.php?/topic/1488-better-battery-charging-beta/page__view__findpost__p__40784 Discussion]. Not a PND; must install from terminal.
|-
|[[Bluefish Editor]] 2.0.3
|2011-03-13
|mcobit (port)
|Network - web design
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,352 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58927-port-request-bluefish-editor/ Discussion]
|-
|[[Bournal]]
|2010-08-11
|
|Office - journal
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,181 Archive]
|encrypted diary program
|-
|[[Brasero]]
|2011-03-01
|mcobit (port)
|System - CD/DVD burner
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,335 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58842-brasero/ Discussion]
|-
|[[Catlooking Writer]]
|2011-03-28
|mcobit (port)
|Office - word processor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,372 Archive]
|[http://www.gp32x.com/board/index.php?/topic/59111-catlooking-writer/ Discussion]
|-
|[[Chromium]]
|2010-09-04
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,90 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56474-chromium-4-with-ssl-and-chromium-snapshot/ Discussion]. SSL now works
|-
|[[Chromium]]-Dev v10.0.642.1
|2011-01-16
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,201 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58234-chromium-dev-snapshot-v10-0-642-1/ Discussion] [http://www.gp32x.com/board/index.php?/topic/57017-chromium-dev-updated/ (old)]. The latest (non-stable) snapshot.
|-
|[[Claunch]] ('''beta''')
|2010-10-14
|Lamoxx
|System - app launcher
|[http://userpages.uni-koblenz.de/~bbrink/tmp/claunch_beta.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57040-claunch-minimal-flexible-rom-pickerapplication-launcher/ Discussion]
|-
|[[Claws Mail]]
|2010-10-03
|sebt3 (port)
|Network - mail client
|[http://sebt3.openpandora.org/pnd/claw-mail.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,223 Archive]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920075 Discussion]. Hopefully doesn't save to NAND (testing needed).
|-
|[[Cmus]]
|2010-11-27
|otherguy66 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,251 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57682-cmus-pnd-installer/page__gopid__928328&#entry928328 Discussion]. Installed to [[NAND]] (1mb). Text mode player
|-
|[[Code::blocks]]
|2010-06-07
|sinoth (port)
|Development - IDE
|[http://sinoth.net/pandora/codeblocks.pnd.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/54091-codeblocks-on-the-pandora/ Discussion].
|-
|Community Codec Package
|2010-05-25
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/CodecPack.inf Apps] [http://openpandora.org/downloads/CodecPack.pnd Official site]
|Make sure you have this installed
|-
|[[Comix]]
|2010-06-30
|Pontus Ekberg
|Graphics - image viewer
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/comix.inf Apps]
|
|-
|[[Conky]]
|2010-08-03
|daniel3000 (port)
|System
|[http://www.hermocom.com/en/downloads/openpandora/Conky.pnd/ Download]
|System monitor. [http://www.gp32x.com/board/index.php?/topic/55775-conky Discussion]
|-
|[[Converseen]]
|2011-03-03
|mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,339 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58859-converseen/ Discussion]
|-
|[[DarCalc]]
|2010-08-28
|JP
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,196 Archive]
|See also the calculator emulators [[Emulator list|here]]
|-
|[[Deadbeef]] 0.4.3
|2010-11-01
|CME (port), sebt3 (port)
|Audio - music player
|[http://root.shadow-node.net/public/cme/pnd/deadbeef.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55178-deadbeef-compiled-with-codesourcery-gcc-2010q1/ Discussion]
|-
|[[dia]]
|2010-10-03
|sebt3 (port)
|Office - diagrams
|[http://sebt3.openpandora.org/pnd/dia.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56863-dia/ Discussion]
|-
|[[DrawSWF]] ('''beta''')
|2010-07-10
|Chrysipp (port)
|Graphics - vector drawing
|[http://www.pandorasource.de/download.php?view.158 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10105%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhilcfdbJF4gEtvmTIwMjO9EFqUQ-A Discussion (German)]. Must have Java.pnd installed. {{HideableNotes|A small drawing program. The drawing can be exported as a Flash animation, which then shows its gradual development.}}
|-
|[[Effigy]] (PEF) Emulator Frontend ('''beta''')
|2011-04-04
|Aimless_E
|System - frontend
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=415 Download]
|[http://boards.openpandora.org/index.php?/topic/2276-effigy-pef-emulator-frontend/page__view__findpost__p__47107 Discussion] ([http://www.gp32x.com/board/index.php?/topic/44952-pandora-emulator-frontend/ old])
|-
|[[Ekiga]] ('''beta''')
|2010-10-29
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/ekiga.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/ Discussion]. Online phone & video calls. '''[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/page__view__findpost__p__924918 Doesn't work]'''{{HideableNotes| though it can be made to work through Debian, [[Extend Utils]]: [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/]}}
|-
|[[Emelfm2]]
|2011-03-09
|mcobit (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,351 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58928-port-request-emelfm2/ Discussion]
|-
|[[Empathy]] 2.29.6 ('''beta''')
|2011-03-08
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/empathy.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58911-empathy/ Discussion]. No networks included yet.
|-
|[[Enna]] ('''beta''')
|2010-07-08
|sebt3 (port)
|Media player
|[http://sebt3.openpandora.org/pnd/enna.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55113-enna/ Discussion]
|-
|[[Exaile]]
|2010-04-28
|Pickle (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,43 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Exaile.inf Apps]
|Needs Community Codec Pack to run
|-
|[[Extend Utils]]
|2010-06-22
|Stuckie
|System
|[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ 1], [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/ 2]. Debian in an extend. Allows you to run over 29,000 programs.
|-
|[[F3]]
|2010-10-17
|slaeshjag (port)
|System
|[http://stuffs.slaeshjag.org/F3.tar Download]
|Test for fake flash memory (like H2testw). [http://www.gp32x.com/board/index.php?/topic/57063-some-quick-tips-to-help-avoid-fake-sd-cardsflash-media/page__view__findpost__p__922187 Discussion]
|-
|[[FBReader]] 0.12.10
|2010-07-26
|zx81 (port)
|Office - eBook Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,168 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fbreader-0.12.10.inf Apps]
|
|-
|[[Fennec]] 4.0b3 ('''beta''')
|2011-02-03
|Mozilla Team, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,75 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Fennec40.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58514-fennec-4-0b3/ Discussion]
|-
|[[Fennec]] 3.6.3
|2010-05-30
|Mozilla Team, Iampanis (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fennec.inf Apps]
|mobile version of FireFox
|-
|[[Figaro's Password Manager 2]] ('''beta''')
|2010-11-30
|mcobit (port)
|System - passwords
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,254 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57714-figaros-password-manager-2/ Discussion]
|-
|[[Firefox]]
|2010-06-14
|Evildragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,91 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/FireFox.inf Apps]
|
|-
|[[Firefox]] 3.6.13
|2011-01-28
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-3.6.13-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/56903-firefox-3-6-10/ Discussion (old)], [http://www.gp32x.com/board/index.php?/topic/58425-firefox-3-6-13/ news/discussion]
|-
|[[Firefox]] 4.0B10 ('''beta''')
|2011-02-01
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-4b10-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58489-firefox-4-beta-10/ Discussion]
|-
|[[FlipClock]] ('''beta''')
|2011-02-05
|torpor (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58548-port-flipclock-for-pandora/ Discussion], also [http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/page__view__findpost__p__937668 here]
|-
|[[Fotoxx]]
|2010-12-06
|Kornelix mcobit (port)
|Graphics - photo editor & manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,261 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57777-fotoxx/ Discussion]
|-
|[[Freemind]] 0.9.0
|2011-03-10 2010-11-21
|mash (port)
|Office - mind mapping
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,4,240 Archive]
|[http://boards.openpandora.org/index.php?/topic/679-freemind-a-mindmap-tool/page__view__findpost__p__39752 Discussion] [http://www.gp32x.com/board/index.php?/topic/57605-freemind-a-mindmap-tool/ (old)] . Needs java.pnd installed.
|-
|[[GanttProject]] 2.0.10
|2011-03-19
|mash (port)
|Office - project management
|[http://mash-systeme.de/downloads/ganttproject.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,364 Archive]
|[http://boards.openpandora.org/index.php?/topic/2491-ganttproject-2010/ Discussion] [http://en.wikipedia.org/wiki/GanttProject Wiki article]. Needs Java.pnd
|-
|[[GCalc]]
|2010-11-23
|mcobit (port)
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,241 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57636-gcalc-graphic-calculator/ Discussion]. Needs java.pnd installed. See also the calculator emulators [[Emulator list|here]]
|-
|[[gCalctool]]
|2011-02-26
|mash (port)
|Office - calculator
|[http://mash-systeme.de/downloads/gcalctool.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/page__gopid__36838#entry36838 Discussion].
|-
|[[Geany]] v0.19-1
|2010-09-16
|bompo (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,14,205 Archive] [http://dl.dropbox.com/u/39448/pandora/geany.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55432-geany/ Discussion]
|-
|[[gedit]]
|2010-10-03
|sebt3 (port)
|Office - text editor
|[http://sebt3.openpandora.org/pnd/gedit.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56862-gedit/ Discussion]
|-
|[[gerbv]]
|2010-09-14
|bompo (port)
|Office - EDA
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,202 Archive]
|viewer for Gerber RS-274X, Excellon drill, & CSV pick-and-place files
|-
|Get iPlayer
|2011-04-23
|freamon (port)
|Multimedia - File Downloader
|[http://repo.openpandora.org/?page=detail&app=getiplayer.freamon.40n8e Repo]
|[http://boards.openpandora.org/index.php?/topic/3045-get-iplayer/ Discussion]
|-
|[[gFTP]] 2.0.18 ('''beta''')
|2010-07-01
|sebt3 (port)
|Network - FTP client
|[http://sebt3.openpandora.org/pnd/gftp.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54931-gftp/ Discussion]
|-
|[[GIMP]] v2.6.11.1
|2011-04-07
|sebt3 (port)
|Graphics - image editor
|[http://repo.openpandora.org/?page=detail&app=gimp-gimp-2.6-4644 Repo]
|[http://www.gp32x.com/board/index.php?/topic/59172-gimp-2-6-9/ Discussion]
|-
|[[GIMP]] v2.6 ('''beta''')
|2010-06-06
|Stuckie (quick hack)
|Graphics - image editor
|[http://www.stuckiegamez.co.uk/apps/pandora/gimp-2.6.pnd Download]
|Read instructions [http://www.gp32x.com/board/index.php?/topic/54071-ubuntu-or-other-dist-alternative/page__p__868411&#entry868411 here]
|-
|[[Gmu Music Player]] 0.7.2
|2010-12-29
|wejp
|Audio - music player
|[http://wejp.k.vu/files/gmu-0.7.2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58009-gmu-music-player-0-7-2/ Discussion] [http://www.gp32x.com/board/index.php?/topic/55007-gmu-music-player-0-7-1-released/ (old)]
|-
|[[Gnomad 2]]
|2010-10-18
|sebt3 (port)
|Audio - music manager
|[http://sebt3.openpandora.org/pnd/gnomad2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57088-gnomad2/ Discussion]
|-
|[[Gnome Music Player Client]] (GMPC) 0.20.0 ('''beta''')
|2010-08-01
|tsh (port)
|Audio - music player
|[https://sites.google.com/site/tshpandorastuff/file-cabinet/gmpc0.20.0.pnd?attredirects=0&d=1 Download]
|[http://www.gp32x.com/board/index.php?/topic/55664-gmpc-beta/ Discussion]
|-
|[[Gnumeric]]
|2011-01-17
|sebt3 (port)
|Office - spreadsheet
|[http://sebt3.openpandora.org/pnd/gnumeric.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920072 Discussion]
|-
|[[GoldenDict]] 0.9.0Svn
|2010-09-27
|Hitnrun (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,209 Archive] [http://www.rangelreale.com/pandora/goldendict.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56802-goldendict-0-9-0svn/ Discussion]
|-
|[[GParted]]
|2011-02-05
|sebt3 (port)
|System - partition
|[http://sebt3.openpandora.org/pnd/gparted.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Discussion]
|-
|[[gPicView]]
|2011-03-10
|sebt3 (port)
|Graphics - image viewer
|[http://sebt3.openpandora.org/pnd/gpicview.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58938-gpicview/ Discussion]
|-
|GQview
|2010-07-27
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/GQview.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55559-gqview-pnd-image-viewer-available/ Discussion]
|-
|[[Grafx2]]
|2010-12-30
|pulkomandy, yrizoud, mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,264 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58016-grafx2/ Discussion]. For pixel art.
|-
|[[Grafx2]] SVN v1713
|2011-02-26
|pulkomandy, yrizoud, et al.
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,330 Archive]
|For pixel art.
|-
|[[GrooveShark Player]]
|2011-03-11
|Elias Woods, coldbird (port)
|Network - music streaming
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,354 Archive]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58952-getting-on-grooveshark/page__view__findpost__p__942959 GP32X] [http://boards.openpandora.org/index.php?/topic/2273-compile-groove-for-pandora/ OP]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. {{HideableNotes|"you can listen to a gigantic Online Music Archive for free."}}
|-
|[[Groove]]
|2010-07-19
|Elias Woods, bompo (port)
|Network - music streaming
|[http://dl.dropbox.com/u/39448/pandora/Groove.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58952-getting-on-grooveshark/ Discussion]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. '''Warning''': {{HideableNotes|Requires installing dependencies with opkg. See discussion thread.}}
|-
|[[GRsync]]
|2011-03-03
|mcobit (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,340 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58861-grsync/ Discussion]. Synchronize folders & files, make backups
|-
|[[Gwaei]]
|2010-11-26
|Zachary Dovel mcobit (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,249 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57674-gwaei-port-japanese-english-dictionary/ Discussion]. Japanese-English.
|-
|[[hfsutils]]
|2011-03-10
|Silent-Hunter (port)
|System
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=295 Download]
|[http://boards.openpandora.org/index.php?/topic/2236-hfsutils-port/ Discussion]. For reading & writing Macintosh file systems.
|-
|[[HomeBank]] 4.3
|2011-02-26
|Maxime Doyen, mcobit (port)
|Office - money manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,296 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58506-homebank/ Discussion]
|-
|Hotfix 5
|2011-03-04
|Pandora team
|System
|[http://www.openpandora.org/downloads/HotFix5-Zaxxon.pnd Official site]
|Make sure you have this installed. Discussion: [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ GP32X] [http://boards.openpandora.org/index.php?/topic/2080-hotfix-5-released/page__pid__37497#entry37497 OP]
|-
|[[Inkscape]] ('''beta''')
|2010-10-08
|sebt3 (port)
|Graphics - vector drawing
|[http://sebt3.openpandora.org/pnd/inkscape.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56954-inkscape/ Discussion]. Currently very slow.
|-
|[[Java]] Pnd ('''beta''')
|2010-11-21
|WizardStan (port)
|System - dependency
|[http://rebirthofxeen.com/files/pandora/java.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57598-java-pnd/ Discussion]. Run Java apps.
|-
|[[jEdit]]
|2010-11-22
|mcobit (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,244 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57614-jedit-programmers-text-editor/ Discussion]. For programmers. Needs java.pnd installed.
|-
|[[jChemPaint]]
|2010-11-23
|mcobit (port)
|Graphics - molecule drawing
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,242 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57633-jchempaint/ Discussion]. Needs java.pnd installed.
|-
|[[jMol]]
|2010-11-22
|mcobit (port)
|Graphics - molecule viewing in 3D
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,243 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57618-jmol-3d-molecule-viewer/ Discussion]. Needs java.pnd installed.
|-
|[[jMP3 Player]]
|2010-07-10
|jaijuju
|Audio - music player
|[http://www.pandorasource.de/download.php?view.156 Download]
|[http://code.google.com/p/jmp3player/ Website]. Java.pnd required.
|-
|[[Jumanji]]
|2011-03-03
|b3w (port)
|Network - web browser
|[http://www.mediafire.com/?5va2dj4x6bkrobi Download] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/jumanji.inf Apps]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11821 Discussion (German)]. [https://wiki.archlinux.org/index.php/Jumanji Wiki]
|-
|[[KCHMViewer]] 5.2
|2010-10-05
|Hitnrun (port)
|Office - CHM Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,215 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56901-kcmviewer/ Discussion.] Windows help files reader.
|-
|[[KDiff 3]]
|2011-02-03
|Joachim Eibl
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,299 Archive]
|[http://boards.openpandora.org/index.php?/topic/1440-kdiff3-0995-pandora-3/ Discussion]. Merge 2 or 3 text input files or directories
|-
|[[Keyboard layout changer]]
|2011-03-18
|slaeshjag
|System - configuration
|[http://stuffs.slaeshjag.org/kblayout.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/2428-keyboard-layout-changer/ Discussion]. Shows up in Settings as Keyboard Layout
|-
|[[Liferea]]
|2010-07-06
|sebt3 (port)
|Network - RSS Reader
|[http://sebt3.openpandora.org/pnd/liferea.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55089-liferea/ Discussion]
|-
|[[Lightweight2]] 1.8.0.2
|2011-04-09
|cpttom, mcobit (port), Zero3K (port)
|Network - web browser
|[http://repo.openpandora.org/?page=detail&app=lightweight2-Lightweight2-112245 Repo]
|[http://www.gp32x.com/board/index.php?/topic/58836-lightweight2/page__view__findpost__p__945285 Discussion]. Small, fast browser.
|-
|[[Links2]]
|2011-03-10
|mash (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,333 Archive]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/ Discussion].
|-
|[[Linksys AE1000 USB Wifi]] (installer)
|2011-04-01
|Jey123456
|Network - USB Wifi driver
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=379 Download]
|[http://boards.openpandora.org/index.php?/topic/1992-linksys-ae1000-usb-wifi/page__view__findpost__p__46426 Discussion]. Get internet anywhere.
|-
|[[Linphone]] ('''beta''')
|2011-01-20
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/linphone.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58289-linphone Discussion]. Online phone calls.
|-
|[[Lynx]] v2.8.7
|2011-02-28
|Mhaws (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,331 Archive]
|[http://boards.openpandora.org/index.php?/topic/1998-lynx-087/ Discussion]
|-
|[[Me TV]]
|2010-10-19
|sebt3 (port)
|Network - digital TV
|[http://sebt3.openpandora.org/pnd/metv.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56987-port-request-me-tv/page__p__921501&#entry921501 Discussion]
|-
|[[Merkaartor]] 0.17.0
|2011-01-27
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/merkaartor.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56656-merkaartor-or-other-osm-editor/page__p__922345&#entry922345 Discussion]
|-
|[[Midnightcommander]]
|2011-03-27
|mcobit (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,367 Archive]
|Discussion: [http://boards.openpandora.org/index.php?/topic/2621-midnightcommander/ OP] [http://www.gp32x.com/board/index.php?/topic/59103-midnightcommander/ GP32X]
|-
|[[Midori]] 0.3.3-1
|2011-04-05
|slaeshjag (port)
|Network - web browser
|[http://stuffs.slaeshjag.org/midori-0.3.3-1.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/59121-midori-0-3-3/ Discussion] Fixed version of Midori.
|-
|[[MilkyTracker]]
|2010-06-23
|Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,102 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/milkytracker.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/57612-remember-the-only-2-keyboard-buttons-at-once-limitation/ Discussion]
|-
|[[Minitube]] 1.4.1.1
|2011-04-09
|Flavio Tordini, sebt3 (port)
|Network - Youtube client
|[http://sebt3.openpandora.org/pnd/?f=minitube.pnd Download] [http://repo.openpandora.org/?page=detail&app=minitube Repo]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/55952-minitube-1-1/ v1.1] [http://www.gp32x.com/board/index.php?/topic/58183-minitube-1-3/ v1.3] [http://www.gp32x.com/board/index.php?/topic/57099-new-version-of-minitube-avaiable/page__view__findpost__p__946029 v1.4]. Youtube browser/player
|-
|[[mtPaint]]
|2010-07-27 2010-12-29
|Mark Tyler, daniel3000 (port 1), chris_c (port 2)
|Graphics - image editor
|[http://www.hermocom.com/en/downloads/openpandora/mtPaint.pnd/ Download (port 1)] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,263 Archive (port 2)]
|[http://www.gp32x.com/board/index.php?/topic/55561-mtpaint-pnd-available/ Discussion]. For painting & pixel art. Ported twice.
|-
|[[MuPDF]]
|2011-04-13
|b3w (port)
|Office - PDF viewer
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11994 Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11994 Discussion (German)].
|-
|[[Mutt]]
|2011-03-01
|mash (port)
|Network - email client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,334 Archive]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/ Discussion]. Text-based.
|-
|[[MyPaint]]
|2011-02-27
|First (port)
|Graphics - image editor
|[http://webusers.spa.umn.edu/~laurens/pnd/mypaint-0.9.0.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1817-mypaint-port/ Discussion]. [http://mypaint.intilinux.com/ Website]. Has pressure sensitivity.
|-
|[[ncmpcpp4P]] v0.5.7.0
|2011-03-01
|remogatto (port)
|Audio - music player
|[https://github.com/downloads/remogatto/ncmpcpp4P/ncmpcpp4P_v0.5.7.0.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/2032-ncmpcpp4p/ Discussion]. [http://unkart.ovh.org/ncmpcpp/ Website] ncurses-based music player
|-
|[[Netsurf]] 2.6
|2011-03-08
|slaeshjag(port)
|Network - web browser
|[http://stuffs.slaeshjag.org/netsurf.pnd Download]
|Discussion: [http://boards.openpandora.org/index.php?/topic/2129-netsurf/ OP] [http://www.gp32x.com/board/index.php?/topic/58913-netsurf-2-6/ GP32X] No SSL support
|-
|[[Nightvision]] 3.0
|2011-03-12
|F_Slim (port)
|Office - planetarium
|[http://www.slimpages.de/extern/nightvision.pnd.zip Download]
|[http://boards.openpandora.org/index.php?/topic/2299-nightvision-30/ Discussion] [http://forum.gp2x.de/viewtopic.php?f=59&t=11810 (German}]. Needs java.pnd installed. May not work in HF5
|-
|[[Ommpc]] v0.5.4
|2010-10-06
|Tim Temple
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,133 Archive]
|MPD client [http://www.gp32x.com/board/index.php?/topic/55039-ommpc-v0-5-2/ Discussion]
|-
|[[OSM2Go]]
|2010-10-20
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/osm2go.pnd Download]
|
|-
|[[Osmo]] ('''beta''')
|2010-09-03
|sebt3 (port)
|Office - personal organizer
|[http://sebt3.openpandora.org/pnd/osmo.pnd Download]
|[http://clayo.org/osmo/ Website] [http://www.gp32x.com/board/index.php?/topic/56455-osmo/ Discussion]
|-
|[[PanDebian]]
|2011-02-04
|Gregor
|System
|[http://codu.org/tmp/pandebian.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1474-pandebian/ Discussion]. [[Extend Utils]] alternative for Angstrom-Debian cooperation
|-
|Pandora Fractals
|2010-08-26
|Or Green
|Graphics - fractals
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/PFractals.inf Apps]
|fractal generator. [http://www.gp32x.com/board/index.php?/topic/51402-mandelbrot-set-generator-for-pandora/page__st__75 Discussion]
|-
|Pandora SD Installer 1.2
|2011-03-19
|Dave1234
|System
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=337 Download]
|[http://boards.openpandora.org/index.php?/topic/2297-pandora-sd-installer/page__view__findpost__p__42772 Discussion]. Install Pandora OS to your SD card.
|-
|[[PanPlayer]] Beta 4
|2011-02-24
|JDGBOLT
|Media player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive] [http://apps.openpandora.org/cgi-bin/viewapp.pl?/Application/PanPlayer.inf Apps]
|'''Needs Hotfix 5'''. [http://www.gp32x.com/board/index.php?/topic/58769-panplayer-beta/ Discussion]. Optimized mplayer build
|-
|[[Pencil]] 0.4.4b ('''beta''')
|2010-11-04
|sebt3 (port)
|Graphics - animation
|[http://sebt3.openpandora.org/pnd/pencil.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57362-pencil/ Discussion]. 2D animation & drawing.
|-
|[[Pepviewer]]
|2011-02-22
|Skadus (port)
|Graphics - image viewer
|[http://www.mediafire.com/?t0sop9wrj087e1t Download]
|[http://boards.openpandora.org/index.php?/topic/1869-pepviewer/ Discussion]. Ported from PSP.
|-
|[[Pidgin]] 2.7.10
|2011-03-03
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/pidgin.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56898-pidgin/ Discussion]. This version no longer uses [[NAND]] to [http://www.gp32x.com/board/index.php?/topic/56898-pidgin/page__view__findpost__p__934658 store data].
|-
|[[PNDbuilder]] v1.1
|2011-02-22
|freedomdown (Ryan Dallaire)
|Development
|[http://www.freedomdown.ca/storage/pndb.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58587-pndbuilder/page__view__findpost__p__940230 Discussion]. Graphical PND maker.
|-
|PS3 Bluetooth Controller - Sixpair Utility
|2010-06-13
|Jim Paris, Samson Yeung, AireTamStrm (port)
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,4 Archive]
|Use a DualShock III Controller or SIXAXIS controller via USB
|-
|[[pnd_assoc]]
|2011-03-29
|Jey123456
|System
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=369 Download]
|[http://boards.openpandora.org/index.php?/topic/2634-pnd-assoc/ Discussion] Associate file types with PNDs
|-
|[[pnd_run.sh]] installer ('''beta''')
|2011-04-09
|sebt3
|System
|[http://sebt3.openpandora.org/pnd/pnd_run_installer.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/59113-pnd-run-sh/ Discussion]. Fix PND crashing errors since HF5.
|-
|[[pnd_utils]]
|2011-03-30
|Jey123456
|System
|[http://repo.openpandora.org/?page=detail&app=Pnd_Utils Repo]
|[http://boards.openpandora.org/index.php?/topic/2688-pnd-utils/ Discussion] Includes pnd_assoc and some other features.
|-
|[[PNDStore]] 0.2.2.0
|2011-04-13
|Tempel
|System - Application Downloader/Updater
|[http://repo.openpandora.org/?page=detail&app=pndstore Repo]
|[http://www.gp32x.com/board/index.php?/topic/59148-pndstore/page__view__findpost__p__946289 Discussion]
|-
|[[PSFreedom]]
|2010-09-23
|Notaz (port)
|Other
|[http://pandorapress.net/gruso/psfreedom.ko Download]
|[http://www.gp32x.com/board/index.php?/topic/56752-psfreedom-for-pandora/ Discussion]. Allows homebrew on your PS3.
|-
|[[qBittorrent]]
|2011-03-16
|Coldbird (port)
|Network - BitTorrent client
|[http://dl.dropbox.com/u/13011238/qbittorrent-1.3.3-pandora.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58993-qbittorrent/ GP32X] [http://boards.openpandora.org/index.php?/topic/2389-qbittorrent/page__gopid__41612#entry41612 OP]
|-
|[[qOrganizer]]
|2010-11-04
|sebt3 (port)
|Office - organizer
|[http://sebt3.openpandora.org/pnd/qorganizer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,233 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57359-qorganizer/ Discussion]
|-
|[[QSynth & FluidSynth]] 0.3.5 ('''beta''')
|2011-03-18
|Kazuki (port)
|Audio - synthesizer
|[http://pandora.idb.s1.jcink.com/qsynth-0.3.5.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/59011-porting-qsynth-fluidsynth-with-yactfeau/page__view__findpost__p__943670 Discussion] [http://qsynth.sourceforge.net/qsynth-index.html Website] {{HideableNotes|software synthesiser based on the Soundfont specification.}}
|-
|[[QtSpotify]]
|2011-03-11
|sebt3 (port)
|Network - music streaming
|[http://sebt3.openpandora.org/pnd/qtspotify.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58955-qtspotify/ Discussion]. Spotify client.
|-
|Quick Change CPU Speed
|2010-06-20
|Pleng
|System
|[http://www.strappysolutions.com/demos/pandora/CPUSpeeds.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54583-quick-change-cpu-speeds/ Discussion]. Add CPU speed presets to your menu.
|-
|RAM Defragger 0.4.0
|2011-03-16
|Tobias 'knilch' Jordan
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,359 Archive]
|memory optimizer
|-
|[[Remmina]]
|2010-06-21
|mindlord (port)
|Network - VNC/RDP/XDMCP client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,99 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/remmina.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54610-remmina-0-7-5/ Discussion]. Control your PC from your Pandora.
|-
|[[Rockbox]] 3.8.x.3 ('''beta''')
|2011-04-20
|Thomas Jarosch, froggyman (port)
|Audio - music player
|[http://repo.openpandora.org/?page=detail&app=rockbox.thomasjfox.003 Repo] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,343 Archive]
|[http://boards.openpandora.org/index.php?/topic/2094-rockbox-as-an-app/page__view__findpost__p__51473 Discussion]
|-
|[[RText]]
|2010-07-10
|Fifesoft, Chrysipp (port)
|Development - text editor
|[http://www.pandorasource.de/download.php?view.157 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10106%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhivaNHspNg4XSb4aOpjskxivvIRXw Discussion (German)]. Must have Java.pnd installed.
|-
|[[Schism Mod Player]]
|2010-06-10
|?
|Audio - music tracker
|[http://www.pandorasource.de/download.php?view.79 Download]
|Player for MOD and XM.
|-
|[[Schism Tracker]]
|2010-06-19
|Storlek, Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,89 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/schismtracker.inf Apps]
|Clone of Impulse Tracker
|-
|[[Scientific Calculator]]
|2011-02-14
|Chrysipp (port)
|Office - calculator
|[http://web.student.tuwien.ac.at/~e0725060/JavaScientificCalculator.pnd Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11714 Discussion (German)]. Must have Java.pnd installed. If you have trouble running it, try [http://boards.openpandora.org/index.php?/topic/673-java-pnd/page__view__findpost__p__51226 this].
|-
|[[Scite]] 2.21
|2010-10-20
|urjaman (port)
|Office - text editor
|[http://urjaman.dyndns.info/scite221.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57116-scite-2-21-ported/ Discussion]. Scintilla-based syntax highlighting text editor
|-
|Script Launcher
|2011-03-29
|meandu229
|System
|[http://boards.openpandora.org/index.php?/topic/2640-script-launcher/ Download]
|[http://boards.openpandora.org/index.php?/topic/2640-script-launcher/ Discussion] script to launch .sh files
|-
|SD Card Speed Fix
|2010-06-13
|mawler
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,88 Archive]
|improve SD writing speed, but risk data corruption if writing is interrupted
|-
|[[Seq24]] ('''beta''')
|2010-09-06
|Gruso (port)
|Audio - music tracker
|[http://users.tpg.com.au/pw2007/seq24.beta1.pnd Download] [http://repo.openpandora.org/?page=detail&app=seq24-0.8.7-pandora Repo]
|MIDI sequencer. [http://www.gp32x.com/board/index.php?/topic/56517-seq24-midi-sequencer/ Discussion]
|-
|[[SMPlayer]] 0.6.9-1
|2011-02-02
|Ivanovic (port)
|Media player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive]
|MPlayer frontend. [http://www.gp32x.com/board/index.php?/topic/58511-smplayer/ Discussion]
|-
|[[SUPA]] 0.1-1 ('''beta''') Simple Updater for Pandora Applications
|2010-07-04
|Bryce Leo
|System - Application Downloader/Updater
|[http://drive.and-a-half.com/SUPA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55023-supa-simple-updater-for-pandora-applications/ Discussion]. No GUI yet. PNDStore is probably better.
|-
|[[Synergy]]
|2010-10-09
|Lomaxx (port)
|Network - VNC client
|[http://www.mediafire.com/?npdbkibd5bm5ckb Download]
|[http://www.gp32x.com/board/index.php?/topic/56943-synergy-clientserver-as-pnd/ Discussion]. Control your PC from your Pandora.
|-
|[[Sxiv]]
|2011-04-13
|b3w (port)
|Graphics - image viewer
|[http://forum.gp2x.de/download/file.php?id=1088&sid=c7364ef00c1d355c4f22cd82b21dae0a Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11998 Discussion (German)].
|-
|[[TiMidity++]] 2.13.3 (player + Daemon loader)
|2011-03-21
|Gruso (port)
|Audio - MIDI
|[http://bunnitude.com/gruso/timidity-alsa-daemon.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/59041-timidity-2-13-2-port/ GP32X] [http://boards.openpandora.org/index.php?/topic/2450-timidity/ OP]. Must install Timidity MIDI Installer first. {{HideableNotes|This makes Timidity visible to sequencers as a device.}}
|-
|[[Timidity MIDI Installer]]
|2011-01-12
|sebt3
|Audio - MIDI
|[http://sebt3.openpandora.org/pnd/timidity_midi_installer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,273 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58173-midi-installer/ Discussion]. MIDI patches installer. {{HideableNotes|It will allow you to have music for games that use MIDI. There are 3 different sound-sample sets packing different levels of sound quality. Installs to [[NAND]], though you can put them on SD card and then it's less than 2k on NAND (2 2-line files).}}
|-
|[[Transmission]]
|2010-09-24
|sebt3 (port)
|Network - BitTorrent client
|[http://sebt3.openpandora.org/pnd/transmission.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,208 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56553-bit-torrent-client/ Discussion].
|-
|[[TrueCrypt]] ('''beta''')
|2011-02-12 2010-07-18
|TJSomething (port) daniel3000 (old port)
|System - encryption
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,321 Archive] [http://www.hermocom.com/en/downloads/openpandora/TrueCrypt.pnd/ old version]
|[http://boards.openpandora.org/index.php?/topic/1763-truecrypt-port/ Discussion]. [http://www.gp32x.com/board/index.php?/topic/55347-truecrypt-pnd-ready-for-testing/ Discussion (old)].
|-
|TuxPaint (from "Tux4Kids")
|2011-04-20
|mcobit (port)
|Graphics - image editor
|[http://repo.openpandora.org/?page=detail&app=tux4kids-tux4kids-27407 Repo]
|[http://boards.openpandora.org/index.php?/topic/2990-tux4kids Discussion]. Part of "Tux4Kids".
|-
|[[TV-Browser]] ('''beta''')
|2011-02-13
|chrysipp (port)
|Network - TV guide
|[http://web.student.tuwien.ac.at/~e0725060/TVBrowser.pnd Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11706 Discussion (German)]. [http://sourceforge.net/projects/tvbrowser/ Website]
|-
|[[Unace]]
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UnRar]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UPX]] (The Ultimate Packer for eXecutables)
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Viewnior 1.1
|2011-02-26
|gruso (port)
|Graphics - image viewer
|[http://bunnitude.com/gruso/Viewnior.pnd Download] [http://repo.openpandora.org/?page=detail&app=viewnior-viewnior-15225 Repo]
|[http://www.gp32x.com/board/index.php?/topic/55618-viewnior-pnd-available/page__view__findpost__p__940887 Discussion]
|-
|Vim Gvim 7.2 ('''beta''')
|2010-08-08
|joseluisjazz (port)
|Office - text editor
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Discussion]. [http://www.vim.org/about.php About]. Not a PND.
|-
|[[VLC]] 1.1.0 ('''beta''')
|2010-10-12
|sebt3 (port)
|Media player (video & audio)
|[http://sebt3.openpandora.org/pnd/vlc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54922-vlc/ Discussion]
|-
|[[Wahcade]] Emulator Frontend b1 ('''beta''')
|2011-02-06
|Sigma (port)
|System - frontend
|[http://www.mediafire.com/?h8o33khvtcy3x8m Download]
|[http://boards.openpandora.org/index.php?/topic/1508-wahcade-frontend-beta1/ Discussion].
|-
|[[Wbar]]
|2011-03-03
|mcobit (port)
|System - app launcher
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,338 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58858-wbar/ Discussion].
|-
|WiFi "Another Test Wifi Driver" ('''Beta''')
|2011-03-05
|David, notaz
|System
|[http://notaz.gp2x.de/misc/pnd/wl1251-modules_1.0-r24.5_omap3-pandora.ipk Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58888-another-test-wifi-driver/ GP32X] [http://boards.openpandora.org/index.php?/topic/2151-another-test-wifi-driver/ OP]. HF5 only, not for use with HF6.
|-
|WiFi '''Beta test'''
|2010-11-05
|Evildragon
|System
|[http://www.openpandora.org/downloads/WiFiBETA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57364-wifi-betatest/ Discussion]. Might fix WiFi issues.
|-
|[[Worker]] 2.17.11
|2011-04-01
|mash (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,375 Archive]
|[http://boards.openpandora.org/index.php?/topic/2709-worker-21711/ Discussion]
|-
|[[Xarchiver]] 0.5.2
|2010-12-04
|mcobit (port)
|System - file archiver
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,259 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57748-xarchiver/ Discussion]
|-
|Xbindkeys
|2010-10-14
|Lomaxx (port)
|System
|[http://userpages.uni-koblenz.de/~bbrink/tmp/xbindkeys-1.8.3_prebuild.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57037-xbindkeys-precompiled/ Discussion]. Configure hotkeys
|-
|[[XBMC]] 10.0 ('''beta''')
|2011-03-13
|sebt3 (port)
|Media player
|[http://sebt3.openpandora.org/pnd/xbmc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57106-xbmc-media-center/page__view__findpost__p__942955 Discussion]. Functions as "entertainment hub".
|-
|XFE 1.32.1
|2010-07-20
|Maxim Baranov, Roland Baudin, packaged by sebt3
|System - file manager, packager Graphics - image viewer Office - notepad
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,163 Archive]
|
|-
|[[Xournal]]
|2010-10-03
|sebt3 (port)
|Office - journal
|[http://sebt3.openpandora.org/pnd/xournal.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56864-xournal/ Discussion]. Can annotate PDFs.
|-
|[[Zim]]
|2011-03-02
|Mindlord (port)
|Office - personal wiki
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,337 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58850-zim-the-desktop-wiki/page__view__getnewpost Discussion]
|}

===Operating systems===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Arch Linux
|2011-03-19
|wejp
|Full OS
|[http://wejp.k.vu/pandora/plugapps_linux_on_the_pandora_handheld Download]
|[http://www.gp32x.com/board/index.php?/topic/59027-arch-linux-on-the-pandora/ Discussion] Using PlugApps, some libraries missing (like libpnd)
|-
|Debian (Squeeze)
|2011-04-09
|Stuckie
|Full OS
|[http://pandorawiki.org/Debian_On_SD#Debian_On_SD Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/page__view__findpost__p__945994 GP32X] [http://boards.openpandora.org/index.php?/topic/1819-debian-on-sd/page__view__findpost__p__48443 OP]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-09
|skeezix
|Launcher
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110209.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion] [http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/page__view__findpost__p__935861 Older versions]
|-
|Panorama ('''beta''')
|2011-04-19
|B-Zar dflemstr
|Launcher
|[http://repo.openpandora.org/?page=detail&app=bzar-panorama Repo]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/59231-panorama/page__view__findpost__p__946988 GP32X] [http://boards.openpandora.org/index.php?/topic/2979-panorama-alpha-preview/ OP]
|}

====Type explanation====
'''Full OS:''' It is a full desktop environment similar to the one your are used to on your PC. You usually get a X-based system with a window manager similar to the default one included in Xfce (meaning you can have multiple, drag-able windows, a task bar, etc.). This is what you would want for the full usability, but it often is slower in running games than a launcher as more tasks are running in the background.

'''Launcher:''' A more simplistic and sleek interface you might know from handhelds like the Wiz or Nintendo DS. Functionality is limited (compared to a full OS) as you don't have a desktop and usually no file browser. It often cannot display multiple windows or programs at once, but uses less memory, might be faster and better suited if you only want to run a few PNDs.

===Skins===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Basic Gray
|2010-11-25
|milkshake
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=506 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueFuture
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,239 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=434 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Executive
|2010-11-27
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,250 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928158 Discussion]
|-
|Gray Is Sexy
|2010-11-27
|milkshake
|Minimenu skin
|[http://www.liquidfists.com/files/grayissexy.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928315 Discussion]
|-
|Midnight
|2010-06-17
|Trevsweb
|Minimenu skin
|[http://trevsweb.com/pandainterface/midnight.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|Newsprint
|2010-07-26
|Pleng
|Minimenu skin
|[http://www.strappysolutions.com/demos/pandora/newsprint.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|RedDevil
|2010-11-26
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,248 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928099 Discussion]
|-
|RedWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=433 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Toybox & Corporate (2 skins)
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=432 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Wasp
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,238 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|}

===Graphic engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[GLES]] ('''beta''')
|2010-09-02
|Farox (port)
|
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Download]
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Discussion]
|}
===Demos/technical demos===

==Unreleased software ("Projects Under Development")==
This section includes both software that is actively being worked on, as well as ones that are or may be abandoned. The latter are included for historical purposes.

===Operating systems===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Android Omap
|[http://elinux.org/Android_on_OMAP]
|wip
|
|
|-
|AROS Arm
|[http://projects.powerdeveloper.org/project/imx515/735]
|wip
|
|
|-
|Debian
|[http://debian.org] [http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/]
|working build
|Stuckie
|
|-
|FreeBSD
|[http://wiki.freebsd.org/FreeBSD/arm/OMAP]
|wip
|
|
|-
|Fedora ARM
|[http://fedoraproject.org/wiki/Architectures/ARM]
|wip
|
|
|-
|Gentoo Linux
|[http://neuvoo.org] [http://vminko.org/gentoo_manuals/pandora]
|Working build, not completed
|javaJake, Viridior, vminko
|IRC: (FreeNode) #gentoo-pandora
|-
|HaikuOS
|[http://www.haiku-os.org]
|wip
|
|
|-
|Ohhie GUI
|[http://www.gp32x.com/board/index.php?/topic/58320-video-ohhie-gui/]
|working build
|Pleng
|Last update: Jan. 2011
|-
|RISC OS
|[[RISC OS|Link]]
|wip
|Uwe Kall, Jeffrey Lee + others
|BeagleBoard port available for download and testing.
|-
|Ubuntu ARM
|[http://www.ubuntu.com/products/whatisubuntu/arm]
|wip
|
|
|-
|Xoo on ubuntu
|[[Xoo on ubuntu|Link]]
|wip
|
|
|}

===Game Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OLA.G.E
|[http://sourceforge.net/projects/olage/]
|Wip
|neilae
|Game Engine with Authoring Tool for multiplatforms
|}

===Graphic Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|GLES2D
|
|Wip
|Cpasjuste
|OpenGL ES 2D library
|-
|GL-WES-v2.0
|[http://code.google.com/p/gl-wes-v2/]
|Working Build
|Adventus
|Opensource OpenGL 2.0 driver built on OpenGL ES 2.0
|-
|Irrlicht
|[http://irrlicht.sourceforge.net/] [http://irrlicht.sourceforge.net/phpBB2/viewtopic.php?t=32538&start=45]
|working build
|Hybrid
|3D game engine
|-
|NSS Engine
|[http://www.nosiestastudios.com/wiki/] [http://www.youtube.com/user/Prompt84]
|
|No Siesta Studios
|
|-
|OGRE Engine
|[http://www.gp32x.com/board/index.php?showtopic=46706] [http://www.youtube.com/watch?v=LDtUE5PIhV0]
|
|
|3D real-time renderer
|-
|Otaco Glost Engine
|[http://www.youtube.com/user/otacogloost], [http://www.gp32x.com/board/index.php?/topic/48393-i-did-stuff/page__p__736650&#entry736650]
|working
|Otaco
|
|-
|Quad-Ren 2D
|[http://quad-ren.sourceforge.net/index.php]
|Working
|Hessiess
|Version 0.5
|-
|SDL GLES
|[http://github.com/Cpasjuste/sdl-1.2.13_gles/tree]
|working
|Cpasjuste
|
|-
|XreaL
|[http://xreal.sourceforge.net/xrealwiki/]
|
|Pickle
|No longer being worked on. [http://www.gp32x.com/board/index.php?/topic/55173-xreal-patch-question/]
|-
|Stratagus
|[http://stratagus.sourceforge.net/]
|working build
|Cpasjuste
|RTS Engine
|-
|WakeBreaker
|[http://w1xer.at/pandora/]
|working codebase - can be compiled onboard
|torpor
|Working C++ codebase to implement a 3D game using nothing more than OpenGLES 1.1 .. can even be built *on* the Pandora, with nothing more than the onboard compiler. WakeBreaker contains everything you need to get started writing a 3D game in C++ with OpenGL ES - no further libraries required. Its an excellent example of how to write a 3D game in plain, easy to understand C++ and can serve as a working base for your own developments, easily enough.
|}
===Other programs===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Inside The Box
|[http://www.openpandora.pl broken] [http://www.youtube.com/watch?v=uLMmJBDEs2E broken]
|wip
|StreaK
|Pandora e-zine
|-
|Math-NEON
|[http://code.google.com/p/math-neon/]
|Wip
|Adventus
|cmath like library optimized for ARM NEON coprocessor
|-
|MythTVPlayer
|[http://www.gp32x.com/board/index.php?/topic/52882-mythtvplayer/]
|Working build
|Pickle
|Media center + TV/DV recording
|-
|Pandaphone
|[http://www.gp32x.com/board/index.php?/topic/48327-pandaphone/]
|
|jb0yx
|project to incorporate the Open Pandora handheld device with cell phone technology
|-
|Pandora Sync Suite
|[http://www.openpandora.pl broken]
|Working build
|StreaK
|for Windows 9x/NT
|-
|Pangea GUI
|[http://www.gp32x.com/board/index.php?showtopic=45631&hl=pangea]
|WIP
|efegea
|Gmenu alternative
|-
|PDM
|[http://github.com/Cpasjuste/pdm/tree]
|
|Cpasjuste
|Light desktop manager for Pandora
|-
|PGui
|[http://github.com/Cpasjuste/pgui/tree]
|
|Cpasjuste
|Standard emulator fronted for Pandora
|-
|PMenu
|[http://mydedibox.fr/_stuff/pandora/]
|
|Cpasjuste
|Minimal Menu for Pandora
|-
|PND Builder for windows
|[http://www.gp32x.com/board/index.php?/topic/47088-pnd-builder-for-windows/]
|Working build
|StreaK
|
|-
|Qemu
|[http://wiki.qemu.org/]
|testing build
|Fabrice Bellard
|open source machine emulator and virtualizer
|-
|Scale
|[http://www.youtube.com/user/Zoxc64]
|wip
|Zoxc64
|Minimal Menu for Pandora
|-
|Simple Dev Studio for Pandora
|[http://www.openpandora.pl broken]
|Wip
|StreaK
|for Windows 9x/NT
|-
|[[TINXL]]
|[[TINXL]]
|
|
|Application stack for multiplayer internet games
|}

===Demos / Technical Demos for OpenPandora===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OpenGL Cell Shading
|[http://www.youtube.com/watch?v=cpAj0jHglGw]
|working build
|
|
|-
|OpenGL Demo with MP3 Playback
|[http://www.youtube.com/watch?v=hkx18kruRJs]
|working build
|
|
|-
|OpenGL Skull Demo
|[http://www.youtube.com/watch?v=qG7EDaZpyOo]
|working build
|
|
|-
|WaveDemo
|[http://www.youtube.com/watch?v=4wgEHFCq9Lo]
|Working
|Otaco
|
|}

==External links==
*[http://sebt3.openpandora.org/pnd/ Releases by sebt3]
*[http://www.hermocom.com/en/downloads/openpandora/ Releases by Hermocom]
*[http://rebirthofxeen.com/files/pandora/ Releases by WizardStan]
*[http://www.stuckiegamez.co.uk/apps/pandora/ Releases by Stuckie]
*[http://www.pandorasource.de/download.php PandoraSource.de downloads] - German Pandora download site

===Forums===
The following community forums are checked when updating this page:
*From GP32X: [http://www.gp32x.com/board/index.php?/forum/63-news-zone-pandora/ News Zone], [http://www.gp32x.com/board/index.php?/forum/71-beta-testing-pandora/ Beta Testing] and [http://www.gp32x.com/board/index.php?/forum/64-developers-corner-pandora/ Developer's Corner]
*From OP: [http://boards.openpandora.org/index.php?/forum/26-software-news/ Software News] and [http://boards.openpandora.org/index.php?/forum/10-beta-testing/ Beta Testing]
*From GP2X.de: [http://forum.gp2x.de/viewforum.php?f=24 News] and [http://forum.gp2x.de/viewforum.php?f=59 Betatest]

[[Category:Development]]
[[Category:List]]
[[Category:Software]]
[[Category:Ideas and proposals]]

Talk:Extend Utils

2011-04-24T11:19:24Z

Stuckie: New release should be a bit clearer and sort out the madness of the page.

I have no idea what Ambox is, but it has absolutely nothing to do with Extend Utils. 
I wrote Extend Utils myself last year, and I have never heard of this "Ambox" thing till it was tagged onto this page, which incidentally IS documentation for the Extend Utils suite. 
If you're going to make random edits like that, it's actually somewhat courteous to let the original author know before doing so.. just because it's a Wiki doesn't mean you should just go about and edit as you please. [[User:Stuckie|stuckie]] 21:06, 22 April 2011 (MEST)
:Sorry it wasn't my intention to annoy anybody Stuckie :( [[:template:Ambox]] is to create this nitty small hint boxes. In this case I used it to mark that we might think about splitting up this page, cause to me it seemed to be a bit to much. --[[User:ABC|ABC]] 00:16, 23 April 2011 (MEST)
:: Ah it's a template.. wasn't quite aware of that. Apologies for being a bit snippy; work has been a bit hectic and I'm probably a bit overstressed just now! Just saw lots of my pages get changed without much indication as to what was going on or why and had a slight knee-jerk reaction! In future, please post in the comments what it is you're doing, or check with me in advance if it's one of my pages as I tend to have mass edits offline to push up when I've got a release ready ;) As for splitting the page - the whole thing is documentation for Extend Utils which is itself a rather large and complex set of scripts, so not sure how you'd want to split it up. What would you suggest? [[User:Stuckie|stuckie]] 00:25, 23 April 2011 (MEST)

Stuckie, are you sure that "OS extends" is a subsection of "bug reports"? Granted I know nothing, but that seems like it might be wrong. [[User:Esn|Esn]] 07:10, 23 April 2011 (MEST)
:Fixed.. not sure how I never noticed that.. those were describing available files, so I must've added Bug Reports at some point and mucked the ordering up - probably from being annoyed at people going "It's broken" and that being their entire bug report! [[User:Stuckie|stuckie]] 11:08, 23 April 2011 (MEST)
What I miss is a more general Overview for people not familar with Pandora or OS layers in general. And I would prefer a more neutral style ( no 'me', and focused/ordered more on usage not development). What does the others say? --[[User:ABC|ABC]] 14:05, 23 April 2011 (MEST)
:Not quite sure what you're wanting here... Extend Utils really isn't for use by everyone ( it's still under "Dodgy Hack" status, has a rather hostile "GUI" if you can even call a bunch of Zenity scripts a GUI, and can sometimes fail to mount things without telling you ) a fact compounded in that I haven't pushed it to any app repository ( and it definitely better not be in any of them. ) An overview of the Pandora OS doesn't have much to do with Extend Utils - it's just a set of scripts for using loopback files and mounting them in special ways. The documentation is also focused more on development as that's generally what it's aimed at; it's not stable enough for general use in my opinion, and was written specifically for myself to aid development on the Pandora itself, with the documentation here being more pointers to help others use it. I sadly don't have much free time to work on stuff, and would rather work on the applications themselves than documentation, so I'll write the documentation up quickly in this style to get something up - which has to be better than nothing, right? Feel free to rewrite it if you want, but I'd ask you to email me the results first, before pushing it on the page, so I can check it. [[User:Stuckie|stuckie]] 14:33, 23 April 2011 (MEST)
::Well ATM I'm not that expereienced to contribute to such a advanced topic. This was just my suggestion to point out some details of the topic to anybody that visits this page :) --[[User:ABC|ABC]] 19:51, 23 April 2011 (MEST)
:::I'm sortof working on another Extend Utils feature, then it's onto an actual GUI-based application, so that should help sort things out a bit better.. for now, this documentation page is probably a bit too invaluable as it stands as it's the only guide/tutorial/documentation/thing for Extend Utils. [[User:Stuckie|stuckie]] 13:19, 24 April 2011 (MEST)

Talk:Extend Utils

2011-04-23T12:33:47Z

Stuckie: Styling/Usage reply

Talk:Extend Utils

2011-04-23T09:08:05Z

Stuckie: Bug Report/Available File swappage

Extend Utils

2011-04-23T09:06:23Z

Stuckie: Swapping Bug Reports and Available Files around.. not sure how I've never noticed that!

= Overview =

[[Extend Utils]] provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Bug Reports =
In order for a bug report to be useful, I need the following information from you: 
Output from "dmesg | tail", "mount" and your preMount script. 
A description of the error.

Just PM me them on the GP32X boards, or post in the relevant threads - Links at the bottom of this page.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the Simple Dev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For those that prefer the "classic" version which doesn't have as much options available to it, you can grab that here:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/OldExtendUtils.pnd Classic Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in New Extend Utils, but are available here as well as they're just loop files and can therefore be used with other things:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/4GBExtend.zip 4GB Extend]

== Dev Extends ==
The last Dev Extend is very very old and may not work on recent firmwares. 
A newer one is in progress as of 24th Feb 2011.

=== Old Releases ===
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

Alternatively, check the [[Debian On SD]] project for booting Debian directly from SD card.

=== Gentoo ===
None, yet.

=== Ubuntu ===
Ubuntu is now officially 100% not supported. Upstart is an arse.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

See [[Debian On SD]] for a better solution ( Debian booting from SD ) for the moment.

== Ubuntu OS Extend ==
Ubuntu caused a great deal of stress and hacking about to get it to work in any shape or form - this is mostly due to Upstart. 
Eventually, only Jaunty was able to be loadable much. 
With the recent progres with [[Debian On SD]] I think that Ubuntu is a lost cause, so I'm removing all Ubuntu files from my server as they were utterly hacky to begin with.

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

Unfortunately, a Dev Extend hasn't been released for a while, and may currently BREAK some applications on the Pandora with the latest hot fix releases.. use with caution, or create an Overlay and install dev tools into that ( which is effectively all a Dev Extend is. )

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]
[[Category:Filesystem]]
[[Category:Operating System]]
[[Category:Tutorials]]

Talk:Extend Utils

2011-04-22T22:25:57Z

Stuckie: Apologies for being snippy!

Talk:Extend Utils

2011-04-22T19:06:15Z

Stuckie: Expressing my annoyance over this "ambox" thing being tagged on without anyone contacting me about it beforehand.

Extend Utils

2011-04-22T19:01:07Z

Stuckie: Removing random nonsense that has got NOTHING to do with Extend Utils, and adding the Documentation tag back. If you have an issue, you talk to the original author, not just randomly start messing...

= Overview =

[[Extend Utils]] provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the Simple Dev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For those that prefer the "classic" version which doesn't have as much options available to it, you can grab that here:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/OldExtendUtils.pnd Classic Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

= Bug Reports =
In order for a bug report to be useful, I need the following information from you: 
Output from "dmesg | tail", "mount" and your preMount script. 
A description of the error.

Just PM me them on the GP32X boards, or post in the relevant threads - Links at the bottom of this page.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in New Extend Utils, but are available here as well as they're just loop files and can therefore be used with other things:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/4GBExtend.zip 4GB Extend]

== Dev Extends ==
The last Dev Extend is very very old and may not work on recent firmwares. 
A newer one is in progress as of 24th Feb 2011.

=== Old Releases ===
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

Alternatively, check the [[Debian On SD]] project for booting Debian directly from SD card.

=== Gentoo ===
None, yet.

=== Ubuntu ===
Ubuntu is now officially 100% not supported. Upstart is an arse.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

See [[Debian On SD]] for a better solution ( Debian booting from SD ) for the moment.

== Ubuntu OS Extend ==
Ubuntu caused a great deal of stress and hacking about to get it to work in any shape or form - this is mostly due to Upstart. 
Eventually, only Jaunty was able to be loadable much. 
With the recent progres with [[Debian On SD]] I think that Ubuntu is a lost cause, so I'm removing all Ubuntu files from my server as they were utterly hacky to begin with.

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

Unfortunately, a Dev Extend hasn't been released for a while, and may currently BREAK some applications on the Pandora with the latest hot fix releases.. use with caution, or create an Overlay and install dev tools into that ( which is effectively all a Dev Extend is. )

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]
[[Category:Filesystem]]
[[Category:Operating System]]
[[Category:Tutorials]]

User:Stuckie

2011-04-22T18:51:44Z

Stuckie: Moving Bennu to "possibly" maintained due to recent release.

I do scary dodgy hacks ;)

Homesite: [http://www.stuckiegamez.co.uk stuckieGAMEZ]

= Scary Hacks =
== Extend Utils ==
[[Extend Utils]] - The Extend Utils suite which allows loading of loop files for swap, overlays and OS extensions. 
== Debian on SD ==
[[Debian On SD]] - OS project to get Debian running on Pandora via SD card; maintaining all Debian and Pandora features. 

= Other Projects =
== GLESGAE ==
[[GLESGAE]] - GL ES Game Application Engine; an engine originally written for Pandora to aid in GL ES programming and porting to other capable devices. 
Not released as yet.

= (Possibly) Maintained Ports =
== Bennu ==
* Recent version available for beta testing as of 20th April 2011

= Unmaintained Ports =
Unmaintained in the sense that, they've been released and work as far as I'm aware.. unless someone shouts at me otherwise, they'll stay that way! 
I'm also not directly keeping an eye on the original package for updates.
== MAXR ==
* Technically, this does work completely as intended as they only have multi-player running, and no single player.
* Might be tempted to upgrade it at some point if there's interest, and there's been an update since.

== MilkyTracker ==
* There was a bug report that an HF5 beta had issues with it... will test again once HF5 is final.

== SchismTracker ==
* Had no bug reports from it, I assume it's fine.

== gMPC ==
* There's a much better port than the one I quickly put together.

== gimp ==
* Very very quick and hacky port... really needs a rebuild properly - which sebt3 has done, use his instead!

= Package Site =
My packages can usually be found on http://www.stuckiegamez.co.uk/apps/pandora .. if linking to this, I'm "stuckie" not "stuckieGAMEZ" or any variation of!

= Contact Details =
Can be found in irc mostly... PM me if you don't get a response in a timely fashion, and I'll contact you when I'm around.

GLESGAE

2011-04-10T22:55:49Z

Stuckie: Adding link to Shader Based Contexts

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]
* [[GLESGAE:Shader Based Contexts]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

Debian On SD

2011-04-10T13:49:50Z

Stuckie: /* Release 1.0.5 */ more info on the sneaky bug fixes

= Debian On SD =

I'm going to split this into three chunks now... standard Desktop Debian on SD using Squeeze/Lenny/Sid ( choose your poison, though only Squeeze is officially tested to work by myself, ) Emdebian GRIP install, and NAND install.

You can post feedback, bugs, etc.. on the following topics:
GP32X: http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/
OpenPandora Boards: http://boards.openpandora.org/index.php?/topic/1819-debian-on-sd/

I'd prefer the GP32X boards as I'm slightly more active there.

= Little Note to Wiki Editors =
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Desktop Debian ==
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 and 1.0.4 "brute force" releases. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full builds are:
* LXDE - http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.4-grip.tar.bz2
* XFCE - http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.5-grip.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2/3 formatted SD card. 
For example: '''''tar -xvjpf pandora-squeeze*.tar.bz2 -C /media/sdcard .'''''

Default User details are: 
username: '''pandora''' 
password: '''debian'''

=== Changelog ===
==== Original Proof of Concept ====
* Released - 19th October 2010
* Based on Sid
* GDM
* GNOME
* Bit slow but workable

==== Release 1.0 ====
* Released - 20th February 2011
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

==== Release 1.0.1 ====
* Released - 23rd February 2011
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

==== Release 1.0.2 ====
* Released - 22nd March 2011
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

==== Release 1.0.3 ====
* Released - 27th March 2011
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

==== Release 1.0.4 ====
* Released - 4th April 2011
* 1.0.3 with lots of bugs fixed and based on Grip so it's got even more and super tiny in comparision.
* Contains; LXDE, GDM, Gnome MPlayer, IceWeasel ( firefox ) and Synaptic

==== Release 1.0.5 ====
* Released - 9th April 2011
* 1.0.4 with XFCE instead of LXDE and a few bug fixes ( pandora-state's rc scripts being set correctly, and console key map .. see the relevant bits below if you need them, but other than that, it's exactly the same - just with XFCE instead of LXDE )

=== Release 1.1 Proposed ===
* Expected - May 2011 ( maybe )
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

== Building From Scratch ==
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

=== Getting a Minimal Install from Scratch ===

There are two options here:
* Linux PC
* On Pandora

==== Linux PC ====
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian''''' 
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

==== Pandora ====
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

=== Setting up Apt ===
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

=== Desktop Environment ===
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

=== Device Drivers and PNDs ===
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

==== X Display Driver ====
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

==== SGX Drivers ====
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

===== Libraries =====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

===== Demos/SDK =====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

==== Keymap ====
The keymap is actually stupidly easy, and I've missed how easy it is for quite a while now! 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

1.0.4 is again different, and doesn't HUP pndnotifyd at all as it seemed to work without much issue just by starting the service differently, also, due to use of GDM, we do the xmodmap at GDM's startup instead in the following manner: 
'''''sudo nano /etc/gdm/Init/\:0''''' - the \ is needed to use : as a character! 
#!/bin/bash
xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183
xmodmap /etc/skel/.pndXmodmap
loadkeys /etc/keymap-extension-2.6.map

The xinput line is for the evdev touchscreen configuration, if this is wrong, please run '''xinput_calibrator''' from a Terminal, and replace the line with what it gives you!

The loadkeys line also ensures that the console gets the correct keymap as well.

Thanks to chris_c for the GDM init hint, and mcobit for the loadkeys hint!

Should probably copy more over but, this'll do for now. 

==== Nubs ====
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

==== Touchscreen ====
===== Current 1.0.2/3 Release =====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

This is already done on 1.0.4 and xinput_calibrator is included should you need to re-run it.

===== libts for other releases =====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

==== Wifi ====
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

==== Bluetooth ====
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

==== Kernel and Misc Bits and Pieces ====
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

==== Misc Init Scripts and Things ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

==== PNDs ====
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1''''' 
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

==== RC Scripts ====

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set.
===== Script Fixups =====
We need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pndnotifyd-init, pndevmapperd-init and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up. 
The update-rc.d program will shout at you which ones, and essentially, it's just some tidying up that needs done.

It's now recommended to use update-rc.d to put these in rather than the old heavy handed ln calls:
update-rc.d led-config defaults 05
update-rc.d pndevmapperd-init defaults 30 40
update-rc.d pndnotifyd-init defaults 30 40
update-rc.d pandora-state defaults 05

The pandora-state is different on Angstrom than Debian as it didn't start up with it's usual bindings, which was annoying!

=== Users and Permissions ===
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

You'll also need to do the above for every new user you create for the moment.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

=== Reboot and Troubleshooting ===

==== auto/boot.txt ====
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

Alternatively, if you remove the '''console=ttyS0,115200n8''' part, you will be able to see debug text as the system boots up.

All that's really left now is to reboot and catch any issues that may crop up!

==== First Boot ====

===== tslib calibration =====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

===== Finish up installing any left overs =====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

==== Cleanup ====
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

== Maintenance and Upgrades ==
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

== Common Issues/Fun Things To Do ==
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

=== Networking ===
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

=== Synaptic ===
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

=== My PNDs don't work, why?! ===
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 and 1.0.4 do not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

=== Wifi and Session Management is broken?! ===
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

=== My PNDs don't appear immediately? ===
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

This should be fixed in 1.0.4

=== I get no notifications in 1.0.3 ===
This is actually because notification-daemon hasn't been installed.

=== Packages to add in 1.1! ===
Feel free to add packages here that I should include in the next release (1.1)
* wireless-tools
* x11-xserver-utils ( I keep forgetting this.. it's for xmodmap )
* xinput - for evdev's configuration
* console-tools - for chvt
* xterm - for failsafe console
* bash-completion - tis handy to have
* aptitude - somehow I forgot this.

= Emdebian Grip =
Most of the above can be taken for Grip, with the following changes...

Why Grip? It's much smaller and targeted for embedded devices... I originally was going to use Grip actually, but it was a bit buggered at the time, though it seems to be working now. 
Additionally, Emdebian comes in Crush and Baked flavours... Grip is compatible with Desktop Debian, so we'll use that.. Crush is smaller again, and generally requires a cross-compiler to setup packages, and Baked is effectively what we do with Angstrom.

Emdebian could also in theory be shrunk enough to actually fit on NAND... which is something I'll be looking into - if only to document another alternative process to the Angstrom OE bitbake bonanza.

== Multistrap ==
Grip's debootstrap is slightly different... it uses multistrap instead.

This allows us to use Grip's repository as the base, and Desktop Debian's repositories for anything else we might need ( omap3 drivers, for instance. ) This is also particularly useful for us when I get around to doing Pandora specifics compiled for Debian, as then we just add that repository as well.

Anyway, we need Debian running for this - be it on your Desktop ( or Ubuntu ) or on your Pandora ( recommended, as this guide assumes this is what you're doing. ) 
Install Multistrap - '''''sudo apt-get install multistrap'''''

You'll also need to mount an SD card somewhere manually.. I've mounted mine to /tmp/emdebian: '''''sudo umount /dev/mmcblk1p1 && mount /dev/mmcblk1p1 /tmp/emdebian'''''

=== Config File ===
'''''nano multistrap'''''
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

'''''sudo multistrap -f multistrap'''''

Change /tmp/multistrap to where ever you want the debootstrap to occur. 
'''Gotcha''''' I had issues with it complaining about unauthenticated packages, just add '''--no-auth''' to your command line and it'll continue happily.''

This shouldn't take too long ( was about half an hour on my Pandora ) and gives you a very sparse minimal rootfs of 192Mb.

The following multistrap config will give you what's in the 1.0.4 Grip rootfs
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=xserver-xorg-video-omap3 libxcb-dri2-0 libnotify-bin xinput
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=lxde busybox network-manager-gnome xfce4-power-manager apmd gdm less sudo nano wireless-tools iceweasel synaptic gnome-mplayer x11-xserver-utils notification-daemon gnome-keyring
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

You could also add packages into the Grip and Debian configuration parts, and it will automatically pull them down and install them for you, be careful with what you pull in though, as not everything has been repackaged for Grip, so it will pull down the "full fat" variants from Debian instead.

You might get errors of unconfigured packages, just chroot in and run '''''apt-get -f install''''' to finish up.. if there are warnings about proc, ignore them till you reboot into the rootfs and re-run '''''sudo apt-get -f install'''''.

== Chroot and Setup ==
Now we can just chroot in and setup as we see fit. 
'''''sudo chroot /tmp/emdebian''''' - again, you may have mounted your media elsewhere. 
'''''sudo apt-get update'''''

You can now just follow the Debian guide as above, with the added bonus of most packages will come from Grip and be pre-stripped of extra fluff. 
I would recommend to get as much stuff as possible downloaded in the initial multistrap however, as it will automatically clean stuff up for you.

= Debian On NAND =
First of all, 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

== Get a Debian Rootfs ==
Your NAND has about 475Mb for the rootfs to play with ( there are other partitions, remember! ), therefore Desktop Debian is a bit too large for our purposes - even 1.0.3's complete massacre still ended up too big by far; so we need to look at Emdebian, of which there are three flavours - grip, crush and baked. 
We'll be using Grip, so follow the guide above for at least getting a working system on SD before going anywhere near your NAND.

We can use compression to get your rootfs down by 40-50%, but I'd still be vary wary of a large rootfs!

If you're lazy, grab my pre-made Grip rootfs, which includes LXDE by default.

== Preparing the Rootfs ==
Boot into your rootfs for this, so we can ensure we're as up to date as we can be, then clean the apt cache, and then any crap we installed which we don't need any more, such as things which were installed as dependencies and the parent's been removed. 
'''''sudo apt-get update''''' 
'''''sudo apt-get upgrade''''' 
'''''sudo apt-get clean''''' 
'''''sudo apt-get autoclean''''' 

Additionally, you could wipe out the documentation ( if any ) and manually pull out unwanted packages. However, if you're pulling stuff out, you shouldn't have installed it in the first place! Go back to the start and do it again as punishment!

This post on the Ubuntu forums is particularly helpful: http://ubuntuforums.org/showthread.php?t=140920

Depending on your needs, you may also want to wipe out your home folder and reinstate it from /etc/skel 
You'll also want to wipe out tmp - '''''sudo rm -rf /tmp/*'''''

Now shut down and either place your SD card in your PC. You can do this on Pandora, but you will need a lot of space.

Copy your rootfs somewhere.. I suggest /tmp/pandora-debian 
'''''mkdir /tmp/pandora-debian''''' 
'''''sudo cp -p -r /media/my/sd/card/* /tmp/pandora-debian''''' - this will preserve Permissions and copy everything Recursively.

We need to edit the fstab so that it can boot properly, if you haven't done so already. 
'''''sudo nano /tmp/pandora-debian/etc/fstab'''''
# OpenPandora fstab.

rootfs / auto defaults,noatime 1 1
proc /proc proc defaults 0 0
devpts /dev/pts devpts mode=0620,gid=5 0 0
usbfs /proc/bus/usb usbfs defaults 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /dev/shm tmpfs mode=0777 0 0
tmpfs /media/ram tmpfs defaults 0 0

This should look familiar, as it's effectively your stock fstab minus the boot partition ( we have a kernel in our rootfs, if you've followed the above guides... )

We should also get rid of the autoboot.txt or boot.txt; '''''sudo rm /tmp/pandora-debian/autoboot.txt'''''

== Creating the Image ==
You need mtd-utils in your Debian distro of choice. '''''sudo apt-get install mtd-utils'''''

Now, mkfs.ubifs can compress using either LZO ( by default ) or zlib and will get your rootfs about 40-50% smaller depending on what you choose. It's also possible to use a combination of both, which is what we will do later.. Of course, if your rootfs is full of pre-compressed stuff already, it's not really going to shrink a great deal. 
For a full run down on mkfs.ubifs and co, see here: http://www.linux-mtd.infradead.org/doc/ubifs.html

Download the flash kit: http://openpandora.org/firmware/pandora-flash-kit.zip and extract it to /tmp/flash. I suggest reading the README as well.

Now run these fun commands... what we're doing is we're making a ubifs image first, then making an md5 checksum. 
We're also favoring LZO compression meaning we're mixing zlib and LZO to get the best compression we can. 
'''''sudo mkfs.ubifs -r /tmp/pandora-debian -o rootfs.img -m 2048 -e 129024 -c 4042 -x favor_lzo -X 20''''' 
'''''md5sum rootfs.img > rootfs.md5'''''

'''STOP! If your rootfs.img is getting close to 480Mb, you might not want to try and flash it.. it may be fine, but I would recommend 450Mb as an absolute maximum.'''

== Flashing the Image ==
I shall repeat: 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

Stick the following on to a FAT32 formatted SD card: 
* '''boot.scr''' - from the flash kit.
* '''rootfs.img''' - the image you've just created.
* '''rootfs.md5''' - the checksum to the image.

Place it in slot 1 of your Pandora ( the left slot, ) reboot while holding the right trigger, select boot from SD, cross your fingers and pray to the Pandora Gods.

Once it's done.. reboot and see what mess you've made, assuming you get it to boot! 
If you haven't got it to boot, on your FAT32 flasher card, add an autoboot.txt with the following:
setenv bootargs ubi.mtd=4 ubi.mtd=3 root=ubi0:rootfs rootfstype=ubifs rw vram=6272K omapfb.vram=0:3000K
ubi part boot && ubifsmount boot && ubifsload ${loadaddr} uImage && bootm ${loadaddr};

As this will let you see what's gone wrong... I had to do this a few times, as I buggered it up myself...

Congratulations, you now have Debian on NAND rather than Angstrom. 
Also, these instructions could easily be adapted to allow you to use any other distro that boots on Pandora.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-04-09T14:59:29Z

Stuckie: Added 1.0.5 .. which is 1.0.4 with XFCE instead of LXDE and a few bug fixes.

= Debian On SD =

I'm going to split this into three chunks now... standard Desktop Debian on SD using Squeeze/Lenny/Sid ( choose your poison, though only Squeeze is officially tested to work by myself, ) Emdebian GRIP install, and NAND install.

You can post feedback, bugs, etc.. on the following topics:
GP32X: http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/
OpenPandora Boards: http://boards.openpandora.org/index.php?/topic/1819-debian-on-sd/

I'd prefer the GP32X boards as I'm slightly more active there.

= Little Note to Wiki Editors =
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Desktop Debian ==
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 and 1.0.4 "brute force" releases. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full builds are:
* LXDE - http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.4-grip.tar.bz2
* XFCE - http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.5-grip.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2/3 formatted SD card. 
For example: '''''tar -xvjpf pandora-squeeze*.tar.bz2 -C /media/sdcard .'''''

Default User details are: 
username: '''pandora''' 
password: '''debian'''

=== Changelog ===
==== Original Proof of Concept ====
* Released - 19th October 2010
* Based on Sid
* GDM
* GNOME
* Bit slow but workable

==== Release 1.0 ====
* Released - 20th February 2011
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

==== Release 1.0.1 ====
* Released - 23rd February 2011
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

==== Release 1.0.2 ====
* Released - 22nd March 2011
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

==== Release 1.0.3 ====
* Released - 27th March 2011
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

==== Release 1.0.4 ====
* Released - 4th April 2011
* 1.0.3 with lots of bugs fixed and based on Grip so it's got even more and super tiny in comparision.
* Contains; LXDE, GDM, Gnome MPlayer, IceWeasel ( firefox ) and Synaptic

==== Release 1.0.5 ====
* Released - 9th April 2011
* 1.0.4 with XFCE instead of LXDE and a few bug fixes.

=== Release 1.1 Proposed ===
* Expected - May 2011 ( maybe )
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

== Building From Scratch ==
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

=== Getting a Minimal Install from Scratch ===

There are two options here:
* Linux PC
* On Pandora

==== Linux PC ====
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian''''' 
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

==== Pandora ====
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

=== Setting up Apt ===
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

=== Desktop Environment ===
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

=== Device Drivers and PNDs ===
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

==== X Display Driver ====
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

==== SGX Drivers ====
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

===== Libraries =====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

===== Demos/SDK =====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

==== Keymap ====
The keymap is actually stupidly easy, and I've missed how easy it is for quite a while now! 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

1.0.4 is again different, and doesn't HUP pndnotifyd at all as it seemed to work without much issue just by starting the service differently, also, due to use of GDM, we do the xmodmap at GDM's startup instead in the following manner: 
'''''sudo nano /etc/gdm/Init/\:0''''' - the \ is needed to use : as a character! 
#!/bin/bash
xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183
xmodmap /etc/skel/.pndXmodmap
loadkeys /etc/keymap-extension-2.6.map

The xinput line is for the evdev touchscreen configuration, if this is wrong, please run '''xinput_calibrator''' from a Terminal, and replace the line with what it gives you!

The loadkeys line also ensures that the console gets the correct keymap as well.

Thanks to chris_c for the GDM init hint, and mcobit for the loadkeys hint!

Should probably copy more over but, this'll do for now. 

==== Nubs ====
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

==== Touchscreen ====
===== Current 1.0.2/3 Release =====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

This is already done on 1.0.4 and xinput_calibrator is included should you need to re-run it.

===== libts for other releases =====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

==== Wifi ====
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

==== Bluetooth ====
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

==== Kernel and Misc Bits and Pieces ====
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

==== Misc Init Scripts and Things ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

==== PNDs ====
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1''''' 
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

==== RC Scripts ====

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set.
===== Script Fixups =====
We need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pndnotifyd-init, pndevmapperd-init and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up. 
The update-rc.d program will shout at you which ones, and essentially, it's just some tidying up that needs done.

It's now recommended to use update-rc.d to put these in rather than the old heavy handed ln calls:
update-rc.d led-config defaults 05
update-rc.d pndevmapperd-init defaults 30 40
update-rc.d pndnotifyd-init defaults 30 40
update-rc.d pandora-state defaults 05

The pandora-state is different on Angstrom than Debian as it didn't start up with it's usual bindings, which was annoying!

=== Users and Permissions ===
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

You'll also need to do the above for every new user you create for the moment.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

=== Reboot and Troubleshooting ===

==== auto/boot.txt ====
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

Alternatively, if you remove the '''console=ttyS0,115200n8''' part, you will be able to see debug text as the system boots up.

All that's really left now is to reboot and catch any issues that may crop up!

==== First Boot ====

===== tslib calibration =====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

===== Finish up installing any left overs =====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

==== Cleanup ====
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

== Maintenance and Upgrades ==
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

== Common Issues/Fun Things To Do ==
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

=== Networking ===
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

=== Synaptic ===
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

=== My PNDs don't work, why?! ===
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 and 1.0.4 do not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

=== Wifi and Session Management is broken?! ===
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

=== My PNDs don't appear immediately? ===
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

This should be fixed in 1.0.4

=== I get no notifications in 1.0.3 ===
This is actually because notification-daemon hasn't been installed.

=== Packages to add in 1.1! ===
Feel free to add packages here that I should include in the next release (1.1)
* wireless-tools
* x11-xserver-utils ( I keep forgetting this.. it's for xmodmap )
* xinput - for evdev's configuration
* console-tools - for chvt
* xterm - for failsafe console
* bash-completion - tis handy to have
* aptitude - somehow I forgot this.

= Emdebian Grip =
Most of the above can be taken for Grip, with the following changes...

Why Grip? It's much smaller and targeted for embedded devices... I originally was going to use Grip actually, but it was a bit buggered at the time, though it seems to be working now. 
Additionally, Emdebian comes in Crush and Baked flavours... Grip is compatible with Desktop Debian, so we'll use that.. Crush is smaller again, and generally requires a cross-compiler to setup packages, and Baked is effectively what we do with Angstrom.

Emdebian could also in theory be shrunk enough to actually fit on NAND... which is something I'll be looking into - if only to document another alternative process to the Angstrom OE bitbake bonanza.

== Multistrap ==
Grip's debootstrap is slightly different... it uses multistrap instead.

This allows us to use Grip's repository as the base, and Desktop Debian's repositories for anything else we might need ( omap3 drivers, for instance. ) This is also particularly useful for us when I get around to doing Pandora specifics compiled for Debian, as then we just add that repository as well.

Anyway, we need Debian running for this - be it on your Desktop ( or Ubuntu ) or on your Pandora ( recommended, as this guide assumes this is what you're doing. ) 
Install Multistrap - '''''sudo apt-get install multistrap'''''

You'll also need to mount an SD card somewhere manually.. I've mounted mine to /tmp/emdebian: '''''sudo umount /dev/mmcblk1p1 && mount /dev/mmcblk1p1 /tmp/emdebian'''''

=== Config File ===
'''''nano multistrap'''''
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

'''''sudo multistrap -f multistrap'''''

Change /tmp/multistrap to where ever you want the debootstrap to occur. 
'''Gotcha''''' I had issues with it complaining about unauthenticated packages, just add '''--no-auth''' to your command line and it'll continue happily.''

This shouldn't take too long ( was about half an hour on my Pandora ) and gives you a very sparse minimal rootfs of 192Mb.

The following multistrap config will give you what's in the 1.0.4 Grip rootfs
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=xserver-xorg-video-omap3 libxcb-dri2-0 libnotify-bin xinput
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=lxde busybox network-manager-gnome xfce4-power-manager apmd gdm less sudo nano wireless-tools iceweasel synaptic gnome-mplayer x11-xserver-utils notification-daemon gnome-keyring
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

You could also add packages into the Grip and Debian configuration parts, and it will automatically pull them down and install them for you, be careful with what you pull in though, as not everything has been repackaged for Grip, so it will pull down the "full fat" variants from Debian instead.

You might get errors of unconfigured packages, just chroot in and run '''''apt-get -f install''''' to finish up.. if there are warnings about proc, ignore them till you reboot into the rootfs and re-run '''''sudo apt-get -f install'''''.

== Chroot and Setup ==
Now we can just chroot in and setup as we see fit. 
'''''sudo chroot /tmp/emdebian''''' - again, you may have mounted your media elsewhere. 
'''''sudo apt-get update'''''

You can now just follow the Debian guide as above, with the added bonus of most packages will come from Grip and be pre-stripped of extra fluff. 
I would recommend to get as much stuff as possible downloaded in the initial multistrap however, as it will automatically clean stuff up for you.

= Debian On NAND =
First of all, 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

== Get a Debian Rootfs ==
Your NAND has about 475Mb for the rootfs to play with ( there are other partitions, remember! ), therefore Desktop Debian is a bit too large for our purposes - even 1.0.3's complete massacre still ended up too big by far; so we need to look at Emdebian, of which there are three flavours - grip, crush and baked. 
We'll be using Grip, so follow the guide above for at least getting a working system on SD before going anywhere near your NAND.

We can use compression to get your rootfs down by 40-50%, but I'd still be vary wary of a large rootfs!

If you're lazy, grab my pre-made Grip rootfs, which includes LXDE by default.

== Preparing the Rootfs ==
Boot into your rootfs for this, so we can ensure we're as up to date as we can be, then clean the apt cache, and then any crap we installed which we don't need any more, such as things which were installed as dependencies and the parent's been removed. 
'''''sudo apt-get update''''' 
'''''sudo apt-get upgrade''''' 
'''''sudo apt-get clean''''' 
'''''sudo apt-get autoclean''''' 

Additionally, you could wipe out the documentation ( if any ) and manually pull out unwanted packages. However, if you're pulling stuff out, you shouldn't have installed it in the first place! Go back to the start and do it again as punishment!

This post on the Ubuntu forums is particularly helpful: http://ubuntuforums.org/showthread.php?t=140920

Depending on your needs, you may also want to wipe out your home folder and reinstate it from /etc/skel 
You'll also want to wipe out tmp - '''''sudo rm -rf /tmp/*'''''

Now shut down and either place your SD card in your PC. You can do this on Pandora, but you will need a lot of space.

Copy your rootfs somewhere.. I suggest /tmp/pandora-debian 
'''''mkdir /tmp/pandora-debian''''' 
'''''sudo cp -p -r /media/my/sd/card/* /tmp/pandora-debian''''' - this will preserve Permissions and copy everything Recursively.

We need to edit the fstab so that it can boot properly, if you haven't done so already. 
'''''sudo nano /tmp/pandora-debian/etc/fstab'''''
# OpenPandora fstab.

rootfs / auto defaults,noatime 1 1
proc /proc proc defaults 0 0
devpts /dev/pts devpts mode=0620,gid=5 0 0
usbfs /proc/bus/usb usbfs defaults 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /dev/shm tmpfs mode=0777 0 0
tmpfs /media/ram tmpfs defaults 0 0

This should look familiar, as it's effectively your stock fstab minus the boot partition ( we have a kernel in our rootfs, if you've followed the above guides... )

We should also get rid of the autoboot.txt or boot.txt; '''''sudo rm /tmp/pandora-debian/autoboot.txt'''''

== Creating the Image ==
You need mtd-utils in your Debian distro of choice. '''''sudo apt-get install mtd-utils'''''

Now, mkfs.ubifs can compress using either LZO ( by default ) or zlib and will get your rootfs about 40-50% smaller depending on what you choose. It's also possible to use a combination of both, which is what we will do later.. Of course, if your rootfs is full of pre-compressed stuff already, it's not really going to shrink a great deal. 
For a full run down on mkfs.ubifs and co, see here: http://www.linux-mtd.infradead.org/doc/ubifs.html

Download the flash kit: http://openpandora.org/firmware/pandora-flash-kit.zip and extract it to /tmp/flash. I suggest reading the README as well.

Now run these fun commands... what we're doing is we're making a ubifs image first, then making an md5 checksum. 
We're also favoring LZO compression meaning we're mixing zlib and LZO to get the best compression we can. 
'''''sudo mkfs.ubifs -r /tmp/pandora-debian -o rootfs.img -m 2048 -e 129024 -c 4042 -x favor_lzo -X 20''''' 
'''''md5sum rootfs.img > rootfs.md5'''''

'''STOP! If your rootfs.img is getting close to 480Mb, you might not want to try and flash it.. it may be fine, but I would recommend 450Mb as an absolute maximum.'''

== Flashing the Image ==
I shall repeat: 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

Stick the following on to a FAT32 formatted SD card: 
* '''boot.scr''' - from the flash kit.
* '''rootfs.img''' - the image you've just created.
* '''rootfs.md5''' - the checksum to the image.

Place it in slot 1 of your Pandora ( the left slot, ) reboot while holding the right trigger, select boot from SD, cross your fingers and pray to the Pandora Gods.

Once it's done.. reboot and see what mess you've made, assuming you get it to boot! 
If you haven't got it to boot, on your FAT32 flasher card, add an autoboot.txt with the following:
setenv bootargs ubi.mtd=4 ubi.mtd=3 root=ubi0:rootfs rootfstype=ubifs rw vram=6272K omapfb.vram=0:3000K
ubi part boot && ubifsmount boot && ubifsload ${loadaddr} uImage && bootm ${loadaddr};

As this will let you see what's gone wrong... I had to do this a few times, as I buggered it up myself...

Congratulations, you now have Debian on NAND rather than Angstrom. 
Also, these instructions could easily be adapted to allow you to use any other distro that boots on Pandora.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-04-09T13:36:45Z

Stuckie: /* Current 1.0.2/3 Release */ added info on xinput_calibrator

= Debian On SD =

I'm going to split this into three chunks now... standard Desktop Debian on SD using Squeeze/Lenny/Sid ( choose your poison, though only Squeeze is officially tested to work by myself, ) Emdebian GRIP install, and NAND install.

You can post feedback, bugs, etc.. on the following topics:
GP32X: http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/
OpenPandora Boards: http://boards.openpandora.org/index.php?/topic/1819-debian-on-sd/

I'd prefer the GP32X boards as I'm slightly more active there.

= Little Note to Wiki Editors =
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Desktop Debian ==
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 and 1.0.4 "brute force" releases. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.4-grip.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2/3 formatted SD card. 
For example: '''''tar -xvjpf pandora-squeeze*.tar.bz2 -C /media/sdcard .'''''

Default User details are: 
username: '''pandora''' 
password: '''debian'''

=== Changelog ===
==== Original Proof of Concept ====
* Released - 19th October 2010
* Based on Sid
* GDM
* GNOME
* Bit slow but workable

==== Release 1.0 ====
* Released - 20th February 2011
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

==== Release 1.0.1 ====
* Released - 23rd February 2011
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

==== Release 1.0.2 ====
* Released - 22nd March 2011
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

==== Release 1.0.3 ====
* Released - 27th March 2011
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

==== Release 1.0.4 ====
* Released - 4th April 2011
* 1.0.3 with lots of bugs fixed and based on Grip so it's got even more and super tiny in comparision.
* Contains; LXDE, GDM, Gnome MPlayer, IceWeasel ( firefox ) and Synaptic

=== Release 1.1 Proposed ===
* Expected - May 2011 ( maybe )
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

== Building From Scratch ==
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

=== Getting a Minimal Install from Scratch ===

There are two options here:
* Linux PC
* On Pandora

==== Linux PC ====
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

==== Pandora ====
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

=== Setting up Apt ===
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

=== Desktop Environment ===
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

=== Device Drivers and PNDs ===
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

==== X Display Driver ====
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

==== SGX Drivers ====
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

===== Libraries =====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

===== Demos/SDK =====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

==== Keymap ====
The keymap is actually stupidly easy, and I've missed how easy it is for quite a while now! 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

1.0.4 is again different, and doesn't HUP pndnotifyd at all as it seemed to work without much issue just by starting the service differently, also, due to use of GDM, we do the xmodmap at GDM's startup instead in the following manner: 
'''''sudo nano /etc/gdm/Init/\:0''''' - the \ is needed to use : as a character! 
#!/bin/bash
xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183
xmodmap /etc/skel/.pndXmodmap
loadkeys /etc/keymap-extension-2.6.map

The xinput line is for the evdev touchscreen configuration, if this is wrong, please run '''xinput_calibrator''' from a Terminal, and replace the line with what it gives you!

The loadkeys line also ensures that the console gets the correct keymap as well.

Thanks to chris_c for the GDM init hint, and mcobit for the loadkeys hint!

Should probably copy more over but, this'll do for now. 

==== Nubs ====
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

==== Touchscreen ====
===== Current 1.0.2/3 Release =====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

This is already done on 1.0.4 and xinput_calibrator is included should you need to re-run it.

===== libts for other releases =====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

==== Wifi ====
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

==== Bluetooth ====
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

==== Kernel and Misc Bits and Pieces ====
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

==== Misc Init Scripts and Things ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

==== PNDs ====
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

==== RC Scripts ====

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set.
===== Script Fixups =====
We need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pndnotifyd-init, pndevmapperd-init and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up. 
The update-rc.d program will shout at you which ones, and essentially, it's just some tidying up that needs done.

It's now recommended to use update-rc.d to put these in rather than the old heavy handed ln calls:
update-rc.d led-config defaults 05
update-rc.d pndevmapperd-init defaults 30 40
update-rc.d pndnotifyd-init defaults 30 40
update-rc.d pandora-state defaults 05

The pandora-state is different on Angstrom than Debian as it didn't start up with it's usual bindings, which was annoying!

=== Users and Permissions ===
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

=== Reboot and Troubleshooting ===

==== auto/boot.txt ====
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

Alternatively, if you remove the '''console=ttyS0,115200n8''' part, you will be able to see debug text as the system boots up.

All that's really left now is to reboot and catch any issues that may crop up!

==== First Boot ====

===== tslib calibration =====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

===== Finish up installing any left overs =====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

==== Cleanup ====
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

== Maintenance and Upgrades ==
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

== Common Issues/Fun Things To Do ==
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

=== Networking ===
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

=== Synaptic ===
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

=== My PNDs don't work, why?! ===
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 and 1.0.4 do not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

=== Wifi and Session Management is broken?! ===
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

=== My PNDs don't appear immediately? ===
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

This should be fixed in 1.0.4

=== I get no notifications in 1.0.3 ===
This is actually because notification-daemon hasn't been installed.

=== Packages to add in 1.1! ===
Feel free to add packages here that I should include in the next release (1.1)
* wireless-tools
* x11-xserver-utils ( I keep forgetting this.. it's for xmodmap )
* xinput - for evdev's configuration
* console-tools - for chvt
* xterm - for failsafe console
* bash-completion - tis handy to have
* aptitude - somehow I forgot this.

= Emdebian Grip =
Most of the above can be taken for Grip, with the following changes...

Why Grip? It's much smaller and targeted for embedded devices... I originally was going to use Grip actually, but it was a bit buggered at the time, though it seems to be working now. 
Additionally, Emdebian comes in Crush and Baked flavours... Grip is compatible with Desktop Debian, so we'll use that.. Crush is smaller again, and generally requires a cross-compiler to setup packages, and Baked is effectively what we do with Angstrom.

Emdebian could also in theory be shrunk enough to actually fit on NAND... which is something I'll be looking into - if only to document another alternative process to the Angstrom OE bitbake bonanza.

== Multistrap ==
Grip's debootstrap is slightly different... it uses multistrap instead.

This allows us to use Grip's repository as the base, and Desktop Debian's repositories for anything else we might need ( omap3 drivers, for instance. ) This is also particularly useful for us when I get around to doing Pandora specifics compiled for Debian, as then we just add that repository as well.

Anyway, we need Debian running for this - be it on your Desktop ( or Ubuntu ) or on your Pandora ( recommended, as this guide assumes this is what you're doing. ) 
Install Multistrap - '''''sudo apt-get install multistrap'''''

You'll also need to mount an SD card somewhere manually.. I've mounted mine to /tmp/emdebian: '''''sudo umount /dev/mmcblk1p1 && mount /dev/mmcblk1p1 /tmp/emdebian'''''

=== Config File ===
'''''nano multistrap'''''
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

'''''sudo multistrap -f multistrap'''''

Change /tmp/multistrap to where ever you want the debootstrap to occur. 
'''Gotcha''''' I had issues with it complaining about unauthenticated packages, just add '''--no-auth''' to your command line and it'll continue happily.''

This shouldn't take too long ( was about half an hour on my Pandora ) and gives you a very sparse minimal rootfs of 192Mb.

The following multistrap config will give you what's in the 1.0.4 Grip rootfs
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=xserver-xorg-video-omap3 libxcb-dri2-0 libnotify-bin xinput
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=lxde busybox network-manager-gnome xfce4-power-manager apmd gdm less sudo nano wireless-tools iceweasel synaptic gnome-mplayer x11-xserver-utils notification-daemon gnome-keyring
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

You could also add packages into the Grip and Debian configuration parts, and it will automatically pull them down and install them for you, be careful with what you pull in though, as not everything has been repackaged for Grip, so it will pull down the "full fat" variants from Debian instead.

You might get errors of unconfigured packages, just chroot in and run '''''apt-get -f install''''' to finish up.. if there are warnings about proc, ignore them till you reboot into the rootfs and re-run '''''sudo apt-get -f install'''''.

== Chroot and Setup ==
Now we can just chroot in and setup as we see fit. 
'''''sudo chroot /tmp/emdebian''''' - again, you may have mounted your media elsewhere. 
'''''sudo apt-get update'''''

You can now just follow the Debian guide as above, with the added bonus of most packages will come from Grip and be pre-stripped of extra fluff. 
I would recommend to get as much stuff as possible downloaded in the initial multistrap however, as it will automatically clean stuff up for you.

= Debian On NAND =
First of all, 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

== Get a Debian Rootfs ==
Your NAND has about 475Mb for the rootfs to play with ( there are other partitions, remember! ), therefore Desktop Debian is a bit too large for our purposes - even 1.0.3's complete massacre still ended up too big by far; so we need to look at Emdebian, of which there are three flavours - grip, crush and baked. 
We'll be using Grip, so follow the guide above for at least getting a working system on SD before going anywhere near your NAND.

We can use compression to get your rootfs down by 40-50%, but I'd still be vary wary of a large rootfs!

If you're lazy, grab my pre-made Grip rootfs, which includes LXDE by default.

== Preparing the Rootfs ==
Boot into your rootfs for this, so we can ensure we're as up to date as we can be, then clean the apt cache, and then any crap we installed which we don't need any more, such as things which were installed as dependencies and the parent's been removed. 
'''''sudo apt-get update''''' 
'''''sudo apt-get upgrade''''' 
'''''sudo apt-get clean''''' 
'''''sudo apt-get autoclean''''' 

Additionally, you could wipe out the documentation ( if any ) and manually pull out unwanted packages. However, if you're pulling stuff out, you shouldn't have installed it in the first place! Go back to the start and do it again as punishment!

This post on the Ubuntu forums is particularly helpful: http://ubuntuforums.org/showthread.php?t=140920

Depending on your needs, you may also want to wipe out your home folder and reinstate it from /etc/skel 
You'll also want to wipe out tmp - '''''sudo rm -rf /tmp/*'''''

Now shut down and either place your SD card in your PC. You can do this on Pandora, but you will need a lot of space.

Copy your rootfs somewhere.. I suggest /tmp/pandora-debian 
'''''mkdir /tmp/pandora-debian''''' 
'''''sudo cp -p -r /media/my/sd/card/* /tmp/pandora-debian''''' - this will preserve Permissions and copy everything Recursively.

We need to edit the fstab so that it can boot properly, if you haven't done so already. 
'''''sudo nano /tmp/pandora-debian/etc/fstab'''''
# OpenPandora fstab.

rootfs / auto defaults,noatime 1 1
proc /proc proc defaults 0 0
devpts /dev/pts devpts mode=0620,gid=5 0 0
usbfs /proc/bus/usb usbfs defaults 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /dev/shm tmpfs mode=0777 0 0
tmpfs /media/ram tmpfs defaults 0 0

This should look familiar, as it's effectively your stock fstab minus the boot partition ( we have a kernel in our rootfs, if you've followed the above guides... )

We should also get rid of the autoboot.txt or boot.txt; '''''sudo rm /tmp/pandora-debian/autoboot.txt'''''

== Creating the Image ==
You need mtd-utils in your Debian distro of choice. '''''sudo apt-get install mtd-utils'''''

Now, mkfs.ubifs can compress using either LZO ( by default ) or zlib and will get your rootfs about 40-50% smaller depending on what you choose. It's also possible to use a combination of both, which is what we will do later.. Of course, if your rootfs is full of pre-compressed stuff already, it's not really going to shrink a great deal. 
For a full run down on mkfs.ubifs and co, see here: http://www.linux-mtd.infradead.org/doc/ubifs.html

Download the flash kit: http://openpandora.org/firmware/pandora-flash-kit.zip and extract it to /tmp/flash. I suggest reading the README as well.

Now run these fun commands... what we're doing is we're making a ubifs image first, then making an md5 checksum. 
We're also favoring LZO compression meaning we're mixing zlib and LZO to get the best compression we can. 
'''''sudo mkfs.ubifs -r /tmp/pandora-debian -o rootfs.img -m 2048 -e 129024 -c 4042 -x favor_lzo -X 20''''' 
'''''md5sum rootfs.img > rootfs.md5'''''

'''STOP! If your rootfs.img is getting close to 480Mb, you might not want to try and flash it.. it may be fine, but I would recommend 450Mb as an absolute maximum.'''

== Flashing the Image ==
I shall repeat: 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

Stick the following on to a FAT32 formatted SD card: 
* '''boot.scr''' - from the flash kit.
* '''rootfs.img''' - the image you've just created.
* '''rootfs.md5''' - the checksum to the image.

Place it in slot 1 of your Pandora ( the left slot, ) reboot while holding the right trigger, select boot from SD, cross your fingers and pray to the Pandora Gods.

Once it's done.. reboot and see what mess you've made, assuming you get it to boot! 
If you haven't got it to boot, on your FAT32 flasher card, add an autoboot.txt with the following:
setenv bootargs ubi.mtd=4 ubi.mtd=3 root=ubi0:rootfs rootfstype=ubifs rw vram=6272K omapfb.vram=0:3000K
ubi part boot && ubifsmount boot && ubifsload ${loadaddr} uImage && bootm ${loadaddr};

As this will let you see what's gone wrong... I had to do this a few times, as I buggered it up myself...

Congratulations, you now have Debian on NAND rather than Angstrom. 
Also, these instructions could easily be adapted to allow you to use any other distro that boots on Pandora.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-04-09T13:19:47Z

Stuckie: Added release dates, updated keymapping and rc scripts, some cleanup here and there

= Debian On SD =

I'm going to split this into three chunks now... standard Desktop Debian on SD using Squeeze/Lenny/Sid ( choose your poison, though only Squeeze is officially tested to work by myself, ) Emdebian GRIP install, and NAND install.

You can post feedback, bugs, etc.. on the following topics:
GP32X: http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/
OpenPandora Boards: http://boards.openpandora.org/index.php?/topic/1819-debian-on-sd/

I'd prefer the GP32X boards as I'm slightly more active there.

= Little Note to Wiki Editors =
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Desktop Debian ==
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 and 1.0.4 "brute force" releases. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.4-grip.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2/3 formatted SD card. 
For example: '''''tar -xvjpf pandora-squeeze*.tar.bz2 -C /media/sdcard .'''''

Default User details are: 
username: '''pandora''' 
password: '''debian'''

=== Changelog ===
==== Original Proof of Concept ====
* Released - 19th October 2010
* Based on Sid
* GDM
* GNOME
* Bit slow but workable

==== Release 1.0 ====
* Released - 20th February 2011
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

==== Release 1.0.1 ====
* Released - 23rd February 2011
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

==== Release 1.0.2 ====
* Released - 22nd March 2011
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

==== Release 1.0.3 ====
* Released - 27th March 2011
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

==== Release 1.0.4 ====
* Released - 4th April 2011
* 1.0.3 with lots of bugs fixed and based on Grip so it's got even more and super tiny in comparision.
* Contains; LXDE, GDM, Gnome MPlayer, IceWeasel ( firefox ) and Synaptic

=== Release 1.1 Proposed ===
* Expected - May 2011 ( maybe )
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

== Building From Scratch ==
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

=== Getting a Minimal Install from Scratch ===

There are two options here:
* Linux PC
* On Pandora

==== Linux PC ====
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

==== Pandora ====
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

=== Setting up Apt ===
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

=== Desktop Environment ===
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

=== Device Drivers and PNDs ===
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

==== X Display Driver ====
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

==== SGX Drivers ====
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

===== Libraries =====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

===== Demos/SDK =====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

==== Keymap ====
The keymap is actually stupidly easy, and I've missed how easy it is for quite a while now! 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

1.0.4 is again different, and doesn't HUP pndnotifyd at all as it seemed to work without much issue just by starting the service differently, also, due to use of GDM, we do the xmodmap at GDM's startup instead in the following manner: 
'''''sudo nano /etc/gdm/Init/\:0''''' - the \ is needed to use : as a character! 
#!/bin/bash
xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183
xmodmap /etc/skel/.pndXmodmap
loadkeys /etc/keymap-extension-2.6.map

The xinput line is for the evdev touchscreen configuration, if this is wrong, please run '''xinput_calibrator''' from a Terminal, and replace the line with what it gives you!

The loadkeys line also ensures that the console gets the correct keymap as well.

Thanks to chris_c for the GDM init hint, and mcobit for the loadkeys hint!

Should probably copy more over but, this'll do for now. 

==== Nubs ====
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

==== Touchscreen ====
===== Current 1.0.2/3 Release =====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

===== libts for other releases =====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

==== Wifi ====
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

==== Bluetooth ====
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

==== Kernel and Misc Bits and Pieces ====
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

==== Misc Init Scripts and Things ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

==== PNDs ====
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

==== RC Scripts ====

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set.
===== Script Fixups =====
We need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pndnotifyd-init, pndevmapperd-init and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up. 
The update-rc.d program will shout at you which ones, and essentially, it's just some tidying up that needs done.

It's now recommended to use update-rc.d to put these in rather than the old heavy handed ln calls:
update-rc.d led-config defaults 05
update-rc.d pndevmapperd-init defaults 30 40
update-rc.d pndnotifyd-init defaults 30 40
update-rc.d pandora-state defaults 05

The pandora-state is different on Angstrom than Debian as it didn't start up with it's usual bindings, which was annoying!

=== Users and Permissions ===
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

=== Reboot and Troubleshooting ===

==== auto/boot.txt ====
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

Alternatively, if you remove the '''console=ttyS0,115200n8''' part, you will be able to see debug text as the system boots up.

All that's really left now is to reboot and catch any issues that may crop up!

==== First Boot ====

===== tslib calibration =====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

===== Finish up installing any left overs =====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

==== Cleanup ====
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

== Maintenance and Upgrades ==
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

== Common Issues/Fun Things To Do ==
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

=== Networking ===
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

=== Synaptic ===
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

=== My PNDs don't work, why?! ===
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 and 1.0.4 do not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

=== Wifi and Session Management is broken?! ===
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

=== My PNDs don't appear immediately? ===
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

This should be fixed in 1.0.4

=== I get no notifications in 1.0.3 ===
This is actually because notification-daemon hasn't been installed.

=== Packages to add in 1.1! ===
Feel free to add packages here that I should include in the next release (1.1)
* wireless-tools
* x11-xserver-utils ( I keep forgetting this.. it's for xmodmap )
* xinput - for evdev's configuration
* console-tools - for chvt
* xterm - for failsafe console
* bash-completion - tis handy to have
* aptitude - somehow I forgot this.

= Emdebian Grip =
Most of the above can be taken for Grip, with the following changes...

Why Grip? It's much smaller and targeted for embedded devices... I originally was going to use Grip actually, but it was a bit buggered at the time, though it seems to be working now. 
Additionally, Emdebian comes in Crush and Baked flavours... Grip is compatible with Desktop Debian, so we'll use that.. Crush is smaller again, and generally requires a cross-compiler to setup packages, and Baked is effectively what we do with Angstrom.

Emdebian could also in theory be shrunk enough to actually fit on NAND... which is something I'll be looking into - if only to document another alternative process to the Angstrom OE bitbake bonanza.

== Multistrap ==
Grip's debootstrap is slightly different... it uses multistrap instead.

This allows us to use Grip's repository as the base, and Desktop Debian's repositories for anything else we might need ( omap3 drivers, for instance. ) This is also particularly useful for us when I get around to doing Pandora specifics compiled for Debian, as then we just add that repository as well.

Anyway, we need Debian running for this - be it on your Desktop ( or Ubuntu ) or on your Pandora ( recommended, as this guide assumes this is what you're doing. ) 
Install Multistrap - '''''sudo apt-get install multistrap'''''

You'll also need to mount an SD card somewhere manually.. I've mounted mine to /tmp/emdebian: '''''sudo umount /dev/mmcblk1p1 && mount /dev/mmcblk1p1 /tmp/emdebian'''''

=== Config File ===
'''''nano multistrap'''''
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

'''''sudo multistrap -f multistrap'''''

Change /tmp/multistrap to where ever you want the debootstrap to occur. 
'''Gotcha''''' I had issues with it complaining about unauthenticated packages, just add '''--no-auth''' to your command line and it'll continue happily.''

This shouldn't take too long ( was about half an hour on my Pandora ) and gives you a very sparse minimal rootfs of 192Mb.

The following multistrap config will give you what's in the 1.0.4 Grip rootfs
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=xserver-xorg-video-omap3 libxcb-dri2-0 libnotify-bin xinput
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=lxde busybox network-manager-gnome xfce4-power-manager apmd gdm less sudo nano wireless-tools iceweasel synaptic gnome-mplayer x11-xserver-utils notification-daemon gnome-keyring
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

You could also add packages into the Grip and Debian configuration parts, and it will automatically pull them down and install them for you, be careful with what you pull in though, as not everything has been repackaged for Grip, so it will pull down the "full fat" variants from Debian instead.

You might get errors of unconfigured packages, just chroot in and run '''''apt-get -f install''''' to finish up.. if there are warnings about proc, ignore them till you reboot into the rootfs and re-run '''''sudo apt-get -f install'''''.

== Chroot and Setup ==
Now we can just chroot in and setup as we see fit. 
'''''sudo chroot /tmp/emdebian''''' - again, you may have mounted your media elsewhere. 
'''''sudo apt-get update'''''

You can now just follow the Debian guide as above, with the added bonus of most packages will come from Grip and be pre-stripped of extra fluff. 
I would recommend to get as much stuff as possible downloaded in the initial multistrap however, as it will automatically clean stuff up for you.

= Debian On NAND =
First of all, 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

== Get a Debian Rootfs ==
Your NAND has about 475Mb for the rootfs to play with ( there are other partitions, remember! ), therefore Desktop Debian is a bit too large for our purposes - even 1.0.3's complete massacre still ended up too big by far; so we need to look at Emdebian, of which there are three flavours - grip, crush and baked. 
We'll be using Grip, so follow the guide above for at least getting a working system on SD before going anywhere near your NAND.

We can use compression to get your rootfs down by 40-50%, but I'd still be vary wary of a large rootfs!

If you're lazy, grab my pre-made Grip rootfs, which includes LXDE by default.

== Preparing the Rootfs ==
Boot into your rootfs for this, so we can ensure we're as up to date as we can be, then clean the apt cache, and then any crap we installed which we don't need any more, such as things which were installed as dependencies and the parent's been removed. 
'''''sudo apt-get update''''' 
'''''sudo apt-get upgrade''''' 
'''''sudo apt-get clean''''' 
'''''sudo apt-get autoclean''''' 

Additionally, you could wipe out the documentation ( if any ) and manually pull out unwanted packages. However, if you're pulling stuff out, you shouldn't have installed it in the first place! Go back to the start and do it again as punishment!

This post on the Ubuntu forums is particularly helpful: http://ubuntuforums.org/showthread.php?t=140920

Depending on your needs, you may also want to wipe out your home folder and reinstate it from /etc/skel 
You'll also want to wipe out tmp - '''''sudo rm -rf /tmp/*'''''

Now shut down and either place your SD card in your PC. You can do this on Pandora, but you will need a lot of space.

Copy your rootfs somewhere.. I suggest /tmp/pandora-debian 
'''''mkdir /tmp/pandora-debian''''' 
'''''sudo cp -p -r /media/my/sd/card/* /tmp/pandora-debian''''' - this will preserve Permissions and copy everything Recursively.

We need to edit the fstab so that it can boot properly, if you haven't done so already. 
'''''sudo nano /tmp/pandora-debian/etc/fstab'''''
# OpenPandora fstab.

rootfs / auto defaults,noatime 1 1
proc /proc proc defaults 0 0
devpts /dev/pts devpts mode=0620,gid=5 0 0
usbfs /proc/bus/usb usbfs defaults 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /dev/shm tmpfs mode=0777 0 0
tmpfs /media/ram tmpfs defaults 0 0

This should look familiar, as it's effectively your stock fstab minus the boot partition ( we have a kernel in our rootfs, if you've followed the above guides... )

We should also get rid of the autoboot.txt or boot.txt; '''''sudo rm /tmp/pandora-debian/autoboot.txt'''''

== Creating the Image ==
You need mtd-utils in your Debian distro of choice. '''''sudo apt-get install mtd-utils'''''

Now, mkfs.ubifs can compress using either LZO ( by default ) or zlib and will get your rootfs about 40-50% smaller depending on what you choose. It's also possible to use a combination of both, which is what we will do later.. Of course, if your rootfs is full of pre-compressed stuff already, it's not really going to shrink a great deal. 
For a full run down on mkfs.ubifs and co, see here: http://www.linux-mtd.infradead.org/doc/ubifs.html

Download the flash kit: http://openpandora.org/firmware/pandora-flash-kit.zip and extract it to /tmp/flash. I suggest reading the README as well.

Now run these fun commands... what we're doing is we're making a ubifs image first, then making an md5 checksum. 
We're also favoring LZO compression meaning we're mixing zlib and LZO to get the best compression we can. 
'''''sudo mkfs.ubifs -r /tmp/pandora-debian -o rootfs.img -m 2048 -e 129024 -c 4042 -x favor_lzo -X 20''''' 
'''''md5sum rootfs.img > rootfs.md5'''''

'''STOP! If your rootfs.img is getting close to 480Mb, you might not want to try and flash it.. it may be fine, but I would recommend 450Mb as an absolute maximum.'''

== Flashing the Image ==
I shall repeat: 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

Stick the following on to a FAT32 formatted SD card: 
* '''boot.scr''' - from the flash kit.
* '''rootfs.img''' - the image you've just created.
* '''rootfs.md5''' - the checksum to the image.

Place it in slot 1 of your Pandora ( the left slot, ) reboot while holding the right trigger, select boot from SD, cross your fingers and pray to the Pandora Gods.

Once it's done.. reboot and see what mess you've made, assuming you get it to boot! 
If you haven't got it to boot, on your FAT32 flasher card, add an autoboot.txt with the following:
setenv bootargs ubi.mtd=4 ubi.mtd=3 root=ubi0:rootfs rootfstype=ubifs rw vram=6272K omapfb.vram=0:3000K
ubi part boot && ubifsmount boot && ubifsload ${loadaddr} uImage && bootm ${loadaddr};

As this will let you see what's gone wrong... I had to do this a few times, as I buggered it up myself...

Congratulations, you now have Debian on NAND rather than Angstrom. 
Also, these instructions could easily be adapted to allow you to use any other distro that boots on Pandora.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-04-04T00:48:44Z

Stuckie: Adding details on Grip plus new release, some fixups, and replacing Angstrom on NAND with Debian for those feeling brave.

= Debian On SD =

I'm going to split this into three chunks now... standard Desktop Debian on SD using Squeeze/Lenny/Sid ( choose your poison, though only Squeeze is officially tested to work by myself, ) Emdebian GRIP install, and NAND install.

= Little Note to Wiki Editors =
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Desktop Debian ==
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 and 1.0.4 "brute force" releases. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.4-grip.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2/3 formatted SD card. 
For example: '''''tar -xvjpf pandora-squeeze*.tar.bz2 -C /media/sdcard .'''''

Default User details are: 
username: '''pandora''' 
password: '''debian'''

=== Changelog ===
==== Release 1.0 ====
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

==== Release 1.0.1 ====
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

==== Release 1.0.2 ====
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

==== Release 1.0.3 ====
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

==== Release 1.0.4 ====
* 1.0.3 with lots of bugs fixed and based on Grip so it's got even more and super tiny in comparision.
* Contains; LXDE, GDM, Gnome MPlayer, IceWeasel ( firefox ) and Synaptic

=== Release 1.1 Proposed ===
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

== Building From Scratch ==
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

=== Getting a Minimal Install from Scratch ===

There are two options here:
* Linux PC
* On Pandora

==== Linux PC ====
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

==== Pandora ====
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

=== Setting up Apt ===
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

=== Desktop Environment ===
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

=== Device Drivers and PNDs ===
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

==== X Display Driver ====
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

==== SGX Drivers ====
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

===== Libraries =====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

===== Demos/SDK =====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

==== Keymap ====
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

Should probably copy more over but, this'll do for now. 

==== Nubs ====
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

==== Touchscreen ====
===== Current 1.0.2/3 Release =====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

===== libts for other releases =====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

==== Wifi ====
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

==== Bluetooth ====
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

==== Kernel and Misc Bits and Pieces ====
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

==== Misc Init Scripts and Things ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

==== PNDs ====
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

==== RC Scripts ====

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
===== rc0.d =====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

===== rc1.d =====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

===== rc2.d =====
ln -s ../init.d/led-config S05led-config

===== rc3.d =====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

===== rc4.d =====
ln -s ../init.d/led-config S05led-config

===== rc5.d =====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

===== rc6.d =====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

===== rcS.d =====
ln -s ../init.d/pandora-state S39pandora-state

Alternatively ( and this is what I did in Grip ) you can use update-rc.d to put these in, more or less.
update-rc.d led-config defaults 05
update-rc.d pandora-state defaults 31
update-rc.d pndevmapperd-init defaults 30 40
update-rc.d pndnotifyd-init defaults 30 40

===== Script Fixups =====
We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up. 
The update-rc.d program will shout at you which ones, and essentially, it's just some tidying up that needs done.

=== Users and Permissions ===
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

=== Reboot and Troubleshooting ===

==== auto/boot.txt ====
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

Alternatively, if you remove the '''console=ttyS0,115200n8''' part, you will be able to see debug text as the system boots up.

All that's really left now is to reboot and catch any issues that may crop up!

==== First Boot ====

===== tslib calibration =====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

===== Finish up installing any left overs =====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

==== Cleanup ====
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

== Maintenance and Upgrades ==
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

== Common Issues/Fun Things To Do ==
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

=== Networking ===
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

=== Synaptic ===
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

=== My PNDs don't work, why?! ===
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 and 1.0.4 do not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

=== Wifi and Session Management is broken?! ===
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

=== My PNDs don't appear immediately? ===
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

This should be fixed in 1.0.4

=== I get no notifications in 1.0.3 ===
This is actually because notification-daemon hasn't been installed.

=== Packages to add in 1.1! ===
Feel free to add packages here that I should include in the next release (1.1)
* wireless-tools
* x11-xserver-utils ( I keep forgetting this.. it's for xmodmap )
* xinput

= Emdebian Grip =
Most of the above can be taken for Grip, with the following changes...

Why Grip? It's much smaller and targeted for embedded devices... I originally was going to use Grip actually, but it was a bit buggered at the time, though it seems to be working now. 
Additionally, Emdebian comes in Crush and Baked flavours... Grip is compatible with Desktop Debian, so we'll use that.. Crush is smaller again, and generally requires a cross-compiler to setup packages, and Baked is effectively what we do with Angstrom.

Emdebian could also in theory be shrunk enough to actually fit on NAND... which is something I'll be looking into - if only to document another alternative process to the Angstrom OE bitbake bonanza.

== Multistrap ==
Grip's debootstrap is slightly different... it uses multistrap instead.

This allows us to use Grip's repository as the base, and Desktop Debian's repositories for anything else we might need ( omap3 drivers, for instance. ) This is also particularly useful for us when I get around to doing Pandora specifics compiled for Debian, as then we just add that repository as well.

Anyway, we need Debian running for this - be it on your Desktop ( or Ubuntu ) or on your Pandora ( recommended, as this guide assumes this is what you're doing. ) 
Install Multistrap - '''''sudo apt-get install multistrap'''''

You'll also need to mount an SD card somewhere manually.. I've mounted mine to /tmp/emdebian: '''''sudo umount /dev/mmcblk1p1 && mount /dev/mmcblk1p1 /tmp/emdebian'''''

=== Config File ===
'''''nano multistrap'''''
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

'''''sudo multistrap -f multistrap'''''

Change /tmp/multistrap to where ever you want the debootstrap to occur. 
'''Gotcha''''' I had issues with it complaining about unauthenticated packages, just add '''--no-auth''' to your command line and it'll continue happily.''

This shouldn't take too long ( was about half an hour on my Pandora ) and gives you a very sparse minimal rootfs of 192Mb.

The following multistrap config will give you what's in the 1.0.4 Grip rootfs
[General]
arch=armel
directory=/tmp/emdebian
cleanup=true
noauth=false
unpack=true
aptsources=Grip Debian
debootstrap=Grip Debian

[Debian]
packages=xserver-xorg-video-omap3 libxcb-dri2-0 libnotify-bin xinput
source=ftp://ftp.uk.debian.org/debian
keyring=debian-archive-keyring
suite=squeeze

[Grip]
packages=lxde busybox network-manager-gnome xfce4-power-manager apmd gdm less sudo nano wireless-tools iceweasel synaptic gnome-mplayer x11-xserver-utils notification-daemon gnome-keyring
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=squeeze

You could also add packages into the Grip and Debian configuration parts, and it will automatically pull them down and install them for you, be careful with what you pull in though, as not everything has been repackaged for Grip, so it will pull down the "full fat" variants from Debian instead.

You might get errors of unconfigured packages, just chroot in and run '''''apt-get -f install''''' to finish up.. if there are warnings about proc, ignore them till you reboot into the rootfs and re-run '''''sudo apt-get -f install'''''.

== Chroot and Setup ==
Now we can just chroot in and setup as we see fit. 
'''''sudo chroot /tmp/emdebian''''' - again, you may have mounted your media elsewhere. 
'''''sudo apt-get update'''''

You can now just follow the Debian guide as above, with the added bonus of most packages will come from Grip and be pre-stripped of extra fluff. 
I would recommend to get as much stuff as possible downloaded in the initial multistrap however, as it will automatically clean stuff up for you.

= Debian On NAND =
First of all, 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

== Get a Debian Rootfs ==
Your NAND has about 475Mb for the rootfs to play with ( there are other partitions, remember! ), therefore Desktop Debian is a bit too large for our purposes - even 1.0.3's complete massacre still ended up too big by far; so we need to look at Emdebian, of which there are three flavours - grip, crush and baked. 
We'll be using Grip, so follow the guide above for at least getting a working system on SD before going anywhere near your NAND.

We can use compression to get your rootfs down by 40-50%, but I'd still be vary wary of a large rootfs!

If you're lazy, grab my pre-made Grip rootfs, which includes LXDE by default.

== Preparing the Rootfs ==
Boot into your rootfs for this, so we can ensure we're as up to date as we can be, then clean the apt cache, and then any crap we installed which we don't need any more, such as things which were installed as dependencies and the parent's been removed. 
'''''sudo apt-get update''''' 
'''''sudo apt-get upgrade''''' 
'''''sudo apt-get clean''''' 
'''''sudo apt-get autoclean''''' 

Additionally, you could wipe out the documentation ( if any ) and manually pull out unwanted packages. However, if you're pulling stuff out, you shouldn't have installed it in the first place! Go back to the start and do it again as punishment!

This post on the Ubuntu forums is particularly helpful: http://ubuntuforums.org/showthread.php?t=140920

Depending on your needs, you may also want to wipe out your home folder and reinstate it from /etc/skel 
You'll also want to wipe out tmp - '''''sudo rm -rf /tmp/*'''''

Now shut down and either place your SD card in your PC. You can do this on Pandora, but you will need a lot of space.

Copy your rootfs somewhere.. I suggest /tmp/pandora-debian 
'''''mkdir /tmp/pandora-debian''''' 
'''''sudo cp -p -r /media/my/sd/card/* /tmp/pandora-debian''''' - this will preserve Permissions and copy everything Recursively.

We need to edit the fstab so that it can boot properly, if you haven't done so already. 
'''''sudo nano /tmp/pandora-debian/etc/fstab'''''
# OpenPandora fstab.

rootfs / auto defaults,noatime 1 1
proc /proc proc defaults 0 0
devpts /dev/pts devpts mode=0620,gid=5 0 0
usbfs /proc/bus/usb usbfs defaults 0 0
tmpfs /var/volatile tmpfs defaults 0 0
tmpfs /dev/shm tmpfs mode=0777 0 0
tmpfs /media/ram tmpfs defaults 0 0

This should look familiar, as it's effectively your stock fstab minus the boot partition ( we have a kernel in our rootfs, if you've followed the above guides... )

We should also get rid of the autoboot.txt or boot.txt; '''''sudo rm /tmp/pandora-debian/autoboot.txt'''''

== Creating the Image ==
You need mtd-utils in your Debian distro of choice. '''''sudo apt-get install mtd-utils'''''

Now, mkfs.ubifs can compress using either LZO ( by default ) or zlib and will get your rootfs about 40-50% smaller depending on what you choose. It's also possible to use a combination of both, which is what we will do later.. Of course, if your rootfs is full of pre-compressed stuff already, it's not really going to shrink a great deal. 
For a full run down on mkfs.ubifs and co, see here: http://www.linux-mtd.infradead.org/doc/ubifs.html

Download the flash kit: http://openpandora.org/firmware/pandora-flash-kit.zip and extract it to /tmp/flash. I suggest reading the README as well.

Now run these fun commands... what we're doing is we're making a ubifs image first, then making an md5 checksum. 
We're also favoring LZO compression meaning we're mixing zlib and LZO to get the best compression we can. 
'''''sudo mkfs.ubifs -r /tmp/pandora-debian -o rootfs.img -m 2048 -e 129024 -c 4042 -x favor_lzo -X 20''''' 
'''''md5sum rootfs.img > rootfs.md5'''''

'''STOP! If your rootfs.img is getting close to 480Mb, you might not want to try and flash it.. it may be fine, but I would recommend 450Mb as an absolute maximum.'''

== Flashing the Image ==
I shall repeat: 
'''''WARNING: DO NOT ATTEMPT THIS.''''' 
'''''NO, SERIOUSLY, DON'T! THIS IS UTTERLY HACKY AND IT IS ON YOUR OWN HEAD IF YOU MESS UP.''''' 

Stick the following on to a FAT32 formatted SD card: 
* '''boot.scr''' - from the flash kit.
* '''rootfs.img''' - the image you've just created.
* '''rootfs.md5''' - the checksum to the image.

Place it in slot 1 of your Pandora ( the left slot, ) reboot while holding the right trigger, select boot from SD, cross your fingers and pray to the Pandora Gods.

Once it's done.. reboot and see what mess you've made, assuming you get it to boot! 
If you haven't got it to boot, on your FAT32 flasher card, add an autoboot.txt with the following:
setenv bootargs ubi.mtd=4 ubi.mtd=3 root=ubi0:rootfs rootfstype=ubifs rw vram=6272K omapfb.vram=0:3000K
ubi part boot && ubifsmount boot && ubifsload ${loadaddr} uImage && bootm ${loadaddr};

As this will let you see what's gone wrong... I had to do this a few times, as I buggered it up myself...

Congratulations, you now have Debian on NAND rather than Angstrom. 
Also, these instructions could easily be adapted to allow you to use any other distro that boots on Pandora.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-04-01T19:54:47Z

Stuckie: Adding apt details, fixing some line muckups and adding a list of packages to be includeded in 1.1

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 "brute force" release. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.3.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default User details are: 
username: '''pandora''' 
password: '''debian'''

== Little Note to Wiki Editors ==
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Changelog ==
=== Release 1.0 ===
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

=== Release 1.0.1 ===
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

=== Release 1.0.2 ===
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

=== Release 1.0.3 ===
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

== Release 1.1 Proposed ==
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Setting up Apt ==
I've forgotten about this, as mostly it'll be set to the default Debian repository, but should you want to change it: 
'''''sudo nano /etc/apt/sources.list'''''

UK people can set this to ''deb ftp://ftp.uk.debian.org/debian main non-free contrib'' to get pretty much everything, or can pick whichever local Debian repository they like - but be warned that not all of them have an armel repo! 
By default, debootstrap will likely only get main.. adding the non-free and contrib branches are optional, but bring in more stuff.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

Should probably copy more over but, this'll do for now. 

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
==== Current 1.0.2/3 Release ====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

==== libts for other releases ====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

=== Battery Monitor ===
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

=== Misc Init Scripts and Things ===
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

=== RC Scripts ===

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
==== rc0.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc1.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc2.d ====
ln -s ../init.d/led-config S05led-config

==== rc3.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc4.d ====
ln -s ../init.d/led-config S05led-config

==== rc5.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc6.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rcS.d ====
ln -s ../init.d/pandora-state S39pandora-state

==== Script Fixups ====
We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up.

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

==== tslib calibration ====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

==== Finish up installing any left overs ====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

= Common Issues/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PNDs don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 does not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

== Wifi and Session Management is broken?! ==
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following: 
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

== My PNDs don't appear immediately? ==
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

== I get no notifications in 1.0.3? ==
This is because there is no theme.. feel free to install one! I was just trying to make a small as possible rootfs, compared to 1.0.2's 1.2gig of stuff.

== My nubs don't work in 1.0.3! ==
Try re-downloading.. I uploaded a bit too quick and missed the init script fiddling.

== Packages to add in 1.1! ==
Feel free to add packages here that I include in the next release (1.1)
* wireless-tools

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-03-27T01:06:55Z

Stuckie: Marking the init script fiddling as important - as even I missed it with the 1.0.3 release and just re-uploaded it.

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 "brute force" release. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.3.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default User details are: 
username: '''pandora''' 
password: '''debian'''

== Little Note to Wiki Editors ==
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Changelog ==
=== Release 1.0 ===
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

=== Release 1.0.1 ===
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

=== Release 1.0.2 ===
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

=== Release 1.0.3 ===
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

== Release 1.1 Proposed ==
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

Should probably copy more over but, this'll do for now. 

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
==== Current 1.0.2/3 Release ====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

==== libts for other releases ====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

=== Battery Monitor ===
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

=== Misc Init Scripts and Things ===
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

=== RC Scripts ===

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
==== rc0.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc1.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc2.d ====
ln -s ../init.d/led-config S05led-config

==== rc3.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc4.d ====
ln -s ../init.d/led-config S05led-config

==== rc5.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc6.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rcS.d ====
ln -s ../init.d/pandora-state S39pandora-state

==== Script Fixups ====
We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

If you don't do this, the nub settings won't save, for instance, and some system scripts are not guaranteed to start up.

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

==== tslib calibration ====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

==== Finish up installing any left overs ====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

= Common Issues/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PNDs don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 does not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

== Wifi and Session Management is broken?! ==
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following:
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

== My PNDs don't appear immediately? ==
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

== I get no notifications in 1.0.3? ==
This is because there is no theme.. feel free to install one! I was just trying to make a small as possible rootfs, compared to 1.0.2's 1.2gig of stuff.

== My nubs don't work in 1.0.3! ==
Try re-downloading.. I uploaded a bit too quick and missed the init script fiddling.

[[Category:Documentation]] [[Category:Operating Systems]]

Software projects

2011-03-26T23:30:06Z

Stuckie: /* Operating systems */ Fixing Debian download link to point to Debian_On_SD page.

''These lists were last updated on 2011-03-25 to include the latest files from [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps], the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive], and the [[Software_projects#Forums|community forums]].''

This is a list of '''all software projects''' for the Pandora ''excluding'' emulators (see: [[Emulator list]]), games (see: [[Games]]), and development tools (see: [[Development Tools]]). However, this list ''does'' include the development apps that can be used on the Pandora itself.

See the [[Port Requests]] article for open-source projects which ''could'' be ported but have not been taken on by anyone yet.

==Released software==
If you would like to add something, you could edit the wiki or [http://www.gp32x.com/board/index.php?/topic/54923-the-pandora-apps-thread/ post in this forum thread]. If different versions of a software were released, please make sure the "release date" is the most recent one.

Please click on the little squares to sort by different categories (such as Release date, Type, etc.)

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[AbiWord]]
|2011-01-17
|sebt3 (packaging)
|Office - word processor
|[http://sebt3.openpandora.org/pnd/abiword.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__919843 Discussion]
|-
|Alarm Clock ('''beta''')
|2011-02-01
|sebt3 (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,303 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/ Discussion]
|-
|[[Anki]] 1.2.5 ('''beta''')
|2011-01-25
|Drack (port)
|Office - memory aid
|[http://dl.dropbox.com/u/8938380/anki-1.2.4-drack1.pnd) Download]
|Discussion [http://www.gp32x.com/board/index.php?/topic/58929-anki-friendly-intelligent-flashcards/ 1] [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/ 2]
|-
|[[Arora]] (for [[Minimenu]])
|2010-05-26
|Skeezix (quick hack)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,69 Archive]
|Needed to run Arora from Minimenu
|-
|[[Audacious]] 2.4.4
|2011-03-07
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/audacious.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54792-audacious/page__view__findpost__p__942175 Discussion]
|-
|[[b7zip]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Background killer
|2010-06-07
|Notaz
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/background_killer.inf Apps]
|Kill background tasks in minimenu. {{HideableNotes|"[http://www.gp32x.com/board/index.php?/topic/56008-zelda-classic-for-pandora/page__st__15__p__907940&#entry907940 Not needed]" since Hotfix 3, but still useful as a quick way to make sure all other tasks are closed.}}
|-
|[[Banshee]]
|2010-10-23
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/banshee.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57144-portrequest-banshee/ Discussion]
|-
|Better battery charging ('''beta''')
|2011-03-13
|WizardStan
|System
|[http://www.rebirthofxeen.com/files/pandora/chargeHack1 Download]
|[http://boards.openpandora.org/index.php?/topic/1488-better-battery-charging-beta/page__view__findpost__p__40784 Discussion]. Not a PND; must install from terminal.
|-
|[[Bluefish Editor]] 2.0.3
|2011-03-13
|mcobit (port)
|Network - web design
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,352 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58927-port-request-bluefish-editor/ Discussion]
|-
|[[Bournal]]
|2010-08-11
|
|Office - journal
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,181 Archive]
|encrypted diary program
|-
|[[Brasero]]
|2011-03-01
|mcobit (port)
|System - CD/DVD burner
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,335 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58842-brasero/ Discussion]
|-
|[[Chromium]]
|2010-09-04
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,90 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56474-chromium-4-with-ssl-and-chromium-snapshot/ Discussion]. SSL now works
|-
|[[Chromium]]-Dev v10.0.642.1
|2011-01-16
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,201 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58234-chromium-dev-snapshot-v10-0-642-1/ Discussion] [http://www.gp32x.com/board/index.php?/topic/57017-chromium-dev-updated/ (old)]. The latest (non-stable) snapshot.
|-
|[[Claunch]] ('''beta''')
|2010-10-14
|Lamoxx
|System - app launcher
|[http://userpages.uni-koblenz.de/~bbrink/tmp/claunch_beta.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57040-claunch-minimal-flexible-rom-pickerapplication-launcher/ Discussion]
|-
|[[Claws Mail]]
|2010-10-03
|sebt3 (port)
|Network - mail client
|[http://sebt3.openpandora.org/pnd/claw-mail.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,223 Archive]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920075 Discussion]. Hopefully doesn't save to NAND (testing needed).
|-
|[[Cmus]]
|2010-11-27
|otherguy66 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,251 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57682-cmus-pnd-installer/page__gopid__928328&#entry928328 Discussion]. Installed to [[NAND]] (1mb). Text mode player
|-
|[[Code::blocks]]
|2010-06-07
|sinoth (port)
|Development - IDE
|[http://sinoth.net/pandora/codeblocks.pnd.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/54091-codeblocks-on-the-pandora/ Discussion].
|-
|Community Codec Package
|2010-05-25
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/CodecPack.inf Apps] [http://openpandora.org/downloads/CodecPack.pnd Official site]
|Make sure you have this installed
|-
|[[Comix]]
|2010-06-30
|Pontus Ekberg
|Graphics - image viewer
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/comix.inf Apps]
|
|-
|[[Conky]]
|2010-08-03
|daniel3000 (port)
|System
|[http://www.hermocom.com/en/downloads/openpandora/Conky.pnd/ Download]
|System monitor. [http://www.gp32x.com/board/index.php?/topic/55775-conky Discussion]
|-
|[[Converseen]]
|2011-03-03
|mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,339 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58859-converseen/ Discussion]
|-
|[[DarCalc]]
|2010-08-28
|JP
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,196 Archive]
|See also the calculator emulators [[Emulator list|here]]
|-
|[[Deadbeef]] 0.4.3
|2010-11-01
|CME (port), sebt3 (port)
|Audio - music player
|[http://root.shadow-node.net/public/cme/pnd/deadbeef.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55178-deadbeef-compiled-with-codesourcery-gcc-2010q1/ Discussion]
|-
|[[dia]]
|2010-10-03
|sebt3 (port)
|Office - diagrams
|[http://sebt3.openpandora.org/pnd/dia.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56863-dia/ Discussion]
|-
|[[DrawSWF]] ('''beta''')
|2010-07-10
|Chrysipp (port)
|Graphics - vector drawing
|[http://www.pandorasource.de/download.php?view.158 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10105%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhilcfdbJF4gEtvmTIwMjO9EFqUQ-A Discussion (German)]. Must have Java.pnd installed. {{HideableNotes|A small drawing program. The drawing can be exported as a Flash animation, which then shows its gradual development.}}
|-
|[[Effigy]] (PEF) Emulator Frontend ('''beta''')
|2011-03-11
|Aimless_E
|System - frontend
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=301 Download]
|[http://boards.openpandora.org/index.php?/topic/2276-effigy-pef-emulator-frontend/ Discussion] ([http://www.gp32x.com/board/index.php?/topic/44952-pandora-emulator-frontend/ old])
|-
|[[Ekiga]] ('''beta''')
|2010-10-29
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/ekiga.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/ Discussion]. Online phone & video calls. '''[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/page__view__findpost__p__924918 Doesn't work]'''{{HideableNotes| though it can be made to work through Debian, [[Extend Utils]]: [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/]}}
|-
|[[Emelfm2]]
|2011-03-09
|mcobit (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,351 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58928-port-request-emelfm2/ Discussion]
|-
|[[Empathy]] 2.29.6 ('''beta''')
|2011-03-08
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/empathy.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58911-empathy/ Discussion]. No networks included yet.
|-
|[[Enna]] ('''beta''')
|2010-07-08
|sebt3 (port)
|Media player
|[http://sebt3.openpandora.org/pnd/enna.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55113-enna/ Discussion]
|-
|[[Exaile]]
|2010-04-28
|Pickle (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,43 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Exaile.inf Apps]
|Needs Community Codec Pack to run
|-
|[[Extend Utils]]
|2010-06-22
|Stuckie
|System
|[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ 1], [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/ 2]. Debian in an extend. Allows you to run over 29,000 programs.
|-
|[[F3]]
|2010-10-17
|slaeshjag (port)
|System
|[http://stuffs.slaeshjag.org/F3.tar Download]
|Test for fake flash memory (like H2testw). [http://www.gp32x.com/board/index.php?/topic/57063-some-quick-tips-to-help-avoid-fake-sd-cardsflash-media/page__view__findpost__p__922187 Discussion]
|-
|[[FBReader]] 0.12.10
|2010-07-26
|zx81 (port)
|Office - eBook Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,168 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fbreader-0.12.10.inf Apps]
|
|-
|[[Fennec]] 4.0b3 ('''beta''')
|2011-02-03
|Mozilla Team, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,75 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Fennec40.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58514-fennec-4-0b3/ Discussion]
|-
|[[Fennec]] 3.6.3
|2010-05-30
|Mozilla Team, Iampanis (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fennec.inf Apps]
|mobile version of FireFox
|-
|[[Figaro's Password Manager 2]] ('''beta''')
|2010-11-30
|mcobit (port)
|System - passwords
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,254 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57714-figaros-password-manager-2/ Discussion]
|-
|[[Firefox]]
|2010-06-14
|Evildragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,91 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/FireFox.inf Apps]
|
|-
|[[Firefox]] 3.6.13
|2011-01-28
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-3.6.13-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/56903-firefox-3-6-10/ Discussion (old)], [http://www.gp32x.com/board/index.php?/topic/58425-firefox-3-6-13/ news/discussion]
|-
|[[Firefox]] 4.0B10 ('''beta''')
|2011-02-01
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-4b10-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58489-firefox-4-beta-10/ Discussion]
|-
|[[FlipClock]] ('''beta''')
|2011-02-05
|torpor (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58548-port-flipclock-for-pandora/ Discussion], also [http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/page__view__findpost__p__937668 here]
|-
|[[Fotoxx]]
|2010-12-06
|Kornelix mcobit (port)
|Graphics - photo editor & manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,261 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57777-fotoxx/ Discussion]
|-
|[[Freemind]] 0.9.0
|2011-03-10 2010-11-21
|mash (port)
|Office - mind mapping
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,4,240 Archive]
|[http://boards.openpandora.org/index.php?/topic/679-freemind-a-mindmap-tool/page__view__findpost__p__39752 Discussion] [http://www.gp32x.com/board/index.php?/topic/57605-freemind-a-mindmap-tool/ (old)] . Needs java.pnd installed.
|-
|[[GanttProject]] 2.0.10
|2011-03-19
|mash (port)
|Office - project management
|[http://mash-systeme.de/downloads/ganttproject.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,364 Archive]
|[http://boards.openpandora.org/index.php?/topic/2491-ganttproject-2010/ Discussion] [http://en.wikipedia.org/wiki/GanttProject Wiki article]. Needs Java.pnd
|-
|[[GCalc]]
|2010-11-23
|mcobit (port)
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,241 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57636-gcalc-graphic-calculator/ Discussion]. Needs java.pnd installed. See also the calculator emulators [[Emulator list|here]]
|-
|[[gCalctool]]
|2011-02-26
|mash (port)
|Office - calculator
|[http://mash-systeme.de/downloads/gcalctool.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/page__gopid__36838#entry36838 Discussion].
|-
|[[Geany]] v0.19-1
|2010-09-16
|bompo (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,14,205 Archive] [http://dl.dropbox.com/u/39448/pandora/geany.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55432-geany/ Discussion]
|-
|[[gedit]]
|2010-10-03
|sebt3 (port)
|Office - text editor
|[http://sebt3.openpandora.org/pnd/gedit.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56862-gedit/ Discussion]
|-
|[[gerbv]]
|2010-09-14
|bompo (port)
|Office - EDA
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,202 Archive]
|viewer for Gerber RS-274X, Excellon drill, & CSV pick-and-place files
|-
|[[gFTP]] 2.0.18 ('''beta''')
|2010-07-01
|sebt3 (port)
|Network - FTP client
|[http://sebt3.openpandora.org/pnd/gftp.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54931-gftp/ Discussion]
|-
|[[GIMP]] v2.6 ('''beta''')
|2010-06-06
|Stuckie (quick hack)
|Graphics - image editor
|[http://www.stuckiegamez.co.uk/apps/pandora/gimp-2.6.pnd Download]
|Read instructions [http://www.gp32x.com/board/index.php?/topic/54071-ubuntu-or-other-dist-alternative/page__p__868411&#entry868411 here]
|-
|[[Gmu Music Player]] 0.7.2
|2010-12-29
|wejp
|Audio - music player
|[http://wejp.k.vu/files/gmu-0.7.2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58009-gmu-music-player-0-7-2/ Discussion] [http://www.gp32x.com/board/index.php?/topic/55007-gmu-music-player-0-7-1-released/ (old)]
|-
|[[Gnomad 2]]
|2010-10-18
|sebt3 (port)
|Audio - music manager
|[http://sebt3.openpandora.org/pnd/gnomad2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57088-gnomad2/ Discussion]
|-
|[[Gnome Music Player Client]] (GMPC) 0.20.0 ('''beta''')
|2010-08-01
|tsh (port)
|Audio - music player
|[https://sites.google.com/site/tshpandorastuff/file-cabinet/gmpc0.20.0.pnd?attredirects=0&d=1 Download]
|[http://www.gp32x.com/board/index.php?/topic/55664-gmpc-beta/ Discussion]
|-
|[[Gnumeric]]
|2011-01-17
|sebt3 (port)
|Office - spreadsheet
|[http://sebt3.openpandora.org/pnd/gnumeric.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920072 Discussion]
|-
|[[GoldenDict]] 0.9.0Svn
|2010-09-27
|Hitnrun (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,209 Archive] [http://www.rangelreale.com/pandora/goldendict.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56802-goldendict-0-9-0svn/ Discussion]
|-
|[[GParted]]
|2011-02-05
|sebt3 (port)
|System - partition
|[http://sebt3.openpandora.org/pnd/gparted.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Discussion]
|-
|[[gPicView]]
|2011-03-10
|sebt3 (port)
|Graphics - image viewer
|[http://sebt3.openpandora.org/pnd/gpicview.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58938-gpicview/ Discussion]
|-
|GQview
|2010-07-27
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/GQview.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55559-gqview-pnd-image-viewer-available/ Discussion]
|-
|[[Grafx2]]
|2010-12-30
|pulkomandy, yrizoud, mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,264 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58016-grafx2/ Discussion]. For pixel art.
|-
|[[Grafx2]] SVN v1713
|2010-12-30
|pulkomandy, yrizoud, et al.
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,330 Archive]
|For pixel art.
|-
|[[GrooveShark Player]]
|2011-03-11
|Elias Woods, coldbird (port)
|Network - music streaming
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,354 Archive]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58952-getting-on-grooveshark/page__view__findpost__p__942959 GP32X] [http://boards.openpandora.org/index.php?/topic/2273-compile-groove-for-pandora/ OP]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. {{HideableNotes|"you can listen to a gigantic Online Music Archive for free."}}
|-
|[[Groove]]
|2010-07-19
|Elias Woods, bompo (port)
|Network - music streaming
|[http://dl.dropbox.com/u/39448/pandora/Groove.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58952-getting-on-grooveshark/ Discussion]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. '''Warning''': {{HideableNotes|Requires installing dependencies with opkg. See discussion thread.}}
|-
|[[GRsync]]
|2011-03-03
|mcobit (port)
|System - file manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,340 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58861-grsync/ Discussion]. Synchronize folders & files, make backups
|-
|[[Gwaei]]
|2010-11-26
|Zachary Dovel mcobit (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,249 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57674-gwaei-port-japanese-english-dictionary/ Discussion]. Japanese-English.
|-
|[[hfsutils]]
|2011-03-10
|Silent-Hunter (port)
|System
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=295 Download]
|[http://boards.openpandora.org/index.php?/topic/2236-hfsutils-port/ Discussion]. For reading & writing Macintosh file systems.
|-
|[[HomeBank]] 4.3
|2011-02-26
|Maxime Doyen, mcobit (port)
|Office - money manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,296 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58506-homebank/ Discussion]
|-
|Hotfix 5
|2011-03-04
|Pandora team
|System
|[http://www.openpandora.org/downloads/HotFix5-Zaxxon.pnd Official site]
|Make sure you have this installed. Discussion: [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ GP32X] [http://boards.openpandora.org/index.php?/topic/2080-hotfix-5-released/page__pid__37497#entry37497 OP]
|-
|[[Inkscape]] ('''beta''')
|2010-10-08
|sebt3 (port)
|Graphics - vector drawing
|[http://sebt3.openpandora.org/pnd/inkscape.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56954-inkscape/ Discussion]. Currently very slow.
|-
|[[Java]] Pnd ('''beta''')
|2010-11-21
|WizardStan (port)
|System - dependency
|[http://rebirthofxeen.com/files/pandora/java.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57598-java-pnd/ Discussion]. Run Java apps.
|-
|[[jEdit]]
|2010-11-22
|mcobit (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,244 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57614-jedit-programmers-text-editor/ Discussion]. For programmers. Needs java.pnd installed.
|-
|[[jChemPaint]]
|2010-11-23
|mcobit (port)
|Graphics - molecule drawing
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,242 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57633-jchempaint/ Discussion]. Needs java.pnd installed.
|-
|[[jMol]]
|2010-11-22
|mcobit (port)
|Graphics - molecule viewing in 3D
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,243 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57618-jmol-3d-molecule-viewer/ Discussion]. Needs java.pnd installed.
|-
|[[jMP3 Player]]
|2010-07-10
|jaijuju
|Audio - music player
|[http://www.pandorasource.de/download.php?view.156 Download]
|[http://code.google.com/p/jmp3player/ Website]. Java.pnd required.
|-
|[[Jumanji]]
|2011-03-03
|b3w (port)
|Network - web browser
|[http://www.mediafire.com/?5va2dj4x6bkrobi Download] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/jumanji.inf Apps]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11821 Discussion (German)]. [https://wiki.archlinux.org/index.php/Jumanji Wiki]
|-
|[[KCHMViewer]] 5.2
|2010-10-05
|Hitnrun (port)
|Office - CHM Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,215 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56901-kcmviewer/ Discussion.] Windows help files reader.
|-
|[[KDiff 3]]
|2011-02-03
|Joachim Eibl
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,299 Archive]
|[http://boards.openpandora.org/index.php?/topic/1440-kdiff3-0995-pandora-3/ Discussion]. Merge 2 or 3 text input files or directories
|-
|[[Keyboard layout changer]]
|2011-03-18
|slaeshjag
|System - configuration
|[http://stuffs.slaeshjag.org/kblayout.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/2428-keyboard-layout-changer/ Discussion]. Shows up in Settings as Keyboard Layout
|-
|[[Liferea]]
|2010-07-06
|sebt3 (port)
|Network - RSS Reader
|[http://sebt3.openpandora.org/pnd/liferea.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55089-liferea/ Discussion]
|-
|[[Lightweight2]] 1.5
|2011-03-22
|cpttom, mcobit (port), Zero3K (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,332 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58836-lightweight2/page__view__findpost__p__944075 Discussion]. Small, fast browser.
|-
|[[Links2]]
|2011-03-10
|mash (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,333 Archive]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/ Discussion].
|-
|[[Linphone]] ('''beta''')
|2011-01-20
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/linphone.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58289-linphone Discussion]. Online phone calls.
|-
|[[Lynx]] v2.8.7
|2011-02-28
|Mhaws (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,331 Archive]
|[http://boards.openpandora.org/index.php?/topic/1998-lynx-087/ Discussion]
|-
|[[Me TV]]
|2010-10-19
|sebt3 (port)
|Network - digital TV
|[http://sebt3.openpandora.org/pnd/metv.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56987-port-request-me-tv/page__p__921501&#entry921501 Discussion]
|-
|[[Merkaartor]] 0.17.0
|2011-01-27
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/merkaartor.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56656-merkaartor-or-other-osm-editor/page__p__922345&#entry922345 Discussion]
|-
|[[MilkyTracker]]
|2010-06-23
|Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,102 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/milkytracker.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/57612-remember-the-only-2-keyboard-buttons-at-once-limitation/ Discussion]
|-
|[[Minitube]] 1.4
|2011-03-05
|Flavio Tordini, sebt3 (port)
|Network - Youtube client
|[http://sebt3.openpandora.org/pnd/?f=minitube.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/55952-minitube-1-1/ v1.1] [http://www.gp32x.com/board/index.php?/topic/58183-minitube-1-3/ v1.3] [http://www.gp32x.com/board/index.php?/topic/57099-new-version-of-minitube-avaiable/page__view__findpost__p__941908 v1.4]. Youtube browser/player
|-
|[[mtPaint]]
|2010-07-27 2010-12-29
|Mark Tyler, daniel3000 (port 1), chris_c (port 2)
|Graphics - image editor
|[http://www.hermocom.com/en/downloads/openpandora/mtPaint.pnd/ Download (port 1)] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,263 Archive (port 2)]
|[http://www.gp32x.com/board/index.php?/topic/55561-mtpaint-pnd-available/ Discussion]. For painting & pixel art. Ported twice.
|-
|[[Mutt]]
|2011-03-01
|mash (port)
|Network - email client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,334 Archive]
|[http://boards.openpandora.org/index.php?/topic/1964-mutt-links2-and-gcalctool/ Discussion]. Text-based.
|-
|[[MyPaint]]
|2011-02-27
|First (port)
|Graphics - image editor
|[http://webusers.spa.umn.edu/~laurens/pnd/mypaint-0.9.0.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1817-mypaint-port/ Discussion]. [http://mypaint.intilinux.com/ Website]. Has pressure sensitivity.
|-
|[[ncmpcpp4P]] v0.5.7.0
|2011-03-01
|remogatto (port)
|Audio - music player
|[https://github.com/downloads/remogatto/ncmpcpp4P/ncmpcpp4P_v0.5.7.0.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/2032-ncmpcpp4p/ Discussion]. [http://unkart.ovh.org/ncmpcpp/ Website] ncurses-based music player
|-
|[[Netsurf]] 2.6
|2011-03-08
|slaeshjag(port)
|Network - web browser
|[http://stuffs.slaeshjag.org/netsurf.pnd Download]
|Discussion: [http://boards.openpandora.org/index.php?/topic/2129-netsurf/ OP] [http://www.gp32x.com/board/index.php?/topic/58913-netsurf-2-6/ GP32X] No SSL support
|-
|[[Nightvision]] 3.0
|2011-03-12
|F_Slim (port)
|Office - planetarium
|[http://www.slimpages.de/extern/nightvision.pnd.zip Download]
|[http://boards.openpandora.org/index.php?/topic/2299-nightvision-30/ Discussion] [http://forum.gp2x.de/viewtopic.php?f=59&t=11810 (German}]. Needs java.pnd installed. May not work in HF5
|-
|[[Ommpc]] v0.5.4
|2010-10-06
|Tim Temple
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,133 Archive]
|MPD client [http://www.gp32x.com/board/index.php?/topic/55039-ommpc-v0-5-2/ Discussion]
|-
|[[OSM2Go]]
|2010-10-20
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/osm2go.pnd Download]
|
|-
|[[Osmo]] ('''beta''')
|2010-09-03
|sebt3 (port)
|Office - personal organizer
|[http://sebt3.openpandora.org/pnd/osmo.pnd Download]
|[http://clayo.org/osmo/ Website] [http://www.gp32x.com/board/index.php?/topic/56455-osmo/ Discussion]
|-
|[[PanDebian]]
|2011-02-04
|Gregor
|System
|[http://codu.org/tmp/pandebian.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1474-pandebian/ Discussion]. [[Extend Utils]] alternative for Angstrom-Debian cooperation
|-
|Pandora Fractals
|2010-08-26
|Or Green
|Graphics - fractals
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/PFractals.inf Apps]
|fractal generator. [http://www.gp32x.com/board/index.php?/topic/51402-mandelbrot-set-generator-for-pandora/page__st__75 Discussion]
|-
|Pandora SD Installer 1.2
|2011-03-19
|Dave1234
|System
|[http://boards.openpandora.org/index.php?app=core&module=attach&section=attach&attach_id=337 Download]
|[http://boards.openpandora.org/index.php?/topic/2297-pandora-sd-installer/page__view__findpost__p__42772 Discussion]. Install Pandora OS to your SD card.
|-
|[[PanPlayer]] Beta 4
|2011-02-24
|JDGBOLT
|Media player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive] [http://apps.openpandora.org/cgi-bin/viewapp.pl?/Application/PanPlayer.inf Apps]
|'''Needs Hotfix 5'''. [http://www.gp32x.com/board/index.php?/topic/58769-panplayer-beta/ Discussion]. Optimized mplayer build
|-
|[[Pencil]] 0.4.4b ('''beta''')
|2010-11-04
|sebt3 (port)
|Graphics - animation
|[http://sebt3.openpandora.org/pnd/pencil.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57362-pencil/ Discussion]. 2D animation & drawing.
|-
|[[Pepviewer]]
|2011-02-22
|Skadus (port)
|Graphics - image viewer
|[http://www.mediafire.com/?t0sop9wrj087e1t Download]
|[http://boards.openpandora.org/index.php?/topic/1869-pepviewer/ Discussion]. Ported from PSP.
|-
|[[Pidgin]] 2.7.10
|2011-03-03
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/pidgin.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56898-pidgin/ Discussion]. This version no longer uses [[NAND]] to [http://www.gp32x.com/board/index.php?/topic/56898-pidgin/page__view__findpost__p__934658 store data].
|-
|[[PNDbuilder]] v1.1
|2011-02-22
|freedomdown (Ryan Dallaire)
|Development
|[http://www.freedomdown.ca/storage/pndb.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58587-pndbuilder/page__view__findpost__p__940230 Discussion]. Graphical PND maker.
|-
|PS3 Bluetooth Controller - Sixpair Utility
|2010-06-13
|Jim Paris, Samson Yeung, AireTamStrm (port)
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,4 Archive]
|Use a DualShock III Controller or SIXAXIS controller via USB
|-
|[[PSFreedom]]
|2010-09-23
|Notaz (port)
|Other
|[http://pandorapress.net/gruso/psfreedom.ko Download]
|[http://www.gp32x.com/board/index.php?/topic/56752-psfreedom-for-pandora/ Discussion]. Allows homebrew on your PS3.
|-
|[[qBittorrent]]
|2011-03-16
|Coldbird (port)
|Network - BitTorrent client
|[http://dl.dropbox.com/u/13011238/qbittorrent-1.3.3-pandora.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58993-qbittorrent/ GP32X] [http://boards.openpandora.org/index.php?/topic/2389-qbittorrent/page__gopid__41612#entry41612 OP]
|-
|[[qOrganizer]]
|2010-11-04
|sebt3 (port)
|Office - organizer
|[http://sebt3.openpandora.org/pnd/qorganizer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,233 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57359-qorganizer/ Discussion]
|-
|[[QSynth & FluidSynth]] 0.3.5 ('''beta''')
|2011-03-18
|Kazuki (port)
|Audio - synthesizer
|[http://pandora.idb.s1.jcink.com/qsynth-0.3.5.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/59011-porting-qsynth-fluidsynth-with-yactfeau/page__view__findpost__p__943670 Discussion] [http://qsynth.sourceforge.net/qsynth-index.html Website] {{HideableNotes|software synthesiser based on the Soundfont specification.}}
|-
|[[QtSpotify]]
|2011-03-11
|sebt3 (port)
|Network - music streaming
|[http://sebt3.openpandora.org/pnd/qtspotify.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58955-qtspotify/ Discussion]. Spotify client.
|-
|Quick Change CPU Speed
|2010-06-20
|Pleng
|System
|[http://www.strappysolutions.com/demos/pandora/CPUSpeeds.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54583-quick-change-cpu-speeds/ Discussion]. Add CPU speed presets to your menu.
|-
|RAM Defragger 0.4.0
|2011-03-16
|Tobias 'knilch' Jordan
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,359 Archive]
|memory optimizer
|-
|[[Remmina]]
|2010-06-21
|mindlord (port)
|Network - VNC/RDP/XDMCP client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,99 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/remmina.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54610-remmina-0-7-5/ Discussion]. Control your PC from your Pandora.
|-
|[[Rockbox]] 3.8.x ('''beta''')
|2011-03-13
|Thomas Jarosch, froggyman (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,343 Archive]
|[http://boards.openpandora.org/index.php?/topic/2094-rockbox-as-an-app/ Discussion]
|-
|[[RText]]
|2010-07-10
|Fifesoft, Chrysipp (port)
|Development - text editor
|[http://www.pandorasource.de/download.php?view.157 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10106%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhivaNHspNg4XSb4aOpjskxivvIRXw Discussion (German)]. Must have Java.pnd installed.
|-
|[[Schism Mod Player]]
|2010-06-10
|?
|Audio - music tracker
|[http://www.pandorasource.de/download.php?view.79 Download]
|Player for MOD and XM.
|-
|[[Schism Tracker]]
|2010-06-19
|Storlek, Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,89 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/schismtracker.inf Apps]
|Clone of Impulse Tracker
|-
|[[Scientific Calculator]]
|2011-02-14
|Chrysipp (port)
|Office - calculator
|[http://web.student.tuwien.ac.at/~e0725060/JavaScientificCalculator.pnd Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11714 Discussion (German)]. Must have Java.pnd installed.
|-
|[[Scite]] 2.21
|2010-10-20
|urjaman (port)
|Office - text editor
|[http://urjaman.dyndns.info/scite221.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57116-scite-2-21-ported/ Discussion]. Scintilla-based syntax highlighting text editor
|-
|SD Card Speed Fix
|2010-06-13
|mawler
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,88 Archive]
|improve SD writing speed, but risk data corruption if writing is interrupted
|-
|[[Seq24]] ('''beta''')
|2010-09-06
|Gruso (port)
|Audio - music tracker
|[http://users.tpg.com.au/pw2007/seq24.beta1.pnd Download]
|MIDI sequencer. [http://www.gp32x.com/board/index.php?/topic/56517-seq24-midi-sequencer/ Discussion]
|-
|[[SMPlayer]] 0.6.9-1
|2011-02-02
|Ivanovic (port)
|Media player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive]
|MPlayer frontend. [http://www.gp32x.com/board/index.php?/topic/58511-smplayer/ Discussion]
|-
|[[SUPA]] 0.1-1 ('''beta''') Simple Updater for Pandora Applications
|2010-07-04
|Bryce Leo
|System - Application Downloader/Updater
|[http://drive.and-a-half.com/SUPA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55023-supa-simple-updater-for-pandora-applications/ Discussion]. No GUI yet.
|-
|[[Synergy]]
|2010-10-09
|Lomaxx (port)
|Network - VNC client
|[http://www.mediafire.com/?npdbkibd5bm5ckb Download]
|[http://www.gp32x.com/board/index.php?/topic/56943-synergy-clientserver-as-pnd/ Discussion]. Control your PC from your Pandora.
|-
|[[TiMidity++]] 2.13.3 (player + Daemon loader)
|2011-03-21
|Gruso (port)
|Audio - MIDI
|[http://bunnitude.com/gruso/timidity-alsa-daemon.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/59041-timidity-2-13-2-port/ GP32X] [http://boards.openpandora.org/index.php?/topic/2450-timidity/ OP]. Must install Timidity MIDI Installer first. {{HideableNotes|This makes Timidity visible to sequencers as a device.}}
|-
|[[Timidity MIDI Installer]]
|2011-01-12
|sebt3
|Audio - MIDI
|[http://sebt3.openpandora.org/pnd/timidity_midi_installer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,273 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58173-midi-installer/ Discussion]. MIDI patches installer. {{HideableNotes|It will allow you to have music for games that use MIDI. There are 3 different sound-sample sets packing different levels of sound quality. Installs to [[NAND]], though you can put them on SD card and then it's less than 2k on NAND (2 2-line files).}}
|-
|[[Transmission]]
|2010-09-24
|sebt3 (port)
|Network - BitTorrent client
|[http://sebt3.openpandora.org/pnd/transmission.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,208 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56553-bit-torrent-client/ Discussion].
|-
|[[TrueCrypt]] ('''beta''')
|2011-02-12 2010-07-18
|TJSomething (port) daniel3000 (old port)
|System - encryption
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,321 Archive] [http://www.hermocom.com/en/downloads/openpandora/TrueCrypt.pnd/ old version]
|[http://boards.openpandora.org/index.php?/topic/1763-truecrypt-port/ Discussion]. [http://www.gp32x.com/board/index.php?/topic/55347-truecrypt-pnd-ready-for-testing/ Discussion (old)].
|-
|[[TV-Browser]] ('''beta''')
|2011-02-13
|chrysipp (port)
|Network - TV guide
|[http://web.student.tuwien.ac.at/~e0725060/TVBrowser.pnd Download]
|[http://forum.gp2x.de/viewtopic.php?f=59&t=11706 Discussion (German)]. [http://sourceforge.net/projects/tvbrowser/ Website]
|-
|[[Unace]]
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UnRar]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UPX]] (The Ultimate Packer for eXecutables)
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Viewnior 1.0
|2010-07-29
|daniel3000 (port)
|Graphics - image viewer
|[http://bunnitude.com/gruso/Viewnior.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55618-viewnior-pnd-available/ Discussion]
|-
|Vim Gvim 7.2 ('''beta''')
|2010-08-08
|joseluisjazz (port)
|Office - text editor
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Discussion]. [http://www.vim.org/about.php About]. Not a PND.
|-
|[[VLC]] 1.1.0 ('''beta''')
|2010-10-12
|sebt3 (port)
|Media player (video & audio)
|[http://sebt3.openpandora.org/pnd/vlc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54922-vlc/ Discussion]
|-
|[[Wahcade]] Emulator Frontend b1 ('''beta''')
|2011-02-06
|Sigma (port)
|System - frontend
|[http://www.mediafire.com/?h8o33khvtcy3x8m Download]
|[http://boards.openpandora.org/index.php?/topic/1508-wahcade-frontend-beta1/ Discussion].
|-
|[[Wbar]]
|2011-03-03
|mcobit (port)
|System - app launcher
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,338 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58858-wbar/ Discussion].
|-
|WiFi "Another Test Wifi Driver" ('''Beta''')
|2011-03-05
|David, notaz
|System
|[http://notaz.gp2x.de/misc/pnd/wl1251-modules_1.0-r24.5_omap3-pandora.ipk Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58888-another-test-wifi-driver/ GP32X] [http://boards.openpandora.org/index.php?/topic/2151-another-test-wifi-driver/ OP]. HF5 only, not for use with HF6.
|-
|WiFi '''Beta test'''
|2010-11-05
|Evildragon
|System
|[http://www.openpandora.org/downloads/WiFiBETA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57364-wifi-betatest/ Discussion]. Might fix WiFi issues.
|-
|[[Xarchiver]] 0.5.2
|2010-12-04
|mcobit (port)
|System - file archiver
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,259 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57748-xarchiver/ Discussion]
|-
|Xbindkeys
|2010-10-14
|Lomaxx (port)
|System
|[http://userpages.uni-koblenz.de/~bbrink/tmp/xbindkeys-1.8.3_prebuild.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57037-xbindkeys-precompiled/ Discussion]. Configure hotkeys
|-
|[[XBMC]] 10.0 ('''beta''')
|2011-03-13
|sebt3 (port)
|Media player
|[http://sebt3.openpandora.org/pnd/xbmc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57106-xbmc-media-center/page__view__findpost__p__942955 Discussion]. Functions as "entertainment hub".
|-
|XFE 1.32.1
|2010-07-20
|Maxim Baranov, Roland Baudin, packaged by sebt3
|System - file manager, packager Graphics - image viewer Office - notepad
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,163 Archive]
|
|-
|[[Xournal]]
|2010-10-03
|sebt3 (port)
|Office - journal
|[http://sebt3.openpandora.org/pnd/xournal.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56864-xournal/ Discussion]. Can annotate PDFs.
|-
|[[Zim]]
|2011-03-02
|Mindlord (port)
|Office - personal wiki
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,337 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58850-zim-the-desktop-wiki/page__view__getnewpost Discussion]
|}

===Skins===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Basic Gray
|2010-11-25
|milkshake
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=506 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueFuture
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,239 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=434 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Executive
|2010-11-27
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,250 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928158 Discussion]
|-
|Gray Is Sexy
|2010-11-27
|milkshake
|Minimenu skin
|[http://www.liquidfists.com/files/grayissexy.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928315 Discussion]
|-
|Midnight
|2010-06-17
|Trevsweb
|Minimenu skin
|[http://trevsweb.com/pandainterface/midnight.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|Newsprint
|2010-07-26
|Pleng
|Minimenu skin
|[http://www.strappysolutions.com/demos/pandora/newsprint.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|RedDevil
|2010-11-26
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,248 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928099 Discussion]
|-
|RedWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=433 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Toybox & Corporate (2 skins)
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=432 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Wasp
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,238 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|}

===Operating systems===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Debian ('''beta''')
|2011-02-20
|Stuckie
|Debian
|[http://pandorawiki.org/Debian_On_SD#Debian_On_SD Download]
|[http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/page__view__findpost__p__940030 Discussion]
|-
|Minimenu With Toggle Detail Panel Support ('''beta''')
|2011-01-23
|skeezix
|Minimenu
|[http://www.codejedi.com/pandora/minimenu/detail-toggle/ Download]
|[http://www.gp32x.com/board/index.php?/topic/58327-beta%3B-minimenu-with-toggle-detail-panel-support/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-26
|skeezix
|Minimenu
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110126.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-27
|skeezix
|Minimenu
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110127.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-02
|skeezix
|Minimenu
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110202.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-09
|skeezix
|Minimenu
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110209.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/page__view__findpost__p__938340 Discussion]
|}

===Graphic engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[GLES]] ('''beta''')
|2010-09-02
|Farox (port)
|
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Download]
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Discussion]
|}
===Demos/technical demos===

==Unreleased software ("Projects Under Development")==
This section includes both software that is actively being worked on, as well as ones that are or may be abandoned. The latter are included for historical purposes.

===Operating systems===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Android Omap
|[http://elinux.org/Android_on_OMAP]
|wip
|
|
|-
|AROS Arm
|[http://projects.powerdeveloper.org/project/imx515/735]
|wip
|
|
|-
|Debian
|[http://debian.org] [http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/]
|working build
|Stuckie
|
|-
|FreeBSD
|[http://wiki.freebsd.org/FreeBSD/arm/OMAP]
|wip
|
|
|-
|Fedora ARM
|[http://fedoraproject.org/wiki/Architectures/ARM]
|wip
|
|
|
|-
|Gentoo Linux
|[http://neuvoo.org] [http://vminko.org/gentoo_manuals/pandora]
|Working build, not completed
|javaJake, Viridior, vminko
|IRC: (FreeNode) #gentoo-pandora
|-
|HaikuOS
|[http://www.haiku-os.org]
|wip
|
|
|-
|Ohhie GUI
|[http://www.gp32x.com/board/index.php?/topic/58320-video-ohhie-gui/]
|working build
|Pleng
|Last update: Jan. 2011
|-
|RISC OS
|[[RISC OS|Link]]
|wip
|Uwe Kall, Jeffrey Lee + others
|BeagleBoard port available for download and testing.
|-
|Ubuntu ARM
|[http://www.ubuntu.com/products/whatisubuntu/arm]
|wip
|
|
|-
|Xoo on ubuntu
|[[Xoo on ubuntu|Link]]
|wip
|
|
|}

===Game Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OLA.G.E
|[http://sourceforge.net/projects/olage/]
|Wip
|neilae
|Game Engine with Authoring Tool for multiplatforms
|}

===Graphic Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|GLES2D
|
|Wip
|Cpasjuste
|OpenGL ES 2D library
|-
|GL-WES-v2.0
|[http://code.google.com/p/gl-wes-v2/]
|Working Build
|Adventus
|Opensource OpenGL 2.0 driver built on OpenGL ES 2.0
|-
|Irrlicht
|[http://irrlicht.sourceforge.net/] [http://irrlicht.sourceforge.net/phpBB2/viewtopic.php?t=32538&start=45]
|working build
|Hybrid
|3D game engine
|-
|NSS Engine
|[http://www.nosiestastudios.com/wiki/] [http://www.youtube.com/user/Prompt84]
|
|No Siesta Studios
|
|-
|OGRE Engine
|[http://www.gp32x.com/board/index.php?showtopic=46706] [http://www.youtube.com/watch?v=LDtUE5PIhV0]
|
|
|3D real-time renderer
|-
|Otaco Glost Engine
|[http://www.youtube.com/user/otacogloost], [http://www.gp32x.com/board/index.php?/topic/48393-i-did-stuff/page__p__736650&#entry736650]
|working
|Otaco
|
|-
|Quad-Ren 2D
|[http://quad-ren.sourceforge.net/index.php]
|Working
|Hessiess
|Version 0.5
|-
|SDL GLES
|[http://github.com/Cpasjuste/sdl-1.2.13_gles/tree]
|working
|Cpasjuste
|
|-
|XreaL
|[http://xreal.sourceforge.net/xrealwiki/]
|
|Pickle
|No longer being worked on. [http://www.gp32x.com/board/index.php?/topic/55173-xreal-patch-question/]
|-
|Stratagus
|[http://stratagus.sourceforge.net/]
|working build
|Cpasjuste
|RTS Engine
|-
|WakeBreaker
|[http://w1xer.at/pandora/]
|working codebase - can be compiled onboard
|torpor
|Working C++ codebase to implement a 3D game using nothing more than OpenGLES 1.1 .. can even be built *on* the Pandora, with nothing more than the onboard compiler. WakeBreaker contains everything you need to get started writing a 3D game in C++ with OpenGL ES - no further libraries required. Its an excellent example of how to write a 3D game in plain, easy to understand C++ and can serve as a working base for your own developments, easily enough.
|}
===Other programs===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Inside The Box
|[http://www.openpandora.pl broken] [http://www.youtube.com/watch?v=uLMmJBDEs2E broken]
|wip
|StreaK
|Pandora e-zine
|-
|Math-NEON
|[http://code.google.com/p/math-neon/]
|Wip
|Adventus
|cmath like library optimized for ARM NEON coprocessor
|-
|MythTVPlayer
|[http://www.gp32x.com/board/index.php?/topic/52882-mythtvplayer/]
|Working build
|Pickle
|Media center + TV/DV recording
|-
|Pandaphone
|[http://www.gp32x.com/board/index.php?/topic/48327-pandaphone/]
|
|jb0yx
|project to incorporate the Open Pandora handheld device with cell phone technology
|-
|Pandora Sync Suite
|[http://www.openpandora.pl broken]
|Working build
|StreaK
|for Windows 9x/NT
|-
|Pangea GUI
|[http://www.gp32x.com/board/index.php?showtopic=45631&hl=pangea]
|WIP
|efegea
|Gmenu alternative
|-
|Panorama
|[http://www.gp32x.com/board/index.php?/topic/51076-panorama/]
|abandoned
|dflemstr
|Gmenu alternative
|-
|PDM
|[http://github.com/Cpasjuste/pdm/tree]
|
|Cpasjuste
|Light desktop manager for Pandora
|-
|PGui
|[http://github.com/Cpasjuste/pgui/tree]
|
|Cpasjuste
|Standard emulator fronted for Pandora
|-
|PMenu
|[http://mydedibox.fr/_stuff/pandora/]
|
|Cpasjuste
|Minimal Menu for Pandora
|-
|PND Builder for windows
|[http://www.gp32x.com/board/index.php?/topic/47088-pnd-builder-for-windows/]
|Working build
|StreaK
|
|-
|Qemu
|[http://wiki.qemu.org/]
|testing build
|Fabrice Bellard
|open source machine emulator and virtualizer
|-
|Scale
|[http://www.youtube.com/user/Zoxc64]
|wip
|Zoxc64
|Minimal Menu for Pandora
|-
|Simple Dev Studio for Pandora
|[http://www.openpandora.pl broken]
|Wip
|StreaK
|for Windows 9x/NT
|-
|[[TINXL]]
|[[TINXL]]
|
|
|Application stack for multiplayer internet games
|}
===Demos / Technical Demos for OpenPandora===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OpenGL Cell Shading
|[http://www.youtube.com/watch?v=cpAj0jHglGw]
|working build
|
|
|-
|OpenGL Demo with MP3 Playback
|[http://www.youtube.com/watch?v=hkx18kruRJs]
|working build
|
|
|-
|OpenGL Skull Demo
|[http://www.youtube.com/watch?v=qG7EDaZpyOo]
|working build
|
|
|-
|WaveDemo
|[http://www.youtube.com/watch?v=4wgEHFCq9Lo]
|Working
|Otaco
|
|}

==External links==
*[http://sebt3.openpandora.org/pnd/ Releases by sebt3]
*[http://www.hermocom.com/en/downloads/openpandora/ Releases by Hermocom]
*[http://rebirthofxeen.com/files/pandora/ Releases by WizardStan]
*[http://www.stuckiegamez.co.uk/apps/pandora/ Releases by Stuckie]
*[http://www.pandorasource.de/download.php PandoraSource.de downloads] - German Pandora download site

===Forums===
The following community forums are checked when updating this page:
*From GP32X: [http://www.gp32x.com/board/index.php?/forum/63-news-zone-pandora/ News Zone], [http://www.gp32x.com/board/index.php?/forum/71-beta-testing-pandora/ Beta Testing] and [http://www.gp32x.com/board/index.php?/forum/64-developers-corner-pandora/ Developer's Corner]
*From OP: [http://boards.openpandora.org/index.php?/forum/26-software-news/ Software News] and [http://boards.openpandora.org/index.php?/forum/10-beta-testing/ Beta Testing]
*From GP2X.de: [http://forum.gp2x.de/viewforum.php?f=24 News] and [http://forum.gp2x.de/viewforum.php?f=59 Betatest]

[[Category:Development]]
[[Category:List]]
[[Category:Software]]

Debian On SD

2011-03-26T22:11:52Z

Stuckie: Fprgot .asoundrc

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 "brute force" release. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.3.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default User details are: 
username: '''pandora''' 
password: '''debian'''

== Little Note to Wiki Editors ==
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Changelog ==
=== Release 1.0 ===
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

=== Release 1.0.1 ===
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

=== Release 1.0.2 ===
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

=== Release 1.0.3 ===
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

== Release 1.1 Proposed ==
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

Should probably copy more over but, this'll do for now. 

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
==== Current 1.0.2/3 Release ====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

==== libts for other releases ====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

=== Battery Monitor ===
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

=== Misc Init Scripts and Things ===
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/skel/.asoundrc /media/mmcblk0p1/etc/skel''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

=== RC Scripts ===

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
==== rc0.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc1.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc2.d ====
ln -s ../init.d/led-config S05led-config

==== rc3.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc4.d ====
ln -s ../init.d/led-config S05led-config

==== rc5.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc6.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rcS.d ====
ln -s ../init.d/pandora-state S39pandora-state

We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

==== tslib calibration ====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

==== Finish up installing any left overs ====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

= Common Issues/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PNDs don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 does not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

== Wifi and Session Management is broken?! ==
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following:
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

== My PNDs don't appear immediately? ==
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

== I get no notifications in 1.0.3? ==
This is because there is no theme.. feel free to install one! I was just trying to make a small as possible rootfs, compared to 1.0.2's 1.2gig of stuff.

== My nubs don't work in 1.0.3! ==
Yes they do, I just didn't pre-configure them! Go to Preferences->Nubs and set them up yourself.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-03-26T22:01:58Z

Stuckie: Updated for 1.0.3 changes - the final "brute force" release

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''' This documents the final 1.0.3 "brute force" release. The 1.1 "debianized" release will take a while and not involve this process at all. '''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.3.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default User details are: 
username: '''pandora''' 
password: '''debian'''

== Little Note to Wiki Editors ==
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Changelog ==
=== Release 1.0 ===
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

=== Release 1.0.1 ===
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

=== Release 1.0.2 ===
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

=== Release 1.0.3 ===
* Effectively 1.0.2 with the WiFi and Session Management bug fixed.
* Much slimmer as it's done from scratch again without the dev setup ~805mb rootfs

== Release 1.1 Proposed ==
* libts, amongst other libraries, using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.
* Perhaps an updated kernel using the patches from mainline.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2/ext3 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself, or debootstrap from within Debian... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment ( Squeeze has e16 .. and is faster than I expected )
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

1.0.3 has slimmed stuff down again. 
Once in the chroot jail, I've performed the following: '''''aptitude install --without-recommends lxde-core slim lxterminal zenity less xserver-xorg-video-omap3 network-manager-gnome synaptic xfce4-power-manager apmd libnotify-bin gedit epiphany-browser eject gksu gnome-bluetooth python-dbus ca-certificates xinput busybox''''' which will effectively pull in all the Debian specifics we'll be needing, gutting out a rather large amount of cruft.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

1.0.3 does something else again.. it does not have the '''killall -1 pndnotifyd &''' line, instead it has the following:
sudo /etc/init.d/pndnotifyd-init restart
sudo /etc/init.d/pndevmapperd-init restart
And has edited /etc/sudoers.d/99_libpnd to add access to those two lines without being prompted for a password.

Should probably copy more over but, this'll do for now. 

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
==== Current 1.0.2/3 Release ====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

My values, which you should put into .xsession, are as follows: '''''xinput set-int-prop "touchscreen" "Evdev Axis Calibration" 32 3936 125 3873 183''''' and you'll need xinput installed ( which you should've done above if following the 1.0.3 path. )

==== libts for other releases ====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox if you haven't already, so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

=== Battery Monitor ===
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

=== Misc Init Scripts and Things ===
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

=== RC Scripts ===

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
==== rc0.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc1.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc2.d ====
ln -s ../init.d/led-config S05led-config

==== rc3.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc4.d ====
ln -s ../init.d/led-config S05led-config

==== rc5.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc6.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rcS.d ====
ln -s ../init.d/pandora-state S39pandora-state

We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

==== tslib calibration ====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

==== Finish up installing any left overs ====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install if your rootfs didn't have it. )

= Common Issues/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here! 
Also, sometimes there are odd issues, so if you fix something odd, place it here too.

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 and 1.0.3 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PNDs don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

1.0.3 does not have library compatibility as it caused extra issues in 1.0.2, you'll need to either wait for 1.1 or pull in the needed libraries yourself.

== Wifi and Session Management is broken?! ==
Pre-1.0.3 there was an issue with this.. it should now be fixed in 1.0.3 so if you don't want to update, perform the following:
'''''sudo rm -f /etc/udev/rules.d/70-persistent-net.rules''''' 
'''''sudo chmod +x /usr/lib/dbus-1.0/dbus-daemon-launch-helper''''' 
and reboot.. everything should now work properly.

== My PNDs don't appear immediately? ==
This is an odd one.. by rights they should.. and I also don't quite understand why pndnotifyd kicks in when you open a terminal, but it does.

Therefore, if you haven't done so already, open up a terminal and then close it.. pndnotifyd then starts up and takes care of all the PND stuff for you.

== I get no notifications in 1.0.3? ==
This is because there is no theme.. feel free to install one! I was just trying to make a small as possible rootfs, compared to 1.0.2's 1.2gig of stuff.

== My nubs don't work in 1.0.3! ==
Yes they do, I just didn't pre-configure them! Go to Preferences->Nubs and set them up yourself.

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-03-23T10:07:13Z

Stuckie: Updated to 1.0.2 process.. apologies to Xiloynaha for obliterating changes, I had too many of my own to try and sort out.

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

''''' This might be a bit iffy just now, I need to go through this and recheck some details.. use at your own risk... '''''

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.2.tar.bz2 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.2.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default User details are: 
username: '''pandora''' 
password: '''debian'''

== Little Note to Wiki Editors ==
I change this a lot offline and then plaster the changes on during a new release. 
If you're going to go changing this page, please contact me first so I don't accidentally obliterate your changes, or that you do changes to the style I've set out that I don't agree with! 
This may well be against the "wiki spirit" .. but I spend days/weeks typing up these changes and testing them.. so a little consideration please :)

== Changelog ==
=== Release 1.0 ===
* First release
* libts issues
* libpnd issues
* Overly fat with stuff
* Wifi issues for some people

=== Release 1.0.1 ===
* First documented release
* libts issues persist
* Most libpnd issues fixed
* Slimmed down to ~830mb
* Made Wifi issues worse and accidentally stripped out more than needed

=== Release 1.0.2 ===
* Replaced libts with evdev... doesn't cause X choking.
* libpnd should behave now, though the pnd services don't seem to get kicked till a terminal is opened, and even then they turn zombie.. eh?
* Added full dev setup.. so it's fat.. it's 1.2gig extracted.
* Replaced GDM with SLIM.

== Release 1.1 Proposed ==
* libts using OpenPandora patched version.
* Pandora specifics wrapped as Debian archives.
* Pandora specifics repo to deal with updates to drivers from mainline.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users, First Boot Scripts and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Additional: 
Installing LXDE via the above command pulls in GDM by default.. if you use ''lxde-core'' instead, it removes a lot of the stuff that pulls in random things, and if you additionally use '''''aptitude install --without-recommends lxde-core''''' it should strip out even more. You will need to manually install ''less'', ''zenity'', and ''xterm'' for example. Zenity is especially needed for all the Pandora config scripts.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 

After some fiddling, if you stick the following into ''.xsession'' it'll actually get called...
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &
exec startlxde

Of course, this is a bit hacky and hard-coded in that if you've chosen something other than lxde, you'll probably want to change that startlxde to something else!

1.0.2 does something really hacky and actually starts pndnotifyd and pndevmapperd as daemons directly. 
It also starts up the xfce4-power-manager for a battery meter.

Should probably copy more over but, this'll do for now. 

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
==== Current 1.0.2 Release ====
1.0.2 uses evdev instead of libts for the touchscreen. This doesn't really require any configuration for the most part, but does need to be calibrated. 
You'll need a full dev setup on the Pandora for this, as you'll need to compile the xinput_calibrator - http://www.freedesktop.org/wiki/Software/xinput_calibrator however it's fairly trivial once all the libraries are installed.

==== libts for other releases ====
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
This will be fixed properly when WiFi issues settle, so I can finalize a build system and re-do everything as packages - including libts with the OpenPandora-specific patches from the git.

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Debian's bluetooth setup seems to kick in and work without issue. 
Probably need to get a clean way to toggle it on and off - as it defaults to being on.

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

=== Battery Monitor ===
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd''''' 
''Debian'' '''''apt-get install xfce4-power-manager''''' 
Somewhat cheeky perhaps, but it does work! [http://www.gp32x.com/board/index.php?/topic/57653-a-guide-to-installing-lxde/page__view__findpost__p__928896 see this post]

If you add '''''xfce4-power-manager &''''' before '''''exec startlxde''''' in your .xsession, it'll start up automatically for you.

=== Misc Init Scripts and Things ===
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver 
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default''''' 
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default''''' 

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now, and clean up some stuff. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

=== RC Scripts ===

We also need to disable some things from running.. the first run script specifies the following: 
update-rc.d -f samba remove
update-rc.d -f xinetd remove
update-rc.d -f avahi-daemon remove
update-rc.d -f apmd remove
update-rc.d -f usb-gadget remove
update-rc.d -f banner remove
update-rc.d -f portmap remove
update-rc.d -f mountnfs remove
update-rc.d -f blueprobe remove
update-rc.d -f dropbear remove
update-rc.d -f wl1251-init remove

We'll also need to add some bits to the rc.d script set:
==== rc0.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc1.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rc2.d ====
ln -s ../init.d/led-config S05led-config

==== rc3.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc4.d ====
ln -s ../init.d/led-config S05led-config

==== rc5.d ====
ln -s ../init.d/led-config S05led-config
ln -s ../init.d/pndevmapperd-init S30pndevmapperd-init
ln -s ../init.d/pndnotifyd-init S30pndnotify-init

==== rc6.d ====
ln -s ../init.d/led-config K05led-config
ln -s ../init.d/pandora-state K31pandora-state
ln -s ../init.d/pndevmapperd-init K40pndevmapperd-init
ln -s ../init.d/pndnotifyd-init K40pndnotify-init

==== rcS.d ====
ln -s ../init.d/pandora-state S39pandora-state

We also need to fiddle with a few of the scripts - specifically led-config to add the dummy LSB information ( just rip it out of another script, and leave Required-Start, Required-Stop, Default-Start and Default-Stop empty, ) and pandora-state where you need to blank out the #adjust marker as it causes Debian to have fits.

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 
''Debian'' '''''usermod -a -G netdev <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

==== tslib calibration ====
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 

==== Finish up installing any left overs ====
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install! )

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The 1.0.1 release did not include Synaptic.. it's back in 1.0.2 
To get it back for the 1.0.1 release, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PND don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

1.0.2 has some library compatibility with Pandora Angstrom but it's not complete. The PNDs of Wesnoth and BattleJewels will work for example, whereas SuperTux and GravityForce do not.

Library compatibility was achieved by pulling packages manually from older revisions, symlinking some libraries and pulling stuff from experimental.. it was trial and error so, is a tad iffy.

[[Category:Documentation]] [[Category:Operating Systems]]

GLESGAE

2011-03-12T13:36:56Z

Stuckie: Added premade boot SD, and another warning about grabbing the latest rootfs

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =

== I'm Lazy, Give Me A Pre-Configured Thing! ==
Here you go: http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/zaxxon-premade-dev.tar.bz2 ~250mb

Extract to an ext2/3 formatted SD card, and boot. Simple!

== Tell Me What You Did ==
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs - though lately, these appear to be very out of sync between Pandora OE and Angstrom OE so be careful! 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg install libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

GLESGAE

2011-03-08T02:04:54Z

Stuckie: Adding third part - Event and Input Systems

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]
* [[GLESGAE:The Event and Input Systems]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs. 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

GLESGAE

2011-02-26T16:57:56Z

Stuckie: Adding link to part two.

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]
* [[GLESGAE:Setting Up A Window and Context]]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs. 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

User:Stuckie

2011-02-25T00:32:05Z

Stuckie: Adding GLESGAE link

I do scary dodgy hacks ;)

Homesite: [http://www.stuckiegamez.co.uk stuckieGAMEZ]

= Scary Hacks =
== Extend Utils ==
[[Extend Utils]] - The Extend Utils suite which allows loading of loop files for swap, overlays and OS extensions. 
== Debian on SD ==
[[Debian On SD]] - OS project to get Debian running on Pandora via SD card; maintaining all Debian and Pandora features. 

= Other Projects =
== GLESGAE ==
[[GLESGAE]] - GL ES Game Application Engine; an engine originally written for Pandora to aid in GL ES programming and porting to other capable devices. 
Not released as yet.

= Unmaintained Ports =
Unmaintained in the sense that, they've been released and work as far as I'm aware.. unless someone shouts at me otherwise, they'll stay that way! 
I'm also not directly keeping an eye on the original package for updates.
== MAXR ==
* Technically, this does work completely as intended as they only have multi-player running, and no single player.
* Might be tempted to upgrade it at some point if there's interest, and there's been an update since.

== MilkyTracker ==
* There was a bug report that an HF5 beta had issues with it... will test again once HF5 is final.

== SchismTracker ==
* Had no bug reports from it, I assume it's fine.

== gMPC ==
* There's a much better port than the one I quickly put together.

== gimp ==
* Very very quick and hacky port... really needs a rebuild properly.

== Bennu ==
* Have had zero feedback on this at all.. no idea if it even works right as I don't use the language so couldn't test properly.

= Package Site =
My packages can usually be found on http://www.stuckiegamez.co.uk/apps/pandora .. if linking to this, I'm "stuckie" not "stuckieGAMEZ" or any variation of!

= Contact Details =
Can be found in irc mostly... PM me if you don't get a response in a timely fashion, and I'll contact you when I'm around.

GLESGAE

2011-02-25T00:31:29Z

Stuckie: Fixed up links in Table of Contents.. ok they're on the same page, but it's the principle of the thing!

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE_Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine_Design_Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment_Setup Environment Setup]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs. 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

GLESGAE

2011-02-25T00:30:28Z

Stuckie: Initial Page for GLESGAE - tutorial/guide for building an engine for Pandora.

= GLESGAE - GL ES Game Application Engine =

GLESGAE is a vehicle for a series of tutorials on building a game engine for the Pandora console from scratch. 
I'm hoping to try and get this into a weekly series parts as time permits.

== Table of Contents ==
* [http://pandorawiki.org/index.php?title=GLESGAE#GLESGAE%20Overview GLESGAE Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Engine%20Design%20Overview Engine Design Overview]
* [http://pandorawiki.org/index.php?title=GLESGAE#Environment%20Setup Environment Setup]

= GLESGAE Overview =
To try not spam the wiki to death, I'll include the first two parts here, but subsequent parts will be in their own pages as they're more to deal with actual development problems rather than general overview stuff. 
Where possible, I'll also combine things if they're related to the last part that I did - IE: generating a window, and then adding ES contexts.

Originally, I was going to attempt to take part in the Platformer Homebrew Competition over on the OpenPandora boards. However, with free time being very limited, no engine to speak of, the need to do assets and that it's already been going a month so I'm a bit behind, I've decided to tackle a somewhat different challenge - build and document an engine, originally for Pandora and spawning out elsewhere later.

Yes, another engine.

I've been dragging my old SGZEngine around for quite a while now.. though it's never really got much further than it has, and it's full of weird quirks and bugs that with each project, I spend more time working around than writing actual logic. 
I did start another engine - SGEngine ( dropped the Z ) - however this was highly experimental in fobbing off every subsystem to a dynamically runtime loadable DLL to facilitate mix and matching bits and pieces. Especially useful for testing OpenGL and D3D renderers and a neat hack, but not much use as it was becoming highly complicated to do anything. 
This brings us to GLESGAE. The name being chosen due to me being Scottish, and it being an amusing mnemoic to begin with.

Recently, I've been doing a lot of Android programming. 
This involved writing a custom renderer for GLES1 and then onto GLES2. 
With my previous experience of writing such low level GL code being glBegin(); ... glEnd(); I effectively got thrown in at the deep end and had to fight a bit to stay afloat. However, I pulled through, and while furthering the work engine is always going to be appreciated by them; there's already a defined system of how things work, and I wanted to change a bit too much of that.. so a new personal engine it is; using the new found knowledge I've just gained.

So, with the introduction out of the way, this ( weekly, with any luck ) set of tutorials, guides and random gibberings on building an engine while I continue GLESGAE shall begin.

= Engine Design Overview =

Game Engines are somewhat of a necessary evil these days if you have any inclination of producing more than one game on a system, or one game on many systems.
However, there is also a very real danger of writing a solution for a non-existing problem - an engine without a game.
As such, I will be writing a game alongside this as well, to make sure that the engine does in fact have useful features.

The danger of writing an engine without a game in mind, is that you keep adding bits and pieces and end up not really getting anywhere. Which is exactly what happened with SGEngine. Lots of neat hacks, but it never really got anywhere, and it's a right pig to try and get working for anything serious now.
It was still a useful educational experience, as I learned how to deal with dynamic runtime libraries across Windows and *nix systems, as well as a more saner route for platform independent modules - SGZEngine essentially had a platform folder where all the code went, and interfaces and objects everywhere else. It wasn't particularly clean, even though it sounds like it should've been.

So what is an Engine? 
In the purest sense, it's a collection of generic functions that when wired up can help you create code much quicker. Generally, a Game Engine can pull in other Engines such as Rendering Engines, Audio Engines and Physics Engines - all tailor made for their own specific domains. 
As programmers we do tend to have the habit of being a bit ego-centric with an "I can rewrite the wheel better!" attitude. This can get us in to trouble at times! While I specifically want to deal with GL ES rendering on my own, I'll be pulling in OpenAL for audio and bullet or perhaps box2d for Physics; while trying to leave things open to be able to switch these out for something else at a later date.

This is therefore going to be a set of tutorials on building a Game Engine with a custom Graphics Engine in particular. 
However, a Game Engine isn't just Audio, Graphics and Physics - though these are by far the most interesting parts of a Game Engine.
You'll also generally need a set of utility functions that range from file I/O, input handling, event handling, memory management, resource management, and much more. 
You may also want to abstract logic out to a scripting engine; something I've a lot of experience with and quite fond of, so shall be pulling in Lua as well for this purpose.

While on PC development ( and by extension, Pandora ) you can generally get away with just new/malloc random things at any point and free/delete when necessary all over the place, certain consoles don't particularly like that and you're generally better off managing your own heap and memory pages so you know exactly where your memory is at any time, and can cache things yourself, rather than relying on anything that may or may not do what you expect.

File Management can also catch you unaware on other platforms. Android, for example, has a rather strict permission system whereby you only really have access to your own package, and the contents of the sdcard. Granted, Android 2.3 gives you more control, but if you're writing NDK apps for <2.3 you'll have to jump back and forth between Java and C where file management becomes a whole new game of fun.

And what about input? The Pandora has those nubs! those lovely lovely nubs, dpad, face buttons, shoulder buttons, touchscreen and a full keyboard! You've also got the possibility of godknows what connected via USB - game pads, mice, full-sized keyboards...

I won't even start about threading and the chaos that can bring... then there's networking, which is even worse!

Finally, there's the thought of how you organize data and feed it to your engine. 
These days, most engines follow a very data-driven design - and for good reason! You don't want to have to recompile half your codebase just for changing some NPC text, repositioning a graphic, loading a new model, etc.. GLESGAE is going to be data driven - and that also means tools that will be able to create the data to feed it, in the format that works best for the target platform. 
We shall be building these tools along the way too, and where possible, also having them run on the Pandora itself.

I'll cover more bits as we get to them.. for now, we'll get the Environment Setup.

= Environment Setup =
This weekend is essentially the overview and setup phase, so it's a bit boring I'm afraid. 
To keep everyone on the same page, I'm going to assume you're using Angstrom from an SD card, that you've installed GCC et al on it, and you'll be booting from it for development purposes.

This gives us a few benefits; 
* We are developing on the target hardware and can test things immediately.
* We can keep the NAND in a near enough vanilla state to ensure we don't accidentally pull in and use random libraries that not everyone will have.
* If we do something really bad, we've only messed up an SD card and can just re-extract the tarball and start again, rather than reflash the NAND!

If you've already got an SD card setup with dev tools, then you can leave class early and I'll see you next week. 
Same for if you have a preferred development environment already.. if it works for you, there's no point changing it. 
The rest of you, pay attention!

We'll do everything on the Pandora, to save having to deal with Linux, Windows, Mac, BSD, BeOS, whatever... madness. 
I advise at least grabbing yourself a 2Gig SD card.. go for a bigger card if you like, but 2Gig is probably a good minimum and are reasonably cheap these days. 

Grab your SD card and ensure everything you want from it has been removed - we're about to sacrifice it to the Pandora Dev Gods. 
Stick it in your left slot. 
Open up a terminal. 
You'll need to manually unmount it before going near it with cfdisk to repartition. 
'''''sudo umount /dev/mmcblk0p1''''' -- and possibly p2, p3, p# depending on how many partitions it has. Generally, it'll only have the one. 
'''''sudo cfdisk /dev/mmcblk0''''' -- this'll launch cfdisk on your card.. if you see more than one partition and you've only unmounted one partition, then quit and unmount them!

We want to delete all partitions on this card, so press right and then return to delete the current partition. 
Press up and down to move the selector if need be to remove the rest of them if you've more than one. 
Now we want to create a new partition, so with the Free Space selected, press right to highlight '''[ New ]''' and hit return, select '''[ Primary ]''', and let it use the full card ( just hit return. ) 
Press Left to highlight '''[ Write ]''' and press return. Type "yes" and hit return to confirm the changes, then '''[ Quit ]''' 
You could have added swap if you wanted.. it's up to you really. 

Now we have to format it. 
'''''sudo mkfs.ext2 /dev/mmcblk0p1'''''

Remove the card and reinsert so that the system re-reads the partition table correctly and gives you access to your newly formatted partition.

Now, we download the latest rootfs from OpenPandora.org and extract it to the card. We shall be lazy and stay in the terminal for this so... 
'''''cd /media/mmcblk0p1''''' 
'''''sudo su''''' -- we'll need to be root for this, as we'll have no permission by default to touch this card. 
'''''wget -c http://openpandora.org/firmware/pandora-rootfs.tar.bz2''''' - this grabs us the latest rootfs. 
'''''tar -xjpf pandora-rootfs.tar.bz2'''' -- you could add v to the arguments if you like.. it'll let you see what it's extracting and is slightly more exciting than just waiting for it to finish! The p is for preserving permissions, x to extract, j for bz2 support and f for file. 
'''''rm pandora-rootfs.tar.bz2'''''

We want the system to autoboot this when the card is inserted, so let's create autoboot.txt 
'''''nano autoboot.txt''''' 
Fill it with the following: 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0 0x80300000 /boot/uImage-2.6.27.46-omap1
bootm 0x80300000

That's us.. reboot and run through the First Time Configuration stuff, being sure to choose XFCE over MiniMenu, and then feel free to configure the look as you see fit.

Now the fun bit.

'''Warning''' - ''This is potentially dangerous as Angstrom and Pandora libraries may have gone off at tangents at this point... this is why we're doing this on an SD card rather than the NAND so if we stuff it up, we only need to reformat an SD card and not reflash the NAND!''

Make sure your Pandora is connected to the net by whatever means you have. 
Open up a terminal 
'''''sudo opkg update''''' 
'''''sudo opkg install gcc g++ make binutils-dev cpp cpp-symlinks g++-symlinks gcc-symlinks libstdc++-dev libgles-omap3-dev subversion''''' - You could install sdl etc.. too if you want, but that's all we'll be using for now; and you'll be needing subversion later to keep up with the project.

Now the ever popular Hello World. 
'''''mkdir Projects''''' 
'''''cd Projects''''' 
'''''nano main.cpp''''' 
#include <cstdio>

int main(void)
{
printf("Hello World!\n");

return 0;
}

'''''g++ -o main main.cpp''''' 
'''''./main''''' 

''' Interesting Gotcha ''' - '' In the rootfs I downloaded (HF5 RC1), ncurses hadn't been installed... '''sudo opkg libncurses5''' if you get "cannot open shared object file libncurses.so.5" when invoking nano.''

That's all for this week.. course you could go and install Geany, or whatever code editor you prefer. 
Next time, we shall be opening up a window via badgering X11 directly, and getting a GL ES context up and running.

[[Category:Development]] [[Category:Documentation]] [[Category:Tutorials]]

Games

2011-02-24T03:46:29Z

Stuckie: Fixed MAXR description ( it does have multi player ) and changed StuckieGamez to Stuckie

''These lists were last updated on 2011-02-18 to include the latest files from [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps], the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive], and the [[Games#Forums|community forums]]. For other software lists on the wiki, see [[Software projects]] and [[Emulator list]]'' for Unreleased games [[Unreleased]]

If different versions of a game were released, please make sure the "release date" is the most recent one when editing this article.

Please click on the little squares to sort by different categories (such as Genre, Release date, etc.)
==Games==
{|class="wikitable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: left;"
|- style="background: #ececec; text-align: center;"
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Genre
!MP1
!Download
!Notes
|-
|[[Abe's Amazing Adventure]]
|2010-11-25
|mcobit (port)
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,246 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57658-abes-amazing-adventure/ Discussion]
|-
|Abuse-SDL
|2010-06-26
|sebt3 (port)
|Shooter (Platform)
|
|[http://sebt3.openpandora.org/pnd/abuse.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54771-abuse-sdl/ Discussion]
|-
|Alien Blaster
|2010-06-27
|Alienblaster Team, Pickle (port)
|Top down Shooter
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,116 Archive]
|
|-
|Amoebax
|2010-10-10
|Safareig Creatiu, Àlex Almarza, Jordi Fita, sebt3 (port)
|Puzzle
|
|[http://sebt3.openpandora.org/pnd/amoebax.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55500-amoebax-and-pengupop/page__p__896822&#entry896822 Discussion][http://www.emma-soft.com/games/amoebax/ Website]
|-
|Angband
|2010-06-17
|Angband team, skeezix (port)
|RPG (Roguelike)
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,94 Archive]
|
|-
|Angry Drunken Dwarves
|2010-03-17
|Joe Wreschnig, EvilDragon (port)
|Puzzle
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/AngryDD.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,41 Archive]
|
|-
|ASCIIpOrtal
|2010-07-04
|Joe Larson, CME (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,132 Archive]
|
|-
|AudioRace 1.5
|2011-02-10
|crow_riot (port)
|Rhythm / Puzzle
|
|[http://katzl.riot.org/pnd/beta/audiorace-1.5-pnd.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/58591-audiorace-1-5/ Discussion]
|-
|Ballgame HD ('''beta''')
|2010-10-25
|RomanH, Pixitu
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,227 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57180-ballgame-hd/ Discussion]
|-
|[[Battle for Wesnoth]] v1.8.5-1
|2010-09-26
|Ivanovic (port)
|Strategy
|N+S
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,25 Archive] [http://sourceforge.net/projects/wesnoth/files/wesnoth-1.8/wesnoth-1.8.5/wesnoth-1.8.5-1.pnd/download Download]
|[http://www.gp32x.com/board/index.php?/topic/55033-battle-for-wesnoth-1-8-3/ Discussion]; stable series
|-
|[[Battle for Wesnoth]] v1.9.4-1
|2011-01-15
|Ivanovic (port)
|Strategy
|N+S
|[http://sourceforge.net/projects/wesnoth/files/wesnoth/wesnoth-1.9.4/wesnoth-1.9.4-1.pnd/download Download]
|[http://www.gp32x.com/board/index.php?/topic/55033-battle-for-wesnoth-1-8-3/ Discussion]; development series
|-
|BattleJewels
|2010-03-29
|Skeezix, codejedi
|Puzzle
|x
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/battlejewels20100329.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,48 Archive]
|
|-
|Beat2X
|2010-06-26
|PokeParadox (port)
|Rhythm
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/beat2x.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,105 Archive]
|
|-
|Bejeweled ('''beta''')
|2010-10-24
|sebt3 (port)
|Puzzle
|
|[http://sebt3.openpandora.org/pnd/bejeweled.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57167-bejeweled/ Discussion]
|-
|Biniax 2
|2010-07-18
|zx-81 (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,160 Archive]
|[http://www.gp32x.com/board/index.php?/topic/55349-pandora-biniax2-biniax2-for-pandora-v130 Discussion]
|-
|BlobWars v2 ('''beta''')
|2010-07-21
|Sigma.NL
|Strategy
|
|[http://www.mediafire.com/file/s5eb33gdkv88d3r/blobwars-v2.tar Download]
|[http://www.gp32x.com/board/index.php?/topic/55339-testing-blobwars-soulfu Discussion]
|-
|Blocks of the Undead
|2011-01-08
|mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,270 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58134-blocks-of-the-undead/ Discussion]
|-
|BomberClone
|2010-07-13
|BomberClone Team
|Arcade
|Net
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,149 Archive]
|Bomberman clone
|-
|Bos Wars
|2010-07-20
|bompo (port)
|Strategy - real time
|
|[http://dl.dropbox.com/u/39448/pandora/boswars.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55413-bos-wars/ Discussion]
|-
|Boxbot4K
|2010-07-10
|rcarvall
|Puzzle
|
|[http://www.pandorasource.de/download.php?view.154 Download]
|[http://www.dcc.uchile.cl/~rcarvall/juegos/index.html Website] Like Sokoban
|-
|Briquolo
|2011-02-08
|cbr, paeryn (port), sebt3 (port), Pickle (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,314 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58596-briquolo/ Discussion] [http://briquolo.free.fr/en/ Website]
|-
|Bubble Chains ('''beta''')
|2010-10-31
|sebt3 (port)
|Arcade
|
|[http://sebt3.openpandora.org/pnd/bubble_chains.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57290-bubble-chains/ Discussion]
|-
|BubbMan 2 ('''beta''')
|2011-01-10
|pymike, Tempel (port)
|Platformer
|
|[http://randy.heydon.selfip.net/extra/BubbMan2.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,266 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58096-bubbman-2/ Discussion] {{HideableNotes|Default set at 700Mhz, but may work well at lower speeds}}
|-
|C-Dogs
|2010-03-17
|Lumaki, Pickle (port)
|Top down Shooter
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/CDogs.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,42 Archive]
|
|-
|Ceferino
|2010-06-23
|Don Ceferino Hazaña
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,103 Archive]
|Pang remake
|-
|Chuckie Egg
|2010-08-29
|Paul Brook
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,197 Archive]
|Clone of the 8-bit game
|-
|Circus Linux
|2010-07-20
|daniel3000 (port)
|Arcade
|SS
|[http://www.hermocom.com/en/downloads/openpandora/Circuslinux.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55407-circuslinux-pnd-available/ Discussion] Circus Atari clone
|-
|Classic Invaders
|2011-01-20
|Todd Steinackle, Gareth Francis (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,277 Archive]
|Space Invaders clone
|-
|Clonk2x (Clonk Planet)
|2010-07-12
|Pickle (port)
|Strategy
|N+C?
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,148 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/clonk2x.inf Apps]
|[http://www.clonk.de/ Website] [http://www.gp32x.com/board/index.php?/topic/55175-clonk-rage/ Discussion]
|-
|Color Lines
|2010-10-24
|sebt3 (port)
|Puzzle
|
|[http://sebt3.openpandora.org/pnd/ColorLines.pnd Download]
|
|-
|Crimson Fields (pandora 0.2.1, general 0.5.3)
|2010-09-14
|MarkoeZ (port)
|Strategy
|N+S
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,203 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56583-crimson-fields-for-pandora/ Discussion]
|-
|CromoZome
|2010-08-13
|PokeParadox
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/CromoZome.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,183 Archive]
|[http://projectinfinity.org.uk/doku.php?id=homebrew:games:cromozome Website]
|-
|Daimonin 0.10.1 (B5)
|2010-08-15
|joseluisjazz (port)
|MMORPG
|Net
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/daimonin-0.10.1-Os.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/55979-daimonin-mmorpg/ Discussion]
|-
|Deathtrap Remix
|2010-06-21
|Mindlord
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/deathtrap.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,100 Archive]
|
|-
|Defendguin 0.0.12
|2010-10-20
|Yamara (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,225 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57117-defendguin/page__gopid__922761&#entry922761 Discussion] Defender clone
|-
|Defendguin ('''beta''')
|2010-09-07
|darfgarf (port)
|Arcade
|
|[http://localhostr.com/files/ac44cb/defendguin.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/187-defendguin/ Discussion] Defender clone
|-
|Dink Smallwood ('''outdated''')
|2010-07-31
|WizardStan (port)
|RPG
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/freedink.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58637-dink-smallwood/ Discussion]. No music.
|-
|Dink Smallwood
|2011-02-11
|Cobalt (port)
|RPG
|
|[http://www.megaupload.com/?d=DJMDE2VJ Download]
|[http://www.gp32x.com/board/index.php?/topic/58637-dink-smallwood/page__view__findpost__p__938931 Discussion]. This has proper controls and music.
|-
|Donkey Bolonkey
|2011-01-17
|mcobit (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,275 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58252-donkey-bolonkey/ Discussion] clone of Rat Poker
|-
|Eat the Whistle
|2010-05-25
|Pickle (port)
|Sports
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Etwhistle.inf Apps]
|
|-
|eboard with GNUChess
|2010-06-29
|
|Chess
|N+S
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,121 Archive]
|Internet play allowed
|-
|Elemental 0.2
|2010-07-17
|Chaosmage
|Sandbox
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/elemental.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/55303-elemental-0-2-released/ Discussion]
|-
|Enigma 1.01
|2010-08-08
|Whynodd
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,174 Archive]
|[http://www.nongnu.org/enigma/ Website]
|-
|FishFillets
|2010-08-09
|zx-81 (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,179 Archive]
|
|-
|Flare
|2011-01-25
|sebt3 (port)
|RPG
|
|[http://sebt3.openpandora.org/pnd/flare.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58356-flare/ Discussion]
|-
|Formido
|2011-01-22
|sebt3 (port)
|Arcade
|
|[http://sebt3.openpandora.org/pnd/formido.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58322-formido/ Discussion]
|-
|FreeCiv 2.1.9
|2010-05-31
|Cpasjuste (port)
|Strategy
|Net
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,77 Archive]
|[http://freeciv.wikia.com/wiki/Main_Page Wiki]
|-
|Frogatto and Friends
|2011-02-08
|Pickle (port)
|Platformer
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,312 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58558-frogatto-and-friends/ Discussion]
|-
|Fy.WoD! 2.1
|2010-11-25
|Scntrblob
|Racing
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,28,247 Archive]
|
|-
|Game & Watch Simulators
|2010-07-27
|Hitnrun
|Arcade
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,3,169 Archive]
|Not an emulator.
|-
|Game Editor ('''beta''')
|2011-02-06
|WizardStan (port)
|Engine
|
|[http://rebirthofxeen.com/files/pandora/gameEditor.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58562-game-editor/ Discussion]. No sound, slow. {{HideableNotes|Get game files [http://game-editor.com/Games here]}}
|-
|GAV (GPL Arcade Volleyball)
|2010-06-30
|
|Sports
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,36,122 Archive]
|
|-
|Giana's Return v1.0
|2011-01-01
|Gianas Team Pickle (port)
|Platformer
|
|[http://www.gianas-return.de/gr-v10-pandora.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,60 Archive]
|[http://www.gianas-return.de/ Website] [http://www.gp32x.com/board/index.php?/topic/58054-gianas-return-v10-pandora Discussion]
|-
|Globulation 2 (Glob 2)
|2011-01-24
|sebt3 (port)
|Strategy
|
|[http://sebt3.openpandora.org/pnd/glob2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58325-glob2/ Discussion]
|-
|Gnome Games
|2010-10-11
|sebt3 (packaging)
|Compilation
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,37,221 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56993-gnome-games/ Discussion]
|-
|GNU Robbo
|2011-01-22
|mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,280 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58318-gnu-roboo/ Discussion]
|-
|GNUGo (ccGO + CGoban)
|2011-01-20
|mcobit (port)
|Board
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,276 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58281-ccgo-gnugo/ Discussion] {{HideableNotes|Port of GNU Go with the frontends ccGO and CGoban}}
|-
|Gravity Force Remake
|2011-02-05
|David Douglas
|Action
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,72,310 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58546-gravity-force-remake/ Discussion]
|-
|Gwelled
|2011-01-26
|sebt3 (port)
|Puzzle
|
|[http://sebt3.openpandora.org/pnd/gweled.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58354-gweled/ Discussion]
|-
|Hex-A-Hop
|2011-01-27
|mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,286 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58401-hex-a-hop/ Discussion].
|-
|Infector
|2011-01-06
|mcobit (port)
|Puzzle
|Net
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,268 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58110-infector/ Discussion]
|-
|Jag ('''beta''')
|2010-10-31
|sebt3 (port)
|Arcade
|
|[http://sebt3.openpandora.org/pnd/jag.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57289-jag/ Discussion]
|-
|Jump n Blob
|2011-01-10
|[http://www.2d-rp.de 2d Retroperspectives]
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,271 Archive]
|
|-
|Kde games ('''beta''')
|2010-07-28
|sebt3 (port)
|Various
|SS?
|[http://sebt3.openpandora.org/pnd/kde-games.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55569-kde-games/ Discussion]
|-
|KETM (Kill Everything That Moves)
|2010-11-10
|sebt3 (port)
|Top Down Shooter
|x
|[http://sebt3.openpandora.org/pnd/ketm.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54577-ketm/page__view__findpost__p__925774 Discussion]
|-
|King of Fighters (KOF): Flames of Courage
|2011-01-29
|mth411 (port)
|Fighting
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,40,290 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58446-kof-king-of-fighters-on-pandora/ Discussion]
|-
|Kobo Deluxe
|2011-01-06
|David Olofson, mcobit (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,267 Archive]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/58109-kobo-deluxe/ GP32X] [http://boards.openpandora.org/index.php?/topic/928-kobo-deluxe/ OP] Music doesn't work yet
|-
|Lbreakout2
|2010-06-23
|Michael Speck
|Arcade
|Net
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,104 Archive]
|[http://lgames.sourceforge.net/index.php?project=LBreakout2 Website]
|-
|LemmingsSDL ('''beta''')
|2010-11-20
|Miner49er
|Puzzle
|Net?
|[http://lessermatters.homeunix.com/LemmingsSDL/lemmings.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/51581-lemmingssdl-networked/page__st__135__p__928674&#entry928674 Discussion]
|-
|LettersFall
|2011-01-31
|16Bitsoft, Pickle (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,292 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58464-3-games-from-16bitsoft/ Discussion] spell words as fast you can
|-
|L'hôpital Pital
|2010-11-23
|mcobit (port)
|Strategy - tower defense
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,245 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57648-lhopital-pital/ Discussion]
|-
|LMarbles
|2010-07-18
|MarkoeZ (port), daniel3000 (2nd port)
|Puzzle
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,162 MarkoeZ] [http://www.hermocom.com/en/downloads/openpandora/LMarbles.pnd/ daniel3000]
|[http://lgames.sourceforge.net/ Website], [http://www.gp32x.com/board/index.php?/topic/55353-lgames-ltris-lpairs-lmarbles-available/ Discussion] (this game was ported twice)
|-
|The Lonely Tower v2.2
|2010-11-19 2010-01-12
|Tempel
|?
|
|[http://randy.heydon.selfip.net/Programs/The%20Lonely%20Tower/V2/The%20Lonely%20Tower-2.2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/51441-the-lonely-tower/ Discussion]. The first Pandora game.
|-
|LPairs
|2010-07-18
|daniel3000 (port)
|Puzzle
|
|[http://www.hermocom.com/en/downloads/openpandora/LPairs.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55353-lgames-ltris-lpairs-lmarbles-available/ Discussion] Memory game
|-
|LTris
|2010-07-18
|daniel3000 (port)
|Arcade
|
|[http://www.hermocom.com/en/downloads/openpandora/LTris.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55353-lgames-ltris-lpairs-lmarbles-available/ Discussion] Tetris clone
|-
|The Mana World
|2010-09-06
|Cpasjuste (port)
|MMORPG
|Net
|[http://mydedibox.fr/pandora/pnd/cpasjuste.tmw-0.0.29.1-1.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56506-the-mana-world-mmorpg/ Discussion]
|-
|The Maze Of Galious Remake
|2011-02-11
|Dimacus (port)
|Platformer
|
|[http://luminare.no-ip.org/files/mog.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58606-the-maze-of-galious-remake-port/ Discussion]
|-
|MAXR ( M.A.X Reloaded )
|2010-08-31
|Stuckie (port)
|Turn Based Strategy
|Net
|[http://www.stuckiegamez.co.uk/apps/pandora/maxr.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56403-m-a-x-reloaded/ Discussion]
|-
|Meritous
|2010-12-07 2010-06-25
|EvilDragon (2nd port) TJ Hooka (port)
|Dungeon Crawler
|
|'''[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,256 ED's port]''' [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/meritous.inf Hooka's port]
|[http://www.gp32x.com/board/index.php?/topic/57725-meritous/page__gopid__928726&#entry928726 Discussion] ED's port [http://www.gp32x.com/board/index.php?/topic/57725-meritous/page__view__findpost__p__929360 doesn't crash] (hopefully)
|-
|Mirror Magic
|2010-08-14
|Holger Schemel
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,184 Archive]
|[http://www.artsoft.org/mirrormagic Website]
|-
|Monkey Bubble v0.4.0
|2010-12-03
|Laurent Belmonte mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,257 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57733-monkey-bubble/ Discussion] Like "Bubble Bobble"
|-
|N-Speed
|2011-01-28
|Sami Kyöstilä, Tommi Inkil, Joonas Kerttula, mcobit (port)
|Racing
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,28,289 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58421-n-speed/ Discussion]
|-
|Numpty Physics
|2010-06-15
|Tim Edmonds, Thomas Perl, Manolis (port)
|Drawing
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,93 Archive]
|
|-
|openBOR
|2010-06-26
|Senile Team, Pickle (port)
|Beat 'em up
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,40,111 Archive]
|Beats of Rage
|-
|OpenGlad
|2010-05-09
|Snowstorm Entertainment, Pickle (port)
|Strategy
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/OpenGlad.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,57 Archive]
|
|-
|OpenLieroX
|2010-07-09
|Pickle (port)
|Shooter (Worms-like)
|Net
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,140 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/OpenLieroX.inf Apps]
|[http://www.openlierox.net/ Website] [http://www.gp32x.com/board/index.php?/topic/55168-rise-of-the-triad-openlierox-alpehone/ Discussion] [http://www.gp32x.com/board/index.php?/topic/55132-openlierox/ Discussion (2)]
|-
|openPirates 0.0.0.2
|2010-07-03
|Pickle (Scott Smith)
|Strategy
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,109 Archive]
|[http://www.gp32x.com/board/index.php?/topic/54773-openpirates/ Discussion]
|-
|OpenTTD (Transport Tycoon)
|2010-06-25
|OpenTTD team, MistaGiggles (port)
|Simulation
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,107 Archive]
|[http://www.gp32x.com/board/index.php?/topic/54734-openttd-port/page__gopid__882049&#entry882049 Discussion]
|-
|OpenTTD 1.0.5 (Transport Tycoon)
|2011-01-24
|OpenTTD team, steven@starmice.net (port)
|Simulation
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,284 Archive]
|
|-
|OpenTyrian v1.1
|2010-07-14
|zx-81 (port)
|Top down Shooter
|
|[http://zx81.zx81.free.fr/public/pandora/opentyrian/opentyrian-v1.0-pnd.zip Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,155 Archive]
|[http://zx81.zx81.free.fr/serendipity/index.php?/archives/432-Pandora-OpenTyrian-OpenTyrian-ported-to-Pandora-v1.0.html Announcement]
|-
|PacDudeHero 2
|2011-01-31
|16Bitsoft, Pickle (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,291 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58464-3-games-from-16bitsoft/ Discussion] Pacman clone
|-
|Paintown
|2011-01-24
|Jon Rafkind, sebt3 (port)
|Fighting
|
|[http://sebt3.openpandora.org/pnd/paintown.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58326-paintown/ Discussion]
|-
|Pandora Panic
|2010-06-11
|PokeParadox / GP32X Community
|Arcade
|x
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/PPanic.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,59 Archive]
|
|-
|Pandora Pool Panic
|2010-07-27
|Unfathomable Depths
|Sports
|
|[http://www.fileden.com/files/2008/6/27/1978308//PoolPanic.pnd Download (zip)]
|[http://www.gp32x.com/board/index.php?/topic/46996-pandora-pool-panic-beta/page__view__findpost__p__897564 Discussion]
|-
|Pandora X-pilot NG 4.7.3
|2010-08-18
|zx-81 (port)
|Arcade
|Net
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/xpilot-ng-4.7.3.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,37,192 Archive]
|[http://xpilot.sourceforge.net/ Website]
|-
|Pandora-Acm
|2010-08-10
|zx-81 (port)
|Simulator
|Net?
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,37,180 Archive]
|Flight simulator
|-
|Pandora-Blockrage
|2010-07-18
|zx-81 (port)
|Puzzle
|x
|[http://zx81.zx81.free.fr/public/pandora/blockrage/pandora-blockrage-v0.2.3-pnd.zip Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,161 Archive]
|[http://blockrage.sourceforge.net/ Website] [http://www.gp32x.com/board/index.php?/topic/55343-pandora-blockrage-block-rage-for-pandora-v0-2-3 Discussion]
|-
|Pandora-Lopan
|2010-07-13
|zx-81 (port)
|Puzzle
|x
|[http://zx81.zx81.free.fr/public/pandora/lopan/pandora-lopan-v1.0-pnd.zip Download]
|[http://zx81.zx81.free.fr/serendipity/index.php?/archives/430-Pandora-Lopan-Mahjong-game-for-Pandora-v10.html Announcement]
|-
|PandoraNetPuzzle (WiiNetPuzzle)
|2011-02-14
|chris_c
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,235 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57446-wiinetpuzzle/ Discussion]
|-
|Pandora-OpenSonic
|2010-08-13
|zx-81 (port)
|Platformer
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/opensonic-v1.3.0.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,187 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56005-pandora-opensonic-sonic-clone-for-pandora-v13/ Discussion][http://zx81.zx81.free.fr/ Website]
|-
|Pandora-Ri-Li v2.0.1
|2010-08-17
|zx-81 (port)
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/ri-li-v2.0.1.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,190 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58370-ri-li/ Discussion]
|-
|Pandora-Simutrans
|2010-08-29
|zx-81
|Simulation
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,198 Archive]
|Transportation simulation
|-
|Pandora-Tombstone
|2010-07-17
|zx-81 (port)
|Arcade
|x
|[http://zx81.zx81.free.fr/public/pandora/tombstone/pandora-tombstone-v1.0-pnd.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/55318-pandora-tombstone-tombstone-city-for-pandora-v10/ Discussion]
|-
|PandyWordSeek ('''beta''')
|2010-07-14
|authoreyes
|Puzzle
|x
|[http://www.markandmarina.com/code/pandywordseek.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55263-quick-personal-update-and-a-new-homebrew-pnd/ Discussion]
|-
|Panjoust (demo)
|2010-10-05
|MarkoeZ
|Platformer
|x
|[http://kenai.com/projects/panjoust/downloads/download/Panjoust05-10-10Windowsand%2520Pandora.rar Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/55107-panjoust-001-released/] [http://www.gp32x.com/board/index.php?/topic/56909-panjoust-new-beta/]
|-
|Pasang Emas
|2011-01-15
|mcobit (port)
|Puzzle
|SS?
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,274 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58221-pasang-emas/ Discussion] Board game
|-
|Penguin Command
|2010-10-01
|Karl Bartel
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/penguin-command.inf Apps]
|Missile Command clone
|-
|PenguinZombiesPandora (SDLZombies)
|2010-07-29
|MarkoeZ (port)
|Arcade
|
|[http://apps.openpandora.org/cgi-bin/viewapp.pl?/Game/sdlzombies.inf Apps]
|
|-
|PenguPop 2.2.4
|2010-07-24
|Junoplay, sebt3 (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,166 Archive]
|[http://www.gp32x.com/board/index.php?/topic/55500-amoebax-and-pengupop/page__p__896822&#entry896822 Discussion]
|-
|Pingus
|2010-08-08
|joseluisjazz (port)
|Arcade
|
|[http://apps.openpandora.org/cgi-bin/viewapp.pl?/Game/pingus-0.7.3-Os-upx.inf Apps]
|Lemmings-like game
|-
|PipePanic
|2011-01-27
|mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,285 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58396-pipepanic/ Discussion].
|-
|Pocket Volleyball
|2011-01-21
|mcobit (port)
|Sport
|SS
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,36,278 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58301-pocket-volleyball/ Discussion]
|-
|Police4K
|2010-07-10
|rcarvall
|Shooter
|
|[http://www.pandorasource.de/download.php?view.155 Download]
|[http://www.dcc.uchile.cl/~rcarvall/juegos/index.html Website]
|-
|Powder
|2010-08-09
|joseluisjazz (port)
|RPG (Roguelike)
|
|[http://apps.openpandora.org/cgi-bin/viewapp.pl?/Game/powder-114-Os-upx-pandora.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,253 Archive]
|
|-
|PowerManga v1.0.1
|2010-11-20
|chris_c (port)
|Top-down shooter
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,236 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57648-lhopital-pital/ Discussion]
|-
|Pushover
|2010-10-31
|Farox (port)
|Puzzle
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,231 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57298-pushover/ Discussion] Resolution too big for screen.
|-
|Pushover v0.2
|2010-11-06
|zx-81 (port)
|Puzzle
|x
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/pushover-0.2.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/57386-pandora-pushover-pushover-for-pandora-v02/ Discussion]. No speed throttling.
|-
|PyDance ('''beta''')
|2010-08-31
|darfgarf (port)
|Dance
|
|[http://localhostr.com/files/397bff/pydancebeta%201.zip Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/56418-pydancebeta1/] [http://www.gp32x.com/board/index.php?/topic/56293-anki-friendly-intelligent-flashcards/]
|-
|QNetWalk
|2010-06-29
|sebt3 (port)
|Puzzle
|
|[http://sebt3.openpandora.org/pnd/qnetwalk.pnd Download]
|
|-
|Racer
|2010-10-30
|sebt3 (port)
|Racing
|SS
|[http://sebt3.openpandora.org/pnd/racer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,28,230 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57189-racer/ Discussion]
|-
|Rafkill
|2011-01-26
|Jon Rafkind, sebt3 (port)
|Top-down Shooter
|
|[http://sebt3.openpandora.org/pnd/rafkill.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58185-rafkill/ Discussion]
|-
|Reign of Brains
|2011-01-16
|emil10001
|Arcade
|
|[http://feigdev.com/ReignOfBrains.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,262 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57910-reign-of-brains-demo/ Discussion]
|-
|Rezerwar
|2011-01-23
|mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,282 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58335-rezerwar/ Discussion]. Configure keys in game options.
|-
|Reword
|2010-07-17
|PurplePup
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,159 Archive]
|[http://www.gp32x.com/board/index.php?/topic/55327-reword-0-5-1-released/ Discussion]
|-
|Road Fighter
|2011-02-08
|Dimacus (port)
|Racing
|
|[http://luminare.no-ip.org/files/roadfighter.pnd Download] [http://pandorapress.net/gruso/roadfighter.pnd Download (mirror)]
|[http://www.gp32x.com/board/index.php?/topic/58557-port-requiest-road-fighterrr/ Discussion]
|-
|Rocks 'n' Diamonds
|2011-02-09
|Holger Schemel, Blue Ion (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,189 Archive]
|[http://www.artsoft.org/rocksndiamonds/ Website] Like Boulder Dash, Emerald Mine, Supaplex, Sokoban
|-
|Scarecrow Tobias ('''beta''')
|2011-01-16
|MUMBL35, Paramultart
|Platformer
|
|[http://www.mediafire.com/?e3zyu4lmhszz9p6 Download]
|[http://www.gp32x.com/board/index.php?/topic/58228-side-scroller-engine/ Discussion] {{HideableNotes|MUMBL35 wants to use the engine to create another game, but would like an artist & coder to help him finish}}
|-
|SDL-Ball
|2011-02-16
|paeryn (port)
|Arcade
|
|[http://paeryn.myby.co.uk/pandora/sdl-ball.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,322 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58686-sdl-ball/ Discussion]
|-
|SdlZombies
|2010-07-14
|Philippe Brochard, MarkoeZ (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,154 Archive]
|
|-
|Shane's Chess Information Database (SCID)
|2010-06-27
|Shane Hudson, Pascal Georges
|Chess
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,112 Archive]
|
|-
|Snowball
|2010-07-09
|willikappler
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,142 Archive]
|[http://www.snowball.retrovertigo.de/ Website]
|-
|SolarWolf v1.5
|2010-11-27
|Magic Sam (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,252 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57694-solarwolf-for-the-pandora/ Discussion]
|-
|Sopwith
|2011-01-24
|Jon Rafkind, sebt3 (port)
|shmup
|
|[http://sebt3.openpandora.org/pnd/sopwith.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58350-sopwith/ Discussion]
|-
|Sound Fall
|2010-06-21
|Chris Thompson
|Sound
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,101 Archive]
|
|-
|Sparks v0.4.5 ('''beta''')
|2010-12-04
|hal9000
|Shooter
|
|[http://julien.carme.free.fr/sparks/Sparks-0.4.5.pnd Download]
|Discussion: [http://boards.openpandora.org/index.php?/topic/745-sparks/ OP] [http://www.gp32x.com/board/index.php?/topic/57765-sparks/ GP32X] [http://www.gp32x.com/board/index.php?/topic/57148-sparks-a-vectorial-shooter/page__view__findpost__p__928922 GP32X (old)] May need [[overclocking]] to ~800Mhz
|-
|Spout
|2010-07-08
|PokeParadox (port)
|Shooter
|
|[http://projectinfinity.org.uk/lib/exe/fetch.php?media=homebrew:games:spout:downloads:spout.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,136 Archive]
|[http://projectinfinity.org.uk/doku.php?id=homebrew:games:spout Website] [http://www.gp32x.com/board/index.php?/topic/55143-spout-1-0-released/ Discussion]
|-
|Sqrxz
|2010-09-10
|Pickle (port)
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,144 Archive]
|[http://www.sqrxz.de/?p=171 Website] [http://www.gp32x.com/board/index.php?/topic/55157-sqrxz-v0-9-9 Discussion]
|-
|Sqrxz 2
|2011-01-03
|Pickle (port)
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,265 Archive]
|[http://www.sqrxz2.de/ Website] [http://www.gp32x.com/board/index.php?/topic/58078-sqrxz-2-v080-pandora/ Discussion]
|-
|Sudoku (fltk)
|2011-01-14
|chris_c (package)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,272 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58199-sudoku-fltk/ Discussion]
|-
|Super Mario War 1.7 April Fools Edition
|2010-08-18
|Pickle (port)
|Fighting
|Net?
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,191 Archive]
|[http://smw.72dpiarmy.com/ Website]
|-
|Super Methane Bros.
|2010-08-26
|Mark Rombust
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,195 Archive]
|[http://methane.sourceforge.net/ Website] Runs with [[Ginge]]
|-
|SuperTux
|2011-01-27
|Pickle (port), EvilDragon (port)
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,73 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58343-supertux/ Discussion]
|-
|TecnoballZ
|2011-01-16
|sebt3 (port)
|Arcade
|
|[http://sebt3.openpandora.org/pnd/tecnoballz.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58236-tecnoballz/ Discussion] Ported from Amiga
|-
|Teeworlds
|2010-07-19
|bompo (port)
|Fighting
|Net?
|[http://dl.dropbox.com/u/39448/pandora/teeworlds.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55374-teeworlds Discussion]
|-
|TetriCrisis 3 100% CPU
|2011-01-31
|16Bitsoft, Pickle (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,293 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58464-3-games-from-16bitsoft/ Discussion] Needs overclocking
|-
|Thruster 1.3
|2010-07-15
|Vilmos, PokeParadox (port)
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Thruster.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,156 Archive]
|[http://www.gp32x.com/board/index.php?/topic/55288-thruster-1-3-released/ Discussion]
|-
|TicTacToe From Hell
|2010-12-01
|Simone Tobia mcobit (port)
|Puzzle
|N+S
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,255 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57718-tictactoe-from-hell/ Discussion]
|-
|Tile World
|2010-07-12
|zx-81 (port)
|Puzzle
|
|[http://zx81.zx81.free.fr/public/pandora/tworld/pandora-tworld-v1.3-pnd.zip Download] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/tworld-13.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/55211-pandora-tworld-tile-world-for-pandora-v13/ Discussion] fan remake of Chip's Challenge
|-
|Tombstone
|2010-07-17
|zx-81 (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,157 Archive]
|
|-
|Tower Toppler
|2011-01-07
|mcobit (port)
|Arcade
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,269 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58124-tower-toppler/ Discussion] Nebulous/Castelian clone
|-
|Triplane Classic
|2010-08-02
|Markku, Teemu, Henri
|Arcade
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/triplane-classic-1.04.01.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/55736-triplane-classic/ Discussion]
|-
|Tubularix v0.5.1.5
|2010-12-03
|Miguel Scudero mcobit (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,258 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57738-tubularix/ Discussion]
|-
|Tux Football
|2011-01-22
|mcobit (port)
|Sport
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,36,281 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58319-tux-football/ Discussion]. Configure keys in game options.
|-
|TuxRace ('''beta''')
|2010-10-24
|sebt3 (port)
|Racing
|
|[http://sebt3.openpandora.org/pnd/tuxrace.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57209-tuxrace/ Discussion]
|-
|VoR (Variations on Rockdodger)
|2011-01-21
|mcobit (port)
|Arcade
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,27,279 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58303-vor-variations-on-rockdodger/ Discussion]
|-
|Wall Defender
|2010-07-06
|ElLun3s
|Arcade
|
|[http://www.pandorasource.de/download.php?view.151 Download]
|[http://code.google.com/p/walldefender/ Website] Requires Java.pnd
|-
|Wind and Water: Puzzle Battles
|2011-02-07
|Yuan Works (Ginge wrap by Coldbird)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,313 Archive]
|GP2X Wiz version running under Ginge. Select scale ratio with launcher
|-
|Wormux 0.2.9.1
|2010-07-17
|Pickle (port)
|Strategy
|N+S
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,158 Archive]
|[http://www.gp32x.com/board/index.php?/topic/55321-wormux-0-2-9-1/ Discussion]
|-
|xLinCity
|2010-07-28
|Peters, Sharp, Keasley
|Strategy
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9,170 Archive]
|[http://lincity.sourceforge.net/ Website]
|-
|XRick
|2010-07-22
|MarkoeZ (port)
|Platformer
|x
|[http://apps.openpandora.org/cgi-bin/viewapp.pl?/Game/xrick.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,165 Archive]
|[http://bigorno.net/xrick/ Website] [http://www.gp32x.com/board/index.php?/topic/55449-xrick-for-pandora Discussion]
|-
|xscorch (Scorched Earth)
|2010-06-30
|Justin/Jacob, Pickle (port)
|Strategy
|SS
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,152 Archive]
|
|-
|Zaz
|2011-02-21
|sebt3 (port)
|Puzzle
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,25,325 Archive]
|
|-
|Zelda 3T
|2010-11-15
|Vincent Jouillat, sebt3 (port)
|RPG
|x
|[http://sebt3.openpandora.org/beta/Zelda3T_US.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54633-zelda-kind-of/ Discussion] Hardware scaling version (software scaling works slow in one section)
|-
|Zelda Classic 2.11B18 0.3alpha
|2010-08-16
|Hitnrun (port)
|RPG
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,188 Archive]
|
|-
|Zelda OLB
|2010-11-10
|Vincent Jouillat, sebt3 (port)
|RPG
|x
|[http://sebt3.openpandora.org/pnd/ZeldaOLB_US.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54633-zelda-kind-of/ Discussion] Software scaling version
|-
|Zelda ROTH
|2010-11-10
|Vincent Jouillat, sebt3 (port)
|RPG
|x
|[http://sebt3.openpandora.org/pnd/ZeldaROTH_US.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54633-zelda-kind-of/ Discussion] Software scaling version
|}

==Game Engines==

Each of these games requires the original data files to play. They can typically be obtained from the original CD or floppy disc, though on occasion the game in question is freeware. Sometimes, rather than an engine (like PrBoom), the original game itself is directly ported (like Gish)

{|class="wikitable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: left;"
|- style="background: #ececec; text-align: center;"
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Original Game
!Engine Name (where applicable)
!Release date (YYYY-MM-DD)
!Author/Port Author
!Genre
!MP1
!Download
!Notes
|-
|Command and Conquer: Red Alert
|OpenRedAlert ('''beta''')
|2011-01-26
|mcobit (port)
|RTS
|
|[http://maheld.heckel-web.pharmchem.uni-frankfurt.de/openredalert.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58123-openredalert/page__view__findpost__p__935817 Discussion]. Developer would like help. Get the data files [http://www.commandandconquer.com/classic here.]
|-
|Commander Keen 1-3 (partial support for 4)
|CGenius
|2011-01-03
|CGenius team, Pickle (port)
|Platformer
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,50 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58070-commander-genius-for-pandora-enhanced-keen-engine/ Discussion] includes keen 1
|-
|Descent
|D1X-Rebirth
|2010-08-08
|Pickle (port)
|FPS
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,175 Archive]
|[http://www.dxx-rebirth.com/ Website] Get the original shareware files [http://www.dxx-rebirth.com/download/dxx/content/descent-shareware.zip here.]
|-
|Descent 2
|D2X-Rebirth
|2010-08-08
|Pickle (port)
|FPS
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,177 Archive]
|[http://www.dxx-rebirth.com/ Website] Get the original shareware files [http://www.dxx-rebirth.com/download/dxx/content/descent2-demo.zip here.]
|-
|Doom 1 and 2
|PrBoom
|2011-01-30
|Pickle (port)
|FPS
|
|[http://pickle.gp2x.de/prboom.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56700-prboom-with-picklelauncher-for-pandora/page__view__findpost__p__936645 Discussion] Enhanced Doom engine [http://prboom.sourceforge.net/ Website] Fully compatible with [http://www.nongnu.org/freedoom/ Freedoom], a free clone that comes as a .WAD file . Uses [[PickleLauncher]]
|-
|Duke Nukem 3D
|eDuke32SDL
|2010-07-01
|eduke32 team
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/eduke32SDL.inf Apps]
|Get the original shareware files [http://liberatedgames.com/game.php?game_id=19 here]
|-
|Flashback
|Reminiscence v0.1.11
|2011-01-15
|zx-81 (port)
|Platformer
|
|[http://zx81.zx81.free.fr/public/pandora/reminiscence/reminiscence-v0.1.11-pnd.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/55244-pandora-reminiscence-flashback-clone-for-pandora-v0110/ Discussion] needs non-free data
|-
|Gish ('''beta''')
|Gish
|2011-01-12
|Pickle (port)
|Platformer
|
|[http://pickle.gp2x.de/gish.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58034-gish/page__view__findpost__p__933707 Discussion] A bit slow [https://github.com/megagun/gish free data untested]
|-
|Heretic
|HHeretic
|2010-05-23
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Heretic.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,67 Archive]
|Get the original shareware files:link needed
|-
|Heroes of Might and Magic 2
|FHeroes
|2010-03-17
|Pickle (port)
|Strategy
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/FHeroes2.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,29,44 Archive]
|[http://www.gp32x.com/board/index.php?showtopic=47553 Discussion] needs non-free data
|-
|Hexen
|HHexen
|2010-05-23
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Hexen.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,68 Archive]
|Get the original shareware files:link needed
|-
|Hexen 2
|Hexen 2: Hammer of Thyrion
|2010-06-05
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Hexen2.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,66 Archive]
|Get the original shareware files:link needed
|-
|[http://en.wikipedia.org/wiki/Infinity_Engine Infinity Engine]
|GemRB 0.6.3
|2011-01-23
|JurnD (port)
|RPG
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,5,204 Archive]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/53848-has-anyone-done-anything-on-gemrb/page__view__findpost__p__888096 1] [http://www.gp32x.com/board/index.php?/topic/56677-gemrb/ 2] needs non free data
|-
|Jazz Jackrabbit
|OpenJazz svn116
|2010-07-04
|Alister, Pickle (port)
|Platformer
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,35,55 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/Openjazz.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54974-openjazz-update/ Discussion] Get the original shareware files [ftp://download.dosgamesarchive.com/jjrabbit.zip here.]
|-
|Ken's Labyrinth
|Ken's Labyrinth
|2010-08-03
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/ken.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,176 Archive]
|data included in pnd
|-
|Little Big Adventure 1 and 2
|Prequ ('''beta''')
|2011-01-31
|mcobit (port)
|Action-adventure
|
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=520 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58483-prequ-engine-another-lba-engine/ Discussion]. Works better than Twin-E version. Needs [http://www.gp32x.com/board/index.php?/topic/58173-midi-installer/ Timidity MIDI Installer] needs non-free data
|-
|Lord of the Rings: The Fellowship of the Ring
|Lord of the Rings Game Engine
|2011-01-31
|Michal Benes, EvilDragon (port)
|RPG
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,294 Archive]
|Engine for the game by Interplay. Put the DOS game files in /pandora/appdata/lotr/ | data not free
|-
|Marathon 2, Marathon Infinity
|AlephOne Trilogy 0.23.1
|2010-10-11
|Pickle (port)
|FPS
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,143 Archive]
|[http://sourceforge.net/projects/marathon/ Website] [http://www.gp32x.com/board/index.php?/topic/55168-rise-of-the-triad-openlierox-alpehone/ Discussion] includes game files
|-
|Narcissu
|ONscripter
|2010-05-11
|Insani, EvilDragon (port)
|Visual Novel
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,37,58 Archive]
|[http://boards.openpandora.org/index.php?/topic/1768-narcissu/page__view__findpost__p__33096 includes ONScripter]
|-
|Quake
|ZQuake ('''beta''')
|2011-02-13
|Pickle (port)
|FPS
|
|[http://pickle.gp2x.de/zquake.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58651-quake-1-zquake-with-gles/page__pid__939012__st__0&#entry939012 Discussion] Get the original shareware files [ftp://ftp.idsoftware.com/idstuff/quake/quake106.zip here.]
|-
|Quake 2
|IOQuake 2
|2010-06-05
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/IOquake2.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,64 Archive]
|Get the original shareware files [ftp://ftp.idsoftware.com/idstuff/quake2/q2-314-demo-x86.exe here.]
|-
|Quake 3
|IOQuake 3
|2010-06-05
|Pickle (port)
|FPS
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/IOquake3.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,65 Archive]
|Get the original shareware files:link needed
|-
|Rise of the Triad
|Rise of the Triad
|2010-07-10
|Pickle (port)
|FPS
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,145 Archive]
|[http://www.3drealms.com/rott/ Website] [http://www.gp32x.com/board/index.php?/topic/55168-rise-of-the-triad-openlierox-alpehone/ Discussion] Get the original shareware files: link needed
|-
|Sonic Robo Blast 2
|Sonic Robo Blast 2
|2010-09-21
|Pickle (port)
|Platformer
|N+C
|[http://pickle.gp2x.de/srb2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56726-sonic-robo-blast-2-with-opengles/ Discussion] Put [http://www.srb2.org/download/ data files] in appdata/srb2
|-
|Star Control 2
|Pandora-Uqm
|2010-08-21
|zx-81 (port)
|Adventure
|N+C
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/pandora-uqm-v0.6.2.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,194 Archive]
|The data files can be obtained for free [http://sc2.sourceforge.net/downloads.php here].
|-
|Star Control 2
|Ur-Quan Masters
|2010-06-19
|Pickle (port)
|Adventure
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/uqmasters.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54936-ur-quan-masters-is-it-really-that-good Discussion] The data files can be obtained for free [http://sc2.sourceforge.net/downloads.php here].
|-
|{{HideableNotes|Text adventures from Magnetic Scrolls, Infocom, ZMachine, and Scott Adams.}}
|Kronos (Interpreter)
|2010-05-21
|Skeezix (port)
|Text Adventure
|x
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/kronos.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,62 Archive]
|free if [http://www.ifarchive.org/] ,[http://wurb.com/if/], [http://www.ifcomp.org/]
|- style="background: #xxxxxx"
|Text adventure games
|[[Gargoyle 08-2009]]
|2010-08-23
|gargoyle, skeezix
|Text Adventure
|x
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/gargoyle_20100823.inf Apps]
| {{HideableNotes|Supports Adrift, Alan, APT, Glulx, Hugo, Level 9, Magnetic Scroll, TADS and Z-Code format games}} free if [http://www.ifarchive.org/] ,[http://wurb.com/if/], [http://www.ifcomp.org/]
|-
|Theme Hospital
|CorsixTH
|2011-02-16
|CorsixTH team, Wally (port)
|Simulation / Godgame
|
|[https://idisk.mac.com/catapultit//Public/CorsixTH-B5.zip Download]
|Discussion: [http://boards.openpandora.org/index.php?/topic/1734-corsix-th-open-theme-hospital-engine/ OP] [http://www.gp32x.com/board/index.php?/topic/58690-corsix-th-open-theme-hospital-engine/ GP32X]. Needs non-free data
|-
|Ultima VII
|Pandora-Exult
|2010-08-12
|zx-81 (port)
|RPG
|
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Game/exult-1.4.inf Apps] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,26,182 Archive]
|needs non-free data
|-
|[http://en.wikipedia.org/wiki/SCUMMVM#Games_supported_by_ScummVM Various]
|[[ScummVM]] 1.2.1
|2010-12-30
|DJWillis
|Adventure
|
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,20,295 Archive] [http://sourceforge.net/projects/scummvm/files/scummvm/1.2.1/scummvm-1.2.1-openpandora.zip/download Download]
|[http://www.gp32x.com/board/index.php?/topic/56874-scummvm-120-preview-1-for-the-openpandora/ Discussion] [http://wiki.scummvm.org/index.php?title=OpenPandora Wiki] [http://www.scummvm.org/downloads/ freeware]
|-
|Wolfenstein 3D/Spear of Destiny
|Wolf4SDL with [[PickleLauncher]]
|2010-10-09
|Pickle (port)
|FPS
|x
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,30,51 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56977-wolf4sdl-with-pickelauncher-for-pandora/ Discussion] [http://liberatedgames.com/game.php?game_id=17 shareware data]
|-
|Z-Machine Games
|[[Frotz]] v2.43
|2010-05-27
|SteveM (port)
|Adventure
|x
|[http://www.cosam.org/computers/pandora/frotz-2.43.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,20,82 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53717-frotz-pnd Discussion] {{HideableNotes|Interpreter for Infocom and other Z-machine games}} free if [http://www.ifarchive.org/] ,[http://wurb.com/if/], [http://www.ifcomp.org/]
|}

1MP stands for "multiplayer"
{|class="wikitable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 355px;"
|- style="background: #ececec"
!colspan="2" | About the MP column
|-
|x || There is no multiplayer
|-
|SS || Yes, by sharing a system
|-
|SSC || Yes, by sharing a system with an external controller attached.
|-
|Net || Yes, multiplayer over a network
|-
|N+S || Both Net and SS
|-
|N+C || Both Net and SSC
|-
|All || Net, SS and SSC
|}

==External links==
*[http://sebt3.openpandora.org/pnd/ Releases by sebt3]
*[http://www.hermocom.com/en/downloads/openpandora/ Releases by Hermocom]
*[http://rebirthofxeen.com/files/pandora/ Releases by WizardStan]
*[http://www.stuckiegamez.co.uk/apps/pandora/ Releases by Stuckie]

===Forums===
The following community forums are checked when updating this page:
*From GP32X: [http://www.gp32x.com/board/index.php?/forum/63-news-zone-pandora/ News Zone], [http://www.gp32x.com/board/index.php?/forum/71-beta-testing-pandora/ Beta Testing] and [http://www.gp32x.com/board/index.php?/forum/64-developers-corner-pandora/ Developer's Corner]
*From OP: [http://boards.openpandora.org/index.php?/forum/26-software-news/ Software News] and [http://boards.openpandora.org/index.php?/forum/10-beta-testing/ Beta Testing]

[[Category:Games| ]]
[[Category:Software]]

User:Stuckie

2011-02-24T03:32:28Z

Stuckie: Added list of projects with links as necessary.

I do scary dodgy hacks ;)

Homesite: [http://www.stuckiegamez.co.uk stuckieGAMEZ]

= Scary Hacks =
== Extend Utils ==
[[Extend Utils]] - The Extend Utils suite which allows loading of loop files for swap, overlays and OS extensions. 
== Debian on SD ==
[[Debian On SD]] - OS project to get Debian running on Pandora via SD card; maintaining all Debian and Pandora features. 

= Other Projects =
== GLESGAE ==
GLESGAE - GL ES Game Application Engine; an engine originally written for Pandora to aid in GL ES programming and porting to other capable devices. 
Not released as yet.

= Unmaintained Ports =
Unmaintained in the sense that, they've been released and work as far as I'm aware.. unless someone shouts at me otherwise, they'll stay that way! 
I'm also not directly keeping an eye on the original package for updates.
== MAXR ==
* Technically, this does work completely as intended as they only have multi-player running, and no single player.
* Might be tempted to upgrade it at some point if there's interest, and there's been an update since.

== MilkyTracker ==
* There was a bug report that an HF5 beta had issues with it... will test again once HF5 is final.

== SchismTracker ==
* Had no bug reports from it, I assume it's fine.

== gMPC ==
* There's a much better port than the one I quickly put together.

== gimp ==
* Very very quick and hacky port... really needs a rebuild properly.

== Bennu ==
* Have had zero feedback on this at all.. no idea if it even works right as I don't use the language so couldn't test properly.

= Package Site =
My packages can usually be found on http://www.stuckiegamez.co.uk/apps/pandora .. if linking to this, I'm "stuckie" not "stuckieGAMEZ" or any variation of!

= Contact Details =
Can be found in irc mostly... PM me if you don't get a response in a timely fashion, and I'll contact you when I'm around.

Software projects

2011-02-24T03:31:17Z

Stuckie: Changed port author of GIMP to Stuckie - it is my dirty hacky port! read the discussion for proof and the fact it's on my site!

''These lists were last updated on 2011-02-19 to include the latest files from [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps], the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive], and the [[Software_projects#Forums|community forums]].''

This is a list of '''all software projects''' for the Pandora ''excluding'' emulators (see: [[Emulator list]]), games (see: [[Games]]), and development tools (see: [[Development Tools]]). However, this list ''does'' include the development apps that can be used on the Pandora itself.

See the [[Port Requests]] article for open-source projects which ''could'' be ported but have not been taken on by anyone yet.
for [[Unreleased]]

==Software==
If you would like to add something, you could edit the wiki or [http://www.gp32x.com/board/index.php?/topic/54923-the-pandora-apps-thread/ post in this forum thread]. If different versions of a software were released, please make sure the "release date" is the most recent one.

Please click on the little squares to sort by different categories (such as Release date, Type, etc.)

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[AbiWord]]
|2011-01-17
|sebt3 (packaging)
|Office - word processor
|[http://sebt3.openpandora.org/pnd/abiword.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__919843 Discussion]
|-
|Alarm Clock ('''beta''')
|2011-02-01
|sebt3 (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,303 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/ Discussion]
|-
|[[Anki]] 1.2.4 ('''beta''')
|2011-01-25
|Drack (port)
|Office - memory aid
|[http://dl.dropbox.com/u/8938380/anki-1.2.4-drack1.pnd Download]
|Discussion [http://www.gp32x.com/board/index.php?/topic/56293-anki-friendly-intelligent-flashcards/ 1] [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/ 2]
|-
|[[Arora]] (for [[Minimenu]])
|2010-05-26
|Skeezix (quick hack)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,69 Archive]
|Needed to run Arora from Minimenu
|-
|[[Audacious]] 2.4.3
|2011-02-03
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/audacious.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54792-audacious/page__view__findpost__p__937089 Discussion]
|-
|[[b7zip]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Background killer
|2010-06-07
|Notaz
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/background_killer.inf Apps]
|Kill background tasks in minimenu. [http://www.gp32x.com/board/index.php?/topic/56008-zelda-classic-for-pandora/page__st__15__p__907940&#entry907940 Not needed] since Hotfix 3.
|-
|[[Banshee]]
|2010-10-23
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/banshee.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57144-portrequest-banshee/ Discussion]
|-
|[[Bournal]]
|2010-08-11
|
|Office - journal
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,181 Archive]
|encrypted diary program
|-
|[[Chromium]]
|2010-09-04
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,90 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56474-chromium-4-with-ssl-and-chromium-snapshot/ Discussion]. SSL now works
|-
|[[Chromium]]-Dev v10.0.642.1
|2011-01-16
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,201 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58234-chromium-dev-snapshot-v10-0-642-1/ Discussion] [http://www.gp32x.com/board/index.php?/topic/57017-chromium-dev-updated/ (old)]. The latest (non-stable) snapshot.
|-
|[[Claunch]] ('''beta''')
|2010-10-14
|Lamoxx
|System - app launcher
|[http://userpages.uni-koblenz.de/~bbrink/tmp/claunch_beta.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57040-claunch-minimal-flexible-rom-pickerapplication-launcher/ Discussion]
|-
|[[Claws Mail]]
|2010-10-03
|sebt3 (port)
|Network - mail client
|[http://sebt3.openpandora.org/pnd/claw-mail.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,223 Archive]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920075 Discussion]. Hopefully doesn't save to NAND (testing needed).
|-
|[[Cmus]]
|2010-11-27
|otherguy66 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,251 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57682-cmus-pnd-installer/page__gopid__928328&#entry928328 Discussion]. Installed to [[NAND]] (1mb). Text mode player
|-
|[[Code::blocks]]
|2010-06-07
|sinoth (port)
|Development - IDE
|[http://sinoth.net/pandora/codeblocks.pnd.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/54091-codeblocks-on-the-pandora/ Discussion].
|-
|Community Codec Package
|2010-05-25
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/CodecPack.inf Apps] [http://openpandora.org/downloads/CodecPack.pnd Official site]
|Make sure you have this installed
|-
|[[Comix]]
|2010-06-30
|Pontus Ekberg
|Graphics - image viewer
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/comix.inf Apps]
|
|-
|[[Conky]]
|2010-08-03
|daniel3000 (port)
|System
|[http://www.hermocom.com/en/downloads/openpandora/Conky.pnd/ Download]
|System monitor. [http://www.gp32x.com/board/index.php?/topic/55775-conky Discussion]
|-
|[[DarCalc]]
|2010-08-28
|JP
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,196 Archive]
|See also the calculator emulators [[Emulator list|here]]
|-
|[[Deadbeef]] 0.4.3
|2010-11-01
|CME (port), sebt3 (port)
|Audio - music player
|[http://root.shadow-node.net/public/cme/pnd/deadbeef.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55178-deadbeef-compiled-with-codesourcery-gcc-2010q1/ Discussion]
|-
|[[dia]]
|2010-10-03
|sebt3 (port)
|Office - diagrams
|[http://sebt3.openpandora.org/pnd/dia.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56863-dia/ Discussion]
|-
|[[DrawSWF]] ('''beta''')
|2010-07-10
|Chrysipp (port)
|Graphics - vector drawing
|[http://www.pandorasource.de/download.php?view.158 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10105%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhilcfdbJF4gEtvmTIwMjO9EFqUQ-A Discussion (German)]. Must have Java.pnd installed. {{HideableNotes|A small drawing program. The drawing can be exported as a Flash animation, which then shows its gradual development.}}
|-
|[[Ekiga]] ('''beta''')
|2010-10-29
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/ekiga.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/ Discussion]. Online phone & video calls. '''[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/page__view__findpost__p__924918 Doesn't work]'''{{HideableNotes| though it can be made to work through Debian, [[Extend Utils]]: [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/]}}
|-
|[[Enna]] ('''beta''')
|2010-07-08
|sebt3 (port)
|Media Player
|[http://sebt3.openpandora.org/pnd/enna.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55113-enna/ Discussion]
|-
|[[Exaile]]
|2010-04-28
|Pickle (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,43 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Exaile.inf Apps]
|Needs Community Codec Pack to run
|-
|[[Extend Utils]]
|2010-06-22
|Stuckie
|System
|[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ 1], [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/ 2]. Debian in an extend. Allows you to run over 29,000 programs.
|-
|[[F3]]
|2010-10-17
|slaeshjag (port)
|System
|[http://stuffs.slaeshjag.org/F3.tar Download]
|Test for fake flash memory (like H2testw). [http://www.gp32x.com/board/index.php?/topic/57063-some-quick-tips-to-help-avoid-fake-sd-cardsflash-media/page__view__findpost__p__922187 Discussion]
|-
|[[FBReader]] 0.12.10
|2010-07-26
|zx81 (port)
|Office - eBook Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,168 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fbreader-0.12.10.inf Apps]
|
|-
|[[Fennec]] 4.0b3 ('''beta''')
|2011-02-03
|Mozilla Team, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,75 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Fennec40.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58514-fennec-4-0b3/ Discussion]
|-
|[[Fennec]] 3.6.3
|2010-05-30
|Mozilla Team, Iampanis (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fennec.inf Apps]
|mobile version of FireFox
|-
|[[Figaro's Password Manager 2]] ('''beta''')
|2010-11-30
|mcobit (port)
|System - passwords
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,254 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57714-figaros-password-manager-2/ Discussion]
|-
|[[Firefox]]
|2010-06-14
|Evildragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,91 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/FireFox.inf Apps]
|
|-
|[[Firefox]] 3.6.13
|2011-01-28
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-3.6.13-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/56903-firefox-3-6-10/ Discussion (old)], [http://www.gp32x.com/board/index.php?/topic/58425-firefox-3-6-13/ news/discussion]
|-
|[[Firefox]] 4.0B10 ('''beta''')
|2011-02-01
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-4b10-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58489-firefox-4-beta-10/ Discussion]
|-
|[[FlipClock]] ('''beta''')
|2011-02-05
|torpor (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58548-port-flipclock-for-pandora/ Discussion], also [http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/page__view__findpost__p__937668 here]
|-
|[[Fotoxx]]
|2010-12-06
|Kornelix mcobit (port)
|Graphics - photo editor & manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,261 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57777-fotoxx/ Discussion]
|-
|[[Freemind]]
|2010-11-21
|mcobit (port)
|Office - mind mapping
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,4,240 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57605-freemind-a-mindmap-tool/ Discussion]. Needs java.pnd installed.
|-
|[[GCalc]]
|2010-11-23
|mcobit (port)
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,241 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57636-gcalc-graphic-calculator/ Discussion]. Needs java.pnd installed. See also the calculator emulators [[Emulator list|here]]
|-
|[[Geany]] v0.19-1
|2010-09-16
|bompo (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,14,205 Archive] [http://dl.dropbox.com/u/39448/pandora/geany.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55432-geany/ Discussion]
|-
|[[gedit]]
|2010-10-03
|sebt3 (port)
|Office - text editor
|[http://sebt3.openpandora.org/pnd/gedit.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56862-gedit/ Discussion]
|-
|[[gerbv]]
|2010-09-14
|bompo (port)
|Office - EDA
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,202 Archive]
|viewer for Gerber RS-274X, Excellon drill, & CSV pick-and-place files
|-
|[[gFTP]] 2.0.18 ('''beta''')
|2010-07-01
|sebt3 (port)
|Network - FTP client
|[http://sebt3.openpandora.org/pnd/gftp.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54931-gftp/ Discussion]
|-
|[[GIMP]] v2.6 ('''beta''')
|2010-06-06
|Stuckie (quick hack)
|Graphics - image editor
|[http://www.stuckiegamez.co.uk/apps/pandora/gimp-2.6.pnd Download]
|Read instructions [http://www.gp32x.com/board/index.php?/topic/54071-ubuntu-or-other-dist-alternative/page__p__868411&#entry868411 here]
|-
|[[Gmu Music Player]] 0.7.2
|2010-12-29
|wejp
|Audio - music player
|[http://wejp.k.vu/files/gmu-0.7.2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58009-gmu-music-player-0-7-2/ Discussion] [http://www.gp32x.com/board/index.php?/topic/55007-gmu-music-player-0-7-1-released/ (old)]
|-
|[[Gnomad 2]]
|2010-10-18
|sebt3 (port)
|Audio - music manager
|[http://sebt3.openpandora.org/pnd/gnomad2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57088-gnomad2/ Discussion]
|-
|[[Gnome Music Player Client]] (GMPC) 0.20.0 ('''beta''')
|2010-08-01
|tsh (port)
|Audio - music player
|[https://sites.google.com/site/tshpandorastuff/file-cabinet/gmpc0.20.0.pnd?attredirects=0&d=1 Download]
|[http://www.gp32x.com/board/index.php?/topic/55664-gmpc-beta/ Discussion]
|-
|[[Gnumeric]]
|2011-01-17
|sebt3 (port)
|Office - spreadsheet
|[http://sebt3.openpandora.org/pnd/gnumeric.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920072 Discussion]
|-
|[[GoldenDict]] 0.9.0Svn
|2010-09-27
|Hitnrun (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,209 Archive] [http://www.rangelreale.com/pandora/goldendict.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56802-goldendict-0-9-0svn/ Discussion]
|-
|[[GParted]]
|2011-02-05
|sebt3 (port)
|System - partition
|[http://sebt3.openpandora.org/pnd/gparted.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Discussion]
|-
|GQview
|2010-07-27
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/GQview.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55559-gqview-pnd-image-viewer-available/ Discussion]
|-
|[[Grafx2]]
|2010-12-30
|pulkomandy, yrizoud, mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,264 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58016-grafx2/ Discussion]. For pixel art.
|-
|[[Groove]]
|2010-07-19
|Elias Woods, bompo (port)
|Network - radio
|[http://dl.dropbox.com/u/39448/pandora/Groove.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55363-groove/ Discussion]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. '''Warning''': {{HideableNotes|Requires installing dependencies with opkg. See discussion thread.}}
|-
|[[Gwaei]]
|2010-11-26
|Zachary Dovel mcobit (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,249 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57674-gwaei-port-japanese-english-dictionary/ Discussion]. Japanese-English.
|-
|[[HomeBank]] 4.3
|2011-02-02
|Maxime Doyen, mcobit (port)
|Office - money manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,296 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58506-homebank/ Discussion]
|-
|Hotfix 4
|2010-08-31
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/HotFix4-Zaxxon.inf Apps] [http://openpandora.org/downloads/HotFix4-Zaxxon.pnd Official site]
|Make sure you have this installed
|-
|[[Inkscape]] ('''beta''')
|2010-10-08
|sebt3 (port)
|Graphics - vector drawing
|[http://sebt3.openpandora.org/pnd/inkscape.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56954-inkscape/ Discussion]. Currently very slow.
|-
|[[Java]] Pnd ('''beta''')
|2010-11-21
|WizardStan (port)
|System - dependency
|[http://rebirthofxeen.com/files/pandora/java.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57598-java-pnd/ Discussion]. Run Java apps.
|-
|[[jEdit]]
|2010-11-22
|mcobit (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,244 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57614-jedit-programmers-text-editor/ Discussion]. For programmers. Needs java.pnd installed.
|-
|[[jChemPaint]]
|2010-11-23
|mcobit (port)
|Graphics - molecule drawing
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,242 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57633-jchempaint/ Discussion]. Needs java.pnd installed.
|-
|[[jMol]]
|2010-11-22
|mcobit (port)
|Graphics - molecule viewing in 3D
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,243 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57618-jmol-3d-molecule-viewer/ Discussion]. Needs java.pnd installed.
|-
|[[jMP3 Player]]
|2010-07-10
|jaijuju
|Audio - music player
|[http://www.pandorasource.de/download.php?view.156 Download]
|[http://code.google.com/p/jmp3player/ Website]. Java.pnd required.
|-
|[[KCHMViewer]] 5.2
|2010-10-05
|Hitnrun (port)
|Office - CHM Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,215 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56901-kcmviewer/ Discussion.] Windows help files reader.
|-
|[[KDiff 3]]
|2011-02-03
|Joachim Eibl
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,299 Archive]
|[http://boards.openpandora.org/index.php?/topic/1440-kdiff3-0995-pandora-3/ Discussion]. Merge 2 or 3 text input files or directories
|-
|[[Liferea]]
|2010-07-06
|sebt3 (port)
|Network - RSS Reader
|[http://sebt3.openpandora.org/pnd/liferea.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55089-liferea/ Discussion]
|-
|[[Linphone]] ('''beta''')
|2011-01-20
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/linphone.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58289-linphone Discussion]. Online phone calls.
|-
|[[Me TV]]
|2010-10-19
|sebt3 (port)
|Network - digital TV
|[http://sebt3.openpandora.org/pnd/metv.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56987-port-request-me-tv/page__p__921501&#entry921501 Discussion]
|-
|[[Merkaartor]] 0.17.0
|2011-01-27
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/merkaartor.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56656-merkaartor-or-other-osm-editor/page__p__922345&#entry922345 Discussion]
|-
|[[MilkyTracker]]
|2010-06-23
|Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,102 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/milkytracker.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/57612-remember-the-only-2-keyboard-buttons-at-once-limitation/ Discussion]
|-
|[[Minitube]] 1.3
|2011-01-13
|Flavio Tordini, sebt3 (port)
|Network - Youtube client
|[http://sebt3.openpandora.org/pnd/?f=minitube.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/55952-minitube-1-1/ v1.1] [http://www.gp32x.com/board/index.php?/topic/58183-minitube-1-3/ v1.3]. Youtube browser/player
|-
|[[mtPaint]]
|2010-07-27 2010-12-29
|Mark Tyler, daniel3000 (port 1), chris_c (port 2)
|Graphics - image editor
|[http://www.hermocom.com/en/downloads/openpandora/mtPaint.pnd/ Download (port 1)] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,263 Archive (port 2)]
|[http://www.gp32x.com/board/index.php?/topic/55561-mtpaint-pnd-available/ Discussion]. For painting & pixel art. Ported twice.
|-
|[[MyPaint]] ('''beta''')
|2011-02-19
|First (port)
|Graphics - image editor
|[http://webusers.spa.umn.edu/~laurens/pnd/mypaint-0.9.0.pnd.gz Download]
|[http://boards.openpandora.org/index.php?/topic/1817-mypaint-port/ Discussion]. [http://mypaint.intilinux.com/ Website]. Has pressure sensitivity.
|-
|[[Ommpc]] v0.5.4
|2010-10-06
|Tim Temple
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,133 Archive]
|MPD client [http://www.gp32x.com/board/index.php?/topic/55039-ommpc-v0-5-2/ Discussion]
|-
|[[OSM2Go]]
|2010-10-20
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/osm2go.pnd Download]
|
|-
|[[Osmo]] ('''beta''')
|2010-09-03
|sebt3 (port)
|Office - personal organizer
|[http://sebt3.openpandora.org/pnd/osmo.pnd Download]
|[http://clayo.org/osmo/ Website] [http://www.gp32x.com/board/index.php?/topic/56455-osmo/ Discussion]
|-
|[[PanDebian]]
|2011-02-04
|Gregor
|System
|[http://codu.org/tmp/pandebian.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1474-pandebian/ Discussion]. [[Extend Utils]] alternative for Angstrom-Debian cooperation
|-
|Pandora Fractals
|2010-08-26
|Or Green
|Graphics - fractals
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/PFractals.inf Apps]
|fractal generator. [http://www.gp32x.com/board/index.php?/topic/51402-mandelbrot-set-generator-for-pandora/page__st__75 Discussion]
|-
|[[Pencil]] 0.4.4b ('''beta''')
|2010-11-04
|sebt3 (port)
|Graphics - animation
|[http://sebt3.openpandora.org/pnd/pencil.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57362-pencil/ Discussion]. 2D animation & drawing.
|-
|[[Pidgin]]
|2010-12-07
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/pidgin.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56898-pidgin/ Discussion]. This version no longer uses [[NAND]] to [http://www.gp32x.com/board/index.php?/topic/56898-pidgin/page__view__findpost__p__934658 store data].
|-
|[[PNDbuilder]]
|2011-02-08
|freedomdown (Ryan Dallaire)
|Development
|[http://freedomdown.squarespace.com/storage/pndb.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58587-pndbuilder/ Discussion]. Graphical PND maker.
|-
|PS3 Bluetooth Controller - Sixpair Utility
|2010-06-13
|Jim Paris, Samson Yeung, AireTamStrm (port)
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,4 Archive]
|Use a DualShock III Controller or SIXAXIS controller via USB
|-
|[[PSFreedom]]
|2010-09-23
|Notaz (port)
|Other
|[http://pandorapress.net/gruso/psfreedom.ko Download]
|[http://www.gp32x.com/board/index.php?/topic/56752-psfreedom-for-pandora/ Discussion]. Allows homebrew on your PS3.
|-
|[[qOrganizer]]
|2010-11-04
|sebt3 (port)
|Office - organizer
|[http://sebt3.openpandora.org/pnd/qorganizer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,233 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57359-qorganizer/ Discussion]
|-
|Quick Change CPU Speed
|2010-06-20
|Pleng
|System
|[http://www.strappysolutions.com/demos/pandora/CPUSpeeds.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54583-quick-change-cpu-speeds/ Discussion]. Add CPU speed presets to your menu.
|-
|[[Remmina]]
|2010-06-21
|mindlord (port)
|Network - VNC/RDP/XDMCP client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,99 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/remmina.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54610-remmina-0-7-5/ Discussion]. Control your PC from your Pandora.
|-
|[[RText]]
|2010-07-10
|Fifesoft, Chrysipp (port)
|Development - text editor
|[http://www.pandorasource.de/download.php?view.157 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10106%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhivaNHspNg4XSb4aOpjskxivvIRXw Discussion (German)]. Must have Java.pnd installed.
|-
|[[Schism Mod Player]]
|2010-06-10
|?
|Audio - music tracker
|[http://www.pandorasource.de/download.php?view.79 Download]
|Player for MOD and XM.
|-
|[[Schism Tracker]]
|2010-06-19
|Storlek, Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,89 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/schismtracker.inf Apps]
|Clone of Impulse Tracker
|-
|[[Scite]] 2.21
|2010-10-20
|urjaman (port)
|Office - text editor
|[http://urjaman.dyndns.info/scite221.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57116-scite-2-21-ported/ Discussion]. Scintilla-based syntax highlighting text editor
|-
|SD Card Speed Fix
|2010-06-13
|mawler
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,88 Archive]
|improve SD writing speed, but risk data corruption if writing is interrupted
|-
|[[Seq24]] ('''beta''')
|2010-09-06
|Gruso (port)
|Audio - music tracker
|[http://users.tpg.com.au/pw2007/seq24.beta1.pnd Download]
|MIDI sequencer. [http://www.gp32x.com/board/index.php?/topic/56517-seq24-midi-sequencer/ Discussion]
|-
|[[SMPlayer]] 0.6.9-1
|2011-02-02
|Ivanovic (port)
|Media Player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive]
|MPlayer frontend. [http://www.gp32x.com/board/index.php?/topic/58511-smplayer/ Discussion]
|-
|[[SUPA]] 0.1-1 ('''beta''') Simple Updater for Pandora Applications
|2010-07-04
|Bryce Leo
|System - Application Downloader/Updater
|[http://drive.and-a-half.com/SUPA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55023-supa-simple-updater-for-pandora-applications/ Discussion]. No GUI yet.
|-
|[[Synergy]]
|2010-10-09
|Lomaxx (port)
|Network - VNC client
|[http://www.mediafire.com/?npdbkibd5bm5ckb Download]
|[http://www.gp32x.com/board/index.php?/topic/56943-synergy-clientserver-as-pnd/ Discussion]. Control your PC from your Pandora.
|-
|[[Timidity MIDI Installer]]
|2011-01-12
|sebt3
|Audio - MIDI
|[http://sebt3.openpandora.org/pnd/timidity_midi_installer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,273 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58173-midi-installer/ Discussion]. MIDI patches installer. {{HideableNotes|It will allow you to have music for games that use MIDI. There are 3 different sound-sample sets packing different levels of sound quality. Installs to [[NAND]], though you can put them on SD card and then it's less than 2k on NAND (2 2-line files).}}
|-
|[[Transmission]]
|2010-09-24
|sebt3 (port)
|Network - BitTorrent client
|[http://sebt3.openpandora.org/pnd/transmission.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,208 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56553-bit-torrent-client/ Discussion].
|-
|[[TrueCrypt]] ('''beta''')
|2011-02-12 2010-07-18
|TJSomething (port) daniel3000 (old port)
|System - encryption
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,321 Archive] [http://www.hermocom.com/en/downloads/openpandora/TrueCrypt.pnd/ old version]
|[http://boards.openpandora.org/index.php?/topic/1763-truecrypt-port/ Discussion]. [http://www.gp32x.com/board/index.php?/topic/55347-truecrypt-pnd-ready-for-testing/ Discussion (old)].
|-
|[[Unace]]
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UnRar]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UPX]] (The Ultimate Packer for eXecutables)
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Viewnior 1.0
|2010-07-29
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/Viewnior.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55618-viewnior-pnd-available/ Discussion]
|-
|Vim Gvim 7.2 ('''beta''')
|2010-08-08
|joseluisjazz (port)
|Office - text editor
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Discussion]. [http://www.vim.org/about.php About]. Not a PND.
|-
|[[VLC]] 1.1.0 ('''beta''')
|2010-10-12
|sebt3 (port)
|Media player (video & audio)
|[http://sebt3.openpandora.org/pnd/vlc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54922-vlc/ Discussion]
|-
|[[Wahcade]] Emulator Frontend b1 ('''beta''')
|2011-02-06
|Sigma (port)
|System - frontend
|[http://www.mediafire.com/?h8o33khvtcy3x8m Download]
|[http://boards.openpandora.org/index.php?/topic/1508-wahcade-frontend-beta1/ Discussion].
|-
|WiFi '''Beta test'''
|2010-11-05
|EvilDragon
|System
|[http://www.openpandora.org/downloads/WiFiBETA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57364-wifi-betatest/ Discussion]. Might fix WiFi issues.
|-
|[[Xarchiver]] 0.5.2
|2010-12-04
|mcobit (port)
|System - file archiver
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,259 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57748-xarchiver/ Discussion]
|-
|Xbindkeys
|2010-10-14
|Lomaxx (port)
|System
|[http://userpages.uni-koblenz.de/~bbrink/tmp/xbindkeys-1.8.3_prebuild.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57037-xbindkeys-precompiled/ Discussion]. Configure hotkeys
|-
|[[XBMC]] 10.0 ('''beta''')
|2011-01-11
|sebt3 (port)
|Media Player
|[http://sebt3.openpandora.org/pnd/xbmc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57106-xbmc-media-center/ Discussion]. Functions as "entertainment hub".
|-
|XFE 1.32.1
|2010-07-20
|Maxim Baranov, Roland Baudin, packaged by sebt3
|System - file manager, packager Graphics - image viewer Office - notepad
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,163 Archive]
|
|-
|[[Xournal]]
|2010-10-03
|sebt3 (port)
|Office - journal
|[http://sebt3.openpandora.org/pnd/xournal.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56864-xournal/ Discussion]. Can annotate PDFs.
|}
==Skins==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Basic Gray
|2010-11-25
|milkshake
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=506 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueFuture
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,239 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=434 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Executive
|2010-11-27
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,250 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928158 Discussion]
|-
|Gray Is Sexy
|2010-11-27
|milkshake
|Minimenu skin
|[http://www.liquidfists.com/files/grayissexy.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928315 Discussion]
|-
|Midnight
|2010-06-17
|Trevsweb
|Minimenu skin
|[http://trevsweb.com/pandainterface/midnight.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|Minimenu With Toggle Detail Panel Support ('''beta''')
|2011-01-23
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/detail-toggle/ Download]
|[http://www.gp32x.com/board/index.php?/topic/58327-beta%3B-minimenu-with-toggle-detail-panel-support/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-26
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110126.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-27
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110127.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-02
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110202.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-09
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110209.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/page__view__findpost__p__938340 Discussion]
|-
|Newsprint
|2010-07-26
|Pleng
|Minimenu skin
|[http://www.strappysolutions.com/demos/pandora/newsprint.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|RedDevil
|2010-11-26
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,248 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928099 Discussion]
|-
|RedWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=433 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Toybox & Corporate (2 skins)
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=432 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Wasp
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,238 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|}
==Operating Systems==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Debian('''beta''')
|[http://debian.org] [http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/]
|working build
|Stuckie
|[[Debian On SD]]
|}

==Graphic engines==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[GLES]] ('''beta''')
|2010-09-02
|Farox (port)
|
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Download]
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Discussion]
|-
|WakeBreaker
|
|torpor
|3d
|[http://w1xer.at/pandora/]
|{{HideableNotes|Working C++ codebase to implement a 3D game using nothing more than OpenGLES 1.1 .. can even be built *on* the Pandora, with nothing more than the onboard compiler. WakeBreaker contains everything you need to get started writing a 3D game in C++ with OpenGL ES - no further libraries required. Its an excellent example of how to write a 3D game in plain, easy to understand C++ and can serve as a working base for your own developments, easily enough.}}
|}

==Links==
*[http://sebt3.openpandora.org/pnd/ Releases by sebt3]
*[http://www.hermocom.com/en/downloads/openpandora/ Releases by Hermocom]
*[http://rebirthofxeen.com/files/pandora/ Releases by WizardStan]
*[http://www.stuckiegamez.co.uk/apps/pandora/ Releases by Stuckie]
*[http://www.pandorasource.de/download.php PandoraSource.de downloads] - German Pandora download site
*From GP32X: [http://www.gp32x.com/board/index.php?/forum/63-news-zone-pandora/ News Zone], [http://www.gp32x.com/board/index.php?/forum/71-beta-testing-pandora/ Beta Testing] and [http://www.gp32x.com/board/index.php?/forum/64-developers-corner-pandora/ Developer's Corner]
*From OP: [http://boards.openpandora.org/index.php?/forum/26-software-news/ Software News] and [http://boards.openpandora.org/index.php?/forum/10-beta-testing/ Beta Testing]
[[Category:Development]]
[[Category:Software]]

Extend Utils

2011-02-24T03:13:07Z

Stuckie: Link clean up and general tidiness. Removed Ubuntu support - use Debian instead!

= Overview =
Extend Utils provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the SimpleDev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For those that prefer the "classic" version which doesn't have as much options available to it, you can grab that here:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/OldExtendUtils.pnd Classic Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

= Bug Reports =
In order for a bug report to be useful, I need the following information from you: 
Output from "dmesg | tail", "mount" and your preMount script. 
A description of the error.

Just PM me them on the GP32X boards, or post in the relevant threads - Links at the bottom of this page.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in New Extend Utils, but are available here as well as they're just loop files and can therefore be used with other things:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/4GBExtend.zip 4GB Extend]

== Dev Extends ==
The last Dev Extend is very very old and may not work on recent firmwares. 
A newer one is in progress as of 24th Feb 2011.

=== Old Releases ===
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

Alternatively, check the [[Debian On SD]] project for booting Debian directly from SD card.

=== Gentoo ===
None, yet.

=== Ubuntu ===
Ubuntu is now officially 100% not supported. Upstart is an arse.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

See [[Debian On SD]] for a better solution ( Debian booting from SD ) for the moment.

== Ubuntu OS Extend ==
Ubuntu caused a great deal of stress and hacking about to get it to work in any shape or form - this is mostly due to Upstart. 
Eventually, only Jaunty was able to be loadable much. 
With the recent progres with [[Debian On SD]] I think that Ubuntu is a lost cause, so I'm removing all Ubuntu files from my server as they were utterly hacky to begin with.

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

Unfortunately, a Dev Extend hasn't been released for a while, and may currently BREAK some applications on the Pandora with the latest hot fix releases.. use with caution, or create an Overlay and install dev tools into that ( which is effectively all a Dev Extend is. )

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]

Debian On SD

2011-02-24T02:20:04Z

Stuckie: Forgot to add default user details

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD&action=submit#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.1.tar.gz 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.1.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

Default user details for the full build are: 
username: '''pandora''' 
password: '''debian'''

== Changelog ==
* 1.0 - First release; libts issues, libpnd issues, overly fat with stuff.
* 1.0.1 - Documented release; libts issues persist, libpnd issues fixed, slimmed down to ~830mb.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 
''Debian'' '''''nano /etc/skel/.profile''''' 
Add the following to the bottom
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &

Should probably copy more over but, this'll do for now. 
Need to figure out why .xinitrc isn't even being looked at for some reason.... this works for now though.

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
Currently, there's a few issues with the touchscreen - it'll cause X to go mad and chew through 100% CPU as soon as you touch it. 
However, it's still usable so we'll add in the libraries and configure it anyway. 
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

Some programs may look for /dev/input/touchscreen0 .. so we'll set that up too.

We'll do the rest of it on First Boot. 
There's an evtouch library.. haven't looked at that yet but it may work better?

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Don't really have any bluetooth devices to test.. though I could try tethering my phone by bluetooth...

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

That's essentially the kernel setup... we'll cover the boot script later.

==== RC Scripts ====
There's quite a number of RC scripts kicking about.. we'll nick most of them from Angstrom again and deal with them one state at a time.

===== rc0.d =====
sudo cp /etc/rc0.d/K05led-config /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K31pandora-state /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc0.d/

===== rc1.d =====
sudo cp /etc/rc1.d/K05led-config /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K31pandora-state /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc1.d/

===== rc2.d =====
sudo cp /etc/rc2.d/S05led-config /media/mmcblk0p1/etc/rc2.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc3.d =====
sudo cp /etc/rc3.d/S05led-config /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc3.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc4.d =====
sudo cp /etc/rc4.d/S05led-config /media/mmcblk0p1/etc/rc4.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc5.d =====
sudo cp /etc/rc5.d/S05led-config /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc5.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc6.d =====
sudo cp /etc/rc6.d/K05led-config /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K31pandora-state /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc6.d/

===== rcS.d =====
sudo cp /etc/rcS.d/S39pandora-state /media/mmcblk0p1/etc/rcS.d/

You were expecting led-config again, weren't you!

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd'''''

==== Misc Init Scripts and Things====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default'''''
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default'''''

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now.. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

Angstrom also uses a netdev group... not sure what creates that or what it's for... ignoring for now as it doesn't exist on stock Debian.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install! )

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The original 1.0 release included Synaptic.. but it's a heavy bugger and perhaps not everyone really feels the need for it, so I didn't keep it for 1.0.1 
To get it back, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PND don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

== My PNDs don't automatically display on menu/desktop, why?! ==
Not sure about this.. kicking pndnotifyd seems to trigger it properly, but why it's not doing it automatically, I'm not so sure...

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-02-24T02:07:44Z

Stuckie: Updated links for 1.0.1 .. libts issues persist... also finished permission issues and everything else.. this is the guide for what I did for the 1.0.1 release.

= Debian On SD =
This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD&action=submit#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-minimal-1.0.1.tar.gz 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.1.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

== Changelog ==
* 1.0 - First release; libts issues, libpnd issues, overly fat with stuff.
* 1.0.1 - Documented release; libts issues persist, libpnd issues fixed, slimmed down to ~830mb.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===
The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 
''Debian'' '''''nano /etc/skel/.profile''''' 
Add the following to the bottom
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &

Should probably copy more over but, this'll do for now. 
Need to figure out why .xinitrc isn't even being looked at for some reason.... this works for now though.

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
Currently, there's a few issues with the touchscreen - it'll cause X to go mad and chew through 100% CPU as soon as you touch it. 
However, it's still usable so we'll add in the libraries and configure it anyway. 
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

Some programs may look for /dev/input/touchscreen0 .. so we'll set that up too.

We'll do the rest of it on First Boot. 
There's an evtouch library.. haven't looked at that yet but it may work better?

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Don't really have any bluetooth devices to test.. though I could try tethering my phone by bluetooth...

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

That's essentially the kernel setup... we'll cover the boot script later.

==== RC Scripts ====
There's quite a number of RC scripts kicking about.. we'll nick most of them from Angstrom again and deal with them one state at a time.

===== rc0.d =====
sudo cp /etc/rc0.d/K05led-config /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K31pandora-state /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc0.d/

===== rc1.d =====
sudo cp /etc/rc1.d/K05led-config /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K31pandora-state /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc1.d/

===== rc2.d =====
sudo cp /etc/rc2.d/S05led-config /media/mmcblk0p1/etc/rc2.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc3.d =====
sudo cp /etc/rc3.d/S05led-config /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc3.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc4.d =====
sudo cp /etc/rc4.d/S05led-config /media/mmcblk0p1/etc/rc4.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc5.d =====
sudo cp /etc/rc5.d/S05led-config /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc5.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc6.d =====
sudo cp /etc/rc6.d/K05led-config /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K31pandora-state /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc6.d/

===== rcS.d =====
sudo cp /etc/rcS.d/S39pandora-state /media/mmcblk0p1/etc/rcS.d/

You were expecting led-config again, weren't you!

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd'''''

==== Misc Init Scripts and Things====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default'''''
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default'''''

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now.. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown -R <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the wheel group, which we are about to create: 
''Debian'' '''''groupadd wheel''''' 
There's also few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G wheel <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 

Technically, you could've done all this in the one line with adduser, but I'd rather keep it all separate so that if we end up with extra groups, we all know how to add them.

Angstrom also uses a netdev group... not sure what creates that or what it's for... ignoring for now as it doesn't exist on stock Debian.

There's a bunch of sudoers rules that are hidden as well that we need to steal ( I completely missed these twice - my thanks to sebt3 and DJWillis for pointing me to them! I thought the #includedir line was commented out due to the # ... *facepalm* ) 
''Angstrom'' '''''sudo cp /etc/sudoers.d/* /media/mmcblk0p1/etc/sudoers.d/'''''

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===
First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now. 
While root ( that's what sudo su does ) we shall finish setting up anything that didn't take during our chroot session in Angstrom ( bluetooth usually ) 
'''''apt-get -f install''''' 
'''''exit''''' - jump back to our user so we don't accidentally mess things up 

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

The following should probably be stuffed into deb files for easier maintainability: 
* libpnd
* pandora specific scripts
* SGX drivers
* kernel
* modules and firmware

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic ( see below on how to install! )

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

== Networking ==
Networking should work effectively the same as on Angstrom, but here's a run down of what to do anyway:
* Click the LXDE menu up.
* Click System Tools -> Toggle Wifi
* Click the Network Manager app between the process bar and the clock.
* Click your network - or select "Connect to Hidden Wireless Network" if it's not there and fill out the details.
* Fill out the keyring for your passwords to go into - so you only need to remember the one ;)
* The Network Manager icon should spin and then give you a strength bar as normal once connected.

== Synaptic ==
The original 1.0 release included Synaptic.. but it's a heavy bugger and perhaps not everyone really feels the need for it, so I didn't keep it for 1.0.1 
To get it back, it's simply a case of doing: 
'''''sudo apt-get update''''' - if you haven't done so for a while ( as in, days, not hours ) 
'''''sudo apt-get install synaptic''''' 
Then wait for a while as it downloads and installs.

You'll find Synaptic under System Tools once it's done.

== My PND don't work, why?! ==
Generally, it'll be because of library differences.. I'm still trying to figure out the best way to deal with this, but you've got the Debian armel repository at your disposal, so you should be fine for a while!

== My PNDs don't automatically display on menu/desktop, why?! ==
Not sure about this.. kicking pndnotifyd seems to trigger it properly, but why it's not doing it automatically, I'm not so sure...

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-02-23T03:45:29Z

Stuckie: Some cleanup, and final bits and pieces left to add to get to the 1.0.1 release.

= Debian On SD =

''' PLEASE NOTE THAT THIS IS NOT FINISHED AND IS WORK IN PROGRESS.. ONCE THIS LINE HAS BEEN REMOVED, IT WILL BE "COMPLETE" '''

This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD&action=submit#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-debian6.0-minimal.tar.gz 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===

The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 
''Debian'' '''''nano /etc/skel/.profile''''' 
Add the following to the bottom
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &

Should probably copy more over but, this'll do for now. 
Need to figure out why .xinitrc isn't even being looked at for some reason.... this works for now though.

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
Currently, there's a few issues with the touchscreen - it'll cause X to go mad and chew through 100% CPU as soon as you touch it. 
However, it's still usable so we'll add in the libraries and configure it anyway. 
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
There's an evtouch library.. haven't looked at that yet but it may work better?

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

While we don't necessarily need Network Manager, it's a damn sight more easier to use than battering iwconfig et al from the Terminal: 
''Debian'' '''''apt-get install network-manager-gnome''''' 
This'll take a long time as it pulls in quite a lot of stuff...

=== Bluetooth ===
Don't really have any bluetooth devices to test.. though I could try tethering my phone by bluetooth...

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

That's essentially the kernel setup... we'll cover the boot script later.

==== RC Scripts ====
There's quite a number of RC scripts kicking about.. we'll nick most of them from Angstrom again and deal with them one state at a time.

===== rc0.d =====
sudo cp /etc/rc0.d/K05led-config /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K31pandora-state /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc0.d/

===== rc1.d =====
sudo cp /etc/rc1.d/K05led-config /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K31pandora-state /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc1.d/

===== rc2.d =====
sudo cp /etc/rc2.d/S05led-config /media/mmcblk0p1/etc/rc2.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc3.d =====
sudo cp /etc/rc3.d/S05led-config /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc3.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc4.d =====
sudo cp /etc/rc4.d/S05led-config /media/mmcblk0p1/etc/rc4.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc5.d =====
sudo cp /etc/rc5.d/S05led-config /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc5.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc6.d =====
sudo cp /etc/rc6.d/K05led-config /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K31pandora-state /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc6.d/

===== rcS.d =====
sudo cp /etc/rcS.d/S39pandora-state /media/mmcblk0p1/etc/rcS.d/

You were expecting led-config again, weren't you!

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd'''''

==== Misc Init Scripts and Things====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver
''Angstrom'' '''''sudo cp /etc/default/leds /media/mmcblk0p1/etc/default'''''
''Angstrom'' '''''sudo cp /etc/default/usb-gadget /media/mmcblk0p1/etc/default'''''

And some more stuff to install in Debian: 
''Debian'' '''''apt-get install libnotify-bin'''''

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now.. 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''
''Debian'' '''''rm -rf /usr/pandora/mmenu''''' - these are just PNDs that call the programs installed in Angstrom from MiniMenu. We don't have these programs installed on Debian so, they're useless to us. 

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the sudo group ( it's wheel on Angstrom. ) Actually, there's a few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G sudo <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 

Angstrom also uses a netdev group... not sure what creates that or what it's for... ignoring for now.

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now.

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic.

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-02-23T03:21:57Z

Stuckie: Lots more updates.. effectively following this should get it to boot.. there's a few niggles left but working on them.

= Debian On SD =

''' PLEASE NOTE THAT THIS IS NOT FINISHED AND IS WORK IN PROGRESS.. ONCE THIS LINE HAS BEEN REMOVED, IT WILL BE "COMPLETE" '''

This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD&action=submit#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-debian6.0-minimal.tar.gz 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp''''' 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===

The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 
''Debian'' '''''nano /etc/skel/.profile''''' 
Add the following to the bottom
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &

Should probably copy more over but, this'll do for now. 
Need to figure out why .xinitrc isn't even being looked at for some reason.... this works for now though.

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
Currently, there's a few issues with the touchscreen - it'll cause X to go mad and chew through 100% CPU as soon as you touch it. 
However, it's still usable so we'll add in the libraries and configure it anyway. 
''Debian'' '''''apt-get install libxcb-dri2-0 xserver-xorg-input-tslib libts-bin''''' 
''Debian'' '''''nano /etc/profile.d/tslib.sh'''''
#!/bin/sh
TSLIB_TSDEVICE=/dev/input/event5
TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_TSDEVICE TSLIB_CONFFILE

We'll do the rest of it on First Boot. 
There's an evtouch library.. haven't looked at that yet but it may work better?

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The wl1251-init script uses busybox. While you could edit the script and remove the dependency on busybox, it's probably better to just install busybox so that there are less changes to deal with - seeing as it's only about 600kB. 
''Debian'' '''''apt-get install busybox'''''

-- add information on networkmanager

The rest come in the Kernel install below, and the PND install too.

=== Bluetooth ===
Don't really have any bluetooth devices to test.. though I could try tethering my phone by bluetooth...

=== Kernel and Misc Bits and Pieces ===
The kernel *should* be easy... grabbing a fresh set would've been advisable, but this doesn't seem to come with everything so we'll steal from our running system again.

''Angstrom'' '''''sudo cp -R /lib/modules/2.6.27.46-omap1 /media/mmcblk0p1/lib/modules''''' 
''Angstrom'' '''''sudo cp -R /lib/firmware /media/mmcblk0p1/lib/firmare''''' 
''Angstrom'' '''''sudo cp /boot/uImage /media/mmcblk0p1/boot/uImage'''''

That's essentially the kernel setup... we'll cover the boot script later.

==== RC Scripts ====
There's quite a number of RC scripts kicking about.. we'll nick most of them from Angstrom again and deal with them one state at a time.

===== rc0.d =====
sudo cp /etc/rc0.d/K05led-config /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K31pandora-state /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc0.d/

===== rc1.d =====
sudo cp /etc/rc1.d/K05led-config /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K31pandora-state /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc1.d/

===== rc2.d =====
sudo cp /etc/rc2.d/S05led-config /media/mmcblk0p1/etc/rc2.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc3.d =====
sudo cp /etc/rc3.d/S05led-config /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc3.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc4.d =====
sudo cp /etc/rc4.d/S05led-config /media/mmcblk0p1/etc/rc4.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc5.d =====
sudo cp /etc/rc5.d/S05led-config /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc5.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc6.d =====
sudo cp /etc/rc6.d/K05led-config /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K31pandora-state /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc6.d/

===== rcS.d =====
sudo cp /etc/rcS.d/S39pandora-state /media/mmcblk0p1/etc/rcS.d/

You were expecting led-config again, weren't you!

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd'''''

==== Misc Init Scripts and Things====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 
''Angstrom'' '''''sudo cp /usr/bin/usb-gadget /media/mmcblk0p1/usr/bin''''' 
''Angstrom'' '''''sudo cp /etc/profile.d/op_env.sh /media/mmcblk0p1/etc/profile.d''''' - effectively just tells SDL to use tslib driver

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /usr/bin/pnd* /media/mmcblk0p1/usr/bin''''' - there are a few pnd binaries, these include pnd_info, pnd_run, pndevmapperd and pndnotifyd. 
''Angstrom'' '''''sudo cp /usr/lib/libpnd.so.1.0.1 /media/mmcblk0p1/usr/lib''''' - obviously nothing'll work without the pnd libraries! 

There are a bunch of scripts and PNDs hiding in /usr/pandora.. we may as well grab them over as well. 
''Angstrom'' '''''sudo cp -R /usr/pandora /media/mmcblk0p1/usr''''' 

We need to do a symlink to the library properly now.. so, Debian... 
''Debian'' '''''ln -s /usr/lib/libpnd.so.1.0.1 /usr/lib/libpnd.so.1'''''

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

''Debian'' ''''''adduser <username>''''' - obviously, replace <username> with what you want; for example ''adduser pandora''.

One interesting thing I've noticed happens, is sometimes it'll happily create your user... then not give you full permissions to your own folder.. so let's beat it a bit. 
''Debian'' '''''chown <username>:<username> /home/<username>''''' - replacing <username> with your actual username; for example ''chown pandora:pandora /home/pandora'' 

You'll probably want to use sudo, which will require you to be in the sudo group ( it's wheel on Angstrom. ) Actually, there's a few groups you'd want to be in, so we'll do that now. 
''Debian'' '''''usermod -a -G sudo <username>''''' - you know the drill now... example; ''usermod -a -G wheel pandora'' 
''Debian'' '''''usermod -a -G adm <username>''''' 
''Debian'' '''''usermod -a -G audio <username>''''' 
''Debian'' '''''usermod -a -G video <username>''''' 
''Debian'' '''''usermod -a -G plugdev <username>''''' 
''Debian'' '''''usermod -a -G users <username>''''' 

Angstrom also uses a netdev group... not sure what creates that or what it's for... ignoring for now.

Finally, /tmp can sometimes go mad so we shall fix that just now too. 
''Debian'' '''''chmod a+w /tmp'''''

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ext2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== First Boot ===

First Boot should bring you up to GDM in all it's splendour. But Wait! The touchscreen! IT IS MADNESS! 
If you've a USB keyboard, you can be one step ahead and do CTRL+ALT+F1 to jump to a terminal, but we're going to assume just the Pandora so we'll carry on and login.

Once LXDE has finished loading up, press FN+ALT+F2 and type "lxterminal" 
'''''sudo su''''' 
'''''export TSLIB_TSDEVICE=/dev/input/event5''''' 
'''''export TSLIB_CONFFILE=/etc/ts.conf''''' 
'''''ts_calibrate'''''

Touchscreen should behave itself now.

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic.

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-02-21T23:42:52Z

Stuckie: Massive update of information.. still not finished ( PND support needs adding, as does touch screen and other little bits and pieces here and there )

= Debian On SD =

''' PLEASE NOTE THAT THIS IS NOT FINISHED AND IS WORK IN PROGRESS.. ONCE THIS LINE HAS BEEN REMOVED, IT WILL BE "COMPLETE" '''

This is split into three main sections - Building from Scratch, Maintenance and Upgrades, Common Things To Do.

* Building From Scratch lets you customise everything from the outset, and lets you create your very own tailor-made distribution, rather than a pre-created one.
It does require a bit of Linux knowledge before diving in.. so if unsure, ask!

* Maintenance and Upgrades covers standard Debian maintenance if you're not usually a Debian user.
It'll also ( in the future ) cover how to upgrade your pre-built distribution with new drivers as the official OS gets updated.

* Common/Fun Things To Do will give you ideas on what to try in your new Debian installation.
Remember, this is a full desktop OS you now have squeezed into your hands, and feel free to share your cool ideas!

If you don't want to build from scratch, you have two choices;
* Grab a Minimal Install and continue from [http://pandorawiki.org/index.php?title=Debian_On_SD&action=submit#Desktop_Environment Desktop Environment]
* Grab a full build.

The latest minimal is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-debian6.0-minimal.tar.gz 
The latest full build is available here: http://www.stuckiegamez.co.uk/apps/pandora/Debian/pandora-squeeze-1.0.tar.bz2

Remember to untar with permissions ( include '''p''' in your arguments to tar ) on to your ext2 formatted SD card.

= Building From Scratch =
This isn't for the feint of heart.. if you don't understand something - stop! Ask or read up on it before continuing. While I haven't mangled my Pandora or PC in any way from doing this, it's still possible to make a mess, so be careful!

This is split into many parts.. it's advised to go through this in order.

* Getting a Minimal Install from Scratch
* Desktop Environment
* Device Drivers and PNDs
* Users and Permissions
* Reboot and Troubleshooting

== Getting a Minimal Install from Scratch ==

There are two options here:
* Linux PC
* On Pandora

=== Linux PC ===
On a Linux PC, run debootstrap to grab the version you want. We shall be using Squeeze today: 
'''''sudo debootstrap --arch armel --foreign squeeze /tmp/pandora-debian ftp://ftp.uk.debian.org/debian'''''
Grab a large SD card, and repartition it to have one large ext2 partition and format as normal. 
Copy all the files from /tmp/pandora-debian over to your new SD card partition. 
Put it in your Pandora. 
'''''sudo chroot /media/mmcblk0p1''''' -- assuming it's in your first slot. 
'''''/debootstrap/deboostrap --second-stage''''' 
... this takes a while...

=== Pandora ===
Alternatively, you can run cdebootstrap on the Pandora itself... this bypasses the need of doing the second-stage madness. 
Grab it from here: http://packages.debian.org/sid/cdebootstrap-static and select the armel package. 
Download it to /tmp preferably, but your home folder will do, or anywhere you like. For now, I shall assume you downloaded it to /tmp 
'''''cd /tmp''''' -- Again, if you downloaded elsewhere, change to that directory instead. 
'''''ar xv cdebootstrap*.deb''''' -- We're using the archive tool to extract with verbosity our cdebootstrap package. 
'''''sudo tar -zxvf data.tar.gz -C /''''' -- Now we're using tar to extract, with gzip support, again with verbosity, the file data.tar.gz, changing the Current directory to / so that it extracts systemwide on our NAND. We're running this command sudo so we have write permissions. 
Now we just run cdebootstrap-static with a few parameters, and wait. 
'''''cdebootstrap-static --allow-unauthenticated -f minimal squeeze /media/mmcblk1p1''''' -- What we're doing here, is we're allowing "unauthenticated" packages to be installed. As we don't, or probably don't, have the gnupg keychain stuff configured, all packaged will be "unauthenticated" regardless of whether they are or not. We're telling it we also want a minimal install of the squeeze release, and to install to where we have the mount point of Partition 1 of the SD card in Slot 1 - which you should have already partitioned and formatted as ext2! 
This takes a while... perhaps longer than doing the first stage on the PC and second-stage on Pandora.

== Desktop Environment ==
Now you have Debian, the world is yours for the taking!
Or something like that...

Debian comes with a wide variety of desktop environments and window managers; from XFCE as you use on Angstrom by default, to KDE, GNOME, LXDE, Fluxbox, Enlightenment, etc.. 
Now's the time to choose one of them to install.. be aware that the bigger they are, the longer they'll take to install and the more resources they will eat up while in use.. as a rough guide from heavy to light: 
* KDE
* GNOME
* Enlightenment
* XFCE
* LXDE
* Fluxbox

Having recently tested KDE myself, it doesn't quite seem to work properly, so I'd avoid that for the moment... especially as it takes about ten hours to install!

We shall install LXDE as it's a bit more light weight than XFCE and still provides a reasonable mainstream environment. While I do prefer Fluxbox overall, it's a bit of a paradigm shift to use from your standard desktop machine.

If you haven't already, chroot into your environment.
You should already be root, so we'll get on with the installing.

'''''apt-get install lxde'''''

This may well take an age, so go do something else in the meantime. 
You may also want a login manager.. your choices are amongst XDM, GDM, KDM and SLIM to name a few. KDM is perhaps a bit heavy, whereas GDM works fairly well even though it's rather heavy too. SLIM is what you use on Pandora anyway, and XDM is rather basic but usable all the same. GDM is automatically pulled in via LXDE anyway, so we may as well just use that for now.

Once it's done, we'll start tackling the Drivers.

== Device Drivers and PNDs ==
We shall tackle these one at a time, as there's quite a few of them.

* X Display Driver
* SGX Drivers
* Keymap
* Nubs
* Touchscreen
* Wifi
* Bluetooth
* Kernel and Misc Bits and Pieces
* PNDs

=== X Display Driver ===
Debian has a NEON-optimised omapfb driver. We shall use this, and pinch some configuration gubbins from Angstrom.

'''''apt-get install xserver-xorg-video-omap3'''''

We now need to create an xorg.conf .. though it'll be rather minimal as we only really want to overload what graphics device setup it has, so: 
'''''nano /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

Most of this is pinched from the Angstrom xorg.conf minus the fb Option at the bottom, as our framebuffer has a different device node.

That should be all you need for basic X though.

=== SGX Drivers ===
Most of this has been pinched from http://elinux.org/BeagleBoardDebian#SGX_Video_Acceleration - why rewrite the wheel? 
This mostly works apart from a few caveats, so I shall repeat it here for future reference and to keep all information in one place, and I've uploaded the resulting tarballs for convenience.

You can either follow the above guide - substituting the BeagleBoard for the Pandora, or use the following preconfigured packages. 
'''''cd /tmp'''''
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_4_00_00_01_libs.tar.gz''''' ~20MB Libraries themselves 
'''''wget -c http://www.stuckiegamez.co.uk/apps/pandora/Debian/GFX_Linux_SDK.tar.gz''''' ~220MB Demos and SDK gubbins 

Technically, you don't really need that fat 220MB GFX_Linux_SDK tarball unless you really want it, or want to test the libraries are in place. 
I'll cover installing both anyway...

==== Libraries ====
'''''tar -zxvf GFX_4_00_00_01_libs.tar.gz''''' 
'''''chmod +x ./install-SGX.sh''''' 
'''''./install-SGX.sh''''' 
'''''rm /devmem2_0.0-0ubuntu1_armel.deb''''' - this is particularly useless to us... and why it dumps it at root, I don't know! 

That package contains ES2, ES3 and ES5 libraries.. we're only really interested in ES2 ( haven't tried if ES3 or ES5 would even work! ) so: 
'''''cd /usr/lib''''' 
'''''ln -s ES2.0/* .''''' 

Not hugely clean, but it works. For the brave, you could try ES3 or ES5 but.. you're on your own!

==== Demos/SDK ====
'''''cd /tmp''''' 
'''''tar -zxvf OGLES.tar.gz''''' 
'''''tar -zxvf OGLES2.tar.gz''''' 

You can't run anything yet ( well, you might since you've chrooted in via Angstrom ) so we'll leave them in /tmp for the moment - or move them elsewhere - such as /opt if you're worried about Debian wiping out /tmp on boot.

=== Keymap ===

The keymap is fun and comes in two parts - the mapping extension, and an xmodmap script. 
We shall steal them from Angstrom.. so open up another Terminal. 
As of now, I shall prefix Angstrom commands with ''Angstrom'' and Debian commands with ''Debian'' so you know which Terminal to type them in.

''Angstrom'' '''''sudo cp /etc/keymap-extension-2.6.map /media/mmcblk0p1/etc''''' - this does assume you've got your SD card mounted in slot one, and with one ext2 partition.. adjust as necessary. 
''Angstrom'' '''''sudo cp /etc/skel/.pndXmodmap /media/mmcblk0p1/etc/skel''''' - as above. 
''Debian'' '''''nano /etc/skel/.xinitrc''''' 
xmodmap ~/.pndXmodmap
whoami > /tmp/currentuser
killall -1 pndnotifyd &

Should probably copy more over but, this'll do for now.

=== Nubs ===
The nubs just require some more config stuff to be copied over, and a few rc scripts to be setup right. 
''Angstrom'' '''''sudo cp -R /etc/pandora /media/mmcblk0p1/etc''''' 
This also copies over configurations for the LCD backlight, some pmenu and mmenu stuff, and some PND configuration bits.

''Angstrom'' '''''sudo cp /etc/init.d/pandora-state /media/mmcblk0p1/etc/init.d''''' - pandora-state restores nubs and backlight settings, as well as saves them on exit.

Configuration utils come in with the PND installation below.

=== Touchscreen ===
tslib setup... though need to check if evdev will do it better as it seems to torment X at 100% CPU when the touchscreen is used just now...

=== Wifi ===
Wifi is fun... most of it will come in the kernel and modules/firmware pack when we get to it, but there's some ancillary scripts and things that lay in wait to catch you off guard! 
''Angstrom'' '''''sudo cp /etc/init.d/wl1251-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/50-compat_firmware.rules /media/mmcblk0p1/lib/udev/rules.d''''' 
''Angstrom'' '''''sudo cp /lib/udev/rules.d/compat_firmware.sh /media/mmcblk0p1/lib/udev/rules.d'''''

The rest come in the Kernel install below, and the PND install too.

=== Bluetooth ===
Don't really have any bluetooth devices to test.. though I could try tethering my phone by bluetooth...

=== Kernel and Misc Bits and Pieces ===
The kernel is easy... I advise grabbing a clean set from openpandora.org .. so we shall do that just now: 
''Debian'' '''''cd /'''''
''Debian'' '''''wget -c http://openpandora.org/firmware/images/modules-2.6.27-pandora+r24+git4bc490f3aa30d331d624faf2816851211a05f0b7-r24-omap3-pandora.tgz''''' - module and firmware pack. 
''Debian'' '''''wget -c http://openpandora.org/firmware/images/uImage-2.6.27-pandora+r24+git4bc490f3aa30d331d624faf2816851211a05f0b7-r24-omap3-pandora.bin''''' - kernel itself. 
''Debian'' '''''mv uImage* /boot/uImage''''' - yea, typing THAT long thing out again was going to happen! 
''Debian'' '''''tar -zxvpf modules*.tgz''''' - again, no typing the giant filename! 
''Debian'' '''''rm modules*.tgz''''' - bye bye giant scary named tarball!

That's essentially the kernel setup... we'll cover the boot script later.

==== RC Scripts ====
There's quite a number of RC scripts kicking about.. we'll nick most of them from Angstrom again and deal with them one state at a time.

===== rc0.d =====
sudo cp /etc/rc0.d/K05led-config /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K31pandora-state /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc0.d/
sudo cp /etc/rc0.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc0.d/

===== rc1.d =====
sudo cp /etc/rc1.d/K05led-config /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K31pandora-state /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc1.d/
sudo cp /etc/rc1.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc1.d/

===== rc2.d =====
sudo cp /etc/rc2.d/S05led-config /media/mmcblk0p1/etc/rc2.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc3.d =====
sudo cp /etc/rc3.d/S05led-config /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc3.d/
sudo cp /etc/rc3.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc3.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc4.d =====
sudo cp /etc/rc4.d/S05led-config /media/mmcblk0p1/etc/rc4.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc5.d =====
sudo cp /etc/rc5.d/S05led-config /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndevmapperd-init /media/mmcblk0p1/etc/rc5.d/
sudo cp /etc/rc5.d/S30pndnotifyd-init /media/mmcblk0p1/etc/rc5.d/

oprun-init scripts live here too, but you're probably not going to want them!

===== rc6.d =====
sudo cp /etc/rc6.d/K05led-config /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K31pandora-state /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndevmapperd-init /media/mmcblk0p1/etc/rc6.d/
sudo cp /etc/rc6.d/K40pndnotifyd-init /media/mmcblk0p1/etc/rc6.d/

===== rcS.d =====
sudo cp /etc/rcS.d/S39pandora-state /media/mmcblk0p1/etc/rcS.d/

You were expecting led-config again, weren't you!

==== Battery Monitor ====
You'll likely want to know how much battery power you have! 
''Debian'' '''''apt-get install apmd'''''

==== Misc Init Scripts ====
There are a few random init scripts we need for things: 
''Angstrom'' '''''sudo cp /etc/init.d/led-config /media/mmcblk0p1/etc/init.d''''' - configure the LEDs properly. 
''Angstrom'' '''''sudo cp /etc/init.d/usb-gadget /media/mmcblk0p1/etc/init.d''''' - for initializing the usb gadget device - g_cdc for USB networking, for instance. 

=== PNDs ===
There are some init scripts you need for the PNDs to work. These are: 
''Angstrom'' '''''sudo cp /etc/init.d/pndevmapperd-init /media/mmcblk0p1/etc/init.d''''' 
''Angstrom'' '''''sudo cp /etc/init.d/pndnotifyd-init /media/mmcblk0p1/etc/init.d''''' 

== Users and Permissions ==
You may be wondering why Users haven't been done till the very end.. we've edited the /etc/skel setup which will be used to create your user details.

If you have already jumped the gun and created a user previously, all changes we've done to /etc/skel will need to be mirrored in your home folder!

== Reboot and Troubleshooting ==

=== auto/boot.txt ===
We need either an autoboot.txt or a boot.txt now or we won't be able to boot up Debian. 
There's no difference between either, other than autoboot will cause the Pandora to automatically boot from SD if it finds it, whereas boot requires holding the right shoulder button as usual. 
''Debian'' '''''nano /autoboot.txt''''' - again, you could use boot.txt instead and press the right shoulder button during boot. 
setenv bootargs debug root=/dev/mmcblk0p1 rw rootdelay=2 console=ttyS0,115200n8 vram=6272K omapfb.vram=0:3000K
ex2load mmc 0:1 0x80300000 /boot/uImage
bootm 0x80300000

All that's really left now is to reboot and catch any issues that may crop up!

=== Cleanup ===
Potential clean-ups that should occur is packaging up the Pandora specific libraries and scripts into .deb files for maintenance purposes if nothing else. We can then either try and get them fed back into Debian, or provide our own Debian repo for Pandora.

= Maintenance and Upgrades =
Maintenance on Debian is very easy.. it's just a case of running '''''sudo apt-get update && sudo apt-get upgrade''''' from a console, or using Synaptic.

= Common/Fun Things To Do =
There's a wealth of power at your fingertips with Debian, so place your fun things to do here!

[[Category:Documentation]] [[Category:Operating Systems]]

Debian On SD

2011-02-20T16:06:06Z

Stuckie: Initial Page for Debian on SD project... this isn't finished but will include full documentation on how to roll your own, as well as maintenance and help.

Software projects

2011-02-19T20:50:08Z

Stuckie: changing StuckieGamez to Stuckie and adding Debian OS details.

''These lists were last updated on 2011-02-18 to include the latest files from [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps], the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive], and the [[Software_projects#Forums|community forums]].''

This is a list of '''all software projects''' for the Pandora ''excluding'' emulators (see: [[Emulator list]]), games (see: [[Games]]), and development tools (see: [[Development Tools]]). However, this list ''does'' include the development apps that can be used on the Pandora itself.

See the [[Port Requests]] article for open-source projects which ''could'' be ported but have not been taken on by anyone yet.

==Released software==
If you would like to add something, you could edit the wiki or [http://www.gp32x.com/board/index.php?/topic/54923-the-pandora-apps-thread/ post in this forum thread]. If different versions of a software were released, please make sure the "release date" is the most recent one.

Please click on the little squares to sort by different categories (such as Release date, Type, etc.)

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[AbiWord]]
|2011-01-17
|sebt3 (packaging)
|Office - word processor
|[http://sebt3.openpandora.org/pnd/abiword.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__919843 Discussion]
|-
|Alarm Clock ('''beta''')
|2011-02-01
|sebt3 (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,303 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/ Discussion]
|-
|[[Anki]] 1.2.4 ('''beta''')
|2011-01-25
|Drack (port)
|Office - memory aid
|[http://dl.dropbox.com/u/8938380/anki-1.2.4-drack1.pnd Download]
|Discussion [http://www.gp32x.com/board/index.php?/topic/56293-anki-friendly-intelligent-flashcards/ 1] [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/ 2]
|-
|[[Arora]] (for [[Minimenu]])
|2010-05-26
|Skeezix (quick hack)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,69 Archive]
|Needed to run Arora from Minimenu
|-
|[[Audacious]] 2.4.3
|2011-02-03
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/audacious.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54792-audacious/page__view__findpost__p__937089 Discussion]
|-
|[[b7zip]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Background killer
|2010-06-07
|Notaz
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/background_killer.inf Apps]
|Kill background tasks in minimenu. [http://www.gp32x.com/board/index.php?/topic/56008-zelda-classic-for-pandora/page__st__15__p__907940&#entry907940 Not needed] since Hotfix 3.
|-
|[[Banshee]]
|2010-10-23
|sebt3 (port)
|Audio - music player
|[http://sebt3.openpandora.org/pnd/banshee.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57144-portrequest-banshee/ Discussion]
|-
|[[Bournal]]
|2010-08-11
|
|Office - journal
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,181 Archive]
|encrypted diary program
|-
|[[Chromium]]
|2010-09-04
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,90 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56474-chromium-4-with-ssl-and-chromium-snapshot/ Discussion]. SSL now works
|-
|[[Chromium]]-Dev v10.0.642.1
|2011-01-16
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,201 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58234-chromium-dev-snapshot-v10-0-642-1/ Discussion] [http://www.gp32x.com/board/index.php?/topic/57017-chromium-dev-updated/ (old)]. The latest (non-stable) snapshot.
|-
|[[Claunch]] ('''beta''')
|2010-10-14
|Lamoxx
|System - app launcher
|[http://userpages.uni-koblenz.de/~bbrink/tmp/claunch_beta.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57040-claunch-minimal-flexible-rom-pickerapplication-launcher/ Discussion]
|-
|[[Claws Mail]]
|2010-10-03
|sebt3 (port)
|Network - mail client
|[http://sebt3.openpandora.org/pnd/claw-mail.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,223 Archive]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920075 Discussion]. Hopefully doesn't save to NAND (testing needed).
|-
|[[Cmus]]
|2010-11-27
|otherguy66 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,251 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57682-cmus-pnd-installer/page__gopid__928328&#entry928328 Discussion]. Installed to [[NAND]] (1mb). Text mode player
|-
|[[Code::blocks]]
|2010-06-07
|sinoth (port)
|Development - IDE
|[http://sinoth.net/pandora/codeblocks.pnd.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/54091-codeblocks-on-the-pandora/ Discussion].
|-
|Community Codec Package
|2010-05-25
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/CodecPack.inf Apps] [http://openpandora.org/downloads/CodecPack.pnd Official site]
|Make sure you have this installed
|-
|[[Comix]]
|2010-06-30
|Pontus Ekberg
|Graphics - image viewer
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/comix.inf Apps]
|
|-
|[[Conky]]
|2010-08-03
|daniel3000 (port)
|System
|[http://www.hermocom.com/en/downloads/openpandora/Conky.pnd/ Download]
|System monitor. [http://www.gp32x.com/board/index.php?/topic/55775-conky Discussion]
|-
|[[DarCalc]]
|2010-08-28
|JP
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,196 Archive]
|See also the calculator emulators [[Emulator list|here]]
|-
|[[Deadbeef]] 0.4.3
|2010-11-01
|CME (port), sebt3 (port)
|Audio - music player
|[http://root.shadow-node.net/public/cme/pnd/deadbeef.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55178-deadbeef-compiled-with-codesourcery-gcc-2010q1/ Discussion]
|-
|[[dia]]
|2010-10-03
|sebt3 (port)
|Office - diagrams
|[http://sebt3.openpandora.org/pnd/dia.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56863-dia/ Discussion]
|-
|[[DrawSWF]] ('''beta''')
|2010-07-10
|Chrysipp (port)
|Graphics - vector drawing
|[http://www.pandorasource.de/download.php?view.158 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10105%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhilcfdbJF4gEtvmTIwMjO9EFqUQ-A Discussion (German)]. Must have Java.pnd installed. {{HideableNotes|A small drawing program. The drawing can be exported as a Flash animation, which then shows its gradual development.}}
|-
|[[Ekiga]] ('''beta''')
|2010-10-29
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/ekiga.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/ Discussion]. Online phone & video calls. '''[http://www.gp32x.com/board/index.php?/topic/57263-ekiga/page__view__findpost__p__924918 Doesn't work]'''{{HideableNotes| though it can be made to work through Debian, [[Extend Utils]]: [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/]}}
|-
|[[Enna]] ('''beta''')
|2010-07-08
|sebt3 (port)
|Media Player
|[http://sebt3.openpandora.org/pnd/enna.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55113-enna/ Discussion]
|-
|[[Exaile]]
|2010-04-28
|Pickle (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,43 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Exaile.inf Apps]
|Needs Community Codec Pack to run
|-
|[[Extend Utils]]
|2010-06-22
|Stuckie
|System
|[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ 1], [http://www.gp32x.com/board/index.php?/topic/56462-pandora-phone-openoffice-amsn-yes-d/ 2]. Debian in an extend. Allows you to run over 29,000 programs.
|-
|[[F3]]
|2010-10-17
|slaeshjag (port)
|System
|[http://stuffs.slaeshjag.org/F3.tar Download]
|Test for fake flash memory (like H2testw). [http://www.gp32x.com/board/index.php?/topic/57063-some-quick-tips-to-help-avoid-fake-sd-cardsflash-media/page__view__findpost__p__922187 Discussion]
|-
|[[FBReader]] 0.12.10
|2010-07-26
|zx81 (port)
|Office - eBook Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,168 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fbreader-0.12.10.inf Apps]
|
|-
|[[Fennec]] 4.0b3 ('''beta''')
|2011-02-03
|Mozilla Team, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,75 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Fennec40.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58514-fennec-4-0b3/ Discussion]
|-
|[[Fennec]] 3.6.3
|2010-05-30
|Mozilla Team, Iampanis (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/fennec.inf Apps]
|mobile version of FireFox
|-
|[[Figaro's Password Manager 2]] ('''beta''')
|2010-11-30
|mcobit (port)
|System - passwords
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,254 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57714-figaros-password-manager-2/ Discussion]
|-
|[[Firefox]]
|2010-06-14
|Evildragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,91 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/FireFox.inf Apps]
|
|-
|[[Firefox]] 3.6.13
|2011-01-28
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-3.6.13-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/56903-firefox-3-6-10/ Discussion (old)], [http://www.gp32x.com/board/index.php?/topic/58425-firefox-3-6-13/ news/discussion]
|-
|[[Firefox]] 4.0B10 ('''beta''')
|2011-02-01
|Mozilla team, hdonk (port)
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox-4b10-0.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/58489-firefox-4-beta-10/ Discussion]
|-
|[[FlipClock]] ('''beta''')
|2011-02-05
|torpor (port)
|Office
|[http://sebt3.openpandora.org/pnd/alarmclock.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58548-port-flipclock-for-pandora/ Discussion], also [http://www.gp32x.com/board/index.php?/topic/58479-alarm-clock-app/page__view__findpost__p__937668 here]
|-
|[[Fotoxx]]
|2010-12-06
|Kornelix mcobit (port)
|Graphics - photo editor & manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,261 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57777-fotoxx/ Discussion]
|-
|[[Freemind]]
|2010-11-21
|mcobit (port)
|Office - mind mapping
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,4,240 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57605-freemind-a-mindmap-tool/ Discussion]. Needs java.pnd installed.
|-
|[[GCalc]]
|2010-11-23
|mcobit (port)
|Office - calculator
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,241 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57636-gcalc-graphic-calculator/ Discussion]. Needs java.pnd installed. See also the calculator emulators [[Emulator list|here]]
|-
|[[Geany]] v0.19-1
|2010-09-16
|bompo (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,14,205 Archive] [http://dl.dropbox.com/u/39448/pandora/geany.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55432-geany/ Discussion]
|-
|[[gedit]]
|2010-10-03
|sebt3 (port)
|Office - text editor
|[http://sebt3.openpandora.org/pnd/gedit.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56862-gedit/ Discussion]
|-
|[[gerbv]]
|2010-09-14
|bompo (port)
|Office - EDA
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,202 Archive]
|viewer for Gerber RS-274X, Excellon drill, & CSV pick-and-place files
|-
|[[gFTP]] 2.0.18 ('''beta''')
|2010-07-01
|sebt3 (port)
|Network - FTP client
|[http://sebt3.openpandora.org/pnd/gftp.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54931-gftp/ Discussion]
|-
|[[GIMP]] v2.6 ('''beta''')
|2010-06-06
|daniel3000 (quick hack)
|Graphics - image editor
|[http://www.stuckiegamez.co.uk/apps/pandora/gimp-2.6.pnd Download]
|Read instructions [http://www.gp32x.com/board/index.php?/topic/54071-ubuntu-or-other-dist-alternative/page__p__868411&#entry868411 here]
|-
|[[Gmu Music Player]] 0.7.2
|2010-12-29
|wejp
|Audio - music player
|[http://wejp.k.vu/files/gmu-0.7.2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58009-gmu-music-player-0-7-2/ Discussion] [http://www.gp32x.com/board/index.php?/topic/55007-gmu-music-player-0-7-1-released/ (old)]
|-
|[[Gnomad 2]]
|2010-10-18
|sebt3 (port)
|Audio - music manager
|[http://sebt3.openpandora.org/pnd/gnomad2.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57088-gnomad2/ Discussion]
|-
|[[Gnome Music Player Client]] (GMPC) 0.20.0 ('''beta''')
|2010-08-01
|tsh (port)
|Audio - music player
|[https://sites.google.com/site/tshpandorastuff/file-cabinet/gmpc0.20.0.pnd?attredirects=0&d=1 Download]
|[http://www.gp32x.com/board/index.php?/topic/55664-gmpc-beta/ Discussion]
|-
|[[Gnumeric]]
|2011-01-17
|sebt3 (port)
|Office - spreadsheet
|[http://sebt3.openpandora.org/pnd/gnumeric.pnd Download]
|Stand-alone PND. [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__920072 Discussion]
|-
|[[GoldenDict]] 0.9.0Svn
|2010-09-27
|Hitnrun (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,8,209 Archive] [http://www.rangelreale.com/pandora/goldendict.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56802-goldendict-0-9-0svn/ Discussion]
|-
|[[GParted]]
|2011-02-05
|sebt3 (port)
|System - partition
|[http://sebt3.openpandora.org/pnd/gparted.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Discussion]
|-
|GQview
|2010-07-27
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/GQview.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55559-gqview-pnd-image-viewer-available/ Discussion]
|-
|[[Grafx2]]
|2010-12-30
|pulkomandy, yrizoud, mcobit (port)
|Graphics - image editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,264 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58016-grafx2/ Discussion]. For pixel art.
|-
|[[Groove]]
|2010-07-19
|Elias Woods, bompo (port)
|Network - radio
|[http://dl.dropbox.com/u/39448/pandora/Groove.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55363-groove/ Discussion]. [http://en.wikipedia.org/wiki/Grooveshark Grooveshark] client. '''Warning''': {{HideableNotes|Requires installing dependencies with opkg. See discussion thread.}}
|-
|[[Gwaei]]
|2010-11-26
|Zachary Dovel mcobit (port)
|Office - dictionary
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,249 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57674-gwaei-port-japanese-english-dictionary/ Discussion]. Japanese-English.
|-
|[[HomeBank]] 4.3
|2011-02-02
|Maxime Doyen, mcobit (port)
|Office - money manager
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,296 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58506-homebank/ Discussion]
|-
|Hotfix 4
|2010-08-31
|Pandora team
|System
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/HotFix4-Zaxxon.inf Apps] [http://openpandora.org/downloads/HotFix4-Zaxxon.pnd Official site]
|Make sure you have this installed
|-
|[[Inkscape]] ('''beta''')
|2010-10-08
|sebt3 (port)
|Graphics - vector drawing
|[http://sebt3.openpandora.org/pnd/inkscape.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56954-inkscape/ Discussion]. Currently very slow.
|-
|[[Java]] Pnd ('''beta''')
|2010-11-21
|WizardStan (port)
|System - dependency
|[http://rebirthofxeen.com/files/pandora/java.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57598-java-pnd/ Discussion]. Run Java apps.
|-
|[[jEdit]]
|2010-11-22
|mcobit (port)
|Office - text editor
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,244 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57614-jedit-programmers-text-editor/ Discussion]. For programmers. Needs java.pnd installed.
|-
|[[jChemPaint]]
|2010-11-23
|mcobit (port)
|Graphics - molecule drawing
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,242 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57633-jchempaint/ Discussion]. Needs java.pnd installed.
|-
|[[jMol]]
|2010-11-22
|mcobit (port)
|Graphics - molecule viewing in 3D
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,243 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57618-jmol-3d-molecule-viewer/ Discussion]. Needs java.pnd installed.
|-
|[[jMP3 Player]]
|2010-07-10
|jaijuju
|Audio - music player
|[http://www.pandorasource.de/download.php?view.156 Download]
|[http://code.google.com/p/jmp3player/ Website]. Java.pnd required.
|-
|[[KCHMViewer]] 5.2
|2010-10-05
|Hitnrun (port)
|Office - CHM Reader
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,215 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56901-kcmviewer/ Discussion.] Windows help files reader.
|-
|[[KDiff 3]]
|2011-02-03
|Joachim Eibl
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,299 Archive]
|[http://boards.openpandora.org/index.php?/topic/1440-kdiff3-0995-pandora-3/ Discussion]. Merge 2 or 3 text input files or directories
|-
|[[Liferea]]
|2010-07-06
|sebt3 (port)
|Network - RSS Reader
|[http://sebt3.openpandora.org/pnd/liferea.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55089-liferea/ Discussion]
|-
|[[Linphone]] ('''beta''')
|2011-01-20
|sebt3 (port)
|Network - VOIP
|[http://sebt3.openpandora.org/pnd/linphone.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58289-linphone Discussion]. Online phone calls.
|-
|[[Me TV]]
|2010-10-19
|sebt3 (port)
|Network - digital TV
|[http://sebt3.openpandora.org/pnd/metv.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56987-port-request-me-tv/page__p__921501&#entry921501 Discussion]
|-
|[[Merkaartor]] 0.17.0
|2011-01-27
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/merkaartor.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56656-merkaartor-or-other-osm-editor/page__p__922345&#entry922345 Discussion]
|-
|[[MilkyTracker]]
|2010-06-23
|Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,102 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/milkytracker.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/57612-remember-the-only-2-keyboard-buttons-at-once-limitation/ Discussion]
|-
|[[Minitube]] 1.3
|2011-01-13
|Flavio Tordini, sebt3 (port)
|Network - Youtube client
|[http://sebt3.openpandora.org/pnd/?f=minitube.pnd Download]
|Discussion: [http://www.gp32x.com/board/index.php?/topic/55952-minitube-1-1/ v1.1] [http://www.gp32x.com/board/index.php?/topic/58183-minitube-1-3/ v1.3]. Youtube browser/player
|-
|[[mtPaint]]
|2010-07-27 2010-12-29
|Mark Tyler, daniel3000 (port 1), chris_c (port 2)
|Graphics - image editor
|[http://www.hermocom.com/en/downloads/openpandora/mtPaint.pnd/ Download (port 1)] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,263 Archive (port 2)]
|[http://www.gp32x.com/board/index.php?/topic/55561-mtpaint-pnd-available/ Discussion]. For painting & pixel art. Ported twice.
|-
|[[Ommpc]] v0.5.4
|2010-10-06
|Tim Temple
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,133 Archive]
|MPD client [http://www.gp32x.com/board/index.php?/topic/55039-ommpc-v0-5-2/ Discussion]
|-
|[[OSM2Go]]
|2010-10-20
|sebt3 (port)
|Office - openstreetmap editor
|[http://sebt3.openpandora.org/pnd/osm2go.pnd Download]
|
|-
|[[Osmo]] ('''beta''')
|2010-09-03
|sebt3 (port)
|Office - personal organizer
|[http://sebt3.openpandora.org/pnd/osmo.pnd Download]
|[http://clayo.org/osmo/ Website] [http://www.gp32x.com/board/index.php?/topic/56455-osmo/ Discussion]
|-
|[[PanDebian]]
|2011-02-04
|Gregor
|System
|[http://codu.org/tmp/pandebian.pnd Download]
|[http://boards.openpandora.org/index.php?/topic/1474-pandebian/ Discussion]. [[Extend Utils]] alternative for Angstrom-Debian cooperation
|-
|Pandora Fractals
|2010-08-26
|Or Green
|Graphics - fractals
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Other/PFractals.inf Apps]
|fractal generator. [http://www.gp32x.com/board/index.php?/topic/51402-mandelbrot-set-generator-for-pandora/page__st__75 Discussion]
|-
|[[Pencil]] 0.4.4b ('''beta''')
|2010-11-04
|sebt3 (port)
|Graphics - animation
|[http://sebt3.openpandora.org/pnd/pencil.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57362-pencil/ Discussion]. 2D animation & drawing.
|-
|[[Pidgin]]
|2010-12-07
|sebt3 (port)
|Network - IM client
|[http://sebt3.openpandora.org/pnd/pidgin.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56898-pidgin/ Discussion]. This version no longer uses [[NAND]] to [http://www.gp32x.com/board/index.php?/topic/56898-pidgin/page__view__findpost__p__934658 store data].
|-
|[[PNDbuilder]]
|2011-02-08
|freedomdown (Ryan Dallaire)
|Development
|[http://freedomdown.squarespace.com/storage/pndb.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58587-pndbuilder/ Discussion]. Graphical PND maker.
|-
|PS3 Bluetooth Controller - Sixpair Utility
|2010-06-13
|Jim Paris, Samson Yeung, AireTamStrm (port)
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,4 Archive]
|Use a DualShock III Controller or SIXAXIS controller via USB
|-
|[[PSFreedom]]
|2010-09-23
|Notaz (port)
|Other
|[http://pandorapress.net/gruso/psfreedom.ko Download]
|[http://www.gp32x.com/board/index.php?/topic/56752-psfreedom-for-pandora/ Discussion]. Allows homebrew on your PS3.
|-
|[[qOrganizer]]
|2010-11-04
|sebt3 (port)
|Office - organizer
|[http://sebt3.openpandora.org/pnd/qorganizer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,113,233 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57359-qorganizer/ Discussion]
|-
|Quick Change CPU Speed
|2010-06-20
|Pleng
|System
|[http://www.strappysolutions.com/demos/pandora/CPUSpeeds.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54583-quick-change-cpu-speeds/ Discussion]. Add CPU speed presets to your menu.
|-
|[[Remmina]]
|2010-06-21
|mindlord (port)
|Network - VNC/RDP/XDMCP client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,99 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/remmina.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54610-remmina-0-7-5/ Discussion]. Control your PC from your Pandora.
|-
|[[RText]]
|2010-07-10
|Fifesoft, Chrysipp (port)
|Development - text editor
|[http://www.pandorasource.de/download.php?view.157 Download]
|[http://translate.googleusercontent.com/translate_c?hl=en&ie=UTF-8&sl=auto&tl=en&u=http://forum.gp2x.de/viewtopic.php%3Ff%3D59%26t%3D10106%26sid%3D5788c986948f651167f85a989309482d&prev=_t&rurl=translate.google.com&usg=ALkJrhivaNHspNg4XSb4aOpjskxivvIRXw Discussion (German)]. Must have Java.pnd installed.
|-
|[[Schism Mod Player]]
|2010-06-10
|?
|Audio - music tracker
|[http://www.pandorasource.de/download.php?view.79 Download]
|Player for MOD and XM.
|-
|[[Schism Tracker]]
|2010-06-19
|Storlek, Stuckie (port)
|Audio - music tracker
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,89 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/schismtracker.inf Apps]
|Clone of Impulse Tracker
|-
|[[Scite]] 2.21
|2010-10-20
|urjaman (port)
|Office - text editor
|[http://urjaman.dyndns.info/scite221.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57116-scite-2-21-ported/ Discussion]. Scintilla-based syntax highlighting text editor
|-
|SD Card Speed Fix
|2010-06-13
|mawler
|System
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,88 Archive]
|improve SD writing speed, but risk data corruption if writing is interrupted
|-
|[[Seq24]] ('''beta''')
|2010-09-06
|Gruso (port)
|Audio - music tracker
|[http://users.tpg.com.au/pw2007/seq24.beta1.pnd Download]
|MIDI sequencer. [http://www.gp32x.com/board/index.php?/topic/56517-seq24-midi-sequencer/ Discussion]
|-
|[[SMPlayer]] 0.6.9-1
|2011-02-02
|Ivanovic (port)
|Media Player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,114,298 Archive]
|MPlayer frontend. [http://www.gp32x.com/board/index.php?/topic/58511-smplayer/ Discussion]
|-
|[[SUPA]] 0.1-1 ('''beta''') Simple Updater for Pandora Applications
|2010-07-04
|Bryce Leo
|System - Application Downloader/Updater
|[http://drive.and-a-half.com/SUPA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/55023-supa-simple-updater-for-pandora-applications/ Discussion]. No GUI yet.
|-
|[[Synergy]]
|2010-10-09
|Lomaxx (port)
|Network - VNC client
|[http://www.mediafire.com/?npdbkibd5bm5ckb Download]
|[http://www.gp32x.com/board/index.php?/topic/56943-synergy-clientserver-as-pnd/ Discussion]. Control your PC from your Pandora.
|-
|[[Timidity MIDI Installer]]
|2011-01-12
|sebt3
|Audio - MIDI
|[http://sebt3.openpandora.org/pnd/timidity_midi_installer.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,273 Archive]
|[http://www.gp32x.com/board/index.php?/topic/58173-midi-installer/ Discussion]. MIDI patches installer. {{HideableNotes|It will allow you to have music for games that use MIDI. There are 3 different sound-sample sets packing different levels of sound quality. Installs to [[NAND]], though you can put them on SD card and then it's less than 2k on NAND (2 2-line files).}}
|-
|[[Transmission]]
|2010-09-24
|sebt3 (port)
|Network - BitTorrent client
|[http://sebt3.openpandora.org/pnd/transmission.pnd Download] [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,208 Archive]
|[http://www.gp32x.com/board/index.php?/topic/56553-bit-torrent-client/ Discussion].
|-
|[[TrueCrypt]] ('''beta''')
|2011-02-12 2010-07-18
|TJSomething (port) daniel3000 (old port)
|System - encryption
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,321 Archive] [http://www.hermocom.com/en/downloads/openpandora/TrueCrypt.pnd/ old version]
|[http://boards.openpandora.org/index.php?/topic/1763-truecrypt-port/ Discussion]. [http://www.gp32x.com/board/index.php?/topic/55347-truecrypt-pnd-ready-for-testing/ Discussion (old)].
|-
|[[Unace]]
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UnRar]]
|2010-08-06
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|[[UPX]] (The Ultimate Packer for eXecutables)
|2010-08-08
|joseluisjazz
|System - file archiver
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55761-decompressors/ Discussion]. Not a PND. {{HideableNotes|Once installed, adds functionality to Pandora's built-in archiving gui (squeeze)|}}
|-
|Viewnior 1.0
|2010-07-29
|daniel3000 (port)
|Graphics - image viewer
|[http://www.hermocom.com/en/downloads/openpandora/Viewnior.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55618-viewnior-pnd-available/ Discussion]
|-
|Vim Gvim 7.2 ('''beta''')
|2010-08-08
|joseluisjazz (port)
|Office - text editor
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55813-vim-gvim-7-2/ Discussion]. [http://www.vim.org/about.php About]. Not a PND.
|-
|[[VLC]] 1.1.0 ('''beta''')
|2010-10-12
|sebt3 (port)
|Media player (video & audio)
|[http://sebt3.openpandora.org/pnd/vlc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54922-vlc/ Discussion]
|-
|[[Wahcade]] Emulator Frontend b1 ('''beta''')
|2011-02-06
|Sigma (port)
|System - frontend
|[http://www.mediafire.com/?h8o33khvtcy3x8m Download]
|[http://boards.openpandora.org/index.php?/topic/1508-wahcade-frontend-beta1/ Discussion].
|-
|WiFi '''Beta test'''
|2010-11-05
|EvilDragon
|System
|[http://www.openpandora.org/downloads/WiFiBETA.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57364-wifi-betatest/ Discussion]. Might fix WiFi issues.
|-
|[[Xarchiver]] 0.5.2
|2010-12-04
|mcobit (port)
|System - file archiver
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,115,259 Archive]
|[http://www.gp32x.com/board/index.php?/topic/57748-xarchiver/ Discussion]
|-
|Xbindkeys
|2010-10-14
|Lomaxx (port)
|System
|[http://userpages.uni-koblenz.de/~bbrink/tmp/xbindkeys-1.8.3_prebuild.tar.gz Download]
|[http://www.gp32x.com/board/index.php?/topic/57037-xbindkeys-precompiled/ Discussion]. Configure hotkeys
|-
|[[XBMC]] 10.0 ('''beta''')
|2011-01-11
|sebt3 (port)
|Media Player
|[http://sebt3.openpandora.org/pnd/xbmc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/57106-xbmc-media-center/ Discussion]. Functions as "entertainment hub".
|-
|XFE 1.32.1
|2010-07-20
|Maxim Baranov, Roland Baudin, packaged by sebt3
|System - file manager, packager Graphics - image viewer Office - notepad
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,116,163 Archive]
|
|-
|[[Xournal]]
|2010-10-03
|sebt3 (port)
|Office - journal
|[http://sebt3.openpandora.org/pnd/xournal.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/56864-xournal/ Discussion]. Can annotate PDFs.
|}
===Operating systems & skins===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|Basic Gray
|2010-11-25
|milkshake
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=506 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueFuture
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,239 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|BlueWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=434 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Executive
|2010-11-27
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,250 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928158 Discussion]
|-
|Gray Is Sexy
|2010-11-27
|milkshake
|Minimenu skin
|[http://www.liquidfists.com/files/grayissexy.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928315 Discussion]
|-
|Midnight
|2010-06-17
|Trevsweb
|Minimenu skin
|[http://trevsweb.com/pandainterface/midnight.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|Minimenu With Toggle Detail Panel Support ('''beta''')
|2011-01-23
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/detail-toggle/ Download]
|[http://www.gp32x.com/board/index.php?/topic/58327-beta%3B-minimenu-with-toggle-detail-panel-support/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-26
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110126.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-01-27
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110127.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-02
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110202.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/ Discussion]
|-
|Minimenu Beta Installer ('''beta''')
|2011-02-09
|skeezix
|OS
|[http://www.codejedi.com/pandora/minimenu/mmenu_beta_installer_20110209.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/58377-minimenu-preview-beta-for-you-to-try/page__view__findpost__p__938340 Discussion]
|-
|Newsprint
|2010-07-26
|Pleng
|Minimenu skin
|[http://www.strappysolutions.com/demos/pandora/newsprint.zip Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__876021 Discussion]
|-
|RedDevil
|2010-11-26
|Sarlix
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,248 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/page__view__findpost__p__928099 Discussion]
|-
|RedWash
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=433 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Toybox & Corporate (2 skins)
|2010-06-14
|Pleng
|Minimenu skin
|[http://www.gp32x.com/board/index.php?app=core&module=attach&section=attach&attach_id=432 Download]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|-
|Wasp
|2010-11-23
|Farox
|Minimenu skin
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,67,238 Archive]
|[http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/ Discussion]
|}

===Graphic engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Name
!Release date (YYYY-MM-DD)
!Author/Port Author
!Type
!Download
!Notes
|-
|[[GLES]] ('''beta''')
|2010-09-02
|Farox (port)
|
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Download]
|[http://www.gp32x.com/board/index.php?/topic/56453-little-gles-pandora-test/ Discussion]
|}
===Demos/technical demos===

==Unreleased software ("Projects Under Development")==
''Note: this section may be out of date and in need of an update.''

===Operating Systems===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Android Omap
|[http://elinux.org/Android_on_OMAP]
|wip
|
|
|-
|AROS Arm
|[http://projects.powerdeveloper.org/project/imx515/735]
|wip
|
|
|-
|Debian
|[http://debian.org] [http://www.gp32x.com/board/index.php?/topic/57097-debian-on-an-sd-card/]
|working build
|Stuckie
|
|-
|FreeBSD
|[http://wiki.freebsd.org/FreeBSD/arm/OMAP]
|wip
|
|
|-
|Fedora ARM
|[http://fedoraproject.org/wiki/Architectures/ARM]
|wip
|
|
|
|-
|Gentoo Linux
|[http://neuvoo.org] [http://vminko.org/gentoo_manuals/pandora]
|Working build, not completed
|javaJake, Viridior, vminko
|IRC: (FreeNode) #gentoo-pandora
|-
|HaikuOS
|[http://www.haiku-os.org]
|wip
|
|
|-
|Ohhie GUI
|[http://www.gp32x.com/board/index.php?/topic/58320-video-ohhie-gui/]
|working build
|Pleng
|Last update: Jan. 2011
|-
|RISC OS
|[[RISC OS|Link]]
|wip
|Uwe Kall, Jeffrey Lee + others
|BeagleBoard port available for download and testing.
|-
|Ubuntu ARM
|[http://www.ubuntu.com/products/whatisubuntu/arm]
|wip
|
|
|-
|Xoo on ubuntu
|[[Xoo on ubuntu|Link]]
|wip
|
|
|}

===Game Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OLA.G.E
|[http://sourceforge.net/projects/olage/]
|Wip
|neilae
|Game Engine with Authoring Tool for multiplatforms
|}

===Graphic Engines===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|GLES2D
|
|Wip
|Cpasjuste
|OpenGL ES 2D library
|-
|GL-WES-v2.0
|[http://code.google.com/p/gl-wes-v2/]
|Working Build
|Adventus
|Opensource OpenGL 2.0 driver built on OpenGL ES 2.0
|-
|Irrlicht
|[http://irrlicht.sourceforge.net/] [http://irrlicht.sourceforge.net/phpBB2/viewtopic.php?t=32538&start=45]
|working build
|Hybrid
|3D game engine
|-
|NSS Engine
|[http://www.nosiestastudios.com/wiki/] [http://www.youtube.com/user/Prompt84]
|
|No Siesta Studios
|
|-
|OGRE Engine
|[http://www.gp32x.com/board/index.php?showtopic=46706] [http://www.youtube.com/watch?v=LDtUE5PIhV0]
|
|
|3D real-time renderer
|-
|Otaco Glost Engine
|[http://www.youtube.com/user/otacogloost], [http://www.gp32x.com/board/index.php?/topic/48393-i-did-stuff/page__p__736650&#entry736650]
|working
|Otaco
|
|-
|Quad-Ren 2D
|[http://quad-ren.sourceforge.net/index.php]
|Working
|Hessiess
|Version 0.5
|-
|SDL GLES
|[http://github.com/Cpasjuste/sdl-1.2.13_gles/tree]
|working
|Cpasjuste
|
|-
|XreaL
|[http://xreal.sourceforge.net/xrealwiki/]
|
|Pickle
|No longer being worked on. [http://www.gp32x.com/board/index.php?/topic/55173-xreal-patch-question/]
|-
|Stratagus
|[http://stratagus.sourceforge.net/]
|working build
|Cpasjuste
|RTS Engine
|-
|WakeBreaker
|[http://w1xer.at/pandora/]
|working codebase - can be compiled onboard
|torpor
|Working C++ codebase to implement a 3D game using nothing more than OpenGLES 1.1 .. can even be built *on* the Pandora, with nothing more than the onboard compiler. WakeBreaker contains everything you need to get started writing a 3D game in C++ with OpenGL ES - no further libraries required. Its an excellent example of how to write a 3D game in plain, easy to understand C++ and can serve as a working base for your own developments, easily enough.
|}
===Other programs===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|Inside The Box
|[http://www.openpandora.pl broken] [http://www.youtube.com/watch?v=uLMmJBDEs2E broken]
|wip
|StreaK
|Pandora e-zine
|-
|Math-NEON
|[http://code.google.com/p/math-neon/]
|Wip
|Adventus
|cmath like library optimized for ARM NEON coprocessor
|-
|MythTVPlayer
|[http://www.gp32x.com/board/index.php?/topic/52882-mythtvplayer/]
|Working build
|Pickle
|Media Center + TV/DV recording
|-
|Pandaphone
|[http://www.gp32x.com/board/index.php?/topic/48327-pandaphone/]
|
|jb0yx
|project to incorporate the Open Pandora handheld device with cell phone technology
|-
|Pandora Sync Suite
|[http://www.openpandora.pl broken]
|Working build
|StreaK
|for Windows 9x/NT
|-
|Pangea GUI
|[http://www.gp32x.com/board/index.php?showtopic=45631&hl=pangea]
|WIP
|efegea
|Gmenu alternative
|-
|Panorama
|[http://www.gp32x.com/board/index.php?/topic/51076-panorama/]
|abandoned
|dflemstr
|Gmenu alternative
|-
|PDM
|[http://github.com/Cpasjuste/pdm/tree]
|
|Cpasjuste
|Light desktop manager for Pandora
|-
|PGui
|[http://github.com/Cpasjuste/pgui/tree]
|
|Cpasjuste
|Standard emulator fronted for Pandora
|-
|PMenu
|[http://mydedibox.fr/_stuff/pandora/]
|
|Cpasjuste
|Minimal Menu for Pandora
|-
|PND Builder for windows
|[http://www.gp32x.com/board/index.php?/topic/47088-pnd-builder-for-windows/]
|Working build
|StreaK
|
|-
|Qemu
|[http://wiki.qemu.org/]
|testing build
|Fabrice Bellard
|open source machine emulator and virtualizer
|-
|Scale
|[http://www.youtube.com/user/Zoxc64]
|wip
|Zoxc64
|Minimal Menu for Pandora
|-
|Simple Dev Studio for Pandora
|[http://www.openpandora.pl broken]
|Wip
|StreaK
|for Windows 9x/NT
|-
|[[TINXL]]
|[[TINXL]]
|
|
|Application stack for multiplayer internet games
|-
|ZiB Emulator Frontend
|[http://www.gp32x.com/board/index.php?/topic/44952-pandora-emulator-frontend/]
|Author waiting for pandora
|Aimless_E
|
|}
===Demos / Technical Demos for OpenPandora===
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
!Project Name
!Link
!Status
!Author/Port Author
!Notes
|-
|OpenGL Cell Shading
|[http://www.youtube.com/watch?v=cpAj0jHglGw]
|working build
|
|
|-
|OpenGL Demo with MP3 Playback
|[http://www.youtube.com/watch?v=hkx18kruRJs]
|working build
|
|
|-
|OpenGL Skull Demo
|[http://www.youtube.com/watch?v=qG7EDaZpyOo]
|working build
|
|
|-
|WaveDemo
|[http://www.youtube.com/watch?v=4wgEHFCq9Lo]
|Working
|Otaco
|
|}

==External links==
*[http://sebt3.openpandora.org/pnd/ Releases by sebt3]
*[http://www.hermocom.com/en/downloads/openpandora/ Releases by Hermocom]
*[http://rebirthofxeen.com/files/pandora/ Releases by WizardStan]
*[http://www.stuckiegamez.co.uk/apps/pandora/ Releases by Stuckie]
*[http://www.pandorasource.de/download.php PandoraSource.de downloads] - German Pandora download site

===Forums===
The following community forums are checked when updating this page:
*From GP32X: [http://www.gp32x.com/board/index.php?/forum/63-news-zone-pandora/ News Zone], [http://www.gp32x.com/board/index.php?/forum/71-beta-testing-pandora/ Beta Testing] and [http://www.gp32x.com/board/index.php?/forum/64-developers-corner-pandora/ Developer's Corner]
*From OP: [http://boards.openpandora.org/index.php?/forum/26-software-news/ Software News] and [http://boards.openpandora.org/index.php?/forum/10-beta-testing/ Beta Testing]

[[Category:Development]]
[[Category:Software]]

Extend Utils

2010-08-30T15:15:16Z

Stuckie: Pruning of dead links, help for submitting bug reports, some cleanup here and there

= Overview =
Extend Utils provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the SimpleDev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

= Bug Reports =
In order for a bug report to be useful, I need the following information from you: 
Output from "dmesg | tail", "mount" and your preMount script. 
A description of the error.

Just PM me them on the GP32X boards, or post in the relevant threads - Links at the bottom of this page.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in Extend Utils, but are available here as well:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/4GBExtend.zip 4GB Extend]

== Dev Extends ==
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

=== Gentoo ===
None, yet.

=== Ubuntu ===
==== Jaunty ====
The Jaunty Release is the most complete and working version of Ubuntu in an Extend. It requires a special mount script to use it.
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntu-arm-jaunty-desktop-3.5G.7z Uncompressed 3.5Gb Extend of Ubuntu 9.04 - Jaunty Jackalope]
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntuExtend.pnd Custom Ubuntu Extend Mount Script]

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

Work on Debian is currently active...ish.

== Ubuntu OS Extend ==
Ubuntu development is on hold.

A first release is available, that requires a slightly customised mount script.
See Files above for download details.

Ubuntu can be started via the '' Start Ubuntu '' option in the System Menu. Then just follow the on-screen prompts.

=== F.A.Q ===
Q: How do I login? 
A: The default user is "ubuntu" with password "pandora"

Q: Can I create a new user? 
A: Yes, but you'll have to do it manually from the Terminal, or start the DBus service ( see below. )

Q: Can I upgrade to Karmic or Lucid? 
A: I'd highly advise against this due to the usual System V init system being replace by Upstart, which isn't too happy about being wrapped in a chroot.

=== Issues ===
Ubuntu seems to be very dependent upon it's system services being operational. This unfortunately causes us problems as we're jumping in via a chroot, rather than booting the system normally, so Ubuntu's services haven't started; though Angstrom's have.

It is possible to get Ubuntu's services to start by calling ''''' sudo /etc/init.d/dbus start ''''' however, this knocks out Angstrom's services, and in particular, HAL - the Hardware Abstraction Layer - which currently detects the presence of a chroot and refuses to work inside our environment. This is bad as if we log out of Ubuntu, we've lost access to all input devices, unless we have switched back to Angstrom and restarted dbus in it's environment.

Update: Hal can be kept active by following this routine...
* Start Ubuntu as normal, but don't click the final Ok for GDM to start.
* Open a Terminal
* ''''' sudo chroot /tmp/osextend '''''
* Open another Terminal/Tab ... this'll be Angstrom, whereas your original is Ubuntu.
* ''''' sudo /etc/init.d/dbus-1 stop ''''' (Angstrom)
* ''''' sudo /etc/init.d/dbus start ''''' (Ubuntu)
* ''''' sudo hald --daemon=no --verbose=yes ''''' (Angstrom)
* Wait till HAL has finished, then click OK.

This gets us slightly further, but still seems to stop Ubuntu's admin services somewhere, as you still cannot use the GUI-based Administration tools. You do however, seem to have access to WiFi and Bluetooth as their icons now appear in the system tray.
D-Pad control now seems knocked out as well.

Touchscreen support currently does not work. The TSLib has been installed, and the xorg-input-tslib is also available, however it doesn't seem to be picked up.

Due to Ubuntu's services not being active, most GUI-driven Administration utilities do not appear to work. Either perform the manual command line work, or start services as above.

If Angstrom's X is quit ( IE: you log out of XFCE, ) although a speed up is gained, you've lost access to WiFi. I haven't yet checked if starting services inside Ubuntu would allow the setting up of the WiFi from inside the OS Extend.

The CTRL+ALT+F# keys for changing virtual terminals work on a USB keyboard in Ubuntu, but not on the Pandora's keyboard; neither work in Angstrom.. as such, you have to perform ''''' sudo chvt # ''''' replacing # with 2 for Ubuntu, and 7 for Angstrom.

Ubuntu 9.04 - Jaunty Jackalope, is currently the last version of Ubuntu to work "properly" in a chroot due to later versions changing the init deamon from the standard System V to Upstart.

=== Further Work ===
Ubuntu has been put on hold for the time being.

I also need to have a further look into getting Karmic or Lucid running properly.

=== Links ===
* [https://wiki.ubuntu.com/ARM/RootfsFromScratch Ubuntu ARM From Scratch/RootStock]
* [http://dedors.wordpress.com/2008/12/10/run-kde4-in-chroot-gentoodebianubuntu-howto/ Running KDE4 in chroot] - pay particular attention to the dbus/hal manipulation.
* [http://www.gentoo-wiki.info/HOWTO_startx_in_a_chroot Start X in chroot]
* [https://answers.launchpad.net/ubuntu/+source/gnome-system-tools/+question/32334 Console-Kit issues] - what we get on Ubuntu

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

Unfortunately, a Dev Extend hasn't been released for a while, and may currently BREAK some applications on the Pandora with the latest hot fix releases.. use with caution, or create an Overlay and install dev tools into that ( which is effectively all a Dev Extend is. )

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]

Extend Utils

2010-07-28T22:58:55Z

Stuckie: Forgot to add the Empty Extends

= Overview =
Extend Utils provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the SimpleDev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

== Empty Extends ==
The following files are pre-formatted ext2 files. These are included in Extend Utils, but are available here as well:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/256MBExtend.zip 256MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/512MBExtend.zip 512MB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zip 1GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/2GBExtend.zip 2GB Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/4GBExtend.zip 4GB Extend]

== Dev Extends ==
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

The following will be DEPRECATED by 1st August - grab them while you can if you need them.
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-lenny.512MbExtend.zip Uncompressed 512Mb Extend of Lenny]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid.1GbExtend.zip Uncompressed 1Gb Extend of Sid]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.1GbExtend.zip Uncompressed 1Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.2GbExtend.zip Uncompressed 2Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.4GbExtend.zip Uncompressed 4Gb Extend of Sid with Synaptic pre-installed]

=== Gentoo ===
None, yet.

=== Ubuntu ===
==== Jaunty ====
The Jaunty Release is the most complete and working version of Ubuntu in an Extend. It requires a special mount script to use it.
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntu-arm-jaunty-desktop-3.5G.7z Uncompressed 3.5Gb Extend of Ubuntu 9.04 - Jaunty Jackalope]
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntuExtend.pnd Custom Ubuntu Extend Mount Script]

==== Others ====
Other variants of Ubuntu, which will be DEPRECATED by 1st August include:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/ubuntu-karmic-arm.1GbExtend.zip Ubuntu Karmic - 1Gb Uncompressed Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/ubuntu-karmic-arm.2GbExtend.zip Ubuntu Karmic - 2Gb Uncompressed Extend]

Note that Karmic is a bit of a pest as it uses Upstart, so services are almost guaranteed not to work.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

Work on Debian is currently active...ish.

== Ubuntu OS Extend ==
Ubuntu development is on hold.

A first release is available, that requires a slightly customised mount script.
See Files above for download details.

Ubuntu can be started via the '' Start Ubuntu '' option in the System Menu. Then just follow the on-screen prompts.

=== F.A.Q ===
Q: How do I login? 
A: The default user is "ubuntu" with password "pandora"

Q: Can I create a new user? 
A: Yes, but you'll have to do it manually from the Terminal, or start the DBus service ( see below. )

Q: Can I upgrade to Karmic or Lucid? 
A: I'd highly advise against this due to the usual System V init system being replace by Upstart, which isn't too happy about being wrapped in a chroot.

=== Issues ===
Ubuntu seems to be very dependent upon it's system services being operational. This unfortunately causes us problems as we're jumping in via a chroot, rather than booting the system normally, so Ubuntu's services haven't started; though Angstrom's have.

It is possible to get Ubuntu's services to start by calling ''''' sudo /etc/init.d/dbus start ''''' however, this knocks out Angstrom's services, and in particular, HAL - the Hardware Abstraction Layer - which currently detects the presence of a chroot and refuses to work inside our environment. This is bad as if we log out of Ubuntu, we've lost access to all input devices, unless we have switched back to Angstrom and restarted dbus in it's environment.

Update: Hal can be kept active by following this routine...
* Start Ubuntu as normal, but don't click the final Ok for GDM to start.
* Open a Terminal
* ''''' sudo chroot /tmp/osextend '''''
* Open another Terminal/Tab ... this'll be Angstrom, whereas your original is Ubuntu.
* ''''' sudo /etc/init.d/dbus-1 stop ''''' (Angstrom)
* ''''' sudo /etc/init.d/dbus start ''''' (Ubuntu)
* ''''' sudo hald --daemon=no --verbose=yes ''''' (Angstrom)
* Wait till HAL has finished, then click OK.

This gets us slightly further, but still seems to stop Ubuntu's admin services somewhere, as you still cannot use the GUI-based Administration tools. You do however, seem to have access to WiFi and Bluetooth as their icons now appear in the system tray.
D-Pad control now seems knocked out as well.

Touchscreen support currently does not work. The TSLib has been installed, and the xorg-input-tslib is also available, however it doesn't seem to be picked up.

Due to Ubuntu's services not being active, most GUI-driven Administration utilities do not appear to work. Either perform the manual command line work, or start services as above.

If Angstrom's X is quit ( IE: you log out of XFCE, ) although a speed up is gained, you've lost access to WiFi. I haven't yet checked if starting services inside Ubuntu would allow the setting up of the WiFi from inside the OS Extend.

The CTRL+ALT+F# keys for changing virtual terminals work on a USB keyboard in Ubuntu, but not on the Pandora's keyboard; neither work in Angstrom.. as such, you have to perform ''''' sudo chvt # ''''' replacing # with 2 for Ubuntu, and 7 for Angstrom.

Ubuntu 9.04 - Jaunty Jackalope, is currently the last version of Ubuntu to work "properly" in a chroot due to later versions changing the init deamon from the standard System V to Upstart.

=== Further Work ===
Ubuntu has been put on hold for the time being.

I also need to have a further look into getting Karmic or Lucid running properly.

=== Links ===
* [https://wiki.ubuntu.com/ARM/RootfsFromScratch Ubuntu ARM From Scratch/RootStock]
* [http://dedors.wordpress.com/2008/12/10/run-kde4-in-chroot-gentoodebianubuntu-howto/ Running KDE4 in chroot] - pay particular attention to the dbus/hal manipulation.
* [http://www.gentoo-wiki.info/HOWTO_startx_in_a_chroot Start X in chroot]
* [https://answers.launchpad.net/ubuntu/+source/gnome-system-tools/+question/32334 Console-Kit issues] - what we get on Ubuntu

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]

Extend Utils

2010-07-28T22:55:54Z

Stuckie: Restructured all download links to a special section for easy tracking.

= Overview =
Extend Utils provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

= Available Files =

The Extend Utils suite is updated regularly, and will always be available here, as part of the SimpleDev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

== Dev Extends ==
The current release of the Dev Extend is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.20thJune2010.zip Dev Extend - 20th June 2010]

The original release is here:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zip Dev Extend - 18th June 2010]

Upgrade functionality is being worked on.

== OS Extends ==
=== Arch Linux ===
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

=== Debian ===
New "Current" Release
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic-compressed.7z ~250mb Compressed Debian Sid 28th July 2010 with Synaptic]

The following will be DEPRECATED by 1st August - grab them while you can if you need them.
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-lenny.512MbExtend.zip Uncompressed 512Mb Extend of Lenny]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid.1GbExtend.zip Uncompressed 1Gb Extend of Sid]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.1GbExtend.zip Uncompressed 1Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.2GbExtend.zip Uncompressed 2Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.4GbExtend.zip Uncompressed 4Gb Extend of Sid with Synaptic pre-installed]

=== Gentoo ===
None, yet.

=== Ubuntu ===
==== Jaunty ====
The Jaunty Release is the most complete and working version of Ubuntu in an Extend. It requires a special mount script to use it.
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntu-arm-jaunty-desktop-3.5G.7z Uncompressed 3.5Gb Extend of Ubuntu 9.04 - Jaunty Jackalope]
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntuExtend.pnd Custom Ubuntu Extend Mount Script]

==== Others ====
Other variants of Ubuntu, which will be DEPRECATED by 1st August include:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/ubuntu-karmic-arm.1GbExtend.zip Ubuntu Karmic - 1Gb Uncompressed Extend]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/ubuntu-karmic-arm.2GbExtend.zip Ubuntu Karmic - 2Gb Uncompressed Extend]

Note that Karmic is a bit of a pest as it uses Upstart, so services are almost guaranteed not to work.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available ( see Files above )
Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts exist, and an "official" compressed version of Sid with Synaptic.
See Files above.

Work on Debian is currently active...ish.

== Ubuntu OS Extend ==
Ubuntu development is on hold.

A first release is available, that requires a slightly customised mount script.
See Files above for download details.

Ubuntu can be started via the '' Start Ubuntu '' option in the System Menu. Then just follow the on-screen prompts.

=== F.A.Q ===
Q: How do I login? 
A: The default user is "ubuntu" with password "pandora"

Q: Can I create a new user? 
A: Yes, but you'll have to do it manually from the Terminal, or start the DBus service ( see below. )

Q: Can I upgrade to Karmic or Lucid? 
A: I'd highly advise against this due to the usual System V init system being replace by Upstart, which isn't too happy about being wrapped in a chroot.

=== Issues ===
Ubuntu seems to be very dependent upon it's system services being operational. This unfortunately causes us problems as we're jumping in via a chroot, rather than booting the system normally, so Ubuntu's services haven't started; though Angstrom's have.

It is possible to get Ubuntu's services to start by calling ''''' sudo /etc/init.d/dbus start ''''' however, this knocks out Angstrom's services, and in particular, HAL - the Hardware Abstraction Layer - which currently detects the presence of a chroot and refuses to work inside our environment. This is bad as if we log out of Ubuntu, we've lost access to all input devices, unless we have switched back to Angstrom and restarted dbus in it's environment.

Update: Hal can be kept active by following this routine...
* Start Ubuntu as normal, but don't click the final Ok for GDM to start.
* Open a Terminal
* ''''' sudo chroot /tmp/osextend '''''
* Open another Terminal/Tab ... this'll be Angstrom, whereas your original is Ubuntu.
* ''''' sudo /etc/init.d/dbus-1 stop ''''' (Angstrom)
* ''''' sudo /etc/init.d/dbus start ''''' (Ubuntu)
* ''''' sudo hald --daemon=no --verbose=yes ''''' (Angstrom)
* Wait till HAL has finished, then click OK.

This gets us slightly further, but still seems to stop Ubuntu's admin services somewhere, as you still cannot use the GUI-based Administration tools. You do however, seem to have access to WiFi and Bluetooth as their icons now appear in the system tray.
D-Pad control now seems knocked out as well.

Touchscreen support currently does not work. The TSLib has been installed, and the xorg-input-tslib is also available, however it doesn't seem to be picked up.

Due to Ubuntu's services not being active, most GUI-driven Administration utilities do not appear to work. Either perform the manual command line work, or start services as above.

If Angstrom's X is quit ( IE: you log out of XFCE, ) although a speed up is gained, you've lost access to WiFi. I haven't yet checked if starting services inside Ubuntu would allow the setting up of the WiFi from inside the OS Extend.

The CTRL+ALT+F# keys for changing virtual terminals work on a USB keyboard in Ubuntu, but not on the Pandora's keyboard; neither work in Angstrom.. as such, you have to perform ''''' sudo chvt # ''''' replacing # with 2 for Ubuntu, and 7 for Angstrom.

Ubuntu 9.04 - Jaunty Jackalope, is currently the last version of Ubuntu to work "properly" in a chroot due to later versions changing the init deamon from the standard System V to Upstart.

=== Further Work ===
Ubuntu has been put on hold for the time being.

I also need to have a further look into getting Karmic or Lucid running properly.

=== Links ===
* [https://wiki.ubuntu.com/ARM/RootfsFromScratch Ubuntu ARM From Scratch/RootStock]
* [http://dedors.wordpress.com/2008/12/10/run-kde4-in-chroot-gentoodebianubuntu-howto/ Running KDE4 in chroot] - pay particular attention to the dbus/hal manipulation.
* [http://www.gentoo-wiki.info/HOWTO_startx_in_a_chroot Start X in chroot]
* [https://answers.launchpad.net/ubuntu/+source/gnome-system-tools/+question/32334 Console-Kit issues] - what we get on Ubuntu

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]

Extend Utils

2010-07-17T21:58:22Z

Stuckie: Lots of documentation on the new Extend Utils suite.

= Overview =
Extend Utils provide a variety of tools to manipulate Extend, Overlay and Swap files. These are generally loop-back files stored on SD card for various purposes which include, but is not limited to:
* OS Extends - running another distribution on top of Angstrom in a chroot environment.
* Dev Extends - a method of providing dev tool support without installing directly to NAND.
* File system Overlays - redirect writes from NAND to a file on an SD card.
* Swap - use a swap file on SD card to provide additional memory for the Pandora when needed.

This page used to only document OS Extends... it will now document all facets of the Extend Utils.

Extend Utils have been written by Stuckie and while very much work-in-progress, the scripts are very useful in day to day tasks.

The Extend Utils suite is updated regularly, and will always be available here, as part of the SimpleDev system:
[http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/extendutils.pnd Extend Utils]

For support, please direct questions to the relevant threads on the forum - see Links at the bottom of this page.

= Extend Utils Help =
Extend Utils ( version 1.0a ) now facilitates the creation of "PreMount" scripts. For users of previous Extend Utils script sets, these separate scripts are essentially a PreMount script - the Ubuntu specific variant being a prime example.

This allows us to create customised mounting procedures - such as being able to mount multiple Extends and Overlays at once; for example, a compressed Base OS Extend with perhaps an Overlay on top to "catch" installed programs.

Unfortunately, as is always the case with more customization, the complexity has shot up. This guide will help you to create a PreMount script given four common scenarios: a Swap mount, a Home or Root Overlay, an OS Extend and a Dev Extend.

== Creating a Swap PreMount ==
Perhaps the simplest PreMount script is a Swap Mount. For this, I shall assume you have not created a .swap file.
* Start up Extend Utils.
* Select New Extend/Overlay/Swap.
* Select New Swap File.
* Select 256MB - this uses one of the pre-created zipped Extend files, whereas Custom will create a new one on the card.
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Swap Mount Script.
* Find your Swap File you just created.
* Select a location for your Pre-Mount script to be saved to.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. you have swap mounted.

Obviously, now that the script is saved, you only need to repeat the last two steps, or just run the script direct from the Terminal.

== Creating a Root or Home Overlay PreMount ==
Again, I shall assume that you do not have any pre-made .overlay files.
* Start up Extend Utils.
* Select New Overlay.
* Select New Overlay File.
* Select 1GB - or whatever you like.. again be aware that Custom may very well chew through your SD card as it DD's direct to it!
* Save the file anywhere you like.
* It will extract the appropriate zip to where you selected.
* Back at the Main Menu, select New Pre-Mount.
* Select New Overlay Mount Script.
* Select either Standard Home Overlay or Standard Root Overlay.
* Find your Overlay that you created.
* Select where you want to save the Pre-Mount script.
* Finally, back at the Main Menu, you can select Mount Existing Pre-Mount.
* Find where your Pre-Mount script was saved to, and that's it.. either the majority of / or your /home is bound to the overlay.

== Creating an OS Extend PreMount ==
Generally, these will have been pre-made downloads, or you'll have created a chroot environment and wrapped it in an extend already.
It's also important to note that there are essentially TWO types of OS Extends - compressed and uncompressed. Compressed OS Extends should be affixed with compressed; base-debian-sid-compressed.extend for example, which donates it's a base install of debian sid, in a compressed extend. Compressed extends can only be mounted as read-only, and will likely fail if you try to mount them read-write. This means they require an Overlay in order to be much use. As such, I will describe a "classic" uncompressed OS Extend procedure, and a "modern" compressed OS Extend procedure.

=== Compressed OS Extends ===
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

This is where you need to start paying attention as to what you're doing.
For our purposes, we want a basic configuration for say a Base Debian Sid Extend, and one Overlay.
The Base Debian Sid Extend we would have downloaded already, and the Overlay we should have created as well.

* Move the slider to select 1 Read-Only Extend.
* Select our base-debian-sid-compressed.extend ( assuming you've downloaded it, and it's been released! )
* We don't want any Read-Write Extends, so Cancel or select 0.
* We do want an Overlay, so select 1 Read-Write Overlay.
* Choose the Overlay you want to use.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend or Overlay you've chosen.
* You'll then be asked where you want to save the PreMount script.

Again, we need to pay attention as to what we want here.
For our purposes, we just want a Terminal, so that we can call apt-get and install whatever we feel like, and run it from the shell to interact with the program in Angstrom.
You can, of course, re-do this procedure later after having installed a window manager and desktop manager ( IE: something like Fluxbox and GDM ) so that you can jump fully into Debian if you so wish.

* Select the Terminal option.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, you should have a Terminal open inside your OS Extend, where all writes go to your Overlay.

=== Uncompressed/Classic OS Extends ===
These ones are much easier to deal with, and are generally what have been released up till now.
These don't require an Overlay ( though you can still use one if you like. )
The procedure for setting up a mount script for one of these runs as follows:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select OS Extend.

As said, we don't need an Overlay, and Uncompressed/Classic Extends can be mounted Read-Write without any issues.
Therefore, we only need to select 1 Read-Write Extend, and 0 everything else.

* We don't want any Read-Only Extends, so Cancel or select 0.
* We don want a Read-Write Extend...so move the slider to 1 and find your Extend file.
* Again, we don't want an Overlay, so select 0 or Cancel it.
* Now you must name the mount point. This can be anything you like, but it must be unique and not the name of the Extend.
* You'll then be asked where you want to save the PreMount script.

Now we need to know roughly what's in our Extend.. to be safe, we can just choose a Terminal as that's guaranteed to work. If, however, you know that GDM is installed and setup ( I'll ensure that any of my Extends that are, are documented in saying so ) then you can choose the GDM option.

* We'll assume we've got GDM present, so select GDM.
* You'll now be sent back to the Main Menu, where you can now select Mount Existing Pre-Mount.
* Select your Pre-Mount Script you've just created.
* After the gksudo checks, GDM will start up alongside Angstrom and ask you to login. You should have a login/password already - either from you manually setting it up, or the default that whoever set the .Extend up performed.

== Creating a Dev Extend Pre-Mount ==
Dev Extends are essentially Root Extends these days.. however that's not to say there won't eventually be packs so that there's a base Dev Extend with just the bare essentials, then addons for GTK, QT, wxWidgets, etc.. so having them classed as an Extend seems like the best option.

The current Dev Extends are created exactly like the Uncompressed/Classic OS Extends, but for completeness sakes:
* Start Extend Utils.
* Select New Pre-Mount.
* Select New Extend Mount.
* Select Dev Extend.
* Select 0 Read-Only Extends.
* Select 1 Read-Write Extend.
* Find your Dev Extend.
* Select 0 Read-Write Overlays.
* Come up with a mount point.
* Save your Pre-Mount somewhere.
* You may now load it up through the Mount Existing Pre-Mount script if you so wish.

= OS Extends =
OS Extend is a method of running another distribution on top of Angstrom. This is currently very much a hacky WORK IN PROGRESS method of doing so, and this page describes what it does, how to get started, and any major pitfalls in using it.

Currently, I've been successful in getting Debian, Ubuntu and Arch running to varying degrees. This page will be split up into these distributions so you should be able to jump to the correct section for any oddities that I've uncovered, and any workarounds presented.

Essentially, what I'm doing is using a loop back file, formatted as Ext2, and performing a first stage install within it for Arm. This is called by either debootstrap, rootstock, or whichever system the target distribution uses. These "Extend" files are then copied over to SD card/Memory Stick/etc... and chrooted into.

However, this brings some very important caveats:
* System Services don't always tend to work, and starting them can clobber Angstrom's services ( see the HAL/DBus issues in Ubuntu below. )
* Limited resources when running TWO XServers and TWO Desktop Managers does start to show, but the fact that it's still running fairly well is a testament to how powerful the Pandora actually is.
* Logging out of XFCE will speed up the chrooted environment, but tends to shut down NetworkManager with it, disabling WiFi for the environment unless it knows how to handle it.

Hopefully, these can be dealt with in due time.

That said, there are benefits of using a system such as this:
* It's (almost) the exact same distribution as you'd be installing on SD Card, so why not test it out first before sacrificing an SD card fully?
* Perhaps you only have the one SD card? It may be a gigantic SD card but partitioning scares you, so this allows you to try a chosen distribution first without messing about!
* Some distributions have a HUGE library of packages ready and waiting to be played with.. why not see which ones you'd like ported over to Angstrom natively?
* We can be sneaky and take advantage of all Pandora specific updates to Angstrom, and have our Extended OS install reap the benefits rather than having to wait for someone to port it over ( kernel drivers, for example. )
* Why not show off just how powerful the Pandora actually is - you are running TWO X Servers and TWO Desktop Managers at once!
* Development between multiple distributions can be done much more easily, as you could bind your development distribution, and check driver support in Angstrom.
* And my absolute favourite - it's a fun hack!

So, there is good reason to try and pursue a system such as this, if perhaps not generally geared to "End User Consumption."

== Arch OS Extend ==
A proof of concept is available here: [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/archmobile.1GbExtend.zip 1Gb Arch Extend]

Not much work has been taking in furthering the install as of this time.

== Android OS Extend ==
This might be tricky due to dalvik.. doesn't seem to be any fast way of "borrowing" an existing rootfs, will have to just try compiling manually for the Pandora.

=== Links ===
* http://elinux.org/Android_on_OMAP
* http://omappedia.org/wiki/Android_Getting_Started

== Debian OS Extend ==
Debian was the first distribution to work in this environment.

Various proof of concepts currently exist:
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-lenny.512MbExtend.zip 512Mb Extend of Lenny]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid.1GbExtend.zip 1Gb Extend of Sid]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.1GbExtend.zip 1Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.2GbExtend.zip 2Gb Extend of Sid with Synaptic pre-installed]
* [http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/debian-sid-synaptic.4GbExtend.zip 4Gb Extend of Sid with Synaptic pre-installed]

Work on Debian has currently active...ish.

If you get "cannot open display: :0.0" this is a regression in the script for xhost support, please run the following in an Angstrom terminal:
xhost local:localhost

Sorry about that!

== Ubuntu OS Extend ==
Ubuntu development is on hold.

A first release is available here:
* [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntu-arm-jaunty-desktop-3.5G.7z 3.5Gb Extend of Ubuntu 9.04 - Jaunty Jackalope] - note this is a 7zip archive due to it's size; there aren't many empty blocks in this for zip to compress.

Ubuntu OS Extend currently uses a slightly tailored version of Extend Utils, available here: [http://www.stuckiegamez.co.uk/apps/pandora/UbuntuExtend/ubuntuExtend.pnd Ubuntu Extend]

Ubuntu can be started via the '' Start Ubuntu '' option in the System Menu. Then just follow the on-screen prompts.

=== F.A.Q ===
Q: How do I login? 
A: The default user is "ubuntu" with password "pandora"

Q: Can I create a new user? 
A: Yes, but you'll have to do it manually from the Terminal, or start the DBus service ( see below. )

Q: Can I upgrade to Karmic or Lucid? 
A: I'd highly advise against this due to the usual System V init system being replace by Upstart, which isn't too happy about being wrapped in a chroot.

=== Issues ===
Ubuntu seems to be very dependent upon it's system services being operational. This unfortunately causes us problems as we're jumping in via a chroot, rather than booting the system normally, so Ubuntu's services haven't started; though Angstrom's have.

It is possible to get Ubuntu's services to start by calling ''''' sudo /etc/init.d/dbus start ''''' however, this knocks out Angstrom's services, and in particular, HAL - the Hardware Abstraction Layer - which currently detects the presence of a chroot and refuses to work inside our environment. This is bad as if we log out of Ubuntu, we've lost access to all input devices, unless we have switched back to Angstrom and restarted dbus in it's environment.

Update: Hal can be kept active by following this routine...
* Start Ubuntu as normal, but don't click the final Ok for GDM to start.
* Open a Terminal
* ''''' sudo chroot /tmp/osextend '''''
* Open another Terminal/Tab ... this'll be Angstrom, whereas your original is Ubuntu.
* ''''' sudo /etc/init.d/dbus-1 stop ''''' (Angstrom)
* ''''' sudo /etc/init.d/dbus start ''''' (Ubuntu)
* ''''' sudo hald --daemon=no --verbose=yes ''''' (Angstrom)
* Wait till HAL has finished, then click OK.

This gets us slightly further, but still seems to stop Ubuntu's admin services somewhere, as you still cannot use the GUI-based Administration tools. You do however, seem to have access to WiFi and Bluetooth as their icons now appear in the system tray.
D-Pad control now seems knocked out as well.

Touchscreen support currently does not work. The TSLib has been installed, and the xorg-input-tslib is also available, however it doesn't seem to be picked up.

Due to Ubuntu's services not being active, most GUI-driven Administration utilities do not appear to work. Either perform the manual command line work, or start services as above.

If Angstrom's X is quit ( IE: you log out of XFCE, ) although a speed up is gained, you've lost access to WiFi. I haven't yet checked if starting services inside Ubuntu would allow the setting up of the WiFi from inside the OS Extend.

The CTRL+ALT+F# keys for changing virtual terminals work on a USB keyboard in Ubuntu, but not on the Pandora's keyboard; neither work in Angstrom.. as such, you have to perform ''''' sudo chvt # ''''' replacing # with 2 for Ubuntu, and 7 for Angstrom.

Ubuntu 9.04 - Jaunty Jackalope, is currently the last version of Ubuntu to work "properly" in a chroot due to later versions changing the init deamon from the standard System V to Upstart.

=== Further Work ===
Ubuntu has been put on hold for the time being.

I also need to have a further look into getting Karmic or Lucid running properly.

=== Links ===
* [https://wiki.ubuntu.com/ARM/RootfsFromScratch Ubuntu ARM From Scratch/RootStock]
* [http://dedors.wordpress.com/2008/12/10/run-kde4-in-chroot-gentoodebianubuntu-howto/ Running KDE4 in chroot] - pay particular attention to the dbus/hal manipulation.
* [http://www.gentoo-wiki.info/HOWTO_startx_in_a_chroot Start X in chroot]
* [https://answers.launchpad.net/ubuntu/+source/gnome-system-tools/+question/32334 Console-Kit issues] - what we get on Ubuntu

= Dev Extend =
A Dev Extend is a special kind of Overlay which only binds enough of the file system to allow development tools to work. As such, most information on Overlays - particularly Root Overlays - match Dev Extends.

Dev Extends are routinely updated and match Stuckie's current development environment.
Support for updating between revisions is planned, but not currently implemented.

= Overlays =
Overlays allow the base system to be kept unmodified, and all changes to be propagated to the Overlay file. This is immensely useful for development work where you can install a development environment "normally" and compile what is needed, then unbind the overlay and run it on a "vanilla" install, to see if any libraries are missing.

Stuckie's general development environment uses a Dev Extend and an Overlay - so that all compiled code sits in the Home Overlay, and the development environment is in the Dev Extend. This allows any programs that have not been configured fully to keep clear of the NAND when running, should they create config files in the user's Home directory, as well as separating the compiled programs from the development environment for easier testing on the "vanilla" state.

Overlays essentially come in two flavours - Home and Root - where the latter covers everything written to / and the former only covering /home, however an Overlay could be made for any combination of directories.

= Extend Utils GUI =
On the forums, SomeGuy99 has suggested the creation of a GUI-based app to wrap around the Extend Utils suite. This would greatly simplify what is going on by being able to provide on-screen help, as well as tying the many scripts into one app and not cluttering up the System menu any further.

This also needs to be a cross-platform application, if only for the creation of Extend files. As such, it needs a cross-platform widget toolkit; preferably a light-weight one to run on Pandora as well. Currently, this looks to be [http://www.fltk.org/ FLTK]

For the time being, the Extend Utils has been rewritten ( version 1.0a ) to further use Zenity and create customised mount scripts, in preparation for the work on the FLTK-based GUI.

= Links =
* [http://www.gp32x.com/board/index.php?/topic/54651-debian-in-an-extend/ Original OS Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54508-simple-dev-pnd/ Original Dev Extend Thread]
* [http://www.gp32x.com/board/index.php?/topic/54064-advanced-filesystem-hackery/ Original Overlay Thread]

[[Category:Documentation]]