From 76992402d7d11ced3c0a676774bb768cc4454d10 Mon Sep 17 00:00:00 2001
From: Fabio Battaglia
Date: Sat, 25 Sep 2010 21:54:41 +0000
Subject: DINGUX: remove wrong comment and fill the readme with some infos

svn-id: r52894
---
 backends/platform/dingux/README.DINGUX     | 60 +++++++++++++++++++++++++++++-
 backends/platform/dingux/dingux-events.cpp |  2 +-
 2 files changed, 60 insertions(+), 2 deletions(-)

diff --git a/backends/platform/dingux/README.DINGUX b/backends/platform/dingux/README.DINGUX
index bda3e51c73..12289388de 100644
--- a/backends/platform/dingux/README.DINGUX
+++ b/backends/platform/dingux/README.DINGUX
@@ -7,4 +7,62 @@ Requirements
 - Dingux installed on SD card
 - Fixed Tremor libs in dingux rootfs (see below)
 
-* To Be Filled *
+Controls
+============
+- Dpad: move mouse cursor
+- Y: left mouse button click
+- A: '0' key
+- B: right mouse button click
+- X: '.' key (skips dialogue line in some engines)
+- Left Trigger: open global menu
+- Right Trigger: ESC button, scene skip in some engines
+- Select: opens virtual keyboard
+- Start: F5 key, game menu in some engines
+
+Installation from binaries
+==============================
+Mount your dingux SD card in your pc, then copy the directory "scummvm" found in 
+the release package to a directory inside /pathtosdcard/local/dirofyourchoice 
+(on windows it would be SDLETTER:\local\dirofyourchoice).
+At this point is sufficient to point your launcher (eg. gmenu2x) to scummvm.gpe 
+file included into the scummvm directory you copied to the SD card, and then launch it.
+
+Building from binaries
+==============================
+* ToDO *
+
+Kernel and rootfs WARNINGS
+==============================
+All the dingux root images (rootfs) i found floating on the net have 
+broken tremor libraries, which make scummvm crash in a bad way.
+One solution is to replace the libraries in your rootfs by injecting these fixed ones:
+http://hkzlab.ipv7.net/files/misc/dingux/dingux_fixed_tremor_libs.zip
+After having added these libs, scummvm should work on your standard dingux kernel,
+but this doesn't mean it will work perfectly:
+non-opendingux kernels doesn't have lcd double buffering leading to a lot of annoying
+tearing on screen.
+
+The best way to address all the problems in one shot, is to use an opendingux kernel for 
+your dingoo, which has some interesting advantages:
+- The kernel gets updated and kept in sync with main linux tree
+- Double buffering and centering of screen image
+- Support for swap on compressed ram
+I have prepared a rootfs image with fixed libs and swap-on-zram to use together with opendingux kernels:
+http://hkzlab.ipv7.net/files/misc/dingux/opendingux/opendingux_kernel_rootfs.zip
+The kernel and rootfs images in the zip file is what i use for developing scummvm on dingux.
+
+BTW, i have built images for the A330 and A320 with ILI9325 controllers too,
+but these version aren't tested (i have an A320 with ILI9331, but if someone wants to 
+donate an A330 to a poor scummvm developer so i can try the port there too... :P)
+
+If you need a launcher with opendingux cpu frequency scaler support, you can find gmenu2x here:
+http://www.treewalker.org/dingux/cpufreq.html
+
+I've also prepared a rootfs image for use on normal dingux kernels (non-opendingux ones). 
+It's based on elta's rootfs image with just the fixed libs replaced.
+http://hkzlab.ipv7.net/files/misc/dingux/normal_dingux/rootfs_elta_fixtremor.zip
+I still raccomand the use of opendingux kernel + rootfs, but if you don't, this roofs 
+image plus another kernel (eg. SiENcE's one) should be do the job.
+
+Enjoy
+
diff --git a/backends/platform/dingux/dingux-events.cpp b/backends/platform/dingux/dingux-events.cpp
index b6070f68ca..f9b519623d 100644
--- a/backends/platform/dingux/dingux-events.cpp
+++ b/backends/platform/dingux/dingux-events.cpp
@@ -149,7 +149,7 @@ bool OSystem_SDL_Dingux::remapKey(SDL_Event &ev, Common::Event &event) {
 		}
 
 		return true;
-	} else if (ev.key.keysym.sym == BUT_A) { // virtual keyboard
+	} else if (ev.key.keysym.sym == BUT_A) { // key '0'
 		ev.key.keysym.sym = SDLK_0;
 
 		event.kbd.keycode = Common::KEYCODE_0;
-- 
cgit v1.2.3