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''' ( | '''PUP''' (Playstation Update Package) 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 PS3UPDATE.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). | ||
== | === Interactive Display Unit === | ||
A plain retail unit, optionally in kiosk enclosure, running Shop/SEX firmware (a [[Playstation Update Package (PUP)]] with [[Promo_flags.txt]] set accordingly) | |||
=== | ==== Explaination ==== | ||
<div style="border-width: 1px; border-style:dashed; border-color:#000000; padding: 10px; background-color:#FFFFFF; color:#000000; ">http://qknowledge72.mosaic.com/courses/docs/GO_SONYMANINTENANCE_SONYGLOSSARY.pdf (10/7/2008) | |||
Demonstration Mode is exclusive to PS3 IDUs. When the console is placed in Demonstration Mode, many of the settings functions on the XMB are locked out, for instance you are unable to delete movies and games, turn off the console in the PS Button menu, and reformatting the hard drive. To perform any firmware update, or install any package files, the PS3 has to be taken out of demo mode. The instructions included with the IDU update disc will walk you through the process of unlocking the console. It is important to always put the console back into Demonstration Mode after any update. If “Playstation 3 Demonstration Mode ver. xxx” is not displayed in the bottom right of the XMB screen, the console is not in Demonstration Mode. To place the console in Demo Mode you can restart the console using the touch sensitive button on the front of the console. | |||
The | IDU stands for Interactive Display Unit. The Playstation 3 consoles displayed in Walmart stores are different from consumer units; They are unable to play some consumer software and have a built in demonstration mode which requires a password to access the important features. When a Firmware update is being performed, the disk and instructions will read “PS3 IDU v. xxx” along with the date of the update. Note: All interactives must be a IDU console! If it is not: 1) Get with the D5 manager and try to find the store's IDU console, 2) If it can not be found call the Tech Line to order a replacement and report it lost or stolen. | ||
The update | The IDU update disc is used to install the new firmware and package files on the IDU PS3s. Instructions are sent with the IDU disc, providing step by step instructions of how to complete the installation. It is very important to follow the directions as they are written, and to check the date listed on the IDU update disc. | ||
Package files are media files installed onto the Playstation 3 console during a firmware update. The package files include game demos, photos, audio and movie demonstrations, both playable and viewable.</div> | |||
As the IDU disks are [[Disk_Identification/Serialisation_Data|pressed BDROMs]], they comply to [[Basic Bluray disc authentication procedure]], with its content on it as discbound+signed by Sony themselves, it does not [[Error_Codes#NP_DRM_error|error out with 0x80029564 - SCE_NP_DRM_INSTALL_ERROR_CHECK]], like those NP retail packages would that are ''not'' started from pressed BD or using [[ODE]], even when those are signed by Sony themselves. | |||
==== Default unlock codes for Shop/SEX ==== | |||
*1.5x: 5202 <strike>8604/</strike> | |||
*1.6x: 7568 | |||
*1.7x: 0506 | |||
*1.8x: 7712 <strike>7259/</strike> | |||
*1.9x: 2737 | |||
*2.0x: 0219 | |||
*2.1x: 2464 | |||
*2.2x: 4801 | |||
*2.3x: 6558 | |||
*2.4x: 9015 | |||
*2.5x: 6258 | |||
*2.6x: 8783 | |||
*2.7x: 7164 | |||
*2.8x: 7897 | |||
*3.0x: 2310 | |||
*3.1x: 5081 | |||
*3.2x: 7818 | |||
*3.3x: 3512 | |||
*3.4x: 2998 | |||
*3.5x: 2297 | |||
*3.6x: 1739 | |||
*3.7x: 5138 | |||
*4.1x: 2464 | |||
*4.2x: 4801 | |||
*4.3x: 6558 | |||
*4.4x: 9015 | |||
others seen in vsh.self (3.55): | |||
*1739 | |||
*5138 | |||
*0168 | |||
*8294 | |||
== | ==Regioning== | ||
There is no regioning in the .PUP files, they are the same for all different regions (if you where 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, depening 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 70: | ||
<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 81: | ||
Content: | Content: | ||
# JP(shop) | # JP(shop) | ||
Dest=83;CompatibleSystemSoftwareVersion=4.7600-; | Dest=83;CompatibleSystemSoftwareVersion=4.7600-; | ||
| Line 130: | Line 117: | ||
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 123: | ||
(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 335: | Line 135: | ||
* The update location for Arcade is "/dev_hdd0/game/SCEEXE000/ARCDIR/PS3UPDAT.PUP" | * The update location for Arcade is "/dev_hdd0/game/SCEEXE000/ARCDIR/PS3UPDAT.PUP" | ||
* The update location in Factory Service Mode (used for downgrader and remarry) is /PS3UPDAT.PUP | * The update location in Factory Service Mode (used for downgrader and remarry) is /PS3UPDAT.PUP | ||
* The update location for [[QA_Flagging#Debug_Settings|QA Debug setting]] : System Update Debug=ON is /dev_hdd0/updater/01/ | * The update location for [[QA_Flagging#Debug_Settings|QA Debug setting]] : System Update Debug=ON is /dev_hdd0/updater/ (with subfolders /01/, /02/ ... e.g. /dev_hdd0/updater/01/PS3UPDAT.PUP) | ||
=== Problem solving / tips === | === Problem solving / tips === | ||
| Line 448: | Line 249: | ||
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 261: | ||
! 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 | | 0x0 | ||
| 0x8 | |||
| unsigned long | |||
| Entry ID | |||
|- | |- | ||
| 0x8 | | 0x8 | ||
| 0x8 | |||
| unsigned long | |||
| Data Offset | |||
|- | |- | ||
| 0x10 | | 0x10 | ||
| 0x8 | |||
| unsigned long | |||
| Data Length | |||
|- | |- | ||
| 0x18 | | | 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. | |||
Here are examples of the files stored in a PUP. | |||
=== 3.55 === | === 3.55 === | ||
PSUPDATE.PUP | |||
├── dots.txt | ├── dots.txt | ||
├── license.txt | ├── license.txt | ||
| Line 910: | Line 500: | ||
│ ├── info0 | │ ├── info0 | ||
│ └── info1 | │ └── info1 | ||
├── update_files.tar | |||
├── update_flags.txt | ├── update_flags.txt | ||
├── 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 === | ||
PSUPDATE.PUP | |||
├── dots.txt | ├── dots.txt | ||
├── license.xml | ├── license.xml | ||
| Line 1,066: | Line 654: | ||
└── 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> | |||
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> | </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]] | |||
|- | |- | ||
|} | |} | ||
{{ | {{Firmware}}<noinclude>[[Category:Main]]</noinclude> | ||