SceSdstor
Jump to navigation
Jump to search
Module
This module is responsible for initializing all storage devices. This includes:
- eMMC
- Game gard
- Memory card
- USB Mass Storage
- Micro SD card / SD card
| Version | World | Privilege |
|---|---|---|
| 1.69-3.740.011 | Non-secure | Kernel |
Libraries
SceSdstor module does not export any function exсept module_start.
Interrupt Table
| Index | Code | Name |
|---|---|---|
| 0 | 0xDC | SceSdif0 |
| 1 | 0xDD | SceSdif1 |
| 2 | 0x3C | SceMsifIns |
| 3 | 0xF | SceUsbMass |
| 4 | 0xDF | SceSdif3 |
Block Device Naming Rules
First level prefix: port.
| Name | Index | Long name | Description |
|---|---|---|---|
| int | 0 | internal | eMMC |
| ext | 1 | external | SD card |
| gcd | 1 | game card | Game Card |
| mcd | 2 | memory card | Memory Card |
| uma | 3 | usb mass | USB mass storage device |
| usd | 4 | micro sd | Micro SD card |
| xmc | 0xFF | external memory card | Actual Memory Card when internal eMMC is mounted as Memory Card |
Second level prefix: kind
- lp - general.
- pp - no part.
Third level prefix: stat
- ina: inactive
- act: active
- ign: ignore (same behaviour as inactive)
Fourth level prefix: id
- unused
- idstor
- sloader
- os
- vsh
- vshdata
- vtrm
- user
- userext
- gamero
- gamerw
- updater
- sysdata
- mediaid
- pidata
- entire
Partition Block Devices
Each partition has a numeric alias (string) that seems to be used to reference the partition.
Numeric names most likely follow order of partitions in MBR.
To access device node use /dev prefix (like /dev/gcd-lp-ign-gamero).
There can be up to 16 aliases from 0 to 15 per physical device (eMMC, Game Card, Memory Card) and alias 16 is hardcoded and called entire.
Not all numeric names are fixed but entire numeric names are hardcoded.
| Block device | Numeric name | Hardcoded |
|---|---|---|
| int-lp-ign-idstor | 000 | no |
| int-lp-act-sloader/int-lp-ina-sloader | 001 | no |
| int-lp-act-sloader/int-lp-ina-sloader | 002 | no |
| int-lp-act-os/int-lp-ina-os | 003 | no |
| int-lp-act-os/int-lp-ina-os | 004 | no |
| int-lp-ign-sysdata | 005 | no |
| int-lp-ign-vtrm | 006 | no |
| int-lp-ign-vsh | 007 | no |
| int-lp-ign-vshdata | 008 | no |
| int-lp-ign-updater | 009 | no |
| int-lp-ign-pidata | 010 | no |
| int-lp-ign-user | 011 | no |
| int-lp-ign-userext | 012 | no |
| int-lp-act-entire | 016 | yes |
| gcd-lp-ign-gamero, gcd-lp-act-mediaid (need to confirm) | 100 | no |
| gcd-lp-ign-gamerw (need to confirm) | 101 | no |
| ext-lp-act-entire | 116 | yes |
| mcd-lp-act-mediaid | 200 | no |
| mcd-lp-ign-userext | 201 | no |
| mcd-lp-act-entire | 216 | yes |
| uma-lp-act-entire | 316 | yes |
| usd-lp-act-entire | 416 | yes |
Types
It looks like SceSdstor driver uses its own device type.
| Device Type Index | Description |
|---|---|
| 0 | MMC card |
| 1 | SD card |
| 2 | Memory Card |
| 3 | USB Mass Storage |
Also see here (vita-headers)
typedef struct unknown_1C2C { // size is 0x1C
uint8_t data[0x1C];
} unknown_1C2C;
#define CARD_REMOVE_SDSTOR_REQUEST_EVENT_FLAG 0x01
#define IO_DEVCTL_SDSTOR_REQUEST_EVENT_FLAG 0x02
#define CARD_INSERT_SDSTOR_REQUEST_EVENT_FLAG 0x10
#define SUSPEND_SDSTOR_REQUEST_EVENT_FLAG 0x100
#define RESUME_SDSTOR_REQUEST_EVENT_FLAG 0x1000
typedef struct interrupt_argument { // size is 0x28
uint32_t unk_0;
SceUID SceSdstorRequest_evid; // event id
SceUID SceSdstorOpSync_evid; // event id
interrupt_info* intr_info; //
unknown_1C2C* unk_10;
// card swap protection
char cid_rnd[0x10]; // cid of the card / randomly generated non zero byte array / zero
uint8_t intr_table_index; // check interrupt table section (also sd_stor_device index)
uint8_t unk_25; // = 0
uint8_t unk_26; // = 0
uint8_t unk_27;
} interrupt_argument;
typedef int(insert_handler)(int unk, interrupt_argument* arg);
typedef int(remove_handler)(int unk, interrupt_argument* arg);
#define SDSTOR_SUBINTERRUPT_CODE_INSERT 0
#define SDSTOR_SUBINTERRUPT_CODE_REMOVE 1
typedef struct interrupt_info { // size is 0xC
insert_handler* SceSdstorCardInsert_handler;
remove_handler* SceSdstorCardRemove_handler;
uint8_t intr_table_index; // check interrupt table section
uint8_t SceSdstorCardInsert_subintr_code;
uint8_t SceSdstorCardRemove_subintr_code;
uint8_t unk_0xB;
} interrupt_info;Data segment layout
| Address | Size | Description |
|---|---|---|
| 0x0000 | 0x20 | unknown |
| 0x0020 | 0x14 | array of 5 integers (number created device handles?) (each corresponds to sd_stor_device) |
| 0x0034 | 0x4 | unknown |
| 0x0038 | 0x4 | SceSdStorDeviceHandle mempool SceUID of size 0x2000
|
| 0x003C | 0x4 | unknown |
| 0x0040 | 0x200 | MBR of eMMC |
| 0x0240 | 0x200 | MBR of Game card |
| 0x0440 | 0x200 | MBR of Memory card |
| 0x0640 | 0x200 | MBR of USB Mass Storage |
| 0x0840 | 0x200 | MBR of micro SD card (usd device) |
| 0x0A40 | 0x238 | sdstor_mbr_ctx element 0 |
| 0x0C78 | 0x238 | sdstor_mbr_ctx element 1 |
| 0x0EB0 | 0x238 | sdstor_mbr_ctx element 2 |
| 0x10E8 | 0x238 | sdstor_mbr_ctx element 3 |
| 0x1320 | 0x238 | sdstor_mbr_ctx element 4 |
| 0x1558 | 0x54 | sd_stor_device element 0 |
| 0x15AC | 0x54 | sd_stor_device element 1 |
| 0x1600 | 0x54 | sd_stor_device element 2 |
| 0x1654 | 0x54 | sd_stor_device element 3 |
| 0x16A8 | 0x54 | sd_stor_device element 4 |
| 0x16FC | 0x20 | vfs_add_data sdstor_dev_fs node
|
| 0x171C | 0x04 | SceSdStorVfs mempool SceUID of size 0x2000
|
| 0x1720 | 0x200 | first sector of external partition (0xD) (gcd-lp-act-mediaid) of game card (interrupt index 1) |
| 0x1920 | 0x200 | first sector of external partition (0xD) (mcd-lp-act-mediaid) of memory card (interrupt index 2) |
| 0x1B20 | 0xC8 | array of 5 interrupt_argument structures
|
| 0x1BE8 | 0x8 | suspend_register_callback opt |
| 0x1BF0 | 0x3C | array of 5 interrupt_info structures
|
| 0x1C2C | 0x8C | array of 5 unknown_1C2C structures
|
| 0x1CB8 | 0x8 | unknown |
| 0x1CC0 | 0x200 | MBR of Memory card (xmc device) |