----------------------------------------------------------------------------------------------- Sony Ericsson K750/W800/W810 camera driver compatible with CID36/49 phones and MXE-60 accessory Configuration Tool for modded camera drivers by Raider ----------------------------------------------------------------------------------------------- visit: www.esato.com/board/viewtopic.php?topic=135737 this driver has a lot of functions but there is no need to use them. if you want to make picture then just do it. you don't have to change any function! you will use functions only if you want to correct something or to obtain special effect shortcuts: EM = enchanced mode ENM = enchanced night mode CC = color correction WB = white balance 1. EV FUNCTIONS -2.0 = Zoom 1.0 - 4.0 = 1x - 4x -1.7 = CC Cyan 1.0 = automatic 1.1 - 4.0 = none - maximum -1.3 = CC Red 1.0 = automatic 1.1 - 4.0 = none - maximum -1.0 = Saturation 1.0 = initial 1.1 = default (neutral) 1.2 - 4.0 = desaturated - maximum -0.7 = CC Yellow 1.0 = automatic 1.1 - 4.0 = none - maximum -0.3 = CC Blue 1.0 = automatic 1.1 - 4.0 = none - maximum 0.0 = Focus 1.0 = automatic 1.1 = infinity 1.2 - 4.0 = manual (press and free snapshot button to enable/disable zoom 4x) +0.3 = Exposure Compensation 1.0 = 0.0 1.1 = -3.0 2.0 = 0.0 2.6 = +2.0 +0.7 = Shutter Speed 1.0 = automatic 1.1 = normal mode (EM) 1.1 = night mode (ENM) 1.2 - 4.0 = normal mode (1/5000s - 1/6s) 1.2 - 3.0 = night mode (1/40s - 2s, all zoom values above 3.0 = 2s) +1.0 = Light Metering Method 1.1 = spot other = default (center-weighted average) +2.0 = Profile 1.0 = automatic 1.1 = cloudy landscape 1.2 = document optional functions (enable them in configuration tool) Brightness 1.0 = default 1.1 - 2.6 = minimum - maximum Contrast 1.0 = default 1.1 - 1.9 = minimum - maximum Green Color Cast 1.0 - 4.0 = neutral - maximum Magenta Color Cast 1.0 - 4.0 = neutral - maximum Orange Color Cast 1.0 - 4.0 = neutral - maximum 2. FAQ 01. what is supermode? supermode is different approach to manage camera capabilities by including many additional functions which aren't available in standard driver. this may look as unnecessary complication but in skilled hands can be powerful solution 02. my picture is blurred, what is wrong? 1. make sure that you're using macro mode for macro photos only and no-macro for normal photos 2. autofocus can't work well bacause of too low contrast in photographed scene 3. driver doesn't fit to your phone model (CID36, CID49, W810) 03. how to use/set functions? 1. select function EV value (when phone is in horizontal position: joystick left/right) 2. use zoom +/- keys to alter value of the chosen function 04. i don't like supermode features, can i use this driver in standard way? yes, use configuration tool and select "standard" driver type 05. what is autoexposure? the camera automatically calculates the best aperture and shutter speed combination for lighting conditions and to adjust correct exposure value. read about overexposure to know why good exposure is so much important 06. what is autoexposure lock/unlock? autoexposure can be temporarily disabled (lock) at selected exposure level and then quickly enabled (unlock) by user. this is very efficient function because can help when overexposure or underexposure problem appears 07. how to use autoexposure lock/unlock? auto exposure (un)lock can be done whenever you want but it can not work if led/flash is enabled - snapshot button half pressed = locked - snapshot button not pressed = unlocked 08. what is overexposure? this happens when too much lighting strikes the sensor. minor overexposure may cause a loss of details in the scene highlights. severe overexposure will cause a serious deterioration of picture quality in color and details. overexposure refers to a white-looking or washed-out image. often happens on high contrast scene snapshots. very bright surface will be overexposed if you focus on dark surface details. if you focus on very bright surface details then dark surface will be underexposed (even black). overexposure and underexposure issues are results of the sensor poor dynamic range 09. what is Enchanced Mode and Enchanced Night Mode and when should i use them? EM and ENM are special additional modes for normal and night mode which can dramatically improve picture quality in low light or even very bad light conditions. you can also achieve better quality using manual shutter speed. when you use EN, ENM or manual long shutter speed then you have to hold your hand still or put camera on stable stand to avoid blur 10. what for is shutter speed? shutter speed determines the amount of time that the sensor is exposed to light from the scene. the slower the shutter speed, the longer the exposure time. when the shutter speed is set to 1/125 this means that the shutter will be open for exactly 1/125th of one second zoom | normal | night -----|----------|------- 1.2 | 1/5000 | 1/40 1.3 | 1/3200 | 1/30 1.4 | 1/2500 | 1/25 1.5 | 1/2000 | 1/20 1.6 | 1/1600 | 1/15 1.7 | 1/1250 | 1/13 1.8 | 1/1000 | 1/10 1.9 | 1/800 | 1/8 2.0 | 1/640 | 1/6 2.1 | 1/500 | 1/5 2.2 | 1/400 | 1/4 2.3 | 1/320 | 1/3 2.4 | 1/250 | 1/2.5 2.5 | 1/200 | 1/2 2.6 | 1/160 | 0.6 2.7 | 1/125 | 0.75 2.8 | 1/100 | 1 2.9 | 1/80 | 1.33(3) 3.0 | 1/60 | 2 3.1 | 1/50 | 2 3.2 | 1/40 | 2 3.3 | 1/30 | 2 3.4 | 1/25 | 2 3.5 | 1/20 | 2 3.6 | 1/15 | 2 3.7 | 1/13 | 2 3.8 | 1/10 | 2 3.9 | 1/8 | 2 4.0 | 1/6 | 2 11. can i see in realtime how shutter speed works? yes, you can enable realtime shutter speed preview. press and then free snapshot button to switch preview on/off. preview can be enabled only for manual shutter speed, not for EM and ENM. if you use manual focus setting you can't enable preview. if preview is enabled and you will change the shutter speed, preview will be updated to selected value. in some cases preview is auto disabled to prevent unexpected behaviour during camera work or to shorten time necessary to take next snapshot 12. how focus works? you can set one of three types of focus work: - automatic macro off = only for objects being above 40cm from camera macro on = only for objects being in close camera distance (10 - 40cm) - infinity use if you don't want to focus on single object or if object is more than 6m from camera - manual accurate setting of focus distance (very useful in macro shots) 13. how can i use color correction? white balance is controled by two groups of colors and three additional colors: - yellow or blue - cyan or red - green - magenta - orange 14. can i make colors to be more vivid or even black and white? yes, this can be controlled by saturation function 15. what is profile? this is special set of functions settings dedicated to the specific type of scene which you want to photograph. for example: cloudy day, snow, grass, dark room etc. profiles are very useful because you don't have to set many functions again after camera open - this makes photography much easier 16. can i edit my own profiles? definitely yes! you should create your own profiles, this is very easy and can be done in configuration tool 3. CONFIGURATION TOOL RMB = right mouse button 01. can i use configuration tool with my own camdriver.dat file? yes, but you have to adapt your code. every important information about this process and step by step procedure you can find in this document 02. i've loaded driver but i can't adjust all parameters that is because driver doesn't support all functionalities of the tool 03. what for is "Model mark" option? this is information only, nothing more. first line of the driver's code contains selected model mark. in this way you can sign on which phone model your driver can be used 04. how to displace functions into different EV values? panel "Functions": - left window = list of all driver's functions which aren't associated to EV values - right window = list of EV values and associated with them functions move function to EV: - select function in left window - select destination EV in right window - press '>' button remove function from EV: - select function associated to EV value - press '<' button 05. what is "EM in quality" option? you can set on which quality (Normal, Fine, none) EM will be always enabled. if you set "normal" or "fine" you won't be able to change shutter speed on selected quality 06. what is "Macro AF range" option? this is option only for macro mode, set: - full range scan (slow) - macro range scan only (fast, only for objects near the camera) 07. what is "Focus preview" option? this is size of zoomed preview which can be activated when manual focus is in use 08. why two "Saturation" options? first is used in normal mode, second is used in EM, ENM and night mode 09. how to add profile? - press RMB on big rectangle in "Profiles" panel (menu will appear) - select "add" new profile called "new" is at the end of the list 10. how to remove profile? - select profile on the list - press RMB (menu will appear) - select "remove" answer "yes" to remove profile or "no" to cancel operation 11. how to edit profile name? - click twice on profile name - text cursor will appear - you can edit name when new name will be ready press Enter or select other profile to finish 12. how to displace profiles? - select profile - press RMB (menu will appear) - select "move up" or "move down" 13. what i can change in profile? - white balance profile - blue-yellow color correction - cyan-red color correction - colors saturation - contrast - brighntess - exposure compensation - focus (auto, infinity or manual) - shutter speed (auto, EM or manual) - add additional code executed after above settings 14. what exactly represent values near the scroll bars in "Profiles" panel? this is zoom value (1.0 - 4.0) multiplied by 10 if you set any function in the camera at zoom 1.6 then corresponding effect in profile is 16 10 = 1.0 (this is always auto/default setting) 40 = 4.0 and so on... in this way it's very easy to "copy" settings from the camera to profile settings 15. what exactly i can do in "WB color correction" panel? you can define your own color correction for all five WB settings which you can find in camera menu 16. what is the priority of color correction settings? for example, your driver has two color correction settings: - defined in profile - defined in "WB color correction" panel if you will use profile and WB together then CC settings will collide in this case CC defined in profile will be used 17. only Fine quality setting window is activated, what is wrong? loaded driver file has the same quality levels for Normal and Fine mode 18. i want to share my profiles or copy them to other driver, what should i do? export selected profiles to file and share it or import to other driver 4. THE DRIVER AND THE TOOL COMPATIBILITY fact 1: no need to support everything! you can select functionality you want to adapt: - selected initial parameters - functions displacement - color correction for all five WB settings - profiles - jpeg compression file size rules calculation fact 2: for the tool is not important how you will use data from customize sections fact 3: driver is not a set of standalone features! most of them are connected in some ways that's why you can't just copy & paste code because it won't work! the worst thing is thoughtlessly copied code. think about that what you are doing and analyze every part of code to enable functionalities you have to separate parts of code into commented on top and bottom code sections: // --- CUSTOMIZE [name] ... code ... // --- END number of '-' chars in above comments is not important but leave at last one '-' char! if you want to see look of customization sections search for them in 6.6 driver and analyze CUSTOMIZE INITIALS select parameters which you want to support. if you won't define parameter in this section his adjusting in the tool will be disabled syntax: PARAMETER_NAME= [some additional code if necessary] value; additional code will be ignored, only value at the end is important list of supported parameters and values: WORK_AS_STANDARD driver type: 00 = standard driver (no supermode functions, only original driver functions) 01 = supermode EM_IN_QUALITY Enchanced Mode will be always activated when selected quality is: 00 = Normal 01 = Fine 02 = none SHARPNESS Image sharpness: FF = default ... BRIGHTNESS CONTRAST SATURATION colors saturation in normal mode SATURATION_SS colors saturation when EM, ENM or night mode is enabled EXPOSURE exposure compensation: ... 07 = EV +0.3 09 = EV 0.0 0A = EV -0.3 ... FILTERING image filtering: 00 = always enabled 01 = enable for EM, ENM and night mode only AF_MACRO_SCAN_MODE the range of autofocus scanning in macro mode: 00 = full range 01 = macro range only FOCUS_PREVIEW_ZOOM size of zoom during manual focus preview: 40 = x1 20 = x2 15 = x3 10 = x4 08 = x8 JQ_NORMAL JPEG quality for Normal JQ_FINE JPEG quality for Fine you can use additional code in parameters but only last value is the right one, for example: JQ_FINE= $s0 00 $c1 04 $cl $cx 58; // the tool will use 58 as value all additional lines like comments, empty lines, different values, code, etc. in this section will be ignored during driver file loading and copied during file save WARNING! if your driver uses only one quality value for Normal and Fine mode: 1. define JQ_NORMAL before JQ_FINE 2. set JQ_NORMAL to 00 3. in code use JQ_FINE only CUSTOMIZE WB CC for full WB color correction support you have to clean your code from all unnecessary CC occurrences: - register 20: #SET(20,..) or 05 02 00 20 .. #CMD_END - register 21: #SET(21,..) or 05 02 00 21 .. #CMD_END - register 13: #CMD(13,01) or 06 02 00 01 01 13 #CMD_END - whole LED_WB_SET macro you should only leave above occurences in functions for manual CC if you have them $s1 00 $s2 00 // ---------------------------- CUSTOMIZE WB CC $cR W1 [additional code if necessary] $+1 00 $+2 00 $cl $cR W2 [additional code if necessary] $+1 00 $+2 00 $cl $cR W3 [additional code if necessary] $+1 00 $+2 00 $cl $cR W4 [additional code if necessary] $+1 00 $+2 00 $cl $cR W5 [additional code if necessary] $+1 00 $+2 00 // ---------------------------------------- END $cx $cx $cx $cx $cx ... #SET(20,$w1) #SET(21,$w2) #CMD(13,01) ... where: R = register where is info about selected/used WB value (in most cases code: $pR 01 is good enough) W1 = value corresponding to WB auto (00) W2 = value corresponding to WB daylight (03) W3 = value corresponding to WB cloudy (04) W4 = value corresponding to WB fluorescent (02) W5 = value corresponding to WB incandescent (01) you can change registers. use this WB CC wherever you want: in "cam_ss_start" before snapshot or in "seq_set_prop_1_" after WB change WARNING!!! code structure for this feature in driver 6.6 is a bit different and much more complicated! that is because driver will take care for all kind of situations where WB CC and manual CC can collide with themselves CUSTOMIZE FUNCTIONS this section is separated into 2 blocks: - list of all functions defined in the driver's code: syntax: // FUNCTION_NAME description - list of all EV values with associated to them functions: syntax: // EV_s_yy= #FUNCTION_NAME; | | | |__ values: 00 (EV 0.0), 03, 07, 10, 13, 17, 20 |_____ values: M = minus, P = plus these macro definitions are used in macro "SELECT_FUNCTION" and in then in "seq_set_prop_6" and "seq_set_prop_6_a" method which are responsible for the zoom value change CUSTOMIZE PROFILES whole code necessary to support profiles is inside SET_PROFILE macro, but... 1. you can not do profiles support if you'll not implement functions displacement (FUNCTIONS) that's because profiles are using functions names defined on the driver's functions list 2. currently, profiles code generator use constant function names: SET_WB SET_CC_CYAN SET_CC_RED SET_CC_YELLOW SET_CC_BLUE SET_SATURATION SET_CONTRAST SET_BRIGHTNESS SET_FOCUS SET_EXPOSURE SET_SHUTTER_SPEED if the tool during the driver's file loading don't find one or more of above function names on functions list then function(-s) adjusting will be disabled 3. content between CUSTOMIZE PROFILES and END lines is automatically generated by the tool edit it only in the tool if you don't know what can be done there with the text editor 4. zoom value (after key +/-) for EVERY function is sent in register 0 5. value 0A (zoom 1.0) sent to any function ALWAYS means: automatic/initial settings! CUSTOMIZE JPEG FS file size (min, average, max) rules calculation for jpeg encoder from max quality values is very useful functionality because: - every time when jpeg quality is changed, final file size will change too. quality and file size rules should always be corrected together to make jpeg encoder work better for better pics quality - various file size limits for various phone models: K750/W800 = ~600kb (max quality for this limit is ~90%) W810 = unknown (max quality is ~95%) K790/K800/K810 = ~900kb (max quality for this limit is below 95%) specification of the code section: r1 = quality (00 = Normal, 01 = Fine) r0 = resolution (08 = 1632x1224 or 2048x1536, any other value will be ignored) $c1 00 // normal quality ... $c0 08 #SET_JPEG_MIN(..,..) #SET_JPEG_MAX(..,..) #SET_JPEG_AVG(..,..) [other code] ... $cl $c1 01 // fine quality ... $c0 08 #SET_JPEG_MIN(..,..) #SET_JPEG_MAX(..,..) #SET_JPEG_AVG(..,..) [other code] ... $cx $cx macros names of course can be different than SET_JPEG_xxx 5. KNOWN ISSUES - when MXE-60 accessory is connected some kind of EV compensation override is started and you can not select functions by changing EV value (only EV 0.0 function is available) - when autofocus fails shutter speed preview can be activated before snapshot button release - when autofocus fails autoexposure will not be locked 6. CHANGELOG DRIVER 6.0 - new: first public release 6.01 - fix: AE lock shouldn't work if led/flash is enabled because of overexposure (thanks lord_kin0) 6.02 - new: added temporary EM/ENM solution (well known from 21.91 driver) 6.03 - new: added slots (EV_ before "seq_set_prop_6" line) to easy reorganize functions into different EV values - improve: new rules of using Enchanced Modes - added EM_ON_NORMAL_QUALITY parameter, for now it's possible to have EM as standard when you use Normal quality - deleted EM enable/disable under EV -2.0 - changed manual settings of shutter speed (check list in point 1 for more info), for now you can enable/disable EM only with this function 6.4 - fix: changed version numeration method (previous was visible as 6.1, 6.2, 6.3) - improve: changes in compression to minimalize camera crash 6.5 TEST2 - fix: lack of MXE-60 synchronization (reported by aabg) - fix: AE (un)lock can not be done when focus is in manual mode - improve: new compression rules to avoid camera crash (especially for EM and MXE-60) - improve: for now shutter speed change is not visible in realtime on viewfinder because of annoying slow reaction and blocking autofocus mechanism (ENM, value above 2.4) which makes impossible to take snapshot. realtime preview is available only on demand 6.5 TEST3 - new: parameter WORK_AS_STANDARD, set 00 for supermode driver, set 01 for standard driver - new: cyan-red balance added - new: experimental introduction to self defined profiles (temporary at EV +2.0) 1.0 = auto 1.1 = cloudy landscape (focus = infinity, yellow WB correction = small) - improve: many problems with SSP resolved by more restrictions and auto disabling if necessary - improve: SSP can be enabled only for manual shutter because SSP for EM/ENM cause unexpected behaviour due to very specific code of this feature - fix: very slow EM (reported by shouhei) - bugfix: when shutter speed is above 3.0 (zoom value) and night mode will be enabled phone will restart, for now when you switch between normal/night mode: SSP goes off and shutter speed safe limit is checked, every illegal value (too short/long time) is corrected to nearest proper value IMPORTANT! if your phone restarted, turn it off and remove battery on a few seconds - fix: when you change shutter speed and then go to manual focus and press snapshot button to enable zoom preview this will cause SSP availability at the same time (reported by primaru), for now when manual focus is activated SSP can not be enabled - improve: better MXE-60 synchronization, high compression to prevent risk of retake snapshots (flash is only fired during the first image) 6.5 TEST4 - bugfix: functions value changes can mess in EM and shutter speed setting (reported by strong) - new: saturation control added at EV -1.0 - change: zoom control moved from EV -1.0 to -2.0 - improve: saturation parameter value reduced and separated to normal and night mode - new: brightness control added [optional function, unavailable under any EV in original driver form] - new: contrast control added [optional function] 6.5 TEST5 - fix: misprint in sharpness initialization code - fix: small cast of yellow color in "cloudy landscape" profile doesn't work - improve: infinity focus and manual focus allowed in video mode - improve: contrast reduced from 01 to 00 (eliminates small overexposure problems) - improve: saturation for normal and night mode integrated into one parameter and reduced - improve: a bit better compression rules for ENM - improve: rewritten documentation in FAQ form 6.5 TEST5u - bugfix: color correction for WB settings isn't applied in CID49 phones 6.5 - improve: full compatibility with configuration tool - change: driver file divided on three "base" versions: - CID36: no CC - W810: no CC, sharpness = 05 - CID49: CC by Lpachuong, contrast = 01 - change: Normal quality reduced to 85% - improve: saturation separated for normal mode and EM/ENM/night mode - improve: image filtering disabled in manual macro zoomed preview for better edge sharpness view - improve: you can set in configuration tool on which quality you want EM to be always enabled - improve: new scan ranges for autofocus (default is AF_MACRO_SCAN_MODE = 01) SCAN_MODE | normal mode | macro mode ----------|-------------------|------------------------ 00 | normal (no macro) | full (normal and macro) 01 | normal (no macro) | fast macro 6.5.1 - improve: unsuccessful snapshot retakes increased (much lower chance of camera crash) - improve: max quality of Fine increased to 91% 6.6 - new: three additional functions for orange, green and magenta color cast added [optional functions] these colors are combinations of cyan, red, yellow and blue colors - new: profiles can control WB - new: profile "document" added - change: max quality of Fine decreased to 90% in practice it's hard to take max 600kb photo with more than 90% quality of course quality in W810 can go up to 95% - change: image filtering extended, now it's applied to EM, ENM and night mode pictures - improve: saturation function value 1.1 = default (neutral) - improve: color correction in profile "cloudy landscape" has been modified - improve: jpeg retry time limit increased to 4000ms - improve: slightly changed file size rules in jpeg compression - improve: CC for all five WB are now visible all the time on viewfinder, previously CC was invisible in realtime and applied only during snapshot process 7. CHANGELOG CONFIGURATION TOOL 0.1 - new: first public release (FUNCTIONALITY PREVIEW) - displace functions into different EV values - edit many initial parameters - add, remove or edit your own profiles - edit CC for default five settings of WB 0.2 BETA YOU SHOULD BE AWARE OF POTENTIAL PROBLEMS! REPORT IF YOU WILL FIND BUGS! ALWAYS CREATE BACKUP OF CAMDRIVER FILE OR DON'T OVERWRITE FILES! - new: file save added - new: compression settings added - improve: FAQ documentation supplemented - improve: image filtering settings extended - improve: better GUI work - improve: much better recognition of the driver code compatibility with the tool 0.2.1 BETA - new: one or many profiles can be exported to file and imported from file - improve: you can remove many profiles from the list at once 0.5 - new: documentation how to adapt the driver's code added - new: extended profiles programmability, additional code can be written for every profile - new: WB selection added as additional setting for profiles - new: support for K790/K800/K810 added - new: file size rules for jpeg encoder can be automatically calculated from defined max jpeg qualities values (this feature works only for max resolutions) - change: Image filtering options renamed to more comprehensible descriptions - change: Macro AF range options renamed to more comprehensible descriptions - change: description "Green - Magenta" renamed to "Red - Cyan" - change: description "Macro preview" renamed to "Focus preview" - improve: optimized GUI in "Profiles" panel for focus and shutter speed values