Capmtp services: Difference between revisions

(7 intermediate revisions by 2 users not shown)

Line 1:

This implements the MTP PTP ~~protocol~~[https://www.usb.org/document-library/media-transfer-protocol-v11-spec-and-mtp-v11-adopters-agreement].

This implements the MTP PTP [https://www.usb.org/document-library/media-transfer-protocol-v11-spec-and-mtp-v11-adopters-agreement protocol]. This was added with [[11.0.0]].

= capmtp =

Line 19:

! Cmd || Name || Notes

|-

| 0 || || Takes a u32 max folder count, a u32 max image count, a u32 max video count, a transfer memory handle + u32 size and a type-0x5 buffer translated "Other" string.

| 0 || || Takes a u32 max folder count, a u32 max image count, a u32 max video count, a transfer memory handle + u32 size and a type-0x5 buffer translated "Other" utf-16 string.

|-

| 1 || || No input or output.

| 1 || || No input or output. Unmaps transfer memory from Cmd0, stops "nn.capmtp.CapmtpCommandLoop".

|-

| 2 || || No input or output. Starts MTP command handler "nn.capmtp.CapmtpCommandLoop".

| 2 || || No input or output. Starts MTP command handler thread "nn.capmtp.CapmtpCommandLoop".

|-

| 3 || || No input or output. Stops "nn.capmtp.CapmtpCommandLoop".

Line 29:

| 4 || || No input. Returns true if "nn.capmtp.CapmtpCommandLoop" is running.

|-

| 5 || || No input. Returns readable event handle.

| 5 || || No input. Returns readable event handle. Signaled when the USB connection status changes.

|-

| 6 || || No input. Returns a ~~boolean~~.

| 6 || || No input. Returns true if a USB connection is established.

|-

| 7 || || No input. Returns readable event handle.

| 7 || || No input. Returns readable event handle. Signaled when an error occurred during album scan.

|-

| 8 || || No input or output.

| 8 || || No input or output. Returns the album scan Result.

|-

|}

== Notes ==

Only ~~operation calls~~ 0x1001-0x100A are available.

Only PTP operations 0x1001-0x100A are available.

* OpenSession/CloseSession only allow a maximum of 1 session to be opened.

* DeviceInfo: Serial Number is set to the output from [[Settings_services#GetSerialNumber|GetSerialNumber]]. Device Version is set to the [[System_Version_Title|SystemVersion]] DisplayVersion.

While this has access to [[Filesystem_services#fsp-srv|fsp-srv]] it remains unused.

@@ Line 1: / Line 1: @@
-This implements the MTP PTP protocol[https://www.usb.org/document-library/media-transfer-protocol-v11-spec-and-mtp-v11-adopters-agreement].
+This implements the MTP PTP [https://www.usb.org/document-library/media-transfer-protocol-v11-spec-and-mtp-v11-adopters-agreement protocol]. This was added with [[11.0.0]].
 = capmtp =
@@ Line 19: / Line 19: @@
 ! Cmd || Name || Notes
 |-
-| 0 || || Takes a u32 max folder count, a u32 max image count, a u32 max video count, a transfer memory handle + u32 size and a type-0x5 buffer translated "Other" string.
+| 0 || || Takes a u32 max folder count, a u32 max image count, a u32 max video count, a transfer memory handle + u32 size and a type-0x5 buffer translated "Other" utf-16 string.
 |-
-| 1 || || No input or output.
+| 1 || || No input or output. Unmaps transfer memory from Cmd0, stops "nn.capmtp.CapmtpCommandLoop".
 |-
-| 2 || || No input or output. Starts MTP command handler "nn.capmtp.CapmtpCommandLoop".
+| 2 || || No input or output. Starts MTP command handler thread "nn.capmtp.CapmtpCommandLoop".
 |-
 | 3 || || No input or output. Stops "nn.capmtp.CapmtpCommandLoop".
@@ Line 29: / Line 29: @@
 | 4 || || No input. Returns true if "nn.capmtp.CapmtpCommandLoop" is running.
 |-
-| 5 || || No input. Returns readable event handle.
+| 5 || || No input. Returns readable event handle. Signaled when the USB connection status changes.
 |-
-| 6 || || No input. Returns a boolean.
+| 6 || || No input. Returns true if a USB connection is established.
 |-
-| 7 || || No input. Returns readable event handle.
+| 7 || || No input. Returns readable event handle. Signaled when an error occurred during album scan.
 |-
-| 8 || || No input or output.
+| 8 || || No input or output. Returns the album scan Result.
 |-
 |}
 == Notes ==
-Only operation calls 0x1001-0x100A are available.
+Only PTP operations 0x1001-0x100A are available.
+* OpenSession/CloseSession only allow a maximum of 1 session to be opened.
+* DeviceInfo: Serial Number is set to the output from [[Settings_services#GetSerialNumber|GetSerialNumber]]. Device Version is set to the [[System_Version_Title|SystemVersion]] DisplayVersion.
 While this has access to [[Filesystem_services#fsp-srv|fsp-srv]] it remains unused.