Pandora Wiki - User contributions [en]

Ångström

2012-10-04T20:49:58Z

Yamara: /* SuperZaxxon Hotfixes */ Added SuperZaxxon final link

{{FIXME|How do I know what hotfix I have? (spiralofhope has notes somewhere)}}
= Note =

In general it's possible to apply hotfixes to any lower firmware versions without installing all previous hotfixes.

For the easy and up-to-date firmware install, go to the [http://www.open-pandora.org OpenPandora website]
under Community and Support, and choose Official Updates and Firmware.
[http://www.open-pandora.org/index.php?option=com_content&view=article&id=199&Itemid=40&lang=en Here's a link as of Oct 2012.]

= SuperZaxxon Hotfixes =

[http://boards.openpandora.org/index.php?/topic/9002-superzaxxon-final-released/ Jun 28 2012 SuperZaxxon final released]

= Zaxxon Hotfixes =

The original [[Zaxxon]] firmware has been updated with a number of Hotfixes. Since then, a newer firmware called SuperZaxxon has been released.

'''Warning:''' If you do not have Zaxxon installed (boot screen says SuperZaxxon or something else), do not attempt to install any of these hofixes, doing so will break the system.

== Hotfix 6 ==

* [http://boards.openpandora.org/index.php?/topic/5652-hotfix-6-final-released/ Information and discussion] (2011-10-10)
* [http://www.openpandora.org/downloads/Zaxxon-HF6.zip Full flash update] (will delete all prior user settings; useful if you've screwed something up and are not sure of how to fix it)

=== Bugs and solutions ===

In general, the latest information about bugs will be on the official [http://bugs.openpandora.org/ bugtracker]; that is also the best place to go report a bug.

==== PNDs won't run ====

So you can start Xfce, but you can no longer run any programs or switch to Minimenu since you upgraded to HF6?

This can easily be solved without a reflash.

: [http://boards.openpandora.org/index.php?app=forums&module=forums&section=findpost&pid=98627 valhalla] This problem is because of version 1.0-r58.5 of the pandora-scripts package that includes some files that it should not have included and conflicts with the new version of pandora-libpnd. That version is installed at least in HF5rc2.

# Open a terminal in the location where you put your HF6 update PND. In the default file browser, you can do this by right-clicking in the folder where the PND is, and selecting "open terminal here". For example, if you put it on your desktop (<code>/pandora/desktop</code>), the text in the terminal to the left of your cursor should look something like <code>username-openpandora:/media/pandora/mmcblk0p1/pandora/desktop$</code>
# Type in <code>sudo mkdir /mnt/pnd</code> and press "enter". If it asks you for your password, type in what you use to log in to your Pandora, then press "enter".
# Type in <code>sudo mount -o loop HF6-Updater.pnd /mnt/pnd</code> and press "enter"
# Now we'll go to the packages directory in the PND and reinstall a couple of packages. Type in <code>cd /mnt/pnd/packages/other/</code> and press "enter"
# Type in <code>sudo opkg install pandora-libpnd_1.0-r56.5_armv7a.ipk</code> and press "enter"
# Type in <code>sudo opkg install pandora-skel_1.0-r9.5_omap3-pandora.ipk</code> and press "enter"
# To unmount the PND, type in <code>sudo umount /mnt/pnd</code> and press "enter". If it says it can't unmount it, just restart your Pandora.
# That's it, your Pandora should work again!

===Beta versions===

* [http://boards.openpandora.org/index.php?/topic/5616-hotfix-6-rc-released/ RC] (2011-10-07)
* [http://boards.openpandora.org/index.php?/topic/5320-zaxxon-hotfix-6-beta-1-released/ Beta 1] (2011-09-14)
* [http://boards.openpandora.org/index.php?/topic/4118-hotfix-6-alpha-4-released/ Alpha 4] (2011-06-21)
* [http://boards.openpandora.org/index.php?/topic/4065-hotfix-6-alpha-3-out/ Alpha 3] (2011-06-17)
* [http://boards.openpandora.org/index.php?/topic/4056-hotfix-6-alpha-2-is-out/ Alpha 2] (2011-06-16)
* [http://boards.openpandora.org/index.php?/topic/3955-hotfix-6-alpha-1-released/ Alpha 1] (2011-06-09)

== Hotfix 5 ==

* Information and discussion: [http://boards.openpandora.org/index.php?/topic/2080-hotfix-5-released/ OP] [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ GP32X] (2011-03-04)

===Beta versions===

* RC2: [http://boards.openpandora.org/index.php?/topic/1877-hotfix-5-rc2-last-one-before-going-final/ OP] [http://www.gp32x.com/board/index.php?/topic/58779-hotfix-5-rc2-last-one-before-going-final/ GP32X] (2011-02-22)
* RC1: [http://boards.openpandora.org/index.php?/topic/1572-hotfix-5-rc-1-ready-for-testing/ OP] [http://www.gp32x.com/board/index.php?/topic/58598-hotfix-5-rc-1-ready-for-testing/ GP32X] (2011-02-09)
* [http://boards.openpandora.org/index.php?/topic/1418-beta-test-upcoming-hf5-firmware-image-beta-4/ Beta 4] (2011-02-01)
* [http://boards.openpandora.org/index.php?/topic/1316-beta-test-upcoming-hf5-firmware-image-beta-3/ Beta 3] (2011-01-28)
* [http://boards.openpandora.org/index.php?/topic/1209-beta-test-upcoming-hf5-firmware-image-beta-2/ Beta 2] (2011-01-23)
* [http://boards.openpandora.org/index.php?/topic/1115-beta-test-upcoming-hf5-firmware-image/ Beta 1] (2011-01-17)

== Hotfix 4 ==

* Information and discussion: [http://boards.openpandora.org/index.php?/topic/90-pandora-hotfix-4-final-released-2010-08-31/ OP] [http://www.gp32x.com/board/index.php?/topic/56385-hotfix-4-final-released/ GP32X] (2010-08-31)

=== Beta versions ===

* Beta 4: [http://boards.openpandora.org/index.php?/topic/69-hotfix-4-beta-4-released/ OP] [http://www.gp32x.com/board/index.php?/topic/56361-hotfix-4-beta-4-pre-final/ GP32X] (2010-08-29)
* Beta 3: [http://boards.openpandora.org/index.php?/topic/17-hotfix-4-beta-3-released/ OP] [http://www.gp32x.com/board/index.php?/topic/56266-hotfix-4-beta-3-released/ GP32X] (2010-08-27)
* [http://www.gp32x.com/board/index.php?/topic/55965-hotfix-4-beta-2/ Beta 2] (2010-08-15)
* [http://www.gp32x.com/board/index.php?/topic/55788-hotfix-4-very-first-beta/ Beta 1] (2010-08-07)

== Hotfix 3 ==

* [http://www.gp32x.com/board/index.php?/topic/54933-hotfix-3-released/ Information and discussion] (2010-07-01)

=== Beta versions ===

* [http://www.gp32x.com/board/index.php?/topic/54852-pandora-hotfix-3-beta-2/ Beta 2] (2010-06-29)
* [http://www.gp32x.com/board/index.php?/topic/54724-pandora-hotfix-3-beta-test/ Beta 1] (2010-06-25)

== Hotfix 2 ==

* [http://www.gp32x.com/board/index.php?/topic/54171-hotfix-2-for-zaxxon-released/ Information and discussion] (2010-06-08)

=== Beta versions ===

* [http://www.gp32x.com/board/index.php?/topic/54137-pandora-hotfix-pack-2-for-zaxxon/ Beta 1] (2010-06-08)

== Hotfix 1 ==

* [http://www.gp32x.com/board/index.php?/topic/53580-hotfix-pack-1-and-community-codec-pack-released/ Information and discussion] (2010-05-24)

== Original firmware ==

* You can download the very first release of the Pandora's [[Zaxxon]] firmware from [http://notaz.gp2x.de/releases/pandora/pandora-firmware-2010-05-01-Zaxxon.zip here] (2010-05-01)

[[Category:Software]]

Ångström

2012-10-04T20:47:37Z

Yamara: /* Note */ updated with link to general hotfixes

{{FIXME|How do I know what hotfix I have? (spiralofhope has notes somewhere)}}
= Note =

In general it's possible to apply hotfixes to any lower firmware versions without installing all previous hotfixes.

For the easy and up-to-date firmware install, go to the [http://www.open-pandora.org OpenPandora website]
under Community and Support, and choose Official Updates and Firmware.
[http://www.open-pandora.org/index.php?option=com_content&view=article&id=199&Itemid=40&lang=en Here's a link as of Oct 2012.]

= SuperZaxxon Hotfixes =

As of 2012-05-24, SuperZaxxon is still in beta. Hotfixes may be published later.

= Zaxxon Hotfixes =

The original [[Zaxxon]] firmware has been updated with a number of Hotfixes. Since then, a newer firmware called SuperZaxxon has been released.

'''Warning:''' If you do not have Zaxxon installed (boot screen says SuperZaxxon or something else), do not attempt to install any of these hofixes, doing so will break the system.

== Hotfix 6 ==

* [http://boards.openpandora.org/index.php?/topic/5652-hotfix-6-final-released/ Information and discussion] (2011-10-10)
* [http://www.openpandora.org/downloads/Zaxxon-HF6.zip Full flash update] (will delete all prior user settings; useful if you've screwed something up and are not sure of how to fix it)

=== Bugs and solutions ===

In general, the latest information about bugs will be on the official [http://bugs.openpandora.org/ bugtracker]; that is also the best place to go report a bug.

==== PNDs won't run ====

So you can start Xfce, but you can no longer run any programs or switch to Minimenu since you upgraded to HF6?

This can easily be solved without a reflash.

: [http://boards.openpandora.org/index.php?app=forums&module=forums&section=findpost&pid=98627 valhalla] This problem is because of version 1.0-r58.5 of the pandora-scripts package that includes some files that it should not have included and conflicts with the new version of pandora-libpnd. That version is installed at least in HF5rc2.

# Open a terminal in the location where you put your HF6 update PND. In the default file browser, you can do this by right-clicking in the folder where the PND is, and selecting "open terminal here". For example, if you put it on your desktop (<code>/pandora/desktop</code>), the text in the terminal to the left of your cursor should look something like <code>username-openpandora:/media/pandora/mmcblk0p1/pandora/desktop$</code>
# Type in <code>sudo mkdir /mnt/pnd</code> and press "enter". If it asks you for your password, type in what you use to log in to your Pandora, then press "enter".
# Type in <code>sudo mount -o loop HF6-Updater.pnd /mnt/pnd</code> and press "enter"
# Now we'll go to the packages directory in the PND and reinstall a couple of packages. Type in <code>cd /mnt/pnd/packages/other/</code> and press "enter"
# Type in <code>sudo opkg install pandora-libpnd_1.0-r56.5_armv7a.ipk</code> and press "enter"
# Type in <code>sudo opkg install pandora-skel_1.0-r9.5_omap3-pandora.ipk</code> and press "enter"
# To unmount the PND, type in <code>sudo umount /mnt/pnd</code> and press "enter". If it says it can't unmount it, just restart your Pandora.
# That's it, your Pandora should work again!

===Beta versions===

* [http://boards.openpandora.org/index.php?/topic/5616-hotfix-6-rc-released/ RC] (2011-10-07)
* [http://boards.openpandora.org/index.php?/topic/5320-zaxxon-hotfix-6-beta-1-released/ Beta 1] (2011-09-14)
* [http://boards.openpandora.org/index.php?/topic/4118-hotfix-6-alpha-4-released/ Alpha 4] (2011-06-21)
* [http://boards.openpandora.org/index.php?/topic/4065-hotfix-6-alpha-3-out/ Alpha 3] (2011-06-17)
* [http://boards.openpandora.org/index.php?/topic/4056-hotfix-6-alpha-2-is-out/ Alpha 2] (2011-06-16)
* [http://boards.openpandora.org/index.php?/topic/3955-hotfix-6-alpha-1-released/ Alpha 1] (2011-06-09)

== Hotfix 5 ==

* Information and discussion: [http://boards.openpandora.org/index.php?/topic/2080-hotfix-5-released/ OP] [http://www.gp32x.com/board/index.php?/topic/58867-hotfix-5-released/ GP32X] (2011-03-04)

===Beta versions===

* RC2: [http://boards.openpandora.org/index.php?/topic/1877-hotfix-5-rc2-last-one-before-going-final/ OP] [http://www.gp32x.com/board/index.php?/topic/58779-hotfix-5-rc2-last-one-before-going-final/ GP32X] (2011-02-22)
* RC1: [http://boards.openpandora.org/index.php?/topic/1572-hotfix-5-rc-1-ready-for-testing/ OP] [http://www.gp32x.com/board/index.php?/topic/58598-hotfix-5-rc-1-ready-for-testing/ GP32X] (2011-02-09)
* [http://boards.openpandora.org/index.php?/topic/1418-beta-test-upcoming-hf5-firmware-image-beta-4/ Beta 4] (2011-02-01)
* [http://boards.openpandora.org/index.php?/topic/1316-beta-test-upcoming-hf5-firmware-image-beta-3/ Beta 3] (2011-01-28)
* [http://boards.openpandora.org/index.php?/topic/1209-beta-test-upcoming-hf5-firmware-image-beta-2/ Beta 2] (2011-01-23)
* [http://boards.openpandora.org/index.php?/topic/1115-beta-test-upcoming-hf5-firmware-image/ Beta 1] (2011-01-17)

== Hotfix 4 ==

* Information and discussion: [http://boards.openpandora.org/index.php?/topic/90-pandora-hotfix-4-final-released-2010-08-31/ OP] [http://www.gp32x.com/board/index.php?/topic/56385-hotfix-4-final-released/ GP32X] (2010-08-31)

=== Beta versions ===

* Beta 4: [http://boards.openpandora.org/index.php?/topic/69-hotfix-4-beta-4-released/ OP] [http://www.gp32x.com/board/index.php?/topic/56361-hotfix-4-beta-4-pre-final/ GP32X] (2010-08-29)
* Beta 3: [http://boards.openpandora.org/index.php?/topic/17-hotfix-4-beta-3-released/ OP] [http://www.gp32x.com/board/index.php?/topic/56266-hotfix-4-beta-3-released/ GP32X] (2010-08-27)
* [http://www.gp32x.com/board/index.php?/topic/55965-hotfix-4-beta-2/ Beta 2] (2010-08-15)
* [http://www.gp32x.com/board/index.php?/topic/55788-hotfix-4-very-first-beta/ Beta 1] (2010-08-07)

== Hotfix 3 ==

* [http://www.gp32x.com/board/index.php?/topic/54933-hotfix-3-released/ Information and discussion] (2010-07-01)

=== Beta versions ===

* [http://www.gp32x.com/board/index.php?/topic/54852-pandora-hotfix-3-beta-2/ Beta 2] (2010-06-29)
* [http://www.gp32x.com/board/index.php?/topic/54724-pandora-hotfix-3-beta-test/ Beta 1] (2010-06-25)

== Hotfix 2 ==

* [http://www.gp32x.com/board/index.php?/topic/54171-hotfix-2-for-zaxxon-released/ Information and discussion] (2010-06-08)

=== Beta versions ===

* [http://www.gp32x.com/board/index.php?/topic/54137-pandora-hotfix-pack-2-for-zaxxon/ Beta 1] (2010-06-08)

== Hotfix 1 ==

* [http://www.gp32x.com/board/index.php?/topic/53580-hotfix-pack-1-and-community-codec-pack-released/ Information and discussion] (2010-05-24)

== Original firmware ==

* You can download the very first release of the Pandora's [[Zaxxon]] firmware from [http://notaz.gp2x.de/releases/pandora/pandora-firmware-2010-05-01-Zaxxon.zip here] (2010-05-01)

[[Category:Software]]

Logo

2011-05-19T18:47:03Z

Yamara: /* High Resolution Logo */ Wiki is not properly making thumbnails. Changed image back to original media download link.

== High Resolution Logo ==
People keep asking for the logo, so in the interest of helping out, I re-drew the drawing. Here's the logo in PDF & SVG (using RGB colors as people are making things for screen use). I didn't have a high resolution copy to work from, so I did my best in the time I had. I do not know what the font is, and craigix has stated he believes it to be drawn.

* [[Media:Pandora_logo-unofficial.pdf]]
* [[Media:Pandora_logo-unofficial.svg]]

== Logo Colors ==

For those doing print or reproducing the logo, the CMYK colors are:
* box logo: 100% cyan, 75% black
* word logo: 100% cyan, 20% black

== Logo Use ==

I suspect there are no logo use rules at present, and so I'll just make some general design suggestions. Don't change the spacing between the letters. When presented side-by-side, try not to change the spacing between the box and the word logo. In general, don't overlay the word logo over the box (unless perhaps the box logo is enormous) as the legibility of both would suffer. The logo is best presented in solid colors, and the letters in the word logo should be of the same color. When scaling the logo, preserve the aspect ratio of height to width. (These are merely suggestions of best use, but design is about pushing boundaries, and so some rules can be a bit flexible.)

I do not know the designer of the logo, and I imagine the logo copyright is owned by OpenPandora. Ask them, or check their web page for rights reserved.

[[Category:Community]]

Controllers

2011-03-17T20:53:01Z

Yamara: /* PRECAUTION */

This includes instructions on installing software and configuration to pair Nintendo Wii Wiimotes using Bluetooth to the Pandora, and using them as joystick controllers. This was done under the base install of Angstrom Linux provided on the Pandora, using Hotfix 4. This does not include setting up a sensor bar type setup, but should allow you to use classic controllers that plug into the Wiimote.

== PRECAUTION ==

Updating the list of packages (the command "sudo opkg update") should not affect your Pandora. However, upgrading or installing some packages may update core files on the Pandora and cause instability or prevent your Pandora from booting (requiring a reflash of your system).

These instructions worked in Hotfix 4 and 5. When Hotfix 5 was released, the update took 30 minutes to complete.

== Installing the Drivers ==

Open a Terminal, and run the command "sudo opkg update" (without the quotes). It will give you a warning about responsibility, and asks for your user password. This will update the Angstrom packages stored on NAND.

Then install the Wiimote drivers and software, cwiid, using the command "sudo opkg install cwiid"

== Pairing the Wiimote ==

Make sure Bluetooth is enabled. In Hotfix 4, there's a script to "Toggle Bluetooth Status" in the Pandora menu under the "System" category. A light will turn on on the left hand side of the Pandora if Bluetooth is on, next to the network light.

Open a Terminal, and run the command "wminput" and follow the directions. It will tell you to press 1+2 on the Wiimote to connect. On my Wiimotes, the lights flash and the fourth light on the Wiimote lights solid once paired. If you then quit the wminput application (for instance, by hitting CTRL-C), your Wiimote will un-pair and turn off. I usually just hide the Terminal in the background by minimizing the window while I run game emulators.

You can pair multiple Wiimotes, just run wminput a second time and follow the instructions to pair it. I only have two, and both lit the fourth light.

In PicoDrive, the Sega Genesis emulator, in the controller settings, if you push left or right it will display different joysticks configured. You can set up the buttons for different players there. The Wiimotes appeared as joysticks 1 and 2, in the order in which I paired them.

== Changing the Wiimote Configuration ==

You can edit ''/etc/cwiid/wminput/default'' and ''/etc/cwiid/wminput/buttons'' to map the buttons of the Wiimote. You should quit wminput and restart them for these changes to take effect. They are plain text files. I edited them using vim from the command line, which is not the most user friendly thing to describe. Because they're system files, I needed to use sudo again, so I ran "sudo vim /etc/cwiid/wminput/default" in Terminal.

By default, the Wiimote is set up to control the mouse with the accelerometer. This means, as you tilt the Wiimote left and right, your mouse will shift around. I found it a bit distracting, and so I commented out two lines in /etc/cwiid/wminput/default so they look like this:

: #Plugin.acc.X = REL_X
: #Plugin.acc.Y = REL_Y

Also, I use the Wiimote "sideways", like a traditional Nintendo controller. I changed the direction pad to reflect this. Though you can do that within emulator configurations, it seemed handier to just have that set up by default. To do this, make these changes in /etc/cwiid/wminput/buttons

: Wiimote.Up = KEY_LEFT
: Wiimote.Down = KEY_RIGHT
: Wiimote.Left = KEY_DOWN
: Wiimote.Right = KEY_UP

It is also possible to map the Wiimote or extension buttons to a virtual gamepad. See below for instructions.

== Using a Classic Controller ==

There are two ways to use a Wiimote or Classic Controller with the Pandora:
* As a virtual gamepad. This means you can use it in games that support gamepads, and allows multiplayer in games that support it, but won't work in games that don't support gamepads.

* As a clone of the Pandora's gaming controls, by mapping it to the same keys. This theoretically means it would work in games that don't have gamepad support, or allow you to change the controls at all, as long as they are using the Pandora controls. However, currently, not all games will register the input with this method. SuperTux, OpenTyrian, PandoraPanic and Snes9X4D4P will. Giana's Return, Sqrxz and psx4pandora won't. Additionally, Mupen64Plus with the default PPSP Input Plugin won't - but the Blight Input Plugin will.

=== As a virtual gamepad ===

The default profile doesn't have classic controller buttons defined, but cwiid comes with a gamepad profile which does. You can load it in wminput like this using a terminal:
: wminput -c gamepad
Then connect your Wiimote and Classic Controller. You do not have to connect the Classic Controller before you connect the Wiimote.

However the analog sticks/dpad seemed to be set up wrong in the gamepad profile:
: Classic.Dpad.X = ABS_X
: Classic.Dpad.Y = ABS_Y
: Classic.LStick.X = ABS_HAT0X
: Classic.LStick.Y = ABS_HAT0Y
: Classic.RStick.X = ABS_HAT1X
: Classic.RStick.Y = ABS_HAT1Y

should be replaced with:
: Classic.Dpad.X = ABS_HAT0X
: Classic.Dpad.Y = ABS_HAT0Y
: Classic.LStick.X = ABS_X
: Classic.LStick.Y = ABS_Y
: Classic.RStick.X = ABS_RX
: Classic.RStick.Y = ABS_RY

Otherwise, you won't get proper analog input from the sticks, since PoV hats aren't analog.

=== As a clone of the Pandora's gaming controls ===

This method works well where it does, you get a clone of the Pandora's gaming controls (minus the nubs), that should theoretically work in all games that support the Pandora's gaming controls. However, because of differences in how the games receive input, not all will detect the "fake" input.

Here is the profile for the Pandora gaming controls:
: # D-Pad
: Classic.Up = KEY_UP
: Classic.Down = KEY_DOWN
: Classic.Left = KEY_LEFT
: Classic.Right = KEY_RIGHT

: # Select, Start and Space
: Classic.Minus = KEY_LEFTCTRL
: Classic.Plus = KEY_LEFTALT
: Classic.Home = KEY_SPACE

: # BXYA on Pandora
: Classic.A = KEY_END
: Classic.B = KEY_PAGEDOWN
: Classic.X = KEY_PAGEUP
: Classic.Y = KEY_HOME
: Classic.ZL = KEY_Q
: Classic.ZR = KEY_P
: Classic.L = KEY_RIGHTSHIFT
: Classic.R = KEY_RIGHTCTRL

Save that in /etc/cwiid/wminput - you can name it whatever you want, as long as you load it in wminput using "wminput -c filename" - and make sure to save it using UNIX line endings (LF).

Once the profile is loaded and your Wiimote/Classic Controller is connected, it will automatically work in some games, but not in others. This might be possible to change to work in all games by modifying the wminput source code.

== Extra Information ==

* [http://abstrakraft.org/cwiid/browser/wminput/action_enum.txt List of bindable buttons, axises and keys for wminput]

[[Category:Tutorials]]

Controllers

2011-03-15T20:35:17Z

Yamara: added caution notice

This includes instructions on installing software and configuration to pair Nintendo Wii Wiimotes using Bluetooth to the Pandora, and using them as joystick controllers. This was done under the base install of Angstrom Linux provided on the Pandora, using Hotfix 4. This does not include setting up a sensor bar type setup, but should allow you to use classic controllers that plug into the Wiimote.

== PRECAUTION ==

Updating the list of packages (the command "sudo opkg update") should not affect your Pandora. However, upgrading or installing some packages may update core files on the Pandora and cause instability or prevent your Pandora from booting (requiring a reflash of your system).

These instructions worked in Hotfix 4. They have not been tested in Hotfix 5 or later.

== Installing the Drivers ==

Open a Terminal, and run the command "sudo opkg update" (without the quotes). It will give you a warning about responsibility, and asks for your user password. This will update the Angstrom packages stored on NAND.

Then install the Wiimote drivers and software, cwiid, using the command "sudo opkg install cwiid"

== Pairing the Wiimote ==

Make sure Bluetooth is enabled. In Hotfix 4, there's a script to "Toggle Bluetooth Status" in the Pandora menu under the "System" category. A light will turn on on the left hand side of the Pandora if Bluetooth is on, next to the network light.

Open a Terminal, and run the command "wminput" and follow the directions. It will tell you to press 1+2 on the Wiimote to connect. On my Wiimotes, the lights flash and the fourth light on the Wiimote lights solid once paired. If you then quit the wminput application (for instance, by hitting CTRL-C), your Wiimote will un-pair and turn off. I usually just hide the Terminal in the background by minimizing the window while I run game emulators.

You can pair multiple Wiimotes, just run wminput a second time and follow the instructions to pair it. I only have two, and both lit the fourth light.

In PicoDrive, the Sega Genesis emulator, in the controller settings, if you push left or right it will display different joysticks configured. You can set up the buttons for different players there. The Wiimotes appeared as joysticks 1 and 2, in the order in which I paired them.

== Changing the Wiimote Configuration ==

You can edit ''/etc/cwiid/wminput/default'' and ''/etc/cwiid/wminput/buttons'' to map the buttons of the Wiimote. You should quit wminput and restart them for these changes to take effect. They are plain text files. I edited them using vim from the command line, which is not the most user friendly thing to describe. Because they're system files, I needed to use sudo again, so I ran "sudo vim /etc/cwiid/wminput/default" in Terminal.

By default, the Wiimote is set up to control the mouse with the accelerometer. This means, as you tilt the Wiimote left and right, your mouse will shift around. I found it a bit distracting, and so I commented out two lines in /etc/cwiid/wminput/default so they look like this:

: #Plugin.acc.X = REL_X
: #Plugin.acc.Y = REL_Y

Also, I use the Wiimote "sideways", like a traditional Nintendo controller. I changed the direction pad to reflect this. Though you can do that within emulator configurations, it seemed handier to just have that set up by default. To do this, make these changes in /etc/cwiid/wminput/buttons

: Wiimote.Up = KEY_LEFT
: Wiimote.Down = KEY_RIGHT
: Wiimote.Left = KEY_DOWN
: Wiimote.Right = KEY_UP

It is also possible to map the Wiimote or extension buttons to a virtual gamepad. See below for instructions.

== Using a Classic Controller ==

There are two ways to use a Wiimote or Classic Controller with the Pandora:
* As a virtual gamepad. This means you can use it in games that support gamepads, and allows multiplayer in games that support it, but won't work in games that don't support gamepads.

* As a clone of the Pandora's gaming controls, by mapping it to the same keys. This theoretically means it would work in games that don't have gamepad support, or allow you to change the controls at all, as long as they are using the Pandora controls. However, currently, not all games will register the input with this method. SuperTux, OpenTyrian, PandoraPanic and Snes9X4D4P will. Giana's Return, Sqrxz and psx4pandora won't. Additionally, Mupen64Plus with the default PPSP Input Plugin won't - but the Blight Input Plugin will.

=== As a virtual gamepad ===

The default profile doesn't have classic controller buttons defined, but cwiid comes with a gamepad profile which does. You can load it in wminput like this using a terminal:
: wminput -c gamepad
Then connect your Wiimote and Classic Controller. You do not have to connect the Classic Controller before you connect the Wiimote.

However the analog sticks/dpad seemed to be set up wrong in the gamepad profile:
: Classic.Dpad.X = ABS_X
: Classic.Dpad.Y = ABS_Y
: Classic.LStick.X = ABS_HAT0X
: Classic.LStick.Y = ABS_HAT0Y
: Classic.RStick.X = ABS_HAT1X
: Classic.RStick.Y = ABS_HAT1Y

should be replaced with:
: Classic.Dpad.X = ABS_HAT0X
: Classic.Dpad.Y = ABS_HAT0Y
: Classic.LStick.X = ABS_X
: Classic.LStick.Y = ABS_Y
: Classic.RStick.X = ABS_RX
: Classic.RStick.Y = ABS_RY

Otherwise, you won't get proper analog input from the sticks, since PoV hats aren't analog.

=== As a clone of the Pandora's gaming controls ===

This method works well where it does, you get a clone of the Pandora's gaming controls (minus the nubs), that should theoretically work in all games that support the Pandora's gaming controls. However, because of differences in how the games receive input, not all will detect the "fake" input.

Here is the profile for the Pandora gaming controls:
: # D-Pad
: Classic.Up = KEY_UP
: Classic.Down = KEY_DOWN
: Classic.Left = KEY_LEFT
: Classic.Right = KEY_RIGHT

: # Select, Start and Space
: Classic.Minus = KEY_LEFTCTRL
: Classic.Plus = KEY_LEFTALT
: Classic.Home = KEY_SPACE

: # BXYA on Pandora
: Classic.A = KEY_END
: Classic.B = KEY_PAGEDOWN
: Classic.X = KEY_PAGEUP
: Classic.Y = KEY_HOME
: Classic.ZL = KEY_Q
: Classic.ZR = KEY_P
: Classic.L = KEY_RIGHTSHIFT
: Classic.R = KEY_RIGHTCTRL

Save that in /etc/cwiid/wminput - you can name it whatever you want, as long as you load it in wminput using "wminput -c filename" - and make sure to save it using UNIX line endings (LF).

Once the profile is loaded and your Wiimote/Classic Controller is connected, it will automatically work in some games, but not in others. This might be possible to change to work in all games by modifying the wminput source code.

== Extra Information ==

* [http://abstrakraft.org/cwiid/browser/wminput/action_enum.txt List of bindable buttons, axises and keys for wminput]

[[Category:Tutorials]]

Controllers

2010-09-15T22:39:47Z

Yamara: New page: This includes instructions on installing software and configuration to pair Nintendo Wii Wiimotes using Bluetooth to the Pandora, and using them as joystick controllers. This was done unde...

Development Tools

2008-11-18T20:29:07Z

Yamara: /* Tentative Library Environment */ Added kernel interface link

==Tentative Library Environment==

===Information===

'''Please note, that this information is hearsay/guesswork, and is yet to be confirmed on a production unit.'''

For Pandora [http://en.wikipedia.org/wiki/Out_of_the_box (Out-Of-The-Box)]
* [http://www.gnu.org/software/libc glibc] (at a guess, version 2.6.1 or whatever is compatible with OpenEmbedded)
* [http://www.libsdl.org/ libSDL] (also a guess, latest available version of 1.2)

For those interested in creating libraries, or needing more low-level access, read about the
[[kernel interface]].

==Tools for Pandora Software Development==

* OpenEmbedded cross-compile environment (and Angstrom distro) [http://www.elinux.org/BeagleBoard#OpenEmbedded]
* CodeSourcery gcc[http://www.codesourcery.com/gnu_toolchains/arm]
** [http://www.codesourcery.com/gnu_toolchains/arm/portal/release313] - NB: OpenEmbedded uses the CodeSourcery 2007q3 to build the kernel, but uses gcc 4.3.1 to compile everything else.
* TI CodeComposer Studio: Free Evaluation Tools[http://focus.ti.com/dsp/docs/dspsupportaut.tsp?sectionId=3&tabId=416&familyId=44&toolTypeId=30]
* TI c6x Codegen tools for Linux[https://www-a.ti.com/downloads/sds_support/targetcontent/LinuxDspTools/download.html]; License [https://www-a.ti.com/downloads/sds_support/targetcontent/LinuxDspTools/doc/c6x/TILAW-%23180394-v1-Compiler_Clickwrap_For_OS_Community-2.html]; TI account required; this is *only* for Open Source development
* Das U-boot: The Universal Bootloader[http://www.denx.de/wiki/DULG/WebHome]

===OpenGL===

(See also [[OpenGLES_On_the_Pandora]])

* OpenGL ES 2.0 emulator for PC[http://www.imgtec.com/powervr/insider/sdkdownloads/index.asp#GLES2] ''This works both on Linux and Windows. One needs to register with imgtec before downloading.''
** To build the applications a few environment variables need to be set (tested on Ubuntu Gutsy). Note that to run them, you do need an OpenGL 2.0 compliant gfx card.
*** LD_LIBRARY_PATH needs to be set to the folder holding the important libraries, such as libEGL.so ($SDK_PATH/Builds/OGLES2/LinuxPC/Lib might be enough)
*** To run the makefiles in the Training section you need to set a PLATFORM variable to either LinuxPC or LinuxGeneric. I have had success with LinuxPC.
*** See [http://pastebin.com/f3f9f159f] for a script that you can run to set these for you.
* [http://www.imgtec.com/powervr/insider/powervr-pvrtextool.asp PowerVR Texture creation tool]
** "PVRTexTool enables conversion of standard bitmap files (e.g. BMP, JPG, PNG, TGA, etc.) to any texture type supported by POWERVR MBX or POWERVR SGX hardware including PVRTC, DXT and ETC compressed formats. Both a GUI and command line version are supplied for Windows and Linux. There are also plug-ins for Autodesk 3ds Max, Maya and Adobe Photoshop." - requires imgtec registration.
** ''Note, this is part of the main SDK'' - (Linux path to it is /SDKPackage/Utilities/PVRTexTool/)

[[Category:Development]]

Logo

2008-09-30T17:11:56Z

Yamara: Added logo PDF, CMYK colors, and suggested use

== High Resolution Logo ==
People keep asking for the logo, so in the interest of helping out, I re-drew the drawing. Here's the logo in PDF (using RGB colors as people are making things for screen use). I didn't have a high resolution copy to work from, so I did my best in the time I had. I do not know what the font is, and craigix has stated he believes it to be drawn.

* [[Image:Pandora_logo-unofficial.pdf]]

== Logo Colors ==

For those doing print or reproducing the logo, the CMYK colors are:
* box logo: 100% cyan, 75% black
* word logo: 100% cyan, 20% black

== Logo Use ==

I suspect there are no logo use rules at present, and so I'll just make some general design suggestions. Don't change the spacing between the letters. When presented side-by-side, try not to change the spacing between the box and the word logo. In general, don't overlay the word logo over the box (unless perhaps the box logo is enormous) as the legibility of both would suffer. The logo is best presented in solid colors, and the letters in the word logo should be of the same color. When scaling the logo, preserve the aspect ratio of height to width. (These are merely suggestions of best use, but design is about pushing boundaries, and so some rules can be a bit flexible.)

I do not know the designer of the logo, and I imagine the logo copyright is owned by OpenPandora. Ask them, or check their web page for rights reserved.

File:Pandora logo-unofficial.pdf

2008-09-30T16:56:13Z

Yamara: The logo in PDF, redrawn from the banner on the openpandora.org web site. In RGB color format for screen use.

The logo in PDF, redrawn from the banner on the openpandora.org web site. In RGB color format for screen use.