Difference between revisions of "User manual"

From Pandora Wiki
Jump to: navigation, search
m (Replacing the Firmware)
(merged codec pack from quickstart)
 
(107 intermediate revisions by 21 users not shown)
Line 1: Line 1:
{{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:PandoraFrontNew.jpg|Right|thumb|360px|The Pandora.]]
  
[[Image:PandoraFront.jpg|Right|thumb|360px|Pandora FTW!]]
+
== Introduction ==
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.
+
The OpenPandora is a pocket sized computer which is a combination of a PC and a Gaming Console. OpenPandora has a D-Pad, Two analogue [[nubs]], ABXY + Shoulder Buttons and a 43-button QWERTY [[keyboard]]. The OpenPandora is fast enough to run a full ARM based Operating System, access the internet, play games and do stuff productively if desired.
  
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]
+
==Quick Start Guide ==
 +
If you just want a quick walkthrough on how things work (tl;dr) have a look [[Quickstart | here]]
  
 +
== Technical Specifications ==
  
== Safety Information ==
+
; Outside:
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.
+
* 140 x 83.4 x 27.5mm, 335g (including battery)
 +
* "Clamshell" design
 +
* 43 button QWERTY and numeric keypad
 +
<!-- But it doesn't have a separate numeric keypad.. -->
 +
* Gaming controls:
 +
** Two analog controllers (nubs)
 +
** 8-way D-pad
 +
** A/B/X/Y and shoulder buttons for gaming.
 +
* 800x480 resolution LTPS lcd with resistive touch screen, 4.3" widescreen, 16.7 million colors, 300 cd/m2 brightness, 450:1 contrast ratio
 +
* Two SDHC slots
 +
* Headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
 +
* Internal microphone plus ability to connect external microphone through headset
 +
* TV Output (composite and S-Video)
 +
* 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)
 +
* Two externally accessible UARTs and four PMW signals (for hardware hacking, robot control, debugging, etc.)
  
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.
+
; Inside:
  
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.
+
* 4200mAh battery.
 +
** 10+ hours of battery life, depending on usage. For example, turning Wi-Fi or the screen off would give better battery life. (e.g. whilst listening to music via headphones)
 +
* 600MHz Texas Instruments OMAP3530 processor /1GHZ DM3730 Texas Instruments SoC
 +
** Can be clocked higher or lower by software designed for the device.
 +
* 256MB DDR-333 SDRAM (Pre-2012-units), 512MB DDR-333 SDRAM (units made in Germany, 2012)
 +
* 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 OpenGL ES 2.0 compliant 3D hardware
 +
* Wifi 802.11b/g (up to 18dBm output)
 +
* Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
  
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.
+
; More:
  
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.
+
* Stereo line level inputs and outputs
 +
<!-- What does this mean? -->
 +
* Unbrickable 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 GNU/Linux Operating System (currently kernel 3.2.x and 2.6.x)
  
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.
+
== Box Contents ==
  
== 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:
 
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 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**
 
 
:<small><nowiki>*</nowiki>The 600Mhz+ can be clocked higher or lower. This can be controlled by software designed for the device.</small>
 
:<small><nowiki>**</nowiki>Is affected by use. (For example, turning Wi-Fi off will give better battery life.)</small>
 
 
==== 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 console
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.)
+
* Stylus (located in stylus slot on the side of the Pandora)
Remember that your Pandora console will get better with every application installed!
+
* Battery
 +
* Mains power adapter
 +
* Battery Case
  
== First Time Use ==
+
Available separately:
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.
+
* TV-Out Cable - SDTV over composite or s-video
 +
* Carrying Case
 +
* Extra Battery
  
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.
+
== Safety Information ==
  
You can find more useful information about charging on the [[Power_modes]]-page.
+
*The OpenPandora should not be used by Children under the age of 3 due to potential choking hazards.
 +
*The OpenPandora's Battery should only be charged with supplied charger / Via USB or a suitable third party charger.
 +
*The OpenPandora should only be used in temperatures above -10°C (14°F) and below 40°C (104°F).
  
As an added note by MWeston:
+
== Warranty Information ==
IF YOU POWERED THE SYSTEM WITHOUT A BATTERY, SHUT IT OFF BEFORE STICKING THE BATTERY BACK IN.
 
  
==== First Boot ====
+
Standard one year warranty applies to the OpenPandora.
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:
+
* User Neglect / Modifications are generally not covered by warranty.
===== 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.
+
== First Time Use ==
  
===== User setup =====
+
Place the battery inside the battery compartment underneath the OpenPandora taking care to ensure the battery contacts and battery touch. Replace the battery cover and your OpenPandora will power up.
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 =====
+
==== Charging ====
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.
+
As this is your first time using the Battery it is recommended you fully charge your OpenPandora to 100% using the AC Adapter as this will calibrate and improve the lifetime of your battery. This process may take up to 4 hours. If you're not planning on using the OpenPandora whilst it is charging you should flip the power switch to the left (Low Power Mode) as it should decrease the charging time dramatically.
# 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.
+
Once the OpenPandora has completed charging it will stop charging and begin discharging to protect the battery from damage.
  
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.
+
You can find more useful information about charging on the [[power modes | Power Modes]] page.
  
==== Calibrating the Analog Nubs [http://pandorawiki.org/Nubs]====
+
==== First Boot ====
 
 
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.
+
While you are charging your OpenPandora completing the first boot wizard is essential.
  
==== Mouse (stylus/pointer) settings ====
+
===== Steps Involved=====
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:
+
*Calibrate Touchscreen - This will ensure that the TouchScreen works perfectly.
 +
*Enter Full Name - This personalises your OpenPandora
 +
*Enter Short name - can be a fancy nickname or just your fullname in all lowercase
 +
*Enter Password - anything you like and you'll need to verify it
 +
*Choose a name for your OpenPandora - Give it a fancy name as this will be the network visible name.
 +
*Automatic Login - Entirely up to you. Preferably off if you don't want others to use your OpenPandora without your permission
 +
*GUI choice - Slimmed down basic GUI - Minimenu or full Linux OS - Xfce
 +
*TimeZone / Date and Time - Recommended you do set this correctly as it may cause problems down the track with certain applications.
 +
*CPU Clock Speed - Recommended that you set to Default unless a game / application is running slowly.
 +
*Advanced settings - Do not change until you are comfortable with the device.
  
#  The double-click Time setting
+
====Analog Nubs [http://pandorawiki.org/Nubs]====
#  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.
+
The OpenPandora nubs are designed to automatically calibrate when you turn your Pandora & Calibration is lost once the OpenPandora is switched off.
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.
+
==== Calibrating the Touchscreen ====
  
These two settings can be found under:  Desktop ---> Xfce menu ---> Settings ---> Mouse ---> Behaviour tab.
+
The touchscreen in the OpenPandora may / may not be calibrated when you first get it. It is recommended you do run the Calibration Wizard in the first boot wizard alternatively if you clicked too fast you can run the calibration wizard by going to the Settings / Calibrate Touch Screen section in either GUIs
  
 
== Basic Use ==
 
== Basic Use ==
 
See the [[GUI]] page for more details on the user interfaces which can be used with the Pandora.
 
See the [[GUI]] page for more details on the user interfaces which can be used with the Pandora.
  
===Pmenu===
+
===Mini Menu===
 
 
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!
+
[[minimenu | Mini Menu]] is a quick and easy to use launcher created by OpenPandora's great friend Skeezix. Mini Menu is designed to be fully reskinnable.
  
=====The main grid=====
+
===== Basic Navigation =====
  
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.
+
The main grid of Mini Menu displays the available applications, category tabs, Date / Time, Battery life and a detail pane on the right.
  
Pressing Start or B will invoke the pnd-application. Presseing Select will switch to a basic menu, providing shutdown or some advanced options.
+
When you copy a PND to SDCARDNAME/pandora/apps it will appear in its preset category.  
  
Pressing "Y" (think "Why?") will bring up pnd-application documentation, if that pnd-file has defined any.
+
Controls for Mini Menu:
 +
* D-Pad or touch screen can be used to select PNDs
 +
* Launch a PND by pressing 'Start', 'B' or touching the icon with the stylus or finger.
 +
* Press 'Y' for documentation if there is any available.
 +
* Left and Right shoulder triggers switch categories
  
The left and right shoulder triggers will switch categories of applications; by default, minimenu includes an All category and defaults to showing it.
+
=====Skinning=====
  
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.
+
Skinning guide in gp32x forum: http://www.gp32x.com/board/index.php?/topic/53990-skinning-minimenu/
  
The standard overrides are supported -- .ovr files for icon title, clockspeed setting and categories, as well as a .pnd for icon override.
+
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 (Skinning will not work without it)
  
 
===Desktop style environment (Xfce)===
 
===Desktop style environment (Xfce)===
Line 179: Line 144:
 
=====On the Desktop=====
 
=====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]].
+
The desktop contains icons which have been found on SD Cards / in Firmware.
 
 
=====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 Menu & Task Bar=====
 +
On the bottom left the Pandora menu contains all your applications sorted into the appropriate categories.
  
===Pandora Button===
+
The task bar by default contains settings for Brightness and Sound, various enablers such as Wifi,  Bluetooth and USB host, Network Connectivity, Battery life, Date / Time and various workspaces you can select.
  
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.
+
=====Navigation=====
 +
*If a window for an application is too big for the screen you can drag the window around by holding the left trigger and dragging with the stylus.
 +
*Changing your workspace is as easy as holding 'Start' & "Select' then using the D-Pad to switch
 +
*Killing an application is as simple as holding the Pandora button down for 5 seconds, selecting the application and clicking okay
  
 
===Power modes===
 
===Power modes===
  
The [[Power modes]] page provides full details of power modes, charging and battery care and lifetime.
+
Pushing the power button to the left will turn the OpenPandora to low power mode for conserving battery which is similar to sleep mode on a computer but the Pandora can still run.
 
 
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.
+
The [[Power modes]] page provides more information.
 
 
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 ===
 
=== 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 ===
+
Connecting USB2 High Speed devices is possible using the standard USB connector or USB On The Go adapter. USB 1.1 devices will only work through a USB hub.
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.
+
See the [[USB_compatibility_list| USB compatibility list]] for more information
  
 
=== Forcing a Restart ===
 
=== 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.
 
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 ==
+
== Operating System ==
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).
+
==== Updating The OS ====
  
Etc and so on.
+
Updating the OS can be done via either full Reflash or the Upgrade Pandora OS Application which is found in the System Menu.
  
Additional keys are supported: Q to quit the menu (not really useful for most people), and Space to invoke the application.
+
==== Reinstalling the OS ====
  
[[Minimenu Configuration Documentation | This section contains more information.]]
+
Sometimes things don't work out or you've broken something in the OS. You can reflash to default by getting the latest package from the [http://boards.openpandora.org/index.php/forum/41-pandora-os-superzaxxon-gnulinux/ forum] and placing in the root of the SD Card then while booting the Pandora hold down the R Button. Reinstalling the OS can take up to 15 minutes
  
 
== Applications ==
 
== Applications ==
 +
There is a relatively large number of games and applications available for your OpenPandora from the following sources:
  
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.)
+
*[http://repo.openpandora.org OpenPandora Repo] - Has over 1000 applications which are either free or at a very low cost. Applications do not contain DRM.
 
+
*[http://dl.openhandshelds.org/cgi-bin/pandora.cgi Open HandHelds] - An older site which may not have the latest applications but you'll find a heap of applications that are archive worthy.
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.)
+
*Angstrom Repository - Contains several applications for your Pandora. It is not really recommended that you use this unless you are an advanced user.
 
 
==== 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, 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. 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)
+
Installing applications is as simple as dragging them to the appropriate folders on your SD Card.
 +
These folders are:
 +
* <SD>/pandora/apps - Will appear both on Xfce Desktop & Pandora Menu (this is the 'both' option in PNDManager)
 +
*<SD>/pandora/desktop/ - If you want it to appear on Xfce Desktop
 +
*<SD>/pandora/menu/ - If you want it to appear in Pandora Menu
  
:<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>
+
You can use [http://repo.openpandora.org/?page=detail&app=pndmanager-bzar PNDManager] or [http://repo.openpandora.org/?page=detail&app=pndstore PNDStore] to download software from the repo and save it in the appropriate directory in one operation. PNDManager is recommended as the most user-friendly way of doing this.
  
==== Installing a PND file (an application) ====
+
Some applications will require additional data to work, this data will need to go into:
[[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.]]
+
*<SD>/pandora/appdata/applicationname
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 ==
+
The application should generate the required appdata folder when launched.
For more detail about firmware, see the [[Introduction to firmware]] page.
 
  
==== Updating The Firmware ====
+
== Download the codec pack ==
  
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.
+
Codecs are not bundled with the Pandora because there are different licensing laws in different countries.
  
==== Replacing the Firmware ====
+
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)
  
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.
+
'''Note:''' You must perform the previous step in order to do this one!
  
== Pandora FAQ ==
+
If you are not connected to WiFi, do this on another computer.
Silly goose, go to the [[FAQ]] page for more detailed information.
+
{{FIXME|These directions are awkward and need to be redone and accompanied with annotated screenshots.}}
 +
# Click the blue globe icon (3rd from left)
 +
# Type [http://pandorawiki.org/Firmware http://pandorawiki.org/Firmware] into the address bar
 +
# Click the ''Click here to download Community Codec Pack'' link for the codec pack
 +
# 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
  
 
==Futher reading==
 
==Futher reading==
 
* [[Basic Linux Guide]] - For those who don't know very much about Linux and want to learn more.
 
* [[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.
 
* [[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.
 
* [[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]]
+
[[Category:Documentation]]

Latest revision as of 00:38, 8 October 2013

The Pandora.

Introduction

The OpenPandora is a pocket sized computer which is a combination of a PC and a Gaming Console. OpenPandora has a D-Pad, Two analogue nubs, ABXY + Shoulder Buttons and a 43-button QWERTY keyboard. The OpenPandora is fast enough to run a full ARM based Operating System, access the internet, play games and do stuff productively if desired.

Quick Start Guide

If you just want a quick walkthrough on how things work (tl;dr) have a look here

Technical Specifications

Outside
  • 140 x 83.4 x 27.5mm, 335g (including battery)
  • "Clamshell" design
  • 43 button QWERTY and numeric keypad
  • Gaming controls:
    • Two analog controllers (nubs)
    • 8-way D-pad
    • A/B/X/Y and shoulder buttons for gaming.
  • 800x480 resolution LTPS lcd with resistive touch screen, 4.3" widescreen, 16.7 million colors, 300 cd/m2 brightness, 450:1 contrast ratio
  • Two SDHC slots
  • Headphone output up to 150mW/channel into 16 ohms, 99dB SNR (up to 24 bit/48KHz)
  • Internal microphone plus ability to connect external microphone through headset
  • TV Output (composite and S-Video)
  • 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)
  • Two externally accessible UARTs and four PMW signals (for hardware hacking, robot control, debugging, etc.)
Inside
  • 4200mAh battery.
    • 10+ hours of battery life, depending on usage. For example, turning Wi-Fi or the screen off would give better battery life. (e.g. whilst listening to music via headphones)
  • 600MHz Texas Instruments OMAP3530 processor /1GHZ DM3730 Texas Instruments SoC
    • Can be clocked higher or lower by software designed for the device.
  • 256MB DDR-333 SDRAM (Pre-2012-units), 512MB DDR-333 SDRAM (units made in Germany, 2012)
  • 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 OpenGL ES 2.0 compliant 3D hardware
  • Wifi 802.11b/g (up to 18dBm output)
  • Bluetooth 2.0 + EDR (3Mbps) (Class 2, + 4dBm)
More
  • Stereo line level inputs and outputs
  • Unbrickable 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 GNU/Linux Operating System (currently kernel 3.2.x and 2.6.x)

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:

  • The Pandora console
  • Stylus (located in stylus slot on the side of the Pandora)
  • Battery
  • Mains power adapter
  • Battery Case

Available separately:

  • TV-Out Cable - SDTV over composite or s-video
  • Carrying Case
  • Extra Battery

Safety Information

  • The OpenPandora should not be used by Children under the age of 3 due to potential choking hazards.
  • The OpenPandora's Battery should only be charged with supplied charger / Via USB or a suitable third party charger.
  • The OpenPandora should only be used in temperatures above -10°C (14°F) and below 40°C (104°F).

Warranty Information

Standard one year warranty applies to the OpenPandora.

  • User Neglect / Modifications are generally not covered by warranty.

First Time Use

Place the battery inside the battery compartment underneath the OpenPandora taking care to ensure the battery contacts and battery touch. Replace the battery cover and your OpenPandora will power up.

Charging

As this is your first time using the Battery it is recommended you fully charge your OpenPandora to 100% using the AC Adapter as this will calibrate and improve the lifetime of your battery. This process may take up to 4 hours. If you're not planning on using the OpenPandora whilst it is charging you should flip the power switch to the left (Low Power Mode) as it should decrease the charging time dramatically.

Once the OpenPandora has completed charging it will stop charging and begin discharging to protect the battery from damage.

You can find more useful information about charging on the Power Modes page.

First Boot

While you are charging your OpenPandora completing the first boot wizard is essential.

Steps Involved
  • Calibrate Touchscreen - This will ensure that the TouchScreen works perfectly.
  • Enter Full Name - This personalises your OpenPandora
  • Enter Short name - can be a fancy nickname or just your fullname in all lowercase
  • Enter Password - anything you like and you'll need to verify it
  • Choose a name for your OpenPandora - Give it a fancy name as this will be the network visible name.
  • Automatic Login - Entirely up to you. Preferably off if you don't want others to use your OpenPandora without your permission
  • GUI choice - Slimmed down basic GUI - Minimenu or full Linux OS - Xfce
  • TimeZone / Date and Time - Recommended you do set this correctly as it may cause problems down the track with certain applications.
  • CPU Clock Speed - Recommended that you set to Default unless a game / application is running slowly.
  • Advanced settings - Do not change until you are comfortable with the device.

Analog Nubs [1]

The OpenPandora nubs are designed to automatically calibrate when you turn your Pandora & Calibration is lost once the OpenPandora is switched off.

Calibrating the Touchscreen

The touchscreen in the OpenPandora may / may not be calibrated when you first get it. It is recommended you do run the Calibration Wizard in the first boot wizard alternatively if you clicked too fast you can run the calibration wizard by going to the Settings / Calibrate Touch Screen section in either GUIs

Basic Use

See the GUI page for more details on the user interfaces which can be used with the Pandora.

Mini Menu

Mini Menu is a quick and easy to use launcher created by OpenPandora's great friend Skeezix. Mini Menu is designed to be fully reskinnable.

Basic Navigation

The main grid of Mini Menu displays the available applications, category tabs, Date / Time, Battery life and a detail pane on the right.

When you copy a PND to SDCARDNAME/pandora/apps it will appear in its preset category.

Controls for Mini Menu:

  • D-Pad or touch screen can be used to select PNDs
  • Launch a PND by pressing 'Start', 'B' or touching the icon with the stylus or finger.
  • Press 'Y' for documentation if there is any available.
  • Left and Right shoulder triggers switch categories
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 (Skinning will not work without it)

Desktop style environment (Xfce)

On the Desktop

The desktop contains icons which have been found on SD Cards / in Firmware.

Pandora Menu & Task Bar

On the bottom left the Pandora menu contains all your applications sorted into the appropriate categories.

The task bar by default contains settings for Brightness and Sound, various enablers such as Wifi, Bluetooth and USB host, Network Connectivity, Battery life, Date / Time and various workspaces you can select.

Navigation
  • If a window for an application is too big for the screen you can drag the window around by holding the left trigger and dragging with the stylus.
  • Changing your workspace is as easy as holding 'Start' & "Select' then using the D-Pad to switch
  • Killing an application is as simple as holding the Pandora button down for 5 seconds, selecting the application and clicking okay

Power modes

Pushing the power button to the left will turn the OpenPandora to low power mode for conserving battery which is similar to sleep mode on a computer but the Pandora can still run.

The Power modes page provides more information.

USB Peripherals

Connecting USB2 High Speed devices is possible using the standard USB connector or USB On The Go adapter. USB 1.1 devices will only work through a USB hub. See the USB compatibility list for more information

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.

Operating System

Updating The OS

Updating the OS can be done via either full Reflash or the Upgrade Pandora OS Application which is found in the System Menu.

Reinstalling the OS

Sometimes things don't work out or you've broken something in the OS. You can reflash to default by getting the latest package from the forum and placing in the root of the SD Card then while booting the Pandora hold down the R Button. Reinstalling the OS can take up to 15 minutes

Applications

There is a relatively large number of games and applications available for your OpenPandora from the following sources:

  • OpenPandora Repo - Has over 1000 applications which are either free or at a very low cost. Applications do not contain DRM.
  • Open HandHelds - An older site which may not have the latest applications but you'll find a heap of applications that are archive worthy.
  • Angstrom Repository - Contains several applications for your Pandora. It is not really recommended that you use this unless you are an advanced user.

Installing applications is as simple as dragging them to the appropriate folders on your SD Card. These folders are:

  • <SD>/pandora/apps - Will appear both on Xfce Desktop & Pandora Menu (this is the 'both' option in PNDManager)
  • <SD>/pandora/desktop/ - If you want it to appear on Xfce Desktop
  • <SD>/pandora/menu/ - If you want it to appear in Pandora Menu

You can use PNDManager or PNDStore to download software from the repo and save it in the appropriate directory in one operation. PNDManager is recommended as the most user-friendly way of doing this.

Some applications will require additional data to work, this data will need to go into:

  • <SD>/pandora/appdata/applicationname

The application should generate the required appdata folder when launched.

Download the codec pack

Codecs are not bundled with the Pandora because there are 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 you are not connected to WiFi, do this on another computer.

  1. Click the blue globe icon (3rd from left)
  2. Type http://pandorawiki.org/Firmware into the address bar
  3. Click the Click here to download Community Codec Pack link for the codec pack
  4. Select save as
  5. Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
  6. Double click on the pandora folder (right nub up once)
  7. Double click on the apps folder (right nub up once)
  8. Click save
  9. Wait for the download to finish
  10. Put the SD card in your pandora if done on a PC
  11. Press the pandora button in between the nubs (short press)
  12. Use the D-pad to scroll up to System then right, and down to Community Codec pack installer. Press enter
  13. Follow the prompts and enter your password when requested

Futher reading