libmtp: /tmp/libmtp-0.3.3/src/ptp.h Source File

# ptp.h

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