Editing Filesystem

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 11: Line 11:
* ipl - Initial Program Loader
* ipl - Initial Program Loader
* irda0 - Infrared Port (Not present in PSP 2000)
* irda0 - Infrared Port (Not present in PSP 2000)
* idstorage - Contains the IDStorage keys specific to the PSP hardware. Damage to the keys can result in homebrew and UMDs no longer running.<br />
* idstorage - Contains the IDStorage keys specific to the PSP hardware. Damage to the keys can result in homebrew and UMDs no longer running.
<br />
<br />
 
The filesystem contains many media which can be accessed. Some media should never be wrote to, as it could brick the system like the risk using kernel mode has. With kernel mode, the media restricted here will not be talked about, but told what should be restricted.
 
== Pathing Conventions ==
The PSP is more unix-like than when it comes to paths. The general path convention has forward slashes "/" to delimit protocols, directories, and files. Everything should be uppercase, likewise, any file or directory will be referenced despite it's capitalization - it is not case sensitive. This means "BIN" is "bIN" as well as "bIn". It would make sense to keep everything uniform and uppercase it following this rule, so it is best practice to make files and folders uppercase.
 
=== Protocol ===
A protocol determines the medium in which is being referenced. There are quite a few media in which there is ability to reference. Below are a list of the common ones that are safe to use.
* umd0:/ - a UMD disc
* ms0:/ - the memory stick
* disc0:/ - a UMD disc
 
Stay away from
* lflash:/
* flash0:/
* flash1:/
 
== The Memorystick Root ==
The root of the memory stick is the base of all the folders. In windows, this is commonly your C:/ drive. However, with the PSP it is the memorystick. The memorystick may list as any protocol when plugged into your computer. Depending on your [[w:Plug_and_play|PNP]] settings, it may not mount and will have to be mounted manually.
 
This is a list of default folders in your memory stick with firmware 6.60 PSP 1000 CFW.
* MP_ROOT
** 100MNV01
** 101ANV01
* MUSIC
* PICTURE
* PSP
** COMMON
** GAME
** RSSCH
** SAVEDATA
** SYSTEM
*** BROWSER
*** INFOBOARD
**** TEMP
***** IMAGE
** THEME
* VIDEO
 
The root would be the first level of folders. Inside of those folders aren't the root anymore and colloqiually change to 'the GAME folder root', pertaining to anything in the PSP/GAME folder.
 
== PPSSPP Memstick ==
Since PPSSPP 1.4, fixes have been made to make homebrew easier to test. Placing the folder containing the project inside of PPSSPP/Memstick/PSP/GAME will result in the correct argument passed to main() (ms0:/PSP/GAME/APPLICATION/EBOOT.PBP) instead of umd0:/. The latter path is to support ISO PBP and PS1 games. This means it is possible to emulate a UMD on PPSSPP, but in order to do it on a real PSP, CFW or a signed PBP must be present. Below is a list of default PPSSPP folders, which differs from the PSP initially.
* MUSIC
* VIDEO
* PICTURE
* PSP
** COMMON
** GAME
** SAVEDATA
** SYSTEM
 
== Absolute Paths ==
An absolute path includes a protocol which directly links, through all paths, to a file or directory. Absolute links are the most secure in that they point to a location no matter where the Current Working Directory (CWD) is. It is recommended to use an absolute path when necessary.
 
Example Paths
* umd0:/FOLDER/file.txt
* ms0:/PSP/GAME/APPLICATION/EBOOT.PBP
* ms0:/MUSIC/HomeBySafia.mp3
 
== Relative Paths ==
A relative path takes the CWD and builds the path based on it. For example, if the current working directory is ms0:/PSP/GAME/APPLICATION, a relative path could reference GAME/OTHER_APPLICATION. To do this uses a series of double periods to denote previous directory, however, it is not necessary to use previous directories with this method as it builds off the CWD too. This means ms0:/PSP/GAME/APPLICATION could be the CWD and to reference a folder inside called FILES, all there needs to be is /FILES.
 
Example Paths Filesystem (ms0:/)
* MUSIC
* PSP
** GAME
*** APPLICATION
**** FILES
*** OTHER_APPLICATION
**** FILES
**** DATA
 
Example Paths for CWD (ms0:/PSP/GAME/APPLICATION)
* /FILES
* ../OTHER_APPLICATION
* ../OTHER_APPLICATION/FILES
* ../OTHER_APPLICATION/DATA
* ../../../MUSIC
 
== Path Concatenation ==
One common trick is to use the literal concatenation strategy, which has the counterpart to where you malloc or calloc some memory, and do the string concatenation there - using dynamic memory. The literal concatenation is not on the dynamic memory and on the automatic stack.
 
Malloc/Calloc avoiding literal concatenation
<pre>
// make some zero terminated literals
#define abc "abc"
#define onetwothree "123"
 
// concat them by specifying variable
const char* abc_onetwothree = abc onetwothree;
printf(abc_onetwothree); //> abc123
</pre>
 
== Throwing It All Together ==
Absolute paths are the way to go. Messing with CWD in PSP is a bit cumbersome. It is even more cumbersome when detecting the medium the EBOOT.PBP came from. As stated in [[PSP_Development/Hello_World_Application#PSP_main.c_Body|Hello World Application]], the parameter passed to main() will tell you the absolute path to the EBOOT.PBP. A better way than to substring this and build off of it is using [[#Path_Concatenation|Path Concatenation]]. This makes for absolute paths easy. The problem would be the folder's name is dependent on the user not editing the name.
 
Example
<pre>
#define TITLE "APPLICATION"
#define ROOT "ms0:/PSP/GAME/" TITLE "/"
</pre>
 
Doing this method also enables placing the TITLE macro inside of the PSP_MODULE_INFO() function. If emulating a UMD, the path would be umd0:/ instead of directly from memstick (ms0:/).
 
== Current Working Directory ==
The PSP has concept of the [[w:Working_directory|current working directory]] (CWD). This is always the boot location of the PBP file. While emulating a UMD, the CWD is the root folder inside the EBOOT.PBP, which is umd0:/. In order to set the CWD, PSPDEV provides the function sceIoChdir(). sceIoChdir() takes in a const char* that points to the new path to be the CWD. Once set, it is unknown to read back the CWD using the provided sceIo* functions. Such a function is found in unistd.h as getcwd() and in windows.h as _getcwd().
Please note that all contributions to PSP Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PSP 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)
Retrieved from "http://www.psdevwiki.com/psp/Filesystem"