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 /* The max packet is set to 512 bytes. The spec says
00055  * "end of data transfers are signaled by short packets or NULL
00056  * packets". It never says anything about 512, but current
00057  * implementations seem to have chosen this value, which also
00058  * happens to be the size of an USB 2.0 HS endpoint, even though
00059  * this is not necessary.
00060  *
00061  * Previously we had this as 4096 for MTP devices. We have found
00062  * and fixed the bugs that made this necessary and it can be 512 again.
00063  */
00064 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE    512
00065 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_READ   512
00066 #define PTP_USB_BULK_HDR_LEN            (2*sizeof(uint32_t)+2*sizeof(uint16_t))
00067 #define PTP_USB_BULK_PAYLOAD_LEN_WRITE  (PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE-PTP_USB_BULK_HDR_LEN)
00068 #define PTP_USB_BULK_PAYLOAD_LEN_READ   (PTP_USB_BULK_HS_MAX_PACKET_LEN_READ-PTP_USB_BULK_HDR_LEN)
00069 #define PTP_USB_BULK_REQ_LEN    (PTP_USB_BULK_HDR_LEN+5*sizeof(uint32_t))
00070 
00071 struct _PTPUSBBulkContainer {
00072         uint32_t length;
00073         uint16_t type;
00074         uint16_t code;
00075         uint32_t trans_id;
00076         union {
00077                 struct {
00078                         uint32_t param1;
00079                         uint32_t param2;
00080                         uint32_t param3;
00081                         uint32_t param4;
00082                         uint32_t param5;
00083                 } params;
00084        /* this must be set to the maximum of PTP_USB_BULK_PAYLOAD_LEN_WRITE 
00085         * and PTP_USB_BULK_PAYLOAD_LEN_READ */
00086                 unsigned char data[PTP_USB_BULK_PAYLOAD_LEN_READ];
00087         } payload;
00088 };
00089 typedef struct _PTPUSBBulkContainer PTPUSBBulkContainer;
00090 
00091 /* PTP USB Asynchronous Event Interrupt Data Format */
00092 struct _PTPUSBEventContainer {
00093         uint32_t length;
00094         uint16_t type;
00095         uint16_t code;
00096         uint32_t trans_id;
00097         uint32_t param1;
00098         uint32_t param2;
00099         uint32_t param3;
00100 };
00101 typedef struct _PTPUSBEventContainer PTPUSBEventContainer;
00102 
00103 struct _PTPCanon_directtransfer_entry {
00104         uint32_t        oid;
00105         char            *str;
00106 };
00107 typedef struct _PTPCanon_directtransfer_entry PTPCanon_directtransfer_entry;
00108 
00109 /* USB container types */
00110 
00111 #define PTP_USB_CONTAINER_UNDEFINED             0x0000
00112 #define PTP_USB_CONTAINER_COMMAND               0x0001
00113 #define PTP_USB_CONTAINER_DATA                  0x0002
00114 #define PTP_USB_CONTAINER_RESPONSE              0x0003
00115 #define PTP_USB_CONTAINER_EVENT                 0x0004
00116 
00117 /* PTP/IP definitions */
00118 #define PTPIP_INIT_COMMAND_REQUEST      1
00119 #define PTPIP_INIT_COMMAND_ACK          2
00120 #define PTPIP_INIT_EVENT_REQUEST        3
00121 #define PTPIP_INIT_EVENT_ACK            4
00122 #define PTPIP_INIT_FAIL                 5
00123 #define PTPIP_CMD_REQUEST               6
00124 #define PTPIP_CMD_RESPONSE              7
00125 #define PTPIP_EVENT                     8
00126 #define PTPIP_START_DATA_PACKET         9
00127 #define PTPIP_DATA_PACKET               10
00128 #define PTPIP_CANCEL_TRANSACTION        11
00129 #define PTPIP_END_DATA_PACKET           12
00130 #define PTPIP_PING                      13
00131 #define PTPIP_PONG                      14
00132 
00133 struct _PTPIPHeader {
00134         uint32_t        length;
00135         uint32_t        type;
00136 };
00137 typedef struct _PTPIPHeader PTPIPHeader;
00138 
00139 /* Vendor IDs */
00140 #define PTP_VENDOR_EASTMAN_KODAK        0x00000001
00141 #define PTP_VENDOR_SEIKO_EPSON          0x00000002
00142 #define PTP_VENDOR_AGILENT              0x00000003
00143 #define PTP_VENDOR_POLAROID             0x00000004
00144 #define PTP_VENDOR_AGFA_GEVAERT         0x00000005
00145 #define PTP_VENDOR_MICROSOFT            0x00000006
00146 #define PTP_VENDOR_EQUINOX              0x00000007
00147 #define PTP_VENDOR_VIEWQUEST            0x00000008
00148 #define PTP_VENDOR_STMICROELECTRONICS   0x00000009
00149 #define PTP_VENDOR_NIKON                0x0000000A
00150 #define PTP_VENDOR_CANON                0x0000000B
00151 
00152 /* Operation Codes */
00153 
00154 #define PTP_OC_Undefined                0x1000
00155 #define PTP_OC_GetDeviceInfo            0x1001
00156 #define PTP_OC_OpenSession              0x1002
00157 #define PTP_OC_CloseSession             0x1003
00158 #define PTP_OC_GetStorageIDs            0x1004
00159 #define PTP_OC_GetStorageInfo           0x1005
00160 #define PTP_OC_GetNumObjects            0x1006
00161 #define PTP_OC_GetObjectHandles         0x1007
00162 #define PTP_OC_GetObjectInfo            0x1008
00163 #define PTP_OC_GetObject                0x1009
00164 #define PTP_OC_GetThumb                 0x100A
00165 #define PTP_OC_DeleteObject             0x100B
00166 #define PTP_OC_SendObjectInfo           0x100C
00167 #define PTP_OC_SendObject               0x100D
00168 #define PTP_OC_InitiateCapture          0x100E
00169 #define PTP_OC_FormatStore              0x100F
00170 #define PTP_OC_ResetDevice              0x1010
00171 #define PTP_OC_SelfTest                 0x1011
00172 #define PTP_OC_SetObjectProtection      0x1012
00173 #define PTP_OC_PowerDown                0x1013
00174 #define PTP_OC_GetDevicePropDesc        0x1014
00175 #define PTP_OC_GetDevicePropValue       0x1015
00176 #define PTP_OC_SetDevicePropValue       0x1016
00177 #define PTP_OC_ResetDevicePropValue     0x1017
00178 #define PTP_OC_TerminateOpenCapture     0x1018
00179 #define PTP_OC_MoveObject               0x1019
00180 #define PTP_OC_CopyObject               0x101A
00181 #define PTP_OC_GetPartialObject         0x101B
00182 #define PTP_OC_InitiateOpenCapture      0x101C
00183 
00184 /* Eastman Kodak extension Operation Codes */
00185 #define PTP_OC_EK_GetSerial             0x9003
00186 #define PTP_OC_EK_SetSerial             0x9004
00187 #define PTP_OC_EK_SendFileObjectInfo    0x9005
00188 #define PTP_OC_EK_SendFileObject        0x9006
00189 #define PTP_OC_EK_SetText               0x9008
00190 
00191 /* Canon extension Operation Codes */
00192 #define PTP_OC_CANON_GetPartialObjectInfo       0x9001
00193 #define PTP_OC_CANON_SetObjectArchive           0x9002
00194 /* 9002 - sends 2 uint32, nothing back  */
00195 #define PTP_OC_CANON_9003                       0x9003
00196 /* 9003 - sends nothing, nothing back  */
00197 /* no 9004 observed yet */
00198 /* no 9005 observed yet */
00199 #define PTP_OC_CANON_GetObjectHandleByName      0x9006
00200 /* no 9007 observed yet */
00201 #define PTP_OC_CANON_StartShootingMode          0x9008
00202 #define PTP_OC_CANON_EndShootingMode            0x9009
00203 /* 900a - sends nothing, nothing back */
00204 #define PTP_OC_CANON_900a                       0x900A
00205 #define PTP_OC_CANON_ViewfinderOn               0x900B
00206 #define PTP_OC_CANON_ViewfinderOff              0x900C
00207 #define PTP_OC_CANON_DoAeAfAwb                  0x900D
00208 
00209 /* 900e - send nothing, gets 5 uint16t in 32bit entities back in 20byte datablob */
00210 #define PTP_OC_CANON_GetCustomizeSpec           0x900E
00211 #define PTP_OC_CANON_GetCustomizeItemInfo       0x900F
00212 #define PTP_OC_CANON_GetCustomizeData           0x9010
00213 #define PTP_OC_CANON_SetCustomizeData           0x9011
00214 
00215 /* initiate movie capture:
00216    9010 startmoviecapture?
00217    9003 stopmoviecapture?
00218 */
00219 
00220 #define PTP_OC_CANON_CheckEvent                 0x9013
00221 #define PTP_OC_CANON_FocusLock                  0x9014
00222 #define PTP_OC_CANON_FocusUnlock                0x9015
00223 #define PTP_OC_CANON_InitiateCaptureInMemory    0x901A
00224 #define PTP_OC_CANON_GetPartialObjectEx         0x901B
00225 #define PTP_OC_CANON_SetObjectTime              0x901C
00226 #define PTP_OC_CANON_GetViewfinderImage         0x901D
00227 #define PTP_OC_CANON_ChangeUSBProtocol          0x901F
00228 #define PTP_OC_CANON_GetChanges                 0x9020
00229 #define PTP_OC_CANON_GetObjectInfoEx            0x9021
00230 
00231 #define PTP_OC_CANON_TerminateDirectTransfer    0x9023
00232 
00233 #define PTP_OC_CANON_InitiateDirectTransferEx2  0x9028
00234 #define PTP_OC_CANON_GetTargetHandles           0x9029
00235 #define PTP_OC_CANON_NotifyProgress             0x902A
00236 #define PTP_OC_CANON_NotifyCancelAccepted       0x902B
00237 /* 902c: no parms, read 3 uint32 in data, no response parms */
00238 #define PTP_OC_CANON_902C                       0x902C
00239 #define PTP_OC_CANON_GetDirectory               0x902D
00240 
00241 #define PTP_OC_CANON_SetPairingInfo             0x9030
00242 #define PTP_OC_CANON_GetPairingInfo             0x9031
00243 #define PTP_OC_CANON_DeletePairingInfo          0x9032
00244 #define PTP_OC_CANON_GetMACAddress              0x9033
00245 /* 9034: 1 param, no parms returned */
00246 #define PTP_OC_CANON_SetDisplayMonitor          0x9034
00247 #define PTP_OC_CANON_PairingComplete            0x9035
00248 #define PTP_OC_CANON_GetWirelessMAXChannel      0x9036
00249 
00250 /* Nikon extension Operation Codes */
00251 #define PTP_OC_NIKON_GetProfileAllData  0x9006
00252 #define PTP_OC_NIKON_SendProfileData    0x9007
00253 #define PTP_OC_NIKON_DeleteProfile      0x9008
00254 #define PTP_OC_NIKON_SetProfileData     0x9009
00255 #define PTP_OC_NIKON_AdvancedTransfer   0x9010
00256 #define PTP_OC_NIKON_GetFileInfoInBlock 0x9011
00257 #define PTP_OC_NIKON_Capture            0x90C0
00258 #define PTP_OC_NIKON_SetControlMode     0x90C2
00259 #define PTP_OC_NIKON_CurveDownload      0x90C5
00260 #define PTP_OC_NIKON_CurveUpload        0x90C6
00261 #define PTP_OC_NIKON_CheckEvent         0x90C7
00262 #define PTP_OC_NIKON_DeviceReady        0x90C8
00263 #define PTP_OC_NIKON_GetDevicePTPIPInfo 0x90E0
00264 
00265 /* Microsoft / MTP extension codes */
00266 
00267 #define PTP_OC_MTP_GetObjectPropsSupported      0x9801
00268 #define PTP_OC_MTP_GetObjectPropDesc            0x9802
00269 #define PTP_OC_MTP_GetObjectPropValue           0x9803
00270 #define PTP_OC_MTP_SetObjectPropValue           0x9804
00271 #define PTP_OC_MTP_GetObjPropList               0x9805
00272 #define PTP_OC_MTP_SetObjPropList               0x9806
00273 #define PTP_OC_MTP_GetInterdependendPropdesc    0x9807
00274 #define PTP_OC_MTP_SendObjectPropList           0x9808
00275 #define PTP_OC_MTP_GetObjectReferences          0x9810
00276 #define PTP_OC_MTP_SetObjectReferences          0x9811
00277 #define PTP_OC_MTP_UpdateDeviceFirmware         0x9812
00278 #define PTP_OC_MTP_Skip                         0x9820
00279 
00280 /*
00281  * Windows Media Digital Rights Management for Portable Devices 
00282  * Extension Codes (microsoft.com/WMDRMPD: 10.1)
00283  */
00284 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeChallenge       0x9101
00285 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeResponse        0x9102
00286 #define PTP_OC_MTP_WMDRMPD_SetLicenseResponse   0x9103
00287 #define PTP_OC_MTP_WMDRMPD_GetSyncList          0x9104
00288 #define PTP_OC_MTP_WMDRMPD_SendMeterChallengeQuery      0x9105
00289 #define PTP_OC_MTP_WMDRMPD_GetMeterChallenge    0x9106
00290 #define PTP_OC_MTP_WMDRMPD_SetMeterResponse             0x9107
00291 #define PTP_OC_MTP_WMDRMPD_CleanDataStore               0x9108
00292 #define PTP_OC_MTP_WMDRMPD_GetLicenseState              0x9109
00293 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDCommand   0x910A
00294 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDRequest   0x910B
00295 
00296 /* 
00297  * Windows Media Digital Rights Management for Portable Devices 
00298  * Extension Codes (microsoft.com/WMDRMPD: 10.1)
00299  * Below are operations that have no public documented identifier 
00300  * associated with them "Vendor-defined Command Code"
00301  */
00302 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDAppRequest        0x9212
00303 #define PTP_OC_MTP_WMDRMPD_GetWMDRMPDAppResponse        0x9213
00304 #define PTP_OC_MTP_WMDRMPD_EnableTrustedFilesOperations 0x9214
00305 #define PTP_OC_MTP_WMDRMPD_DisableTrustedFilesOperations 0x9215
00306 #define PTP_OC_MTP_WMDRMPD_EndTrustedAppSession         0x9216
00307 /* ^^^ guess ^^^ */
00308 
00309 /*
00310  * Microsoft Advanced Audio/Video Transfer 
00311  * Extensions (microsoft.com/AAVT: 1.0)
00312  */
00313 #define PTP_OC_MTP_AAVT_OpenMediaSession                0x9170
00314 #define PTP_OC_MTP_AAVT_CloseMediaSession               0x9171
00315 #define PTP_OC_MTP_AAVT_GetNextDataBlock                0x9172
00316 #define PTP_OC_MTP_AAVT_SetCurrentTimePosition          0x9173
00317 
00318 /*
00319  * Windows Media Digital Rights Management for Network Devices 
00320  * Extensions (microsoft.com/WMDRMND: 1.0) MTP/IP?
00321  */
00322 #define PTP_OC_MTP_WMDRMND_SendRegistrationRequest      0x9180
00323 #define PTP_OC_MTP_WMDRMND_GetRegistrationResponse      0x9181
00324 #define PTP_OC_MTP_WMDRMND_GetProximityChallenge        0x9182
00325 #define PTP_OC_MTP_WMDRMND_SendProximityResponse        0x9183
00326 #define PTP_OC_MTP_WMDRMND_SendWMDRMNDLicenseRequest    0x9184
00327 #define PTP_OC_MTP_WMDRMND_GetWMDRMNDLicenseResponse    0x9185
00328 
00329 /* 
00330  * Windows Media Player Portiable Devices 
00331  * Extension Codes (microsoft.com/WMPPD: 11.1)
00332  */
00333 #define PTP_OC_MTP_WMPPD_ReportAddedDeletedItems        0x9201
00334 #define PTP_OC_MTP_WMPPD_ReportAcquiredItems            0x9202
00335 #define PTP_OC_MTP_WMPPD_PlaylistObjectPref             0x9203
00336 
00337 /*
00338  * Undocumented Zune Operation Codes 
00339  * maybe related to WMPPD extension set?
00340  */
00341 #define PTP_OC_MTP_ZUNE_GETUNDEFINED001                 0x9204
00342 
00343 /* WiFi Provisioning MTP Extension Codes (microsoft.com/WPDWCN: 1.0) */
00344 #define PTP_OC_MTP_WPDWCN_ProcessWFCObject              0x9122
00345 
00346 /* Proprietary vendor extension operations mask */
00347 #define PTP_OC_EXTENSION_MASK           0xF000
00348 #define PTP_OC_EXTENSION                0x9000
00349 
00350 /* Response Codes */
00351 
00352 #define PTP_RC_Undefined                0x2000
00353 #define PTP_RC_OK                       0x2001
00354 #define PTP_RC_GeneralError             0x2002
00355 #define PTP_RC_SessionNotOpen           0x2003
00356 #define PTP_RC_InvalidTransactionID     0x2004
00357 #define PTP_RC_OperationNotSupported    0x2005
00358 #define PTP_RC_ParameterNotSupported    0x2006
00359 #define PTP_RC_IncompleteTransfer       0x2007
00360 #define PTP_RC_InvalidStorageId         0x2008
00361 #define PTP_RC_InvalidObjectHandle      0x2009
00362 #define PTP_RC_DevicePropNotSupported   0x200A
00363 #define PTP_RC_InvalidObjectFormatCode  0x200B
00364 #define PTP_RC_StoreFull                0x200C
00365 #define PTP_RC_ObjectWriteProtected     0x200D
00366 #define PTP_RC_StoreReadOnly            0x200E
00367 #define PTP_RC_AccessDenied             0x200F
00368 #define PTP_RC_NoThumbnailPresent       0x2010
00369 #define PTP_RC_SelfTestFailed           0x2011
00370 #define PTP_RC_PartialDeletion          0x2012
00371 #define PTP_RC_StoreNotAvailable        0x2013
00372 #define PTP_RC_SpecificationByFormatUnsupported         0x2014
00373 #define PTP_RC_NoValidObjectInfo        0x2015
00374 #define PTP_RC_InvalidCodeFormat        0x2016
00375 #define PTP_RC_UnknownVendorCode        0x2017
00376 #define PTP_RC_CaptureAlreadyTerminated 0x2018
00377 #define PTP_RC_DeviceBusy               0x2019
00378 #define PTP_RC_InvalidParentObject      0x201A
00379 #define PTP_RC_InvalidDevicePropFormat  0x201B
00380 #define PTP_RC_InvalidDevicePropValue   0x201C
00381 #define PTP_RC_InvalidParameter         0x201D
00382 #define PTP_RC_SessionAlreadyOpened     0x201E
00383 #define PTP_RC_TransactionCanceled      0x201F
00384 #define PTP_RC_SpecificationOfDestinationUnsupported            0x2020
00385 
00386 /* Eastman Kodak extension Response Codes */
00387 #define PTP_RC_EK_FilenameRequired      0xA001
00388 #define PTP_RC_EK_FilenameConflicts     0xA002
00389 #define PTP_RC_EK_FilenameInvalid       0xA003
00390 
00391 /* Nikon specific response codes */
00392 #define PTP_RC_NIKON_AdvancedTransferCancel 0xA022
00393 
00394 /* Microsoft/MTP specific codes */
00395 #define PTP_RC_MTP_Undefined                    0xA800
00396 #define PTP_RC_MTP_Invalid_ObjectPropCode       0xA801
00397 #define PTP_RC_MTP_Invalid_ObjectProp_Format    0xA802
00398 #define PTP_RC_MTP_Invalid_ObjectProp_Value     0xA803
00399 #define PTP_RC_MTP_Invalid_ObjectReference      0xA804
00400 #define PTP_RC_MTP_Invalid_Dataset              0xA806
00401 #define PTP_RC_MTP_Specification_By_Group_Unsupported           0xA808
00402 #define PTP_RC_MTP_Object_Too_Large             0xA809
00403 
00404 /* Microsoft Advanced Audio/Video Transfer response codes 
00405 (microsoft.com/AAVT 1.0) */
00406 #define PTP_RC_MTP_Invalid_Media_Session_ID     0xA170  
00407 #define PTP_RC_MTP_Media_Session_Limit_Reached  0xA171
00408 #define PTP_RC_MTP_No_More_Data                 0xA172
00409 
00410 /* WiFi Provisioning MTP Extension Error Codes (microsoft.com/WPDWCN: 1.0) */
00411 #define PTP_RC_MTP_Invalid_WFC_Syntax           0xA121
00412 #define PTP_RC_MTP_WFC_Version_Not_Supported    0xA122
00413 
00414 /* libptp2 extended ERROR codes */
00415 #define PTP_ERROR_IO                    0x02FF
00416 #define PTP_ERROR_DATA_EXPECTED         0x02FE
00417 #define PTP_ERROR_RESP_EXPECTED         0x02FD
00418 #define PTP_ERROR_BADPARAM              0x02FC
00419 
00420 /* PTP Event Codes */
00421 
00422 #define PTP_EC_Undefined                0x4000
00423 #define PTP_EC_CancelTransaction        0x4001
00424 #define PTP_EC_ObjectAdded              0x4002
00425 #define PTP_EC_ObjectRemoved            0x4003
00426 #define PTP_EC_StoreAdded               0x4004
00427 #define PTP_EC_StoreRemoved             0x4005
00428 #define PTP_EC_DevicePropChanged        0x4006
00429 #define PTP_EC_ObjectInfoChanged        0x4007
00430 #define PTP_EC_DeviceInfoChanged        0x4008
00431 #define PTP_EC_RequestObjectTransfer    0x4009
00432 #define PTP_EC_StoreFull                0x400A
00433 #define PTP_EC_DeviceReset              0x400B
00434 #define PTP_EC_StorageInfoChanged       0x400C
00435 #define PTP_EC_CaptureComplete          0x400D
00436 #define PTP_EC_UnreportedStatus         0x400E
00437 
00438 /* Canon extension Event Codes */
00439 #define PTP_EC_CANON_ExtendedErrorcode          0xC005  /* ? */
00440 #define PTP_EC_CANON_ObjectInfoChanged          0xC008
00441 #define PTP_EC_CANON_RequestObjectTransfer      0xC009
00442 #define PTP_EC_CANON_CameraModeChanged          0xC00C
00443 
00444 #define PTP_EC_CANON_StartDirectTransfer        0xC011
00445 #define PTP_EC_CANON_StopDirectTransfer         0xC013
00446 
00447 /* Nikon extension Event Codes */
00448 #define PTP_EC_Nikon_ObjectAddedInSDRAM         0xC101
00449 #define PTP_EC_Nikon_CaptureOverflow            0xC102
00450 /* Gets 1 parameter, objectid pointing to DPOF object */
00451 #define PTP_EC_Nikon_AdvancedTransfer           0xC103
00452 
00453 /* constants for GetObjectHandles */
00454 #define PTP_GOH_ALL_STORAGE 0xffffffff
00455 #define PTP_GOH_ALL_FORMATS 0x00000000
00456 #define PTP_GOH_ALL_ASSOCS  0x00000000
00457 
00458 /* PTP device info structure (returned by GetDevInfo) */
00459 
00460 struct _PTPDeviceInfo {
00461         uint16_t StandardVersion;
00462         uint32_t VendorExtensionID;
00463         uint16_t VendorExtensionVersion;
00464         char    *VendorExtensionDesc;
00465         uint16_t FunctionalMode;
00466         uint32_t OperationsSupported_len;
00467         uint16_t *OperationsSupported;
00468         uint32_t EventsSupported_len;
00469         uint16_t *EventsSupported;
00470         uint32_t DevicePropertiesSupported_len;
00471         uint16_t *DevicePropertiesSupported;
00472         uint32_t CaptureFormats_len;
00473         uint16_t *CaptureFormats;
00474         uint32_t ImageFormats_len;
00475         uint16_t *ImageFormats;
00476         char    *Manufacturer;
00477         char    *Model;
00478         char    *DeviceVersion;
00479         char    *SerialNumber;
00480 };
00481 typedef struct _PTPDeviceInfo PTPDeviceInfo;
00482 
00483 /* PTP storageIDs structute (returned by GetStorageIDs) */
00484 
00485 struct _PTPStorageIDs {
00486         uint32_t n;
00487         uint32_t *Storage;
00488 };
00489 typedef struct _PTPStorageIDs PTPStorageIDs;
00490 
00491 /* PTP StorageInfo structure (returned by GetStorageInfo) */
00492 struct _PTPStorageInfo {
00493         uint16_t StorageType;
00494         uint16_t FilesystemType;
00495         uint16_t AccessCapability;
00496         uint64_t MaxCapability;
00497         uint64_t FreeSpaceInBytes;
00498         uint32_t FreeSpaceInImages;
00499         char    *StorageDescription;
00500         char    *VolumeLabel;
00501 };
00502 typedef struct _PTPStorageInfo PTPStorageInfo;
00503 
00504 /* PTP objecthandles structure (returned by GetObjectHandles) */
00505 
00506 struct _PTPObjectHandles {
00507         uint32_t n;
00508         uint32_t *Handler;
00509 };
00510 typedef struct _PTPObjectHandles PTPObjectHandles;
00511 
00512 #define PTP_HANDLER_SPECIAL     0xffffffff
00513 #define PTP_HANDLER_ROOT        0x00000000
00514 
00515 
00516 /* PTP objectinfo structure (returned by GetObjectInfo) */
00517 
00518 struct _PTPObjectInfo {
00519         uint32_t StorageID;
00520         uint16_t ObjectFormat;
00521         uint16_t ProtectionStatus;
00522         uint32_t ObjectCompressedSize;
00523         uint16_t ThumbFormat;
00524         uint32_t ThumbCompressedSize;
00525         uint32_t ThumbPixWidth;
00526         uint32_t ThumbPixHeight;
00527         uint32_t ImagePixWidth;
00528         uint32_t ImagePixHeight;
00529         uint32_t ImageBitDepth;
00530         uint32_t ParentObject;
00531         uint16_t AssociationType;
00532         uint32_t AssociationDesc;
00533         uint32_t SequenceNumber;
00534         char    *Filename;
00535         time_t  CaptureDate;
00536         time_t  ModificationDate;
00537         char    *Keywords;
00538 };
00539 typedef struct _PTPObjectInfo PTPObjectInfo;
00540 
00541 /* max ptp string length INCLUDING terminating null character */
00542 
00543 #define PTP_MAXSTRLEN                           255
00544 
00545 /* PTP Object Format Codes */
00546 
00547 /* ancillary formats */
00548 #define PTP_OFC_Undefined                       0x3000
00549 #define PTP_OFC_Defined                         0x3800
00550 #define PTP_OFC_Association                     0x3001
00551 #define PTP_OFC_Script                          0x3002
00552 #define PTP_OFC_Executable                      0x3003
00553 #define PTP_OFC_Text                            0x3004
00554 #define PTP_OFC_HTML                            0x3005
00555 #define PTP_OFC_DPOF                            0x3006
00556 #define PTP_OFC_AIFF                            0x3007
00557 #define PTP_OFC_WAV                             0x3008
00558 #define PTP_OFC_MP3                             0x3009
00559 #define PTP_OFC_AVI                             0x300A
00560 #define PTP_OFC_MPEG                            0x300B
00561 #define PTP_OFC_ASF                             0x300C
00562 #define PTP_OFC_QT                              0x300D /* guessing */
00563 /* image formats */
00564 #define PTP_OFC_EXIF_JPEG                       0x3801
00565 #define PTP_OFC_TIFF_EP                         0x3802
00566 #define PTP_OFC_FlashPix                        0x3803
00567 #define PTP_OFC_BMP                             0x3804
00568 #define PTP_OFC_CIFF                            0x3805
00569 #define PTP_OFC_Undefined_0x3806                0x3806
00570 #define PTP_OFC_GIF                             0x3807
00571 #define PTP_OFC_JFIF                            0x3808
00572 #define PTP_OFC_PCD                             0x3809
00573 #define PTP_OFC_PICT                            0x380A
00574 #define PTP_OFC_PNG                             0x380B
00575 #define PTP_OFC_Undefined_0x380C                0x380C
00576 #define PTP_OFC_TIFF                            0x380D
00577 #define PTP_OFC_TIFF_IT                         0x380E
00578 #define PTP_OFC_JP2                             0x380F
00579 #define PTP_OFC_JPX                             0x3810
00580 /* Eastman Kodak extension ancillary format */
00581 #define PTP_OFC_EK_M3U                          0xb002
00582 /* MTP extensions */
00583 #define PTP_OFC_MTP_MediaCard                   0xb211
00584 #define PTP_OFC_MTP_MediaCardGroup              0xb212
00585 #define PTP_OFC_MTP_Encounter                   0xb213
00586 #define PTP_OFC_MTP_EncounterBox                0xb214
00587 #define PTP_OFC_MTP_M4A                         0xb215
00588 #define PTP_OFC_MTP_ZUNEUNDEFINED               0xb217 /* Unknown file type */
00589 #define PTP_OFC_MTP_Firmware                    0xb802
00590 #define PTP_OFC_MTP_WindowsImageFormat          0xb881
00591 #define PTP_OFC_MTP_UndefinedAudio              0xb900
00592 #define PTP_OFC_MTP_WMA                         0xb901
00593 #define PTP_OFC_MTP_OGG                         0xb902
00594 #define PTP_OFC_MTP_AAC                         0xb903
00595 #define PTP_OFC_MTP_AudibleCodec                0xb904
00596 #define PTP_OFC_MTP_FLAC                        0xb906
00597 #define PTP_OFC_MTP_UndefinedVideo              0xb980
00598 #define PTP_OFC_MTP_WMV                         0xb981
00599 #define PTP_OFC_MTP_MP4                         0xb982
00600 #define PTP_OFC_MTP_MP2                         0xb983
00601 #define PTP_OFC_MTP_3GP                         0xb984
00602 #define PTP_OFC_MTP_UndefinedCollection         0xba00
00603 #define PTP_OFC_MTP_AbstractMultimediaAlbum     0xba01
00604 #define PTP_OFC_MTP_AbstractImageAlbum          0xba02
00605 #define PTP_OFC_MTP_AbstractAudioAlbum          0xba03
00606 #define PTP_OFC_MTP_AbstractVideoAlbum          0xba04
00607 #define PTP_OFC_MTP_AbstractAudioVideoPlaylist  0xba05
00608 #define PTP_OFC_MTP_AbstractContactGroup        0xba06
00609 #define PTP_OFC_MTP_AbstractMessageFolder       0xba07
00610 #define PTP_OFC_MTP_AbstractChapteredProduction 0xba08
00611 #define PTP_OFC_MTP_AbstractAudioPlaylist       0xba09
00612 #define PTP_OFC_MTP_AbstractVideoPlaylist       0xba0a
00613 #define PTP_OFC_MTP_AbstractMediacast           0xba0b
00614 #define PTP_OFC_MTP_WPLPlaylist                 0xba10
00615 #define PTP_OFC_MTP_M3UPlaylist                 0xba11
00616 #define PTP_OFC_MTP_MPLPlaylist                 0xba12
00617 #define PTP_OFC_MTP_ASXPlaylist                 0xba13
00618 #define PTP_OFC_MTP_PLSPlaylist                 0xba14
00619 #define PTP_OFC_MTP_UndefinedDocument           0xba80
00620 #define PTP_OFC_MTP_AbstractDocument            0xba81
00621 #define PTP_OFC_MTP_XMLDocument                 0xba82
00622 #define PTP_OFC_MTP_MSWordDocument              0xba83
00623 #define PTP_OFC_MTP_MHTCompiledHTMLDocument     0xba84
00624 #define PTP_OFC_MTP_MSExcelSpreadsheetXLS       0xba85
00625 #define PTP_OFC_MTP_MSPowerpointPresentationPPT 0xba86
00626 #define PTP_OFC_MTP_UndefinedMessage            0xbb00
00627 #define PTP_OFC_MTP_AbstractMessage             0xbb01
00628 #define PTP_OFC_MTP_UndefinedContact            0xbb80
00629 #define PTP_OFC_MTP_AbstractContact             0xbb81
00630 #define PTP_OFC_MTP_vCard2                      0xbb82
00631 #define PTP_OFC_MTP_vCard3                      0xbb83
00632 #define PTP_OFC_MTP_UndefinedCalendarItem       0xbe00
00633 #define PTP_OFC_MTP_AbstractCalendarItem        0xbe01
00634 #define PTP_OFC_MTP_vCalendar1                  0xbe02
00635 #define PTP_OFC_MTP_vCalendar2                  0xbe03
00636 #define PTP_OFC_MTP_UndefinedWindowsExecutable  0xbe80
00637 
00638 
00639 /* PTP Association Types */
00640 #define PTP_AT_Undefined                        0x0000
00641 #define PTP_AT_GenericFolder                    0x0001
00642 #define PTP_AT_Album                            0x0002
00643 #define PTP_AT_TimeSequence                     0x0003
00644 #define PTP_AT_HorizontalPanoramic              0x0004
00645 #define PTP_AT_VerticalPanoramic                0x0005
00646 #define PTP_AT_2DPanoramic                      0x0006
00647 #define PTP_AT_AncillaryData                    0x0007
00648 
00649 /* PTP Protection Status */
00650 
00651 #define PTP_PS_NoProtection                     0x0000
00652 #define PTP_PS_ReadOnly                         0x0001
00653 
00654 /* PTP Storage Types */
00655 
00656 #define PTP_ST_Undefined                        0x0000
00657 #define PTP_ST_FixedROM                         0x0001
00658 #define PTP_ST_RemovableROM                     0x0002
00659 #define PTP_ST_FixedRAM                         0x0003
00660 #define PTP_ST_RemovableRAM                     0x0004
00661 
00662 /* PTP FilesystemType Values */
00663 
00664 #define PTP_FST_Undefined                       0x0000
00665 #define PTP_FST_GenericFlat                     0x0001
00666 #define PTP_FST_GenericHierarchical             0x0002
00667 #define PTP_FST_DCF                             0x0003
00668 
00669 /* PTP StorageInfo AccessCapability Values */
00670 
00671 #define PTP_AC_ReadWrite                        0x0000
00672 #define PTP_AC_ReadOnly                         0x0001
00673 #define PTP_AC_ReadOnly_with_Object_Deletion    0x0002
00674 
00675 /* Property Describing Dataset, Range Form */
00676 
00677 union _PTPPropertyValue {
00678         char            *str;   /* common string, malloced */
00679         uint8_t         u8;
00680         int8_t          i8;
00681         uint16_t        u16;
00682         int16_t         i16;
00683         uint32_t        u32;
00684         int32_t         i32;
00685         /* XXXX: 64bit and 128 bit signed and unsigned missing */
00686         struct array {
00687                 uint32_t        count;
00688                 union _PTPPropertyValue *v;     /* malloced, count elements */
00689         } a;
00690 };
00691 
00692 typedef union _PTPPropertyValue PTPPropertyValue;
00693 
00694 /* Metadata lists for MTP operations */
00695 struct _MTPPropList {
00696         uint16_t                property;
00697         uint16_t                datatype;
00698         uint32_t                ObjectHandle;
00699         PTPPropertyValue        propval;
00700         struct _MTPPropList     *next;
00701 };
00702 typedef struct _MTPPropList MTPPropList;
00703 
00704 struct _PTPPropDescRangeForm {
00705         PTPPropertyValue        MinimumValue;
00706         PTPPropertyValue        MaximumValue;
00707         PTPPropertyValue        StepSize;
00708 };
00709 typedef struct _PTPPropDescRangeForm PTPPropDescRangeForm;
00710 
00711 /* Property Describing Dataset, Enum Form */
00712 
00713 struct _PTPPropDescEnumForm {
00714         uint16_t                NumberOfValues;
00715         PTPPropertyValue        *SupportedValue;        /* malloced */
00716 };
00717 typedef struct _PTPPropDescEnumForm PTPPropDescEnumForm;
00718 
00719 /* Device Property Describing Dataset (DevicePropDesc) */
00720 
00721 struct _PTPDevicePropDesc {
00722         uint16_t                DevicePropertyCode;
00723         uint16_t                DataType;
00724         uint8_t                 GetSet;
00725         PTPPropertyValue        FactoryDefaultValue;
00726         PTPPropertyValue        CurrentValue;
00727         uint8_t                 FormFlag;
00728         union   {
00729                 PTPPropDescEnumForm     Enum;
00730                 PTPPropDescRangeForm    Range;
00731         } FORM;
00732 };
00733 typedef struct _PTPDevicePropDesc PTPDevicePropDesc;
00734 
00735 /* Object Property Describing Dataset (DevicePropDesc) */
00736 
00737 struct _PTPObjectPropDesc {
00738         uint16_t                ObjectPropertyCode;
00739         uint16_t                DataType;
00740         uint8_t                 GetSet;
00741         PTPPropertyValue        FactoryDefaultValue;
00742         uint32_t                GroupCode;
00743         uint8_t                 FormFlag;
00744         union   {
00745                 PTPPropDescEnumForm     Enum;
00746                 PTPPropDescRangeForm    Range;
00747         } FORM;
00748 };
00749 typedef struct _PTPObjectPropDesc PTPObjectPropDesc;
00750 
00751 /* Canon filesystem's folder entry Dataset */
00752 
00753 #define PTP_CANON_FilenameBufferLen     13
00754 #define PTP_CANON_FolderEntryLen        28
00755 
00756 struct _PTPCANONFolderEntry {
00757         uint32_t        ObjectHandle;
00758         uint16_t        ObjectFormatCode;
00759         uint8_t         Flags;
00760         uint32_t        ObjectSize;
00761         time_t          Time;
00762         char            Filename[PTP_CANON_FilenameBufferLen];
00763 };
00764 typedef struct _PTPCANONFolderEntry PTPCANONFolderEntry;
00765 
00766 /* Nikon Tone Curve Data */
00767 
00768 #define PTP_NIKON_MaxCurvePoints 19
00769 
00770 struct _PTPNIKONCoordinatePair {
00771         uint8_t         X;
00772         uint8_t         Y;
00773 };
00774 
00775 typedef struct _PTPNIKONCoordinatePair PTPNIKONCoordinatePair;
00776 
00777 struct _PTPNTCCoordinatePair {
00778         uint8_t         X;
00779         uint8_t         Y;
00780 };
00781 
00782 typedef struct _PTPNTCCoordinatePair PTPNTCCoordinatePair;
00783 
00784 struct _PTPNIKONCurveData {
00785         char                    static_preamble[6];
00786         uint8_t                 XAxisStartPoint;
00787         uint8_t                 XAxisEndPoint;
00788         uint8_t                 YAxisStartPoint;
00789         uint8_t                 YAxisEndPoint;
00790         uint8_t                 MidPointIntegerPart;
00791         uint8_t                 MidPointDecimalPart;
00792         uint8_t                 NCoordinates;
00793         PTPNIKONCoordinatePair  CurveCoordinates[PTP_NIKON_MaxCurvePoints];
00794 };
00795 
00796 typedef struct _PTPNIKONCurveData PTPNIKONCurveData;
00797 
00798 struct _PTPEKTextParams {
00799         char    *title;
00800         char    *line[5];
00801 };
00802 typedef struct _PTPEKTextParams PTPEKTextParams;
00803 
00804 /* Nikon Wifi profiles */
00805 
00806 struct _PTPNIKONWifiProfile {
00807         /* Values valid both when reading and writing profiles */
00808         char      profile_name[17];
00809         uint8_t   device_type;
00810         uint8_t   icon_type;
00811         char      essid[33];
00812 
00813         /* Values only valid when reading. Some of these are in the write packet,
00814          * but are set automatically, like id, display_order and creation_date. */
00815         uint8_t   id;
00816         uint8_t   valid;
00817         uint8_t   display_order;
00818         char      creation_date[16];
00819         char      lastusage_date[16];
00820         
00821         /* Values only valid when writing */
00822         uint32_t  ip_address;
00823         uint8_t   subnet_mask; /* first zero bit position, e.g. 24 for 255.255.255.0 */
00824         uint32_t  gateway_address;
00825         uint8_t   address_mode; /* 0 - Manual, 2-3 -  DHCP ad-hoc/managed*/
00826         uint8_t   access_mode; /* 0 - Managed, 1 - Adhoc */
00827         uint8_t   wifi_channel; /* 1-11 */
00828         uint8_t   authentification; /* 0 - Open, 1 - Shared, 2 - WPA-PSK */
00829         uint8_t   encryption; /* 0 - None, 1 - WEP 64bit, 2 - WEP 128bit (not supported: 3 - TKIP) */
00830         uint8_t   key[64];
00831         uint8_t   key_nr;
00832 //      char      guid[16];
00833 };
00834 
00835 typedef struct _PTPNIKONWifiProfile PTPNIKONWifiProfile;
00836 
00837 /* DataType Codes */
00838 
00839 #define PTP_DTC_UNDEF           0x0000
00840 #define PTP_DTC_INT8            0x0001
00841 #define PTP_DTC_UINT8           0x0002
00842 #define PTP_DTC_INT16           0x0003
00843 #define PTP_DTC_UINT16          0x0004
00844 #define PTP_DTC_INT32           0x0005
00845 #define PTP_DTC_UINT32          0x0006
00846 #define PTP_DTC_INT64           0x0007
00847 #define PTP_DTC_UINT64          0x0008
00848 #define PTP_DTC_INT128          0x0009
00849 #define PTP_DTC_UINT128         0x000A
00850 
00851 #define PTP_DTC_ARRAY_MASK      0x4000
00852 
00853 #define PTP_DTC_AINT8           (PTP_DTC_ARRAY_MASK | PTP_DTC_INT8)
00854 #define PTP_DTC_AUINT8          (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT8)
00855 #define PTP_DTC_AINT16          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT16)
00856 #define PTP_DTC_AUINT16         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT16)
00857 #define PTP_DTC_AINT32          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT32)
00858 #define PTP_DTC_AUINT32         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT32)
00859 #define PTP_DTC_AINT64          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT64)
00860 #define PTP_DTC_AUINT64         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT64)
00861 #define PTP_DTC_AINT128         (PTP_DTC_ARRAY_MASK | PTP_DTC_INT128)
00862 #define PTP_DTC_AUINT128        (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT128)
00863 
00864 #define PTP_DTC_STR             0xFFFF
00865 
00866 /* Device Properties Codes */
00867 
00868 #define PTP_DPC_Undefined               0x5000
00869 #define PTP_DPC_BatteryLevel            0x5001
00870 #define PTP_DPC_FunctionalMode          0x5002
00871 #define PTP_DPC_ImageSize               0x5003
00872 #define PTP_DPC_CompressionSetting      0x5004
00873 #define PTP_DPC_WhiteBalance            0x5005
00874 #define PTP_DPC_RGBGain                 0x5006
00875 #define PTP_DPC_FNumber                 0x5007
00876 #define PTP_DPC_FocalLength             0x5008
00877 #define PTP_DPC_FocusDistance           0x5009
00878 #define PTP_DPC_FocusMode               0x500A
00879 #define PTP_DPC_ExposureMeteringMode    0x500B
00880 #define PTP_DPC_FlashMode               0x500C
00881 #define PTP_DPC_ExposureTime            0x500D
00882 #define PTP_DPC_ExposureProgramMode     0x500E
00883 #define PTP_DPC_ExposureIndex           0x500F
00884 #define PTP_DPC_ExposureBiasCompensation        0x5010
00885 #define PTP_DPC_DateTime                0x5011
00886 #define PTP_DPC_CaptureDelay            0x5012
00887 #define PTP_DPC_StillCaptureMode        0x5013
00888 #define PTP_DPC_Contrast                0x5014
00889 #define PTP_DPC_Sharpness               0x5015
00890 #define PTP_DPC_DigitalZoom             0x5016
00891 #define PTP_DPC_EffectMode              0x5017
00892 #define PTP_DPC_BurstNumber             0x5018
00893 #define PTP_DPC_BurstInterval           0x5019
00894 #define PTP_DPC_TimelapseNumber         0x501A
00895 #define PTP_DPC_TimelapseInterval       0x501B
00896 #define PTP_DPC_FocusMeteringMode       0x501C
00897 #define PTP_DPC_UploadURL               0x501D
00898 #define PTP_DPC_Artist                  0x501E
00899 #define PTP_DPC_CopyrightInfo           0x501F
00900 
00901 /* Proprietary vendor extension device property mask */
00902 #define PTP_DPC_EXTENSION_MASK          0xF000
00903 #define PTP_DPC_EXTENSION               0xD000
00904 
00905 /* Zune extension device property codes */
00906 #define PTP_DPC_MTP_ZUNE_UNKNOWN1       0xD181
00907 #define PTP_DPC_MTP_ZUNE_UNKNOWN2       0xD132
00908 #define PTP_DPC_MTP_ZUNE_UNKNOWN3       0xD215
00909 #define PTP_DPC_MTP_ZUNE_UNKNOWN4       0xD216
00910 
00911 /* Eastman Kodak extension device property codes */
00912 #define PTP_DPC_EK_ColorTemperature     0xD001
00913 #define PTP_DPC_EK_DateTimeStampFormat  0xD002
00914 #define PTP_DPC_EK_BeepMode             0xD003
00915 #define PTP_DPC_EK_VideoOut             0xD004
00916 #define PTP_DPC_EK_PowerSaving          0xD005
00917 #define PTP_DPC_EK_UI_Language          0xD006
00918 /* Canon extension device property codes */
00919 #define PTP_DPC_CANON_BeepMode          0xD001
00920 #define PTP_DPC_CANON_ViewfinderMode    0xD003
00921 #define PTP_DPC_CANON_ImageQuality      0xD006
00922 #define PTP_DPC_CANON_D007              0xD007
00923 #define PTP_DPC_CANON_ImageSize         0xD008
00924 #define PTP_DPC_CANON_FlashMode         0xD00A
00925 #define PTP_DPC_CANON_ShootingMode      0xD00C
00926 #define PTP_DPC_CANON_DriveMode         0xD00E
00927 #define PTP_DPC_CANON_MeteringMode      0xD010
00928 #define PTP_DPC_CANON_AFDistance        0xD011
00929 #define PTP_DPC_CANON_FocusingPoint     0xD012
00930 #define PTP_DPC_CANON_WhiteBalance      0xD013
00931 #define PTP_DPC_CANON_ISOSpeed          0xD01C
00932 #define PTP_DPC_CANON_Aperture          0xD01D
00933 #define PTP_DPC_CANON_ShutterSpeed      0xD01E
00934 #define PTP_DPC_CANON_ExpCompensation   0xD01F
00935 
00936         /* capture data type (?) */
00937 #define PTP_DPC_CANON_D029              0xD029
00938 #define PTP_DPC_CANON_Zoom              0xD02A
00939 #define PTP_DPC_CANON_SizeQualityMode   0xD02C
00940 #define PTP_DPC_CANON_FirmwareVersion   0xD031
00941 #define PTP_DPC_CANON_CameraModel       0xD032
00942 #define PTP_DPC_CANON_CameraOwner       0xD033
00943 #define PTP_DPC_CANON_UnixTime          0xD034
00944 #define PTP_DPC_CANON_DZoomMagnification        0xD039
00945 #define PTP_DPC_CANON_PhotoEffect       0xD040
00946 #define PTP_DPC_CANON_AssistLight       0xD041
00947 #define PTP_DPC_CANON_D045              0xD045
00948 #define PTP_DPC_CANON_AverageFilesizes  0xD048
00949 
00950 /* Nikon extension device property codes */
00951 #define PTP_DPC_NIKON_ShootingBank                      0xD010
00952 #define PTP_DPC_NIKON_ShootingBankNameA                 0xD011
00953 #define PTP_DPC_NIKON_ShootingBankNameB                 0xD012
00954 #define PTP_DPC_NIKON_ShootingBankNameC                 0xD013
00955 #define PTP_DPC_NIKON_ShootingBankNameD                 0xD014
00956 #define PTP_DPC_NIKON_RawCompression                    0xD016
00957 #define PTP_DPC_NIKON_WhiteBalanceAutoBias              0xD017
00958 #define PTP_DPC_NIKON_WhiteBalanceTungstenBias          0xD018
00959 #define PTP_DPC_NIKON_WhiteBalanceFluorescentBias       0xD019
00960 #define PTP_DPC_NIKON_WhiteBalanceDaylightBias          0xD01A
00961 #define PTP_DPC_NIKON_WhiteBalanceFlashBias             0xD01B
00962 #define PTP_DPC_NIKON_WhiteBalanceCloudyBias            0xD01C
00963 #define PTP_DPC_NIKON_WhiteBalanceShadeBias             0xD01D
00964 #define PTP_DPC_NIKON_WhiteBalanceColorTemperature      0xD01E
00965 #define PTP_DPC_NIKON_ImageSharpening                   0xD02A
00966 #define PTP_DPC_NIKON_ToneCompensation                  0xD02B
00967 #define PTP_DPC_NIKON_ColorModel                        0xD02C
00968 #define PTP_DPC_NIKON_HueAdjustment                     0xD02D
00969 #define PTP_DPC_NIKON_NonCPULensDataFocalLength         0xD02E
00970 #define PTP_DPC_NIKON_NonCPULensDataMaximumAperture     0xD02F
00971 #define PTP_DPC_NIKON_CSMMenuBankSelect                 0xD040
00972 #define PTP_DPC_NIKON_MenuBankNameA                     0xD041
00973 #define PTP_DPC_NIKON_MenuBankNameB                     0xD042
00974 #define PTP_DPC_NIKON_MenuBankNameC                     0xD043
00975 #define PTP_DPC_NIKON_MenuBankNameD                     0xD044
00976 #define PTP_DPC_NIKON_A1AFCModePriority                 0xD048
00977 #define PTP_DPC_NIKON_A2AFSModePriority                 0xD049
00978 #define PTP_DPC_NIKON_A3GroupDynamicAF                  0xD04A
00979 #define PTP_DPC_NIKON_A4AFActivation                    0xD04B
00980 #define PTP_DPC_NIKON_A5FocusAreaIllumManualFocus       0xD04C
00981 #define PTP_DPC_NIKON_FocusAreaIllumContinuous          0xD04D
00982 #define PTP_DPC_NIKON_FocusAreaIllumWhenSelected        0xD04E
00983 #define PTP_DPC_NIKON_FocusAreaWrap                     0xD04F
00984 #define PTP_DPC_NIKON_A7VerticalAFON                    0xD050
00985 #define PTP_DPC_NIKON_ISOAuto                           0xD054
00986 #define PTP_DPC_NIKON_B2ISOStep                         0xD055
00987 #define PTP_DPC_NIKON_EVStep                            0xD056
00988 #define PTP_DPC_NIKON_B4ExposureCompEv                  0xD057
00989 #define PTP_DPC_NIKON_ExposureCompensation              0xD058
00990 #define PTP_DPC_NIKON_CenterWeightArea                  0xD059
00991 #define PTP_DPC_NIKON_AELockMode                        0xD05E
00992 #define PTP_DPC_NIKON_AELAFLMode                        0xD05F
00993 #define PTP_DPC_NIKON_MeterOff                          0xD062
00994 #define PTP_DPC_NIKON_SelfTimer                         0xD063
00995 #define PTP_DPC_NIKON_MonitorOff                        0xD064
00996 #define PTP_DPC_NIKON_D1ShootingSpeed                   0xD068
00997 #define PTP_DPC_NIKON_D2MaximumShots                    0xD069
00998 #define PTP_DPC_NIKON_D3ExpDelayMode                    0xD06A
00999 #define PTP_DPC_NIKON_LongExposureNoiseReduction        0xD06B
01000 #define PTP_DPC_NIKON_FileNumberSequence                0xD06C
01001 #define PTP_DPC_NIKON_D6ControlPanelFinderRearControl   0xD06D
01002 #define PTP_DPC_NIKON_ControlPanelFinderViewfinder      0xD06E
01003 #define PTP_DPC_NIKON_D7Illumination                    0xD06F
01004 #define PTP_DPC_NIKON_E1FlashSyncSpeed                  0xD074
01005 #define PTP_DPC_NIKON_FlashShutterSpeed                 0xD075
01006 #define PTP_DPC_NIKON_E3AAFlashMode                     0xD076
01007 #define PTP_DPC_NIKON_E4ModelingFlash                   0xD077
01008 #define PTP_DPC_NIKON_BracketSet                        0xD078
01009 #define PTP_DPC_NIKON_E6ManualModeBracketing            0xD079  
01010 #define PTP_DPC_NIKON_BracketOrder                      0xD07A
01011 #define PTP_DPC_NIKON_E8AutoBracketSelection            0xD07B
01012 #define PTP_DPC_NIKON_BracketingSet                     0xD07C
01013 #define PTP_DPC_NIKON_F1CenterButtonShootingMode        0xD080
01014 #define PTP_DPC_NIKON_CenterButtonPlaybackMode          0xD081
01015 #define PTP_DPC_NIKON_F2Multiselector                   0xD082
01016 #define PTP_DPC_NIKON_F3PhotoInfoPlayback               0xD083
01017 #define PTP_DPC_NIKON_F4AssignFuncButton                0xD084
01018 #define PTP_DPC_NIKON_F5CustomizeCommDials              0xD085
01019 #define PTP_DPC_NIKON_ReverseCommandDial                0xD086
01020 #define PTP_DPC_NIKON_ApertureSetting                   0xD087
01021 #define PTP_DPC_NIKON_MenusAndPlayback                  0xD088
01022 #define PTP_DPC_NIKON_F6ButtonsAndDials                 0xD089
01023 #define PTP_DPC_NIKON_NoCFCard                          0xD08A
01024 #define PTP_DPC_NIKON_ImageCommentString                0xD090
01025 #define PTP_DPC_NIKON_ImageCommentAttach                0xD091
01026 #define PTP_DPC_NIKON_ImageRotation                     0xD092
01027 #define PTP_DPC_NIKON_Bracketing                        0xD0C0
01028 #define PTP_DPC_NIKON_ExposureBracketingIntervalDist    0xD0C1
01029 #define PTP_DPC_NIKON_BracketingProgram                 0xD0C2
01030 #define PTP_DPC_NIKON_WhiteBalanceBracketStep           0xD0C4
01031 #define PTP_DPC_NIKON_LensID                            0xD0E0
01032 #define PTP_DPC_NIKON_FocalLengthMin                    0xD0E3
01033 #define PTP_DPC_NIKON_FocalLengthMax                    0xD0E4
01034 #define PTP_DPC_NIKON_MaxApAtMinFocalLength             0xD0E5
01035 #define PTP_DPC_NIKON_MaxApAtMaxFocalLength             0xD0E6
01036 #define PTP_DPC_NIKON_ExposureTime                      0xD100
01037 #define PTP_DPC_NIKON_ACPower                           0xD101
01038 #define PTP_DPC_NIKON_MaximumShots                      0xD103
01039 #define PTP_DPC_NIKON_AFLLock                           0xD104
01040 #define PTP_DPC_NIKON_AutoExposureLock                  0xD105
01041 #define PTP_DPC_NIKON_AutoFocusLock                     0xD106
01042 #define PTP_DPC_NIKON_AutofocusLCDTopMode2              0xD107
01043 #define PTP_DPC_NIKON_AutofocusArea                     0xD108
01044 #define PTP_DPC_NIKON_LightMeter                        0xD10A
01045 #define PTP_DPC_NIKON_CameraOrientation                 0xD10E
01046 #define PTP_DPC_NIKON_ExposureApertureLock              0xD111
01047 #define PTP_DPC_NIKON_FlashExposureCompensation         0xD126
01048 #define PTP_DPC_NIKON_OptimizeImage                     0xD140
01049 #define PTP_DPC_NIKON_Saturation                        0xD142
01050 #define PTP_DPC_NIKON_BeepOff                           0xD160
01051 #define PTP_DPC_NIKON_AutofocusMode                     0xD161
01052 #define PTP_DPC_NIKON_AFAssist                          0xD163
01053 #define PTP_DPC_NIKON_PADVPMode                         0xD164
01054 #define PTP_DPC_NIKON_ImageReview                       0xD165
01055 #define PTP_DPC_NIKON_AFAreaIllumination                0xD166
01056 #define PTP_DPC_NIKON_FlashMode                         0xD167
01057 #define PTP_DPC_NIKON_FlashCommanderMode                0xD168
01058 #define PTP_DPC_NIKON_FlashSign                         0xD169
01059 #define PTP_DPC_NIKON_RemoteTimeout                     0xD16B
01060 #define PTP_DPC_NIKON_GridDisplay                       0xD16C
01061 #define PTP_DPC_NIKON_FlashModeManualPower              0xD16D
01062 #define PTP_DPC_NIKON_FlashModeCommanderPower           0xD16E
01063 #define PTP_DPC_NIKON_CSMMenu                           0xD180
01064 #define PTP_DPC_NIKON_BracketingFramesAndSteps          0xD190
01065 #define PTP_DPC_NIKON_LowLight                          0xD1B0
01066 #define PTP_DPC_NIKON_FlashOpen                         0xD1C0
01067 #define PTP_DPC_NIKON_FlashCharged                      0xD1C1
01068 
01069 /* Microsoft/MTP specific */
01070 #define PTP_DPC_MTP_SecureTime                          0xD101
01071 #define PTP_DPC_MTP_DeviceCertificate                   0xD102
01072 #define PTP_DPC_MTP_RevocationInfo                      0xD103
01073 #define PTP_DPC_MTP_SynchronizationPartner              0xD401
01074 #define PTP_DPC_MTP_DeviceFriendlyName                  0xD402
01075 #define PTP_DPC_MTP_VolumeLevel                         0xD403
01076 #define PTP_DPC_MTP_DeviceIcon                          0xD405
01077 #define PTP_DPC_MTP_PlaybackRate                        0xD410
01078 #define PTP_DPC_MTP_PlaybackObject                      0xD411
01079 #define PTP_DPC_MTP_PlaybackContainerIndex              0xD412
01080 #define PTP_DPC_MTP_PlaybackPosition                    0xD413
01081 #define PTP_DPC_MTP_PlaysForSureID                      0xD131
01082 
01083 /* Zune specific property codes */
01084 #define PTP_DPC_MTP_Zune_UnknownVersion                 0xD181
01085 
01086 /* MTP specific Object Properties */
01087 #define PTP_OPC_StorageID                               0xDC01
01088 #define PTP_OPC_ObjectFormat                            0xDC02
01089 #define PTP_OPC_ProtectionStatus                        0xDC03
01090 #define PTP_OPC_ObjectSize                              0xDC04
01091 #define PTP_OPC_AssociationType                         0xDC05
01092 #define PTP_OPC_AssociationDesc                         0xDC06
01093 #define PTP_OPC_ObjectFileName                          0xDC07
01094 #define PTP_OPC_DateCreated                             0xDC08
01095 #define PTP_OPC_DateModified                            0xDC09
01096 #define PTP_OPC_Keywords                                0xDC0A
01097 #define PTP_OPC_ParentObject                            0xDC0B
01098 #define PTP_OPC_AllowedFolderContents                   0xDC0C
01099 #define PTP_OPC_Hidden                                  0xDC0D
01100 #define PTP_OPC_SystemObject                            0xDC0E
01101 #define PTP_OPC_PersistantUniqueObjectIdentifier        0xDC41
01102 #define PTP_OPC_SyncID                                  0xDC42
01103 #define PTP_OPC_PropertyBag                             0xDC43
01104 #define PTP_OPC_Name                                    0xDC44
01105 #define PTP_OPC_CreatedBy                               0xDC45
01106 #define PTP_OPC_Artist                                  0xDC46
01107 #define PTP_OPC_DateAuthored                            0xDC47
01108 #define PTP_OPC_Description                             0xDC48
01109 #define PTP_OPC_URLReference                            0xDC49
01110 #define PTP_OPC_LanguageLocale                          0xDC4A
01111 #define PTP_OPC_CopyrightInformation                    0xDC4B
01112 #define PTP_OPC_Source                                  0xDC4C
01113 #define PTP_OPC_OriginLocation                          0xDC4D
01114 #define PTP_OPC_DateAdded                               0xDC4E
01115 #define PTP_OPC_NonConsumable                           0xDC4F
01116 #define PTP_OPC_CorruptOrUnplayable                     0xDC50
01117 #define PTP_OPC_ProducerSerialNumber                    0xDC51
01118 #define PTP_OPC_RepresentativeSampleFormat              0xDC81
01119 #define PTP_OPC_RepresentativeSampleSize                0xDC82
01120 #define PTP_OPC_RepresentativeSampleHeight              0xDC83
01121 #define PTP_OPC_RepresentativeSampleWidth               0xDC84
01122 #define PTP_OPC_RepresentativeSampleDuration            0xDC85
01123 #define PTP_OPC_RepresentativeSampleData                0xDC86
01124 #define PTP_OPC_Width                                   0xDC87
01125 #define PTP_OPC_Height                                  0xDC88
01126 #define PTP_OPC_Duration                                0xDC89
01127 #define PTP_OPC_Rating                                  0xDC8A
01128 #define PTP_OPC_Track                                   0xDC8B
01129 #define PTP_OPC_Genre                                   0xDC8C
01130 #define PTP_OPC_Credits                                 0xDC8D
01131 #define PTP_OPC_Lyrics                                  0xDC8E
01132 #define PTP_OPC_SubscriptionContentID                   0xDC8F
01133 #define PTP_OPC_ProducedBy                              0xDC90
01134 #define PTP_OPC_UseCount                                0xDC91
01135 #define PTP_OPC_SkipCount                               0xDC92
01136 #define PTP_OPC_LastAccessed                            0xDC93
01137 #define PTP_OPC_ParentalRating                          0xDC94
01138 #define PTP_OPC_MetaGenre                               0xDC95
01139 #define PTP_OPC_Composer                                0xDC96
01140 #define PTP_OPC_EffectiveRating                         0xDC97
01141 #define PTP_OPC_Subtitle                                0xDC98
01142 #define PTP_OPC_OriginalReleaseDate                     0xDC99
01143 #define PTP_OPC_AlbumName                               0xDC9A
01144 #define PTP_OPC_AlbumArtist                             0xDC9B
01145 #define PTP_OPC_Mood                                    0xDC9C
01146 #define PTP_OPC_DRMStatus                               0xDC9D
01147 #define PTP_OPC_SubDescription                          0xDC9E
01148 #define PTP_OPC_IsCropped                               0xDCD1
01149 #define PTP_OPC_IsColorCorrected                        0xDCD2
01150 #define PTP_OPC_ImageBitDepth                           0xDCD3
01151 #define PTP_OPC_Fnumber                                 0xDCD4
01152 #define PTP_OPC_ExposureTime                            0xDCD5
01153 #define PTP_OPC_ExposureIndex                           0xDCD6
01154 #define PTP_OPC_DisplayName                             0xDCE0
01155 #define PTP_OPC_BodyText                                0xDCE1
01156 #define PTP_OPC_Subject                                 0xDCE2
01157 #define PTP_OPC_Prority                                 0xDCE3
01158 #define PTP_OPC_GivenName                               0xDD00
01159 #define PTP_OPC_MiddleNames                             0xDD01
01160 #define PTP_OPC_FamilyName                              0xDD02
01161 #define PTP_OPC_Prefix                                  0xDD03
01162 #define PTP_OPC_Suffix                                  0xDD04
01163 #define PTP_OPC_PhoneticGivenName                       0xDD05
01164 #define PTP_OPC_PhoneticFamilyName                      0xDD06
01165 #define PTP_OPC_EmailPrimary                            0xDD07
01166 #define PTP_OPC_EmailPersonal1                          0xDD08
01167 #define PTP_OPC_EmailPersonal2                          0xDD09
01168 #define PTP_OPC_EmailBusiness1                          0xDD0A
01169 #define PTP_OPC_EmailBusiness2                          0xDD0B
01170 #define PTP_OPC_EmailOthers                             0xDD0C
01171 #define PTP_OPC_PhoneNumberPrimary                      0xDD0D
01172 #define PTP_OPC_PhoneNumberPersonal                     0xDD0E
01173 #define PTP_OPC_PhoneNumberPersonal2                    0xDD0F
01174 #define PTP_OPC_PhoneNumberBusiness                     0xDD10
01175 #define PTP_OPC_PhoneNumberBusiness2                    0xDD11
01176 #define PTP_OPC_PhoneNumberMobile                       0xDD12
01177 #define PTP_OPC_PhoneNumberMobile2                      0xDD13
01178 #define PTP_OPC_FaxNumberPrimary                        0xDD14
01179 #define PTP_OPC_FaxNumberPersonal                       0xDD15
01180 #define PTP_OPC_FaxNumberBusiness                       0xDD16
01181 #define PTP_OPC_PagerNumber                             0xDD17
01182 #define PTP_OPC_PhoneNumberOthers                       0xDD18
01183 #define PTP_OPC_PrimaryWebAddress                       0xDD19
01184 #define PTP_OPC_PersonalWebAddress                      0xDD1A
01185 #define PTP_OPC_BusinessWebAddress                      0xDD1B
01186 #define PTP_OPC_InstantMessengerAddress                 0xDD1C
01187 #define PTP_OPC_InstantMessengerAddress2                0xDD1D
01188 #define PTP_OPC_InstantMessengerAddress3                0xDD1E
01189 #define PTP_OPC_PostalAddressPersonalFull               0xDD1F
01190 #define PTP_OPC_PostalAddressPersonalFullLine1          0xDD20
01191 #define PTP_OPC_PostalAddressPersonalFullLine2          0xDD21
01192 #define PTP_OPC_PostalAddressPersonalFullCity           0xDD22
01193 #define PTP_OPC_PostalAddressPersonalFullRegion         0xDD23
01194 #define PTP_OPC_PostalAddressPersonalFullPostalCode     0xDD24
01195 #define PTP_OPC_PostalAddressPersonalFullCountry        0xDD25
01196 #define PTP_OPC_PostalAddressBusinessFull               0xDD26
01197 #define PTP_OPC_PostalAddressBusinessLine1              0xDD27
01198 #define PTP_OPC_PostalAddressBusinessLine2              0xDD28
01199 #define PTP_OPC_PostalAddressBusinessCity               0xDD29
01200 #define PTP_OPC_PostalAddressBusinessRegion             0xDD2A
01201 #define PTP_OPC_PostalAddressBusinessPostalCode         0xDD2B
01202 #define PTP_OPC_PostalAddressBusinessCountry            0xDD2C
01203 #define PTP_OPC_PostalAddressOtherFull                  0xDD2D
01204 #define PTP_OPC_PostalAddressOtherLine1                 0xDD2E
01205 #define PTP_OPC_PostalAddressOtherLine2                 0xDD2F
01206 #define PTP_OPC_PostalAddressOtherCity                  0xDD30
01207 #define PTP_OPC_PostalAddressOtherRegion                0xDD31
01208 #define PTP_OPC_PostalAddressOtherPostalCode            0xDD32
01209 #define PTP_OPC_PostalAddressOtherCountry               0xDD33
01210 #define PTP_OPC_OrganizationName                        0xDD34
01211 #define PTP_OPC_PhoneticOrganizationName                0xDD35
01212 #define PTP_OPC_Role                                    0xDD36
01213 #define PTP_OPC_Birthdate                               0xDD37
01214 #define PTP_OPC_MessageTo                               0xDD40
01215 #define PTP_OPC_MessageCC                               0xDD41
01216 #define PTP_OPC_MessageBCC                              0xDD42
01217 #define PTP_OPC_MessageRead                             0xDD43
01218 #define PTP_OPC_MessageReceivedTime                     0xDD44
01219 #define PTP_OPC_MessageSender                           0xDD45
01220 #define PTP_OPC_ActivityBeginTime                       0xDD50
01221 #define PTP_OPC_ActivityEndTime                         0xDD51
01222 #define PTP_OPC_ActivityLocation                        0xDD52
01223 #define PTP_OPC_ActivityRequiredAttendees               0xDD54
01224 #define PTP_OPC_ActivityOptionalAttendees               0xDD55
01225 #define PTP_OPC_ActivityResources                       0xDD56
01226 #define PTP_OPC_ActivityAccepted                        0xDD57
01227 #define PTP_OPC_Owner                                   0xDD5D
01228 #define PTP_OPC_Editor                                  0xDD5E
01229 #define PTP_OPC_Webmaster                               0xDD5F
01230 #define PTP_OPC_URLSource                               0xDD60
01231 #define PTP_OPC_URLDestination                          0xDD61
01232 #define PTP_OPC_TimeBookmark                            0xDD62
01233 #define PTP_OPC_ObjectBookmark                          0xDD63
01234 #define PTP_OPC_ByteBookmark                            0xDD64
01235 #define PTP_OPC_LastBuildDate                           0xDD70
01236 #define PTP_OPC_TimetoLive                              0xDD71
01237 #define PTP_OPC_MediaGUID                               0xDD72
01238 #define PTP_OPC_TotalBitRate                            0xDE91
01239 #define PTP_OPC_BitRateType                             0xDE92
01240 #define PTP_OPC_SampleRate                              0xDE93
01241 #define PTP_OPC_NumberOfChannels                        0xDE94
01242 #define PTP_OPC_AudioBitDepth                           0xDE95
01243 #define PTP_OPC_ScanDepth                               0xDE97
01244 #define PTP_OPC_AudioWAVECodec                          0xDE99
01245 #define PTP_OPC_AudioBitRate                            0xDE9A
01246 #define PTP_OPC_VideoFourCCCodec                        0xDE9B
01247 #define PTP_OPC_VideoBitRate                            0xDE9C
01248 #define PTP_OPC_FramesPerThousandSeconds                0xDE9D
01249 #define PTP_OPC_KeyFrameDistance                        0xDE9E
01250 #define PTP_OPC_BufferSize                              0xDE9F
01251 #define PTP_OPC_EncodingQuality                         0xDEA0
01252 #define PTP_OPC_EncodingProfile                         0xDEA1
01253 #define PTP_OPC_BuyFlag                                 0xD901
01254 
01255 /* WiFi Provisioning MTP Extension property codes */
01256 #define PTP_OPC_WirelessConfigurationFile               0xB104
01257 
01258 /* Device Property Form Flag */
01259 
01260 #define PTP_DPFF_None                   0x00
01261 #define PTP_DPFF_Range                  0x01
01262 #define PTP_DPFF_Enumeration            0x02
01263 
01264 /* Object Property Codes used by MTP (first 3 are same as DPFF codes) */
01265 #define PTP_OPFF_None                   0x00
01266 #define PTP_OPFF_Range                  0x01
01267 #define PTP_OPFF_Enumeration            0x02
01268 #define PTP_OPFF_DateTime               0x03
01269 #define PTP_OPFF_FixedLengthArray       0x04
01270 #define PTP_OPFF_RegularExpression      0x05
01271 #define PTP_OPFF_ByteArray              0x06
01272 #define PTP_OPFF_LongString             0xFF
01273 
01274 /* Device Property GetSet type */
01275 #define PTP_DPGS_Get                    0x00
01276 #define PTP_DPGS_GetSet                 0x01
01277 
01278 /* Glue stuff starts here */
01279 
01280 typedef struct _PTPParams PTPParams;
01281 
01282 
01283 typedef uint16_t (* PTPDataGetFunc)     (PTPParams* params, void* private,
01284                                         unsigned long wantlen,
01285                                         unsigned char *data, unsigned long *gotlen);
01286 
01287 typedef uint16_t (* PTPDataPutFunc)     (PTPParams* params, void* private,
01288                                         unsigned long sendlen,
01289                                         unsigned char *data, unsigned long *putlen);
01290 typedef struct _PTPDataHandler {
01291         PTPDataGetFunc          getfunc;
01292         PTPDataPutFunc          putfunc;
01293         void                    *private;
01294 } PTPDataHandler;
01295 
01296 /*
01297  * This functions take PTP oriented arguments and send them over an
01298  * appropriate data layer doing byteorder conversion accordingly.
01299  */
01300 typedef uint16_t (* PTPIOSendReq)       (PTPParams* params, PTPContainer* req);
01301 typedef uint16_t (* PTPIOSendData)      (PTPParams* params, PTPContainer* ptp,
01302                                          unsigned long size, PTPDataHandler*getter);
01303 
01304 typedef uint16_t (* PTPIOGetResp)       (PTPParams* params, PTPContainer* resp);
01305 typedef uint16_t (* PTPIOGetData)       (PTPParams* params, PTPContainer* ptp,
01306                                          PTPDataHandler *putter);
01307 /* debug functions */
01308 typedef void (* PTPErrorFunc) (void *data, const char *format, va_list args)
01309 #if (__GNUC__ >= 3)
01310         __attribute__((__format__(printf,2,0)))
01311 #endif
01312 ;
01313 typedef void (* PTPDebugFunc) (void *data, const char *format, va_list args)
01314 #if (__GNUC__ >= 3)
01315         __attribute__((__format__(printf,2,0)))
01316 #endif
01317 ;
01318 
01319 struct _PTPParams {
01320         /* data layer byteorder */
01321         uint8_t         byteorder;
01322         uint16_t        maxpacketsize;
01323 
01324         /* PTP IO: Custom IO functions */
01325         PTPIOSendReq    sendreq_func;
01326         PTPIOSendData   senddata_func;
01327         PTPIOGetResp    getresp_func;
01328         PTPIOGetData    getdata_func;
01329         PTPIOGetResp    event_check;
01330         PTPIOGetResp    event_wait;
01331 
01332         /* Custom error and debug function */
01333         PTPErrorFunc    error_func;
01334         PTPDebugFunc    debug_func;
01335 
01336         /* Data passed to above functions */
01337         void            *data;
01338 
01339         /* ptp transaction ID */
01340         uint32_t        transaction_id;
01341         /* ptp session ID */
01342         uint32_t        session_id;
01343 
01344         /* PTP IO: if we have MTP style split header/data transfers */
01345         int             split_header_data;
01346 
01347         /* PTP: MTP specific structure. */
01348         MTPPropList     *proplist;
01349 
01350         /* PTP: internal structures used by ptp driver */
01351         PTPObjectHandles handles;
01352         PTPObjectInfo   *objectinfo;
01353         PTPDeviceInfo   deviceinfo;
01354 
01355         /* PTP: Canon specific flags list */
01356         uint32_t        *canon_flags; /* size(handles.n) */
01357 
01358         /* PTP: Wifi profiles */
01359         uint8_t         wifi_profiles_version;
01360         uint8_t         wifi_profiles_number;
01361         PTPNIKONWifiProfile *wifi_profiles;
01362 
01363         /* IO: PTP/IP related data */
01364         int             cmdfd, evtfd;
01365         uint8_t         cameraguid[16];
01366         uint32_t        eventpipeid;
01367         char            *cameraname;
01368 
01369         /* PTP: iconv converters */
01370         iconv_t cd_locale_to_ucs2;
01371         iconv_t cd_ucs2_to_locale;
01372 
01373         /* IO: Sometimes the response packet get send in the dataphase
01374          * too. This only happens for a Samsung player now.
01375          */
01376         uint8_t         *response_packet;
01377         uint16_t        response_packet_size;
01378 };
01379 
01380 /* last, but not least - ptp functions */
01381 uint16_t ptp_usb_sendreq        (PTPParams* params, PTPContainer* req);
01382 uint16_t ptp_usb_senddata       (PTPParams* params, PTPContainer* ptp,
01383                                  unsigned long size, PTPDataHandler *handler);
01384 uint16_t ptp_usb_getresp        (PTPParams* params, PTPContainer* resp);
01385 uint16_t ptp_usb_getdata        (PTPParams* params, PTPContainer* ptp, 
01386                                  PTPDataHandler *handler);
01387 uint16_t ptp_usb_event_check    (PTPParams* params, PTPContainer* event);
01388 uint16_t ptp_usb_event_wait     (PTPParams* params, PTPContainer* event);
01389 
01390 int      ptp_ptpip_connect      (PTPParams* params, const char *port);
01391 uint16_t ptp_ptpip_sendreq      (PTPParams* params, PTPContainer* req);
01392 uint16_t ptp_ptpip_senddata     (PTPParams* params, PTPContainer* ptp,
01393                                 unsigned long size, PTPDataHandler *handler);
01394 uint16_t ptp_ptpip_getresp      (PTPParams* params, PTPContainer* resp);
01395 uint16_t ptp_ptpip_getdata      (PTPParams* params, PTPContainer* ptp, 
01396                                  PTPDataHandler *handler);
01397 uint16_t ptp_ptpip_event_wait   (PTPParams* params, PTPContainer* event);
01398 uint16_t ptp_ptpip_event_check  (PTPParams* params, PTPContainer* event);
01399 
01400 uint16_t ptp_getdeviceinfo      (PTPParams* params, PTPDeviceInfo* deviceinfo);
01401 
01402 uint16_t ptp_opensession        (PTPParams *params, uint32_t session);
01403 uint16_t ptp_closesession       (PTPParams *params);
01404 
01405 uint16_t ptp_getstorageids      (PTPParams* params, PTPStorageIDs* storageids);
01406 uint16_t ptp_getstorageinfo     (PTPParams* params, uint32_t storageid,
01407                                 PTPStorageInfo* storageinfo);
01408 uint16_t ptp_formatstore        (PTPParams* params, uint32_t storageid);
01409 
01410 uint16_t ptp_getobjecthandles   (PTPParams* params, uint32_t storage,
01411                                 uint32_t objectformatcode,
01412                                 uint32_t associationOH,
01413                                 PTPObjectHandles* objecthandles);
01414 
01415 uint16_t ptp_getnumobjects      (PTPParams* params, uint32_t storage,
01416                                 uint32_t objectformatcode,
01417                                 uint32_t associationOH,
01418                                 uint32_t* numobs);
01419 
01420 uint16_t ptp_getobjectinfo      (PTPParams *params, uint32_t handle,
01421                                 PTPObjectInfo* objectinfo);
01422 
01423 uint16_t ptp_getobject          (PTPParams *params, uint32_t handle,
01424                                 unsigned char** object);
01425 uint16_t ptp_getobject_tofd     (PTPParams* params, uint32_t handle, int fd);
01426 uint16_t ptp_getobject_to_handler (PTPParams* params, uint32_t handle, PTPDataHandler*);
01427 uint16_t ptp_getpartialobject   (PTPParams* params, uint32_t handle, uint32_t offset,
01428                                 uint32_t maxbytes, unsigned char** object);
01429 uint16_t ptp_getthumb           (PTPParams *params, uint32_t handle,
01430                                 unsigned char** object);
01431 
01432 uint16_t ptp_deleteobject       (PTPParams* params, uint32_t handle,
01433                                 uint32_t ofc);
01434 
01435 uint16_t ptp_sendobjectinfo     (PTPParams* params, uint32_t* store,
01436                                 uint32_t* parenthandle, uint32_t* handle,
01437                                 PTPObjectInfo* objectinfo);
01438 uint16_t ptp_sendobject         (PTPParams* params, unsigned char* object,
01439                                  uint32_t size);
01440 uint16_t ptp_sendobject_fromfd  (PTPParams* params, int fd, uint32_t size);
01441 uint16_t ptp_sendobject_from_handler  (PTPParams* params, PTPDataHandler*, uint32_t size);
01442 
01443 uint16_t ptp_initiatecapture    (PTPParams* params, uint32_t storageid,
01444                                 uint32_t ofc);
01445 
01446 uint16_t ptp_getdevicepropdesc  (PTPParams* params, uint16_t propcode,
01447                                 PTPDevicePropDesc *devicepropertydesc);
01448 uint16_t ptp_getdevicepropvalue (PTPParams* params, uint16_t propcode,
01449                                 PTPPropertyValue* value, uint16_t datatype);
01450 uint16_t ptp_setdevicepropvalue (PTPParams* params, uint16_t propcode,
01451                                 PTPPropertyValue* value, uint16_t datatype);
01452 
01453 /* Microsoft MTP extensions */
01454 uint16_t ptp_mtp_getobjectpropdesc (PTPParams* params, uint16_t opc, uint16_t ofc,
01455                                 PTPObjectPropDesc *objectpropertydesc);
01456 uint16_t ptp_mtp_getobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc, 
01457                                 PTPPropertyValue *value, uint16_t datatype);
01458 uint16_t ptp_mtp_setobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc,
01459                                 PTPPropertyValue *value, uint16_t datatype);
01460 uint16_t ptp_mtp_getobjectreferences (PTPParams* params, uint32_t handle, uint32_t** ohArray, uint32_t* arraylen);
01461 uint16_t ptp_mtp_setobjectreferences (PTPParams* params, uint32_t handle, uint32_t* ohArray, uint32_t arraylen);
01462 uint16_t ptp_mtp_getobjectproplist (PTPParams* params, uint32_t handle, MTPPropList **proplist);
01463 uint16_t ptp_mtp_sendobjectproplist (PTPParams* params, uint32_t* store, uint32_t* parenthandle, uint32_t* handle,
01464                                      uint16_t objecttype, uint64_t objectsize, MTPPropList *proplist);
01465 uint16_t ptp_mtp_setobjectproplist (PTPParams* params, MTPPropList *proplist);
01466 
01467 /* Eastman Kodak extensions */
01468 uint16_t ptp_ek_9007 (PTPParams* params, unsigned char **serial, unsigned int *size);
01469 uint16_t ptp_ek_9009 (PTPParams* params, uint32_t*, uint32_t*);
01470 uint16_t ptp_ek_900c (PTPParams* params, unsigned char **serial, unsigned int *size);
01471 uint16_t ptp_ek_getserial (PTPParams* params, unsigned char **serial, unsigned int *size);
01472 uint16_t ptp_ek_setserial (PTPParams* params, unsigned char *serial, uint32_t size);
01473 uint16_t ptp_ek_settext (PTPParams* params, PTPEKTextParams *text);
01474 uint16_t ptp_ek_sendfileobjectinfo (PTPParams* params, uint32_t* store,
01475                                 uint32_t* parenthandle, uint32_t* handle,
01476                                 PTPObjectInfo* objectinfo);
01477 uint16_t ptp_ek_sendfileobject  (PTPParams* params, unsigned char* object,
01478                                 uint32_t size);
01479 uint16_t ptp_ek_sendfileobject_from_handler     (PTPParams* params, PTPDataHandler*,
01480                                 uint32_t size);
01481 
01482 /* Canon PTP extensions */
01483 uint16_t ptp_canon_9012 (PTPParams* params);
01484 uint16_t ptp_canon_initiate_direct_transfer (PTPParams* params, uint32_t* out);
01485 uint16_t ptp_canon_get_target_handles (PTPParams* params, PTPCanon_directtransfer_entry**, unsigned int*cnt);
01486 uint16_t ptp_canon_getpartialobjectinfo (PTPParams* params, uint32_t handle,
01487                                 uint32_t p2, uint32_t* size, uint32_t* rp2);
01488 
01489 uint16_t ptp_canon_get_mac_address (PTPParams* params, unsigned char **mac);
01490 uint16_t ptp_canon_startshootingmode (PTPParams* params);
01491 uint16_t ptp_canon_endshootingmode (PTPParams* params);
01492 
01493 uint16_t ptp_canon_viewfinderon (PTPParams* params);
01494 uint16_t ptp_canon_viewfinderoff (PTPParams* params);
01495 
01496 uint16_t ptp_canon_aeafawb (PTPParams* params, uint32_t p1);
01497 uint16_t ptp_canon_checkevent (PTPParams* params, 
01498                                 PTPUSBEventContainer* event, int* isevent);
01499 uint16_t ptp_canon_focuslock (PTPParams* params);
01500 uint16_t ptp_canon_focusunlock (PTPParams* params);
01501 uint16_t ptp_canon_initiatecaptureinmemory (PTPParams* params);
01502 uint16_t ptp_canon_getpartialobject (PTPParams* params, uint32_t handle, 
01503                                 uint32_t offset, uint32_t size,
01504                                 uint32_t pos, unsigned char** block, 
01505                                 uint32_t* readnum);
01506 uint16_t ptp_canon_getviewfinderimage (PTPParams* params, unsigned char** image,
01507                                 uint32_t* size);
01508 uint16_t ptp_canon_getchanges (PTPParams* params, uint16_t** props,
01509                                 uint32_t* propnum); 
01510 uint16_t ptp_canon_getobjectinfo (PTPParams* params, uint32_t store,
01511                                 uint32_t p2, uint32_t parenthandle,
01512                                 uint32_t handle, 
01513                                 PTPCANONFolderEntry** entries,
01514                                 uint32_t* entnum);
01515 uint16_t ptp_canon_get_objecthandle_by_name (PTPParams* params, char* name, uint32_t* objectid);
01516 uint16_t ptp_canon_get_directory (PTPParams* params, PTPObjectHandles *handles, PTPObjectInfo **oinfos, uint32_t **flags);
01517 uint16_t ptp_canon_setobjectarchive (PTPParams* params, uint32_t oid, uint32_t flags);
01518 uint16_t ptp_canon_get_customize_data (PTPParams* params, uint32_t themenr,
01519                                 unsigned char **data, unsigned int *size);
01520 
01521 
01522 uint16_t ptp_nikon_curve_download (PTPParams* params, 
01523                                 unsigned char **data, unsigned int *size);
01524 uint16_t ptp_nikon_getptpipinfo (PTPParams* params, unsigned char **data, unsigned int *size);
01525 uint16_t ptp_nikon_getwifiprofilelist (PTPParams* params);
01526 uint16_t ptp_nikon_writewifiprofile (PTPParams* params, PTPNIKONWifiProfile* profile);
01527 uint16_t ptp_nikon_deletewifiprofile (PTPParams* params, uint32_t profilenr);
01528 uint16_t ptp_nikon_setcontrolmode (PTPParams* params, uint32_t mode);
01529 uint16_t ptp_nikon_capture (PTPParams* params, uint32_t x);
01530 uint16_t ptp_nikon_check_event (PTPParams* params, PTPUSBEventContainer **evt, int *evtcnt);
01531 uint16_t ptp_nikon_getfileinfoinblock (PTPParams* params, uint32_t p1, uint32_t p2, uint32_t p3,
01532                                         unsigned char **data, unsigned int *size);
01533 uint16_t ptp_nikon_device_ready (PTPParams* params);
01534 uint16_t ptp_mtp_getobjectpropssupported (PTPParams* params, uint16_t ofc, uint32_t *propnum, uint16_t **props);
01535 
01536 /* Non PTP protocol functions */
01537 int ptp_operation_issupported   (PTPParams* params, uint16_t operation);
01538 int ptp_event_issupported       (PTPParams* params, uint16_t event);
01539 int ptp_property_issupported    (PTPParams* params, uint16_t property);
01540 
01541 void ptp_free_devicepropdesc    (PTPDevicePropDesc* dpd);
01542 void ptp_free_devicepropvalue   (uint16_t dt, PTPPropertyValue* dpd);
01543 void ptp_free_objectpropdesc    (PTPObjectPropDesc* dpd);
01544 void ptp_free_params            (PTPParams *params);
01545 
01546 void ptp_perror                 (PTPParams* params, uint16_t error);
01547 
01548 const char*
01549 ptp_get_property_description(PTPParams* params, uint16_t dpc);
01550 
01551 int
01552 ptp_render_property_value(PTPParams* params, uint16_t dpc,
01553                           PTPDevicePropDesc *dpd, int length, char *out);
01554 int ptp_render_ofc(PTPParams* params, uint16_t ofc, int spaceleft, char *txt);
01555 int ptp_render_opcode(PTPParams* params, uint16_t opcode, int spaceleft, char *txt);
01556 int ptp_render_mtp_propname(uint16_t propid, int spaceleft, char *txt);
01557 
01558 /* ptpip.c */
01559 void ptp_nikon_getptpipguid (unsigned char* guid);
01560 #endif /* __PTP_H__ */

Generated on Thu Apr 5 09:36:00 2007 for libmtp by  doxygen 1.5.1