55c3b9d0dd
git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@8203 67ed7778-7388-44ab-90cf-0a291f65f57c
176 lines
6.3 KiB
Plaintext
176 lines
6.3 KiB
Plaintext
libptp2 (c)2001-2003 Mariusz Woloszyn <emsi@ipartners.pl>
|
|
|
|
=====================
|
|
*About this software*
|
|
=====================
|
|
|
|
This folder contains following code:
|
|
ptp.c - the main libptp2 code; this library is used to communicate
|
|
with PTP devices
|
|
ptp.h - libptp2 header files
|
|
ptp-pack.c - this file is included into ptp.c (internal structure
|
|
pack/unpack code)
|
|
library.c - gphoto2 PTP2 driver (used by gphoto2 to communicate with
|
|
PTP devices)
|
|
|
|
The libptp2 library is under developement yet, but is considered to be
|
|
functional and quite stable.
|
|
It was written to be used with gphoto2, but can be easily used with any other
|
|
software.
|
|
|
|
|
|
|
|
===================
|
|
*Supported Cameras*
|
|
===================
|
|
|
|
NOTE, that if your camera is not on the list, it DOES NOT mean that it is not
|
|
supported! Most of USB cameras designed after 2002 are PTP or USB Mass
|
|
Storage. In both cases the camera is supported under Linux!
|
|
|
|
Below the list of cameras explicitly supported by gphoto2 ptp driver:
|
|
|
|
=============================================+
|
|
Model |Vendor ID|Product ID|
|
|
========================|=========|==========|
|
|
Kodak DC240 (PTP) | 0x040a | 0x0121 |
|
|
Kodak DC4800 | 0x040a | 0x0160 |
|
|
Kodak DX3215 | 0x040a | 0x0525 |
|
|
Kodak DX3500 | 0x040a | 0x0500 |
|
|
Kodak DX3600 | 0x040a | 0x0510 |
|
|
Kodak DX3700 | 0x040a | 0x0530 |
|
|
Kodak DX3900 | 0x040a | 0x0170 |
|
|
Kodak DX4330 | 0x040a | 0x0555 |
|
|
Kodak DX4900 | 0x040a | 0x0550 |
|
|
Kodak MC3 | 0x040a | 0x0400 |
|
|
Kodak LS420 | 0x040a | 0x0540 |
|
|
Kodak LS443 | 0x040a | 0x0568 |
|
|
Kodak CX4200 | 0x040a | 0x0560 |
|
|
Kodak CX4210 | 0x040a | 0x0560 |
|
|
Kodak CX4230 | 0x040a | 0x0535 |
|
|
Kodak CX4300 | 0x040a | 0x0566 |
|
|
------------------------+---------+----------+
|
|
HP PhotoSmart 120 | 0x03f0 | 0x6502 |
|
|
HP PhotoSmart 318 | 0x03f0 | 0x6302 |
|
|
HP PhotoSmart 320 | 0x03f0 | 0x6602 |
|
|
HP PhotoSmart 612 | 0x03f0 | 0x6302 |
|
|
HP PhotoSmart 620 | 0x03f0 | 0x6802 |
|
|
HP PhotoSmart 715 | 0x03f0 | 0x6402 |
|
|
HP PhotoSmart 720 | 0x03f0 | 0x6702 |
|
|
HP PhotoSmart 735 | 0x03f0 | 0x6a02 |
|
|
HP PhotoSmart 812 | 0x03f0 | 0x4202 |
|
|
HP PhotoSmart 850 | 0x03f0 | 0x4302 |
|
|
------------------------+---------+----------+
|
|
Sony DSC-CD300 | 0x054c | 0x004e |
|
|
Sony DSC-F505 | 0x054c | 0x004e |
|
|
Sony DSC-F505V | 0x054c | 0x004e |
|
|
Sony DSC-F707 | 0x054c | 0x004e |
|
|
Sony DSC-F707V | 0x054c | 0x004e |
|
|
Sony DSC-P5 | 0x054c | 0x004e |
|
|
Sony DSC-P30 | 0x054c | 0x004e |
|
|
Sony DSC-P50 | 0x054c | 0x004e |
|
|
Sony DSC-P71 | 0x054c | 0x004e |
|
|
Sony DSC-S75 | 0x054c | 0x004e |
|
|
Sony DSC-S85 | 0x054c | 0x004e |
|
|
Sony MVC-CD300 | 0x054c | 0x004e |
|
|
------------------------+---------+----------+
|
|
Nikon DSC D100 | 0x04b0 | 0x0402 |
|
|
Nikon Coolpix 2000 | 0x04b0 | 0x0302 |
|
|
Nikon Coolpix SQ | 0x04b0 | 0x0202 |
|
|
Nikon Coolpix 2500 | 0x04b0 | 0x0109 |
|
|
Nikon Coolpix 4500 | 0x04b0 | 0x010b |
|
|
Nikon Coolpix 5700 | 0x04b0 | 0x010d |
|
|
Nikon Coolpix 4300 | 0x04b0 | 0x010f |
|
|
Nikon Coolpix 3500 | 0x04b0 | 0x0111 |
|
|
Nikon Coolpix 885 | 0x04b0 | 0x0112 |
|
|
Nikon Coolpix 5000 | 0x04b0 | 0x0113 |
|
|
Nikon Coolpix 3100 | 0x04b0 | 0x0115 |
|
|
Nikon Coolpix 2100 | 0x04b0 | 0x0117 |
|
|
Nikon Coolpix 5400 | 0x04b0 | 0x0119 |
|
|
Nikon Coolpix 5600 | 0x04b0 | 0x012e |
|
|
Nikon Coolpix 5200 | 0x04b0 | 0x0206 |
|
|
------------------------+---------+----------+
|
|
Canon PowerShot S45 | 0x04a9 | 0x306d |
|
|
Canon PowerShot G3 | 0x04a9 | 0x306f |
|
|
Canon PowerShot S230 | 0x04a9 | 0x3071 |
|
|
Canon Digital IXUS v3 | 0x04a9 | 0x3071 |
|
|
Canon PowerShot A60 | 0x04a9 | 0x3074 |
|
|
Canon PowerShot A70 | 0x04a9 | 0x3073 |
|
|
Canon PowerShot A80 | 0x04a9 | 0x309A |
|
|
==============================================
|
|
|
|
ABOVE LIST IS OUTDATED!
|
|
|
|
Note that for some HP, Nikon, Canon and Sony cameras you have to switch
|
|
them to PTP mode, as in most cases the camera is dual mode:
|
|
PTP and USB Mass Storage.
|
|
For some cameras it even changes the Product ID number, so don't panic if
|
|
it does not match the one listed above, just switch the mode.
|
|
Don't ask me how to do it. Refer to camera documentation.
|
|
|
|
If you know that your camera might be a PTP one, you may test it
|
|
against this code even if it's not on the list above. If it's really
|
|
a PTP device, the USB interface class should be set to 6 (it's called "still").
|
|
You may check this by reading /proc/bus/usb/devices, for example:
|
|
|
|
cat /proc/bus/usb/devices | grep "Cls=06"
|
|
|
|
If you find something like this:
|
|
|
|
I: If#= 0 Alt= 0 #EPs= 3 Cls=06(still) Sub=01 Prot=01 Driver=(none)
|
|
^^^^^^^^^^^^^
|
|
that means that your camera is a PTP one.
|
|
The ptp driver should detect that camera by interface class as "USB PTP
|
|
Class Camera" and allow downloading the pictures and do other stuff exactly
|
|
the same way as if it would be detected by product and vendor ID.
|
|
|
|
If you're not Linux user fetch libptp2 from:
|
|
http://sourceforge.net/projects/libptp
|
|
and try to compile and install it.
|
|
The ptpcam tool attached to thil library is able to find and identify PTP
|
|
devices. Type:
|
|
|
|
ptpcam --list-devices
|
|
|
|
and ptpcam will search and display the names of all found PTP devices.
|
|
|
|
|
|
================================
|
|
*Solving and reporting problems*
|
|
================================
|
|
|
|
To solve the problem stick to gphoto2 CLI, forget about the GUI now.
|
|
Use gphoto2 -L to see if it detects the camera.
|
|
|
|
If you see something like this:
|
|
|
|
~> gphoto2 -L
|
|
Unable to get descriptor (-1)
|
|
(... lot of other errors ...)
|
|
|
|
it may mean that you're working as user while the usb access is restricted.
|
|
See gphoto2-manual, section "Setting up your system for use with libgphoto2
|
|
and gphoto2", subsection "Setting up permissions for USB ports"
|
|
(http://gphoto.sourceforge.net/doc/manual/permissions-usb.html).
|
|
|
|
If the gphoto2 detects the camera but then fails with some error messages
|
|
please report the bug sending the mail to gphoto-devel@lists.sourceforge.net or
|
|
directly to me at: emsi@emsi.it.pl.
|
|
The mail should contain the full output of gphoto2 -L --debug with locale
|
|
language set to _ENGLISH_.
|
|
For example in bash do:
|
|
env LANG=C gphoto2 --debug -L
|
|
tcsh/csh:
|
|
setenv LANG C; gphoto2 --debug -L
|
|
|
|
WARGING!!! Before sending any mail make sure you read the notes in
|
|
"Supported Cameras" above.
|
|
|
|
Enjoy!
|
|
|
|
=============
|
|
Documentation
|
|
|
|
While ptp transactions usage seems to be quite obvious the ptp events
|
|
handling code should be documented.
|