2020-04-14 12:49:43 +01:00
|
|
|
# emuMMC
|
2021-09-17 00:52:08 +01:00
|
|
|
*A SDMMC driver replacement for Nintendo's Filesystem Services, by **m4xw***
|
2020-04-14 12:49:43 +01:00
|
|
|
|
|
|
|
|
### Supported Horizon Versions
|
2021-10-26 09:08:37 +01:00
|
|
|
**1.0.0 - 13.1.0**
|
2020-04-14 12:49:43 +01:00
|
|
|
|
|
|
|
|
## Features
|
2021-09-17 00:52:08 +01:00
|
|
|
* Arbitrary SDMMC backend selection
|
2020-04-14 12:49:43 +01:00
|
|
|
**This allows loading eMMC from SD or even SD from eMMC**
|
2021-09-17 00:52:08 +01:00
|
|
|
* On the fly hooking / patching, fully self-infesting
|
2020-04-14 12:49:43 +01:00
|
|
|
**Only one payload required for all versions!**
|
2021-09-17 00:52:08 +01:00
|
|
|
* File-based SDMMC backend support (from SD)
|
2020-04-14 12:49:43 +01:00
|
|
|
**This allows loading eMMC images from hekate-backups (split or not)**
|
2021-09-17 00:52:08 +01:00
|
|
|
* SDMMC device based sector offset (*currently eMMC only*)
|
2020-04-14 12:49:43 +01:00
|
|
|
**Raw partition support for eMMC from SD with less performance overhead**
|
2021-09-17 00:52:08 +01:00
|
|
|
* Full support for `/Nintendo` folder redirection to a arbitrary path
|
2020-04-14 12:49:43 +01:00
|
|
|
**No 8 char length restriction!**
|
2021-09-17 00:52:08 +01:00
|
|
|
* exosphere based context configuration
|
2020-04-14 12:49:43 +01:00
|
|
|
**This includes full support for multiple emuMMC images**
|
|
|
|
|
|
|
|
|
|
## Compiling
|
|
|
|
|
### hekate
|
|
|
|
|
Run `./build.sh` and copy the produced kipm (Kernel Initial Process Modification) file to `/bootloader/sys/`
|
|
|
|
|
|
|
|
|
|
### Atmosphere
|
|
|
|
|
Run `make`, the resulting kip can be used for code injection via fusee (place at `/atmosphere/emummc.kip`)
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
**emuMMC is released as GPLv2**
|
|
|
|
|
|
|
|
|
|
## Credits
|
|
|
|
|
* **CTCaer** - The CTCaer hekate fork, file-based emuMMC support, SDMMC driver fixes among other things
|
|
|
|
|
* **SciresM, hexkyz** - The Atmosphere project, FS offsets, additional research related to newer FS versions
|
|
|
|
|
* **naehrwert** - The hekate project, its SDMMC driver and being very helpful in the early research phase
|
|
|
|
|
* **jakibaki** - KIP Inject PoC, used in the early dev phase
|
|
|
|
|
* **switchbrew/devkitPro** - devkitA64 and libnx sources
|
