path: root/src/class/mtp/mtp.h

/*
 * SPDX-FileCopyrightText: Copyright (c) 2025 Ennebi Elettronica (https://ennebielettronica.com)
 * SPDX-FileCopyrightText: Copyright (c) 2025 Ha Thach (tinyusb.org)
 * SPDX-License-Identifier: MIT
 *
 * This file is part of the TinyUSB stack.
 */

#ifndef TUSB_MTP_H_
#define TUSB_MTP_H_

#include "common/tusb_common.h"

#if (CFG_TUD_ENABLED && CFG_TUD_MTP)

#ifdef __cplusplus
 extern "C" {
#endif

//--------------------------------------------------------------------+
// Media Transfer Protocol Class Constant
//--------------------------------------------------------------------+

// Media Transfer Protocol Subclass
typedef enum {
  MTP_SUBCLASS_STILL_IMAGE = 1
} mtp_subclass_type_t;

// MTP Protocol.
typedef enum {
  MTP_PROTOCOL_PIMA_15470 = 1, ///< Picture Transfer Protocol (PIMA 15470)
} mtp_protocol_type_t;

// PTP/MTP protocol phases
typedef enum {
  MTP_PHASE_COMMAND = 0,
  MTP_PHASE_DATA,
  MTP_PHASE_RESPONSE,
  MTP_PHASE_ERROR
} mtp_phase_type_t;

// PTP/MTP Class requests, PIMA 15740-2000: D.5.2
typedef enum {
  MTP_REQ_CANCEL             = 0x64,
  MTP_REQ_GET_EXT_EVENT_DATA = 0x65,
  MTP_REQ_RESET              = 0x66,
  MTP_REQ_GET_DEVICE_STATUS  = 0x67,
} mtp_class_request_t;

// PTP/MTP Container type
typedef enum {
  MTP_CONTAINER_TYPE_UNDEFINED      = 0,
  MTP_CONTAINER_TYPE_COMMAND_BLOCK  = 1,
  MTP_CONTAINER_TYPE_DATA_BLOCK     = 2,
  MTP_CONTAINER_TYPE_RESPONSE_BLOCK = 3,
  MTP_CONTAINER_TYPE_EVENT_BLOCK    = 4,
} mtp_container_type_t;

// MTP 1.1 Appendix A: Object formats
typedef enum {
  // ---- Base formats ----
  MTP_OBJ_FORMAT_UNDEFINED        = 0x3000u, // Undefined object
  MTP_OBJ_FORMAT_ASSOCIATION      = 0x3001u, // Association (for example, a folder)
  MTP_OBJ_FORMAT_SCRIPT           = 0x3002u, // Device model-specific script
  MTP_OBJ_FORMAT_EXECUTABLE       = 0x3003u, // Device model-specific binary executable
  MTP_OBJ_FORMAT_TEXT             = 0x3004u, // Text file
  MTP_OBJ_FORMAT_HTML             = 0x3005u, // Hypertext Markup Language file (text)
  MTP_OBJ_FORMAT_DPOF             = 0x3006u, // Digital Print Order Format file (text)
  MTP_OBJ_FORMAT_AIFF             = 0x3007u, // Audio clip (AIFF)
  MTP_OBJ_FORMAT_WAV              = 0x3008u, // Audio clip (WAV)
  MTP_OBJ_FORMAT_MP3              = 0x3009u, // MPEG-1 Layer III audio (ISO/IEC 13818-3)
  MTP_OBJ_FORMAT_AVI              = 0x300Au, // Video clip (AVI)
  MTP_OBJ_FORMAT_MPEG             = 0x300Bu, // Video clip (MPEG)
  MTP_OBJ_FORMAT_ASF              = 0x300Cu, // Microsoft Advanced Streaming Format (video)

  // ---- Image formats ----
  MTP_OBJ_FORMAT_UNDEFINED_IMAGE  = 0x3800u, // Undefined image object
  MTP_OBJ_FORMAT_EXIF_JPEG        = 0x3801u, // Exchangeable Image Format, JEIDA standard
  MTP_OBJ_FORMAT_TIFF_EP          = 0x3802u, // Tag Image File Format for Electronic Photography
  MTP_OBJ_FORMAT_FLASHPIX         = 0x3803u, // Structured Storage Image Format (FlashPix)
  MTP_OBJ_FORMAT_BMP              = 0x3804u, // Microsoft Windows Bitmap file
  MTP_OBJ_FORMAT_CIFF             = 0x3805u, // Canon Camera Image File Format
  MTP_OBJ_FORMAT_UNDEFINED_3806   = 0x3806u, // Reserved / Undefined
  MTP_OBJ_FORMAT_GIF              = 0x3807u, // Graphics Interchange Format
  MTP_OBJ_FORMAT_JFIF             = 0x3808u, // JPEG File Interchange Format
  MTP_OBJ_FORMAT_CD               = 0x3809u, // PhotoCD Image Pac
  MTP_OBJ_FORMAT_PICT             = 0x380Au, // Quickdraw Image Format
  MTP_OBJ_FORMAT_PNG              = 0x380Bu, // Portable Network Graphics
  MTP_OBJ_FORMAT_UNDEFINED_380C   = 0x380Cu, // Reserved / Undefined
  MTP_OBJ_FORMAT_TIFF             = 0x380Du, // Tag Image File Format (baseline)
  MTP_OBJ_FORMAT_TIFF_IT          = 0x380Eu, // Tag Image File Format for IT (graphic arts)
  MTP_OBJ_FORMAT_JP2              = 0x380Fu, // JPEG2000 Baseline File Format
  MTP_OBJ_FORMAT_JPX              = 0x3810u, // JPEG2000 Extended File Format

  // ---- Firmware & misc ----
  MTP_OBJ_FORMAT_UNDEFINED_FIRMWARE = 0xB802u, // Undefined Firmware
  MTP_OBJ_FORMAT_WBMP               = 0xB803u, // Wireless Application Protocol Bitmap Format (.wbmp)
  MTP_OBJ_FORMAT_WINDOWS_IMAGE      = 0xB881u, // Windows Image Format
  MTP_OBJ_FORMAT_JPEGXR             = 0xB804u, // JPEG XR (.hdp, .jxr, .wdp)

  // ---- Audio formats ----
  MTP_OBJ_FORMAT_UNDEFINED_AUDIO  = 0xB900u, // Undefined audio object
  MTP_OBJ_FORMAT_WMA              = 0xB901u, // Windows Media Audio
  MTP_OBJ_FORMAT_OGG              = 0xB902u, // OGG container
  MTP_OBJ_FORMAT_AAC              = 0xB903u, // Advanced Audio Coding (.aac)
  MTP_OBJ_FORMAT_AUDIBLE          = 0xB904u, // Audible format
  MTP_OBJ_FORMAT_FLAC             = 0xB906u, // Free Lossless Audio Codec
  MTP_OBJ_FORMAT_QCELP            = 0xB907u, // Qualcomm Code Excited Linear Prediction (.qcp)
  MTP_OBJ_FORMAT_AMR              = 0xB908u, // Adaptive Multi-Rate audio (.amr)

  // ---- Video formats ----
  MTP_OBJ_FORMAT_UNDEFINED_VIDEO  = 0xB980u, // Undefined video object
  MTP_OBJ_FORMAT_WMV              = 0xB981u, // Windows Media Video
  MTP_OBJ_FORMAT_MP4              = 0xB982u, // MP4 Container (ISO 14496-1)
  MTP_OBJ_FORMAT_MP2              = 0xB983u, // MPEG-1 Layer II audio
  MTP_OBJ_FORMAT_3GP              = 0xB984u, // 3GP Container
  MTP_OBJ_FORMAT_3G2              = 0xB985u, // 3GPP2 Container
  MTP_OBJ_FORMAT_AVCHD            = 0xB986u, // AVCHD (MPEG-4 AVC + Dolby Digital)
  MTP_OBJ_FORMAT_ATSC_TS          = 0xB987u, // ATSC-compliant MPEG-2 Transport Stream
  MTP_OBJ_FORMAT_DVB_TS           = 0xB988u, // DVB-compliant MPEG-2 Transport Stream

  // ---- Collections ----
  MTP_OBJ_FORMAT_UNDEFINED_COLLECTION          = 0xBA00u, // Undefined collection
  MTP_OBJ_FORMAT_ABSTRACT_MULTIMEDIA_ALBUM     = 0xBA01u, // Abstract Multimedia Album
  MTP_OBJ_FORMAT_ABSTRACT_IMAGE_ALBUM          = 0xBA02u, // Abstract Image Album
  MTP_OBJ_FORMAT_ABSTRACT_AUDIO_ALBUM          = 0xBA03u, // Abstract Audio Album
  MTP_OBJ_FORMAT_ABSTRACT_VIDEO_ALBUM          = 0xBA04u, // Abstract Video Album
  MTP_OBJ_FORMAT_ABSTRACT_AV_PLAYLIST          = 0xBA05u, // Abstract Audio & Video Playlist
  MTP_OBJ_FORMAT_ABSTRACT_CONTACT_GROUP        = 0xBA06u, // Abstract Contact Group
  MTP_OBJ_FORMAT_ABSTRACT_MESSAGE_FOLDER       = 0xBA07u, // Abstract Message Folder
  MTP_OBJ_FORMAT_ABSTRACT_CHAPTERED_PRODUCTION = 0xBA08u, // Abstract Chaptered Production
  MTP_OBJ_FORMAT_ABSTRACT_AUDIO_PLAYLIST       = 0xBA09u, // Abstract Audio Playlist
  MTP_OBJ_FORMAT_ABSTRACT_VIDEO_PLAYLIST       = 0xBA0Au, // Abstract Video Playlist
  MTP_OBJ_FORMAT_ABSTRACT_MEDIACAST            = 0xBA0Bu, // Abstract Mediacast (RSS enclosure)

  // ---- Playlist formats ----
  MTP_OBJ_FORMAT_WPL_PLAYLIST     = 0xBA10u, // Windows Media Player Playlist (.wpl)
  MTP_OBJ_FORMAT_M3U_PLAYLIST     = 0xBA11u, // M3U Playlist
  MTP_OBJ_FORMAT_MPL_PLAYLIST     = 0xBA12u, // MPL Playlist
  MTP_OBJ_FORMAT_ASX_PLAYLIST     = 0xBA13u, // ASX Playlist
  MTP_OBJ_FORMAT_PLS_PLAYLIST     = 0xBA14u, // PLS Playlist

  // ---- Document formats ----
  MTP_OBJ_FORMAT_UNDEFINED_DOC    = 0xBA80u, // Undefined Document
  MTP_OBJ_FORMAT_ABSTRACT_DOC     = 0xBA81u, // Abstract Document
  MTP_OBJ_FORMAT_XML_DOC          = 0xBA82u, // XML Document
  MTP_OBJ_FORMAT_DOC              = 0xBA83u, // Microsoft Word Document
  MTP_OBJ_FORMAT_MHT_DOC          = 0xBA84u, // MHT Compiled HTML Document
  MTP_OBJ_FORMAT_XLS              = 0xBA85u, // Microsoft Excel Spreadsheet
  MTP_OBJ_FORMAT_PPT              = 0xBA86u, // Microsoft PowerPoint Presentation

  // ---- Messaging ----
  MTP_OBJ_FORMAT_UNDEFINED_MSG    = 0xBB00u, // Undefined Message
  MTP_OBJ_FORMAT_ABSTRACT_MSG     = 0xBB01u, // Abstract Message

  // ---- Bookmarks ----
  MTP_OBJ_FORMAT_UNDEFINED_BOOKMARK = 0xBB10u, // Undefined Bookmark
  MTP_OBJ_FORMAT_ABSTRACT_BOOKMARK  = 0xBB11u, // Abstract Bookmark

  // ---- Appointments ----
  MTP_OBJ_FORMAT_UNDEFINED_APPT   = 0xBB20u, // Undefined Appointment
  MTP_OBJ_FORMAT_ABSTRACT_APPT    = 0xBB21u, // Abstract Appointment
  MTP_OBJ_FORMAT_VCALENDAR1       = 0xBB22u, // vCalendar 1.0

  // ---- Tasks ----
  MTP_OBJ_FORMAT_UNDEFINED_TASK   = 0xBB40u, // Undefined Task
  MTP_OBJ_FORMAT_ABSTRACT_TASK    = 0xBB41u, // Abstract Task
  MTP_OBJ_FORMAT_ICALENDAR        = 0xBB42u, // iCalendar

  // ---- Notes ----
  MTP_OBJ_FORMAT_UNDEFINED_NOTE   = 0xBB60u, // Undefined Note
  MTP_OBJ_FORMAT_ABSTRACT_NOTE    = 0xBB61u, // Abstract Note

  // ---- Contacts ----
  MTP_OBJ_FORMAT_UNDEFINED_CONTACT= 0xBB80u, // Undefined Contact
  MTP_OBJ_FORMAT_ABSTRACT_CONTACT = 0xBB81u, // Abstract Contact
  MTP_OBJ_FORMAT_VCARD2           = 0xBB82u, // vCard 2.1
  MTP_OBJ_FORMAT_VCARD3           = 0xBB83u, // vCard 3.0
} mtp_object_formats_t;

// MTP 1.1 Appendix B: Object Properties
typedef enum {
  MTP_OBJ_PROP_STORAGE_ID                 = 0xDC01u, // StorageID
  MTP_OBJ_PROP_OBJECT_FORMAT              = 0xDC02u, // Object Format
  MTP_OBJ_PROP_PROTECTION_STATUS          = 0xDC03u, // Protection Status
  MTP_OBJ_PROP_OBJECT_SIZE                = 0xDC04u, // Object Size
  MTP_OBJ_PROP_ASSOCIATION_TYPE           = 0xDC05u, // Association Type
  MTP_OBJ_PROP_ASSOCIATION_DESC           = 0xDC06u, // Association Description
  MTP_OBJ_PROP_OBJECT_FILE_NAME           = 0xDC07u, // Object File Name
  MTP_OBJ_PROP_DATE_CREATED               = 0xDC08u, // Date Created
  MTP_OBJ_PROP_DATE_MODIFIED              = 0xDC09u, // Date Modified
  MTP_OBJ_PROP_KEYWORDS                   = 0xDC0Au, // Keywords
  MTP_OBJ_PROP_PARENT_OBJECT              = 0xDC0Bu, // Parent Object
  MTP_OBJ_PROP_ALLOWED_FOLDER_CONTENTS    = 0xDC0Cu, // Allowed Folder Contents
  MTP_OBJ_PROP_HIDDEN                     = 0xDC0Du, // Hidden
  MTP_OBJ_PROP_SYSTEM_OBJECT              = 0xDC0Eu, // System Object
  // 0xDC0F-0xDC40 is reserved

  MTP_OBJ_PROP_PERSISTENT_UID             = 0xDC41u, // Persistent Unique Object Identifier
  MTP_OBJ_PROP_SYNC_ID                    = 0xDC42u, // SyncID
  MTP_OBJ_PROP_PROPERTY_BAG               = 0xDC43u, // Property Bag
  MTP_OBJ_PROP_NAME                       = 0xDC44u, // Name
  MTP_OBJ_PROP_CREATED_BY                 = 0xDC45u, // Created By
  MTP_OBJ_PROP_ARTIST                     = 0xDC46u, // Artist
  MTP_OBJ_PROP_DATE_AUTHORED              = 0xDC47u, // Date Authored
  MTP_OBJ_PROP_DESCRIPTION                = 0xDC48u, // Description
  MTP_OBJ_PROP_URL_REFERENCE              = 0xDC49u, // URL Reference
  MTP_OBJ_PROP_LANGUAGE_LOCALE            = 0xDC4Au, // Language-Locale
  MTP_OBJ_PROP_COPYRIGHT_INFO             = 0xDC4Bu, // Copyright Information
  MTP_OBJ_PROP_SOURCE                     = 0xDC4Cu, // Source
  MTP_OBJ_PROP_ORIGIN_LOCATION            = 0xDC4Du, // Origin Location
  MTP_OBJ_PROP_DATE_ADDED                 = 0xDC4Eu, // Date Added
  MTP_OBJ_PROP_NON_CONSUMABLE             = 0xDC4Fu, // Non-Consumable
  MTP_OBJ_PROP_CORRUPT_UNPLAYABLE         = 0xDC50u, // Corrupt/Unplayable
  MTP_OBJ_PROP_PRODUCER_SERIAL_NUMBER     = 0xDC51u, // ProducerSerialNumber
  // 0xDC52-0xDC80 is reserved

  MTP_OBJ_PROP_REP_SAMPLE_FORMAT          = 0xDC81u, // Representative Sample Format
  MTP_OBJ_PROP_REP_SAMPLE_SIZE            = 0xDC82u, // Representative Sample Size
  MTP_OBJ_PROP_REP_SAMPLE_HEIGHT          = 0xDC83u, // Representative Sample Height
  MTP_OBJ_PROP_REP_SAMPLE_WIDTH           = 0xDC84u, // Representative Sample Width
  MTP_OBJ_PROP_REP_SAMPLE_DURATION        = 0xDC85u, // Representative Sample Duration
  MTP_OBJ_PROP_REP_SAMPLE_DATA            = 0xDC86u, // Representative Sample Data
  MTP_OBJ_PROP_WIDTH                      = 0xDC87u, // Width
  MTP_OBJ_PROP_HEIGHT                     = 0xDC88u, // Height
  MTP_OBJ_PROP_DURATION                   = 0xDC89u, // Duration
  MTP_OBJ_PROP_RATING                     = 0xDC8Au, // Rating
  MTP_OBJ_PROP_TRACK                      = 0xDC8Bu, // Track
  MTP_OBJ_PROP_GENRE                      = 0xDC8Cu, // Genre
  MTP_OBJ_PROP_CREDITS                    = 0xDC8Du, // Credits
  MTP_OBJ_PROP_LYRICS                     = 0xDC8Eu, // Lyrics
  MTP_OBJ_PROP_SUBSCRIPTION_CONTENT_ID    = 0xDC8Fu, // Subscription Content ID
  MTP_OBJ_PROP_PRODUCED_BY                = 0xDC90u, // Produced By
  MTP_OBJ_PROP_USE_COUNT                  = 0xDC91u, // Use Count
  MTP_OBJ_PROP_SKIP_COUNT                 = 0xDC92u, // Skip Count
  MTP_OBJ_PROP_LAST_ACCESSED              = 0xDC93u, // Last Accessed
  MTP_OBJ_PROP_PARENTAL_RATING            = 0xDC94u, // Parental Rating
  MTP_OBJ_PROP_META_GENRE                 = 0xDC95u, // Meta Genre
  MTP_OBJ_PROP_COMPOSER                   = 0xDC96u, // Composer
  MTP_OBJ_PROP_EFFECTIVE_RATING           = 0xDC97u, // Effective Rating
  MTP_OBJ_PROP_SUBTITLE                   = 0xDC98u, // Subtitle
  MTP_OBJ_PROP_ORIGINAL_RELEASE_DATE      = 0xDC99u, // Original Release Date
  MTP_OBJ_PROP_ALBUM_NAME                 = 0xDC9Au, // Album Name
  MTP_OBJ_PROP_ALBUM_ARTIST               = 0xDC9Bu, // Album Artist
  MTP_OBJ_PROP_MOOD                       = 0xDC9Cu, // Mood
  MTP_OBJ_PROP_DRM_STATUS                 = 0xDC9Du, // DRM Status
  MTP_OBJ_PROP_SUB_DESCRIPTION            = 0xDC9Eu, // Sub Description
  // 0xDC9F-0xDCD0 is reserved

  MTP_OBJ_PROP_IS_CROPPED                 = 0xDCD1u, // Is Cropped
  MTP_OBJ_PROP_IS_COLOUR_CORRECTED        = 0xDCD2u, // Is Colour Corrected
  MTP_OBJ_PROP_IMAGE_BIT_DEPTH            = 0xDCD3u, // Image Bit Depth
  MTP_OBJ_PROP_FNUMBER                    = 0xDCD4u, // Fnumber (aperture ×100)
  MTP_OBJ_PROP_EXPOSURE_TIME              = 0xDCD5u, // Exposure Time (sec ×10,000)
  MTP_OBJ_PROP_EXPOSURE_INDEX             = 0xDCD6u, // Exposure Index (ISO)
  // 0xDCD7-0xDCDF is reserved

  MTP_OBJ_PROP_DISPLAY_NAME               = 0xDCE0u, // Display Name
  MTP_OBJ_PROP_BODY_TEXT                  = 0xDCE1u, // Body Text
  MTP_OBJ_PROP_SUBJECT                    = 0xDCE2u, // Subject
  MTP_OBJ_PROP_PRIORITY                   = 0xDCE3u, // Priority
  // 0xDCE4-0xDCFF is reserved

  MTP_OBJ_PROP_GIVEN_NAME                 = 0xDD00u, // Given Name
  MTP_OBJ_PROP_MIDDLE_NAMES               = 0xDD01u, // Middle Names
  MTP_OBJ_PROP_FAMILY_NAME                = 0xDD02u, // Family Name
  MTP_OBJ_PROP_PREFIX                     = 0xDD03u, // Prefix
  MTP_OBJ_PROP_SUFFIX                     = 0xDD04u, // Suffix
  MTP_OBJ_PROP_PHONETIC_GIVEN_NAME        = 0xDD05u, // Phonetic Given Name
  MTP_OBJ_PROP_PHONETIC_FAMILY_NAME       = 0xDD06u, // Phonetic Family Name
  MTP_OBJ_PROP_EMAIL_PRIMARY              = 0xDD07u, // Email Primary
  MTP_OBJ_PROP_EMAIL_PERSONAL_1           = 0xDD08u, // Email Personal 1
  MTP_OBJ_PROP_EMAIL_PERSONAL_2           = 0xDD09u, // Email Personal 2
  MTP_OBJ_PROP_EMAIL_BUSINESS_1           = 0xDD0Au, // Email Business 1
  MTP_OBJ_PROP_EMAIL_BUSINESS_2           = 0xDD0Bu, // Email Business 2
  MTP_OBJ_PROP_EMAIL_OTHERS               = 0xDD0Cu, // Email Others
  MTP_OBJ_PROP_PHONE_PRIMARY              = 0xDD0Du, // Phone Number Primary
  MTP_OBJ_PROP_PHONE_PERSONAL_1           = 0xDD0Eu, // Phone Number Personal
  MTP_OBJ_PROP_PHONE_PERSONAL_2           = 0xDD0Fu, // Phone Number Personal 2
  MTP_OBJ_PROP_PHONE_BUSINESS_1           = 0xDD10u, // Phone Number Business
  MTP_OBJ_PROP_PHONE_BUSINESS_2           = 0xDD11u, // Phone Number Business 2
  MTP_OBJ_PROP_PHONE_MOBILE_1             = 0xDD12u, // Phone Number Mobile
  MTP_OBJ_PROP_PHONE_MOBILE_2             = 0xDD13u, // Phone Number Mobile 2
  MTP_OBJ_PROP_FAX_PRIMARY                = 0xDD14u, // Fax Number Primary
  MTP_OBJ_PROP_FAX_PERSONAL               = 0xDD15u, // Fax Number Personal
  MTP_OBJ_PROP_FAX_BUSINESS               = 0xDD16u, // Fax Number Business
  MTP_OBJ_PROP_PAGER_NUMBER               = 0xDD17u, // Pager Number
  MTP_OBJ_PROP_PHONE_OTHERS               = 0xDD18u, // Phone Number Others
  MTP_OBJ_PROP_WEB_PRIMARY                = 0xDD19u, // Primary Web Address
  MTP_OBJ_PROP_WEB_PERSONAL               = 0xDD1Au, // Personal Web Address
  MTP_OBJ_PROP_WEB_BUSINESS               = 0xDD1Bu, // Business Web Address
  MTP_OBJ_PROP_IM_ADDRESS_1               = 0xDD1Cu, // Instant Messenger Address
  MTP_OBJ_PROP_IM_ADDRESS_2               = 0xDD1Du, // Instant Messenger Address 2
  MTP_OBJ_PROP_IM_ADDRESS_3               = 0xDD1Eu, // Instant Messenger Address 3
  MTP_OBJ_PROP_ADDR_PERSONAL_FULL         = 0xDD1Fu, // Postal Address Personal Full
  MTP_OBJ_PROP_ADDR_PERSONAL_LINE1        = 0xDD20u, // Postal Address Personal Line 1
  MTP_OBJ_PROP_ADDR_PERSONAL_LINE2        = 0xDD21u, // Postal Address Personal Line 2
  MTP_OBJ_PROP_ADDR_PERSONAL_CITY         = 0xDD22u, // Postal Address Personal City
  MTP_OBJ_PROP_ADDR_PERSONAL_REGION       = 0xDD23u, // Postal Address Personal Region
  MTP_OBJ_PROP_ADDR_PERSONAL_POSTAL_CODE  = 0xDD24u, // Postal Address Personal Postal Code
  MTP_OBJ_PROP_ADDR_PERSONAL_COUNTRY      = 0xDD25u, // Postal Address Personal Country
  MTP_OBJ_PROP_ADDR_BUSINESS_FULL         = 0xDD26u, // Postal Address Business Full
  MTP_OBJ_PROP_ADDR_BUSINESS_LINE1        = 0xDD27u, // Postal Address Business Line 1
  MTP_OBJ_PROP_ADDR_BUSINESS_LINE2        = 0xDD28u, // Postal Address Business Line 2
  MTP_OBJ_PROP_ADDR_BUSINESS_CITY         = 0xDD29u, // Postal Address Business City
  MTP_OBJ_PROP_ADDR_BUSINESS_REGION       = 0xDD2Au, // Postal Address Business Region
  MTP_OBJ_PROP_ADDR_BUSINESS_POSTAL_CODE  = 0xDD2Bu, // Postal Address Business Postal Code
  MTP_OBJ_PROP_ADDR_BUSINESS_COUNTRY      = 0xDD2Cu, // Postal Address Business Country
  MTP_OBJ_PROP_ADDR_OTHER_FULL            = 0xDD2Du, // Postal Address Other Full
  MTP_OBJ_PROP_ADDR_OTHER_LINE1           = 0xDD2Eu, // Postal Address Other Line 1
  MTP_OBJ_PROP_ADDR_OTHER_LINE2           = 0xDD2Fu, // Postal Address Other Line 2
  MTP_OBJ_PROP_ADDR_OTHER_CITY            = 0xDD30u, // Postal Address Other City
  MTP_OBJ_PROP_ADDR_OTHER_REGION          = 0xDD31u, // Postal Address Other Region
  MTP_OBJ_PROP_ADDR_OTHER_POSTAL_CODE     = 0xDD32u, // Postal Address Other Postal Code
  MTP_OBJ_PROP_ADDR_OTHER_COUNTRY         = 0xDD33u, // Postal Address Other Country
  MTP_OBJ_PROP_ORGANIZATION_NAME          = 0xDD34u, // Organization Name
  MTP_OBJ_PROP_PHONETIC_ORG_NAME          = 0xDD35u, // Phonetic Organization Name
  MTP_OBJ_PROP_ROLE                       = 0xDD36u, // Role
  MTP_OBJ_PROP_BIRTHDATE                  = 0xDD37u, // Birthdate
  // 0xDD38-0xDD3F is reserved

  MTP_OBJ_PROP_MESSAGE_TO                 = 0xDD40u, // Message To
  MTP_OBJ_PROP_MESSAGE_CC                 = 0xDD41u, // Message CC
  MTP_OBJ_PROP_MESSAGE_BCC                = 0xDD42u, // Message BCC
  MTP_OBJ_PROP_MESSAGE_READ               = 0xDD43u, // Message Read
  MTP_OBJ_PROP_MESSAGE_RECEIVED_TIME      = 0xDD44u, // Message Received Time
  MTP_OBJ_PROP_MESSAGE_SENDER             = 0xDD45u, // Message Sender
  // 0xDD46-0xDD4F is reserved

  MTP_OBJ_PROP_ACTIVITY_BEGIN_TIME        = 0xDD50u, // Activity Begin Time
  MTP_OBJ_PROP_ACTIVITY_END_TIME          = 0xDD51u, // Activity End Time
  MTP_OBJ_PROP_ACTIVITY_LOCATION          = 0xDD52u, // Activity Location
  // 0xDD53 is reserved
  MTP_OBJ_PROP_ACTIVITY_REQUIRED_ATTENDEES= 0xDD54u, // Activity Required Attendees
  MTP_OBJ_PROP_ACTIVITY_OPTIONAL_ATTENDEES= 0xDD55u, // Activity Optional Attendees
  MTP_OBJ_PROP_ACTIVITY_RESOURCES         = 0xDD56u, // Activity Resources
  MTP_OBJ_PROP_ACTIVITY_ACCEPTED          = 0xDD57u, // Activity Accepted
  MTP_OBJ_PROP_ACTIVITY_TENTATIVE         = 0xDD58u, // Activity Tentative
  MTP_OBJ_PROP_ACTIVITY_DECLINED          = 0xDD59u, // Activity Declined
  MTP_OBJ_PROP_ACTIVITY_REMINDER_TIME     = 0xDD5Au, // Activity Reminder Time
  MTP_OBJ_PROP_ACTIVITY_OWNER             = 0xDD5Bu, // Activity Owner
  MTP_OBJ_PROP_ACTIVITY_STATUS            = 0xDD5Cu, // Activity Status
  MTP_OBJ_PROP_OWNER                      = 0xDD5Du, // Owner
  MTP_OBJ_PROP_EDITOR                     = 0xDD5Eu, // Editor
  MTP_OBJ_PROP_WEBMASTER                  = 0xDD5Fu, // Webmaster

  MTP_OBJ_PROP_URL_SOURCE                 = 0xDD60u, // URL Source
  MTP_OBJ_PROP_URL_DESTINATION            = 0xDD61u, // URL Destination
  MTP_OBJ_PROP_TIME_BOOKMARK              = 0xDD62u, // Time Bookmark
  MTP_OBJ_PROP_OBJECT_BOOKMARK            = 0xDD63u, // Object Bookmark
  MTP_OBJ_PROP_BYTE_BOOKMARK              = 0xDD64u, // Byte Bookmark
  // 0xDD65-0xDD6F is reserved

  MTP_OBJ_PROP_LAST_BUILD_DATE            = 0xDD70u, // Last Build Date
  MTP_OBJ_PROP_TIME_TO_LIVE               = 0xDD71u, // Time to Live (minutes)
  MTP_OBJ_PROP_MEDIA_GUID                 = 0xDD72u, // Media GUID
  // 0xDD73-0xDDFF is reserved

  // media encoding
  MTP_OBJ_PROP_TOTAL_BITRATE              = 0xDE91u, // Total BitRate
  MTP_OBJ_PROP_BITRATE_TYPE               = 0xDE92u, // Bitrate Type
  MTP_OBJ_PROP_SAMPLE_RATE                = 0xDE93u, // Sample Rate
  MTP_OBJ_PROP_NUM_CHANNELS               = 0xDE94u, // Number Of Channels
  MTP_OBJ_PROP_AUDIO_BITDEPTH             = 0xDE95u, // Audio BitDepth
  // 0xDE96 is reserved
  MTP_OBJ_PROP_SCAN_TYPE                  = 0xDE97u, // Scan Type
  // 0xDE98 is reserved
  MTP_OBJ_PROP_AUDIO_WAVE_CODEC           = 0xDE99u, // Audio WAVE Codec
  MTP_OBJ_PROP_AUDIO_BITRATE              = 0xDE9Au, // Audio BitRate
  MTP_OBJ_PROP_VIDEO_FOURCC_CODEC         = 0xDE9Bu, // Video FourCC Codec
  MTP_OBJ_PROP_VIDEO_BITRATE              = 0xDE9Cu, // Video BitRate
  MTP_OBJ_PROP_FRAMES_PER_KSEC            = 0xDE9Du, // Frames Per Thousand Seconds
  MTP_OBJ_PROP_KEYFRAME_DISTANCE          = 0xDE9Eu, // KeyFrame Distance (ms)
  MTP_OBJ_PROP_BUFFER_SIZE                = 0xDE9Fu, // Buffer Size
  MTP_OBJ_PROP_ENCODING_QUALITY           = 0xDEA0u, // Encoding Quality
  MTP_OBJ_PROP_ENCODING_PROFILE           = 0xDEA1u  // Encoding Profile
} mtp_object_properties_t;


// MTP 1.1 Appendeix C: Device Properties
typedef enum {
  MTP_DEV_PROP_UNDEFINED                      = 0x5000u,
  MTP_DEV_PROP_BATTERY_LEVEL                  = 0x5001u,
  MTP_DEV_PROP_FUNCTIONAL_MODE                = 0x5002u,
  MTP_DEV_PROP_IMAGE_SIZE                     = 0x5003u,
  MTP_DEV_PROP_COMPRESSION_SETTING            = 0x5004u,
  MTP_DEV_PROP_WHITE_BALANCE                  = 0x5005u,
  MTP_DEV_PROP_RGB_GAIN                       = 0x5006u,
  MTP_DEV_PROP_F_NUMBER                       = 0x5007u,
  MTP_DEV_PROP_FOCAL_LENGTH                   = 0x5008u,
  MTP_DEV_PROP_FOCUS_DISTANCE                 = 0x5009u,
  MTP_DEV_PROP_FOCUS_MODE                     = 0x500Au,
  MTP_DEV_PROP_EXPOSURE_METERING_MODE         = 0x500Bu,
  MTP_DEV_PROP_FLASH_MODE                     = 0x500Cu,
  MTP_DEV_PROP_EXPOSURE_TIME                  = 0x500Du,
  MTP_DEV_PROP_EXPOSURE_PROGRAM_MODE          = 0x500Eu,
  MTP_DEV_PROP_EXPOSURE_INDEX                 = 0x500Fu,
  MTP_DEV_PROP_EXPOSURE_BIAS_COMPENSATION     = 0x5010u,
  MTP_DEV_PROP_DATE_TIME                      = 0x5011u,
  MTP_DEV_PROP_CAPTURE_DELAY                  = 0x5012u,
  MTP_DEV_PROP_STILL_CAPTURE_MODE             = 0x5013u,
  MTP_DEV_PROP_CONTRAST                       = 0x5014u,
  MTP_DEV_PROP_SHARPNESS                      = 0x5015u,
  MTP_DEV_PROP_DIGITAL_ZOOM                   = 0x5016u,
  MTP_DEV_PROP_EFFECT_MODE                    = 0x5017u,
  MTP_DEV_PROP_BURST_NUMBER                   = 0x5018u,
  MTP_DEV_PROP_BURST_INTERVAL                 = 0x5019u,
  MTP_DEV_PROP_TIMELAPSE_NUMBER               = 0x501Au,
  MTP_DEV_PROP_TIMELAPSE_INTERVAL             = 0x501Bu,
  MTP_DEV_PROP_FOCUS_METERING_MODE            = 0x501Cu,
  MTP_DEV_PROP_UPLOAD_URL                     = 0x501Du,
  MTP_DEV_PROP_ARTIST                         = 0x501Eu,
  MTP_DEV_PROP_COPYRIGHT_INFO                 = 0x501Fu,
  MTP_DEV_PROP_SYNCHRONIZTION_PARTNER         = 0xD401,
  MTP_DEV_PROP_DEVICE_FRIENDLY_NAME           = 0xD402u,
  MTP_DEV_PROP_VOLUME                         = 0xD403u,
  MTP_DEV_PROP_SUPPORTED_FORMATS_ORDERED      = 0xD404u,
  MTP_DEV_PROP_DEVICE_ICON                    = 0xD405u,
  MTP_DEV_PROP_SECTION_INITIATOR_VERSION_INFO = 0xD406u,
  MTP_DEV_PROP_PERCEIVED_DEVICE_TYPE          = 0xD407u,
  MTP_DEV_PROP_PLAYBACK_RATE                  = 0xD410u,
  MTP_DEV_PROP_PLAYBACK_OBJECT                = 0xD411u,
  MTP_DEV_PROP_PLAYBACK_CONTAINER_INDEX       = 0xD412u,
} mtp_event_properties_t;

// MTP 1.1 Appendix D: Operations
typedef enum {
  MTP_OP_UNDEFINED                  = 0x1000u,
  MTP_OP_GET_DEVICE_INFO            = 0x1001u,
  MTP_OP_OPEN_SESSION               = 0x1002u,
  MTP_OP_CLOSE_SESSION              = 0x1003u,
  MTP_OP_GET_STORAGE_IDS            = 0x1004u,
  MTP_OP_GET_STORAGE_INFO           = 0x1005u,
  MTP_OP_GET_NUM_OBJECTS            = 0x1006u,
  MTP_OP_GET_OBJECT_HANDLES         = 0x1007u,
  MTP_OP_GET_OBJECT_INFO            = 0x1008u,
  MTP_OP_GET_OBJECT                 = 0x1009u,
  MTP_OP_GET_THUMB                  = 0x100Au,
  MTP_OP_DELETE_OBJECT              = 0x100Bu,
  MTP_OP_SEND_OBJECT_INFO           = 0x100Cu,
  MTP_OP_SEND_OBJECT                = 0x100Du,
  MTP_OP_INITIATE_CAPTURE           = 0x100Eu,
  MTP_OP_FORMAT_STORE               = 0x100Fu,
  MTP_OP_RESET_DEVICE               = 0x1010u,
  MTP_OP_SELF_TEST                  = 0x1011u,
  MTP_OP_SET_OBJECT_PROTECTION      = 0x1012u,
  MTP_OP_POWER_DOWN                 = 0x1013u,
  MTP_OP_GET_DEVICE_PROP_DESC       = 0x1014u,
  MTP_OP_GET_DEVICE_PROP_VALUE      = 0x1015u,
  MTP_OP_SET_DEVICE_PROP_VALUE      = 0x1016u,
  MTP_OP_RESET_DEVICE_PROP_VALUE    = 0x1017u,
  MTP_OP_TERMINATE_OPEN_CAPTURE     = 0x1018u,
  MTP_OP_MOVE_OBJECT                = 0x1019u,
  MTP_OP_COPY_OBJECT                = 0x101Au,
  MTP_OP_GET_PARTIAL_OBJECT         = 0x101Bu,
  MTP_OP_INITIATE_OPEN_CAPTURE      = 0x101Bu,
  MTP_OP_GET_OBJECT_PROPS_SUPPORTED = 0x9801u,
  MTP_OP_GET_OBJECT_PROP_DESC       = 0x9802u,
  MTP_OP_GET_OBJECT_PROP_VALUE      = 0x9803u,
  MTP_OP_SET_OBJECT_PROP_VALUE      = 0x9804u,
  MTP_OP_GET_OBJECT_PROPLIST        = 0x9805u,
  MTP_OP_GET_OBJECT_PROP_REFERENCES = 0x9810u,

  MTP_OP_GET_SERVICE_IDS            = 0x9301u,
  MTP_OP_GET_SERVICE_INFO           = 0x9302u,
  MTP_OP_GET_SERVICE_CAPABILITIES   = 0x9303u,
  MTP_OP_GET_SERVICE_PROP_DESC      = 0x9304u,

  // Appendix E: Enhanced Operations
  MTP_OP_GET_OBJECT_PROP_LIST         = 0x9805u,
  MTP_OP_SET_OBJECT_PROP_LIST         = 0x9806u,
  MTP_OP_GET_INTERDEPENDENT_PROP_DESC = 0x9807u,
  MTP_OP_SEND_OBJECT_PROP_LIST        = 0x9808u,
} mtp_operation_code_t;

// Appendix F: Responses
typedef enum {
  MTP_RESP_UNDEFINED                           = 0x2000u,
  MTP_RESP_OK                                  = 0x2001u,
  MTP_RESP_GENERAL_ERROR                       = 0x2002u,
  MTP_RESP_SESSION_NOT_OPEN                    = 0x2003u,
  MTP_RESP_INVALID_TRANSACTION_ID              = 0x2004u,
  MTP_RESP_OPERATION_NOT_SUPPORTED             = 0x2005u,
  MTP_RESP_PARAMETER_NOT_SUPPORTED             = 0x2006u,
  MTP_RESP_INCOMPLETE_TRANSFER                 = 0x2007u,
  MTP_RESP_INVALID_STORAGE_ID                  = 0x2008u,
  MTP_RESP_INVALID_OBJECT_HANDLE               = 0x2009u,
  MTP_RESP_DEVICE_PROP_NOT_SUPPORTED           = 0x200Au,
  MTP_RESP_INVALID_OBJECT_FORMAT_CODE          = 0x200Bu,
  MTP_RESP_STORE_FULL                          = 0x200Cu,
  MTP_RESP_OBJECT_WRITE_PROTECTED              = 0x200Du,
  MPT_RESC_STORE_READ_ONLY                     = 0x200Eu,
  MTP_RESP_ACCESS_DENIED                       = 0x200Fu,
  MTP_RESP_NO_THUMBNAIL_PRESENT                = 0x2010u,
  MTP_RESP_SELF_TEST_FAILED                    = 0x2011u,
  MTP_RESP_PARTIAL_DELETION                    = 0x2012u,
  MTP_RESP_STORE_NOT_AVAILABLE                 = 0x2013u,
  MTP_RESP_SPECIFICATION_BY_FORMAT_UNSUPPORTED = 0x2014u,
  MTP_RESP_NO_VALID_OBJECTINFO                 = 0x2015u,
  MTP_RESP_INVALID_CODE_FORMAT                 = 0x2016u,
  MTP_RESP_UNKNOWN_VENDOR_CODE                 = 0x2017u,
  MTP_RESP_CAPTURE_ALREADY_TERMINATED          = 0x2018u,
  MTP_RESP_DEVICE_BUSY                         = 0x2019u,
  MTP_RESP_INVALID_PARENT_OBJECT               = 0x201Au,
  MTP_RESP_INVALID_DEVICE_PROP_FORMAT          = 0x201Bu,
  MTP_RESP_INVALID_DEVICE_PROP_VALUE           = 0x201Cu,
  MTP_RESP_INVALID_PARAMETER                   = 0x201Du,
  MTP_RESP_SESSION_ALREADY_OPEN                = 0x201Eu,
  MTP_RESP_TRANSACTION_CANCELLED               = 0x201Fu,
  MTP_RESP_SPEC_OF_DESTINATION_UNSUPPORTED     = 0x2020u,

  MTP_RESP_INVALID_OBJECT_PROP_CODE            = 0xA801u,
  MTP_RESP_INVALID_OBJECT_PROP_FORMAT          = 0xA802u,
  MTP_RESP_INVALID_OBJECT_PROP_VALUE           = 0xA803u,
  MTP_RESP_INVALID_OBJECT_REFERENCE            = 0xA804u,
  MTP_RESP_GROUP_NOT_SUPPORTED                 = 0xA805u,
  MTP_RESP_INVALID_DATASET                     = 0xA806u,
  MTP_RESP_SPEC_BY_GROUP_UNSUPPORTED           = 0xA807u,
  MTP_RESP_SPEC_BY_DEPTH_UNSUPPORTED           = 0xA808u,
  MTP_RESP_OBJECT_TOO_LARGE                    = 0xA809u,
  MTP_RESP_OBJECT_PROP_NOT_SUPPORTED           = 0xA80Au,
} mtp_response_t;

// Appendix G: Events
typedef enum {
  MTP_EVENT_UNDEFINED                 = 0x4000,
  MTP_EVENT_CANCEL_TRANSACTION        = 0x4001,
  MTP_EVENT_OBJECT_ADDED              = 0x4002,
  MTP_EVENT_OBJECT_REMOVED            = 0x4003,
  MTP_EVENT_STORE_ADDED               = 0x4004,
  MTP_EVENT_STORE_REMOVED             = 0x4005,
  MTP_EVENT_DEVICE_PROP_CHANGED       = 0x4006,
  MTP_EVENT_OBJECT_INFO_CHANGED       = 0x4007,
  MTP_EVENT_DEVICE_INFO_CHANGED       = 0x4008,
  MTP_EVENT_REQUEST_OBJECT_TRANSFER   = 0x4009,
  MTP_EVENT_STORE_FULL                = 0x400Au,
  MTP_EVENT_DEVICE_RESET              = 0x400Bu,
  MTP_EVENT_STORAGE_INFO_CHANGED      = 0x400Cu,
  MTP_EVENT_CAPTURE_COMPLETE          = 0x400Du,
  MTP_EVENT_UNREPORTED_STATUS         = 0x400Eu,
  MTP_EVENT_OBJECT_PROP_CHANGED       = 0xC801u,
  MTP_EVENT_OBJECT_PROP_DESC_CHANGED  = 0xC802u,
  MTP_EVENT_OBJECT_REFERENCES_CHANGED = 0xC803u,
} mtp_event_code_t;

// Datatypes
typedef enum {
  MTP_DATA_TYPE_UNDEFINED = 0x0000u,
  // scalars
  MTP_DATA_TYPE_INT8      = 0x0001u,
  MTP_DATA_TYPE_UINT8     = 0x0002u,
  MTP_DATA_TYPE_INT16     = 0x0003u,
  MTP_DATA_TYPE_UINT16    = 0x0004u,
  MTP_DATA_TYPE_INT32     = 0x0005u,
  MTP_DATA_TYPE_UINT32    = 0x0006u,
  MTP_DATA_TYPE_INT64     = 0x0007u,
  MTP_DATA_TYPE_UINT64    = 0x0008u,
  MTP_DATA_TYPE_INT128    = 0x0009u,
  MTP_DATA_TYPE_UINT128   = 0x000Au,
  // array
  MTP_DATA_TYPE_AINT8     = 0x4001u,
  MTP_DATA_TYPE_AUINT8    = 0x4002u,
  MTP_DATA_TYPE_AINT16    = 0x4003u,
  MTP_DATA_TYPE_AUINT16   = 0x4004u,
  MTP_DATA_TYPE_AINT32    = 0x4005u,
  MTP_DATA_TYPE_AUINT32   = 0x4006u,
  MTP_DATA_TYPE_AINT64    = 0x4007u,
  MTP_DATA_TYPE_AUINT64   = 0x4008u,
  MTP_DATA_TYPE_AINT128   = 0x4009u,
  MTP_DATA_TYPE_AUINT128  = 0x400Au,
  MTP_DATA_TYPE_STR       = 0xFFFFu,
} mtp_data_type_t;

// Get/Set
typedef enum {
  MTP_MODE_GET     = 0x00u,
  MTP_MODE_GET_SET = 0x01u,
} mtp_mode_get_set_t;

typedef enum {
  MTP_STORAGE_TYPE_UNDEFINED     = 0x0000u,
  MTP_STORAGE_TYPE_FIXED_ROM     = 0x0001u,
  MTP_STORAGE_TYPE_REMOVABLE_ROM = 0x0002u,
  MTP_STORAGE_TYPE_FIXED_RAM     = 0x0003u,
  MTP_STORAGE_TYPE_REMOVABLE_RAM = 0x0004u,
} mtp_storage_type_t;

typedef enum {
  MTP_FILESYSTEM_TYPE_UNDEFINED            = 0x0000u,
  MTP_FILESYSTEM_TYPE_GENERIC_FLAT         = 0x0001u,
  MTP_FILESYSTEM_TYPE_GENERIC_HIERARCHICAL = 0x0002u,
  MTP_FILESYSTEM_TYPE_DCF                  = 0x0003u,
} mtp_filesystem_type_t;

typedef enum {
  MTP_ACCESS_CAPABILITY_READ_WRITE                        = 0x0000u,
  MTP_ACCESS_CAPABILITY_READ_ONLY_WITHOUT_OBJECT_DELETION = 0x0001u,
  MTP_ACCESS_CAPABILITY_READ_ONLY_WITH_OBJECT_DELETION    = 0x0002u,
} mtp_access_capability_t;

typedef enum {
  MTP_PROTECTION_STATUS_NO_PROTECTION  = 0x0000u,
  MTP_PROTECTION_STATUS_READ_ONLY      = 0x0001u,
  MTP_PROTECTION_STATUS_READ_ONLY_DATA = 0x8002u,
  MTP_PROTECTION_NON_TRANSFERABLE_DATA = 0x8003u,
} mtp_protection_status_t;

typedef enum {
  MTP_ASSOCIATION_UNDEFINED            = 0x0000u,
  MTP_ASSOCIATION_GENERIC_FOLDER       = 0x0001u,
  MTP_ASSOCIATION_ALBUM                = 0x0002u,
  MTP_ASSOCIATION_TIME_SEQUENCE        = 0x0003u,
  MTP_ASSOCIATION_HORIZONTAL_PANORAMIC = 0x0004u,
  MTP_ASSOCIATION_VERTICAL_PANORAMIC   = 0x0005u,
  MTP_ASSOCIATION_2D_PANORAMIC         = 0x0006u,
  MTP_ASSOCIATION_ANCILLARY_DATA       = 0x0007u,
} mtp_association_t;

//--------------------------------------------------------------------+
// Data structures
//--------------------------------------------------------------------+
typedef struct TU_ATTR_PACKED {
  uint32_t len;
  uint16_t type;
  uint16_t code;
  uint32_t transaction_id;
} mtp_container_header_t;
TU_VERIFY_STATIC(sizeof(mtp_container_header_t) == 12, "size is not correct");

typedef struct TU_ATTR_PACKED {
  mtp_container_header_t header;
  uint32_t params[5];
} mtp_container_command_t;
TU_VERIFY_STATIC(sizeof(mtp_container_command_t) == 32, "size is not correct");

// PTP/MTP Generic container
typedef struct TU_ATTR_PACKED {
  mtp_container_header_t header;
  uint8_t payload[(CFG_TUD_MTP_EP_BUFSIZE - sizeof(mtp_container_header_t))];
} mtp_generic_container_t;

typedef struct {
  mtp_container_header_t* header;
  union {
    uint8_t*  payload;
    uint16_t* payload16;
    uint32_t* payload32;
  };
  uint32_t payload_bytes; // available bytes for read/write
} mtp_container_info_t;

typedef struct TU_ATTR_PACKED {
  uint16_t code;
  uint32_t session_id;
  uint32_t transaction_id;
  uint32_t params[3];
} mtp_event_t;
TU_VERIFY_STATIC(sizeof(mtp_event_t) == 22, "size is not correct");

#define mtp_string_t(_nchars) \
  struct TU_ATTR_PACKED { \
    uint8_t count; /* in characters including null */ \
    uint16_t utf16[_nchars]; \
  }

#define mtp_array_t(_type, _count) \
   struct TU_ATTR_PACKED { \
     uint32_t count; \
     _type arr[_count];\
   }

#define mtp_aint8_t(_count)  mtp_array_t(int8_t, _count)
#define mtp_auint16_t(_count) mtp_array_t(uint16_t, _count)
#define mtp_auint32_t(_count) mtp_array_t(uint32_t, _count)
#define mtp_auint64_t(_count) mtp_array_t(uint64_t, _count)

#define MTP_STORAGE_INFO_STRUCT(_storage_desc_chars, _volume_id_chars) \
  struct TU_ATTR_PACKED { \
    uint16_t storage_type; \
    uint16_t filesystem_type; \
    uint16_t access_capability; \
    uint64_t max_capacity_in_bytes; \
    uint64_t free_space_in_bytes; \
    uint32_t free_space_in_objects; \
    mtp_string_t(_storage_desc_chars) storage_description; \
    mtp_string_t(_volume_id_chars) volume_identifier; \
  }

// Object Info Dataset without dynamic string: filename, date_created, date_modified, keywords
typedef struct TU_ATTR_PACKED {
  uint32_t storage_id;
  uint16_t object_format;
  uint16_t protection_status;
  uint32_t object_compressed_size;
  uint16_t thumb_format;
  uint32_t thumb_compressed_size;
  uint32_t thumb_pix_width;
  uint32_t thumb_pix_height;
  uint32_t image_pix_width;
  uint32_t image_pix_height;
  uint32_t image_bit_depth;
  uint32_t parent_object; // 0: root
  uint16_t association_type;
  uint32_t association_desc;
  uint32_t sequence_number;
  // mtp_string_t() filename
  // mtp_string_t() date_created
  // mtp_string_t() date_modified
  // mtp_string_t() keywords
} mtp_object_info_header_t;

// Device property desc up to get/set
typedef struct TU_ATTR_PACKED {
  uint16_t device_property_code;
  uint16_t datatype;
  uint8_t  get_set;
} mtp_device_prop_desc_header_t;

// The following fields will be dynamically added to the struct at runtime:
// - wstring factory_def_value;
// - wstring current_value_len;
// - uint8_t form_flag;

// no form
#define MTP_DEVICE_PROPERTIES_STRUCT(_type) \
   struct TU_ATTR_PACKED { \
     uint16_t device_property_code; \
     uint16_t datatype; \
     uint8_t get_set; \
     _type factory_default; \
     _type current_value; \
     uint8_t form_flag; /* 0: none, 1: range, 2: enum */ \
   };

typedef struct TU_ATTR_PACKED {
  uint16_t code;
  uint32_t transaction_id;
} mtp_request_reset_cancel_data_t;
TU_VERIFY_STATIC(sizeof(mtp_request_reset_cancel_data_t) == 6, "size is not correct");

//--------------------------------------------------------------------+
// Container helper function
// return number of bytes added
//--------------------------------------------------------------------+

// return payload buffer for next write
TU_ATTR_ALWAYS_INLINE static inline uint8_t* mtp_container_payload_ptr(mtp_container_info_t* p_container) {
  // only 1st packet include header
  uint32_t pos = p_container->header->len - sizeof(mtp_container_header_t);
  while (pos > CFG_TUD_MTP_EP_BUFSIZE) {
    pos -= CFG_TUD_MTP_EP_BUFSIZE;
  }
  return p_container->payload + pos;
}

// only add_raw does partial copy
TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_raw(mtp_container_info_t* p_container, const void* data, uint32_t len) {
  uint8_t* buf = mtp_container_payload_ptr(p_container);
  const uint32_t added_len = tu_min32(len, CFG_TUD_MTP_EP_BUFSIZE - p_container->header->len);
  if (added_len > 0) {
    memcpy(buf, data, added_len);
  }
  p_container->header->len += len; // always increase len, even partial copy
  return added_len;
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_array(mtp_container_info_t* p_container, uint8_t scalar_size, uint32_t count, const void* data) {
  const uint32_t added_len = 4 + count * scalar_size;
  TU_ASSERT(p_container->header->len + added_len < CFG_TUD_MTP_EP_BUFSIZE, 0);
  uint8_t* buf = p_container->payload + p_container->header->len - sizeof(mtp_container_header_t);

  tu_unaligned_write32(buf, count);
  p_container->header->len += 4;
  buf += 4;

  memcpy(buf, data, count * scalar_size);
  p_container->header->len += count * scalar_size;

  return added_len;
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_string(mtp_container_info_t* p_container, uint16_t* utf16) {
  uint32_t count = 0;
  while (utf16[count] != 0u) {
    count++;
  }
  // MTP strings store length in a single uint8_t, including trailing null.
  TU_ASSERT(count < UINT8_MAX, 0);
  count++;

  uint8_t* buf = p_container->payload + p_container->header->len - sizeof(mtp_container_header_t);

  if (count == 1) {
    // empty string (size only): single zero byte
    TU_ASSERT(p_container->header->len + 1 < CFG_TUD_MTP_EP_BUFSIZE, 0);
    *buf = 0;
    p_container->header->len++;
    return 1u;
  }

  const uint32_t added_len = 1u + count * 2u;
  TU_ASSERT(p_container->header->len + added_len < CFG_TUD_MTP_EP_BUFSIZE, 0);

  *buf++ = (uint8_t) count;
  p_container->header->len++;

  memcpy(buf, utf16, 2u * count);
  p_container->header->len += 2u * count;

  return added_len;
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_cstring(mtp_container_info_t* p_container, const char* str) {
  const size_t cstr_len = strlen(str);
  // MTP strings store length in a single uint8_t, including trailing null.
  TU_ASSERT(cstr_len < UINT8_MAX, 0);

  const uint32_t count = (uint32_t) cstr_len + 1u; // include null
  uint8_t* buf = p_container->payload + p_container->header->len - sizeof(mtp_container_header_t);

  if (count == 1u) {
    // empty string (size only): single zero byte
    TU_ASSERT(p_container->header->len + 1 < CFG_TUD_MTP_EP_BUFSIZE, 0);
    *buf = 0;
    p_container->header->len++;
    return 1u;
  }

  const uint32_t added_len = 1u + 2u * count;
  TU_ASSERT(p_container->header->len + added_len < CFG_TUD_MTP_EP_BUFSIZE, 0);

  *buf++ = (uint8_t) count;
  p_container->header->len++;

  for (uint32_t i = 0; i < count; i++) {
    *buf++ = (uint8_t) str[i];
    *buf++ = 0;
  }
  p_container->header->len += 2u * count;

  return added_len;
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_uint8(mtp_container_info_t* p_container, uint8_t data) {
  return mtp_container_add_raw(p_container, &data, 1);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_uint16(mtp_container_info_t* p_container, uint16_t data) {
  return mtp_container_add_raw(p_container, &data, 2);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_uint32(mtp_container_info_t* p_container, uint32_t data) {
  return mtp_container_add_raw(p_container, &data, 4);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_uint64(mtp_container_info_t* p_container, uint64_t data) {
  return mtp_container_add_raw(p_container, &data, 8);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_uint128(mtp_container_info_t* p_container, const void* data) {
  return mtp_container_add_raw(p_container, data, 16);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_auint8(mtp_container_info_t* p_container, uint32_t count, const uint8_t* data) {
  return mtp_container_add_array(p_container, sizeof(uint8_t), count, data);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_auint16(mtp_container_info_t* p_container, uint32_t count, const uint16_t* data) {
  return mtp_container_add_array(p_container, sizeof(uint16_t), count, data);
}

TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_add_auint32(mtp_container_info_t* p_container, uint32_t count, const uint32_t* data) {
  return mtp_container_add_array(p_container, sizeof(uint32_t), count, data);
}

//--------------------------------------------------------------------+
//
//--------------------------------------------------------------------+
TU_ATTR_ALWAYS_INLINE static inline uint32_t mtp_container_get_string(uint8_t* buf, uint16_t utf16[]) {
  size_t nchars = *buf++;
  memcpy(utf16, buf, 2u * nchars);
  return 1u + 2u * nchars;
}

#ifdef __cplusplus
 }
#endif

#endif
#endif