System File Object (SFO) (PSF): Difference between revisions

From Vita Developer wiki
Jump to navigation Jump to search
Line 311: Line 311:
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}


Minimum [[Template:Firmware_revisions|Firmware]] needed to play this title.
Minimum [[Template:Firmware_revisions|Firmware]] for display needed to play this title.


====PSP2_SYSTEM_VER====
====PSP2_SYSTEM_VER====

Revision as of 09:08, 19 July 2015

These config strings are inside the Game Package (PKG).

See also PARAM.SFO on:

See also Discussion page

Internal Structure

The values contained in a System File Object can be simplyfied as inputs/outputs for/from the content: Boot modifyers (most of the int32 datas) that are sent to the content when is executed to activate specific features or settings (e.g. audio and video modes of a game). Information texts (most of the utf8 datas) about the content and its restrictions (e.g. title and version of a game).

Header SFO

This is the Header of a SFO/PSF file.

Offset Data Length Notes
0x00 00 50 53 46 0x04 " PSF" Magic
0x04 01 01 00 00 0x04 Version
0x08 xx xx 00 00 0x04 Key table start offset
0x0C xx xx 00 00 0x04 Data table start offset
0x10 xx 00 00 00 0x04 № of entries in index table (params/values) 
typedef struct{
    int magic; //PSF
    int version; //1.1
    int keyTableOffset;
    int dataTableOffset;
    int indexTableEntries;
} sfo_header_t;

Index table

Starting at offset 0x14, this structure (0x10) is repeated the number of times defined in the header ( № of parameters)

Offset Data Length Notes
0x14 00 00 0x02 Key table offset
0x16 04 0x 0x02 param_fmt (type of data)
0x18 xx xx 00 00 0x04 parameter length
0x1C xx xx 00 00 0x04 parameter max length
0x20 00 00 00 00 0x04 Data table offset 
typedef struct{
    u16 keyOffset; //offset of keytable + keyOffset
    u16 param_fmt; //enum (see below)
    u32 paramLen;
    u32 paramMaxLen;
    u32 dataOffset; //offset of datatable + dataOffset
} indexTableEntry_t;

Used on index table, there are 3 variables:

0x6+0x10*i
(i=0,1,2,3,4,5,...)

Param_fmt Arch Format Notes
04 00 Little Endian utf-8 Special Mode Used in contents generated by the system (e.g.: save data)
04 02 Little Endian utf-8 Character string, NULL finished (0x00)
04 04 Little Endian integer 32 bits unsigned

Key table

Ordered alphabetically, each name of parameters of this table is NULL terminated with 1 blank byte (0x00) to separate them.

The table has padding at the end to align their size to a multiply of 4 ( if matches with a multiply of 4 this padding doesn't exist)

Data table

  • UTF-8 entries never uses all the reserved bytes, needs 1 blank byte (0x00) after the last character.
  • Integer entries uses all the reserved bytes.

Algorithm

(i=0,1,2,3,4,5,...)

  • Get Position Value
    • [PSF offset] + [Value Start] + (0x14+(0x10*i))
  • Get Type
    • [PSF offset] + (0x16 * (0x10*i))
  • Get Lenght Param
    • [PSF offset] + (0x1C * (0x10*i))
  • Get Lenght Value
    • [PSF offset] + (0x24+0x10*i)-(0x14+0x10*i)
  • Get Position Param
    • [PSF offset] + [Param Start] + (0x20+(0x10*i))

for any problems, you can give a look into my sourcecode: sfo_stuff.c

Parameters Descriptions

APP_VER

Info
param_fmt: utf-8
param_max_len: 0x8 (8 bytes)
param_len: 0x6 (6 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

The format is XX.YY where "XX" and "YY" are numbers, and the point "." is included in the string, e.g: 01.00 for the first stable version released.

ATTRIBUTE

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Can contains 32 flags that can be turned on/off to activate/deactivate features allowed for the game/apps content.

FW min for FW column (SYSTEM_VER) seen.

Flag № column is for easy wikify/chat.

Hexadecimal Decimal Binary
(flags)		 Notes
(feature)		 FW Flag №
(flag required)
little endian big endian
???
01 00 00 00 00 00 00 01 1 00000000 00000000 00000000 00000001 - - 01
02 00 00 00 00 00 00 02 2 00000000 00000000 00000000 00000010 Use liblocation in order to get location - 02
04 00 00 00 00 00 00 04 4 00000000 00000000 00000000 00000100 - - 03
08 00 00 00 00 00 00 08 8 00000000 00000000 00000000 00001000 - - 04
10 00 00 00 00 00 00 10 16 00000000 00000000 00000000 00010000 - - 05
20 00 00 00 00 00 00 20 32 00000000 00000000 00000000 00100000 - - 06
40 00 00 00 00 00 00 40 64 00000000 00000000 00000000 01000000 - - 07
80 00 00 00 00 00 00 80 128 00000000 00000000 00000000 10000000 Information Bar is displayed on startup - 08
???
00 01 00 00 00 00 01 00 256 00000000 00000000 00000001 00000000 Information Bar color (white:ON, black:OFF) - 09
00 02 00 00 00 00 02 00 512 00000000 00000000 00000010 00000000 Use alpha blending to display Information Bar (option for Non-Game) - 10
00 04 00 00 00 00 04 00 1024 00000000 00000000 00000100 00000000 The Application is upgradable - 11
00 08 00 00 00 00 08 00 2048 00000000 00000000 00001000 00000000 - - 12
00 10 00 00 00 00 10 00 4096 00000000 00000000 00010000 00000000 - - 13
00 20 00 00 00 00 20 00 8192 00000000 00000000 00100000 00000000 - - 14
00 40 00 00 00 00 40 00 16384 00000000 00000000 01000000 00000000 - - 15
00 80 00 00 00 00 80 00 32768 00000000 00000000 10000000 00000000 Communication Zone is not displayed (option for Non-Game) - 16
???
00 00 01 00 00 01 00 00 65536 00000000 00000001 00000000 00000000 - - 17
00 00 02 00 00 02 00 00 131072 00000000 00000010 00000000 00000000 - - 18
00 00 04 00 00 04 00 00 262144 00000000 00000100 00000000 00000000 - - 19
00 00 08 00 00 08 00 00 524288 00000000 00001000 00000000 00000000 - - 20
00 00 10 00 00 10 00 00 1048576 00000000 00010000 00000000 00000000 - - 21
00 00 20 00 00 20 00 00 2097152 00000000 00100000 00000000 00000000 Add a health warning to the first page of the software manual - 22
00 00 40 00 00 40 00 00 4194304 00000000 01000000 00000000 00000000 - - 23
00 00 80 00 00 80 00 00 8388608 00000000 10000000 00000000 00000000 Content of Cache0 is cleared when application is killed (option for Non-Game) - 24
???
00 00 00 01 01 00 00 00 16777216 00000001 00000000 00000000 00000000 Use libNotification to post Notification Message (option for Non-Game) - 25
00 00 00 02 02 00 00 00 33554432 0000001 000000000 00000000 00000000 Use Twitter dialog - 26
00 00 00 04 04 00 00 00 262144 00000100 00000000 00000000 00000000 - - 27
00 00 00 08 08 00 00 00 134217728 00001000 00000000 00000000 00000000 - - 28
00 00 00 10 10 00 00 00 268435456 00010000 00000000 00000000 00000000 - - 29
00 00 00 20 20 00 00 00 536870912 00100000 00000000 00000000 00000000 - - 30
00 00 00 40 40 00 00 00 1073741824 01000000 00000000 00000000 00000000 - - 31
00 00 00 80 80 00 00 00 2147483648 10000000 00000000 00000000 00000000 - - 32

ATTRIBUTE2

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

This parameter can not exist on some PKG (used for special functions??)

ATTRIBUTE_MINOR

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital)

Can contains 32 flags that can be turned on/off to activate/deactivate features allowed for the game/apps content.

CATEGORY

Info
param_fmt: utf-8
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

See PS4 Category

Value standard name
ac PS Vita Additional Content
gd PS Vita Application (Game Digital)
gda PS Vita System Application
gdc PS Vita Non-Game Application
gdd PS Vita BG Application
gp PS Vita Application Patch
gpc PS Vita Non-Game Application Patch
gpd PS Vita BG Application patch
sd PS Vita Save Data

CONTENT_ID

Info
param_fmt: utf-8
param_max_len: 0x30 (48 bytes)
param_len: 0x25 (37 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

The format is: XXYYYY-NP_COMMUNICATION_ID-LICENSE_ID.

e.g.: JP0365-PCSG90004_00-SKP2TRIAL0000000

See Content ID

GC_RO_SIZE

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Seen: 0x1C0000 (1835008), 0x380000 (3670016)

GC_RW_SIZE

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

...

INSTALL_DIR_SAVEDATA

Info
param_fmt: utf-8
param_max_len: 0xc (12 bytes)
param_len: 0x9? (9 bytes)
Tip
Used by: PSVita Game (Digital)

Similar to TITLE_ID, identifier of the content, in the format WXYZ12345.

Used by demo trials/cross platforms titles?

NP_COMMUNICATION_ID

Info
param_fmt: utf8
param_max_len: 0x10 (16 bytes)
param_len: 0xD (13 bytes)
Tip
Used by: PSVita Game (Digital)

Network Platform Communication ID.

The format is 4 letters + 5 numbers with optionally a subid (usually 0) : NPWRyyyyy_zz (e.g. NPWR00001_00)

PARENTAL_LEVEL

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

This should be the same as in the PS3/PS4 (from 0 to 11)

It is a scale to rate the content for the different users based in parental control settings and international rating systems as: PEGI, ESRB, CERO, etc...

PSP2_DISP_VER

Info
param_fmt: utf-8
param_max_len: 0x8 (4 bytes)
param_len: 0x8? (8 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Minimum Firmware for display needed to play this title.

PSP2_SYSTEM_VER

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Minimum Firmware needed to play this title.

PUBTOOLINFO

Info
param_fmt: utf-8
param_max_len: 0x200 (512 bytes)
param_len:variable
Tip
Used by: PSVita Game (Digital), Non-Game Application

Contains infos (UTF-8), separated by a comma (0x2C):

  • c_date=yyyymmdd (creation date format?)
  • sdk_ver=xxxxxxxx (digits to indicate PSVita SDK version?) : seen: 01650000, 01800000, 02500000, 03000000

REGION_DENY

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Regions restrictions for the content.

See PS3 Region deny

SAVEDATA_MAX_SIZE

Info
param_fmt: uint32_t
param_max_len: 0x4 (4 bytes)
param_len: 0x4 (4 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Save Data Quota

e.g.: 0x00000400 ( = 1024) this game can use 1024 Bytes (1MB)

Seen: 0x400 (1024), 0x800 (2048), 0x1000 (4096), 0x2000 (8192), 0x2800 (10240), 0x5000 (20480), 0x20000 (131072), 0x100000 (1048576)

STITLE

Info
param_fmt: utf-8
param_max_len: 0x34 (52 bytes)
param_len: variable
Tip
Used by: PSVita Game (Digital), Non-Game Application

Short Title for default language.

STITLE_xx

Info
param_fmt: utf-8
param_max_len: 0x34 (52 bytes)
param_len: variable
Tip
Used by: PSVita Game (Digital)

Same than STITLE but for localized languages.

An .SFO can contain several STITLE_xx where xx is a number for a regional code.

The "default" TITLE is always present when other "localized" TITLE_xx are used.

SUPPORT_URI

Info
param_fmt: utf-8
param_max_len: 0x200 (512 bytes)
param_len: variable?
Tip
Used by: Non-Game Application

e.g.:sonyreader://

TITLE

Info
param_fmt: utf-8
param_max_len: 0x80 (128 bytes)
param_len: variable
Tip
Used by: PSVita Game (Digital), Non-Game Application

Default "title of the game" for all languages.

TITLE_xx

Info
param_fmt: utf-8
param_max_len: 0x80 (128 bytes)
param_len: variable
Tip
Used by: PSVita Game (Digital)

Same than STITLE.

TITLE_ID

Info
param_fmt: utf-8
param_max_len: 0x0C (12 bytes)
param_len: 0xA (10 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Identifier ( Productcode ) of the content, in the format WXYZ12345.

See also Title_ID

VERSION

Info
param_fmt: utf-8
param_max_len: 0x8 (8 bytes)
param_len: 0x6 (6 bytes)
Tip
Used by: PSVita Game (Digital), Non-Game Application

Version content of the game: Disc revision, or Package revision. The number increases when the content is re-released or re-packaged for whatever reason that doesn't affect the main executable (e.g. when a disc game reaches platinum sales, or "game of the year edition" including extra contents).

PSF Dump (From 0xBF0 to 0x11F0)

The length of this is 0x5D0 

 offset   00 01 02 03 04 05 06 07  08 09 0A 0B 0C 0D 0E 0F

00000bf0  00 50 53 46 01 01 00 00  24 01 00 00 dc 01 00 00  |.PSF....$.......|  -> Header
00000c00  11 00 00 00 00 00 04 02  06 00 00 00 08 00 00 00  |................|  -> Unknown
00000c10  00 00 00 00 08 00 04 04  04 00 00 00 04 00 00 00  |................|
00000c20  08 00 00 00 12 00 04 02  03 00 00 00 04 00 00 00  |................|  
00000c30  0c 00 00 00 1b 00 04 02  25 00 00 00 30 00 00 00  |........%...0...|
00000c40  10 00 00 00 26 00 04 04  04 00 00 00 04 00 00 00  |....&...........|
00000c50  40 00 00 00 31 00 04 04  04 00 00 00 04 00 00 00  |@...1...........|
00000c60  44 00 00 00 3c 00 04 04  04 00 00 00 04 00 00 00  |D...<...........|
00000c70  48 00 00 00 4b 00 04 02  07 00 00 00 08 00 00 00  |H...K...........|
00000c80  4c 00 00 00 59 00 04 04  04 00 00 00 04 00 00 00  |L...Y...........|
00000c90  54 00 00 00 69 00 04 02  10 00 00 00 00 02 00 00  |T...i...........|
00000ca0  58 00 00 00 75 00 04 04  04 00 00 00 04 00 00 00  |X...u...........|
00000cb0  58 02 00 00 87 00 04 02  20 00 00 00 34 00 00 00  |X....... ...4...|
00000cc0  5c 02 00 00 8e 00 04 02  20 00 00 00 34 00 00 00  |\....... ...4...|
00000cd0  90 02 00 00 98 00 04 02  35 00 00 00 80 00 00 00  |........5.......|
00000ce0  c4 02 00 00 9e 00 04 02  35 00 00 00 80 00 00 00  |........5.......|
00000cf0  44 03 00 00 a7 00 04 02  0a 00 00 00 0c 00 00 00  |D...............|
00000d00  c4 03 00 00 b0 00 04 02  06 00 00 00 08 00 00 00  |................|
00000d10  d0 03 00 00 41 50 50 5f  56 45 52 00 41 54 54 52  |....APP_VER.ATTR| -> Variables
00000d20  49 42 55 54 45 00 43 41  54 45 47 4f 52 59 00 43  |IBUTE.CATEGORY.C|
00000d30  4f 4e 54 45 4e 54 5f 49  44 00 47 43 5f 52 4f 5f  |ONTENT_ID.GC_RO_|
00000d40  53 49 5a 45 00 47 43 5f  52 57 5f 53 49 5a 45 00  |SIZE.GC_RW_SIZE.|
00000d50  50 41 52 45 4e 54 41 4c  5f 4c 45 56 45 4c 00 50  |PARENTAL_LEVEL.P|
00000d60  53 50 32 5f 44 49 53 50  5f 56 45 52 00 50 53 50  |SP2_DISP_VER.PSP|
00000d70  32 5f 53 59 53 54 45 4d  5f 56 45 52 00 50 55 42  |2_SYSTEM_VER.PUB|
00000d80  54 4f 4f 4c 49 4e 46 4f  00 53 41 56 45 44 41 54  |TOOLINFO.SAVEDAT|
00000d90  41 5f 4d 41 58 5f 53 49  5a 45 00 53 54 49 54 4c  |A_MAX_SIZE.STITL|
00000da0  45 00 53 54 49 54 4c 45  5f 30 30 00 54 49 54 4c  |E.STITLE_00.TITL|
00000db0  45 00 54 49 54 4c 45 5f  30 30 00 54 49 54 4c 45  |E.TITLE_00.TITLE|
00000dc0  5f 49 44 00 56 45 52 53  49 4f 4e 00 30 31 2e 30  |_ID.VERSION.01.0| -> Parameters of Variables
00000dd0  30 00 00 00 00 00 00 00  67 64 00 00 4a 50 30 33  |0.......gd..JP03|
00000de0  36 35 2d 50 43 53 47 39  30 30 30 34 5f 30 30 2d  |65-PCSG90004_00-|
00000df0  53 4b 50 32 54 52 49 41  4c 30 30 30 30 30 30 30  |SKP2TRIAL0000000|
00000e00  00 00 00 00 00 00 00 00  00 00 00 00 00 80 1a 00  |................|
00000e30  00 00 00 00 01 00 00 00  30 31 2e 35 30 30 00 00  |........01.500..|
00000e40  00 00 50 01 63 5f 64 61  74 65 3d 32 30 31 31 31  |..P.c_date=20111| -> creation data
00000e50  32 30 35 00 00 00 00 00  00 00 00 00 00 00 00 00  |205.............|
00000e60  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
00001040  00 00 00 00 00 04 00 00  75 6b 65 2d 74 6f 72 6e  |........uke-torn| ->SAVEDATA_MAX_SIZE + STITLE
00001050  65 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |e...............|
00001060  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
00001070  00 00 00 00 00 00 00 00  00 00 00 00 75 6b 65 2d  |............uke-| ->STITLE_00
00001080  74 6f 72 6e 65 00 00 00  00 00 00 00 00 00 00 00  |torne...........|
00001090  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
000010b0  75 6b 65 2d 74 6f 72 6e  65 00 00 00 00 00 00 00  |uke-torne.......| ->TITLE
000010c0  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
00001130  75 6b 65 2d 74 6f 72 6e  65 28 e3 82 a6 e3 82 b1  |uke-torne(......| ->TITLE_00
00001140  e3 83 88 e3 83 ab e3 83  8d 29 00 00 00 00 00 00  |.........)......|
00001150  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
000011b0  50 43 53 43 38 30 30 30  33 00 00 00 30 31 2e 30  |PCSC80003...01.0| ->TITLE_ID + VERSION
000011c0  30 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |0...............|
000011d0  00 00 00 00 00 00 00 01  28 00 00 00 00 00 00 30  |........(......0|
000011e0  80 00 00 00 00 00 00 00  22 00 00 10 1c c7 38 83  |........".....8.|
Retrieved from "http://www.psdevwiki.com/vita/index.php?title=System_File_Object_(SFO)_(PSF)&oldid=4123"