SceUsbstorVStorDriver: Difference between revisions

From Vita Development Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Library ==
== Module ==


=== Known NIDs ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version !! Name !! World !! Privilege !! NID
! Version !! World !! Privilege
|-
|-
| 1.69 || SceUsbstorVStorDriver || Non-secure || Kernel || 0xC2C77BE3
| 1.69-3.60 || Non-secure || Kernel
|}
|}


== Modules ==
== Libraries ==


=== Known NIDs ===
=== Known NIDs ===
Line 19: Line 18:
| 1.69 || [[SceUsbstorVStorDriver#SceUsbstorVStorForDriver|SceUsbstorVStorForDriver]] || Non-secure || Kernel || 0xFD5BA349
| 1.69 || [[SceUsbstorVStorDriver#SceUsbstorVStorForDriver|SceUsbstorVStorForDriver]] || Non-secure || Kernel || 0xFD5BA349
|-
|-
| 1.69 || [[SceUsbstorVStorDriver#SceUsbstorVStor|SceUsbstorVStor]] || Non-secure || User || 0x17F294B9
| 3.60 || [[SceUsbstorVStorDriver#SceUsbstorVStorForDriver|SceUsbstorVStorForDriver]] || Non-secure || Kernel || not present
|-
| 1.69-3.60 || [[SceUsbstorVStorDriver#SceUsbstorVStor|SceUsbstorVStor]] || Non-secure || User || 0x17F294B9
|}
|}
== Types ==
<source lang="C">
#define USBSTOR_DEVICE_TYPE_DIRECT_ACCESS_BLOCK_DEVICE 0 // used for sceUsbstorVStorStart
</source>


== SceUsbstorVStorForDriver ==
== SceUsbstorVStorForDriver ==


=== Set Device Name ===
=== sceUsbstorVStorSetDeviceInfoForDriver ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69 || 0x3F02417C
| 0x3F02417C
|-
| 3.60 || not present
|}
|}
This name shows up in the USB descriptor.


<source lang="c">int SceUsbstorVStorForDriver_0x3F02417C_set_name(const char *name);</source>
This is a guessed name.
 
These name and version show up in the USB descriptor.
 
<source lang="c">int sceUsbstorVStorSetDeviceInfoForDriver(const char* name, const char* version_string);</source>


=== Set Image Path ===
=== sceUsbstorVStorSetImgFilePathForDriver ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69 || 0x78B42CC8
| 0x78B42CC8
|-
| 3.60 || not present
|}
|}
The filesystem image to use as USB storage. This is limited to the CMA installer ISO and a FAT image at <code>ux0:/umass/fat.img</code>. Other paths will return error.


<source lang="c">int SceUsbstorVStorForDriver_0x78B42CC8_set_path(const char *path);</source>
This is a guessed name.


=== Activate USB storage device ===
Sets the filesystem image to use as USB storage. This is limited to the CMA installer ISO and a FAT image at <code>ux0:/umass/fat.img</code>. Other paths will return error.
 
<source lang="c">int sceUsbstorVStorSetImgFilePathForDriver(const char *path);</source>
 
=== sceUsbstorVStorStartForDriver ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
| 1.69 || 0x31F7BBAD
|-
|-
| 1.69
| 3.60 || not present
| 0x31F7BBAD
|}
|}
The user is responsible for making sure no other UDC driver is active. This activates UDC as a <code>"PS Vita" Type A</code> device.


<source lang="c">int SceUsbstorVStorForDriver_0x31F7BBAD_activate(int unk);</source>
This is a guessed name.
 
The user is responsible for making sure that no other UDC driver is active. This activates UDC as a <code>"PS Vita" Type A</code> device.
 
<source lang="c">int sceUsbstorVStorStartForDriver(int unk);</source>


=== Stop USB Storage ===
=== sceUsbstorVStorStopForDriver ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
| 1.69 || 0x99C2BC8A
|-
|-
| 1.69
| 3.60 || not present
| 0x99C2BC8A
|}
|}


<source lang="c">int SceUsbstorVStorForDriver_0x99C2BC8A_stop(int unk);</source>
This is a guessed name.
 
<source lang="c">int sceUsbstorVStorStopForDriver(int unk);</source>


== SceUsbstorVStor ==
== SceUsbstorVStor ==


=== Set Device Name ===
=== sceUsbstorVStorSetDeviceInfo ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69-3.60 || 0x3F02417C
| 0x3F02417C
|}
|}
User wrapper for <code>0x14455C20</code>. Must have correct permissions to call.


=== Set Image Path ===
This is a guessed name.
 
User wrapper for [[#sceUsbstorVStorSetDeviceInfoForDriver]]. Must have correct permissions to call.
 
=== sceUsbstorVStorSetImgFilePath ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69-3.60 || 0x8C9F93AB
| 0x8C9F93AB
|}
|}
User wrapper for <code>0x78B42CC8</code>. Must have correct permissions to call.


=== Activate USB storage device ===
This is a guessed name.
 
User wrapper for [[#sceUsbstorVStorSetImgFilePathForDriver]]. Must have correct permissions to call.
 
=== sceUsbstorVStorStart ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69-3.60 || 0xB606F1AF
| 0xB606F1AF
|}
|}
User wrapper for <code>0x31F7BBAD</code>. Must have correct permissions to call.


=== Stop USB Storage ===
This is a guessed name.
 
User wrapper for [[#sceUsbstorVStorStartForDriver]]. Must have correct permissions to call.
 
=== sceUsbstorVStorStop ===
{| class="wikitable"
{| class="wikitable"
|-
|-
! Version
! Version !! NID
! NID
|-
|-
| 1.69
| 1.69-3.60 || 0x0FD67059
| 0x0FD67059
|}
|}
User wrapper for <code>0x99C2BC8A</code>. Must have correct permissions to call.
 
This is a guessed name.
 
User wrapper for [[#sceUsbstorVStorStopForDriver]]. Must have correct permissions to call.


== 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(1); // stop MTP driver (it calls sceUsbMtpStopForDriver)
     int ret;
 
    ret = SceMtpIfForDriver_0xFDF8C3C0_stop(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:/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;
}
}


int start_usb_storage_unchecked(void)
int start_usb_storage_unchecked(void) {
{
     int ret = SceMtpIfForDriver_0xFDF8C3C0(1); // stop MTP driver
     int ret;
 
    ret = SceMtpIfForDriver_0xFDF8C3C0_stop(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 test
     // activate without tests
     //*(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;
}
}


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


[[Category:Libraries]]
[[Category:ARM]]
[[Category:Kernel]]
[[Category:Kernel]]
[[Category:Modules]]
[[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;
}