
 Sony Ericsson C901 modded camera driver by Raider
 -------------------------------------------------


 HOMEPAGE
 ========

     Bug reporting, issues, questions, suggestions, informations, free discussion...

     http://www.esato.com/board/viewtopic.php?topic=194677


 SUPERMODE
 =========

     Supermode is an additional layer of functionality which is not available in original driver.
     This layer collects many manual functions which makes you able to control parameters yourself
     and not rely only on point & shoot automatic settings.


 HOW TO USE
 ==========

     It's very simple, after switching the camera on:

     * All manual functions are in automatic point & shoot mode.
     * You don't have to use manual functions at all, do this only if you want.

     * Keep in mind that 'EV position' is different than 'EV compensation'

       - EV position is just a value
       - EV compensation is a value + EV correction visible on viewfinder

     * Use joystick left/right key to select function.
       In original driver these keys are reserved for EV compensation, in this driver their purpose
       is exactly the same but it changes after first change of value in any manual function, except
       of function at position 0.0 which is neutral position.

       When you start the camera and use joystick left/right you'll see that EV compensation will
       change. At this stage the camera doesn't know whether you want to use EV compensation only or
       just go to manual function and then change its value. The first change of function value is
       a shift from automatic mode to manual mode, which means:

       - Current EV compensation which is a result of the joystick movements will be gone and reset
         to default value 0.0EV. In this way the camera assumes that the movements of joystick were
         used to select manual function, rather than to change EV compensation from default 0.0EV

       - You cannot use joystick left/right to compensate EV, only to select functions
         however you can bring back EV compensation for joystick. To make this possible use function
         at position +0.3, it's called "EV compensation"

       - When you reset the camera all manual settings will be gone

     * Use zoom -/+ key to select value of function.
       In original driver these keys are reserved for digital zoom, in this driver they are used to
       select value of manual function. Functions have different ranges of values, when you reach
       maximum the indicator on zoom bar won't let you go any further. Minimum value is 0 and in all
       functions it means automatic/neutral/default state of selected function.

       Of course zoom is still available but has become a manual function. If you want to use it
       you have to select position (+2.0) where zoom function is hooked.

     * If you don't want to keep -/+ key pressed all the time when moving to far values of function
       you can try to use small bug in firmware:

       - Press -/+ key and hold it
       - Press 3 or 6 key once
       - Release -/+ key

       Now value changes by itself! To stop it press -/+ key. Credits goes to Mriley from Esato :)

     * Precise control of all manual functions.
       It's hard to control functions when you have no idea on which value are you at, isn't?
       This problem can be easily solved, it's not perfect but still good enough. All you have to do
       is to replace 2 graphic files in the phone's file system. Use files from folder 'gfx' and
       CodeClaw IC Manager [http://bit.ly/cArE03] to replace files:

          207404 and 2CF164

       in file from folder tpa/presets/system/icons:

          hb1_08_qvga_cybershot_icon_graphics_main_0.ic

       and then upload this file to your phone with A2uploader [http://bit.ly/cqptwZ].
       In case if you don't have .ic file:

       - Download it from http://raider.4shared.com
       - Download file system (FS) file [topsony.com, seusers.com, 4shared.com, etc.] and then use
         DB3150 FS Extractor [http://bit.ly/cmQxoh] to extract all files


 OTHER CHANGES
 =============

     * Rich customization zone at the top of code for individual changes
     * Forced flash when red eye reduction is enabled
     * Improved sharpness and always maximum sharpness for macro mode
     * Manual focus with zoomed in preview on demand
       preview on/off = press the camera key half down and release

     * Xenon ISO 100 for macro mode
     * Manual gain (ISO) and shutter speed with realtime preview on demand
       preview on/off = press the camera key half down and release

     * Autofocus and manual focus in video mode


 ENHANCED MODES
 ==============

     Special modes which can improve picture quality in low light conditions. Enhanced modes are
     using lower ISO values but also longer exposure times therefore you have to pay attention to
     not move the camera during the capture process to avoid blurry pictures!

     As for now only one mode is available:

     * Hybrid EM (Enhanced Mode)


 MANUAL FUNCTIONS, EV POSITIONS, LAYERS
 ======================================

     -2.0   Layer number change

 1st layer:

     -1.7
     -1.3
     -1.0   White balance+
     -0.7   Contrast
     -0.3   Colors saturation
      0.0   Focus
     +0.3   AE lock and EV compensation
     +0.7   Enhanced modes and shutter speed
     +1.0   Gain
     +1.3
     +1.7
     +2.0   Digital zoom

 2nd layer:

     -1.7   Colors saturation (method used in Sony Ericsson Aino)
     -1.3   Colorization (Cb)
     -1.0   Colorization (Cr)
     -0.7   Effects+
     -0.3
      0.0
     +0.3   Selective color source
     +0.7   Selective color destination
     +1.0
     +1.3
     +1.7
     +2.0


 VALUES OF MANUAL FUNCTIONS
 ==========================

     Contrast		0		default (1)
			1		neutral
			2		high black point
			3		high black point + low white point


     Colors saturation	0		default
			1		maximum
			...
			30		neutral
			...
			60		minimum


     Colors saturation (Aino method)

			0		default (2)
			1		off
			2 - 5		various saturations


     Focus		0		photo: autofocus
					video: force autofocus start
			1		infinity (the camera key half down for photo AE lock works fine)
			2		far
			...
			60		near


     EV compensation	0		default
			1		AE lock
			2		allow compensation with joystick left/right
                        3		-2.0 EV
			4		-1.7
			5		-1.3
			6		-1.0
			7		-0.7
			8		-0.3
			9		 0.0
			10		+0.3
			11		+0.7
			12		+1.0
			13		+1.3
			14		+1.7
			15		+2.0


     Gain		0		auto
			1 - 60		ISO 100 - ISO 3200


     Enhanced modes and shutter speed

			0		auto
			1		hybrid EM
			2		1/20000s
			3		1/10000s
			4		1/6400s
			5		1/5000s
			6		1/3200s
			7		1/2500s
			8		1/2000s
			9		1/1600s
			10		1/1250s
			11		1/1000s
			12		1/800s
			13		1/640s
			14		1/500s
			15		1/400s
			16		1/320s
			17		1/250s
			18		1/200s
			19		1/160s
			20		1/125s
			21		1/100s
			22		1/80s
			23		1/60s
			24		1/50s
			25		1/40s
			26		1/30s
			27		1/25s
			28		1/20s
			29		1/15s
			30		1/13s
			31		1/10s
			32		1/8s
			33		1/6s
			34		1/5s
			35		1/4s
			36		1/3s
			37		2/5s
			38		1/2s
			39		3/5s
			40		3/4s
			41		1/1s

					All values are approximate!


     Effects+		0		off
			1		emboss
			2		edge detect
			3		negative solarize
			4		posterize #1
			5		posterize #2
			6		posterize #3


     Colorization (Cb)	0		off
			1		black & white
			...
			30		blue
			31		vivid green
			...
			60		black & white


     Colorization (Cr)	0		off
			1		black & white
			...
			30		red
			31		green
			...
			60		black & white


     Selective color source

			0		off
			1 - 8		visible color, all other will be changed to destination color
			9 - 16		negative color, only it will be changed to destination color

					At first use this function with reference table of colors
					to find out which colors corresponds to selected values:
					http://www.visibone.com/cmyk/gamutgrid.pdf


     Selective color destination

			0		purple
			1		magenta
			2		red
			3		sepia
			4		dark green
			5		bright green
			6		cyan
			7		blue
			8		gray


     White balance+	0		default (selected in the camera menu)
			1		WB lock
			2		auto
			3		incandescent
			4		fluorescent (high)
			5		fluorescent (low)
			6		daylight
			7		cloudy
			8		shade
			9		horizon


 KNOWN PROBLEMS
 ==============

     * Xenon power is controlled by EV position, not by real value of EV compensation
     * Some functions cannot be used with other functions
     * EXIF exposure time and ISO values are approximate
     * EXIF exposure time 4/3s is in fact 3/4s

     Suggestions...

     * Too high sharpness can cause a lot of noise in low-light conditions
     * Not neutral contrast affects brightness of pictures taken in low-light
       and/or with manual shutter speed and gain


 CHANGELOG
 =========

   6.3.2  [2010-05-15]
         - video mode now has its own settings of sharpness and doesn't inherit
           sharpness from the photo mode. video sharpness must be soft while in photo
           is medium and high which caused more visible video compression artefacts

         - manual gain function extended from ISO 1000 to ISO 3200
         - JPEG compression Fine reduced to ~2000 KiB


   6.3.1  [2010-05-06]
         - fixed bug: white balance+ function doesn't work


   6.3    [2010-05-06]
         - fixed bug: realtime preview of manual gain and shutter speed could be
                      switched on/off while hybrid EM was enabled only

         - forced autofocus start at step 0 in video mode manual focus
         - new manual function: white balance+
           * contains all WB settings, including those from the menu
           * easy and fast to use, instead of inconvenient selection from the menu
           * WB lock

         - manual contrast function extended from 3 to 4 values
         - changes in customization zone
           * slightly increased default value of colors saturation
           * sharpness of the edges
             VAL_SHARP_DEFAULT renamed to VAL_EDGE_DEFAULT
             VAL_SHARP_PORTRAIT renamed to VAL_EDGE_PORTRAIT

           * sharpness of the details
             new value VAL_SHARP_DEFAULT for non-macro pictures
             new value VAL_SHARP_MACRO for macro pictures

           * sharpness of the details changed from original low to
             medium in non-macro mode and to maximum in macro mode

           * VAL_MAX_JPEG_2MB removed, new compression quality rules are:
             Normal = ~1800 KiB
             Fine   = ~2100 KiB


   6.2.2  [2010-04-05]
         - in video mode
           * position +2.0 is manual focus (15 steps)
           * all other positions are zoom

         - two new values in customization zone
           * VAL_MAX_JPEG_2MB
           * VAL_FOCUS_REVERSE

         - EV compensation is not canceled (0.0EV) when -/+ key was pressed at
           * empty EV position with no function
           * EV position of layer number change (-2.0)

         - possible fix of rare camera crash at shutter speed 1/1s
         - small changes in precise calculations
         - improvements in 3rd layer


   6.2    [2010-03-27]
         - fixed bug: manual focus instead of zoom during video calls
         - fixed bug: no AE lock at the half down camera key for manual focus
         - very accurate steps on slide bar
         - hybrid EM can work with xenon
         - xenon ISO 100 without extended exposure time (default 1/125s) for macro mode
         - two new manual functions: gain and shutter speed
           * gain is equivalent of ISO control
           * both can be used together
           * gain doesn't effect shutter speed and vice versa
           * both can be used with and without xenon
           * default ISO value for manual shutter speed is ISO 100
           * default shutter speed value for manual gain is 1/125s

         - gain and shutter speed functions have realtime preview on demand
           preview can be turned on only at EV positions of gain and shutter speed functions

         - from now manual focus preview can be turned on
           * only at EV position of manual focus function
           * on all EV positions while the camera is in BestPic mode


   6.0.5  [2010-03-19]
         - more precise calculations of values for some functions
         - fixed some bugs in 3rd layer and removed access to it from public release
         - fixed jammed AE lock after usage of manual focus zoomed in preview
         - additional sharpness in zoomed in preview of manual focus
         - value on the slide bar is restored to current value of function if EV position was changed
           * colors saturation (Aino method)
           * selective color source
           * selective color destination


   6.0    [2010-03-18]
         - code fully redesigned
         - implemented supermode layer with manual functions
         - implemented multiple layers for manual functions
           * 1st layer: standard functions
           * 2nd layer: color manipulation functions and other functions
           * 3rd layer: research & development functions

         - maximum size of high quality 5MP JPEG increased from ~1.5MB to ~1.85MB
         - always maximum sharpness for macro mode
         - forced flash when red eye reduction is enabled
         - flash doesn't fire in scenes without flash
         - purple color has less tendency to be slightly bluish


