Pandora Wiki - User contributions [en]

Talk:Production Timeline

2011-06-16T11:24:47Z

Tsh: /* Table or heirachical list */ new section

Brief history here: [http://openpandora.org/index.php?option=com_content&view=article&id=116&Itemid=25&lang=en]
--[[User:Cheese|Cheese]] 00:16, 9 July 2010 (MEST)

== 13 Aug ==

I had been avoiding the random partial build statuses, only counting actual shipments, so I might change this when they actually leave. According to ED, these PCBs are not with Craig yet

== There's a reason I put it on the main page ==

"Open Pandora is so lazy! 2000 units in two years? Come on!"

<nowiki>*looks*</nowiki>

"Oh wait, they went through tons of shit. Silly me!"

[[User:Blue Protoman|Blue Protoman]] 02:26, 20 February 2011 (MET)

== We need more info ==

We need to add a bit more info to the timeline. Notably, the entire fiasco with the case factory is missing. Someone mind shedding some light on this?

[[User:Blue Protoman|Blue Protoman]] 02:28, 20 February 2011 (MET)
:Not quite sure what your point is? The fiasco with the case factory is pretty normal in the course of production. Did anything tangible occur in 2009? We saw a few iterations of the case, some software work, and I think 2010 started with the wifi no longer working. Maybe the case thing was the most visible outside the team, but thats how long these things take. It's still all on GP32X, so all it takes is for someone to go back and see if there are a few key items to pull out. I'd rather this page didn't end up being a 'why did it take so long' discussion - that can be something else if you want. If you want data, ask on the forum. --[[User:Tsh|Tsh]] 11:09, 20 February 2011 (MET)

== Table or heirachical list ==

I much prefer the format [http://pandorawiki.org/index.php?title=Production_Timeline&oldid=7586 here] which breaks each year down into headings rather than the 'stuff it all in a table' format, which has no benefit. I'll revert it unless anyone can justify the change.

WiFi

2011-06-05T10:14:49Z

Tsh: Tidying some of the empty links from the quickstart page

#REDIRECT [[Wifi]]

Talk:Introduction to PNDs

2011-02-25T00:24:59Z

Tsh: clock defaults?

==I want to override the .PND icon, name, or other settings, how is this done?==
This section mentions changing the clock speed, but [[Overclocking]] seems to cover the current method. I'm not sure... --[[User:Tsh|Tsh]] 01:24, 25 February 2011 (MET)

User manual

2011-02-22T21:05:19Z

Tsh: /* Where Can I Get More Apps? */ PandaPacks

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device. We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|The Pandora.]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box (so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion! Ask on the [http://boards.openpandora.org/ Official Open Pandora forum] if you want a definitive answer.

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [http://www.open-pandora.org/ Open Pandora Ltd.] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [http://www.open-pandora.org/ Open Pandora Ltd] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case (note: it can be difficult to open. [http://boards.openpandora.org/index.php?/topic/963-complain-about-battery-case-here/ Here] is how to do it)
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 3rd November 2010 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric [[keypad]]
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB [[NAND]] FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric [[keypad]]
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while ''off''. This is currently a feature and may change in future versions of the firmware.

You can find more useful information about charging on the [[power modes]] page.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

Finally, don't just leave your Pandora plugged in forever. Unplug it once every couple days while using it to allow the battery to discharge from full (to around 90% or less?). If you're not going to use your Pandora for a while, discharge the battery to around 40%, remove the battery, wrap it in a plastic bag (a Ziplock-type bag?), and stick it in the fridge.

Leaving your Pandora plugged in indefinitely, even while in low-power mode, may damage the battery! See the [http://boards.openpandora.org/index.php?/topic/640-warning-dont-leave-your-pandora-plugged-in-for-too-long/|the Open Pandora Boards] for more details.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==
See the [[GUI]] page for more details on the user interfaces which can be used with the Pandora.

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

=====Skinning=====

Skinning guide in gp32x forum: http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/

A mmskin.conf from February 2011: http://git.openpandora.org/cgi-bin/gitweb.cgi?p=pandora-libraries.git;a=blob;f=minimenu/skin/default/mmskin.conf;h=695888b3ae310d7ea04b4e682baed0c0c6fc4349;hb=98c1d081629ac9cbb3056b39097a3db968ce4055

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal [[NAND]].

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

If a window is too tall to fit on the screen you can move it by holding down the left sholder button and dragging the window with the stylus.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application. If that doesn't work, you can do a hard-reset of the Pandora by pressing and holding the Pandora button, then flicking the power switch to the right.

===Power modes===

The [[Power modes]] page provides full details of power modes, charging and battery care and lifetime.

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behavior of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal [[NAND]]; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full featured web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail (warning: do not use ClawsMail, it will fill up your [[NAND]]. Solutions are [http://www.gp32x.com/board/index.php?/topic/56810-html-viewer-for-claws-mail/page__view__findpost__p__919458 being worked on]).
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*To help with the massive range of applications, a member of the community has started to produce [[PandaPacks]] for some pre-packaged games, emulators and distributable ROMs in handy SD card filling torrents.

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to [[NAND]] by default, so should be used with great caution. Type "df -h" into the terminal to see how much space you have left.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before some time in 2011).

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal [[NAND]] to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.
* [[Software projects]] - A list of all non-emulator, non-game software for Pandora.

[[Category:Categories]]

Emulators

2011-02-22T21:01:26Z

Tsh: /* Where to download emulators */ PandaPacks

:''Please visit the '''[[Emulator list]]''' article for a full list of available emulators.''
'''Emulators''' are applications which reproduce another, different computer system in software allowing the software from one machine to be run on another. Emulators are used for a wide range of purposes. For example, OS X provides emulation on x86 computers to allow old PowerPC binaries to be run. Microsoft provide an ARM PDA emulator for testing applications without having to repeatedly copy things onto a device.

One of the most popular uses for emulators however is to play video games from older (or in some exceptional circumstances, current) systems on modern hardware (generally PCs but the Pandora, GP2X, GP32 and PSP are also popular platforms for running emulators). Nintendo sells a number of official emulators through its Virtual Console service for the Wii.

== Pandora and emulators ==
One of the popular uses for the Pandora is to run emulators of old video games systems (though some old home computers and calculators are also emulated). The Pandora is suited to this task because it has a fairly standard control layout similar (or almost identical to) the layouts of the input devices of the systems it emulates. Furthermore, it has an LCD of resolution 800x480, which is large enough to accommodate most older systems without any downscaling. Of course, it is also portable meaning you can play these games whenever and wherever you want without having to carry a TV, machine and collection of cartridges.

== What is needed to run emulators ==
In most cases, emulators can simply load software and run. However, some require a dump of the BIOS ROM stored within the system itself. These dumps cannot be distributed legally without the permission of the company/individual who created them due to them being copyrighted. In some cases (such as the GBA) it may be feasible to extract a dump of the BIOS yourself if you own a GBA and the necessary equipment but for others (like the PlayStation) the only way most people can obtain a BIOS dump is to illegally download it. Each system has a unique BIOS, though many older ones don't have a BIOS at all, or it is emulated along with the hardware. You should check the individual pages for each emulator to see if they need a BIOS dump to run.

An emulator is no use without software to run on it. These normally come in the form of ROM dumps (since they are extracted from the ROM chips that used to be used to distribute software) generally known as just "ROMs". A few ROMs are "homebrew", that is, free software or freeware. However, ROMs of commercial games are illegal under copyright law unless you dump them yourself (and even then you are only allowed to make use of them under very specific circumstances). ROMs for one system will not work on another system's emulator, just as you can't plug Super Nintendo cartridges into a PlayStation and run them. As such, you need ROMs for each system and an emulator for each system (though some special cases exist such as MAME which will run ROMs from multiple arcade systems).

== What the Pandora can emulate ==
The Pandora, despite its apparent low clock speed when compared to those of modern desktop PCs, is a powerful system (clock speeds cannot be reliably compared between systems). Although there is very little hardware for accelerating graphics functions, the CPU is fast enough to emulate many systems purely in software. This means that there are literally tens of thousands, possibly hundreds of thousands of games which can be played on the Pandora if you are able to obtain the software. You can see for yourself what the Pandora can emulate by checking the [[Emulator List]].

== Where to download emulators ==
Most software (including emulators) for the Pandora can be obtained from either [http://apps.openpandora.org/ Pandora Apps] or the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive]. Check out the [[PandaPacks]] for some pre-packaged games, emulators and distributable ROMs.

== Emulator Compatibility ==
This wiki houses compatibility and performance lists for various emulators available on the Pandora. You can find these on the [[Emulator Compatibility]] page.

Please do add to these lists as you test more games so that others may benefit from settings you may have discovered (for some users a particular game running well is enough to justify the purchase).

== Legal ROM Sources ==
There are a number of websites dedicated to providing downloads to completely legal ROMs, see the page, [[Legal Emulation Resources]] for more information. If you choose to download from a source not guaranteed to contain legal ROMs, you should first make yourself aware of the laws regarding ROMs in your region.

== Emulator list ==
See the page, [[Emulator list]].

For a list of announced projects, please see the list of potential emulators and development status on the GP32X forums: [http://www.gp32x.com/board/index.php?showtopic=47518]

== Deciding what games to play ==
See the page, [[Emulation essentials]].

[[Category:Emulators]]
[[Category:Software]]

Quickstart

2011-02-22T20:59:29Z

Tsh: /* Download a game */ lint

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix4 here, although a [http://www.gp32x.com/board/index.php?/topic/58260-upcoming-hf5-firmware-image/ beta version of Hotfix 5] is also out as of January 2011. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.
[[Image:Pandorasd.thunar.png|thumb|alt=SD card folder structure|A Pandora SD card as it appears in Thunar, the default file browser on the Pandora. Figure 1 is the SD card itself (yours will have a different name). Figure 2 shows us that a /pandora folder has already been created on the card, and we're browsing inside it. Figure 3 shows the subfolders within the /pandora folder.]]
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''Click here to download HotFix Package 4'' link for the latest HotFix Package (It's located under the "HotFix Package 4 - for Pandora OS Release 2010-05 (Zaxxon)"). (31-8-2010 - Hotfix 4: [http://www.open-pandora.org/downloads/HotFix4-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder[[Image:Hotfix installed.jpg|thumb|alt=Hotfix screenshot|This is where you can find the hotfix installer. Click for a larger view.]]
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 4 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==
Well, no instructions for a specific game, but for a simple starting point of legaly redistributable games, emulators and ROMs, check out the [[PandaPacks]] which you can download, copy to SD card and just run.

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Fix known problems with the default installation==
It is assumed your are using Xfce for these fixes. If you wish to switch back to MiniMenu after making these changes see above.

===Take ownership of your home directory===
Your home directory is owned by root in the default installation. Until this is fixed you won't be able to write to your home directory.

# In Xfce, open up the menu by pressing the Pandora button
# Select ''Terminal'' from the menu.
# Type ''whoami'' and press [ENTER]
# Note your user-name which has just been printed to the terminal
# Type ''sudo chown {your user-name} .''
# Enter your password and press [ENTER] if it is required
# Type ''sudo chgrp {your user-name .''
# Enter your password and press [ENTER] if it is required

===Fix the installer's time-zone set-up===
There appears to be a problem with Pandora's first-run wizard that incorrectly sets up your time-zone. This can cause confusing behaviour when you or a program attempts to change the system time. Instructions are taken from this [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/] board post.

# In Xfce, open up the menu by pressing the Pandora button
# Select ''Terminal'' from the menu.
# Enter the following commands:
# ''cd /usr/share/zoneinfo''
# ''ls''
# Note the continents listed, such as ''America'' and ''Australia''
# Enter the following commands, where ''America'' is your continent:
# ''cd America''
# ''ls''
# Find a listed city in the same timezone as you
# Determine the full path of the file you have chosen. For instance for the Eastern timezone use ''/usr/share/zoneinfo/America/New_York''
# Enter the following commands, replacing ''021915402011'' with the current date in ''MMDDHHMMYYYY'' format, and ''America/New_York'' with your city:
# ''sudo ln -sf /usr/share/zoneinfo/America/New_York /etc/localtime''
# ''export TZ=America/New_York''
# ''echo "export TZ=America/New_York" >>~/.bashrc''
# ''date 021915402011''

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

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

Quickstart

2011-02-22T20:58:58Z

Tsh: /* Download a game */ PandaPacks

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix4 here, although a [http://www.gp32x.com/board/index.php?/topic/58260-upcoming-hf5-firmware-image/ beta version of Hotfix 5] is also out as of January 2011. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.
[[Image:Pandorasd.thunar.png|thumb|alt=SD card folder structure|A Pandora SD card as it appears in Thunar, the default file browser on the Pandora. Figure 1 is the SD card itself (yours will have a different name). Figure 2 shows us that a /pandora folder has already been created on the card, and we're browsing inside it. Figure 3 shows the subfolders within the /pandora folder.]]
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''Click here to download HotFix Package 4'' link for the latest HotFix Package (It's located under the "HotFix Package 4 - for Pandora OS Release 2010-05 (Zaxxon)"). (31-8-2010 - Hotfix 4: [http://www.open-pandora.org/downloads/HotFix4-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder[[Image:Hotfix installed.jpg|thumb|alt=Hotfix screenshot|This is where you can find the hotfix installer. Click for a larger view.]]
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 4 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==
Well, no instructions for a specific game, but for a simple starting point of legaly redistributable games, emulators and ROMs, check out the [PandaPacks] which you can download, copy to SD card and just run.

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Fix known problems with the default installation==
It is assumed your are using Xfce for these fixes. If you wish to switch back to MiniMenu after making these changes see above.

===Take ownership of your home directory===
Your home directory is owned by root in the default installation. Until this is fixed you won't be able to write to your home directory.

# In Xfce, open up the menu by pressing the Pandora button
# Select ''Terminal'' from the menu.
# Type ''whoami'' and press [ENTER]
# Note your user-name which has just been printed to the terminal
# Type ''sudo chown {your user-name} .''
# Enter your password and press [ENTER] if it is required
# Type ''sudo chgrp {your user-name .''
# Enter your password and press [ENTER] if it is required

===Fix the installer's time-zone set-up===
There appears to be a problem with Pandora's first-run wizard that incorrectly sets up your time-zone. This can cause confusing behaviour when you or a program attempts to change the system time. Instructions are taken from this [http://boards.openpandora.org/index.php?/topic/34-anki-friendly-intelligent-flashcards/] board post.

# In Xfce, open up the menu by pressing the Pandora button
# Select ''Terminal'' from the menu.
# Enter the following commands:
# ''cd /usr/share/zoneinfo''
# ''ls''
# Note the continents listed, such as ''America'' and ''Australia''
# Enter the following commands, where ''America'' is your continent:
# ''cd America''
# ''ls''
# Find a listed city in the same timezone as you
# Determine the full path of the file you have chosen. For instance for the Eastern timezone use ''/usr/share/zoneinfo/America/New_York''
# Enter the following commands, replacing ''021915402011'' with the current date in ''MMDDHHMMYYYY'' format, and ''America/New_York'' with your city:
# ''sudo ln -sf /usr/share/zoneinfo/America/New_York /etc/localtime''
# ''export TZ=America/New_York''
# ''echo "export TZ=America/New_York" >>~/.bashrc''
# ''date 021915402011''

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

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

Talk:Production Timeline

2011-02-20T10:09:42Z

Tsh: /* We need more info */

Power modes

2011-02-20T09:50:50Z

Tsh: /* Charging */ - USB charge from flat workaround.

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes. Note that as of hotfix3, opening the lid in low power mode has no effect.

====Normal Mode====
This is the normal operating mode, screen on, WiFi and Bluetooth on if requested. CPU speed can be selected by the user, and has a small impact on battery life. Screen brightness will also have a significant effect on battery life. The CPU should automatically self-regulate to the current task, and 10-14 hours battery life is possible depending on usage. This is mostly independent of the set CPU speed for any given task. At any time, the battery gauge will show the remaining battery life ''if the usage remains the same as over the past some seconds''.

====Lid Closed====
The only change with the lid closed is to turn off the LCD backlight. This improves battery life, allowing music playback and streaming to continue. As of Hotfix2, the screen remains on if the device is powered up with the screen closed. It is also possible to set xfce to blank the screen after a period of inactivity, which helps with battery.

====Low Power====
Low power mode is toggled by a short press of the power switch to the right. The screen is off, the radios are disabled, the CPU max speed is set to 14 MHz. The device is still silently on, allowing for alarms to go off or it to be turned on again instantly. The power LED will be dimmed, and may appear to be off if you are outside.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few days or longer.

Since the Pandora has to be powered whilst it is charging, low power mode is best for fastest charging, and will even allow a full charge to be achieved from USB. It is also the best way to use the Pandora as a USB charger for other devices.

Opening the screen whilst in low power mode has no effect (screen stays off, clocks stay low), and you will need to use the power switch to resume.

At the moment, there is no clear advantage in slowing the clocks (other than being an effective pause button when playing MP3). The only saving is through disabling the radios. This is likely to be improved in due course since there are features in the omap processor for power saving which are being added to the linux kernel.

====Power Off====
Select Logout then Shutdown from the window manager to power off. If a charger is connected, the device will re-boot immediately. It is possible to get into a state where you believe it is powered off, but in fact it is using power at the normal screen off rate - so after 12 hours, 50% of your battery is gone. The Power green LED ought to be a tell-tale. It is possible that some bugs exist in this area, but nothing has been clearly identified[http://www.gp32x.com/board/index.php?/topic/54652-solved-pandora-lost-charge-overnight/]

A common problem seems to be that if you switch off ''before'' unplugging, your Pandora will re-boot even though it is now left unplugged. This problem is compounded by the low battery shutdown script being called repeatedly (and actually preventing shutdown).

To do a '''hard-reset''' of the Pandora (in case of software crashes), press and hold the Pandora key and flick the power button to the right.

==Events==
The events which control power can be customised [http://www.gp32x.com/board/index.php?/topic/54544-forcing-shutdown-at-10-battery-life/page__view__findpost__p__878418]. Lid switch, Power Switch, battery threshold and Window Manager shutdown commands. Note that the battery manager in xfce will also take action when the battery is low, by default forcing a shutdown at 5% (so you may observe a full boot process, the window manager appears, then immediately shuts down)

==Charging==
[[image:Power_uk.png|thumb|alt=UK charger and adapter|UK charger and adapter]]
It is possible to charge from the mains charger (use the supplied one or a ''GENUINE'' PSP adaptor only) or USB cable. While a charger is connected, remaining battery level is displayed, but the time displays 00:00. If charging from USB, it is possible that the battery will still discharge slowly, since the Pandora takes more current (in normal mode) than the USB can supply. Mains charge is configured to draw 1000mA, USB charge is more like 500mA.

It is not possible to charge the Pandora without turning it on - the charging circuits rely on the CPU for configuration. In practice, this has minimal impact on usage, except that after charging, you might wish to explicitly turn off (and maybe there is a easy way to automate this by adding a charger event to call a script)

If your Pandora's battery is at less than 1% (actually configurable in XFCE), then you may have problems in using USB to charge the Pandora. Currently, USB is not recognised by the XFCE battery monitor so it will shutdown with no warning. As a workaround, you can put your Pandora into low power mode as soon as the flashing mouse icon (XFE startup) appears. This should significantly delay loading the battery monitor widget, and even if the charge hasn't passed 1% by the time it checks, on the next try you should be there.

==Opperating Point==
The ''OPP'' is a TI term which reflects the fact that low clock speeds can be achieved with lower supply voltage than the higher clock speeds. Increasing OPP will reduce the lifetime of the device significantly (from 10 years to 5 years of continuous use.) OPP3 is the default as shipped by OpenPandora. As of Hotfix4, it is possible to set a maximum OPP in the range 1-5 (for example, to 5):
<pre>echo 5 | sudo tee -a /proc/pandora/cpu_opp_max</pre>
This will then increase OPP to suit the requested CPU max, as pre-determined by a table built in to the kernel. These thresholds use OPP1 for below 125 MHz, and OPP5 for above 720 MHz. It is possible to set the limiter and maybe run at 500 MHz in OPP2 (depending on your specific chip). See [http://boards.openpandora.org/index.php?/topic/22-using-hotfix4-how-high-can-you-clock/ this forum thread] for actual results.

'''''Using anything above OPP3 WILL shorten the lifetime of your Pandora, although it should still outlive the 1 year warranty. Using anything above OPP5 will void your warranty.'''''

Tweaking scripts to make this tuning easier are in the works.
==Monitoring==
The kernel provides some information about battery state through the filesystem. See [[Data_provided_by_Battery_and_Power_driver]]. This may help with diagnosing problems.

==Times==
(These are my estimates, mostly from HotFix3. Please add to the data section in the talk page, and be clear about the conditions you use)
{| border="1"
|+ Charge/Discharge times
! Mode !! Time
|-
! Normal Operating
| 10-14 hours
|-
! MP3 play, screen off
| 17 hours (May improve)
|-
! Lid Closed
|16-23 hours (est, depends on wifi)
|-
! Low Power
|23 hours (maybe 30 with Hotfix4)
|-
! Power off
|about 5% per week charge loss (although there are reports of much faster drain?[http://boards.openpandora.org/index.php?/topic/24-battery-drain/])
|-
! Mains charge, operating
| 20 hours (est)
|-
! Mains charge (low power)
|8 hours (est)
|-
! USB Charge, operating
| 20 hours (inactive, screen+wifi on), may charge or discharge depending on load
|-
! USB Charge, low power
|20 hours (est)
|}

==Battery Care==
* You can charge your battery to full charge, the charging circuits will then reduce the current to avoid overheating
* If you won't use the battery for more than a week, it is best to leave it at about 40% charged (as opposed to full)
* Don't worry about running it down too low, there are protection circuits to avoid a damagingly low discharge.
**Avoid leaving the battery completely discharged though. When the power runs out, the system will be unable to shutdown cleanly, and might corrupt your files or the system.
* No harm will come if you only partially recharge it. If you've only got 10 free minutes to charge before leaving, go ahead. You'll put an hour of usage back into the battery, and you can always charge it more later.
* For best accuracy, the battery meter relies on watching the battery discharge over most of it's range (down to say 10%).
**This will only affect the 'time to run' indication
* If you're not going to be using your battery for a very long time, the extremely best thing you can do for it is to discharge to 40%, seal it in an airtight bag, and put it in the fridge. Even years later, you pull it out, and it will be almost as good as when you put it in.

[[Category:Hardware]]

Production Timeline

2011-01-31T12:44:39Z

Tsh: /* 2011 */ premium pandora

==Pandora Production Timeline==
Please feel free to either contribute on the talk page, or update here. I am adding some milestones which I can't easily track down the dates for - hopefully others will have bookmarked key forum posts, etc.
===2007===
'''December''': Pandora section in GP32X forums opened

===2008===
'''September 30''': 3000 units were made available for pre-order, resulting in server overload and crashes.

'''Within first few days''': Pre-order extended to 4000 units.
:The first mention of this (that I have found so far) is in a [http://www.gp32x.com/board/index.php?/topic/45065-ram-upgrade-and-credit-card-orders-the-readers-digest-version/ post] by Chip.

'''Early October''': Craig's bank account frozen. Later on, refunds start to be sent out [http://www.openpandora.org/index.php?option=com_content&view=category&layout=blog&id=2&Itemid=2&lang=en&limitstart=111]

'''October 30''': Amount of ram increased to 256MB (from 128MB), NAND increased to 512MB (from 256MB). [http://www.gp32x.com/board/index.php?/topic/45019-pandora-now-has-256mb-of-ram-and-512mb-internal-nand-storage/page__view__findpost__p__663880]

===2009===
'''January''': Re-paying for pre-orders begins [http://www.gp32x.com/board/index.php?showtopic=46235&hl=]

Renders of the case shown off [http://pandorapress.net/2009/01/23/sneak-preview-render/]

Pre-ordering re-opened to fill places freed up after the great banking event. Only cash/bank transfer payments were accepted, no credit payments.

Prototype caseworks received.

Populated PCBs shown off.

===2010===

'''May 21''': First shipments start[http://www.open-pandora.org/index.php?option=com_content&view=article&id=177%3Ait-finally-happened&catid=2%3Ablog&Itemid=2&lang=en].
: Helpers on the production line seem to have been paid in pandora, first one here[http://www.gp32x.com/board/index.php?/topic/53552-look-who-flew-the-nest/]. By June 25th, the parts which arrived in the first shipment were exhausted, with approximately 400 shipped to GBAX customers, and 200 to EvilDragon's customers in mainland Europe. These shipments went to people who pre-ordered in the first 1.5 hours (roughly). Some 50 odd units shipped with only one fully working nub (to pre-orderers who choose to take one in order to skip the queue). Of these, 5 were left over that nobody had chosen to take and auctioned on eBay by Craig for £279.99. There were an additional 7 units with both nubs not fully functional[http://www.gp32x.com/board/index.php?/topic/54711-7-dead-nub-units-to-go/]. These were offered at £150.00 on the boards and seem all to have sold at that price. The highest price on eBay for one of the first ~600 units was ~$1600???

'''July 1''': 2nd Batch Pre-order emails start to be sent out.
: 2nd batch is priced[http://www.gp32x.com/board/index.php?/topic/54958-just-had-my-2nd-batch-pre-order-email] at £279.99/340 EUR (includes VAT) or $349. Ordering from the 2nd batch is offered as a way of getting a Pandora before Christmas, the shipment of the first 4000 predicted to complete around October 2010 with a continuous progression into the 2nd batch at this point.

'''Mid-July''': Production is stalled to help prevent building more units with faulty nubs.
: See the "[[Nubs#Early_Nub_Problems |Nubs]]" page for details.

'''Aug 04''': Another 100 from the first batch start to ship[http://www.gp32x.com/board/index.php?/topic/54915-uae4all-additions/page__view__findpost__p__900610]
: Along with a few more one-nub units, these are the first units to ship since the nub tolerance problems were identified and the factory re-supplied with 100% tested nubs. (requiring some previously 'ready to ship' boards to be re-worked) This small shipment was used for approval before any more populated boards were shipped from the factory.

'''Aug 13''': Another 200 are in the process of being built[http://twitter.com/Craigix/statuses/21061399677][http://www.gp32x.com/board/index.php?/topic/55937-200-pandoras-shipping-wc-16-august/]

'''Sep 20''': 100 scheduled to ship[http://boards.openpandora.org/index.php?/topic/254-birthplace-of-a-pandora-board-and-a-power-loss-2010-09-16/page__view__findpost__p__4627], taking production past the 1000 mark.
: These are still using nubs from the 1st production run, tested to select good ones. New prototype nubs are still in final testing. Since 150 of these shipped out of sequence (with faults), this equates to roughly 600 in the GBAX queue, and an hour into pre-ordering.

'''Oct 6''':2000 cases arrive in the UK[http://twitter.com/#!/Craigix/status/26571340236].
: This allows first phase assembly to re-commence (displays in lids, etc). Still waiting for updated nubs to be prototyped and produced (although populated PCBs are waiting).

===2011===
'''Jan 5''' :First Pandora from a batch of 350 boards that shipped over Christmas has been delivered[http://boards.openpandora.org/index.php?/topic/917-pcb-production-continues-2011-01-04/page__view__findpost__p__16989]
: These are the first boards produced after production was halted whilst the nubs were improved and re-designed. PCB production has continued with at least another 400 ready to be shipped from Texas.
'''Jan 7''' : 400-550 units shipped to customers this week.[http://boards.openpandora.org/index.php?/topic/917-pcb-production-continues-2011-01-04/page__view__findpost__p__17458]
: By 11th Jan, delivered units had reached orders at 4:30 GMT on 30th Sep'08[http://www.gp32x.com/board/index.php?/topic/54432-got-your-pandora-tell-us-your-order-date/page__st__105]
'''Jan 27''' : Craig announces that Pandoras can be ordered for delivery within 7 days at a price of $500[http://boards.openpandora.org/index.php?/topic/1274-instant-pandora-with-a-premium/]
: This is to fund an immediate increase in the final assembly team and will be in parallel with the pre-order assembly which ought to be sped up (and the premium price units will be limited in quantity)

Production Timeline

2011-01-15T19:09:05Z

Tsh: /* 2011 */ most recent reported order time.

Production Timeline

2011-01-06T18:05:08Z

Tsh: /* 2010 */ add Jan'11 first shippment

==Pandora Production Timeline==
Please feel free to either contribute on the talk page, or update here. I am adding some milestones which I can't easily track down the dates for - hopefully others will have bookmarked key forum posts, etc.
===2007===
'''December''': Pandora section in GP32X forums opened

===2008===
'''September 30''': 3000 units were made available for pre-order, resulting in server overload and crashes.

'''Early October''': Craig's bank account frozen. Later on, refunds start to be sent out [http://www.openpandora.org/index.php?option=com_content&view=category&layout=blog&id=2&Itemid=2&lang=en&limitstart=111]

'''October?''': Pre-order extended to 4000 units.
:The first mention of this (that I have found so far) is in a [http://www.gp32x.com/board/index.php?/topic/45065-ram-upgrade-and-credit-card-orders-the-readers-digest-version/ post] by Chip.

'''October 30''': Amount of ram increased to 256MB (from 128MB), NAND increased to 512MB (from 256MB). [http://www.gp32x.com/board/index.php?/topic/45019-pandora-now-has-256mb-of-ram-and-512mb-internal-nand-storage/page__view__findpost__p__663880]

===2009===
'''January''': Re-paying for pre-orders begins [http://www.gp32x.com/board/index.php?showtopic=46235&hl=]

Renders of the case shown off [http://pandorapress.net/2009/01/23/sneak-preview-render/]

Pre-ordering re-opened to fill places freed up after the great banking event. Only cash/bank transfer payments were accepted, no credit payments.

Prototype caseworks received.

Populated PCBs shown off.

===2010===

'''May 22''': First shipments start[http://www.open-pandora.org/index.php?option=com_content&view=article&id=177%3Ait-finally-happened&catid=2%3Ablog&Itemid=2&lang=en].
: Helpers on the production line seem to have been paid in pandora, first one here[http://www.gp32x.com/board/index.php?/topic/53552-look-who-flew-the-nest/]. By June 25th, the parts which arrived in the first shipment were exhausted, with approximately 400 shipped to GBAX customers, and 200 to EvilDragon's customers in mainland Europe. These shipments went to people who pre-ordered in the first 1.5 hours (roughly). Some 50 odd units shipped with only one fully working nub (to pre-orderers who choose to take one in order to skip the queue). Of these, 5 were left over that nobody had chosen to take and auctioned on eBay by Craig for £279.99. There were an additional 7 units with both nubs not fully functional[http://www.gp32x.com/board/index.php?/topic/54711-7-dead-nub-units-to-go/]. These were offered at £150.00 on the boards and seem all to have sold at that price. The highest price on eBay for one of the first ~600 units was ~$1600???

'''July 1''': 2nd Batch Pre-order emails start to be sent out.
: 2nd batch is priced[http://www.gp32x.com/board/index.php?/topic/54958-just-had-my-2nd-batch-pre-order-email] at £279.99/340 EUR (includes VAT) or $349. Ordering from the 2nd batch is offered as a way of getting a Pandora before Christmas, the shipment of the first 4000 predicted to complete around October 2010 with a continuous progression into the 2nd batch at this point.

'''Mid-July''': Production is stalled to help prevent building more units with faulty nubs.
: See the "[[Nubs#Early_Nub_Problems |Nubs]]" page for details.

'''Aug 04''': Another 100 from the first batch start to ship[http://www.gp32x.com/board/index.php?/topic/54915-uae4all-additions/page__view__findpost__p__900610]
: Along with a few more one-nub units, these are the first units to ship since the nub tolerance problems were identified and the factory re-supplied with 100% tested nubs. (requiring some previously 'ready to ship' boards to be re-worked) This small shipment was used for approval before any more populated boards were shipped from the factory.

'''Aug 13''': Another 200 are in the process of being built[http://twitter.com/Craigix/statuses/21061399677][http://www.gp32x.com/board/index.php?/topic/55937-200-pandoras-shipping-wc-16-august/]

'''Sep 20''': 100 scheduled to ship[http://boards.openpandora.org/index.php?/topic/254-birthplace-of-a-pandora-board-and-a-power-loss-2010-09-16/page__view__findpost__p__4627], taking production past the 1000 mark.
: These are still using nubs from the 1st production run, tested to select good ones. New prototype nubs are still in final testing. Since 150 of these shipped out of sequence (with faults), this equates to roughly 600 in the GBAX queue, and an hour into pre-ordering.

'''Oct 6''':2000 cases arrive in the UK[http://twitter.com/#!/Craigix/status/26571340236].
: This allows first phase assembly to re-commence (displays in lids, etc). Still waiting for updated nubs to be prototyped and produced (although populated PCBs are waiting).

===2011===
'''Jan 5''' :First Pandora from a batch of 350 boards that shipped over Christmas has been delivered[http://boards.openpandora.org/index.php?/topic/917-pcb-production-continues-2011-01-04/page__view__findpost__p__16989]
: These are the first boards produced after production was halted whilst the nubs were improved and re-designed. PCB production has continued with at least another 400 ready to be shipped from Texas.

Overclocking

2010-11-02T20:56:13Z

Tsh:

The The Pandora's CPU can officially run at 600Mhz, but most Pandoras can also run at higher speeds. This will make CPU-intensive programs (such as an N64 emulator) run smoother. If you try a speed that's too high, your Pandora will freeze up. Simply turn off your system, then turn it back on, and you'll be good as new. If you still have problems, take out your battery for a minute before turning on your Pandora (this will discharge the backup capacitor that was designed to retain RTC while the battery is being changed [http://www.gp32x.com/board/index.php?/topic/57303-overclocking-broke-my-pandora/page__view__findpost__p__924479])

==CPU Speed==
The OS comes with the ability to modify the CPU speed from the GUI. Under 'System' in the menu, you should find 'CPU-Speed'. This gives you a slider to set the speed between 14 MHz and 900 MHz. If you attempt to set anything over 600 MHz, you will be presented with a warning dialogue.

Note that the OMAP core will actually adjust it's speed to match the load, you are setting the upper limit. On it's own, reducing the clock speed has little impact on battery life.

==Voltage Scaling==
This is where it gets complicated. At low frequencies, the OMAP can still work with a reduced voltage, and that causes it to drain the battery a little slower. Alternatively, you can increase the voltage and maybe get a higher overclock '''This WILL reduce the lifetime of your Pandora''' At the moment, there is no gui method of changing the operating voltage (which is specified as an 'opp' in the range 1-5, with 3 being the default)

If you reduce the CPU speed below specific thresholds, the voltage will automatically adjust downwards. In the proc/pandora filesystem, cpu_opp_max (default 3) is the upper limit. if you set this to 1 whilst still running at the default 500 MHz, your pandora is very likely to crash. At 4, you may see almost as good an overclock performace as at 5. '''REMEMBER: OverVolting can halve the life of your pandora'''

A GUI tuning tool is likely to make tweaking this easier. Specifically setting preferred max stable overclock, warnings on overclock, and over-volt options.

==App Specific Speed Control==
It is possible to auto configure specific applications to increase the CPU speed whilst running. Applications can be configured to prompt with a suggested speed, and you are given the option to select a speed, making the choice persistent if desired. This is done by placing a 'cpuspeed' file in the /pandora/appdata/{pnd_name}/ directory. Delete the file to have the app ask again next time it is run.

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

Talk:Power modes

2010-10-21T17:07:59Z

Tsh: /* Self-discharge */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)

The total battery drain over the course of one week and one day, with a few minutes of usage on two occasions, was 6%. [http://boards.openpandora.org/index.php?/topic/24-battery-drain/page__view__findpost__p__6088]

==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off (Hotfix 3)

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

Hotfix 4
250 MHz, opp1 2:55, 10% (30 hours)

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
500 MHz opp5 1:15, 7% (18 hours) - deadbeef 
900 MHz opp5 2:30, 15% (18 hours) - deadbeef 
250 MHz oop1 2:30, 15% (18 hours) - deadbeef

Power modes

2010-10-21T17:06:57Z

Tsh: /* Times */ off for a week 6%

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes. Note that as of hotfix3, opening the lid in low power mode has no effect.

====Normal Mode====
This is the normal operating mode, screen on, WiFi and Bluetooth on if requested. CPU speed can be selected by the user, and has a small impact on battery life. Screen brightness will also have a significant effect on battery life. The CPU should automatically self-regulate to the current task, and 10-14 hours battery life is possible depending on usage. This is mostly independent of the set CPU speed for any given task. At any time, the battery gauge will show the remaining battery life ''if the usage remains the same as over the past some seconds''.

====Lid Closed====
The only change with the lid closed is to turn off the LCD backlight. This improves battery life, allowing music playback and streaming to continue. As of Hotfix2, the screen remains on if the device is powered up with the screen closed. It is also possible to set xfce to blank the screen after a period of inactivity, which helps with battery.

====Low Power====
Low power mode is toggled by a short press of the power switch to the right. The screen is off, the radios are disabled, the CPU max speed is set to 14 MHz. The device is still silently on, allowing for alarms to go off or it to be turned on again instantly. The power LED will be dimmed, and may appear to be off if you are outside.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few days or longer.

Since the Pandora has to be powered whilst it is charging, low power mode is best for fastest charging, and will even allow a full charge to be achieved from USB. It is also the best way to use the Pandora as a USB charger for other devices.

Opening the screen whilst in low power mode has no effect (screen stays off, clocks stay low), and you will need to use the power switch to resume.

At the moment, there is no clear advantage in slowing the clocks (other than being an effective pause button when playing MP3). The only saving is through disabling the radios. This is likely to be improved in due course since there are features in the omap processor for power saving which are being added to the linux kernel.

====Power Off====
Select Logout then Shutdown from the window manager to power off. If a charger is connected, the device will re-boot immediately. It is possible to get into a state where you believe it is powered off, but in fact it is using power at the normal screen off rate - so after 12 hours, 50% of your battery is gone. The Power green LED ought to be a tell-tail. It is possible that some bugs exist in this area, but nothing has been clearly identified[http://www.gp32x.com/board/index.php?/topic/54652-solved-pandora-lost-charge-overnight/]

A common problem seems to be that if you switch off ''before'' unplugging, your Pandora will re-boot even though it is now left unplugged. This problem is compounded by the low battery shutdown script being called repeatedly (and actually preventing shutdown).

==Events==
The events which control power can be customised [http://www.gp32x.com/board/index.php?/topic/54544-forcing-shutdown-at-10-battery-life/page__view__findpost__p__878418]. Lid switch, Power Switch, battery threshold and Window Manager shutdown commands. Note that the battery manager in xfce will also take action when the battery is low, by default forcing a shutdown at 5% (so you may observe a full boot process, the window manager appears, then immediately shuts down)

==Charging==
[[image:Power_uk.png|thumb|alt=UK charger and adapter|UK charger and adapter]]
It is possible to charge from the mains charger (use the supplied one or a ''GENUINE'' PSP adaptor only) or USB cable. While a charger is connected, remaining battery level is displayed, but the time displays 00:00. If charging from USB, it is possible that the battery will still discharge slowly, since the Pandora takes more current (in normal mode) than the USB can supply. Mains charge is configured to draw 1000mA, USB charge is more like 500mA.

It is not possible to charge the Pandora without turning it on - the charging circuits rely on the CPU for configuration. In practice, this has minimal impact on usage, except that after charging, you might wish to explicitly turn off (and maybe there is a easy way to automate this by adding a charger event to call a script)

==Opperating Point==
The ''OPP'' is a TI term which reflects the fact that low clock speeds can be achieved with lower supply voltage than the higher clock speeds. Increasing OPP will reduce the lifetime of the device significantly (from 10 years to 5 years of continuous use.) OPP3 is the default as shipped by OpenPandora. As of Hotfix4, it is possible to set a maximum OPP in the range 1-5 (for example, to 5):
<pre>echo 5 | sudo tee -a /proc/pandora/cpu_opp_max</pre>
This will then increase OPP to suit the requested CPU max, as pre-determined by a table built in to the kernel. These thresholds use OPP1 for below 125 MHz, and OPP5 for above 720 MHz. It is possible to set the limiter and maybe run at 500 MHz in OPP2 (depending on your specific chip). See [http://boards.openpandora.org/index.php?/topic/22-using-hotfix4-how-high-can-you-clock/ this forum thread] for actual results.

'''''Using anything above OPP3 WILL shorten the lifetime of your Pandora, although it should still outlive the 1 year warranty. Using anything above OPP5 will void your warranty.'''''

Tweaking scripts to make this tuning easier are in the works.
==Monitoring==
The kernel provides some information about battery state through the filesystem. See [[Data_provided_by_Battery_and_Power_driver]]. This may help with diagnosing problems.

==Times==
(These are my estimates, mostly from HotFix3. Please add to the data section in the talk page, and be clear about the conditions you use)
{| border="1"
|+ Charge/Discharge times
! Mode !! Time
|-
! Normal Operating
| 10-14 hours
|-
! MP3 play, screen off
| 17 hours (May improve)
|-
! Lid Closed
|16-23 hours (est, depends on wifi)
|-
! Low Power
|23 hours (maybe 30 with Hotfix4)
|-
! Power off
|about 5% per week charge loss (although there are reports of much faster drain?[http://boards.openpandora.org/index.php?/topic/24-battery-drain/])
|-
! Mains charge, operating
| 20 hours (est)
|-
! Mains charge (low power)
|8 hours (est)
|-
! USB Charge, operating
| 20 hours (inactive, screen+wifi on), may charge or discharge depending on load
|-
! USB Charge, low power
|20 hours (est)
|}

==Battery Care==
* You can charge your battery to full charge, the charging circuits will then reduce the current to avoid overheating
* If you won't use the battery for more than a week, it is best to leave it at about 40% charged (as opposed to full)
* Don't worry about running it down too low, there are protection circuits to avoid a damagingly low discharge.
**Avoid leaving the battery completely discharged though.
**When the power runs out, th system will be unable to shutdown cleanly, and might corrupt your files or the system.
* No harm will come if you only partially recharge it. If you've only got 10 free minutes to charge before leaving, go ahead. You'll put an hour of usage back into the battery, and you can always charge it more later.
* For best accuracy, the battery meter relies on watching the battery discharge over most of it's range (down to say 10%).
**This will only affect the 'time to run' indication
* If you're not going to be using your battery for a very long time, the extremely best thing you can do for it is to discharge to 40%, seal it in an airtight bag, and put it in the fridge. Even years later, you pull it out, and it will be almost as good as when you put it in.

[[Category:Hardware]]

Production Timeline

2010-10-07T12:14:32Z

Tsh:

==Pandora Production Timeline==
Please feel free to either contribute on the talk page, or update here. I am adding some milestones which I can't easily track down the dates for - hopefully others will have bookmarked key forum posts, etc.
===2007===
'''December''': Pandora section in GP32X forums opened

===2008===
'''September 30''': 3000 units were made available for pre-order, resulting in server overload and crashes.

'''Early October''': Craig's bank account frozen. Later on, refunds start to be sent out [http://www.openpandora.org/index.php?option=com_content&view=category&layout=blog&id=2&Itemid=2&lang=en&limitstart=111]

'''October?''': Pre-order extended to 4000 units.
:The first mention of this (that I have found so far) is in a [http://www.gp32x.com/board/index.php?/topic/45065-ram-upgrade-and-credit-card-orders-the-readers-digest-version/ post] by Chip.

'''October 30''': Amount of ram increased to 256MB (from 128MB), NAND increased to 512MB (from 256MB). [http://www.gp32x.com/board/index.php?/topic/45019-pandora-now-has-256mb-of-ram-and-512mb-internal-nand-storage/page__view__findpost__p__663880]

===2009===
'''January''': Re-paying for pre-orders begins [http://www.gp32x.com/board/index.php?showtopic=46235&hl=]

Renders of the case shown off [http://pandorapress.net/2009/01/23/sneak-preview-render/]

Pre-ordering re-opened to fill places freed up after the great banking event. Only cash/bank transfer payments were accepted, no credit payments.

Prototype caseworks received.

Populated PCBs shown off.

===2010===

'''May 22''': First shipments start[http://www.open-pandora.org/index.php?option=com_content&view=article&id=177%3Ait-finally-happened&catid=2%3Ablog&Itemid=2&lang=en].
: Helpers on the production line seem to have been paid in pandora, first one here[http://www.gp32x.com/board/index.php?/topic/53552-look-who-flew-the-nest/]. By June 25th, the parts which arrived in the first shipment were exhausted, with approximately 400 shipped to GBAX customers, and 200 to EvilDragon's customers in mainland Europe. These shipments went to people who pre-ordered in the first 1.5 hours (roughly). Some 50 odd units shipped with only one fully working nub (to pre-orderers who choose to take one in order to skip the queue). Of these, 5 were left over that nobody had chosen to take and auctioned on eBay by Craig for £279.99. There were an additional 7 units with both nubs not fully functional[http://www.gp32x.com/board/index.php?/topic/54711-7-dead-nub-units-to-go/]. These were offered at £150.00 on the boards and seem all to have sold at that price. The highest price on eBay for one of the first ~600 units was ~$1600???

'''July 1''': 2nd Batch Pre-order emails start to be sent out.
: 2nd batch is priced[http://www.gp32x.com/board/index.php?/topic/54958-just-had-my-2nd-batch-pre-order-email] at £279.99/340 EUR (includes VAT) or $349. Ordering from the 2nd batch is offered as a way of getting a Pandora before Christmas, the shipment of the first 4000 predicted to complete around October 2010 with a continuous progression into the 2nd batch at this point.

'''Mid-July''': Production is stalled to help prevent building more units with faulty nubs.
: See the "[[Nubs#Early_Nub_Problems |Nubs]]" page for details.

'''Aug 04''': Another 100 from the first batch start to ship[http://www.gp32x.com/board/index.php?/topic/54915-uae4all-additions/page__view__findpost__p__900610]
: Along with a few more one-nub units, these are the first units to ship since the nub tolerance problems were identified and the factory re-supplied with 100% tested nubs. (requiring some previously 'ready to ship' boards to be re-worked) This small shipment was used for approval before any more populated boards were shipped from the factory.

'''Aug 13''': Another 200 are in the process of being built[http://twitter.com/Craigix/statuses/21061399677][http://www.gp32x.com/board/index.php?/topic/55937-200-pandoras-shipping-wc-16-august/]

'''Sep 20''': 100 scheduled to ship[http://boards.openpandora.org/index.php?/topic/254-birthplace-of-a-pandora-board-and-a-power-loss-2010-09-16/page__view__findpost__p__4627], taking production past the 1000 mark.
: These are still using nubs from the 1st production run, tested to select good ones. New prototype nubs are still in final testing. Since 150 of these shipped out of sequence (with faults), this equates to roughly 600 in the GBAX queue, and an hour into pre-ordering.

'''Oct 6''':2000 cases arrive in the UK[http://twitter.com/#!/Craigix/status/26571340236].
: This allows first phase assembly to re-commence (displays in lids, etc). Still waiting for updated nubs to be prototyped and produced (although populated PCBs are waiting).

Production Timeline

2010-09-17T14:55:47Z

Tsh:

==Pandora Production Timeline==
Please feel free to either contribute on the talk page, or update here. I am adding some milestones which I can't easily track down the dates for - hopefully others will have bookmarked key forum posts, etc.
===2007===
'''December''': Pandora section in GP32X forums opened

===2008===
'''September 30''': 3000 units were made available for pre-order, resulting in server overload and crashes.

'''Early October''': Craig's bank account frozen. Later on, refunds start to be sent out [http://www.openpandora.org/index.php?option=com_content&view=category&layout=blog&id=2&Itemid=2&lang=en&limitstart=111]

'''October?''': Pre-order extended to 4000 units.
:The first mention of this (that I have found so far) is in a [http://www.gp32x.com/board/index.php?/topic/45065-ram-upgrade-and-credit-card-orders-the-readers-digest-version/ post] by Chip.

'''October 30''': Amount of ram increased to 256MB (from 128MB), NAND increased to 512MB (from 256MB). [http://www.gp32x.com/board/index.php?/topic/45019-pandora-now-has-256mb-of-ram-and-512mb-internal-nand-storage/page__view__findpost__p__663880]

===2009===
'''January''': Re-paying for pre-orders begins [http://www.gp32x.com/board/index.php?showtopic=46235&hl=]

Renders of the case shown off [http://pandorapress.net/2009/01/23/sneak-preview-render/]

Pre-ordering re-opened to fill places freed up after the great banking event. Only cash/bank transfer payments were accepted, no credit payments.

Prototype caseworks received.

Populated PCBs shown off.

===2010===

'''May 22''': First shipments start[http://www.open-pandora.org/index.php?option=com_content&view=article&id=177%3Ait-finally-happened&catid=2%3Ablog&Itemid=2&lang=en].
: Helpers on the production line seem to have been paid in pandora, first one here[http://www.gp32x.com/board/index.php?/topic/53552-look-who-flew-the-nest/]. By June 25th, the parts which arrived in the first shipment were exhausted, with approximately 400 shipped to GBAX customers, and 200 to EvilDragon's customers in mainland Europe. These shipments went to people who pre-ordered in the first 1.5 hours (roughly). Some 50 odd units shipped with only one fully working nub (to pre-orderers who choose to take one in order to skip the queue). Of these, 5 were left over that nobody had chosen to take and auctioned on eBay by Craig for £279.99. There were an additional 7 units with both nubs not fully functional[http://www.gp32x.com/board/index.php?/topic/54711-7-dead-nub-units-to-go/]. These were offered at £150.00 on the boards and seem all to have sold at that price. The highest price on eBay for one of the first ~600 units was ~$1600???

'''July 1''': 2nd Batch Pre-order emails start to be sent out.
: 2nd batch is priced[http://www.gp32x.com/board/index.php?/topic/54958-just-had-my-2nd-batch-pre-order-email] at £279.99/340 EUR (includes VAT) or $349. Ordering from the 2nd batch is offered as a way of getting a Pandora before Christmas, the shipment of the first 4000 predicted to complete around October 2010 with a continuous progression into the 2nd batch at this point.

'''Mid-July''': Production is stalled to help prevent building more units with faulty nubs.
: See the "[[Nubs#Early_Nub_Problems |Nubs]]" page for details.

'''Aug 04''': Another 100 from the first batch start to ship[http://www.gp32x.com/board/index.php?/topic/54915-uae4all-additions/page__view__findpost__p__900610]
: Along with a few more one-nub units, these are the first units to ship since the nub tolerance problems were identified and the factory re-supplied with 100% tested nubs. (requiring some previously 'ready to ship' boards to be re-worked) This small shipment was used for approval before any more populated boards were shipped from the factory.

'''Aug 13''': Another 200 are in the process of being built[http://twitter.com/Craigix/statuses/21061399677][http://www.gp32x.com/board/index.php?/topic/55937-200-pandoras-shipping-wc-16-august/]

'''Sep 20''': 100 scheduled to ship[http://boards.openpandora.org/index.php?/topic/254-birthplace-of-a-pandora-board-and-a-power-loss-2010-09-16/page__view__findpost__p__4627], taking production past the 1000 mark.
: These are still using nubs from the 1st production run, tested to select good ones. New prototype nubs are still in final testing. Since 150 of these shipped out of sequence (with faults), this equates to roughly 600 in the GBAX queue, and an hour into pre-ordering.

User:Phillips123

2010-09-09T12:37:00Z

Tsh: spam

Talk:Pandora

2010-09-07T08:14:31Z

Tsh: /* mp3 playing time - 100hrs or 20? */

I added the full spec list from the bluwiki page with minor updates and changes. I did not update any of the existing links, though. This ''really'' needs to get done. [[User:Chip|Chip]] 02:22, 15 April 2008 (CEST)
: Thanks for doing this - I did mean to move the information across at some point but I've been busy. When I get a Pandora board it is fairly likely I'll start to throw some more information on here and we can slowly remove the links to 'prove' various aspects of the design as it becomes more final. [[User:Orkie|Orkie]] 19:48, 15 April 2008 (CEST)

: OpenGL ES Demonstrated link updated. [[User:AeroSigma|AeroSigma]] 13:47, 7 July 2008 (PST)

== Sorry about that ==

I accidentally added the 'we need help' header thinking it was the Spanish page. All fixed. 
[[User:Nat1192|Nat1192]] 03:00, 1 October 2008 (CEST)

== Size Comparisons ==

Several threads on the forums have linked to pictures and videos comparing real Pandoras to other gadgets. I suggest we add some of these with permission. (The SizEasy is nice, but leaves a lot to imagination...)

This thread:: http://www.gp32x.com/board/index.php?/topic/54034-pandora-size-comparison-pictures/
--[[User:Ollonk|Ollonk]] 22:05, 21 June 2010 (MEST)
:Very nice. I missed that topic. I think the size comparisons should actually go on their own page (with a link on this page).
:Edit: I made a page for it [[Size Comparisons]]
: --[[User:Cheese|Cheese]] 23:21, 21 June 2010 (MEST)

== Expanding History ==

Someone who was there to experience the whole process, from when it was first announced, to when it started shipping, should expand this section. Or at least post some notes here for me or whoever feels up to doing it.
--[[User:Cheese|Cheese]] 07:25, 26 June 2010 (MEST)
Created a page for this.--[[User:Tsh|Tsh]] 19:51, 26 June 2010 (MEST)

==mp3 playing time - 100hrs or 20?==
Concerning [http://pandorawiki.org/index.php?title=Pandora&diff=3566&oldid=3563 this edit], I realize that 100 hrs may be unrealistic, but where does the "20 hrs" figure even come from? Was it just pulled out of a hat? [[User:Esn|Esn]] 20:24, 6 September 2010 (MEST)
::Yes, looks like it was a rather odd guess. Currently, I measure 17 hours [[Power_modes]]. Claiming that it is impossible to ever get anywhere near to 2 or 3 times that just shows a poor understanding of where the power management is at the moment. --[[User:Tsh|Tsh]] 03:11, 7 September 2010 (MEST)
:After starting exaile with a fully charged battery and playing music for a few minutes, when I opened the lid again the battery meter told me I had 19.5 hours left. I didn't leave it on to see if it really lasted that long. --[[User:Nyan|Nyan]] 10:07, 7 September 2010 (MEST)
::The whole point of the '100' hours, and the quote from the forum is that with good power management, and if the DSP can be used to play music (with minimal support from the main CPU), some tasks can be optimised - it is not a reflection of the current state.--[[User:Tsh|Tsh]] 10:14, 7 September 2010 (MEST)

Talk:Pandora

2010-09-07T08:13:06Z

Tsh: /* mp3 playing time - 100hrs or 20? */

Talk:Pandora

2010-09-07T01:11:50Z

Tsh: /* mp3 playing time - 100hrs or 20? */

Development

2010-09-06T13:23:17Z

Tsh: /* Kernel and Firmware */

==Kernel and Firmware==
* [[Development_Tools | Pandora kernel and Firmware reference information]] including SD card booting
* [[http://bugs.openpandora.org/ Pandora Bug Tracker]], [[Reporting bugs]] instructions
* Official [[Current_open_tasks_official | Open Tasks]] (please don't edit unless you are a dev)

==Compiling Software==
* [[Setting up a cross-compiler|Set up a cross-compiler]] to compile code for the Pandora on your PC.
* Or, [[Bollocks | set up and compile directly on the Pandora, 'bollocks' style]].

==Porting and Writing Software==
* If porting existing software, try the [[porting guide]].
* If creating new code, then the [[development tutorials]] may be useful.

==Distributing Software==
* Learn more about the [[Libpnd hub|PND file format]] that is used for distribution.
* [[PND quickstart]] - Quickly learn how to make PNDs (using Linux) for your software.

[[Category:Development]]

Pandora

2010-09-06T11:44:06Z

Tsh: 100hrs mp3 is optimistic. I've never seen 'SoC' with an -a-.

[[Image:PandoraFrontNew.jpg|right|thumb|320px|The Pandora.]]
The Pandora is a combination of a seventh-generation handheld game console and miniature computer. It is the spiritual successor to other open handheld consoles such as the GP32 and GP2X. The device is open, meaning you can use it however you like and there are no restrictions or fees placed on developers, so anyone can write and release software for it. It runs a custom distribution of Linux based on [http://www.angstrom-distribution.org/ Ångström] and is currently the most powerful handheld gaming console available.

==History==

On September 30, 2008, 3000 units were made available for pre-order. Later on, this number was increased to 4000. The release of the Pandora was delayed several times until May 2010, when mass production and shipping of the Pandora began. A [[Production timeline]] page describes the process.

==Availability==
[[Image:Pandora-newrender.jpg|left|thumb|220px|A render of the Pandora.]]

For the first batch, 4000 units were made available to be pre-ordered for $330 USD each. Currently (as of September 2010) these are being assembled and shipped out to customers.

A second batch of 4000 was made available for pre-order in July 2010. The price of the second batch is $349 USD. [http://www.gp32x.com/board/index.php?/topic/54958-just-had-my-2nd-batch-pre-order-email/]

==Capabilities==

The Pandora is a unique device. Currently, there is no other device available that has dedicated gaming controls (including two analog nubs) and a QWERTY keyboard. It was developed primarily as a game console, specifically, a device to emulate older systems (see [[Emulator list]]) and run native games (see [[Games]]). It can also be used as a handheld computer. You can use it to do many of the tasks you would on any other computer, such as browsing the Internet (with a full-featured web browser), listening to music, watching movies and shows, using instant messaging applications, etc.

There are also a few things it can't do. Specifically, it can't run software that is only available for Windows, though if the source code is available there is a possibility it could be ported to run on the Pandora. Also, most proprietary Linux applications won't run without a port (as they were made to run on the x86 architecture while the Pandora is ARM-based).

==Specifications==

===Core Hardware===

*Texas Instruments OMAP3530 system-on-chip (SoC). [http://www.gp32x.com/board/index.php?s=&showtopic=38155&view=findpost&p=562133] [http://www.gp32x.com/board/index.php?showtopic=39172&st=160#] ''Specifications can be found at this link: [http://focus.ti.com/pdfs/wtbu/ti_omap3430.pdf] ''
*PowerVR SGX GPU (OpenGL ES 2.0, several million polygons per second). ''OpenGL ES demonstrated: [http://www.imgtec.com/powervr/insider/powervr-demos.asp] ''
*256MB DDR SDRAM in consumer units (early developer units had 128MB).
*Real-time clock (RTC) built in, to keep track of time. [http://www.gp32x.com/board/index.php?s=&showtopic=38155&view=findpost&p=568882]
*512MB internal flash memory (NAND) for consumer Pandoras (early developer boards had 256MB).
*Is "unbrickable", through a ROM bootloader.
*Dimensions: 140 x 83 x 27 mm (See [[Size Comparisons]])
*Mass: 320g [http://openpandora.ca/] (0.739 lbs)

===Display===

*4.3-inch (93.6 x 56.2 mm), 800x480 widescreen (5:3), touchscreen TFT-LCD. [http://www.gp32x.com/board/index.php?showtopic=38044]
*Brightness: 300 cd/m2, Contrast ratio: 450:1, Response time: tr+tf=30ms. [http://www.gp32x.com/board/index.php?s=&showtopic=39741&view=findpost&p=573484]
*TV-out included in hardware, A/V-OUT Port (similar in appearance to a large USB OTG port) has Composite and S-Video outputs and 3.5mm headphone output and microphone input.
**Separate TV-out signals, picture-in-picture capabilities. [http://www.gp32x.com/board/index.php?showtopic=38044]
*Powerful 2D and 3D hardware acceleration, see above. [http://www.gp32x.com/board/index.php?showtopic=38044]

===Sound===

*Has a high-quality audio DAC and an ADC.
*A pair of stereo speakers are built into the sides of the display.
*The hardware volume control is a wheel.
*Built-in microphone. [http://www.gp32x.com/board/index.php?act=findpost&pid=568882]

===Input===

*Buttons, keyboard, microphone, and touchscreen. [http://www.gp32x.com/board/index.php?showtopic=38044]
*Directional pad will be a D-pad. [http://www.gp32x.com/board/index.php?showtopic=38044]
*Two real, custom-designed, plastic analog nubs.
*QWERTY keyboard (cellphone-like, but larger). [http://www.gp32x.com/board/index.php?showtopic=38044]

===Connectivity===

*802.11b/g (Wi-Fi) included. USB host included. USB-on-the-go (one-port host and client) included. [http://www.gp32x.com/board/index.php?showtopic=38044]
*Integrated Bluetooth 2.0 + EDR (3Mbps). [http://www.gp32x.com/board/index.php?s=&showtopic=42344&view=findpost&p=613832]
*[[USB_reference|USB OTG mini-AB port and fully powered (500 mA) standard-A port.]] You can use anything that has the appropriate drivers. [http://www.gp32x.com/board/index.php?s=&showtopic=38155&view=findpost&p=568882] Some devices need to first go through a powered USB hub.
*RS-232 included, but a level converter is needed for the UART. [http://www.gp32x.com/board/index.php?s=&showtopic=38155&view=findpost&p=568882]
*Two SDIO-capable SDHC slots.

===Power===

*Lithium-polymer battery, ~4000mAh.
*Up to 10 hours battery life under reasonable load, 8.5 hours under max CPU load. Up to 100 hours playing music may be possible eventually. [http://www.gp32x.com/board/index.php?showtopic=40823&st=80&p=595336&#entry595336]
*Can charge through an AC adapter or USB. [http://www.gp32x.com/board/index.php?s=&showtopic=40659&view=findpost&p=587802]
*Advanced power management capabilities: only need to set a max clock speed; when the CPU is not doing anything it automatically HALTs and does nothing to save power. [http://www.gp32x.com/board/index.php?s=&showtopic=38155&view=findpost&p=574380]
*Eventually will be able to suspend to RAM or suspend to disk for longer battery life and faster start up. See [[Power modes]].

Talk:Top 10 apps

2010-09-04T14:06:45Z

Tsh:

Sorry, but this page is based on opinions and it won't be helpful I believe.

Telling other users what you like best is manipulative and will most likely push one specific app while another one might be better for that user.
One way to fix this would be to rename this page to: "10 apps for category ..." and then just list them, rather than numbering them.

BUT that would also mean it's highly similar to the [[Software_projects]], [[Games]] and [[Emulator_list]] pages (which should be merged anyway in my opinion), rendering this pages useless.
To make sure certain apps are seen by other people you should start extending the previously named topics by adding a description and feature list for the apps.

- [[User:JayFoxRox|JayFoxRox]] 13:58, 4 September 2010 (MEST)
: Well, I see your point, but the aim was to help people to get started, so 'first apps to look at' might be a better representation. Certainly i wasn't planning on giving the list an order. The difference between this list and the other pages you linked is that this is a manageable list to install in one go, and should only list apps which are working well. This isn't my list either, it is taken from the forum discussion - where it seemed that people wanted a simple collection. --[[User:Tsh|Tsh]] 16:06, 4 September 2010 (MEST)

Talk:Power modes

2010-08-31T19:43:30Z

Tsh: /* All off (as low power state) */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)
==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off (Hotfix 3)

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

Hotfix 4
250 MHz, opp1 2:55, 10% (30 hours)

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
500 MHz opp5 1:15, 7% (18 hours) - deadbeef 
900 MHz opp5 2:30, 15% (18 hours) - deadbeef 
250 MHz oop1 2:30, 15% (18 hours) - deadbeef

Talk:Power modes

2010-08-31T16:29:42Z

Tsh: /* MP3 only */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)
==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

So, Release1, Hotfix3, low power state only seems to shut off the radios, no other improvements.

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
500 MHz opp5 1:15, 7% (18 hours) - deadbeef 
900 MHz opp5 2:30, 15% (18 hours) - deadbeef 
250 MHz oop1 2:30, 15% (18 hours) - deadbeef

Talk:Power modes

2010-08-31T13:50:45Z

Tsh: /* MP3 only */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)
==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

So, Release1, Hotfix3, low power state only seems to shut off the radios, no other improvements.

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
500 MHz opp5 1:15, 7% (18 hours) - deadbeef 
900 MHz opp5 2:30, 15% (18 hours) - deadbeef 
250 MHz oop1

Talk:Power modes

2010-08-31T13:44:45Z

Tsh: /* MP3 only */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)
==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

So, Release1, Hotfix3, low power state only seems to shut off the radios, no other improvements.

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
500 MHz 1:15, 7% (18 hours) - deadbeef 
900 MHz 2:30, 15% (18 hours) - deadbeef

Quickstart

2010-08-31T10:31:54Z

Tsh: /* Download the latest Hotfix */

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix4 here, although it is likely that Hotfix 5 will be released in September 2010. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.
[[Image:Pandorasd.thunar.png|thumb|alt=SD card folder structure|A Pandora SD card as it appears in Thunar, the default file browser on the Pandora. Figure 1 is the SD card itself (yours will have a different name). Figure 2 shows us that a /pandora folder has already been created on the card, and we're browsing inside it. Figure 3 shows the subfolders within the /pandora folder.]]
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''Click here to download HotFix Package 4'' link for the latest HotFix Package (It's located under the "HotFix Package 4 - for Pandora OS Release 2010-05 (Zaxxon)"). (31-8-2010 - Hotfix 4: [http://www.open-pandora.org/downloads/HotFix4-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder[[Image:Hotfix installed.jpg|thumb|alt=Hotfix screenshot|This is where you can find the hotfix installer. Click for a larger view.]]
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 4 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

Software projects

2010-08-31T10:28:21Z

Tsh: /* Released software */ Hotfix4 released

''These lists were last updated on 2010-08-04. You may also want to check out [http://apps.open-pandora.org/cgi-bin/viewarea.pl?Games Pandora Apps] or the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,9 File Archive].''

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]])

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
|-
|[[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]]
|2010-06-27
|sebt3 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,113 Archive]
|
|-
|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.
|-
|[[Chromium]]
|2010-06-13
|The Chromium Authors, EvilDragon (port)
|Network - web browser
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,90 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Chromium.inf Apps]
|SSL is currently broken in this build (needs compile from source)
|-
|[[Cmus]]
|2010-06-24
|SomeGuy99 (port)
|Audio - music player
|[http://www.gp32x.com/board/index.php?/topic/54923-the-pandora-apps-thread/page__view__findpost__p__885409]
|Not packaged, manual install. Text mode player
|-
|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]
|
|-
|[[Deadbeef]]
|2010-07-15
|CME (port), sebt3 (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,114 Archive] [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]
|-
|[[Exaile]]
|2010-04-28
|Pickle (port)
|Audio - music player
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,6,114 Archive] [http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/Exaile.inf Apps]
|Needs Community Codec Pack to run
|-
|[[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]
|
|-
|[[Fennec]]
|2010-05-30
|Mozilla Team
|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/fennec.inf Apps]
|mobile version of FireFox
|-
|[[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.6 (Namoroka)
|2010-07-01
|Mozilla team
|Network - web browser
|[http://apps.open-pandora.org/cgi-bin/viewapp.pl?/Application/firefox366.inf Apps]
|
|-
|[[gFTP]] 2.0.18 ('''beta''')
|2010-07-01
|sebt3 (port)
|Network - FTP client
|[http://sebastien.huss.free.fr/pnd/gftp.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54931-gftp/ Link]
|-
|[[Gmu Music Player]] 0.7.1
|2010-07-03
|wejp
|Audio - music player
|[http://wejp.k.vu/gmu/gmu-0-7-1-released Download]
|[http://www.gp32x.com/board/index.php?/topic/55007-gmu-music-player-0-7-1-released/ Link]
|-
|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/ Link]
|-
|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
|-
|[[Liferea]]
|2010-07-06
|sebt3 (port)
|Network - RSS Reader
|[http://sebastien.huss.free.fr/pnd/liferea.pnd Apps]
|[http://www.gp32x.com/board/index.php?/topic/55089-liferea/ Link]
|-
|[[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]
|
|-
|[[Minitube]]
|2010-06-29
|Flavio Tordini, sebt3 (port)
|Network - Youtube client
|[http://dl.openhandhelds.org/cgi-bin/pandora.cgi?0,0,0,0,112,119 Archive]
|youtube browser/player
|-
|[[Ommpc]] v0.5.2
|2010-07-04
|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/ Link]
|-
|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
|-
|[[Remmina]]
|2010-06-21
|mindlord (port)
|Network - VNC/RDP/XDMCP client
|[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/remmina.inf Apps]
|[http://www.gp32x.com/board/index.php?/topic/54610-remmina-0-7-5/ Link]. Control your PC from your Pandora.
|-
|[[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
|-
|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
|-
|[[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.
|-
|[[TrueCrypt]] ('''beta''')
|2010-07-18
|danie3000 (port)
|System - encryption
|[http://www.hermocom.com/en/downloads/openpandora/TrueCrypt.pnd/ Download]
|[http://www.gp32x.com/board/index.php?/topic/55347-truecrypt-pnd-ready-for-testing/ Discussion].
|-
|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/ Link]
|-
|[[VLC]] 1.1.0 ('''beta''')
|2010-07-01
|sebt3 (port)
|Media player (video & audio)
|[http://sebastien.huss.free.fr/pnd/vlc.pnd Download]
|[http://www.gp32x.com/board/index.php?/topic/54922-vlc/ Link]
|-
|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]
|
|}

===Operating systems===
===Graphic engines===
===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 Link]
|wip
|
|
|-
|AROS Arm
|[http://projects.powerdeveloper.org/project/imx515/735 Link]
|wip
|
|
|-
|FreeBSD
|[http://wiki.freebsd.org/FreeBSD/arm/OMAP Link]
|wip
|
|
|-
|Fedora ARM
|[http://fedoraproject.org/wiki/Architectures/ARM Link]
|wip
|
|
|
|-
|Gentoo Linux
|[http://neuvoo.org Link]
|Working build, not completed
|javaJake, Viridior
|IRC: (FreeNode) #gentoo-pandora
|-
|HaikuOS
|[http://www.haiku-os.org Link]
|wip
|
|
|-
|RISC OS
|[http://www.riscosopen.org Link]
|wip
|Uwe Kall, Jeffrey Lee
|BeagleBoard port available for download and testing
|-
|Ubuntu ARM
|[http://www.ubuntu.com/products/whatisubuntu/arm Link]
|wip
|
|
|}

=== 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/ link]
|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/ Link1] [http://www.youtube.com/user/Prompt84 Link2]
|
|No Siesta Studios
|
|-
|OGRE Engine
|[http://www.gp32x.com/board/index.php?showtopic=46706 Link1] [http://www.youtube.com/watch?v=LDtUE5PIhV0 Link2]
|
|
|3D real-time renderer
|-
|Otaco Glost Engine
|[http://www.youtube.com/user/otacogloost Link1], [http://www.gp32x.com/board/index.php?/topic/48393-i-did-stuff/page__p__736650&#entry736650 Link2]
|working
|Otaco
|
|-
|Quad-Ren 2D
|[http://quad-ren.sourceforge.net/index.php Link]
|Working
|Hessiess
|Version 0.5
|-
|SDL GLES
|[http://github.com/Cpasjuste/sdl-1.2.13_gles/tree Link]
|working
|Cpasjuste
|
|-
|XreaL
|[http://xreal.sourceforge.net/xrealwiki/ Link]
|
|Pickle
|No longer being worked on. [http://www.gp32x.com/board/index.php?/topic/55173-xreal-patch-question/]
|-
|Stratagus
|[http://stratagus.sourceforge.net/ Link]
|working build
|Cpasjuste
|RTS Engine
|-
|WakeBreaker
|[http://w1xer.at/pandora/ Link]
| 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 Link1] [http://www.youtube.com/watch?v=uLMmJBDEs2E Link2]
|wip
|StreaK
|Pandora e-zine
|-
|LeafPad
|[http://www.youtube.com/watch?v=sKKMj37Psd8 Link]
|Working build
|
|
|-
|Math-NEON
|[http://code.google.com/p/math-neon/ Link1]
|Wip
|Adventus
|cmath like library optimised for ARM NEON coprocessor.
|-
|MythTVPlayer
|[http://www.gp32x.com/board/index.php?/topic/52882-mythtvplayer/ Link]
|Working build
|Pickle
|Media Center + TV/DV recording
|-
|Pandaphone
|[http://www.gp32x.com/board/index.php?/topic/48327-pandaphone/ Link]
|
|jb0yx
|A project to incorporate the Open Pandora handheld device with cell phone technology
|-
|Pandora Sync Suite
|[http://www.openpandora.pl Link]
|Working build
|StreaK
|for Windows 9x/NT
|-
|Pangea GUI
|[http://www.gp32x.com/board/index.php?showtopic=45631&hl=pangea Link]
|WIP
|efegea
|Gmenu alternative
|-
|Panorama
|[http://www.gp32x.com/board/index.php?/topic/51076-panorama/ Link]
|WIP
|dflemstr
|Gmenu alternative
|-
|PDM
|[http://github.com/Cpasjuste/pdm/tree Link]
|
|Cpasjuste
|Light desktop manager for Pandora
|-
|PGui
|[http://github.com/Cpasjuste/pgui/tree Link]
|
|Cpasjuste
|Standard emulator fronted for Pandora
|-
|PMenu
|[http://mydedibox.fr/_stuff/pandora/ Link]
|
|Cpasjuste
|Minimal Menu for Pandora
|-
|PND Maker (for Windows 9x/NT)
|[http://www.openpandora.pl Link]
|Working build
|StreaK
|
|-
|Qemu
|[http://www.nongnu.org/qemu/status.html Link]
|testing build
|Fabrice Bellard
|open source machine emulator and virtualizer
|-
|Scale
|[http://www.youtube.com/user/Zoxc64 Link]
|wip
|Zoxc64
|Minimal Menu for Pandora
|-
|Simple Dev Studio for Pandora
|[http://www.openpandora.pl Link]
|Wip
|StreaK
|for Windows 9x/NT
|-
|[[TINXL]]
|[[TINXL]]
|
|
|Application stack for multiplayer internet games
|-
|[[TS2A]]
|[[TS2A]]
|Documentation only
||[[User:JayFoxRox|JayFoxRox]]
|Teamspeak 2 Alternative Client / Server, Needs developer
|-
|ZiB Emulator Frontend
|[http://www.gp32x.com/board/index.php?showtopic=47203 Link1] [http://www.youtube.com/watch?v=UJvON8lCM3M Link2]
|
|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 Link]
|working build
|
|
|-
|OpenGL Demo with MP3 Playback
|[http://www.youtube.com/watch?v=hkx18kruRJs Link]
|working build
|
|
|-
|OpenGL Skull Demo
|[http://www.youtube.com/watch?v=qG7EDaZpyOo Link]
|working build
|
|
|-
|WaveDemo
|[http://www.youtube.com/watch?v=4wgEHFCq9Lo Link]
|Working
|Otaco
|
|}

[[Category:Development]]
[[Category:Software]]

User manual

2010-08-31T10:17:36Z

Tsh: /* Where Can I Get More Apps? */ Link to top 10 page

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box(so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion! Ask on the [http://boards.openpandora.org/ Official Open Pandora forum] if you want a definitive answer.

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [[http://www.open-pandora.org/ Open Pandora Ltd.]] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [[http://www.open-pandora.org/ Open Pandora Ltd]] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 05-25-10 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric keypad
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB NAND FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric keypad
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while _off_. This is currently a feature and may change in future versions of the firmware.

You can find more useful information about charging on the [[Power_modes]]-page.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==
See the [[GUI]] page for more details on the user interfaces which can be used with the Pandora.

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal NAND.

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application.

===Power modes===

The [[Power modes]] page provides full details of power modes, charging and battery care and lifetime.

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behavior of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal NAND; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full features web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail.
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*To help with the massive range of applications, the wiki has a page to bring together some stable and highly rated apps which will help you to get started, see [[Top 10 apps]]

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to nand by default, so should be used with great caution.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before late in 2010.

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal NAND to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.

[[Category:Categories]]

Xfce

2010-08-31T09:29:48Z

Tsh: /* MiniMenu */

{{ IntroNote | This page is a reference for all things window manager related.}}
==GUIs for the Pandora==
Over the development of the Pandora, many different graphical interfaces have been discussed, but there has always been some recognition that there are different use cases. There is the full-desktop style environment, set up for multi-tasking etc. and a minimal, no overhead, gaming optimised environment. These environments are referred to as the Graphical User Interface for the Pandora. Currently, both run on top of the X-windowing system and the Linux operating system. For the application (be it word processor or emulator) this should mean that the active GUI makes little difference.

==MiniMenu==
minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

MiniMenu offers an application developer a high degree of flexibility, see [[Minimenu configuration documentation]]. This gives the appearance of the applications being closely integrated with the Pandora's built-in menuing system.

==XFCE window manager==

===Change The Default Browser===
This also applies to other applications. To change the default browser to chromium[http://www.gp32x.com/board/index.php?/topic/54877-how-do-you-change-the-default-browser/]
Go to SETTINGS, PREFERRED APPLICATIONS and in the drop down list choose other and enter the following :
<pre>
'pnd_run /media/SD_CARD_NAME/pandora/apps/APPNAME.pnd' "%s"
</pre>
The quotes are important, use the a key and the s key. You need to use the name which you have given to your SD card, it does not matter which slot the card is in, but this will then only work properly when the browser application is in an inserted card.

==Adding other GUIs==
In order to add other window managers or graphical environments, you should edit this file /etc/pandora/conf/gui.conf[http://www.gp32x.com/board/index.php?/topic/54649-window-managers/]

At the moment, it looks like this:
<pre>
XFCE4;The full desktop Environment;startxfce4;xfce4-session-logout --logout
MiniMenu;A very simple but flexible menu;startmmenu;stopmmenu
</pre>

Each line is one GUI. Various parameters are there delimited with a ;
:The first is the Name of the GUI (what appears when you select Switch GUI or Change Default GUI).
:The second is a short description.
:The third is the actual command to start the GUI.
:The fourth is the actual command to stop the GUI.

So as an example, for Gnome you could make a line like that:
<pre>
Gnome;The Gnome Desktop;gnome-session;gnome-session-save --kill
</pre>
Now you can select Switch GUI from XFCE4 or MiniMenu and Gnome will appear there as well.
If it is installed correctly, it will load up.

By using Switch GUI, you make sure your system will bootup even if the new GUI doesn't work.
Once you have confirmed that it does work fine, you can slect your new GUI in the startup settings, to be used all the time.
[[Category:Tutorials]]
[[Category:Documentation]]

User manual

2010-08-31T09:28:35Z

Tsh: /* Basic Use */ link to GUI page

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box(so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion! Ask on the [http://boards.openpandora.org/ Official Open Pandora forum] if you want a definitive answer.

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [[http://www.open-pandora.org/ Open Pandora Ltd.]] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [[http://www.open-pandora.org/ Open Pandora Ltd]] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 05-25-10 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric keypad
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB NAND FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric keypad
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while _off_. This is currently a feature and may change in future versions of the firmware.

You can find more useful information about charging on the [[Power_modes]]-page.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==
See the [[GUI]] page for more details on the user interfaces which can be used with the Pandora.

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal NAND.

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application.

===Power modes===

The [[Power modes]] page provides full details of power modes, charging and battery care and lifetime.

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behavior of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal NAND; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full features web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail.
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to nand by default, so should be used with great caution.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before late in 2010.

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal NAND to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.

[[Category:Categories]]

User manual

2010-08-31T09:23:20Z

Tsh: /* Power Modes */

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box(so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion! Ask on the [http://boards.openpandora.org/ Official Open Pandora forum] if you want a definitive answer.

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [[http://www.open-pandora.org/ Open Pandora Ltd.]] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [[http://www.open-pandora.org/ Open Pandora Ltd]] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 05-25-10 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric keypad
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB NAND FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric keypad
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while _off_. This is currently a feature and may change in future versions of the firmware.

You can find more useful information about charging on the [[Power_modes]]-page.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal NAND.

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application.

===Power modes===

The [[Power modes]] page provides full details of power modes, charging and battery care and lifetime.

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behavior of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal NAND; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full features web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail.
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to nand by default, so should be used with great caution.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before late in 2010.

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal NAND to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.

[[Category:Categories]]

Power modes

2010-08-31T09:07:19Z

Tsh: /* Times */

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes. Note that as of hotfix3, opening the lid in low power mode has no effect.

====Normal Mode====
This is the normal operating mode, screen on, WiFi and Bluetooth on if requested. CPU speed can be selected by the user, and has a small impact on battery life. Screen brightness will also have a significant effect on battery life. The CPU should automatically self-regulate to the current task, and 10-14 hours battery life is possible depending on usage. This is mostly independent of the set CPU speed for any given task. At any time, the battery gauge will show the remaining battery life ''if the usage remains the same as over the past some seconds''.

====Lid Closed====
The only change with the lid closed is to turn off the LCD backlight. This improves battery life, allowing music playback and streaming to continue. As of Hotfix2, the screen remains on if the device is powered up with the screen closed. It is also possible to set xfce to blank the screen after a period of inactivity, which helps with battery.

====Low Power====
Low power mode is toggled by a short press of the power switch to the right. The screen is off, the radios are disabled, the CPU max speed is set to 14 MHz. The device is still silently on, allowing for alarms to go off or it to be turned on again instantly. The power LED will be dimmed, and may appear to be off if you are outside.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few days or longer.

Since the Pandora has to be powered whilst it is charging, low power mode is best for fastest charging, and will even allow a full charge to be achieved from USB. It is also the best way to use the Pandora as a USB charger for other devices.

Opening the screen whilst in low power mode has no effect (screen stays off, clocks stay low), and you will need to use the power switch to resume.

At the moment, there is no clear advantage in slowing the clocks (other than being an effective pause button when playing MP3). The only saving is through disabling the radios. This is likely to be improved in due course since there are features in the omap processor for power saving which are being added to the linux kernel.

====Power Off====
Select Logout then Shutdown from the window manager to power off. If a charger is connected, the device will re-boot immediately. It is possible to get into a state where you believe it is powered off, but in fact it is using power at the normal screen off rate - so after 12 hours, 50% of your battery is gone. The Power green LED ought to be a tell-tail. It is possible that some bugs exist in this area, but nothing has been clearly identified[http://www.gp32x.com/board/index.php?/topic/54652-solved-pandora-lost-charge-overnight/]

A common problem seems to be that if you switch off ''before'' unplugging, your Pandora will re-boot even though it is now left unplugged. This problem is compounded by the low battery shutdown script being called repeatedly (and actually preventing shutdown).

==Events==
The events which control power can be customised [http://www.gp32x.com/board/index.php?/topic/54544-forcing-shutdown-at-10-battery-life/page__view__findpost__p__878418]. Lid switch, Power Switch, battery threshold and Window Manager shutdown commands. Note that the battery manager in xfce will also take action when the battery is low, by default forcing a shutdown at 5% (so you may observe a full boot process, the window manager appears, then immediately shuts down)

==Charging==
[[image:Power_uk.png|thumb|alt=UK charger and adapter|UK charger and adapter]]
It is possible to charge from the mains charger (use the supplied one or a ''GENUINE'' PSP adaptor only) or USB cable. While a charger is connected, remaining battery level is displayed, but the time displays 00:00. If charging from USB, it is possible that the battery will still discharge slowly, since the Pandora takes more current (in normal mode) than the USB can supply. Mains charge is configured to draw 1000mA, USB charge is more like 500mA.

It is not possible to charge the Pandora without turning it on - the charging circuits rely on the CPU for configuration. In practice, this has minimal impact on usage, except that after charging, you might wish to explicitly turn off (and maybe there is a easy way to automate this by adding a charger event to call a script)

==Opperating Point==
The ''OPP'' is a TI term which reflects the fact that low clock speeds can be achieved with lower supply voltage than the higher clock speeds. Increasing OPP will reduce the lifetime of the device significantly (from 10 years to 5 years of continuous use.) OPP3 is the default as shipped by OpenPandora. As of Hotfix4, it is possible to set a maximum OPP in the range 1-5 (for example, to 5):
<pre>echo 5 | sudo tee -a /proc/pandora/cpu_opp_max</pre>
This will then increase OPP to suit the requested CPU max, as pre-determined by a table built in to the kernel. These thresholds use OPP1 for below 125 MHz, and OPP5 for above 720 MHz. It is possible to set the limiter and maybe run at 500 MHz in OPP2 (depending on your specific chip). See [http://boards.openpandora.org/index.php?/topic/22-using-hotfix4-how-high-can-you-clock/ this forum thread] for actual results.

'''''Using anything above OPP3 WILL shorten the lifetime of your Pandora, although it should still outlive the 1 year warranty. Using anything above OPP5 will void your warranty.'''''

Tweaking scripts to make this tuning easier are in the works.
==Monitoring==
The kernel provides some information about battery state through the filesystem. See [[Data_provided_by_Battery_and_Power_driver]]. This may help with diagnosing problems.

==Times==
(These are my estimates, mostly from HotFix3. Please add to the data section in the talk page, and be clear about the conditions you use)
{| border="1"
|+ Charge/Discharge times
! Mode !! Time
|-
! Normal Operating
| 10-14 hours
|-
! MP3 play, screen off
| 17 hours (May improve)
|-
! Lid Closed
|16-23 hours (est, depends on wifi)
|-
! Low Power
|23 hours (maybe 30 with Hotfix4)
|-
! Power off
|less than 5% per day charge loss (sometimes more?[http://boards.openpandora.org/index.php?/topic/24-battery-drain/])
|-
! Mains charge, operating
| 20 hours (est)
|-
! Mains charge (low power)
|8 hours (est)
|-
! USB Charge, operating
| 20 hours (inactive, screen+wifi on), may charge or discharge depending on load
|-
! USB Charge, low power
|20 hours (est)
|}

==Battery Care==
* You can charge your battery to full charge, the charging circuits will then reduce the current to avoid overheating
* If you won't use the battery for more than a week, it is best to leave it at about 40% charged (as opposed to full)
* Don't worry about running it down too low, there are protection circuits to avoid a damagingly low discharge.
**Avoid leaving the battery completely discharged though.
**When the power runs out, th system will be unable to shutdown cleanly, and might corrupt your files or the system.
* No harm will come if you only partially recharge it. If you've only got 10 free minutes to charge before leaving, go ahead. You'll put an hour of usage back into the battery, and you can always charge it more later.
* For best accuracy, the battery meter relies on watching the battery discharge over most of it's range (down to say 10%).
**This will only affect the 'time to run' indication
* If you're not going to be using your battery for a very long time, the extremely best thing you can do for it is to discharge to 40%, seal it in an airtight bag, and put it in the fridge. Even years later, you pull it out, and it will be almost as good as when you put it in.

[[Category:Hardware]]

Talk:Power modes

2010-08-31T09:03:14Z

Tsh: /* MP3 only */

"10-20% per day charge loss (est)" - mine does not discharge nearly this much on it's own while powered off for a day. --[[User:Cheese|Cheese]] 07:13, 26 June 2010 (MEST)

That was borrowed from some forum chat, it would be good to collect some numbers (see table below), both for going through a power cycle (chews battery on my phone) and powering up after 12/24/48 hours off. I also wonder if some batteries are more leaky than others. 50% loss over a weekend was (i think) quoted.--[[User:Tsh|Tsh]] 19:43, 26 June 2010 (MEST)

==Self-discharge==
Off 13 hours = 100% -> 99%. (tsh) 
Off 18 hours = 97% -> 97% (cheese) 
Off 13 hours = 39% -> 44% (Ivanovic, FS#136)

Based on this, maybe taking a reading immediately after power on is not reliable, so I now suggest taking 2 readings, one immediately after power on, one 15 min later (after sitting idle) --[[User:Tsh|Tsh]] 12:48, 5 July 2010 (MEST)
==Charge times==
Low power 1:36 17%->51% (->63% after 3 min not charging)(tsh)

== All off (as low power state) ==

With WiFi off, screen off

500 MHz 4h10m 81%->63% (~23 hours battery life) 
50 MHz 4 hours, 62% -> 45% (same as above)

So, Release1, Hotfix3, low power state only seems to shut off the radios, no other improvements.

== MP3 only ==

500 MHz 63 min, 6% (17.5 hours)-exaile 
500 MHz 2:54, 16% (18 hours) - ommpc 
900 MHz 1:15, 7% (18 hours) - deadbeef

Power modes

2010-08-31T09:01:28Z

Tsh:

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes. Note that as of hotfix3, opening the lid in low power mode has no effect.

====Normal Mode====
This is the normal operating mode, screen on, WiFi and Bluetooth on if requested. CPU speed can be selected by the user, and has a small impact on battery life. Screen brightness will also have a significant effect on battery life. The CPU should automatically self-regulate to the current task, and 10-14 hours battery life is possible depending on usage. This is mostly independent of the set CPU speed for any given task. At any time, the battery gauge will show the remaining battery life ''if the usage remains the same as over the past some seconds''.

====Lid Closed====
The only change with the lid closed is to turn off the LCD backlight. This improves battery life, allowing music playback and streaming to continue. As of Hotfix2, the screen remains on if the device is powered up with the screen closed. It is also possible to set xfce to blank the screen after a period of inactivity, which helps with battery.

====Low Power====
Low power mode is toggled by a short press of the power switch to the right. The screen is off, the radios are disabled, the CPU max speed is set to 14 MHz. The device is still silently on, allowing for alarms to go off or it to be turned on again instantly. The power LED will be dimmed, and may appear to be off if you are outside.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few days or longer.

Since the Pandora has to be powered whilst it is charging, low power mode is best for fastest charging, and will even allow a full charge to be achieved from USB. It is also the best way to use the Pandora as a USB charger for other devices.

Opening the screen whilst in low power mode has no effect (screen stays off, clocks stay low), and you will need to use the power switch to resume.

At the moment, there is no clear advantage in slowing the clocks (other than being an effective pause button when playing MP3). The only saving is through disabling the radios. This is likely to be improved in due course since there are features in the omap processor for power saving which are being added to the linux kernel.

====Power Off====
Select Logout then Shutdown from the window manager to power off. If a charger is connected, the device will re-boot immediately. It is possible to get into a state where you believe it is powered off, but in fact it is using power at the normal screen off rate - so after 12 hours, 50% of your battery is gone. The Power green LED ought to be a tell-tail. It is possible that some bugs exist in this area, but nothing has been clearly identified[http://www.gp32x.com/board/index.php?/topic/54652-solved-pandora-lost-charge-overnight/]

A common problem seems to be that if you switch off ''before'' unplugging, your Pandora will re-boot even though it is now left unplugged. This problem is compounded by the low battery shutdown script being called repeatedly (and actually preventing shutdown).

==Events==
The events which control power can be customised [http://www.gp32x.com/board/index.php?/topic/54544-forcing-shutdown-at-10-battery-life/page__view__findpost__p__878418]. Lid switch, Power Switch, battery threshold and Window Manager shutdown commands. Note that the battery manager in xfce will also take action when the battery is low, by default forcing a shutdown at 5% (so you may observe a full boot process, the window manager appears, then immediately shuts down)

==Charging==
[[image:Power_uk.png|thumb|alt=UK charger and adapter|UK charger and adapter]]
It is possible to charge from the mains charger (use the supplied one or a ''GENUINE'' PSP adaptor only) or USB cable. While a charger is connected, remaining battery level is displayed, but the time displays 00:00. If charging from USB, it is possible that the battery will still discharge slowly, since the Pandora takes more current (in normal mode) than the USB can supply. Mains charge is configured to draw 1000mA, USB charge is more like 500mA.

It is not possible to charge the Pandora without turning it on - the charging circuits rely on the CPU for configuration. In practice, this has minimal impact on usage, except that after charging, you might wish to explicitly turn off (and maybe there is a easy way to automate this by adding a charger event to call a script)

==Opperating Point==
The ''OPP'' is a TI term which reflects the fact that low clock speeds can be achieved with lower supply voltage than the higher clock speeds. Increasing OPP will reduce the lifetime of the device significantly (from 10 years to 5 years of continuous use.) OPP3 is the default as shipped by OpenPandora. As of Hotfix4, it is possible to set a maximum OPP in the range 1-5 (for example, to 5):
<pre>echo 5 | sudo tee -a /proc/pandora/cpu_opp_max</pre>
This will then increase OPP to suit the requested CPU max, as pre-determined by a table built in to the kernel. These thresholds use OPP1 for below 125 MHz, and OPP5 for above 720 MHz. It is possible to set the limiter and maybe run at 500 MHz in OPP2 (depending on your specific chip). See [http://boards.openpandora.org/index.php?/topic/22-using-hotfix4-how-high-can-you-clock/ this forum thread] for actual results.

'''''Using anything above OPP3 WILL shorten the lifetime of your Pandora, although it should still outlive the 1 year warranty. Using anything above OPP5 will void your warranty.'''''

Tweaking scripts to make this tuning easier are in the works.
==Monitoring==
The kernel provides some information about battery state through the filesystem. See [[Data_provided_by_Battery_and_Power_driver]]. This may help with diagnosing problems.

==Times==
(These are my estimates, should be clarified once more user data exists)
{| border="1"
|+ Charge/Discharge times
! Mode !! Time
|-
! Normal Operating
| 10-14 hours
|-
! MP3 play, screen off
| 17 hours (May improve)
|-
! Lid Closed
|16-23 hours (est, depends on wifi)
|-
! Low Power
|23 hours (est, should improve)
|-
! Power off
|less than 5% per day charge loss (est)
|-
! Mains charge, operating
| 20 hours (est)
|-
! Mains charge (low power)
|8 hours (est)
|-
! USB Charge, operating
| 20 hours (inactive, screen+wifi on), may charge or discharge depending on load
|-
! USB Charge, low power
|20 hours (est)
|}

==Battery Care==
* You can charge your battery to full charge, the charging circuits will then reduce the current to avoid overheating
* If you won't use the battery for more than a week, it is best to leave it at about 40% charged (as opposed to full)
* Don't worry about running it down too low, there are protection circuits to avoid a damagingly low discharge.
**Avoid leaving the battery completely discharged though.
**When the power runs out, th system will be unable to shutdown cleanly, and might corrupt your files or the system.
* No harm will come if you only partially recharge it. If you've only got 10 free minutes to charge before leaving, go ahead. You'll put an hour of usage back into the battery, and you can always charge it more later.
* For best accuracy, the battery meter relies on watching the battery discharge over most of it's range (down to say 10%).
**This will only affect the 'time to run' indication
* If you're not going to be using your battery for a very long time, the extremely best thing you can do for it is to discharge to 40%, seal it in an airtight bag, and put it in the fridge. Even years later, you pull it out, and it will be almost as good as when you put it in.

[[Category:Hardware]]

User manual

2010-08-27T19:52:12Z

Tsh: Official forum link

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box(so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion! Ask on the [http://boards.openpandora.org/ Official Open Pandora forum] if you want a definitive answer.

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [[http://www.open-pandora.org/ Open Pandora Ltd.]] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [[http://www.open-pandora.org/ Open Pandora Ltd]] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 05-25-10 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric keypad
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB NAND FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric keypad
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while _off_. This is currently a feature and may change in future versions of the firmware.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal NAND.

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application.

===[[Power modes | Power Modes]]===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behaviour of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal NAND; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full features web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail.
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to nand by default, so should be used with great caution.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before late in 2010.

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal NAND to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.

[[Category:Categories]]

USB reference

2010-08-22T16:24:06Z

Tsh: Undo revision 3368 by Rebeca123 (Talk)

==Readme First!==

If you have a question to ask, that isn't covered in this FAQ already, please ask over on the [http://www.gp32x.com/board/index.php?showforum=61 Forums].

==USB FAQ==

===How many USB ports does Pandora have?===
Pandora has two USB ports:
* 1x USB 2.0 host port (USB standard-A receptacle)
* 1x USB 1.1/2.0 OTG port (USB mini-AB receptacle)

===What does “host port” mean?===
A USB host port “hosts” any device that you plug in, just like the USB ports on your computer. Pandora’s full size USB A port can host USB 2.0 devices, and provide up to 500mA (the maximum allowed according to USB standards).

===What does “OTG” mean?===
OTG stands for On The Go. USB OTG ports can operate in two different modes. When connected through this port, the Pandora can act as a device, for example when connected to a computer for charging & data transfer. For this mode, you need a standard-A to mini-B cable. However, the Pandora can also act as a host port for USB 1.1 and USB 2.0 devices. For details on how to make the necessary cable connection, see [[USB_reference#OTG_host_mode|the OTG host mode section]]. This port can supply a maximum of 100mA in host mode. Although this port implements On The Go functionality, it can not get an official On The Go certification because the OTG specification requires a device to have exactly one USB port. (The Pandora has two.) Also, the mini-AB connector used on the Pandora has been taken out of the specification in 2007 (but is still widely adopted).

===What’s all this stuff about USB 1.1 and USB 2.0? Isn’t USB, uh, universal?===
The USB 2.0 protocol is not backwards compatible with USB 1.1. Most USB ports (eg. on your computer’s motherboard, in USB hubs) actually contain two chips to allow universal compatibility – one for USB 1.1, and one for USB 2.0.

Pandora’s USB standard-A host port does not contain this second chip. Only USB 2.0 devices bearing the “USB HIGH SPEED” logo can be plugged directly into this port. However, USB 1.1 devices can be connected to this port through a USB hub, provided the hub bears the “USB HIGH SPEED” logo.

Pandora’s USB OTG (mini-AB) port is fully compatible with both USB 1.1 and USB 2.0, allowing it to host either type of device.

===So which devices are USB 1.1, and which ones are USB 2.0?===
[[Image:USB-HighSpeed-certified-Logo.png|thumb|alt=USB High Speed Certified logo|Devices bearing this logo are certified High Speed devices. They can be plugged directly into Pandora's USB 2.0 host port.]]
There are no set rules. As a very general guide:
* Common USB 1.1 devices include keyboards, mice, headsets, older USB devices.
* Common USB 2.0 devices include cameras, PMPs, HDDs, hubs, card readers, thumb drives.
This is just a rough representation of what’s out there in the wild, and you will find exceptions. Devices like HSDPA modems and GPS units could fall into either category. The only reliable indication of true USB 2.0 compatibility is the “USB High Speed Certified” logo (right).

===Arrgh, USB used to be simple. What can I actually connect to Pandora?===
Almost anything, as long as it's supported by Linux. Think of a USB device that everybody uses (mouse, keyboard, thumb drive...) and chances are it will be a simple matter of plug and play. But this might not be the case for more specialised USB devices (modems, ethernet adapters, USB displays...), many of which will only function with Windows specific drivers.

If you intend to purchase USB accessories for use with Pandora, you should first research Linux support for that type of device. Devices already tested on Pandora will be added to the [[USB compatibility list]].

The various USB connection scenarios are as follows:

==Pandora as USB slave==
[[Image:Pandora.usb.slave.png|thumb|alt=Pandora as USB slave|Pandora as USB slave]]
Using a USB standard-A to mini-B cable (the kind you probably own several of), you can:
* Transfer data to/from Pandora
* Charge Pandora's battery.

'''Note:'''
*Charging Pandora from your computer's USB port is best done with Pandora in standby mode, or switched off. The current provided by your computer will probably not be sufficient to provide an effective charge while Pandora is being used.

==Hosting USB devices==
[[Image:Pandora.usb.host.png|thumb|alt=Pandora as a USB host|Pandora as a USB host]]
*Directly plug in a USB 2.0 device such as a thumb drive, or a Huawei E160 modem.
*Using a USB standard-A to USB standard-B (or mini-B, micro-B, depending on what's on the device) cable, connect USB 2.0 devices such as cameras, PMPs, and HDDS.
*Connect a USB hub, which will enable you to to connect USB 1.1 devices such as keyboards, mice, or a Huawei E220 modem.

'''Note:'''
*This port can supply a maximum of 500mA. If you plan to use a USB HDD, note that very few of these can draw sufficient power from a single USB port. A powered HDD caddy or powered USB hub will be necessary in most cases.

==OTG host mode==
[[Image:Pandora.usb.otg.host.png|thumb|alt=Pandora in OTG host mode|Pandora in OTG host mode]]
How you connect a device to the mini-AB OTG port depends on the device's USB connector.
*standard-B receptacle: Use a mini-A to standard-B cable.
*mini-B receptacle: Use a mini-A to mini-B cable.
*micro-B receptacle: Use a mini-A plug to standard-A receptacle adapter and a standard-A to micro-B cable.
*standard-A plug: Use a mini-A plug to standard-A receptacle adapter.
*mini-A plug: No extra cable or adapter needed.
*micro-A plug: No standardized solution exists.

This port allows you to connect a USB 1.1 device directly, without the use of a hub. This port is also USB 2.0 compliant.

'''Notes:'''
*mini-A and mini-AB connectors have been removed from the present USB standard. This means that the above connectors may vanish from the market at some point (although there will probably be demand for them for some time). There are a lot of connectors available that were never standardized. It is recommended that you do not use them as they may lead to non-working connections. Stick to the cables and adapters mentioned above and look for a mention of "OTG" or "On The Go" and you should be on the safe side.
*In host mode, this port can supply a maximum of 100mA. USB 1.1 devices that draw more than 100mA will need to connect to Pandora's other USB port via a hub, as depicted in the previous example. The Huawei E220 is one such device.

'''Host mode connector'''
[[Image:Mini-usb.png|thumb|alt=mini-B and Mini-A comparison|mini-B and Mini-A comparison]]
Shown here are a Mini-B connector (left, black) and a Mini-A connector (right, white). The mini-a connector should be the one you want in order to use the OTG port in host mode. Click on the image for a larger version.

With the right connector, it is not necessary to switch the mode of the port[http://www.gp32x.com/board/index.php?/topic/55396-how-do-you-put-the-usb-otg-port-into-host-mode/], it will be done automatically. It may also be possible to force a mode switch, but this has not been clarified by the devs, and could result in two devices both attempting to power the port (which is not recommended)

==Links==
*[[USB_compatibility_list|Pandora USB compatibility list]]
*[http://www.usb.org/developers/docs/usb_20_122208.zip USB 2.0 Standard (including present OTG spec)]
*[http://www.usb.org/developers/onthego/otg1_0.pdf Original OTG Specification defining mini-A and mini-AB and allowed connections]
*[http://www.usb.org/developers/Deprecation_Announcement_052507.pdf mini-A and mini-AB Deprecation Announcement]
*[http://en.wikipedia.org/wiki/USB Wikipedia page on USB]

[[Category:FAQ]]

Quickstart

2010-08-18T10:15:01Z

Tsh: /* Download the latest Hotfix */ - another screenshot

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix3 here, although it is likely that Hotfix 4 will be released in August 2010. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''download the package here'' link for the latest HotFix Package (It's located under the "Complete firmware image including all Hotfixes"). (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/HotFix3-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder[[Image:Hotfix installed.jpg|thumb|alt=Hotfix screenshot|This is where you can find the hotfix installer. Click for a larger view.]]
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 3 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

File:Hotfix installed.jpg

2010-08-18T10:09:36Z

Tsh: Find your hotfix installer under system in the menu

Find your hotfix installer under system in the menu

User manual

2010-08-18T09:50:35Z

Tsh: Emphasised link to quickstart page

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
So your Pandora just arrived after being in the post for two months. Jolly good! But now that it's actually here, what on earth do you do with it? '''Don't panic!''' Let's take a look at what's included in the box(so you don't miss anything!) and then hop on over to setting it up for that extended Ms. Pacman marathon you've been waiting for!

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion!

If you find a problem which is not explained after visiting the forum, be sure to report it in the [http://bugs.openpandora.org/ Bug Tracker]

== Safety Information ==
Warning: Choking Hazard, do not let children under the age of 3 come close to your Pandora console.
The Pandora contains small parts that can be eaten by those children.

The battery of Pandora must be charged by the charger included with the Pandora (see package contents). [[http://www.open-pandora.org/ Open Pandora Ltd.]] will not be responsible for damage arising from the use of third party chargers. Please be aware that "cheap" third party chargers often carry fake CE logos. These can damage your Pandora or burst horribly into FLAMES.

Keep the Pandora in normal temperatures under 140F/60C (Recommended temperatures are in the range between -10C and 40C){{Citation needed}}. The battery is a standard Lithium Polymer battery. Do not keep near fire or water. Do not disassemble, destroy or damage the battery, or it may explode! Do not short circuit external contacts! Dispose of it properly, please.

Modifications to hardware can damage your Pandora. [[http://www.open-pandora.org/ Open Pandora Ltd]] cannot be held responsible for any resulting damages that occur from you modifying your Pandora.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the [http://apps.openpandora.org Pandora Apps] website, the [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive], or the websites of trusted developers.

The Pandora has a 4.3-inch touch screen. You can touch the screen to trigger an action. That's right, a touch screen - not a stab screen, punch screen, or solid mahogany workbench. Always touch the screen gently – that is more than enough to trigger the action you want.

The casing of the Pandora has been designed for maximum strength, making it quite hard to break. Please do not consider this a challenge. Do not drop, throw, clamp, launch, tumble dry, or place anvils on the Pandora. This will void your warranty.

== Warranty Information ==
A one year warranty applies as required by law, and the device will be replaced/repaired if it is faulty. LCDs with numerous/excessive dead pixels will also be replaced.{{Citation needed}}

== Box Contents ==
When you first open Pandora's box, a slew of demons and raging emotions may forcibly leave the box. This is normal. After that, you should find the following items:
*Pandora console
*Stylus (located in stylus slot on the side of the Pandora)
*Battery
*Mains power adapter (charger)
*Battery case
The following items should also be present if you ordered them separately:
*TV-Out Cable (As of 05-25-10 these are not yet included in the box and will ship separately as available)
*Carrying Case
*Extra Battery
After you take those things out, you may find a sliver of Hope left over. It's best to keep it, as you never know when you could use some Hope.

== Specifications ==
==== Highlights ====
{{citation needed}}
* ARM® Cortex™-A8 600Mhz+ CPU running Linux*
* 430-MHz TMS320C64x+™ DSP Core
* PowerVR SGX OpenGL 2.0 ES compliant 3D hardware
* 800x480 4.3" 16.7 million colours touchscreen LCD
* Wifi 802.11b/g, Bluetooth & High Speed USB 2.0 Host
* Dual SDHC card slots & SVideo TV output
* Dual Analogue and Digital gaming controls
* 43 button QWERTY and numeric keypad
* Around 10+ Hours battery life**

:<nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.
:<nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)

==== Advanced Specifications ====
* Texas Instruments OMAP3530 processor at 600MHz (officially)
* 256MB DDR-333 SDRAM
* 512MB NAND FLASH memory
* IVA2+ audio and video processor using TI's DaVinci™ technology (430MHz C64x DSP)
* ARM® Cortex™-A8 superscalar microprocessor core
* PowerVR SGX530 (110MHz officially) OpenGL ES 2.0 compliant 3D hardware
* integrated Wifi 802.11b/g (up to 18dBm output)
* integrated Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
* 800x480 resolution LTPS LCD with resistive touch screen, 4.3" widescreen, 16.7 million colors (300 cd/m2 brightness, 450:1 contrast ratio)
* Dual analog controllers
* Full gamepad controls plus shoulder buttons
* Dual SDHC card slots (up to 64GB of storage currently)
* headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
* TV output (composite and S-Video)
* Internal microphone plus ability to connect external microphone through headset
* Stereo line level inputs and outputs
* 43 button QWERTY and numeric keypad
* USB 2.0 OTG port (1.5/12/480Mbps) with capability to charge device
* USB 2.0 HOST port (480Mbps) capable of providing the full 500mA to attached devices (examples include USB memory, keyboard, mouse, 3G modem, GPS)
* up to two externally accessible UARTs and/or four PWM signals for hardware hacking, robot control, debugging, etc.
* un-brickable design with integrated boot loader for safe code experimentation
* Power and hold switch useful for "instant on" and key lockout to aid in media player applications on the go
* Runs on the Linux operating system (2.6.x)
* Dimensions: 140x83.4x27.5mm
* Weight: 335g (with 4200mAh battery)

==== Features ====
The Pandora is a mixture between a PC and a gaming console (similar to classic computers such as the Amiga). That's why it has gaming controls (ABXY buttons, d-pad, and analogue nubs). It is fast enough to emulate many other systems, run a full desktop, access the internet with Firefox and play games such as Quake III. However, it is not as big as a netbook. Believe it or not, it will fit in your pocket. It's a bit bigger than the original Nintendo DS. (See the [[#Applications | Applications]] section of this manual to see what applications your Pandora will come with.)
Remember that your Pandora console will get better with every application installed!

== First Time Use ==
Now that you've opened the box, let's set this thing up! Place the battery inside the battery compartment on the back of the Pandora, making sure the contacts touch(the little silvery metal bits, it's easy). Snap on the battery cover and you're all set!
If you find this linux stuff is a bit new and overwhelming, please try the [[Quickstart | quickstart page]] for a simple walk through the first steps (including downloading the codec pack) and please provide feedback on the forums about how it can be improved and still kept simple.
==== Charging ====
Charge your Pandora 8 hours before disconnecting it from the wall charger. This will improve the lifetime of your battery. To charge the Pandora, insert the power cable end in the Pandora and the other end into your wall socket.

The battery comes pre-charged at 40%, and that level might have decreased during shipping. To be on the safe side, we recommend that you charge the Pandora before you use it. Simply plug in your wall charger into an outlet, or optionally use a mini-USB cable connected to a computer or wall adapter. For extreme silliness, plug your Pandora into an ''already charged Pandora,'' and charge it from that! But not really.

To "fast charge" just put the system into "low-power" mode. You cannot charge the system while _off_. This is currently a feature and may change in future versions of the firmware.

As an added note by MWeston:
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.

==== First Boot ====
Once your Pandora is ready, turn it on. The OS will take some time to boot up for the first time (about 10 minutes, this is only for the first boot, and is normal). After it has booted, a series of settings dialogs will pop up in the shape of a "Boot Wizard" allowing you to alter your Pandora's settings to your liking.

There are a total of 3 parts to the Boot Wizard guide:
===== System configuration =====
The first thing you will have to do is to calibrate the Pandora's touch screen. Only do this if the screen isn't calibrated already.
You will have the option for touchscreen calibration the first time you boot up your Pandora console.

Note: "Calibrating the touch screen" is a term used to describe the process of matching coordinates given by the touch layer with the underlying screen. A badly calibrated screen will register your push elsewhere on the screen, perhaps half a centimeter to one side. As there are sometimes slight variations in the production of the touch layer, you the user can improve the accuracy by matching the two layers manually.

===== User setup =====
After calibrating your screen, you will have to enter your full name. This is what you will see in any user selection dialogs or when the system needs to address you, so enter whatever you are most comfortable with. Then follows your username. It is recommended to choose an all-lowercase, one-word username here, since you will have to enter this name every time you log in. Once you've entered your username, a password input dialog appears. You will have to enter the password you want to use twice here. If you don't want to have a password for your device, simply leave both fields empty. If, however, you decide to enter a password, something hard to guess and between 8 and 16 characters long is preferred.

===== Network and security settings =====
You will now have to enter a name for your Pandora. This will be the Pandora's host name, so you have two options in this situation:

# If you don't have a domain you want to connect to, simply enter any name here. It should not contain any spaces.
# If you ''do'' have a domain you want to connect to, enter a name in the form of "pandoraname.domainname.tld". Note that you may never have a use for this.

Then, you'll have to choose whether you want to automatically log in on your Pandora when it boots, or if you should be given the opportunity to log in as a different user, or enter your password. It is recommended to disable auto login if you want to protect your user data, but if you're often in a hurry, then you can enable auto login here.

The final thing you will have to choose, is whether you want to use the full desktop Xfce environment or the gaming-oriented PMenu environment as your default environment in the Pandora. It is recommended to choose Xfce here if you want to gain access to the Pandora's full potential. This option can be changed later at any point.

==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====

The nubs automatically calibrate with use, and do so every time the unit is freshly powered up. Calibration information is stored inside the nub RAM, so when you power down (full power off, not just low power mode) the calibration information is lost. Calibrating the nubs is as simple as just using them -- do a few left right up down moves or swoosh around, and the nub will know its boundaries and be good thereafter.

So no special effort is required to calibrate or use the nubs, but the first few motions you use of them may be erratic as they self-calibrate.

==== Calibrating The Touchscreen ====
The touchscreen in your new Pandora device isn't psychic! You have to tell it what to do, and in order to do that effectively, you need to calibrate it. Simply navigate to settings→screen→calibration wizard{{Verify credibility}} and follow the onscreen instructions. You may have to recalibrate the screen from time to time as well.

During the first boot wizard, you will be offered the option to calibrate the touchscreen. By default it may well work okay, but the option is there. If calibration is far off, use the keyboard to select the calibration option.

==== Mouse (stylus/pointer) settings ====
When done with the calibration and you are back in the Pandora Xfce desktop environment you might also want to change some other touch screen settings to make navigation with the stylus work according to your preferences. Two recommended settings to experiment with for easier navigation are:

# The double-click Time setting
# The double-click Distance (valid touch-screen double-click area)

In the first setting, i.e. Time, you will be setting the interval between double-clicks where such clicks will be accepted as valid.
Ex. if you set the time to 250ms, the second click (or screen-tap in our case) must occur within 250ms of the first to be valid.

In the second setting, Distance, you will be setting the radius of screen area where the second click (tap) must fall into to be considered as a valid second tap. This means that if, for example, you set the distance to 5, your second tap must fall within a circle radius of 5 pixels from the point where the first tap occurred.

These two settings can be found under: Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.

== Basic Use ==

===Pmenu===

TBD.

===minimenu / mmenu===

minimenu is designed as a fast and easy to use launcher, without a lot of fancy frills. A grid of icons to launch, and use the d-pad or touchscreen to fire one off. It is fairly configurable and skinnable and is fully featured, and very fast. If you recall the interface on the gp32, gp2x, wiz, and gmenu2x you will be right at home and then some!

=====The main grid=====

The main grid with the default skin has most of the screen realestate showing a grid of available 'auto discovered' applications, with a detail panel on the right. A list of tabs is across the top of the screen, with some short help message on the bottom.

Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.

Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.

The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.

The applications are auto-discovered in the same means as the xfce desktop and pmenu and other pnd-supporting systems, however you may add additional minimenu-specific searchpaths into the configuration should you wish to. It is likely a basic file browser will also be added, letting you launch applications manually placed on your SD cards.

The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.

===Desktop style environment (Xfce)===

=====On the Desktop=====

The desktop will contain icons for numerous locations (such as each mounted SD card), as well as any auto-discovered pnd-applications located on SD cards or internal NAND.

=====In the menu=====
On the bottom left you have your applications menu, similar to the Windows start menu. Clicking it brings up a list of all installed applications and pnd-applications in the appropriate location on your SD cards.

=====Miscellaneous=====
To the right may be some icons, these serve as shortcuts to commonly used applications. Next to that you have your taskbar which, as you might have guessed, lists all running applications in your current workspace. To the right of the taskbar you have your workspaces, think of these as multiple desktops. By default you have two to switch between. Applications running in one workspace will not be visible in the other, so you can effectively hide your Ms. Pacman game from your boss at work, because there's no way you're not going to go for the gold, even at work! Finally there are a few more icons that deal with TV-Out, network connectivity, etc. and some running applications may place an icon there as well. And to the right of THOSE, you have your time. Because time flies when you're using your Pandora! Badum tsh. And to the right of that, you have a little icon which, when clicked, displays all running applications.

Finally, I'd just like to reiterate this--EVERYTHING is customizable! We'll get to that section later on.

===Pandora Button===

When in the desktop style environment (Xfce), the Pandora button will bring up the applications menu, letting you quickly view the available applications. If held, it allows you to [[User_manual#Killing Applications | kill]] an unresponsive application.

===[[Power modes | Power Modes]]===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply sliding the power switch to the right will toggle modes.

Consider low power mode to be akin to turning off a PDA or cellphone -- the screen is off, the CPU is clocked down and so on, but the device is still silently on, allowing for alarms to go off or it to be turned on again instantly. Regular power mode is for normal usage.

Low power mode is probably going to be used as the normal "off" for most people, with true off (device powered down entirely, unable to respond to alarms or wake up quickly) available to conserve battery power. Turning the Pandora off completely is the best option if you don't plan on using it for few weeks or longer.

Closing the lid will turn off the display but otherwise leave the device operating - handy for audio playing; turning off the display reduces power consumption.

Shutdown will only occur if you are unplugged from the wall. The device can't be charged while off, to "fast charge" just switch to low power mode. See [[Power modes | power modes]] for more info.

The actual behaviour of buttons and events can be customized.

=== USB Peripherals ===
You can connect USB2 High Speed peripherals directly, using the large USB connector, or a USB-OTG adaptor lead. Lower-speed USB devices will only work through a hub, the Pandora does not have the support circuitry inside to drive the interface in the correct mode.
See the [[USB_compatibility_list|the USB compatibility list]] for peripherals which have been tested so far.

=== Killing Applications ===
Killing (or forcibly closing) an unresponsive application is as simple as holding down the Pandora button (just under start and select) for a few seconds. A dialog will appear which lists the open applications and gives you the option to kill them.

=== Forcing a Restart ===
Occasionally something will happen causing your Pandora to become unresponsive (to the point that even killing a program isn't possible). When this happens it is necessary to force your Pandora to restart. The easiest way to do this is by holding the Pandora button and moving the power switch to the right.

== Configuration and Customization ==
This is just an overview of the customization and configuration you can do. Individual sections may link to their own pages.

=== Setting Up WiFi ===
If wifi is enabled, and you are in range of an access point, a dialogue should appear offering to connect to it. See the [[Wifi]] page for more detail on using wifi.

=== Setting Up Bluetooth ===

=== Adjusting Brightness/Contrast ===
Brightness can be raised by pressing Fn+I and lowered with Fn+U. A tool is included with the Pandora called "LCD-Settings" (under the "Settings" menu) which can be used to adjust the brightness and the gamma.

=== Changing Your Theme ===
Under "Settings" in the menu, you will find "Appearance" which will let you adjust the style, icon set, fonts, and a few other appearance related settings. Also, under "Window Manager" you can adjust the style of each window's title bar.

=== Minimenu Configuration and Tricks ===

minimenu has a fairly comprehensive configuration file for its minimalistic design; most options may be enabled or disabled or fiddled with, and the skin can reasonably be altered.

The All category can be removed if undesired.

Expert conf hackers can specify what categories they'd like and in what order, and have multiple app categories dumped into one tab, and other tricks.

pnd-application icons may be all loaded during the menu setup, or deferred until later and loaded in the background.

Preview pics may be loaded up front (not advised, as it can be slow), or deferred until later. (When deferred, they may load when you rest the selection, or load in background.)

You may choose to have auto-discovered applications registered into any of their 6 categories (Main, Sub1, Sub2, Alt, AltSub1, AltSub2).

Etc and so on.

Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.

[[Minimenu Configuration Documentation | This section contains more information.]]

== Applications ==

Many applications will come preinstalled into the internal NAND; these will be regular Linux applications (not packaged into pnd files, since they do not need to be redistributed to anyone.)

Additional applications may be found as [[Introduction to PNDs | pnd-files]] (a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

==== What Is Included? ====
* Ångström Linux: Lightweight beautiful Linux-based operating system for the Pandora.
* Xfce: A full featured window manager for Linux.
* Midori: A full features web browser, designed to be lighter and faster than a full desktop style browser.
* Lightweight office utilities including Abiword, Gnumeric, and ClawsMail.
{{Volume needed}}

==== Where Can I Get More Apps? ====
There are many ways to get more applications onto your Pandora.

*On this wiki, we maintain up-to-date lists of [[games]], [[Emulator list|emulators]], and [[Software projects|other software]], with download links. These lists are more comprehensive than the two official sites below, because not every program is submitted to both of them.

*The easiest way is to browse the [http://apps.open-pandora.org Open App Store], where you can download a selection of free or commercial applications. To download, navigate to an app, pay for it if you must, and hit the 'download' button. Select where you want to save it, and you're done!

*There is the good ol' [http://dl.openhandhelds.org/cgi-bin/pandora.cgi Pandora File Archive].

*There are nice repositories, such as the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], or...

*The Pandora includes the package manager opkg, which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. Note this will install to nand by default, so should be used with great caution.

*Also, people may upload their apps to weird crevices in the net, so be on the lookout! (or use a search engine)

:<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">''Note: Your Pandora's internal memory (NAND) will be at close to capacity when you receive it. All new programs should be installed to SD card. Downloads from the Angstrom Repo, or use of the opkg package manager, should only be done by advanced users or when instructed by Open Pandora Ltd (for example, firmware updates will probably use a pandora specific repository in the future).''</div>

==== Installing a PND file (an application) ====
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
Installation of a PND file is so easy, you can hardly even call it installing. All you need to do is copy the PND file into the appropriate folder on your SD card. The first thing you'll need to do is set up some folders that the Pandora will recognise. It's recommended that you start with a blank, freshly formatted (or freshly purchased) SD card. For the purposes of this guide we'll refer to your SD card as <SD>. (Windows might call it something like G:\Removable Disk.) Create a new folder on the SD card called 'pandora':
*<SD>/pandora
Then open the 'pandora' folder, and create four more inside it: apps, appdata, desktop, and menu:
*<SD>/pandora/apps
*<SD>/pandora/appdata/
*<SD>/pandora/desktop/
*<SD>/pandora/menu/
Now you're ready to install a PND file. Just copy and paste (or drag and drop) (or save) the file into your folder of choice:
* Putting a PND in the /desktop folder will make it appear on the XFCE desktop
* Putting a PND in the /menu folder will make it appear in the XFCE system menu
* Putting a PND in the /apps folder will make it appear in both locations
* If you're using Minimenu instead of XFCE, it doesn't matter which of these three folders you use
Occasionally you'll come across an application which needs additional data (for example, the data files for Quake, or ROMs for an emulator). These files goes into the appdata folder. A PND program will automatically create its own subfolder within /appdata the first time it is run; then you can add files to it. More information on this is available on the [[Introduction_to_PNDs#Where_does_my_data_go.3F_How_do_I_make_files_visible_to_the_applications.3F | introduction to PNDs]] page.

== Firmware ==
For more detail about firmware, see the [[Introduction to firmware]] page.

==== Updating The Firmware ====

Updates to the firmware are currently provided as Hotfix packages, in [[Introduction to PNDs |PND]] format. Check the OpenPandora official [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en support] page for the latest status. This will update any parts of the system which need to be updated. A more flexible system is planned, this should allow automatic downloading and installing of updates if you wish (but should not be expected before late in 2010.

==== Replacing the Firmware ====

There are several reasons why you might wish to take this seemingly drastic step. It is possible that the system software gets corrupted somehow (for example, a power failure whilst you are completing the 'first boot' process). Alternatively, you might wish to install a copy of the firmware on an SD card if you are experimenting with different system configurations. Regardless, the Pandora is very robust, it is always possible to download some files to the SD card, and use these to return the internal NAND to the 'factory' state without too much effort. See the [[Introduction to firmware]] page for information on how to do this.

== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

==Futher reading==
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
* [[Minimenu Configuration Documentation]] - If you want to customize or configure Minimenu.
* [[Tutorials]]
* [[Emulator list]] - See what systems you can emulate.
* [[Games]] - Take a look at the games that are available.

[[Category:Categories]]

Quickstart

2010-08-18T09:39:58Z

Tsh: /* Download the latest Hotfix */

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix3 here, although it is likely that Hotfix 4 will be released in August 2010. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.
[[Image:PandoraSD.png|thumb|alt=SD card folder structure|This is what the folder structure on your SD card should look like. The drive letter and card name will vary; they're not important.]]
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''download the package here'' link for the latest HotFix Package (It's located under the "Complete firmware image including all Hotfixes"). (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/HotFix3-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 3 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

Talk:Production Timeline

2010-08-14T11:02:08Z

Tsh: New section: 13 Aug

Production Timeline

2010-08-12T08:00:54Z

Tsh: /* 2010 */ cureent 100 are for approval

USB compatibility list

2010-08-10T09:33:39Z

Tsh: /* HSDPA (3G) Modems */

==Devices==

===Networking===
----

====HSDPA (3G) Modems====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Huawei E160
| Not required
| standard-A
| USB 2.0
| 250mA
| standard-A port
| Yes
| Yes
|
|-
| Huawei E160E
| Not required
| standard-A
| USB 2.0
| 250mA
| standard-A port
| Yes
| Yes
|
|-
| Huawei E220
| Not required
| standard-A
| USB 1.1
| 250mA
| standard-A port via High Speed hub
| Yes
| Yes
|
|-
| iPhone 3GS (Probably also 1G/3G)
| ipheth
| standard-A
| USB 2.0
| 500mA
| USB A
| Yes, works.
| Yes, works.
| Requires a good bit of dependencies to get working. Tested with Debian from SD, but should work in Angstrom with some work. The ipheth wwan0 device only provides a connection over the 3G modem, even if you're connected to a wifi network. I used the iproxy and SSH tunneling method with proxychains to get to the wifi network.
|
|-
| HTC Desire
| not required
| standard-A
| USB 2.0
| 500mA
| USB A
| Yes, works.
| Yes, works.
| Requires internet connection sharing to be enabled from the phone.
|}

====USB to Ethernet adapters====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Apple USB Ethernet Adapter MB442Z/A
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| Yes
| Works perfectly on the Pandora. You may need to left-click the networking icon on the panel in Xfce, and click "Ifupdown (bnep0)" in order to connect to the internet.
|-
| EU.MARK USB 10/100M RJ45 Ethernet Network Adapter Dongle (MosChip MCS7830)
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| No
| Tested on Opensuse 11.2 - USB ID: 9710:7830 - bought from [http://www.dealextreme.com/details.dx/sku.22684 DealExtreme]
|-
| Wii USB 2.0 adapter (use [http://www.asix.com.tw/products.php?op=pItemdetail&PItemID=86;71;101 ASIX AX 88772 USB 2.0 chip])
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| Yes
| Works perfectly on the Pandora. I have not the official one from Nintendo but a clone from [http://www.dealextreme.com/details.dx/sku.5926 dealextrem]
|}

====USB WiFi adapters====
The Pandora stock kernel doesn't seem to come with any wireless driver support outside of the internal wifi chip. The only way you'll get wireless working is to build your own kernel with it included or try [http://wireless.kernel.org/en/users/Download compat-wireless].

{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Belkin N1 Wireless USB Adapter (F5D8051) ("Ver. 2053") (MARVELL v1021)
| N/A
| Standard-A
| USB 2.0
|
| Not connecting it at all.
| Reported to work with ndiswrapper.
| No native driver support and ndiswrapper obviously won't work.
| There's a previous revision of this dongle which is supposed to have a Ralink chip, but they revised it and put a different chip inside.
|-
| Cisco/Linksys AE1000 High Performance Wireless-N USB Adapter
| rt3572sta (RT3572USB)
| Standard-A
| USB 2.0
|
| USB A
| Reportedly works.
| Works with a modified driver.
| Download the driver from [http://www.ralinktech.com/support.php?s=2 ralink's driver site], edit ./common/rtusb_dev_id.c, before "#endif // RT2870" add "{USB_DEVICE(0x13B1,0x002F)},", compile. '''NOTE: Broke after three days!'''
|}

See also this thread [[http://www.gp32x.com/board/index.php?/topic/55570-new-pandora thread]] on the forums for the latest.

===Storage===
----

====External Hard Disk Drives====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! style="min-width: 120px" | Works
! Additional comments
|-
| LaCie Rikiki 250GB USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Not working on Pandora Works in Linux.
| This drive does not work on a Pandora. Not only does it fail to spin up, but it causes the Pandora's screen to pulsate wildly, much like an old CRT would if you placed a speaker or a magnet near to it. I have not yet tested this with a powered hub.
|-
| SAMSUNG S1 Mini 250GB HXSU025BA, 1.8 Inch USB Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Untested on Pandora Works in Linux (*)
| * Logical Block Size being 4096 partitioning and formating can be an issue on Linux. [http://ubuntuforums.org/showthread.php?t=1252729 Ubuntu forum] Try using Palimpsest on Ubuntu 9.10 or later. [http://anandtech.com/storage/showdoc.aspx?i=3691 Article on moving to 4096 LBS]
|-
| Toshiba HDDR320E03E 320GB 2.5-Inch Ext USB Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Untested on Pandora Works in Linux
|
|-
| Verbatim 250GB Model #47580 Hard Drive
| Not required
| direct
| USB 2.0
| Unknown
| direct
| Works on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877512 almatuk]. "worked an absolute treat when plugged into the Pandora. Watched videos directly from it at full speed, no need for powered USB hub. Had issues playing roms directly off it however as it was formatted NTFS. I'm sure if I formatted to FAT32 these would disappear."
|-
| Western Digital 160GB Elements External USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Works on Pandora Works in Linux
| This drive works just fine with the Pandora.
|-
| Western Digital 250GB My Passport Essential USB 2.0 2.5" Hard Drive
| Not required
| direct?
| USB 2.0
| Unknown
| direct?
| Works on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877386 TheDarkSpectrum48K]. "Works perfectly!"
|-
| Western Digital 400GB My Passport Essential USB 2.0 2.5" HDD model WDME4000TE
| Not required
| standard-A
| USB 2.0
| Unknown
| Direct
| Works on Pandora
| Tested by [http://www.gp32x.com/board/index.php?/user/14534-peca/ Peca]. "Works perfectly!"
|-
| Seagate Seagate® Expansion™ External Drives
| Not required
| standard-A
| USB 2.0
| Unknown
| Direct
| Doesn't work on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/user/14781-hitnrun/]. "Isn't even detected in lsusb (drive powered by external power source)"
|}

====DVD/CD Drives====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Lite-On EZ-DUB DVD/CD Multi-Recorder (Model eZAU120)
| Not required
| standard-A
| USB 2.0
| Powered by included mains adapter - DC 12V 1.8A
| standard-A port
| Yes
| No
|
|}

===Video capture device===
----

====Webcams====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Exoo No Driver/USB 2.0 Webcam (Model No.: M053)
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port
| Yes
| No
| Bought from [http://www.dealextreme.com/details.dx/sku.14991 DealExtreme]
|-
| Logitech Quickcam Communicate Deluxe
| Not required
| standard-A
| high speed
| Unknown
| standard-A port
| Yes
| No
| USB ID: 046d:0992, works though [http://linux-uvc.berlios.de/ uvcvideo]
|}

===Input device===
----
Any HID ([http://en.wikipedia.org/wiki/Human_interface_device Human Interface Device]) compliant keyboard, mouse or game controller should work on the Pandora. Most of those device are low speed or full speed USB device and will need to be connected though either a USB OTG adapter/cable or a USB2 hub in order to work on the Pandora.

====External Game Controllers====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| USB Super RetroPort (SNES-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=29 RetroZone]
|
|-
| USB RetroPort (NES-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=28 RetroZone]
|
|-
| Trio Linker Plus II (PlayStation,-GameCube,-and-Dreamcast-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.play-asia.com/paOS-13-71-6m-49-en-70-1zfv.html Play-Asia]
|
|-
| NAZAR V47 USB Force Feedback Vibrating Gamepad Controller for PC
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.24551 DealExtreme]
|
|-
| 10-Fire-Button Double Vibration Feedback USB PC Arcade Joystick
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.27821 DealExtreme]
|
|-
| Official PlayStation 3 controller
| Not required
| standard-A
| Full speed
| USB A To Mini B Cable via High Speed Hub
| Yes
| No
| This is for USB not bluetooth compatibility. Sixaxis and DualShock not tested.
|-
| Wired Xbox 360 Controller
| xpad module
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| This also includes gamepads for PC that needs the Windows Xinput driver. Such gamepads include the Logitech Chillstream.
|}

====Graphics tablets====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Wacom Volito2 Tablet (Model: CTF-420)
| Not required
| standard-A
| Low speed
| 40 mA ([http://www.my-volito.com/volito/specs.asp?lang=en Source])
| Yes
| No
| USB ID: 056a:0062
|}

==Connectors, adapters, and hubs==
This section is intended as a general guide. Items in this section are standard USB accessories, so drivers are not required. Compatibility with Pandora is assumed. Please note that any external product links are provided for reference only, and are not an endorsement.

===OTG Adapters===
{|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"
! Device
! Tested
! Additional comments
|-
| Generic adapter
| No
| [[http://shop.ebay.com/?_from=R40&_trksid=p3907.m38.l1313&_nkw=usb+otg+host+cable&_sacat=See-All-Categories Find on eBay]] [[http://www.amazon.co.uk/s/ref=nb_ss_ce?url=search-alias%3Delectronics&field-keywords=OTG+Cable+Adapter&x=3&y=23 Find on Amazon]] These links are not 100% accurate. Check for `mini-a`, and on ebay, the price is higher (like $8)
|-
| Nokia USB OTG adapter
| Yes
| Link Required
|}

===Compact USB Hubs===
{|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"
! Device
! Tested
! Additional comments
|-
| Griffin SmartShare USB
| No
| [[http://www.griffintechnology.com/products/smartshare-usb Griffin website]]
|-
| Belkin F5U415 4 Port USB 2.0 Swivel Hub
| No
| Comes with an optional power adapter. [[http://catalog.belkin.com/IWCatProductPage.process?Product_Id=377085 Belkin website]]
|-
| ID 0e8f:0016 GreenAsia Inc.
| Not Working - tsh
| Labeled as high speed, from ebay
|-
|Trust 4 port netbook hub ID 05e3:0608
|Works - tsh
|http://www.amazon.co.uk/gp/product/B0025X16AS
|-
| HIGH SPEED 4 PORT MINI USB 2.0 HUB FOR LAPTOP PC (non powered)
| YES
| octopus style small cheap nonpowered USB hub from ebay [[http://cgi.benl.ebay.be/ws/eBayISAPI.dll?ViewItem&item=270538502843 ebay seller]]
|}

==More Information==
For more information on the Pandora's two USB ports and the possible connections that can be made with them, see [[USB_reference|the USB reference page]].

[[Category:Hardware]]

Quickstart

2010-08-09T14:13:17Z

Tsh: /* Download the codec pack */

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix3 here, although it is likely that Hotfix 4 will be released in August 2010. Always use the latest one. An automated process is being worked on.
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''download the package here'' link for the latest HotFix Package (It's located under the "Complete firmware image including all Hotfixes"). (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/HotFix3-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 3 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet)
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

USB compatibility list

2010-08-09T10:17:24Z

Tsh: /* USB to Ethernet adapters */

==Devices==

===Networking===
----

====HSDPA (3G) Modems====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Huawei E160
| Not required
| standard-A
| USB 2.0
| 250mA
| standard-A port
| Yes
| Yes
|
|-
| Huawei E160E
| Not required
| standard-A
| USB 2.0
| 250mA
| standard-A port
| Yes
| Yes
|
|-
| Huawei E220
| Not required
| standard-A
| USB 1.1
| 250mA
| standard-A port via High Speed hub
| Yes
| Yes
|
|}

====USB to Ethernet adapters====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Apple USB Ethernet Adapter MB442Z/A
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| Yes
| Works perfectly on the Pandora. You may need to left-click the networking icon on the panel in Xfce, and click "Ifupdown (bnep0)" in order to connect to the internet.
|-
| EU.MARK USB 10/100M RJ45 Ethernet Network Adapter Dongle (MosChip MCS7830)
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| No
| Tested on Opensuse 11.2 - USB ID: 9710:7830 - bought from [http://www.dealextreme.com/details.dx/sku.22684 DealExtreme]
|-
| Wii USB 2.0 adapter (use [http://www.asix.com.tw/products.php?op=pItemdetail&PItemID=86;71;101 ASIX AX 88772 USB 2.0 chip])
| Not required
| standard-A
| USB 2.0
|
| standard-A port
| Yes
| Yes
| Works perfectly on the Pandora. I have not the official one from Nintendo but a clone from [http://www.dealextreme.com/details.dx/sku.5926 dealextrem]
|}

====USB WiFi adapters====
As yet (9Aug) no adaptors have been identified as working without having to re-compile the kernel to add support. Some (cheaper) adaptors have been identified as not working. See this [[http://www.gp32x.com/board/index.php?/topic/55570-new-pandora thread]] on the forums for the latest.

===Storage===
----

====External Hard Disk Drives====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! style="min-width: 120px" | Works
! Additional comments
|-
| LaCie Rikiki 250GB USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Not working on Pandora Works in Linux.
| This drive does not work on a Pandora. Not only does it fail to spin up, but it causes the Pandora's screen to pulsate wildly, much like an old CRT would if you placed a speaker or a magnet near to it. I have not yet tested this with a powered hub.
|-
| SAMSUNG S1 Mini 250GB HXSU025BA, 1.8 Inch USB Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Untested on Pandora Works in Linux (*)
| * Logical Block Size being 4096 partitioning and formating can be an issue on Linux. [http://ubuntuforums.org/showthread.php?t=1252729 Ubuntu forum] Try using Palimpsest on Ubuntu 9.10 or later. [http://anandtech.com/storage/showdoc.aspx?i=3691 Article on moving to 4096 LBS]
|-
| Toshiba HDDR320E03E 320GB 2.5-Inch Ext USB Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Untested on Pandora Works in Linux
|
|-
| Verbatim 250GB Model #47580 Hard Drive
| Not required
| direct
| USB 2.0
| Unknown
| direct
| Works on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877512 almatuk]. "worked an absolute treat when plugged into the Pandora. Watched videos directly from it at full speed, no need for powered USB hub. Had issues playing roms directly off it however as it was formatted NTFS. I'm sure if I formatted to FAT32 these would disappear."
|-
| Western Digital 160GB Elements External USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port via powered High Speed Hub
| Works on Pandora Works in Linux
| This drive works just fine with the Pandora.
|-
| Western Digital 250GB My Passport Essential USB 2.0 2.5" Hard Drive
| Not required
| direct?
| USB 2.0
| Unknown
| direct?
| Works on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877386 TheDarkSpectrum48K]. "Works perfectly!"
|-
| Western Digital 400GB My Passport Essential USB 2.0 2.5" HDD model WDME4000TE
| Not required
| standard-A
| USB 2.0
| Unknown
| Direct
| Works on Pandora
| Tested by [http://www.gp32x.com/board/index.php?/user/14534-peca/ Peca]. "Works perfectly!"
|-
| Seagate Seagate® Expansion™ External Drives
| Not required
| standard-A
| USB 2.0
| Unknown
| Direct
| Doesn't work on Pandora Works in Linux
| Tested by [http://www.gp32x.com/board/index.php?/user/14781-hitnrun/]. "Isn't even detected in lsusb (drive powered by external power source)"
|}

====DVD/CD Drives====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Lite-On EZ-DUB DVD/CD Multi-Recorder (Model eZAU120)
| Not required
| standard-A
| USB 2.0
| Powered by included mains adapter - DC 12V 1.8A
| standard-A port
| Yes
| No
|
|}

===Video capture device===
----

====Webcams====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Exoo No Driver/USB 2.0 Webcam (Model No.: M053)
| Not required
| standard-A
| USB 2.0
| Unknown
| standard-A port
| Yes
| No
| Bought from [http://www.dealextreme.com/details.dx/sku.14991 DealExtreme]
|-
| Logitech Quickcam Communicate Deluxe
| Not required
| standard-A
| high speed
| Unknown
| standard-A port
| Yes
| No
| USB ID: 046d:0992, works though [http://linux-uvc.berlios.de/ uvcvideo]
|}

===Input device===
----
Any HID ([http://en.wikipedia.org/wiki/Human_interface_device Human Interface Device]) compliant keyboard, mouse or game controller should work on the Pandora. Most of those device are low speed or full speed USB device and will need to be connected though either a USB OTG adapter/cable or a USB2 hub in order to work on the Pandora.

====External Game Controllers====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Suggested connection to Pandora
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| USB Super RetroPort (SNES-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=29 RetroZone]
|
|-
| USB RetroPort (NES-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=28 RetroZone]
|
|-
| Trio Linker Plus II (PlayStation,-GameCube,-and-Dreamcast-to-USB adapter)
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Bought from [http://www.play-asia.com/paOS-13-71-6m-49-en-70-1zfv.html Play-Asia]
|
|-
| NAZAR V47 USB Force Feedback Vibrating Gamepad Controller for PC
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.24551 DealExtreme]
|
|-
| 10-Fire-Button Double Vibration Feedback USB PC Arcade Joystick
| Not required
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.27821 DealExtreme]
|
|-
| Official PlayStation 3 controller
| Not required
| standard-A
| Full speed
| USB A To Mini B Cable via High Speed Hub
| Yes
| No
| This is for USB not bluetooth compatibility. Sixaxis and DualShock not tested.
|-
| Wired Xbox 360 Controller
| xpad module
| standard-A
| Unknown, probably USB 1.1
| standard-A port via High Speed Hub
| Yes
| No
| This also includes gamepads for PC that needs the Windows Xinput driver. Such gamepads include the Logitech Chillstream.
|}

====Graphics tablets====
{|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"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Tested in Linux
! Tested on Pandora
! Additional comments
|-
| Wacom Volito2 Tablet (Model: CTF-420)
| Not required
| standard-A
| Low speed
| 40 mA ([http://www.my-volito.com/volito/specs.asp?lang=en Source])
| Yes
| No
| USB ID: 056a:0062
|}

==Connectors, adapters, and hubs==
This section is intended as a general guide. Items in this section are standard USB accessories, so drivers are not required. Compatibility with Pandora is assumed. Please note that any external product links are provided for reference only, and are not an endorsement.
===OTG Adapters===
{|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"
! Device
! Tested
! Additional comments
|-
| Generic adapter
| No
| [[http://shop.ebay.com/?_from=R40&_trksid=p3907.m38.l1313&_nkw=usb+otg+host+cable&_sacat=See-All-Categories Find on eBay]] [[http://www.amazon.co.uk/s/ref=nb_ss_ce?url=search-alias%3Delectronics&field-keywords=OTG+Cable+Adapter&x=3&y=23 Find on Amazon]] These links are not 100% accurate. Check for `mini-a`, and on ebay, the price is higher (like $8)
|-
| Nokia USB OTG adapter
| Yes
| Link Required
|}

===Compact USB Hubs===
{|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"
! Device
! Tested
! Additional comments
|-
| Griffin SmartShare USB
| No
| [[http://www.griffintechnology.com/products/smartshare-usb Griffin website]]
|-
| Belkin F5U415 4 Port USB 2.0 Swivel Hub
| No
| Comes with an optional power adapter. [[http://catalog.belkin.com/IWCatProductPage.process?Product_Id=377085 Belkin website]]
|-
| ID 0e8f:0016 GreenAsia Inc.
| Not Working - tsh
| Labeled as high speed, from ebay
|-
|Trust 4 port netbook hub ID 05e3:0608
|Works - tsh
|http://www.amazon.co.uk/gp/product/B0025X16AS
|-
| HIGH SPEED 4 PORT MINI USB 2.0 HUB FOR LAPTOP PC (non powered)
| YES
| octopus style small cheap nonpowered USB hub from ebay [[http://cgi.benl.ebay.be/ws/eBayISAPI.dll?ViewItem&item=270538502843 ebay seller]]
|}

==More Information==
For more information on the Pandora's two USB ports and the possible connections that can be made with them, see [[USB_reference|the USB reference page]].

[[Category:Hardware]]

Quickstart

2010-08-06T11:29:53Z

Tsh: /* Download the latest Hotfix */

{{IntroNote | This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.}}

==Introduction==
This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the [[Main Page]] of the wiki.

==Power it up==
#You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
#Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
#Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

==First Run Wizard==
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
#After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
#The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to ''click''
##Name (Conventionally your full name)
##Login (Must not contain spaces)
##Password (and confirmation). Do not forget this!
##Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
##Select if you want to login automatically with no password prompt
##Prefered GUI (Use XFCE for this tutorial)
##Time Zone (can be changed later)
#Once done, Pandora will reboot. From this point it is safe to unplug from the mains

==Around the screen==
[[image:Screen_layout.jpg]]
==Connect WiFi==
This step is optional, you can use another PC to download apps to an SD card or USB stick.
# Click the menu buttton, click System, click Toggle WiFi
# The 3rd light on the left is red, and should come ON (WiFi)
# A popup might say networks arre available.
# To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
# Move the mouse with the left nub, and left click by moving the right nub to the left.
# Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
# A spinning circle indicates the connection is in progress.
# A beacon icon shows the signal strength when connected
:[[image:Wifi_connected.jpg]]

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

==Download the latest Hotfix==
This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix3 here, although it is likely that Hotfix 4 will be released in August 2010. Always use the latest one. An automated process is being worked on.
# Find an SD or SDHC card.
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar
# Click on Support
# Click the ''download the package here'' link for the latest HotFix Package (It's located under the "Complete firmware image including all Hotfixes"). (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/HotFix3-Zaxxon.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Click ''create folder'' and enter then name ''pandora''
# Double click on the pandora folder (right nub up once)
# Click ''create folder'' and enter then name ''apps''
# Double click on the apps folder
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''HotFix 3 Installer''. Press enter
# Follow the prompts and enter your password when requested

==Download the codec pack==
This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country.
Note: You must perform the previous step in order to do this one!
# If not connected to WiFi, do this on another computer
# Click the blue globe icon (3rd from left)
# type open-pandora.org into the address bar, click on Support
# Click the ''download the package here'' link for the codec pack. (2-8-2010 - Hotfix 3: [http://www.open-pandora.org/downloads/CodecPack.pnd])
# Select ''save as''
# Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
# Double click on the pandora folder (right nub up once)
# Double click on the apps folder (right nub up once)
# Click ''save''
# Wait for the download to finish
# Put the SD card in your pandora if done on a PC
# Press the pandora button in between the nubs (short press)
# Use the D-pad to scroll up to ''System'' then right, and down to ''Community Codec pack installer''. Press enter
# Follow the prompts and enter your password when requested

==Play some Music==

==Download a game==

==Switch to MiniMenu==

Assuming you are in Xfce:
# Open up the Xfce menu
# Go to ''System'', then ''Switch GUI''
# Highlight ''MiniMenu'' and press ''OK''

==Switch to Xfce==

Assuming you are in MiniMenu:
# Go to ''System'', then ''Switch GUI''
# Highlight ''XFCE4'' and press ''OK''

==Change the default GUI==

# If in Xfce, open up the menu by pressing the Pandora button
# Go to ''Settings'', then ''Startup''
# Highlight ''Change Default GUI for current user'' and press ''OK''
# Highlight the GUI you want and press ''OK''
The next time you log in, the chosen GUI should load.

==Shutdown==
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:
# Press the Pandora button for the menu.
# Select LogOut
# Select Shutdown

From MiniMenu:
# Press the Select button
# Select ''Shutdown Pandora''

Production Timeline

2010-08-04T12:33:25Z

Tsh: /* 2010 */