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

- Main Page
- Modules
- Data Structures
- Files
- Directories
- Examples

- File List
- Globals

# ptp.h

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