mcobit
Advanced Member
- Joined
- Jul 28, 2008
- Messages
- 6,909
Posted this also in the devsection of the other boards, but maybe someone here would find it useful too.
Disclaimer: This is the way I compile software on the Pandora. It may not be the best way, it might not be the simplest solutions, but if you have comments please just post them and I can correct or change parts of this tutorial. You follow this at your own risk. I am not responsible, if you destroy your OS or do anything else to your Pandora!
Porting a simple SDL game to Pandora
The noob way (yes, I am a noob too)
First off, Id like to state, that I learned all I know about compiling, throwing some lines of code around and packaging, I learned since I have a Pandora.
It all came about, when I, fortunately one of the firsat german pandoraowner, wanted to do something useful for the community.
I worked with creaturexl together on an application for the Pandora and as he wouldnt get his device anytime soon, he could try his app on my Pandora via ssh. He used screen to let me see, what he did. I learned a lot about symlinks and resolving dependencies.
Later I tried to do something on my own. I packaged up some java-apps with the help of the descriptions on the pandorawiki.
After that I packaged a pythonapp, that worked out of the box on Pandora.
When that was done I thought, that I could try to compile an SDL app. That was Abes Amazing Adventure. And this is the app, that this tutorial is about.
Also many thanks to all the people from this community. You really help where you can! Thanks Sebt3, CreatureXL, Paulguy, Skeezix, and everyone else I forgot right now. Thank you very much!
To get started you will need a dev environment. My choice was to use stuckies extends.
In the post he said, that they may be unstable and may cause some bad things, but for me so far it never happend a thing.
So go and download stuckies extend utils. For ease of use you can use the old ones. These are easier, as they only give the option to mount a root or a home extend:
Copy it to the pandora/menu folder on a SD card.
Also you need a dev extend. download the one from 18thJune, because as I remember there are some broken packages in the newer one.
Download it here:
Unzip it to a sd-card. You will get a file named dev.extend.
You will need a home extend too, as the space on the nand is pretty limited:
Unzip this one to a sd-card, too. You will get a file named 1gb.extend.
Now its time to mount our extends:
Open the menu and select Extend Root from the System menu.
You will be asked, which extend you want to mount. Choose the dev.extend file we unzipped earlier. You have to give your root password and then it will tell you, that it will spawn a terminal. When it does so, you can type gcc into the terminal window. If it says: gcc: no input files The mount was successful.
Now mount your homeextend. Choose Extend Home in the system menu and mount your 1gb.extend like you mounted the dev.extend.
FROM NOW ON DON'T REMOVE A SDCARD, THAT CONTAINS THE EXTENDS!!!
BAD THINGS MIGHT HAPPEN IF YOU DO! TO CLEANLY UNMOUNT THEM REBOOT THE PANDORA!
In the terminal, that will pop up at the end you can now cd into your homeextend directory:
This will be your working directory.
Now the environment is set up. That was easy, wasnt it?
Now get the source code for the game you want to port. In this example lets download the sources to Abes Amazing Advenure. Wget the sources into your /tmp/homeExtend directory with:
NOTE: Games, that require OpenGL will not work out of the box! They have to be rewritten or you have to use a wrapper that currently doesn't work on many games!
After the download is finnished, untar the file with
Now cd into the new directory:
Whe you type ls now you can see all the files, that belong to the game.
To build it we have to create a Makeile first. Fortunately ths is done by the configure script for us.
Run
and then
Now there will be a couple of checks, that the program does to find all the dependencies for the game and if they are already installed.
"--prefix=/mnt/utmp/abe" means, that the game will be installed into this directory, when it is built.
We have to choose a directory, that will be in /mnt/utmp, as the pnd will mount it there, when it is executed.
The script should finish without errors.
Now type
and wait until your game is built for you.
When this finished without errors, we can create the installation dir:
Now we install the game:
As the datafiles are still missing, we need to copy the following directories to the installdirectory:
Now go to the directory and run your game:
As you can see it already runs pretty well, but the buttons are not mapped to the pandorabuttons. So lets go back and change that!
Do
this is the folder, that contains the sourcecode for the executable.
Here edit the files, that contain the keymappings. Lets begin with the main game:
(I use Nano, but you can of course use any texteditor you want)
In nano you can press ctrl+w and search for SDLK.
This will set your cursor to the first buttonmapping. Scroll down to find the Line with case SDLK_SPACE. This would trigger the guy to jump in the game.
Before we edit:
The Pandoracontrols are just like keys on a keyboard.
Here are the SDL-keymappings for the Buttons and D-Pad:
A = SDLK_HOME
B = SDLK_END
Y = SDLK_PAGEUP
X = SDLK_PAGEDOWN
L-Shoulder = SDLK_RSHIFT
R-Shoulder = SDLK_RCTRL
START = SDLK_LALT
SELECT = SDLK_LCTRL
D-PAD-Left = SDLK_LEFT
D-PAD-Right = SDLK_RIGHT
D-PAD-Up = SDLK_UP
D-PAD-Down = SDLK_DOWN
This is enough for us to work with.
Now substitute the SDLK_SPACE with SDLK_HOME to make the guy jump, when we press the actionbutton A.
Then there is the balloonfunction, that is currently mapped to SDLK_RETURN.
Change it to SDLK_PAGEUP, as you did for the jumpbutton.
Now press ctrl+x to quit the editor and type y when it asks you to save.
Now we can go through all the sourcefiles and edit the Keys to our liking:
Edit the SDLK_SPACE in Menu.c to SDLK_HOME.
And while we are at it: Search for space to toggle and change it into A to toggle
Also you can change arrows to navigate into d-pad to navigate
Do the same for the SDLK_SPACE in the Splash.c file.
Now everything is good for a second compile!
Go to /tmp/homeExtend and type make. The changes you did to the sourcecode will now be incorporated into the binary.
When this finished without errors, you should do make install again to copy the new binary into the installdirectory.
Should there be an error while compiling, maybe you messed up something in one of the sourcefiles. You can always start over by reextracting the tar.gz archive.
Go to /mnt/utmp/abe and type
to test, if all controls are fine.
Congratulations! You ported a SDL game to the Pandora!
Packaging up an app.
This is a followup to the „Porting a simple SDL game“ tutorial. Make sure you have your home and root extends mounted and have a compiled version of Abe’s Amazing Adventure in your /mnt/utmp/abe folder.
Disclaimer: This is how I package pnds. There might be better solutions, but this works for me.
I am not responsible, if you mess up your system or do anything else to your Pandora!
When I wanted to package up some apps, I followed the packaging tutorial in the pandorawiki.
This is a little confusig, as it is written for different OSses and the link to the example PXML.xml file is broken.
So here is a step-by step tutorial, that only uses the Pandora itself.
This is a followup to the „Porting a simple SDL game“ tutorial. Make sure you have your home and root extends mounted and have a compiled version of Abe’s Amazing Adventure in your /mnt/utmp/abe folder.
Now, that we have the game compiled, cd into the /tmp homeExtend folder:
Make a new dir, to hold your pnd:
Now cd into the new dir and copy the /mnt/utmp/abe folder over:
Now we will create an PXML –file. For this type:
Now that you have opened in the editor, you can just copy and paste the example below into the empty file:
You can modify this file for every app you want to package, but for our little project this is just what we want.
Save the file and exit the editor.
There is something else we need right now and that is an icon for our game. As there is no default icon for Abe’s Amazing Adventure, I took a png from Google:
Let’s rename it to fit the name we specified in the PXML.xml:
Now put a copy of both files into the abe folder:
Cd into the folder,
As you might know, some programs need additional libs, that are not included in the original firmware. This program doesn’t, but we will nontheless package all the libs needed with it. Fort he learning experience ;-)
So create a new folder called lib and cd into the folder:
But how do we know, what libraries are needed by the program? This can be found out with the nice little program called ldd.
This is not in the dev.extend by default, so we need to install it:
When this finished we can check for the libraries with ldd:
This will print out a list with all the needed libraries. So now we know which ones we need, copy them all to our lib folder:
Go out oft he folder:
Now we can create our startupscript, as seen in the PXML file:
We also need to make it executable:
Now we open the file and edit it:
Here you can see the contents of an abe.sh file, I made:
Save and close the editor.
Then go to the abe-pnd folder again:
Now we should have everything, that will be packaged into the pnd.
The only thing we don’t have is the script to make the pnd. You can make a copy in this folder by typing:
Now we are ready!
The usage of pnd_make.sh is as follows:
The –c ist to tell the script that it should create a compressed sqashfs filesystem instead fo iso in the pnd. This saves some space.
So in our case the command should be:
Execute the script and you should have a fresh abe.pnd file in the same folder you are in now. Test it by copying it to one of your sdcards.
Now we should remove the folder in /mnt/utmp:
Congratulations! You packaged your first selfported game!
Disclaimer: This is the way I compile software on the Pandora. It may not be the best way, it might not be the simplest solutions, but if you have comments please just post them and I can correct or change parts of this tutorial. You follow this at your own risk. I am not responsible, if you destroy your OS or do anything else to your Pandora!
Porting a simple SDL game to Pandora
The noob way (yes, I am a noob too)
First off, Id like to state, that I learned all I know about compiling, throwing some lines of code around and packaging, I learned since I have a Pandora.
It all came about, when I, fortunately one of the firsat german pandoraowner, wanted to do something useful for the community.
I worked with creaturexl together on an application for the Pandora and as he wouldnt get his device anytime soon, he could try his app on my Pandora via ssh. He used screen to let me see, what he did. I learned a lot about symlinks and resolving dependencies.
Later I tried to do something on my own. I packaged up some java-apps with the help of the descriptions on the pandorawiki.
After that I packaged a pythonapp, that worked out of the box on Pandora.
When that was done I thought, that I could try to compile an SDL app. That was Abes Amazing Adventure. And this is the app, that this tutorial is about.
Also many thanks to all the people from this community. You really help where you can! Thanks Sebt3, CreatureXL, Paulguy, Skeezix, and everyone else I forgot right now. Thank you very much!
To get started you will need a dev environment. My choice was to use stuckies extends.
In the post he said, that they may be unstable and may cause some bad things, but for me so far it never happend a thing.
So go and download stuckies extend utils. For ease of use you can use the old ones. These are easier, as they only give the option to mount a root or a home extend:
Code:
http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/OldExtendUtils.pndAlso you need a dev extend. download the one from 18thJune, because as I remember there are some broken packages in the newer one.
Download it here:
Code:
http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/Dev.Extend.18thJune2010.zipYou will need a home extend too, as the space on the nand is pretty limited:
Code:
http://www.stuckiegamez.co.uk/apps/pandora/SimpleDev/1GBExtend.zipNow its time to mount our extends:
Open the menu and select Extend Root from the System menu.
You will be asked, which extend you want to mount. Choose the dev.extend file we unzipped earlier. You have to give your root password and then it will tell you, that it will spawn a terminal. When it does so, you can type gcc into the terminal window. If it says: gcc: no input files The mount was successful.
Now mount your homeextend. Choose Extend Home in the system menu and mount your 1gb.extend like you mounted the dev.extend.
FROM NOW ON DON'T REMOVE A SDCARD, THAT CONTAINS THE EXTENDS!!!
BAD THINGS MIGHT HAPPEN IF YOU DO! TO CLEANLY UNMOUNT THEM REBOOT THE PANDORA!
In the terminal, that will pop up at the end you can now cd into your homeextend directory:
Code:
cd /tmp/homeExtendThis will be your working directory.
Now the environment is set up. That was easy, wasnt it?
Now get the source code for the game you want to port. In this example lets download the sources to Abes Amazing Advenure. Wget the sources into your /tmp/homeExtend directory with:
Code:
wget http://downloads.sourceforge.net/project/abe/abe/abe-1.1/abe-1.1.tar.gzNOTE: Games, that require OpenGL will not work out of the box! They have to be rewritten or you have to use a wrapper that currently doesn't work on many games!
After the download is finnished, untar the file with
Code:
tar xvzf abe-1.1.tar.gz
Code:
cd abe-1.1Whe you type ls now you can see all the files, that belong to the game.
To build it we have to create a Makeile first. Fortunately ths is done by the configure script for us.
Run
Code:
./autogen.sh
Code:
./configure --prefix=/mnt/utmp/abeNow there will be a couple of checks, that the program does to find all the dependencies for the game and if they are already installed.
"--prefix=/mnt/utmp/abe" means, that the game will be installed into this directory, when it is built.
We have to choose a directory, that will be in /mnt/utmp, as the pnd will mount it there, when it is executed.
The script should finish without errors.
Now type
Code:
makeWhen this finished without errors, we can create the installation dir:
Code:
sudo mkdir /mnt/utmp/abe
Code:
sudo chmod -R 777 /mnt/utmp/abeNow we install the game:
Code:
make installAs the datafiles are still missing, we need to copy the following directories to the installdirectory:
Code:
cp images maps sounds /mnt/utmp/abeNow go to the directory and run your game:
Code:
cd /mnt/utmp/abe
Code:
./bin/abeAs you can see it already runs pretty well, but the buttons are not mapped to the pandorabuttons. So lets go back and change that!
Do
Code:
cd /tmp/homeExtend/abe-1.1/srcHere edit the files, that contain the keymappings. Lets begin with the main game:
Code:
nano Game.cIn nano you can press ctrl+w and search for SDLK.
This will set your cursor to the first buttonmapping. Scroll down to find the Line with case SDLK_SPACE. This would trigger the guy to jump in the game.
Before we edit:
The Pandoracontrols are just like keys on a keyboard.
Here are the SDL-keymappings for the Buttons and D-Pad:
A = SDLK_HOME
B = SDLK_END
Y = SDLK_PAGEUP
X = SDLK_PAGEDOWN
L-Shoulder = SDLK_RSHIFT
R-Shoulder = SDLK_RCTRL
START = SDLK_LALT
SELECT = SDLK_LCTRL
D-PAD-Left = SDLK_LEFT
D-PAD-Right = SDLK_RIGHT
D-PAD-Up = SDLK_UP
D-PAD-Down = SDLK_DOWN
This is enough for us to work with.
Now substitute the SDLK_SPACE with SDLK_HOME to make the guy jump, when we press the actionbutton A.
Then there is the balloonfunction, that is currently mapped to SDLK_RETURN.
Change it to SDLK_PAGEUP, as you did for the jumpbutton.
Now press ctrl+x to quit the editor and type y when it asks you to save.
Now we can go through all the sourcefiles and edit the Keys to our liking:
Edit the SDLK_SPACE in Menu.c to SDLK_HOME.
And while we are at it: Search for space to toggle and change it into A to toggle
Also you can change arrows to navigate into d-pad to navigate
Do the same for the SDLK_SPACE in the Splash.c file.
Now everything is good for a second compile!
Go to /tmp/homeExtend and type make. The changes you did to the sourcecode will now be incorporated into the binary.
When this finished without errors, you should do make install again to copy the new binary into the installdirectory.
Should there be an error while compiling, maybe you messed up something in one of the sourcefiles. You can always start over by reextracting the tar.gz archive.
Go to /mnt/utmp/abe and type
Code:
./bin/abeCongratulations! You ported a SDL game to the Pandora!
Packaging up an app.
This is a followup to the „Porting a simple SDL game“ tutorial. Make sure you have your home and root extends mounted and have a compiled version of Abe’s Amazing Adventure in your /mnt/utmp/abe folder.
Disclaimer: This is how I package pnds. There might be better solutions, but this works for me.
I am not responsible, if you mess up your system or do anything else to your Pandora!
When I wanted to package up some apps, I followed the packaging tutorial in the pandorawiki.
This is a little confusig, as it is written for different OSses and the link to the example PXML.xml file is broken.
So here is a step-by step tutorial, that only uses the Pandora itself.
This is a followup to the „Porting a simple SDL game“ tutorial. Make sure you have your home and root extends mounted and have a compiled version of Abe’s Amazing Adventure in your /mnt/utmp/abe folder.
Now, that we have the game compiled, cd into the /tmp homeExtend folder:
Code:
cd /tmp/homeExtendMake a new dir, to hold your pnd:
Code:
mkdir /tmp/homeExtend/abe-pndNow cd into the new dir and copy the /mnt/utmp/abe folder over:
Code:
cd abe-pnd
Code:
cp -R /mnt/utmp/abe .Now we will create an PXML –file. For this type:
Code:
touch PXML.xml
Code:
nano PXML.xmlNow that you have opened in the editor, you can just copy and paste the example below into the empty file:
Code:
<?xml version="1.0" encoding="UTF-8" ?>
<PXML xmlns="http://openpandora.org/namespaces/PXML">
<application id="abe" appdata="abe">
<title lang="en_US">Abe's Amazing Adventure</title>
<description lang="en_US">A scrolling, platform-jumping, key-collecting, ancient pyramid exploring game, vaguely in the style of similar games for the Commodore+4. The game is intended to show young people all the cool games they missed.</description>
<version major="1" minor="1" release="0" build="0" />
<exec command="./abe.sh" background="true" standalone="true" />
<author name="Gabor Torok, Pedro Izecksohn, Alex Clarck" website="http://abe.sourceforge.net/" email="cctorok@yahoo.com" />
<icon src="icon.png" />
<categories>
<category name="Game">
<subcategory name="ActionGame" />
</category>
</categories>
</application>
</PXML>You can modify this file for every app you want to package, but for our little project this is just what we want.
Save the file and exit the editor.
There is something else we need right now and that is an icon for our game. As there is no default icon for Abe’s Amazing Adventure, I took a png from Google:
Code:
wget http://ubuntu.allmyapps.com/data/a/b/abe-abes-amazing-adventure/icon_48x48__usr_share_pixmaps_abe.pngLet’s rename it to fit the name we specified in the PXML.xml:
Code:
mv icon_48x48__usr_share_pixmaps_abe.png icon.pngNow put a copy of both files into the abe folder:
Code:
cp PXML.xml icon.png abe/Cd into the folder,
Code:
cd abeAs you might know, some programs need additional libs, that are not included in the original firmware. This program doesn’t, but we will nontheless package all the libs needed with it. Fort he learning experience ;-)
So create a new folder called lib and cd into the folder:
Code:
mkdir lib
Code:
cd libBut how do we know, what libraries are needed by the program? This can be found out with the nice little program called ldd.
This is not in the dev.extend by default, so we need to install it:
Code:
sudo opkg install lddWhen this finished we can check for the libraries with ldd:
Code:
ldd ../bin/abeThis will print out a list with all the needed libraries. So now we know which ones we need, copy them all to our lib folder:
Code:
cp /lib/libdl.so.2 /lib/libm.so.6 /usr/liblibSDL-1.2.so.0 /lib/libthread.so.0 /usr/lib/libSDL_mixer-1.2.so.0 /lib/libc.so.6 /lib/ld-linux.so.3 /usr/lib/libts-1.0.so.0 /lib/libgcc_s.so.1 /usr/lib/libmad.so.0 .Go out oft he folder:
Code:
cd ..Now we can create our startupscript, as seen in the PXML file:
Code:
touch abe.shWe also need to make it executable:
Code:
chmod +x abe.shNow we open the file and edit it:
Code:
nano abe.shHere you can see the contents of an abe.sh file, I made:
Code:
#!/bin/sh
# We don’t want to let the program write its configuration, savestates etc. to the NAND.
#So we need to export our HOME environment variable first.
export HOME=/mnt/utmp/abe
# There may be libs, that the program needs and that are not on the NAND by default.
#So we need to export the LD_LIBRARY_PATH environment variable to point to the libs we will package into our pnd.
export LD_LIBRARY_PATH=LD_LIBRARY_PATH:/mnt/utmp/abe/lib
#Now we need to launch our program.
./bin/abe
#You can attach any commandlinearguments to the above line, if a program needs them.Save and close the editor.
Then go to the abe-pnd folder again:
Code:
cd ..Now we should have everything, that will be packaged into the pnd.
The only thing we don’t have is the script to make the pnd. You can make a copy in this folder by typing:
Code:
cp /usr/pandora/scripts/pnd_make.sh .Now we are ready!
The usage of pnd_make.sh is as follows:
Code:
./pnd_make.sh –d yourfolder –p yourpnd.pnd –x yourpxmlfile.xml –i youricon.png –cThe –c ist to tell the script that it should create a compressed sqashfs filesystem instead fo iso in the pnd. This saves some space.
So in our case the command should be:
Code:
./pnd_make.sh -d abe –p abe.pnd –x PXML.xml –i icon.png -cExecute the script and you should have a fresh abe.pnd file in the same folder you are in now. Test it by copying it to one of your sdcards.
Now we should remove the folder in /mnt/utmp:
Code:
sudo rm -r /mnt/utmp/abeCongratulations! You packaged your first selfported game!
