005Tools 3DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 1: Line 1:
{{Infobox-3DS-Homebrews
{{Infobox-3DS-Homebrews
| title      = 005Tools
| title      = 005Tools
| image      = [[File:005toolsds.jpg|300px]]
| image      = https://dlhb.gamebrew.org/dshomebrew/005tools.png
| type        = PC utility
| type        = PC utility
| version=0.1d
| version     = 0.1d
| lastupdated = 2013/12/08
| lastupdated = 2013/12/08
| licence    = Mixed
| licence    = Mixed
| author      = McHaggis
| author      = McHaggis
| website    = http://gbatemp.net/threads/release-005tools-by-mchaggis.334528/
| website    = http://gbatemp.net/threads/release-005tools-by-mchaggis.334528
| download    = https://dlhb.gamebrew.org/3dshomebrew/005tools.rar
| download    = https://dlhb.gamebrew.org/dshomebrew/005tools.7z
| source      = https://github.com/darthstroyer/005tools
| source      = https://github.com/darthstroyer/005tools
}}     
}}     
Line 17: Line 17:


==User guide==
==User guide==
===Available commands:===
===Available commands===
 
* info - Display information about the currently inserted game card.
* info - Display information about the currently inserted game card.
* download - Downloads the currently inserted game card's save data and writes it to filename.
* download - Downloads the currently inserted game card's save data and writes it to filename.
Line 24: Line 23:
* erase -Erase the save data stored on the currently inserted game card.
* erase -Erase the save data stored on the currently inserted game card.


===Available options:===
===Available options===
 
  -s, --save-size=BYTES
  -s, --save-size=BYTES
Override detected save size with BYTES.
Override detected save size with BYTES.
Line 36: Line 34:


Please make sure permissions are appropriately set for your device (or use su, if you don't care).
Please make sure permissions are appropriately set for your device (or use su, if you don't care).
===Additional notes===
The official app writes 3DS cards in full and then writes the first 16kB again. 005tools mimics this but I haven't bothered to change how the progress bar works, so don't be surprised when the progress bar resets after writing all the data.
Also, when writing 3DS/very large cards, you'll notice the progress bar freeze after the first 128kB is written. The official software does the same thing, and writing resumes ~7 seconds later.


==Known issues==
==Known issues==
Line 42: Line 45:
Certain games have a specific flag set in official software, not implemented yet.
Certain games have a specific flag set in official software, not implemented yet.


Cannot write to DS EEPROMs smaller than 1kB (reading does)
Cannot write to DS EEPROMs smaller than 1kB (reading does).


==Compatibility==
==Compatibility==
Line 48: Line 51:


==Changelog==
==Changelog==
'''v0.1d'''
* Fix command line options that were broken in v0.1c.
* Fix progress redrawing in Linux.
'''v0.1c'''
* Now compiles with gcc 4.7.
'''0.01b'''
'''0.01b'''
* Writing to 3DS cards works now.
* Writing to 3DS cards works now.
Line 59: Line 69:
==Credits==
==Credits==
elisherer for his R4iSaveMore application that got this homebrew started.
elisherer for his R4iSaveMore application that got this homebrew started.
==External links==
* GitHub - https://github.com/darthstroyer/005tools
* GBAtemp - http://gbatemp.net/threads/release-005tools-by-mchaggis.334528


[[Category:DS homebrew applications]]
[[Category:DS homebrew applications]]
[[Category:PC utilities for DS]]
[[Category:PC utilities for DS]]

Revision as of 01:57, 11 October 2021

Template:Infobox-3DS-Homebrews

005tools is a simple command line application designed to work with devices that can transfer game saves from CTR-005 (3DS) and NTR-005 (DS/DSi) game cards to your PC. The source code is platform independent, so it can be compiled to run on any system.

It allows backing up and restoring save games for 3DS/DSi/DS game cards using a device such as the R4i Save Dongle.

User guide

Available commands

  • info - Display information about the currently inserted game card.
  • download - Downloads the currently inserted game card's save data and writes it to filename.
  • upload - Overwrites the currently inserted game card's save data with data from filename.
  • erase -Erase the save data stored on the currently inserted game card.

Available options

-s, --save-size=BYTES

Override detected save size with BYTES.

-h, --output-header=FILE

Save game header to FILE.

-?, --help

Show this help.

Please make sure permissions are appropriately set for your device (or use su, if you don't care).

Additional notes

The official app writes 3DS cards in full and then writes the first 16kB again. 005tools mimics this but I haven't bothered to change how the progress bar works, so don't be surprised when the progress bar resets after writing all the data.

Also, when writing 3DS/very large cards, you'll notice the progress bar freeze after the first 128kB is written. The official software does the same thing, and writing resumes ~7 seconds later.

Known issues

Save detection for some DS cards isn't implemented.

Certain games have a specific flag set in official software, not implemented yet.

Cannot write to DS EEPROMs smaller than 1kB (reading does).

Compatibility

Currently the application only supports the R4i Save Dongle.

Changelog

v0.1d

  • Fix command line options that were broken in v0.1c.
  • Fix progress redrawing in Linux.

v0.1c

  • Now compiles with gcc 4.7.

0.01b

  • Writing to 3DS cards works now.
  • Improved save size detection for 3DS cards.
  • Fixed progress bar on Win32.
  • Added some error detection.

0.01a

  • First version.

Credits

elisherer for his R4iSaveMore application that got this homebrew started.

External links

Advertising: