1. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    Italy
    EmuTool
    Move, Copy, Convert, Backup and Restore your SXOS and Atmosphere Emunand/emuMMC.

    upload_2019-11-18_20-25-34.png
    (Art by @CrazyKing93)​

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

    Italian language guide here

    Warning!

    Antivirus program can block and delete EmuTools.
    EmuTool uses these functions of Windows Kernel32: CreateFile, CloseHandle, DeviceIoControl, SetFilePointer, ReadFile, GetFileSize, WriteFile, FlushFileBuffer, LockFile, UnlockFile
    Check source code in second post if you need.


    1. What is it for?

    • Move the Hidden partition Emu (Atmosphere\SXOS) on a new (bigger?) SD
    • For SXOS it allows to switch from Emu on partition mode to Emu on file and vice versa, so you can have two Emunand on the same SD card.
    • Change your Emu format from Atmosphere to SX OS and viceversa and from Hidden partition Emu to Emu on file
    • Backup and restore of every type of Emu.
    • Create a new Emu (for experiments?) starting from you current Emu.
    • Create the relevant configuration files to boot the Emu (emummc.ini, raw_based, file_based and folder structure)

    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 shows a list of the partitions present on the SD card.
    The Sector field located at the bottom right is important.
    The first value is read by emummc.ini if it is correct, check the emummc.ini file in the emummc folder of the SD card if this value is incorrect. If you are using Kosmos simply select the Emu from the emuMMC menu.
    If you select a partition from the list, then the initial sector of the partition, added to the 16Mbyte offset, will be shown in the Sector field.
    No partition selection for SXOS as it is fixed to 0x2 on the first patition.
    If something is wrong then you can correct the value, in hex (with notation 0x as in 0x02AC2300) or in decimal (for example the value read from Minitool Partition Wizard)

    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!!!
    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.9
    Fixed restore from Hekate backup file, now rawnand.bin or rawnand.bin.xx are supported as single file backup or up to 51 files splitted backup (rawnand.bin.50)
    Added partition selection for Atmosphere
    Minor fixes in partition selection for Atmosphere

    Version 0.2.8
    Solved bad starting sector report when Atmosphere hidden partition was chosen as Source
    Fixed some minor bugs found during more tests

    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: Dec 28, 2019
    Darkyose, Zangrief, DSwizzy and 16 others like this.
  2. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    Italy
    Software developed in VB6, source code here attached
    Only dependencies of win32 were used.

    Many Antivirus software recognize EmuTool as a Virus.
    EmuTool uses these functions of Windows Kernel32: CreateFile, CloseHandle, DeviceIoControl, SetFilePointer, ReadFile, GetFileSize, WriteFile, FlushFileBuffer, LockFile, UnlockFile and this may be something antivirus don't like very much

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


    Known bug:
    - In some windows installation you can get overflow error. If it keep giving overflow error, try to delete Windows Font cache as @Unkouh suggested
    - Antivirus software may detect EmuTool as a Virus. Please check the source here for your peace of mind.
     

    Attached Files:

    Last edited: Dec 28, 2019
  3. kublai

    kublai GBAtemp Fan
    Member

    Joined:
    May 29, 2008
    Messages:
    441
    Country:
    United States
    Looks like and awesome tool. Thanks.
     
  4. yyoossk

    yyoossk GBAtemp Regular
    Member

    Joined:
    Oct 18, 2017
    Messages:
    106
    Country:
    Japan
    run time error '6' Overflow in visual basic 6.0
     
  5. Mthodmn101

    Mthodmn101 GBAtemp Advanced Fan
    Member

    Joined:
    Jan 31, 2008
    Messages:
    586
    Country:
    United States
  6. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    Italy
    Run as Administrator, I have to trap that error yet.... In the next release.
     
    eco95 likes this.
  7. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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: Oct 23, 2019
    eco95 likes this.
  8. Alchemy_Gaming

    Newcomer

    Joined:
    Mar 11, 2019
    Messages:
    29
    Country:
    United States
    I’d like to request the source please :)
     
  9. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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: Oct 23, 2019
    eco95 and Alchemy_Gaming like this.
  10. mathew77

    mathew77 GBAtemp Regular
    Member

    Joined:
    Jan 19, 2019
    Messages:
    159
    Country:
    Norway
    Even in Admin mode there's an error. Win7, 64b
     
  11. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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: Oct 24, 2019
    eco95 likes this.
  12. mathew77

    mathew77 GBAtemp Regular
    Member

    Joined:
    Jan 19, 2019
    Messages:
    159
    Country:
    Norway
    Yep, the same error as yyoossk said, at the very startup, with Admin mode too:
     

    Attached Files:

    • err.PNG
      err.PNG
      File size:
      4 KB
      Views:
      46
    yyoossk likes this.
  13. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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

    Joined:
    Oct 18, 2017
    Messages:
    106
    Country:
    Japan
    still same error with admin mode
    windows7 x64
     
  15. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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

    Joined:
    Oct 18, 2017
    Messages:
    106
    Country:
    Japan
    thx!
     
  17. TheyKilledKenny

    OP TheyKilledKenny Member
    Newcomer

    Joined:
    Dec 5, 2015
    Messages:
    45
    Country:
    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: Oct 24, 2019
    eco95 likes this.
  18. mathew77

    mathew77 GBAtemp Regular
    Member

    Joined:
    Jan 19, 2019
    Messages:
    159
    Country:
    Norway
    Tried both new files, same error...
     
  19. pcwizard7

    pcwizard7 GBAtemp Advanced Fan
    Member

    Joined:
    Aug 2, 2013
    Messages:
    742
    Country:
    Australia
    i ve tried opening the program and no issue. win 10 x64
     
    TheyKilledKenny likes this.
  20. yyoossk

    yyoossk GBAtemp Regular
    Member

    Joined:
    Oct 18, 2017
    Messages:
    106
    Country:
    Japan
    me too
     
    mathew77 likes this.
Draft saved Draft deleted
Loading...

Hide similar threads Similar threads with keywords - partition, EmuTool, another