Atmosphere/emummc/README.md
2023-02-21 15:33:33 -07:00

1.5 KiB
Vendored

emuMMC

A SDMMC driver replacement for Nintendo's Filesystem Services, by m4xw

Supported Horizon Versions

1.0.0 - 16.0.0

Features

  • Arbitrary SDMMC backend selection
    This allows loading eMMC from SD or even SD from eMMC
  • On the fly hooking / patching, fully self-infesting
    Only one payload required for all versions!
  • File-based SDMMC backend support (from SD)
    This allows loading eMMC images from hekate-backups (split or not)
  • SDMMC device based sector offset (currently eMMC only)
    Raw partition support for eMMC from SD with less performance overhead
  • Full support for /Nintendo folder redirection to a arbitrary path
    No 8 char length restriction!
  • exosphere based context configuration
    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