PARAM.SFO

From PS3 Developer wiki
Jump to navigation Jump to search


SFO (System File O???) are used in folders wich content needs to be displayed in the XMB. In the same folder than the SFO are the "content files" (ICON0.PNG PIC0.PNG etc...) and in few cases (like in savegames) there is a PARAM.PFD for security reasons.

The parameters SFO contains can be simplyfied as imputs and outputs of the content:

  • Contains the information strings needed to display the content in the XMB and his restrictions (e.g. name and version of a game).
  • When executing the content, the SFO is sending "boot modifyers" (or flags) to the content to activate "speciall modes" (e.g. audio and video modes of a game).


SFX (System File in XML format) are used to create SFO's. Additionally SFX files are used in Blue-Ray disc games inside PS3_EXTRA folder to display content in XMB. In fact the values contained in both formats are the same and the conversion is easy from one format to the other

SFO and SFX can be "chained" in a structure of subfolders with a maximun of 3 levels (SFX format is used in level3).

Level2 SFO's can contain specific values than cant be used in Level1 (e.g. CATTEGORY when used in level2 has lot of different and specific values). In the same way when ATTRIBUTE is used in level2 his valid values are completly different than when used in level1.

Internal Structure

Header

typdef struct Header
{
uint32_t Signature_bytes; /* PSF */
uint32_t File_Version; /* 1.1 */
uint32_t Start_of_Variable_Name_Table;
uint32_t Start_of_Variable_Data_Table;
uint32_t Number_of_Variables;
};

Internal data definition table

This structure repeats one time for every Number_of_Variables defined in the header 

 typedef struct Internal_Data_Definition
 {
 uint16_t Zero_based_offset_from_Start_of_Variable_Name_Table; /*Name Offset*/
 uint16_t Data_Type; /*utf-8, integer, or blank*/
 uint32_t Total_Used_Bytes_of_Current_Data_Block; /*Bytes Used from the block*/
 uint32_t Total_Size_In_Bytes_of_Current_Data_Block; /*Block Size*/
 uint32_t Zero_based_offset_from_Start_of_Variable_Data_Table; /*Data Offset*/
 };

Variable name table

The entryes of this table (and the next table) can vary depending of the kind of content that is displayed in the XMB (in other words... are defined by CATTEGORY and restricted by the system). This is an example of a savegame 

 unsigned char Variable_Name_table[Number_of_variables+1]={
 "ACCOUNT_ID\0x00",
 "ATTRIBUTE\0x00",
 "CATEGORY\0x00",
 "DETAIL0\x00",
  "PARAMS\0x00",
 "PARAMS2\0x00",
 "PARENTAL_LEVEL\0x00",
 "SAVEDATA_DIRECTORY\0x00",
 "SAVEDATA_LIST_PARAM\0x00",
 "SUB_TITLE\0x00",
 "TITLE\0x00",
 "\0x00\0x00"
 };

Variable data table

 unsigned char Account_ID[16]; account_id
 unsigned long Attribute; attribute
 unsigned char Category[4]="SD",0x00,0x00 category
 unsigned char Detail[1024]; detail
 000558 01 05 01 03 03 00 00 00 00 00 00 00 00 00 00 00 / params
 000568 08 00 00 00 01 00 00 00 01 00 00 00 00 00 00 00
 000578 992 x 0x00
 unsigned char Params2[12]; params2
 unsigned long Parental_level; parental_level
 unsigned char SaveData_directory[64]; savedata_directory
 0009a8 37 33 37 00 00 00 00 00 savedata_list_param
 unsigned char Sub_Title[128]; sub title
 unsigned char Title[128]; title
 } param_sfo;

Source: http://ps3dev.wikispaces.com/PARAM.SFO



PSL1GHT PARAM.SFO

See : 

$ ./read_sfo PARAM1.SFO 
read_sfo v0.01

-[HEADER]---------------
SFO Version: 101
Entries: 12

-[PARAMETERS]-----------
APP_VER: 01.00
ATTRIBUTE: 0
BOOTABLE: 1
CATEGORY: HG
LICENSE: This application was created with the official non-official SDK called psl1ght, for more information visit http://www.psl1ght.com/ . This is in no way associated with Sony Computer Entertainment Inc., please do not contact them for help, they will not be able to provide it.
PARENTAL_LEVEL: 0
PS3_SYSTEM_VER: 01.8000
RESOLUTION: 3f
SOUND_FORMAT: 117
TITLE: PSL1GHT SFO
TITLE_ID: TEST00001
VERSION: 01.00

HEADER

SFO Version

  SFO Version: 101

Entries

Number of entries for PARAMETERS 

  Entries: 12

PARAMETERS

APP_VER

This is the version of the Homebrew, that will be displayed on the PS3 

   <value name="APP_VER" type="string">
   00.50
   </value>

ATTRIBUTE

This value enable special functions of the Homebrew (Enable Move Controller, etc..) 

   <value name="ATTRIBUTE" type="integer">
   0
   </value>

BOOTABLE

If this pkg is bootable or not. (1 to enable, 0 to disable) useful when you are going to make a data pkg. 

   <value name="BOOTABLE" type="integer">
   1
   </value>

CATEGORY

This is the category where you will see your homebrew. 

   <value name="CATEGORY" type="string">
   HG
   </value>

these are the categories available on a Official Firmware:

  • HM : Playstation Network
  • CB : Network
  • HG : Harddrive Game
  • DG : Disc Game (blueray)
  • AV : Video
  • AM : Music
  • AP : Photo
  • AT : TV
  • MN : Minis Network
  • IP : Install Package
  • DP : Disc Package
  • TR : Theme DIR
  • VR : Video DIR
  • VI : Video

LICENSE

PSL1GHT Licence ( DO NOT REMOVE IT and DON'T CHANGE IT) LICENSE has a fixed block size of 128 bytes 

   <value name="LICENSE" type="string">
   This application was created with the official non-official SDK called PSL1GHT, for more information visit http://www.psl1ght.com/ . This is in no way associated with Sony Computer Entertainment Inc., please do not contact them for help, they will not be able to provide it.
   </value>

PARENTAL_LEVEL

Parental level, ( 0 for everyone ) 

   <value name="PARENTAL_LEVEL" type="integer">
   0
   </value>

PS3_SYSTEM_VER

Minimum PS3 System version to be bootable this homebrew 

   <value name="PS3_SYSTEM_VER" type="string">
   01.5000
   </value>

RESOLUTION

TV Resolution (Unknown ) 

   <value name="RESOLUTION" type="integer">
   63
   </value>

SOUND_FORMAT

Type of sound 

   <value name="SOUND_FORMAT" type="integer">
   279
   </value>

TITLE

Title of the homebrew 

   <value name="TITLE" type="string">
   Title of this Homebrew
   </value>

TITLE_ID

ID of the homebrew (this id must be the same id inside the Makefile) 

   <value name="TITLE_ID" type="string">
   XXYYYYYY
   </value>

VERSION

Homebrew Version 

   <value name="VERSION" type="string">
   00.50
   </value>


(source deroad: http://ps3tutorials.wikispaces.com/Edit+the+sfo.xml+Tutorial)

PS3SYS PARAM.SFO

$ ./read_sfo PARAM2.SFO 
read_sfo v0.01

-[HEADER]---------------
SFO Version: 101
Entries: 20

-[PARAMETERS]-----------
APP_VER: 01.00
ATTRIBUTE: 880727
BOOTABLE: 1
CATEGORY: HG
LICENSE: Library programs ©Sony Computer Entertainment Inc. Licensed for play on the PLAYSTATION®3 Computer Entertainment System or authorized PLAYSTATION®3 format systems. For full terms and conditions see the user's manual. This product is authorized and produced under license from Sony Computer Entertainment Inc. Use is subject to the copyright laws and the terms and conditions of the user's license.
PARENTAL_LEVEL: 0
PARENTAL_LEVEL_A: ffffffff
PARENTAL_LEVEL_C: ffffffff
PARENTAL_LEVEL_E: ffffffff
PARENTAL_LEVEL_H: ffffffff
PARENTAL_LEVEL_J: ffffffff
PARENTAL_LEVEL_K: ffffffff
PS3_SYSTEM_VER: 00.93
REGION_DENY: fffff001
RESOLUTION: 1
SOUND_FORMAT: 1
TITLE: PS3SYS SFO
TITLE_ID: TEST00002
VERSION: 01.00


HEADER

SFO Version

  SFO Version: 101

Entries

Number of entries for PARAMETERS 

   Entries: 20

PARAMETERS

APP_VER

This is the version of the Homebrew, that will be displayed on the PS3 

String (UTF-8)
max length 8

   <value name="APP_VER" type="string">
   01.00
   </value>

ATTRIBUTE

This value enable special functions of the Homebrew (Enable Move Controller, Enable PSP remoteplay etc..) 

Integer
max length 4 

   <value name="ATTRIBUTE" type="integer">
   880727
   </value>
Enable PSP remoteplay
  • MPEG-4 SP/ATRAC=0x1
  • MPEG-4 AVC/AAC=0x4
Enable BGM
  • Enable ingame XMB BGM=0x20
Enable Move Controller
  • Support Playstation Move=0x800000
  • Enable Move controller warning=0x100
  • Enable Navigation controller warning=0x200
  • Enable Playstation Eye warning=0x400
  • Enable Calibration warning=0x800
Enable 3D Warning
  • Enable 3D warning screen=0x1000

BOOTABLE

If this pkg is bootable or not. (1 to enable, 0 to disable) useful when you are going to make a data pkg. 

Integer
max length 4

   <value name="BOOTABLE" type="integer">
   1
   </value>

CATEGORY

This is the category where you will see your homebrew. 

String(UTF-8)
max length 4

   <value name="CATEGORY" type="string">
   HG
   </value>

these are the categories available on a Official Firmware:

  • HM : Playstation Network
  • CB : Network
  • HG : Harddrive Game
  • DG : Disc Game (blueray)
  • AV : Video
  • AM : Music
  • AP : Photo
  • AT : TV
  • MN : Minis Network

As Additional Items:

  • AR : Patches
  • IP : Install Packages
  • VI : Video
  • TR : Theme
  • XR : Extra Contents

CONTENT_ID

ContentID for Gamepurchase 

String(UTF-8)
max length 48

LICENSE

PSL1GHT Licence ( DO NOT REMOVE IT and DON'T CHANGE IT) LICENSE has a fixed block size of 128 bytes 

String(UTF-8)
max length 512

   <value name="LICENSE" type="string">
   Library programs ©Sony Computer Entertainment Inc. Licensed for play on the PLAYSTATION®3 Computer Entertainment System or authorized PLAYSTATION®3 format systems. For full terms and conditions see the user's manual. This product is authorized and produced under license from Sony Computer Entertainment Inc. Use is subject to the copyright laws and the terms and conditions of the user's license.
   </value>

NP_COMMUNICATION_ID

Comm ID for Bootable message 

String(UTF-8)
max length 16

PARENTAL_LEVEL

Integer
max length 4

Parental level, (0-11 ; 0 for everyone ) 

   <value name="PARENTAL_LEVEL" type="integer">
   0
   </value>
PARENTAL_LEVEL_A

Parental level, SCEA 

Integer
max length 4

   <value name="PARENTAL_LEVEL_A" type="integer">
   ffffffff
   </value>
PARENTAL_LEVEL_C

Parental level, SCH 

Integer
max length 4

   <value name="PARENTAL_LEVEL_C" type="integer">
   ffffffff
   </value>
PARENTAL_LEVEL_E

Parental level, SCEE 

Integer
max length 4

   <value name="PARENTAL_LEVEL_E" type="integer">
   ffffffff
   </value>
PARENTAL_LEVEL_H

Parental level, SCEH 

Integer
max length 4

   <value name="PARENTAL_LEVEL_H" type="integer">
   ffffffff
   </value>
PARENTAL_LEVEL_J

Parental level, SCEJ 

Integer
max length 4

   <value name="PARENTAL_LEVEL_J" type="integer">
   ffffffff
   </value>
PARENTAL_LEVEL_K

Parental level, SCEK 

Integer
max length 4

   <value name="PARENTAL_LEVEL_K" type="integer">
   ffffffff
   </value>

PS3_SYSTEM_VER

Minimum PS3 System version to be bootable this homebrew 

String(UTF-8)
max length 8

   <value name="PS3_SYSTEM_VER" type="string">
   00.93
   </value>

REGION_DENY

Region restrictions (only possible with 3.30 and higher) 

Integer
max length 4

   <value name="REGION_DENY" type="integer">
   fffff001
   </value>

RESOLUTION

TV Resolution (576(16x9)=0x20, 480(16:9)=0x10, 1080=0x8, 720=0x4, , 576=0x2, 480=0x1) 

Integer
max length 4

   <value name="RESOLUTION" type="integer">
   1
   </value>

SOUND_FORMAT

Type of sound (DTS Digital Surround=0x202, Dolby Digital=0x102, 7.1LPCM=0x10, 5.1LPCM=0x4, 2LPCM=0x1) 

Integer
max length 4

   <value name="SOUND_FORMAT" type="integer">
   1
   </value>

TITLE

Title of the homebrew 

String(UTF-8)
max length 128

   <value name="TITLE" type="string">
   Title of this Homebrew
   </value>
TITLE_00

Localised title - Japanese 

String(UTF-8)
max length 128
TITLE_01

Localised title - English 

String(UTF-8)
max length 128
TITLE_02

Localised title - French 

String(UTF-8)
max length 128
TITLE_03

Localised title - Spanish 

String(UTF-8)
max length 128
TITLE_04

Localised title - German 

String(UTF-8)
max length 128
TITLE_05

Localised title - Italian 

String(UTF-8)
max length 128
TITLE_06

Localised title - Dutch 

String(UTF-8)
max length 128
TITLE_07

Localised title - Portuguese 

String(UTF-8)
max length 128
TITLE_08

Localised title - Russian 

String(UTF-8)
max length 128
TITLE_09

Localised title - Korean 

String(UTF-8)
max length 128
TITLE_10

Localised title - Trad.Chinese 

String(UTF-8)
max length 128
TITLE_11

Localised title - Simp.Chinese 

String(UTF-8)
max length 128
TITLE_12

Localised title - Finnish 

String(UTF-8)
max length 128
TITLE_13

Localised title - Swedish 

String(UTF-8)
max length 128
TITLE_14

Localised title - Danish 

String(UTF-8)
max length 128
TITLE_15

Localised title - Norwegian 

String(UTF-8)
max length 128
TITLE_16

Localised title - Polish 

String(UTF-8)
max length 128

TITLE_ID

ID of the homebrew (this id must be the same id inside the Makefile) 

String(UTF-8)
max length 16

   <value name="TITLE_ID" type="string">
   XXYYYYYY
   </value>

VERSION

Homebrew Version 

String(UTF-8)
max length 8

   <value name="VERSION" type="string">
   01.00
   </value>
Retrieved from "http://www.psdevwiki.com/ps3/index.php?title=PARAM.SFO&oldid=9380"