Source code upload
[framework/connectivity/libgphoto2.git] / camlibs / sq905 / README.913C
1 /* This is a supplemental README file for libgphoto2/camlibs/sq905, dealing
2  * specifically with support for sq913 cameras. This file is an 
3  * integral part of the libgphoto2/camlibs/sq905 library source and is 
4  * distributed with that source under the LGPL license. a copy of which 
5  * license may be seen in any of the source files in libgphoto2/camlibs/sq905, 
6  * or in the head directory of libgphoto2.
7  */ 
8
9
10 INTRODUCTION
11
12 The Argus DC-1730 apparently uses the sq913 chip and has Vendor:Product
13 number 0x2770:0x913c. It provides 640x480 or 320x240 resolution, optional
14 compression setting, and capture mode. The camera also has an LED thumbnail
15 display and a flash, which the user can turn off to save power. Even with
16 these new features, the camera still retails for under $50 (US). This new
17 camera (presumably along with any other 0x2770:0x913c cameras which may
18 exist) uses the same command set as the existing sq905 cameras, and thus it
19 is supported simply by adding its ID to the models list in sq905/library.c.
20 It also has the new chip or model ID 09 13 06 67, but it seems to be
21 supported well enough under the options used for SQ_MODEL_DEFAULT.
22
23 DIFFERENCES BETWEEN SQ913 AND  SQ905 CAMERAS
24
25 As already mentioned, these new cameras have an LED display on the rear and
26 also have a flash. Two other differences are not so readily visible. 
27
28 First, the sq905 cameras have a "video clip" feature. If this feature is
29 set, the camera will shoot frames repeatedly, until its memory is full. The
30 Argus DC-1730 does not have this feature; on similar button setting it will
31 shoot three frames only, and then stop. 
32
33 This functional difference also is reflected in a slightly different format
34 for the configuration data presented by the camera. 
35
36 The most major consequence of this change in the configuration data is
37 that sq_postprocess ( ) must be completely rewritten before it can be used
38 with these cameras; the meaning of entries 7 through 15 in each line of
39 config data is now wrong. For this reason, sq_postprocess ( ) is turned off
40 in CVS for now. 
41
42 Repeating myself: If you are running an existing version of camlibs/sq905
43 and want to just add the new ID number 0x2770:0x913c instead of upgrading,
44 then be sure to comment out the call to sq_postprocess ( ) in the download
45 routine, or rewrite it. Otherwise you will get very funny-looking photos
46 from your Argus DC-1730. 
47
48
49 HARDWARE COMPATIBILITY ISSUES AND PROBLEMS WITH THE ARGUS DC-1730
50
51 The addition of support for 0x2770:0x913c cameras has been delayed somewhat
52 by some rather strange hardware problems which seem to be related to the USB
53 controller chipset on the computer and/or to the length of the cable used to
54 connect the camera. Here, then, are my experiences.
55
56 The first computer on which I tested my new Argus DC-1730 is an old Dell,
57 which has in it a Pentium III (Coppermine) 1Ghz and a board with Intel
58 USB controller. I had no problems at all. Everything was quite routine, and
59 I was about to commit the code to CVS.
60
61 Then, I checked my work on machines and got mixed results:
62
63 On an Athlon 1Ghz on an FIC AZ-11 board, with VIA KT166 chipset, the camera
64 misbehaved. It dropped data blocks while downloading and got jammed,
65 requiring battery removal to clear the jam. However, removal of an extension
66 cable seemed to clear up the problem.
67
68 An old Micron "barebones" system, again with a VIA chipset, seems completely
69 unusable with this camera.
70
71 I have also tested the camera with a Dell Inspiron 7500 laptop. No problems,
72 even with the extension cable. 
73
74 Finally, the camera was tested again on the first machine. the Dell Pentium
75 III, using the extension cable which had caused problems previously. Again
76 no problems.
77
78 Gphoto2-libgphoto2 is installed on all of these computers. No such problems
79 have ever been noticed with any other camera on any of the machines. If you
80 are similarly unlucky with an 0x2770:0x913c camera, it would seem that the
81 only possible cure might be to install another USB controller on an addon
82 card, to use an external USB hub, to take extra precautions about cabling,
83 or in the most extreme circumstances to buy a new computer. You may have no
84 problems. It could be that I just got one bad camera or one bad USB cable to
85 go with it. But in case you do, you are hereby warned.