Development Tools

Official Pandora Source Code Repository

The official source repository is under GIT revision control; EvilDragon is the admin, but the repo has a web based browser built in.===

Minor note on libpnd in the GIT; as skeezix (me) is too lazy to install vmware-tools for date sync, the check-in times are not accurate for libpnd; they're in order of course, but the actual date is usually off by many days, so don't sweat it.

The actual GIT repository is here: [1] It is recommended that you read the git structure information before going too far.

For stable released images, see other OpenPandora support pages. E.g. official forum software - pandora OS news.

Pandora Specific Libraries

libpnd - the Pandora Library

Libpnd hub‏‎ is a collection of utilities that Pandora developers may find useful, as well as including the daemons and tools for creating and working with PXML.xml based applications (pnd files or unpacked application directories.)

It is hoped the community will continue to expand this library over time!

Some stubs are included as hints .. for instance, the first dev to build a clean /dev/gpio based input library should slip it into libpnd so that others may benefit as well, avoid fragmentation and application bugs.

Continue into the main libpnd documentation hub.

Notaz SDL - improved SDL for Pandora

SDL on this wiki
enhanced SDL thread, on the boards

This library is very very useful for SDL-based ports and new games / apps.

• hardware scaling support (up and down)
• doublebuffering support (can eliminate tearing)
• vsync support (can give smooth scrolling if done right)
• keymap change with a config file (porting aid)

Tentative Library Environment

Information

Please note, that this information is hearsay/guesswork, and is yet to be confirmed on a production unit.

For Pandora (Out-Of-The-Box)

• glibc (at a guess, version 2.6.1 or whatever is compatible with OpenEmbedded)
• libSDL (also a guess, latest available version of 1.2)

For those interested in creating libraries, or needing more low-level access, read about the kernel interface.

Tools for Pandora Software Development

• OpenEmbedded cross-compile environment (and Angstrom distro) [2]
• CodeSourcery gcc[3]
  • [4] - NB: OpenEmbedded uses the CodeSourcery 2007q3 to build the kernel, but uses gcc 4.3.1 to compile everything else.
• TI CodeComposer Studio: Free Evaluation Tools[5]
• TI c6x Codegen tools for Linux[6]; License [7]; TI account required; this is *only* for Open Source development
• Das U-boot: The Universal Bootloader[8]
• Git - Fast Version Control System [9]; Good tuto: [10]

Kernel Source

• A read-only GIT repository for the kernel source has been made available (November 2008); the note from ED is:

If anybody wants to take a sneak peek at the current kernel, we've got a read-only GIT setup which features the most recent version of the MK2 OpenPandora Kernel.

The git is: [11]

Use the pandora-27-omap1 branch for the moment, there will soon be a 2.6.28.

• Kernel build instructions

OpenGL and ES

• GLES 2.0 emulator for PC[12] This works both on Linux and Windows. One needs to register with imgtec before downloading.
  • To build the applications a few environment variables need to be set (tested on Ubuntu Gutsy). Note that to run them, you do need an OpenGL 2.0 compliant gfx card.
    • LD_LIBRARY_PATH needs to be set to the folder holding the important libraries, such as libEGL.so ($SDK_PATH/Builds/OGLES2/LinuxPC/Lib might be enough)
    • To run the makefiles in the Training section you need to set a PLATFORM variable to either LinuxPC or LinuxGeneric. I have had success with LinuxPC.
    • See [13] for a script that you can run to set these for you.
• PowerVR Texture creation tool
  • "PVRTexTool enables conversion of standard bitmap files (e.g. BMP, JPG, PNG, TGA, etc.) to any texture type supported by POWERVR MBX or POWERVR SGX hardware including PVRTC, DXT and ETC compressed formats. Both a GUI and command line version are supplied for Windows and Linux. There are also plug-ins for Autodesk 3ds Max, Maya and Adobe Photoshop." - requires imgtec registration.
  • Note, this is part of the main SDK - (Linux path to it is /SDKPackage/Utilities/PVRTexTool/)

Packaging

(See also Make and run simple PND‏‎ and the PND package format)

• pnd_make.sh - a straightforward shell script to build PND files from a prepared directory. Included with libpnd and, therefore, in all Pandoras
• PNDbuilder - a graphical tool to build PNDs. Can be used in Windows or on the Pandora.
• distPND - an extension to Python's Distutils designed to make PND files from Python source quickly and easily.

Profiling

If you need performance analysis, you can find a compiled version of the "perf" tool there : http://boards.openpandora.org/index.php?/topic/9809-profiling/#entry181954
Just unzip the tool somewhere and launch it with LD_LIBRARY_PATH set.

See https://perf.wiki.kernel.org/index.php/Main_Page to learn how to use it and happy optimizations!