Skip to content

Commit

Permalink
Add usage instructions for the switch to README.md (#1)
Browse files Browse the repository at this point in the history
* Add usage instructions for the switch

* Add more context to `override_config.ini` workaround
  • Loading branch information
jeliebig authored Mar 3, 2022
1 parent 605e10f commit 8725d3b
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,31 @@ A PlayStation Vita to Horizon OS (Nintendo Switch OS) translation layer (**not**
PlayStation Vita (ARMv7 CPU) executables can be run natively on Nintendo Switch ARMv8 CPU in 32-bit execution mode.
When loading a PlayStation Vita executable, _vita2hos_ redirects the [module](https://wiki.henkaku.xyz/vita/Modules) imports of said executable to jump to routines that implement the same behavior, by using native Horizon OS services, like the one exposed by the original PlayStation Vita OS modules.

### How can I use it?

1. Copy `vita2hos.nsp` to your microSD card (i.e. to: `atmosphere/vita2hos.nsp`)
2. Create [atmosphere/config/override_config.ini](https://github.com/Atmosphere-NX/Atmosphere/blob/master/config_templates/override_config.ini) and add the following lines to it:

```ini
[hbl_config]
override_any_app=true
override_any_app_key=R
override_any_app_address_space=32_bit
; adjust the path according to the location of your file
path=atmosphere/vita2hos.nsp

```

- Note: As long as this file exists you won't be able to use the homebrew menu and instead will always run vita2hos.
A quick workaround would be to rename the file and restart your Switch.
Unfortunately `override_config.ini` doesn't allow multiple `path` entries which is why it has to be done this way.

3. Copy a PSVita `.velf` to the root of your microSD card and rename it to `test.elf`
4. Boot (or reboot) your Switch and start any game while holding down `R`
- Attempting to use `vita2hos` via applet mode (album button) will currently result in a fatal error and wouldn't be recommended anyway.
5. Enjoy!
### Special Thanks
A few noteworthy teams/projects who've helped along the way are:
* **[Vita3K](https://vita3k.org/)**
Expand Down

0 comments on commit 8725d3b

Please sign in to comment.