1 /* ptp.h 2 * 3 * Copyright (C) 2001 Mariusz Woloszyn <emsi@ipartners.pl> 4 * Copyright (C) 2003-2009 Marcus Meissner <marcus@jet.franken.de> 5 * Copyright (C) 2006-2008 Linus Walleij <triad@df.lth.se> 6 * 7 * This library is free software; you can redistribute it and/or 8 * modify it under the terms of the GNU Lesser General Public 9 * License as published by the Free Software Foundation; either 10 * version 2 of the License, or (at your option) any later version. 11 * 12 * This library is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this library; if not, write to the 19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, 20 * Boston, MA 02111-1307, USA. 21 */ 22 23 #ifndef __PTP_H__ 24 #define __PTP_H__ 25 26 #include <stdarg.h> 27 #include <time.h> 28 #ifdef HAVE_ICONV 29 #include <iconv.h> 30 #endif 31 #include "gphoto2-endian.h" 32 #include "device-flags.h" 33 34 #ifdef __cplusplus 35 extern "C" { 36 #endif /* __cplusplus */ 37 38 /* PTP datalayer byteorder */ 39 40 #define PTP_DL_BE 0xF0 41 #define PTP_DL_LE 0x0F 42 43 /* USB interface class */ 44 #ifndef USB_CLASS_PTP 45 #define USB_CLASS_PTP 6 46 #endif 47 48 /* PTP request/response/event general PTP container (transport independent) */ 49 50 struct _PTPContainer { 51 uint16_t Code; 52 uint32_t SessionID; 53 uint32_t Transaction_ID; 54 /* params may be of any type of size less or equal to uint32_t */ 55 uint32_t Param1; 56 uint32_t Param2; 57 uint32_t Param3; 58 /* events can only have three parameters */ 59 uint32_t Param4; 60 uint32_t Param5; 61 /* the number of meaningfull parameters */ 62 uint8_t Nparam; 63 }; 64 typedef struct _PTPContainer PTPContainer; 65 66 /* PTP USB Bulk-Pipe container */ 67 /* USB bulk max packet length for high speed endpoints */ 68 /* The max packet is set to 512 bytes. The spec says 69 * "end of data transfers are signaled by short packets or NULL 70 * packets". It never says anything about 512, but current 71 * implementations seem to have chosen this value, which also 72 * happens to be the size of an USB 2.0 HS endpoint, even though 73 * this is not necessary. 74 * 75 * Previously we had this as 4096 for MTP devices. We have found 76 * and fixed the bugs that made this necessary and it can be 512 again. 77 */ 78 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE 512 79 #define PTP_USB_BULK_HS_MAX_PACKET_LEN_READ 512 80 #define PTP_USB_BULK_HDR_LEN (2*sizeof(uint32_t)+2*sizeof(uint16_t)) 81 #define PTP_USB_BULK_PAYLOAD_LEN_WRITE (PTP_USB_BULK_HS_MAX_PACKET_LEN_WRITE-PTP_USB_BULK_HDR_LEN) 82 #define PTP_USB_BULK_PAYLOAD_LEN_READ (PTP_USB_BULK_HS_MAX_PACKET_LEN_READ-PTP_USB_BULK_HDR_LEN) 83 #define PTP_USB_BULK_REQ_LEN (PTP_USB_BULK_HDR_LEN+5*sizeof(uint32_t)) 84 85 struct _PTPUSBBulkContainer { 86 uint32_t length; 87 uint16_t type; 88 uint16_t code; 89 uint32_t trans_id; 90 union { 91 struct { 92 uint32_t param1; 93 uint32_t param2; 94 uint32_t param3; 95 uint32_t param4; 96 uint32_t param5; 97 } params; 98 /* this must be set to the maximum of PTP_USB_BULK_PAYLOAD_LEN_WRITE 99 * and PTP_USB_BULK_PAYLOAD_LEN_READ */ 100 unsigned char data[PTP_USB_BULK_PAYLOAD_LEN_READ]; 101 } payload; 102 }; 103 typedef struct _PTPUSBBulkContainer PTPUSBBulkContainer; 104 105 /* PTP USB Asynchronous Event Interrupt Data Format */ 106 struct _PTPUSBEventContainer { 107 uint32_t length; 108 uint16_t type; 109 uint16_t code; 110 uint32_t trans_id; 111 uint32_t param1; 112 uint32_t param2; 113 uint32_t param3; 114 }; 115 typedef struct _PTPUSBEventContainer PTPUSBEventContainer; 116 117 struct _PTPCanon_directtransfer_entry { 118 uint32_t oid; 119 char *str; 120 }; 121 typedef struct _PTPCanon_directtransfer_entry PTPCanon_directtransfer_entry; 122 123 /* USB container types */ 124 125 #define PTP_USB_CONTAINER_UNDEFINED 0x0000 126 #define PTP_USB_CONTAINER_COMMAND 0x0001 127 #define PTP_USB_CONTAINER_DATA 0x0002 128 #define PTP_USB_CONTAINER_RESPONSE 0x0003 129 #define PTP_USB_CONTAINER_EVENT 0x0004 130 131 /* PTP/IP definitions */ 132 #define PTPIP_INIT_COMMAND_REQUEST 1 133 #define PTPIP_INIT_COMMAND_ACK 2 134 #define PTPIP_INIT_EVENT_REQUEST 3 135 #define PTPIP_INIT_EVENT_ACK 4 136 #define PTPIP_INIT_FAIL 5 137 #define PTPIP_CMD_REQUEST 6 138 #define PTPIP_CMD_RESPONSE 7 139 #define PTPIP_EVENT 8 140 #define PTPIP_START_DATA_PACKET 9 141 #define PTPIP_DATA_PACKET 10 142 #define PTPIP_CANCEL_TRANSACTION 11 143 #define PTPIP_END_DATA_PACKET 12 144 #define PTPIP_PING 13 145 #define PTPIP_PONG 14 146 147 struct _PTPIPHeader { 148 uint32_t length; 149 uint32_t type; 150 }; 151 typedef struct _PTPIPHeader PTPIPHeader; 152 153 /* Vendor IDs */ 154 #define PTP_VENDOR_EASTMAN_KODAK 0x00000001 155 #define PTP_VENDOR_SEIKO_EPSON 0x00000002 156 #define PTP_VENDOR_AGILENT 0x00000003 157 #define PTP_VENDOR_POLAROID 0x00000004 158 #define PTP_VENDOR_AGFA_GEVAERT 0x00000005 159 #define PTP_VENDOR_MICROSOFT 0x00000006 160 #define PTP_VENDOR_EQUINOX 0x00000007 161 #define PTP_VENDOR_VIEWQUEST 0x00000008 162 #define PTP_VENDOR_STMICROELECTRONICS 0x00000009 163 #define PTP_VENDOR_NIKON 0x0000000A 164 #define PTP_VENDOR_CANON 0x0000000B 165 166 /* Vendor extension ID used for MTP */ 167 #define PTP_VENDOR_MTP 0xffffffff 168 169 /* Operation Codes */ 170 171 /* PTP v1.0 operation codes */ 172 #define PTP_OC_Undefined 0x1000 173 #define PTP_OC_GetDeviceInfo 0x1001 174 #define PTP_OC_OpenSession 0x1002 175 #define PTP_OC_CloseSession 0x1003 176 #define PTP_OC_GetStorageIDs 0x1004 177 #define PTP_OC_GetStorageInfo 0x1005 178 #define PTP_OC_GetNumObjects 0x1006 179 #define PTP_OC_GetObjectHandles 0x1007 180 #define PTP_OC_GetObjectInfo 0x1008 181 #define PTP_OC_GetObject 0x1009 182 #define PTP_OC_GetThumb 0x100A 183 #define PTP_OC_DeleteObject 0x100B 184 #define PTP_OC_SendObjectInfo 0x100C 185 #define PTP_OC_SendObject 0x100D 186 #define PTP_OC_InitiateCapture 0x100E 187 #define PTP_OC_FormatStore 0x100F 188 #define PTP_OC_ResetDevice 0x1010 189 #define PTP_OC_SelfTest 0x1011 190 #define PTP_OC_SetObjectProtection 0x1012 191 #define PTP_OC_PowerDown 0x1013 192 #define PTP_OC_GetDevicePropDesc 0x1014 193 #define PTP_OC_GetDevicePropValue 0x1015 194 #define PTP_OC_SetDevicePropValue 0x1016 195 #define PTP_OC_ResetDevicePropValue 0x1017 196 #define PTP_OC_TerminateOpenCapture 0x1018 197 #define PTP_OC_MoveObject 0x1019 198 #define PTP_OC_CopyObject 0x101A 199 #define PTP_OC_GetPartialObject 0x101B 200 #define PTP_OC_InitiateOpenCapture 0x101C 201 /* PTP v1.1 operation codes */ 202 #define PTP_OC_StartEnumHandles 0x101D 203 #define PTP_OC_EnumHandles 0x101E 204 #define PTP_OC_StopEnumHandles 0x101F 205 #define PTP_OC_GetVendorExtensionMaps 0x1020 206 #define PTP_OC_GetVendorDeviceInfo 0x1021 207 #define PTP_OC_GetResizedImageObject 0x1022 208 #define PTP_OC_GetFilesystemManifest 0x1023 209 #define PTP_OC_GetStreamInfo 0x1024 210 #define PTP_OC_GetStream 0x1025 211 212 /* Eastman Kodak extension Operation Codes */ 213 #define PTP_OC_EK_GetSerial 0x9003 214 #define PTP_OC_EK_SetSerial 0x9004 215 #define PTP_OC_EK_SendFileObjectInfo 0x9005 216 #define PTP_OC_EK_SendFileObject 0x9006 217 #define PTP_OC_EK_SetText 0x9008 218 219 /* Canon extension Operation Codes */ 220 #define PTP_OC_CANON_GetPartialObjectInfo 0x9001 221 /* 9002 - sends 2 uint32, nothing back */ 222 #define PTP_OC_CANON_SetObjectArchive 0x9002 223 #define PTP_OC_CANON_KeepDeviceOn 0x9003 224 #define PTP_OC_CANON_LockDeviceUI 0x9004 225 #define PTP_OC_CANON_UnlockDeviceUI 0x9005 226 #define PTP_OC_CANON_GetObjectHandleByName 0x9006 227 /* no 9007 observed yet */ 228 #define PTP_OC_CANON_InitiateReleaseControl 0x9008 229 #define PTP_OC_CANON_TerminateReleaseControl 0x9009 230 #define PTP_OC_CANON_TerminatePlaybackMode 0x900A 231 #define PTP_OC_CANON_ViewfinderOn 0x900B 232 #define PTP_OC_CANON_ViewfinderOff 0x900C 233 #define PTP_OC_CANON_DoAeAfAwb 0x900D 234 235 /* 900e - send nothing, gets 5 uint16t in 32bit entities back in 20byte datablob */ 236 #define PTP_OC_CANON_GetCustomizeSpec 0x900E 237 #define PTP_OC_CANON_GetCustomizeItemInfo 0x900F 238 #define PTP_OC_CANON_GetCustomizeData 0x9010 239 #define PTP_OC_CANON_SetCustomizeData 0x9011 240 #define PTP_OC_CANON_GetCaptureStatus 0x9012 241 #define PTP_OC_CANON_CheckEvent 0x9013 242 #define PTP_OC_CANON_FocusLock 0x9014 243 #define PTP_OC_CANON_FocusUnlock 0x9015 244 #define PTP_OC_CANON_GetLocalReleaseParam 0x9016 245 #define PTP_OC_CANON_SetLocalReleaseParam 0x9017 246 #define PTP_OC_CANON_AskAboutPcEvf 0x9018 247 #define PTP_OC_CANON_SendPartialObject 0x9019 248 #define PTP_OC_CANON_InitiateCaptureInMemory 0x901A 249 #define PTP_OC_CANON_GetPartialObjectEx 0x901B 250 #define PTP_OC_CANON_SetObjectTime 0x901C 251 #define PTP_OC_CANON_GetViewfinderImage 0x901D 252 #define PTP_OC_CANON_GetObjectAttributes 0x901E 253 #define PTP_OC_CANON_ChangeUSBProtocol 0x901F 254 #define PTP_OC_CANON_GetChanges 0x9020 255 #define PTP_OC_CANON_GetObjectInfoEx 0x9021 256 #define PTP_OC_CANON_InitiateDirectTransfer 0x9022 257 #define PTP_OC_CANON_TerminateDirectTransfer 0x9023 258 #define PTP_OC_CANON_SendObjectInfoByPath 0x9024 259 #define PTP_OC_CANON_SendObjectByPath 0x9025 260 #define PTP_OC_CANON_InitiateDirectTansferEx 0x9026 261 #define PTP_OC_CANON_GetAncillaryObjectHandles 0x9027 262 #define PTP_OC_CANON_GetTreeInfo 0x9028 263 #define PTP_OC_CANON_GetTreeSize 0x9029 264 #define PTP_OC_CANON_NotifyProgress 0x902A 265 #define PTP_OC_CANON_NotifyCancelAccepted 0x902B 266 /* 902c: no parms, read 3 uint32 in data, no response parms */ 267 #define PTP_OC_CANON_902C 0x902C 268 #define PTP_OC_CANON_GetDirectory 0x902D 269 270 #define PTP_OC_CANON_SetPairingInfo 0x9030 271 #define PTP_OC_CANON_GetPairingInfo 0x9031 272 #define PTP_OC_CANON_DeletePairingInfo 0x9032 273 #define PTP_OC_CANON_GetMACAddress 0x9033 274 /* 9034: 1 param, no parms returned */ 275 #define PTP_OC_CANON_SetDisplayMonitor 0x9034 276 #define PTP_OC_CANON_PairingComplete 0x9035 277 #define PTP_OC_CANON_GetWirelessMAXChannel 0x9036 278 279 /* 9101: no args, 8 byte data (01 00 00 00 00 00 00 00), no resp data. */ 280 #define PTP_OC_CANON_EOS_GetStorageIDs 0x9101 281 /* 9102: 1 arg (0) 282 * 0x28 bytes of data: 283 00000000: 34 00 00 00 02 00 02 91 0a 00 00 00 04 00 03 00 284 00000010: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 285 00000020: 00 00 ff ff ff ff 03 43 00 46 00 00 00 03 41 00 286 00000030: 3a 00 00 00 287 * no resp args 288 */ 289 #define PTP_OC_CANON_EOS_GetStorageInfo 0x9102 290 #define PTP_OC_CANON_EOS_GetObjectInfo 0x9103 291 #define PTP_OC_CANON_EOS_GetObject 0x9104 292 #define PTP_OC_CANON_EOS_DeleteObject 0x9105 293 #define PTP_OC_CANON_EOS_FormatStore 0x9106 294 #define PTP_OC_CANON_EOS_GetPartialObject 0x9107 295 #define PTP_OC_CANON_EOS_GetDeviceInfoEx 0x9108 296 297 /* sample1: 298 * 3 cmdargs: 1,0xffffffff,00 00 10 00; 299 * data: 300 00000000: 48 00 00 00 02 00 09 91 12 00 00 00 01 00 00 00 301 00000010: 38 00 00 00 00 00 00 30 01 00 00 00 01 30 00 00 302 00000020: 01 00 00 00 10 00 00 00 00 00 00 00 00 00 00 20 303 00000030: 00 00 00 30 44 43 49 4d 00 00 00 00 00 00 00 00 DCIM 304 00000040: 00 00 00 00 cc c3 01 46 305 * 2 respargs: 0x0, 0x3c 306 * 307 * sample2: 308 * 309 00000000: 18 00 00 00 01 00 09 91 15 00 00 00 01 00 00 00 310 00000010: 00 00 00 30 00 00 10 00 311 312 00000000: 48 00 00 00 02 00 09 91 15 00 00 00 01 00 00 00 313 00000010: 38 00 00 00 00 00 9c 33 01 00 00 00 01 30 00 00 314 00000020: 01 00 00 00 10 00 00 00 00 00 00 00 00 00 00 30 315 00000030: 00 00 9c 33 32 33 31 43 41 4e 4f 4e 00 00 00 00 231CANON 316 00000040: 00 00 00 00 cc c3 01 46 317 318 */ 319 #define PTP_OC_CANON_EOS_GetObjectInfoEx 0x9109 320 #define PTP_OC_CANON_EOS_GetThumbEx 0x910A 321 #define PTP_OC_CANON_EOS_SendPartialObject 0x910B 322 #define PTP_OC_CANON_EOS_SetObjectAttributes 0x910C 323 #define PTP_OC_CANON_EOS_GetObjectTime 0x910D 324 #define PTP_OC_CANON_EOS_SetObjectTime 0x910E 325 326 /* 910f: no args, no data, 1 response arg (0). */ 327 #define PTP_OC_CANON_EOS_RemoteRelease 0x910F 328 /* Marcus: looks more like "Set DeviceProperty" in the trace. 329 * 330 * no cmd args 331 * data phase (0xc, 0xd11c, 0x1) 332 * no resp args 333 */ 334 #define PTP_OC_CANON_EOS_SetDevicePropValueEx 0x9110 335 #define PTP_OC_CANON_EOS_GetRemoteMode 0x9113 336 /* 9114: 1 arg (0x1), no data, no resp data. */ 337 #define PTP_OC_CANON_EOS_SetRemoteMode 0x9114 338 /* 9115: 1 arg (0x1), no data, no resp data. */ 339 #define PTP_OC_CANON_EOS_SetEventMode 0x9115 340 /* 9116: no args, data phase, no resp data. */ 341 #define PTP_OC_CANON_EOS_GetEvent 0x9116 342 #define PTP_OC_CANON_EOS_TransferComplete 0x9117 343 #define PTP_OC_CANON_EOS_CancelTransfer 0x9118 344 #define PTP_OC_CANON_EOS_ResetTransfer 0x9119 345 346 /* 911a: 3 args (0xfffffff7, 0x00001000, 0x00000001), no data, no resp data. */ 347 /* 911a: 3 args (0x001dfc60, 0x00001000, 0x00000001), no data, no resp data. */ 348 #define PTP_OC_CANON_EOS_PCHDDCapacity 0x911A 349 350 /* 911b: no cmd args, no data, no resp args */ 351 #define PTP_OC_CANON_EOS_SetUILock 0x911B 352 /* 911c: no cmd args, no data, no resp args */ 353 #define PTP_OC_CANON_EOS_ResetUILock 0x911C 354 #define PTP_OC_CANON_EOS_KeepDeviceOn 0x911D 355 #define PTP_OC_CANON_EOS_SetNullPacketMode 0x911E 356 #define PTP_OC_CANON_EOS_UpdateFirmware 0x911F 357 #define PTP_OC_CANON_EOS_TransferCompleteDT 0x9120 358 #define PTP_OC_CANON_EOS_CancelTransferDT 0x9121 359 #define PTP_OC_CANON_EOS_SetWftProfile 0x9122 360 #define PTP_OC_CANON_EOS_GetWftProfile 0x9122 361 #define PTP_OC_CANON_EOS_SetProfileToWft 0x9124 362 #define PTP_OC_CANON_EOS_BulbStart 0x9125 363 #define PTP_OC_CANON_EOS_BulbEnd 0x9126 364 #define PTP_OC_CANON_EOS_RequestDevicePropValue 0x9127 365 366 /* 0x9128 args (0x1/0x2, 0x0), no data, no resp args */ 367 #define PTP_OC_CANON_EOS_RemoteReleaseOn 0x9128 368 /* 0x9129 args (0x1/0x2), no data, no resp args */ 369 #define PTP_OC_CANON_EOS_RemoteReleaseOff 0x9129 370 371 #define PTP_OC_CANON_EOS_InitiateViewfinder 0x9151 372 #define PTP_OC_CANON_EOS_TerminateViewfinder 0x9152 373 #define PTP_OC_CANON_EOS_GetViewFinderData 0x9153 374 #define PTP_OC_CANON_EOS_DoAf 0x9154 375 #define PTP_OC_CANON_EOS_DriveLens 0x9155 376 #define PTP_OC_CANON_EOS_DepthOfFieldPreview 0x9156 377 #define PTP_OC_CANON_EOS_ClickWB 0x9157 378 #define PTP_OC_CANON_EOS_Zoom 0x9158 379 #define PTP_OC_CANON_EOS_ZoomPosition 0x9159 380 #define PTP_OC_CANON_EOS_SetLiveAfFrame 0x915a 381 #define PTP_OC_CANON_EOS_AfCancel 0x9160 382 #define PTP_OC_CANON_EOS_FAPIMessageTX 0x91FE 383 #define PTP_OC_CANON_EOS_FAPIMessageRX 0x91FF 384 385 /* Nikon extension Operation Codes */ 386 #define PTP_OC_NIKON_GetProfileAllData 0x9006 387 #define PTP_OC_NIKON_SendProfileData 0x9007 388 #define PTP_OC_NIKON_DeleteProfile 0x9008 389 #define PTP_OC_NIKON_SetProfileData 0x9009 390 #define PTP_OC_NIKON_AdvancedTransfer 0x9010 391 #define PTP_OC_NIKON_GetFileInfoInBlock 0x9011 392 #define PTP_OC_NIKON_Capture 0x90C0 /* 1 param, no data */ 393 #define PTP_OC_NIKON_AfDrive 0x90C1 /* no params, no data */ 394 #define PTP_OC_NIKON_SetControlMode 0x90C2 /* 1 param, no data */ 395 #define PTP_OC_NIKON_DelImageSDRAM 0x90C3 /* no params, no data */ 396 #define PTP_OC_NIKON_GetLargeThumb 0x90C4 397 #define PTP_OC_NIKON_CurveDownload 0x90C5 /* 1 param, data in */ 398 #define PTP_OC_NIKON_CurveUpload 0x90C6 /* 1 param, data out */ 399 #define PTP_OC_NIKON_CheckEvent 0x90C7 /* no params, data in */ 400 #define PTP_OC_NIKON_DeviceReady 0x90C8 /* no params, no data */ 401 #define PTP_OC_NIKON_SetPreWBData 0x90C9 /* 3 params, data out */ 402 #define PTP_OC_NIKON_GetVendorPropCodes 0x90CA /* 0 params, data in */ 403 #define PTP_OC_NIKON_AfCaptureSDRAM 0x90CB /* no params, no data */ 404 #define PTP_OC_NIKON_GetPictCtrlData 0x90CC 405 #define PTP_OC_NIKON_SetPictCtrlData 0x90CD 406 #define PTP_OC_NIKON_DelCstPicCtrl 0x90CE 407 #define PTP_OC_NIKON_GetPicCtrlCapability 0x90CF 408 409 /* Nikon Liveview stuff */ 410 #define PTP_OC_NIKON_GetPreviewImg 0x9200 411 #define PTP_OC_NIKON_StartLiveView 0x9201 412 #define PTP_OC_NIKON_EndLiveView 0x9202 413 #define PTP_OC_NIKON_GetLiveViewImg 0x9203 414 #define PTP_OC_NIKON_MfDrive 0x9204 415 #define PTP_OC_NIKON_ChangeAfArea 0x9205 416 #define PTP_OC_NIKON_AfDriveCancel 0x9206 417 418 #define PTP_OC_NIKON_GetDevicePTPIPInfo 0x90E0 419 420 /* Microsoft / MTP extension codes */ 421 422 #define PTP_OC_MTP_GetObjectPropsSupported 0x9801 423 #define PTP_OC_MTP_GetObjectPropDesc 0x9802 424 #define PTP_OC_MTP_GetObjectPropValue 0x9803 425 #define PTP_OC_MTP_SetObjectPropValue 0x9804 426 #define PTP_OC_MTP_GetObjPropList 0x9805 427 #define PTP_OC_MTP_SetObjPropList 0x9806 428 #define PTP_OC_MTP_GetInterdependendPropdesc 0x9807 429 #define PTP_OC_MTP_SendObjectPropList 0x9808 430 #define PTP_OC_MTP_GetObjectReferences 0x9810 431 #define PTP_OC_MTP_SetObjectReferences 0x9811 432 #define PTP_OC_MTP_UpdateDeviceFirmware 0x9812 433 #define PTP_OC_MTP_Skip 0x9820 434 435 /* 436 * Windows Media Digital Rights Management for Portable Devices 437 * Extension Codes (microsoft.com/WMDRMPD: 10.1) 438 */ 439 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeChallenge 0x9101 440 #define PTP_OC_MTP_WMDRMPD_GetSecureTimeResponse 0x9102 441 #define PTP_OC_MTP_WMDRMPD_SetLicenseResponse 0x9103 442 #define PTP_OC_MTP_WMDRMPD_GetSyncList 0x9104 443 #define PTP_OC_MTP_WMDRMPD_SendMeterChallengeQuery 0x9105 444 #define PTP_OC_MTP_WMDRMPD_GetMeterChallenge 0x9106 445 #define PTP_OC_MTP_WMDRMPD_SetMeterResponse 0x9107 446 #define PTP_OC_MTP_WMDRMPD_CleanDataStore 0x9108 447 #define PTP_OC_MTP_WMDRMPD_GetLicenseState 0x9109 448 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDCommand 0x910A 449 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDRequest 0x910B 450 451 /* 452 * Windows Media Digital Rights Management for Portable Devices 453 * Extension Codes (microsoft.com/WMDRMPD: 10.1) 454 * Below are operations that have no public documented identifier 455 * associated with them "Vendor-defined Command Code" 456 */ 457 #define PTP_OC_MTP_WMDRMPD_SendWMDRMPDAppRequest 0x9212 458 #define PTP_OC_MTP_WMDRMPD_GetWMDRMPDAppResponse 0x9213 459 #define PTP_OC_MTP_WMDRMPD_EnableTrustedFilesOperations 0x9214 460 #define PTP_OC_MTP_WMDRMPD_DisableTrustedFilesOperations 0x9215 461 #define PTP_OC_MTP_WMDRMPD_EndTrustedAppSession 0x9216 462 /* ^^^ guess ^^^ */ 463 464 /* 465 * Microsoft Advanced Audio/Video Transfer 466 * Extensions (microsoft.com/AAVT: 1.0) 467 */ 468 #define PTP_OC_MTP_AAVT_OpenMediaSession 0x9170 469 #define PTP_OC_MTP_AAVT_CloseMediaSession 0x9171 470 #define PTP_OC_MTP_AAVT_GetNextDataBlock 0x9172 471 #define PTP_OC_MTP_AAVT_SetCurrentTimePosition 0x9173 472 473 /* 474 * Windows Media Digital Rights Management for Network Devices 475 * Extensions (microsoft.com/WMDRMND: 1.0) MTP/IP? 476 */ 477 #define PTP_OC_MTP_WMDRMND_SendRegistrationRequest 0x9180 478 #define PTP_OC_MTP_WMDRMND_GetRegistrationResponse 0x9181 479 #define PTP_OC_MTP_WMDRMND_GetProximityChallenge 0x9182 480 #define PTP_OC_MTP_WMDRMND_SendProximityResponse 0x9183 481 #define PTP_OC_MTP_WMDRMND_SendWMDRMNDLicenseRequest 0x9184 482 #define PTP_OC_MTP_WMDRMND_GetWMDRMNDLicenseResponse 0x9185 483 484 /* 485 * Windows Media Player Portiable Devices 486 * Extension Codes (microsoft.com/WMPPD: 11.1) 487 */ 488 #define PTP_OC_MTP_WMPPD_ReportAddedDeletedItems 0x9201 489 #define PTP_OC_MTP_WMPPD_ReportAcquiredItems 0x9202 490 #define PTP_OC_MTP_WMPPD_PlaylistObjectPref 0x9203 491 492 /* 493 * Undocumented Zune Operation Codes 494 * maybe related to WMPPD extension set? 495 */ 496 #define PTP_OC_MTP_ZUNE_GETUNDEFINED001 0x9204 497 498 /* WiFi Provisioning MTP Extension Codes (microsoft.com/WPDWCN: 1.0) */ 499 #define PTP_OC_MTP_WPDWCN_ProcessWFCObject 0x9122 500 501 /* Proprietary vendor extension operations mask */ 502 #define PTP_OC_EXTENSION_MASK 0xF000 503 #define PTP_OC_EXTENSION 0x9000 504 505 /* Response Codes */ 506 507 /* PTP v1.0 response codes */ 508 #define PTP_RC_Undefined 0x2000 509 #define PTP_RC_OK 0x2001 510 #define PTP_RC_GeneralError 0x2002 511 #define PTP_RC_SessionNotOpen 0x2003 512 #define PTP_RC_InvalidTransactionID 0x2004 513 #define PTP_RC_OperationNotSupported 0x2005 514 #define PTP_RC_ParameterNotSupported 0x2006 515 #define PTP_RC_IncompleteTransfer 0x2007 516 #define PTP_RC_InvalidStorageId 0x2008 517 #define PTP_RC_InvalidObjectHandle 0x2009 518 #define PTP_RC_DevicePropNotSupported 0x200A 519 #define PTP_RC_InvalidObjectFormatCode 0x200B 520 #define PTP_RC_StoreFull 0x200C 521 #define PTP_RC_ObjectWriteProtected 0x200D 522 #define PTP_RC_StoreReadOnly 0x200E 523 #define PTP_RC_AccessDenied 0x200F 524 #define PTP_RC_NoThumbnailPresent 0x2010 525 #define PTP_RC_SelfTestFailed 0x2011 526 #define PTP_RC_PartialDeletion 0x2012 527 #define PTP_RC_StoreNotAvailable 0x2013 528 #define PTP_RC_SpecificationByFormatUnsupported 0x2014 529 #define PTP_RC_NoValidObjectInfo 0x2015 530 #define PTP_RC_InvalidCodeFormat 0x2016 531 #define PTP_RC_UnknownVendorCode 0x2017 532 #define PTP_RC_CaptureAlreadyTerminated 0x2018 533 #define PTP_RC_DeviceBusy 0x2019 534 #define PTP_RC_InvalidParentObject 0x201A 535 #define PTP_RC_InvalidDevicePropFormat 0x201B 536 #define PTP_RC_InvalidDevicePropValue 0x201C 537 #define PTP_RC_InvalidParameter 0x201D 538 #define PTP_RC_SessionAlreadyOpened 0x201E 539 #define PTP_RC_TransactionCanceled 0x201F 540 #define PTP_RC_SpecificationOfDestinationUnsupported 0x2020 541 /* PTP v1.1 response codes */ 542 #define PTP_RC_InvalidEnumHandle 0x2021 543 #define PTP_RC_NoStreamEnabled 0x2022 544 #define PTP_RC_InvalidDataSet 0x2023 545 546 /* Eastman Kodak extension Response Codes */ 547 #define PTP_RC_EK_FilenameRequired 0xA001 548 #define PTP_RC_EK_FilenameConflicts 0xA002 549 #define PTP_RC_EK_FilenameInvalid 0xA003 550 551 /* Nikon specific response codes */ 552 #define PTP_RC_NIKON_HardwareError 0xA001 553 #define PTP_RC_NIKON_OutOfFocus 0xA002 554 #define PTP_RC_NIKON_ChangeCameraModeFailed 0xA003 555 #define PTP_RC_NIKON_InvalidStatus 0xA004 556 #define PTP_RC_NIKON_SetPropertyNotSupported 0xA005 557 #define PTP_RC_NIKON_WbResetError 0xA006 558 #define PTP_RC_NIKON_DustReferenceError 0xA007 559 #define PTP_RC_NIKON_ShutterSpeedBulb 0xA008 560 #define PTP_RC_NIKON_MirrorUpSequence 0xA009 561 #define PTP_RC_NIKON_CameraModeNotAdjustFNumber 0xA00A 562 #define PTP_RC_NIKON_NotLiveView 0xA00B 563 #define PTP_RC_NIKON_MfDriveStepEnd 0xA00C 564 #define PTP_RC_NIKON_MfDriveStepInsufficiency 0xA00E 565 #define PTP_RC_NIKON_AdvancedTransferCancel 0xA022 566 567 /* Canon specific response codes */ 568 #define PTP_RC_CANON_A009 0xA009 569 570 /* Microsoft/MTP specific codes */ 571 #define PTP_RC_MTP_Undefined 0xA800 572 #define PTP_RC_MTP_Invalid_ObjectPropCode 0xA801 573 #define PTP_RC_MTP_Invalid_ObjectProp_Format 0xA802 574 #define PTP_RC_MTP_Invalid_ObjectProp_Value 0xA803 575 #define PTP_RC_MTP_Invalid_ObjectReference 0xA804 576 #define PTP_RC_MTP_Invalid_Dataset 0xA806 577 #define PTP_RC_MTP_Specification_By_Group_Unsupported 0xA807 578 #define PTP_RC_MTP_Specification_By_Depth_Unsupported 0xA808 579 #define PTP_RC_MTP_Object_Too_Large 0xA809 580 #define PTP_RC_MTP_ObjectProp_Not_Supported 0xA80A 581 582 /* Microsoft Advanced Audio/Video Transfer response codes 583 (microsoft.com/AAVT 1.0) */ 584 #define PTP_RC_MTP_Invalid_Media_Session_ID 0xA170 585 #define PTP_RC_MTP_Media_Session_Limit_Reached 0xA171 586 #define PTP_RC_MTP_No_More_Data 0xA172 587 588 /* WiFi Provisioning MTP Extension Error Codes (microsoft.com/WPDWCN: 1.0) */ 589 #define PTP_RC_MTP_Invalid_WFC_Syntax 0xA121 590 #define PTP_RC_MTP_WFC_Version_Not_Supported 0xA122 591 592 /* libptp2 extended ERROR codes */ 593 #define PTP_ERROR_IO 0x02FF 594 #define PTP_ERROR_DATA_EXPECTED 0x02FE 595 #define PTP_ERROR_RESP_EXPECTED 0x02FD 596 #define PTP_ERROR_BADPARAM 0x02FC 597 #define PTP_ERROR_CANCEL 0x02FB 598 #define PTP_ERROR_TIMEOUT 0x02FA 599 600 /* PTP Event Codes */ 601 602 #define PTP_EC_Undefined 0x4000 603 #define PTP_EC_CancelTransaction 0x4001 604 #define PTP_EC_ObjectAdded 0x4002 605 #define PTP_EC_ObjectRemoved 0x4003 606 #define PTP_EC_StoreAdded 0x4004 607 #define PTP_EC_StoreRemoved 0x4005 608 #define PTP_EC_DevicePropChanged 0x4006 609 #define PTP_EC_ObjectInfoChanged 0x4007 610 #define PTP_EC_DeviceInfoChanged 0x4008 611 #define PTP_EC_RequestObjectTransfer 0x4009 612 #define PTP_EC_StoreFull 0x400A 613 #define PTP_EC_DeviceReset 0x400B 614 #define PTP_EC_StorageInfoChanged 0x400C 615 #define PTP_EC_CaptureComplete 0x400D 616 #define PTP_EC_UnreportedStatus 0x400E 617 618 /* Canon extension Event Codes */ 619 #define PTP_EC_CANON_ExtendedErrorcode 0xC005 /* ? */ 620 #define PTP_EC_CANON_ObjectInfoChanged 0xC008 621 #define PTP_EC_CANON_RequestObjectTransfer 0xC009 622 #define PTP_EC_CANON_CameraModeChanged 0xC00C 623 #define PTP_EC_CANON_ShutterButtonPressed 0xC00E 624 625 #define PTP_EC_CANON_StartDirectTransfer 0xC011 626 #define PTP_EC_CANON_StopDirectTransfer 0xC013 627 628 /* Canon EOS events */ 629 #define PTP_EC_CANON_EOS_RequestGetEvent 0xc101 630 #define PTP_EC_CANON_EOS_ObjectAddedEx 0xc181 631 #define PTP_EC_CANON_EOS_ObjectRemoved 0xc182 632 #define PTP_EC_CANON_EOS_RequestGetObjectInfoEx 0xc183 633 #define PTP_EC_CANON_EOS_StorageStatusChanged 0xc184 634 #define PTP_EC_CANON_EOS_StorageInfoChanged 0xc185 635 #define PTP_EC_CANON_EOS_RequestObjectTransfer 0xc186 636 #define PTP_EC_CANON_EOS_ObjectInfoChangedEx 0xc187 637 #define PTP_EC_CANON_EOS_ObjectContentChanged 0xc188 638 #define PTP_EC_CANON_EOS_PropValueChanged 0xc189 639 #define PTP_EC_CANON_EOS_AvailListChanged 0xc18a 640 #define PTP_EC_CANON_EOS_CameraStatusChanged 0xc18b 641 #define PTP_EC_CANON_EOS_WillSoonShutdown 0xc18d 642 #define PTP_EC_CANON_EOS_ShutdownTimerUpdated 0xc18e 643 #define PTP_EC_CANON_EOS_RequestCancelTransfer 0xc18f 644 #define PTP_EC_CANON_EOS_RequestObjectTransferDT 0xc190 645 #define PTP_EC_CANON_EOS_RequestCancelTransferDT 0xc191 646 #define PTP_EC_CANON_EOS_StoreAdded 0xc192 647 #define PTP_EC_CANON_EOS_StoreRemoved 0xc193 648 #define PTP_EC_CANON_EOS_BulbExposureTime 0xc194 649 #define PTP_EC_CANON_EOS_RecordingTime 0xc195 650 #define PTP_EC_CANON_EOS_RequestObjectTransferTS 0xC1a2 651 #define PTP_EC_CANON_EOS_AfResult 0xc1a3 652 653 /* Nikon extension Event Codes */ 654 655 /* Nikon extension Event Codes */ 656 #define PTP_EC_Nikon_ObjectAddedInSDRAM 0xC101 657 #define PTP_EC_Nikon_CaptureCompleteRecInSdram 0xC102 658 /* Gets 1 parameter, objectid pointing to DPOF object */ 659 #define PTP_EC_Nikon_AdvancedTransfer 0xC103 660 #define PTP_EC_Nikon_PreviewImageAdded 0xC104 661 662 /* MTP Event codes */ 663 #define PTP_EC_MTP_ObjectPropChanged 0xC801 664 #define PTP_EC_MTP_ObjectPropDescChanged 0xC802 665 #define PTP_EC_MTP_ObjectReferencesChanged 0xC803 666 667 /* constants for GetObjectHandles */ 668 #define PTP_GOH_ALL_STORAGE 0xffffffff 669 #define PTP_GOH_ALL_FORMATS 0x00000000 670 #define PTP_GOH_ALL_ASSOCS 0x00000000 671 #define PTP_GOH_ROOT_PARENT 0xffffffff 672 673 /* PTP device info structure (returned by GetDevInfo) */ 674 675 struct _PTPDeviceInfo { 676 uint16_t StandardVersion; 677 uint32_t VendorExtensionID; 678 uint16_t VendorExtensionVersion; 679 char *VendorExtensionDesc; 680 uint16_t FunctionalMode; 681 uint32_t OperationsSupported_len; 682 uint16_t *OperationsSupported; 683 uint32_t EventsSupported_len; 684 uint16_t *EventsSupported; 685 uint32_t DevicePropertiesSupported_len; 686 uint16_t *DevicePropertiesSupported; 687 uint32_t CaptureFormats_len; 688 uint16_t *CaptureFormats; 689 uint32_t ImageFormats_len; 690 uint16_t *ImageFormats; 691 char *Manufacturer; 692 char *Model; 693 char *DeviceVersion; 694 char *SerialNumber; 695 }; 696 typedef struct _PTPDeviceInfo PTPDeviceInfo; 697 698 /* PTP storageIDs structute (returned by GetStorageIDs) */ 699 700 struct _PTPStorageIDs { 701 uint32_t n; 702 uint32_t *Storage; 703 }; 704 typedef struct _PTPStorageIDs PTPStorageIDs; 705 706 /* PTP StorageInfo structure (returned by GetStorageInfo) */ 707 struct _PTPStorageInfo { 708 uint16_t StorageType; 709 uint16_t FilesystemType; 710 uint16_t AccessCapability; 711 uint64_t MaxCapability; 712 uint64_t FreeSpaceInBytes; 713 uint32_t FreeSpaceInImages; 714 char *StorageDescription; 715 char *VolumeLabel; 716 }; 717 typedef struct _PTPStorageInfo PTPStorageInfo; 718 719 /* PTP objecthandles structure (returned by GetObjectHandles) */ 720 721 struct _PTPObjectHandles { 722 uint32_t n; 723 uint32_t *Handler; 724 }; 725 typedef struct _PTPObjectHandles PTPObjectHandles; 726 727 #define PTP_HANDLER_SPECIAL 0xffffffff 728 #define PTP_HANDLER_ROOT 0x00000000 729 730 731 /* PTP objectinfo structure (returned by GetObjectInfo) */ 732 733 struct _PTPObjectInfo { 734 uint32_t StorageID; 735 uint16_t ObjectFormat; 736 uint16_t ProtectionStatus; 737 uint32_t ObjectCompressedSize; 738 uint16_t ThumbFormat; 739 uint32_t ThumbCompressedSize; 740 uint32_t ThumbPixWidth; 741 uint32_t ThumbPixHeight; 742 uint32_t ImagePixWidth; 743 uint32_t ImagePixHeight; 744 uint32_t ImageBitDepth; 745 uint32_t ParentObject; 746 uint16_t AssociationType; 747 uint32_t AssociationDesc; 748 uint32_t SequenceNumber; 749 char *Filename; 750 time_t CaptureDate; 751 time_t ModificationDate; 752 char *Keywords; 753 }; 754 typedef struct _PTPObjectInfo PTPObjectInfo; 755 756 /* max ptp string length INCLUDING terminating null character */ 757 758 #define PTP_MAXSTRLEN 255 759 760 /* PTP Object Format Codes */ 761 762 /* ancillary formats */ 763 #define PTP_OFC_Undefined 0x3000 764 #define PTP_OFC_Defined 0x3800 765 #define PTP_OFC_Association 0x3001 766 #define PTP_OFC_Script 0x3002 767 #define PTP_OFC_Executable 0x3003 768 #define PTP_OFC_Text 0x3004 769 #define PTP_OFC_HTML 0x3005 770 #define PTP_OFC_DPOF 0x3006 771 #define PTP_OFC_AIFF 0x3007 772 #define PTP_OFC_WAV 0x3008 773 #define PTP_OFC_MP3 0x3009 774 #define PTP_OFC_AVI 0x300A 775 #define PTP_OFC_MPEG 0x300B 776 #define PTP_OFC_ASF 0x300C 777 #define PTP_OFC_QT 0x300D /* guessing */ 778 /* image formats */ 779 #define PTP_OFC_EXIF_JPEG 0x3801 780 #define PTP_OFC_TIFF_EP 0x3802 781 #define PTP_OFC_FlashPix 0x3803 782 #define PTP_OFC_BMP 0x3804 783 #define PTP_OFC_CIFF 0x3805 784 #define PTP_OFC_Undefined_0x3806 0x3806 785 #define PTP_OFC_GIF 0x3807 786 #define PTP_OFC_JFIF 0x3808 787 #define PTP_OFC_PCD 0x3809 788 #define PTP_OFC_PICT 0x380A 789 #define PTP_OFC_PNG 0x380B 790 #define PTP_OFC_Undefined_0x380C 0x380C 791 #define PTP_OFC_TIFF 0x380D 792 #define PTP_OFC_TIFF_IT 0x380E 793 #define PTP_OFC_JP2 0x380F 794 #define PTP_OFC_JPX 0x3810 795 /* ptp v1.1 has only DNG new */ 796 #define PTP_OFC_DNG 0x3811 797 /* Eastman Kodak extension ancillary format */ 798 #define PTP_OFC_EK_M3U 0xb002 799 /* Canon extension */ 800 #define PTP_OFC_CANON_CRW 0xb101 801 #define PTP_OFC_CANON_CRW3 0xb103 802 #define PTP_OFC_CANON_MOV 0xb104 803 /* MTP extensions */ 804 #define PTP_OFC_MTP_MediaCard 0xb211 805 #define PTP_OFC_MTP_MediaCardGroup 0xb212 806 #define PTP_OFC_MTP_Encounter 0xb213 807 #define PTP_OFC_MTP_EncounterBox 0xb214 808 #define PTP_OFC_MTP_M4A 0xb215 809 #define PTP_OFC_MTP_ZUNEUNDEFINED 0xb217 /* Unknown file type */ 810 #define PTP_OFC_MTP_Firmware 0xb802 811 #define PTP_OFC_MTP_WindowsImageFormat 0xb881 812 #define PTP_OFC_MTP_UndefinedAudio 0xb900 813 #define PTP_OFC_MTP_WMA 0xb901 814 #define PTP_OFC_MTP_OGG 0xb902 815 #define PTP_OFC_MTP_AAC 0xb903 816 #define PTP_OFC_MTP_AudibleCodec 0xb904 817 #define PTP_OFC_MTP_FLAC 0xb906 818 #define PTP_OFC_MTP_UndefinedVideo 0xb980 819 #define PTP_OFC_MTP_WMV 0xb981 820 #define PTP_OFC_MTP_MP4 0xb982 821 #define PTP_OFC_MTP_MP2 0xb983 822 #define PTP_OFC_MTP_3GP 0xb984 823 #define PTP_OFC_MTP_UndefinedCollection 0xba00 824 #define PTP_OFC_MTP_AbstractMultimediaAlbum 0xba01 825 #define PTP_OFC_MTP_AbstractImageAlbum 0xba02 826 #define PTP_OFC_MTP_AbstractAudioAlbum 0xba03 827 #define PTP_OFC_MTP_AbstractVideoAlbum 0xba04 828 #define PTP_OFC_MTP_AbstractAudioVideoPlaylist 0xba05 829 #define PTP_OFC_MTP_AbstractContactGroup 0xba06 830 #define PTP_OFC_MTP_AbstractMessageFolder 0xba07 831 #define PTP_OFC_MTP_AbstractChapteredProduction 0xba08 832 #define PTP_OFC_MTP_AbstractAudioPlaylist 0xba09 833 #define PTP_OFC_MTP_AbstractVideoPlaylist 0xba0a 834 #define PTP_OFC_MTP_AbstractMediacast 0xba0b 835 #define PTP_OFC_MTP_WPLPlaylist 0xba10 836 #define PTP_OFC_MTP_M3UPlaylist 0xba11 837 #define PTP_OFC_MTP_MPLPlaylist 0xba12 838 #define PTP_OFC_MTP_ASXPlaylist 0xba13 839 #define PTP_OFC_MTP_PLSPlaylist 0xba14 840 #define PTP_OFC_MTP_UndefinedDocument 0xba80 841 #define PTP_OFC_MTP_AbstractDocument 0xba81 842 #define PTP_OFC_MTP_XMLDocument 0xba82 843 #define PTP_OFC_MTP_MSWordDocument 0xba83 844 #define PTP_OFC_MTP_MHTCompiledHTMLDocument 0xba84 845 #define PTP_OFC_MTP_MSExcelSpreadsheetXLS 0xba85 846 #define PTP_OFC_MTP_MSPowerpointPresentationPPT 0xba86 847 #define PTP_OFC_MTP_UndefinedMessage 0xbb00 848 #define PTP_OFC_MTP_AbstractMessage 0xbb01 849 #define PTP_OFC_MTP_UndefinedContact 0xbb80 850 #define PTP_OFC_MTP_AbstractContact 0xbb81 851 #define PTP_OFC_MTP_vCard2 0xbb82 852 #define PTP_OFC_MTP_vCard3 0xbb83 853 #define PTP_OFC_MTP_UndefinedCalendarItem 0xbe00 854 #define PTP_OFC_MTP_AbstractCalendarItem 0xbe01 855 #define PTP_OFC_MTP_vCalendar1 0xbe02 856 #define PTP_OFC_MTP_vCalendar2 0xbe03 857 #define PTP_OFC_MTP_UndefinedWindowsExecutable 0xbe80 858 #define PTP_OFC_MTP_MediaCast 0xbe81 859 #define PTP_OFC_MTP_Section 0xbe82 860 861 /* PTP Association Types */ 862 #define PTP_AT_Undefined 0x0000 863 #define PTP_AT_GenericFolder 0x0001 864 #define PTP_AT_Album 0x0002 865 #define PTP_AT_TimeSequence 0x0003 866 #define PTP_AT_HorizontalPanoramic 0x0004 867 #define PTP_AT_VerticalPanoramic 0x0005 868 #define PTP_AT_2DPanoramic 0x0006 869 #define PTP_AT_AncillaryData 0x0007 870 871 /* PTP Protection Status */ 872 873 #define PTP_PS_NoProtection 0x0000 874 #define PTP_PS_ReadOnly 0x0001 875 #define PTP_PS_MTP_ReadOnlyData 0x8002 876 #define PTP_PS_MTP_NonTransferableData 0x8003 877 878 /* PTP Storage Types */ 879 880 #define PTP_ST_Undefined 0x0000 881 #define PTP_ST_FixedROM 0x0001 882 #define PTP_ST_RemovableROM 0x0002 883 #define PTP_ST_FixedRAM 0x0003 884 #define PTP_ST_RemovableRAM 0x0004 885 886 /* PTP FilesystemType Values */ 887 888 #define PTP_FST_Undefined 0x0000 889 #define PTP_FST_GenericFlat 0x0001 890 #define PTP_FST_GenericHierarchical 0x0002 891 #define PTP_FST_DCF 0x0003 892 893 /* PTP StorageInfo AccessCapability Values */ 894 895 #define PTP_AC_ReadWrite 0x0000 896 #define PTP_AC_ReadOnly 0x0001 897 #define PTP_AC_ReadOnly_with_Object_Deletion 0x0002 898 899 /* Property Describing Dataset, Range Form */ 900 901 union _PTPPropertyValue { 902 char *str; /* common string, malloced */ 903 uint8_t u8; 904 int8_t i8; 905 uint16_t u16; 906 int16_t i16; 907 uint32_t u32; 908 int32_t i32; 909 uint64_t u64; 910 int64_t i64; 911 /* XXXX: 128 bit signed and unsigned missing */ 912 struct array { 913 uint32_t count; 914 union _PTPPropertyValue *v; /* malloced, count elements */ 915 } a; 916 }; 917 918 typedef union _PTPPropertyValue PTPPropertyValue; 919 920 /* Metadata lists for MTP operations */ 921 struct _MTPProperties { 922 uint16_t property; 923 uint16_t datatype; 924 uint32_t ObjectHandle; 925 PTPPropertyValue propval; 926 }; 927 typedef struct _MTPProperties MTPProperties; 928 929 struct _PTPPropDescRangeForm { 930 PTPPropertyValue MinimumValue; 931 PTPPropertyValue MaximumValue; 932 PTPPropertyValue StepSize; 933 }; 934 typedef struct _PTPPropDescRangeForm PTPPropDescRangeForm; 935 936 /* Property Describing Dataset, Enum Form */ 937 938 struct _PTPPropDescEnumForm { 939 uint16_t NumberOfValues; 940 PTPPropertyValue *SupportedValue; /* malloced */ 941 }; 942 typedef struct _PTPPropDescEnumForm PTPPropDescEnumForm; 943 944 /* Device Property Describing Dataset (DevicePropDesc) */ 945 946 struct _PTPDevicePropDesc { 947 uint16_t DevicePropertyCode; 948 uint16_t DataType; 949 uint8_t GetSet; 950 PTPPropertyValue FactoryDefaultValue; 951 PTPPropertyValue CurrentValue; 952 uint8_t FormFlag; 953 union { 954 PTPPropDescEnumForm Enum; 955 PTPPropDescRangeForm Range; 956 } FORM; 957 }; 958 typedef struct _PTPDevicePropDesc PTPDevicePropDesc; 959 960 /* Object Property Describing Dataset (DevicePropDesc) */ 961 962 struct _PTPObjectPropDesc { 963 uint16_t ObjectPropertyCode; 964 uint16_t DataType; 965 uint8_t GetSet; 966 PTPPropertyValue FactoryDefaultValue; 967 uint32_t GroupCode; 968 uint8_t FormFlag; 969 union { 970 PTPPropDescEnumForm Enum; 971 PTPPropDescRangeForm Range; 972 } FORM; 973 }; 974 typedef struct _PTPObjectPropDesc PTPObjectPropDesc; 975 976 /* Canon filesystem's folder entry Dataset */ 977 978 #define PTP_CANON_FilenameBufferLen 13 979 #define PTP_CANON_FolderEntryLen 28 980 981 struct _PTPCANONFolderEntry { 982 uint32_t ObjectHandle; 983 uint16_t ObjectFormatCode; 984 uint8_t Flags; 985 uint32_t ObjectSize; 986 time_t Time; 987 char Filename[PTP_CANON_FilenameBufferLen]; 988 }; 989 typedef struct _PTPCANONFolderEntry PTPCANONFolderEntry; 990 991 /* Nikon Tone Curve Data */ 992 993 #define PTP_NIKON_MaxCurvePoints 19 994 995 struct _PTPNIKONCoordinatePair { 996 uint8_t X; 997 uint8_t Y; 998 }; 999 1000 typedef struct _PTPNIKONCoordinatePair PTPNIKONCoordinatePair; 1001 1002 struct _PTPNTCCoordinatePair { 1003 uint8_t X; 1004 uint8_t Y; 1005 }; 1006 1007 typedef struct _PTPNTCCoordinatePair PTPNTCCoordinatePair; 1008 1009 struct _PTPNIKONCurveData { 1010 char static_preamble[6]; 1011 uint8_t XAxisStartPoint; 1012 uint8_t XAxisEndPoint; 1013 uint8_t YAxisStartPoint; 1014 uint8_t YAxisEndPoint; 1015 uint8_t MidPointIntegerPart; 1016 uint8_t MidPointDecimalPart; 1017 uint8_t NCoordinates; 1018 PTPNIKONCoordinatePair CurveCoordinates[PTP_NIKON_MaxCurvePoints]; 1019 }; 1020 1021 typedef struct _PTPNIKONCurveData PTPNIKONCurveData; 1022 1023 struct _PTPEKTextParams { 1024 char *title; 1025 char *line[5]; 1026 }; 1027 typedef struct _PTPEKTextParams PTPEKTextParams; 1028 1029 /* Nikon Wifi profiles */ 1030 1031 struct _PTPNIKONWifiProfile { 1032 /* Values valid both when reading and writing profiles */ 1033 char profile_name[17]; 1034 uint8_t device_type; 1035 uint8_t icon_type; 1036 char essid[33]; 1037 1038 /* Values only valid when reading. Some of these are in the write packet, 1039 * but are set automatically, like id, display_order and creation_date. */ 1040 uint8_t id; 1041 uint8_t valid; 1042 uint8_t display_order; 1043 char creation_date[16]; 1044 char lastusage_date[16]; 1045 1046 /* Values only valid when writing */ 1047 uint32_t ip_address; 1048 uint8_t subnet_mask; /* first zero bit position, e.g. 24 for 255.255.255.0 */ 1049 uint32_t gateway_address; 1050 uint8_t address_mode; /* 0 - Manual, 2-3 - DHCP ad-hoc/managed*/ 1051 uint8_t access_mode; /* 0 - Managed, 1 - Adhoc */ 1052 uint8_t wifi_channel; /* 1-11 */ 1053 uint8_t authentification; /* 0 - Open, 1 - Shared, 2 - WPA-PSK */ 1054 uint8_t encryption; /* 0 - None, 1 - WEP 64bit, 2 - WEP 128bit (not supported: 3 - TKIP) */ 1055 uint8_t key[64]; 1056 uint8_t key_nr; 1057 // char guid[16]; 1058 }; 1059 1060 typedef struct _PTPNIKONWifiProfile PTPNIKONWifiProfile; 1061 1062 #define PTP_CANON_EOS_CHANGES_TYPE_UNKNOWN 0 1063 #define PTP_CANON_EOS_CHANGES_TYPE_OBJECTINFO 1 1064 #define PTP_CANON_EOS_CHANGES_TYPE_OBJECTTRANSFER 2 1065 1066 struct _PTPCanon_New_Object { 1067 uint32_t oid; 1068 PTPObjectInfo oi; 1069 }; 1070 1071 struct _PTPCanon_changes_entry { 1072 int type; 1073 union { 1074 struct _PTPCanon_New_Object object; /* TYPE_OBJECTINFO */ 1075 } u; 1076 }; 1077 typedef struct _PTPCanon_changes_entry PTPCanon_changes_entry; 1078 1079 typedef struct _PTPCanon_Property { 1080 uint32_t size; 1081 uint32_t type; 1082 uint32_t proptype; 1083 unsigned char *data; 1084 1085 /* fill out for queries */ 1086 PTPDevicePropDesc dpd; 1087 } PTPCanon_Property; 1088 1089 typedef struct _PTPCanonEOSDeviceInfo { 1090 /* length */ 1091 uint32_t EventsSupported_len; 1092 uint32_t *EventsSupported; 1093 1094 uint32_t DevicePropertiesSupported_len; 1095 uint32_t *DevicePropertiesSupported; 1096 1097 uint32_t unk_len; 1098 uint32_t *unk; 1099 } PTPCanonEOSDeviceInfo; 1100 1101 /* DataType Codes */ 1102 1103 #define PTP_DTC_UNDEF 0x0000 1104 #define PTP_DTC_INT8 0x0001 1105 #define PTP_DTC_UINT8 0x0002 1106 #define PTP_DTC_INT16 0x0003 1107 #define PTP_DTC_UINT16 0x0004 1108 #define PTP_DTC_INT32 0x0005 1109 #define PTP_DTC_UINT32 0x0006 1110 #define PTP_DTC_INT64 0x0007 1111 #define PTP_DTC_UINT64 0x0008 1112 #define PTP_DTC_INT128 0x0009 1113 #define PTP_DTC_UINT128 0x000A 1114 1115 #define PTP_DTC_ARRAY_MASK 0x4000 1116 1117 #define PTP_DTC_AINT8 (PTP_DTC_ARRAY_MASK | PTP_DTC_INT8) 1118 #define PTP_DTC_AUINT8 (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT8) 1119 #define PTP_DTC_AINT16 (PTP_DTC_ARRAY_MASK | PTP_DTC_INT16) 1120 #define PTP_DTC_AUINT16 (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT16) 1121 #define PTP_DTC_AINT32 (PTP_DTC_ARRAY_MASK | PTP_DTC_INT32) 1122 #define PTP_DTC_AUINT32 (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT32) 1123 #define PTP_DTC_AINT64 (PTP_DTC_ARRAY_MASK | PTP_DTC_INT64) 1124 #define PTP_DTC_AUINT64 (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT64) 1125 #define PTP_DTC_AINT128 (PTP_DTC_ARRAY_MASK | PTP_DTC_INT128) 1126 #define PTP_DTC_AUINT128 (PTP_DTC_ARRAY_MASK | PTP_DTC_UINT128) 1127 1128 #define PTP_DTC_STR 0xFFFF 1129 1130 /* Device Properties Codes */ 1131 1132 /* PTP v1.0 property codes */ 1133 #define PTP_DPC_Undefined 0x5000 1134 #define PTP_DPC_BatteryLevel 0x5001 1135 #define PTP_DPC_FunctionalMode 0x5002 1136 #define PTP_DPC_ImageSize 0x5003 1137 #define PTP_DPC_CompressionSetting 0x5004 1138 #define PTP_DPC_WhiteBalance 0x5005 1139 #define PTP_DPC_RGBGain 0x5006 1140 #define PTP_DPC_FNumber 0x5007 1141 #define PTP_DPC_FocalLength 0x5008 1142 #define PTP_DPC_FocusDistance 0x5009 1143 #define PTP_DPC_FocusMode 0x500A 1144 #define PTP_DPC_ExposureMeteringMode 0x500B 1145 #define PTP_DPC_FlashMode 0x500C 1146 #define PTP_DPC_ExposureTime 0x500D 1147 #define PTP_DPC_ExposureProgramMode 0x500E 1148 #define PTP_DPC_ExposureIndex 0x500F 1149 #define PTP_DPC_ExposureBiasCompensation 0x5010 1150 #define PTP_DPC_DateTime 0x5011 1151 #define PTP_DPC_CaptureDelay 0x5012 1152 #define PTP_DPC_StillCaptureMode 0x5013 1153 #define PTP_DPC_Contrast 0x5014 1154 #define PTP_DPC_Sharpness 0x5015 1155 #define PTP_DPC_DigitalZoom 0x5016 1156 #define PTP_DPC_EffectMode 0x5017 1157 #define PTP_DPC_BurstNumber 0x5018 1158 #define PTP_DPC_BurstInterval 0x5019 1159 #define PTP_DPC_TimelapseNumber 0x501A 1160 #define PTP_DPC_TimelapseInterval 0x501B 1161 #define PTP_DPC_FocusMeteringMode 0x501C 1162 #define PTP_DPC_UploadURL 0x501D 1163 #define PTP_DPC_Artist 0x501E 1164 #define PTP_DPC_CopyrightInfo 0x501F 1165 /* PTP v1.1 property codes */ 1166 #define PTP_DPC_SupportedStreams 0x5020 1167 #define PTP_DPC_EnabledStreams 0x5021 1168 #define PTP_DPC_VideoFormat 0x5022 1169 #define PTP_DPC_VideoResolution 0x5023 1170 #define PTP_DPC_VideoQuality 0x5024 1171 #define PTP_DPC_VideoFrameRate 0x5025 1172 #define PTP_DPC_VideoContrast 0x5026 1173 #define PTP_DPC_VideoBrightness 0x5027 1174 #define PTP_DPC_AudioFormat 0x5028 1175 #define PTP_DPC_AudioBitrate 0x5029 1176 #define PTP_DPC_AudioSamplingRate 0x502A 1177 #define PTP_DPC_AudioBitPerSample 0x502B 1178 #define PTP_DPC_AudioVolume 0x502C 1179 1180 /* Proprietary vendor extension device property mask */ 1181 #define PTP_DPC_EXTENSION_MASK 0xF000 1182 #define PTP_DPC_EXTENSION 0xD000 1183 1184 /* Zune extension device property codes */ 1185 #define PTP_DPC_MTP_ZUNE_UNKNOWN1 0xD181 1186 #define PTP_DPC_MTP_ZUNE_UNKNOWN2 0xD132 1187 #define PTP_DPC_MTP_ZUNE_UNKNOWN3 0xD215 1188 #define PTP_DPC_MTP_ZUNE_UNKNOWN4 0xD216 1189 1190 /* Eastman Kodak extension device property codes */ 1191 #define PTP_DPC_EK_ColorTemperature 0xD001 1192 #define PTP_DPC_EK_DateTimeStampFormat 0xD002 1193 #define PTP_DPC_EK_BeepMode 0xD003 1194 #define PTP_DPC_EK_VideoOut 0xD004 1195 #define PTP_DPC_EK_PowerSaving 0xD005 1196 #define PTP_DPC_EK_UI_Language 0xD006 1197 1198 /* Canon extension device property codes */ 1199 #define PTP_DPC_CANON_BeepMode 0xD001 1200 #define PTP_DPC_CANON_BatteryKind 0xD002 1201 #define PTP_DPC_CANON_BatteryStatus 0xD003 1202 #define PTP_DPC_CANON_UILockType 0xD004 1203 #define PTP_DPC_CANON_CameraMode 0xD005 1204 #define PTP_DPC_CANON_ImageQuality 0xD006 1205 #define PTP_DPC_CANON_FullViewFileFormat 0xD007 1206 #define PTP_DPC_CANON_ImageSize 0xD008 1207 #define PTP_DPC_CANON_SelfTime 0xD009 1208 #define PTP_DPC_CANON_FlashMode 0xD00A 1209 #define PTP_DPC_CANON_Beep 0xD00B 1210 #define PTP_DPC_CANON_ShootingMode 0xD00C 1211 #define PTP_DPC_CANON_ImageMode 0xD00D 1212 #define PTP_DPC_CANON_DriveMode 0xD00E 1213 #define PTP_DPC_CANON_EZoom 0xD00F 1214 #define PTP_DPC_CANON_MeteringMode 0xD010 1215 #define PTP_DPC_CANON_AFDistance 0xD011 1216 #define PTP_DPC_CANON_FocusingPoint 0xD012 1217 #define PTP_DPC_CANON_WhiteBalance 0xD013 1218 #define PTP_DPC_CANON_SlowShutterSetting 0xD014 1219 #define PTP_DPC_CANON_AFMode 0xD015 1220 #define PTP_DPC_CANON_ImageStabilization 0xD016 1221 #define PTP_DPC_CANON_Contrast 0xD017 1222 #define PTP_DPC_CANON_ColorGain 0xD018 1223 #define PTP_DPC_CANON_Sharpness 0xD019 1224 #define PTP_DPC_CANON_Sensitivity 0xD01A 1225 #define PTP_DPC_CANON_ParameterSet 0xD01B 1226 #define PTP_DPC_CANON_ISOSpeed 0xD01C 1227 #define PTP_DPC_CANON_Aperture 0xD01D 1228 #define PTP_DPC_CANON_ShutterSpeed 0xD01E 1229 #define PTP_DPC_CANON_ExpCompensation 0xD01F 1230 #define PTP_DPC_CANON_FlashCompensation 0xD020 1231 #define PTP_DPC_CANON_AEBExposureCompensation 0xD021 1232 #define PTP_DPC_CANON_AvOpen 0xD023 1233 #define PTP_DPC_CANON_AvMax 0xD024 1234 #define PTP_DPC_CANON_FocalLength 0xD025 1235 #define PTP_DPC_CANON_FocalLengthTele 0xD026 1236 #define PTP_DPC_CANON_FocalLengthWide 0xD027 1237 #define PTP_DPC_CANON_FocalLengthDenominator 0xD028 1238 #define PTP_DPC_CANON_CaptureTransferMode 0xD029 1239 #define CANON_TRANSFER_ENTIRE_IMAGE_TO_PC 0x0002 1240 #define CANON_TRANSFER_SAVE_THUMBNAIL_TO_DEVICE 0x0004 1241 #define CANON_TRANSFER_SAVE_IMAGE_TO_DEVICE 0x0008 1242 /* we use those values: */ 1243 #define CANON_TRANSFER_MEMORY (2|1) 1244 #define CANON_TRANSFER_CARD (8|4|1) 1245 1246 #define PTP_DPC_CANON_Zoom 0xD02A 1247 #define PTP_DPC_CANON_NamePrefix 0xD02B 1248 #define PTP_DPC_CANON_SizeQualityMode 0xD02C 1249 #define PTP_DPC_CANON_SupportedThumbSize 0xD02D 1250 #define PTP_DPC_CANON_SizeOfOutputDataFromCamera 0xD02E 1251 #define PTP_DPC_CANON_SizeOfInputDataToCamera 0xD02F 1252 #define PTP_DPC_CANON_RemoteAPIVersion 0xD030 1253 #define PTP_DPC_CANON_FirmwareVersion 0xD031 1254 #define PTP_DPC_CANON_CameraModel 0xD032 1255 #define PTP_DPC_CANON_CameraOwner 0xD033 1256 #define PTP_DPC_CANON_UnixTime 0xD034 1257 #define PTP_DPC_CANON_CameraBodyID 0xD035 1258 #define PTP_DPC_CANON_CameraOutput 0xD036 1259 #define PTP_DPC_CANON_DispAv 0xD037 1260 #define PTP_DPC_CANON_AvOpenApex 0xD038 1261 #define PTP_DPC_CANON_DZoomMagnification 0xD039 1262 #define PTP_DPC_CANON_MlSpotPos 0xD03A 1263 #define PTP_DPC_CANON_DispAvMax 0xD03B 1264 #define PTP_DPC_CANON_AvMaxApex 0xD03C 1265 #define PTP_DPC_CANON_EZoomStartPosition 0xD03D 1266 #define PTP_DPC_CANON_FocalLengthOfTele 0xD03E 1267 #define PTP_DPC_CANON_EZoomSizeOfTele 0xD03F 1268 #define PTP_DPC_CANON_PhotoEffect 0xD040 1269 #define PTP_DPC_CANON_AssistLight 0xD041 1270 #define PTP_DPC_CANON_FlashQuantityCount 0xD042 1271 #define PTP_DPC_CANON_RotationAngle 0xD043 1272 #define PTP_DPC_CANON_RotationScene 0xD044 1273 #define PTP_DPC_CANON_EventEmulateMode 0xD045 1274 #define PTP_DPC_CANON_DPOFVersion 0xD046 1275 #define PTP_DPC_CANON_TypeOfSupportedSlideShow 0xD047 1276 #define PTP_DPC_CANON_AverageFilesizes 0xD048 1277 #define PTP_DPC_CANON_ModelID 0xD049 1278 1279 /* From EOS 400D trace. */ 1280 #define PTP_DPC_CANON_EOS_Aperture 0xD101 1281 #define PTP_DPC_CANON_EOS_ShutterSpeed 0xD102 1282 #define PTP_DPC_CANON_EOS_ISOSpeed 0xD103 1283 #define PTP_DPC_CANON_EOS_ExpCompensation 0xD104 1284 #define PTP_DPC_CANON_EOS_AutoExposureMode 0xD105 1285 #define PTP_DPC_CANON_EOS_DriveMode 0xD106 1286 #define PTP_DPC_CANON_EOS_MeteringMode 0xD107 1287 #define PTP_DPC_CANON_EOS_FocusMode 0xD108 1288 #define PTP_DPC_CANON_EOS_WhiteBalance 0xD109 1289 #define PTP_DPC_CANON_EOS_ColorTemperature 0xD10A 1290 #define PTP_DPC_CANON_EOS_WhiteBalanceAdjustA 0xD10B 1291 #define PTP_DPC_CANON_EOS_WhiteBalanceAdjustB 0xD10C 1292 #define PTP_DPC_CANON_EOS_WhiteBalanceXA 0xD10D 1293 #define PTP_DPC_CANON_EOS_WhiteBalanceXB 0xD10E 1294 #define PTP_DPC_CANON_EOS_ColorSpace 0xD10F 1295 #define PTP_DPC_CANON_EOS_PictureStyle 0xD110 1296 #define PTP_DPC_CANON_EOS_BatteryPower 0xD111 1297 #define PTP_DPC_CANON_EOS_BatterySelect 0xD112 1298 #define PTP_DPC_CANON_EOS_CameraTime 0xD113 1299 #define PTP_DPC_CANON_EOS_Owner 0xD115 1300 #define PTP_DPC_CANON_EOS_ModelID 0xD116 1301 #define PTP_DPC_CANON_EOS_PTPExtensionVersion 0xD119 1302 #define PTP_DPC_CANON_EOS_DPOFVersion 0xD11A 1303 #define PTP_DPC_CANON_EOS_AvailableShots 0xD11B 1304 #define PTP_DPC_CANON_EOS_CaptureDestination 0xD11C 1305 #define PTP_DPC_CANON_EOS_BracketMode 0xD11D 1306 #define PTP_DPC_CANON_EOS_CurrentStorage 0xD11E 1307 #define PTP_DPC_CANON_EOS_CurrentFolder 0xD11F 1308 #define PTP_DPC_CANON_EOS_ImageFormat 0xD120 /* file setting */ 1309 #define PTP_DPC_CANON_EOS_ImageFormatCF 0xD121 /* file setting CF */ 1310 #define PTP_DPC_CANON_EOS_ImageFormatSD 0xD122 /* file setting SD */ 1311 #define PTP_DPC_CANON_EOS_ImageFormatExtHD 0xD123 /* file setting exthd */ 1312 #define PTP_DPC_CANON_EOS_CompressionS 0xD130 1313 #define PTP_DPC_CANON_EOS_CompressionM1 0xD131 1314 #define PTP_DPC_CANON_EOS_CompressionM2 0xD132 1315 #define PTP_DPC_CANON_EOS_CompressionL 0xD133 1316 #define PTP_DPC_CANON_EOS_PCWhiteBalance1 0xD140 1317 #define PTP_DPC_CANON_EOS_PCWhiteBalance2 0xD141 1318 #define PTP_DPC_CANON_EOS_PCWhiteBalance3 0xD142 1319 #define PTP_DPC_CANON_EOS_PCWhiteBalance4 0xD143 1320 #define PTP_DPC_CANON_EOS_PCWhiteBalance5 0xD144 1321 #define PTP_DPC_CANON_EOS_MWhiteBalance 0xD145 1322 #define PTP_DPC_CANON_EOS_PictureStyleStandard 0xD150 1323 #define PTP_DPC_CANON_EOS_PictureStylePortrait 0xD151 1324 #define PTP_DPC_CANON_EOS_PictureStyleLandscape 0xD152 1325 #define PTP_DPC_CANON_EOS_PictureStyleNeutral 0xD153 1326 #define PTP_DPC_CANON_EOS_PictureStyleFaithful 0xD154 1327 #define PTP_DPC_CANON_EOS_PictureStyleBlackWhite 0xD155 1328 #define PTP_DPC_CANON_EOS_PictureStyleUserSet1 0xD160 1329 #define PTP_DPC_CANON_EOS_PictureStyleUserSet2 0xD161 1330 #define PTP_DPC_CANON_EOS_PictureStyleUserSet3 0xD162 1331 #define PTP_DPC_CANON_EOS_PictureStyleParam1 0xD170 1332 #define PTP_DPC_CANON_EOS_PictureStyleParam2 0xD171 1333 #define PTP_DPC_CANON_EOS_PictureStyleParam3 0xD172 1334 #define PTP_DPC_CANON_EOS_FlavorLUTParams 0xD17f 1335 #define PTP_DPC_CANON_EOS_CustomFunc1 0xD180 1336 #define PTP_DPC_CANON_EOS_CustomFunc2 0xD181 1337 #define PTP_DPC_CANON_EOS_CustomFunc3 0xD182 1338 #define PTP_DPC_CANON_EOS_CustomFunc4 0xD183 1339 #define PTP_DPC_CANON_EOS_CustomFunc5 0xD184 1340 #define PTP_DPC_CANON_EOS_CustomFunc6 0xD185 1341 #define PTP_DPC_CANON_EOS_CustomFunc7 0xD186 1342 #define PTP_DPC_CANON_EOS_CustomFunc8 0xD187 1343 #define PTP_DPC_CANON_EOS_CustomFunc9 0xD188 1344 #define PTP_DPC_CANON_EOS_CustomFunc10 0xD189 1345 #define PTP_DPC_CANON_EOS_CustomFunc11 0xD18a 1346 #define PTP_DPC_CANON_EOS_CustomFunc12 0xD18b 1347 #define PTP_DPC_CANON_EOS_CustomFunc13 0xD18c 1348 #define PTP_DPC_CANON_EOS_CustomFunc14 0xD18d 1349 #define PTP_DPC_CANON_EOS_CustomFunc15 0xD18e 1350 #define PTP_DPC_CANON_EOS_CustomFunc16 0xD18f 1351 #define PTP_DPC_CANON_EOS_CustomFunc17 0xD190 1352 #define PTP_DPC_CANON_EOS_CustomFunc18 0xD191 1353 #define PTP_DPC_CANON_EOS_CustomFunc19 0xD192 1354 #define PTP_DPC_CANON_EOS_CustomFunc19 0xD192 1355 #define PTP_DPC_CANON_EOS_CustomFuncEx 0xD1a0 1356 #define PTP_DPC_CANON_EOS_MyMenu 0xD1a1 1357 #define PTP_DPC_CANON_EOS_MyMenuList 0xD1a2 1358 #define PTP_DPC_CANON_EOS_WftStatus 0xD1a3 1359 #define PTP_DPC_CANON_EOS_WftInputTransmission 0xD1a4 1360 #define PTP_DPC_CANON_EOS_HDDirectoryStructure 0xD1a5 1361 #define PTP_DPC_CANON_EOS_BatteryInfo 0xD1a6 1362 #define PTP_DPC_CANON_EOS_AdapterInfo 0xD1a7 1363 #define PTP_DPC_CANON_EOS_LensStatus 0xD1a8 1364 #define PTP_DPC_CANON_EOS_QuickReviewTime 0xD1a9 1365 #define PTP_DPC_CANON_EOS_CardExtension 0xD1aa 1366 #define PTP_DPC_CANON_EOS_TempStatus 0xD1ab 1367 #define PTP_DPC_CANON_EOS_ShutterCounter 0xD1ac 1368 #define PTP_DPC_CANON_EOS_SpecialOption 0xD1ad 1369 #define PTP_DPC_CANON_EOS_PhotoStudioMode 0xD1ae 1370 #define PTP_DPC_CANON_EOS_SerialNumber 0xD1af 1371 #define PTP_DPC_CANON_EOS_EVFOutputDevice 0xD1b0 1372 #define PTP_DPC_CANON_EOS_EVFMode 0xD1b1 1373 #define PTP_DPC_CANON_EOS_DepthOfFieldPreview 0xD1b2 1374 #define PTP_DPC_CANON_EOS_EVFSharpness 0xD1b3 1375 #define PTP_DPC_CANON_EOS_EVFWBMode 0xD1b4 1376 #define PTP_DPC_CANON_EOS_EVFClickWBCoeffs 0xD1b5 1377 #define PTP_DPC_CANON_EOS_EVFColorTemp 0xD1b6 1378 #define PTP_DPC_CANON_EOS_ExposureSimMode 0xD1b7 1379 #define PTP_DPC_CANON_EOS_EVFRecordStatus 0xD1b8 1380 #define PTP_DPC_CANON_EOS_LvAfSystem 0xD1ba 1381 #define PTP_DPC_CANON_EOS_MovSize 0xD1bb 1382 #define PTP_DPC_CANON_EOS_LvViewTypeSelect 0xD1bc 1383 #define PTP_DPC_CANON_EOS_Artist 0xD1d0 1384 #define PTP_DPC_CANON_EOS_Copyright 0xD1d1 1385 #define PTP_DPC_CANON_EOS_BracketValue 0xD1d2 1386 #define PTP_DPC_CANON_EOS_FocusInfoEx 0xD1d3 1387 #define PTP_DPC_CANON_EOS_DepthOfField 0xD1d4 1388 #define PTP_DPC_CANON_EOS_Brightness 0xD1d5 1389 #define PTP_DPC_CANON_EOS_LensAdjustParams 0xD1d6 1390 #define PTP_DPC_CANON_EOS_EFComp 0xD1d7 1391 #define PTP_DPC_CANON_EOS_LensName 0xD1d8 1392 #define PTP_DPC_CANON_EOS_AEB 0xD1d9 1393 #define PTP_DPC_CANON_EOS_StroboSetting 0xD1da 1394 #define PTP_DPC_CANON_EOS_StroboWirelessSetting 0xD1db 1395 #define PTP_DPC_CANON_EOS_StroboFiring 0xD1dc 1396 #define PTP_DPC_CANON_EOS_LensID 0xD1dd 1397 1398 /* Nikon extension device property codes */ 1399 #define PTP_DPC_NIKON_ShootingBank 0xD010 1400 #define PTP_DPC_NIKON_ShootingBankNameA 0xD011 1401 #define PTP_DPC_NIKON_ShootingBankNameB 0xD012 1402 #define PTP_DPC_NIKON_ShootingBankNameC 0xD013 1403 #define PTP_DPC_NIKON_ShootingBankNameD 0xD014 1404 #define PTP_DPC_NIKON_ResetBank0 0xD015 1405 #define PTP_DPC_NIKON_RawCompression 0xD016 1406 #define PTP_DPC_NIKON_WhiteBalanceAutoBias 0xD017 1407 #define PTP_DPC_NIKON_WhiteBalanceTungstenBias 0xD018 1408 #define PTP_DPC_NIKON_WhiteBalanceFluorescentBias 0xD019 1409 #define PTP_DPC_NIKON_WhiteBalanceDaylightBias 0xD01A 1410 #define PTP_DPC_NIKON_WhiteBalanceFlashBias 0xD01B 1411 #define PTP_DPC_NIKON_WhiteBalanceCloudyBias 0xD01C 1412 #define PTP_DPC_NIKON_WhiteBalanceShadeBias 0xD01D 1413 #define PTP_DPC_NIKON_WhiteBalanceColorTemperature 0xD01E 1414 #define PTP_DPC_NIKON_WhiteBalancePresetNo 0xD01F 1415 #define PTP_DPC_NIKON_WhiteBalancePresetName0 0xD020 1416 #define PTP_DPC_NIKON_WhiteBalancePresetName1 0xD021 1417 #define PTP_DPC_NIKON_WhiteBalancePresetName2 0xD022 1418 #define PTP_DPC_NIKON_WhiteBalancePresetName3 0xD023 1419 #define PTP_DPC_NIKON_WhiteBalancePresetName4 0xD024 1420 #define PTP_DPC_NIKON_WhiteBalancePresetVal0 0xD025 1421 #define PTP_DPC_NIKON_WhiteBalancePresetVal1 0xD026 1422 #define PTP_DPC_NIKON_WhiteBalancePresetVal2 0xD027 1423 #define PTP_DPC_NIKON_WhiteBalancePresetVal3 0xD028 1424 #define PTP_DPC_NIKON_WhiteBalancePresetVal4 0xD029 1425 #define PTP_DPC_NIKON_ImageSharpening 0xD02A 1426 #define PTP_DPC_NIKON_ToneCompensation 0xD02B 1427 #define PTP_DPC_NIKON_ColorModel 0xD02C 1428 #define PTP_DPC_NIKON_HueAdjustment 0xD02D 1429 #define PTP_DPC_NIKON_NonCPULensDataFocalLength 0xD02E /* Set FMM Manual */ 1430 #define PTP_DPC_NIKON_NonCPULensDataMaximumAperture 0xD02F /* Set F0 Manual */ 1431 #define PTP_DPC_NIKON_ShootingMode 0xD030 1432 #define PTP_DPC_NIKON_JPEG_Compression_Policy 0xD031 1433 #define PTP_DPC_NIKON_ColorSpace 0xD032 1434 #define PTP_DPC_NIKON_AutoDXCrop 0xD033 1435 #define PTP_DPC_NIKON_CSMMenuBankSelect 0xD040 1436 #define PTP_DPC_NIKON_MenuBankNameA 0xD041 1437 #define PTP_DPC_NIKON_MenuBankNameB 0xD042 1438 #define PTP_DPC_NIKON_MenuBankNameC 0xD043 1439 #define PTP_DPC_NIKON_MenuBankNameD 0xD044 1440 #define PTP_DPC_NIKON_ResetBank 0xD045 1441 #define PTP_DPC_NIKON_A1AFCModePriority 0xD048 1442 #define PTP_DPC_NIKON_A2AFSModePriority 0xD049 1443 #define PTP_DPC_NIKON_A3GroupDynamicAF 0xD04A 1444 #define PTP_DPC_NIKON_A4AFActivation 0xD04B 1445 #define PTP_DPC_NIKON_FocusAreaIllumManualFocus 0xD04C 1446 #define PTP_DPC_NIKON_FocusAreaIllumContinuous 0xD04D 1447 #define PTP_DPC_NIKON_FocusAreaIllumWhenSelected 0xD04E 1448 #define PTP_DPC_NIKON_FocusAreaWrap 0xD04F /* area sel */ 1449 #define PTP_DPC_NIKON_VerticalAFON 0xD050 1450 #define PTP_DPC_NIKON_AFLockOn 0xD051 1451 #define PTP_DPC_NIKON_FocusAreaZone 0xD052 1452 #define PTP_DPC_NIKON_EnableCopyright 0xD053 1453 #define PTP_DPC_NIKON_ISOAuto 0xD054 1454 #define PTP_DPC_NIKON_EVISOStep 0xD055 1455 #define PTP_DPC_NIKON_EVStep 0xD056 /* EV Step SS FN */ 1456 #define PTP_DPC_NIKON_EVStepExposureComp 0xD057 1457 #define PTP_DPC_NIKON_ExposureCompensation 0xD058 1458 #define PTP_DPC_NIKON_CenterWeightArea 0xD059 1459 #define PTP_DPC_NIKON_ExposureBaseMatrix 0xD05A 1460 #define PTP_DPC_NIKON_ExposureBaseCenter 0xD05B 1461 #define PTP_DPC_NIKON_ExposureBaseSpot 0xD05C 1462 #define PTP_DPC_NIKON_LiveViewAF 0xD05D 1463 #define PTP_DPC_NIKON_AELockMode 0xD05E 1464 #define PTP_DPC_NIKON_AELAFLMode 0xD05F 1465 #define PTP_DPC_NIKON_MeterOff 0xD062 1466 #define PTP_DPC_NIKON_SelfTimer 0xD063 1467 #define PTP_DPC_NIKON_MonitorOff 0xD064 1468 #define PTP_DPC_NIKON_ImgConfTime 0xD065 1469 #define PTP_DPC_NIKON_AngleLevel 0xD067 1470 #define PTP_DPC_NIKON_D1ShootingSpeed 0xD068 /* continous speed low */ 1471 #define PTP_DPC_NIKON_D2MaximumShots 0xD069 1472 #define PTP_DPC_NIKON_D3ExpDelayMode 0xD06A 1473 #define PTP_DPC_NIKON_LongExposureNoiseReduction 0xD06B 1474 #define PTP_DPC_NIKON_FileNumberSequence 0xD06C 1475 #define PTP_DPC_NIKON_ControlPanelFinderRearControl 0xD06D 1476 #define PTP_DPC_NIKON_ControlPanelFinderViewfinder 0xD06E 1477 #define PTP_DPC_NIKON_D7Illumination 0xD06F 1478 #define PTP_DPC_NIKON_NrHighISO 0xD070 1479 #define PTP_DPC_NIKON_SHSET_CH_GUID_DISP 0xD071 1480 #define PTP_DPC_NIKON_ArtistName 0xD072 1481 #define PTP_DPC_NIKON_CopyrightInfo 0xD073 1482 #define PTP_DPC_NIKON_FlashSyncSpeed 0xD074 1483 #define PTP_DPC_NIKON_FlashShutterSpeed 0xD075 /* SB Low Limit */ 1484 #define PTP_DPC_NIKON_E3AAFlashMode 0xD076 1485 #define PTP_DPC_NIKON_E4ModelingFlash 0xD077 1486 #define PTP_DPC_NIKON_BracketSet 0xD078 /* Bracket Type? */ 1487 #define PTP_DPC_NIKON_E6ManualModeBracketing 0xD079 /* Bracket Factor? */ 1488 #define PTP_DPC_NIKON_BracketOrder 0xD07A 1489 #define PTP_DPC_NIKON_E8AutoBracketSelection 0xD07B /* Bracket Method? */ 1490 #define PTP_DPC_NIKON_BracketingSet 0xD07C 1491 #define PTP_DPC_NIKON_F1CenterButtonShootingMode 0xD080 1492 #define PTP_DPC_NIKON_CenterButtonPlaybackMode 0xD081 1493 #define PTP_DPC_NIKON_F2Multiselector 0xD082 1494 #define PTP_DPC_NIKON_F3PhotoInfoPlayback 0xD083 /* MultiSelector Dir */ 1495 #define PTP_DPC_NIKON_F4AssignFuncButton 0xD084 /* CMD Dial Rotate */ 1496 #define PTP_DPC_NIKON_F5CustomizeCommDials 0xD085 /* CMD Dial Change */ 1497 #define PTP_DPC_NIKON_ReverseCommandDial 0xD086 /* CMD Dial FN Set */ 1498 #define PTP_DPC_NIKON_ApertureSetting 0xD087 /* CMD Dial Active */ 1499 #define PTP_DPC_NIKON_MenusAndPlayback 0xD088 /* CMD Dial Active */ 1500 #define PTP_DPC_NIKON_F6ButtonsAndDials 0xD089 /* Universal Mode? */ 1501 #define PTP_DPC_NIKON_NoCFCard 0xD08A /* Enable Shutter? */ 1502 #define PTP_DPC_NIKON_CenterButtonZoomRatio 0xD08B 1503 #define PTP_DPC_NIKON_FunctionButton2 0xD08C 1504 #define PTP_DPC_NIKON_AFAreaPoint 0xD08D 1505 #define PTP_DPC_NIKON_NormalAFOn 0xD08E 1506 #define PTP_DPC_NIKON_ImageCommentString 0xD090 1507 #define PTP_DPC_NIKON_ImageCommentEnable 0xD091 1508 #define PTP_DPC_NIKON_ImageRotation 0xD092 1509 #define PTP_DPC_NIKON_ManualSetLensNo 0xD093 1510 #define PTP_DPC_NIKON_MovScreenSize 0xD0A0 1511 #define PTP_DPC_NIKON_MovVoice 0xD0A1 1512 #define PTP_DPC_NIKON_Bracketing 0xD0C0 1513 #define PTP_DPC_NIKON_AutoExposureBracketStep 0xD0C1 1514 #define PTP_DPC_NIKON_AutoExposureBracketProgram 0xD0C2 1515 #define PTP_DPC_NIKON_AutoExposureBracketCount 0xD0C3 1516 #define PTP_DPC_NIKON_WhiteBalanceBracketStep 0xD0C4 1517 #define PTP_DPC_NIKON_WhiteBalanceBracketProgram 0xD0C5 1518 #define PTP_DPC_NIKON_LensID 0xD0E0 1519 #define PTP_DPC_NIKON_LensSort 0xD0E1 1520 #define PTP_DPC_NIKON_LensType 0xD0E2 1521 #define PTP_DPC_NIKON_FocalLengthMin 0xD0E3 1522 #define PTP_DPC_NIKON_FocalLengthMax 0xD0E4 1523 #define PTP_DPC_NIKON_MaxApAtMinFocalLength 0xD0E5 1524 #define PTP_DPC_NIKON_MaxApAtMaxFocalLength 0xD0E6 1525 #define PTP_DPC_NIKON_FinderISODisp 0xD0F0 1526 #define PTP_DPC_NIKON_AutoOffPhoto 0xD0F2 1527 #define PTP_DPC_NIKON_AutoOffMenu 0xD0F3 1528 #define PTP_DPC_NIKON_AutoOffInfo 0xD0F4 1529 #define PTP_DPC_NIKON_SelfTimerShootNum 0xD0F5 1530 #define PTP_DPC_NIKON_VignetteCtrl 0xD0F7 1531 #define PTP_DPC_NIKON_ExposureTime 0xD100 /* Shutter Speed */ 1532 #define PTP_DPC_NIKON_ACPower 0xD101 1533 #define PTP_DPC_NIKON_WarningStatus 0xD102 1534 #define PTP_DPC_NIKON_MaximumShots 0xD103 /* remain shots (in RAM buffer?) */ 1535 #define PTP_DPC_NIKON_AFLockStatus 0xD104 1536 #define PTP_DPC_NIKON_AELockStatus 0xD105 1537 #define PTP_DPC_NIKON_FVLockStatus 0xD106 1538 #define PTP_DPC_NIKON_AutofocusLCDTopMode2 0xD107 1539 #define PTP_DPC_NIKON_AutofocusArea 0xD108 1540 #define PTP_DPC_NIKON_FlexibleProgram 0xD109 1541 #define PTP_DPC_NIKON_LightMeter 0xD10A /* Exposure Status */ 1542 #define PTP_DPC_NIKON_RecordingMedia 0xD10B /* Card or SDRAM */ 1543 #define PTP_DPC_NIKON_USBSpeed 0xD10C 1544 #define PTP_DPC_NIKON_CCDNumber 0xD10D 1545 #define PTP_DPC_NIKON_CameraOrientation 0xD10E 1546 #define PTP_DPC_NIKON_GroupPtnType 0xD10F 1547 #define PTP_DPC_NIKON_FNumberLock 0xD110 1548 #define PTP_DPC_NIKON_ExposureApertureLock 0xD111 /* shutterspeed lock*/ 1549 #define PTP_DPC_NIKON_TVLockSetting 0xD112 1550 #define PTP_DPC_NIKON_AVLockSetting 0xD113 1551 #define PTP_DPC_NIKON_IllumSetting 0xD114 1552 #define PTP_DPC_NIKON_FocusPointBright 0xD115 1553 #define PTP_DPC_NIKON_ExternalFlashAttached 0xD120 1554 #define PTP_DPC_NIKON_ExternalFlashStatus 0xD121 1555 #define PTP_DPC_NIKON_ExternalFlashSort 0xD122 1556 #define PTP_DPC_NIKON_ExternalFlashMode 0xD123 1557 #define PTP_DPC_NIKON_ExternalFlashCompensation 0xD124 1558 #define PTP_DPC_NIKON_NewExternalFlashMode 0xD125 1559 #define PTP_DPC_NIKON_FlashExposureCompensation 0xD126 1560 #define PTP_DPC_NIKON_OptimizeImage 0xD140 1561 #define PTP_DPC_NIKON_Saturation 0xD142 1562 #define PTP_DPC_NIKON_BW_FillerEffect 0xD143 1563 #define PTP_DPC_NIKON_BW_Sharpness 0xD144 1564 #define PTP_DPC_NIKON_BW_Contrast 0xD145 1565 #define PTP_DPC_NIKON_BW_Setting_Type 0xD146 1566 #define PTP_DPC_NIKON_Slot2SaveMode 0xD148 1567 #define PTP_DPC_NIKON_RawBitMode 0xD149 1568 #define PTP_DPC_NIKON_ISOAutoTime 0xD14E 1569 #define PTP_DPC_NIKON_FlourescentType 0xD14F 1570 #define PTP_DPC_NIKON_TuneColourTemperature 0xD150 1571 #define PTP_DPC_NIKON_TunePreset0 0xD151 1572 #define PTP_DPC_NIKON_TunePreset1 0xD152 1573 #define PTP_DPC_NIKON_TunePreset2 0xD153 1574 #define PTP_DPC_NIKON_TunePreset3 0xD154 1575 #define PTP_DPC_NIKON_TunePreset4 0xD155 1576 #define PTP_DPC_NIKON_BeepOff 0xD160 1577 #define PTP_DPC_NIKON_AutofocusMode 0xD161 1578 #define PTP_DPC_NIKON_AFAssist 0xD163 1579 #define PTP_DPC_NIKON_PADVPMode 0xD164 /* iso auto time */ 1580 #define PTP_DPC_NIKON_ImageReview 0xD165 1581 #define PTP_DPC_NIKON_AFAreaIllumination 0xD166 1582 #define PTP_DPC_NIKON_FlashMode 0xD167 1583 #define PTP_DPC_NIKON_FlashCommanderMode 0xD168 1584 #define PTP_DPC_NIKON_FlashSign 0xD169 1585 #define PTP_DPC_NIKON_ISO_Auto 0xD16A 1586 #define PTP_DPC_NIKON_RemoteTimeout 0xD16B 1587 #define PTP_DPC_NIKON_GridDisplay 0xD16C 1588 #define PTP_DPC_NIKON_FlashModeManualPower 0xD16D 1589 #define PTP_DPC_NIKON_FlashModeCommanderPower 0xD16E 1590 #define PTP_DPC_NIKON_AutoFP 0xD16F 1591 #define PTP_DPC_NIKON_CSMMenu 0xD180 1592 #define PTP_DPC_NIKON_WarningDisplay 0xD181 1593 #define PTP_DPC_NIKON_BatteryCellKind 0xD182 1594 #define PTP_DPC_NIKON_ISOAutoHiLimit 0xD183 1595 #define PTP_DPC_NIKON_DynamicAFArea 0xD184 1596 #define PTP_DPC_NIKON_ContinuousSpeedHigh 0xD186 1597 #define PTP_DPC_NIKON_InfoDispSetting 0xD187 1598 #define PTP_DPC_NIKON_PreviewButton 0xD189 1599 #define PTP_DPC_NIKON_PreviewButton2 0xD18A 1600 #define PTP_DPC_NIKON_AEAFLockButton2 0xD18B 1601 #define PTP_DPC_NIKON_IndicatorDisp 0xD18D 1602 #define PTP_DPC_NIKON_CellKindPriority 0xD18E 1603 #define PTP_DPC_NIKON_BracketingFramesAndSteps 0xD190 1604 #define PTP_DPC_NIKON_LiveViewMode 0xD1A0 1605 #define PTP_DPC_NIKON_LiveViewDriveMode 0xD1A1 1606 #define PTP_DPC_NIKON_LiveViewStatus 0xD1A2 1607 #define PTP_DPC_NIKON_LiveViewImageZoomRatio 0xD1A3 1608 #define PTP_DPC_NIKON_LiveViewProhibitCondition 0xD1A4 1609 #define PTP_DPC_NIKON_ExposureDisplayStatus 0xD1B0 1610 #define PTP_DPC_NIKON_ExposureIndicateStatus 0xD1B1 1611 #define PTP_DPC_NIKON_InfoDispErrStatus 0xD1B2 1612 #define PTP_DPC_NIKON_ExposureIndicateLightup 0xD1B3 1613 #define PTP_DPC_NIKON_FlashOpen 0xD1C0 1614 #define PTP_DPC_NIKON_FlashCharged 0xD1C1 1615 #define PTP_DPC_NIKON_FlashMRepeatValue 0xD1D0 1616 #define PTP_DPC_NIKON_FlashMRepeatCount 0xD1D1 1617 #define PTP_DPC_NIKON_FlashMRepeatInterval 0xD1D2 1618 #define PTP_DPC_NIKON_FlashCommandChannel 0xD1D3 1619 #define PTP_DPC_NIKON_FlashCommandSelfMode 0xD1D4 1620 #define PTP_DPC_NIKON_FlashCommandSelfCompensation 0xD1D5 1621 #define PTP_DPC_NIKON_FlashCommandSelfValue 0xD1D6 1622 #define PTP_DPC_NIKON_FlashCommandAMode 0xD1D7 1623 #define PTP_DPC_NIKON_FlashCommandACompensation 0xD1D8 1624 #define PTP_DPC_NIKON_FlashCommandAValue 0xD1D9 1625 #define PTP_DPC_NIKON_FlashCommandBMode 0xD1DA 1626 #define PTP_DPC_NIKON_FlashCommandBCompensation 0xD1DB 1627 #define PTP_DPC_NIKON_FlashCommandBValue 0xD1DC 1628 #define PTP_DPC_NIKON_ActivePicCtrlItem 0xD200 1629 #define PTP_DPC_NIKON_ChangePicCtrlItem 0xD201 1630 1631 /* Microsoft/MTP specific */ 1632 #define PTP_DPC_MTP_SecureTime 0xD101 1633 #define PTP_DPC_MTP_DeviceCertificate 0xD102 1634 #define PTP_DPC_MTP_RevocationInfo 0xD103 1635 #define PTP_DPC_MTP_SynchronizationPartner 0xD401 1636 #define PTP_DPC_MTP_DeviceFriendlyName 0xD402 1637 #define PTP_DPC_MTP_VolumeLevel 0xD403 1638 #define PTP_DPC_MTP_DeviceIcon 0xD405 1639 #define PTP_DPC_MTP_SessionInitiatorInfo 0xD406 1640 #define PTP_DPC_MTP_PerceivedDeviceType 0xD407 1641 #define PTP_DPC_MTP_PlaybackRate 0xD410 1642 #define PTP_DPC_MTP_PlaybackObject 0xD411 1643 #define PTP_DPC_MTP_PlaybackContainerIndex 0xD412 1644 #define PTP_DPC_MTP_PlaybackPosition 0xD413 1645 #define PTP_DPC_MTP_PlaysForSureID 0xD131 1646 1647 /* Zune specific property codes */ 1648 #define PTP_DPC_MTP_Zune_UnknownVersion 0xD181 1649 1650 /* MTP specific Object Properties */ 1651 #define PTP_OPC_StorageID 0xDC01 1652 #define PTP_OPC_ObjectFormat 0xDC02 1653 #define PTP_OPC_ProtectionStatus 0xDC03 1654 #define PTP_OPC_ObjectSize 0xDC04 1655 #define PTP_OPC_AssociationType 0xDC05 1656 #define PTP_OPC_AssociationDesc 0xDC06 1657 #define PTP_OPC_ObjectFileName 0xDC07 1658 #define PTP_OPC_DateCreated 0xDC08 1659 #define PTP_OPC_DateModified 0xDC09 1660 #define PTP_OPC_Keywords 0xDC0A 1661 #define PTP_OPC_ParentObject 0xDC0B 1662 #define PTP_OPC_AllowedFolderContents 0xDC0C 1663 #define PTP_OPC_Hidden 0xDC0D 1664 #define PTP_OPC_SystemObject 0xDC0E 1665 #define PTP_OPC_PersistantUniqueObjectIdentifier 0xDC41 1666 #define PTP_OPC_SyncID 0xDC42 1667 #define PTP_OPC_PropertyBag 0xDC43 1668 #define PTP_OPC_Name 0xDC44 1669 #define PTP_OPC_CreatedBy 0xDC45 1670 #define PTP_OPC_Artist 0xDC46 1671 #define PTP_OPC_DateAuthored 0xDC47 1672 #define PTP_OPC_Description 0xDC48 1673 #define PTP_OPC_URLReference 0xDC49 1674 #define PTP_OPC_LanguageLocale 0xDC4A 1675 #define PTP_OPC_CopyrightInformation 0xDC4B 1676 #define PTP_OPC_Source 0xDC4C 1677 #define PTP_OPC_OriginLocation 0xDC4D 1678 #define PTP_OPC_DateAdded 0xDC4E 1679 #define PTP_OPC_NonConsumable 0xDC4F 1680 #define PTP_OPC_CorruptOrUnplayable 0xDC50 1681 #define PTP_OPC_ProducerSerialNumber 0xDC51 1682 #define PTP_OPC_RepresentativeSampleFormat 0xDC81 1683 #define PTP_OPC_RepresentativeSampleSize 0xDC82 1684 #define PTP_OPC_RepresentativeSampleHeight 0xDC83 1685 #define PTP_OPC_RepresentativeSampleWidth 0xDC84 1686 #define PTP_OPC_RepresentativeSampleDuration 0xDC85 1687 #define PTP_OPC_RepresentativeSampleData 0xDC86 1688 #define PTP_OPC_Width 0xDC87 1689 #define PTP_OPC_Height 0xDC88 1690 #define PTP_OPC_Duration 0xDC89 1691 #define PTP_OPC_Rating 0xDC8A 1692 #define PTP_OPC_Track 0xDC8B 1693 #define PTP_OPC_Genre 0xDC8C 1694 #define PTP_OPC_Credits 0xDC8D 1695 #define PTP_OPC_Lyrics 0xDC8E 1696 #define PTP_OPC_SubscriptionContentID 0xDC8F 1697 #define PTP_OPC_ProducedBy 0xDC90 1698 #define PTP_OPC_UseCount 0xDC91 1699 #define PTP_OPC_SkipCount 0xDC92 1700 #define PTP_OPC_LastAccessed 0xDC93 1701 #define PTP_OPC_ParentalRating 0xDC94 1702 #define PTP_OPC_MetaGenre 0xDC95 1703 #define PTP_OPC_Composer 0xDC96 1704 #define PTP_OPC_EffectiveRating 0xDC97 1705 #define PTP_OPC_Subtitle 0xDC98 1706 #define PTP_OPC_OriginalReleaseDate 0xDC99 1707 #define PTP_OPC_AlbumName 0xDC9A 1708 #define PTP_OPC_AlbumArtist 0xDC9B 1709 #define PTP_OPC_Mood 0xDC9C 1710 #define PTP_OPC_DRMStatus 0xDC9D 1711 #define PTP_OPC_SubDescription 0xDC9E 1712 #define PTP_OPC_IsCropped 0xDCD1 1713 #define PTP_OPC_IsColorCorrected 0xDCD2 1714 #define PTP_OPC_ImageBitDepth 0xDCD3 1715 #define PTP_OPC_Fnumber 0xDCD4 1716 #define PTP_OPC_ExposureTime 0xDCD5 1717 #define PTP_OPC_ExposureIndex 0xDCD6 1718 #define PTP_OPC_DisplayName 0xDCE0 1719 #define PTP_OPC_BodyText 0xDCE1 1720 #define PTP_OPC_Subject 0xDCE2 1721 #define PTP_OPC_Priority 0xDCE3 1722 #define PTP_OPC_GivenName 0xDD00 1723 #define PTP_OPC_MiddleNames 0xDD01 1724 #define PTP_OPC_FamilyName 0xDD02 1725 #define PTP_OPC_Prefix 0xDD03 1726 #define PTP_OPC_Suffix 0xDD04 1727 #define PTP_OPC_PhoneticGivenName 0xDD05 1728 #define PTP_OPC_PhoneticFamilyName 0xDD06 1729 #define PTP_OPC_EmailPrimary 0xDD07 1730 #define PTP_OPC_EmailPersonal1 0xDD08 1731 #define PTP_OPC_EmailPersonal2 0xDD09 1732 #define PTP_OPC_EmailBusiness1 0xDD0A 1733 #define PTP_OPC_EmailBusiness2 0xDD0B 1734 #define PTP_OPC_EmailOthers 0xDD0C 1735 #define PTP_OPC_PhoneNumberPrimary 0xDD0D 1736 #define PTP_OPC_PhoneNumberPersonal 0xDD0E 1737 #define PTP_OPC_PhoneNumberPersonal2 0xDD0F 1738 #define PTP_OPC_PhoneNumberBusiness 0xDD10 1739 #define PTP_OPC_PhoneNumberBusiness2 0xDD11 1740 #define PTP_OPC_PhoneNumberMobile 0xDD12 1741 #define PTP_OPC_PhoneNumberMobile2 0xDD13 1742 #define PTP_OPC_FaxNumberPrimary 0xDD14 1743 #define PTP_OPC_FaxNumberPersonal 0xDD15 1744 #define PTP_OPC_FaxNumberBusiness 0xDD16 1745 #define PTP_OPC_PagerNumber 0xDD17 1746 #define PTP_OPC_PhoneNumberOthers 0xDD18 1747 #define PTP_OPC_PrimaryWebAddress 0xDD19 1748 #define PTP_OPC_PersonalWebAddress 0xDD1A 1749 #define PTP_OPC_BusinessWebAddress 0xDD1B 1750 #define PTP_OPC_InstantMessengerAddress 0xDD1C 1751 #define PTP_OPC_InstantMessengerAddress2 0xDD1D 1752 #define PTP_OPC_InstantMessengerAddress3 0xDD1E 1753 #define PTP_OPC_PostalAddressPersonalFull 0xDD1F 1754 #define PTP_OPC_PostalAddressPersonalFullLine1 0xDD20 1755 #define PTP_OPC_PostalAddressPersonalFullLine2 0xDD21 1756 #define PTP_OPC_PostalAddressPersonalFullCity 0xDD22 1757 #define PTP_OPC_PostalAddressPersonalFullRegion 0xDD23 1758 #define PTP_OPC_PostalAddressPersonalFullPostalCode 0xDD24 1759 #define PTP_OPC_PostalAddressPersonalFullCountry 0xDD25 1760 #define PTP_OPC_PostalAddressBusinessFull 0xDD26 1761 #define PTP_OPC_PostalAddressBusinessLine1 0xDD27 1762 #define PTP_OPC_PostalAddressBusinessLine2 0xDD28 1763 #define PTP_OPC_PostalAddressBusinessCity 0xDD29 1764 #define PTP_OPC_PostalAddressBusinessRegion 0xDD2A 1765 #define PTP_OPC_PostalAddressBusinessPostalCode 0xDD2B 1766 #define PTP_OPC_PostalAddressBusinessCountry 0xDD2C 1767 #define PTP_OPC_PostalAddressOtherFull 0xDD2D 1768 #define PTP_OPC_PostalAddressOtherLine1 0xDD2E 1769 #define PTP_OPC_PostalAddressOtherLine2 0xDD2F 1770 #define PTP_OPC_PostalAddressOtherCity 0xDD30 1771 #define PTP_OPC_PostalAddressOtherRegion 0xDD31 1772 #define PTP_OPC_PostalAddressOtherPostalCode 0xDD32 1773 #define PTP_OPC_PostalAddressOtherCountry 0xDD33 1774 #define PTP_OPC_OrganizationName 0xDD34 1775 #define PTP_OPC_PhoneticOrganizationName 0xDD35 1776 #define PTP_OPC_Role 0xDD36 1777 #define PTP_OPC_Birthdate 0xDD37 1778 #define PTP_OPC_MessageTo 0xDD40 1779 #define PTP_OPC_MessageCC 0xDD41 1780 #define PTP_OPC_MessageBCC 0xDD42 1781 #define PTP_OPC_MessageRead 0xDD43 1782 #define PTP_OPC_MessageReceivedTime 0xDD44 1783 #define PTP_OPC_MessageSender 0xDD45 1784 #define PTP_OPC_ActivityBeginTime 0xDD50 1785 #define PTP_OPC_ActivityEndTime 0xDD51 1786 #define PTP_OPC_ActivityLocation 0xDD52 1787 #define PTP_OPC_ActivityRequiredAttendees 0xDD54 1788 #define PTP_OPC_ActivityOptionalAttendees 0xDD55 1789 #define PTP_OPC_ActivityResources 0xDD56 1790 #define PTP_OPC_ActivityAccepted 0xDD57 1791 #define PTP_OPC_Owner 0xDD5D 1792 #define PTP_OPC_Editor 0xDD5E 1793 #define PTP_OPC_Webmaster 0xDD5F 1794 #define PTP_OPC_URLSource 0xDD60 1795 #define PTP_OPC_URLDestination 0xDD61 1796 #define PTP_OPC_TimeBookmark 0xDD62 1797 #define PTP_OPC_ObjectBookmark 0xDD63 1798 #define PTP_OPC_ByteBookmark 0xDD64 1799 #define PTP_OPC_LastBuildDate 0xDD70 1800 #define PTP_OPC_TimetoLive 0xDD71 1801 #define PTP_OPC_MediaGUID 0xDD72 1802 #define PTP_OPC_TotalBitRate 0xDE91 1803 #define PTP_OPC_BitRateType 0xDE92 1804 #define PTP_OPC_SampleRate 0xDE93 1805 #define PTP_OPC_NumberOfChannels 0xDE94 1806 #define PTP_OPC_AudioBitDepth 0xDE95 1807 #define PTP_OPC_ScanDepth 0xDE97 1808 #define PTP_OPC_AudioWAVECodec 0xDE99 1809 #define PTP_OPC_AudioBitRate 0xDE9A 1810 #define PTP_OPC_VideoFourCCCodec 0xDE9B 1811 #define PTP_OPC_VideoBitRate 0xDE9C 1812 #define PTP_OPC_FramesPerThousandSeconds 0xDE9D 1813 #define PTP_OPC_KeyFrameDistance 0xDE9E 1814 #define PTP_OPC_BufferSize 0xDE9F 1815 #define PTP_OPC_EncodingQuality 0xDEA0 1816 #define PTP_OPC_EncodingProfile 0xDEA1 1817 #define PTP_OPC_BuyFlag 0xD901 1818 1819 /* WiFi Provisioning MTP Extension property codes */ 1820 #define PTP_OPC_WirelessConfigurationFile 0xB104 1821 1822 /* Device Property Form Flag */ 1823 1824 #define PTP_DPFF_None 0x00 1825 #define PTP_DPFF_Range 0x01 1826 #define PTP_DPFF_Enumeration 0x02 1827 1828 /* Object Property Codes used by MTP (first 3 are same as DPFF codes) */ 1829 #define PTP_OPFF_None 0x00 1830 #define PTP_OPFF_Range 0x01 1831 #define PTP_OPFF_Enumeration 0x02 1832 #define PTP_OPFF_DateTime 0x03 1833 #define PTP_OPFF_FixedLengthArray 0x04 1834 #define PTP_OPFF_RegularExpression 0x05 1835 #define PTP_OPFF_ByteArray 0x06 1836 #define PTP_OPFF_LongString 0xFF 1837 1838 /* Device Property GetSet type */ 1839 #define PTP_DPGS_Get 0x00 1840 #define PTP_DPGS_GetSet 0x01 1841 1842 /* Glue stuff starts here */ 1843 1844 typedef struct _PTPParams PTPParams; 1845 1846 1847 typedef uint16_t (* PTPDataGetFunc) (PTPParams* params, void*priv, 1848 unsigned long wantlen, 1849 unsigned char *data, unsigned long *gotlen); 1850 1851 typedef uint16_t (* PTPDataPutFunc) (PTPParams* params, void*priv, 1852 unsigned long sendlen, 1853 unsigned char *data, unsigned long *putlen); 1854 typedef struct _PTPDataHandler { 1855 PTPDataGetFunc getfunc; 1856 PTPDataPutFunc putfunc; 1857 void *priv; 1858 } PTPDataHandler; 1859 1860 /* 1861 * This functions take PTP oriented arguments and send them over an 1862 * appropriate data layer doing byteorder conversion accordingly. 1863 */ 1864 typedef uint16_t (* PTPIOSendReq) (PTPParams* params, PTPContainer* req); 1865 typedef uint16_t (* PTPIOSendData) (PTPParams* params, PTPContainer* ptp, 1866 unsigned long size, PTPDataHandler*getter); 1867 1868 typedef uint16_t (* PTPIOGetResp) (PTPParams* params, PTPContainer* resp); 1869 typedef uint16_t (* PTPIOGetData) (PTPParams* params, PTPContainer* ptp, 1870 PTPDataHandler *putter); 1871 typedef uint16_t (* PTPIOCancelReq) (PTPParams* params, uint32_t transaction_id); 1872 1873 /* debug functions */ 1874 typedef void (* PTPErrorFunc) (void *data, const char *format, va_list args) 1875 #if (__GNUC__ >= 3) 1876 __attribute__((__format__(printf,2,0))) 1877 #endif 1878 ; 1879 typedef void (* PTPDebugFunc) (void *data, const char *format, va_list args) 1880 #if (__GNUC__ >= 3) 1881 __attribute__((__format__(printf,2,0))) 1882 #endif 1883 ; 1884 1885 struct _PTPObject { 1886 uint32_t oid; 1887 unsigned int flags; 1888 #define PTPOBJECT_OBJECTINFO_LOADED (1<<0) 1889 #define PTPOBJECT_CANONFLAGS_LOADED (1<<1) 1890 #define PTPOBJECT_MTPPROPLIST_LOADED (1<<2) 1891 #define PTPOBJECT_DIRECTORY_LOADED (1<<3) 1892 #define PTPOBJECT_PARENTOBJECT_LOADED (1<<4) 1893 #define PTPOBJECT_STORAGEID_LOADED (1<<5) 1894 1895 PTPObjectInfo oi; 1896 uint32_t canon_flags; 1897 MTPProperties *mtpprops; 1898 int nrofmtpprops; 1899 }; 1900 typedef struct _PTPObject PTPObject; 1901 1902 struct _PTPParams { 1903 /* device flags */ 1904 uint32_t device_flags; 1905 1906 /* data layer byteorder */ 1907 uint8_t byteorder; 1908 uint16_t maxpacketsize; 1909 1910 /* PTP IO: Custom IO functions */ 1911 PTPIOSendReq sendreq_func; 1912 PTPIOSendData senddata_func; 1913 PTPIOGetResp getresp_func; 1914 PTPIOGetData getdata_func; 1915 PTPIOGetResp event_check; 1916 PTPIOGetResp event_wait; 1917 PTPIOCancelReq cancelreq_func; 1918 1919 /* Custom error and debug function */ 1920 PTPErrorFunc error_func; 1921 PTPDebugFunc debug_func; 1922 1923 /* Data passed to above functions */ 1924 void *data; 1925 1926 /* ptp transaction ID */ 1927 uint32_t transaction_id; 1928 /* ptp session ID */ 1929 uint32_t session_id; 1930 1931 /* PTP IO: if we have MTP style split header/data transfers */ 1932 int split_header_data; 1933 1934 /* PTP: internal structures used by ptp driver */ 1935 PTPObject *objects; 1936 int nrofobjects; 1937 1938 PTPDeviceInfo deviceinfo; 1939 1940 /* PTP: the current event queue */ 1941 PTPContainer *events; 1942 int nrofevents; 1943 1944 /* PTP: Canon specific flags list */ 1945 PTPCanon_Property *canon_props; 1946 int nrofcanon_props; 1947 int canon_viewfinder_on; 1948 1949 /* PTP: Canon EOS event queue */ 1950 PTPCanon_changes_entry *backlogentries; 1951 int nrofbacklogentries; 1952 int eos_captureenabled; 1953 1954 /* PTP: Wifi profiles */ 1955 uint8_t wifi_profiles_version; 1956 uint8_t wifi_profiles_number; 1957 PTPNIKONWifiProfile *wifi_profiles; 1958 1959 /* IO: PTP/IP related data */ 1960 int cmdfd, evtfd; 1961 uint8_t cameraguid[16]; 1962 uint32_t eventpipeid; 1963 char *cameraname; 1964 1965 #ifdef HAVE_ICONV 1966 /* PTP: iconv converters */ 1967 iconv_t cd_locale_to_ucs2; 1968 iconv_t cd_ucs2_to_locale; 1969 #endif 1970 1971 /* IO: Sometimes the response packet get send in the dataphase 1972 * too. This only happens for a Samsung player now. 1973 */ 1974 uint8_t *response_packet; 1975 uint16_t response_packet_size; 1976 }; 1977 1978 /* last, but not least - ptp functions */ 1979 uint16_t ptp_usb_sendreq (PTPParams* params, PTPContainer* req); 1980 uint16_t ptp_usb_senddata (PTPParams* params, PTPContainer* ptp, 1981 unsigned long size, PTPDataHandler *handler); 1982 uint16_t ptp_usb_getresp (PTPParams* params, PTPContainer* resp); 1983 uint16_t ptp_usb_getdata (PTPParams* params, PTPContainer* ptp, 1984 PTPDataHandler *handler); 1985 uint16_t ptp_usb_event_check (PTPParams* params, PTPContainer* event); 1986 uint16_t ptp_usb_event_wait (PTPParams* params, PTPContainer* event); 1987 1988 uint16_t ptp_usb_control_get_extended_event_data (PTPParams *params, char *buffer, int *size); 1989 uint16_t ptp_usb_control_device_reset_request (PTPParams *params); 1990 uint16_t ptp_usb_control_get_device_status (PTPParams *params, char *buffer, int *size); 1991 uint16_t ptp_usb_control_cancel_request (PTPParams *params, uint32_t transid); 1992 1993 1994 int ptp_ptpip_connect (PTPParams* params, const char *port); 1995 uint16_t ptp_ptpip_sendreq (PTPParams* params, PTPContainer* req); 1996 uint16_t ptp_ptpip_senddata (PTPParams* params, PTPContainer* ptp, 1997 unsigned long size, PTPDataHandler *handler); 1998 uint16_t ptp_ptpip_getresp (PTPParams* params, PTPContainer* resp); 1999 uint16_t ptp_ptpip_getdata (PTPParams* params, PTPContainer* ptp, 2000 PTPDataHandler *handler); 2001 uint16_t ptp_ptpip_event_wait (PTPParams* params, PTPContainer* event); 2002 uint16_t ptp_ptpip_event_check (PTPParams* params, PTPContainer* event); 2003 2004 uint16_t ptp_getdeviceinfo (PTPParams* params, PTPDeviceInfo* deviceinfo); 2005 2006 uint16_t ptp_generic_no_data (PTPParams* params, uint16_t opcode, unsigned int cnt, ...); 2007 2008 uint16_t ptp_opensession (PTPParams *params, uint32_t session); 2009 2010 /** 2011 * ptp_closesession: 2012 * params: PTPParams* 2013 * 2014 * Closes session. 2015 * 2016 * Return values: Some PTP_RC_* code. 2017 **/ 2018 #define ptp_closesession(params) ptp_generic_no_data(params,PTP_OC_CloseSession,0) 2019 /** 2020 * ptp_resetdevice: 2021 * params: PTPParams* 2022 * 2023 * Uses the built-in function to reset the device 2024 * 2025 * Return values: Some PTP_RC_* code. 2026 * 2027 */ 2028 #define ptp_resetdevice(params) ptp_generic_no_data(params,PTP_OC_ResetDevice,0) 2029 2030 uint16_t ptp_getstorageids (PTPParams* params, PTPStorageIDs* storageids); 2031 uint16_t ptp_getstorageinfo (PTPParams* params, uint32_t storageid, 2032 PTPStorageInfo* storageinfo); 2033 /** 2034 * ptp_formatstore: 2035 * params: PTPParams* 2036 * storageid - StorageID 2037 * 2038 * Formats the storage on the device. 2039 * 2040 * Return values: Some PTP_RC_* code. 2041 **/ 2042 #define ptp_formatstore(params,storageid) ptp_generic_no_data(params,PTP_OC_FormatStore,1,storageid) 2043 2044 uint16_t ptp_getobjecthandles (PTPParams* params, uint32_t storage, 2045 uint32_t objectformatcode, 2046 uint32_t associationOH, 2047 PTPObjectHandles* objecthandles); 2048 2049 uint16_t ptp_getnumobjects (PTPParams* params, uint32_t storage, 2050 uint32_t objectformatcode, 2051 uint32_t associationOH, 2052 uint32_t* numobs); 2053 2054 uint16_t ptp_getobjectinfo (PTPParams *params, uint32_t handle, 2055 PTPObjectInfo* objectinfo); 2056 2057 uint16_t ptp_getobject (PTPParams *params, uint32_t handle, 2058 unsigned char** object); 2059 uint16_t ptp_getobject_tofd (PTPParams* params, uint32_t handle, int fd); 2060 uint16_t ptp_getobject_to_handler (PTPParams* params, uint32_t handle, PTPDataHandler*); 2061 uint16_t ptp_getpartialobject (PTPParams* params, uint32_t handle, uint32_t offset, 2062 uint32_t maxbytes, unsigned char** object); 2063 uint16_t ptp_getthumb (PTPParams *params, uint32_t handle, 2064 unsigned char** object); 2065 2066 uint16_t ptp_deleteobject (PTPParams* params, uint32_t handle, 2067 uint32_t ofc); 2068 2069 uint16_t ptp_sendobjectinfo (PTPParams* params, uint32_t* store, 2070 uint32_t* parenthandle, uint32_t* handle, 2071 PTPObjectInfo* objectinfo); 2072 /** 2073 * ptp_setobjectprotection: 2074 * params: PTPParams* 2075 * uint16_t newprot - object protection flag 2076 * 2077 * Set protection of object. 2078 * 2079 * Return values: Some PTP_RC_* code. 2080 * 2081 */ 2082 #define ptp_setobjectprotection(params,oid,newprot) ptp_generic_no_data(params,PTP_OC_SetObjectProtection,2,oid,newprot) 2083 uint16_t ptp_sendobject (PTPParams* params, unsigned char* object, 2084 uint32_t size); 2085 uint16_t ptp_sendobject_fromfd (PTPParams* params, int fd, uint32_t size); 2086 uint16_t ptp_sendobject_from_handler (PTPParams* params, PTPDataHandler*, uint32_t size); 2087 /** 2088 * ptp_initiatecapture: 2089 * params: PTPParams* 2090 * storageid - destination StorageID on Responder 2091 * ofc - object format code 2092 * 2093 * Causes device to initiate the capture of one or more new data objects 2094 * according to its current device properties, storing the data into store 2095 * indicated by storageid. If storageid is 0x00000000, the object(s) will 2096 * be stored in a store that is determined by the capturing device. 2097 * The capturing of new data objects is an asynchronous operation. 2098 * 2099 * Return values: Some PTP_RC_* code. 2100 **/ 2101 #define ptp_initiatecapture(params,storageid,ofc) ptp_generic_no_data(params,PTP_OC_InitiateCapture,2,storageid,ofc) 2102 2103 uint16_t ptp_getdevicepropdesc (PTPParams* params, uint16_t propcode, 2104 PTPDevicePropDesc *devicepropertydesc); 2105 uint16_t ptp_getdevicepropvalue (PTPParams* params, uint16_t propcode, 2106 PTPPropertyValue* value, uint16_t datatype); 2107 uint16_t ptp_setdevicepropvalue (PTPParams* params, uint16_t propcode, 2108 PTPPropertyValue* value, uint16_t datatype); 2109 2110 2111 uint16_t ptp_check_event (PTPParams *params); 2112 int ptp_get_one_event (PTPParams *params, PTPContainer *evt); 2113 2114 /* Microsoft MTP extensions */ 2115 uint16_t ptp_mtp_getobjectpropdesc (PTPParams* params, uint16_t opc, uint16_t ofc, 2116 PTPObjectPropDesc *objectpropertydesc); 2117 uint16_t ptp_mtp_getobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc, 2118 PTPPropertyValue *value, uint16_t datatype); 2119 uint16_t ptp_mtp_setobjectpropvalue (PTPParams* params, uint32_t oid, uint16_t opc, 2120 PTPPropertyValue *value, uint16_t datatype); 2121 uint16_t ptp_mtp_getobjectreferences (PTPParams* params, uint32_t handle, uint32_t** ohArray, uint32_t* arraylen); 2122 uint16_t ptp_mtp_setobjectreferences (PTPParams* params, uint32_t handle, uint32_t* ohArray, uint32_t arraylen); 2123 uint16_t ptp_mtp_getobjectproplist (PTPParams* params, uint32_t handle, MTPProperties **props, int *nrofprops); 2124 uint16_t ptp_mtp_sendobjectproplist (PTPParams* params, uint32_t* store, uint32_t* parenthandle, uint32_t* handle, 2125 uint16_t objecttype, uint64_t objectsize, MTPProperties *props, int nrofprops); 2126 uint16_t ptp_mtp_setobjectproplist (PTPParams* params, MTPProperties *props, int nrofprops); 2127 2128 /* Eastman Kodak extensions */ 2129 uint16_t ptp_ek_9007 (PTPParams* params, unsigned char **serial, unsigned int *size); 2130 uint16_t ptp_ek_9009 (PTPParams* params, uint32_t*, uint32_t*); 2131 uint16_t ptp_ek_900c (PTPParams* params, unsigned char **serial, unsigned int *size); 2132 uint16_t ptp_ek_getserial (PTPParams* params, unsigned char **serial, unsigned int *size); 2133 uint16_t ptp_ek_setserial (PTPParams* params, unsigned char *serial, unsigned int size); 2134 uint16_t ptp_ek_settext (PTPParams* params, PTPEKTextParams *text); 2135 uint16_t ptp_ek_sendfileobjectinfo (PTPParams* params, uint32_t* store, 2136 uint32_t* parenthandle, uint32_t* handle, 2137 PTPObjectInfo* objectinfo); 2138 uint16_t ptp_ek_sendfileobject (PTPParams* params, unsigned char* object, 2139 uint32_t size); 2140 uint16_t ptp_ek_sendfileobject_from_handler (PTPParams* params, PTPDataHandler*, 2141 uint32_t size); 2142 2143 /* Canon PTP extensions */ 2144 #define ptp_canon_9012(params) ptp_generic_no_data(params,0x9012,0) 2145 uint16_t ptp_canon_gettreeinfo (PTPParams* params, uint32_t* out); 2146 uint16_t ptp_canon_gettreesize (PTPParams* params, PTPCanon_directtransfer_entry**, unsigned int*cnt); 2147 uint16_t ptp_canon_getpartialobjectinfo (PTPParams* params, uint32_t handle, 2148 uint32_t p2, uint32_t* size, uint32_t* rp2); 2149 2150 uint16_t ptp_canon_get_mac_address (PTPParams* params, unsigned char **mac); 2151 /** 2152 * ptp_canon_startshootingmode: 2153 * params: PTPParams* 2154 * 2155 * Starts shooting session. It emits a StorageInfoChanged 2156 * event via the interrupt pipe and pushes the StorageInfoChanged 2157 * and CANON_CameraModeChange events onto the event stack 2158 * (see operation PTP_OC_CANON_CheckEvent). 2159 * 2160 * Return values: Some PTP_RC_* code. 2161 * 2162 **/ 2163 #define ptp_canon_startshootingmode(params) ptp_generic_no_data(params,PTP_OC_CANON_InitiateReleaseControl,0) 2164 /** 2165 * ptp_canon_endshootingmode: 2166 * params: PTPParams* 2167 * 2168 * This operation is observed after pressing the Disconnect 2169 * button on the Remote Capture app. It emits a StorageInfoChanged 2170 * event via the interrupt pipe and pushes the StorageInfoChanged 2171 * and CANON_CameraModeChange events onto the event stack 2172 * (see operation PTP_OC_CANON_CheckEvent). 2173 * 2174 * Return values: Some PTP_RC_* code. 2175 * 2176 **/ 2177 #define ptp_canon_endshootingmode(params) ptp_generic_no_data(params,PTP_OC_CANON_TerminateReleaseControl,0) 2178 /** 2179 * ptp_canon_viewfinderon: 2180 * params: PTPParams* 2181 * 2182 * Prior to start reading viewfinder images, one must call this operation. 2183 * Supposedly, this operation affects the value of the CANON_ViewfinderMode 2184 * property. 2185 * 2186 * Return values: Some PTP_RC_* code. 2187 * 2188 **/ 2189 #define ptp_canon_viewfinderon(params) ptp_generic_no_data(params,PTP_OC_CANON_ViewfinderOn,0) 2190 /** 2191 * ptp_canon_viewfinderoff: 2192 * params: PTPParams* 2193 * 2194 * Before changing the shooting mode, or when one doesn't need to read 2195 * viewfinder images any more, one must call this operation. 2196 * Supposedly, this operation affects the value of the CANON_ViewfinderMode 2197 * property. 2198 * 2199 * Return values: Some PTP_RC_* code. 2200 * 2201 **/ 2202 #define ptp_canon_viewfinderoff(params) ptp_generic_no_data(params,PTP_OC_CANON_ViewfinderOff,0) 2203 /** 2204 * ptp_canon_reset_aeafawb: 2205 * params: PTPParams* 2206 * uint32_t flags - what shall be reset. 2207 * 1 - autoexposure 2208 * 2 - autofocus 2209 * 4 - autowhitebalance 2210 * 2211 * Called "Reset AeAfAwb" (auto exposure, focus, white balance) 2212 * 2213 * Return values: Some PTP_RC_* code. 2214 **/ 2215 #define PTP_CANON_RESET_AE 0x1 2216 #define PTP_CANON_RESET_AF 0x2 2217 #define PTP_CANON_RESET_AWB 0x4 2218 #define ptp_canon_reset_aeafawb(params,flags) ptp_generic_no_data(params,PTP_OC_CANON_DoAeAfAwb,1,flags) 2219 uint16_t ptp_canon_checkevent (PTPParams* params, 2220 PTPContainer* event, int* isevent); 2221 /** 2222 * ptp_canon_focuslock: 2223 * 2224 * This operation locks the focus. It is followed by the CANON_GetChanges(?) 2225 * operation in the log. 2226 * It affects the CANON_MacroMode property. 2227 * 2228 * params: PTPParams* 2229 * 2230 * Return values: Some PTP_RC_* code. 2231 * 2232 **/ 2233 #define ptp_canon_focuslock(params) ptp_generic_no_data(params,PTP_OC_CANON_FocusLock,0) 2234 /** 2235 * ptp_canon_focusunlock: 2236 * 2237 * This operation unlocks the focus. It is followed by the CANON_GetChanges(?) 2238 * operation in the log. 2239 * It sets the CANON_MacroMode property value to 1 (where it occurs in the log). 2240 * 2241 * params: PTPParams* 2242 * 2243 * Return values: Some PTP_RC_* code. 2244 * 2245 **/ 2246 #define ptp_canon_focusunlock(params) ptp_generic_no_data(params,PTP_OC_CANON_FocusUnlock,0) 2247 /** 2248 * ptp_canon_keepdeviceon: 2249 * 2250 * This operation sends a "ping" style message to the camera. 2251 * 2252 * params: PTPParams* 2253 * 2254 * Return values: Some PTP_RC_* code. 2255 * 2256 **/ 2257 #define ptp_canon_keepdeviceon(params) ptp_generic_no_data(params,PTP_OC_CANON_KeepDeviceOn,0) 2258 /** 2259 * ptp_canon_eos_keepdeviceon: 2260 * 2261 * This operation sends a "ping" style message to the camera. 2262 * 2263 * params: PTPParams* 2264 * 2265 * Return values: Some PTP_RC_* code. 2266 * 2267 **/ 2268 #define ptp_canon_eos_keepdeviceon(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_KeepDeviceOn,0) 2269 /** 2270 * ptp_canon_initiatecaptureinmemory: 2271 * 2272 * This operation starts the image capture according to the current camera 2273 * settings. When the capture has happened, the camera emits a CaptureComplete 2274 * event via the interrupt pipe and pushes the CANON_RequestObjectTransfer, 2275 * CANON_DeviceInfoChanged and CaptureComplete events onto the event stack 2276 * (see operation CANON_CheckEvent). From the CANON_RequestObjectTransfer 2277 * event's parameter one can learn the just captured image's ObjectHandle. 2278 * The image is stored in the camera's own RAM. 2279 * On the next capture the image will be overwritten! 2280 * 2281 * params: PTPParams* 2282 * 2283 * Return values: Some PTP_RC_* code. 2284 * 2285 **/ 2286 #define ptp_canon_initiatecaptureinmemory(params) ptp_generic_no_data(params,PTP_OC_CANON_InitiateCaptureInMemory,0) 2287 /** 2288 * ptp_canon_eos_requestdevicepropvalue: 2289 * 2290 * This operation sends a "ping" style message to the camera. 2291 * 2292 * params: PTPParams* 2293 * 2294 * Return values: Some PTP_RC_* code. 2295 * 2296 **/ 2297 #define ptp_canon_eos_requestdevicepropvalue(params,prop) ptp_generic_no_data(params,PTP_OC_CANON_EOS_RequestDevicePropValue,1,prop) 2298 /** 2299 * ptp_canon_eos_capture: 2300 * 2301 * This starts a EOS400D style capture. You have to use the 2302 * 0x9116 command to poll for its completion. 2303 * The image is saved on the CF Card currently. 2304 * 2305 * params: PTPParams* 2306 * 2307 * Return values: Some PTP_RC_* code. 2308 * 2309 **/ 2310 #define ptp_canon_eos_capture(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_RemoteRelease,0) 2311 uint16_t ptp_canon_eos_getevent (PTPParams* params, PTPCanon_changes_entry **entries, int *nrofentries); 2312 uint16_t ptp_canon_getpartialobject (PTPParams* params, uint32_t handle, 2313 uint32_t offset, uint32_t size, 2314 uint32_t pos, unsigned char** block, 2315 uint32_t* readnum); 2316 uint16_t ptp_canon_getviewfinderimage (PTPParams* params, unsigned char** image, 2317 uint32_t* size); 2318 uint16_t ptp_canon_getchanges (PTPParams* params, uint16_t** props, 2319 uint32_t* propnum); 2320 uint16_t ptp_canon_getobjectinfo (PTPParams* params, uint32_t store, 2321 uint32_t p2, uint32_t parenthandle, 2322 uint32_t handle, 2323 PTPCANONFolderEntry** entries, 2324 uint32_t* entnum); 2325 uint16_t ptp_canon_eos_getdeviceinfo (PTPParams* params, PTPCanonEOSDeviceInfo*di); 2326 /** 2327 * ptp_canon_eos_setuilock: 2328 * 2329 * This command sets UI lock 2330 * 2331 * params: PTPParams* 2332 * 2333 * Return values: Some PTP_RC_* code. 2334 * 2335 **/ 2336 #define ptp_canon_eos_setuilock(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_SetUILock,0) 2337 /** 2338 * ptp_canon_eos_resetuilock: 2339 * 2340 * This command sets UI lock 2341 * 2342 * params: PTPParams* 2343 * 2344 * Return values: Some PTP_RC_* code. 2345 * 2346 **/ 2347 #define ptp_canon_eos_resetuilock(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_ResetUILock,0) 2348 /** 2349 * ptp_canon_eos_start_viewfinder: 2350 * 2351 * This command starts Viewfinder mode of newer Canon DSLRs. 2352 * 2353 * params: PTPParams* 2354 * 2355 * Return values: Some PTP_RC_* code. 2356 * 2357 **/ 2358 #define ptp_canon_eos_start_viewfinder(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_InitiateViewfinder,0) 2359 /** 2360 * ptp_canon_eos_end_viewfinder: 2361 * 2362 * This command ends Viewfinder mode of newer Canon DSLRs. 2363 * 2364 * params: PTPParams* 2365 * 2366 * Return values: Some PTP_RC_* code. 2367 * 2368 **/ 2369 #define ptp_canon_eos_end_viewfinder(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_TerminateViewfinder,0) 2370 uint16_t ptp_canon_eos_get_viewfinder_image (PTPParams* params, unsigned char **data, unsigned int *size); 2371 uint16_t ptp_canon_get_objecthandle_by_name (PTPParams* params, char* name, uint32_t* objectid); 2372 uint16_t ptp_canon_get_directory (PTPParams* params, PTPObjectHandles *handles, PTPObjectInfo **oinfos, uint32_t **flags); 2373 /** 2374 * ptp_canon_setobjectarchive: 2375 * 2376 * params: PTPParams* 2377 * uint32_t objectid 2378 * uint32_t flags 2379 * 2380 * Return values: Some PTP_RC_* code. 2381 * 2382 **/ 2383 #define ptp_canon_setobjectarchive(params,oid,flags) ptp_generic_no_data(params,PTP_OC_CANON_SetObjectArchive,2,oid,flags) 2384 uint16_t ptp_canon_get_customize_data (PTPParams* params, uint32_t themenr, 2385 unsigned char **data, unsigned int *size); 2386 uint16_t ptp_canon_getpairinginfo (PTPParams* params, uint32_t nr, unsigned char**, unsigned int*); 2387 2388 uint16_t ptp_canon_eos_getstorageids (PTPParams* params, PTPStorageIDs* storageids); 2389 uint16_t ptp_canon_eos_getstorageinfo (PTPParams* params, uint32_t p1); 2390 uint16_t ptp_canon_eos_getpartialobject (PTPParams* params, uint32_t oid, uint32_t off, uint32_t xsize, unsigned char**data); 2391 uint16_t ptp_canon_eos_setdevicepropvalueex (PTPParams* params, unsigned char* data, unsigned int size); 2392 #define ptp_canon_eos_setremotemode(params,p1) ptp_generic_no_data(params,PTP_OC_CANON_EOS_SetRemoteMode,1,p1) 2393 #define ptp_canon_eos_seteventmode(params,p1) ptp_generic_no_data(params,PTP_OC_CANON_EOS_SetEventMode,1,p1) 2394 /** 2395 * ptp_canon_eos_transfercomplete: 2396 * 2397 * This ends a direct object transfer from an EOS camera. 2398 * 2399 * params: PTPParams* 2400 * oid Object ID 2401 * 2402 * Return values: Some PTP_RC_* code. 2403 * 2404 */ 2405 #define ptp_canon_eos_transfercomplete(params,oid) ptp_generic_no_data(params,PTP_OC_CANON_EOS_TransferComplete,1,oid) 2406 /* inHDD = %d, inLength =%d, inReset = %d */ 2407 #define ptp_canon_eos_pchddcapacity(params,p1,p2,p3) ptp_generic_no_data(params,PTP_OC_CANON_EOS_PCHDDCapacity,3,p1,p2,p3) 2408 #define ptp_canon_eos_bulbstart(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_BulbStart,1) 2409 #define ptp_canon_eos_bulbend(params) ptp_generic_no_data(params,PTP_OC_CANON_EOS_BulbEnd,1) 2410 uint16_t ptp_canon_eos_getdevicepropdesc (PTPParams* params, uint16_t propcode, 2411 PTPDevicePropDesc *devicepropertydesc); 2412 uint16_t ptp_canon_eos_setdevicepropvalue (PTPParams* params, uint16_t propcode, 2413 PTPPropertyValue* value, uint16_t datatype); 2414 uint16_t ptp_nikon_get_vendorpropcodes (PTPParams* params, uint16_t **props, unsigned int *size); 2415 uint16_t ptp_nikon_curve_download (PTPParams* params, 2416 unsigned char **data, unsigned int *size); 2417 uint16_t ptp_nikon_getptpipinfo (PTPParams* params, unsigned char **data, unsigned int *size); 2418 uint16_t ptp_nikon_getwifiprofilelist (PTPParams* params); 2419 uint16_t ptp_nikon_writewifiprofile (PTPParams* params, PTPNIKONWifiProfile* profile); 2420 /** 2421 * ptp_nikon_deletewifiprofile: 2422 * 2423 * This command deletes a wifi profile. 2424 * 2425 * params: PTPParams* 2426 * unsigned int profilenr - profile number 2427 * 2428 * Return values: Some PTP_RC_* code. 2429 * 2430 **/ 2431 #define ptp_nikon_deletewifiprofile(params,profilenr) ptp_generic_no_data(params,PTP_OC_NIKON_DeleteProfile,1,profilenr) 2432 /** 2433 * ptp_nikon_setcontrolmode: 2434 * 2435 * This command can switch the camera to full PC control mode. 2436 * 2437 * params: PTPParams* 2438 * uint32_t mode - mode 2439 * 2440 * Return values: Some PTP_RC_* code. 2441 * 2442 **/ 2443 #define ptp_nikon_setcontrolmode(params,mode) ptp_generic_no_data(params,PTP_OC_NIKON_SetControlMode,1,mode) 2444 /** 2445 * ptp_nikon_afdrive: 2446 * 2447 * This command runs (drives) the lens autofocus. 2448 * 2449 * params: PTPParams* 2450 * 2451 * Return values: Some PTP_RC_* code. 2452 * 2453 **/ 2454 #define ptp_nikon_afdrive(params) ptp_generic_no_data(params,PTP_OC_NIKON_AfDrive,0) 2455 /** 2456 * ptp_nikon_mfdrive: 2457 * 2458 * This command runs (drives) the lens autofocus. 2459 * 2460 * params: PTPParams* 2461 * flag: 0x1 for (no limit - closest), 0x2 for (closest - no limit) 2462 * amount: amount of steps 2463 * 2464 * Return values: Some PTP_RC_* code. 2465 * 2466 **/ 2467 #define ptp_nikon_mfdrive(params,flag,amount) ptp_generic_no_data(params,PTP_OC_NIKON_MfDrive,2,flag,amount) 2468 /** 2469 * ptp_nikon_capture: 2470 * 2471 * This command captures a picture on the Nikon. 2472 * 2473 * params: PTPParams* 2474 * uint32_t x - unknown parameter. seen to be -1. 2475 * 2476 * Return values: Some PTP_RC_* code. 2477 * 2478 **/ 2479 #define ptp_nikon_capture(params,x) ptp_generic_no_data(params,PTP_OC_NIKON_Capture,1,x) 2480 /** 2481 * ptp_nikon_capture_sdram: 2482 * 2483 * This command captures a picture on the Nikon. 2484 * 2485 * params: PTPParams* 2486 * 2487 * Return values: Some PTP_RC_* code. 2488 * 2489 **/ 2490 #define ptp_nikon_capture_sdram(params) ptp_generic_no_data(params,PTP_OC_NIKON_AfCaptureSDRAM,0) 2491 /** 2492 * ptp_nikon_start_liveview: 2493 * 2494 * This command starts LiveView mode of newer Nikons DSLRs. 2495 * 2496 * params: PTPParams* 2497 * 2498 * Return values: Some PTP_RC_* code. 2499 * 2500 **/ 2501 #define ptp_nikon_start_liveview(params) ptp_generic_no_data(params,PTP_OC_NIKON_StartLiveView,0) 2502 uint16_t ptp_nikon_get_liveview_image (PTPParams* params, unsigned char**,unsigned int*); 2503 uint16_t ptp_nikon_get_preview_image (PTPParams* params, unsigned char**, unsigned int*, uint32_t*); 2504 /** 2505 * ptp_nikon_end_liveview: 2506 * 2507 * This command ends LiveView mode of newer Nikons DSLRs. 2508 * 2509 * params: PTPParams* 2510 * 2511 * Return values: Some PTP_RC_* code. 2512 * 2513 **/ 2514 #define ptp_nikon_end_liveview(params) ptp_generic_no_data(params,PTP_OC_NIKON_EndLiveView,0) 2515 uint16_t ptp_nikon_check_event (PTPParams* params, PTPContainer **evt, int *evtcnt); 2516 uint16_t ptp_nikon_getfileinfoinblock (PTPParams* params, uint32_t p1, uint32_t p2, uint32_t p3, 2517 unsigned char **data, unsigned int *size); 2518 /** 2519 * ptp_nikon_device_ready: 2520 * 2521 * This command checks if the device is ready. Used after 2522 * a capture. 2523 * 2524 * params: PTPParams* 2525 * 2526 * Return values: Some PTP_RC_* code. 2527 * 2528 **/ 2529 #define ptp_nikon_device_ready(params) ptp_generic_no_data (params, PTP_OC_NIKON_DeviceReady, 0) 2530 uint16_t ptp_mtp_getobjectpropssupported (PTPParams* params, uint16_t ofc, uint32_t *propnum, uint16_t **props); 2531 2532 /* Non PTP protocol functions */ 2533 int ptp_operation_issupported (PTPParams* params, uint16_t operation); 2534 int ptp_event_issupported (PTPParams* params, uint16_t event); 2535 int ptp_property_issupported (PTPParams* params, uint16_t property); 2536 2537 void ptp_free_devicepropdesc (PTPDevicePropDesc* dpd); 2538 void ptp_free_devicepropvalue (uint16_t dt, PTPPropertyValue* dpd); 2539 void ptp_free_objectpropdesc (PTPObjectPropDesc* dpd); 2540 void ptp_free_params (PTPParams *params); 2541 void ptp_free_objectinfo (PTPObjectInfo *oi); 2542 void ptp_free_object (PTPObject *oi); 2543 2544 void ptp_perror (PTPParams* params, uint16_t error); 2545 2546 const char* 2547 ptp_get_property_description(PTPParams* params, uint16_t dpc); 2548 2549 int 2550 ptp_render_property_value(PTPParams* params, uint16_t dpc, 2551 PTPDevicePropDesc *dpd, int length, char *out); 2552 int ptp_render_ofc(PTPParams* params, uint16_t ofc, int spaceleft, char *txt); 2553 int ptp_render_opcode(PTPParams* params, uint16_t opcode, int spaceleft, char *txt); 2554 int ptp_render_mtp_propname(uint16_t propid, int spaceleft, char *txt); 2555 MTPProperties *ptp_get_new_object_prop_entry(MTPProperties **props, int *nrofprops); 2556 void ptp_destroy_object_prop(MTPProperties *prop); 2557 void ptp_destroy_object_prop_list(MTPProperties *props, int nrofprops); 2558 MTPProperties *ptp_find_object_prop_in_cache(PTPParams *params, uint32_t const handle, uint32_t const attribute_id); 2559 void ptp_remove_object_from_cache(PTPParams *params, uint32_t handle); 2560 uint16_t ptp_add_object_to_cache(PTPParams *params, uint32_t handle); 2561 uint16_t ptp_object_want (PTPParams *, uint32_t handle, int want, PTPObject**retob); 2562 void ptp_objects_sort (PTPParams *); 2563 uint16_t ptp_object_find (PTPParams *params, uint32_t handle, PTPObject **retob); 2564 uint16_t ptp_object_find_or_insert (PTPParams *params, uint32_t handle, PTPObject **retob); 2565 /* ptpip.c */ 2566 void ptp_nikon_getptpipguid (unsigned char* guid); 2567 2568 #ifdef __cplusplus 2569 } 2570 #endif /* __cplusplus */ 2571 2572 #endif /* __PTP_H__ */ 2573