Difference between revisions of "Quickstart"

From Pandora Wiki
Jump to: navigation, search
m (Updated instructions for finding the codec pack)
m (simplified language)
 
(59 intermediate revisions by 8 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.}}
+
[[File:Lead_Photo_For_Quickstart0-4735223688200513.jpg|thumbnail|Attunement to pandora]]
 +
<translate>
  
==Introduction==
+
[[Category:Tutorials]]
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.
+
[[Category:Documentation]]
 +
<br /><br />
 +
= Introduction = <!--T:1-->
 +
 
 +
<!--T:2-->
 +
This page provides a very simple walk-through to get you up and running.
 +
 
 +
<!--T:3-->
 +
'''If there is only one document you will take the time to read, it is this one.'''
 +
 
 +
For additional help, see the [[user manual]], or [[Special:Search|search this wiki]].
 +
<br /><br />
 +
== Removing the battery from its case == <!--T:4-->
 +
[[File:BatteryCase.jpg|thumbnail|Battery case.]]
 +
If your battery is in its case, and you find it difficult to open the battery case, try one of these methods.[http://boards.openpandora.org/index.php?/topic/963-complain-about-battery-case-here/]
 +
 
 +
# Stick a fingernail into each corner of one end and then run it around one side to past the 3/4 mark.
 +
# Squeeze the bottom half just a smidge where the semi-circular markings are on the sides and the top pops off fairly easily.
 +
# Hold the case vertically, get a fingernail between the gaps and slowly separate the two sides.
 +
<br /><br />
 +
== Inserting the battery into the Pandora == <!--T:5-->
 +
[[File:BatteryCover.jpg|thumbnail|Battery cover.]]
 +
The battery cover is on the bottom of the Pandora, held on by two tabs.  Remove the battery cover by pulling on those two tabs.
 +
 
 +
<!--T:6-->
 +
One side of the battery has three copper contacts. Line up the three contacts up with three copper contacts on the Pandora and insert the battery.  Add the battery cover and make sure it's closed completely.
 +
 
 +
<!--T:7-->
 +
: ''If your Pandora has issues staying powered on, and you're sure it's charged properly, then perhaps the battery is not seated correctly.  Ensure the cover is on tightly.  If the battery is still loose, try inserting a folded piece of paper in top of the battery before closing the battery cover.''
 +
 
 +
When inserting the battery, the Pandora will begin booting up automatically.
 +
<br /><br />
 +
== Battery and charging notes == <!--T:8-->
 +
[[File:Battery.jpg|thumbnail|Battery.]]
 +
* It's ok to keep your Pandora plugged in overnight to charge.
 +
* It's ok to charge your Pandora at any time.  You do not need to worry about "over charging" it.
 +
* It's ok to use your Pandora until it runs out of power and shuts down.
 +
* It's ok to leave your Pandora laying around not plugged in.  All batteries will diminish in strength over time, and the Pandora's battery is no different.  It will discharge about 5% each week.  This does not damage it. It can be charged up again as normal.
 +
<br /><br />
 +
== Using the mains adapter ==
 +
[[File:AcDcAdapter.jpg|thumbnail|AC/DC adapter.]]
 +
# Plug the charger into the mains.
 +
#* Depending on your region, you may need to use the provided mains adapter.
 +
# Plug the charger into the Pandora.
 +
#* A green light at the right hand will shine as the Pandora wakes up.  Soon after, a red light will appear next to this.{{FIXME|What does it do? -- comradekingu}}
 +
#*: ''If your battery is completely drained, you may need to wait between 10 and 30 minutes for it to trickle-charge enough to wake up.''
 +
<br /><br />
  
==Power it up==
+
== The stylus == <!--T:9-->
#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.
+
[[File:Stylus.jpg|thumbnail|Stylus]]
#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.
+
The stylus fits in a slot in the bottom, near the front and on the right hand side. It slides in parallel to the battery. Pull on it to slide it out.
#Whilst waiting to boot, 'write' with the [[stylus]] on some paper. This will polish the tip.
 
  
==First Run Wizard==
+
<!--T:10-->
Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.
+
A new Pandora's stylus may be a little bit "firm". Over time it will become easier to pull out and push back 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 XFCE screen==
+
<!--T:11-->
[[image:Screen_layout.jpg]]
+
For a brand new stylus, 'write' on some regular paper.  This will polish the tip and help prevent scratches on your screen when using it.
 +
You can also apply a screen protector to achieve this. Writing on paper may leave black streaks, as you rub some plastic onto the paper.
  
==Connect WiFi==
+
Get used to putting your stylus away inside the Pandora. Don't leave it elsewhere. Don't lose it!
{{hint
+
<br /><br />
|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.
 
}}
 
  
This step is optional, you can use another PC to download apps to an [[SD card]] or [[USB]] stick.
+
= Powering up = <!--T:12-->
# 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 are 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|Connected via WLAN]]
 
  
==Download the latest Hotfix==
+
== First Run Wizard == <!--T:13-->
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]]. <br>Figure 1 is the SD card itself (yours will have a different name).<br>Figure 2 shows us that a /pandora folder has already been created on the card, and we're browsing inside it.<br>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==
+
<!--T:14-->
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)
+
Some information is needed at this stage to set things up. Make sure you keep the charger plugged in.{{FIXME|Why?  I didn't -- spiralofhope}}
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 Community & Support
 
# Click on Updates & Firmware
 
# 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
 
  
==Play some Music==
+
<!--T:15-->
Put your music in a folder somewhere on your [[SD card]], then open GNOME [[Mplayer]] and navigate to that folder (read [[Basic Linux Guide]] to learn about the directory structure on the Pandora).
+
All of these settings can be updated later.{{FIXME|We need instructions for updating each item here.}}
  
==Download a game==
+
<!--T:16-->
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. Or download something you like from the [[games]] list.
+
After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus.
  
==Switch to MiniMenu==
+
<!--T:17-->
 +
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''
  
Assuming you are in [[Xfce]]:
+
<!--T:18-->
# Open up the Xfce menu
+
; Name: Conventionally your full name
# Go to ''System'', then ''Switch GUI''
+
; Login: This is your username.  It must not contain spaces.
# Highlight [[MiniMenu]] and press ''OK''
+
; Password: (and confirmation). Do not forget your password!
 +
; Machine Name: How your machine appears on a network. Again no spaces. Short is good.
 +
; Auto Login: Select if you want to login automatically with no password prompt.
 +
; Preferred GUI: This tutorial uses XFCE, a complete Linux desktop environment.
 +
; Time Zone: Select the timezone you are in.
  
==Switch to Xfce==
+
Your Pandora will reboot once this step is complete. You can now unplug from mains if need be.
 +
<br /><br />
 +
= Around the XFCE screen = <!--T:19-->
  
Assuming you are in [[MiniMenu]]:
+
[[image:Screen_layout.jpg]]
# Go to ''System'', then ''Switch GUI''
+
<br /><br />
# Highlight ''XFCE4'' and press ''OK''
+
= Wi-Fi (Wireless) = <!--T:20-->
  
==Change the default GUI==
+
<!--T:21-->
 +
This step is optional, you can use another PC to download apps to an SD card or USB stick.
  
# If in Xfce, open up the menu by pressing the Pandora button
+
<!--T:22-->
# Go to ''Settings'', then ''Startup''
+
: '''Note''': You must already have actual wireless networking set up and working in your household. The pandora only receives signals from a base-station. You may be able to find a free wireless internet connection where you are.  Most libraries and some coffee shops provide one.
# 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==
+
<!--T:23-->
It is assumed your are using Xfce for these fixes. If you wish to switch back to MiniMenu after making these changes see above.
+
# Click the menu button, click System, click Toggle Wi-Fi
 +
# The 3rd light on the left is red, and should come ON (Wi-Fi)
 +
# A popup might say networks are 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.
 +
# A spinning circle indicates the connection is in progress.
 +
# A beacon icon shows the signal strength when connected
  
===Take ownership of your desktop===
+
<!--T:24-->
Your desktop is owned by root in the default installation.  Until this is fixed you won't be able to write to your desktop.
+
:[[image:Wifi_connected.jpg|Connected via WLAN]]
  
# In Xfce, open up the menu by pressing the Pandora button
+
= Change the default GUI = <!--T:25-->
# 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} Desktop''
 
# Enter your password and press [ENTER] if it is required
 
# Type ''sudo chgrp {your user-name) Desktop''
 
# Enter your password and press [ENTER] if it is required
 
  
===Fix the installer's time-zone set-up===
+
<!--T:26-->
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.
+
# 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 chosen GUI will appear the next time you log in.
  
# In Xfce, open up the menu by pressing the Pandora button
+
<!--T:27-->
# Select ''Terminal'' from the menu.
+
There is a choice between [[Xfce]], [[Minimenu]] and [[OpenBox]].
# 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==
+
= Shutdown = <!--T:28-->
To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.
 
  
 +
<!--T:29-->
 +
To shutdown, remove the charger. Otherwise the pandora will reboot.
  
 +
<!--T:30-->
 +
From XFCE:
  
From Xfce:
+
<!--T:31-->
# Press the Pandora button for the menu.
+
# Press the [Pandora] button for the menu.
 
# Select LogOut
 
# Select LogOut
 
# Select Shutdown
 
# Select Shutdown
  
 +
<!--T:32-->
 
From MiniMenu:
 
From MiniMenu:
# Press the Select button
+
 
 +
<!--T:33-->
 +
# Press the [Select] button
 
# Select ''Shutdown Pandora''
 
# Select ''Shutdown Pandora''
  
[[Category:Tutorials]]
+
<!--T:34-->
[[Category:Documentation]]
+
If those do not work, you can [[Power_modes#Power_Off|hard shut-down]].
[[Category:Problems]]
+
</translate>

Latest revision as of 00:08, 10 June 2014

Attunement to pandora



Introduction

This page provides a very simple walk-through to get you up and running.

If there is only one document you will take the time to read, it is this one.

For additional help, see the user manual, or search this wiki.

Removing the battery from its case

Battery case.

If your battery is in its case, and you find it difficult to open the battery case, try one of these methods.[1]

  1. Stick a fingernail into each corner of one end and then run it around one side to past the 3/4 mark.
  2. Squeeze the bottom half just a smidge where the semi-circular markings are on the sides and the top pops off fairly easily.
  3. Hold the case vertically, get a fingernail between the gaps and slowly separate the two sides.



Inserting the battery into the Pandora

Battery cover.

The battery cover is on the bottom of the Pandora, held on by two tabs. Remove the battery cover by pulling on those two tabs.

One side of the battery has three copper contacts. Line up the three contacts up with three copper contacts on the Pandora and insert the battery. Add the battery cover and make sure it's closed completely.

If your Pandora has issues staying powered on, and you're sure it's charged properly, then perhaps the battery is not seated correctly. Ensure the cover is on tightly. If the battery is still loose, try inserting a folded piece of paper in top of the battery before closing the battery cover.

When inserting the battery, the Pandora will begin booting up automatically.

Battery and charging notes

Battery.
  • It's ok to keep your Pandora plugged in overnight to charge.
  • It's ok to charge your Pandora at any time. You do not need to worry about "over charging" it.
  • It's ok to use your Pandora until it runs out of power and shuts down.
  • It's ok to leave your Pandora laying around not plugged in. All batteries will diminish in strength over time, and the Pandora's battery is no different. It will discharge about 5% each week. This does not damage it. It can be charged up again as normal.



Using the mains adapter

AC/DC adapter.
  1. Plug the charger into the mains.
    • Depending on your region, you may need to use the provided mains adapter.
  2. Plug the charger into the Pandora.
    • A green light at the right hand will shine as the Pandora wakes up. Soon after, a red light will appear next to this.
      If your battery is completely drained, you may need to wait between 10 and 30 minutes for it to trickle-charge enough to wake up.



The stylus

Stylus

The stylus fits in a slot in the bottom, near the front and on the right hand side. It slides in parallel to the battery. Pull on it to slide it out.

A new Pandora's stylus may be a little bit "firm". Over time it will become easier to pull out and push back in.

For a brand new stylus, 'write' on some regular paper. This will polish the tip and help prevent scratches on your screen when using it. You can also apply a screen protector to achieve this. Writing on paper may leave black streaks, as you rub some plastic onto the paper.

Get used to putting your stylus away inside the Pandora. Don't leave it elsewhere. Don't lose it!

Powering up

First Run Wizard

Some information is needed at this stage to set things up. Make sure you keep the charger plugged in.

All of these settings can be updated later.

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
This is your username. It must not contain spaces.
Password
(and confirmation). Do not forget your password!
Machine Name
How your machine appears on a network. Again no spaces. Short is good.
Auto Login
Select if you want to login automatically with no password prompt.
Preferred GUI
This tutorial uses XFCE, a complete Linux desktop environment.
Time Zone
Select the timezone you are in.

Your Pandora will reboot once this step is complete. You can now unplug from mains if need be.

Around the XFCE screen

Screen layout.jpg

Wi-Fi (Wireless)

This step is optional, you can use another PC to download apps to an SD card or USB stick.

Note: You must already have actual wireless networking set up and working in your household. The pandora only receives signals from a base-station. You may be able to find a free wireless internet connection where you are. Most libraries and some coffee shops provide one.
  1. Click the menu button, click System, click Toggle Wi-Fi
  2. The 3rd light on the left is red, and should come ON (Wi-Fi)
  3. A popup might say networks are available.
  4. To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
  5. Move the mouse with the left nub, and left click by moving the right nub to the left.
  6. 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.
  7. A spinning circle indicates the connection is in progress.
  8. A beacon icon shows the signal strength when connected
Connected via WLAN

Change the default GUI

  1. If in XFCE, open up the menu by pressing the Pandora button
  2. Go to Settings, then Startup
  3. Highlight Change Default GUI for current user and press OK
  4. Highlight the GUI you want and press OK

The chosen GUI will appear the next time you log in.

There is a choice between Xfce, Minimenu and OpenBox.

Shutdown

To shutdown, remove the charger. Otherwise the pandora will reboot.

From XFCE:

  1. Press the [Pandora] button for the menu.
  2. Select LogOut
  3. Select Shutdown

From MiniMenu:

  1. Press the [Select] button
  2. Select Shutdown Pandora

If those do not work, you can hard shut-down.