| /* ptp.h |
| * |
| * Copyright (C) 2001-2004 Mariusz Woloszyn <emsi@ipartners.pl> |
| * |
| * This file is part of libptp2. |
| * |
| * libptp2 is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU General Public License as published by |
| * the Free Software Foundation; either version 2 of the License, or |
| * (at your option) any later version. |
| * |
| * libptp2 is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License |
| * along with libptp2; if not, write to the Free Software |
| * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| */ |
| |
| #ifndef __PTP_H__ |
| #define __PTP_H__ |
| |
| #include <stdarg.h> |
| #include <time.h> |
| #include "libptp-endian.h" |
| |
| /** The callback type */ |
| typedef int Progress_Callback(u_int32_t sent, u_int32_t total); |
| |
| /* PTP datalayer byteorder */ |
| |
| #define PTP_DL_BE 0xF0 |
| #define PTP_DL_LE 0x0F |
| |
| /* PTP request/response/event general PTP container (transport independent) */ |
| |
| struct _PTPContainer { |
| uint16_t Code; |
| uint32_t SessionID; |
| uint32_t Transaction_ID; |
| /* params may be of any type of size less or equal to uint32_t */ |
| uint32_t Param1; |
| uint32_t Param2; |
| uint32_t Param3; |
| /* events can only have three parameters */ |
| uint32_t Param4; |
| uint32_t Param5; |
| /* the number of meaningfull parameters */ |
| uint8_t Nparam; |
| }; |
| typedef struct _PTPContainer PTPContainer; |
| |
| /* PTP USB Bulk-Pipe container */ |
| /* USB bulk max max packet length for high speed endpoints */ |
| #define PTP_USB_BULK_HS_MAX_PACKET_LEN 512 |
| #define PTP_USB_BULK_HDR_LEN (2*sizeof(uint32_t)+2*sizeof(uint16_t)) |
| #define PTP_USB_BULK_PAYLOAD_LEN (PTP_USB_BULK_HS_MAX_PACKET_LEN-PTP_USB_BULK_HDR_LEN) |
| #define PTP_USB_BULK_REQ_LEN (PTP_USB_BULK_HDR_LEN+5*sizeof(uint32_t)) |
| |
| /* see ptp.c:ptp_usb_senddata for info on these sizes |
| added by RAL 2005-12-21 */ |
| #define BLOCK_SIZE 0xe000 |
| #define MTP_DEVICE_BUF_SIZE 0x200 |
| /* the amount of data between each progress report. Must be multiple of BLOCK_SIZE */ |
| #define CALLBACK_SIZE (BLOCK_SIZE*16) |
| |
| struct _PTPUSBBulkContainer { |
| uint32_t length; |
| uint16_t type; |
| uint16_t code; |
| uint32_t trans_id; |
| union { |
| struct { |
| uint32_t param1; |
| uint32_t param2; |
| uint32_t param3; |
| uint32_t param4; |
| uint32_t param5; |
| } params; |
| ////unsigned char data[PTP_USB_BULK_PAYLOAD_LEN]; |
| } payload; |
| }; |
| typedef struct _PTPUSBBulkContainer PTPUSBBulkContainer; |
| |
| /* USB Bulk Container to send - see ptp.c:ptp_usb_senddata for more info |
| added by RAL 2005-12-21 */ |
| struct _PTPUSBBulkContainerSend { |
| uint32_t length; |
| uint16_t type; |
| uint16_t code; |
| uint32_t trans_id; |
| }; |
| typedef struct _PTPUSBBulkContainerSend PTPUSBBulkContainerSend; |
| |
| /* PTP USB Asynchronous Event Interrupt Data Format */ |
| struct _PTPUSBEventContainer { |
| uint32_t length; |
| uint16_t type; |
| uint16_t code; |
| uint32_t trans_id; |
| uint32_t param1; |
| uint32_t param2; |
| uint32_t param3; |
| }; |
| typedef struct _PTPUSBEventContainer PTPUSBEventContainer; |
| |
| |
| /* USB container types */ |
| |
| #define PTP_USB_CONTAINER_UNDEFINED 0x0000 |
| #define PTP_USB_CONTAINER_COMMAND 0x0001 |
| #define PTP_USB_CONTAINER_DATA 0x0002 |
| #define PTP_USB_CONTAINER_RESPONSE 0x0003 |
| #define PTP_USB_CONTAINER_EVENT 0x0004 |
| |
| /* Vendor IDs */ |
| #define PTP_VENDOR_EASTMAN_KODAK 0x00000001 |
| #define PTP_VENDOR_SEIKO_EPSON 0x00000002 |
| #define PTP_VENDOR_AGILENT 0x00000003 |
| #define PTP_VENDOR_POLAROID 0x00000004 |
| #define PTP_VENDOR_AGFA_GEVAERT 0x00000005 |
| #define PTP_VENDOR_MICROSOFT 0x00000006 |
| #define PTP_VENDOR_EQUINOX 0x00000007 |
| #define PTP_VENDOR_VIEWQUEST 0x00000008 |
| #define PTP_VENDOR_STMICROELECTRONICS 0x00000009 |
| #define PTP_VENDOR_NIKON 0x0000000A |
| #define PTP_VENDOR_CANON 0x0000000B |
| |
| /* Operation Codes */ |
| |
| #define PTP_OC_Undefined 0x1000 |
| #define PTP_OC_GetDeviceInfo 0x1001 |
| #define PTP_OC_OpenSession 0x1002 |
| #define PTP_OC_CloseSession 0x1003 |
| #define PTP_OC_GetStorageIDs 0x1004 |
| #define PTP_OC_GetStorageInfo 0x1005 |
| #define PTP_OC_GetNumObjects 0x1006 |
| #define PTP_OC_GetObjectHandles 0x1007 |
| #define PTP_OC_GetObjectInfo 0x1008 |
| #define PTP_OC_GetObject 0x1009 |
| #define PTP_OC_GetThumb 0x100A |
| #define PTP_OC_DeleteObject 0x100B |
| #define PTP_OC_SendObjectInfo 0x100C |
| #define PTP_OC_SendObject 0x100D |
| #define PTP_OC_InitiateCapture 0x100E |
| #define PTP_OC_FormatStore 0x100F |
| #define PTP_OC_ResetDevice 0x1010 |
| #define PTP_OC_SelfTest 0x1011 |
| #define PTP_OC_SetObjectProtection 0x1012 |
| #define PTP_OC_PowerDown 0x1013 |
| #define PTP_OC_GetDevicePropDesc 0x1014 |
| #define PTP_OC_GetDevicePropValue 0x1015 |
| #define PTP_OC_SetDevicePropValue 0x1016 |
| #define PTP_OC_ResetDevicePropValue 0x1017 |
| #define PTP_OC_TerminateOpenCapture 0x1018 |
| #define PTP_OC_MoveObject 0x1019 |
| #define PTP_OC_CopyObject 0x101A |
| #define PTP_OC_GetPartialObject 0x101B |
| #define PTP_OC_InitiateOpenCapture 0x101C |
| /* Eastman Kodak extension Operation Codes */ |
| #define PTP_OC_EK_SendFileObjectInfo 0x9005 |
| #define PTP_OC_EK_SendFileObject 0x9006 |
| /* Canon extension Operation Codes */ |
| #define PTP_OC_CANON_GetObjectSize 0x9001 |
| #define PTP_OC_CANON_StartShootingMode 0x9008 |
| #define PTP_OC_CANON_EndShootingMode 0x9009 |
| #define PTP_OC_CANON_ViewfinderOn 0x900B |
| #define PTP_OC_CANON_ViewfinderOff 0x900C |
| #define PTP_OC_CANON_ReflectChanges 0x900D |
| #define PTP_OC_CANON_CheckEvent 0x9013 |
| #define PTP_OC_CANON_FocusLock 0x9014 |
| #define PTP_OC_CANON_FocusUnlock 0x9015 |
| #define PTP_OC_CANON_InitiateCaptureInMemory 0x901A |
| #define PTP_OC_CANON_GetPartialObject 0x901B |
| #define PTP_OC_CANON_GetViewfinderImage 0x901d |
| #define PTP_OC_CANON_GetChanges 0x9020 |
| #define PTP_OC_CANON_GetFolderEntries 0x9021 |
| |
| /* Proprietary vendor extension operations mask */ |
| #define PTP_OC_EXTENSION_MASK 0xF000 |
| #define PTP_OC_EXTENSION 0x9000 |
| |
| /* Response Codes */ |
| |
| #define PTP_RC_Undefined 0x2000 |
| #define PTP_RC_OK 0x2001 |
| #define PTP_RC_GeneralError 0x2002 |
| #define PTP_RC_SessionNotOpen 0x2003 |
| #define PTP_RC_InvalidTransactionID 0x2004 |
| #define PTP_RC_OperationNotSupported 0x2005 |
| #define PTP_RC_ParameterNotSupported 0x2006 |
| #define PTP_RC_IncompleteTransfer 0x2007 |
| #define PTP_RC_InvalidStorageId 0x2008 |
| #define PTP_RC_InvalidObjectHandle 0x2009 |
| #define PTP_RC_DevicePropNotSupported 0x200A |
| #define PTP_RC_InvalidObjectFormatCode 0x200B |
| #define PTP_RC_StoreFull 0x200C |
| #define PTP_RC_ObjectWriteProtected 0x200D |
| #define PTP_RC_StoreReadOnly 0x200E |
| #define PTP_RC_AccessDenied 0x200F |
| #define PTP_RC_NoThumbnailPresent 0x2010 |
| #define PTP_RC_SelfTestFailed 0x2011 |
| #define PTP_RC_PartialDeletion 0x2012 |
| #define PTP_RC_StoreNotAvailable 0x2013 |
| #define PTP_RC_SpecificationByFormatUnsupported 0x2014 |
| #define PTP_RC_NoValidObjectInfo 0x2015 |
| #define PTP_RC_InvalidCodeFormat 0x2016 |
| #define PTP_RC_UnknownVendorCode 0x2017 |
| #define PTP_RC_CaptureAlreadyTerminated 0x2018 |
| #define PTP_RC_DeviceBusy 0x2019 |
| #define PTP_RC_InvalidParentObject 0x201A |
| #define PTP_RC_InvalidDevicePropFormat 0x201B |
| #define PTP_RC_InvalidDevicePropValue 0x201C |
| #define PTP_RC_InvalidParameter 0x201D |
| #define PTP_RC_SessionAlreadyOpened 0x201E |
| #define PTP_RC_TransactionCanceled 0x201F |
| #define PTP_RC_SpecificationOfDestinationUnsupported 0x2020 |
| /* Eastman Kodak extension Response Codes */ |
| #define PTP_RC_EK_FilenameRequired 0xA001 |
| #define PTP_RC_EK_FilenameConflicts 0xA002 |
| #define PTP_RC_EK_FilenameInvalid 0xA003 |
| |
| /* Proprietary vendor extension response code mask */ |
| #define PTP_RC_EXTENSION_MASK 0xF000 |
| #define PTP_RC_EXTENSION 0xA000 |
| |
| /* libptp2 extended ERROR codes */ |
| #define PTP_ERROR_IO 0x02FF |
| #define PTP_ERROR_DATA_EXPECTED 0x02FE |
| #define PTP_ERROR_RESP_EXPECTED 0x02FD |
| #define PTP_ERROR_BADPARAM 0x02FC |
| |
| /* PTP Event Codes */ |
| |
| #define PTP_EC_Undefined 0x4000 |
| #define PTP_EC_CancelTransaction 0x4001 |
| #define PTP_EC_ObjectAdded 0x4002 |
| #define PTP_EC_ObjectRemoved 0x4003 |
| #define PTP_EC_StoreAdded 0x4004 |
| #define PTP_EC_StoreRemoved 0x4005 |
| #define PTP_EC_DevicePropChanged 0x4006 |
| #define PTP_EC_ObjectInfoChanged 0x4007 |
| #define PTP_EC_DeviceInfoChanged 0x4008 |
| #define PTP_EC_RequestObjectTransfer 0x4009 |
| #define PTP_EC_StoreFull 0x400A |
| #define PTP_EC_DeviceReset 0x400B |
| #define PTP_EC_StorageInfoChanged 0x400C |
| #define PTP_EC_CaptureComplete 0x400D |
| #define PTP_EC_UnreportedStatus 0x400E |
| /* Canon extension Event Codes */ |
| #define PTP_EC_CANON_DeviceInfoChanged 0xC008 |
| #define PTP_EC_CANON_RequestObjectTransfer 0xC009 |
| #define PTP_EC_CANON_CameraModeChanged 0xC00C |
| |
| /* constants for GetObjectHandles */ |
| #define PTP_GOH_ALL_STORAGE 0xffffffff |
| #define PTP_GOH_ALL_FORMATS 0x00000000 |
| #define PTP_GOH_ALL_ASSOCS 0x00000000 |
| |
| /* PTP device info structure (returned by GetDevInfo) */ |
| |
| struct _PTPDeviceInfo { |
| uint16_t StaqndardVersion; |
| uint32_t VendorExtensionID; |
| uint16_t VendorExtensionVersion; |
| char *VendorExtensionDesc; |
| uint16_t FunctionalMode; |
| uint32_t OperationsSupported_len; |
| uint16_t *OperationsSupported; |
| uint32_t EventsSupported_len; |
| uint16_t *EventsSupported; |
| uint32_t DevicePropertiesSupported_len; |
| uint16_t *DevicePropertiesSupported; |
| uint32_t CaptureFormats_len; |
| uint16_t *CaptureFormats; |
| uint32_t ImageFormats_len; |
| uint16_t *ImageFormats; |
| char *Manufacturer; |
| char *Model; |
| char *DeviceVersion; |
| char *SerialNumber; |
| }; |
| typedef struct _PTPDeviceInfo PTPDeviceInfo; |
| |
| /* PTP storageIDs structute (returned by GetStorageIDs) */ |
| |
| struct _PTPStorageIDs { |
| uint32_t n; |
| uint32_t *Storage; |
| }; |
| typedef struct _PTPStorageIDs PTPStorageIDs; |
| |
| /* PTP StorageInfo structure (returned by GetStorageInfo) */ |
| struct _PTPStorageInfo { |
| uint16_t StorageType; |
| uint16_t FilesystemType; |
| uint16_t AccessCapability; |
| uint64_t MaxCapability; |
| uint64_t FreeSpaceInBytes; |
| uint32_t FreeSpaceInImages; |
| char *StorageDescription; |
| char *VolumeLabel; |
| }; |
| typedef struct _PTPStorageInfo PTPStorageInfo; |
| |
| /* PTP objecthandles structure (returned by GetObjectHandles) */ |
| |
| struct _PTPObjectHandles { |
| uint32_t n; |
| uint32_t *Handler; |
| }; |
| typedef struct _PTPObjectHandles PTPObjectHandles; |
| |
| #define PTP_HANDLER_SPECIAL 0xffffffff |
| #define PTP_HANDLER_ROOT 0x00000000 |
| |
| |
| /* PTP objectinfo structure (returned by GetObjectInfo) */ |
| |
| struct _PTPObjectInfo { |
| uint32_t StorageID; |
| uint16_t ObjectFormat; |
| uint16_t ProtectionStatus; |
| uint32_t ObjectCompressedSize; |
| uint16_t ThumbFormat; |
| uint32_t ThumbCompressedSize; |
| uint32_t ThumbPixWidth; |
| uint32_t ThumbPixHeight; |
| uint32_t ImagePixWidth; |
| uint32_t ImagePixHeight; |
| uint32_t ImageBitDepth; |
| uint32_t ParentObject; |
| uint16_t AssociationType; |
| uint32_t AssociationDesc; |
| uint32_t SequenceNumber; |
| char *Filename; |
| time_t CaptureDate; |
| time_t ModificationDate; |
| char *Keywords; |
| }; |
| typedef struct _PTPObjectInfo PTPObjectInfo; |
| |
| /* max ptp string length INCLUDING terminating null character */ |
| |
| #define PTP_MAXSTRLEN 255 |
| |
| /* PTP Object Format Codes */ |
| |
| /* ancillary formats */ |
| #define PTP_OFC_Undefined 0x3000 |
| #define PTP_OFC_Association 0x3001 |
| #define PTP_OFC_Script 0x3002 |
| #define PTP_OFC_Executable 0x3003 |
| #define PTP_OFC_Text 0x3004 |
| #define PTP_OFC_HTML 0x3005 |
| #define PTP_OFC_DPOF 0x3006 |
| #define PTP_OFC_AIFF 0x3007 |
| #define PTP_OFC_WAV 0x3008 |
| #define PTP_OFC_MP3 0x3009 |
| #define PTP_OFC_AVI 0x300A |
| #define PTP_OFC_MPEG 0x300B |
| #define PTP_OFC_ASF 0x300C |
| #define PTP_OFC_QT 0x300D /* guessing */ |
| /* image formats */ |
| #define PTP_OFC_EXIF_JPEG 0x3801 |
| #define PTP_OFC_TIFF_EP 0x3802 |
| #define PTP_OFC_FlashPix 0x3803 |
| #define PTP_OFC_BMP 0x3804 |
| #define PTP_OFC_CIFF 0x3805 |
| #define PTP_OFC_Undefined_0x3806 0x3806 |
| #define PTP_OFC_GIF 0x3807 |
| #define PTP_OFC_JFIF 0x3808 |
| #define PTP_OFC_PCD 0x3809 |
| #define PTP_OFC_PICT 0x380A |
| #define PTP_OFC_PNG 0x380B |
| #define PTP_OFC_Undefined_0x380C 0x380C |
| #define PTP_OFC_TIFF 0x380D |
| #define PTP_OFC_TIFF_IT 0x380E |
| #define PTP_OFC_JP2 0x380F |
| #define PTP_OFC_JPX 0x3810 |
| /* Eastman Kodak extension ancillary format */ |
| #define PTP_OFC_EK_M3U 0xb002 |
| |
| /* PTP Association Types */ |
| |
| #define PTP_AT_Undefined 0x0000 |
| #define PTP_AT_GenericFolder 0x0001 |
| #define PTP_AT_Album 0x0002 |
| #define PTP_AT_TimeSequence 0x0003 |
| #define PTP_AT_HorizontalPanoramic 0x0004 |
| #define PTP_AT_VerticalPanoramic 0x0005 |
| #define PTP_AT_2DPanoramic 0x0006 |
| #define PTP_AT_AncillaryData 0x0007 |
| |
| /* PTP Protection Status */ |
| |
| #define PTP_PS_NoProtection 0x0000 |
| #define PTP_PS_ReadOnly 0x0001 |
| |
| /* PTP Storage Types */ |
| |
| #define PTP_ST_Undefined 0x0000 |
| #define PTP_ST_FixedROM 0x0001 |
| #define PTP_ST_RemovableROM 0x0002 |
| #define PTP_ST_FixedRAM 0x0003 |
| #define PTP_ST_RemovableRAM 0x0004 |
| |
| /* PTP FilesystemType Values */ |
| |
| #define PTP_FST_Undefined 0x0000 |
| #define PTP_FST_GenericFlat 0x0001 |
| #define PTP_FST_GenericHierarchical 0x0002 |
| #define PTP_FST_DCF 0x0003 |
| |
| /* PTP StorageInfo AccessCapability Values */ |
| |
| #define PTP_AC_ReadWrite 0x0000 |
| #define PTP_AC_ReadOnly 0x0001 |
| #define PTP_AC_ReadOnly_with_Object_Deletion 0x0002 |
| |
| /* Property Describing Dataset, Range Form */ |
| |
| struct _PTPPropDescRangeForm { |
| void * MinimumValue; |
| void * MaximumValue; |
| void * StepSize; |
| }; |
| typedef struct _PTPPropDescRangeForm PTPPropDescRangeForm; |
| |
| /* Property Describing Dataset, Enum Form */ |
| |
| struct _PTPPropDescEnumForm { |
| uint16_t NumberOfValues; |
| void ** SupportedValue; |
| }; |
| typedef struct _PTPPropDescEnumForm PTPPropDescEnumForm; |
| |
| /* Device Property Describing Dataset (DevicePropDesc) */ |
| |
| struct _PTPDevicePropDesc { |
| uint16_t DevicePropertyCode; |
| uint16_t DataType; |
| uint8_t GetSet; |
| void * FactoryDefaultValue; |
| void * CurrentValue; |
| uint8_t FormFlag; |
| union { |
| PTPPropDescEnumForm Enum; |
| PTPPropDescRangeForm Range; |
| } FORM; |
| }; |
| typedef struct _PTPDevicePropDesc PTPDevicePropDesc; |
| |
| |
| /* Property Describing Dataset, Range Form */ |
| |
| struct _PTPObjPropDescRangeForm { |
| void * MinimumValue; |
| void * MaximumValue; |
| void * StepSize; |
| }; |
| typedef struct _PTPObjPropDescRangeForm PTPObjPropDescRangeForm; |
| |
| /* Property Describing Dataset, Enum Form */ |
| |
| struct _PTPObjPropDescEnumForm { |
| uint16_t NumberOfValues; |
| void ** SupportedValue; |
| }; |
| typedef struct _PTPObjPropDescEnumForm PTPObjPropDescEnumForm; |
| |
| /* Canon filesystem's folder entry Dataset */ |
| |
| #define PTP_CANON_FilenameBufferLen 13 |
| #define PTP_CANON_FolderEntryLen sizeof(PTPCANONFolderEntry) |
| |
| struct _PTPCANONFolderEntry { |
| uint32_t ObjectHandle; |
| uint16_t ObjectFormatCode; |
| uint8_t Flags; |
| uint32_t ObjectSize; |
| time_t Time; |
| char Filename[PTP_CANON_FilenameBufferLen]; |
| }; |
| typedef struct _PTPCANONFolderEntry PTPCANONFolderEntry; |
| |
| /* DataType Codes */ |
| |
| #define PTP_DTC_UNDEF 0x0000 |
| #define PTP_DTC_INT8 0x0001 |
| #define PTP_DTC_UINT8 0x0002 |
| #define PTP_DTC_INT16 0x0003 |
| #define PTP_DTC_UINT16 0x0004 |
| #define PTP_DTC_INT32 0x0005 |
| #define PTP_DTC_UINT32 0x0006 |
| #define PTP_DTC_INT64 0x0007 |
| #define PTP_DTC_UINT64 0x0008 |
| #define PTP_DTC_INT128 0x0009 |
| #define PTP_DTC_UINT128 0x000A |
| #define PTP_DTC_AINT8 0x4001 |
| #define PTP_DTC_AUINT8 0x4002 |
| #define PTP_DTC_AINT16 0x4003 |
| #define PTP_DTC_AUINT16 0x4004 |
| #define PTP_DTC_AINT32 0x4005 |
| #define PTP_DTC_AUINT32 0x4006 |
| #define PTP_DTC_AINT64 0x4007 |
| #define PTP_DTC_AUINT64 0x4008 |
| #define PTP_DTC_AINT128 0x4009 |
| #define PTP_DTC_AUINT128 0x400A |
| #define PTP_DTC_STR 0xFFFF |
| |
| /* unicode string defined by RAL */ |
| #define PTP_DTC_UNISTR 0xFFFE |
| |
| /* Device Properties Codes */ |
| |
| #define PTP_DPC_Undefined 0x5000 |
| #define PTP_DPC_BatteryLevel 0x5001 |
| #define PTP_DPC_FunctionalMode 0x5002 |
| #define PTP_DPC_ImageSize 0x5003 |
| #define PTP_DPC_CompressionSetting 0x5004 |
| #define PTP_DPC_WhiteBalance 0x5005 |
| #define PTP_DPC_RGBGain 0x5006 |
| #define PTP_DPC_FNumber 0x5007 |
| #define PTP_DPC_FocalLength 0x5008 |
| #define PTP_DPC_FocusDistance 0x5009 |
| #define PTP_DPC_FocusMode 0x500A |
| #define PTP_DPC_ExposureMeteringMode 0x500B |
| #define PTP_DPC_FlashMode 0x500C |
| #define PTP_DPC_ExposureTime 0x500D |
| #define PTP_DPC_ExposureProgramMode 0x500E |
| #define PTP_DPC_ExposureIndex 0x500F |
| #define PTP_DPC_ExposureBiasCompensation 0x5010 |
| #define PTP_DPC_DateTime 0x5011 |
| #define PTP_DPC_CaptureDelay 0x5012 |
| #define PTP_DPC_StillCaptureMode 0x5013 |
| #define PTP_DPC_Contrast 0x5014 |
| #define PTP_DPC_Sharpness 0x5015 |
| #define PTP_DPC_DigitalZoom 0x5016 |
| #define PTP_DPC_EffectMode 0x5017 |
| #define PTP_DPC_BurstNumber 0x5018 |
| #define PTP_DPC_BurstInterval 0x5019 |
| #define PTP_DPC_TimelapseNumber 0x501A |
| #define PTP_DPC_TimelapseInterval 0x501B |
| #define PTP_DPC_FocusMeteringMode 0x501C |
| #define PTP_DPC_UploadURL 0x501D |
| #define PTP_DPC_Artist 0x501E |
| #define PTP_DPC_CopyrightInfo 0x501F |
| |
| /* Proprietary vendor extension device property mask */ |
| #define PTP_DPC_EXTENSION_MASK 0xF000 |
| #define PTP_DPC_EXTENSION 0xD000 |
| |
| /* Vendor Extensions device property codes */ |
| |
| /* Eastman Kodak extension device property codes */ |
| #define PTP_DPC_EK_ColorTemperature 0xD001 |
| #define PTP_DPC_EK_DateTimeStampFormat 0xD002 |
| #define PTP_DPC_EK_BeepMode 0xD003 |
| #define PTP_DPC_EK_VideoOut 0xD004 |
| #define PTP_DPC_EK_PowerSaving 0xD005 |
| #define PTP_DPC_EK_UI_Language 0xD006 |
| /* Canon extension device property codes */ |
| #define PTP_DPC_CANON_BeepMode 0xD001 |
| #define PTP_DPC_CANON_ViewfinderMode 0xD003 |
| #define PTP_DPC_CANON_ImageQuality 0xD006 |
| #define PTP_DPC_CANON_D007 0xD007 |
| #define PTP_DPC_CANON_ImageSize 0xD008 |
| #define PTP_DPC_CANON_FlashMode 0xD00A |
| #define PTP_DPC_CANON_TvAvSetting 0xD00C |
| #define PTP_DPC_CANON_MeteringMode 0xD010 |
| #define PTP_DPC_CANON_MacroMode 0xD011 |
| #define PTP_DPC_CANON_FocusingPoint 0xD012 |
| #define PTP_DPC_CANON_WhiteBalance 0xD013 |
| #define PTP_DPC_CANON_ISOSpeed 0xD01C |
| #define PTP_DPC_CANON_Aperture 0xD01D |
| #define PTP_DPC_CANON_ShutterSpeed 0xD01E |
| #define PTP_DPC_CANON_ExpCompensation 0xD01F |
| #define PTP_DPC_CANON_D029 0xD029 |
| #define PTP_DPC_CANON_Zoom 0xD02A |
| #define PTP_DPC_CANON_SizeQualityMode 0xD02C |
| #define PTP_DPC_CANON_FlashMemory 0xD031 |
| #define PTP_DPC_CANON_CameraModel 0xD032 |
| #define PTP_DPC_CANON_CameraOwner 0xD033 |
| #define PTP_DPC_CANON_UnixTime 0xD034 |
| #define PTP_DPC_CANON_RealImageWidth 0xD039 |
| #define PTP_DPC_CANON_PhotoEffect 0xD040 |
| #define PTP_DPC_CANON_AssistLight 0xD041 |
| #define PTP_DPC_CANON_D045 0xD045 |
| |
| /* Nikon extension device property codes */ |
| #define PTP_DPC_NIKON_ShootingBank 0xD010 |
| #define PTP_DPC_NIKON_ShootingBankNameA 0xD011 |
| #define PTP_DPC_NIKON_ShootingBankNameB 0xD012 |
| #define PTP_DPC_NIKON_ShootingBankNameC 0xD013 |
| #define PTP_DPC_NIKON_ShootingBankNameD 0xD014 |
| #define PTP_DPC_NIKON_RawCompression 0xD016 |
| #define PTP_DPC_NIKON_WhiteBalanceAutoBias 0xD017 |
| #define PTP_DPC_NIKON_WhiteBalanceTungstenBias 0xD018 |
| #define PTP_DPC_NIKON_WhiteBalanceFlourescentBias 0xD019 |
| #define PTP_DPC_NIKON_WhiteBalanceDaylightBias 0xD01a |
| #define PTP_DPC_NIKON_WhiteBalanceFlashBias 0xD01b |
| #define PTP_DPC_NIKON_WhiteBalanceCloudyBias 0xD01c |
| #define PTP_DPC_NIKON_WhiteBalanceShadeBias 0xD01d |
| #define PTP_DPC_NIKON_WhiteBalanceColourTemperature 0xD01e |
| #define PTP_DPC_NIKON_ImageSharpening 0xD02a |
| #define PTP_DPC_NIKON_ToneCompensation 0xD02b |
| #define PTP_DPC_NIKON_ColourMode 0xD02c |
| #define PTP_DPC_NIKON_HueAdjustment 0xD02d |
| #define PTP_DPC_NIKON_NonCPULensDataFocalLength 0xD02e |
| #define PTP_DPC_NIKON_NonCPULensDataMaximumAperture 0xD02f |
| #define PTP_DPC_NIKON_CSMMenuBankSelect 0xD040 |
| #define PTP_DPC_NIKON_MenuBankNameA 0xD041 |
| #define PTP_DPC_NIKON_MenuBankNameB 0xD042 |
| #define PTP_DPC_NIKON_MenuBankNameC 0xD043 |
| #define PTP_DPC_NIKON_MenuBankNameD 0xD044 |
| #define PTP_DPC_NIKON_A1AFCModePriority 0xD048 |
| #define PTP_DPC_NIKON_A2AFSModePriority 0xD049 |
| #define PTP_DPC_NIKON_A3GroupDynamicAF 0xD04a |
| #define PTP_DPC_NIKON_A4AFActivation 0xD04b |
| #define PTP_DPC_NIKON_A5FocusAreaIllumManualFocus 0xD04c |
| #define PTP_DPC_NIKON_FocusAreaIllumContinuous 0xD04d |
| #define PTP_DPC_NIKON_FocusAreaIllumWhenSelected 0xD04e |
| #define PTP_DPC_NIKON_A6FocusArea 0xD04f |
| #define PTP_DPC_NIKON_A7VerticalAFON 0xD050 |
| #define PTP_DPC_NIKON_B1ISOAuto 0xD054 |
| #define PTP_DPC_NIKON_B2ISOStep 0xD055 |
| #define PTP_DPC_NIKON_B3EVStep 0xD056 |
| #define PTP_DPC_NIKON_B4ExposureCompEv 0xD057 |
| #define PTP_DPC_NIKON_B5ExposureComp 0xD058 |
| #define PTP_DPC_NIKON_B6CenterWeightArea 0xD059 |
| #define PTP_DPC_NIKON_C1AELock 0xD05e |
| #define PTP_DPC_NIKON_C2AELAFL 0xD05f |
| #define PTP_DPC_NIKON_C3AutoMeterOff 0xD062 |
| #define PTP_DPC_NIKON_C4SelfTimer 0xD063 |
| #define PTP_DPC_NIKON_C5MonitorOff 0xD064 |
| #define PTP_DPC_NIKON_D1ShootingSpeed 0xD068 |
| #define PTP_DPC_NIKON_D2MaximumShots 0xD069 |
| #define PTP_DPC_NIKON_D3ExpDelayMode 0xD06a |
| #define PTP_DPC_NIKON_D4LongExposureNoiseReduction 0xD06b |
| #define PTP_DPC_NIKON_D5FileNumberSequence 0xD06c |
| #define PTP_DPC_NIKON_D6ControlPanelFinderRearControl 0xD06d |
| #define PTP_DPC_NIKON_ControlPanelFinderViewfinder 0xD06e |
| #define PTP_DPC_NIKON_D7Illumination 0xD06f |
| #define PTP_DPC_NIKON_E1FlashSyncSpeed 0xD074 |
| #define PTP_DPC_NIKON_E2FlashShutterSpeed 0xD075 |
| #define PTP_DPC_NIKON_E3AAFlashMode 0xD076 |
| #define PTP_DPC_NIKON_E4ModelingFlash 0xD077 |
| #define PTP_DPC_NIKON_E5AutoBracketSet 0xD078 |
| #define PTP_DPC_NIKON_E6ManualModeBracketing 0xD079 |
| #define PTP_DPC_NIKON_E7AutoBracketOrder 0xD07a |
| #define PTP_DPC_NIKON_E8AutoBracketSelection 0xD07b |
| #define PTP_DPC_NIKON_F1CenterButtonShootingMode 0xD080 |
| #define PTP_DPC_NIKON_CenterButtonPlaybackMode 0xD081 |
| #define PTP_DPC_NIKON_F2Multiselector 0xD082 |
| #define PTP_DPC_NIKON_F3PhotoInfoPlayback 0xD083 |
| #define PTP_DPC_NIKON_F4AssignFuncButton 0xD084 |
| #define PTP_DPC_NIKON_F5CustomizeCommDials 0xD085 |
| #define PTP_DPC_NIKON_ChangeMainSub 0xD086 |
| #define PTP_DPC_NIKON_ApertureSetting 0xD087 |
| #define PTP_DPC_NIKON_MenusAndPlayback 0xD088 |
| #define PTP_DPC_NIKON_F6ButtonsAndDials 0xD089 |
| #define PTP_DPC_NIKON_F7NoCFCard 0xD08a |
| #define PTP_DPC_NIKON_ImageCommentString 0xD090 |
| #define PTP_DPC_NIKON_ImageCommentAttached 0xD091 |
| #define PTP_DPC_NIKON_AutoImageRotation 0xD092 |
| #define PTP_DPC_NIKON_ExposureBracketingOnOff 0xD0c0 |
| #define PTP_DPC_NIKON_ExposureBracketingIntervalDist 0xD0c1 |
| #define PTP_DPC_NIKON_ExposureBracketingNumBracketPlace 0xD0c2 |
| #define PTP_DPC_NIKON_AutofocusLCDTopMode2 0xD107 |
| #define PTP_DPC_NIKON_AutofocusLCDTopMode3AndMode4 0xD108 |
| #define PTP_DPC_NIKON_LightMeter 0xD10a |
| #define PTP_DPC_NIKON_ExposureApertureLock 0xD111 |
| #define PTP_DPC_NIKON_MaximumShots 0xD103 |
| #define PTP_DPC_NIKON_Beep 0xD160 |
| #define PTP_DPC_NIKON_AFC 0xD161 |
| #define PTP_DPC_NIKON_AFLampOff 0xD163 |
| #define PTP_DPC_NIKON_PADVPMode 0xD164 |
| #define PTP_DPC_NIKON_ReviewOff 0xD165 |
| #define PTP_DPC_NIKON_GridDisplay 0xD16c |
| #define PTP_DPC_NIKON_AFAreaIllumination 0xD166 |
| #define PTP_DPC_NIKON_FlashMode 0xD167 |
| #define PTP_DPC_NIKON_FlashPower 0xD16d |
| #define PTP_DPC_NIKON_FlashSignOff 0xD169 |
| #define PTP_DPC_NIKON_RemoteTimeout 0xD16B |
| #define PTP_DPC_NIKON_LowLight 0xD1B0 |
| #define PTP_DPC_NIKON_ImageCommentString 0xD090 |
| #define PTP_DPC_NIKON_FlashOpen 0xD1C0 |
| #define PTP_DPC_NIKON_FlashCharged 0xD1C1 |
| #define PTP_DPC_NIKON_LensID 0xD0E0 |
| #define PTP_DPC_NIKON_FocalLengthMin 0xD0E3 |
| #define PTP_DPC_NIKON_FocalLengthMax 0xD0E4 |
| #define PTP_DPC_NIKON_MaxApAtMinFocalLength 0xD0E5 |
| #define PTP_DPC_NIKON_MaxApAtMaxFocalLength 0xD0E6 |
| #define PTP_DPC_NIKON_FlashExposureCompensation 0xD126 |
| #define PTP_DPC_NIKON_ExtendedCSMMenu 0xD180 |
| #define PTP_DPC_NIKON_OptimiseImage 0xD140 |
| |
| /* Device Property Form Flag */ |
| |
| #define PTP_DPFF_None 0x00 |
| #define PTP_DPFF_Range 0x01 |
| #define PTP_DPFF_Enumeration 0x02 |
| |
| /* Device Property GetSet type */ |
| #define PTP_DPGS_Get 0x00 |
| #define PTP_DPGS_GetSet 0x01 |
| |
| /* Glue stuff starts here */ |
| |
| typedef struct _PTPParams PTPParams; |
| |
| /* raw write functions */ |
| typedef short (* PTPIOReadFunc) (unsigned char *bytes, unsigned int size, |
| void *data); |
| typedef short (* PTPIOWriteFunc)(unsigned char *bytes, unsigned int size, |
| void *data); |
| /* |
| * This functions take PTP oriented arguments and send them over an |
| * appropriate data layer doing byteorder conversion accordingly. |
| */ |
| typedef uint16_t (* PTPIOSendReq) (PTPParams* params, PTPContainer* req); |
| typedef uint16_t (* PTPIOSendData) (PTPParams* params, PTPContainer* ptp, |
| unsigned char *data, unsigned int size); |
| typedef uint16_t (* PTPIOGetResp) (PTPParams* params, PTPContainer* resp); |
| typedef uint16_t (* PTPIOGetData) (PTPParams* params, PTPContainer* ptp, |
| unsigned char **data); |
| /* debug functions */ |
| typedef void (* PTPErrorFunc) (void *data, const char *format, va_list args); |
| typedef void (* PTPDebugFunc) (void *data, const char *format, va_list args); |
| |
| struct _PTPParams { |
| /* data layer byteorder */ |
| uint8_t byteorder; |
| |
| /* Data layer IO functions */ |
| PTPIOReadFunc read_func; |
| PTPIOWriteFunc write_func; |
| PTPIOReadFunc check_int_func; |
| PTPIOReadFunc check_int_fast_func; |
| |
| /* Custom IO functions */ |
| PTPIOSendReq sendreq_func; |
| PTPIOSendData senddata_func; |
| PTPIOGetResp getresp_func; |
| PTPIOGetData getdata_func; |
| PTPIOGetResp event_check; |
| PTPIOGetResp event_wait; |
| |
| /* Custom error and debug function */ |
| PTPErrorFunc error_func; |
| PTPDebugFunc debug_func; |
| |
| /* Data passed to above functions */ |
| void *data; |
| |
| /* ptp transaction ID */ |
| uint32_t transaction_id; |
| /* ptp session ID */ |
| uint32_t session_id; |
| |
| /* internal structures used by ptp driver */ |
| PTPObjectHandles handles; |
| PTPObjectInfo * objectinfo; |
| PTPDeviceInfo deviceinfo; |
| }; |
| |
| /* last, but not least - ptp functions */ |
| uint16_t ptp_usb_sendreq (PTPParams* params, PTPContainer* req); |
| uint16_t ptp_usb_senddata (PTPParams* params, PTPContainer* ptp, |
| unsigned char *data, unsigned int size); |
| uint16_t ptp_usb_getresp (PTPParams* params, PTPContainer* resp); |
| uint16_t ptp_usb_getdata (PTPParams* params, PTPContainer* ptp, |
| unsigned char **data); |
| uint16_t ptp_usb_event_check (PTPParams* params, PTPContainer* event); |
| uint16_t ptp_usb_event_wait (PTPParams* params, PTPContainer* event); |
| |
| uint16_t ptp_getdeviceinfo (PTPParams* params, PTPDeviceInfo* deviceinfo); |
| |
| uint16_t ptp_opensession (PTPParams *params, uint32_t session); |
| uint16_t ptp_closesession (PTPParams *params); |
| |
| uint16_t ptp_getstorageids (PTPParams* params, PTPStorageIDs* storageids); |
| uint16_t ptp_getstorageinfo (PTPParams* params, uint32_t storageid, |
| PTPStorageInfo* storageinfo); |
| |
| uint16_t ptp_getobjecthandles (PTPParams* params, uint32_t storage, |
| uint32_t objectformatcode, |
| uint32_t associationOH, |
| PTPObjectHandles* objecthandles); |
| |
| uint16_t ptp_getobjectinfo (PTPParams *params, uint32_t handle, |
| PTPObjectInfo* objectinfo); |
| |
| uint16_t ptp_getobject (PTPParams *params, uint32_t handle, |
| char** object); |
| uint16_t ptp_getthumb (PTPParams *params, uint32_t handle, |
| char** object); |
| |
| uint16_t ptp_deleteobject (PTPParams* params, uint32_t handle, |
| uint32_t ofc); |
| |
| uint16_t ptp_sendobjectinfo (PTPParams* params, uint32_t* store, |
| uint32_t* parenthandle, uint32_t* handle, |
| PTPObjectInfo* objectinfo); |
| uint16_t ptp_sendobject (PTPParams* params, char* object, |
| uint32_t size); |
| |
| uint16_t ptp_initiatecapture (PTPParams* params, uint32_t storageid, |
| uint32_t ofc); |
| |
| uint16_t ptp_getdevicepropdesc (PTPParams* params, uint16_t propcode, |
| PTPDevicePropDesc *devicepropertydesc); |
| uint16_t ptp_getdevicepropvalue (PTPParams* params, uint16_t propcode, |
| void** value, uint16_t datatype); |
| uint16_t ptp_setdevicepropvalue (PTPParams* params, uint16_t propcode, |
| void* value, uint16_t datatype); |
| |
| |
| uint16_t ptp_ek_sendfileobjectinfo (PTPParams* params, uint32_t* store, |
| uint32_t* parenthandle, uint32_t* handle, |
| PTPObjectInfo* objectinfo); |
| uint16_t ptp_ek_sendfileobject (PTPParams* params, char* object, |
| uint32_t size); |
| |
| /* Canon PTP extensions */ |
| |
| uint16_t ptp_canon_getobjectsize (PTPParams* params, uint32_t handle, |
| uint32_t p2, uint32_t* size, uint32_t* rp2); |
| |
| uint16_t ptp_canon_startshootingmode (PTPParams* params); |
| uint16_t ptp_canon_endshootingmode (PTPParams* params); |
| |
| uint16_t ptp_canon_viewfinderon (PTPParams* params); |
| uint16_t ptp_canon_viewfinderoff (PTPParams* params); |
| |
| uint16_t ptp_canon_reflectchanges (PTPParams* params, uint32_t p1); |
| uint16_t ptp_canon_checkevent (PTPParams* params, |
| PTPUSBEventContainer* event, int* isevent); |
| uint16_t ptp_canon_focuslock (PTPParams* params); |
| uint16_t ptp_canon_focusunlock (PTPParams* params); |
| uint16_t ptp_canon_initiatecaptureinmemory (PTPParams* params); |
| uint16_t ptp_canon_getpartialobject (PTPParams* params, uint32_t handle, |
| uint32_t offset, uint32_t size, |
| uint32_t pos, char** block, |
| uint32_t* readnum); |
| uint16_t ptp_canon_getviewfinderimage (PTPParams* params, char** image, |
| uint32_t* size); |
| uint16_t ptp_canon_getchanges (PTPParams* params, uint16_t** props, |
| uint32_t* propnum); |
| uint16_t ptp_canon_getfolderentries (PTPParams* params, uint32_t store, |
| uint32_t p2, uint32_t parenthandle, |
| uint32_t handle, |
| PTPCANONFolderEntry** entries, |
| uint32_t* entnum); |
| |
| |
| /* Non PTP protocol functions */ |
| int ptp_operation_issupported (PTPParams* params, uint16_t operation); |
| int ptp_property_issupported (PTPParams* params, uint16_t property); |
| |
| void ptp_free_devicepropdesc (PTPDevicePropDesc* dpd); |
| void ptp_free_deviceinfo (PTPDeviceInfo* di); |
| void ptp_perror (PTPParams* params, uint16_t error); |
| const char* |
| ptp_get_operation_name (PTPParams* params, uint16_t oc); |
| const char* |
| ptp_get_property_name (PTPParams* params, uint16_t dpc); |
| |
| /* added to header file by RAL */ |
| uint16_t ptp_transaction (PTPParams* params, PTPContainer* ptp, |
| uint16_t flags, unsigned int sendlen, char** data); |
| |
| /* below moved to header file by RAL */ |
| #define CHECK_PTP_RC(result) {uint16_t r=(result); if (r!=PTP_RC_OK) return r;} |
| |
| #define PTP_CNT_INIT(cnt) {memset(&cnt,0,sizeof(cnt));} |
| |
| /* Transaction data phase description */ |
| #define PTP_DP_NODATA 0x0000 /* no data phase */ |
| #define PTP_DP_SENDDATA 0x0001 /* sending data */ |
| #define PTP_DP_GETDATA 0x0002 /* receiving data */ |
| #define PTP_DP_DATA_MASK 0x00ff /* data phase mask */ |
| |
| /* Number of PTP Request phase parameters */ |
| #define PTP_RQ_PARAM0 0x0000 /* zero parameters */ |
| #define PTP_RQ_PARAM1 0x0100 /* one parameter */ |
| #define PTP_RQ_PARAM2 0x0200 /* two parameters */ |
| #define PTP_RQ_PARAM3 0x0300 /* three parameters */ |
| #define PTP_RQ_PARAM4 0x0400 /* four parameters */ |
| #define PTP_RQ_PARAM5 0x0500 /* five parameters */ |
| |
| #endif /* __PTP_H__ */ |