RELEASE EmuTool - Move partition Emu on another SD, Switch Emu type on SXOS and more

Discussion in 'Switch - ROM Hacking, Saves, Translations & Tools' started by TheyKilledKenny, Oct 23, 2019.

  1. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    EmuTool
    Copy, move, backup, restore, switch sxos Emu type for your eMMC\Emunand

    (Emunand or emuMMC are the same concept, so below they will be referred to simply as Emu)

    Italian language guide here

    1. What is it for?

    • Migrate the Emu (Atmosphere\SXOS) on Partition to another SD
    • For SXOS it allows to switch from Emu on partition mode to Emu on file and vice versa
    • Creation of a new Emu (for experiments?) starting from you current Emu
    • Change your Emu format between different Emu types and from Hekate backup file (no real transformation occurs, only a copy byte by byte in different ways)
    • Backup and restore of every type of Emu.
    • Create the files ready to be copied to the SD, in case of recovery on partition for Atmosphere, the emummc.ini file is created (it is overwritten if it already exists without warning


    2. Using the Tool
    To access the SD partitions run EmuTool.exe with administrator rights, it should already request it, if not please do a right click and choos Run as Administrator...
    To start, double click on the EmuTool.exe file and confirm the administrative rights if necessary
    EmuTool requires that you select a source (Source), ie where to read the Emu, and a destination (Target), ie where to write the copy of the Emu.
    Both Source and Target support Partition and Files.
    When Source and Destination are set press the Start button to start copying.
    (I apologize for the UI quality. This was a tool created just for me and I wanted to keep it lightweight, free of dependencies, no installation and easily usable, as I think a tool so limited and specific should be)​

    [​IMG]



    3. How to Select SD card and File
    After selecting the type of Emu you want as a Source or Target, click on the "white" box with the words "Click to select SD Card" in the frame relating to the Emu type selection.
    A navigation window will appear depending on the Emu type selected
    In case of Partition type, the following window will appear​
    [​IMG]
    Selecting the drive containing the SD, if the Emu is correctly configured (emummc.ini is correct), in the lower right pane called Sector, the value of the Emu initial sector must appear (value is 0x2 fixed for sxos), if this data is incorrect please check emummc.ini file in the emummc folder of the SD Card. If you are using Kosmos, please select the Emu you want to copy.

    Confirmed with Ok the main screen displays the data related to the Emu to read
    [​IMG]


    If you choose The File Type Emu the following window will appear
    [​IMG]


    Select the destination folder and the path will be shown on the main screen in the white box

    [​IMG]

    When everything is set as desired press Start.​


    4. Enabling / disabling Emunand SXOS on partition (allows to start emunand on file)
    Select Source SXOS hidden partition and click the white box to select the SD card drive. When SD is selected two new buttons will appear in the main window

    [​IMG]


    WARNING!!!
    The operation takes place immediately without further confirmation !!!
    No check is made on the actual existence of Emunand, so you can enable emu on partition even if this partition does not exist.

    The state of the buttons indicates the current status of Emunand on partition.
    Click on "Enable Partition Emu" to enable reading the Emunand from the hidden partition.
    Click on "Disable Partition Emu" to disable it. In this case the File Emunand will be loaded if there is a valid SXOS File Emunand on SD in the sxos\Emunand folder.
    You can now prepare a SXOS Emunand file.
    Select the SXOS File type as Target, select the SD root as the path and press Start to create a copy of your Emunand partition in Emunand file, without the need to use hard disk and without having to reload the cfw files on the SD.
    EmuTool Create the sxos/Emunand folder starting from the point you choose as the destination folder. Inside the Emunand foledr you will find the Emunand files.

    5. Change SD for those who have Emu on partition
    To bring the Emu to the new SD there are two possibilities:
    1 - Copy the Emu to file and use it in File mode (see section 6)
    2 - Create a special partition of at least 30GByte on the new SD and transfer the Emu on it, however, requires the passage at point 1 (first go to section 6 and then to section 7)
    6. Convert partition Emu in Emu on File
    Select as Source the type of partiton Emu, Atmosphere or SXOS, you want to read/copy and then select the SD card by clicking on the white box.
    Select as Target the type of Emu on file you want to get and click on the white box to select a destination path.
    The Emu-related folders will be created, ready to be copied to the SD root. In the case of the Atmosphere type, the emummc.ini and file_based files are also created.
    For SXOS the sxos folder is created and within it the Emunand folder is created. For Atmosphere the emuMMC folder is created, the emummc.ini file compiled and the HPE0 folder which will contain the eMMC folder with the Emu files and the file_based file needed by Kosmos\Hekate\Nyx.

    Press Start to begin.
    7. Transfer of the Emu to partition
    Select as Source the Emu File type and select the folder that contains the Emu files, not the root folder (ie choose sxos\Emunand or emummc\HE0\eMMC folders).
    Select as Target the type of partition Emu that you want to restore, in case of Atmosphere type you will also have to indicate the initial sector of the partition you created to host the Emu. Please check the other tutorial on how to create a suitable partition for emuMMC (you can use the free minitool partition software).

    Press the Start button to start copying.​

    6. Conclusion
    For any other operation you can think of, the way to select the SD reader and browse through the folders does not change, so I guess I shouldn't bother you with unnecessary chatter ;-)

    I do not offer any guarantee for the use of this software. I am a very bad programmer, so if you use EmuTool it will be at your own risk.
    If using this software the processor should start like a rocket and cut your head off (Hey They killed kenny! ... You Bastard!), I'm not responsible.

    With this software you can do whatever you want (copy, distribute, decompile, write the user TheyKilledKenny is idiot, etc.), but NOT SELL in any ways. If you recover even a single penny with this software you must immediately donate to charity, otherwise you are a thief.


    Thanks to the user @GraFfiX420 for pointing me in the right direction with his tutorial
    https://gbatemp.net/threads/moving-from-sx-os-sd-emunand-to-sd-hidden_emunand.526587/


    Ciao!



    Changelog:
    Version 0.2.7
    Added a minimum of error trapping, useful to debug errors
    Added partition selection, 16MByte offset will be added to the real partition start sector because Kosmos\Hekate do it when I create a new emu on partition from starting menu. Text filed is always editable to correct if needed.
    Some other minor error traping and correction around.
    Not solved overflow error that someone reported, maybe the error trap can be useful.

    Version 0.2.6
    Added different file size for Amosphere eMMC and SXOS size, it should solve some slowness problem during eMMC boot.
    Trapped an overflow error during SD read at the start if not executed as Admin
    Sector field for Atmosphere partition is now always editable
    Changed the icon of the main form that caused crashes on some Windows7 systems.

    Version 0.2.5
    Test Version

    Version 0.2.4
    First public release
     

    Attached Files:

    Last edited by TheyKilledKenny, Nov 17, 2019 at 11:07 PM
    Condemned87, eco95, JRoad and 10 others like this.
  2. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Software developed in VB6, source code here attached
    Only dependencies of win32 were used.

    This software does what can already be done with a normal DD command, no real transformation is done to the data.

    Known bug:
    - Can not recognize hekate backup files if not splitted, ranaming rawnand.bin in rawnand.bin.00 can do the job at the moment
    - if it keep giving overflaw error try to delete Windows Font cache as @Unkouh suggest
     

    Attached Files:

    Last edited by TheyKilledKenny, Nov 17, 2019 at 11:22 PM
  3. kublai

    kublai GBAtemp Fan

    Member
    7
    May 29, 2008
    United States
    Looks like and awesome tool. Thanks.
     
  4. yyoossk

    yyoossk GBAtemp Regular

    Member
    5
    Oct 18, 2017
    Japan
    run time error '6' Overflow in visual basic 6.0
     
  5. Mthodmn101

    Mthodmn101 GBAtemp Advanced Fan

    Member
    6
    Jan 31, 2008
    United States
  6. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Run as Administrator, I have to trap that error yet.... In the next release.
     
    eco95 likes this.
  7. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Thanks for reminding me where I started with the idea, so I could add a reference to that post.

    This is exactly what the enable and disable partition Emu buttons do.
    Not the entire 1024 bytes, but only the first 84 bytes of the second sector (0x1) that is the relevant part for sxos.
    If you click on Disable, all 84 bytes are written to 0, if you click on Enable, the TX 84 bytes are written...
     
    Last edited by TheyKilledKenny, Oct 23, 2019
    eco95 likes this.
  8. Alchemy_Gaming

    Alchemy_Gaming Member

    Newcomer
    2
    Mar 11, 2019
    United States
    I’d like to request the source please :)
     
  9. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Find it attached to first post.
    Don't be too strict with me :D, it's a tool I did for myself to avoid having to use dd anymore.
     
    Last edited by TheyKilledKenny, Oct 23, 2019
    eco95 and Alchemy_Gaming like this.
  10. mathew77

    mathew77 GBAtemp Regular

    Member
    3
    Jan 19, 2019
    Norway
    Even in Admin mode there's an error. Win7, 64b
     
  11. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Can you please tell me what kind of error?
    At start up or at run time?
    Can you please write me the error message or post a picture?
     
    Last edited by TheyKilledKenny, Oct 24, 2019
    eco95 likes this.
  12. mathew77

    mathew77 GBAtemp Regular

    Member
    3
    Jan 19, 2019
    Norway
    Yep, the same error as yyoossk said, at the very startup, with Admin mode too:
     

    Attached Files:

    yyoossk likes this.
  13. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Please, try to start it without any SD in PC.
    If Emutool starts without inserting an SD card, this means that the software cannot access the SD card reader for some reason.
     
    eco95 likes this.
  14. yyoossk

    yyoossk GBAtemp Regular

    Member
    5
    Oct 18, 2017
    Japan
    still same error with admin mode
    windows7 x64
     
  15. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    Did you succeed in starting EmuTool in Admin mode?

    — Posts automatically merged - Please don't double post! —

    Ok, Win7 64Bit.

    I need to check. I have only a Win7 32bit, I'm going to find a 64bit one.
     
    eco95 and yyoossk like this.
  16. yyoossk

    yyoossk GBAtemp Regular

    Member
    5
    Oct 18, 2017
    Japan
    thx!
     
  17. TheyKilledKenny
    OP

    TheyKilledKenny Member

    Newcomer
    3
    Dec 5, 2015
    Italy
    In the attached Zip you can find 2 Exe file.
    They are the same version, but one with an embedded manifest to force Admin mode.
    Without changing the name of the exe files, can you please try to execute both one at a time as Admin and see what happen?

    Unfortunately the error not caught is the initial reading of the SD to check if there is an SX partition, so if the software is not able to read from SD card can be a problem.

    This new version have the error trapped, so we can see if the error is the same.

    Thank you for your support.
     
    Last edited by TheyKilledKenny, Oct 24, 2019
    eco95 likes this.
  18. mathew77

    mathew77 GBAtemp Regular

    Member
    3
    Jan 19, 2019
    Norway
    Tried both new files, same error...
     
  19. pcwizard7

    pcwizard7 GBAtemp Advanced Fan

    Member
    4
    Aug 2, 2013
    Australia
    i ve tried opening the program and no issue. win 10 x64
     
    TheyKilledKenny likes this.
  20. yyoossk

    yyoossk GBAtemp Regular

    Member
    5
    Oct 18, 2017
    Japan
    me too
     
    mathew77 likes this.
Quick Reply
Draft saved Draft deleted
Loading...