Editing Playstation Update Package (PUP)
Jump to navigation
Jump to search
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
== Description == | ==Description== | ||
'''PUP''' ('''P'''laystation '''U'''pdate '''P'''ackage) files are packages which contain the files used to update a PSP or PS3 system. There are 2 different types: patches (PS3PATCH.PUP) and full updates (PS3UPDAT.PUP). Based on the model, there are 4 different release types: Retail/CEX, Shop/SEX, Debug/DEX and Tool/DECR. Within the Retail/CEX there are 2 file versions: 1 is a PUP with a normal file length which also gets released online. The other PUP file version is the same, except it is zero-filled after the normal PUP content to a fixed filelength of 256MB, which gets released on Gamedisks (if gamecreators build their project to a premaster and give it to Sony for signing, they just use a placeholder of a 256MB PS3UPDAT.PUP which contains no firmwaredata at all - it is completely zerofilled. Sony decides the firmware that gets on the disk and for which firmware the 'Gold' code is signed and mastered). | '''PUP''' ('''P'''laystation '''U'''pdate '''P'''ackage) files are packages which contain the files used to update a PSP or PS3 system. There are 2 different types: patches (PS3PATCH.PUP) and full updates (PS3UPDAT.PUP). Based on the model, there are 4 different release types: Retail/CEX, Shop/SEX, Debug/DEX and Tool/DECR. Within the Retail/CEX there are 2 file versions: 1 is a PUP with a normal file length which also gets released online. The other PUP file version is the same, except it is zero-filled after the normal PUP content to a fixed filelength of 256MB, which gets released on Gamedisks (if gamecreators build their project to a premaster and give it to Sony for signing, they just use a placeholder of a 256MB PS3UPDAT.PUP which contains no firmwaredata at all - it is completely zerofilled. Sony decides the firmware that gets on the disk and for which firmware the 'Gold' code is signed and mastered). | ||
== | ==Regioning== | ||
There is no regioning in the .PUP files, they are the same for all different regions (if you were looking for regioninfo, [http://www.ps3devwiki.com/index.php?title=SKU_Models#Regioning see here]).<br /> | |||
The PS3 however gets the [[ps3-updatelist.txt]] from different servers, depending on the region of that model (last 2 numbers in the CECHxxXX SKU name). | |||
There is no regioning in the .PUP files | |||
<ul> | <ul> | ||
| Line 82: | Line 22: | ||
<li> [http://fbr01.ps3.update.playstation.net/update/ps3/list/br/ps3-updatelist.txt Brasil, br] (11 > 0x8F) | <li> [http://fbr01.ps3.update.playstation.net/update/ps3/list/br/ps3-updatelist.txt Brasil, br] (11 > 0x8F) | ||
</ul> | </ul> | ||
for completeness: Reference Tool/DECR : 0x81, Debug/DEX : 0x82 and System Debugger : 0xA0 | |||
Retail basic structure of the update URL: | Retail basic structure of the update URL: | ||
| Line 94: | Line 33: | ||
Content: | Content: | ||
# JP(shop) | # JP(shop) | ||
Dest=83;CompatibleSystemSoftwareVersion=4.7600-; | Dest=83;CompatibleSystemSoftwareVersion=4.7600-; | ||
| Line 130: | Line 69: | ||
Dest=8F;CompatibleSystemSoftwareVersion=4.7600-; | Dest=8F;CompatibleSystemSoftwareVersion=4.7600-; | ||
Dest=8F;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dbr01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30; | Dest=8F;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dbr01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30; | ||
Shop basic structure of the update URL: | Shop basic structure of the update URL: | ||
| Line 136: | Line 75: | ||
(TLD=2 letter abbreviation from above region, YYYY_MMDD is release date, MD5 is 22-digits long HASH) | (TLD=2 letter abbreviation from above region, YYYY_MMDD is release date, MD5 is 22-digits long HASH) | ||
==Installation== | |||
== Installation == | |||
To install firmware via USB Mass Storage Devices (e.g. USB-stick, Memory Stick, SD-card, Compact Flash with at least 256MB free), place the PS3UPDAT.PUP file in the following folder structure: /PS3/UPDATE/PS3UPDAT.PUP | To install firmware via USB Mass Storage Devices (e.g. USB-stick, Memory Stick, SD-card, Compact Flash with at least 256MB free), place the PS3UPDAT.PUP file in the following folder structure: /PS3/UPDATE/PS3UPDAT.PUP | ||
| Line 448: | Line 200: | ||
0x8002F2Ex - (Turning On/Off Recovery Mode Flag) | 0x8002F2Ex - (Turning On/Off Recovery Mode Flag) | ||
= | ==Firmware .PUP structure== | ||
The HMAC key used to verify the packages has been released. Look around for "pup-hmac" | |||
= | <!--// PUP Extractor http://www.megaupload.com/?d=WILOJ5TC (outdated : incompatible output, tool not update since 27 may 2008 - autor:NDT @ ps3news) //--> | ||
=== Header === | ===Header=== | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 494: | Line 212: | ||
! Offset !! Length !! Type !! Information | ! Offset !! Length !! Type !! Information | ||
|- | |- | ||
| 0x0 || | | 0x0 || 0x8 || unsigned long || Magic | ||
|- | |- | ||
| | | 0x8 || 0x8 || unsigned long || Package Version | ||
|- | |- | ||
| | | 0x10 || 0x8 || unsigned long || Image Version | ||
|- | |- | ||
| | | 0x18 || 0x8 || unsigned long || File Count | ||
|- | |- | ||
| | | 0x20 || 0x8 || unsigned long || Header Length | ||
|- | |- | ||
| | | 0x28 || 0x8 || unsigned long || File Length | ||
|- | |- | ||
| | | 0x30 || 0x20 * '''File Count''' || '''File Table''' || File Table | ||
|- | |- | ||
| 0x30 || 0x20 * ''' | | 0x30 + (0x20 * '''File Count''') || 0x20 * '''File Count''' || '''Hash Table''' || Hash Table | ||
|- | |- | ||
| 0x30 + ( | | 0x30 + (0x40 * '''File Count''') || 0x14 || bytes || Header Hash | ||
|- | |- | ||
| | | 0x44 + (0x40 * '''File Count''') || 0xC || bytes || Unknown | ||
|- | |- | ||
|} | |} | ||
=== | ===File Table=== | ||
The file table consists of a number of file entries determined by '''File Count''', with the format below: | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! Offset | ! Offset | ||
! Length | |||
! Type | |||
! Information | |||
|- | |- | ||
| 0x0 | |||
| 0x8 | |||
| unsigned long | |||
| Entry ID | |||
|- | |- | ||
| | | 0x8 | ||
| 0x8 | |||
| unsigned long | |||
| Data Offset | |||
|- | |- | ||
| 0x8 || | | 0x10 | ||
| 0x8 | |||
| unsigned long | |||
| Data Length | |||
|- | |- | ||
| | | 0x18 | ||
| 0x8 | |||
| unsigned long | |||
| Unknown | |||
|} | |} | ||
=== | ===Filename IDs=== | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! File Entry ID | |||
! Filename | |||
|- | |- | ||
| | | 0x100 | ||
| [[version.txt]] (aka: ps3version.txt) | |||
|- | |- | ||
| | | 0x101 | ||
| [[license.xml]] (aka: resource.txt? ) | |||
|- | |- | ||
| | | 0x102 | ||
| [[promo_flags.txt]] (only on {{shop}}) (aka: shop.txt?) | |||
|- | |- | ||
| | | 0x103 | ||
| [[update_flags.txt]] | |||
|- | |- | ||
| | | 0x104 | ||
| [[patch_build.txt]] | |||
|- | |- | ||
| | | 0x200 | ||
| [[ps3swu.self]] | |||
|- | |- | ||
| | | 0x201 | ||
| [[vsh.tar]] / font_resource.tar | |||
|- | |- | ||
| | | 0x202 | ||
| [[dots.txt]] | |||
|- | |- | ||
| | | 0x203 | ||
| [[patch_data.pkg]] | |||
|- | |- | ||
| | | 0x300 | ||
| [[update_files.tar]] | |||
|- | |- | ||
| | | 0x501 | ||
| [[spkg_hdr.tar]] (added since FW 3.56) | |||
|- | |- | ||
| | | 0x601 | ||
| | | [[ps3swu2.self]] (added since FW 3.56) | ||
|} | |} | ||
=== | ===Hash Table=== | ||
The hash table contains a hash entry for every file inside the PUP. | |||
The | |||
The hash entry format is: | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! Offset | ! Offset | ||
! Length | |||
! Type | |||
! Information | |||
|- | |- | ||
| 0x0 | | 0x0 | ||
| 0x8 | |||
| unsigned long | |||
| File Entry ID | |||
|- | |- | ||
| 0x8 || | | 0x8 | ||
| 0x14 | |||
| bytes | |||
| HMAC-SHA1 hash | |||
|- | |- | ||
| | | 0x1C | ||
| 0x4 | |||
| unsigned int | |||
| Unknown | |||
|} | |} | ||
== | ==Files in tree example== | ||
Here are two examples of the files stored in a PUP. | |||
=== 3.55 === | === 3.55 === | ||
PS3UPDAT.PUP | PS3UPDAT.PUP | ||
├── dots.txt | ├── dots.txt | ||
| Line 913: | Line 454: | ||
├── version.txt | ├── version.txt | ||
└── vsh.tar | └── vsh.tar | ||
For a comparison between Retail and Debug firmware : [[3.55 firmware]] | |||
For a comparison between Retail and Debug firmware : [[3.55 firmware]] | |||
=== 3.60 - 4.00 === | === 3.60 - 4.00 === | ||
PS3UPDAT.PUP | PS3UPDAT.PUP | ||
├── dots.txt | ├── dots.txt | ||
| Line 1,066: | Line 604: | ||
└── vsh.tar | └── vsh.tar | ||
└── a | └── a | ||
==Content of different versions== | |||
The following information is a copy/paste from the output of [http://mir.cr/1OBIW13N KaKaRoTo's pup.c tool]. This is an old build, which does not support 3.56/3.60 and higher added entryid's x501 & 0x601 (which because of that are named ''Unknown entry id''). | |||
===File Structure=== | |||
HMAC Key | |||
<!-- <pre> | |||
static const uint8_t hmac_pup_key[] = { | |||
0xf4, 0x91, 0xad, 0x94, 0xc6, 0x81, 0x10, 0x96, | |||
0x91, 0x5f, 0xd5, 0xd2, 0x44, 0x81, 0xae, 0xdc, | |||
0xed, 0xed, 0xbe, 0x6b, 0xe5, 0x13, 0x72, 0x4d, | |||
0xd8, 0xf7, 0xb6, 0x91, 0xe8, 0x8a, 0x38, 0xf4, | |||
0xb5, 0x16, 0x2b, 0xfb, 0xec, 0xbe, 0x3a, 0x62, | |||
0x18, 0x5d, 0xd7, 0xc9, 0x4d, 0xa2, 0x22, 0x5a, | |||
0xda, 0x3f, 0xbf, 0xce, 0x55, 0x5b, 0x9e, 0xa9, | |||
0x64, 0x98, 0x29, 0xeb, 0x30, 0xce, 0x83, 0x66 | |||
}; | |||
</pre> --> | |||
<pre>REDACTED</pre> | |||
Header | |||
<pre> | |||
typedef struct { | |||
uint64_t magic; | |||
uint64_t package_version; | |||
uint64_t image_version; | |||
uint64_t file_count; | |||
uint64_t header_length; | |||
uint64_t data_length; | |||
} PUPHeader; | |||
</pre> | </pre> | ||
File Entry | |||
<pre> | |||
typedef struct { | |||
uint64_t entry_id; | |||
uint64_t data_offset; | |||
uint64_t data_length; | |||
uint8_t padding[8]; | |||
} PUPFileEntry; | |||
</pre> | |||
Hash Entry | |||
{ | <pre> | ||
typedef struct { | |||
uint64_t entry_id; | |||
uint8_t hash[20]; | |||
uint8_t padding[4]; | |||
} PUPHashEntry; | |||
</pre> | |||
Footer | |||
<pre> | |||
typedef struct | |||
{ | |||
uint8_t hash[20]; | |||
uint8_t padding[12]; | |||
} PUPFooter; | |||
</pre> | |||
Entry Id | |||
<pre> | |||
typedef struct { | |||
uint64_t id; | |||
const char *filename; | |||
} PUPEntryID; | |||
</pre> | |||
PUPEntryID entries | |||
<pre>static const PUPEntryID entries[] = { | |||
{0x100, "version.txt"}, | |||
{0x101, "license.xml"}, | |||
{0x102, "promo_flags.txt"}, | |||
{0x103, "update_flags.txt"}, | |||
{0x104, "patch_build.txt"}, | |||
{0x200, "ps3swu.self"}, | |||
{0x201, "vsh.tar"}, | |||
{0x202, "dots.txt"}, | |||
{0x203, "patch_data.pkg"}, | |||
{0x300, "update_files.tar"}, | |||
{0x501, "spkg_hdr.tar"}, | |||
{0x601, "ps3swu2.self"}, | |||
{0, NULL} | |||
};</pre> | |||
=== | ===Contents=== | ||
{| class="wikitable" | |||
{| class="wikitable | |||
|- | |- | ||
!Entry Id | |||
!Filename | |||
|- | |- | ||
| | |0x100 | ||
|[[version.txt]] | |||
|- | |- | ||
| | |0x101 | ||
|[[license.xml]] | |||
|- | |- | ||
| | |0x102 | ||
|[[promo_flags.txt]] | |||
|- | |- | ||
| | |0x103 | ||
|[[update_flags.txt]] | |||
|- | |- | ||
| | |0x104 | ||
|[[patch_build.txt]] | |||
|- | |- | ||
| | |0x200 | ||
|[[ps3swu.self]] | |||
|- | |- | ||
| | |0x201 | ||
|[[vsh.tar]] | |||
|- | |- | ||
| | |0x202 | ||
|[[dots.txt]] | |||
|- | |- | ||
| | |0x203 | ||
|[[patch_data.pkg]] | |||
|- | |- | ||
| | |0x300 | ||
|[[update_files.tar]] | |||
|- | |- | ||
| | |0x501 | ||
|[[spkg_hdr.tar]] | |||
|- | |- | ||
| | |0x601 | ||
|[[ps3swu2.self]] | |||
|- | |- | ||
|} | |} | ||
{{Custom Firmware}}<noinclude>[[Category:Main]]</noinclude> | {{Custom Firmware}}<noinclude>[[Category:Main]]</noinclude> | ||