ptp.h

00001 /* ptp.h
00002  *
00003  * Copyright (C) 2001 Mariusz Woloszyn <emsi@ipartners.pl>
00004  * Copyright (C) 2003-2009 Marcus Meissner <marcus@jet.franken.de>
00005  * Copyright (C) 2006-2008 Linus Walleij <triad@df.lth.se>
00006  *
00007  * This library is free software; you can redistribute it and/or
00008  * modify it under the terms of the GNU Lesser General Public
00009  * License as published by the Free Software Foundation; either
00010  * version 2 of the License, or (at your option) any later version.
00011  *
00012  * This library is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00015  * Lesser General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU Lesser General Public
00018  * License along with this library; if not, write to the
00019  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00020  * Boston, MA 02111-1307, USA.
00021  */
00022 
00023 #ifndef __PTP_H__
00024 #define __PTP_H__
00025 
00026 #include <stdarg.h>
00027 #include <time.h>
00028 #include <iconv.h>
00029 #include "gphoto2-endian.h"
00030 
00031 #ifdef __cplusplus
00032 extern "C" {
00033 #endif /* __cplusplus */
00034 
00035 /* PTP datalayer byteorder */
00036 
00037 #define PTP_DL_BE                       0xF0
00038 #define PTP_DL_LE                       0x0F
00039 
00040 /* PTP request/response/event general PTP container (transport independent) */
00041 
00042 struct _PTPContainer {
00043         uint16_t Code;
00044         uint32_t SessionID;
00045         uint32_t Transaction_ID;
00046         /* params  may be of any type of size less or equal to uint32_t */
00047         uint32_t Param1;
00048         uint32_t Param2;
00049         uint32_t Param3;
00050         /* events can only have three parameters */
00051         uint32_t Param4;
00052         uint32_t Param5;
00053         /* the number of meaningfull parameters */
00054         uint8_t  Nparam;
00055 };
00056 typedef struct _PTPContainer PTPContainer;
00057 
00058 /* PTP USB Bulk-Pipe container */
00059 /* USB bulk max packet length for high speed endpoints */
00060 /* The max packet is set to 512 bytes. The spec says
00061  * "end of data transfers are signaled by short packets or NULL
00062  * packets". It never says anything about 512, but current
00063  * implementations seem to have chosen this value, which also
00064  * happens to be the size of an USB 2.0 HS endpoint, even though
00065  * this is not necessary.
00066  *
00067  * Previously we had this as 4096 for MTP devices. We have found
00068  * and fixed the bugs that made this necessary and it can be 512 again.
00069  */
00070 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE    512
00071 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_READ   512
00072 #define PTP_USB_BULK_HDR_LEN            (2*sizeof(uint32_t)+2*sizeof(uint16_t))
00073 #define PTP_USB_BULK_PAYLOAD_LEN_WRITE  (PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE-PTP_USB_BULK_HDR_LEN)
00074 #define PTP_USB_BULK_PAYLOAD_LEN_READ   (PTP_USB_BULK_HS_MAX_PACKET_LEN_READ-PTP_USB_BULK_HDR_LEN)
00075 #define PTP_USB_BULK_REQ_LEN    (PTP_USB_BULK_HDR_LEN+5*sizeof(uint32_t))
00076 
00077 struct _PTPUSBBulkContainer {
00078         uint32_t length;
00079         uint16_t type;
00080         uint16_t code;
00081         uint32_t trans_id;
00082         union {
00083                 struct {
00084                         uint32_t param1;
00085                         uint32_t param2;
00086                         uint32_t param3;
00087                         uint32_t param4;
00088                         uint32_t param5;
00089                 } params;
00090        /* this must be set to the maximum of PTP_USB_BULK_PAYLOAD_LEN_WRITE 
00091         * and PTP_USB_BULK_PAYLOAD_LEN_READ */
00092                 unsigned char data[PTP_USB_BULK_PAYLOAD_LEN_READ];
00093         } payload;
00094 };
00095 typedef struct _PTPUSBBulkContainer PTPUSBBulkContainer;
00096 
00097 /* PTP USB Asynchronous Event Interrupt Data Format */
00098 struct _PTPUSBEventContainer {
00099         uint32_t length;
00100         uint16_t type;
00101         uint16_t code;
00102         uint32_t trans_id;
00103         uint32_t param1;
00104         uint32_t param2;
00105         uint32_t param3;
00106 };
00107 typedef struct _PTPUSBEventContainer PTPUSBEventContainer;
00108 
00109 struct _PTPCanon_directtransfer_entry {
00110         uint32_t        oid;
00111         char            *str;
00112 };
00113 typedef struct _PTPCanon_directtransfer_entry PTPCanon_directtransfer_entry;
00114 
00115 /* USB container types */
00116 
00117 #define PTP_USB_CONTAINER_UNDEFINED             0x0000
00118 #define PTP_USB_CONTAINER_COMMAND               0x0001
00119 #define PTP_USB_CONTAINER_DATA                  0x0002
00120 #define PTP_USB_CONTAINER_RESPONSE              0x0003
00121 #define PTP_USB_CONTAINER_EVENT                 0x0004
00122 
00123 /* PTP/IP definitions */
00124 #define PTPIP_INIT_COMMAND_REQUEST      1
00125 #define PTPIP_INIT_COMMAND_ACK          2
00126 #define PTPIP_INIT_EVENT_REQUEST        3
00127 #define PTPIP_INIT_EVENT_ACK            4
00128 #define PTPIP_INIT_FAIL                 5
00129 #define PTPIP_CMD_REQUEST               6
00130 #define PTPIP_CMD_RESPONSE              7
00131 #define PTPIP_EVENT                     8
00132 #define PTPIP_START_DATA_PACKET         9
00133 #define PTPIP_DATA_PACKET               10
00134 #define PTPIP_CANCEL_TRANSACTION        11
00135 #define PTPIP_END_DATA_PACKET           12
00136 #define PTPIP_PING                      13
00137 #define PTPIP_PONG                      14
00138 
00139 struct _PTPIPHeader {
00140         uint32_t        length;
00141         uint32_t        type;
00142 };
00143 typedef struct _PTPIPHeader PTPIPHeader;
00144 
00145 /* Vendor IDs */
00146 #define PTP_VENDOR_EASTMAN_KODAK        0x00000001
00147 #define PTP_VENDOR_SEIKO_EPSON          0x00000002
00148 #define PTP_VENDOR_AGILENT              0x00000003
00149 #define PTP_VENDOR_POLAROID             0x00000004
00150 #define PTP_VENDOR_AGFA_GEVAERT         0x00000005
00151 #define PTP_VENDOR_MICROSOFT            0x00000006
00152 #define PTP_VENDOR_EQUINOX              0x00000007
00153 #define PTP_VENDOR_VIEWQUEST            0x00000008
00154 #define PTP_VENDOR_STMICROELECTRONICS   0x00000009
00155 #define PTP_VENDOR_NIKON                0x0000000A
00156 #define PTP_VENDOR_CANON                0x0000000B
00157 
00158 /* Operation Codes */
00159 
00160 /* PTP v1.0 operation codes */
00161 #define PTP_OC_Undefined                0x1000
00162 #define PTP_OC_GetDeviceInfo            0x1001
00163 #define PTP_OC_OpenSession              0x1002
00164 #define PTP_OC_CloseSession             0x1003
00165 #define PTP_OC_GetStorageIDs            0x1004
00166 #define PTP_OC_GetStorageInfo           0x1005
00167 #define PTP_OC_GetNumObjects            0x1006
00168 #define PTP_OC_GetObjectHandles         0x1007
00169 #define PTP_OC_GetObjectInfo            0x1008
00170 #define PTP_OC_GetObject                0x1009
00171 #define PTP_OC_GetThumb                 0x100A
00172 #define PTP_OC_DeleteObject             0x100B
00173 #define PTP_OC_SendObjectInfo           0x100C
00174 #define PTP_OC_SendObject               0x100D
00175 #define PTP_OC_InitiateCapture          0x100E
00176 #define PTP_OC_FormatStore              0x100F
00177 #define PTP_OC_ResetDevice              0x1010
00178 #define PTP_OC_SelfTest                 0x1011
00179 #define PTP_OC_SetObjectProtection      0x1012
00180 #define PTP_OC_PowerDown                0x1013
00181 #define PTP_OC_GetDevicePropDesc        0x1014
00182 #define PTP_OC_GetDevicePropValue       0x1015
00183 #define PTP_OC_SetDevicePropValue       0x1016
00184 #define PTP_OC_ResetDevicePropValue     0x1017
00185 #define PTP_OC_TerminateOpenCapture     0x1018
00186 #define PTP_OC_MoveObject               0x1019
00187 #define PTP_OC_CopyObject               0x101A
00188 #define PTP_OC_GetPartialObject         0x101B
00189 #define PTP_OC_InitiateOpenCapture      0x101C
00190 /* PTP v1.1 operation codes */
00191 #define PTP_OC_StartEnumHandles         0x101D
00192 #define PTP_OC_EnumHandles              0x101E
00193 #define PTP_OC_StopEnumHandles          0x101F
00194 #define PTP_OC_GetVendorExtensionMaps   0x1020
00195 #define PTP_OC_GetVendorDeviceInfo      0x1021
00196 #define PTP_OC_GetResizedImageObject    0x1022
00197 #define PTP_OC_GetFilesystemManifest    0x1023
00198 #define PTP_OC_GetStreamInfo            0x1024
00199 #define PTP_OC_GetStream                0x1025
00200 
00201 /* Eastman Kodak extension Operation Codes */
00202 #define PTP_OC_EK_GetSerial             0x9003
00203 #define PTP_OC_EK_SetSerial             0x9004
00204 #define PTP_OC_EK_SendFileObjectInfo    0x9005
00205 #define PTP_OC_EK_SendFileObject        0x9006
00206 #define PTP_OC_EK_SetText               0x9008
00207 
00208 /* Canon extension Operation Codes */
00209 #define PTP_OC_CANON_GetPartialObjectInfo       0x9001
00210 /* 9002 - sends 2 uint32, nothing back  */
00211 #define PTP_OC_CANON_SetObjectArchive           0x9002
00212 #define PTP_OC_CANON_KeepDeviceOn               0x9003
00213 #define PTP_OC_CANON_LockDeviceUI               0x9004
00214 #define PTP_OC_CANON_UnlockDeviceUI             0x9005
00215 #define PTP_OC_CANON_GetObjectHandleByName      0x9006
00216 /* no 9007 observed yet */
00217 #define PTP_OC_CANON_InitiateReleaseControl     0x9008
00218 #define PTP_OC_CANON_TerminateReleaseControl    0x9009
00219 #define PTP_OC_CANON_TerminatePlaybackMode      0x900A
00220 #define PTP_OC_CANON_ViewfinderOn               0x900B
00221 #define PTP_OC_CANON_ViewfinderOff              0x900C
00222 #define PTP_OC_CANON_DoAeAfAwb                  0x900D
00223 
00224 /* 900e - send nothing, gets 5 uint16t in 32bit entities back in 20byte datablob */
00225 #define PTP_OC_CANON_GetCustomizeSpec           0x900E
00226 #define PTP_OC_CANON_GetCustomizeItemInfo       0x900F
00227 #define PTP_OC_CANON_GetCustomizeData           0x9010
00228 #define PTP_OC_CANON_SetCustomizeData           0x9011
00229 #define PTP_OC_CANON_GetCaptureStatus           0x9012
00230 #define PTP_OC_CANON_CheckEvent                 0x9013
00231 #define PTP_OC_CANON_FocusLock                  0x9014
00232 #define PTP_OC_CANON_FocusUnlock                0x9015
00233 #define PTP_OC_CANON_GetLocalReleaseParam       0x9016
00234 #define PTP_OC_CANON_SetLocalReleaseParam       0x9017
00235 #define PTP_OC_CANON_AskAboutPcEvf              0x9018
00236 #define PTP_OC_CANON_SendPartialObject          0x9019
00237 #define PTP_OC_CANON_InitiateCaptureInMemory    0x901A
00238 #define PTP_OC_CANON_GetPartialObjectEx         0x901B
00239 #define PTP_OC_CANON_SetObjectTime              0x901C
00240 #define PTP_OC_CANON_GetViewfinderImage         0x901D
00241 #define PTP_OC_CANON_GetObjectAttributes        0x901E
00242 #define PTP_OC_CANON_ChangeUSBProtocol          0x901F
00243 #define PTP_OC_CANON_GetChanges                 0x9020
00244 #define PTP_OC_CANON_GetObjectInfoEx            0x9021
00245 #define PTP_OC_CANON_InitiateDirectTransfer     0x9022
00246 #define PTP_OC_CANON_TerminateDirectTransfer    0x9023
00247 #define PTP_OC_CANON_SendObjectInfoByPath       0x9024
00248 #define PTP_OC_CANON_SendObjectByPath           0x9025
00249 #define PTP_OC_CANON_InitiateDirectTansferEx    0x9026
00250 #define PTP_OC_CANON_GetAncillaryObjectHandles  0x9027
00251 #define PTP_OC_CANON_GetTreeInfo                0x9028
00252 #define PTP_OC_CANON_GetTreeSize                0x9029
00253 #define PTP_OC_CANON_NotifyProgress             0x902A
00254 #define PTP_OC_CANON_NotifyCancelAccepted       0x902B
00255 /* 902c: no parms, read 3 uint32 in data, no response parms */
00256 #define PTP_OC_CANON_902C                       0x902C
00257 #define PTP_OC_CANON_GetDirectory               0x902D
00258 
00259 #define PTP_OC_CANON_SetPairingInfo             0x9030
00260 #define PTP_OC_CANON_GetPairingInfo             0x9031
00261 #define PTP_OC_CANON_DeletePairingInfo          0x9032
00262 #define PTP_OC_CANON_GetMACAddress              0x9033
00263 /* 9034: 1 param, no parms returned */
00264 #define PTP_OC_CANON_SetDisplayMonitor          0x9034
00265 #define PTP_OC_CANON_PairingComplete            0x9035
00266 #define PTP_OC_CANON_GetWirelessMAXChannel      0x9036
00267 
00268 /* 9101: no args, 8 byte data (01 00 00 00 00 00 00 00), no resp data. */
00269 #define PTP_OC_CANON_EOS_GetStorageIDs          0x9101
00270 /* 9102: 1 arg (0)
00271  * 0x28 bytes of data:
00272     00000000: 34 00 00 00 02 00 02 91 0a 00 00 00 04 00 03 00
00273     00000010: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00274     00000020: 00 00 ff ff ff ff 03 43 00 46 00 00 00 03 41 00
00275     00000030: 3a 00 00 00
00276  * no resp args
00277  */
00278 #define PTP_OC_CANON_EOS_GetStorageInfo         0x9102
00279 #define PTP_OC_CANON_EOS_GetObjectInfo          0x9103
00280 #define PTP_OC_CANON_EOS_GetObject              0x9104
00281 #define PTP_OC_CANON_EOS_DeleteObject           0x9105
00282 #define PTP_OC_CANON_EOS_FormatStore            0x9106
00283 #define PTP_OC_CANON_EOS_GetPartialObject       0x9107
00284 #define PTP_OC_CANON_EOS_GetDeviceInfoEx        0x9108
00285 
00286 /* sample1:
00287  * 3 cmdargs: 1,0xffffffff,00 00 10 00;
00288  * data:
00289     00000000: 48 00 00 00 02 00 09 91 12 00 00 00 01 00 00 00
00290     00000010: 38 00 00 00 00 00 00 30 01 00 00 00 01 30 00 00
00291     00000020: 01 00 00 00 10 00 00 00 00 00 00 00 00 00 00 20
00292     00000030: 00 00 00 30 44 43 49 4d 00 00 00 00 00 00 00 00   DCIM
00293     00000040: 00 00 00 00 cc c3 01 46
00294  * 2 respargs: 0x0, 0x3c
00295  * 
00296  * sample2:
00297  *
00298     00000000: 18 00 00 00 01 00 09 91 15 00 00 00 01 00 00 00
00299     00000010: 00 00 00 30 00 00 10 00
00300 
00301     00000000: 48 00 00 00 02 00 09 91 15 00 00 00 01 00 00 00
00302     00000010: 38 00 00 00 00 00 9c 33 01 00 00 00 01 30 00 00
00303     00000020: 01 00 00 00 10 00 00 00 00 00 00 00 00 00 00 30
00304     00000030: 00 00 9c 33 32 33 31 43 41 4e 4f 4e 00 00 00 00    231CANON
00305     00000040: 00 00 00 00 cc c3 01 46
00306 
00307  */
00308 #define PTP_OC_CANON_EOS_GetObjectInfoEx        0x9109
00309 #define PTP_OC_CANON_EOS_GetThumbEx             0x910A
00310 #define PTP_OC_CANON_EOS_SetObjectAttributes    0x910C
00311 
00312 /* 910f: no args, no data, 1 response arg (0). */
00313 #define PTP_OC_CANON_EOS_RemoteRelease          0x910F
00314 /* Marcus: looks more like "Set DeviceProperty" in the trace. 
00315  *
00316  * no cmd args
00317  * data phase (0xc, 0xd11c, 0x1)
00318  * no resp args 
00319  */
00320 #define PTP_OC_CANON_EOS_SetDevicePropValueEx   0x9110
00321 #define PTP_OC_CANON_EOS_GetRemoteMode          0x9113
00322 /* 9114: 1 arg (0x1), no data, no resp data. */
00323 #define PTP_OC_CANON_EOS_SetRemoteMode          0x9114
00324 /* 9115: 1 arg (0x1), no data, no resp data. */
00325 #define PTP_OC_CANON_EOS_SetEventMode           0x9115
00326 /* 9116: no args, data phase, no resp data. */
00327 #define PTP_OC_CANON_EOS_GetEvent               0x9116
00328 #define PTP_OC_CANON_EOS_TransferComplete       0x9117
00329 #define PTP_OC_CANON_EOS_CancelTransfer         0x9118
00330 #define PTP_OC_CANON_EOS_ResetTransfer          0x9119
00331 
00332 /* 911a: 3 args (0xfffffff7, 0x00001000, 0x00000001), no data, no resp data. */
00333 /* 911a: 3 args (0x001dfc60, 0x00001000, 0x00000001), no data, no resp data. */
00334 #define PTP_OC_CANON_EOS_PCHDDCapacity          0x911A
00335 
00336 /* 911b: no cmd args, no data, no resp args */
00337 #define PTP_OC_CANON_EOS_SetUILock              0x911B
00338 /* 911c: no cmd args, no data, no resp args */
00339 #define PTP_OC_CANON_EOS_ResetUILock            0x911C
00340 #define PTP_OC_CANON_EOS_KeepDeviceOn           0x911D
00341 #define PTP_OC_CANON_EOS_SetNullPacketMode      0x911E
00342 
00343 /* Nikon extension Operation Codes */
00344 #define PTP_OC_NIKON_GetProfileAllData  0x9006
00345 #define PTP_OC_NIKON_SendProfileData    0x9007
00346 #define PTP_OC_NIKON_DeleteProfile      0x9008
00347 #define PTP_OC_NIKON_SetProfileData     0x9009
00348 #define PTP_OC_NIKON_AdvancedTransfer   0x9010
00349 #define PTP_OC_NIKON_GetFileInfoInBlock 0x9011
00350 #define PTP_OC_NIKON_Capture            0x90C0  /* 1 param,   no data */
00351 #define PTP_OC_NIKON_AfDrive            0x90C1  /* no params, no data */
00352 #define PTP_OC_NIKON_SetControlMode     0x90C2  /* 1 param,   no data */
00353 #define PTP_OC_NIKON_DelImageSDRAM      0x90C3  /* no params, no data */
00354 #define PTP_OC_NIKON_CurveDownload      0x90C5  /* 1 param,   data in */
00355 #define PTP_OC_NIKON_CurveUpload        0x90C6  /* 1 param,   data out */
00356 #define PTP_OC_NIKON_CheckEvent         0x90C7  /* no params, data in */
00357 #define PTP_OC_NIKON_DeviceReady        0x90C8  /* no params, no data */
00358 #define PTP_OC_NIKON_SetPreWBData       0x90C9  /* 3 params,  data out */
00359                                         /* 0x90CA */
00360 #define PTP_OC_NIKON_AfCaptureSDRAM     0x90CB  /* no params, no data */
00361 #define PTP_OC_NIKON_GetPictCtrlData    0x90CC
00362 #define PTP_OC_NIKON_SetPictCtrlData    0x90CD
00363 #define PTP_OC_NIKON_DelCstPicCtrl      0x90CE
00364 #define PTP_OC_NIKON_GetQuickParam      0x90CF
00365 
00366 /* Nikon Liveview stuff */
00367 #define PTP_OC_NIKON_GetPreviewImg      0x9200
00368 #define PTP_OC_NIKON_StartLiveView      0x9201
00369 #define PTP_OC_NIKON_EndLiveView        0x9202
00370 #define PTP_OC_NIKON_GetLiveViewImg     0x9203
00371 #define PTP_OC_NIKON_MfDrive            0x9204
00372 #define PTP_OC_NIKON_ChangeAfDrive      0x9205
00373 #define PTP_OC_NIKON_AfDriveCancel      0x9206
00374 
00375 #define PTP_OC_NIKON_GetDevicePTPIPInfo 0x90E0
00376 
00377 /* Microsoft / MTP extension codes */
00378 
00379 #define PTP_OC_MTP_GetObjectPropsSupported      0x9801
00380 #define PTP_OC_MTP_GetObjectPropDesc            0x9802
00381 #define PTP_OC_MTP_GetObjectPropValue           0x9803
00382 #define PTP_OC_MTP_SetObjectPropValue           0x9804
00383 #define PTP_OC_MTP_GetObjPropList               0x9805
00384 #define PTP_OC_MTP_SetObjPropList               0x9806
00385 #define PTP_OC_MTP_GetInterdependendPropdesc    0x9807
00386 #define PTP_OC_MTP_SendObjectPropList           0x9808
00387 #define PTP_OC_MTP_GetObjectReferences          0x9810
00388 #define PTP_OC_MTP_SetObjectReferences          0x9811
00389 #define PTP_OC_MTP_UpdateDeviceFirmware         0x9812
00390 #define PTP_OC_MTP_Skip                         0x9820
00391 
00392 /*
00393  * Windows Media Digital Rights Management for Portable Devices 
00394  * Extension Codes (microsoft.com/WMDRMPD: 10.1)
00395  */
00396 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeChallenge       0x9101
00397 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeResponse        0x9102
00398 #define PTP_OC_MTP_WMDRMPD_SetLicenseResponse   0x9103
00399 #define PTP_OC_MTP_WMDRMPD_GetSyncList          0x9104
00400 #define PTP_OC_MTP_WMDRMPD_SendMeterChallengeQuery      0x9105
00401 #define PTP_OC_MTP_WMDRMPD_GetMeterChallenge    0x9106
00402 #define PTP_OC_MTP_WMDRMPD_SetMeterResponse             0x9107
00403 #define PTP_OC_MTP_WMDRMPD_CleanDataStore               0x9108
00404 #define PTP_OC_MTP_WMDRMPD_GetLicenseState              0x9109
00405 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDCommand   0x910A
00406 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDRequest   0x910B
00407 
00408 /* 
00409  * Windows Media Digital Rights Management for Portable Devices 
00410  * Extension Codes (microsoft.com/WMDRMPD: 10.1)
00411  * Below are operations that have no public documented identifier 
00412  * associated with them "Vendor-defined Command Code"
00413  */
00414 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDAppRequest        0x9212
00415 #define PTP_OC_MTP_WMDRMPD_GetWMDRMPDAppResponse        0x9213
00416 #define PTP_OC_MTP_WMDRMPD_EnableTrustedFilesOperations 0x9214
00417 #define PTP_OC_MTP_WMDRMPD_DisableTrustedFilesOperations 0x9215
00418 #define PTP_OC_MTP_WMDRMPD_EndTrustedAppSession         0x9216
00419 /* ^^^ guess ^^^ */
00420 
00421 /*
00422  * Microsoft Advanced Audio/Video Transfer 
00423  * Extensions (microsoft.com/AAVT: 1.0)
00424  */
00425 #define PTP_OC_MTP_AAVT_OpenMediaSession                0x9170
00426 #define PTP_OC_MTP_AAVT_CloseMediaSession               0x9171
00427 #define PTP_OC_MTP_AAVT_GetNextDataBlock                0x9172
00428 #define PTP_OC_MTP_AAVT_SetCurrentTimePosition          0x9173
00429 
00430 /*
00431  * Windows Media Digital Rights Management for Network Devices 
00432  * Extensions (microsoft.com/WMDRMND: 1.0) MTP/IP?
00433  */
00434 #define PTP_OC_MTP_WMDRMND_SendRegistrationRequest      0x9180
00435 #define PTP_OC_MTP_WMDRMND_GetRegistrationResponse      0x9181
00436 #define PTP_OC_MTP_WMDRMND_GetProximityChallenge        0x9182
00437 #define PTP_OC_MTP_WMDRMND_SendProximityResponse        0x9183
00438 #define PTP_OC_MTP_WMDRMND_SendWMDRMNDLicenseRequest    0x9184
00439 #define PTP_OC_MTP_WMDRMND_GetWMDRMNDLicenseResponse    0x9185
00440 
00441 /* 
00442  * Windows Media Player Portiable Devices 
00443  * Extension Codes (microsoft.com/WMPPD: 11.1)
00444  */
00445 #define PTP_OC_MTP_WMPPD_ReportAddedDeletedItems        0x9201
00446 #define PTP_OC_MTP_WMPPD_ReportAcquiredItems            0x9202
00447 #define PTP_OC_MTP_WMPPD_PlaylistObjectPref             0x9203
00448 
00449 /*
00450  * Undocumented Zune Operation Codes 
00451  * maybe related to WMPPD extension set?
00452  */
00453 #define PTP_OC_MTP_ZUNE_GETUNDEFINED001                 0x9204
00454 
00455 /* WiFi Provisioning MTP Extension Codes (microsoft.com/WPDWCN: 1.0) */
00456 #define PTP_OC_MTP_WPDWCN_ProcessWFCObject              0x9122
00457 
00458 /* Proprietary vendor extension operations mask */
00459 #define PTP_OC_EXTENSION_MASK           0xF000
00460 #define PTP_OC_EXTENSION                0x9000
00461 
00462 /* Response Codes */
00463 
00464 /* PTP v1.0 response codes */
00465 #define PTP_RC_Undefined                0x2000
00466 #define PTP_RC_OK                       0x2001
00467 #define PTP_RC_GeneralError             0x2002
00468 #define PTP_RC_SessionNotOpen           0x2003
00469 #define PTP_RC_InvalidTransactionID     0x2004
00470 #define PTP_RC_OperationNotSupported    0x2005
00471 #define PTP_RC_ParameterNotSupported    0x2006
00472 #define PTP_RC_IncompleteTransfer       0x2007
00473 #define PTP_RC_InvalidStorageId         0x2008
00474 #define PTP_RC_InvalidObjectHandle      0x2009
00475 #define PTP_RC_DevicePropNotSupported   0x200A
00476 #define PTP_RC_InvalidObjectFormatCode  0x200B
00477 #define PTP_RC_StoreFull                0x200C
00478 #define PTP_RC_ObjectWriteProtected     0x200D
00479 #define PTP_RC_StoreReadOnly            0x200E
00480 #define PTP_RC_AccessDenied             0x200F
00481 #define PTP_RC_NoThumbnailPresent       0x2010
00482 #define PTP_RC_SelfTestFailed           0x2011
00483 #define PTP_RC_PartialDeletion          0x2012
00484 #define PTP_RC_StoreNotAvailable        0x2013
00485 #define PTP_RC_SpecificationByFormatUnsupported         0x2014
00486 #define PTP_RC_NoValidObjectInfo        0x2015
00487 #define PTP_RC_InvalidCodeFormat        0x2016
00488 #define PTP_RC_UnknownVendorCode        0x2017
00489 #define PTP_RC_CaptureAlreadyTerminated 0x2018
00490 #define PTP_RC_DeviceBusy               0x2019
00491 #define PTP_RC_InvalidParentObject      0x201A
00492 #define PTP_RC_InvalidDevicePropFormat  0x201B
00493 #define PTP_RC_InvalidDevicePropValue   0x201C
00494 #define PTP_RC_InvalidParameter         0x201D
00495 #define PTP_RC_SessionAlreadyOpened     0x201E
00496 #define PTP_RC_TransactionCanceled      0x201F
00497 #define PTP_RC_SpecificationOfDestinationUnsupported            0x2020
00498 /* PTP v1.1 response codes */
00499 #define PTP_RC_InvalidEnumHandle        0x2021
00500 #define PTP_RC_NoStreamEnabled          0x2022
00501 #define PTP_RC_InvalidDataSet           0x2023
00502 
00503 /* Eastman Kodak extension Response Codes */
00504 #define PTP_RC_EK_FilenameRequired      0xA001
00505 #define PTP_RC_EK_FilenameConflicts     0xA002
00506 #define PTP_RC_EK_FilenameInvalid       0xA003
00507 
00508 /* Nikon specific response codes */
00509 #define PTP_RC_NIKON_AdvancedTransferCancel 0xA022
00510 
00511 /* Canon specific response codes */
00512 #define PTP_RC_CANON_A009               0xA009
00513 
00514 /* Microsoft/MTP specific codes */
00515 #define PTP_RC_MTP_Undefined                    0xA800
00516 #define PTP_RC_MTP_Invalid_ObjectPropCode       0xA801
00517 #define PTP_RC_MTP_Invalid_ObjectProp_Format    0xA802
00518 #define PTP_RC_MTP_Invalid_ObjectProp_Value     0xA803
00519 #define PTP_RC_MTP_Invalid_ObjectReference      0xA804
00520 #define PTP_RC_MTP_Invalid_Dataset              0xA806
00521 #define PTP_RC_MTP_Specification_By_Group_Unsupported           0xA807
00522 #define PTP_RC_MTP_Specification_By_Depth_Unsupported           0xA808
00523 #define PTP_RC_MTP_Object_Too_Large             0xA809
00524 #define PTP_RC_MTP_ObjectProp_Not_Supported     0xA80A
00525 
00526 /* Microsoft Advanced Audio/Video Transfer response codes 
00527 (microsoft.com/AAVT 1.0) */
00528 #define PTP_RC_MTP_Invalid_Media_Session_ID     0xA170  
00529 #define PTP_RC_MTP_Media_Session_Limit_Reached  0xA171
00530 #define PTP_RC_MTP_No_More_Data                 0xA172
00531 
00532 /* WiFi Provisioning MTP Extension Error Codes (microsoft.com/WPDWCN: 1.0) */
00533 #define PTP_RC_MTP_Invalid_WFC_Syntax           0xA121
00534 #define PTP_RC_MTP_WFC_Version_Not_Supported    0xA122
00535 
00536 /* libptp2 extended ERROR codes */
00537 #define PTP_ERROR_IO                    0x02FF
00538 #define PTP_ERROR_DATA_EXPECTED         0x02FE
00539 #define PTP_ERROR_RESP_EXPECTED         0x02FD
00540 #define PTP_ERROR_BADPARAM              0x02FC
00541 #define PTP_ERROR_CANCEL                0x02FB
00542 
00543 /* PTP Event Codes */
00544 
00545 #define PTP_EC_Undefined                0x4000
00546 #define PTP_EC_CancelTransaction        0x4001
00547 #define PTP_EC_ObjectAdded              0x4002
00548 #define PTP_EC_ObjectRemoved            0x4003
00549 #define PTP_EC_StoreAdded               0x4004
00550 #define PTP_EC_StoreRemoved             0x4005
00551 #define PTP_EC_DevicePropChanged        0x4006
00552 #define PTP_EC_ObjectInfoChanged        0x4007
00553 #define PTP_EC_DeviceInfoChanged        0x4008
00554 #define PTP_EC_RequestObjectTransfer    0x4009
00555 #define PTP_EC_StoreFull                0x400A
00556 #define PTP_EC_DeviceReset              0x400B
00557 #define PTP_EC_StorageInfoChanged       0x400C
00558 #define PTP_EC_CaptureComplete          0x400D
00559 #define PTP_EC_UnreportedStatus         0x400E
00560 
00561 /* Canon extension Event Codes */
00562 #define PTP_EC_CANON_ExtendedErrorcode          0xC005  /* ? */
00563 #define PTP_EC_CANON_ObjectInfoChanged          0xC008
00564 #define PTP_EC_CANON_RequestObjectTransfer      0xC009
00565 #define PTP_EC_CANON_CameraModeChanged          0xC00C
00566 #define PTP_EC_CANON_ShutterButtonPressed       0xC00E
00567 
00568 #define PTP_EC_CANON_StartDirectTransfer        0xC011
00569 #define PTP_EC_CANON_StopDirectTransfer         0xC013
00570 
00571 /* Nikon extension Event Codes */
00572 #define PTP_EC_Nikon_ObjectAddedInSDRAM         0xC101
00573 #define PTP_EC_Nikon_CaptureOverflow            0xC102
00574 /* Gets 1 parameter, objectid pointing to DPOF object */
00575 #define PTP_EC_Nikon_AdvancedTransfer           0xC103
00576 
00577 /* MTP Event codes */
00578 #define PTP_EC_MTP_ObjectPropChanged            0xC801
00579 #define PTP_EC_MTP_ObjectPropDescChanged        0xC802
00580 #define PTP_EC_MTP_ObjectReferencesChanged      0xC803
00581 
00582 /* constants for GetObjectHandles */
00583 #define PTP_GOH_ALL_STORAGE 0xffffffff
00584 #define PTP_GOH_ALL_FORMATS 0x00000000
00585 #define PTP_GOH_ALL_ASSOCS  0x00000000
00586 #define PTP_GOH_ROOT_PARENT 0xffffffff
00587 
00588 /* PTP device info structure (returned by GetDevInfo) */
00589 
00590 struct _PTPDeviceInfo {
00591         uint16_t StandardVersion;
00592         uint32_t VendorExtensionID;
00593         uint16_t VendorExtensionVersion;
00594         char    *VendorExtensionDesc;
00595         uint16_t FunctionalMode;
00596         uint32_t OperationsSupported_len;
00597         uint16_t *OperationsSupported;
00598         uint32_t EventsSupported_len;
00599         uint16_t *EventsSupported;
00600         uint32_t DevicePropertiesSupported_len;
00601         uint16_t *DevicePropertiesSupported;
00602         uint32_t CaptureFormats_len;
00603         uint16_t *CaptureFormats;
00604         uint32_t ImageFormats_len;
00605         uint16_t *ImageFormats;
00606         char    *Manufacturer;
00607         char    *Model;
00608         char    *DeviceVersion;
00609         char    *SerialNumber;
00610 };
00611 typedef struct _PTPDeviceInfo PTPDeviceInfo;
00612 
00613 /* PTP storageIDs structute (returned by GetStorageIDs) */
00614 
00615 struct _PTPStorageIDs {
00616         uint32_t n;
00617         uint32_t *Storage;
00618 };
00619 typedef struct _PTPStorageIDs PTPStorageIDs;
00620 
00621 /* PTP StorageInfo structure (returned by GetStorageInfo) */
00622 struct _PTPStorageInfo {
00623         uint16_t StorageType;
00624         uint16_t FilesystemType;
00625         uint16_t AccessCapability;
00626         uint64_t MaxCapability;
00627         uint64_t FreeSpaceInBytes;
00628         uint32_t FreeSpaceInImages;
00629         char    *StorageDescription;
00630         char    *VolumeLabel;
00631 };
00632 typedef struct _PTPStorageInfo PTPStorageInfo;
00633 
00634 /* PTP objecthandles structure (returned by GetObjectHandles) */
00635 
00636 struct _PTPObjectHandles {
00637         uint32_t n;
00638         uint32_t *Handler;
00639 };
00640 typedef struct _PTPObjectHandles PTPObjectHandles;
00641 
00642 #define PTP_HANDLER_SPECIAL     0xffffffff
00643 #define PTP_HANDLER_ROOT        0x00000000
00644 
00645 
00646 /* PTP objectinfo structure (returned by GetObjectInfo) */
00647 
00648 struct _PTPObjectInfo {
00649         uint32_t StorageID;
00650         uint16_t ObjectFormat;
00651         uint16_t ProtectionStatus;
00652         uint32_t ObjectCompressedSize;
00653         uint16_t ThumbFormat;
00654         uint32_t ThumbCompressedSize;
00655         uint32_t ThumbPixWidth;
00656         uint32_t ThumbPixHeight;
00657         uint32_t ImagePixWidth;
00658         uint32_t ImagePixHeight;
00659         uint32_t ImageBitDepth;
00660         uint32_t ParentObject;
00661         uint16_t AssociationType;
00662         uint32_t AssociationDesc;
00663         uint32_t SequenceNumber;
00664         char    *Filename;
00665         time_t  CaptureDate;
00666         time_t  ModificationDate;
00667         char    *Keywords;
00668 };
00669 typedef struct _PTPObjectInfo PTPObjectInfo;
00670 
00671 /* max ptp string length INCLUDING terminating null character */
00672 
00673 #define PTP_MAXSTRLEN                           255
00674 
00675 /* PTP Object Format Codes */
00676 
00677 /* ancillary formats */
00678 #define PTP_OFC_Undefined                       0x3000
00679 #define PTP_OFC_Defined                         0x3800
00680 #define PTP_OFC_Association                     0x3001
00681 #define PTP_OFC_Script                          0x3002
00682 #define PTP_OFC_Executable                      0x3003
00683 #define PTP_OFC_Text                            0x3004
00684 #define PTP_OFC_HTML                            0x3005
00685 #define PTP_OFC_DPOF                            0x3006
00686 #define PTP_OFC_AIFF                            0x3007
00687 #define PTP_OFC_WAV                             0x3008
00688 #define PTP_OFC_MP3                             0x3009
00689 #define PTP_OFC_AVI                             0x300A
00690 #define PTP_OFC_MPEG                            0x300B
00691 #define PTP_OFC_ASF                             0x300C
00692 #define PTP_OFC_QT                              0x300D /* guessing */
00693 /* image formats */
00694 #define PTP_OFC_EXIF_JPEG                       0x3801
00695 #define PTP_OFC_TIFF_EP                         0x3802
00696 #define PTP_OFC_FlashPix                        0x3803
00697 #define PTP_OFC_BMP                             0x3804
00698 #define PTP_OFC_CIFF                            0x3805
00699 #define PTP_OFC_Undefined_0x3806                0x3806
00700 #define PTP_OFC_GIF                             0x3807
00701 #define PTP_OFC_JFIF                            0x3808
00702 #define PTP_OFC_PCD                             0x3809
00703 #define PTP_OFC_PICT                            0x380A
00704 #define PTP_OFC_PNG                             0x380B
00705 #define PTP_OFC_Undefined_0x380C                0x380C
00706 #define PTP_OFC_TIFF                            0x380D
00707 #define PTP_OFC_TIFF_IT                         0x380E
00708 #define PTP_OFC_JP2                             0x380F
00709 #define PTP_OFC_JPX                             0x3810
00710 /* ptp v1.1 has only DNG new */
00711 #define PTP_OFC_DNG                             0x3811
00712 /* Eastman Kodak extension ancillary format */
00713 #define PTP_OFC_EK_M3U                          0xb002
00714 /* Canon extension */
00715 #define PTP_OFC_CANON_CRW                       0xb101
00716 /* MTP extensions */
00717 #define PTP_OFC_MTP_MediaCard                   0xb211
00718 #define PTP_OFC_MTP_MediaCardGroup              0xb212
00719 #define PTP_OFC_MTP_Encounter                   0xb213
00720 #define PTP_OFC_MTP_EncounterBox                0xb214
00721 #define PTP_OFC_MTP_M4A                         0xb215
00722 #define PTP_OFC_MTP_ZUNEUNDEFINED               0xb217 /* Unknown file type */
00723 #define PTP_OFC_MTP_Firmware                    0xb802
00724 #define PTP_OFC_MTP_WindowsImageFormat          0xb881
00725 #define PTP_OFC_MTP_UndefinedAudio              0xb900
00726 #define PTP_OFC_MTP_WMA                         0xb901
00727 #define PTP_OFC_MTP_OGG                         0xb902
00728 #define PTP_OFC_MTP_AAC                         0xb903
00729 #define PTP_OFC_MTP_AudibleCodec                0xb904
00730 #define PTP_OFC_MTP_FLAC                        0xb906
00731 #define PTP_OFC_MTP_UndefinedVideo              0xb980
00732 #define PTP_OFC_MTP_WMV                         0xb981
00733 #define PTP_OFC_MTP_MP4                         0xb982
00734 #define PTP_OFC_MTP_MP2                         0xb983
00735 #define PTP_OFC_MTP_3GP                         0xb984
00736 #define PTP_OFC_MTP_UndefinedCollection         0xba00
00737 #define PTP_OFC_MTP_AbstractMultimediaAlbum     0xba01
00738 #define PTP_OFC_MTP_AbstractImageAlbum          0xba02
00739 #define PTP_OFC_MTP_AbstractAudioAlbum          0xba03
00740 #define PTP_OFC_MTP_AbstractVideoAlbum          0xba04
00741 #define PTP_OFC_MTP_AbstractAudioVideoPlaylist  0xba05
00742 #define PTP_OFC_MTP_AbstractContactGroup        0xba06
00743 #define PTP_OFC_MTP_AbstractMessageFolder       0xba07
00744 #define PTP_OFC_MTP_AbstractChapteredProduction 0xba08
00745 #define PTP_OFC_MTP_AbstractAudioPlaylist       0xba09
00746 #define PTP_OFC_MTP_AbstractVideoPlaylist       0xba0a
00747 #define PTP_OFC_MTP_AbstractMediacast           0xba0b
00748 #define PTP_OFC_MTP_WPLPlaylist                 0xba10
00749 #define PTP_OFC_MTP_M3UPlaylist                 0xba11
00750 #define PTP_OFC_MTP_MPLPlaylist                 0xba12
00751 #define PTP_OFC_MTP_ASXPlaylist                 0xba13
00752 #define PTP_OFC_MTP_PLSPlaylist                 0xba14
00753 #define PTP_OFC_MTP_UndefinedDocument           0xba80
00754 #define PTP_OFC_MTP_AbstractDocument            0xba81
00755 #define PTP_OFC_MTP_XMLDocument                 0xba82
00756 #define PTP_OFC_MTP_MSWordDocument              0xba83
00757 #define PTP_OFC_MTP_MHTCompiledHTMLDocument     0xba84
00758 #define PTP_OFC_MTP_MSExcelSpreadsheetXLS       0xba85
00759 #define PTP_OFC_MTP_MSPowerpointPresentationPPT 0xba86
00760 #define PTP_OFC_MTP_UndefinedMessage            0xbb00
00761 #define PTP_OFC_MTP_AbstractMessage             0xbb01
00762 #define PTP_OFC_MTP_UndefinedContact            0xbb80
00763 #define PTP_OFC_MTP_AbstractContact             0xbb81
00764 #define PTP_OFC_MTP_vCard2                      0xbb82
00765 #define PTP_OFC_MTP_vCard3                      0xbb83
00766 #define PTP_OFC_MTP_UndefinedCalendarItem       0xbe00
00767 #define PTP_OFC_MTP_AbstractCalendarItem        0xbe01
00768 #define PTP_OFC_MTP_vCalendar1                  0xbe02
00769 #define PTP_OFC_MTP_vCalendar2                  0xbe03
00770 #define PTP_OFC_MTP_UndefinedWindowsExecutable  0xbe80
00771 #define PTP_OFC_MTP_MediaCast                   0xbe81
00772 #define PTP_OFC_MTP_Section                     0xbe82
00773 
00774 /* PTP Association Types */
00775 #define PTP_AT_Undefined                        0x0000
00776 #define PTP_AT_GenericFolder                    0x0001
00777 #define PTP_AT_Album                            0x0002
00778 #define PTP_AT_TimeSequence                     0x0003
00779 #define PTP_AT_HorizontalPanoramic              0x0004
00780 #define PTP_AT_VerticalPanoramic                0x0005
00781 #define PTP_AT_2DPanoramic                      0x0006
00782 #define PTP_AT_AncillaryData                    0x0007
00783 
00784 /* PTP Protection Status */
00785 
00786 #define PTP_PS_NoProtection                     0x0000
00787 #define PTP_PS_ReadOnly                         0x0001
00788 
00789 /* PTP Storage Types */
00790 
00791 #define PTP_ST_Undefined                        0x0000
00792 #define PTP_ST_FixedROM                         0x0001
00793 #define PTP_ST_RemovableROM                     0x0002
00794 #define PTP_ST_FixedRAM                         0x0003
00795 #define PTP_ST_RemovableRAM                     0x0004
00796 
00797 /* PTP FilesystemType Values */
00798 
00799 #define PTP_FST_Undefined                       0x0000
00800 #define PTP_FST_GenericFlat                     0x0001
00801 #define PTP_FST_GenericHierarchical             0x0002
00802 #define PTP_FST_DCF                             0x0003
00803 
00804 /* PTP StorageInfo AccessCapability Values */
00805 
00806 #define PTP_AC_ReadWrite                        0x0000
00807 #define PTP_AC_ReadOnly                         0x0001
00808 #define PTP_AC_ReadOnly_with_Object_Deletion    0x0002
00809 
00810 /* Property Describing Dataset, Range Form */
00811 
00812 union _PTPPropertyValue {
00813         char            *str;   /* common string, malloced */
00814         uint8_t         u8;
00815         int8_t          i8;
00816         uint16_t        u16;
00817         int16_t         i16;
00818         uint32_t        u32;
00819         int32_t         i32;
00820         uint64_t        u64;
00821         int64_t         i64;
00822         /* XXXX: 128 bit signed and unsigned missing */
00823         struct array {
00824                 uint32_t        count;
00825                 union _PTPPropertyValue *v;     /* malloced, count elements */
00826         } a;
00827 };
00828 
00829 typedef union _PTPPropertyValue PTPPropertyValue;
00830 
00831 /* Metadata lists for MTP operations */
00832 struct _MTPProperties {
00833         uint16_t                property;
00834         uint16_t                datatype;
00835         uint32_t                ObjectHandle;
00836         PTPPropertyValue        propval;
00837 };
00838 typedef struct _MTPProperties MTPProperties;
00839 
00840 struct _PTPPropDescRangeForm {
00841         PTPPropertyValue        MinimumValue;
00842         PTPPropertyValue        MaximumValue;
00843         PTPPropertyValue        StepSize;
00844 };
00845 typedef struct _PTPPropDescRangeForm PTPPropDescRangeForm;
00846 
00847 /* Property Describing Dataset, Enum Form */
00848 
00849 struct _PTPPropDescEnumForm {
00850         uint16_t                NumberOfValues;
00851         PTPPropertyValue        *SupportedValue;        /* malloced */
00852 };
00853 typedef struct _PTPPropDescEnumForm PTPPropDescEnumForm;
00854 
00855 /* Device Property Describing Dataset (DevicePropDesc) */
00856 
00857 struct _PTPDevicePropDesc {
00858         uint16_t                DevicePropertyCode;
00859         uint16_t                DataType;
00860         uint8_t                 GetSet;
00861         PTPPropertyValue        FactoryDefaultValue;
00862         PTPPropertyValue        CurrentValue;
00863         uint8_t                 FormFlag;
00864         union   {
00865                 PTPPropDescEnumForm     Enum;
00866                 PTPPropDescRangeForm    Range;
00867         } FORM;
00868 };
00869 typedef struct _PTPDevicePropDesc PTPDevicePropDesc;
00870 
00871 /* Object Property Describing Dataset (DevicePropDesc) */
00872 
00873 struct _PTPObjectPropDesc {
00874         uint16_t                ObjectPropertyCode;
00875         uint16_t                DataType;
00876         uint8_t                 GetSet;
00877         PTPPropertyValue        FactoryDefaultValue;
00878         uint32_t                GroupCode;
00879         uint8_t                 FormFlag;
00880         union   {
00881                 PTPPropDescEnumForm     Enum;
00882                 PTPPropDescRangeForm    Range;
00883         } FORM;
00884 };
00885 typedef struct _PTPObjectPropDesc PTPObjectPropDesc;
00886 
00887 /* Canon filesystem's folder entry Dataset */
00888 
00889 #define PTP_CANON_FilenameBufferLen     13
00890 #define PTP_CANON_FolderEntryLen        28
00891 
00892 struct _PTPCANONFolderEntry {
00893         uint32_t        ObjectHandle;
00894         uint16_t        ObjectFormatCode;
00895         uint8_t         Flags;
00896         uint32_t        ObjectSize;
00897         time_t          Time;
00898         char            Filename[PTP_CANON_FilenameBufferLen];
00899 };
00900 typedef struct _PTPCANONFolderEntry PTPCANONFolderEntry;
00901 
00902 /* Nikon Tone Curve Data */
00903 
00904 #define PTP_NIKON_MaxCurvePoints 19
00905 
00906 struct _PTPNIKONCoordinatePair {
00907         uint8_t         X;
00908         uint8_t         Y;
00909 };
00910 
00911 typedef struct _PTPNIKONCoordinatePair PTPNIKONCoordinatePair;
00912 
00913 struct _PTPNTCCoordinatePair {
00914         uint8_t         X;
00915         uint8_t         Y;
00916 };
00917 
00918 typedef struct _PTPNTCCoordinatePair PTPNTCCoordinatePair;
00919 
00920 struct _PTPNIKONCurveData {
00921         char                    static_preamble[6];
00922         uint8_t                 XAxisStartPoint;
00923         uint8_t                 XAxisEndPoint;
00924         uint8_t                 YAxisStartPoint;
00925         uint8_t                 YAxisEndPoint;
00926         uint8_t                 MidPointIntegerPart;
00927         uint8_t                 MidPointDecimalPart;
00928         uint8_t                 NCoordinates;
00929         PTPNIKONCoordinatePair  CurveCoordinates[PTP_NIKON_MaxCurvePoints];
00930 };
00931 
00932 typedef struct _PTPNIKONCurveData PTPNIKONCurveData;
00933 
00934 struct _PTPEKTextParams {
00935         char    *title;
00936         char    *line[5];
00937 };
00938 typedef struct _PTPEKTextParams PTPEKTextParams;
00939 
00940 /* Nikon Wifi profiles */
00941 
00942 struct _PTPNIKONWifiProfile {
00943         /* Values valid both when reading and writing profiles */
00944         char      profile_name[17];
00945         uint8_t   device_type;
00946         uint8_t   icon_type;
00947         char      essid[33];
00948 
00949         /* Values only valid when reading. Some of these are in the write packet,
00950          * but are set automatically, like id, display_order and creation_date. */
00951         uint8_t   id;
00952         uint8_t   valid;
00953         uint8_t   display_order;
00954         char      creation_date[16];
00955         char      lastusage_date[16];
00956         
00957         /* Values only valid when writing */
00958         uint32_t  ip_address;
00959         uint8_t   subnet_mask; /* first zero bit position, e.g. 24 for 255.255.255.0 */
00960         uint32_t  gateway_address;
00961         uint8_t   address_mode; /* 0 - Manual, 2-3 -  DHCP ad-hoc/managed*/
00962         uint8_t   access_mode; /* 0 - Managed, 1 - Adhoc */
00963         uint8_t   wifi_channel; /* 1-11 */
00964         uint8_t   authentification; /* 0 - Open, 1 - Shared, 2 - WPA-PSK */
00965         uint8_t   encryption; /* 0 - None, 1 - WEP 64bit, 2 - WEP 128bit (not supported: 3 - TKIP) */
00966         uint8_t   key[64];
00967         uint8_t   key_nr;
00968 //      char      guid[16];
00969 };
00970 
00971 typedef struct _PTPNIKONWifiProfile PTPNIKONWifiProfile;
00972 
00973 #define PTP_CANON_EOS_CHANGES_TYPE_UNKNOWN      0
00974 #define PTP_CANON_EOS_CHANGES_TYPE_OBJECTINFO   1
00975 
00976 struct _PTPCanon_New_Object {
00977         uint32_t                oid;
00978         PTPObjectInfo   oi;
00979 };
00980 
00981 struct _PTPCanon_changes_entry {
00982         int     type;
00983         union {
00984                 struct _PTPCanon_New_Object     object; /* TYPE_OBJECTINFO */
00985         } u;
00986 };
00987 typedef struct _PTPCanon_changes_entry PTPCanon_changes_entry;
00988 
00989 typedef struct _PTPCanon_Property {
00990         uint32_t                size;
00991         uint32_t                type;
00992         uint32_t                proptype;
00993         unsigned char           *data;
00994 
00995         /* fill out for queries */
00996         PTPDevicePropDesc       dpd;
00997 } PTPCanon_Property;
00998 
00999 
01000 /* DataType Codes */
01001 
01002 #define PTP_DTC_UNDEF           0x0000
01003 #define PTP_DTC_INT8            0x0001
01004 #define PTP_DTC_UINT8           0x0002
01005 #define PTP_DTC_INT16           0x0003
01006 #define PTP_DTC_UINT16          0x0004
01007 #define PTP_DTC_INT32           0x0005
01008 #define PTP_DTC_UINT32          0x0006
01009 #define PTP_DTC_INT64           0x0007
01010 #define PTP_DTC_UINT64          0x0008
01011 #define PTP_DTC_INT128          0x0009
01012 #define PTP_DTC_UINT128         0x000A
01013 
01014 #define PTP_DTC_ARRAY_MASK      0x4000
01015 
01016 #define PTP_DTC_AINT8           (PTP_DTC_ARRAY_MASK | PTP_DTC_INT8)
01017 #define PTP_DTC_AUINT8          (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT8)
01018 #define PTP_DTC_AINT16          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT16)
01019 #define PTP_DTC_AUINT16         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT16)
01020 #define PTP_DTC_AINT32          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT32)
01021 #define PTP_DTC_AUINT32         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT32)
01022 #define PTP_DTC_AINT64          (PTP_DTC_ARRAY_MASK | PTP_DTC_INT64)
01023 #define PTP_DTC_AUINT64         (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT64)
01024 #define PTP_DTC_AINT128         (PTP_DTC_ARRAY_MASK | PTP_DTC_INT128)
01025 #define PTP_DTC_AUINT128        (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT128)
01026 
01027 #define PTP_DTC_STR             0xFFFF
01028 
01029 /* Device Properties Codes */
01030 
01031 /* PTP v1.0 property codes */
01032 #define PTP_DPC_Undefined               0x5000
01033 #define PTP_DPC_BatteryLevel            0x5001
01034 #define PTP_DPC_FunctionalMode          0x5002
01035 #define PTP_DPC_ImageSize               0x5003
01036 #define PTP_DPC_CompressionSetting      0x5004
01037 #define PTP_DPC_WhiteBalance            0x5005
01038 #define PTP_DPC_RGBGain                 0x5006
01039 #define PTP_DPC_FNumber                 0x5007
01040 #define PTP_DPC_FocalLength             0x5008
01041 #define PTP_DPC_FocusDistance           0x5009
01042 #define PTP_DPC_FocusMode               0x500A
01043 #define PTP_DPC_ExposureMeteringMode    0x500B
01044 #define PTP_DPC_FlashMode               0x500C
01045 #define PTP_DPC_ExposureTime            0x500D
01046 #define PTP_DPC_ExposureProgramMode     0x500E
01047 #define PTP_DPC_ExposureIndex           0x500F
01048 #define PTP_DPC_ExposureBiasCompensation        0x5010
01049 #define PTP_DPC_DateTime                0x5011
01050 #define PTP_DPC_CaptureDelay            0x5012
01051 #define PTP_DPC_StillCaptureMode        0x5013
01052 #define PTP_DPC_Contrast                0x5014
01053 #define PTP_DPC_Sharpness               0x5015
01054 #define PTP_DPC_DigitalZoom             0x5016
01055 #define PTP_DPC_EffectMode              0x5017
01056 #define PTP_DPC_BurstNumber             0x5018
01057 #define PTP_DPC_BurstInterval           0x5019
01058 #define PTP_DPC_TimelapseNumber         0x501A
01059 #define PTP_DPC_TimelapseInterval       0x501B
01060 #define PTP_DPC_FocusMeteringMode       0x501C
01061 #define PTP_DPC_UploadURL               0x501D
01062 #define PTP_DPC_Artist                  0x501E
01063 #define PTP_DPC_CopyrightInfo           0x501F
01064 /* PTP v1.1 property codes */
01065 #define PTP_DPC_SupportedStreams        0x5020
01066 #define PTP_DPC_EnabledStreams          0x5021
01067 #define PTP_DPC_VideoFormat             0x5022
01068 #define PTP_DPC_VideoResolution         0x5023
01069 #define PTP_DPC_VideoQuality            0x5024
01070 #define PTP_DPC_VideoFrameRate          0x5025
01071 #define PTP_DPC_VideoContrast           0x5026
01072 #define PTP_DPC_VideoBrightness         0x5027
01073 #define PTP_DPC_AudioFormat             0x5028
01074 #define PTP_DPC_AudioBitrate            0x5029
01075 #define PTP_DPC_AudioSamplingRate       0x502A
01076 #define PTP_DPC_AudioBitPerSample       0x502B
01077 #define PTP_DPC_AudioVolume             0x502C
01078 
01079 /* Proprietary vendor extension device property mask */
01080 #define PTP_DPC_EXTENSION_MASK          0xF000
01081 #define PTP_DPC_EXTENSION               0xD000
01082 
01083 /* Zune extension device property codes */
01084 #define PTP_DPC_MTP_ZUNE_UNKNOWN1       0xD181
01085 #define PTP_DPC_MTP_ZUNE_UNKNOWN2       0xD132
01086 #define PTP_DPC_MTP_ZUNE_UNKNOWN3       0xD215
01087 #define PTP_DPC_MTP_ZUNE_UNKNOWN4       0xD216
01088 
01089 /* Eastman Kodak extension device property codes */
01090 #define PTP_DPC_EK_ColorTemperature     0xD001
01091 #define PTP_DPC_EK_DateTimeStampFormat  0xD002
01092 #define PTP_DPC_EK_BeepMode             0xD003
01093 #define PTP_DPC_EK_VideoOut             0xD004
01094 #define PTP_DPC_EK_PowerSaving          0xD005
01095 #define PTP_DPC_EK_UI_Language          0xD006
01096 
01097 /* Canon extension device property codes */
01098 #define PTP_DPC_CANON_BeepMode          0xD001
01099 #define PTP_DPC_CANON_BatteryKind       0xD002
01100 #define PTP_DPC_CANON_BatteryStatus     0xD003
01101 #define PTP_DPC_CANON_UILockType        0xD004
01102 #define PTP_DPC_CANON_CameraMode        0xD005
01103 #define PTP_DPC_CANON_ImageQuality      0xD006
01104 #define PTP_DPC_CANON_FullViewFileFormat 0xD007
01105 #define PTP_DPC_CANON_ImageSize         0xD008
01106 #define PTP_DPC_CANON_SelfTime          0xD009
01107 #define PTP_DPC_CANON_FlashMode         0xD00A
01108 #define PTP_DPC_CANON_Beep              0xD00B
01109 #define PTP_DPC_CANON_ShootingMode      0xD00C
01110 #define PTP_DPC_CANON_ImageMode         0xD00D
01111 #define PTP_DPC_CANON_DriveMode         0xD00E
01112 #define PTP_DPC_CANON_EZoom             0xD00F
01113 #define PTP_DPC_CANON_MeteringMode      0xD010
01114 #define PTP_DPC_CANON_AFDistance        0xD011
01115 #define PTP_DPC_CANON_FocusingPoint     0xD012
01116 #define PTP_DPC_CANON_WhiteBalance      0xD013
01117 #define PTP_DPC_CANON_SlowShutterSetting        0xD014
01118 #define PTP_DPC_CANON_AFMode            0xD015
01119 #define PTP_DPC_CANON_ImageStabilization        0xD016
01120 #define PTP_DPC_CANON_Contrast          0xD017
01121 #define PTP_DPC_CANON_ColorGain         0xD018
01122 #define PTP_DPC_CANON_Sharpness         0xD019
01123 #define PTP_DPC_CANON_Sensitivity       0xD01A
01124 #define PTP_DPC_CANON_ParameterSet      0xD01B
01125 #define PTP_DPC_CANON_ISOSpeed          0xD01C
01126 #define PTP_DPC_CANON_Aperture          0xD01D
01127 #define PTP_DPC_CANON_ShutterSpeed      0xD01E
01128 #define PTP_DPC_CANON_ExpCompensation   0xD01F
01129 #define PTP_DPC_CANON_FlashCompensation 0xD020
01130 #define PTP_DPC_CANON_AEBExposureCompensation   0xD021
01131 #define PTP_DPC_CANON_AvOpen            0xD023
01132 #define PTP_DPC_CANON_AvMax             0xD024
01133 #define PTP_DPC_CANON_FocalLength       0xD025
01134 #define PTP_DPC_CANON_FocalLengthTele   0xD026
01135 #define PTP_DPC_CANON_FocalLengthWide   0xD027
01136 #define PTP_DPC_CANON_FocalLengthDenominator    0xD028
01137 #define PTP_DPC_CANON_CaptureTransferMode       0xD029
01138 #define CANON_TRANSFER_ENTIRE_IMAGE_TO_PC       0x0002
01139 #define CANON_TRANSFER_SAVE_THUMBNAIL_TO_DEVICE 0x0004
01140 #define CANON_TRANSFER_SAVE_IMAGE_TO_DEVICE     0x0008
01141 /* we use those values: */
01142 #define CANON_TRANSFER_MEMORY           (2|1)
01143 #define CANON_TRANSFER_CARD             (8|4|1)
01144 
01145 #define PTP_DPC_CANON_Zoom              0xD02A
01146 #define PTP_DPC_CANON_NamePrefix        0xD02B
01147 #define PTP_DPC_CANON_SizeQualityMode   0xD02C
01148 #define PTP_DPC_CANON_SupportedThumbSize        0xD02D
01149 #define PTP_DPC_CANON_SizeOfOutputDataFromCamera        0xD02E
01150 #define PTP_DPC_CANON_SizeOfInputDataToCamera           0xD02F
01151 #define PTP_DPC_CANON_RemoteAPIVersion  0xD030
01152 #define PTP_DPC_CANON_FirmwareVersion   0xD031
01153 #define PTP_DPC_CANON_CameraModel       0xD032
01154 #define PTP_DPC_CANON_CameraOwner       0xD033
01155 #define PTP_DPC_CANON_UnixTime          0xD034
01156 #define PTP_DPC_CANON_CameraBodyID      0xD035
01157 #define PTP_DPC_CANON_CameraOutput      0xD036
01158 #define PTP_DPC_CANON_DispAv            0xD037
01159 #define PTP_DPC_CANON_AvOpenApex        0xD038
01160 #define PTP_DPC_CANON_DZoomMagnification        0xD039
01161 #define PTP_DPC_CANON_MlSpotPos         0xD03A
01162 #define PTP_DPC_CANON_DispAvMax         0xD03B
01163 #define PTP_DPC_CANON_AvMaxApex         0xD03C
01164 #define PTP_DPC_CANON_EZoomStartPosition                0xD03D
01165 #define PTP_DPC_CANON_FocalLengthOfTele 0xD03E
01166 #define PTP_DPC_CANON_EZoomSizeOfTele   0xD03F
01167 #define PTP_DPC_CANON_PhotoEffect       0xD040
01168 #define PTP_DPC_CANON_AssistLight       0xD041
01169 #define PTP_DPC_CANON_FlashQuantityCount        0xD042
01170 #define PTP_DPC_CANON_RotationAngle     0xD043
01171 #define PTP_DPC_CANON_RotationScene     0xD044
01172 #define PTP_DPC_CANON_EventEmulateMode  0xD045
01173 #define PTP_DPC_CANON_DPOFVersion       0xD046
01174 #define PTP_DPC_CANON_TypeOfSupportedSlideShow  0xD047
01175 #define PTP_DPC_CANON_AverageFilesizes  0xD048
01176 #define PTP_DPC_CANON_ModelID           0xD049
01177 
01178 /* From EOS 400D trace. */
01179 #define PTP_DPC_CANON_EOS_Aperture              0xD101
01180 #define PTP_DPC_CANON_EOS_ShutterSpeed          0xD102
01181 #define PTP_DPC_CANON_EOS_ISOSpeed              0xD103
01182 #define PTP_DPC_CANON_EOS_ExpCompensation       0xD104
01183 #define PTP_DPC_CANON_EOS_CameraMode            0xD105
01184 #define PTP_DPC_CANON_EOS_MeteringMode          0xD107
01185 #define PTP_DPC_CANON_EOS_Focus                 0xD108
01186 #define PTP_DPC_CANON_EOS_WhiteBalance          0xD109
01187 #define PTP_DPC_CANON_EOS_WhiteBalanceAdjustA   0xD10B
01188 #define PTP_DPC_CANON_EOS_WhiteBalanceAdjustB   0xD10C
01189 #define PTP_DPC_CANON_EOS_ColorSpace            0xD10F
01190 #define PTP_DPC_CANON_EOS_PictureStyle          0xD110
01191 #define PTP_DPC_CANON_EOS_TransferOption        0xD111
01192 #define PTP_DPC_CANON_EOS_CameraTime            0xD113
01193 #define PTP_DPC_CANON_EOS_Owner                 0xD115
01194 #define PTP_DPC_CANON_EOS_ImageFormat           0xD120
01195 
01196 /* Nikon extension device property codes */
01197 #define PTP_DPC_NIKON_ShootingBank                      0xD010
01198 #define PTP_DPC_NIKON_ShootingBankNameA                 0xD011
01199 #define PTP_DPC_NIKON_ShootingBankNameB                 0xD012
01200 #define PTP_DPC_NIKON_ShootingBankNameC                 0xD013
01201 #define PTP_DPC_NIKON_ShootingBankNameD                 0xD014
01202 #define PTP_DPC_NIKON_ResetBank0                        0xD015
01203 #define PTP_DPC_NIKON_RawCompression                    0xD016
01204 #define PTP_DPC_NIKON_WhiteBalanceAutoBias              0xD017
01205 #define PTP_DPC_NIKON_WhiteBalanceTungstenBias          0xD018
01206 #define PTP_DPC_NIKON_WhiteBalanceFluorescentBias       0xD019
01207 #define PTP_DPC_NIKON_WhiteBalanceDaylightBias          0xD01A
01208 #define PTP_DPC_NIKON_WhiteBalanceFlashBias             0xD01B
01209 #define PTP_DPC_NIKON_WhiteBalanceCloudyBias            0xD01C
01210 #define PTP_DPC_NIKON_WhiteBalanceShadeBias             0xD01D
01211 #define PTP_DPC_NIKON_WhiteBalanceColorTemperature      0xD01E
01212 #define PTP_DPC_NIKON_WhiteBalancePresetNo              0xD01F
01213 #define PTP_DPC_NIKON_WhiteBalancePresetName0           0xD020
01214 #define PTP_DPC_NIKON_WhiteBalancePresetName1           0xD021
01215 #define PTP_DPC_NIKON_WhiteBalancePresetName2           0xD022
01216 #define PTP_DPC_NIKON_WhiteBalancePresetName3           0xD023
01217 #define PTP_DPC_NIKON_WhiteBalancePresetName4           0xD024
01218 #define PTP_DPC_NIKON_WhiteBalancePresetVal0            0xD025
01219 #define PTP_DPC_NIKON_WhiteBalancePresetVal1            0xD026
01220 #define PTP_DPC_NIKON_WhiteBalancePresetVal2            0xD027
01221 #define PTP_DPC_NIKON_WhiteBalancePresetVal3            0xD028
01222 #define PTP_DPC_NIKON_WhiteBalancePresetVal4            0xD029
01223 #define PTP_DPC_NIKON_ImageSharpening                   0xD02A
01224 #define PTP_DPC_NIKON_ToneCompensation                  0xD02B
01225 #define PTP_DPC_NIKON_ColorModel                        0xD02C
01226 #define PTP_DPC_NIKON_HueAdjustment                     0xD02D
01227 #define PTP_DPC_NIKON_NonCPULensDataFocalLength         0xD02E
01228 #define PTP_DPC_NIKON_NonCPULensDataMaximumAperture     0xD02F
01229 #define PTP_DPC_NIKON_JPEG_Compression_Policy           0xD031
01230 #define PTP_DPC_NIKON_ColorSpace                        0xD032
01231 #define PTP_DPC_NIKON_CSMMenuBankSelect                 0xD040
01232 #define PTP_DPC_NIKON_MenuBankNameA                     0xD041
01233 #define PTP_DPC_NIKON_MenuBankNameB                     0xD042
01234 #define PTP_DPC_NIKON_MenuBankNameC                     0xD043
01235 #define PTP_DPC_NIKON_MenuBankNameD                     0xD044
01236 #define PTP_DPC_NIKON_ResetBank                         0xD045
01237 #define PTP_DPC_NIKON_A1AFCModePriority                 0xD048
01238 #define PTP_DPC_NIKON_A2AFSModePriority                 0xD049
01239 #define PTP_DPC_NIKON_A3GroupDynamicAF                  0xD04A
01240 #define PTP_DPC_NIKON_A4AFActivation                    0xD04B
01241 #define PTP_DPC_NIKON_A5FocusAreaIllumManualFocus       0xD04C
01242 #define PTP_DPC_NIKON_FocusAreaIllumContinuous          0xD04D
01243 #define PTP_DPC_NIKON_FocusAreaIllumWhenSelected        0xD04E
01244 #define PTP_DPC_NIKON_FocusAreaWrap                     0xD04F
01245 #define PTP_DPC_NIKON_A7VerticalAFON                    0xD050
01246 #define PTP_DPC_NIKON_AFLockOn                          0xD051
01247 #define PTP_DPC_NIKON_FocusAreaZone                     0xD052
01248 #define PTP_DPC_NIKON_ISOAuto                           0xD054
01249 #define PTP_DPC_NIKON_B2ISOStep                         0xD055 /* EV Step ISO */
01250 #define PTP_DPC_NIKON_EVStep                            0xD056 /* EV Step SS FN */
01251 #define PTP_DPC_NIKON_B4ExposureCompEv                  0xD057 /* EV Step Exposure Compensation */
01252 #define PTP_DPC_NIKON_ExposureCompensation              0xD058
01253 #define PTP_DPC_NIKON_CenterWeightArea                  0xD059
01254 #define PTP_DPC_NIKON_ExposureBaseMatrix                0xD05A
01255 #define PTP_DPC_NIKON_ExposureBaseCenter                0xD05B
01256 #define PTP_DPC_NIKON_ExposureBaseSpot                  0xD05C
01257 #define PTP_DPC_NIKON_AELockMode                        0xD05E
01258 #define PTP_DPC_NIKON_AELAFLMode                        0xD05F
01259 #define PTP_DPC_NIKON_MeterOff                          0xD062
01260 #define PTP_DPC_NIKON_SelfTimer                         0xD063
01261 #define PTP_DPC_NIKON_MonitorOff                        0xD064
01262 #define PTP_DPC_NIKON_D1ShootingSpeed                   0xD068
01263 #define PTP_DPC_NIKON_D2MaximumShots                    0xD069
01264 #define PTP_DPC_NIKON_D3ExpDelayMode                    0xD06A
01265 #define PTP_DPC_NIKON_LongExposureNoiseReduction        0xD06B
01266 #define PTP_DPC_NIKON_FileNumberSequence                0xD06C
01267 #define PTP_DPC_NIKON_D6ControlPanelFinderRearControl   0xD06D
01268 #define PTP_DPC_NIKON_ControlPanelFinderViewfinder      0xD06E
01269 #define PTP_DPC_NIKON_D7Illumination                    0xD06F
01270 #define PTP_DPC_NIKON_NrHighISO                         0xD070
01271 #define PTP_DPC_NIKON_E1FlashSyncSpeed                  0xD074
01272 #define PTP_DPC_NIKON_FlashShutterSpeed                 0xD075  /* SB Low Limit */
01273 #define PTP_DPC_NIKON_E3AAFlashMode                     0xD076
01274 #define PTP_DPC_NIKON_E4ModelingFlash                   0xD077
01275 #define PTP_DPC_NIKON_BracketSet                        0xD078  /* Bracket Type? */
01276 #define PTP_DPC_NIKON_E6ManualModeBracketing            0xD079  /* Bracket Factor? */
01277 #define PTP_DPC_NIKON_BracketOrder                      0xD07A
01278 #define PTP_DPC_NIKON_E8AutoBracketSelection            0xD07B  /* Bracket Method? */
01279 #define PTP_DPC_NIKON_BracketingSet                     0xD07C
01280 #define PTP_DPC_NIKON_F1CenterButtonShootingMode        0xD080
01281 #define PTP_DPC_NIKON_CenterButtonPlaybackMode          0xD081
01282 #define PTP_DPC_NIKON_F2Multiselector                   0xD082
01283 #define PTP_DPC_NIKON_F3PhotoInfoPlayback               0xD083  /* MultiSelector Dir */
01284 #define PTP_DPC_NIKON_F4AssignFuncButton                0xD084  /* CMD Dial Rotate */
01285 #define PTP_DPC_NIKON_F5CustomizeCommDials              0xD085  /* CMD Dial Change */
01286 #define PTP_DPC_NIKON_ReverseCommandDial                0xD086  /* CMD Dial FN Set */
01287 #define PTP_DPC_NIKON_ApertureSetting                   0xD087  /* CMD Dial Active */
01288 #define PTP_DPC_NIKON_MenusAndPlayback                  0xD088  /* Universal Mode */
01289 #define PTP_DPC_NIKON_F6ButtonsAndDials                 0xD089  /* Enable Shutter */
01290 #define PTP_DPC_NIKON_NoCFCard                          0xD08A
01291 #define PTP_DPC_NIKON_CenterButtonZoomRatio             0xD08B
01292 #define PTP_DPC_NIKON_ImageCommentString                0xD090
01293 #define PTP_DPC_NIKON_ImageCommentEnable                0xD091
01294 #define PTP_DPC_NIKON_ImageRotation                     0xD092
01295 #define PTP_DPC_NIKON_Bracketing                        0xD0C0
01296 #define PTP_DPC_NIKON_AutoExposureBracketStep           0xD0C1
01297 #define PTP_DPC_NIKON_AutoExposureBracketProgram        0xD0C2
01298 #define PTP_DPC_NIKON_AutoExposureBracketCount          0xD0C3
01299 #define PTP_DPC_NIKON_WhiteBalanceBracketStep           0xD0C4
01300 #define PTP_DPC_NIKON_WhiteBalanceBracketProgram        0xD0C5
01301 #define PTP_DPC_NIKON_LensID                            0xD0E0
01302 #define PTP_DPC_NIKON_LensSort                          0xD0E1
01303 #define PTP_DPC_NIKON_LensType                          0xD0E2
01304 #define PTP_DPC_NIKON_FocalLengthMin                    0xD0E3
01305 #define PTP_DPC_NIKON_FocalLengthMax                    0xD0E4
01306 #define PTP_DPC_NIKON_MaxApAtMinFocalLength             0xD0E5
01307 #define PTP_DPC_NIKON_MaxApAtMaxFocalLength             0xD0E6
01308 #define PTP_DPC_NIKON_ExposureTime                      0xD100
01309 #define PTP_DPC_NIKON_ACPower                           0xD101
01310 #define PTP_DPC_NIKON_WarningStatus                     0xD102
01311 #define PTP_DPC_NIKON_MaximumShots                      0xD103 /* remain shots (in RAM buffer?) */
01312 #define PTP_DPC_NIKON_AFLockStatus                      0xD104
01313 #define PTP_DPC_NIKON_AELockStatus                      0xD105
01314 #define PTP_DPC_NIKON_FVLockStatus                      0xD106
01315 #define PTP_DPC_NIKON_AutofocusLCDTopMode2              0xD107
01316 #define PTP_DPC_NIKON_AutofocusArea                     0xD108
01317 #define PTP_DPC_NIKON_FlexibleProgram                   0xD109
01318 #define PTP_DPC_NIKON_LightMeter                        0xD10A  /* Exposure Status */
01319 #define PTP_DPC_NIKON_USBSpeed                          0xD10C
01320 #define PTP_DPC_NIKON_CameraOrientation                 0xD10E
01321 #define PTP_DPC_NIKON_GroupPtnType                      0xD10F
01322 #define PTP_DPC_NIKON_ExposureApertureLock              0xD111
01323 #define PTP_DPC_NIKON_ExternalFlashAttached             0xD120
01324 #define PTP_DPC_NIKON_ExternalFlashStatus               0xD121
01325 #define PTP_DPC_NIKON_ExternalFlashSort                 0xD122
01326 #define PTP_DPC_NIKON_ExternalFlashCompensation         0xD124
01327 #define PTP_DPC_NIKON_NewExternalFlashMode              0xD125
01328 #define PTP_DPC_NIKON_FlashExposureCompensation         0xD126
01329 #define PTP_DPC_NIKON_OptimizeImage                     0xD140
01330 #define PTP_DPC_NIKON_Saturation                        0xD142
01331 #define PTP_DPC_NIKON_BW_FillerEffect                   0xD143
01332 #define PTP_DPC_NIKON_BW_Sharpness                      0xD144
01333 #define PTP_DPC_NIKON_BW_Contrast                       0xD145
01334 #define PTP_DPC_NIKON_BW_Setting_Type                   0xD146
01335 #define PTP_DPC_NIKON_BeepOff                           0xD160
01336 #define PTP_DPC_NIKON_AutofocusMode                     0xD161
01337 #define PTP_DPC_NIKON_AFAssist                          0xD163
01338 #define PTP_DPC_NIKON_PADVPMode                         0xD164  /* iso auto time */
01339 #define PTP_DPC_NIKON_ImageReview                       0xD165
01340 #define PTP_DPC_NIKON_AFAreaIllumination                0xD166
01341 #define PTP_DPC_NIKON_FlashMode                         0xD167
01342 #define PTP_DPC_NIKON_FlashCommanderMode                0xD168
01343 #define PTP_DPC_NIKON_FlashSign                         0xD169
01344 #define PTP_DPC_NIKON_ISO_Auto                          0xD16A
01345 #define PTP_DPC_NIKON_RemoteTimeout                     0xD16B
01346 #define PTP_DPC_NIKON_GridDisplay                       0xD16C
01347 #define PTP_DPC_NIKON_FlashModeManualPower              0xD16D
01348 #define PTP_DPC_NIKON_FlashModeCommanderPower           0xD16E
01349 #define PTP_DPC_NIKON_AutoFP                            0xD16F
01350 #define PTP_DPC_NIKON_CSMMenu                           0xD180
01351 #define PTP_DPC_NIKON_WarningDisplay                    0xD181
01352 #define PTP_DPC_NIKON_BatteryCellKind                   0xD182
01353 #define PTP_DPC_NIKON_ISOAutoHiLimit                    0xD183
01354 #define PTP_DPC_NIKON_BracketingFramesAndSteps          0xD190
01355 #define PTP_DPC_NIKON_LowLight                          0xD1B0  /* exp disp status */
01356 #define PTP_DPC_NIKON_ExposureIndicateStatus            0xD1B1  /* exp indicate status */
01357 #define PTP_DPC_NIKON_FlashOpen                         0xD1C0
01358 #define PTP_DPC_NIKON_FlashCharged                      0xD1C1
01359 #define PTP_DPC_NIKON_FlashMRepeatValue                 0xD1D0
01360 #define PTP_DPC_NIKON_FlashMRepeatCount                 0xD1D1
01361 #define PTP_DPC_NIKON_FlashMRepeatInterval              0xD1D2
01362 #define PTP_DPC_NIKON_FlashCommandChannel               0xD1D3
01363 #define PTP_DPC_NIKON_FlashCommandSelfMode              0xD1D4
01364 #define PTP_DPC_NIKON_FlashCommandSelfCompensation      0xD1D5
01365 #define PTP_DPC_NIKON_FlashCommandSelfValue             0xD1D6
01366 #define PTP_DPC_NIKON_FlashCommandAMode                 0xD1D7
01367 #define PTP_DPC_NIKON_FlashCommandACompensation         0xD1D8
01368 #define PTP_DPC_NIKON_FlashCommandAValue                0xD1D9
01369 #define PTP_DPC_NIKON_FlashCommandBMode                 0xD1DA
01370 #define PTP_DPC_NIKON_FlashCommandBCompensation         0xD1DB
01371 #define PTP_DPC_NIKON_FlashCommandBValue                0xD1DC
01372 
01373 /* Microsoft/MTP specific */
01374 #define PTP_DPC_MTP_SecureTime                          0xD101
01375 #define PTP_DPC_MTP_DeviceCertificate                   0xD102
01376 #define PTP_DPC_MTP_RevocationInfo                      0xD103
01377 #define PTP_DPC_MTP_SynchronizationPartner              0xD401
01378 #define PTP_DPC_MTP_DeviceFriendlyName                  0xD402
01379 #define PTP_DPC_MTP_VolumeLevel                         0xD403
01380 #define PTP_DPC_MTP_DeviceIcon                          0xD405
01381 #define PTP_DPC_MTP_PlaybackRate                        0xD410
01382 #define PTP_DPC_MTP_PlaybackObject                      0xD411
01383 #define PTP_DPC_MTP_PlaybackContainerIndex              0xD412
01384 #define PTP_DPC_MTP_PlaybackPosition                    0xD413
01385 #define PTP_DPC_MTP_PlaysForSureID                      0xD131
01386 
01387 /* Zune specific property codes */
01388 #define PTP_DPC_MTP_Zune_UnknownVersion                 0xD181
01389 
01390 /* MTP specific Object Properties */
01391 #define PTP_OPC_StorageID                               0xDC01
01392 #define PTP_OPC_ObjectFormat                            0xDC02
01393 #define PTP_OPC_ProtectionStatus                        0xDC03
01394 #define PTP_OPC_ObjectSize                              0xDC04
01395 #define PTP_OPC_AssociationType                         0xDC05
01396 #define PTP_OPC_AssociationDesc                         0xDC06
01397 #define PTP_OPC_ObjectFileName                          0xDC07
01398 #define PTP_OPC_DateCreated                             0xDC08
01399 #define PTP_OPC_DateModified                            0xDC09
01400 #define PTP_OPC_Keywords                                0xDC0A
01401 #define PTP_OPC_ParentObject                            0xDC0B
01402 #define PTP_OPC_AllowedFolderContents                   0xDC0C
01403 #define PTP_OPC_Hidden                                  0xDC0D
01404 #define PTP_OPC_SystemObject                            0xDC0E
01405 #define PTP_OPC_PersistantUniqueObjectIdentifier        0xDC41
01406 #define PTP_OPC_SyncID                                  0xDC42
01407 #define PTP_OPC_PropertyBag                             0xDC43
01408 #define PTP_OPC_Name                                    0xDC44
01409 #define PTP_OPC_CreatedBy                               0xDC45
01410 #define PTP_OPC_Artist                                  0xDC46
01411 #define PTP_OPC_DateAuthored                            0xDC47
01412 #define PTP_OPC_Description                             0xDC48
01413 #define PTP_OPC_URLReference                            0xDC49
01414 #define PTP_OPC_LanguageLocale                          0xDC4A
01415 #define PTP_OPC_CopyrightInformation                    0xDC4B
01416 #define PTP_OPC_Source                                  0xDC4C
01417 #define PTP_OPC_OriginLocation                          0xDC4D
01418 #define PTP_OPC_DateAdded                               0xDC4E
01419 #define PTP_OPC_NonConsumable                           0xDC4F
01420 #define PTP_OPC_CorruptOrUnplayable                     0xDC50
01421 #define PTP_OPC_ProducerSerialNumber                    0xDC51
01422 #define PTP_OPC_RepresentativeSampleFormat              0xDC81
01423 #define PTP_OPC_RepresentativeSampleSize                0xDC82
01424 #define PTP_OPC_RepresentativeSampleHeight              0xDC83
01425 #define PTP_OPC_RepresentativeSampleWidth               0xDC84
01426 #define PTP_OPC_RepresentativeSampleDuration            0xDC85
01427 #define PTP_OPC_RepresentativeSampleData                0xDC86
01428 #define PTP_OPC_Width                                   0xDC87
01429 #define PTP_OPC_Height                                  0xDC88
01430 #define PTP_OPC_Duration                                0xDC89
01431 #define PTP_OPC_Rating                                  0xDC8A
01432 #define PTP_OPC_Track                                   0xDC8B
01433 #define PTP_OPC_Genre                                   0xDC8C
01434 #define PTP_OPC_Credits                                 0xDC8D
01435 #define PTP_OPC_Lyrics                                  0xDC8E
01436 #define PTP_OPC_SubscriptionContentID                   0xDC8F
01437 #define PTP_OPC_ProducedBy                              0xDC90
01438 #define PTP_OPC_UseCount                                0xDC91
01439 #define PTP_OPC_SkipCount                               0xDC92
01440 #define PTP_OPC_LastAccessed                            0xDC93
01441 #define PTP_OPC_ParentalRating                          0xDC94
01442 #define PTP_OPC_MetaGenre                               0xDC95
01443 #define PTP_OPC_Composer                                0xDC96
01444 #define PTP_OPC_EffectiveRating                         0xDC97
01445 #define PTP_OPC_Subtitle                                0xDC98
01446 #define PTP_OPC_OriginalReleaseDate                     0xDC99
01447 #define PTP_OPC_AlbumName                               0xDC9A
01448 #define PTP_OPC_AlbumArtist                             0xDC9B
01449 #define PTP_OPC_Mood                                    0xDC9C
01450 #define PTP_OPC_DRMStatus                               0xDC9D
01451 #define PTP_OPC_SubDescription                          0xDC9E
01452 #define PTP_OPC_IsCropped                               0xDCD1
01453 #define PTP_OPC_IsColorCorrected                        0xDCD2
01454 #define PTP_OPC_ImageBitDepth                           0xDCD3
01455 #define PTP_OPC_Fnumber                                 0xDCD4
01456 #define PTP_OPC_ExposureTime                            0xDCD5
01457 #define PTP_OPC_ExposureIndex                           0xDCD6
01458 #define PTP_OPC_DisplayName                             0xDCE0
01459 #define PTP_OPC_BodyText                                0xDCE1
01460 #define PTP_OPC_Subject                                 0xDCE2
01461 #define PTP_OPC_Priority                                0xDCE3
01462 #define PTP_OPC_GivenName                               0xDD00
01463 #define PTP_OPC_MiddleNames                             0xDD01
01464 #define PTP_OPC_FamilyName                              0xDD02
01465 #define PTP_OPC_Prefix                                  0xDD03
01466 #define PTP_OPC_Suffix                                  0xDD04
01467 #define PTP_OPC_PhoneticGivenName                       0xDD05
01468 #define PTP_OPC_PhoneticFamilyName                      0xDD06
01469 #define PTP_OPC_EmailPrimary                            0xDD07
01470 #define PTP_OPC_EmailPersonal1                          0xDD08
01471 #define PTP_OPC_EmailPersonal2                          0xDD09
01472 #define PTP_OPC_EmailBusiness1                          0xDD0A
01473 #define PTP_OPC_EmailBusiness2                          0xDD0B
01474 #define PTP_OPC_EmailOthers                             0xDD0C
01475 #define PTP_OPC_PhoneNumberPrimary                      0xDD0D
01476 #define PTP_OPC_PhoneNumberPersonal                     0xDD0E
01477 #define PTP_OPC_PhoneNumberPersonal2                    0xDD0F
01478 #define PTP_OPC_PhoneNumberBusiness                     0xDD10
01479 #define PTP_OPC_PhoneNumberBusiness2                    0xDD11
01480 #define PTP_OPC_PhoneNumberMobile                       0xDD12
01481 #define PTP_OPC_PhoneNumberMobile2                      0xDD13
01482 #define PTP_OPC_FaxNumberPrimary                        0xDD14
01483 #define PTP_OPC_FaxNumberPersonal                       0xDD15
01484 #define PTP_OPC_FaxNumberBusiness                       0xDD16
01485 #define PTP_OPC_PagerNumber                             0xDD17
01486 #define PTP_OPC_PhoneNumberOthers                       0xDD18
01487 #define PTP_OPC_PrimaryWebAddress                       0xDD19
01488 #define PTP_OPC_PersonalWebAddress                      0xDD1A
01489 #define PTP_OPC_BusinessWebAddress                      0xDD1B
01490 #define PTP_OPC_InstantMessengerAddress                 0xDD1C
01491 #define PTP_OPC_InstantMessengerAddress2                0xDD1D
01492 #define PTP_OPC_InstantMessengerAddress3                0xDD1E
01493 #define PTP_OPC_PostalAddressPersonalFull               0xDD1F
01494 #define PTP_OPC_PostalAddressPersonalFullLine1          0xDD20
01495 #define PTP_OPC_PostalAddressPersonalFullLine2          0xDD21
01496 #define PTP_OPC_PostalAddressPersonalFullCity           0xDD22
01497 #define PTP_OPC_PostalAddressPersonalFullRegion         0xDD23
01498 #define PTP_OPC_PostalAddressPersonalFullPostalCode     0xDD24
01499 #define PTP_OPC_PostalAddressPersonalFullCountry        0xDD25
01500 #define PTP_OPC_PostalAddressBusinessFull               0xDD26
01501 #define PTP_OPC_PostalAddressBusinessLine1              0xDD27
01502 #define PTP_OPC_PostalAddressBusinessLine2              0xDD28
01503 #define PTP_OPC_PostalAddressBusinessCity               0xDD29
01504 #define PTP_OPC_PostalAddressBusinessRegion             0xDD2A
01505 #define PTP_OPC_PostalAddressBusinessPostalCode         0xDD2B
01506 #define PTP_OPC_PostalAddressBusinessCountry            0xDD2C
01507 #define PTP_OPC_PostalAddressOtherFull                  0xDD2D
01508 #define PTP_OPC_PostalAddressOtherLine1                 0xDD2E
01509 #define PTP_OPC_PostalAddressOtherLine2                 0xDD2F
01510 #define PTP_OPC_PostalAddressOtherCity                  0xDD30
01511 #define PTP_OPC_PostalAddressOtherRegion                0xDD31
01512 #define PTP_OPC_PostalAddressOtherPostalCode            0xDD32
01513 #define PTP_OPC_PostalAddressOtherCountry               0xDD33
01514 #define PTP_OPC_OrganizationName                        0xDD34
01515 #define PTP_OPC_PhoneticOrganizationName                0xDD35
01516 #define PTP_OPC_Role                                    0xDD36
01517 #define PTP_OPC_Birthdate                               0xDD37
01518 #define PTP_OPC_MessageTo                               0xDD40
01519 #define PTP_OPC_MessageCC                               0xDD41
01520 #define PTP_OPC_MessageBCC                              0xDD42
01521 #define PTP_OPC_MessageRead                             0xDD43
01522 #define PTP_OPC_MessageReceivedTime                     0xDD44
01523 #define PTP_OPC_MessageSender                           0xDD45
01524 #define PTP_OPC_ActivityBeginTime                       0xDD50
01525 #define PTP_OPC_ActivityEndTime                         0xDD51
01526 #define PTP_OPC_ActivityLocation                        0xDD52
01527 #define PTP_OPC_ActivityRequiredAttendees               0xDD54
01528 #define PTP_OPC_ActivityOptionalAttendees               0xDD55
01529 #define PTP_OPC_ActivityResources                       0xDD56
01530 #define PTP_OPC_ActivityAccepted                        0xDD57
01531 #define PTP_OPC_Owner                                   0xDD5D
01532 #define PTP_OPC_Editor                                  0xDD5E
01533 #define PTP_OPC_Webmaster                               0xDD5F
01534 #define PTP_OPC_URLSource                               0xDD60
01535 #define PTP_OPC_URLDestination                          0xDD61
01536 #define PTP_OPC_TimeBookmark                            0xDD62
01537 #define PTP_OPC_ObjectBookmark                          0xDD63
01538 #define PTP_OPC_ByteBookmark                            0xDD64
01539 #define PTP_OPC_LastBuildDate                           0xDD70
01540 #define PTP_OPC_TimetoLive                              0xDD71
01541 #define PTP_OPC_MediaGUID                               0xDD72
01542 #define PTP_OPC_TotalBitRate                            0xDE91
01543 #define PTP_OPC_BitRateType                             0xDE92
01544 #define PTP_OPC_SampleRate                              0xDE93
01545 #define PTP_OPC_NumberOfChannels                        0xDE94
01546 #define PTP_OPC_AudioBitDepth                           0xDE95
01547 #define PTP_OPC_ScanDepth                               0xDE97
01548 #define PTP_OPC_AudioWAVECodec                          0xDE99
01549 #define PTP_OPC_AudioBitRate                            0xDE9A
01550 #define PTP_OPC_VideoFourCCCodec                        0xDE9B
01551 #define PTP_OPC_VideoBitRate                            0xDE9C
01552 #define PTP_OPC_FramesPerThousandSeconds                0xDE9D
01553 #define PTP_OPC_KeyFrameDistance                        0xDE9E
01554 #define PTP_OPC_BufferSize                              0xDE9F
01555 #define PTP_OPC_EncodingQuality                         0xDEA0
01556 #define PTP_OPC_EncodingProfile                         0xDEA1
01557 #define PTP_OPC_BuyFlag                                 0xD901
01558 
01559 /* WiFi Provisioning MTP Extension property codes */
01560 #define PTP_OPC_WirelessConfigurationFile               0xB104
01561 
01562 /* Device Property Form Flag */
01563 
01564 #define PTP_DPFF_None                   0x00
01565 #define PTP_DPFF_Range                  0x01
01566 #define PTP_DPFF_Enumeration            0x02
01567 
01568 /* Object Property Codes used by MTP (first 3 are same as DPFF codes) */
01569 #define PTP_OPFF_None                   0x00
01570 #define PTP_OPFF_Range                  0x01
01571 #define PTP_OPFF_Enumeration            0x02
01572 #define PTP_OPFF_DateTime               0x03
01573 #define PTP_OPFF_FixedLengthArray       0x04
01574 #define PTP_OPFF_RegularExpression      0x05
01575 #define PTP_OPFF_ByteArray              0x06
01576 #define PTP_OPFF_LongString             0xFF
01577 
01578 /* Device Property GetSet type */
01579 #define PTP_DPGS_Get                    0x00
01580 #define PTP_DPGS_GetSet                 0x01
01581 
01582 /* Glue stuff starts here */
01583 
01584 typedef struct _PTPParams PTPParams;
01585 
01586 
01587 typedef uint16_t (* PTPDataGetFunc)     (PTPParams* params, void* private,
01588                                         unsigned long wantlen,
01589                                         unsigned char *data, unsigned long *gotlen);
01590 
01591 typedef uint16_t (* PTPDataPutFunc)     (PTPParams* params, void* private,
01592                                         unsigned long sendlen,
01593                                         unsigned char *data, unsigned long *putlen);
01594 typedef struct _PTPDataHandler {
01595         PTPDataGetFunc          getfunc;
01596         PTPDataPutFunc          putfunc;
01597         void                    *private;
01598 } PTPDataHandler;
01599 
01600 /*
01601  * This functions take PTP oriented arguments and send them over an
01602  * appropriate data layer doing byteorder conversion accordingly.
01603  */
01604 typedef uint16_t (* PTPIOSendReq)       (PTPParams* params, PTPContainer* req);
01605 typedef uint16_t (* PTPIOSendData)      (PTPParams* params, PTPContainer* ptp,
01606                                          unsigned long size, PTPDataHandler*getter);
01607 
01608 typedef uint16_t (* PTPIOGetResp)       (PTPParams* params, PTPContainer* resp);
01609 typedef uint16_t (* PTPIOGetData)       (PTPParams* params, PTPContainer* ptp,
01610                                          PTPDataHandler *putter);
01611 typedef uint16_t (* PTPIOCancelReq)     (PTPParams* params, uint32_t transaction_id);
01612 
01613 /* debug functions */
01614 typedef void (* PTPErrorFunc) (void *data, const char *format, va_list args)
01615 #if (__GNUC__ >= 3)
01616         __attribute__((__format__(printf,2,0)))
01617 #endif
01618 ;
01619 typedef void (* PTPDebugFunc) (void *data, const char *format, va_list args)
01620 #if (__GNUC__ >= 3)
01621         __attribute__((__format__(printf,2,0)))
01622 #endif
01623 ;
01624 
01625 struct _PTPParams {
01626         /* data layer byteorder */
01627         uint8_t         byteorder;
01628         uint16_t        maxpacketsize;
01629 
01630         /* PTP IO: Custom IO functions */
01631         PTPIOSendReq    sendreq_func;
01632         PTPIOSendData   senddata_func;
01633         PTPIOGetResp    getresp_func;
01634         PTPIOGetData    getdata_func;
01635         PTPIOGetResp    event_check;
01636         PTPIOGetResp    event_wait;
01637         PTPIOCancelReq  cancelreq_func;
01638 
01639         /* Custom error and debug function */
01640         PTPErrorFunc    error_func;
01641         PTPDebugFunc    debug_func;
01642 
01643         /* Data passed to above functions */
01644         void            *data;
01645 
01646         /* ptp transaction ID */
01647         uint32_t        transaction_id;
01648         /* ptp session ID */
01649         uint32_t        session_id;
01650 
01651         /* PTP IO: if we have MTP style split header/data transfers */
01652         int             split_header_data;
01653 
01654         /* PTP: MTP specific structure. */
01655         MTPProperties   *props;
01656         int             nrofprops;
01657 
01658         /* PTP: internal structures used by ptp driver */
01659         PTPObjectHandles handles;
01660         PTPObjectInfo   *objectinfo;
01661         PTPDeviceInfo   deviceinfo;
01662 
01663         /* PTP: Canon specific flags list */
01664         uint32_t        *canon_flags; /* size(handles.n) */
01665         PTPCanon_Property       *canon_props;
01666         int                     nrofcanon_props;
01667 
01668         /* PTP: Wifi profiles */
01669         uint8_t         wifi_profiles_version;
01670         uint8_t         wifi_profiles_number;
01671         PTPNIKONWifiProfile *wifi_profiles;
01672 
01673         /* IO: PTP/IP related data */
01674         int             cmdfd, evtfd;
01675         uint8_t         cameraguid[16];
01676         uint32_t        eventpipeid;
01677         char            *cameraname;
01678 
01679         /* PTP: iconv converters */
01680         iconv_t cd_locale_to_ucs2;
01681         iconv_t cd_ucs2_to_locale;
01682 
01683         /* IO: Sometimes the response packet get send in the dataphase
01684          * too. This only happens for a Samsung player now.
01685          */
01686         uint8_t         *response_packet;
01687         uint16_t        response_packet_size;
01688 };
01689 
01690 /* last, but not least - ptp functions */
01691 uint16_t ptp_usb_sendreq        (PTPParams* params, PTPContainer* req);
01692 uint16_t ptp_usb_senddata       (PTPParams* params, PTPContainer* ptp,
01693                                  unsigned long size, PTPDataHandler *handler);
01694 uint16_t ptp_usb_getresp        (PTPParams* params, PTPContainer* resp);
01695 uint16_t ptp_usb_getdata        (PTPParams* params, PTPContainer* ptp, 
01696                                  PTPDataHandler *handler);
01697 uint16_t ptp_usb_event_check    (PTPParams* params, PTPContainer* event);
01698 uint16_t ptp_usb_event_wait     (PTPParams* params, PTPContainer* event);
01699 
01700 uint16_t ptp_usb_control_get_extended_event_data (PTPParams *params, char *buffer, int *size);
01701 uint16_t ptp_usb_control_device_reset_request (PTPParams *params);
01702 uint16_t ptp_usb_control_get_device_status (PTPParams *params, char *buffer, int *size);
01703 uint16_t ptp_usb_control_cancel_request (PTPParams *params, uint32_t transid);
01704 
01705 
01706 int      ptp_ptpip_connect      (PTPParams* params, const char *port);
01707 uint16_t ptp_ptpip_sendreq      (PTPParams* params, PTPContainer* req);
01708 uint16_t ptp_ptpip_senddata     (PTPParams* params, PTPContainer* ptp,
01709                                 unsigned long size, PTPDataHandler *handler);
01710 uint16_t ptp_ptpip_getresp      (PTPParams* params, PTPContainer* resp);
01711 uint16_t ptp_ptpip_getdata      (PTPParams* params, PTPContainer* ptp, 
01712                                  PTPDataHandler *handler);
01713 uint16_t ptp_ptpip_event_wait   (PTPParams* params, PTPContainer* event);
01714 uint16_t ptp_ptpip_event_check  (PTPParams* params, PTPContainer* event);
01715 
01716 uint16_t ptp_getdeviceinfo      (PTPParams* params, PTPDeviceInfo* deviceinfo);
01717 
01718 uint16_t ptp_opensession        (PTPParams *params, uint32_t session);
01719 uint16_t ptp_closesession       (PTPParams *params);
01720 
01721 uint16_t ptp_resetdevice        (PTPParams* params);
01722 uint16_t ptp_getstorageids      (PTPParams* params, PTPStorageIDs* storageids);
01723 uint16_t ptp_getstorageinfo     (PTPParams* params, uint32_t storageid,
01724                                 PTPStorageInfo* storageinfo);
01725 uint16_t ptp_formatstore        (PTPParams* params, uint32_t storageid);
01726 
01727 uint16_t ptp_getobjecthandles   (PTPParams* params, uint32_t storage,
01728                                 uint32_t objectformatcode,
01729                                 uint32_t associationOH,
01730                                 PTPObjectHandles* objecthandles);
01731 
01732 uint16_t ptp_getnumobjects      (PTPParams* params, uint32_t storage,
01733                                 uint32_t objectformatcode,
01734                                 uint32_t associationOH,
01735                                 uint32_t* numobs);
01736 
01737 uint16_t ptp_getobjectinfo      (PTPParams *params, uint32_t handle,
01738                                 PTPObjectInfo* objectinfo);
01739 
01740 uint16_t ptp_getobject          (PTPParams *params, uint32_t handle,
01741                                 unsigned char** object);
01742 uint16_t ptp_getobject_tofd     (PTPParams* params, uint32_t handle, int fd);
01743 uint16_t ptp_getobject_to_handler (PTPParams* params, uint32_t handle, PTPDataHandler*);
01744 uint16_t ptp_getpartialobject   (PTPParams* params, uint32_t handle, uint32_t offset,
01745                                 uint32_t maxbytes, unsigned char** object);
01746 uint16_t ptp_getthumb           (PTPParams *params, uint32_t handle,
01747                                 unsigned char** object);
01748 
01749 uint16_t ptp_deleteobject       (PTPParams* params, uint32_t handle,
01750                                 uint32_t ofc);
01751 
01752 uint16_t ptp_sendobjectinfo     (PTPParams* params, uint32_t* store,
01753                                 uint32_t* parenthandle, uint32_t* handle,
01754                                 PTPObjectInfo* objectinfo);
01755 uint16_t ptp_setobjectprotection (PTPParams* params, uint32_t oid, uint16_t newprot);
01756 uint16_t ptp_sendobject         (PTPParams* params, unsigned char* object,
01757                                  uint32_t size);
01758 uint16_t ptp_sendobject_fromfd  (PTPParams* params, int fd, uint32_t size);
01759 uint16_t ptp_sendobject_from_handler  (PTPParams* params, PTPDataHandler*, uint32_t size);
01760 
01761 uint16_t ptp_initiatecapture    (PTPParams* params, uint32_t storageid,
01762                                 uint32_t ofc);
01763 
01764 uint16_t ptp_getdevicepropdesc  (PTPParams* params, uint16_t propcode,
01765                                 PTPDevicePropDesc *devicepropertydesc);
01766 uint16_t ptp_getdevicepropvalue (PTPParams* params, uint16_t propcode,
01767                                 PTPPropertyValue* value, uint16_t datatype);
01768 uint16_t ptp_setdevicepropvalue (PTPParams* params, uint16_t propcode,
01769                                 PTPPropertyValue* value, uint16_t datatype);
01770 
01771 /* Microsoft MTP extensions */
01772 uint16_t ptp_mtp_getobjectpropdesc (PTPParams* params, uint16_t opc, uint16_t ofc,
01773                                 PTPObjectPropDesc *objectpropertydesc);
01774 uint16_t ptp_mtp_getobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc, 
01775                                 PTPPropertyValue *value, uint16_t datatype);
01776 uint16_t ptp_mtp_setobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc,
01777                                 PTPPropertyValue *value, uint16_t datatype);
01778 uint16_t ptp_mtp_getobjectreferences (PTPParams* params, uint32_t handle, uint32_t** ohArray, uint32_t* arraylen);
01779 uint16_t ptp_mtp_setobjectreferences (PTPParams* params, uint32_t handle, uint32_t* ohArray, uint32_t arraylen);
01780 uint16_t ptp_mtp_getobjectproplist (PTPParams* params, uint32_t handle, MTPProperties **props, int *nrofprops);
01781 uint16_t ptp_mtp_sendobjectproplist (PTPParams* params, uint32_t* store, uint32_t* parenthandle, uint32_t* handle,
01782                                      uint16_t objecttype, uint64_t objectsize, MTPProperties *props, int nrofprops);
01783 uint16_t ptp_mtp_setobjectproplist (PTPParams* params, MTPProperties *props, int nrofprops);
01784 
01785 /* Eastman Kodak extensions */
01786 uint16_t ptp_ek_9007 (PTPParams* params, unsigned char **serial, unsigned int *size);
01787 uint16_t ptp_ek_9009 (PTPParams* params, uint32_t*, uint32_t*);
01788 uint16_t ptp_ek_900c (PTPParams* params, unsigned char **serial, unsigned int *size);
01789 uint16_t ptp_ek_getserial (PTPParams* params, unsigned char **serial, unsigned int *size);
01790 uint16_t ptp_ek_setserial (PTPParams* params, unsigned char *serial, uint32_t size);
01791 uint16_t ptp_ek_settext (PTPParams* params, PTPEKTextParams *text);
01792 uint16_t ptp_ek_sendfileobjectinfo (PTPParams* params, uint32_t* store,
01793                                 uint32_t* parenthandle, uint32_t* handle,
01794                                 PTPObjectInfo* objectinfo);
01795 uint16_t ptp_ek_sendfileobject  (PTPParams* params, unsigned char* object,
01796                                 uint32_t size);
01797 uint16_t ptp_ek_sendfileobject_from_handler     (PTPParams* params, PTPDataHandler*,
01798                                 uint32_t size);
01799 
01800 /* Canon PTP extensions */
01801 uint16_t ptp_canon_9012 (PTPParams* params);
01802 uint16_t ptp_canon_gettreeinfo (PTPParams* params, uint32_t* out);
01803 uint16_t ptp_canon_gettreesize (PTPParams* params, PTPCanon_directtransfer_entry**, unsigned int*cnt);
01804 uint16_t ptp_canon_getpartialobjectinfo (PTPParams* params, uint32_t handle,
01805                                 uint32_t p2, uint32_t* size, uint32_t* rp2);
01806 
01807 uint16_t ptp_canon_get_mac_address (PTPParams* params, unsigned char **mac);
01808 uint16_t ptp_canon_startshootingmode (PTPParams* params);
01809 uint16_t ptp_canon_endshootingmode (PTPParams* params);
01810 
01811 uint16_t ptp_canon_viewfinderon (PTPParams* params);
01812 uint16_t ptp_canon_viewfinderoff (PTPParams* params);
01813 
01814 #define PTP_CANON_RESET_AE      0x1
01815 #define PTP_CANON_RESET_AF      0x2
01816 #define PTP_CANON_RESET_AWB     0x4
01817 uint16_t ptp_canon_reset_aeafawb (PTPParams* params, uint32_t flags);
01818 uint16_t ptp_canon_checkevent (PTPParams* params, 
01819                                 PTPUSBEventContainer* event, int* isevent);
01820 uint16_t ptp_canon_focuslock (PTPParams* params);
01821 uint16_t ptp_canon_focusunlock (PTPParams* params);
01822 uint16_t ptp_canon_keepdeviceon (PTPParams* params);
01823 uint16_t ptp_canon_initiatecaptureinmemory (PTPParams* params);
01824 uint16_t ptp_canon_eos_capture (PTPParams* params);
01825 uint16_t ptp_canon_eos_getevent (PTPParams* params, PTPCanon_changes_entry **entries, int *nrofentries);
01826 uint16_t ptp_canon_getpartialobject (PTPParams* params, uint32_t handle, 
01827                                 uint32_t offset, uint32_t size,
01828                                 uint32_t pos, unsigned char** block, 
01829                                 uint32_t* readnum);
01830 uint16_t ptp_canon_getviewfinderimage (PTPParams* params, unsigned char** image,
01831                                 uint32_t* size);
01832 uint16_t ptp_canon_getchanges (PTPParams* params, uint16_t** props,
01833                                 uint32_t* propnum); 
01834 uint16_t ptp_canon_getobjectinfo (PTPParams* params, uint32_t store,
01835                                 uint32_t p2, uint32_t parenthandle,
01836                                 uint32_t handle, 
01837                                 PTPCANONFolderEntry** entries,
01838                                 uint32_t* entnum);
01839 uint16_t ptp_canon_eos_getdeviceinfo (PTPParams* params, unsigned char**di, unsigned long *len );
01840 uint16_t ptp_canon_get_objecthandle_by_name (PTPParams* params, char* name, uint32_t* objectid);
01841 uint16_t ptp_canon_get_directory (PTPParams* params, PTPObjectHandles *handles, PTPObjectInfo **oinfos, uint32_t **flags);
01842 uint16_t ptp_canon_setobjectarchive (PTPParams* params, uint32_t oid, uint32_t flags);
01843 uint16_t ptp_canon_get_customize_data (PTPParams* params, uint32_t themenr,
01844                                 unsigned char **data, unsigned int *size);
01845 uint16_t ptp_canon_getpairinginfo (PTPParams* params, uint32_t nr, unsigned char**, unsigned int*);
01846 
01847 uint16_t ptp_canon_eos_getstorageids (PTPParams* params, PTPStorageIDs* storageids);
01848 uint16_t ptp_canon_eos_getstorageinfo (PTPParams* params, uint32_t p1);
01849 uint16_t ptp_canon_eos_getpartialobject (PTPParams* params, uint32_t oid, uint32_t off, uint32_t xsize, unsigned char**data);
01850 uint16_t ptp_canon_eos_setdevicepropvalueex (PTPParams* params, unsigned char* data, unsigned int size);
01851 uint16_t ptp_canon_eos_setremotemode (PTPParams* params, uint32_t p1);
01852 uint16_t ptp_canon_eos_seteventmode (PTPParams* params, uint32_t p1);
01853 uint16_t ptp_canon_eos_transfercomplete (PTPParams* params, uint32_t oid);
01854 uint16_t ptp_canon_eos_pchddcapacity (PTPParams* params, uint32_t p1, uint32_t p2, uint32_t p3);
01855 uint16_t ptp_canon_eos_getdevicepropdesc (PTPParams* params, uint16_t propcode,
01856                                 PTPDevicePropDesc *devicepropertydesc);
01857 uint16_t ptp_canon_eos_setdevicepropvalue (PTPParams* params, uint16_t propcode,
01858                                 PTPPropertyValue* value, uint16_t datatype);
01859 
01860 uint16_t ptp_nikon_curve_download (PTPParams* params, 
01861                                 unsigned char **data, unsigned int *size);
01862 uint16_t ptp_nikon_getptpipinfo (PTPParams* params, unsigned char **data, unsigned int *size);
01863 uint16_t ptp_nikon_getwifiprofilelist (PTPParams* params);
01864 uint16_t ptp_nikon_writewifiprofile (PTPParams* params, PTPNIKONWifiProfile* profile);
01865 uint16_t ptp_nikon_deletewifiprofile (PTPParams* params, uint32_t profilenr);
01866 uint16_t ptp_nikon_setcontrolmode (PTPParams* params, uint32_t mode);
01867 uint16_t ptp_nikon_afdrive (PTPParams* params);
01868 uint16_t ptp_nikon_capture (PTPParams* params, uint32_t x);
01869 uint16_t ptp_nikon_capture_sdram (PTPParams* params);
01870 uint16_t ptp_nikon_check_event (PTPParams* params, PTPUSBEventContainer **evt, int *evtcnt);
01871 uint16_t ptp_nikon_getfileinfoinblock (PTPParams* params, uint32_t p1, uint32_t p2, uint32_t p3,
01872                                         unsigned char **data, unsigned int *size);
01873 uint16_t ptp_nikon_device_ready (PTPParams* params);
01874 uint16_t ptp_mtp_getobjectpropssupported (PTPParams* params, uint16_t ofc, uint32_t *propnum, uint16_t **props);
01875 
01876 /* Non PTP protocol functions */
01877 int ptp_operation_issupported   (PTPParams* params, uint16_t operation);
01878 int ptp_event_issupported       (PTPParams* params, uint16_t event);
01879 int ptp_property_issupported    (PTPParams* params, uint16_t property);
01880 
01881 void ptp_free_devicepropdesc    (PTPDevicePropDesc* dpd);
01882 void ptp_free_devicepropvalue   (uint16_t dt, PTPPropertyValue* dpd);
01883 void ptp_free_objectpropdesc    (PTPObjectPropDesc* dpd);
01884 void ptp_free_params            (PTPParams *params);
01885 void ptp_free_objectinfo        (PTPObjectInfo *oi);
01886 
01887 
01888 void ptp_perror                 (PTPParams* params, uint16_t error);
01889 
01890 const char*
01891 ptp_get_property_description(PTPParams* params, uint16_t dpc);
01892 
01893 int
01894 ptp_render_property_value(PTPParams* params, uint16_t dpc,
01895                           PTPDevicePropDesc *dpd, int length, char *out);
01896 int ptp_render_ofc(PTPParams* params, uint16_t ofc, int spaceleft, char *txt);
01897 int ptp_render_opcode(PTPParams* params, uint16_t opcode, int spaceleft, char *txt);
01898 int ptp_render_mtp_propname(uint16_t propid, int spaceleft, char *txt);
01899 MTPProperties *ptp_get_new_object_prop_entry(MTPProperties **props, int *nrofprops);
01900 void ptp_destroy_object_prop(MTPProperties *prop);
01901 void ptp_destroy_object_prop_list(MTPProperties *props, int nrofprops);
01902 MTPProperties *ptp_find_object_prop_in_cache(PTPParams *params, uint32_t const handle, uint32_t const attribute_id);
01903 void ptp_remove_object_from_cache(PTPParams *params, uint32_t handle);
01904 uint16_t ptp_add_object_to_cache(PTPParams *params, uint32_t handle);
01905 
01906 /* ptpip.c */
01907 void ptp_nikon_getptpipguid (unsigned char* guid);
01908 
01909 #ifdef __cplusplus
01910 }
01911 #endif /* __cplusplus */
01912 
01913 #endif /* __PTP_H__ */

Generated on Sun Aug 23 04:57:22 2009 for libmtp by  doxygen 1.5.8