ptp.h

00001 /* ptp.h
00002  *
00003  * Copyright (C) 2001 Mariusz Woloszyn <emsi@ipartners.pl>
00004  *
00005  * This library is free software; you can redistribute it and/or
00006  * modify it under the terms of the GNU Lesser General Public
00007  * License as published by the Free Software Foundation; either
00008  * version 2 of the License, or (at your option) any later version.
00009  *
00010  * This library is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  * Lesser General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU Lesser General Public
00016  * License along with this library; if not, write to the
00017  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00018  * Boston, MA 02111-1307, USA.
00019  */
00020 
00021 #ifndef __PTP_H__
00022 #define __PTP_H__
00023 
00024 #include <stdarg.h>
00025 #include <time.h>
00026 #include <iconv.h>
00027 #include "gphoto2-endian.h"
00028 
00029 /* PTP datalayer byteorder */
00030 
00031 #define PTP_DL_BE                       0xF0
00032 #define PTP_DL_LE                       0x0F
00033 
00034 /* PTP request/response/event general PTP container (transport independent) */
00035 
00036 struct _PTPContainer {
00037         uint16_t Code;
00038         uint32_t SessionID;
00039         uint32_t Transaction_ID;
00040         /* params  may be of any type of size less or equal to uint32_t */
00041         uint32_t Param1;
00042         uint32_t Param2;
00043         uint32_t Param3;
00044         /* events can only have three parameters */
00045         uint32_t Param4;
00046         uint32_t Param5;
00047         /* the number of meaningfull parameters */
00048         uint8_t  Nparam;
00049 };
00050 typedef struct _PTPContainer PTPContainer;
00051 
00052 /* PTP USB Bulk-Pipe container */
00053 /* USB bulk max packet length for high speed endpoints */
00054 /* I have changed this from 512 to 4096 now. The spec says
00055  * "end of data transfers are signaled by short packets or NULL
00056  * packets". It never says anything about 512.
00057  * So it should work like this and the MTP folks will be happier...
00058  * -Marcus
00059  */
00060 #define PTP_USB_BULK_HS_MAX_PACKET_LEN  4096
00061 #define PTP_USB_BULK_HDR_LEN            (2*sizeof(uint32_t)+2*sizeof(uint16_t))
00062 #define PTP_USB_BULK_PAYLOAD_LEN        (PTP_USB_BULK_HS_MAX_PACKET_LEN-PTP_USB_BULK_HDR_LEN)
00063 #define PTP_USB_BULK_REQ_LEN    (PTP_USB_BULK_HDR_LEN+5*sizeof(uint32_t))
00064 
00065 struct _PTPUSBBulkContainer {
00066         uint32_t length;
00067         uint16_t type;
00068         uint16_t code;
00069         uint32_t trans_id;
00070         union {
00071                 struct {
00072                         uint32_t param1;
00073                         uint32_t param2;
00074                         uint32_t param3;
00075                         uint32_t param4;
00076                         uint32_t param5;
00077                 } params;
00078                 unsigned char data[PTP_USB_BULK_PAYLOAD_LEN];
00079         } payload;
00080 };
00081 typedef struct _PTPUSBBulkContainer PTPUSBBulkContainer;
00082 
00083 /* PTP USB Asynchronous Event Interrupt Data Format */
00084 struct _PTPUSBEventContainer {
00085         uint32_t length;
00086         uint16_t type;
00087         uint16_t code;
00088         uint32_t trans_id;
00089         uint32_t param1;
00090         uint32_t param2;
00091         uint32_t param3;
00092 };
00093 typedef struct _PTPUSBEventContainer PTPUSBEventContainer;
00094 
00095 
00096 /* USB container types */
00097 
00098 #define PTP_USB_CONTAINER_UNDEFINED             0x0000
00099 #define PTP_USB_CONTAINER_COMMAND               0x0001
00100 #define PTP_USB_CONTAINER_DATA                  0x0002
00101 #define PTP_USB_CONTAINER_RESPONSE              0x0003
00102 #define PTP_USB_CONTAINER_EVENT                 0x0004
00103 
00104 /* PTP/IP definitions */
00105 #define PTPIP_INIT_COMMAND_REQUEST      1
00106 #define PTPIP_INIT_COMMAND_ACK          2
00107 #define PTPIP_INIT_EVENT_REQUEST        3
00108 #define PTPIP_INIT_EVENT_ACK            4
00109 #define PTPIP_INIT_FAIL                 5
00110 #define PTPIP_CMD_REQUEST               6
00111 #define PTPIP_CMD_RESPONSE              7
00112 #define PTPIP_EVENT                     8
00113 #define PTPIP_START_DATA_PACKET         9
00114 #define PTPIP_DATA_PACKET               10
00115 #define PTPIP_CANCEL_TRANSACTION        11
00116 #define PTPIP_END_DATA_PACKET           12
00117 #define PTPIP_PING                      13
00118 #define PTPIP_PONG                      14
00119 
00120 struct _PTPIPHeader {
00121         uint32_t        length;
00122         uint32_t        type;
00123 };
00124 typedef struct _PTPIPHeader PTPIPHeader;
00125 
00126 /* Vendor IDs */
00127 #define PTP_VENDOR_EASTMAN_KODAK        0x00000001
00128 #define PTP_VENDOR_SEIKO_EPSON          0x00000002
00129 #define PTP_VENDOR_AGILENT              0x00000003
00130 #define PTP_VENDOR_POLAROID             0x00000004
00131 #define PTP_VENDOR_AGFA_GEVAERT         0x00000005
00132 #define PTP_VENDOR_MICROSOFT            0x00000006
00133 #define PTP_VENDOR_EQUINOX              0x00000007
00134 #define PTP_VENDOR_VIEWQUEST            0x00000008
00135 #define PTP_VENDOR_STMICROELECTRONICS   0x00000009
00136 #define PTP_VENDOR_NIKON                0x0000000A
00137 #define PTP_VENDOR_CANON                0x0000000B
00138 
00139 /* Operation Codes */
00140 
00141 #define PTP_OC_Undefined                0x1000
00142 #define PTP_OC_GetDeviceInfo            0x1001
00143 #define PTP_OC_OpenSession              0x1002
00144 #define PTP_OC_CloseSession             0x1003
00145 #define PTP_OC_GetStorageIDs            0x1004
00146 #define PTP_OC_GetStorageInfo           0x1005
00147 #define PTP_OC_GetNumObjects            0x1006
00148 #define PTP_OC_GetObjectHandles         0x1007
00149 #define PTP_OC_GetObjectInfo            0x1008
00150 #define PTP_OC_GetObject                0x1009
00151 #define PTP_OC_GetThumb                 0x100A
00152 #define PTP_OC_DeleteObject             0x100B
00153 #define PTP_OC_SendObjectInfo           0x100C
00154 #define PTP_OC_SendObject               0x100D
00155 #define PTP_OC_InitiateCapture          0x100E
00156 #define PTP_OC_FormatStore              0x100F
00157 #define PTP_OC_ResetDevice              0x1010
00158 #define PTP_OC_SelfTest                 0x1011
00159 #define PTP_OC_SetObjectProtection      0x1012
00160 #define PTP_OC_PowerDown                0x1013
00161 #define PTP_OC_GetDevicePropDesc        0x1014
00162 #define PTP_OC_GetDevicePropValue       0x1015
00163 #define PTP_OC_SetDevicePropValue       0x1016
00164 #define PTP_OC_ResetDevicePropValue     0x1017
00165 #define PTP_OC_TerminateOpenCapture     0x1018
00166 #define PTP_OC_MoveObject               0x1019
00167 #define PTP_OC_CopyObject               0x101A
00168 #define PTP_OC_GetPartialObject         0x101B
00169 #define PTP_OC_InitiateOpenCapture      0x101C
00170 
00171 /* Eastman Kodak extension Operation Codes */
00172 #define PTP_OC_EK_GetSerial             0x9003
00173 #define PTP_OC_EK_SetSerial             0x9004
00174 #define PTP_OC_EK_SendFileObjectInfo    0x9005
00175 #define PTP_OC_EK_SendFileObject        0x9006
00176 #define PTP_OC_EK_SetText               0x9008
00177 
00178 /* Canon extension Operation Codes */
00179 #define PTP_OC_CANON_GetObjectSize      0x9001
00180 #define PTP_OC_CANON_9002               0x9002
00181 /* 9002 - sends 2 uint32, nothing back  */
00182 #define PTP_OC_CANON_9003               0x9003
00183 /* 9003 - sends nothing, nothing back  */
00184 /* no 9004 observed yet */
00185 /* no 9005 observed yet */
00186 #define PTP_OC_CANON_LookupObject       0x9006
00187 /* no 9007 observed yet */
00188 #define PTP_OC_CANON_StartShootingMode  0x9008
00189 #define PTP_OC_CANON_EndShootingMode    0x9009
00190 /* 900a - sends nothing, nothing back */
00191 #define PTP_OC_CANON_900a               0x900A
00192 #define PTP_OC_CANON_ViewfinderOn       0x900B
00193 #define PTP_OC_CANON_ViewfinderOff      0x900C
00194 #define PTP_OC_CANON_ReflectChanges     0x900D
00195 
00196 /* 900e - send nothing, gets 5 uint16t in 32bit entities back in 20byte datablob 
00197  * GetFlashDevParam?
00198  */
00199 #define PTP_OC_CANON_900e               0x900E
00200 /* 900f - gets data ... hmm, object handles ? */
00201 #define PTP_OC_CANON_900f               0x900F
00202 
00203 #define PTP_OC_CANON_ThemeDownload      0x9010
00204 #define PTP_OC_CANON_ThemeUpload        0x9011
00205 
00206 /* initiate movie capture:
00207    9010 startmoviecapture?
00208    9003 stopmoviecapture?
00209 */
00210 
00211 #define PTP_OC_CANON_CheckEvent         0x9013
00212 #define PTP_OC_CANON_FocusLock          0x9014
00213 #define PTP_OC_CANON_FocusUnlock        0x9015
00214 #define PTP_OC_CANON_InitiateCaptureInMemory    0x901A
00215 #define PTP_OC_CANON_GetPartialObject   0x901B
00216 #define PTP_OC_CANON_GetViewfinderImage 0x901d
00217         /* Viewfinder Auto functions */
00218 #define PTP_OC_CANON_GetChanges         0x9020
00219 #define PTP_OC_CANON_GetFolderEntries   0x9021
00220 
00221 /* Nikon extension Operation Codes */
00222 #define PTP_OC_NIKON_GetProfileAllData  0x9006
00223 #define PTP_OC_NIKON_SendProfileData    0x9007
00224 #define PTP_OC_NIKON_DeleteProfile      0x9008
00225 #define PTP_OC_NIKON_SetProfileData     0x9009
00226 #define PTP_OC_NIKON_AdvancedTransfer   0x9010
00227 #define PTP_OC_NIKON_GetFileInfoInBlock 0x9011
00228 #define PTP_OC_NIKON_Capture            0x90C0
00229 #define PTP_OC_NIKON_SetControlMode     0x90C2
00230 #define PTP_OC_NIKON_CurveDownload      0x90C5
00231 #define PTP_OC_NIKON_CurveUpload        0x90C6
00232 #define PTP_OC_NIKON_CheckEvent         0x90C7
00233 #define PTP_OC_NIKON_DeviceReady        0x90C8
00234 #define PTP_OC_NIKON_GetDevicePTPIPInfo 0x90E0
00235 
00236 /* Microsoft / MTP extension codes */
00237 #define PTP_OC_MTP_GetObjectPropsSupported      0x9801
00238 #define PTP_OC_MTP_GetObjectPropDesc            0x9802
00239 #define PTP_OC_MTP_GetObjectPropValue           0x9803
00240 #define PTP_OC_MTP_SetObjectPropValue           0x9804
00241 #define PTP_OC_MTP_GetObjPropList               0x9805
00242 #define PTP_OC_MTP_SetObjPropList               0x9806
00243 #define PTP_OC_MTP_GetInterdependendPropdesc    0x9807
00244 #define PTP_OC_MTP_SendObjectPropList           0x9808
00245 #define PTP_OC_MTP_GetObjectReferences          0x9810
00246 #define PTP_OC_MTP_SetObjectReferences          0x9811
00247 #define PTP_OC_MTP_UpdateDeviceFirmware         0x9812
00248 #define PTP_OC_MTP_Skip                         0x9820
00249 
00250 /* Proprietary vendor extension operations mask */
00251 #define PTP_OC_EXTENSION_MASK           0xF000
00252 #define PTP_OC_EXTENSION                0x9000
00253 
00254 /* Response Codes */
00255 
00256 #define PTP_RC_Undefined                0x2000
00257 #define PTP_RC_OK                       0x2001
00258 #define PTP_RC_GeneralError             0x2002
00259 #define PTP_RC_SessionNotOpen           0x2003
00260 #define PTP_RC_InvalidTransactionID     0x2004
00261 #define PTP_RC_OperationNotSupported    0x2005
00262 #define PTP_RC_ParameterNotSupported    0x2006
00263 #define PTP_RC_IncompleteTransfer       0x2007
00264 #define PTP_RC_InvalidStorageId         0x2008
00265 #define PTP_RC_InvalidObjectHandle      0x2009
00266 #define PTP_RC_DevicePropNotSupported   0x200A
00267 #define PTP_RC_InvalidObjectFormatCode  0x200B
00268 #define PTP_RC_StoreFull                0x200C
00269 #define PTP_RC_ObjectWriteProtected     0x200D
00270 #define PTP_RC_StoreReadOnly            0x200E
00271 #define PTP_RC_AccessDenied             0x200F
00272 #define PTP_RC_NoThumbnailPresent       0x2010
00273 #define PTP_RC_SelfTestFailed           0x2011
00274 #define PTP_RC_PartialDeletion          0x2012
00275 #define PTP_RC_StoreNotAvailable        0x2013
00276 #define PTP_RC_SpecificationByFormatUnsupported         0x2014
00277 #define PTP_RC_NoValidObjectInfo        0x2015
00278 #define PTP_RC_InvalidCodeFormat        0x2016
00279 #define PTP_RC_UnknownVendorCode        0x2017
00280 #define PTP_RC_CaptureAlreadyTerminated 0x2018
00281 #define PTP_RC_DeviceBusy               0x2019
00282 #define PTP_RC_InvalidParentObject      0x201A
00283 #define PTP_RC_InvalidDevicePropFormat  0x201B
00284 #define PTP_RC_InvalidDevicePropValue   0x201C
00285 #define PTP_RC_InvalidParameter         0x201D
00286 #define PTP_RC_SessionAlreadyOpened     0x201E
00287 #define PTP_RC_TransactionCanceled      0x201F
00288 #define PTP_RC_SpecificationOfDestinationUnsupported            0x2020
00289 
00290 /* Eastman Kodak extension Response Codes */
00291 #define PTP_RC_EK_FilenameRequired      0xA001
00292 #define PTP_RC_EK_FilenameConflicts     0xA002
00293 #define PTP_RC_EK_FilenameInvalid       0xA003
00294 
00295 /* Nikon specific response codes */
00296 #define PTP_RC_NIKON_AdvancedTransferCancel 0xA022
00297 
00298 /* Microsoft/MTP specific codes */
00299 #define PTP_RC_MTP_Undefined                    0xA800
00300 #define PTP_RC_MTP_Invalid_ObjectPropCode       0xA801
00301 #define PTP_RC_MTP_Invalid_ObjectProp_Format    0xA802
00302 #define PTP_RC_MTP_Invalid_ObjectProp_Value     0xA803
00303 #define PTP_RC_MTP_Invalid_ObjectReference      0xA804
00304 #define PTP_RC_MTP_Invalid_Dataset              0xA806
00305 #define PTP_RC_MTP_Specification_By_Group_Unsupported           0xA808
00306 #define PTP_RC_MTP_Object_Too_Large             0xA809
00307 
00308 /* libptp2 extended ERROR codes */
00309 #define PTP_ERROR_IO                    0x02FF
00310 #define PTP_ERROR_DATA_EXPECTED         0x02FE
00311 #define PTP_ERROR_RESP_EXPECTED         0x02FD
00312 #define PTP_ERROR_BADPARAM              0x02FC
00313 
00314 /* PTP Event Codes */
00315 
00316 #define PTP_EC_Undefined                0x4000
00317 #define PTP_EC_CancelTransaction        0x4001
00318 #define PTP_EC_ObjectAdded              0x4002
00319 #define PTP_EC_ObjectRemoved            0x4003
00320 #define PTP_EC_StoreAdded               0x4004
00321 #define PTP_EC_StoreRemoved             0x4005
00322 #define PTP_EC_DevicePropChanged        0x4006
00323 #define PTP_EC_ObjectInfoChanged        0x4007
00324 #define PTP_EC_DeviceInfoChanged        0x4008
00325 #define PTP_EC_RequestObjectTransfer    0x4009
00326 #define PTP_EC_StoreFull                0x400A
00327 #define PTP_EC_DeviceReset              0x400B
00328 #define PTP_EC_StorageInfoChanged       0x400C
00329 #define PTP_EC_CaptureComplete          0x400D
00330 #define PTP_EC_UnreportedStatus         0x400E
00331 
00332 /* Canon extension Event Codes */
00333 #define PTP_EC_CANON_ExtendedErrorcode          0xC005  /* ? */
00334 #define PTP_EC_CANON_ObjectInfoChanged          0xC008
00335 #define PTP_EC_CANON_RequestObjectTransfer      0xC009
00336 #define PTP_EC_CANON_CameraModeChanged          0xC00C
00337 
00338 /* Nikon extension Event Codes */
00339 #define PTP_EC_Nikon_ObjectAddedInSDRAM         0xC101
00340 /* Gets 1 parameter, objectid pointing to DPOF object */
00341 #define PTP_EC_Nikon_AdvancedTransfer           0xC103
00342 
00343 /* constants for GetObjectHandles */
00344 #define PTP_GOH_ALL_STORAGE 0xffffffff
00345 #define PTP_GOH_ALL_FORMATS 0x00000000
00346 #define PTP_GOH_ALL_ASSOCS  0x00000000
00347 
00348 /* PTP device info structure (returned by GetDevInfo) */
00349 
00350 struct _PTPDeviceInfo {
00351         uint16_t StaqndardVersion;
00352         uint32_t VendorExtensionID;
00353         uint16_t VendorExtensionVersion;
00354         char    *VendorExtensionDesc;
00355         uint16_t FunctionalMode;
00356         uint32_t OperationsSupported_len;
00357         uint16_t *OperationsSupported;
00358         uint32_t EventsSupported_len;
00359         uint16_t *EventsSupported;
00360         uint32_t DevicePropertiesSupported_len;
00361         uint16_t *DevicePropertiesSupported;
00362         uint32_t CaptureFormats_len;
00363         uint16_t *CaptureFormats;
00364         uint32_t ImageFormats_len;
00365         uint16_t *ImageFormats;
00366         char    *Manufacturer;
00367         char    *Model;
00368         char    *DeviceVersion;
00369         char    *SerialNumber;
00370 };
00371 typedef struct _PTPDeviceInfo PTPDeviceInfo;
00372 
00373 /* PTP storageIDs structute (returned by GetStorageIDs) */
00374 
00375 struct _PTPStorageIDs {
00376         uint32_t n;
00377         uint32_t *Storage;
00378 };
00379 typedef struct _PTPStorageIDs PTPStorageIDs;
00380 
00381 /* PTP StorageInfo structure (returned by GetStorageInfo) */
00382 struct _PTPStorageInfo {
00383         uint16_t StorageType;
00384         uint16_t FilesystemType;
00385         uint16_t AccessCapability;
00386         uint64_t MaxCapability;
00387         uint64_t FreeSpaceInBytes;
00388         uint32_t FreeSpaceInImages;
00389         char    *StorageDescription;
00390         char    *VolumeLabel;
00391 };
00392 typedef struct _PTPStorageInfo PTPStorageInfo;
00393 
00394 /* PTP objecthandles structure (returned by GetObjectHandles) */
00395 
00396 struct _PTPObjectHandles {
00397         uint32_t n;
00398         uint32_t *Handler;
00399 };
00400 typedef struct _PTPObjectHandles PTPObjectHandles;
00401 
00402 #define PTP_HANDLER_SPECIAL     0xffffffff
00403 #define PTP_HANDLER_ROOT        0x00000000
00404 
00405 
00406 /* PTP objectinfo structure (returned by GetObjectInfo) */
00407 
00408 struct _PTPObjectInfo {
00409         uint32_t StorageID;
00410         uint16_t ObjectFormat;
00411         uint16_t ProtectionStatus;
00412         uint32_t ObjectCompressedSize;
00413         uint16_t ThumbFormat;
00414         uint32_t ThumbCompressedSize;
00415         uint32_t ThumbPixWidth;
00416         uint32_t ThumbPixHeight;
00417         uint32_t ImagePixWidth;
00418         uint32_t ImagePixHeight;
00419         uint32_t ImageBitDepth;
00420         uint32_t ParentObject;
00421         uint16_t AssociationType;
00422         uint32_t AssociationDesc;
00423         uint32_t SequenceNumber;
00424         char    *Filename;
00425         time_t  CaptureDate;
00426         time_t  ModificationDate;
00427         char    *Keywords;
00428 };
00429 typedef struct _PTPObjectInfo PTPObjectInfo;
00430 
00431 /* max ptp string length INCLUDING terminating null character */
00432 
00433 #define PTP_MAXSTRLEN                           255
00434 
00435 /* PTP Object Format Codes */
00436 
00437 /* ancillary formats */
00438 #define PTP_OFC_Undefined                       0x3000
00439 #define PTP_OFC_Association                     0x3001
00440 #define PTP_OFC_Script                          0x3002
00441 #define PTP_OFC_Executable                      0x3003
00442 #define PTP_OFC_Text                            0x3004
00443 #define PTP_OFC_HTML                            0x3005
00444 #define PTP_OFC_DPOF                            0x3006
00445 #define PTP_OFC_AIFF                            0x3007
00446 #define PTP_OFC_WAV                             0x3008
00447 #define PTP_OFC_MP3                             0x3009
00448 #define PTP_OFC_AVI                             0x300A
00449 #define PTP_OFC_MPEG                            0x300B
00450 #define PTP_OFC_ASF                             0x300C
00451 #define PTP_OFC_QT                              0x300D /* guessing */
00452 /* image formats */
00453 #define PTP_OFC_EXIF_JPEG                       0x3801
00454 #define PTP_OFC_TIFF_EP                         0x3802
00455 #define PTP_OFC_FlashPix                        0x3803
00456 #define PTP_OFC_BMP                             0x3804
00457 #define PTP_OFC_CIFF                            0x3805
00458 #define PTP_OFC_Undefined_0x3806                0x3806
00459 #define PTP_OFC_GIF                             0x3807
00460 #define PTP_OFC_JFIF                            0x3808
00461 #define PTP_OFC_PCD                             0x3809
00462 #define PTP_OFC_PICT                            0x380A
00463 #define PTP_OFC_PNG                             0x380B
00464 #define PTP_OFC_Undefined_0x380C                0x380C
00465 #define PTP_OFC_TIFF                            0x380D
00466 #define PTP_OFC_TIFF_IT                         0x380E
00467 #define PTP_OFC_JP2                             0x380F
00468 #define PTP_OFC_JPX                             0x3810
00469 /* Eastman Kodak extension ancillary format */
00470 #define PTP_OFC_EK_M3U                          0xb002
00471 /* MTP extensions */
00472 #define PTP_OFC_MTP_Firmware                    0xb802
00473 #define PTP_OFC_MTP_WindowsImageFormat          0xb882
00474 #define PTP_OFC_MTP_UndefinedAudio              0xb900
00475 #define PTP_OFC_MTP_WMA                         0xb901
00476 #define PTP_OFC_MTP_OGG                         0xb902
00477 #define PTP_OFC_MTP_AudibleCodec                0xb904
00478 #define PTP_OFC_MTP_UndefinedVideo              0xb980
00479 #define PTP_OFC_MTP_WMV                         0xb981
00480 #define PTP_OFC_MTP_MP4                         0xb982
00481 #define PTP_OFC_MTP_UndefinedCollection         0xba00
00482 #define PTP_OFC_MTP_AbstractMultimediaAlbum     0xba01
00483 #define PTP_OFC_MTP_AbstractImageAlbum          0xba02
00484 #define PTP_OFC_MTP_AbstractAudioAlbum          0xba03
00485 #define PTP_OFC_MTP_AbstractVideoAlbum          0xba04
00486 #define PTP_OFC_MTP_AbstractAudioVideoPlaylist  0xba05
00487 #define PTP_OFC_MTP_AbstractContactGroup        0xba06
00488 #define PTP_OFC_MTP_AbstractMessageFolder       0xba07
00489 #define PTP_OFC_MTP_AbstractChapteredProduction 0xba08
00490 #define PTP_OFC_MTP_WPLPlaylist                 0xba10
00491 #define PTP_OFC_MTP_M3UPlaylist                 0xba11
00492 #define PTP_OFC_MTP_MPLPlaylist                 0xba12
00493 #define PTP_OFC_MTP_ASXPlaylist                 0xba13
00494 #define PTP_OFC_MTP_PLSPlaylist                 0xba14
00495 #define PTP_OFC_MTP_UndefinedDocument           0xba80
00496 #define PTP_OFC_MTP_AbstractDocument            0xba81
00497 #define PTP_OFC_MTP_UndefinedMessage            0xbb00
00498 #define PTP_OFC_MTP_AbstractMessage             0xbb01
00499 #define PTP_OFC_MTP_UndefinedContact            0xbb80
00500 #define PTP_OFC_MTP_AbstractContact             0xbb81
00501 #define PTP_OFC_MTP_vCard2                      0xbb82
00502 #define PTP_OFC_MTP_vCard3                      0xbb83
00503 #define PTP_OFC_MTP_UndefinedCalendarItem       0xbe00
00504 #define PTP_OFC_MTP_AbstractCalendarItem        0xbe01
00505 #define PTP_OFC_MTP_vCalendar1                  0xbe02
00506 #define PTP_OFC_MTP_vCalendar2                  0xbe03
00507 #define PTP_OFC_MTP_UndefinedWindowsExecutable  0xbe80
00508 
00509 /* PTP Association Types */
00510 #define PTP_AT_Undefined                        0x0000
00511 #define PTP_AT_GenericFolder                    0x0001
00512 #define PTP_AT_Album                            0x0002
00513 #define PTP_AT_TimeSequence                     0x0003
00514 #define PTP_AT_HorizontalPanoramic              0x0004
00515 #define PTP_AT_VerticalPanoramic                0x0005
00516 #define PTP_AT_2DPanoramic                      0x0006
00517 #define PTP_AT_AncillaryData                    0x0007
00518 
00519 /* PTP Protection Status */
00520 
00521 #define PTP_PS_NoProtection                     0x0000
00522 #define PTP_PS_ReadOnly                         0x0001
00523 
00524 /* PTP Storage Types */
00525 
00526 #define PTP_ST_Undefined                        0x0000
00527 #define PTP_ST_FixedROM                         0x0001
00528 #define PTP_ST_RemovableROM                     0x0002
00529 #define PTP_ST_FixedRAM                         0x0003
00530 #define PTP_ST_RemovableRAM                     0x0004
00531 
00532 /* PTP FilesystemType Values */
00533 
00534 #define PTP_FST_Undefined                       0x0000
00535 #define PTP_FST_GenericFlat                     0x0001
00536 #define PTP_FST_GenericHierarchical             0x0002
00537 #define PTP_FST_DCF                             0x0003
00538 
00539 /* PTP StorageInfo AccessCapability Values */
00540 
00541 #define PTP_AC_ReadWrite                        0x0000
00542 #define PTP_AC_ReadOnly                         0x0001
00543 #define PTP_AC_ReadOnly_with_Object_Deletion    0x0002
00544 
00545 /* Property Describing Dataset, Range Form */
00546 
00547 union _PTPPropertyValue {
00548         char            *str;   /* common string, malloced */
00549         uint16_t        *unistr; /* UCS2 unicode string, malloced */
00550         uint8_t         u8;
00551         int8_t          i8;
00552         uint16_t        u16;
00553         int16_t         i16;
00554         uint32_t        u32;
00555         int32_t         i32;
00556         /* XXXX: 64bit and 128 bit signed and unsigned missing */
00557         struct array {
00558                 uint32_t        count;
00559                 union _PTPPropertyValue *v;     /* malloced, count elements */
00560         } a;
00561 };
00562 
00563 typedef union _PTPPropertyValue PTPPropertyValue;
00564 
00565 struct _PTPPropDescRangeForm {
00566         PTPPropertyValue        MinimumValue;
00567         PTPPropertyValue        MaximumValue;
00568         PTPPropertyValue        StepSize;
00569 };
00570 typedef struct _PTPPropDescRangeForm PTPPropDescRangeForm;
00571 
00572 /* Property Describing Dataset, Enum Form */
00573 
00574 struct _PTPPropDescEnumForm {
00575         uint16_t                NumberOfValues;
00576         PTPPropertyValue        *SupportedValue;        /* malloced */
00577 };
00578 typedef struct _PTPPropDescEnumForm PTPPropDescEnumForm;
00579 
00580 /* Device Property Describing Dataset (DevicePropDesc) */
00581 
00582 struct _PTPDevicePropDesc {
00583         uint16_t                DevicePropertyCode;
00584         uint16_t                DataType;
00585         uint8_t                 GetSet;
00586         PTPPropertyValue        FactoryDefaultValue;
00587         PTPPropertyValue        CurrentValue;
00588         uint8_t                 FormFlag;
00589         union   {
00590                 PTPPropDescEnumForm     Enum;
00591                 PTPPropDescRangeForm    Range;
00592         } FORM;
00593 };
00594 typedef struct _PTPDevicePropDesc PTPDevicePropDesc;
00595 
00596 /* Object Property Describing Dataset (DevicePropDesc) */
00597 
00598 struct _PTPObjectPropDesc {
00599         uint16_t                ObjectPropertyCode;
00600         uint16_t                DataType;
00601         uint8_t                 GetSet;
00602         PTPPropertyValue        FactoryDefaultValue;
00603         uint32_t                GroupCode;
00604         uint8_t                 FormFlag;
00605         union   {
00606                 PTPPropDescEnumForm     Enum;
00607                 PTPPropDescRangeForm    Range;
00608         } FORM;
00609 };
00610 typedef struct _PTPObjectPropDesc PTPObjectPropDesc;
00611 
00612 /* Canon filesystem's folder entry Dataset */
00613 
00614 #define PTP_CANON_FilenameBufferLen     13
00615 #define PTP_CANON_FolderEntryLen        28
00616 
00617 struct _PTPCANONFolderEntry {
00618         uint32_t        ObjectHandle;
00619         uint16_t        ObjectFormatCode;
00620         uint8_t         Flags;
00621         uint32_t        ObjectSize;
00622         time_t          Time;
00623         char            Filename[PTP_CANON_FilenameBufferLen];
00624 };
00625 typedef struct _PTPCANONFolderEntry PTPCANONFolderEntry;
00626 
00627 /* Nikon Tone Curve Data */
00628 
00629 #define PTP_NIKON_MaxCurvePoints 19
00630 
00631 struct _PTPNIKONCoordinatePair {
00632         uint8_t         X;
00633         uint8_t         Y;
00634 };
00635 
00636 typedef struct _PTPNIKONCoordinatePair PTPNIKONCoordinatePair;
00637 
00638 struct _PTPNTCCoordinatePair {
00639         uint8_t         X;
00640         uint8_t         Y;
00641 };
00642 
00643 typedef struct _PTPNTCCoordinatePair PTPNTCCoordinatePair;
00644 
00645 struct _PTPNIKONCurveData {
00646         char                    static_preamble[6];
00647         uint8_t                 XAxisStartPoint;
00648         uint8_t                 XAxisEndPoint;
00649         uint8_t                 YAxisStartPoint;
00650         uint8_t                 YAxisEndPoint;
00651         uint8_t                 MidPointIntegerPart;
00652         uint8_t                 MidPointDecimalPart;
00653         uint8_t                 NCoordinates;
00654         PTPNIKONCoordinatePair  CurveCoordinates[PTP_NIKON_MaxCurvePoints];
00655 };
00656 
00657 typedef struct _PTPNIKONCurveData PTPNIKONCurveData;
00658 
00659 struct _PTPEKTextParams {
00660         char    *title;
00661         char    *line[5];
00662 };
00663 typedef struct _PTPEKTextParams PTPEKTextParams;
00664 
00665 /* Nikon Wifi profiles */
00666 
00667 struct _PTPNIKONWifiProfile {
00668         /* Values valid both when reading and writing profiles */
00669         char      profile_name[17];
00670         uint8_t   device_type;
00671         uint8_t   icon_type;
00672         char      essid[33];
00673 
00674         /* Values only valid when reading. Some of these are in the write packet,
00675          * but are set automatically, like id, display_order and creation_date. */
00676         uint8_t   id;
00677         uint8_t   valid;
00678         uint8_t   display_order;
00679         char      creation_date[16];
00680         char      lastusage_date[16];
00681         
00682         /* Values only valid when writing */
00683         uint32_t  ip_address;
00684         uint8_t   subnet_mask; /* first zero bit position, e.g. 24 for 255.255.255.0 */
00685         uint32_t  gateway_address;
00686         uint8_t   address_mode; /* 0 - Manual, 2-3 -  DHCP ad-hoc/managed*/
00687         uint8_t   access_mode; /* 0 - Managed, 1 - Adhoc */
00688         uint8_t   wifi_channel; /* 1-11 */
00689         uint8_t   authentification; /* 0 - Open, 1 - Shared, 2 - WPA-PSK */
00690         uint8_t   encryption; /* 0 - None, 1 - WEP 64bit, 2 - WEP 128bit (not supported: 3 - TKIP) */
00691         uint8_t   key[64];
00692         uint8_t   key_nr;
00693 //      char      guid[16];
00694 };
00695 
00696 typedef struct _PTPNIKONWifiProfile PTPNIKONWifiProfile;
00697 
00698 /* DataType Codes */
00699 
00700 #define PTP_DTC_UNDEF           0x0000
00701 #define PTP_DTC_INT8            0x0001
00702 #define PTP_DTC_UINT8           0x0002
00703 #define PTP_DTC_INT16           0x0003
00704 #define PTP_DTC_UINT16          0x0004
00705 #define PTP_DTC_INT32           0x0005
00706 #define PTP_DTC_UINT32          0x0006
00707 #define PTP_DTC_INT64           0x0007
00708 #define PTP_DTC_UINT64          0x0008
00709 #define PTP_DTC_INT128          0x0009
00710 #define PTP_DTC_UINT128         0x000A
00711 
00712 #define PTP_DTC_ARRAY_MASK      0x4000
00713 
00714 #define PTP_DTC_AINT8           (PTP_DTC_ARRAY_MASK | PTP_DTC_INT8)
00715 #define PTP_DTC_AUINT8          (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT8)
00716 #define PTP_DTC_AINT16          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT16)
00717 #define PTP_DTC_AUINT16         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT16)
00718 #define PTP_DTC_AINT32          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT32)
00719 #define PTP_DTC_AUINT32         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT32)
00720 #define PTP_DTC_AINT64          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT64)
00721 #define PTP_DTC_AUINT64         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT64)
00722 #define PTP_DTC_AINT128         (PTP_DTC_ARRAY_MASK | PTP_DTC_INT128)
00723 #define PTP_DTC_AUINT128        (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT128)
00724 
00725 #define PTP_DTC_STR             0xFFFF
00726 
00727 /* Device Properties Codes */
00728 
00729 #define PTP_DPC_Undefined               0x5000
00730 #define PTP_DPC_BatteryLevel            0x5001
00731 #define PTP_DPC_FunctionalMode          0x5002
00732 #define PTP_DPC_ImageSize               0x5003
00733 #define PTP_DPC_CompressionSetting      0x5004
00734 #define PTP_DPC_WhiteBalance            0x5005
00735 #define PTP_DPC_RGBGain                 0x5006
00736 #define PTP_DPC_FNumber                 0x5007
00737 #define PTP_DPC_FocalLength             0x5008
00738 #define PTP_DPC_FocusDistance           0x5009
00739 #define PTP_DPC_FocusMode               0x500A
00740 #define PTP_DPC_ExposureMeteringMode    0x500B
00741 #define PTP_DPC_FlashMode               0x500C
00742 #define PTP_DPC_ExposureTime            0x500D
00743 #define PTP_DPC_ExposureProgramMode     0x500E
00744 #define PTP_DPC_ExposureIndex           0x500F
00745 #define PTP_DPC_ExposureBiasCompensation        0x5010
00746 #define PTP_DPC_DateTime                0x5011
00747 #define PTP_DPC_CaptureDelay            0x5012
00748 #define PTP_DPC_StillCaptureMode        0x5013
00749 #define PTP_DPC_Contrast                0x5014
00750 #define PTP_DPC_Sharpness               0x5015
00751 #define PTP_DPC_DigitalZoom             0x5016
00752 #define PTP_DPC_EffectMode              0x5017
00753 #define PTP_DPC_BurstNumber             0x5018
00754 #define PTP_DPC_BurstInterval           0x5019
00755 #define PTP_DPC_TimelapseNumber         0x501A
00756 #define PTP_DPC_TimelapseInterval       0x501B
00757 #define PTP_DPC_FocusMeteringMode       0x501C
00758 #define PTP_DPC_UploadURL               0x501D
00759 #define PTP_DPC_Artist                  0x501E
00760 #define PTP_DPC_CopyrightInfo           0x501F
00761 
00762 /* Proprietary vendor extension device property mask */
00763 #define PTP_DPC_EXTENSION_MASK          0xF000
00764 #define PTP_DPC_EXTENSION               0xD000
00765 
00766 /* Vendor Extensions device property codes */
00767 
00768 /* Eastman Kodak extension device property codes */
00769 #define PTP_DPC_EK_ColorTemperature     0xD001
00770 #define PTP_DPC_EK_DateTimeStampFormat  0xD002
00771 #define PTP_DPC_EK_BeepMode             0xD003
00772 #define PTP_DPC_EK_VideoOut             0xD004
00773 #define PTP_DPC_EK_PowerSaving          0xD005
00774 #define PTP_DPC_EK_UI_Language          0xD006
00775 /* Canon extension device property codes */
00776 #define PTP_DPC_CANON_BeepMode          0xD001
00777 #define PTP_DPC_CANON_ViewfinderMode    0xD003
00778 #define PTP_DPC_CANON_ImageQuality      0xD006
00779 #define PTP_DPC_CANON_D007              0xD007
00780 #define PTP_DPC_CANON_ImageSize         0xD008
00781 #define PTP_DPC_CANON_FlashMode         0xD00A
00782 #define PTP_DPC_CANON_ShootingMode      0xD00C
00783 #define PTP_DPC_CANON_DriveMode         0xD00E
00784 #define PTP_DPC_CANON_MeteringMode      0xD010
00785 #define PTP_DPC_CANON_AFDistance        0xD011
00786 #define PTP_DPC_CANON_FocusingPoint     0xD012
00787 #define PTP_DPC_CANON_WhiteBalance      0xD013
00788 #define PTP_DPC_CANON_ISOSpeed          0xD01C
00789 #define PTP_DPC_CANON_Aperture          0xD01D
00790 #define PTP_DPC_CANON_ShutterSpeed      0xD01E
00791 #define PTP_DPC_CANON_ExpCompensation   0xD01F
00792 
00793         /* capture data type (?) */
00794 #define PTP_DPC_CANON_D029              0xD029
00795 #define PTP_DPC_CANON_Zoom              0xD02A
00796 #define PTP_DPC_CANON_SizeQualityMode   0xD02C
00797 #define PTP_DPC_CANON_FirmwareVersion   0xD031
00798 #define PTP_DPC_CANON_CameraModel       0xD032
00799 #define PTP_DPC_CANON_CameraOwner       0xD033
00800 #define PTP_DPC_CANON_UnixTime          0xD034
00801 #define PTP_DPC_CANON_DZoomMagnification        0xD039
00802 #define PTP_DPC_CANON_PhotoEffect       0xD040
00803 #define PTP_DPC_CANON_AssistLight       0xD041
00804 #define PTP_DPC_CANON_D045              0xD045
00805 #define PTP_DPC_CANON_AverageFilesizes  0xD048
00806 
00807 /* Nikon extension device property codes */
00808 #define PTP_DPC_NIKON_ShootingBank                      0xD010
00809 #define PTP_DPC_NIKON_ShootingBankNameA                 0xD011
00810 #define PTP_DPC_NIKON_ShootingBankNameB                 0xD012
00811 #define PTP_DPC_NIKON_ShootingBankNameC                 0xD013
00812 #define PTP_DPC_NIKON_ShootingBankNameD                 0xD014
00813 #define PTP_DPC_NIKON_RawCompression                    0xD016
00814 #define PTP_DPC_NIKON_WhiteBalanceAutoBias              0xD017
00815 #define PTP_DPC_NIKON_WhiteBalanceTungstenBias          0xD018
00816 #define PTP_DPC_NIKON_WhiteBalanceFluorescentBias       0xD019
00817 #define PTP_DPC_NIKON_WhiteBalanceDaylightBias          0xD01A
00818 #define PTP_DPC_NIKON_WhiteBalanceFlashBias             0xD01B
00819 #define PTP_DPC_NIKON_WhiteBalanceCloudyBias            0xD01C
00820 #define PTP_DPC_NIKON_WhiteBalanceShadeBias             0xD01D
00821 #define PTP_DPC_NIKON_WhiteBalanceColorTemperature      0xD01E
00822 #define PTP_DPC_NIKON_ImageSharpening                   0xD02A
00823 #define PTP_DPC_NIKON_ToneCompensation                  0xD02B
00824 #define PTP_DPC_NIKON_ColorModel                        0xD02C
00825 #define PTP_DPC_NIKON_HueAdjustment                     0xD02D
00826 #define PTP_DPC_NIKON_NonCPULensDataFocalLength         0xD02E
00827 #define PTP_DPC_NIKON_NonCPULensDataMaximumAperture     0xD02F
00828 #define PTP_DPC_NIKON_CSMMenuBankSelect                 0xD040
00829 #define PTP_DPC_NIKON_MenuBankNameA                     0xD041
00830 #define PTP_DPC_NIKON_MenuBankNameB                     0xD042
00831 #define PTP_DPC_NIKON_MenuBankNameC                     0xD043
00832 #define PTP_DPC_NIKON_MenuBankNameD                     0xD044
00833 #define PTP_DPC_NIKON_A1AFCModePriority                 0xD048
00834 #define PTP_DPC_NIKON_A2AFSModePriority                 0xD049
00835 #define PTP_DPC_NIKON_A3GroupDynamicAF                  0xD04A
00836 #define PTP_DPC_NIKON_A4AFActivation                    0xD04B
00837 #define PTP_DPC_NIKON_A5FocusAreaIllumManualFocus       0xD04C
00838 #define PTP_DPC_NIKON_FocusAreaIllumContinuous          0xD04D
00839 #define PTP_DPC_NIKON_FocusAreaIllumWhenSelected        0xD04E
00840 #define PTP_DPC_NIKON_FocusAreaWrap                     0xD04F
00841 #define PTP_DPC_NIKON_A7VerticalAFON                    0xD050
00842 #define PTP_DPC_NIKON_ISOAuto                           0xD054
00843 #define PTP_DPC_NIKON_B2ISOStep                         0xD055
00844 #define PTP_DPC_NIKON_EVStep                            0xD056
00845 #define PTP_DPC_NIKON_B4ExposureCompEv                  0xD057
00846 #define PTP_DPC_NIKON_ExposureCompensation              0xD058
00847 #define PTP_DPC_NIKON_CenterWeightArea                  0xD059
00848 #define PTP_DPC_NIKON_AELockMode                        0xD05E
00849 #define PTP_DPC_NIKON_AELAFLMode                        0xD05F
00850 #define PTP_DPC_NIKON_MeterOff                          0xD062
00851 #define PTP_DPC_NIKON_SelfTimer                         0xD063
00852 #define PTP_DPC_NIKON_MonitorOff                        0xD064
00853 #define PTP_DPC_NIKON_D1ShootingSpeed                   0xD068
00854 #define PTP_DPC_NIKON_D2MaximumShots                    0xD069
00855 #define PTP_DPC_NIKON_D3ExpDelayMode                    0xD06A
00856 #define PTP_DPC_NIKON_LongExposureNoiseReduction        0xD06B
00857 #define PTP_DPC_NIKON_FileNumberSequence                0xD06C
00858 #define PTP_DPC_NIKON_D6ControlPanelFinderRearControl   0xD06D
00859 #define PTP_DPC_NIKON_ControlPanelFinderViewfinder      0xD06E
00860 #define PTP_DPC_NIKON_D7Illumination                    0xD06F
00861 #define PTP_DPC_NIKON_E1FlashSyncSpeed                  0xD074
00862 #define PTP_DPC_NIKON_FlashShutterSpeed                 0xD075
00863 #define PTP_DPC_NIKON_E3AAFlashMode                     0xD076
00864 #define PTP_DPC_NIKON_E4ModelingFlash                   0xD077
00865 #define PTP_DPC_NIKON_BracketSet                        0xD078
00866 #define PTP_DPC_NIKON_E6ManualModeBracketing            0xD079  
00867 #define PTP_DPC_NIKON_BracketOrder                      0xD07A
00868 #define PTP_DPC_NIKON_E8AutoBracketSelection            0xD07B
00869 #define PTP_DPC_NIKON_F1CenterButtonShootingMode        0xD080
00870 #define PTP_DPC_NIKON_CenterButtonPlaybackMode          0xD081
00871 #define PTP_DPC_NIKON_F2Multiselector                   0xD082
00872 #define PTP_DPC_NIKON_F3PhotoInfoPlayback               0xD083
00873 #define PTP_DPC_NIKON_F4AssignFuncButton                0xD084
00874 #define PTP_DPC_NIKON_F5CustomizeCommDials              0xD085
00875 #define PTP_DPC_NIKON_ReverseCommandDial                0xD086
00876 #define PTP_DPC_NIKON_ApertureSetting                   0xD087
00877 #define PTP_DPC_NIKON_MenusAndPlayback                  0xD088
00878 #define PTP_DPC_NIKON_F6ButtonsAndDials                 0xD089
00879 #define PTP_DPC_NIKON_NoCFCard                          0xD08A
00880 #define PTP_DPC_NIKON_ImageCommentString                0xD090
00881 #define PTP_DPC_NIKON_ImageCommentAttach                0xD091
00882 #define PTP_DPC_NIKON_ImageRotation                     0xD092
00883 #define PTP_DPC_NIKON_Bracketing                        0xD0C0
00884 #define PTP_DPC_NIKON_ExposureBracketingIntervalDist    0xD0C1
00885 #define PTP_DPC_NIKON_BracketingProgram                 0xD0C2
00886 #define PTP_DPC_NIKON_LensID                            0xD0E0
00887 #define PTP_DPC_NIKON_FocalLengthMin                    0xD0E3
00888 #define PTP_DPC_NIKON_FocalLengthMax                    0xD0E4
00889 #define PTP_DPC_NIKON_MaxApAtMinFocalLength             0xD0E5
00890 #define PTP_DPC_NIKON_MaxApAtMaxFocalLength             0xD0E6
00891 #define PTP_DPC_NIKON_ExposureTime                      0xD100
00892 #define PTP_DPC_NIKON_MaximumShots                      0xD103
00893 #define PTP_DPC_NIKON_AutoExposureLock                  0xD105
00894 #define PTP_DPC_NIKON_AutoFocusLock                     0xD106
00895 #define PTP_DPC_NIKON_AutofocusLCDTopMode2              0xD107
00896 #define PTP_DPC_NIKON_AutofocusArea                     0xD108
00897 #define PTP_DPC_NIKON_LightMeter                        0xD10A
00898 #define PTP_DPC_NIKON_CameraOrientation                 0xD10E
00899 #define PTP_DPC_NIKON_ExposureApertureLock              0xD111
00900 #define PTP_DPC_NIKON_FlashExposureCompensation         0xD126
00901 #define PTP_DPC_NIKON_OptimizeImage                     0xD140
00902 #define PTP_DPC_NIKON_Saturation                        0xD142
00903 #define PTP_DPC_NIKON_BeepOff                           0xD160
00904 #define PTP_DPC_NIKON_AutofocusMode                     0xD161
00905 #define PTP_DPC_NIKON_AFAssist                          0xD163
00906 #define PTP_DPC_NIKON_PADVPMode                         0xD164
00907 #define PTP_DPC_NIKON_ImageReview                       0xD165
00908 #define PTP_DPC_NIKON_AFAreaIllumination                0xD166
00909 #define PTP_DPC_NIKON_FlashMode                         0xD167
00910 #define PTP_DPC_NIKON_FlashCommanderMode                0xD168
00911 #define PTP_DPC_NIKON_FlashSign                         0xD169
00912 #define PTP_DPC_NIKON_RemoteTimeout                     0xD16B
00913 #define PTP_DPC_NIKON_GridDisplay                       0xD16C
00914 #define PTP_DPC_NIKON_FlashModeManualPower              0xD16D
00915 #define PTP_DPC_NIKON_FlashModeCommanderPower           0xD16E
00916 #define PTP_DPC_NIKON_CSMMenu                           0xD180
00917 #define PTP_DPC_NIKON_BracketingFramesAndSteps          0xD190
00918 #define PTP_DPC_NIKON_LowLight                          0xD1B0
00919 #define PTP_DPC_NIKON_FlashOpen                         0xD1C0
00920 #define PTP_DPC_NIKON_FlashCharged                      0xD1C1
00921 
00922 /* Microsoft/MTP specific */
00923 #define PTP_DPC_MTP_SecureTime                          0xD101
00924 #define PTP_DPC_MTP_DeviceCertificate                   0xD102
00925 #define PTP_DPC_MTP_SynchronizationPartner              0xD401
00926 #define PTP_DPC_MTP_DeviceFriendlyName                  0xD402
00927 #define PTP_DPC_MTP_VolumeLevel                         0xD403
00928 #define PTP_DPC_MTP_DeviceIcon                          0xD405
00929 #define PTP_DPC_MTP_PlaybackRate                        0xD410
00930 #define PTP_DPC_MTP_PlaybackObject                      0xD411
00931 #define PTP_DPC_MTP_PlaybackContainerIndex              0xD412
00932 #define PTP_DPC_MTP_PlaybackPosition                    0xD413
00933 
00934 /* MTP specific Object Properties */
00935 #define PTP_OPC_StorageID                               0xDC01
00936 #define PTP_OPC_ObjectFormat                            0xDC02
00937 #define PTP_OPC_ProtectionStatus                        0xDC03
00938 #define PTP_OPC_ObjectSize                              0xDC04
00939 #define PTP_OPC_AssociationType                         0xDC05
00940 #define PTP_OPC_AssociationDesc                         0xDC06
00941 #define PTP_OPC_ObjectFileName                          0xDC07
00942 #define PTP_OPC_DateCreated                             0xDC08
00943 #define PTP_OPC_DateModified                            0xDC09
00944 #define PTP_OPC_Keywords                                0xDC0A
00945 #define PTP_OPC_ParentObject                            0xDC0B
00946 #define PTP_OPC_PersistantUniqueObjectIdentifier        0xDC41
00947 #define PTP_OPC_SyncID                                  0xDC42
00948 #define PTP_OPC_PropertyBag                             0xDC43
00949 #define PTP_OPC_Name                                    0xDC44
00950 #define PTP_OPC_CreatedBy                               0xDC45
00951 #define PTP_OPC_Artist                                  0xDC46
00952 #define PTP_OPC_DateAuthored                            0xDC47
00953 #define PTP_OPC_Description                             0xDC48
00954 #define PTP_OPC_URLReference                            0xDC49
00955 #define PTP_OPC_LanguageLocale                          0xDC4A
00956 #define PTP_OPC_CopyrightInformation                    0xDC4B
00957 #define PTP_OPC_Source                                  0xDC4C
00958 #define PTP_OPC_OriginLocation                          0xDC4D
00959 #define PTP_OPC_DateAdded                               0xDC4E
00960 #define PTP_OPC_NonConsumable                           0xDC4F
00961 #define PTP_OPC_CorruptOrUnplayable                     0xDC50
00962 #define PTP_OPC_RepresentativeSampleFormat              0xDC81
00963 #define PTP_OPC_RepresentativeSampleSize                0xDC82
00964 #define PTP_OPC_RepresentativeSampleHeight              0xDC83
00965 #define PTP_OPC_RepresentativeSampleWidth               0xDC84
00966 #define PTP_OPC_RepresentativeSampleDuration            0xDC85
00967 #define PTP_OPC_RepresentativeSampleData                0xDC86
00968 #define PTP_OPC_Width                                   0xDC87
00969 #define PTP_OPC_Height                                  0xDC88
00970 #define PTP_OPC_Duration                                0xDC89
00971 #define PTP_OPC_Rating                                  0xDC8A
00972 #define PTP_OPC_Track                                   0xDC8B
00973 #define PTP_OPC_Genre                                   0xDC8C
00974 #define PTP_OPC_Credits                                 0xDC8D
00975 #define PTP_OPC_Lyrics                                  0xDC8E
00976 #define PTP_OPC_SubscriptionContentID                   0xDC8F
00977 #define PTP_OPC_ProducedBy                              0xDC90
00978 #define PTP_OPC_UseCount                                0xDC91
00979 #define PTP_OPC_SkipCount                               0xDC92
00980 #define PTP_OPC_LastAccessed                            0xDC93
00981 #define PTP_OPC_ParentalRating                          0xDC94
00982 #define PTP_OPC_MetaGenre                               0xDC95
00983 #define PTP_OPC_Composer                                0xDC96
00984 #define PTP_OPC_EffectiveRating                         0xDC97
00985 #define PTP_OPC_Subtitle                                0xDC98
00986 #define PTP_OPC_OriginalReleaseDate                     0xDC99
00987 #define PTP_OPC_AlbumName                               0xDC9A
00988 #define PTP_OPC_AlbumArtist                             0xDC9B
00989 #define PTP_OPC_Mood                                    0xDC9C
00990 #define PTP_OPC_DRMStatus                               0xDC9D
00991 #define PTP_OPC_SubDescription                          0xDC9E
00992 #define PTP_OPC_IsCropped                               0xDCD1
00993 #define PTP_OPC_IsColorCorrected                        0xDCD2
00994 #define PTP_OPC_TotalBitRate                            0xDE91
00995 #define PTP_OPC_BitRateType                             0xDE92
00996 #define PTP_OPC_SampleRate                              0xDE93
00997 #define PTP_OPC_NumberOfChannels                        0xDE94
00998 #define PTP_OPC_AudioBitDepth                           0xDE95
00999 #define PTP_OPC_ScanDepth                               0xDE97
01000 #define PTP_OPC_AudioWAVECodec                          0xDE99
01001 #define PTP_OPC_AudioBitRate                            0xDE9A
01002 #define PTP_OPC_VideoFourCCCodec                        0xDE9B
01003 #define PTP_OPC_VideoBitRate                            0xDE9C
01004 #define PTP_OPC_FramesPerThousandSeconds                0xDE9D
01005 #define PTP_OPC_KeyFrameDistance                        0xDE9E
01006 #define PTP_OPC_BufferSize                              0xDE9F
01007 #define PTP_OPC_EncodingQuality                         0xDEA0
01008 
01009 /* Device Property Form Flag */
01010 
01011 #define PTP_DPFF_None                   0x00
01012 #define PTP_DPFF_Range                  0x01
01013 #define PTP_DPFF_Enumeration            0x02
01014 
01015 /* Object Property Codes used by MTP (first 3 are same as DPFF codes) */
01016 #define PTP_OPFF_None                   0x00
01017 #define PTP_OPFF_Range                  0x01
01018 #define PTP_OPFF_Enumeration            0x02
01019 #define PTP_OPFF_DateTime               0x03
01020 #define PTP_OPFF_FixedLengthArray       0x04
01021 #define PTP_OPFF_RegularExpression      0x05
01022 #define PTP_OPFF_ByteArray              0x06
01023 #define PTP_OPFF_LongString             0xFF
01024 
01025 /* Device Property GetSet type */
01026 #define PTP_DPGS_Get                    0x00
01027 #define PTP_DPGS_GetSet                 0x01
01028 
01029 /* Glue stuff starts here */
01030 
01031 typedef struct _PTPParams PTPParams;
01032 
01033 /* raw write functions */
01034 typedef short (* PTPIOReadFunc) (unsigned char *bytes, unsigned int size,
01035                                  void *data, unsigned int *readlen);
01036 typedef short (* PTPIOWriteFunc)(unsigned char *bytes, unsigned int size,
01037                                  void *data);
01038 /*
01039  * This functions take PTP oriented arguments and send them over an
01040  * appropriate data layer doing byteorder conversion accordingly.
01041  */
01042 typedef uint16_t (* PTPIOSendReq)       (PTPParams* params, PTPContainer* req);
01043 typedef uint16_t (* PTPIOSendData)      (PTPParams* params, PTPContainer* ptp,
01044                                          unsigned char *data, unsigned int size,
01045                                          int from_fd);
01046 typedef uint16_t (* PTPIOGetResp)       (PTPParams* params, PTPContainer* resp);
01047 typedef uint16_t (* PTPIOGetData)       (PTPParams* params, PTPContainer* ptp,
01048                                         unsigned char **data, unsigned int *recvlen,
01049                                         int to_fd);
01050 /* debug functions */
01051 typedef void (* PTPErrorFunc) (void *data, const char *format, va_list args)
01052 #if (__GNUC__ >= 3)
01053         __attribute__((__format__(printf,2,0)))
01054 #endif
01055 ;
01056 typedef void (* PTPDebugFunc) (void *data, const char *format, va_list args)
01057 #if (__GNUC__ >= 3)
01058         __attribute__((__format__(printf,2,0)))
01059 #endif
01060 ;
01061 
01062 struct _PTPParams {
01063         /* data layer byteorder */
01064         uint8_t byteorder;
01065 
01066         /* Data layer IO functions */
01067         PTPIOReadFunc   read_func;
01068         PTPIOWriteFunc  write_func;
01069         PTPIOReadFunc   check_int_func;
01070         PTPIOReadFunc   check_int_fast_func;
01071 
01072         /* Custom IO functions */
01073         PTPIOSendReq    sendreq_func;
01074         PTPIOSendData   senddata_func;
01075         PTPIOGetResp    getresp_func;
01076         PTPIOGetData    getdata_func;
01077         PTPIOGetResp    event_check;
01078         PTPIOGetResp    event_wait;
01079 
01080         /* Custom error and debug function */
01081         PTPErrorFunc error_func;
01082         PTPDebugFunc debug_func;
01083 
01084         /* Data passed to above functions */
01085         void *data;
01086 
01087         /* ptp transaction ID */
01088         uint32_t transaction_id;
01089         /* ptp session ID */
01090         uint32_t session_id;
01091 
01092         /* if we have MTP style split header/data transfers */
01093         int     split_header_data;
01094 
01095         /* internal structures used by ptp driver */
01096         PTPObjectHandles handles;
01097         PTPObjectInfo * objectinfo;
01098         PTPDeviceInfo deviceinfo;
01099 
01100         /* Wifi profiles */
01101         uint8_t  wifi_profiles_version;
01102         uint8_t  wifi_profiles_number;
01103         PTPNIKONWifiProfile *wifi_profiles;
01104 
01105         /* PTP/IP related data */
01106         int             cmdfd, evtfd;
01107         uint8_t         cameraguid[16];
01108         uint32_t        eventpipeid;
01109         char            *cameraname;
01110 
01111         /* iconv converters */
01112         iconv_t cd_locale_to_ucs2;
01113         iconv_t cd_ucs2_to_locale;
01114 };
01115 
01116 /* last, but not least - ptp functions */
01117 uint16_t ptp_usb_sendreq        (PTPParams* params, PTPContainer* req);
01118 uint16_t ptp_usb_senddata       (PTPParams* params, PTPContainer* ptp,
01119                                  unsigned char *data, unsigned int size,
01120                                  int from_fd);
01121 uint16_t ptp_usb_getresp        (PTPParams* params, PTPContainer* resp);
01122 uint16_t ptp_usb_getdata        (PTPParams* params, PTPContainer* ptp, 
01123                                  unsigned char **data, unsigned int *readlen,
01124                                  int to_fd);
01125 uint16_t ptp_usb_event_check    (PTPParams* params, PTPContainer* event);
01126 uint16_t ptp_usb_event_wait     (PTPParams* params, PTPContainer* event);
01127 
01128 int      ptp_ptpip_connect      (PTPParams* params, const char *port);
01129 uint16_t ptp_ptpip_sendreq      (PTPParams* params, PTPContainer* req);
01130 uint16_t ptp_ptpip_senddata     (PTPParams* params, PTPContainer* ptp,
01131                                 unsigned char *data, unsigned int size,
01132                                 int to_fd);
01133 uint16_t ptp_ptpip_getresp      (PTPParams* params, PTPContainer* resp);
01134 uint16_t ptp_ptpip_getdata      (PTPParams* params, PTPContainer* ptp, 
01135                                  unsigned char **data, unsigned int *readlen,
01136                                  int to_fd);
01137 uint16_t ptp_ptpip_event_wait   (PTPParams* params, PTPContainer* event);
01138 uint16_t ptp_ptpip_event_check  (PTPParams* params, PTPContainer* event);
01139 
01140 uint16_t ptp_getdeviceinfo      (PTPParams* params, PTPDeviceInfo* deviceinfo);
01141 
01142 uint16_t ptp_opensession        (PTPParams *params, uint32_t session);
01143 uint16_t ptp_closesession       (PTPParams *params);
01144 
01145 uint16_t ptp_getstorageids      (PTPParams* params, PTPStorageIDs* storageids);
01146 uint16_t ptp_getstorageinfo     (PTPParams* params, uint32_t storageid,
01147                                 PTPStorageInfo* storageinfo);
01148 uint16_t ptp_formatstore        (PTPParams* params, uint32_t storageid);
01149 
01150 uint16_t ptp_getobjecthandles   (PTPParams* params, uint32_t storage,
01151                                 uint32_t objectformatcode,
01152                                 uint32_t associationOH,
01153                                 PTPObjectHandles* objecthandles);
01154 
01155 uint16_t ptp_getnumobjects      (PTPParams* params, uint32_t storage,
01156                                 uint32_t objectformatcode,
01157                                 uint32_t associationOH,
01158                                 uint32_t* numobs);
01159 
01160 uint16_t ptp_getobjectinfo      (PTPParams *params, uint32_t handle,
01161                                 PTPObjectInfo* objectinfo);
01162 
01163 uint16_t ptp_getobject          (PTPParams *params, uint32_t handle,
01164                                 unsigned char** object);
01165 uint16_t ptp_getobject_tofd     (PTPParams* params, uint32_t handle, int fd);
01166 uint16_t ptp_getpartialobject   (PTPParams* params, uint32_t handle, uint32_t offset,
01167                                 uint32_t maxbytes, unsigned char** object);
01168 uint16_t ptp_getthumb           (PTPParams *params, uint32_t handle,
01169                                 unsigned char** object);
01170 
01171 uint16_t ptp_deleteobject       (PTPParams* params, uint32_t handle,
01172                                 uint32_t ofc);
01173 
01174 uint16_t ptp_sendobjectinfo     (PTPParams* params, uint32_t* store,
01175                                 uint32_t* parenthandle, uint32_t* handle,
01176                                 PTPObjectInfo* objectinfo);
01177 uint16_t ptp_sendobject         (PTPParams* params, unsigned char* object,
01178                                  uint32_t size);
01179 uint16_t ptp_sendobject_fromfd  (PTPParams* params, int fd, uint32_t size);
01180 
01181 uint16_t ptp_initiatecapture    (PTPParams* params, uint32_t storageid,
01182                                 uint32_t ofc);
01183 
01184 uint16_t ptp_getdevicepropdesc  (PTPParams* params, uint16_t propcode,
01185                                 PTPDevicePropDesc *devicepropertydesc);
01186 uint16_t ptp_getdevicepropvalue (PTPParams* params, uint16_t propcode,
01187                                 PTPPropertyValue* value, uint16_t datatype);
01188 uint16_t ptp_setdevicepropvalue (PTPParams* params, uint16_t propcode,
01189                                 PTPPropertyValue* value, uint16_t datatype);
01190 
01191 uint16_t ptp_mtp_getobjectpropdesc (PTPParams* params, uint16_t opc, uint16_t ofc,
01192                                 PTPObjectPropDesc *objectpropertydesc);
01193 uint16_t ptp_mtp_getobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc, 
01194                                 PTPPropertyValue *value, uint16_t datatype);
01195 uint16_t ptp_mtp_setobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc,
01196                                 PTPPropertyValue *value, uint16_t datatype);
01197 uint16_t ptp_mtp_getobjectreferences (PTPParams* params, uint32_t handle, uint32_t** ohArray, uint32_t* arraylen);
01198 uint16_t ptp_mtp_setobjectreferences (PTPParams* params, uint32_t handle, uint32_t* ohArray, uint32_t arraylen);
01199 
01200 
01201 /* Eastman Kodak extensions */
01202 uint16_t ptp_ek_9007 (PTPParams* params, unsigned char **serial, unsigned int *size);
01203 uint16_t ptp_ek_9009 (PTPParams* params, uint32_t*, uint32_t*);
01204 uint16_t ptp_ek_900c (PTPParams* params, unsigned char **serial, unsigned int *size);
01205 uint16_t ptp_ek_getserial (PTPParams* params, unsigned char **serial, unsigned int *size);
01206 uint16_t ptp_ek_setserial (PTPParams* params, unsigned char *serial, uint32_t size);
01207 uint16_t ptp_ek_settext (PTPParams* params, PTPEKTextParams *text);
01208 uint16_t ptp_ek_sendfileobjectinfo (PTPParams* params, uint32_t* store,
01209                                 uint32_t* parenthandle, uint32_t* handle,
01210                                 PTPObjectInfo* objectinfo);
01211 uint16_t ptp_ek_sendfileobject  (PTPParams* params, unsigned char* object,
01212                                 uint32_t size);
01213 
01214 /* Canon PTP extensions */
01215 uint16_t ptp_canon_9012 (PTPParams* params);
01216 uint16_t ptp_canon_getobjectsize (PTPParams* params, uint32_t handle,
01217                                 uint32_t p2, uint32_t* size, uint32_t* rp2);
01218 
01219 uint16_t ptp_canon_startshootingmode (PTPParams* params);
01220 uint16_t ptp_canon_endshootingmode (PTPParams* params);
01221 
01222 uint16_t ptp_canon_viewfinderon (PTPParams* params);
01223 uint16_t ptp_canon_viewfinderoff (PTPParams* params);
01224 
01225 uint16_t ptp_canon_reflectchanges (PTPParams* params, uint32_t p1);
01226 uint16_t ptp_canon_checkevent (PTPParams* params, 
01227                                 PTPUSBEventContainer* event, int* isevent);
01228 uint16_t ptp_canon_focuslock (PTPParams* params);
01229 uint16_t ptp_canon_focusunlock (PTPParams* params);
01230 uint16_t ptp_canon_initiatecaptureinmemory (PTPParams* params);
01231 uint16_t ptp_canon_getpartialobject (PTPParams* params, uint32_t handle, 
01232                                 uint32_t offset, uint32_t size,
01233                                 uint32_t pos, unsigned char** block, 
01234                                 uint32_t* readnum);
01235 uint16_t ptp_canon_getviewfinderimage (PTPParams* params, unsigned char** image,
01236                                 uint32_t* size);
01237 uint16_t ptp_canon_getchanges (PTPParams* params, uint16_t** props,
01238                                 uint32_t* propnum); 
01239 uint16_t ptp_canon_getfolderentries (PTPParams* params, uint32_t store,
01240                                 uint32_t p2, uint32_t parenthandle,
01241                                 uint32_t handle, 
01242                                 PTPCANONFolderEntry** entries,
01243                                 uint32_t* entnum);
01244 uint16_t ptp_canon_lookup_object (PTPParams* params, char* name, uint32_t* objectid);
01245 uint16_t ptp_canon_theme_download (PTPParams* params, uint32_t themenr,
01246                                 unsigned char **data, unsigned int *size);
01247 
01248 uint16_t ptp_nikon_curve_download (PTPParams* params, 
01249                                 unsigned char **data, unsigned int *size);
01250 uint16_t ptp_nikon_getptpipinfo (PTPParams* params, unsigned char **data, unsigned int *size);
01251 uint16_t ptp_nikon_getwifiprofilelist (PTPParams* params);
01252 uint16_t ptp_nikon_writewifiprofile (PTPParams* params, PTPNIKONWifiProfile* profile);
01253 uint16_t ptp_nikon_deletewifiprofile (PTPParams* params, uint32_t profilenr);
01254 uint16_t ptp_nikon_setcontrolmode (PTPParams* params, uint32_t mode);
01255 uint16_t ptp_nikon_capture (PTPParams* params, uint32_t x);
01256 uint16_t ptp_nikon_check_event (PTPParams* params, PTPUSBEventContainer **evt, int *evtcnt);
01257 uint16_t ptp_nikon_getfileinfoinblock (PTPParams* params, uint32_t p1, uint32_t p2, uint32_t p3,
01258                                         unsigned char **data, unsigned int *size);
01259 uint16_t ptp_nikon_device_ready (PTPParams* params);
01260 uint16_t ptp_mtp_getobjectpropssupported (PTPParams* params, uint16_t ofc, uint32_t *propnum, uint16_t **props);
01261 
01262 /* Non PTP protocol functions */
01263 int ptp_operation_issupported   (PTPParams* params, uint16_t operation);
01264 int ptp_event_issupported       (PTPParams* params, uint16_t event);
01265 int ptp_property_issupported    (PTPParams* params, uint16_t property);
01266 
01267 void ptp_free_devicepropdesc    (PTPDevicePropDesc* dpd);
01268 void ptp_free_devicepropvalue   (uint16_t dt, PTPPropertyValue* dpd);
01269 void ptp_free_objectpropdesc    (PTPObjectPropDesc* dpd);
01270 void ptp_perror                 (PTPParams* params, uint16_t error);
01271 
01272 const char*
01273 ptp_get_property_description(PTPParams* params, uint16_t dpc);
01274 
01275 int
01276 ptp_render_property_value(PTPParams* params, uint16_t dpc,
01277                           PTPDevicePropDesc *dpd, int length, char *out);
01278 int ptp_render_ofc(PTPParams* params, uint16_t ofc, int spaceleft, char *txt);
01279 int ptp_render_mtp_propname(uint16_t propid, int spaceleft, char *txt);
01280 
01281 /* ptpip.c */
01282 void ptp_nikon_getptpipguid (unsigned char* guid);
01283 #endif /* __PTP_H__ */

Generated on Mon Nov 6 02:44:59 2006 for libmtp by  doxygen 1.4.7