Editing Playstation Update Package (PUP)

==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).

==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).

<ul>
<li> [http://fjp01.ps3.update.playstation.net/update/ps3/list/jp/ps3-updatelist.txt Japan, jp] (00 > 0x83)
<li> [http://fus01.ps3.update.playstation.net/update/ps3/list/us/ps3-updatelist.txt USA, us] (01 > 0x84)
<li> [http://feu01.ps3.update.playstation.net/update/ps3/list/eu/ps3-updatelist.txt Europe, eu] (04 > 0x85)
<li> [http://fkr01.ps3.update.playstation.net/update/ps3/list/kr/ps3-updatelist.txt Korea, kr] (05 > 0x86)
<li> [http://fuk01.ps3.update.playstation.net/update/ps3/list/uk/ps3-updatelist.txt United Kingdom, uk] (03 > 0x87)
<li> [http://fmx01.ps3.update.playstation.net/update/ps3/list/mx/ps3-updatelist.txt Mexico, mx] (11 > 0x88)
<li> [http://fau01.ps3.update.playstation.net/update/ps3/list/au/ps3-updatelist.txt Australia/New Zealand, au] (02 > 0x89)
<li> [http://fsa01.ps3.update.playstation.net/update/ps3/list/sa/ps3-updatelist.txt South Asia, sa (Asia except China, Japan, Korea  and Taiwan)] (06 > 0x8A)
<li> [http://ftw01.ps3.update.playstation.net/update/ps3/list/tw/ps3-updatelist.txt Taiwan, tw] (07 > 0x8B)
<li> [http://fru01.ps3.update.playstation.net/update/ps3/list/ru/ps3-updatelist.txt Russia, ru] (08 > 0x8C)
<li> [http://fcn01.ps3.update.playstation.net/update/ps3/list/cn/ps3-updatelist.txt China, cn] (09 > 0x8D)
<li> [http://fhk01.ps3.update.playstation.net/update/ps3/list/hk/ps3-updatelist.txt Hong Kong, hk] (10 > 0x8D)
<li> [http://fbr01.ps3.update.playstation.net/update/ps3/list/br/ps3-updatelist.txt Brasil, br] (11 > 0x8F)
</ul>
for completeness: Reference Tool/DECR : 0x81, Debug/DEX : 0x82 and System Debugger : 0xA0

Retail basic structure of the update URL:

   http&#58;&#47;&#47;d<span style="color:darkgreen;font-style:italic;"><TLD></span>01.ps3.update.playstation.net&#47;update&#47;ps3&#47;image&#47;<span style="color:darkgreen;font-style:italic;"><TLD></span>&#47;<span style="color:darkgreen;font-style:italic;">YYYY_MMDD_md5</span>&#47;PS3UPDAT.PUP
 (TLD=2 letter abbreviation from above region, YYYY_MMDD is release date, MD5 is 32-digits long HASH)


Shop update check URL: http://fshop01.ps3.update.playstation.net/update/ps3/list/shop/ps3-updatelist.txt

Content:

 # JP(shop)
 Dest=83;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=83;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://djp01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # US(shop)
 Dest=84;CompatibleSystemSoftwareVersion=4.7600-;
  Dest=84;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dus01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # EU(shop)
 Dest=85;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=85;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://deu01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # KR(shop)
 Dest=86;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=86;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dkr01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # UK(shop)
 Dest=87;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=87;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://duk01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # MX(shop)
 Dest=88;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=88;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dmx01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # AU/NZ(shop)
 Dest=89;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=89;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dau01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # SouthAsia(shop)
 Dest=8A;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=8A;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dsa01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # TW(shop)
 Dest=8B;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=8B;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dtw01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # RU(shop)
 Dest=8C;CompatibleSystemSoftwareVersion=4.7600-;
 Dest=8C;ImageVersion=00010015;SystemSoftwareVersion=4.7600;CDN=http://dru01.ps3.update.playstation.net/update/ps3/image/shop/2015_0903_6f462b5aaaed64263d72e1e989e4b336/PS3UPDAT.PUP;CDN_Timeout=30;
 # CN(shop)
 Dest=8D;ImageVersion=00000000;SystemSoftwareVersion=0.0000;CDN=http://dcn01.ps3.update.playstation.net/update/ps3/image/shop/nodata;CDN_Timeout=30;
 # BR(shop)
 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;


Shop basic structure of the update URL:
   http&#58;&#47;&#47;d<span style="color:darkgreen;font-style:italic;"><TLD></span>01.ps3.update.playstation.net&#47;update&#47;ps3&#47;image&#47;shop&#47;<span style="color:darkgreen;font-style:italic;">YYYY_MMDD_md5</span>&#47;PS3UPDAT.PUP
 (TLD=2 letter abbreviation from above region, YYYY_MMDD is release date, MD5 is 22-digits long HASH)

==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

* The update location for Kiosk is the same as Retail/CEX.
* The update location for disc media (CD, DVD, BD-ROM) is /PS3_UPDATE/PS3UPDAT.PUP
* The update data for Reference Tool (Tool/DECR) is %SCE_PS3_ROOT%\target\updater\ref-tool\PS3UPDAT.PUP.NNN.0xx
* The update data for Debugging Station (Debug/DEX) is %SCE_PS3_ROOT%\target\updater\debugging_station\PS3UPDAT.PUP.NNN.0xx.forDEX.release.yyyymmdd
* For updating with a single firmware PUP, both the Reference Tool (Tool/DECR) and Debugging Station (Debug/DEX) use the same folder structure as Retail/CEX : /PS3/UPDATE/PS3UPDAT.PUP
* For updating with a multiple firmware PUP (2.50 or later), the Reference Tool (Tool/DECR) can use the folder structure : /PS3/UPDATE/SEARCH with a maximum of 2 sublevels deeper (e.g. PS3/UPDATE/SEARCH/ReferenceTool/250/PS3UPDAT.PUP.242.001). A maximum of 20 PUP files (including /PS3/UPDATE/PS3UPDAT.PUP if applicable) will be shown in the firmware list.
* 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 for [[QA_Flagging#Debug_Settings|QA Debug setting]] : System Update Debug=ON is /dev_hdd0/updater/01/PS3UPDAT.PUP, /dev_hdd0/updater/02/PS3UPDAT.PUP, etc... (or up to 20 updates together with any name and no file extension required in /dev_hdd0/updater/01/)

=== Problem solving / tips ===
* Don’t use any USB Mass Storage Device with enhanced functions as: encryption, fingerprintreader, U3, pincode etc. (sometimes marketed under names as SCSI Enclosure Services (SES) thus needing drivers and only working under Windows)
* Don’t use USB Mass Storage Devices with a long initialisation time (e.g. some MP3 players)
* Don’t use multipartitioned USB Mass Storage Devices, only use 1 single primary FAT32 partition.
* Make sure they are formatted according to specifications with FAT32 (e.g. [http://www.google.com/search?q=HP+USB+Format+Tool HP USB Format Tool] – or [http://tokiwa.qee.jp/EN/Fat32Formatter/ TOKIWA] / [http://www.ridgecrop.demon.co.uk/guiformat.htm Ridgecrop] FAT32 formatter)
* If the stick is formatted FAT32 and still not working, consider other stick or use this tool: http://www.pendrivelinux.com/restoring-your-usb-key-partition/
* Most USB Mass Storage Devices that’ll work effortless with PenDrive Linux, will also work with the PS3 (for downgrading, upgrading, storage of your Game dumps and any normal filestorage under the XMB). Those USB Mass Storage Devices are most likely also the ones giving you the least problems under more exotic platforms like PSX/PSone, PS2/PStwo, Xbox/X360, Gamecube/Wii/WiiU etc.
* Make sure no disc is inside the drive otherwise it will try to install that one instead of the one on USB Mass Storage Device!
* Make sure the media is not readonly (e.g. SDcard or USB Stick with readonly tab) if using firmwares when doing one of the following:
** Factory Service Mode reinstallation
** Remarry BDdrive
** RSOD Fix
** or any process that needs to write a log file, in short, write access

== Installation descriptive ==
:Select via XMB, Settings -> System Update

<pre>
Update via Internet
Update via Storage Media
</pre>

:Select Update via Storage Media

<pre>
The following update data was found:
 Version 3.41-@@SUFFIX@@
Location USB Device
</pre>

:Select OK

<pre>
User Agreement

<str id="msg_update_eula_1">line 1
</str>
...
<str id="msg_update_eula_X">line X
</str>
</pre>

:Select right arrow or left joystick right

<pre>
Do you accept the user agreement?

Do Not Accept
Accept
</pre>

:Select right arrow or left joystick right

<pre>
Main Features Revised in System Software Version 3.41-@@SUFFIX@@

<str id="msg_updater_10">FEATURE 1
</str>
...
<str id="msg_updater_X">FEATURE X
</str>

For detailed information including limitations of usage, visit the SCE Web site for your region.
</pre>
:msg_updater_10 - msg_updater_60 tested to work.  they appear one after another in the same manner as the EULA.  
::Could list each feature as a seperate msg_updater_X

<pre>
Do not turn off the system during the update.  If you do, you may not be able to restart the PS3 system.  Once the update is started
you cannot go back to the previous version of the system software.

CHECKBOX Turn off System Automatically After Update

START
</pre>

:Select start to install

<pre>
Copying update data to the hard disk...
Do not turn off the system.
</pre>

<pre>
System Update

Installing...
Do not turn off the system.
After the install operation has completed, the
system will automatically restart.

PROGRESS BAR
</pre>

=== Orientation ===

 0x8002F21x - (Set Recovery Mode Flag On (cex/dex/decr)) / (Connecting Controller)
 0x8002F22x - (Connect Media containing FW equal or higher)
 0x8002F23x - (System Partition formating) / (Search Updater) 
 0x8002F24x - (Formatting)
 0x8002F25x - hdd probing
 0x8002F26x - region searching
 0x8002F27x - preparing partitions
 0x8002F28x - Setup Updating Environment
 0x8002F29x - 
 0x8002F2Ax - 
 0x8002F2Bx - (Turning Off Recovery Mode Flag)
 0x8002F2Cx - Search Updater (Formating preparing Update)
 0x8002F2Dx - (Formatting - Preparing to Update)
 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===

{| class="wikitable"
|-
! Offset !! Length !! Type !! Information
|-
| 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 * '''File Count''') || 0x20 * '''File Count''' || '''Hash Table''' || Hash Table
|-
| 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"
|-
! Offset 
! Length 
! Type 
! Information
|-
| 0x0 
| 0x8 
| unsigned long
| Entry ID
|-
| 0x8 
| 0x8
| unsigned long 
| Data Offset
|-
| 0x10
| 0x8
| unsigned long
| Data Length
|-
| 0x18 
| 0x8
| unsigned long
| Unknown
|}

===Filename IDs===

{| 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 hash entry format is:
{| class="wikitable"
|-
! Offset 
! Length 
! Type 
! Information
|-
| 0x0 
| 0x8 
| unsigned long
| File Entry ID
|-
| 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 ===
 PS3UPDAT.PUP
 ├── dots.txt
 ├── license.txt
 ├── ps3swu.self 
 ├── update_files.tar
 │   ├── BDIT_FIRMWARE_PACKAGE.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_301R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_302R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_303R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_304R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_306R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_308R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BLUETOOTH_FIRMWARE.pkg
 │   │   ├── content
 │   │   │   ├── RC29_firmware_footer.dfu
 │   │   │   ├── usb8780-5.0.1-A1-A2.dfu
 │   │   │   └── usb8781-20.0.12.0.dfu
 │   │   ├── info0
 │   │   └── info1
 │   ├── CORE_OS_PACKAGE.pkg
 │   │   ├── aim_spu_module.self
 │   │   ├── appldr
 │   │   ├── creserved_0
 │   │   ├── default.spp
 │   │   ├── emer_init.self
 │   │   ├── eurus_fw.bin
 │   │   ├── hdd_copy.self
 │   │   ├── isoldr
 │   │   ├── lv0
 │   │   ├── lv1ldr
 │   │   ├── lv1.self
 │   │   ├── lv2_kernel.self
 │   │   ├── lv2ldr
 │   │   ├── manu_info_spu_module.self
 │   │   ├── mc_iso_spu_module.self
 │   │   ├── me_iso_spu_module.self
 │   │   ├── sb_iso_spu_module.self
 │   │   ├── sc_iso.self
 │   │   ├── sdk_version
 │   │   ├── spp_verifier.self
 │   │   ├── spu_pkg_rvk_verifier.self
 │   │   ├── spu_token_processor.self
 │   │   ├── spu_utoken_processor.self
 │   │   └── sv_iso_spu_module.self
 │   ├── dev_flash_''XXX''.tar.aa.''DATE/TIME''
 │   ├── dev_flash3_''XXX''.tar.aa.''DATE/TIME''
 │   ├── MULTI_CARD_FIRMWARE.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── RL_FOR_PACKAGE.img
 │   ├── RL_FOR_PROGRAM.img
 │   ├── SYS_CON_FIRMWARE_01000006.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01010303.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01020302
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01030302.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01040402.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01050002.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01050101.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_S1_00010002083E0832.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   └── UPL.xml.pkg
 │       ├── content
 │       ├── info0
 │       └── info1
 ├── update_files.tar
 ├── update_flags.txt
 ├── version.txt
 └── vsh.tar
For a comparison between Retail and Debug firmware : [[3.55 firmware]]

=== 3.60 - 4.00 ===

 PS3UPDAT.PUP
 ├── dots.txt
 ├── license.xml
 ├── ps3swu2.self
 ├── ps3swu.self 
 ├── spkg_hdr.tar
 │   ├── BDIT_FIRMWARE_PACKAGE.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_301R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_302R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_303R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_304R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_306R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_308R.pkg.spkg_hdr.1
 │   ├── BDPT_FIRMWARE_PACKAGE_310R.pkg.spkg_hdr.1
 │   ├── BLUETOOTH_FIRMWARE.pkg.spkg_hdr.1
 │   ├── CORE_OS_PACKAGE.pkg.spkg_hdr.1
 │   ├── dev_flash_''XXX''.tar.aa.''DATE/TIME''.spkg_hdr.1
 │   ├── dev_flash3_''XXX''.tar.aa.''DATE/TIME''.spkg_hdr.1
 │   ├── MULTI_CARD_FIRMWARE.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01000006.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01010303.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01020302.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01030302.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01040402.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01050002.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_01050101.pkg.spkg_hdr.1
 │   ├── SYS_CON_FIRMWARE_S1_00010002083E0832.pkg.spkg_hdr.1
 │   └── UPL.xml.pkg.spkg_hdr.1
 ├── update_files.tar
 │   ├── BDIT_FIRMWARE_PACKAGE.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_301R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_302R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_303R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_304R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_306R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_308R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BDPT_FIRMWARE_PACKAGE_310R.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── BLUETOOTH_FIRMWARE.pkg
 │   │   ├── content
 │   │   │   ├── RC29_firmware_footer.dfu
 │   │   │   ├── usb8780-5.0.1-A1-A2.dfu
 │   │   │   └── usb8781-20.0.12.0.dfu
 │   │   ├── info0
 │   │   └── info1
 │   ├── CORE_OS_PACKAGE.pkg
 │   │   ├── aim_spu_module.self
 │   │   ├── creserved_0
 │   │   ├── default.spp
 │   │   ├── emer_init.self
 │   │   ├── eurus_fw.bin
 │   │   ├── hdd_copy.self
 │   │   ├── lv0
 │   │   │   ├── appldr
 │   │   │   ├── isoldr
 │   │   │   ├── lv1ldr
 │   │   │   └── lv2ldr
 │   │   ├── lv0.2
 │   │   ├── lv1.self
 │   │   ├── lv2_kernel.self
 │   │   ├── manu_info_spu_module.self
 │   │   ├── mc_iso_spu_module.self
 │   │   ├── me_iso_for_ps2emu.self (3.70+)
 │   │   ├── me_iso_spu_module.self
 │   │   ├── pkg.srvk
 │   │   ├── prog.srvk
 │   │   ├── sb_iso_spu_module.self
 │   │   ├── sc_iso.self
 │   │   ├── sdk_version
 │   │   ├── spp_verifier.self
 │   │   ├── spu_pkg_rvk_verifier.self
 │   │   ├── spu_token_processor.self
 │   │   ├── spu_utoken_processor.self
 │   │   ├── sv_iso_for_ps2emu.self (3.70+)
 │   │   └── sv_iso_spu_module.self
 │   ├── dev_flash_''XXX''.tar.aa.''DATE/TIME''
 │   ├── dev_flash3_''XXX''.tar.aa.''DATE/TIME''
 │   ├── MULTI_CARD_FIRMWARE.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── RL_FOR_PACKAGE.img
 │   ├── RL_FOR_PROGRAM.img
 │   ├── SYS_CON_FIRMWARE_01000006.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01010303.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01020302
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01030302.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01040402.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01050002.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_01050101.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   ├── SYS_CON_FIRMWARE_S1_00010002083E0832.pkg
 │   │   ├── content
 │   │   ├── info0
 │   │   └── info1
 │   └── UPL.xml.pkg
 │       ├── content
 │       ├── info0
 │       └── info1
 ├── update_flags.txt
 ├── version.txt
 └── vsh.tar
     └── 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 &amp; 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>

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"
|-
!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>