1 /*
2  * Copyright (C) 2010 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef _MTP_H
18 #define _MTP_H
19 
20 #include <stdint.h>
21 #include <stdlib.h>
22 
23 #define MTP_STANDARD_VERSION            100
24 
25 // Container Types
26 #define MTP_CONTAINER_TYPE_UNDEFINED    0
27 #define MTP_CONTAINER_TYPE_COMMAND      1
28 #define MTP_CONTAINER_TYPE_DATA         2
29 #define MTP_CONTAINER_TYPE_RESPONSE     3
30 #define MTP_CONTAINER_TYPE_EVENT        4
31 
32 // Container Offsets
33 #define MTP_CONTAINER_LENGTH_OFFSET             0
34 #define MTP_CONTAINER_TYPE_OFFSET               4
35 #define MTP_CONTAINER_CODE_OFFSET               6
36 #define MTP_CONTAINER_TRANSACTION_ID_OFFSET     8
37 #define MTP_CONTAINER_PARAMETER_OFFSET          12
38 #define MTP_CONTAINER_HEADER_SIZE               12
39 
40 // Maximum buffer size for a MTP packet.
41 #define MTP_BUFFER_SIZE 16384
42 
43 // MTP Data Types
44 #define MTP_TYPE_UNDEFINED      0x0000          // Undefined
45 #define MTP_TYPE_INT8           0x0001          // Signed 8-bit integer
46 #define MTP_TYPE_UINT8          0x0002          // Unsigned 8-bit integer
47 #define MTP_TYPE_INT16          0x0003          // Signed 16-bit integer
48 #define MTP_TYPE_UINT16         0x0004          // Unsigned 16-bit integer
49 #define MTP_TYPE_INT32          0x0005          // Signed 32-bit integer
50 #define MTP_TYPE_UINT32         0x0006          // Unsigned 32-bit integer
51 #define MTP_TYPE_INT64          0x0007          // Signed 64-bit integer
52 #define MTP_TYPE_UINT64         0x0008          // Unsigned 64-bit integer
53 #define MTP_TYPE_INT128         0x0009          // Signed 128-bit integer
54 #define MTP_TYPE_UINT128        0x000A          // Unsigned 128-bit integer
55 #define MTP_TYPE_AINT8          0x4001          // Array of signed 8-bit integers
56 #define MTP_TYPE_AUINT8         0x4002          // Array of unsigned 8-bit integers
57 #define MTP_TYPE_AINT16         0x4003          // Array of signed 16-bit integers
58 #define MTP_TYPE_AUINT16        0x4004          // Array of unsigned 16-bit integers
59 #define MTP_TYPE_AINT32         0x4005          // Array of signed 32-bit integers
60 #define MTP_TYPE_AUINT32        0x4006          // Array of unsigned 32-bit integers
61 #define MTP_TYPE_AINT64         0x4007          // Array of signed 64-bit integers
62 #define MTP_TYPE_AUINT64        0x4008          // Array of unsigned 64-bit integers
63 #define MTP_TYPE_AINT128        0x4009          // Array of signed 128-bit integers
64 #define MTP_TYPE_AUINT128       0x400A          // Array of unsigned 128-bit integers
65 #define MTP_TYPE_STR            0xFFFF          // Variable-length Unicode string
66 
67 // MTP Format Codes
68 #define MTP_FORMAT_UNDEFINED                            0x3000   // Undefined object
69 #define MTP_FORMAT_ASSOCIATION                          0x3001   // Association (for example, a folder)
70 #define MTP_FORMAT_SCRIPT                               0x3002   // Device model-specific script
71 #define MTP_FORMAT_EXECUTABLE                           0x3003   // Device model-specific binary executable
72 #define MTP_FORMAT_TEXT                                 0x3004   // Text file
73 #define MTP_FORMAT_HTML                                 0x3005   // Hypertext Markup Language file (text)
74 #define MTP_FORMAT_DPOF                                 0x3006   // Digital Print Order Format file (text)
75 #define MTP_FORMAT_AIFF                                 0x3007   // Audio clip
76 #define MTP_FORMAT_WAV                                  0x3008   // Audio clip
77 #define MTP_FORMAT_MP3                                  0x3009   // Audio clip
78 #define MTP_FORMAT_AVI                                  0x300A   // Video clip
79 #define MTP_FORMAT_MPEG                                 0x300B   // Video clip
80 #define MTP_FORMAT_ASF                                  0x300C   // Microsoft Advanced Streaming Format (video)
81 #define MTP_FORMAT_DEFINED                              0x3800   // Unknown image object
82 #define MTP_FORMAT_EXIF_JPEG                            0x3801   // Exchangeable File Format, JEIDA standard
83 #define MTP_FORMAT_TIFF_EP                              0x3802   // Tag Image File Format for Electronic Photography
84 #define MTP_FORMAT_FLASHPIX                             0x3803   // Structured Storage Image Format
85 #define MTP_FORMAT_BMP                                  0x3804   // Microsoft Windows Bitmap file
86 #define MTP_FORMAT_CIFF                                 0x3805   // Canon Camera Image File Format
87 #define MTP_FORMAT_GIF                                  0x3807   // Graphics Interchange Format
88 #define MTP_FORMAT_JFIF                                 0x3808   // JPEG File Interchange Format
89 #define MTP_FORMAT_CD                                   0x3809   // PhotoCD Image Pac
90 #define MTP_FORMAT_PICT                                 0x380A   // Quickdraw Image Format
91 #define MTP_FORMAT_PNG                                  0x380B   // Portable Network Graphics
92 #define MTP_FORMAT_TIFF                                 0x380D   // Tag Image File Format
93 #define MTP_FORMAT_TIFF_IT                              0x380E   // Tag Image File Format for Information Technology (graphic arts)
94 #define MTP_FORMAT_JP2                                  0x380F   // JPEG2000 Baseline File Format
95 #define MTP_FORMAT_JPX                                  0x3810   // JPEG2000 Extended File Format
96 #define MTP_FORMAT_DNG                                  0x3811   // Digital Negative
97 #define MTP_FORMAT_HEIF                                 0x3812   // HEIF images
98 #define MTP_FORMAT_UNDEFINED_FIRMWARE                   0xB802
99 #define MTP_FORMAT_WINDOWS_IMAGE_FORMAT                 0xB881
100 #define MTP_FORMAT_UNDEFINED_AUDIO                      0xB900
101 #define MTP_FORMAT_WMA                                  0xB901
102 #define MTP_FORMAT_OGG                                  0xB902
103 #define MTP_FORMAT_AAC                                  0xB903
104 #define MTP_FORMAT_AUDIBLE                              0xB904
105 #define MTP_FORMAT_FLAC                                 0xB906
106 #define MTP_FORMAT_UNDEFINED_VIDEO                      0xB980
107 #define MTP_FORMAT_WMV                                  0xB981
108 #define MTP_FORMAT_MP4_CONTAINER                        0xB982  // ISO 14496-1
109 #define MTP_FORMAT_MP2                                  0xB983
110 #define MTP_FORMAT_3GP_CONTAINER                        0xB984  // 3GPP file format. Details: http://www.3gpp.org/ftp/Specs/html-info/26244.htm (page title - \u201cTransparent end-to-end packet switched streaming service, 3GPP file format\u201d).
111 #define MTP_FORMAT_UNDEFINED_COLLECTION                 0xBA00
112 #define MTP_FORMAT_ABSTRACT_MULTIMEDIA_ALBUM            0xBA01
113 #define MTP_FORMAT_ABSTRACT_IMAGE_ALBUM                 0xBA02
114 #define MTP_FORMAT_ABSTRACT_AUDIO_ALBUM                 0xBA03
115 #define MTP_FORMAT_ABSTRACT_VIDEO_ALBUM                 0xBA04
116 #define MTP_FORMAT_ABSTRACT_AV_PLAYLIST                 0xBA05
117 #define MTP_FORMAT_ABSTRACT_CONTACT_GROUP               0xBA06
118 #define MTP_FORMAT_ABSTRACT_MESSAGE_FOLDER              0xBA07
119 #define MTP_FORMAT_ABSTRACT_CHAPTERED_PRODUCTION        0xBA08
120 #define MTP_FORMAT_ABSTRACT_AUDIO_PLAYLIST              0xBA09
121 #define MTP_FORMAT_ABSTRACT_VIDEO_PLAYLIST              0xBA0A
122 #define MTP_FORMAT_ABSTRACT_MEDIACAST                   0xBA0B // For use with mediacasts; references multimedia enclosures of RSS feeds or episodic content
123 #define MTP_FORMAT_WPL_PLAYLIST                         0xBA10
124 #define MTP_FORMAT_M3U_PLAYLIST                         0xBA11
125 #define MTP_FORMAT_MPL_PLAYLIST                         0xBA12
126 #define MTP_FORMAT_ASX_PLAYLIST                         0xBA13
127 #define MTP_FORMAT_PLS_PLAYLIST                         0xBA14
128 #define MTP_FORMAT_UNDEFINED_DOCUMENT                   0xBA80
129 #define MTP_FORMAT_ABSTRACT_DOCUMENT                    0xBA81
130 #define MTP_FORMAT_XML_DOCUMENT                         0xBA82
131 #define MTP_FORMAT_MS_WORD_DOCUMENT                     0xBA83
132 #define MTP_FORMAT_MHT_COMPILED_HTML_DOCUMENT           0xBA84
133 #define MTP_FORMAT_MS_EXCEL_SPREADSHEET                 0xBA85
134 #define MTP_FORMAT_MS_POWERPOINT_PRESENTATION           0xBA86
135 #define MTP_FORMAT_UNDEFINED_MESSAGE                    0xBB00
136 #define MTP_FORMAT_ABSTRACT_MESSSAGE                    0xBB01
137 #define MTP_FORMAT_UNDEFINED_CONTACT                    0xBB80
138 #define MTP_FORMAT_ABSTRACT_CONTACT                     0xBB81
139 #define MTP_FORMAT_VCARD_2                              0xBB82
140 
141 // MTP Object Property Codes
142 #define MTP_PROPERTY_STORAGE_ID                             0xDC01
143 #define MTP_PROPERTY_OBJECT_FORMAT                          0xDC02
144 #define MTP_PROPERTY_PROTECTION_STATUS                      0xDC03
145 #define MTP_PROPERTY_OBJECT_SIZE                            0xDC04
146 #define MTP_PROPERTY_ASSOCIATION_TYPE                       0xDC05
147 #define MTP_PROPERTY_ASSOCIATION_DESC                       0xDC06
148 #define MTP_PROPERTY_OBJECT_FILE_NAME                       0xDC07
149 #define MTP_PROPERTY_DATE_CREATED                           0xDC08
150 #define MTP_PROPERTY_DATE_MODIFIED                          0xDC09
151 #define MTP_PROPERTY_KEYWORDS                               0xDC0A
152 #define MTP_PROPERTY_PARENT_OBJECT                          0xDC0B
153 #define MTP_PROPERTY_ALLOWED_FOLDER_CONTENTS                0xDC0C
154 #define MTP_PROPERTY_HIDDEN                                 0xDC0D
155 #define MTP_PROPERTY_SYSTEM_OBJECT                          0xDC0E
156 #define MTP_PROPERTY_PERSISTENT_UID                         0xDC41
157 #define MTP_PROPERTY_SYNC_ID                                0xDC42
158 #define MTP_PROPERTY_PROPERTY_BAG                           0xDC43
159 #define MTP_PROPERTY_NAME                                   0xDC44
160 #define MTP_PROPERTY_CREATED_BY                             0xDC45
161 #define MTP_PROPERTY_ARTIST                                 0xDC46
162 #define MTP_PROPERTY_DATE_AUTHORED                          0xDC47
163 #define MTP_PROPERTY_DESCRIPTION                            0xDC48
164 #define MTP_PROPERTY_URL_REFERENCE                          0xDC49
165 #define MTP_PROPERTY_LANGUAGE_LOCALE                        0xDC4A
166 #define MTP_PROPERTY_COPYRIGHT_INFORMATION                  0xDC4B
167 #define MTP_PROPERTY_SOURCE                                 0xDC4C
168 #define MTP_PROPERTY_ORIGIN_LOCATION                        0xDC4D
169 #define MTP_PROPERTY_DATE_ADDED                             0xDC4E
170 #define MTP_PROPERTY_NON_CONSUMABLE                         0xDC4F
171 #define MTP_PROPERTY_CORRUPT_UNPLAYABLE                     0xDC50
172 #define MTP_PROPERTY_PRODUCER_SERIAL_NUMBER                 0xDC51
173 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_FORMAT           0xDC81
174 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_SIZE             0xDC82
175 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_HEIGHT           0xDC83
176 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_WIDTH            0xDC84
177 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_DURATION         0xDC85
178 #define MTP_PROPERTY_REPRESENTATIVE_SAMPLE_DATA             0xDC86
179 #define MTP_PROPERTY_WIDTH                                  0xDC87
180 #define MTP_PROPERTY_HEIGHT                                 0xDC88
181 #define MTP_PROPERTY_DURATION                               0xDC89
182 #define MTP_PROPERTY_RATING                                 0xDC8A
183 #define MTP_PROPERTY_TRACK                                  0xDC8B
184 #define MTP_PROPERTY_GENRE                                  0xDC8C
185 #define MTP_PROPERTY_CREDITS                                0xDC8D
186 #define MTP_PROPERTY_LYRICS                                 0xDC8E
187 #define MTP_PROPERTY_SUBSCRIPTION_CONTENT_ID                0xDC8F
188 #define MTP_PROPERTY_PRODUCED_BY                            0xDC90
189 #define MTP_PROPERTY_USE_COUNT                              0xDC91
190 #define MTP_PROPERTY_SKIP_COUNT                             0xDC92
191 #define MTP_PROPERTY_LAST_ACCESSED                          0xDC93
192 #define MTP_PROPERTY_PARENTAL_RATING                        0xDC94
193 #define MTP_PROPERTY_META_GENRE                             0xDC95
194 #define MTP_PROPERTY_COMPOSER                               0xDC96
195 #define MTP_PROPERTY_EFFECTIVE_RATING                       0xDC97
196 #define MTP_PROPERTY_SUBTITLE                               0xDC98
197 #define MTP_PROPERTY_ORIGINAL_RELEASE_DATE                  0xDC99
198 #define MTP_PROPERTY_ALBUM_NAME                             0xDC9A
199 #define MTP_PROPERTY_ALBUM_ARTIST                           0xDC9B
200 #define MTP_PROPERTY_MOOD                                   0xDC9C
201 #define MTP_PROPERTY_DRM_STATUS                             0xDC9D
202 #define MTP_PROPERTY_SUB_DESCRIPTION                        0xDC9E
203 #define MTP_PROPERTY_IS_CROPPED                             0xDCD1
204 #define MTP_PROPERTY_IS_COLOUR_CORRECTED                    0xDCD2
205 #define MTP_PROPERTY_IMAGE_BIT_DEPTH                        0xDCD3
206 #define MTP_PROPERTY_F_NUMBER                               0xDCD4
207 #define MTP_PROPERTY_EXPOSURE_TIME                          0xDCD5
208 #define MTP_PROPERTY_EXPOSURE_INDEX                         0xDCD6
209 #define MTP_PROPERTY_TOTAL_BITRATE                          0xDE91
210 #define MTP_PROPERTY_BITRATE_TYPE                           0xDE92
211 #define MTP_PROPERTY_SAMPLE_RATE                            0xDE93
212 #define MTP_PROPERTY_NUMBER_OF_CHANNELS                     0xDE94
213 #define MTP_PROPERTY_AUDIO_BIT_DEPTH                        0xDE95
214 #define MTP_PROPERTY_SCAN_TYPE                              0xDE97
215 #define MTP_PROPERTY_AUDIO_WAVE_CODEC                       0xDE99
216 #define MTP_PROPERTY_AUDIO_BITRATE                          0xDE9A
217 #define MTP_PROPERTY_VIDEO_FOURCC_CODEC                     0xDE9B
218 #define MTP_PROPERTY_VIDEO_BITRATE                          0xDE9C
219 #define MTP_PROPERTY_FRAMES_PER_THOUSAND_SECONDS            0xDE9D
220 #define MTP_PROPERTY_KEYFRAME_DISTANCE                      0xDE9E
221 #define MTP_PROPERTY_BUFFER_SIZE                            0xDE9F
222 #define MTP_PROPERTY_ENCODING_QUALITY                       0xDEA0
223 #define MTP_PROPERTY_ENCODING_PROFILE                       0xDEA1
224 #define MTP_PROPERTY_DISPLAY_NAME                           0xDCE0
225 #define MTP_PROPERTY_BODY_TEXT                              0xDCE1
226 #define MTP_PROPERTY_SUBJECT                                0xDCE2
227 #define MTP_PROPERTY_PRIORITY                               0xDCE3
228 #define MTP_PROPERTY_GIVEN_NAME                             0xDD00
229 #define MTP_PROPERTY_MIDDLE_NAMES                           0xDD01
230 #define MTP_PROPERTY_FAMILY_NAME                            0xDD02
231 #define MTP_PROPERTY_PREFIX                                 0xDD03
232 #define MTP_PROPERTY_SUFFIX                                 0xDD04
233 #define MTP_PROPERTY_PHONETIC_GIVEN_NAME                    0xDD05
234 #define MTP_PROPERTY_PHONETIC_FAMILY_NAME                   0xDD06
235 #define MTP_PROPERTY_EMAIL_PRIMARY                          0xDD07
236 #define MTP_PROPERTY_EMAIL_PERSONAL_1                       0xDD08
237 #define MTP_PROPERTY_EMAIL_PERSONAL_2                       0xDD09
238 #define MTP_PROPERTY_EMAIL_BUSINESS_1                       0xDD0A
239 #define MTP_PROPERTY_EMAIL_BUSINESS_2                       0xDD0B
240 #define MTP_PROPERTY_EMAIL_OTHERS                           0xDD0C
241 #define MTP_PROPERTY_PHONE_NUMBER_PRIMARY                   0xDD0D
242 #define MTP_PROPERTY_PHONE_NUMBER_PERSONAL                  0xDD0E
243 #define MTP_PROPERTY_PHONE_NUMBER_PERSONAL_2                0xDD0F
244 #define MTP_PROPERTY_PHONE_NUMBER_BUSINESS                  0xDD10
245 #define MTP_PROPERTY_PHONE_NUMBER_BUSINESS_2                0xDD11
246 #define MTP_PROPERTY_PHONE_NUMBER_MOBILE                    0xDD12
247 #define MTP_PROPERTY_PHONE_NUMBER_MOBILE_2                  0xDD13
248 #define MTP_PROPERTY_FAX_NUMBER_PRIMARY                     0xDD14
249 #define MTP_PROPERTY_FAX_NUMBER_PERSONAL                    0xDD15
250 #define MTP_PROPERTY_FAX_NUMBER_BUSINESS                    0xDD16
251 #define MTP_PROPERTY_PAGER_NUMBER                           0xDD17
252 #define MTP_PROPERTY_PHONE_NUMBER_OTHERS                    0xDD18
253 #define MTP_PROPERTY_PRIMARY_WEB_ADDRESS                    0xDD19
254 #define MTP_PROPERTY_PERSONAL_WEB_ADDRESS                   0xDD1A
255 #define MTP_PROPERTY_BUSINESS_WEB_ADDRESS                   0xDD1B
256 #define MTP_PROPERTY_INSTANT_MESSANGER_ADDRESS              0xDD1C
257 #define MTP_PROPERTY_INSTANT_MESSANGER_ADDRESS_2            0xDD1D
258 #define MTP_PROPERTY_INSTANT_MESSANGER_ADDRESS_3            0xDD1E
259 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_FULL           0xDD1F
260 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_LINE_1         0xDD20
261 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_LINE_2         0xDD21
262 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_CITY           0xDD22
263 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_REGION         0xDD23
264 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_POSTAL_CODE    0xDD24
265 #define MTP_PROPERTY_POSTAL_ADDRESS_PERSONAL_COUNTRY        0xDD25
266 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_FULL           0xDD26
267 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_LINE_1         0xDD27
268 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_LINE_2         0xDD28
269 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_CITY           0xDD29
270 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_REGION         0xDD2A
271 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_POSTAL_CODE    0xDD2B
272 #define MTP_PROPERTY_POSTAL_ADDRESS_BUSINESS_COUNTRY        0xDD2C
273 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_FULL              0xDD2D
274 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_LINE_1            0xDD2E
275 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_LINE_2            0xDD2F
276 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_CITY              0xDD30
277 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_REGION            0xDD31
278 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_POSTAL_CODE       0xDD32
279 #define MTP_PROPERTY_POSTAL_ADDRESS_OTHER_COUNTRY           0xDD33
280 #define MTP_PROPERTY_ORGANIZATION_NAME                      0xDD34
281 #define MTP_PROPERTY_PHONETIC_ORGANIZATION_NAME             0xDD35
282 #define MTP_PROPERTY_ROLE                                   0xDD36
283 #define MTP_PROPERTY_BIRTHDATE                              0xDD37
284 #define MTP_PROPERTY_MESSAGE_TO                             0xDD40
285 #define MTP_PROPERTY_MESSAGE_CC                             0xDD41
286 #define MTP_PROPERTY_MESSAGE_BCC                            0xDD42
287 #define MTP_PROPERTY_MESSAGE_READ                           0xDD43
288 #define MTP_PROPERTY_MESSAGE_RECEIVED_TIME                  0xDD44
289 #define MTP_PROPERTY_MESSAGE_SENDER                         0xDD45
290 #define MTP_PROPERTY_ACTIVITY_BEGIN_TIME                    0xDD50
291 #define MTP_PROPERTY_ACTIVITY_END_TIME                      0xDD51
292 #define MTP_PROPERTY_ACTIVITY_LOCATION                      0xDD52
293 #define MTP_PROPERTY_ACTIVITY_REQUIRED_ATTENDEES            0xDD54
294 #define MTP_PROPERTY_ACTIVITY_OPTIONAL_ATTENDEES            0xDD55
295 #define MTP_PROPERTY_ACTIVITY_RESOURCES                     0xDD56
296 #define MTP_PROPERTY_ACTIVITY_ACCEPTED                      0xDD57
297 #define MTP_PROPERTY_ACTIVITY_TENTATIVE                     0xDD58
298 #define MTP_PROPERTY_ACTIVITY_DECLINED                      0xDD59
299 #define MTP_PROPERTY_ACTIVITY_REMAINDER_TIME                0xDD5A
300 #define MTP_PROPERTY_ACTIVITY_OWNER                         0xDD5B
301 #define MTP_PROPERTY_ACTIVITY_STATUS                        0xDD5C
302 #define MTP_PROPERTY_OWNER                                  0xDD5D
303 #define MTP_PROPERTY_EDITOR                                 0xDD5E
304 #define MTP_PROPERTY_WEBMASTER                              0xDD5F
305 #define MTP_PROPERTY_URL_SOURCE                             0xDD60
306 #define MTP_PROPERTY_URL_DESTINATION                        0xDD61
307 #define MTP_PROPERTY_TIME_BOOKMARK                          0xDD62
308 #define MTP_PROPERTY_OBJECT_BOOKMARK                        0xDD63
309 #define MTP_PROPERTY_BYTE_BOOKMARK                          0xDD64
310 #define MTP_PROPERTY_LAST_BUILD_DATE                        0xDD70
311 #define MTP_PROPERTY_TIME_TO_LIVE                           0xDD71
312 #define MTP_PROPERTY_MEDIA_GUID                             0xDD72
313 
314 // MTP Device Property Codes
315 #define MTP_DEVICE_PROPERTY_UNDEFINED                       0x5000
316 #define MTP_DEVICE_PROPERTY_BATTERY_LEVEL                   0x5001
317 #define MTP_DEVICE_PROPERTY_FUNCTIONAL_MODE                 0x5002
318 #define MTP_DEVICE_PROPERTY_IMAGE_SIZE                      0x5003
319 #define MTP_DEVICE_PROPERTY_COMPRESSION_SETTING             0x5004
320 #define MTP_DEVICE_PROPERTY_WHITE_BALANCE                   0x5005
321 #define MTP_DEVICE_PROPERTY_RGB_GAIN                        0x5006
322 #define MTP_DEVICE_PROPERTY_F_NUMBER                        0x5007
323 #define MTP_DEVICE_PROPERTY_FOCAL_LENGTH                    0x5008
324 #define MTP_DEVICE_PROPERTY_FOCUS_DISTANCE                  0x5009
325 #define MTP_DEVICE_PROPERTY_FOCUS_MODE                      0x500A
326 #define MTP_DEVICE_PROPERTY_EXPOSURE_METERING_MODE          0x500B
327 #define MTP_DEVICE_PROPERTY_FLASH_MODE                      0x500C
328 #define MTP_DEVICE_PROPERTY_EXPOSURE_TIME                   0x500D
329 #define MTP_DEVICE_PROPERTY_EXPOSURE_PROGRAM_MODE           0x500E
330 #define MTP_DEVICE_PROPERTY_EXPOSURE_INDEX                  0x500F
331 #define MTP_DEVICE_PROPERTY_EXPOSURE_BIAS_COMPENSATION      0x5010
332 #define MTP_DEVICE_PROPERTY_DATETIME                        0x5011
333 #define MTP_DEVICE_PROPERTY_CAPTURE_DELAY                   0x5012
334 #define MTP_DEVICE_PROPERTY_STILL_CAPTURE_MODE              0x5013
335 #define MTP_DEVICE_PROPERTY_CONTRAST                        0x5014
336 #define MTP_DEVICE_PROPERTY_SHARPNESS                       0x5015
337 #define MTP_DEVICE_PROPERTY_DIGITAL_ZOOM                    0x5016
338 #define MTP_DEVICE_PROPERTY_EFFECT_MODE                     0x5017
339 #define MTP_DEVICE_PROPERTY_BURST_NUMBER                    0x5018
340 #define MTP_DEVICE_PROPERTY_BURST_INTERVAL                  0x5019
341 #define MTP_DEVICE_PROPERTY_TIMELAPSE_NUMBER                0x501A
342 #define MTP_DEVICE_PROPERTY_TIMELAPSE_INTERVAL              0x501B
343 #define MTP_DEVICE_PROPERTY_FOCUS_METERING_MODE             0x501C
344 #define MTP_DEVICE_PROPERTY_UPLOAD_URL                      0x501D
345 #define MTP_DEVICE_PROPERTY_ARTIST                          0x501E
346 #define MTP_DEVICE_PROPERTY_COPYRIGHT_INFO                  0x501F
347 #define MTP_DEVICE_PROPERTY_SYNCHRONIZATION_PARTNER         0xD401
348 #define MTP_DEVICE_PROPERTY_DEVICE_FRIENDLY_NAME            0xD402
349 #define MTP_DEVICE_PROPERTY_VOLUME                          0xD403
350 #define MTP_DEVICE_PROPERTY_SUPPORTED_FORMATS_ORDERED       0xD404
351 #define MTP_DEVICE_PROPERTY_DEVICE_ICON                     0xD405
352 #define MTP_DEVICE_PROPERTY_PLAYBACK_RATE                   0xD410
353 #define MTP_DEVICE_PROPERTY_PLAYBACK_OBJECT                 0xD411
354 #define MTP_DEVICE_PROPERTY_PLAYBACK_CONTAINER_INDEX        0xD412
355 #define MTP_DEVICE_PROPERTY_SESSION_INITIATOR_VERSION_INFO  0xD406
356 #define MTP_DEVICE_PROPERTY_PERCEIVED_DEVICE_TYPE           0xD407
357 
358 // MTP Operation Codes
359 #define MTP_OPERATION_GET_DEVICE_INFO                       0x1001
360 #define MTP_OPERATION_OPEN_SESSION                          0x1002
361 #define MTP_OPERATION_CLOSE_SESSION                         0x1003
362 #define MTP_OPERATION_GET_STORAGE_IDS                       0x1004
363 #define MTP_OPERATION_GET_STORAGE_INFO                      0x1005
364 #define MTP_OPERATION_GET_NUM_OBJECTS                       0x1006
365 #define MTP_OPERATION_GET_OBJECT_HANDLES                    0x1007
366 #define MTP_OPERATION_GET_OBJECT_INFO                       0x1008
367 #define MTP_OPERATION_GET_OBJECT                            0x1009
368 #define MTP_OPERATION_GET_THUMB                             0x100A
369 #define MTP_OPERATION_DELETE_OBJECT                         0x100B
370 #define MTP_OPERATION_SEND_OBJECT_INFO                      0x100C
371 #define MTP_OPERATION_SEND_OBJECT                           0x100D
372 #define MTP_OPERATION_INITIATE_CAPTURE                      0x100E
373 #define MTP_OPERATION_FORMAT_STORE                          0x100F
374 #define MTP_OPERATION_RESET_DEVICE                          0x1010
375 #define MTP_OPERATION_SELF_TEST                             0x1011
376 #define MTP_OPERATION_SET_OBJECT_PROTECTION                 0x1012
377 #define MTP_OPERATION_POWER_DOWN                            0x1013
378 #define MTP_OPERATION_GET_DEVICE_PROP_DESC                  0x1014
379 #define MTP_OPERATION_GET_DEVICE_PROP_VALUE                 0x1015
380 #define MTP_OPERATION_SET_DEVICE_PROP_VALUE                 0x1016
381 #define MTP_OPERATION_RESET_DEVICE_PROP_VALUE               0x1017
382 #define MTP_OPERATION_TERMINATE_OPEN_CAPTURE                0x1018
383 #define MTP_OPERATION_MOVE_OBJECT                           0x1019
384 #define MTP_OPERATION_COPY_OBJECT                           0x101A
385 #define MTP_OPERATION_GET_PARTIAL_OBJECT                    0x101B
386 #define MTP_OPERATION_INITIATE_OPEN_CAPTURE                 0x101C
387 #define MTP_OPERATION_GET_OBJECT_PROPS_SUPPORTED            0x9801
388 #define MTP_OPERATION_GET_OBJECT_PROP_DESC                  0x9802
389 #define MTP_OPERATION_GET_OBJECT_PROP_VALUE                 0x9803
390 #define MTP_OPERATION_SET_OBJECT_PROP_VALUE                 0x9804
391 #define MTP_OPERATION_GET_OBJECT_PROP_LIST                  0x9805
392 #define MTP_OPERATION_SET_OBJECT_PROP_LIST                  0x9806
393 #define MTP_OPERATION_GET_INTERDEPENDENT_PROP_DESC          0x9807
394 #define MTP_OPERATION_SEND_OBJECT_PROP_LIST                 0x9808
395 #define MTP_OPERATION_GET_OBJECT_REFERENCES                 0x9810
396 #define MTP_OPERATION_SET_OBJECT_REFERENCES                 0x9811
397 #define MTP_OPERATION_SKIP                                  0x9820
398 
399 // Android extensions for direct file IO
400 
401 // Same as GetPartialObject, but with 64 bit offset
402 #define MTP_OPERATION_GET_PARTIAL_OBJECT_64                 0x95C1
403 // Same as GetPartialObject64, but copying host to device
404 #define MTP_OPERATION_SEND_PARTIAL_OBJECT                   0x95C2
405 // Truncates file to 64 bit length
406 #define MTP_OPERATION_TRUNCATE_OBJECT                       0x95C3
407 // Must be called before using SendPartialObject and TruncateObject
408 #define MTP_OPERATION_BEGIN_EDIT_OBJECT                     0x95C4
409 // Called to commit changes made by SendPartialObject and TruncateObject
410 #define MTP_OPERATION_END_EDIT_OBJECT                       0x95C5
411 
412 // MTP Response Codes
413 #define MTP_RESPONSE_UNDEFINED                                  0x2000
414 #define MTP_RESPONSE_OK                                         0x2001
415 #define MTP_RESPONSE_GENERAL_ERROR                              0x2002
416 #define MTP_RESPONSE_SESSION_NOT_OPEN                           0x2003
417 #define MTP_RESPONSE_INVALID_TRANSACTION_ID                     0x2004
418 #define MTP_RESPONSE_OPERATION_NOT_SUPPORTED                    0x2005
419 #define MTP_RESPONSE_PARAMETER_NOT_SUPPORTED                    0x2006
420 #define MTP_RESPONSE_INCOMPLETE_TRANSFER                        0x2007
421 #define MTP_RESPONSE_INVALID_STORAGE_ID                         0x2008
422 #define MTP_RESPONSE_INVALID_OBJECT_HANDLE                      0x2009
423 #define MTP_RESPONSE_DEVICE_PROP_NOT_SUPPORTED                  0x200A
424 #define MTP_RESPONSE_INVALID_OBJECT_FORMAT_CODE                 0x200B
425 #define MTP_RESPONSE_STORAGE_FULL                               0x200C
426 #define MTP_RESPONSE_OBJECT_WRITE_PROTECTED                     0x200D
427 #define MTP_RESPONSE_STORE_READ_ONLY                            0x200E
428 #define MTP_RESPONSE_ACCESS_DENIED                              0x200F
429 #define MTP_RESPONSE_NO_THUMBNAIL_PRESENT                       0x2010
430 #define MTP_RESPONSE_SELF_TEST_FAILED                           0x2011
431 #define MTP_RESPONSE_PARTIAL_DELETION                           0x2012
432 #define MTP_RESPONSE_STORE_NOT_AVAILABLE                        0x2013
433 #define MTP_RESPONSE_SPECIFICATION_BY_FORMAT_UNSUPPORTED        0x2014
434 #define MTP_RESPONSE_NO_VALID_OBJECT_INFO                       0x2015
435 #define MTP_RESPONSE_INVALID_CODE_FORMAT                        0x2016
436 #define MTP_RESPONSE_UNKNOWN_VENDOR_CODE                        0x2017
437 #define MTP_RESPONSE_CAPTURE_ALREADY_TERMINATED                 0x2018
438 #define MTP_RESPONSE_DEVICE_BUSY                                0x2019
439 #define MTP_RESPONSE_INVALID_PARENT_OBJECT                      0x201A
440 #define MTP_RESPONSE_INVALID_DEVICE_PROP_FORMAT                 0x201B
441 #define MTP_RESPONSE_INVALID_DEVICE_PROP_VALUE                  0x201C
442 #define MTP_RESPONSE_INVALID_PARAMETER                          0x201D
443 #define MTP_RESPONSE_SESSION_ALREADY_OPEN                       0x201E
444 #define MTP_RESPONSE_TRANSACTION_CANCELLED                      0x201F
445 #define MTP_RESPONSE_SPECIFICATION_OF_DESTINATION_UNSUPPORTED   0x2020
446 #define MTP_RESPONSE_INVALID_OBJECT_PROP_CODE                   0xA801
447 #define MTP_RESPONSE_INVALID_OBJECT_PROP_FORMAT                 0xA802
448 #define MTP_RESPONSE_INVALID_OBJECT_PROP_VALUE                  0xA803
449 #define MTP_RESPONSE_INVALID_OBJECT_REFERENCE                   0xA804
450 #define MTP_RESPONSE_GROUP_NOT_SUPPORTED                        0xA805
451 #define MTP_RESPONSE_INVALID_DATASET                            0xA806
452 #define MTP_RESPONSE_SPECIFICATION_BY_GROUP_UNSUPPORTED         0xA807
453 #define MTP_RESPONSE_SPECIFICATION_BY_DEPTH_UNSUPPORTED         0xA808
454 #define MTP_RESPONSE_OBJECT_TOO_LARGE                           0xA809
455 #define MTP_RESPONSE_OBJECT_PROP_NOT_SUPPORTED                  0xA80A
456 
457 // MTP Event Codes
458 #define MTP_EVENT_UNDEFINED                         0x4000
459 #define MTP_EVENT_CANCEL_TRANSACTION                0x4001
460 #define MTP_EVENT_OBJECT_ADDED                      0x4002
461 #define MTP_EVENT_OBJECT_REMOVED                    0x4003
462 #define MTP_EVENT_STORE_ADDED                       0x4004
463 #define MTP_EVENT_STORE_REMOVED                     0x4005
464 #define MTP_EVENT_DEVICE_PROP_CHANGED               0x4006
465 #define MTP_EVENT_OBJECT_INFO_CHANGED               0x4007
466 #define MTP_EVENT_DEVICE_INFO_CHANGED               0x4008
467 #define MTP_EVENT_REQUEST_OBJECT_TRANSFER           0x4009
468 #define MTP_EVENT_STORE_FULL                        0x400A
469 #define MTP_EVENT_DEVICE_RESET                      0x400B
470 #define MTP_EVENT_STORAGE_INFO_CHANGED              0x400C
471 #define MTP_EVENT_CAPTURE_COMPLETE                  0x400D
472 #define MTP_EVENT_UNREPORTED_STATUS                 0x400E
473 #define MTP_EVENT_OBJECT_PROP_CHANGED               0xC801
474 #define MTP_EVENT_OBJECT_PROP_DESC_CHANGED          0xC802
475 #define MTP_EVENT_OBJECT_REFERENCES_CHANGED         0xC803
476 
477 // Storage Type
478 #define MTP_STORAGE_FIXED_ROM                       0x0001
479 #define MTP_STORAGE_REMOVABLE_ROM                   0x0002
480 #define MTP_STORAGE_FIXED_RAM                       0x0003
481 #define MTP_STORAGE_REMOVABLE_RAM                   0x0004
482 
483 // Storage File System
484 #define MTP_STORAGE_FILESYSTEM_FLAT                 0x0001
485 #define MTP_STORAGE_FILESYSTEM_HIERARCHICAL         0x0002
486 #define MTP_STORAGE_FILESYSTEM_DCF                  0x0003
487 
488 // Storage Access Capability
489 #define MTP_STORAGE_READ_WRITE                      0x0000
490 #define MTP_STORAGE_READ_ONLY_WITHOUT_DELETE        0x0001
491 #define MTP_STORAGE_READ_ONLY_WITH_DELETE           0x0002
492 
493 // Association Type
494 #define MTP_ASSOCIATION_TYPE_UNDEFINED              0x0000
495 #define MTP_ASSOCIATION_TYPE_GENERIC_FOLDER         0x0001
496 
497 // MTP class reqeusts
498 #define MTP_REQ_CANCEL              0x64
499 #define MTP_REQ_GET_EXT_EVENT_DATA  0x65
500 #define MTP_REQ_RESET               0x66
501 #define MTP_REQ_GET_DEVICE_STATUS   0x67
502 
503 #endif // _MTP_H
504