Editing PARAM.HIS

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

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:
[[Image:PARAMHIS_Changelog.png|200px|thumb|right| ]]
== Description ==
== Description ==


This file is used to display the changelog texts of a HDD game (category '''HG'''), game patches (category '''GD''' with '''APP_VER'''), and gamedata (category '''GD''' without '''APP_VER''').
This file is used to describe the update history (display on xmb under options of the game or game data utility)
Texts are displayed under the option "'''Update History'''" when pressing triangle over his icon.
Game example:  
 
*HATSUNE MIKU Project Diva - Dreamy Theater (update 1.01 of the PS3 PSN side)
Others category : Option not available on XMB but text is displayed during download.
*Catherine BLJM60215 (Japanese version) update 1.01
 
PARAM.HIP files are the "source" file, contained in the root of a Install_Package.pkg. When the package is installed the  system adds at the beggining of the "source" file 10 bytes containing his timestamp (date and time when is installed), and copyes it in the install folder as PARAM.HIS.
 
PARAM.HIS files can be updated by consecutive installations of more .HIP files over the same old .HIS file, this adds the same structure severall times separated by his timestamps and a blank row when displayed in XMB.


Severall PARAM_'''xx'''.HIP files can be included in a .pkg for different [[Content_Information_Files#Languages|languages]] by adding a number to the end of the filename (e.g. PARAM_'''16'''.HIP for polish language), the system will install only the one that matches the language settings of the user, or the default PARAM.HIP if no other is applicable.
Location : same as PARAM.SFO (folder game)


By adding a PARAM.HIS inside a .PKG (this is not the standard way how its supposed to work) the system manages the file as any "normal" file and copyes it to the install folder without making any file conversion neither updating his timestamp, this can be used to add it to the first release of a homebrew
Relation with PARAM.SFO : independent from Title_ID or version but need to be under PS3 game category


*'''Game examples''' (using PARAM.HIP)
Relation with PARAM.HIS : Generated from PARAM.HIP by ps3 (after unpkg)or first boot of the game/ homebrew, overwrite, add infos (such as ) and convert it (to Shift JIS).
**HATSUNE MIKU Project Diva (NPJB00047) - patch 1.01
**Catherine (BLJM60215) - patch 1.01


(there are others more recents but the two above give the different diplays: Catherine .HIP is display on Game Data utility and Hatsune .HIP is diplay on game folder.
Both PARAM.HIS & PARAM.HIP can be language specific (e.g. PARAM_'''16'''.HIS for polish language) by adding a number to the end of filename from this list [[Content_Information_Files#Languages]]


*'''Homebrew examples''' (using PARAM.HIP)
==Internal Structures==
**None yet


*'''Homebrew examples''' (using PARAM.HIS)
===PARAM.HIP===
**Paintown 3.5 by Markus95
**Solar 4.1 by Condorstrike


== Internal Structures ==
This structure is repeated several times inside the file, one time for each text row, the controll byte "'''0A'''" displaces text to the next row
 
=== PARAM.HIP ===
 
This structure is repeated several times inside the file, one time for each text row, the controll byte "'''0A'''" displaces text to the next row.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Description !! Length !! Example !! Conversion !! Example Converted !! Notes
! Description !! Lenght !! Example !! Conversion !! Example Converted !! Notes
|-
|-
| Text Line || variable || 52 6F 77 20 31 || utf-8 || Row 1
| Text Line Nº1 || variable || 48 69 20 3A 29 || utf-8 || Hi :)
|-
|-
| Line Feed || 1 byte || 0A || || ||Control byte to break the text line
| Line Feed || 1 byte || 0A || None || ||Control byte to break the text line
|-
|-
|}
|}


=== PARAM.HIS ===
===PARAM.HIS===
 
This structure is repeated severall times inside the file ?... if so... the counter increases ?
This structure is repeated severall times inside the file, one time for each PARAM.HIP included in the file.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Description !! Length !! Example !! Conversion !! Example Converted !!Notes
! Description !! Lenght !! Example !! Conversion !! Example Converted !!Notes
|-
|-
| Timestamp Mark || 1 byte || 01 || || || Marks the start point of a Timestamp
| Counter ? || 1 byte || 01 || Decimal || 1 || needs confirmation
|-
|-
| Timestamp || 8 bytes || 00 00 00 00 4E F6 59 70 || Decimal ---> Unix time || 1324767600 ---> 2011/12/25 00:00 ||
| timestamp || 8 bytes || 00 00 00 00 4E F6 59 70 || Decimal ---> Unix time || 1324767600 ---> 2011/12/25 00:00 ||
|-
|-
| PARAM.HIP Mark || 1 byte || 02 || || || Marks the start point of a PARAM.HIP
| Unknown || 1 byte || 02 || || ||
|-
| PARAM.HIP || variable || || || || raw PARAM.HIP
|-
|-
| PARAM.HIP || variable ||  ||  || || Raw PARAM.HIP
|}
|}


Hexadecimal to Decimal online [[http://www.disfrutalasmatematicas.com/numeros/binario-decimal-hexadecimal-conversor.html conversor]]
Hex to binary online [[http://www.disfrutalasmatematicas.com/numeros/binario-decimal-hexadecimal-conversor.html conversor]]
 
Decimal to Unix Timestamp online [[http://www.timestampconvert.com conversor]]
 
Example of a "hand made" [[http://www.sendspace.com/file/chvymx PARAM.HIS]] that simulates 3 patches with 3 text rows each, installed in 3 different years, usefull to copy-paste it inside an installed patch folder (GD category) or a game (HG category) to understand how the .HIP's are cummulated inside a .HIS
 
== ASCII art ==
[[Image:PARAMHIS_ASCII_art.png|200px|thumb|right| ]]
Because there are a lot of text rows availables it can be made ASCII pictures and logos, the trick here is to first use some online ASCII converter like [[http://www.network-science.de/ascii/ this one]]
. The output text of this conversors will not be displayed correctly in PS3 XMB


There is needed to represent this text in the PC using the official fonts from the firmware (US/Europe fonts are in the path '''dev_flash\data\font\SCE-PS3-RD-R-LATIN.TTF''').
Timestamp online [[http://www.timestampconvert.com copnversor]]


Install this font in the PC, open some image or text editor (like photoshop or gimp), paste the text and correct the widths by adding spaces to display it properly.


Example of a "hand made" [[http://www.sendspace.com/file/dbze2k PARAM.HIS]] with the '''PS3DEV''' logo and a strange guy under it '''o0'''.


== Tools ==


'''HIP2HIS from Deroad''': This app simply convert a PARAM.HIP file to PARAM.HIS
http://www.mediafire.com/?rv6jajz3nfy53iw


'''make_his by jjolano''': Generates a PARAM.HIS file from a Unix-formatted text file https://github.com/jjolano/make_his




{{File Formats}}<noinclude>[[Category:Main]]</noinclude>
== Cryptography==
None?
Please note that all contributions to PS3 Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PS3 Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)

Templates used on this page:

Retrieved from "http://www.psdevwiki.com/ps3/PARAM.HIS"