Pandora Wiki - User contributions [en]

Pyra SoC

2014-02-09T16:43:24Z

T4b:

Pros and Cons of each SoC.

{| class="wikitable"
|-
!
! How important is this aspect?
! OMAP 5
! Snapdragon 800/
! Snapdragon 805
! Z3770
|-
| General purpose power
|
| lowest
| higher
| even higher
| highest
|-
| open source friendliness
|
| better
| worst
| worst
| best
|-
| Battery life
|
|
|
|
|
|}

Pyra SoC

2014-02-09T16:11:35Z

T4b: Created page with "Pros and Cons of each SoC. {| class="wikitable" |- ! ! How important is this aspect? ! OMAP 5 ! Snapdragon 800/ ! Snapdragon 805 ! Z3770 |- | General purpose speed | | slowes..."

Pros and Cons of each SoC.

{| class="wikitable"
|-
!
! How important is this aspect?
! OMAP 5
! Snapdragon 800/
! Snapdragon 805
! Z3770
|-
| General purpose speed
|
| slowest
| faster
| even faster
| fastest
|-
| open source friendliness
|
|
|
|
| best
|-
| Battery life
|
|
|
|
|
|}

Keyboard/Requirement Analysis Pyra

2014-01-21T20:25:10Z

T4b: Reworded stuff ED supposedly said to match more closely what I heard that he probably said. :-)

Discuss [http://boards.openpandora.org/topic/15403-pyra-keyboard-layout-requirement-analysis/ there].

#hardware
##keyboard:
###MUST: allows for both handheld thumb typing and desktop finger typing
###MUST: is possible to find the keys by touch (for thumb typing)
####surface form: flat? rounded? concave? (T4b: I would like them to be more or less flat and concave a little bit so you feel the different keys better)
####surface height: (T4b: no higher than on current Pandora, preferably almost (only almost!) flush with the rest of the surface)
####MUST: surface coating: non sticky, fingers must glide over it as easily as possible
####MUST: minimum force needed to trigger key: is possible to slide finger over key without triggering it
####SHOULD: possible to easily find central keys (e.g. f and j) by touch (e.g. raised markers)
###MUST: individual keys easy to press
####maximum force needed to trigger key: must not be so big as to make it difficult to press the key (clarified?) (too obvious to include? But I guess we should also include trivial things)
####maximum way/travel needed to trigger key: (T4b: must be low, say 0.3mm, max 0.5mm)
####room between keys: (T4b: I would like to get rid of it completely, but only technically possible if the plastic ribs between the keys aren't necessary anymore)
####size of individual keys:
#####MUST: width can't be less than on the Pandora (ED)
#####SHOULD: height: can be lower than on the Pandora (ED)
###MUST NOT: forces Pyra's dimensions to exceed 1-2mm beyond the Pandora's
###MUST: has easy to read labels:
####colors:
####MUST: high enough contrast -> easy to read
###SHOULD (?): backlighting
####MUST: variable intensity (PWM? - Levi)
####COULD: variable color
###is possible to map to (generally as many as possible):
####MUST: qwerty/qwertz/azerty (those are basically the same, so we can group them together)
####MUST: dvorak
####COULD: colemak
####COULD: non latin (Russian, Japanese, etc.) (clarify! what's needed for this?)
###MUST NOT: keyboard gets into the way when gaming
####<practical considerations>
##keyboard '''and''' gaming controls:
###MUST: is resistant to foreign matter (pocket lint) from getting into/between the keys: not possible with the Pandora, could be a problem with mechanical keyboards
##gaming controls:
###NOTE: I think the individual action buttons are fine on the Pandora (T4b)
###MUST: 4 action buttons, dpad, 2 shoulder buttons, 2 nubs
###SHOULD: 2 additional shoulder buttons, buttons between nubs
###COULD: x additional action buttons
##cost: well, this should maybe be a poll. (T4b: the keyboard could cost a lot more than CHF9.27 ($10) if it's also considerably better if you ask me)
#software (default key bindings)
##SHOULD: is similar to Pandora's
##SHOULD: is similar to US international qwerty
###SHOULD NOT: break the correlation between a key and its shifted value (e.g. ; and : ) on the US international layout.
##Which keys need to be there?
###MUST: all keys and special characters found on a normal US keyboard layout (0-9,a-z, A-Z, ~!@#$%*()-_=+[{]}\|;:'"`,<.>/?, F1-F12, ESC, Tab, Capslock, shift, ctrl, alt, backspace, enter, insert, delete, home, end, pageup and pagedown.
###COULD: Omits Num Lock, Pause/Break, Print Scr, Sys Req
###MUST: support valid regular keyboard combinations from being input (e.g. shift-delete is a common shortcut in file managers that cannot be input on a Pandora keyboard)
###SHOULD: Characters commonly needed for shell usage ( Tab,;,",`,{},(),$,| ) are accessible using only one thumb (not counting sticky Fn) in combination with a modifier from the shoulder buttons. (Levi)
###SHOULD: German characters: äöüß (ED)
###SHOULD: two shift keys on main keyboard (ED)
###COULD: different keycodes for different versions of the same keys (T4b: "support" should be a given, it's more about the default layout, isn't it? Did I express it better?)
##what to map to the gaming controls?
##MUST: is usable using non-sticky modifiers in both of the handheld/desktop modes of typing. (clarify!) (T4b: I guess this is similar to 2.3.4, the most important characters shouldn't need sticky modifiers to input)
##Mouse emulation:
###MUST: allows mouse motion
###MUST: allows left/right mouse button clicks
###SHOULD: allows middle mouse button clicks (emulation through left mouse + right mouse is acceptable)
###COULD: allow mouse scrolling
##COULD: W-LAN, Bluetooth, etc.

Keyboard/Requirement Analysis Pyra

2014-01-19T16:34:19Z

T4b: Suggestion by Neelix

Discuss [http://boards.openpandora.org/topic/15403-pyra-keyboard-layout-requirement-analysis/ there].

#hardware
##keyboard:
###MUST: allows for both handheld thumb typing and desktop finger typing
###MUST: is possible to find the keys by touch (for thumb typing)
####surface form: flat? rounded? concave? (T4b: I would like them to be more or less flat and concave a little bit so you feel the different keys better)
####surface height: (T4b: no higher than on current Pandora, preferably almost (only almost!) flush with the rest of the surface)
####MUST: surface coating: non sticky, fingers must glide over it as easily as possible
####MUST: minimum force needed to trigger key: is possible to slide finger over key without triggering it
####SHOULD: possible to easily find central keys (e.g. f and j) by touch (e.g. raised markers)
###MUST: individual keys easy to press
####maximum force needed to trigger key: must not be so big as to make it difficult to press the key (clarified?) (too obvious to include? But I guess we should also include trivial things)
####maximum way/travel needed to trigger key: (T4b: must be low, say 0.3mm, max 0.5mm)
####room between keys: (T4b: I would like to get rid of it completely, but only technically possible if the plastic ribs between the keys aren't necessary anymore)
####size of individual keys:
#####SHOULD: width is as wide if not wider than the Pandora (ED)
#####MUST: height: is no taller than the Pandora (ED)
###MUST NOT: forces Pyra's dimensions to exceed 1-2mm beyond the Pandora's
###MUST: has easy to read labels:
####colors:
####MUST: high enough contrast -> easy to read
###SHOULD (?): backlighting
####MUST: variable intensity (PWM?) (Levi)
####COULD: variable color
###is possible to map to (generally as many as possible):
####MUST: qwerty/qwertz/azerty (those are basically the same, so we can group them together)
####MUST: dvorak
####COULD: colemak
####COULD: non latin (Russian, Japanese, etc.) (clarify! what's needed for this?)
###MUST NOT: keyboard gets into the way when gaming
####<practical considerations>
##keyboard [b]and[/b] gaming controls:
###MUST: is resistant to foreign matter (pocket lint) from getting into/between the keys: not possible with the Pandora, could be a problem with mechanical keyboards
##gaming controls:
###NOTE: I think the individual action buttons are fine on the Pandora (T4b)
###MUST: 4 action buttons, dpad, 2 shoulder buttons, 2 nubs
###SHOULD: 2 additional shoulder buttons, buttons between nubs
###COULD: x additional action buttons
##cost: well, this should maybe be a poll. (T4b: the keyboard could cost a lot more than CHF9.27 (CHF9.27 ($10)) if it's also considerably better if you ask me)
#software (default key bindings)
##SHOULD: is similar to Pandora's
##SHOULD: is similar to US international qwerty
###SHOULD NOT: break the correlation between a key and its shifted value (e.g. ; and : ) on the US international layout.
##Which keys need to be there?
###MUST: all keys and special characters found on a normal US keyboard layout (0-9,a-z, A-Z, ~!@#$%*()-_=+[{]}\|;:'",<.>/?, F1-F12, ESC, Tab, Capslock, shift, ctrl, alt, backspace, enter, insert, delete, home, end, pageup and pagedown.
###SHOULD: Characters commonly needed for shell usage ( Tab,;,",`,{},[],$,| ) are accessible using only one thumb (not counting sticky Fn) in combination with a modifier from the shoulder buttons. (Levi)
###SHOULD: German characters: äöüß (ED)
###SHOULD: two shift keys on main keyboard (ED)
###COULD: different keycodes for different versions of the same keys (T4b: "support" should be a given, it's more about the default layout, isn't it? Did I express it better?)
##what to map to the gaming controls?
##MUST: is usable using non-sticky modifiers in both of the handheld/desktop modes of typing. (clarify!) (T4b: I guess this is similar to 2.3.2, the most important characters shouldn't need sticky modifiers to input)
##MUST NOT: prevents valid regular keyboard combinations from being input (e.g. shift-backspace on the Pandora) (T4b: What's that about again?)
##Mouse emulation:
###MUST: allows mouse motion
###MUST: allows left/right mouse button clicks
###SHOULD: allows middle mouse button clicks (emulation through left mouse + right mouse is acceptable)
###COULD: allow mouse scrolling
##COULD: W-LAN, Bluetooth, etc.

Keyboard/Requirement Analysis Pyra

2014-01-19T16:32:24Z

T4b: Created page with "Discuss [http://boards.openpandora.org/topic/15403-pyra-keyboard-layout-requirement-analysis/ there]. #hardware ##keyboard: ###MUST: allows for both handheld thumb typing and..."

Discuss [http://boards.openpandora.org/topic/15403-pyra-keyboard-layout-requirement-analysis/ there].

#hardware
##keyboard:
###MUST: allows for both handheld thumb typing and desktop finger typing
###MUST: is possible to find the keys by touch (for thumb typing)
####surface form: flat? rounded? concave? (T4b: I would like them to be more or less flat and concave a little bit so you feel the different keys better)
####surface height: (T4b: no higher than on current Pandora, preferably almost (only almost!) flush with the rest of the surface)
####MUST: surface coating: non sticky, fingers must glide over it as easily as possible
####MUST: minimum force needed to trigger key: is possible to slide finger over key without triggering it
###MUST: individual keys easy to press
####maximum force needed to trigger key: must not be so big as to make it difficult to press the key (clarified?) (too obvious to include? But I guess we should also include trivial things)
####maximum way/travel needed to trigger key: (T4b: must be low, say 0.3mm, max 0.5mm)
####room between keys: (T4b: I would like to get rid of it completely, but only technically possible if the plastic ribs between the keys aren't necessary anymore)
####size of individual keys:
#####SHOULD: width is as wide if not wider than the Pandora (ED)
#####MUST: height: is no taller than the Pandora (ED)
###MUST NOT: forces Pyra's dimensions to exceed 1-2mm beyond the Pandora's
###MUST: has easy to read labels:
####colors:
####MUST: high enough contrast -> easy to read
###SHOULD (?): backlighting
####MUST: variable intensity (PWM?) (Levi)
####COULD: variable color
###is possible to map to (generally as many as possible):
####MUST: qwerty/qwertz/azerty (those are basically the same, so we can group them together)
####MUST: dvorak
####COULD: colemak
####COULD: non latin (Russian, Japanese, etc.) (clarify! what's needed for this?)
###MUST NOT: keyboard gets into the way when gaming
####<practical considerations>
##keyboard [b]and[/b] gaming controls:
###MUST: is resistant to foreign matter (pocket lint) from getting into/between the keys: not possible with the Pandora, could be a problem with mechanical keyboards
##gaming controls:
###NOTE: I think the individual action buttons are fine on the Pandora (T4b)
###MUST: 4 action buttons, dpad, 2 shoulder buttons, 2 nubs
###SHOULD: 2 additional shoulder buttons, buttons between nubs
###COULD: x additional action buttons
##cost: well, this should maybe be a poll. (T4b: the keyboard could cost a lot more than CHF9.27 (CHF9.27 ($10)) if it's also considerably better if you ask me)
#software (default key bindings)
##SHOULD: is similar to Pandora's
##SHOULD: is similar to US international qwerty
###SHOULD NOT: break the correlation between a key and its shifted value (e.g. ; and : ) on the US international layout.
##Which keys need to be there?
###MUST: all keys and special characters found on a normal US keyboard layout (0-9,a-z, A-Z, ~!@#$%*()-_=+[{]}\|;:'",<.>/?, F1-F12, ESC, Tab, Capslock, shift, ctrl, alt, backspace, enter, insert, delete, home, end, pageup and pagedown.
###SHOULD: Characters commonly needed for shell usage ( Tab,;,",`,{},[],$,| ) are accessible using only one thumb (not counting sticky Fn) in combination with a modifier from the shoulder buttons. (Levi)
###SHOULD: German characters: äöüß (ED)
###SHOULD: two shift keys on main keyboard (ED)
###COULD: different keycodes for different versions of the same keys (T4b: "support" should be a given, it's more about the default layout, isn't it? Did I express it better?)
##what to map to the gaming controls?
##MUST: is usable using non-sticky modifiers in both of the handheld/desktop modes of typing. (clarify!) (T4b: I guess this is similar to 2.3.2, the most important characters shouldn't need sticky modifiers to input)
##MUST NOT: prevents valid regular keyboard combinations from being input (e.g. shift-backspace on the Pandora) (T4b: What's that about again?)
##Mouse emulation:
###MUST: allows mouse motion
###MUST: allows left/right mouse button clicks
###SHOULD: allows middle mouse button clicks (emulation through left mouse + right mouse is acceptable)
###COULD: allow mouse scrolling
##COULD: W-LAN, Bluetooth, etc.

SD compatibility list

2011-06-18T12:10:52Z

T4b:

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system. Although it is not covered on this list, the Pandora can also read NTFS-formatted SD cards if the [http://www.open-pandora.org/downloads/CodecPack.pnd Community Codec Pack] is installed.

Note: always measure read speed by opening a terminal window and typing this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

By default, the first partition starts at block 8192 (4096KB) for 32GB cards, and block 32768 (16384KB) for 64GB cards. 64GB cards may need to be [[formatting SD cards|reformatted]] before use.

{|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"
! Card size in GB
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|-
| 32
| 10
| Centon 32GB Class 10 SDHC
| [http://www.microcenter.com/single_product_results.phtml?product_id=0335228]
| yes
| ?
| 17.3
| 23.9
| ?
| ok {{HideableNotes|so far, first few hours of use}}
|- style="background: #90Ff90"
| 1
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| 16
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| 32
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| 32
| 10
| Kingston 32GB (red) class 10
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| 32
| 4
| Lexar Multi-Use 32GB
| [http://www.amazon.com/Lexar-Flash-memory-card-Class/dp/B0040J1ET8]
| yes
| yes
| 16.1
| 14.4
| 31267840
| {{HideableNotes|Much faster than would be expected for a class 4 card. Usual warning about high-speed cards being susceptible to power supply glitches applies.}}
|- style="background: #90FF90"
| 64
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| {{HideableNotes|R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.}}[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| 32
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| 4
| 10
| Pretec 4GB, Class 10, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| 32
| 10
| Pretec 32GB class 10, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| 8
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Works nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test its speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|- style="background: #90FF90"
| 32
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| 64
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| 32
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| 32
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| 64
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)

----
<div style="background: #F3F781">yes{{HideableNotes|but look at the notes, not good}}</div>
| no
----
<div style="background: #F3F781">?{{HideableNotes|Might work but didn't really test it long enough}}</div>
| 16.1
----
<div style="background: #F3F781"><=16</div>
| 16.1
----
<div style="background: #F3F781"><=16</div>
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
----
<div style="background: #F3F781">Serious issues{{HideableNotes|My Linux computer can't read it, but that is probably the computer. First formatted it to ext2 while leaving 16MiB free at the beginning because it was like that when I got it. Had 16MB/s r/w. Then started to have problems after writing about 64GB to it, couldn't mount it, reformatted it, no change, reformatted it as Fat32, still no change, reformatted again as fat32, no problems so far but write speed is 0.5MB/s and read speed 14.76MB/s. I let F3 run over it, the speed was measured using it too. --A few weeks later-- It has got variable w/r speed, it drops after a few seconds of writing data to it. Sometimes it gives other errors, stops working until I reboot, etc. It's useable, but I wouldn't buy it again.}}</div>
|- style="background: #FF9090"
| 32
| 6
| Verbatim Class 6 Premium HD Video 32GB SDHC
| [http://www.amazon.co.uk/Verbatim-44032-32GB-Video-Class/dp/B0035MSOX0/ref=sr_1_2?ie=UTF8&s=electronics&qid=1304517332&sr=8-2]
| no
| no
| ?
| ?
| ?
| Behaviour similar to Kingston 32GB Class 4 -[http://www.gp32x.com/board/index.php?/topic/59113-pnd-run-sh/page__view__findpost__p__948196]
|- style="background: #90FF90"
| 32
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

Talk:Screenshot

2011-06-16T15:52:18Z

T4b: Created page with ": chmod ugo+rwx snapsnap.sh : :give executable access to the current user (the one you are logged in as) : : chmod +x snapsnap.sh Why give all users read and write access? If the..."

: chmod ugo+rwx snapsnap.sh
:
:give executable access to the current user (the one you are logged in as)
:
: chmod +x snapsnap.sh
Why give all users read and write access? If they can execute it it should be enough. Then, if you already gave everyone every right, why do you give yourself execution rights again?
A single "chmod a+x snapshot.sh" should do the job. [[User:T4b|T4b]] 17:52, 16 June 2011 (CEST)

Talk:SD compatibility list

2011-05-08T13:22:15Z

T4b: /* Add a column "Tested by"? */ new section

==Other compatibility reports==
mvickers03 has [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__896899 previously reported] on July 25, 2010, that his 16GB Kingston class 4 card "works well"... that seems to be in direct contradiction to this list.

There are also some other reports in that thread that could be added to this list, perhaps. [[User:Esn|Esn]] 04:31, 1 April 2011 (MEST)

Prometheus confirms that the Kingston cards work for her: [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__945184]. But, to quote: "The problem is this: Kingston is a restickering brand - they do not manufacture their own chips, so you have no idea what you will get with any given card.

That is to say, I'm afraid it's completely impossible to confirm for you whether Kingston's cards will work or not, because it changes per card."

Please read the rest of the comment at the above link. [[User:Esn|Esn]] 05:39, 1 April 2011 (MEST)

:So what's the threshold for a card manufacturer to get a yellow rating instead of a red one? If the cards work 50% of the time? 90%? 99%? Also, many people aren't testing the cards thoroughly, just copying a few files and saying "it works". -- [[User:Nyan|Nyan]] 12:36, 1 April 2011 (MEST)
::Well, the way I did it is yellow means that cards work well with one format but not with another. For example, my Patriot 32GB card has worked well with FAT32 over the past few months, but apparently it doesn't work with ext2/3/4. More information should be added in the "notes" column. So I guess "yellow" basically means that you won't have any problems if you choose the right file system. I don't know enough about this to know whether that's a workable definition or not. [[User:Esn|Esn]] 06:19, 3 April 2011 (MEST)
:::Okay, I was just wondering, since you marked nearly all the "problem" cards yellow. Some of these need to be tested further to confirm that the problem really is limited to non-FAT32 filesystems. -- [[User:Nyan|Nyan]] 18:36, 3 April 2011 (MEST)
::::Then that's something that can be mentioned in the "notes", if they haven't been fully tested; these colours are only approximations... I was just getting the ball rolling, really. [[User:Esn|Esn]] 05:11, 4 April 2011 (MEST)

== Change title to "SD compatibility list"? ==

There are also "SDXC" and "SD" cards so I would change the title to the most generic one: SD. [[User:T4b|T4b]] 13:45, 21 April 2011 (MEST)
:I would prefer short titles for the articles as well. Longer titles can be faked by redirect stubs. --[[User:ABC|ABC]] 15:14, 21 April 2011 (MEST)
::Ok, moved and intro edited. [[User:Esn|Esn]] 01:35, 22 April 2011 (MEST)

== Hidden notes ==

Why are a lot of notes hidden behind javascript? There are some browsers which doesn't support it and I hate to click everything just to read a few sentences, clicking there takes at least as long as reading it, rather more. [[User:T4b|T4b]] 21:47, 7 May 2011 (MEST)
:Well, the intention for this wiki is to make the pages look acceptable at a screen width of 800 pixels (as on the Pandora). This does mean that "notes" generally have to be kept pretty short, and hidden behind the HideableNotes template if they're not. Which browsers don't support javascript? I know Links2 doesn't, but that just means that you don't have to click on the note at all because it's all visible anyway. [[User:Esn|Esn]] 07:02, 8 May 2011 (MEST)
:Also, I think most people will just either scroll through the list as a whole, or read the notes for a particular card that they're thinking about buying. [[User:Esn|Esn]] 07:08, 8 May 2011 (MEST)
::Thought the browser which doesn't support it might display nothing at all, but just checked with links2, looks nice. When looking at this table I would like to read all the notes, not just some, because I want to know which classes/brands work better/worse in general, not a specific card. Looking for a specific card would work if this list contained hundreds of entries for the most bought sd cards, which it doesn't at the moment.[[User:T4b|T4b]] 12:51, 8 May 2011 (MEST)

== Add a column "Tested by"? ==

I think it might be a good idea to add a column who tested it, including a way to contact the tester if there are questions.
So you could a) see how many tested a card and b) ask the ones who wrote something like "needs further testing" and never changed it if it now works or not and so on.[[User:T4b|T4b]] 15:22, 8 May 2011 (MEST)

SD compatibility list

2011-05-08T13:15:12Z

T4b: Don't know how to format the table for different result with the same card, feel free to change it again.

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system.

Note: always measure read speed with this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

By default, the first partition starts at block 8192 (4096KB) for 32GB cards, and block 32768 (16384KB) for 64GB cards. 64GB cards may need to be [[formatting SD cards|reformatted]] before use.

{|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"
! SDHC card brand
! Card size in GB
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|- style="background: #90Ff90"
| Kingston
| 1
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| Kingston
| 16
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| Kingston
| 32
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| Kingston
| 32
| 10
| class 10, kingston 32GB (red)
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| Lexar
| 64
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| {{HideableNotes|R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.}}[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| Patriot
| 32
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| Pretec
| 4
| 10
| Class 10, Pretec 4GB, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| Pretec
| 32
| 10
| class 10, Pretec 32GB 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| SanDisk
| 8
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Works nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test its speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|- style="background: #90FF90"
| SanDisk
| 32
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| Sandisk
| 64
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| Topram
| 32
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| Transcend
| 32
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| Transcend
| 64
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)

----
<div style="background: #F3F781">seems to work (needs more testing, {{HideableNotes|I'll update it when I've used it another week}})</div>
| no
----
<div style="background: #F3F781">partly (would need more testing)</div>
| 16.1
----
<div style="background: #F3F781">14.76 (~16 for the first 64GB)</div>
| 16.1
----
<div style="background: #F3F781">0.5 (~16 for the first 64GB)</div>
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
----
<div style="background: #F3F781">{{HideableNotes|My Linux computer can't read it, but that is probably the computer. First formatted it to ext2 while leaving 16MiB free at the beginning because it was like that when I got it. Had 16MB/s r/w. Then started to have problems after writing about 64GB to it, couldn't mount it, reformatted it, no change, reformatted it as Fat32, still no change, reformatted again as fat32, no problems so far but write speed is 0.5MB/s and read speed 14.76MB/s. I let F3 run over it, the speed was measured using it too.}}</div>
|- style="background: #90FF90"
| Zap
| 32
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

Talk:SD compatibility list

2011-05-08T10:51:17Z

T4b:

SD compatibility list

2011-05-07T20:06:59Z

T4b: Sorting didn't work right with the "GB" after the number.

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system.

Note: always measure read speed with this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

{|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"
! SDHC card brand
! Card size in GB
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|- style="background: #90Ff90"
| Kingston
| 1
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| Kingston
| 16
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| Kingston
| 32
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| Kingston
| 32
| 10
| class 10, kingston 32GB (red)
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| Lexar
| 64
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| Patriot
| 32
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| Pretec
| 4
| 10
| Class 10, Pretec 4GB, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| Pretec
| 32
| 10
| class 10, Pretec 32GB 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| SanDisk
| 8
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Works nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test its speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|- style="background: #90FF90"
| SanDisk
| 32
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| Sandisk
| 64
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| Topram
| 32
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| Transcend
| 32
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| Transcend
| 64
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)

----
partly (needs more testing, I'll update it when I've used it another week)
| no
----
partly (would need more testing)
| 16.1
----
still needs to be measured, at the beginning it was 16 too
| 16.1
----
0.5 (~16 for the first 64GB)
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
----
My Linux computer can't read it, but that is probably the computer. First formatted it to ext2 while leaving 16MiB free at the beginning because it was like that when I got it. Had 16MB/s r/w. Then started to have problems after writing about 64GB to it, couldn't mount it, reformatted it, no change, reformatted it as Fat32, still no change, reformatted again as fat32, no problems so far but r/w speed is 0.5MB/s.
|- style="background: #90FF90"
| Zap
| 32
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

SD compatibility list

2011-05-07T20:01:01Z

T4b: Added my Transcend card, has different problems from the other one and they are not as bad. Probably going to send it back though.

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system.

Note: always measure read speed with this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

{|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"
! SDHC card brand
! Card size
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|- style="background: #90Ff90"
| Kingston
| 1GB
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| Kingston
| 16GB
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| Kingston
| 32GB
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| Kingston
| 32GB
| 10
| class 10, kingston 32GB (red)
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| Lexar
| 64GB
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| Patriot
| 32GB
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| Pretec
| 4GB
| 10
| Class 10, Pretec 4GB, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| Pretec
| 32GB
| 10
| class 10, Pretec 32GB 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| SanDisk
| 8GB
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Works nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test its speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|- style="background: #90FF90"
| SanDisk
| 32GB
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| Sandisk
| 64GB
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| Topram
| 32GB
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| Transcend
| 32GB
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| Transcend
| 64GB
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)

----
partly (needs more testing, I'll update it when I've used it another week)
| no
----
partly (would need more testing)
| 16.1
----
still needs to be measured, at the beginning it was 16 too
| 16.1
----
0.5 (~16 for the first 64GB)
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
----
My Linux computer can't read it, but that is probably the computer. First formatted it to ext2 while leaving 16MiB free at the beginning because it was like that when I got it. Had 16MB/s r/w. Then started to have problems after writing about 64GB to it, couldn't mount it, reformatted it, no change, reformatted it as Fat32, still no change, reformatted again as fat32, no problems so far but r/w speed is 0.5MB/s.
|- style="background: #90FF90"
| Zap
| 32GB
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

Talk:SD compatibility list

2011-05-07T19:47:36Z

T4b: /* Hidden notes */ new section

Talk:Mount over ssh

2011-05-05T19:28:12Z

T4b:

Maybe you also have to install some packages over opkg which I've already installed. [[User:T4b|T4b]] 15:16, 16 April 2011 (MEST)
:No, it isn't necessary, also works on a newly flashed firmware. [[User:T4b|T4b]] 21:28, 5 May 2011 (MEST)

Compile on the Pandora

2011-05-05T17:34:21Z

T4b: Added a working and easy way to do it.

== Lazy but working way ==

This is how I, T4b, set up my develepment environment. Of course it is on an SD card, the NAND is way to small. I recommend an 8GB card.
=== Installing the OS to an SD ===
This part was almost only copied from there: http://www.pandorabits.org/index.php?page=sd-installer
#Copy the PND to an SD card in the usual manner. You can get it from [http://www.pandorabits.org/index.php?page=sd-installer-downloads PandoraBits' download page].
#Copy a firmware image to the same card. You can get one from [http://openpandora.org/firmware/ here], the file "pandora-rootfs.tar.bz2" should always be the latest image, older ones are under the "images" directory. I suggest using the newest one, I did it with the (at the moment of writing this) newest one, with HotFix5.
#Ensure that you have both SD cards in Pandora. It doesn't matter which one is in which slot.
#Run the PND. You will probably be asked for your password at this point. This is needed because the installer needs to run as root in order to partition and format the SD card.
#Follow the prompts that appear. You will be asked for the firmware image file, then asked to select the card that you want to use, then asked to choose how much space to allocate to the VFAT (Windows, see below) and swap partitions.
#Once you have gone through all the prompts, the firmware image will be installed to the SD card. This will take upwards of ten minutes. The larger the card, the longer it takes, so be patient.
#Once complete, you will be able to boot your Pandora from the SD card by powering it on with the card in the left slot. Please note that the first boot will take longer than usual, at least ten minutes. Cards of 16 GB or more seem to take a lot longer.
=== Getting the actual development environment ===
No you'll find out why I called it a "lazy" way.
#Download the newest archive from [http://forum.gp2x.de/viewtopic.php?f=24&t=11865 this] thread in the German gp2x.de forum. Use google translator if necessary (at the time of writing this the newest one was [http://kimu.usenet-verwaltung.de/devel-pandora-native-20110411.tar.bz2 this] [direct download])
#Copy it on an SD which you insert into your Pandora
#<source lang="bash">cd /</source>
#<source lang="bash">sudo tar -xjf path/to/archive.tar.bz2</source>
#Reboot
Done!

== Torpor's way ==
torpor described how to [http://www.gp32x.com/board/index.php?/topic/53964-cross-compiling-is-bollocks-toolchains-are-bollocks-use-your-pandora-to-build-apps/ build apps directly on the Pandora].

{{warning
|Please note that as of March 2011, you will break your install if you follow those instructions directly! The angstrom "unstable" distribution is well named.
}}

You can try the following:

1. I found that the www.angstrom-distribution.org repo was very slow, so changed the config files in /etc/opkg/ to use us.feeds.angstrom-distribution.org instead.

2. Enable sshd, and ssh in from another machine. This helps keep control when things break. To get root:

<source lang="bash">sudo bash</source>

3. Set up a [http://pandorawiki.org/Extend_Utils#Creating_a_Root_or_Home_Overlay_PreMount root overlay] on your SD card. This gives you a way to try again when things break, and there are other benefits. I added /home/ to the overlay also, by editing the "premount" script. To explain the extend terminology a bit, a "root overlay" is a loop mounted filesystem (on an SD) which goes over the top of (most of) your normal root filesystem. You can still read the files underneath it, but any writes / deletes are recorded only in the overlay filesystem. Your real root on the NAND is not modified at all. The "premount" shell script is used to mount your overlay, have a look in it to see how it works. You can sort of unmount them using umount -l (lazy umount), but I'm not sure if this is safe. The reliable way to unmount it is to reboot the Pandora!

4. Mount the overlay. Check this worked, with "mount" or "df".

5. Get new fresh package lists:

<source lang="bash">opkg update</source>

6. ncurses packaging seems to be broken, and ncurses is important! So, I suggest to do this first (in the overlay), or be prepared for things to start breaking when it gets removed later. If it does get removed, make sure to install it again!

<source lang="bash">opkg install libncurses5</source>

7. Install dev packages:

<source lang="bash">opkg install gcc gcc-symlinks make-dev binutils-dev cpp cpp-symlinks g++ g++-symlinks libstdc++-dev</source>

8. Try to compile "hello world". Mine didn't find libgcc_s, this fixed it:

<source lang="bash">
opkg install libgcc1 # not sure if this was needed
ln -s /lib/libgcc_s.so.1 /usr/lib/gcc/arm-angstrom-linux-gnueabi/4.3.3/libgcc_s.so
</source>

9. I had trouble with libsdl-image-1.2-dev and libpng / libpng-dev. libpng-dev from the repo conflicts with 'libpng' on the Pandora. That latter package is misnamed I guess, it should be called 'libpng-dev', only contains libpng-config and libpng12-config (dev tools, not essential) but task-pandora-core depends on it. The real libs are in libpng12-0 / libpng3. So I did this:
<source lang="bash">
opkg remove libpng --force-depends
opkg install libpng-dev
</source>

10. Install extra dev libs:
<source lang="bash">
opkg install libgles-omap3-dev
opkg install libsdl-1.2-dev libsdl-gfx-dev libsdl-image-1.2-dev libsdl-mixer-1.2-dev libsdl-net-1.2-dev libsdl-ttf-2.0-dev
</source>

Hopefully this will go smoothly if you've fixed the png conflict in step 9.

11. Install optional extra stuff, if you want them:
<source lang="bash">
opkg install vim vim-syntax
opkg install libgles-omap3-demos
opkg install screen git rsync
</source>

The above was from memory, I didn't re-test all of it because it took too long even the first time! If you find other problems or quirks, please correct it.

After all this, I was able to build torpor's suggested dev demo app, [http://w1xer.at/pandora/ WakeBreaker].

[[Category:Development]]
[[Category:Tutorials]]

User manual

2011-04-30T21:50:45Z

T4b: /* Replacing the Firmware */ Changed "replacing" to reinstalling"

{{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. <br/>We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

{{split section|Page to large, bad for categories, linking topics,....}}

[[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.<br>The Pandora contains small parts that can be eaten by those children.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|Modifications to [[hardware]] ([[Hardware hacking]]) 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.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|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 ([[nubs]])
* 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 ([[nubs]])
* 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.

{{warning
|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 [[First 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===

===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. Pressing 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 [[.png]] 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 [[shoulder 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 hours 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 ===
Connecting to [[Bluetooth]] devices is easy using the tool located in the Xfce taskbar.

For help with setting up a [[Bluetooth]] GPS, see [[GPS#Bluetooth_GPS | here]].

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

== 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]). '''As of [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ Hotfix 5]''', GCalcTool is also included, while Abiword, Gnumeric, Clawsmail and Pidgin have been removed (you can download them from [[software projects|here]] instead).
{{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.

*On [http://repo.openpandora.org repo.openpandora.org] there is a nice [[PND]]-Repository, using [[PNDstore]] you can also automatically update all your [[PND]]s or install new ones directly on the Pandora.

*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].

*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 Pandora includes the package manager [[opkg]], which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. This will install to your Pandoras [[NAND]] by default and can cause severe problems because the version of Angstrom which is used on the Pandora is too old - only use it if you know exactly what you're doing! Type "df -h" in the terminal to see how much space you have left - you shouldn't fill it completely, you might not even be able to login when it is completely full (I'm quite sure you can't, although I might be wrong).

*You could also download .ipk files directly from the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], but these are actually the same as if you would install them using [[opkg]] (see above), have the same problems as if using [[opkg]] and the additional annoyance that dependencies aren't resolved automtically. There are different .ipk files for every program, the right ones are the armv7a ones from 2008.

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

{{warning|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).''}}

==== 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 or Linux /media/something). 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 (this one isn't really needed, [[PND]]s can save there settings and stuff there, it will automatically be created when a [[PND]] wants to save something), 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).

==== Reinstalling 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:Documentation]]

User manual

2011-04-30T21:48:33Z

T4b: /* Installing a PND file (an application) */

{{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. <br/>We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

{{split section|Page to large, bad for categories, linking topics,....}}

[[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.<br>The Pandora contains small parts that can be eaten by those children.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|Modifications to [[hardware]] ([[Hardware hacking]]) 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.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|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 ([[nubs]])
* 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 ([[nubs]])
* 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.

{{warning
|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 [[First 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===

===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. Pressing 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 [[.png]] 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 [[shoulder 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 hours 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 ===
Connecting to [[Bluetooth]] devices is easy using the tool located in the Xfce taskbar.

For help with setting up a [[Bluetooth]] GPS, see [[GPS#Bluetooth_GPS | here]].

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

== 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]). '''As of [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ Hotfix 5]''', GCalcTool is also included, while Abiword, Gnumeric, Clawsmail and Pidgin have been removed (you can download them from [[software projects|here]] instead).
{{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.

*On [http://repo.openpandora.org repo.openpandora.org] there is a nice [[PND]]-Repository, using [[PNDstore]] you can also automatically update all your [[PND]]s or install new ones directly on the Pandora.

*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].

*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 Pandora includes the package manager [[opkg]], which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. This will install to your Pandoras [[NAND]] by default and can cause severe problems because the version of Angstrom which is used on the Pandora is too old - only use it if you know exactly what you're doing! Type "df -h" in the terminal to see how much space you have left - you shouldn't fill it completely, you might not even be able to login when it is completely full (I'm quite sure you can't, although I might be wrong).

*You could also download .ipk files directly from the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], but these are actually the same as if you would install them using [[opkg]] (see above), have the same problems as if using [[opkg]] and the additional annoyance that dependencies aren't resolved automtically. There are different .ipk files for every program, the right ones are the armv7a ones from 2008.

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

{{warning|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).''}}

==== 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 or Linux /media/something). 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 (this one isn't really needed, [[PND]]s can save there settings and stuff there, it will automatically be created when a [[PND]] wants to save something), 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:Documentation]]

User manual

2011-04-30T21:42:29Z

T4b: /* Where Can I Get More Apps? */ Added link to repo.openpandora.org, changed/added other stuff,...

{{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. <br/>We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

{{split section|Page to large, bad for categories, linking topics,....}}

[[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.<br>The Pandora contains small parts that can be eaten by those children.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|Modifications to [[hardware]] ([[Hardware hacking]]) 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.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|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 ([[nubs]])
* 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 ([[nubs]])
* 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.

{{warning
|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 [[First 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===

===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. Pressing 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 [[.png]] 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 [[shoulder 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 hours 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 ===
Connecting to [[Bluetooth]] devices is easy using the tool located in the Xfce taskbar.

For help with setting up a [[Bluetooth]] GPS, see [[GPS#Bluetooth_GPS | here]].

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

== 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]). '''As of [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ Hotfix 5]''', GCalcTool is also included, while Abiword, Gnumeric, Clawsmail and Pidgin have been removed (you can download them from [[software projects|here]] instead).
{{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.

*On [http://repo.openpandora.org repo.openpandora.org] there is a nice [[PND]]-Repository, using [[PNDstore]] you can also automatically update all your [[PND]]s or install new ones directly on the Pandora.

*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].

*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 Pandora includes the package manager [[opkg]], which is a fork of [http://en.wikipedia.org/wiki/Ipkg ipkg]. This will install to your Pandoras [[NAND]] by default and can cause severe problems because the version of Angstrom which is used on the Pandora is too old - only use it if you know exactly what you're doing! Type "df -h" in the terminal to see how much space you have left - you shouldn't fill it completely, you might not even be able to login when it is completely full (I'm quite sure you can't, although I might be wrong).

*You could also download .ipk files directly from the [http://www.angstrom-distribution.org/repo Angstrom ARM Repository], but these are actually the same as if you would install them using [[opkg]] (see above), have the same problems as if using [[opkg]] and the additional annoyance that dependencies aren't resolved automtically. There are different .ipk files for every program, the right ones are the armv7a ones from 2008.

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

{{warning|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).''}}

==== 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:Documentation]]

User manual

2011-04-30T21:19:20Z

T4b: /* Power modes */ Changed "weeks" to "hours", as it says the battery lasts 20-30 hours in low power mode on 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. <br/>We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

{{split section|Page to large, bad for categories, linking topics,....}}

[[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.<br>The Pandora contains small parts that can be eaten by those children.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|Modifications to [[hardware]] ([[Hardware hacking]]) 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.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|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 ([[nubs]])
* 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 ([[nubs]])
* 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.

{{warning
|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 [[First 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===

===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. Pressing 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 [[.png]] 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 [[shoulder 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 hours 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 ===
Connecting to [[Bluetooth]] devices is easy using the tool located in the Xfce taskbar.

For help with setting up a [[Bluetooth]] GPS, see [[GPS#Bluetooth_GPS | here]].

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

== 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]). '''As of [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ Hotfix 5]''', GCalcTool is also included, while Abiword, Gnumeric, Clawsmail and Pidgin have been removed (you can download them from [[software projects|here]] instead).
{{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)

{{warning|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:Documentation]]

User manual

2011-04-30T21:14:51Z

T4b: /* The main grid */ I guess this should be ".png"

{{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. <br/>We can always use more help, look [[Getting_involved#The_Wiki | here]] to find out how you can get involved.}}

{{split section|Page to large, bad for categories, linking topics,....}}

[[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.<br>The Pandora contains small parts that can be eaten by those children.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|Modifications to [[hardware]] ([[Hardware hacking]]) 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.
}}

{{warning
|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.
}}

{{warning
|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.
}}

{{warning
|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 ([[nubs]])
* 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 ([[nubs]])
* 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.

{{warning
|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 [[First 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===

===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. Pressing 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 [[.png]] 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 [[shoulder 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 ===
Connecting to [[Bluetooth]] devices is easy using the tool located in the Xfce taskbar.

For help with setting up a [[Bluetooth]] GPS, see [[GPS#Bluetooth_GPS | here]].

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

== 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]). '''As of [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ Hotfix 5]''', GCalcTool is also included, while Abiword, Gnumeric, Clawsmail and Pidgin have been removed (you can download them from [[software projects|here]] instead).
{{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)

{{warning|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:Documentation]]

SD compatibility list

2011-04-28T20:11:16Z

T4b:

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system.

Note: always measure read speed with this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

{|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"
! SDHC card brand
! Card size
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|- style="background: #90Ff90"
| Kingston
| 1GB
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| Kingston
| 16GB
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| Kingston
| 32GB
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| Kingston
| 32GB
| 10
| class 10, kingston 32GB (red)
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| Lexar
| 64GB
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| Patriot
| 32GB
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| Pretec
| 4GB
| 10
| Class 10, Pretec 4GB, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| Pretec
| 32GB
| 10
| class 10, Pretec 32GB 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| SanDisk
| 32GB
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| Sandisk
| 64GB
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| Topram
| 32GB
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| Transcend
| 32GB
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| Transcend
| 64GB
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)
| no
| 16.1
| 16.1
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
|- style="background: #90FF90"
| Zap
| 32GB
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|- style="background: #90FF90"
| SanDisk
| 8GB
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Works nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test it's speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

SD compatibility list

2011-04-28T20:10:01Z

T4b: Added a card I bought

This is a compatibility list for SD, SDHC and SDXC cards. The cards listed in '''green''' work with any file system. The cards listed in '''yellow''' work well only with one file system (this still means they can be used on the Pandora). The cards listed in '''red''' do not work well with any file system.

Note: always measure read speed with this command:
* in left slot: '''dd if=/dev/mmcblk0 of=/dev/null bs=4MiB count=100'''
* in right slot: '''dd if=/dev/mmcblk1 of=/dev/null bs=4MiB count=100'''

If you can afford '''''destroying''''' all your data, you can test write speed. But be careful, you will need to create a new partition table, afterwards! You can use [http://www.gp32x.com/board/index.php?/topic/56915-gparted/ Gparted] to make new partition table.
* in left slot: # '''dd if=/dev/zero of=/dev/mmcblk0 bs=4MiB count=100'''
* in right slot: # '''dd if=/dev/zero of=/dev/mmcblk1 bs=4MiB count=100'''

{|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"
! SDHC card brand
! Card size
! Card class
! Full name
! URL
! fat32 is working?
! ext2/3/4 are working?
! read speed MB/sec
! write speed MB/sec
! actual capacity (1024byte blocks)
! Notes
|- style="background: #90Ff90"
| Kingston
| 1GB
| ?
| Kingston 1GB (blue)
| [http://www.komputronik.pl/index.php/product/26645/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_2GB_Kingston.html] {{HideableNotes|(looks very similar to that one, except that I have 1GB)}}
| yes
| yes
| 12.5
| ?
| 1006080
| ok
|- style="background: #FF9090"
| Kingston
| 16GB
| 4
| Kingston 16 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-16GB/dp/B0013AV9TW]
| no
| no
| 15
| 9.5
| 15663104
| {{HideableNotes|Bad controller chip, fails in the same manner as the 32GB card.}}
|- style="background: #FF9090"
| Kingston
| 32GB
| 4
| Kingston 32 GB Class 4 SDHC
| [http://www.amazon.com/Kingston-Class-Memory-SD4-32GB/dp/B001C9P5TO]
| no
| no
| 16
| 9.5
| 31539200
| {{HideableNotes|Defective flash controller randomly loses writes regardless of filesystem. When attempting to write, blocks sometimes get erased but not written.}}
|- style="background: #F3F781"
| Kingston
| 32GB
| 10
| class 10, kingston 32GB (red)
| [http://images.google.com/images?q=class+10+kingston+32GB] like this, but 32GB: [http://www.komputronik.pl/index.php/product/101490/Sprzet_komputerowy/Podzespoly_PC/Secure_Digital_16GB_Kingston_High_Capacity_Class_10.html]
| yes
| no
| 15.2
| ?
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| Lexar
| 64GB
| 10
| Lexar Professional 64GB 133x
| [http://www.amazon.com/Lexar-Professional-Flash-memory-Memory/dp/B004QWRZWY]
| yes
| yes
| 19.6
| 15.1
| 62536704
| R/W speed in the pandora is limited to 16.1/11.3 MB/sec. High power consumption, may fail under load.[http://boards.openpandora.org/index.php?/topic/2556-32gb-sdhc-card-problems/page__st__40]
|- style="background: #F3F781"
| Patriot
| 32GB
| 10
| Patriot LX 32GB SDHC Class 10 (PSF32GSDHC10)
| [http://www.bestdirect.ca/products/227442/Patriot/PSF32GSDHC10/] [http://www.amazon.ca/gp/product/B002TABU5I/]
| yes
| no
| 18.1
| 12.6
| ?
| {{HideableNotes|Formatting EXT2 and then running fsck right after finds errors. Seems to work well with fat32}}
|- style="background: #90Ff90"
| Pretec
| 4GB
| 10
| Class 10, Pretec 4GB, 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+4GB+233x]
| yes
| yes {{HideableNotes| I had very few fsck problems, and after several tries running fsck, they eventually got corrected.}}
| 14.0
| ?
| 3883008
| {{HideableNotes|It looks very similar to that broken 32GB pretec. Except that this one almost works good.}}
|- style="background: #F3F781"
| Pretec
| 32GB
| 10
| class 10, Pretec 32GB 233x (white/green)
| [http://images.google.com/images?q=class+10+pretec+32GB+233x]
| yes
| no
| 14.1
| 12.4
| ?
| {{HideableNotes|doesn't have badblocks, seems that "Flash Translation Layer" is not suitable for ext filesystems}}
|- style="background: #90FF90"
| SanDisk
| 32GB
| 4
| SanDisk Ultra 32 GB Class 4 SDHC
| [http://www.sandisk.com/products/imaging/sandisk-ultra-sdhc]
| yes
| yes
| 16.4
| 7.1
| 31166976
| OK.
|- style="background: #90FF90"
| Sandisk
| 64GB
| 4
| Sandisk 64GB SDXC Class 4
| [http://www.amazon.com/SanDisk-Secure-Digital-Capacity-Memory/dp/B003FVG3PC/]
| yes
| yes
| 16.1
| 4.5
| 62367744
| Works fine
|-
| Topram
| 32GB
| 6
| TOPRAM 32GB CLASS 6 SDHC HIGH SPEED (TRSD32GSDHCR3)
| [http://www.buy.com/prod/topram-32gb-class-6-sdhc-high-speed-flash-memory-card-usb-2-0-sdhc/q/loc/101/210247368.html]
| ?
| ?
| ?
| ?
| ?
| Reported working [http://www.gp32x.com/board/index.php?/topic/55506-recommended-sd-cards-for-pandora/page__view__findpost__p__897478 here].
|- style="background: #FF9090"
| Transcend
| 32GB
| 10
| Transcend 32GB SDHC Class 10
| [http://www.amazon.co.uk/Transcend-Flash-memory-card-Class/dp/B003P3MCXW/ref=sr_1_1?ie=UTF8qid=1301320598sr=8-1]
| no
| no
| ?
| ?
| ?
| Has serious issues [http://boards.openpandora.org/index.php?/topic/1592-sd-card-instability/]
|- style="background: #FF9090"
| Transcend
| 64GB
| 10
| Transcend SDXC Card 64GB ULTIMATE CLASS 10 (PN:TS64GSDXC10)
| [http://www.transcendusa.com/Products/ModDetail.asp?ModNo=286&LangNo=0&Func1No=1&Func2No=13]
| yes (needs more testing)
| no
| 16.1
| 16.1
| ?
| {{HideableNotes|After some time the system gives read/write errors. Works fine on a pc with linux with ext2/ext3.}}
|- style="background: #90FF90"
| Zap
| 32GB
| 4
| Zap Glider 32GB Class 4
| [http://www.teknikmagasinet.se/db.pl?tf=product.html&artnr=181043]
| ?
| yes
| 16.6
| 4.6
| ?
| Works fine
|- style="background: #90FF90"
| SanDisk
| 8GB
| 10
| SanDisk SDHC Extreme 30MB Edition
| [http://www.amazon.de/SanDisk-SDHC-Extreme-Speicherkarte-30MB/dp/B001G87S1Y/ref=sr_1_2?ie=UTF8&qid=1304020731&sr=8-2]
| yes
| yes
| ?
| ?
| ?
| Work nice. {{HideableNotes|Installed Angstrom on it and copied some stuff onto it. Angstrom runs as fast as from NAND. Best thing was, where I ordered it it said class 6, but it is actually 10. :-D Still have to test it's speed and actual size. Didn't test Fat a lot, but it seemed to work.}}
|}

[[Category:Hardware]]
[[Category:List]]
[[Category:Storage card]]

Talk:USB reference

2011-04-26T11:04:18Z

T4b:

I changed all Mini A, standard USB A etc. mentions into mini-A, standard-A etc. as they appear in the various USB standard documents. I also corrected all instances where plug names etc. were wrong and clarified some things. I spent quite some time in the last few weeks reading the USB docs so I have some confidence that I got most of this crap sorted out... [[User:OrR|OrR]]

== Move Request ==

Hi, this is not a reference in meaning of "all informations or devices related to USB", so to me it seem to be wise to move this to a FAQ, that it is already. What does you say? --[[User:ABC|ABC]] 07:39, 24 April 2011 (MEST)
:Why not, but then you need to change the "Pandora as USB slave", ... parts to answers to questions too, like "What can my Pandora do as a Slave?" or something like that. [[User:T4b|T4b]] 13:04, 26 April 2011 (MEST)

PND Cookbook

2011-04-23T17:13:25Z

T4b: Corrected <source> tag

=== Using a start-up script ===
In an ideal world, your application will be completely self-contained and can be run directly without any kind of set-up. It is however often necessary to tweak settings or request input from the user before starting your application. This is easily achieved by having the [[PND]] specify a shell script as its executable, which then in turn runs the application. The general structure of such a script is:
<source lang="bash">
#!/bin/sh

# Do stuff here...

./my_app

# Clean-up
</source>
The first line identifies the file as a shell script, run using "/bin/sh" as the shell. The other lines beginning with a "#" are comments. Before the application is started, parameters can be gathered and/or set. The application itself then gets run by the "./my_app" line, which means "execute the file ''my_app'' in the current directory". When the application exits, it may be necessary to restore previous settings, delete temporary files, or perform some other kinds of cleaning up.

=== Avoiding NAND writes by setting $HOME ===
Many applications write configuration data to the user's home directory by default. This is not desirable on the Pandora as this directory resides on the [[NAND]] filesystem. It is however often possible to fool an application into writing to a different directory by setting the $HOME environment variable.
<source lang="bash">
export HOME=`pwd`
export HOME=$(pwd)
</source>

=== Providing a default configuration ===
If your application uses a configuration file, you'll usually want to include this in the PND. However, if you simply leave this file in the root of the PND, it will effectively be read-only, preventing the application or user from writing to it. A simple solution is to provide a default configuration file with a different name, and copy this the first time the application is run. The file will then be created under ''appdata'', and can therefore easily be edited.
<source lang="bash">
# Method 1: check if file exists, otherwise copy default.
if [ ! -f app.conf ] ; then
cp default.conf app.conf
fi

# Method 2: Same as above, less typing.
[ -f app.conf ] || cp default.conf app.conf

# Method 3: using a non-destructive copy.
cp --no-clobber default.conf app.conf
</source>

==== Nub Configuration ====
This is a little (but not much!) lengthier - see the page on [[PND nub modes]].

=== Making writable directories ===
If your application requires that directories be writable for the application, don't put them in the PND, but create them at run-time:
<source lang="bash">
# Bad! This will cause an error after the first run, as the directory will already exist.
mkdir saved_data

# Better to use "-p" which won't complain about existing directories.
mkdir -p saved_data

# Added bonus: this allows you to create whole trees in one go.
mkdir -p saved_data/foo saved_data/bar/with/deep/sub/dirs
</source>

=== Loading shared libraries ===
If your application requires shared libraries which aren't part of the standard firmware, they can be included in the PND along with the executable. In order for the system to be able to find the libraries, it must be told which directories to search. This can be done by setting the LD_LIBRARY_PATH environment variable. For example:
<source lang="bash">
export LD_LIBRARY_PATH=`pwd` # Load libraries in the root directory of the PND.
export LD_LIBRARY_PATH=`pwd`/libs # Load libraries in the "libs" subdirectory of the PND.
</source>

=== Getting a file/directory from the user ===
Its often necessary to ask the user for the location of a file or directory. This may be because your application requires files which aren't included in the PND itself, or simply because you application doesn't have a built in file picker. The commands below will prompt the user for a file, then run "my_app" with that file as an argument. Note the use of different sorts of quotes which is important for proper operation and handling spaces in file names.
<source lang="bash">
FILE="`zenity --file-selection --title='Select a File'`"
./my_app "$FILE"
</source>

=== Saving a file/directory name ===
If your application always asks for a file at start-up, it's handy to remember the location for next time. This can be done by writing the name of the directory to a file in appdata, and reading it back next time the application is run.
<source lang="bash">
SAVEDIR=./dir.saved # Name of the file we'll save the directory name to

# Did we save a directory last time? If so, read it into a variable.
DIR=`cat $SAVEDIR 2> /dev/null`

# Remember where we are right now, as we'll need to come back later.
PNDDIR=`pwd`

# Does the directory still exist?
if [ -d "$DIR" ] ; then
# Yes, go to that directory before Zenity is started.
cd "$DIR"
else
# No, try to go to /media (where the SD cards are mounted)
# or if that fails, go to "/" as a last resort.
cd /media 2> /dev/null || cd /
fi

# Get a file name form the user. Our current directory is now that which
# was saved, so that's where Zenity will start.
FILE=`zenity --file-selection --title="Select a file"`

# If the file selector failed, or the user hit cancel, exit now.
[ $? -eq 0 ] || exit 1;

# Go back to the PND's mount point.
cd $PNDDIR

# Save the file's directory for next time.
dirname "$FILE" > $SAVEDIR

# Run our app with the file as an argument.
./my_app "$FILE"
</source>

=== Checking a file's contents ===
Maybe your application requires some file which cannot be distributed with the PND, either for legal reasons or due to size limitations. A prime example of this is BIOS files used for emulators. Simply copying the file to the current directory will be enough to save it to your program's appdata, but it can also be useful to check the contents of the file are indeed what your application expects.

One way of doing this is to check the file's contents using a hash. A hash is a mathematical formula which can be used to create a "fingerprint" of a file. Two identical files will always generate the same hash value, so knowing this one value is enough to check if two files match. The MD5 hash is a popular choice, and can be easily generated for a given file like so:
<source lang="bash">
$ md5sum bios.img
cfcfd01f1b0dfa97f07cb286b2942dc2 bios.img
</source>

Save this output to a text file named ''bios.md5'' and put it in your PND root directory. The following commands can then be used in your start-up script to copy a file specified by the user, and check it's hash.

<source lang=bash>
BIOS=bios.img # The name of our BIOS file

# Check if the BIOS file already exists.
if [ ! -f ./$BIOS ] ; then
# Not found, so get a file name from the user.
cp "`zenity --file-selection --title="Select your $BIOS file"`" $BIOS
if [ $? != 0 ] ; then
# User hit cancel, bail out.
zenity --error --text="Sorry, emulator cannot run without a BIOS file."
exit 1
fi

# Check the MD5 hash of the given file against our known-good value.
# If the match fails, ask the user if they'd like to try it anyway.
md5sum -c bios.md5 || zenity --question \
--text="BIOS does not appear to be the correct version. Use it anyway?"

if [ $? != 0 ] ; then
# File did not match hash, and the user opted not to try it anyway,
# so remove the copied file and bail out.
rm -f $BIOS
exit 1
fi
fi

# Run our emulator with the BIOS file as an argument.
./my_emu "$BIOS"
</source>

[[Category:PND]]
[[Category:Development]]
[[Category:Tutorial]]

Talk:SD compatibility list

2011-04-21T11:45:21Z

T4b:

Talk:SD compatibility list

2011-04-21T11:45:07Z

T4b: /* Change title to "SD compatibility list"? */ new section

Wireless from the Terminal

2011-04-17T19:46:02Z

T4b: Replaced WiFi with WLAN

Sometimes, you may wish to bypass network manager and configure the WLAN directly. Here is described how to do this.

===Becoming Root===
* You'll need to be root for pretty much everything here.
sudo -i

===Killing NetworkManager===
* A good first step is to just stop NetworkManager, so it doesn't conflict with what we're doing now.
/etc/init.d/NetworkManager stop

===Optional: Disabling NetworkManager===
You may want to completely disable NetworkManager. Here's how.

* This will remove NetworkManager from startup.
update-rc.d -f NetworkManager remove
* This will add it back.
update-rc.d NetworkManager defaults

===Configuring wpa_supplicant===
wpa_supplicant is generally used for connecting using WPA, but I find it pretty convenient even on it's own. It'll also be easier to explain for 1 thing rather than explaining this and iwconfig. It also seems to start by default with the Pandora, but I honestly can't determine what starts it, just that it does.

* Anyway, wpa_supplicant needs to be configured. It's default config file is found in /etc/wpa_supplicant.conf. Here's a basic configuration file that should work with most home routers with WPA. If you have no encryption, set key_mgmt to NONE and remove the psk= line. If you have WEP, key_mgmt should also be NONE and psk= should be removed and replaced with wep_key0= followed by the HEXADECIMAL wep key. You'll need some kind of converter to go from an ASCII key to a HEX key. Here's one, be safe and make sure you don't use the key for anything else important, since you're entering it in to another site: [http://www.speedguide.net/wlan_key.php WEP key converter]
network={
	ssid="Access Point SSID goes here"
	scan_ssid=1
	key_mgmt=WPA-PSK
	psk="password goes here"
}

* A good idea now would be to reboot, to make sure everything is clean. You may need to kill NetworkManager again afterwards, then toggle WLAN off then on (Menu -> System -> Toggle WiFi). You can also make wpa_supplicant reload it's configuration without rebooting:
wpa_cli
* Then type at the prompt
reconfigure

wpa_cli is also good to check the status of wpa_supplicant when you're trying to connect. It'll spit out messages based on what's going on while you're toggling WLAN on and off to see if it's associated or just times out.
If wpa_cli outputs "Could not connect to wpa_supplicant - retrying" you need to enable WLAN via "Main Menu"->"System"->"Toggle WiFi" first.
===Setting Up the Network===
Once you have a connection to the access point, you need to set up a few things either manually or through DHCP.

* To check for connection, if you have wpa_cli running, you can see it's output when you're toggling WLAN on. It'll either say it's Associated, which means it succeeded or that it's timed out, which means it failed, or possibly any other number of errors. You can also check iwconfig.
iwconfig
* If it says Access Point:Not-Associated after about 30 seconds, that means it has likely failed. If you see a 12 digit hex string, that means it has found the access point and has an active connection to it.

====Automatic====
* If you trust DHCP to work, you can just try this.
udhcpc -i wlan0

If all goes well, everything will be properly configured and you'll be on the net. Otherwise you should try to do it manually (see below).

====Manual====
Here are the commands you need to enter to configure the network manually.

* This is optional, but I put it anyway, just in case it causes some kind of trouble.
ifconfig usb0 down
* This disables power management, which can help a dodgy WLAN connection.
iwconfig wlan0 power off
* This limits the rate to 11Mbit, which also can help an unstable WLAN connection.
iwconfig wlan0 rate 11M auto
* Set the IP, broadcast and netmask all at once.
ifconfig wlan0 192.168.1.150/24
* If your network is weird, here's an alternate, more specific line.
ifconfig wlan0 192.168.1.150 broadcast 192.168.1.255 netmask 255.255.255.0
* Add the route to the gateway.
route add default gw 192.168.1.1

Replace 192.168.1.1 with your gateway IP (You can get this from one of your other computers on the network. Linux: ifconfig Windows: ipconfig /all) and 192.168.1.150 with the IP you'd like your Pandora to be. There are a few caveats here, though. Simply put, the subnet needs to be the same as your gateway's subnet. So if it's 192.168.X.Y, it needs to start with 192.168.X or if it's 10.0.0.1, it needs to start with 10. Also for 10.0.0.1, the /24 needs to be /8. There's a bunch of other stuff to do with that, and many odd variations on it, but I'm sure there's a better reference for it elsewhere.

* One last thing you'll need to do is set up DNS name servers. You can get this information from another computer on the network with a working Internet connection.
=====Linux=====
cat /etc/resolv.conf
* Copy that file verbatim in to the /etc/resolv.conf on the Pandora.

=====Windows=====
ipconfig /all
* There should be a line for Primary DNS Server and possibly Secondary DNS Server. They should be entered in to /etc/resolv.conf like this.
nameserver Primary.DNS.Server.IP
nameserver Secondary.DNS.Server.IP

If there is no secondary DNS server, don't worry, just enter only the first line, then.

References:
[http://wiki.archlinux.org/index.php/Wpa_supplicant]
[http://wiki.archlinux.org/index.php/Wireless#Manual_setup]
[http://wiki.archlinux.org/index.php/AutoWLAN]

[[Category:Tutorials]]

Wireless from the Terminal

2011-04-17T18:51:35Z

T4b:

Sometimes, you may wish to bypass network manager and configure the WiFi directly. Here is described how to do this.

===Becoming Root===
* You'll need to be root for pretty much everything here.
sudo -i

===Killing NetworkManager===
* A good first step is to just stop NetworkManager, so it doesn't conflict with what we're doing now.
/etc/init.d/NetworkManager stop

===Optional: Disabling NetworkManager===
You may want to completely disable NetworkManager. Here's how.

* This will remove NetworkManager from startup.
update-rc.d -f NetworkManager remove
* This will add it back.
update-rc.d NetworkManager defaults

===Configuring wpa_supplicant===
wpa_supplicant is generally used for connecting using WPA, but I find it pretty convenient even on it's own. It'll also be easier to explain for 1 thing rather than explaining this and iwconfig. It also seems to start by default with the Pandora, but I honestly can't determine what starts it, just that it does.

* Anyway, wpa_supplicant needs to be configured. It's default config file is found in /etc/wpa_supplicant.conf. Here's a basic configuration file that should work with most home routers with WPA. If you have no encryption, set key_mgmt to NONE and remove the psk= line. If you have WEP, key_mgmt should also be NONE and psk= should be removed and replaced with wep_key0= followed by the HEXADECIMAL wep key. You'll need some kind of converter to go from an ASCII key to a HEX key. Here's one, be safe and make sure you don't use the key for anything else important, since you're entering it in to another site: [http://www.speedguide.net/wlan_key.php WEP key converter]
network={
	ssid="Access Point SSID goes here"
	scan_ssid=1
	key_mgmt=WPA-PSK
	psk="password goes here"
}

* A good idea now would be to reboot, to make sure everything is clean. You may need to kill NetworkManager again afterwards, then toggle wifi off then on (Menu -> System -> Toggle WiFi). You can also make wpa_supplicant reload it's configuration without rebooting:
wpa_cli
* Then type at the prompt
reconfigure

wpa_cli is also good to check the status of wpa_supplicant when you're trying to connect. It'll spit out messages based on what's going on while you're toggling WiFi on and off to see if it's associated or just times out.
If wpa_cli outputs "Could not connect to wpa_supplicant - retrying" you need to enable Wifi via "Main Menu"->"System"->"Toggle WiFi" first.
===Setting Up the Network===
Once you have a connection to the access point, you need to set up a few things either manually or through DHCP.

* To check for connection, if you have wpa_cli running, you can see it's output when you're toggling wifi on. It'll either say it's Associated, which means it succeeded or that it's timed out, which means it failed, or possibly any other number of errors. You can also check iwconfig.
iwconfig
* If it says Access Point:Not-Associated after about 30 seconds, that means it has likely failed. If you see a 12 digit hex string, that means it has found the access point and has an active connection to it.

====Automatic====
* If you trust DHCP to work, you can just try this.
udhcpc -i wlan0

If all goes well, everything will be properly configured and you'll be on the net. Otherwise you should try to do it manually (see below).

====Manual====
Here are the commands you need to enter to configure the network manually.

* This is optional, but I put it anyway, just in case it causes some kind of trouble.
ifconfig usb0 down
* This disables power management, which can help a dodgy wifi connection.
iwconfig wlan0 power off
* This limits the rate to 11Mbit, which also can help an unstable wifi connection.
iwconfig wlan0 rate 11M auto
* Set the IP, broadcast and netmask all at once.
ifconfig wlan0 192.168.1.150/24
* If your network is weird, here's an alternate, more specific line.
ifconfig wlan0 192.168.1.150 broadcast 192.168.1.255 netmask 255.255.255.0
* Add the route to the gateway.
route add default gw 192.168.1.1

Replace 192.168.1.1 with your gateway IP (You can get this from one of your other computers on the network. Linux: ifconfig Windows: ipconfig /all) and 192.168.1.150 with the IP you'd like your Pandora to be. There are a few caveats here, though. Simply put, the subnet needs to be the same as your gateway's subnet. So if it's 192.168.X.Y, it needs to start with 192.168.X or if it's 10.0.0.1, it needs to start with 10. Also for 10.0.0.1, the /24 needs to be /8. There's a bunch of other stuff to do with that, and many odd variations on it, but I'm sure there's a better reference for it elsewhere.

* One last thing you'll need to do is set up DNS name servers. You can get this information from another computer on the network with a working Internet connection.
=====Linux=====
cat /etc/resolv.conf
* Copy that file verbatim in to the /etc/resolv.conf on the Pandora.

=====Windows=====
ipconfig /all
* There should be a line for Primary DNS Server and possibly Secondary DNS Server. They should be entered in to /etc/resolv.conf like this.
nameserver Primary.DNS.Server.IP
nameserver Secondary.DNS.Server.IP

If there is no secondary DNS server, don't worry, just enter only the first line, then.

References:
[http://wiki.archlinux.org/index.php/Wpa_supplicant]
[http://wiki.archlinux.org/index.php/Wireless#Manual_setup]
[http://wiki.archlinux.org/index.php/Autowifi]

[[Category:Tutorials]]

Talk:Bluetooth

2011-04-16T21:17:56Z

T4b: Created page with "For me /nothing/ works, neither sending anything to or from the Pandora nor browsing files on my pc or Pandora.~~~~"

For me /nothing/ works, neither sending anything to or from the Pandora nor browsing files on my pc or Pandora.[[User:T4b|T4b]] 23:17, 16 April 2011 (MEST)

Talk:Mount over ssh

2011-04-16T13:16:15Z

T4b: Created page with "Maybe you also have to install some packages over opkg which I've already installed. ~~~~"

Maybe you also have to install some packages over opkg which I've already installed. [[User:T4b|T4b]] 15:16, 16 April 2011 (MEST)