Editing Playstation Update Package (PUP)

[[Category:Software]]
= Extraction =
The PS VITA update files can be extracted using the "[http://www.vitadevwiki.com/index.php?title=Tools PS VITA Firmware xTractor]".

= Decryption =
To decrypt the files which are unpacked using the tool, the key is available under PS Vita Keys

= Structure =
The file structure of the Vita's PUP files is almost identical to the PS3's, although there is a slight difference in the header and the hash algorithm. For starters, whereas in PS3 the format was big-endian for the Vita it has been switched to little-endian (probably the same for all Vita formats). Also the '''Package Version''' field in Vita pups is set to 2 where in PS3 updates it was set to 1. There is also 0x50 bytes of extra data in the header and the hashes used are of a longer length than in PS3 updates (0x20 bytes in Vita vs 0x14 in PS3)

== Header ==
{| class="wikitable"
|-
! Offset !! Length !! Type !! Information
|-
| 0x0 || 0x8 || unsigned long || Magic (hex: 0x5343455546000001 ~ ASCII "SCEUF")
|-
| 0x8 || 0x8 || unsigned long || Package Version
|-
| 0x10 || 0x8 || unsigned long || Image Version
|-
| 0x18 || 0x8 || unsigned long || File Count
|-
| 0x20 || 0x8 || unsigned long || Header Length (2048, file data starts from here)
|-
| 0x28 || 0x8 || unsigned long || Package Length (size of PUP file - 8)
|-
| 0x30 || 0x50 || '''UNKNOWN''' || UNKNOWN, same for all >V1.0 files so far, maybe something for extra security? (or maybe to break a PS3 which tries to read the update)
<pre>
Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
00000030  02 00 00 00 01 00 00 00 00 00 00 00 02 00 00 00  ................
00000040  00 00 00 00 0F 00 00 00 00 00 00 00 00 00 00 00  ................
00000050  00 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
00000060  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
00000070  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
</pre>
|-
| 0x80 || 0x20 * '''File Count''' || '''File Table''' || File Table
|-
| 0x80 + (0x20 * '''File Count''') || 0x40 * '''File Count''' || '''Hash Table''' || Hash Table
|-
| 0x80 + (0x60 * '''File Count''') || 0x20 || bytes || Header Hash (unknown algo?)
|}

== File Table ==
The file table consists of a number of file entries determined by '''File Count''', with the format below (which is the same as the format in PS3 PUP1 files)

{| 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
| ngpversion.txt
|}

==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 Index
|-
| 0x8 
| 0x20
| bytes
| File Hash (unknown algo?)
|-
| 0x28
| 0x18
| bytes
| Unknown
|}


= Files =
== preinst - 01.000.000 ==
{| class="wikitable sortable"
|-
! Type !! Header !! Information !! Size
|-
| ASCII:MM.mmmm (01.500) || [none] || version.txt || 1
|-
| PSP2SWU.SELF? || SCE .ELF || binary0.self || 4536
|-
| PSP2SWU.SPRX? || SCE .ELF || binary1.self || 42
|-
|  || XML || license.xml || 451
|-
|  || SCE || package_file_0.pkg || 7904
|-
|  || SCE || package_file_1.pkg || 8130
|-
|  || SCE || package_file_2.pkg || 8196
|-
|  || SCE || package_file_3.pkg || 8196
|-
|  || SCE || package_file_4.pkg || 8196
|-
|  || SCE || package_file_5.pkg || 7883
|-
|  || SCE || package_file_6.pkg || 8052
|-
|  || SCE || package_file_7.pkg || 6943
|-
|  || SCE || package_file_8.pkg || 7758
|-
|  || SCE || package_file_9.pkg || 7805
|-
|  || SCE || package_file_10.pkg || 7804
|-
|  || SCE || package_file_11.pkg || 8005
|-
|  || SCE || package_file_12.pkg || 8103
|-
|  || SCE || package_file_13.pkg || 8084
|-
|  || SCE || package_file_14.pkg || 8066
|-
|  || SCE || package_file_15.pkg || 1661
|-
|  || SCEWM || package_file_16.pkg || 14
|-
|  || SCEAS || package_file_17.pkg || 1
|-
|}
== systemdata - 01.000.010 ==
{| class="wikitable sortable"
|-
! Type !! Header !! Information !! Size
|-
| ASCII:MM.mmmm (01.500) || [none] || version.txt || 1
|-
| PSP2SWU.SELF? || SCE .ELF || binary0.self || 4536
|-
| PSP2SWU.SPRX? || SCE .ELF || binary1.self || 42
|-
|  || XML || license.xml || 451
|-
|  || SCE || package_file_0.pkg || 2625
|-
|  || SCE || package_file_1.pkg || 4048
|-
|  || SCE || package_file_2.pkg || 2746
|-
|  || SCE || package_file_3.pkg || 3874
|-
|  || SCE || package_file_4.pkg || 4742
|-
|  || SCE || package_file_5.pkg || 4660
|-
|  || SCE || package_file_6.pkg || 3946
|-
|  || SCE || package_file_7.pkg || 4145
|-
|  || SCE || package_file_8.pkg || 4630
|-
|  || SCE || package_file_9.pkg || 5476
|-
|  || SCE || package_file_10.pkg || 4860
|-
|  || SCE || package_file_11.pkg || 4722
|-
|  || SCEWM || package_file_12.pkg || 4
|-
|  || SCEAS || package_file_13.pkg || 1
|-
|}
== full - 01.500.000 ==
{| class="wikitable sortable"
|-
! Type !! Header !! Information !! Size
|-
| ASCII:MM.mmmm (01.500) || [none] || version.txt || 1
|-
| PSP2SWU.SELF? || SCE .ELF || binary0.self || 4536
|-
| PSP2SWU.SPRX? || SCE .ELF || binary1.self || 42
|-
|  || XML || license.xml || 451
|-
|  || SCE || package_file_0.pkg || 634
|-
|  || SCE || package_file_1.pkg || 6718
|-
|  || SCE || package_file_2.pkg || 8194
|-
|  || SCE || package_file_3.pkg || 8194
|-
|  || SCE || package_file_4.pkg || 8194
|-
|  || SCE || package_file_5.pkg || 8194
|-
|  || SCE || package_file_6.pkg || 8194
|-
|  || SCE || package_file_7.pkg || 8194
|-
|  || SCE || package_file_8.pkg || 8194
|-
|  || SCE || package_file_9.pkg || 8194
|-
|  || SCE || package_file_10.pkg || 8194
|-
|  || SCE || package_file_11.pkg || 6154
|-
|  || SCEWM || package_file_12.pkg || 4
|-
|  || SCEAS || package_file_13.pkg || 1
|-
|}

= Regioning =
If simular to PS3, then there is no regioning in the .PUP files, they are the same for all different regions.<br />
The PS Vita however gets the psp2-updatelist.xml from different servers, depening on the region of that model.

Retail:
* [http://fjp01.psp2.update.playstation.net/update/psp2/list/jp/psp2-updatelist.xml Japan (jp)]
* [http://fus01.psp2.update.playstation.net/update/psp2/list/us/psp2-updatelist.xml USA (us)]
* [http://feu01.psp2.update.playstation.net/update/psp2/list/eu/psp2-updatelist.xml Europe (eu)]

11 jan 2012 :: full 01.520.000 + systemdata 01.000.010 + preinst 01.000.000:
<pre>
<update_data_list>
  <region id="jp">
    <np level0_system_version="01.520.000" level1_system_version="01.520.000" level2_system_version="01.520.000"/>
    <version system_version="01.520.000" label="01.520">
      <update_data update_type="full">
        <image size="94646272">
          http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/rel_01a72de4dd90191f679f648da8d11a48/PSP2UPDAT.PUP?dest=jp
        </image>
      </update_data>
    </version>
    <recovery spkg_type="systemdata">
      <image spkg_version="01.000.010" size="56817152">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/sd_d48c3a2ca8963ffc7ac01c73e873809c/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
    <recovery spkg_type="preinst">
      <image spkg_version="01.000.000" size="128837120">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/pre_5899e51b24eb4ab2c985df08bf6c901b/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
  </region>
</update_data_list>
</pre>

22 dec 2011 :: full 01.510.000 + systemdata 01.000.010 + preinst 01.000.000:
<pre>
<update_data_list>
  <region id="jp">
    <np level0_system_version="01.510.000" level1_system_version="01.510.000" level2_system_version="01.510.000"/>
    <version system_version="01.510.000" label="01.510">
      <update_data update_type="full">
        <image size="94500352">
          http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/rel_48ac631ecae3837a7530506de0d73eaf/PSP2UPDAT.PUP?dest=jp
        </image>
      </update_data>
    </version>
    <recovery spkg_type="systemdata">
      <image spkg_version="01.000.010" size="56817152">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/sd_52ff6b714e5f701d15938a6fee68fb66/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
    <recovery spkg_type="preinst">
      <image spkg_version="01.000.000" size="128837120">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/pre_a18a91bb8c86f8c1a101d19fcb15fb6d/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
  </region>
</update_data_list>
</pre>

14 dec 2011 :: full 01.500.000 + systemdata 01.000.010 + preinst 01.000.000:
<pre>
<update_data_list>
  <region id="jp">
    <np level0_system_version="01.500.000" level1_system_version="01.500.000" level2_system_version="01.500.000"/>
    <version system_version="01.500.000" label="01.500">
      <update_data update_type="full">
        <image size="94496256">
          http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/rel_f090a69bcf392b5c311b9e786c5cc0b5/PSP2UPDAT.PUP?dest=jp
        </image>
      </update_data>
    </version>
    <recovery spkg_type="systemdata">
      <image spkg_version="01.000.010" size="56817152">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/sd_484243f3964158b38ad1adaac0332a3e/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
    <recovery spkg_type="preinst">
      <image spkg_version="01.000.000" size="128837120">
        http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/pre_24b5601c3b3aa63b51cf5eaeab718a4c/PSP2UPDAT.PUP?dest=jp
      </image>
    </recovery>
  </region>
</update_data_list>
</pre>

Shop:
* [http://fshop01.psp2.update.playstation.net/update/psp2/list/shop/psp2-updatelist.xml shop]
* [http://fjp01.psp2.update.playstation.net/update/psp2/list/shop/psp2-updatelist.xml Japan (jp)]
* [http://fus01.psp2.update.playstation.net/update/psp2/list/shop/psp2-updatelist.xml USA (us)]
* [http://feu01.psp2.update.playstation.net/update/psp2/list/shop/psp2-updatelist.xml Europe (eu)]
<pre>
<update_data_list>
  <region id="shop">
    <np level0_system_version="00.000.000" level1_system_version="00.000.000" level2_system_version="00.000.000"/>
    <version system_version="00.000.000">
      <update_data update_type="full">
        <image>NA</image>
      </update_data>
    </version>
  </region>
</update_data_list>
</pre>

Retail basic structure of the update URL:
<pre>http://d<TLD>01.psp2.update.playstation.net/update/psp2/image/<YYYY_MMDD>/pre_<md5>/PSP2UPDAT.PUP?dest=<TLD>
(TLD=2 letter abbreviation from above region, YYYY_MMDD is release date, md5 is 22-digits long HASH)</pre>

= Revisions =

== 01.030.010 ==
SKU Release version in Japan

== 01.050.00 ==
shipped on launch gaming cards

== 01.500.000 Complete ==
14 dec 2011 <br />
Update released online together with Japanese launch
[http://www.multiupload.com/18TJMHBSQU 01.500.000 PSP2UPDAT.PUP's (266.73 MB)]

=== preinst 01.000.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/pre_24b5601c3b3aa63b51cf5eaeab718a4c/PSP2UPDAT.PUP <br />
[http://www.multiupload.com/01JB1H1OCW 1.000.000 PSP2UPDAT.PUP (122.87 MB)]

=== systemdata 01.000.010 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/sd_484243f3964158b38ad1adaac0332a3e/PSP2UPDAT.PUP <br />
[http://www.multiupload.com/DLXZASPZD0 1.000.010 PSP2UPDAT.PUP (54.19 MB)]

=== full 01.500.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1214/rel_f090a69bcf392b5c311b9e786c5cc0b5/PSP2UPDAT.PUP <br />


== 01.510.000 Complete ==
22 dec 2011 <br />
[http://www.multiupload.com/Q949J1LSL9 PSP2UPDAT.PUP's (266.74 MB)]

=== preinst 01.000.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/pre_a18a91bb8c86f8c1a101d19fcb15fb6d/PSP2UPDAT.PUP <br />
[http://www.multiupload.com/FG4NF4FEDM PSP2UPDAT.PUP (122.87 MB)]

=== systemdata 01.000.010 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/sd_52ff6b714e5f701d15938a6fee68fb66/PSP2UPDAT.PUP <br />
[http://www.multiupload.com/6FHQULTQR8 PSP2UPDAT.PUP (54.19 MB)]

=== full 01.510.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2011_1222/rel_48ac631ecae3837a7530506de0d73eaf/PSP2UPDAT.PUP <br />
[http://www.multiupload.com/M6Z7RTV6PU PSP2UPDAT.PUP (90.12 MB)]


== 01.520.000 Complete ==
11 jan 2012 <br />
[http://www.multiupload.nl/1MP31MOCON PSP2UPDAT.PUP's (266.88 MB)]

=== preinst 01.000.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/pre_5899e51b24eb4ab2c985df08bf6c901b/PSP2UPDAT.PUP <br />
[http://www.multiupload.nl/YR9P2Z46XJ PSP2UPDAT.PUP (122.87 MB)]

=== systemdata 01.000.010 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/sd_d48c3a2ca8963ffc7ac01c73e873809c/PSP2UPDAT.PUP <br />
[http://www.multiupload.nl/JNP49YVH57 PSP2UPDAT.PUP (54.19 MB)]

=== full 01.520.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0111/rel_01a72de4dd90191f679f648da8d11a48/PSP2UPDAT.PUP <br />
[http://www.multiupload.nl/OCVVKRFPBA PSP2UPDAT.PUP (90.26 MB)]


== 01.600.000 Complete ==
8 feb 2012 <br />
[fill here]

=== preinst 01.000.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0206/pre_fb565f82d66bbd1ac9dbc2ddb1c62cdf/PSP2UPDAT.PUP <br />
[fill here]

=== systemdata 01.000.010 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0206/sd_49299e94ebc7c040b6e0a2d2a7f6ddcc/PSP2UPDAT.PUP <br />
[fill here]

=== full 01.600.000 ===
http://djp01.psp2.update.playstation.net/update/psp2/image/2012_0206/rel_5e9c9bc4f434db1401d30ec41c174ab9/PSP2UPDAT.PUP<br />
[fill here]