Difference between revisions of "SceUsbstorVStorDriver"

From Vita Development Wiki
Jump to navigation Jump to search
 
(One intermediate revision by one other user not shown)
Line 37: Line 37:
 
|-
 
|-
 
| 1.69 || 0x3F02417C
 
| 1.69 || 0x3F02417C
 +
|-
 +
| 3.60 || not present
 
|}
 
|}
  
 
This is a guessed name.
 
This is a guessed name.
  
This name shows up in the USB descriptor.
+
These name and version show up in the USB descriptor.
  
<source lang="c">int sceUsbstorVStorSetDeviceInfoForDriver(const char *name);</source>
+
<source lang="c">int sceUsbstorVStorSetDeviceInfoForDriver(const char* name, const char* version_string);</source>
  
 
=== sceUsbstorVStorSetImgFilePathForDriver ===
 
=== sceUsbstorVStorSetImgFilePathForDriver ===
Line 51: Line 53:
 
|-
 
|-
 
| 1.69 || 0x78B42CC8
 
| 1.69 || 0x78B42CC8
 +
|-
 +
| 3.60 || not present
 
|}
 
|}
  
Line 65: Line 69:
 
|-
 
|-
 
| 1.69 || 0x31F7BBAD
 
| 1.69 || 0x31F7BBAD
 +
|-
 +
| 3.60 || not present
 
|}
 
|}
  
Line 79: Line 85:
 
|-
 
|-
 
| 1.69 || 0x99C2BC8A
 
| 1.69 || 0x99C2BC8A
 +
|-
 +
| 3.60 || not present
 
|}
 
|}
  
Line 92: Line 100:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.69 || 0x3F02417C
+
| 1.69-3.60 || 0x3F02417C
 
|}
 
|}
  
Line 104: Line 112:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.69 || 0x8C9F93AB
+
| 1.69-3.60 || 0x8C9F93AB
 
|}
 
|}
  
Line 116: Line 124:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.69 || 0xB606F1AF
+
| 1.69-3.60 || 0xB606F1AF
 
|}
 
|}
  
Line 128: Line 136:
 
! Version !! NID
 
! Version !! NID
 
|-
 
|-
| 1.69 || 0x0FD67059
+
| 1.69-3.60 || 0x0FD67059
 
|}
 
|}
  
Line 136: Line 144:
  
 
== Sample Usage ==
 
== Sample Usage ==
 +
 +
This code is made for FWs 0.990-1.69 as it used the SceUsbstorVStorForDriver library which was removed in some recent FWs.
  
 
<source lang="c">
 
<source lang="c">
 
int start_usb_storage(void) {
 
int start_usb_storage(void) {
     int ret = SceMtpIfForDriver_0xFDF8C3C0_stop(1); // stop MTP driver (it calls SceUsbMtpForDriver_08CD359F)
+
     int ret = SceMtpIfForDriver_0xFDF8C3C0(1); // stop MTP driver (it calls sceUsbMtpStopForDriver)
 
     printf("Stop: 0x%08X\n", ret);
 
     printf("Stop: 0x%08X\n", ret);
     ret = SceUsbstorVStorForDriver_0x3F02417C_set_name("\"PS Vita\" MC", "1.00");
+
     ret = sceUsbstorVStorSetDeviceInfoForDriver("\"PS Vita\" MC", "1.00");
 
     printf("SetName: 0x%08X\n", ret);
 
     printf("SetName: 0x%08X\n", ret);
     ret = SceUsbstorVStorForDriver_0x78B42CC8_set_path("ux0:/umass/fat.img");
+
     ret = sceUsbstorVStorSetImgFilePathForDriver("ux0:/umass/fat.img");
 
     printf("SetPath: 0x%08X\n", ret);
 
     printf("SetPath: 0x%08X\n", ret);
     ret = SceUsbstorVStorForDriver_0x31F7BBAD_activate(0);
+
     ret = SceUsbstorVStorStartForDriver(USBSTOR_DEVICE_TYPE_DIRECT_ACCESS_BLOCK_DEVICE);
 
     printf("Activate: 0x%08X\n", ret);
 
     printf("Activate: 0x%08X\n", ret);
 
     return 0;
 
     return 0;
Line 151: Line 161:
  
 
int start_usb_storage_unchecked(void) {
 
int start_usb_storage_unchecked(void) {
     int ret = SceMtpIfForDriver_0xFDF8C3C0_stop(1); // stop MTP driver
+
     int ret = SceMtpIfForDriver_0xFDF8C3C0(1); // stop MTP driver
 
     printf("Stop: 0x%08X\n", ret);
 
     printf("Stop: 0x%08X\n", ret);
     ret = SceUsbstorVStorForDriver_0x3F02417C_set_name("\"PS Vita\" MC", "1.00");
+
     ret = sceUsbstorVStorSetDeviceInfoForDriver("\"PS Vita\" MC", "1.00");
 
     printf("SetName: 0x%08X\n", ret);
 
     printf("SetName: 0x%08X\n", ret);
     ret = SceUsbstorVStorForDriver_0x78B42CC8_set_path("ux0:/any/path/here.img");
+
     ret = sceUsbstorVStorSetImgFilePathForDriver("ux0:/any/path/here.img");
 
     printf("SetPath: 0x%08X\n", ret);
 
     printf("SetPath: 0x%08X\n", ret);
     // activate without tests
+
     // Activate without test
 
     //*(int*)0x013F9054 = 0; // set 1 for RO access
 
     //*(int*)0x013F9054 = 0; // set 1 for RO access
     ret = SceUdcdForDriver_0x9FD733EA_start("USBDeviceControllerDriver", 0, 0);
+
     ret = sceUdcdStartForDriver("USBDeviceControllerDriver", 0, 0);
 
     printf("StartUSB: 0x%08X\n", ret);
 
     printf("StartUSB: 0x%08X\n", ret);
     ret = SceUdcdForDriver_0x9FD733EA_start("USBStor_Driver", 0, 0);
+
     ret = sceUdcdStartForDriver("USBStor_Driver", 0, 0);
 
     printf("StartStor: 0x%08X\n", ret);
 
     printf("StartStor: 0x%08X\n", ret);
     ret = SceUdcdForDriver_0x4FDEA423_activate(1491);
+
     ret = sceUdcdActivateForDriver(1491);
 
     printf("Activate: 0x%08X\n", ret);
 
     printf("Activate: 0x%08X\n", ret);
 
     return 0;
 
     return 0;
Line 169: Line 179:
  
 
int stop_usb_storage(void) {
 
int stop_usb_storage(void) {
     int ret = SceUsbstorVStorForDriver_0x99C2BC8A_stop(1); // stop storage driver
+
     int ret = sceUsbstorVStorStopForDriver(1); // stop storage driver
 
     printf("Stop: 0x%08X\n", ret);
 
     printf("Stop: 0x%08X\n", ret);
 
     return ret;
 
     return ret;
Line 175: Line 185:
 
</source>
 
</source>
  
 
+
[[Category:ARM]]
 +
[[Category:Kernel]]
 
[[Category:Modules]]
 
[[Category:Modules]]
[[Category:Kernel]]
+
[[Category:Library]]

Latest revision as of 21:39, 1 May 2023

Module

Version World Privilege
1.69-3.60 Non-secure Kernel

Libraries

Known NIDs

Version Name World Visibility NID
1.69 SceUsbstorVStorForDriver Non-secure Kernel 0xFD5BA349
3.60 SceUsbstorVStorForDriver Non-secure Kernel not present
1.69-3.60 SceUsbstorVStor Non-secure User 0x17F294B9

Types

#define USBSTOR_DEVICE_TYPE_DIRECT_ACCESS_BLOCK_DEVICE 0 // used for sceUsbstorVStorStart

SceUsbstorVStorForDriver

sceUsbstorVStorSetDeviceInfoForDriver

Version NID
1.69 0x3F02417C
3.60 not present

This is a guessed name.

These name and version show up in the USB descriptor.

int sceUsbstorVStorSetDeviceInfoForDriver(const char* name, const char* version_string);

sceUsbstorVStorSetImgFilePathForDriver

Version NID
1.69 0x78B42CC8
3.60 not present

This is a guessed name.

Sets the filesystem image to use as USB storage. This is limited to the CMA installer ISO and a FAT image at ux0:/umass/fat.img. Other paths will return error.

int sceUsbstorVStorSetImgFilePathForDriver(const char *path);

sceUsbstorVStorStartForDriver

Version NID
1.69 0x31F7BBAD
3.60 not present

This is a guessed name.

The user is responsible for making sure that no other UDC driver is active. This activates UDC as a "PS Vita" Type A device.

int sceUsbstorVStorStartForDriver(int unk);

sceUsbstorVStorStopForDriver

Version NID
1.69 0x99C2BC8A
3.60 not present

This is a guessed name.

int sceUsbstorVStorStopForDriver(int unk);

SceUsbstorVStor

sceUsbstorVStorSetDeviceInfo

Version NID
1.69-3.60 0x3F02417C

This is a guessed name.

User wrapper for #sceUsbstorVStorSetDeviceInfoForDriver. Must have correct permissions to call.

sceUsbstorVStorSetImgFilePath

Version NID
1.69-3.60 0x8C9F93AB

This is a guessed name.

User wrapper for #sceUsbstorVStorSetImgFilePathForDriver. Must have correct permissions to call.

sceUsbstorVStorStart

Version NID
1.69-3.60 0xB606F1AF

This is a guessed name.

User wrapper for #sceUsbstorVStorStartForDriver. Must have correct permissions to call.

sceUsbstorVStorStop

Version NID
1.69-3.60 0x0FD67059

This is a guessed name.

User wrapper for #sceUsbstorVStorStopForDriver. Must have correct permissions to call.

Sample Usage

This code is made for FWs 0.990-1.69 as it used the SceUsbstorVStorForDriver library which was removed in some recent FWs.

int start_usb_storage(void) {
    int ret = SceMtpIfForDriver_0xFDF8C3C0(1); // stop MTP driver (it calls sceUsbMtpStopForDriver)
    printf("Stop: 0x%08X\n", ret);
    ret = sceUsbstorVStorSetDeviceInfoForDriver("\"PS Vita\" MC", "1.00");
    printf("SetName: 0x%08X\n", ret);
    ret = sceUsbstorVStorSetImgFilePathForDriver("ux0:/umass/fat.img");
    printf("SetPath: 0x%08X\n", ret);
    ret = SceUsbstorVStorStartForDriver(USBSTOR_DEVICE_TYPE_DIRECT_ACCESS_BLOCK_DEVICE);
    printf("Activate: 0x%08X\n", ret);
    return 0;
}

int start_usb_storage_unchecked(void) {
    int ret = SceMtpIfForDriver_0xFDF8C3C0(1); // stop MTP driver
    printf("Stop: 0x%08X\n", ret);
    ret = sceUsbstorVStorSetDeviceInfoForDriver("\"PS Vita\" MC", "1.00");
    printf("SetName: 0x%08X\n", ret);
    ret = sceUsbstorVStorSetImgFilePathForDriver("ux0:/any/path/here.img");
    printf("SetPath: 0x%08X\n", ret);
    // Activate without test
    //*(int*)0x013F9054 = 0; // set 1 for RO access
    ret = sceUdcdStartForDriver("USBDeviceControllerDriver", 0, 0);
    printf("StartUSB: 0x%08X\n", ret);
    ret = sceUdcdStartForDriver("USBStor_Driver", 0, 0);
    printf("StartStor: 0x%08X\n", ret);
    ret = sceUdcdActivateForDriver(1491);
    printf("Activate: 0x%08X\n", ret);
    return 0;
}

int stop_usb_storage(void) {
    int ret = sceUsbstorVStorStopForDriver(1); // stop storage driver
    printf("Stop: 0x%08X\n", ret);
    return ret;
}