[RCM Payload] Hekate - CTCaer mod

Discussion in 'Switch - Exploits, Custom Firmwares & Soft Mods' started by CTCaer, May 1, 2018.

  1. CTCaer
    OP

    CTCaer GBAtemp Advanced Fan

    Member
    9
    Mar 22, 2008
    Greece
    Hekate - CTCaer mod v3.2

    * Hekate is a Bootloader
    with fw patching, recovery tools and many more features. *

    * hekate or Εκάτη (in Greek) is a goddess in ancient greek religion and mythology. *
    * She was one of the main deities worshiped in Athenian households as a protective goddess and one who bestowed prosperity and daily blessings on the family. *
    * Here, it blesses your Nintendo Switch. *


    * CFW Launching for ALL current updates (1.0.0, 2.X, 3.X, 4.X, 5.X)
    * Auto boot
    * Full Atmosphère support w/Exosphère booting
    * Automatic RAW eMMC partial dumping
    * Restore eMMC

    * Working Sleep Mode on ALL firmware.
    * And many more



    [​IMG]



    Before you continue:
    Hekate - ipl, is a custom bootloader with extra features.
    It must not be confused with CFW, hbmenu and anything else that is on the Horizon OS (Switch's OS) side.
    E.g., hekate supports exFAT formatted sd cards, but if you never downloaded the exFAT update, it will not work on horizon os or any homebrew.
    So, please don't report problems that happen after leaving hekate - ipl (hbmenu can't see apps, etc).



    Summary:
    CTCaer mod is based on naehrwert's hekate - ipl. hekate is basically a custom Nintendo Switch bootloader with many advanced features.
    It supports all sd cards (except SDSC) and automatically chooses if it will dump in parts or not, based on your free space and sd card filesystem.
    Supports CFW launching in the following Switch updates (all current):
    • 1.0.0
    • 2.X.X (all)
    • 3.X.X (all)
    • 4.X.X (all)
    • 5.X.X (all)
    Comes with many additional features. For example you can see your SoC's fuses, eMMC info, SD card info, etc.



    Features guide:

    [​IMG]
    • Launch firmware
      Used to launch CFW. This CFW is actually Atmosphere.

      There's only one type of release currently.
      That one, is used to launch any hbmenu or any homebrew with the filename hbmenu.nro through Album icon.
      Check for @tomGER 's sdfiles.zip
      Replace the hbmenu.nro with the one provided here or with the latest version.
    [​IMG]
    • Launch options
      This lets you configure the auto boot options
      • Auto boot
        [​IMG]
        Let's you choose which CFW to autoboot.
      • Boot time delay
        [​IMG]
        Wait time on boot to allow you to enter bootloader menu by pressing VOL- (not volume up. It's volume down).
      • Custom boot logo
        Enable the use of a custom boot logo when auto booting.
        If a log is specified in the selected boot entry, it will be used
        If not or the logo was not found, bootlogo.bmp will be used.
        If nothing is found or custom boot logo is disabled, hekate's built in logo will be used.
    -------------------------------------

    [​IMG]

    Notice
    : All the backup/restore functions support verification.
    That means, that when the bar turns green, hekate checks that the sd card written data and the eMMC data match.


    [​IMG]

    Verification options:

    As described above, this are the options for your backup and restore verification.
    You can disable it here if you want. Default is Full.
    Sparse: Only checks 4 bytes every 128Bytes. This is normally enough for block errors.
    Full: It creates sha256 hashes of your sd backup and eMMC data and compares it byte to byte.


    [​IMG]

    Backup eMMC BOOT0/1 (important!):
    This will backup the physical eMMC partitions BOOT0 and BOOT1. These are needed to complete your eMMC full backup.


    Backup eMMC RAW GPP (important!):
    Let's you backup the whole general purpose partition from your Switch's eMMC. This includes Switch system and user files.
    It's one of the 4 physical partitions that your eMMC has. The other are BOOT0, BOOT1 and RPMB (unused).
    Because the whole GPP is 29.1 GiB (31,268,536,320 B), there several automatic ways to back it up.

    1. Using exFAT formatted sd card which is 32GiB* and up:
    (* Some 32GB cards have less available free space than 29.1 GiB, so they may trigger partial backup)
    This will backup the whole physical partition as one big file.


    Troubleshooting when error occurs:
    There are some cases that your sd card will spit errors, either because of bad sectors, or bad I/O. In these cases from v1.5 and up, it will show a specific error, which you need to right it down to find out why.
    Sometimes though it can't be fixed.
    In these cases you can force partial backup, by creating a new file called partial.idx. You have to open it in a HEX editor and write these exactly hex values: 00 00 00 00 (the red is the LSB, because Little-endianess).
    The next time you'll try to run Backup eMMC RAW GPP, it will backup in parts of 2GB.
    (This specific file is attached here, if you have difficulties with hex editors. Just rename it from .idx.txt to .idx.)


    2. Using a FAT32 or an exFAT with smaller space than 29.1GiB:
    This will trigger the automatic partial backup.
    In this mode it will start backing up in 2GB parts or in 1GB if you have 8GB and smaller card.
    It backups your eMMC, until it fills your card. It also uses a file called partial.idx, so it know which is the next part to backup.
    When this is done you will see a similar message like the following procedure:
    1. After the session is done, press any key and Power off or Reboot rcm (if you want to skip step 3) Switch from the main menu
    2. Move the files from SD card to your PC to free some space
      Don't move the partial.idx file! This file, keeps tabs on which is the next part to backup.
    3. Unplug and re-plug USB while pressing Vol+ (skip if you rebooted into rcm from hekate's main menu)
    4. Run hekate_ctcaer_1.5.1.bin again and press Backup eMMC RAW GPP to continue with the next parts.
    5. Repeat steps 1-4 until you have 15 2GiB or 30 1GB files
    6. Join the files with your favorite cmd/app or use the scripts provided
    For step 6, there are also scripts inside a zip, provided in the download link below. Choose the correct one based on the parts size (15 x 2GB or 30 x 1GB) and based on your OS.
    Notice 1: Users that have a 8GB SD card and less, it will automatically backups with 1GB parts.
    Notice 2: If you have an unfinished partial backup and want to start anew, delete the partial.idx file first.
    Warning: When backing up the eMMC, in parts, you should not power on the switch normally and boot to Switch OS before done. Otherwise your finished backup will probably corrupt, because Switch OS writes on your eMMC even if it seems you done nothing.


    Troubleshooting when error occurs (write it down for better support):
    In this mode, it's easier to skip the problematic area of your sd card.
    1. First try to run Dump RAW eMMC again right away. It will try to continue from the last part it was trying to backup.
    2. If this does not work, move the already backed up files to your PC, without deleting/moving the partial.idx file.
    3. Run Backup eMMC RAW GPP again, and it will start backup.
    You may hit these problematic SD card areas. In this case, rinse and repeat the above steps, with always keeping the partial.idx file as it is.

    Notice on errors: If the errors persist, try to do a low level (full) format or try to run chkdsk /f /r /x Z: (where Z is your drive letter).


    Backup eMMC SYS
    (uneeded if you already backed up the RAW eMMC):
    The General Purpose physical partition, contains several GPT partitions.
    By using this option, you can backup all these partitions, except USER, as separate files.


    Backup eMMC USER (uneeded if you already backed up the RAW eMMC):
    As described above, this will backup the USER partition from your eMMC's General Purpose partition.




    [​IMG]

    Restore eMMC RAW GPP (Dangerous!):
    Do not use that if you don't know what you are doing! No one is responsible for messing with your device.
    You have a 10 second mandatory wait time before letting you start restore by pressing POWER.

    This let's you restore your eMMC general purpose partition. If hekate find the /Backup/Restore/rawnand.bin it will restore it and verify it.
    If it does not find it, it does nothing.
    For now only exFAT is supported. No partial restoring.


    Restore eMMC BOOT0/1 (Dangerous!):
    Do not use that if you don't know what you are doing! No one is responsible for messing with your device.
    You have a 10 second mandatory wait time before letting you start restore by pressing POWER.

    This let's you restore your eMMC BOOT0 and BOOT1 partitions.
    It will only restore the files at /Backup/Restore/BOOT0 and /Backup/Restore/BOOT1.
    If a file does not exists, it will be skipped.


    Restore eMMC GPP partitions (Dangerous!):
    Do not use that if you don't know what you are doing! No one is responsible for messing with your device.
    You have a 10 second mandatory wait time before letting you start restore by pressing POWER.

    This let's you restore your eMMC GPP partitions.
    It restores only the files found in /Backup/Restore/Partitions/*
    Any file that is not found, it is skipped.
    The USER partition requires exFAT.


    -------------------------------------


    Dump package1/2:
    This will dump and decrypt package1 and package2 from BOOT0 and BCPKG2-1-Normal-Main. It will also extract from it the secure monitor, warmboot, INI1 and kernel binaries.
    The above feature is intended for developer use.


    Fix SD files attributes:
    DON'T use that until v3.1 comes out.
    Apparently some users have problems with it. If you done it and have problems, you have to set the archive bit on Nintendo folder and all its content.
    This disables the archive bit in all sd card files.
    If you have problems with homebrew not showing up, use this.


    Fix battery de-sync:
    This fixes the low battery monitor missconfiguration at PMIC max77160, produces by linux builds.
    The fix is instant and you can just boot into Horizon OS after that.


    AutoRCM (Dangerous!):
    The AutoRCM, also known as briccmii, it is based on @Reisyukaku AutoRCM v2 and it smartly corrupts the boot configuration in BOOT0 partition.
    This allows the user to always boot/reboot into RCM, without the need of a jig.
    Because it writes to the eMMC, it is considered a dangerous operation and must be used with caution and only if needed.
    Warning: The various auto rcm solutions are incompatible between them.
    That means, that if you used AutoRCM v2, you need to use the same again to restore it back. Not another solution.


    -------------------------------------

    [​IMG]

    Print fuse info:
    This will print your Tegra X1's fuses on your screen (plus your burnt fuses).
    It also includes an option to dump them on the sd card, so you can examine them easier.


    Print kfuse info:
    This will print your Tegra X1's kfuses on your screen.
    It also includes an option to dump them on the sd card, so you can examine them easier.


    Print TSEC keys:
    This will print your Tegra X1's security co-processor's keys on your screen.


    Print eMMC info:
    This will print your eMMC info.
    You can see many things, like maximum speed allowed, manufacturer and model, all the physical partitions,all the GPT partitions, etc.


    Print SD Card info:
    This will print your current SD Card info.
    You can see many things, like maximum speed classes and speed grades allowed, manufacturer and model, total user space, free space, cluster size, etc.


    Print battery info:
    Lot's of info about your Battery Charger IC and Fuel Gauge IC.


    -------------------------------------
    • Reboot (normal)
      Reboot normally, without any mods and CFW
    • Reboot (rcm)
      Reboot into Recovery mode again. Useful if you want to run another payload or you want to remove your sd card.
    • Power off
      Powers off the console.
      When this is used, it's better to remove any sd card with homebrew/CFW/eMMC files and reboot into Horizon OS.
    • About
      Displays info about this payload.

    Warning:
    Don't forget your console into RCM. This will drain your battery without a cable. And because, it does not have a battery cuttoff, it will completely drain it.
    If this happens, you should power off (if it didn't all ready) your console, and let it charge into normal mode (red battery icon top-left) for 20-30 minutes, to open. Better remove the sd card, if it has payloads/homebrew/eMMC files, because it will boot into Horizon OS.



    Changelog:
    v3.2:

    • Fixed sleep mode for 3.0.0 - 3.0.2
    • Add status bar with battery info
      Now you can always see your battery when into a time-consuming backup/restore.
    • Add background color support from bitmap's first pixel
      If your logo is smaller than 720x1280, it will now use the first pixel as background color, instead of dark grey.
    • Add dumping of package2
    • Unset archive bit to all sd card files re-added
      Now it does not touch Nintendo folder. Keep in mind that this can mess with some homebrew.
    • Fixed an issue with a non-working firmware launching when "Dump package1" was used before.
    • Changed partial backup message to inform about the sd card unmounting when in a menu.
    • Some small bugfixes.

    v3.1:

    • Implement millisecond timer
      This is a must and a very important feature, because we expect to use the bootloader more than 71 minutes (Backup/Restore). This has the side-effect of fixing a lot of stuff. Especially on SDMMC operations.
      If you had problems with read/write/verify on eMMC or SD, the new version is a must.
    • Fix the verification code at last!
      Another side-effect of using a 32bit ms timer (from the μs original one). Plus the additional fixes to variables that could not fit in u32 storage, makes the fix completely. Thanks to all the testers that helped to tackle these dreaded bugs.
      Better redo that backup!
    • The Fusée patches for 4.X are now fixed
    • The sd files archive bit removal tool, now only applies to switch folder

    v3.0:

    • Auto boot
      with hekate logo or custom logo support
      When enabled, press VOL- to go into the bootloader menu
    • Full Atmosphère support w/Exosphère boot
      It can now properly boot through Exosphère.
    • Completely fix Backup & Restore Verifying algorithm
      Better do a new backup to make sure.
    • Restore options
      You can now restore your BOOT0/1, GPP physical partitions and all GPP partitions. Individually. Read the warning!
    • Configuration
      Support configuration loading and saving
    • Add Battery charger and Fuel gauge info
    • Support styling in hekate .ini file
    • Add battery "de-sync" fix
    • Add Fix sd files attributes
    • Show battery stats in menu
    • Raise sd card power limit for faster transfer speeds
    • Update FatFS to 0.13b /w hotfix
    • Other features that I forgot. Check commit log
    • Countless (really!) bugfixes, memory leak fixes and general fixes
    Warning: The restore options are DANGEROUS! Do not use that if you don't know what you are doing!
    No one is responsible for your actions!

    v2.3:

    • Sleep mode now works on 1.0.0-2.3.0, 4.0.0-5.1.0

    v2.2:

    • Added Disable SVC verification for 5.X.X kernel patch (enabled by using fullsvcperm=1 in hekate ini)
    • Better support for SDR50 sd card speed (mitigates a T210 hardware bug)
    • Fixed a bug with scrambled tex
    • And many other bugfixes

    Old Changelog:
    Warning: Spoilers inside!



    Download v3.2



    In windows, you can then use rajkosto's biskeydump and HacDiskMount to manipulate your raw eMMC dump.

    Thanks:
    naehrwert for the original code: http://github.com/nwert/hekate
    @rajkosto for his hekate - ipl commits and tools: http://github.com/rajkosto/
    And all other contributors in hekate repo.
     

    Attached Files:

    Last edited by CTCaer, Jul 9, 2018
    Kvac, Benman93, Mike15678 and 86 others like this.
  2. Taffy

    Taffy AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

    Member
    4
    Mar 3, 2017
    United States
    Student
    Ah....this is clever! But how do you consolidate/re-join the parts afterwards?
     
  3. DSpider

    DSpider GBAtemp Advanced Fan

    Member
    4
    Mar 14, 2015
    Romania
    A better question would be is there a way to restore it?
     
  4. CTCaer
    OP

    CTCaer GBAtemp Advanced Fan

    Member
    9
    Mar 22, 2008
    Greece
    Check OP, I've added a simple solution.
    You can still use whatever filer joiner exists though.
     
    Taffy likes this.
  5. Taffy

    Taffy AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

    Member
    4
    Mar 3, 2017
    United States
    Student
    iirc we only are able to dump things at this point.

    And if you're concerned about restoring things then you probably shouldn't be screwing with the console in the first place.

    edit: ninja'd

    I like it! Saves me a little money so I don't need to buy a bigger card!

    still will probably get one though
     
    Last edited by Taffy, May 1, 2018
  6. TheZander

    TheZander King of the Level 7's

    Member
    8
    Feb 1, 2008
    United States
    Level 7
    What's the firmware patching functionality of this?
     
  7. CTCaer
    OP

    CTCaer GBAtemp Advanced Fan

    Member
    9
    Mar 22, 2008
    Greece
    You can replace various firmwares and functions with your own.
     
  8. rajkosto

    rajkosto GBAtemp Fan

    Member
    6
    Apr 6, 2017
    if you have enough space on your microSD for all of USER you should probably use mine, this one seems a LOT hackier.
     
    CymraegAce and CTCaer like this.
  9. sweetlilmre

    sweetlilmre Member

    Newcomer
    3
    Aug 15, 2010
    The instructions state "Warning: When dumping the USER partition, you should not power on the switch normally before done. Otherwise the USER contents will change."

    Why would reading the contents change the partition?

    -(e)
     
  10. aut0mat3d

    aut0mat3d GBAtemp Regular

    Member
    2
    Mar 15, 2017
    Australia
    If only one bit is written to the Filesystem which you are currently dumping xou have good chances to have it corrupted.
    And you are reading it in parts...
     
    CTCaer likes this.
  11. tecfreak

    tecfreak GBAtemp Regular

    Member
    2
    Apr 24, 2018
    Germany
    Berlin
    How do you know that it only reads from this partition?
     
  12. sweetlilmre

    sweetlilmre Member

    Newcomer
    3
    Aug 15, 2010
    If the warning means the dump would be corrupted then that makes sense. The wording was ambiguous.

    -(e)
     
  13. sweetlilmre

    sweetlilmre Member

    Newcomer
    3
    Aug 15, 2010
    Because I looked at the code and writing to the partition when dumping would be insane?

    -(e)
     
  14. aut0mat3d

    aut0mat3d GBAtemp Regular

    Member
    2
    Mar 15, 2017
    Australia
    That is the key, yes.
    I see no reason why the dumper should write to emmc. This would be verry dangerous and there is no reason to do so
     
  15. tecfreak

    tecfreak GBAtemp Regular

    Member
    2
    Apr 24, 2018
    Germany
    Berlin
    ^^
    The warning says that you shouldn't boot into the OFW while you are dumping your user partition in the case when you need to restart the system because you have not enough space on your sd card for a complete dump.

    Got it now?
     
    CTCaer likes this.
  16. CTCaer
    OP

    CTCaer GBAtemp Advanced Fan

    Member
    9
    Mar 22, 2008
    Greece
    Because booting to Switch OS writes to the user partition.
    And that may render your unfinished backup corrupted, because one part of it changed.

    This tool does not write to your emmc by any means.

    EDIT:
    Fixed the ambiguous description in github
     
    Last edited by CTCaer, May 1, 2018
  17. sweetlilmre

    sweetlilmre Member

    Newcomer
    3
    Aug 15, 2010
    Thanks, makes sense :)
     
  18. TheZander

    TheZander King of the Level 7's

    Member
    8
    Feb 1, 2008
    United States
    Level 7
    Is this how they messed with the FW version field in the screenshots from months ago? What other system firmware changes are possible threw this?
     
  19. Ghost92

    Ghost92 GBAtemp Fan

    Member
    3
    Jun 29, 2017
    Colombia
    Do you think there is a possibility to dump the data directly to the PC ?. Like adding a driver to the useful load that allows to explore the data or transfer it to the connected PC after loading the Payload
     
  20. Carlos Escobar

    Carlos Escobar Member

    Newcomer
    2
    Jan 19, 2016
    Spain
    I have dumped the nand several times but part 6 is always skipped... I use a 32 gb sd and I dump all parts until part 6 hat I have to copy all contents of the sd to my pc and then boot again hetake to finish part 6 and 7 but 6 is always skipped. Anyone knows the reason?

    Regards,
     
    Last edited by Carlos Escobar, May 1, 2018
    Oriordan likes this.
  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.
    Dismiss Notice