Pandora Wiki - User contributions [en]

BandLuxe C270 3G USB Modem

2012-07-23T08:33:17Z

Relliker:

The Bandluxe C270 3G stick is now working on the Pandora. Here's how I got it working on mine:

The following instructions were carried out on a fresh installation of Zaxxon (the Pandora Operating system) with [[Hotfix]] 6 alpha 4. I have not tested them on any other Hotfix version so I do not know if they will work with other versions but they should keep working with versions later that Hotfix 6 Alpha 4. ( EDIT : ) Note: It is now working intermittently on "Super Zaxxon 1.5 Final Release" with kernel 3.xx. Remember to "Enable USB Host" before inserting the 3G stick. '''Warning''': Overclocked Pandoras may hang and will need a hard reset when this stick is inserted so try to avoid overclocking if using this device.

I also do not know if there is an easier method to get this device to work on the Pandora. The (easier) usb_modeswitch trick did not work for me and that is why I used this method.

''Most of these instructions need to be run as [[root]] as we will be modifying files and directories only accessible to the root user.''

'''Step 1'''

*Change directory to /lib/udev/rules.d

*Create a file called “10-bandluxe.rules” in /lib/udev/rules.d and put the following content in it:

<pre>
ACTION!="add", GOTO="hso_end"

# send eject command via usb_storage driver for all BandLuxe Installation CDROM devices
SYSFS{idVendor}=="1a8d", SYSFS{idProduct}=="1000", RUN="/usr/bin/eject /dev/%k"

LABEL="hso_end"

</pre>

The above file contents are courtesy of the instructions provided by BandLuxe themselves for the eee-pc.

*Make sure that the file permissions of the file you have just created are the same as the other files in that directory.

'''Step 2'''

*Change directory to /etc/ppp/peers.

*Create a new file in /etc/ppp/peers with any name you want (I used “GO” as the filename since my provider is called “GO mobile”). Put the following contents in this newly created file:

<pre>
hide-password
noauth

### the filename GO in the next line is the same as this file's filename.
connect "/usr/sbin/chat -v -f /etc/chatscripts/GO"

debug
/dev/ttyUSB0
460800
defaultroute
noipdefault
user ""
nobsdcomp
noccp
ipcp-accept-local
ipcp-accept-remote
noipdefault
novj
novjccomp
nomagic
usepeerdns
</pre>

Please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 3'''

*Check if you have a directory called “chatscripts” in /etc, i.e..... /etc/chatscripts. If not, create one:

<pre>mkdir /etc/chatscripts</pre>

'''Step 4'''

*Change directory to /etc/chatscripts

*Create a file here with the same name you gave the one in “Step 2” and put the following contents in it:

<pre>

TIMEOUT 240
ABORT BUSY
ABORT 'NO CARRIER'
ABORT VOICE
ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE'
ABORT 'NO ANSWER'
ABORT DELAYED
ABORT ERROR
# modeminit
'' ATZ
OK "AT+CSQ"
OK "ATD*99#"
"CONNECT" ""

</pre>

Once again, please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 5'''

*Create a file in /etc/init.d called mkpppnode.sh

*Put the following two lines in this file

<pre>
#!/bin/sh
mknod /dev/ppp c 108 0
</pre>

This will create the ppp device node required by the pppd daemon when dialing out.

Now link this file in your startup sequence by executing the following command:

<pre>ln -s /etc/init.d/mkpppnode.sh /etc/rcS.d/S98mkpppnode.sh</pre>

This creates a symbolic link called “S98mkpppnode.sh in /etc/rcS.d so that the ppp device is automatically created every time you reboot the Pandora.

'''Step 6'''

*Shutdown and restart the Pandora so the new udev rule we created in “Step 1” is read and the ppp device is created.

NOTE: I tried running “/etc/init.d/udev restart” to avoid the reboot but it did not work and messed up the running system so a shutdown/restart is preferred as the udev init script does not recognise the “restart” argument.

'''Step 7'''

After your Pandora has booted up again:

*Log in and plug in your Bandluxe C270 USB modem.

*Wait until the LED on your Bandluxe C270 starts blinking once every few seconds.

*Check if there are 3 new devices in /dev called ttyUSB0, ttyUSB1 and ttyUSB2.

If there are, then hopefully your device is now recognised and you can connect using your 3G modem by running:

<pre>pon GO</pre> in a root terminal (replace “GO” with the name you gave the file in Step 2)

If the connection is successful, you should be able to see a new interface called “ppp0” when running:

<pre>ifconfig -a</pre>

with a newly-assigned IP address.

'''Happy 3G surfing with your Pandora!!'''

'''Step 8'''

When finished, to disconnect, type:

<pre>poff GO</pre> in a root terminal (again replacing “GO” with the name you gave the file in Step 2)

That's all folks.

In future I'll try to add some scripts to this procedure to make it a bit more user friendly and avoid having to go into command line every time to start/stop your connection but for now at least, the hard-headed Bandluxe C270 is working on the Pandora :)

''relliker''

[[Category:Tutorials]]

BandLuxe C270 3G USB Modem

2012-05-04T10:41:53Z

Relliker:

The Bandluxe C270 3G stick is now working on the Pandora. Here's how I got it working on mine:

The following instructions were carried out on a fresh installation of Zaxxon (the Pandora Operating system) with [[Hotfix]] 6 alpha 4. I have not tested them on any other Hotfix version so I do not know if they will work with other versions but they should keep working with versions later that Hotfix 6 Alpha 4. ( EDIT : ) Note however that currently it's not yet working on kernel 3.2 of "Super Zaxxon 1.5 (Beta 4)".

I also do not know if there is an easier method to get this device to work on the Pandora. The (easier) usb_modeswitch trick did not work for me and that is why I used this method.

''Most of these instructions need to be run as [[root]] as we will be modifying files and directories only accessible to the root user.''

'''Step 1'''

*Change directory to /lib/udev/rules.d

*Create a file called “10-bandluxe.rules” in /lib/udev/rules.d and put the following content in it:

<pre>
ACTION!="add", GOTO="hso_end"

# send eject command via usb_storage driver for all BandLuxe Installation CDROM devices
SYSFS{idVendor}=="1a8d", SYSFS{idProduct}=="1000", RUN="/usr/bin/eject /dev/%k"

LABEL="hso_end"

</pre>

The above file contents are courtesy of the instructions provided by BandLuxe themselves for the eee-pc.

*Make sure that the file permissions of the file you have just created are the same as the other files in that directory.

'''Step 2'''

*Change directory to /etc/ppp/peers.

*Create a new file in /etc/ppp/peers with any name you want (I used “GO” as the filename since my provider is called “GO mobile”). Put the following contents in this newly created file:

<pre>
hide-password
noauth

### the filename GO in the next line is the same as this file's filename.
connect "/usr/sbin/chat -v -f /etc/chatscripts/GO"

debug
/dev/ttyUSB0
460800
defaultroute
noipdefault
user ""
nobsdcomp
noccp
ipcp-accept-local
ipcp-accept-remote
noipdefault
novj
novjccomp
nomagic
usepeerdns
</pre>

Please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 3'''

*Check if you have a directory called “chatscripts” in /etc, i.e..... /etc/chatscripts. If not, create one:

<pre>mkdir /etc/chatscripts</pre>

'''Step 4'''

*Change directory to /etc/chatscripts

*Create a file here with the same name you gave the one in “Step 2” and put the following contents in it:

<pre>

TIMEOUT 240
ABORT BUSY
ABORT 'NO CARRIER'
ABORT VOICE
ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE'
ABORT 'NO ANSWER'
ABORT DELAYED
ABORT ERROR
# modeminit
'' ATZ
OK "AT+CSQ"
OK "ATD*99#"
"CONNECT" ""

</pre>

Once again, please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 5'''

*Create a file in /etc/init.d called mkpppnode.sh

*Put the following two lines in this file

<pre>
#!/bin/sh
mknod /dev/ppp c 108 0
</pre>

This will create the ppp device node required by the pppd daemon when dialing out.

Now link this file in your startup sequence by executing the following command:

<pre>ln -s /etc/init.d/mkpppnode.sh /etc/rcS.d/S98mkpppnode.sh</pre>

This creates a symbolic link called “S98mkpppnode.sh in /etc/rcS.d so that the ppp device is automatically created every time you reboot the Pandora.

'''Step 6'''

*Shutdown and restart the Pandora so the new udev rule we created in “Step 1” is read and the ppp device is created.

NOTE: I tried running “/etc/init.d/udev restart” to avoid the reboot but it did not work and messed up the running system so a shutdown/restart is preferred as the udev init script does not recognise the “restart” argument.

'''Step 7'''

After your Pandora has booted up again:

*Log in and plug in your Bandluxe C270 USB modem.

*Wait until the LED on your Bandluxe C270 starts blinking once every few seconds.

*Check if there are 3 new devices in /dev called ttyUSB0, ttyUSB1 and ttyUSB2.

If there are, then hopefully your device is now recognised and you can connect using your 3G modem by running:

<pre>pon GO</pre> in a root terminal (replace “GO” with the name you gave the file in Step 2)

If the connection is successful, you should be able to see a new interface called “ppp0” when running:

<pre>ifconfig -a</pre>

with a newly-assigned IP address.

'''Happy 3G surfing with your Pandora!!'''

'''Step 8'''

When finished, to disconnect, type:

<pre>poff GO</pre> in a root terminal (again replacing “GO” with the name you gave the file in Step 2)

That's all folks.

In future I'll try to add some scripts to this procedure to make it a bit more user friendly and avoid having to go into command line every time to start/stop your connection but for now at least, the hard-headed Bandluxe C270 is working on the Pandora :)

''relliker''

[[Category:Tutorials]]

BandLuxe C270 3G USB Modem

2011-08-25T23:06:35Z

Relliker:

The Bandluxe C270 3G stick is now working on the Pandora. Here's how I got it working on mine:

The following instructions were carried out on a fresh installation of Zaxxon (the Pandora Operating system) with Hotfix 6 alpha 4. I have not tested them on any other Hotfix version so I do not know if they will work with other versions but they should keep working with versions later that Hotfix 6 Alpha 4.

I also do not know if there is an easier method to get this device to work on the Pandora. The (easier) usb_modeswitch trick did not work for me and that is why I used this method.

''Most of these instructions need to be run as [[root]] as we will be modifying files and directories only accessible to the root user.''

'''Step 1'''

*Change directory to /lib/udev/rules.d

*Create a file called “10-bandluxe.rules” in /lib/udev/rules.d and put the following content in it:

<pre>
ACTION!="add", GOTO="hso_end"

# send eject command via usb_storage driver for all BandLuxe Installation CDROM devices
SYSFS{idVendor}=="1a8d", SYSFS{idProduct}=="1000", RUN="/usr/bin/eject /dev/%k"

LABEL="hso_end"

</pre>

The above file contents are courtesy of the instructions provided by BandLuxe themselves for the eee-pc.

*Make sure that the file permissions of the file you have just created are the same as the other files in that directory.

'''Step 2'''

*Change directory to /etc/ppp/peers.

*Create a new file in /etc/ppp/peers with any name you want (I used “GO” as the filename since my provider is called “GO mobile”). Put the following contents in this newly created file:

<pre>
hide-password
noauth

### the filename GO in the next line is the same as this file's filename.
connect "/usr/sbin/chat -v -f /etc/chatscripts/GO"

debug
/dev/ttyUSB0
460800
defaultroute
noipdefault
user ""
nobsdcomp
noccp
ipcp-accept-local
ipcp-accept-remote
noipdefault
novj
novjccomp
nomagic
usepeerdns
</pre>

Please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 3'''

*Check if you have a directory called “chatscripts” in /etc, i.e..... /etc/chatscripts. If not, create one:

<pre>mkdir /etc/chatscripts</pre>

'''Step 4'''

*Change directory to /etc/chatscripts

*Create a file here with the same name you gave the one in “Step 2” and put the following contents in it:

<pre>

TIMEOUT 240
ABORT BUSY
ABORT 'NO CARRIER'
ABORT VOICE
ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE'
ABORT 'NO ANSWER'
ABORT DELAYED
ABORT ERROR
# modeminit
'' ATZ
OK "AT+CSQ"
OK "ATD*99#"
"CONNECT" ""

</pre>

Once again, please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 5'''

*Create a file in /etc/init.d called mkpppnode.sh

*Put the following two lines in this file

<pre>
#!/bin/sh
mknod /dev/ppp c 108 0
</pre>

This will create the ppp device node required by the pppd daemon when dialing out.

Now link this file in your startup sequence by executing the following command:

<pre>ln -s /etc/init.d/mkpppnode.sh /etc/rcS.d/S98mkpppnode.sh</pre>

This creates a symbolic link called “S98mkpppnode.sh in /etc/rcS.d so that the ppp device is automatically created every time you reboot the Pandora.

'''Step 6'''

*Shutdown and restart the Pandora so the new udev rule we created in “Step 1” is read and the ppp device is created.

NOTE: I tried running “/etc/init.d/udev restart” to avoid the reboot but it did not work and messed up the running system so a shutdown/restart is preferred as the udev init script does not recognise the “restart” argument.

'''Step 7'''

After your Pandora has booted up again:

*Log in and plug in your Bandluxe C270 USB modem.

*Wait until the LED on your Bandluxe C270 starts blinking once every few seconds.

*Check if there are 3 new devices in /dev called ttyUSB0, ttyUSB1 and ttyUSB2.

If there are, then hopefully your device is now recognised and you can connect using your 3G modem by running:

<pre>pon GO</pre> in a root terminal (replace “GO” with the name you gave the file in Step 2)

If the connection is successful, you should be able to see a new interface called “ppp0” when running:

<pre>ifconfig -a</pre>

with a newly-assigned IP address.

'''Happy 3G surfing with your Pandora!!'''

'''Step 8'''

When finished, to disconnect, type:

<pre>poff GO</pre> in a root terminal (again replacing “GO” with the name you gave the file in Step 2)

That's all folks.

In future I'll try to add some scripts to this procedure to make it a bit more user friendly and avoid having to go into command line every time to start/stop your connection but for now at least, the hard-headed Bandluxe C270 is working on the Pandora :)

''relliker''

[[Category:Tutorials]]

BandLuxe C270 3G USB Modem

2011-08-25T22:59:18Z

Relliker:

'''This is a W.I.P. Please excuse the formatting for now, it was imported from a .odt document.'''

Bandluxe C270 3G stick is now working on the Pandora. Here's how I got it working on mine:

The following instructions were carried out on a fresh installation of Zaxxon (the Pandora Operating system) with Hotfix 6 alpha 4. I have not tested them on any other Hotfix version so I do not know if they will work with other versions but they should keep working with versions later that Hotfix 6 Alpha 4.

I also do not know if there is an easier method to get this device to work on the Pandora. The (easier) usb_modeswitch trick did not work for me and that is why I used this method.

'''Step 1'''

*Change directory to /lib/udev/rules.d

*Create a file called “10-bandluxe.rules” in /lib/udev/rules.d and put the following content in it:

<pre>
ACTION!="add", GOTO="hso_end"

# send eject command via usb_storage driver for all BandLuxe Installation CDROM devices
SYSFS{idVendor}=="1a8d", SYSFS{idProduct}=="1000", RUN="/usr/bin/eject /dev/%k"

LABEL="hso_end"

</pre>

*Make sure that the file permissions of the file you have just created are the same as the other files in that directory.

'''Step 2'''

*Change directory to /etc/ppp/peers.

*Create a new file in /etc/ppp/peers with any name you want (I used “GO” as the filename since my provider is called “GO mobile”). Put the following contents in this newly created file:

<pre>
hide-password
noauth

### the filename GO in the next line is the same as this file's filename.
connect "/usr/sbin/chat -v -f /etc/chatscripts/GO"

debug
/dev/ttyUSB0
460800
defaultroute
noipdefault
user ""
nobsdcomp
noccp
ipcp-accept-local
ipcp-accept-remote
noipdefault
novj
novjccomp
nomagic
usepeerdns
</pre>

Please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 3'''

*Check if you have a directory called “chatscripts” in /etc, i.e..... /etc/chatscripts. If not, create one:

<pre>mkdir /etc/chatscripts</pre>

'''Step 4'''

*Change directory to /etc/chatscripts

*Create a file here with the same name you gave the one in “Step 2” and put the following contents in it:

<pre>

TIMEOUT 240
ABORT BUSY
ABORT 'NO CARRIER'
ABORT VOICE
ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE'
ABORT 'NO ANSWER'
ABORT DELAYED
ABORT ERROR
# modeminit
'' ATZ
OK "AT+CSQ"
OK "ATD*99#"
"CONNECT" ""

</pre>

Once again, please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

'''Step 5'''

*Create a file in /etc/init.d called mkpppnode.sh

*Put the following two lines in this file

<pre>
#!/bin/sh
mknod /dev/ppp c 108 0
</pre>

This will create the ppp device node required by the pppd daemon when dialing out.

Now link this file in your startup sequence by executing the following command:

<pre>ln -s /etc/init.d/mkpppnode.sh /etc/rcS.d/S98mkpppnode.sh</pre>

This creates a symbolic link called “S98mkpppnode.sh in /etc/rcS.d so that the ppp device is automatically created every time you reboot the Pandora.

'''Step 6'''

*Shutdown and restart the Pandora so the new udev rule we created in “Step 1” is read and the ppp device is created.

NOTE: I tried running “/etc/init.d/udev restart” to avoid the reboot but it did not work and messed up the running system so a shutdown/restart is preferred as the udev init script does not recognise the “restart” argument.

'''Step 7'''

After your Pandora has booted up again:

*Log in and plug in your Bandluxe C270 USB modem.

*Wait until the LED on your Bandluxe C270 starts blinking once every few seconds.

*Check if there are 3 new devices in /dev called ttyUSB0, ttyUSB1 and ttyUSB2.

If there are, then hopefully your device is now recognised and you can connect using your 3G modem by running:

<pre>pon GO</pre> in a root terminal (replace “GO” with the name you gave the file in Step 2)

If the connection is successful, you should be able to see a new interface called “ppp0” when running:

<pre>ifconfig -a</pre>

with a newly-assigned IP address.

'''Happy 3G surfing with your Pandora!!'''

'''Step 8'''

When finished, to disconnect, type:

<pre>poff GO</pre> in a root terminal (again replacing “GO” with the name you gave the file in Step 2)

That's all folks.

In future I'll try to add some scripts to this procedure to make it a bit more user friendly to avoid having to go into command line every time to start/stop your connection but for now at least, the hard-headed Bandluxe C270 is working on the Pandora :)

[[Category:Tutorials]]

USB compatibility list

2011-08-25T22:42:52Z

Relliker: /* HSDPA (3G) Modems */

This is a list of USB devices that have been tested on the Pandora. If the device you want to know about isn't listed here, don't worry! Just go to [[USB_reference|the USB reference page]], look up the specs of your device, and you may be able to figure out if it's compatible.

= Networking =

Please see the [[Mobile broadband]] page for tips on how to get these working, as well as [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/ this tutorial] from the GP32X forum.

== HSDPA (3G) Modems ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| BandLuxe C270
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| A how-to by relliker for this modem can be found [http://www.pandorawiki.org/BandLuxe_C270_3G_USB_Modem here]
|-
| Huawei E156G
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/52827-3gumts-usb-dongle/page__view__findpost__p__835681]}}
|
|-
| Huawei E160
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E160E
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E1750
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__939350]}}
|
|-
| [[wikipedia:Huawei E220|Huawei E220]]
| Not required
| Standard-A
| USB 1.1
| 500mA
| Standard-A port via High Speed hub
| {{No|Not on new kernels.}}
| The successful Pandora E220 tests were done by DJWillis on an old kernel (long before Pandora shipped). It seems that they are NOT working any more. Also tested on Linux (was it working?) This entry originally said 250mA, but there is no source and current sources say 500mA.
|-
| 4G-Systems XS Stick P14
| Not required (usbserial module)
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__937681]}}
| Requires usbmodeswitch program.
|-
| iPhone 3GS (Probably also 1G/3G)
| ipheth
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Maybe|Should work in Angstrom with some work.}}
| Requires a good bit of dependencies to get working. Tested with Debian from SD, but should work in Angstrom with some work. The ipheth wwan0 device only provides a connection over the 3G modem, even if you're connected to a wifi network. I used the iproxy and SSH tunneling method with proxychains to get to the wifi network.
|-
| HTC Desire
| not required
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Yes}}
| Requires internet connection sharing to be enabled from the phone.
|}

== USB to Ethernet adapters ==

To enable USB Ethernet adapters on the Pandora, you may need to left-click the networking icon on the panel in Xfce, and select "Ifupdown (bnep0)".

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Apple USB Ethernet Adapter MB442Z/A
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Reportedly uses an ASIX AX88xxx chipset.
|-
| Apple USB Ethernet Adapter model A1277
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 05ac:1402 Apple, Inc.
|-
| Conrad 3-Port-USB-Hub und Netzwerk-Adapter
| Not required
| Standard-A
| USB 2.0
| A lot! {{HideableNotes|50% of battery charge only brings you 2h40min (min brightness, no other devices attached)}}
| Standard-A port
| {{Yes}}
| Has a 3port USB Hub included. External power supply can (and should) be attached, not included though. ASIX Chipset. 20€ @ [http://www.conrad.de/ce/de/product/976406/NOTEBOOK-MINI-DOCKINGSTATION-USBRJ45/SHOP_AREA_32315&promotionareaSearchDetail=005 Conrad Electronics]. Not tested in Linux.
|-
| Wii USB 2.0 10/100M adapter (use [http://www.asix.com.tw/products.php?op=pItemdetail&PItemID=86;71;101 ASIX AX 88772 USB 2.0 chip])
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772. [http://www.dealextreme.com/details.dx/sku.5926 This clone from DealExtreme] works too.
|-
| Connectland USB 2.0 10/100M Ethernet Adapter
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772 - Works fine, Sometimes a reboot is necessary (ZaxxonHF5RC1).
|-
| Belkin Gigabit USB 2.0 Network Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| The shape of it make is a bit awkward to fit if you connect it directly, but it has a short adapter cable. I only get ~95Mbit on a gigabit network, but then the pandora's cpu maxes out. (it may be that the driver/usb stack isn't very well optimized), has horribly bright blue LEDs.
|-
| MosChip MCS7830 USB 10/100 Ethernet adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| ID 9710:7830 MosChip Semiconductor MCS7830 10/100 Mbps Ethernet adapter. Kernel module: mcs7830.
|-
| EU.MARK USB 10/100M RJ45 Ethernet Network Adapter Dongle
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| USB ID: 9710:7830 - bought from [http://www.dealextreme.com/details.dx/sku.22684 DealExtreme]
|-
| Digitus DN-10050 Fast Ethernet USB Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| MosChip MCS7830-based adapter. USB ID 9710:7830.
|-
| Edimax EU-4230 Fast Ethernet USB Adapter with 3-port USB hub [http://edimax.ie/images/Image/datasheet/USB/EU-4230/EU-4230_Datasheet.pdf]
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Ethernet USB ID 0b95:772a ASIX Electronics Corp. 3-port USB2.0 hub USB ID 0409:005a NEC Corp. Optional power adapter for USB hub.
|}

== USB WiFi adapters ==

The Pandora stock kernel doesn't seem to come with any wireless driver support outside of the internal WiFi chip. The only way you'll get wireless working is to build your own kernel with it included or try [http://wireless.kernel.org/en/users/Download compat-wireless].

See also [http://www.gp32x.com/board/index.php?/topic/55570-new-pandora this thread] on the forums for the latest.

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested on Pandora
! Additional comments
|-
| Belkin N1 Wireless USB Adapter (F5D8051) ("Ver. 2053") (MARVELL v1021)
| N/A
| Standard-A
| USB 2.0
| {{Unknown}}
| No connection was attempted.
| {{No|No native driver support and ndiswrapper obviously won't work.}}
| There's a previous revision of this dongle which is supposed to have a Ralink chip, but they revised it and put a different chip inside. Reported (by whom?) to work with ndiswrapper and works in Linux.
|-
| Cisco/Linksys AE1000 High Performance Wireless-N USB Adapter
| rt3572sta (RT3572USB)
| Standard-A
| USB 2.0
| {{Unknown}}
| USB A (Standard-A port?)
| {{Yes|Works with a modified driver.}}
| (Compiled module for pandora:[http://boards.openpandora.org/index.php?/topic/1992-linksys-ae1000-usb-wifi/ pandora forum]) Download the driver from [http://www.ralinktech.com/support.php?s=2 ralink's driver site], edit ./common/rtusb_dev_id.c, before "#endif // RT2870" add "{USB_DEVICE(0x13B1,0x002F)},", compile.' Reported (by whom?) to work in Linux.
|}

= Storage =

== External Hard Disk Drives ==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! style="min-width: 120px" | Works on Pandora
! Additional comments
|-
| Freecom 250GB 2.5" portable
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Inside it's a Samsung Model HM251JX. {{HideableNotes|So I guess anything based on that will also work OK.}}
|-
| LaCie Rikiki 250GB USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port via powered High Speed Hub
| {{Partial|Not when unpowered, needs testing with a powered hub}}
| Not only does it fail to spin up, but it causes the Pandora's screen to pulsate wildly, much like an old CRT would if you placed a speaker or a magnet near to it. Not tested with a powered hub.
|-
| Seagate Seagate® Expansion™ External Drives
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{No}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14781-hitnrun/ Hitnrun]. "Isn't even detected in lsusb (drive powered by external power source)"
|-
| Verbatim 250GB Model #47580 Hard Drive
| Not required
| Direct
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877512 almatuk]. {{HideableNotes|"Watched videos directly from it at full speed, no need for powered USB hub. Had issues playing roms directly off it however as it was formatted NTFS. I'm sure if I formatted to FAT32 these would disappear."}}
|-
| Western Digital 160GB Elements External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| standard-A port via powered High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB Elements Portable USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or standard-A port via High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB My Passport Essential USB 2.0 2.5" Hard Drive
| Not required
| {{Unknown|Direct?}}
| USB 2.0
| {{Unknown}}
| {{Unknown|Direct?}}
| {{Partial|Maybe}}
| Tested by TheDarkSpectrum48K. The first time it [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877386 "works perfectly!"]. The second time [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__882635 it didn't work].
|-
| Western Digital 400GB My Passport Essential USB 2.0 2.5" HDD model WDME4000TE
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14534-peca/ Peca].
|-
| Western Digital 500GB Elements Portable External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. {{HideableNotes|The USB cable that came with it was bad, so I used another one.[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949863]}}
|-
| Western Digital 500GB My Passport Essential External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works fine. {{HideableNotes|Came pre-formatted in NTFS, but should work if you downloaded the community codec pack. It said 1TB on the packaging, but there was 465GB free space, so I'm pretty sure it was actually the 500GB one.}}[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949645]
|-
| Western Digital 1TB My Passport Essential SE External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or through powered High Speed Hub
| {{Yes}}
| Tested by [http://http://www.gp32x.com/board/index.php?/user/19191-mycohl/ Mycohl]. {{HideableNotes|Externally powered hub recommended to conserve battery power.}}
|-
| Western Digital Elements 2TB 3.5" Hard Drive Model:WDBAAU0020HBK
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://boards.openpandora.org/index.php?/user/430-kilowatt/ kilowatt].
|}

== DVD/CD Drives ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Lite-On EZ-DUB DVD/CD Multi-Recorder (Model eZAU120)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter - DC 12V 1.8A
| Standard-A port
| {{No}}
| Works in Linux.
|-
| Memorex 20x Multi Format DVD Recorder External - DVD±RW (±R DL)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter
| Standard-A port
| {{Yes}}
|
|}

= Video display device =

== VGA DVI HDMI adapter ==

No devices have been tested yet

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
|
|
|
|
|
|
|
| No devices have been tested yet
|}

==== External graphic card ====

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
| Tritton see2 usb 2.0 to SVGA adapter
| sisusb
| USB
| USB 2.0
| {{Unknown|High {{HideableNotes|Reduces Pandora's battery life in half (10h → 4h)}}}}
| VGA (D-SUB)
| {{Partial|Yes, but has performance issues.}}
| Needs to be integrated with preferences. {{HideableNotes|Currently I must edit xorg.conf and mess with xinerama.}} Good for presentations, dragging a window is bearable, but hi-res video is slow. Works in Linux without any issues.
|}

= Video capture devices =

== Webcams ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Exoo No Driver/USB 2.0 Webcam (Model No.: M053)
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| Bought from [http://www.dealextreme.com/details.dx/sku.14991 DealExtreme]. Works in Linux.
|-
| Logitech Quickcam Communicate Deluxe
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| USB ID: 046d:0992, works though [http://linux-uvc.berlios.de/ uvcvideo]. Works in Linux.
|-
| Logitech HD Webcam C270 720p
| Not required
| Standard-A
| USB 2.0
| 500mA
| Standard-A port
| {{Partial|Yes, but audio untested}}
| ID 046d:0825 Logitech, Inc. Audio recognized, but not tested. More info to come. Works in Linux.
|}

= Audio devices =

== Microphones/recorders ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Zoom H2 Handy Recorder
| not required
| standard-A
| USB 1.1
| 300mA
| standard-A port via High Speed USB hub
| {{Yes|Yes, needs a USB hub.}}
| Can record into Audacity, but won't be recognized unless connected through USB hub.[http://www.gp32x.com/board/index.php?/topic/59301-audacity-1-3-12/page__view__findpost__p__947602].
|}

== MIDI controllers ==

EvilDragon bundled the usb MIDI class drivers in the default firmware image, therefore ANY class-compliant MIDI device should work with the Pandora, out of the box.[http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Akai LKP25
| Not required
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]}}
|
|-
| M-Audio MIDISPORT 2x2 Anniv
| Not required
| {{Unknown}}
| {{Unknown}}
| 400mA
| {{Unknown}}
| {{Unknown}}
| ID 0763:1050 Midiman. High current draw!
|-
|}

== USB audio controllers ==

Aka. "professional soundcard"; see [http://en.wikipedia.org/wiki/Sound_card#Professional_soundcards_.28audio_interfaces.29 definition on Wikipedia].

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Cakewalk UA-1G
| not required
| Standard-A
| USB 2.0
| 200mA
| Standard-A port
| {{No}}
| ID 0582:00e9 Roland Corp. This device may be similar to older Edirol/Roland USB audio devices. Widely reported (by whom?) to work in Linux.
|}

= Input devices =

Any HID ([http://en.wikipedia.org/wiki/Human_interface_device Human Interface Device]) compliant keyboard, mouse or game controller should work on the Pandora. Most of those device are low speed or full speed USB device and will need to be connected though either a USB OTG adapter/cable or a USB2 hub in order to work on the Pandora.

== External Game Controllers ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| 2-TECH SNES-to-USB adapter
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| USB description is "HuiJia USB GamePad", <tt>lsusb</tt> calls it "0e8f:3013 GreenAsia Inc."
|-
| USB Super RetroPort (SNES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=29 RetroZone]. Works in Linux.
|-
| USB RetroPort (NES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=28 RetroZone]. Works in Linux.
|-
| Trio Linker Plus II (PlayStation,-GameCube,-and-Dreamcast-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.play-asia.com/paOS-13-71-6m-49-en-70-1zfv.html Play-Asia]. Works in Linux.
|-
| NAZAR V47 USB Force Feedback Vibrating Gamepad Controller for PC
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.24551 DealExtreme]. Works in Linux.
|-
| 10-Fire-Button Double Vibration Feedback USB PC Arcade Joystick
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.27821 DealExtreme]. Works in Linux.
|-
| Official PlayStation 3 controller
| Not required
| Standard-A
| Full speed
| {{Unknown}}
| USB A To Mini B Cable via High Speed Hub
| {{No}}
| This is for USB not bluetooth compatibility. Sixaxis and DualShock not tested. Works in Linux.
|-
| Thrustmaster Firestorm Digital 3 Gamepad
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| ID 07b5:0213 Mega World International, Ltd Thrustmaster Firestorm Digital 3 Gamepad.
|-
| Wired Xbox 360 Controller
| xpad module
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| This also includes gamepads for PC that needs the Windows Xinput driver. Such gamepads include the Logitech Chillstream. Works in Linux.
|-
| WiseGroup.,Ltd SmartJoy Dual PLUS Adapter (dual PSX to USB joypad adapter)
| {{Unknown}}
| Standard-A
| {{Unknown}}
| 100mA
| {{Unknown}}
| {{No}}
| ID 6677:8802. Works in Linux.
|}

== Graphics tablets ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Works on Pandora
! Additional comments
|-
| Bamboo Multitouch
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__881806]}}
| It's not known if this works in Linux.
|-
| Genius Tablet
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes, [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__883140 via USB hub]}}
| It's not known if this works in Linux.
|-
| Wacom CTH-460
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__924422]}}
| Would need a patched driver to work. It's not known if this works in Linux.
|-
| Wacom Volito2 Tablet (Model: CTF-420)
| Not required
| Standard-A
| Low speed
| 40mA [http://www.my-volito.com/volito/specs.asp?lang=en]
| {{No}}
| USB ID: 056a:0062
|}

== Mice ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Connector
! Works on Pandora
! Additional comments
|-
| Apple Mouse (M5769)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|-
| Apple Mouse with Scroll Ball (A1152)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|}

= Connectors, adapters, and hubs =

This section is intended as a general guide. Items in this section are standard USB accessories, so drivers are not required. Compatibility with Pandora is assumed. Please note that any external product links are provided for reference only, and are not an endorsement.

== OTG (On The Go) Adapters ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Generic adapter
| {{No}}
| [http://shop.ebay.com/?_from=R40&_trksid=p3907.m38.l1313&_nkw=usb+otg+host+cable&_sacat=See-All-Categories Find on eBay] [http://www.amazon.co.uk/s/ref=nb_ss_ce?url=search-alias%3Delectronics&field-keywords=OTG+Cable+Adapter&x=3&y=23 Find on Amazon] These links are not 100% accurate. Check for `mini-a`, and on eBay, the price is higher by about $8.
|-
| Nokia USB OTG adapter
| {{Yes}}
| [http://www.electronicproductonline.com/catalog/product_info.php?cPath=35_67&products_id=2043 Electronic Product Online]
|}

== Compact USB Hubs ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Griffin SmartShare USB [http://www.griffintechnology.com/products/smartshare-usb]
| {{No}}
|
|-
| Belkin F5U415 4 Port USB 2.0 Swivel Hub [http://catalog.belkin.com/IWCatProductPage.process?Product_Id=377085]
| {{No}}
| Comes with an optional power adapter.
|-
| Belkin F5U701 USB 2.0 7 Port Mobile Hub [http://www.belkin.com/IWCatProductPage.process?Product_Id=369788]
| {{Yes}}
| Tested by pabloh. Comes with an optional power adapter.
|-
| ID 0e8f:0016 GreenAsia Inc.
| {{No}}
| Tested by tsh. Labeled as high speed. Bought from ebay.
|-
|Trust 4 port netbook hub ID 05e3:0608
| {{Yes}}
| Tested by tsh. Bought from [http://www.amazon.co.uk/gp/product/B0025X16AS Amazon].
|-
| High Speed 4 Port Mini USB 2.0 Hub for Laptop PC (non powered)
| {{Yes}}
| Octopus-style small cheap unpowered USB hub. Bought from [http://cgi.benl.ebay.be/ws/eBayISAPI.dll?ViewItem&item=270538502843 ebay]
|-
| Keeptech USB 2.0 Hub (7 Ports) with Power Adapter, KT-UH703 [http://www.keeptech.com/books_show.php?id=144]
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works powered or unpowered.
|-
| Logitech Premium 4-Port USB Hub [http://www.logitech.com/en-in/notebook-products/usb-hubs/devices/3048]
| {{Yes}}
|
|-
| LUPO 7-port USB 2.0 Hub (cheap octopus type which can be powered as there is dc socket)
| {{Partial|Yes. {{HideableNotes|Can use a power supply but wasn't tested with one.}}}}
| Tested by kilowatt. Bought from [http://www.amazon.co.uk/gp/product/B003BVDABG/ref=oss_product from amazon uk]
|-
| LogiLink USB 2.0 Hub 4-Port UA0086 [http://www.logilink.eu/showproduct/UA0086.htm]
| {{Yes}}
| Tested by Jones. Comes with an optional power adapter.
|}

[[Category:USB]]
[[Category:List]]

User manual

2011-08-25T13:42:09Z

Relliker: /* Mouse (stylus/pointer) settings */

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

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

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

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

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

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

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

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

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

== Specifications ==
==== Highlights ====
{{citation needed}}
* [[ARM]]® Cortex™-A8 600Mhz+ CPU running [[Linux]]*
* 430-MHz [[TMS320C64x+]]™ DSP Core
* PowerVR SGX [[OpenGL 2.0 ES]] compliant 3D hardware
* 800x480 4.3" 16.7 million colours [[touchscreen]] LCD
* [[Wifi]] 802.11b/g, [[Bluetooth]] & High Speed [[USB]] 2.0 Host
* Dual [[SDHC card]] slots & SVideo [[TV output]]
* Dual Analogue and Digital gaming controls ([[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.

To be on the safe side, you can use this [http://boards.openpandora.org/index.php?/topic/1488-better-battery-charging-beta/page__view__findpost__p__40784 better battery charging script], which is planned to be included in Hotfix 6 to the Pandora's firmware.[http://boards.openpandora.org/index.php?/topic/3100-bluetooth-file-receiving-daemon/page__view__findpost__p__54581] It will keep your Pandora charged between 95-100% rather than constantly at 100%, which is better for the battery.

==== 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 ---> Desktop ---> 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 can use the [http://www.pandorabits.org/index.php?page=opkg-installer OPKG Installer] to make things easier.

*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 automatically. 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. You can also create a <SD>/pandora/mmenu/ folder, and anything saved there will ''only'' show up in Minimenu.
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]]

USB compatibility list

2011-08-25T13:30:04Z

Relliker: /* HSDPA (3G) Modems */

This is a list of USB devices that have been tested on the Pandora. If the device you want to know about isn't listed here, don't worry! Just go to [[USB_reference|the USB reference page]], look up the specs of your device, and you may be able to figure out if it's compatible.

= Networking =

Please see the [[Mobile broadband]] page for tips on how to get these working, as well as [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/ this tutorial] from the GP32X forum.

== HSDPA (3G) Modems ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| BandLuxe C270
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| A how-to by relliker for this modem can be found here[http://www.pandorawiki.org/BandLuxe_C270_3G_USB_Modem]
|-
| Huawei E156G
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/52827-3gumts-usb-dongle/page__view__findpost__p__835681]}}
|
|-
| Huawei E160
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E160E
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E1750
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__939350]}}
|
|-
| [[wikipedia:Huawei E220|Huawei E220]]
| Not required
| Standard-A
| USB 1.1
| 500mA
| Standard-A port via High Speed hub
| {{No|Not on new kernels.}}
| The successful Pandora E220 tests were done by DJWillis on an old kernel (long before Pandora shipped). It seems that they are NOT working any more. Also tested on Linux (was it working?) This entry originally said 250mA, but there is no source and current sources say 500mA.
|-
| 4G-Systems XS Stick P14
| Not required (usbserial module)
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__937681]}}
| Requires usbmodeswitch program.
|-
| iPhone 3GS (Probably also 1G/3G)
| ipheth
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Maybe|Should work in Angstrom with some work.}}
| Requires a good bit of dependencies to get working. Tested with Debian from SD, but should work in Angstrom with some work. The ipheth wwan0 device only provides a connection over the 3G modem, even if you're connected to a wifi network. I used the iproxy and SSH tunneling method with proxychains to get to the wifi network.
|-
| HTC Desire
| not required
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Yes}}
| Requires internet connection sharing to be enabled from the phone.
|}

== USB to Ethernet adapters ==

To enable USB Ethernet adapters on the Pandora, you may need to left-click the networking icon on the panel in Xfce, and select "Ifupdown (bnep0)".

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Apple USB Ethernet Adapter MB442Z/A
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Reportedly uses an ASIX AX88xxx chipset.
|-
| Apple USB Ethernet Adapter model A1277
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 05ac:1402 Apple, Inc.
|-
| Conrad 3-Port-USB-Hub und Netzwerk-Adapter
| Not required
| Standard-A
| USB 2.0
| A lot! {{HideableNotes|50% of battery charge only brings you 2h40min (min brightness, no other devices attached)}}
| Standard-A port
| {{Yes}}
| Has a 3port USB Hub included. External power supply can (and should) be attached, not included though. ASIX Chipset. 20€ @ [http://www.conrad.de/ce/de/product/976406/NOTEBOOK-MINI-DOCKINGSTATION-USBRJ45/SHOP_AREA_32315&promotionareaSearchDetail=005 Conrad Electronics]. Not tested in Linux.
|-
| Wii USB 2.0 10/100M adapter (use [http://www.asix.com.tw/products.php?op=pItemdetail&PItemID=86;71;101 ASIX AX 88772 USB 2.0 chip])
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772. [http://www.dealextreme.com/details.dx/sku.5926 This clone from DealExtreme] works too.
|-
| Connectland USB 2.0 10/100M Ethernet Adapter
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772 - Works fine, Sometimes a reboot is necessary (ZaxxonHF5RC1).
|-
| Belkin Gigabit USB 2.0 Network Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| The shape of it make is a bit awkward to fit if you connect it directly, but it has a short adapter cable. I only get ~95Mbit on a gigabit network, but then the pandora's cpu maxes out. (it may be that the driver/usb stack isn't very well optimized), has horribly bright blue LEDs.
|-
| MosChip MCS7830 USB 10/100 Ethernet adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| ID 9710:7830 MosChip Semiconductor MCS7830 10/100 Mbps Ethernet adapter. Kernel module: mcs7830.
|-
| EU.MARK USB 10/100M RJ45 Ethernet Network Adapter Dongle
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| USB ID: 9710:7830 - bought from [http://www.dealextreme.com/details.dx/sku.22684 DealExtreme]
|-
| Digitus DN-10050 Fast Ethernet USB Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| MosChip MCS7830-based adapter. USB ID 9710:7830.
|-
| Edimax EU-4230 Fast Ethernet USB Adapter with 3-port USB hub [http://edimax.ie/images/Image/datasheet/USB/EU-4230/EU-4230_Datasheet.pdf]
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Ethernet USB ID 0b95:772a ASIX Electronics Corp. 3-port USB2.0 hub USB ID 0409:005a NEC Corp. Optional power adapter for USB hub.
|}

== USB WiFi adapters ==

The Pandora stock kernel doesn't seem to come with any wireless driver support outside of the internal WiFi chip. The only way you'll get wireless working is to build your own kernel with it included or try [http://wireless.kernel.org/en/users/Download compat-wireless].

See also [http://www.gp32x.com/board/index.php?/topic/55570-new-pandora this thread] on the forums for the latest.

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested on Pandora
! Additional comments
|-
| Belkin N1 Wireless USB Adapter (F5D8051) ("Ver. 2053") (MARVELL v1021)
| N/A
| Standard-A
| USB 2.0
| {{Unknown}}
| No connection was attempted.
| {{No|No native driver support and ndiswrapper obviously won't work.}}
| There's a previous revision of this dongle which is supposed to have a Ralink chip, but they revised it and put a different chip inside. Reported (by whom?) to work with ndiswrapper and works in Linux.
|-
| Cisco/Linksys AE1000 High Performance Wireless-N USB Adapter
| rt3572sta (RT3572USB)
| Standard-A
| USB 2.0
| {{Unknown}}
| USB A (Standard-A port?)
| {{Yes|Works with a modified driver.}}
| (Compiled module for pandora:[http://boards.openpandora.org/index.php?/topic/1992-linksys-ae1000-usb-wifi/ pandora forum]) Download the driver from [http://www.ralinktech.com/support.php?s=2 ralink's driver site], edit ./common/rtusb_dev_id.c, before "#endif // RT2870" add "{USB_DEVICE(0x13B1,0x002F)},", compile.' Reported (by whom?) to work in Linux.
|}

= Storage =

== External Hard Disk Drives ==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! style="min-width: 120px" | Works on Pandora
! Additional comments
|-
| Freecom 250GB 2.5" portable
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Inside it's a Samsung Model HM251JX. {{HideableNotes|So I guess anything based on that will also work OK.}}
|-
| LaCie Rikiki 250GB USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port via powered High Speed Hub
| {{Partial|Not when unpowered, needs testing with a powered hub}}
| Not only does it fail to spin up, but it causes the Pandora's screen to pulsate wildly, much like an old CRT would if you placed a speaker or a magnet near to it. Not tested with a powered hub.
|-
| Seagate Seagate® Expansion™ External Drives
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{No}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14781-hitnrun/ Hitnrun]. "Isn't even detected in lsusb (drive powered by external power source)"
|-
| Verbatim 250GB Model #47580 Hard Drive
| Not required
| Direct
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877512 almatuk]. {{HideableNotes|"Watched videos directly from it at full speed, no need for powered USB hub. Had issues playing roms directly off it however as it was formatted NTFS. I'm sure if I formatted to FAT32 these would disappear."}}
|-
| Western Digital 160GB Elements External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| standard-A port via powered High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB Elements Portable USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or standard-A port via High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB My Passport Essential USB 2.0 2.5" Hard Drive
| Not required
| {{Unknown|Direct?}}
| USB 2.0
| {{Unknown}}
| {{Unknown|Direct?}}
| {{Partial|Maybe}}
| Tested by TheDarkSpectrum48K. The first time it [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877386 "works perfectly!"]. The second time [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__882635 it didn't work].
|-
| Western Digital 400GB My Passport Essential USB 2.0 2.5" HDD model WDME4000TE
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14534-peca/ Peca].
|-
| Western Digital 500GB Elements Portable External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. {{HideableNotes|The USB cable that came with it was bad, so I used another one.[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949863]}}
|-
| Western Digital 500GB My Passport Essential External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works fine. {{HideableNotes|Came pre-formatted in NTFS, but should work if you downloaded the community codec pack. It said 1TB on the packaging, but there was 465GB free space, so I'm pretty sure it was actually the 500GB one.}}[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949645]
|-
| Western Digital 1TB My Passport Essential SE External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or through powered High Speed Hub
| {{Yes}}
| Tested by [http://http://www.gp32x.com/board/index.php?/user/19191-mycohl/ Mycohl]. {{HideableNotes|Externally powered hub recommended to conserve battery power.}}
|-
| Western Digital Elements 2TB 3.5" Hard Drive Model:WDBAAU0020HBK
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://boards.openpandora.org/index.php?/user/430-kilowatt/ kilowatt].
|}

== DVD/CD Drives ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Lite-On EZ-DUB DVD/CD Multi-Recorder (Model eZAU120)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter - DC 12V 1.8A
| Standard-A port
| {{No}}
| Works in Linux.
|-
| Memorex 20x Multi Format DVD Recorder External - DVD±RW (±R DL)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter
| Standard-A port
| {{Yes}}
|
|}

= Video display device =

== VGA DVI HDMI adapter ==

No devices have been tested yet

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
|
|
|
|
|
|
|
| No devices have been tested yet
|}

==== External graphic card ====

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
| Tritton see2 usb 2.0 to SVGA adapter
| sisusb
| USB
| USB 2.0
| {{Unknown|High {{HideableNotes|Reduces Pandora's battery life in half (10h → 4h)}}}}
| VGA (D-SUB)
| {{Partial|Yes, but has performance issues.}}
| Needs to be integrated with preferences. {{HideableNotes|Currently I must edit xorg.conf and mess with xinerama.}} Good for presentations, dragging a window is bearable, but hi-res video is slow. Works in Linux without any issues.
|}

= Video capture devices =

== Webcams ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Exoo No Driver/USB 2.0 Webcam (Model No.: M053)
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| Bought from [http://www.dealextreme.com/details.dx/sku.14991 DealExtreme]. Works in Linux.
|-
| Logitech Quickcam Communicate Deluxe
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| USB ID: 046d:0992, works though [http://linux-uvc.berlios.de/ uvcvideo]. Works in Linux.
|-
| Logitech HD Webcam C270 720p
| Not required
| Standard-A
| USB 2.0
| 500mA
| Standard-A port
| {{Partial|Yes, but audio untested}}
| ID 046d:0825 Logitech, Inc. Audio recognized, but not tested. More info to come. Works in Linux.
|}

= Audio devices =

== Microphones/recorders ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Zoom H2 Handy Recorder
| not required
| standard-A
| USB 1.1
| 300mA
| standard-A port via High Speed USB hub
| {{Yes|Yes, needs a USB hub.}}
| Can record into Audacity, but won't be recognized unless connected through USB hub.[http://www.gp32x.com/board/index.php?/topic/59301-audacity-1-3-12/page__view__findpost__p__947602].
|}

== MIDI controllers ==

EvilDragon bundled the usb MIDI class drivers in the default firmware image, therefore ANY class-compliant MIDI device should work with the Pandora, out of the box.[http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Akai LKP25
| Not required
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]}}
|
|-
| M-Audio MIDISPORT 2x2 Anniv
| Not required
| {{Unknown}}
| {{Unknown}}
| 400mA
| {{Unknown}}
| {{Unknown}}
| ID 0763:1050 Midiman. High current draw!
|-
|}

== USB audio controllers ==

Aka. "professional soundcard"; see [http://en.wikipedia.org/wiki/Sound_card#Professional_soundcards_.28audio_interfaces.29 definition on Wikipedia].

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Cakewalk UA-1G
| not required
| Standard-A
| USB 2.0
| 200mA
| Standard-A port
| {{No}}
| ID 0582:00e9 Roland Corp. This device may be similar to older Edirol/Roland USB audio devices. Widely reported (by whom?) to work in Linux.
|}

= Input devices =

Any HID ([http://en.wikipedia.org/wiki/Human_interface_device Human Interface Device]) compliant keyboard, mouse or game controller should work on the Pandora. Most of those device are low speed or full speed USB device and will need to be connected though either a USB OTG adapter/cable or a USB2 hub in order to work on the Pandora.

== External Game Controllers ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| 2-TECH SNES-to-USB adapter
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| USB description is "HuiJia USB GamePad", <tt>lsusb</tt> calls it "0e8f:3013 GreenAsia Inc."
|-
| USB Super RetroPort (SNES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=29 RetroZone]. Works in Linux.
|-
| USB RetroPort (NES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=28 RetroZone]. Works in Linux.
|-
| Trio Linker Plus II (PlayStation,-GameCube,-and-Dreamcast-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.play-asia.com/paOS-13-71-6m-49-en-70-1zfv.html Play-Asia]. Works in Linux.
|-
| NAZAR V47 USB Force Feedback Vibrating Gamepad Controller for PC
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.24551 DealExtreme]. Works in Linux.
|-
| 10-Fire-Button Double Vibration Feedback USB PC Arcade Joystick
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.27821 DealExtreme]. Works in Linux.
|-
| Official PlayStation 3 controller
| Not required
| Standard-A
| Full speed
| {{Unknown}}
| USB A To Mini B Cable via High Speed Hub
| {{No}}
| This is for USB not bluetooth compatibility. Sixaxis and DualShock not tested. Works in Linux.
|-
| Thrustmaster Firestorm Digital 3 Gamepad
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| ID 07b5:0213 Mega World International, Ltd Thrustmaster Firestorm Digital 3 Gamepad.
|-
| Wired Xbox 360 Controller
| xpad module
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| This also includes gamepads for PC that needs the Windows Xinput driver. Such gamepads include the Logitech Chillstream. Works in Linux.
|-
| WiseGroup.,Ltd SmartJoy Dual PLUS Adapter (dual PSX to USB joypad adapter)
| {{Unknown}}
| Standard-A
| {{Unknown}}
| 100mA
| {{Unknown}}
| {{No}}
| ID 6677:8802. Works in Linux.
|}

== Graphics tablets ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Works on Pandora
! Additional comments
|-
| Bamboo Multitouch
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__881806]}}
| It's not known if this works in Linux.
|-
| Genius Tablet
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes, [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__883140 via USB hub]}}
| It's not known if this works in Linux.
|-
| Wacom CTH-460
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__924422]}}
| Would need a patched driver to work. It's not known if this works in Linux.
|-
| Wacom Volito2 Tablet (Model: CTF-420)
| Not required
| Standard-A
| Low speed
| 40mA [http://www.my-volito.com/volito/specs.asp?lang=en]
| {{No}}
| USB ID: 056a:0062
|}

== Mice ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Connector
! Works on Pandora
! Additional comments
|-
| Apple Mouse (M5769)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|-
| Apple Mouse with Scroll Ball (A1152)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|}

= Connectors, adapters, and hubs =

This section is intended as a general guide. Items in this section are standard USB accessories, so drivers are not required. Compatibility with Pandora is assumed. Please note that any external product links are provided for reference only, and are not an endorsement.

== OTG (On The Go) Adapters ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Generic adapter
| {{No}}
| [http://shop.ebay.com/?_from=R40&_trksid=p3907.m38.l1313&_nkw=usb+otg+host+cable&_sacat=See-All-Categories Find on eBay] [http://www.amazon.co.uk/s/ref=nb_ss_ce?url=search-alias%3Delectronics&field-keywords=OTG+Cable+Adapter&x=3&y=23 Find on Amazon] These links are not 100% accurate. Check for `mini-a`, and on eBay, the price is higher by about $8.
|-
| Nokia USB OTG adapter
| {{Yes}}
| [http://www.electronicproductonline.com/catalog/product_info.php?cPath=35_67&products_id=2043 Electronic Product Online]
|}

== Compact USB Hubs ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Griffin SmartShare USB [http://www.griffintechnology.com/products/smartshare-usb]
| {{No}}
|
|-
| Belkin F5U415 4 Port USB 2.0 Swivel Hub [http://catalog.belkin.com/IWCatProductPage.process?Product_Id=377085]
| {{No}}
| Comes with an optional power adapter.
|-
| Belkin F5U701 USB 2.0 7 Port Mobile Hub [http://www.belkin.com/IWCatProductPage.process?Product_Id=369788]
| {{Yes}}
| Tested by pabloh. Comes with an optional power adapter.
|-
| ID 0e8f:0016 GreenAsia Inc.
| {{No}}
| Tested by tsh. Labeled as high speed. Bought from ebay.
|-
|Trust 4 port netbook hub ID 05e3:0608
| {{Yes}}
| Tested by tsh. Bought from [http://www.amazon.co.uk/gp/product/B0025X16AS Amazon].
|-
| High Speed 4 Port Mini USB 2.0 Hub for Laptop PC (non powered)
| {{Yes}}
| Octopus-style small cheap unpowered USB hub. Bought from [http://cgi.benl.ebay.be/ws/eBayISAPI.dll?ViewItem&item=270538502843 ebay]
|-
| Keeptech USB 2.0 Hub (7 Ports) with Power Adapter, KT-UH703 [http://www.keeptech.com/books_show.php?id=144]
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works powered or unpowered.
|-
| Logitech Premium 4-Port USB Hub [http://www.logitech.com/en-in/notebook-products/usb-hubs/devices/3048]
| {{Yes}}
|
|-
| LUPO 7-port USB 2.0 Hub (cheap octopus type which can be powered as there is dc socket)
| {{Partial|Yes. {{HideableNotes|Can use a power supply but wasn't tested with one.}}}}
| Tested by kilowatt. Bought from [http://www.amazon.co.uk/gp/product/B003BVDABG/ref=oss_product from amazon uk]
|-
| LogiLink USB 2.0 Hub 4-Port UA0086 [http://www.logilink.eu/showproduct/UA0086.htm]
| {{Yes}}
| Tested by Jones. Comes with an optional power adapter.
|}

[[Category:USB]]
[[Category:List]]

BandLuxe C270 3G USB Modem

2011-08-25T13:25:27Z

Relliker: Getting the BandLuxe C270 3G USB Modem to work on the Pandora

'''This is a W.I.P. Please excuse the formatting for now, it was imported from a .odt document.'''

Bandluxe C270 3G stick is now working on the Pandora. Here's how I got it working on mine:

Before starting I would like to say that the following instructions were carried out on a fresh installation of Zaxxon (the Pandora Operating system) with Hotfix 6 alpha 4. I have not tested them on any other Hotfix version so I do not know if they will work with other versions but they should keep working with versions later that Hotfix 6 Alpha 4.

I also do not know if there is an easier method to get this device to work on the Pandora. The (easier) usb_modeswitch trick did not work for me and that is why I used this method.

Step 1

Change directory to /lib/udev/rules.d

Create a file called “10-bandluxe.rules” in /lib/udev/rules.d and put the following content in it:

### START
ACTION!="add", GOTO="hso_end"

# send eject command via usb_storage driver for all BandLuxe Installation CDROM devices
SYSFS{idVendor}=="1a8d", SYSFS{idProduct}=="1000", RUN="/usr/bin/eject /dev/%k"

LABEL="hso_end"

### END

make sure that the file permissions of the file you have just created are the same as the other files in that directory.

Step 2

Change directory to /etc/ppp/peers.

Create a new file in /etc/ppp/peers with any name you want (I used “GO” as the filename since my provider is called “GO mobile”). Put the following contents in this newly created file:

### START
hide-password
noauth

### the filename GO in the next line is the same as this file's filename.
connect "/usr/sbin/chat -v -f /etc/chatscripts/GO"

debug
/dev/ttyUSB0
460800
defaultroute
noipdefault
user ""
nobsdcomp
noccp
ipcp-accept-local
ipcp-accept-remote
noipdefault
novj
novjccomp
nomagic
usepeerdns
### END

Please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

Step 3

Check if you have a directory called “chatscripts” in /etc, that is.... /etc/chatscripts. If not, create one:

mkdir /etc/chatscripts

Step 4

Change directory to /etc/chatscripts

Create a file here with the same name you gave the one in “Step 2” and put the following contents in it:

### START

TIMEOUT 240
ABORT BUSY
ABORT 'NO CARRIER'
ABORT VOICE
ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE'
ABORT 'NO ANSWER'
ABORT DELAYED
ABORT ERROR
# modeminit
'' ATZ
OK "AT+CSQ"
OK "ATD*99#"
"CONNECT" ""

### END

Once again, please note that these entries are what worked for me. You might have to tweak/delete/add to them according to your requirements.

Step 5

Create a file in /etc/init.d called mkpppnode.sh

put the following two lines in this file

#!/bin/sh
mknod /dev/ppp c 108 0

This will create the ppp device node required by the pppd daemon when dialling out.

Now link this file in your startup sequence by executing the following command:

ln -s /etc/init.d/mkpppnode.sh /etc/rcS.d/S98mkpppnode.sh

This creates a symbolic link called “S98mkpppnode.sh in /etc/rcS.d so that the ppp device is automatically created every time you reboot the Pandora.

Step 6

Shutdown and restart the Pandora so the new udev rule we created in “Step 1” is read and the ppp device is created.

NOTE: I tried running “/etc/init.d/udev restart” to avoid the reboot but it did not work and messed up the running system so a shutdown/restart is preferred as the udev init script does not recognise the “restart” argument.

Step 7

After your Pandora has booted up again, log in and plug in your Bandluxe C270 USB modem.

Wait until the LED on your Bandluxe C270 starts blinking once every few seconds.

Check if there are 3 new devices in /dev called ttyUSB0, ttyUSB1 and ttyUSB2.

If there are, then hopefully your device is now recognised and you can connect using your 3G modem by running:

“pon GO “ in a root terminal (replace “GO” with the name you gave the file in Step 2)

If the connection is successful, you should be able to see a new interface called “ppp0” when running:

ifconfig -a

with a newly-assigned IP address

.

Happy 3G surfing with your Pandora!!

Step 8

When finished, to disconnect, type:

“poff GO” in a root terminal (again replacing “GO” with the name you gave the file in Step 2)

That's all folks.

In future I might try to make this procedure a bit more user friendly to avoid having to go into command line everytime to start/stop your connection but for now at least, the hard-headed Bandluxe C270 is working on the Pandora :)

USB compatibility list

2011-08-25T13:19:15Z

Relliker: /* HSDPA (3G) Modems */

This is a list of USB devices that have been tested on the Pandora. If the device you want to know about isn't listed here, don't worry! Just go to [[USB_reference|the USB reference page]], look up the specs of your device, and you may be able to figure out if it's compatible.

= Networking =

Please see the [[Mobile broadband]] page for tips on how to get these working, as well as [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/ this tutorial] from the GP32X forum.

== HSDPA (3G) Modems ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| BandLuxe C270
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| A how-to by relliker for this modem can be found at ---> [http://www.pandorawiki.org]
|-
| Huawei E156G
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/52827-3gumts-usb-dongle/page__view__findpost__p__835681]}}
|
|-
| Huawei E160
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E160E
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| As the entry for Huawei E220 was wrong, this Current draw could also be wrong.
|-
| Huawei E1750
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__939350]}}
|
|-
| [[wikipedia:Huawei E220|Huawei E220]]
| Not required
| Standard-A
| USB 1.1
| 500mA
| Standard-A port via High Speed hub
| {{No|Not on new kernels.}}
| The successful Pandora E220 tests were done by DJWillis on an old kernel (long before Pandora shipped). It seems that they are NOT working any more. Also tested on Linux (was it working?) This entry originally said 250mA, but there is no source and current sources say 500mA.
|-
| 4G-Systems XS Stick P14
| Not required (usbserial module)
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/54318-guide-mobile-broadband-usb-stick-usage/page__view__findpost__p__937681]}}
| Requires usbmodeswitch program.
|-
| iPhone 3GS (Probably also 1G/3G)
| ipheth
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Maybe|Should work in Angstrom with some work.}}
| Requires a good bit of dependencies to get working. Tested with Debian from SD, but should work in Angstrom with some work. The ipheth wwan0 device only provides a connection over the 3G modem, even if you're connected to a wifi network. I used the iproxy and SSH tunneling method with proxychains to get to the wifi network.
|-
| HTC Desire
| not required
| Standard-A
| USB 2.0
| 500mA
| {{Unknown|USB A (Standard-A port?)}}
| {{Yes}}
| Requires internet connection sharing to be enabled from the phone.
|}

== USB to Ethernet adapters ==

To enable USB Ethernet adapters on the Pandora, you may need to left-click the networking icon on the panel in Xfce, and select "Ifupdown (bnep0)".

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Apple USB Ethernet Adapter MB442Z/A
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Reportedly uses an ASIX AX88xxx chipset.
|-
| Apple USB Ethernet Adapter model A1277
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 05ac:1402 Apple, Inc.
|-
| Conrad 3-Port-USB-Hub und Netzwerk-Adapter
| Not required
| Standard-A
| USB 2.0
| A lot! {{HideableNotes|50% of battery charge only brings you 2h40min (min brightness, no other devices attached)}}
| Standard-A port
| {{Yes}}
| Has a 3port USB Hub included. External power supply can (and should) be attached, not included though. ASIX Chipset. 20€ @ [http://www.conrad.de/ce/de/product/976406/NOTEBOOK-MINI-DOCKINGSTATION-USBRJ45/SHOP_AREA_32315&promotionareaSearchDetail=005 Conrad Electronics]. Not tested in Linux.
|-
| Wii USB 2.0 10/100M adapter (use [http://www.asix.com.tw/products.php?op=pItemdetail&PItemID=86;71;101 ASIX AX 88772 USB 2.0 chip])
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772. [http://www.dealextreme.com/details.dx/sku.5926 This clone from DealExtreme] works too.
|-
| Connectland USB 2.0 10/100M Ethernet Adapter
| Not required
| Standard-A
| USB 2.0
| 250mA
| Standard-A port
| {{Yes}}
| ID 0b95:7720 ASIX Electronics Corp. AX88772 - Works fine, Sometimes a reboot is necessary (ZaxxonHF5RC1).
|-
| Belkin Gigabit USB 2.0 Network Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| The shape of it make is a bit awkward to fit if you connect it directly, but it has a short adapter cable. I only get ~95Mbit on a gigabit network, but then the pandora's cpu maxes out. (it may be that the driver/usb stack isn't very well optimized), has horribly bright blue LEDs.
|-
| MosChip MCS7830 USB 10/100 Ethernet adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| ID 9710:7830 MosChip Semiconductor MCS7830 10/100 Mbps Ethernet adapter. Kernel module: mcs7830.
|-
| EU.MARK USB 10/100M RJ45 Ethernet Network Adapter Dongle
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| USB ID: 9710:7830 - bought from [http://www.dealextreme.com/details.dx/sku.22684 DealExtreme]
|-
| Digitus DN-10050 Fast Ethernet USB Adapter
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| MosChip MCS7830-based adapter. USB ID 9710:7830.
|-
| Edimax EU-4230 Fast Ethernet USB Adapter with 3-port USB hub [http://edimax.ie/images/Image/datasheet/USB/EU-4230/EU-4230_Datasheet.pdf]
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{Yes}}
| Ethernet USB ID 0b95:772a ASIX Electronics Corp. 3-port USB2.0 hub USB ID 0409:005a NEC Corp. Optional power adapter for USB hub.
|}

== USB WiFi adapters ==

The Pandora stock kernel doesn't seem to come with any wireless driver support outside of the internal WiFi chip. The only way you'll get wireless working is to build your own kernel with it included or try [http://wireless.kernel.org/en/users/Download compat-wireless].

See also [http://www.gp32x.com/board/index.php?/topic/55570-new-pandora this thread] on the forums for the latest.

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Tested on Pandora
! Additional comments
|-
| Belkin N1 Wireless USB Adapter (F5D8051) ("Ver. 2053") (MARVELL v1021)
| N/A
| Standard-A
| USB 2.0
| {{Unknown}}
| No connection was attempted.
| {{No|No native driver support and ndiswrapper obviously won't work.}}
| There's a previous revision of this dongle which is supposed to have a Ralink chip, but they revised it and put a different chip inside. Reported (by whom?) to work with ndiswrapper and works in Linux.
|-
| Cisco/Linksys AE1000 High Performance Wireless-N USB Adapter
| rt3572sta (RT3572USB)
| Standard-A
| USB 2.0
| {{Unknown}}
| USB A (Standard-A port?)
| {{Yes|Works with a modified driver.}}
| (Compiled module for pandora:[http://boards.openpandora.org/index.php?/topic/1992-linksys-ae1000-usb-wifi/ pandora forum]) Download the driver from [http://www.ralinktech.com/support.php?s=2 ralink's driver site], edit ./common/rtusb_dev_id.c, before "#endif // RT2870" add "{USB_DEVICE(0x13B1,0x002F)},", compile.' Reported (by whom?) to work in Linux.
|}

= Storage =

== External Hard Disk Drives ==
{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! style="min-width: 120px" | Works on Pandora
! Additional comments
|-
| Freecom 250GB 2.5" portable
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Inside it's a Samsung Model HM251JX. {{HideableNotes|So I guess anything based on that will also work OK.}}
|-
| LaCie Rikiki 250GB USB 2.0 2.5" Hard Drive
| Not required
| standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port via powered High Speed Hub
| {{Partial|Not when unpowered, needs testing with a powered hub}}
| Not only does it fail to spin up, but it causes the Pandora's screen to pulsate wildly, much like an old CRT would if you placed a speaker or a magnet near to it. Not tested with a powered hub.
|-
| Seagate Seagate® Expansion™ External Drives
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{No}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14781-hitnrun/ Hitnrun]. "Isn't even detected in lsusb (drive powered by external power source)"
|-
| Verbatim 250GB Model #47580 Hard Drive
| Not required
| Direct
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877512 almatuk]. {{HideableNotes|"Watched videos directly from it at full speed, no need for powered USB hub. Had issues playing roms directly off it however as it was formatted NTFS. I'm sure if I formatted to FAT32 these would disappear."}}
|-
| Western Digital 160GB Elements External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| standard-A port via powered High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB Elements Portable USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or standard-A port via High Speed Hub
| {{Yes}}
|
|-
| Western Digital 250GB My Passport Essential USB 2.0 2.5" Hard Drive
| Not required
| {{Unknown|Direct?}}
| USB 2.0
| {{Unknown}}
| {{Unknown|Direct?}}
| {{Partial|Maybe}}
| Tested by TheDarkSpectrum48K. The first time it [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__877386 "works perfectly!"]. The second time [http://www.gp32x.com/board/index.php?/topic/54509-dont-use-lacie-25-usb-hard-disk-drives-with-a-pandora/page__view__findpost__p__882635 it didn't work].
|-
| Western Digital 400GB My Passport Essential USB 2.0 2.5" HDD model WDME4000TE
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://www.gp32x.com/board/index.php?/user/14534-peca/ Peca].
|-
| Western Digital 500GB Elements Portable External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. {{HideableNotes|The USB cable that came with it was bad, so I used another one.[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949863]}}
|-
| Western Digital 500GB My Passport Essential External Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works fine. {{HideableNotes|Came pre-formatted in NTFS, but should work if you downloaded the community codec pack. It said 1TB on the packaging, but there was 465GB free space, so I'm pretty sure it was actually the 500GB one.}}[http://www.gp32x.com/board/index.php?/topic/59494-solved-how-do-i-get-my-wd-500gb-external-hard-drive-to-work-properly/page__view__findpost__p__949645]
|-
| Western Digital 1TB My Passport Essential SE External USB 2.0 2.5" Hard Drive
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct or through powered High Speed Hub
| {{Yes}}
| Tested by [http://http://www.gp32x.com/board/index.php?/user/19191-mycohl/ Mycohl]. {{HideableNotes|Externally powered hub recommended to conserve battery power.}}
|-
| Western Digital Elements 2TB 3.5" Hard Drive Model:WDBAAU0020HBK
| Not Required
| Standard-A
| USB 2.0
| {{Unknown}}
| Direct
| {{Yes}}
| Tested by [http://boards.openpandora.org/index.php?/user/430-kilowatt/ kilowatt].
|}

== DVD/CD Drives ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Lite-On EZ-DUB DVD/CD Multi-Recorder (Model eZAU120)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter - DC 12V 1.8A
| Standard-A port
| {{No}}
| Works in Linux.
|-
| Memorex 20x Multi Format DVD Recorder External - DVD±RW (±R DL)
| Not required
| Standard-A
| USB 2.0
| Powered by included mains adapter
| Standard-A port
| {{Yes}}
|
|}

= Video display device =

== VGA DVI HDMI adapter ==

No devices have been tested yet

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
|
|
|
|
|
|
|
| No devices have been tested yet
|}

==== External graphic card ====

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Output connectors
! Works on Pandora
! Additional comments
|-
| Tritton see2 usb 2.0 to SVGA adapter
| sisusb
| USB
| USB 2.0
| {{Unknown|High {{HideableNotes|Reduces Pandora's battery life in half (10h → 4h)}}}}
| VGA (D-SUB)
| {{Partial|Yes, but has performance issues.}}
| Needs to be integrated with preferences. {{HideableNotes|Currently I must edit xorg.conf and mess with xinerama.}} Good for presentations, dragging a window is bearable, but hi-res video is slow. Works in Linux without any issues.
|}

= Video capture devices =

== Webcams ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Exoo No Driver/USB 2.0 Webcam (Model No.: M053)
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| Bought from [http://www.dealextreme.com/details.dx/sku.14991 DealExtreme]. Works in Linux.
|-
| Logitech Quickcam Communicate Deluxe
| Not required
| Standard-A
| USB 2.0
| {{Unknown}}
| Standard-A port
| {{No}}
| USB ID: 046d:0992, works though [http://linux-uvc.berlios.de/ uvcvideo]. Works in Linux.
|-
| Logitech HD Webcam C270 720p
| Not required
| Standard-A
| USB 2.0
| 500mA
| Standard-A port
| {{Partial|Yes, but audio untested}}
| ID 046d:0825 Logitech, Inc. Audio recognized, but not tested. More info to come. Works in Linux.
|}

= Audio devices =

== Microphones/recorders ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Zoom H2 Handy Recorder
| not required
| standard-A
| USB 1.1
| 300mA
| standard-A port via High Speed USB hub
| {{Yes|Yes, needs a USB hub.}}
| Can record into Audacity, but won't be recognized unless connected through USB hub.[http://www.gp32x.com/board/index.php?/topic/59301-audacity-1-3-12/page__view__findpost__p__947602].
|}

== MIDI controllers ==

EvilDragon bundled the usb MIDI class drivers in the default firmware image, therefore ANY class-compliant MIDI device should work with the Pandora, out of the box.[http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Akai LKP25
| Not required
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes [http://www.gp32x.com/board/index.php?/topic/58523-zynaddsubfx/page__view__findpost__p__938432]}}
|
|-
| M-Audio MIDISPORT 2x2 Anniv
| Not required
| {{Unknown}}
| {{Unknown}}
| 400mA
| {{Unknown}}
| {{Unknown}}
| ID 0763:1050 Midiman. High current draw!
|-
|}

== USB audio controllers ==

Aka. "professional soundcard"; see [http://en.wikipedia.org/wiki/Sound_card#Professional_soundcards_.28audio_interfaces.29 definition on Wikipedia].

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| Cakewalk UA-1G
| not required
| Standard-A
| USB 2.0
| 200mA
| Standard-A port
| {{No}}
| ID 0582:00e9 Roland Corp. This device may be similar to older Edirol/Roland USB audio devices. Widely reported (by whom?) to work in Linux.
|}

= Input devices =

Any HID ([http://en.wikipedia.org/wiki/Human_interface_device Human Interface Device]) compliant keyboard, mouse or game controller should work on the Pandora. Most of those device are low speed or full speed USB device and will need to be connected though either a USB OTG adapter/cable or a USB2 hub in order to work on the Pandora.

== External Game Controllers ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Suggested connection to Pandora
! Works on Pandora
! Additional comments
|-
| 2-TECH SNES-to-USB adapter
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| USB description is "HuiJia USB GamePad", <tt>lsusb</tt> calls it "0e8f:3013 GreenAsia Inc."
|-
| USB Super RetroPort (SNES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=29 RetroZone]. Works in Linux.
|-
| USB RetroPort (NES-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.retrousb.com/product_info.php?cPath=21&products_id=28 RetroZone]. Works in Linux.
|-
| Trio Linker Plus II (PlayStation,-GameCube,-and-Dreamcast-to-USB adapter)
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Bought from [http://www.play-asia.com/paOS-13-71-6m-49-en-70-1zfv.html Play-Asia]. Works in Linux.
|-
| NAZAR V47 USB Force Feedback Vibrating Gamepad Controller for PC
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.24551 DealExtreme]. Works in Linux.
|-
| 10-Fire-Button Double Vibration Feedback USB PC Arcade Joystick
| Not required
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| Whether it really contains the claimed force feedback feature is unknown as this feature does not work under Linux - bought from [http://www.dealextreme.com/details.dx/sku.27821 DealExtreme]. Works in Linux.
|-
| Official PlayStation 3 controller
| Not required
| Standard-A
| Full speed
| {{Unknown}}
| USB A To Mini B Cable via High Speed Hub
| {{No}}
| This is for USB not bluetooth compatibility. Sixaxis and DualShock not tested. Works in Linux.
|-
| Thrustmaster Firestorm Digital 3 Gamepad
| Not required
| Standard-A
| Low speed
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{Yes}}
| ID 07b5:0213 Mega World International, Ltd Thrustmaster Firestorm Digital 3 Gamepad.
|-
| Wired Xbox 360 Controller
| xpad module
| Standard-A
| {{Unknown|Probably USB 1.1}}
| {{Unknown}}
| Standard-A port via High Speed Hub
| {{No}}
| This also includes gamepads for PC that needs the Windows Xinput driver. Such gamepads include the Logitech Chillstream. Works in Linux.
|-
| WiseGroup.,Ltd SmartJoy Dual PLUS Adapter (dual PSX to USB joypad adapter)
| {{Unknown}}
| Standard-A
| {{Unknown}}
| 100mA
| {{Unknown}}
| {{No}}
| ID 6677:8802. Works in Linux.
|}

== Graphics tablets ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Driver
! Connector
! Supported standard
! Current draw
! Works on Pandora
! Additional comments
|-
| Bamboo Multitouch
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__881806]}}
| It's not known if this works in Linux.
|-
| Genius Tablet
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Yes|Yes, [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__883140 via USB hub]}}
| It's not known if this works in Linux.
|-
| Wacom CTH-460
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{Unknown}}
| {{No|No [http://www.gp32x.com/board/index.php?/topic/54728-pandora-owners-tried-tablet/page__view__findpost__p__924422]}}
| Would need a patched driver to work. It's not known if this works in Linux.
|-
| Wacom Volito2 Tablet (Model: CTF-420)
| Not required
| Standard-A
| Low speed
| 40mA [http://www.my-volito.com/volito/specs.asp?lang=en]
| {{No}}
| USB ID: 056a:0062
|}

== Mice ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Connector
! Works on Pandora
! Additional comments
|-
| Apple Mouse (M5769)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|-
| Apple Mouse with Scroll Ball (A1152)
| USB
| {{No}}
| Seems to disable USB port, reboot afterwards required
|}

= Connectors, adapters, and hubs =

This section is intended as a general guide. Items in this section are standard USB accessories, so drivers are not required. Compatibility with Pandora is assumed. Please note that any external product links are provided for reference only, and are not an endorsement.

== OTG (On The Go) Adapters ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Generic adapter
| {{No}}
| [http://shop.ebay.com/?_from=R40&_trksid=p3907.m38.l1313&_nkw=usb+otg+host+cable&_sacat=See-All-Categories Find on eBay] [http://www.amazon.co.uk/s/ref=nb_ss_ce?url=search-alias%3Delectronics&field-keywords=OTG+Cable+Adapter&x=3&y=23 Find on Amazon] These links are not 100% accurate. Check for `mini-a`, and on eBay, the price is higher by about $8.
|-
| Nokia USB OTG adapter
| {{Yes}}
| [http://www.electronicproductonline.com/catalog/product_info.php?cPath=35_67&products_id=2043 Electronic Product Online]
|}

== Compact USB Hubs ==

{|class="wikitable sortable" border="1" cellpadding="1" cellspacing="0" style="font-size: 90%; border:1px solid gray; border-collapse: collapse; text-align: center; width: 100%;"
|- style="background: #ececec"
! Device
! Works on Pandora
! Additional comments
|-
| Griffin SmartShare USB [http://www.griffintechnology.com/products/smartshare-usb]
| {{No}}
|
|-
| Belkin F5U415 4 Port USB 2.0 Swivel Hub [http://catalog.belkin.com/IWCatProductPage.process?Product_Id=377085]
| {{No}}
| Comes with an optional power adapter.
|-
| Belkin F5U701 USB 2.0 7 Port Mobile Hub [http://www.belkin.com/IWCatProductPage.process?Product_Id=369788]
| {{Yes}}
| Tested by pabloh. Comes with an optional power adapter.
|-
| ID 0e8f:0016 GreenAsia Inc.
| {{No}}
| Tested by tsh. Labeled as high speed. Bought from ebay.
|-
|Trust 4 port netbook hub ID 05e3:0608
| {{Yes}}
| Tested by tsh. Bought from [http://www.amazon.co.uk/gp/product/B0025X16AS Amazon].
|-
| High Speed 4 Port Mini USB 2.0 Hub for Laptop PC (non powered)
| {{Yes}}
| Octopus-style small cheap unpowered USB hub. Bought from [http://cgi.benl.ebay.be/ws/eBayISAPI.dll?ViewItem&item=270538502843 ebay]
|-
| Keeptech USB 2.0 Hub (7 Ports) with Power Adapter, KT-UH703 [http://www.keeptech.com/books_show.php?id=144]
| {{Yes}}
| Tested by [[User:Esn|Esn]]. Works powered or unpowered.
|-
| Logitech Premium 4-Port USB Hub [http://www.logitech.com/en-in/notebook-products/usb-hubs/devices/3048]
| {{Yes}}
|
|-
| LUPO 7-port USB 2.0 Hub (cheap octopus type which can be powered as there is dc socket)
| {{Partial|Yes. {{HideableNotes|Can use a power supply but wasn't tested with one.}}}}
| Tested by kilowatt. Bought from [http://www.amazon.co.uk/gp/product/B003BVDABG/ref=oss_product from amazon uk]
|-
| LogiLink USB 2.0 Hub 4-Port UA0086 [http://www.logilink.eu/showproduct/UA0086.htm]
| {{Yes}}
| Tested by Jones. Comes with an optional power adapter.
|}

[[Category:USB]]
[[Category:List]]

Development tutorials

2011-03-03T13:49:35Z

Relliker: /* SDL Tutorials */

== PND Quickstart ==
See [[PND quickstart]] for a quick and dirty packaging tutorial

== General Game development ==
Just start basic. Follow the Jump'n'Run tutorial (or any of the others). Copy their code. Change bits. Break it.. fix it. Write it over and over until you know what is happening where and why. Get a pandora or GP2X and cross-compile it for those platforms. Run your little creations on other devices (Android phones and iPhones are great). Little milestones like this will keep you motivated to continue learning.

Making a game, or programming a whole project is a massive undertaking. Be prepared to fail the first few attempts... quit at least 5 times only to come back and give it another go... and even then you might have only programmed Mahjong. If, at the end of all this, you are still keen, you can step it up to 3D graphics and start working on "bigger projects".

Remember.. no one can learn to program in a day... and I wouldn't expect anyone who started programming tomorrow to be able to produce a Mario clone, let alone quake 4 in a month.

== ARM Cortex A8 Tutorials ==
* [[Floating Point Optimization]]
* [[Assembly Code Optimization]]

== SDL on Pandora ==

SDL is NOT a game engine, but it will provide you with the foundations for putting stuff on the screen, getting keyboard and controller input and making sounds. All of these are basics in programming games.

You can locate a lot of SDL specific information at [http://www.libsdl.org]

=== Getting started with SDL on the Pandora ===
(This portion assumes you already have a dev environment ready)

First, you need to grab the SDL libraries, you can either compile them yourself or grab some pre compiled libs.
You can get the sources for SDL [http://www.libsdl.org here] and compile it yourself.

Or

You can get the pre compiled libraries [http://www.angstrom-distribution.org/unstable/feed/armv7a/base/ here] (they are named libSDL... etc).
These are ipk files so windows user might need 7zip in order to open them.
You will need both the 'normal' lib and the -dev library.
You might want to get the SDL_image, SDL_mixer and other SDL_* libraries, since these add to general functionality of SDL.

=== Basic Pandora specific SDL Information ===

SDL maps the controlls on the Pandora in the following fashion:

* The Left and Right nubs are represented as Joystick 1 and 2.
* The D-Pad is linked to SDLK_LEFT/RIGHT/UP/DOWN.
* The abxy / lr buttons are (A):home (B):end (X):pgdn (Y):pgup (L):right shift (R): right ctrl
* START(ALT) button : SDLK_LALT
* SELECT(CTRL) button : SDLK_LCTRL

=== SDL Tutorials ===

These tutorials assume you know the basics of C++ programming, and know your way around a C++ compiler.

* [http://www.gp32x.com/board/index.php?/topic/58490-yactfeau/page__view__findpost__p__940518 Getting started with SDL on pandora]
* [http://www.lazyfoo.net/SDL_tutorials/index.php Lazy Foo's Tutorials]. Not Pandora specific, but a good guide to getting your programming environment set up, along with many SDL tutorials.
* [http://iki.fi/sol/gp/ Sol's Graphics for beginners]. Not Pandora specific, but a good place to get started with SDL graphics coding.
* [http://jnrdev.72dpiarmy.com/ 2D Jump'n'Run Tutorial]. (Page not loading as at 03/03/2011. No longer available?)
* [http://gpwiki.org/index.php/Category:All_SDL_articles The Game Programming Wiki's tutorials]

==OpenGL on the Pandora==

*[[OpenGL ES 1.1 Tutorial]]

*[[OpenGL ES 2.0 Tutorial]]

*[[Combining OpenGL ES 1.1 and SDL to create a window on the Pandora]]

*[[Porting_to_GLES_from_GL]]

== The Kernel ==
* [[Kernel build instructions|Compiling the Kernel from Git]]
* [[Kernel interface|Kernel Interface]]

== Matchbox Window Manager ==

* [[Matchbox|Matchbox version]]
* [[xoo on ubuntu|Setting up xoo on Ubuntu 8.04/8.10]] (Theme Testing and Development)

== GLBasic ==

There is a [http://www.glbasic.com/ GLBasic] [[GLBasic tutorial|tutorial on this wiki]] which is still a work in progress, but should get new parts fairly frequently. More information can be found on the [http://www.glbasic.com/forum/ GLBasic forums].

== See Also ==

* [[Development Tools]]

[[Category:Development]]

User manual

2010-04-03T06:59:05Z

Relliker: /* Mouse (stylus/pointer) settings */

<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">     ''This page is an unofficial community project, and Open Pandora Ltd. is not responsible for its content.''</div>

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

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion!

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

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

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

Modifications to hardware can damage your Pandora. [[Open Pandora Ltd]] cannot be held responsible for any resulting damage.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the Pandora [[App Store]], or the websites of trusted developers. See the [[OP-Team Trusted]] image in the [[App Store]] to see if the software application can be trusted.{{Citation needed}}

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 – this will be more than enough to trigger the action you want.

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

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

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

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

:<small><nowiki>*</nowiki>The 600Mhz+ can be higher or lower. This can be controlled by software designed for the device.</small>
:<small><nowiki>**</nowiki>Is affected by use. (example turn bluetooth on or off during play time)</small>

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

==== Features ====
The Pandora 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 Nintendo DS. (See 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!
==== 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Basic Use ==

===Pmenu===

TBD.

===minimenu / mmenu===

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

====The main grid====

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

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

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

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

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

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

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

===Desktop style environment===

====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, but for now, let's just check out the applications on your Pandora.

===Buttons===

====Xfce menu====

The Pandora button will bring up the applications menu, letting you quickly enter a search to locate an application to run or perform operations against running applications.

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes.

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 lowers power use.

The actual behaviour of buttons and events can be customized.

== Basic Linux user guide ==
New to the wonderful world of Linux? No problem! You don't need mad terminal skills to open a web browser, but it can be nice to know what you're doing once in a while.
==== The structure of the file system ====
If you're used to the file system of e.g. MS Windows, you will find that a Linux file system is rather different from what you're used to. In this section, we will go through everything you have to know in order to feel comfortable with using the Pandora's file system.
===== Basic philosophy =====
In Windows, you have multiple file system roots, called "drives", that are labeled with different letters, like "C:" or "D:". In Linux, there aren't multiple root directories, but rather just one root directory, called "/". All other directories are inside of this directory, including other drives.

===== Common directories =====
Inside of the root directory ("/") are quite a lot of other directories. Here are the most important ones:
* "/home" - This is where all of the files that are owned by all users are stored. Users do not generally have write-access to anything outside of this directory.
* "/home/username" - Here are the personal files of user "username". In this directory, you will find a directory called "Documents", "Pictures", "Desktop" etc. that correspond to that users personal directories. This directory is also called "username"'s home directory, and can be abbreviated with "~/" (if you're currently logged in as username) or "~username/".
* "/boot" - This is the directory where the Linux kernel is stored, and other files that are needed at boot time can be accessed. Do not touch this directory (You can't even do it if you wanted to)!
* "/bin", "/lib" - System binaries and libraries are stored here. Most of the terminal commands mentioned below can be found inside of "/bin". You should generally never have to touch this directory, either.
* "/usr" - Here is where you'll find programs and files installed by the user. Core applications such as the web browser, media player, and other applications that are available the first time you start your Pandora are stored here. If you decide to install anything via the "ipkg" command (covered later), this is where the files needed by those installations will end up.
* "/etc" - System-wide configuration. Should only be touched by power-users.
* "/media/*" - If you connect USB drives, SD cards or other external media, you will find that the contents of that media have been placed here.

Don't worry if this doesn't make any sense; It was thought up by bearded engineers back in the seventies. They liked the idea that everything would be in a predictable place, but this is no longer completely the case.

==== The File Manager ====
==== Killing Applications ====
==== Basic Terminal Commands ====
Note: Linux is case sensitive. This applies to filenames and directories too. "/home/me/stuff" is a different folder than "/home/me/STUFF", you can actually have both. You can have "/home/me/Stuff" too if you like, and all three are separately recognised directories.

=====Navigation=====
In the terminal, you are always in some folder. Think of it like being in a file manager: you can see the contents of the directory you're in, you can do things with those files, or you may decide to go to some other folder and continue your work there.

There are a few essential commands that are used to navigate around your system via the terminal:

* "pwd" - Print the current working directory (will print e.g. "/home/user")
* "ls" - List directory contents (similar to "Dir" in Dos, and the Linux command "dir" will actually emulate the DOS command if you want to!)
* "cd <directory name>" - Change to a different directory, eg. "cd music" or "cd /home/me/music"
* "cd .." - Go up one directory level (similar to "cd.." in Dos)
* "cd" - Go back to your home directory (similar to My Documents in Windows)
* "cd -" - Go back to the previous directory you were in (handy if you forget)

=====Controlling Running Apps=====
* "top" - View running processes (like the Task Manager in Windows) press "q" to quit
* "killall [program name] - Stops running process (use with care)

=====File Manipulation=====
* "rm <filename>" - Remove a file, eg. "rm somefile.txt" or "rm /home/me/randomfiles/somefile.txt"
* "rmdir <directory>" - Will remove a directory, but **only** if it is empty!
* "rm -r <directory>" - Will remove a directory and its contents ("-r" means recursive)
* "rm -rf <directory>" - Will remove a directory, all of its contents, without asking you first. Use with extreme care. ("-f" means force)
* "mv <original filename> <new filename>" - Moves a file to a new place, also used for renaming, eg. "mv somefile.txt somefile_backup.txt" will rename it, but "mv somefile.txt /home/me/backup/somefile.txt" will move it. This will also work for directories.
* "cp <file to copy> <new filename>" - Copy a file, eg. "cp twoweeks.txt twomonths.txt" copies into current directory, while "cp twomonths.txt /home/me/ihaveadream/twoweeks.txt" copies to another directory.
* "cp -r <directory to copy> <new directory name>" - Copy a directory and all of its contents to another location.
* "touch <new file name>" - Makes a new (empty) file
* "mkdir <new directory name>" - Makes a directory

=====Misc.=====
* "cat <filename>" - Prints the contents of a file, eg. "cat hellolo.txt"
* "clear" - Clears screen, terminal input begins at the top again
* "date" - Your friend, the terminal will tell you the date
* "cal [month] [year]" - Makes a pretty calendar, eg. "cal 12 2009" or "cal * 2010" or "cal 1 2010 > fingers_crossed.txt" sends output to file
* "history" - Gives a list of the recent commands you have run. Running !number (e.g. !15) will rerun that numbered command in the history list
* "vi <filename>" - Opens the file for editing in vi [http://pandorawiki.org/Vi]

History Search: Press CTRL-R. As you type, BASH will try and find the command in your recent history that most closely matches what you are typing. To get back to the prompt, press CTRL-C.

Autocompletion: Press TAB. The terminal (also called the shell) will attempt to intelligently figure out what you're trying to type. It needs something to work with however, so try pressing TAB half way through a command or location.

eg. "cd /home/me/pandora_suc" *TAB* will complete it as "cd /home/me/pandora_success" or with a filename "cat /home/me/letters/i_want_the_pandora_to_fa" *TAB* will turn into "cat /home/me/letters/i_want_the_pandora_to_fall_into_my_hands"

Directory aliases: There are some special directory names you can use to refer to a directory that would be too long to type otherwise, or that you simply don't know the name of.
* "~" - Refers to your home directory e.g. "/home/user".
* "~seconduser" - Refers to someone else's home directory.
* "." - Refers to the current directory, or the "same directory" in a path. What this means, is that if you type "cd .", nothing will happen since you already are in ".", and if you type "cd somedir/././././././.", you will simply go to "somedir", since the "."-directories that come after it are the "same directory" as the one before them.
* ".." - Refers to the directory in which the current directory is, or the "parent directory" in a path. If you type "cd .." you will come to the parent directory of your current directory, and if you type "cd s1/s2/s3/../../..", nothing will happen, since the path you specified cancels itself out.

== 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 pnd-files (see below, a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

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

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

*The easiest way is to browse the [[Pandora 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 [http://en.wikipedia.org/wiki/Ipkg ipkg].

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

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

== Introduction To .PNDs ==
==== What Are .PNDs? ====

A .pnd ("pandora") file is an application (game, word processor, emulator, whatever.) More accurately, it is a full application bundled up into a single file; think of it like a zip, with a relatively well defined internal structure.

The pnd-file system was designed so you could use an application without the hassle of installation or uninstallation, or even having to organize it yourself if you don't want to. You just download or obtain the pnd-file, and use it.

If you remember classic computers such as the Amiga - where you inserted a disk and then launched the applications read by Workbench (the Amiga's operating system) - then this is similar: when you insert an SD card into one of the two slots, the (Linux based) Pandora OS will scan it for your PND program files. Any program it finds will either turn up on the desktop or the application menu (just like in Windows).

More details can be found in the "libpnd hub" part of the wiki, but that is more oriented to techies and developers.

==== How do I run a PND-application? ====

Put your pnd-files in your SD (see below for some suggestions where.)

A pnd-file is usually invoked in one of the following ways

* browse to the file using the directory browser, and click to run it. (.pnd files are file-associated to another program, pnd_run which knows how to run them.) This lets you organize pnd-files in directories of your choice on the device NAND or SD.

* in PMenu, the applications will be shown by name; you can just select and run them from the menu

* for pnd-files placed into /pandora/menu on SD, the application will be shown in the Start menu on the device; use your stylus or buttons to invoke it

* for pnd-files placed into /pandora/desktop or /pandora/apps on SD, they will show up automatically on your desktop; invoke them with the stylus, your finger, or controls as you see fit

==== Where Do .PNDs Go? ====

Put .pnd-files into specific directories if you want them to show up in the Start menu or on your Pandora desktop, or in Pmenu.

You can put them anywhere you like in internal NAND or SD, if you wish to organize them yourself and launch them with taps.

/pandora/desktop -> pnd files show up on the desktop

/pandora/menu -> show up in the Applications menu (by the developers suggested categories.)

/pandora/apps -> show up in the desktop, and in Pmenu

These locations are not written in stone. The "libpnd" config files are in /etc/pandora/conf in the NAND. Generally you will never need to alter these files, but you certainly can if you wish. In theory, obliterating the files will still leave the system working, and they are easily restored. One file, /etc/pandora/conf/desktop defines the "search paths" to look for .pnd files, and where to put ".desktop" files when they are found. The searchpaths says where to find them (such as /pandora/desktop), and where to put the application link - /usr/share/applications is where the menu items are pulled from. IF you wish to put pnd files somewhere not in the searchpath, just add the directory to the search-path and you're good to go.

==== If I want to override the .PND icon, name, or other settings, how? (Slightly advanced topic)====

The easiest way right now is via the "override" (or "overlay") system -- .ovr files.

An .ovr is just a text file you create, with the same name as the pnd-file and in the same location, but with a different file extension. Piece of cake.

If your pnd-file is Hatari.pnd, and you're putting it into /pandora/desktop, then you might create an ovr file for it as: /pandora/desktop/Hatari.ovr
If you wish to provide your own icon, create it with the same location and filename, but as a .pnd file: /pandora/desktop/Hatari.png

.ovr files are automatically supported by the system so should work across all pnd-application aware applications and desktops. .png icon overrides have to be handled by the menus, but are already handled by minimenu and anythign using the .desktop system (such as xfce full desktop or other standard desktop environments.)

An ovr-file simply looks like this:

The ovr file may (at this time) override the icon title, the CPU clock speed to set on launch, the main category, and the first subcategory for the main category. Additional fields will become overridable.

Minimenu honors up to 3 lines of 'notes', pulled from the .ovr file. (Make sure they are in the right subapp group). note-1, note-2, note-3, see example below. The notes in minimenu are shown at the bottom of the detail text panel.

<source lang="c">
[Application-0]
title HatariHack0
maincategory Audio
maincategorysub1 Emulator
[Application-1]
title HatariHack1
clockspeed 200
note-1 My text for note line 1
</source>

Notice the Application-0 and Application-1 -- any given .pnd file may include multiple applications, so you need to assign your overrides to the correct "sub application". It can be tricky to figure out which subapp you wish to override, but there are some tricks. minimenu, for example, shows the subapp-number in the detail panel. When looking at a .desktop filename, you'll notice #0.desktop .. some number after the # is the subapp-number.

==== Where does my data go? How do I make files visible to the applications? ====

An application normally will see what is contained within the pnd-file, or your personal data created with the tool; it can of course look anywhere on the SD or device internal memory. For example a Quake port might expect to see extra level files in /quake, or give you a way of selecting a path to put files in.. or it might just expect it to be in your personal data folders, or in the pnd-file itself. Its up to the application, with suggestions in the pnd-guidelines for developers.

The first time a pnd-application is run, an "app data" directory is created for it; anything that app data folder contains will be visible to the application as if it was in the pnd-file (and in fact, this lets you override files in the pnd-file without modifying the .pnd itself, which could be handy.) If your app creates a file "foo", it'll show up in /pandora/appdata/appname-id as "foo". The actual appdata folder name depends on the name used by the developer, but should generally look like application-name and some funny number afterwards. It should be easy to spot.

ex: Quake 1 will probably put score or save data in /pandora/appdata/quake1-123/ or somesuch.

It will always be helpful to read the description or readme file included.

===== Example: Hatari =====

Hatari (Atari ST emulator) by default is set to look in "./disks" for the disk images (ROMs) to use. What this means is within the pnd-file (where no disks are supplied), and in the appdata directory. With Hatari, you can browse anywhere from the UI and pick a disk anywhere on your SD cards, but by default it'll look into the ./disks directory.

So you might put Hatari into the menu (/pandora/menu/Hatari131.pnd), or into the desktop (/pandora/desktop/Hatari131.pnd), or somewhere else. Regardless, the appdata will be (with the version I'm building now), /pandora/appdata/hatari.skeezix and thus you would put your .ST or .MSA disk images into /pandora/appdata/hatari.skeezix/disks to make them visible to the emulator. However, given it features its own UI, you can put them into /roms/atarist or /disks or whatever, and use them from there.

===== Q: How do I make ROMs available to an emulator? =====

For something like ROMs, hopefully a developer consensus will lead either to a canonical location, or a convention of having a directory picker or browser present, so that ROMs can be stored in SD locations of your choice; doesn't strike me as something that should be in a pnd-file, or to be pretended to be in a pnd-file with appdata tricks.

===== Q: How do I make pak-files available to Quake? =====

For some add-ons or data needed for a game, the developer may require it to be 'in the main application path'; as mentioned above, just drop it into the appdata folder and the app will just see it.

==== How Do I Make .PNDs? ====
==== More Info About .PNDs ====
Visit [[libpnd_hub]] for more information!
== Configuration ==
==== Updating The Firmware ====

Given a working firmware, you might wish to patch it with official Open Pandora patches; you might also wish to just grab an application from the Angstrom repository, say.

In both of these cases, an ipk file will be made available. (In the future, an automated system may offer to patch up your device or auto-download patches. TBD.)

An ipk file is a compressed installable package.

It should be easily used, but from the Terminal if you wish to manually apply an ipk to patch the firmware, install or update an Angstrom application, it is simple: '''opkg install foo.ipk'''

==== Replacing the Firmware ====

Rather than patch the firmware, the firmware may be replaced wholesale with a freshly downloaded firmware.

==== Booting a Firmware from SD ====

The hardware is capable of booting entirely from SD; if the device is bricked or otherwise has a blank NAND, this could be an option. furthermore you're able to try out alternative operating systems without needing to reinstall your primary operating system.

Steps include:

* Preparing the SD card(s)
* Setting up the firmware on the SD card

=====Preparing the SD card=====

There are two main approaches:

* Setting up the firmware on on SD card (meaning you need two partitions - a boot partition, and a firmware partition), and
* Setting things up across two SD cards - meaning you boot from one SD card, and have the firmware on the other.

Operating from one SD card provides you the option of still being able to use the other; operating across two cards provides you he option to have a regular boot-SD, and flip between multiple other SDs for the actual firmware, should you wish to cycle between many operating systems (say.)

The boot partition generally must be FAT32, and then the kernel, MLO and other files need to be unpacked upon it.

The firmware partition must be either ext2fs or ext3fs; under Linux, such a partition can be easily created:

'''mkfs.ext2 -L LABELNAME /dev/mmcblk0p2'''
- assuming LABELNAME for the partition
- assuming /dev/mmcblk0p2 for your SD device; you'd better check this carefully ;)

==== Setting Up WiFi ====
==== Setting Up Blutooth ====
==== Adjusting Brightness/Contrast ====
==== Changing Your Theme ====
== Oops! I Borked My Pandora! ==
Fear not, young netizen! Your Pandora was designed to be unbrickable, so unless you used the ancient art of alchemy to physically turn your Pandora into a brick (or you just broke the hardware inside), you should be okay!
==== Restore The Original Firmware ====
==== Boot From SD or USB ====
== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

[[Category:Categories]]

User manual

2010-04-03T06:56:21Z

Relliker: /* Calibrating The Touchscreen */

<div style="border-top:1px solid gray; border-bottom:1px solid gray; padding-top:5px; padding-bottom:5px; margin-bottom:20px">     ''This page is an unofficial community project, and Open Pandora Ltd. is not responsible for its content.''</div>

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

Also, don't forget to hit up [http://www.gp32x.com/board/index.php?/forum/61-pandora/ GP32X] for questions/info/apps/fun/discussion!

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

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

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

Modifications to hardware can damage your Pandora. [[Open Pandora Ltd]] cannot be held responsible for any resulting damage.

Malicious software can do horrible things to your Pandora. Only download Pandora software from trusted locations such as the Pandora [[App Store]], or the websites of trusted developers. See the [[OP-Team Trusted]] image in the [[App Store]] to see if the software application can be trusted.{{Citation needed}}

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 – this will be more than enough to trigger the action you want.

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

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

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

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

:<small><nowiki>*</nowiki>The 600Mhz+ can be higher or lower. This can be controlled by software designed for the device.</small>
:<small><nowiki>**</nowiki>Is affected by use. (example turn bluetooth on or off during play time)</small>

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

==== Features ====
The Pandora 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 Nintendo DS. (See 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!
==== 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Basic Use ==

===Pmenu===

TBD.

===minimenu / mmenu===

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

====The main grid====

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

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

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

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

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

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

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

===Desktop style environment===

====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, but for now, let's just check out the applications on your Pandora.

===Buttons===

====Xfce menu====

The Pandora button will bring up the applications menu, letting you quickly enter a search to locate an application to run or perform operations against running applications.

===Power Modes===

Without switching the device entirely off, it may be placed into low power mode or regular power mode; simply pressing the power button will toggle modes.

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 lowers power use.

The actual behaviour of buttons and events can be customized.

== Basic Linux user guide ==
New to the wonderful world of Linux? No problem! You don't need mad terminal skills to open a web browser, but it can be nice to know what you're doing once in a while.
==== The structure of the file system ====
If you're used to the file system of e.g. MS Windows, you will find that a Linux file system is rather different from what you're used to. In this section, we will go through everything you have to know in order to feel comfortable with using the Pandora's file system.
===== Basic philosophy =====
In Windows, you have multiple file system roots, called "drives", that are labeled with different letters, like "C:" or "D:". In Linux, there aren't multiple root directories, but rather just one root directory, called "/". All other directories are inside of this directory, including other drives.

===== Common directories =====
Inside of the root directory ("/") are quite a lot of other directories. Here are the most important ones:
* "/home" - This is where all of the files that are owned by all users are stored. Users do not generally have write-access to anything outside of this directory.
* "/home/username" - Here are the personal files of user "username". In this directory, you will find a directory called "Documents", "Pictures", "Desktop" etc. that correspond to that users personal directories. This directory is also called "username"'s home directory, and can be abbreviated with "~/" (if you're currently logged in as username) or "~username/".
* "/boot" - This is the directory where the Linux kernel is stored, and other files that are needed at boot time can be accessed. Do not touch this directory (You can't even do it if you wanted to)!
* "/bin", "/lib" - System binaries and libraries are stored here. Most of the terminal commands mentioned below can be found inside of "/bin". You should generally never have to touch this directory, either.
* "/usr" - Here is where you'll find programs and files installed by the user. Core applications such as the web browser, media player, and other applications that are available the first time you start your Pandora are stored here. If you decide to install anything via the "ipkg" command (covered later), this is where the files needed by those installations will end up.
* "/etc" - System-wide configuration. Should only be touched by power-users.
* "/media/*" - If you connect USB drives, SD cards or other external media, you will find that the contents of that media have been placed here.

Don't worry if this doesn't make any sense; It was thought up by bearded engineers back in the seventies. They liked the idea that everything would be in a predictable place, but this is no longer completely the case.

==== The File Manager ====
==== Killing Applications ====
==== Basic Terminal Commands ====
Note: Linux is case sensitive. This applies to filenames and directories too. "/home/me/stuff" is a different folder than "/home/me/STUFF", you can actually have both. You can have "/home/me/Stuff" too if you like, and all three are separately recognised directories.

=====Navigation=====
In the terminal, you are always in some folder. Think of it like being in a file manager: you can see the contents of the directory you're in, you can do things with those files, or you may decide to go to some other folder and continue your work there.

There are a few essential commands that are used to navigate around your system via the terminal:

* "pwd" - Print the current working directory (will print e.g. "/home/user")
* "ls" - List directory contents (similar to "Dir" in Dos, and the Linux command "dir" will actually emulate the DOS command if you want to!)
* "cd <directory name>" - Change to a different directory, eg. "cd music" or "cd /home/me/music"
* "cd .." - Go up one directory level (similar to "cd.." in Dos)
* "cd" - Go back to your home directory (similar to My Documents in Windows)
* "cd -" - Go back to the previous directory you were in (handy if you forget)

=====Controlling Running Apps=====
* "top" - View running processes (like the Task Manager in Windows) press "q" to quit
* "killall [program name] - Stops running process (use with care)

=====File Manipulation=====
* "rm <filename>" - Remove a file, eg. "rm somefile.txt" or "rm /home/me/randomfiles/somefile.txt"
* "rmdir <directory>" - Will remove a directory, but **only** if it is empty!
* "rm -r <directory>" - Will remove a directory and its contents ("-r" means recursive)
* "rm -rf <directory>" - Will remove a directory, all of its contents, without asking you first. Use with extreme care. ("-f" means force)
* "mv <original filename> <new filename>" - Moves a file to a new place, also used for renaming, eg. "mv somefile.txt somefile_backup.txt" will rename it, but "mv somefile.txt /home/me/backup/somefile.txt" will move it. This will also work for directories.
* "cp <file to copy> <new filename>" - Copy a file, eg. "cp twoweeks.txt twomonths.txt" copies into current directory, while "cp twomonths.txt /home/me/ihaveadream/twoweeks.txt" copies to another directory.
* "cp -r <directory to copy> <new directory name>" - Copy a directory and all of its contents to another location.
* "touch <new file name>" - Makes a new (empty) file
* "mkdir <new directory name>" - Makes a directory

=====Misc.=====
* "cat <filename>" - Prints the contents of a file, eg. "cat hellolo.txt"
* "clear" - Clears screen, terminal input begins at the top again
* "date" - Your friend, the terminal will tell you the date
* "cal [month] [year]" - Makes a pretty calendar, eg. "cal 12 2009" or "cal * 2010" or "cal 1 2010 > fingers_crossed.txt" sends output to file
* "history" - Gives a list of the recent commands you have run. Running !number (e.g. !15) will rerun that numbered command in the history list
* "vi <filename>" - Opens the file for editing in vi [http://pandorawiki.org/Vi]

History Search: Press CTRL-R. As you type, BASH will try and find the command in your recent history that most closely matches what you are typing. To get back to the prompt, press CTRL-C.

Autocompletion: Press TAB. The terminal (also called the shell) will attempt to intelligently figure out what you're trying to type. It needs something to work with however, so try pressing TAB half way through a command or location.

eg. "cd /home/me/pandora_suc" *TAB* will complete it as "cd /home/me/pandora_success" or with a filename "cat /home/me/letters/i_want_the_pandora_to_fa" *TAB* will turn into "cat /home/me/letters/i_want_the_pandora_to_fall_into_my_hands"

Directory aliases: There are some special directory names you can use to refer to a directory that would be too long to type otherwise, or that you simply don't know the name of.
* "~" - Refers to your home directory e.g. "/home/user".
* "~seconduser" - Refers to someone else's home directory.
* "." - Refers to the current directory, or the "same directory" in a path. What this means, is that if you type "cd .", nothing will happen since you already are in ".", and if you type "cd somedir/././././././.", you will simply go to "somedir", since the "."-directories that come after it are the "same directory" as the one before them.
* ".." - Refers to the directory in which the current directory is, or the "parent directory" in a path. If you type "cd .." you will come to the parent directory of your current directory, and if you type "cd s1/s2/s3/../../..", nothing will happen, since the path you specified cancels itself out.

== 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 pnd-files (see below, a packaged up single file representing an entire application) or as regular Linux files (an application likely being made up of many files and possibly needing installation.)

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

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

*The easiest way is to browse the [[Pandora 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 [http://en.wikipedia.org/wiki/Ipkg ipkg].

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

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

== Introduction To .PNDs ==
==== What Are .PNDs? ====

A .pnd ("pandora") file is an application (game, word processor, emulator, whatever.) More accurately, it is a full application bundled up into a single file; think of it like a zip, with a relatively well defined internal structure.

The pnd-file system was designed so you could use an application without the hassle of installation or uninstallation, or even having to organize it yourself if you don't want to. You just download or obtain the pnd-file, and use it.

If you remember classic computers such as the Amiga - where you inserted a disk and then launched the applications read by Workbench (the Amiga's operating system) - then this is similar: when you insert an SD card into one of the two slots, the (Linux based) Pandora OS will scan it for your PND program files. Any program it finds will either turn up on the desktop or the application menu (just like in Windows).

More details can be found in the "libpnd hub" part of the wiki, but that is more oriented to techies and developers.

==== How do I run a PND-application? ====

Put your pnd-files in your SD (see below for some suggestions where.)

A pnd-file is usually invoked in one of the following ways

* browse to the file using the directory browser, and click to run it. (.pnd files are file-associated to another program, pnd_run which knows how to run them.) This lets you organize pnd-files in directories of your choice on the device NAND or SD.

* in PMenu, the applications will be shown by name; you can just select and run them from the menu

* for pnd-files placed into /pandora/menu on SD, the application will be shown in the Start menu on the device; use your stylus or buttons to invoke it

* for pnd-files placed into /pandora/desktop or /pandora/apps on SD, they will show up automatically on your desktop; invoke them with the stylus, your finger, or controls as you see fit

==== Where Do .PNDs Go? ====

Put .pnd-files into specific directories if you want them to show up in the Start menu or on your Pandora desktop, or in Pmenu.

You can put them anywhere you like in internal NAND or SD, if you wish to organize them yourself and launch them with taps.

/pandora/desktop -> pnd files show up on the desktop

/pandora/menu -> show up in the Applications menu (by the developers suggested categories.)

/pandora/apps -> show up in the desktop, and in Pmenu

These locations are not written in stone. The "libpnd" config files are in /etc/pandora/conf in the NAND. Generally you will never need to alter these files, but you certainly can if you wish. In theory, obliterating the files will still leave the system working, and they are easily restored. One file, /etc/pandora/conf/desktop defines the "search paths" to look for .pnd files, and where to put ".desktop" files when they are found. The searchpaths says where to find them (such as /pandora/desktop), and where to put the application link - /usr/share/applications is where the menu items are pulled from. IF you wish to put pnd files somewhere not in the searchpath, just add the directory to the search-path and you're good to go.

==== If I want to override the .PND icon, name, or other settings, how? (Slightly advanced topic)====

The easiest way right now is via the "override" (or "overlay") system -- .ovr files.

An .ovr is just a text file you create, with the same name as the pnd-file and in the same location, but with a different file extension. Piece of cake.

If your pnd-file is Hatari.pnd, and you're putting it into /pandora/desktop, then you might create an ovr file for it as: /pandora/desktop/Hatari.ovr
If you wish to provide your own icon, create it with the same location and filename, but as a .pnd file: /pandora/desktop/Hatari.png

.ovr files are automatically supported by the system so should work across all pnd-application aware applications and desktops. .png icon overrides have to be handled by the menus, but are already handled by minimenu and anythign using the .desktop system (such as xfce full desktop or other standard desktop environments.)

An ovr-file simply looks like this:

The ovr file may (at this time) override the icon title, the CPU clock speed to set on launch, the main category, and the first subcategory for the main category. Additional fields will become overridable.

Minimenu honors up to 3 lines of 'notes', pulled from the .ovr file. (Make sure they are in the right subapp group). note-1, note-2, note-3, see example below. The notes in minimenu are shown at the bottom of the detail text panel.

<source lang="c">
[Application-0]
title HatariHack0
maincategory Audio
maincategorysub1 Emulator
[Application-1]
title HatariHack1
clockspeed 200
note-1 My text for note line 1
</source>

Notice the Application-0 and Application-1 -- any given .pnd file may include multiple applications, so you need to assign your overrides to the correct "sub application". It can be tricky to figure out which subapp you wish to override, but there are some tricks. minimenu, for example, shows the subapp-number in the detail panel. When looking at a .desktop filename, you'll notice #0.desktop .. some number after the # is the subapp-number.

==== Where does my data go? How do I make files visible to the applications? ====

An application normally will see what is contained within the pnd-file, or your personal data created with the tool; it can of course look anywhere on the SD or device internal memory. For example a Quake port might expect to see extra level files in /quake, or give you a way of selecting a path to put files in.. or it might just expect it to be in your personal data folders, or in the pnd-file itself. Its up to the application, with suggestions in the pnd-guidelines for developers.

The first time a pnd-application is run, an "app data" directory is created for it; anything that app data folder contains will be visible to the application as if it was in the pnd-file (and in fact, this lets you override files in the pnd-file without modifying the .pnd itself, which could be handy.) If your app creates a file "foo", it'll show up in /pandora/appdata/appname-id as "foo". The actual appdata folder name depends on the name used by the developer, but should generally look like application-name and some funny number afterwards. It should be easy to spot.

ex: Quake 1 will probably put score or save data in /pandora/appdata/quake1-123/ or somesuch.

It will always be helpful to read the description or readme file included.

===== Example: Hatari =====

Hatari (Atari ST emulator) by default is set to look in "./disks" for the disk images (ROMs) to use. What this means is within the pnd-file (where no disks are supplied), and in the appdata directory. With Hatari, you can browse anywhere from the UI and pick a disk anywhere on your SD cards, but by default it'll look into the ./disks directory.

So you might put Hatari into the menu (/pandora/menu/Hatari131.pnd), or into the desktop (/pandora/desktop/Hatari131.pnd), or somewhere else. Regardless, the appdata will be (with the version I'm building now), /pandora/appdata/hatari.skeezix and thus you would put your .ST or .MSA disk images into /pandora/appdata/hatari.skeezix/disks to make them visible to the emulator. However, given it features its own UI, you can put them into /roms/atarist or /disks or whatever, and use them from there.

===== Q: How do I make ROMs available to an emulator? =====

For something like ROMs, hopefully a developer consensus will lead either to a canonical location, or a convention of having a directory picker or browser present, so that ROMs can be stored in SD locations of your choice; doesn't strike me as something that should be in a pnd-file, or to be pretended to be in a pnd-file with appdata tricks.

===== Q: How do I make pak-files available to Quake? =====

For some add-ons or data needed for a game, the developer may require it to be 'in the main application path'; as mentioned above, just drop it into the appdata folder and the app will just see it.

==== How Do I Make .PNDs? ====
==== More Info About .PNDs ====
Visit [[libpnd_hub]] for more information!
== Configuration ==
==== Updating The Firmware ====

Given a working firmware, you might wish to patch it with official Open Pandora patches; you might also wish to just grab an application from the Angstrom repository, say.

In both of these cases, an ipk file will be made available. (In the future, an automated system may offer to patch up your device or auto-download patches. TBD.)

An ipk file is a compressed installable package.

It should be easily used, but from the Terminal if you wish to manually apply an ipk to patch the firmware, install or update an Angstrom application, it is simple: '''opkg install foo.ipk'''

==== Replacing the Firmware ====

Rather than patch the firmware, the firmware may be replaced wholesale with a freshly downloaded firmware.

==== Booting a Firmware from SD ====

The hardware is capable of booting entirely from SD; if the device is bricked or otherwise has a blank NAND, this could be an option. furthermore you're able to try out alternative operating systems without needing to reinstall your primary operating system.

Steps include:

* Preparing the SD card(s)
* Setting up the firmware on the SD card

=====Preparing the SD card=====

There are two main approaches:

* Setting up the firmware on on SD card (meaning you need two partitions - a boot partition, and a firmware partition), and
* Setting things up across two SD cards - meaning you boot from one SD card, and have the firmware on the other.

Operating from one SD card provides you the option of still being able to use the other; operating across two cards provides you he option to have a regular boot-SD, and flip between multiple other SDs for the actual firmware, should you wish to cycle between many operating systems (say.)

The boot partition generally must be FAT32, and then the kernel, MLO and other files need to be unpacked upon it.

The firmware partition must be either ext2fs or ext3fs; under Linux, such a partition can be easily created:

'''mkfs.ext2 -L LABELNAME /dev/mmcblk0p2'''
- assuming LABELNAME for the partition
- assuming /dev/mmcblk0p2 for your SD device; you'd better check this carefully ;)

==== Setting Up WiFi ====
==== Setting Up Blutooth ====
==== Adjusting Brightness/Contrast ====
==== Changing Your Theme ====
== Oops! I Borked My Pandora! ==
Fear not, young netizen! Your Pandora was designed to be unbrickable, so unless you used the ancient art of alchemy to physically turn your Pandora into a brick (or you just broke the hardware inside), you should be okay!
==== Restore The Original Firmware ====
==== Boot From SD or USB ====
== Pandora FAQ ==
Silly goose, go to the [[FAQ]] page for more detailed information.

[[Category:Categories]]