Ntrboot flasher 3DS: Difference between revisions

ntrboot_flasher
ntrboot_flasher
	File:Ntrboot flasher.jpeg
General
Author	ntrteam
Type	Utilities
Version	0.5.0
License	GPLv3
Last Updated	2018/11/21
Links
	Download
	Website
	Source

Revision as of 08:54, 6 November 2021

ntrboot_flasher is a tool to flash bootrom-hax to flashcart. For details on how ntrboot works, see the last few pages of 33.5c3.

Note from developers:

ntrboot_flasher is considered mostly complete and no longer in active development. Support for flashcarts that are not already supported is extremely unlikely. Although there are newer commits, they do not affect functionality (they fix build issues with newer devkitARM releases). There are no known serious issues.

Installation

Instructions are documented at @Plailect's 3ds.guide and are heavily recommended over any alternatives.

Compiling

To compile this, you need:

devkitARM r47
firmtool
flashcart_core - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you must use the --recursive option to grab it. Example: git clone --recursive https://github.com/ntrteam/ntrboot_flasher.git
libelm3ds - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you must use the --recursive option to grab it.

User guide

Supported Carts

Acekard 2i HW-44
Acekard 2i HW-81
DSTT (some flash chips only)
Infinity 3 R4i (r4infinity.com)
R4 3D Revolution (r4idsn.com)
R4i 3DS RTS (r4i-sdhc.com)
R4i Gold 3DS (RTS, revisions A5/A6/A7) (r4ids.cn)
R4i Gold 3DS Deluxe Edition (r4ids.cn) (variants of this such as 3dslink, Orange 3DS, etc. may also work, but have not been tested)
R4i Ultra (r4ultra.com)
R4i-B9S (r4i-sdhc.com)
R4i-SDHC Dual-Core (r4isdhc.com)
R4i-SDHC Gold Pro (r4isdhc.com)
R4i-SDHC RTS Lite (r4isdhc.com)
R4 SDHC Dual Core (revisions 5.06/7.00/7.07) (r4isdhc.hk) (R4iGold.cc may work as well, but have not been tested)

Notes

Flashcarts from r4isdhc.com tend to have yearly re-releases; all versions of these carts (2014-2017) should work but not all have been tested. Note that in some rare circumstances, it may be possible for the flashing process to brick a counterfeit flashcart and render it permanently unusable. This is unlikely, but nevertheless only the genuine (i.e. from the original manufacturer) versions of the listed flashcarts are officially supported. There is not a good way to test for counterfeit carts, unfortunately, as they usually report the same chip ID and revision as legitimate carts.

Note that you are more likely to receive a counterfeit R4 than a counterfeit AK2i. Though there is a chance that many counterfeit versions of the listed flashcarts will work fine, there is too much variance to guarantee that any counterfeit is supported. As such, use this tool at your own risk.

Changelog

v0.5.0

Updated flashcart_core to v1.1.0:
- R4isdhchk: Add support for r4isdhc.hk (AKA r4igold.cc) - thanks @EleventhSign.

v0.4.0

Backups now have the shortname of the cart prefixed for backup/restore. e.g. ak2i-backup.bin
- If you have a backup.bin from an older version, you need to rename it to its new name before you can restore (TODO: list of possible names somewhere).
A backup is required before injection is possible (again).
The Ace3DS+ and clones (i.e. r4isdhc.com.cn) are now supported.

v0.3.1

Support for r4i-sdhc.com and r4isdhc.com carts has been added.
Some minor things for DSTT were fixed.
Error checking added, since things are actually starting to return errors.

v0.3.0

Logging support has been added to flashcart_core, and therefore to ntrboot_flasher.
Logs should be generated at /ntrboot/ntrboot.log, and should contain cart dependent information like the hardware revision for Kk2i and R4i Gold 3DS, or flashchip ID for DSTT. This should make some forms of debugging easier, now that the framework is in place.
Meanwhile, a few more DSTT chips have been given support.

v0.2.0

DSTT Support has been added (not all of them, unfortunately).
Menu highlighting.
Progress bars.

v0.1.3

Added support for a couple of very similar cards (https://github.com/kitling/flashcart_core/issues/26 and https://github.com/kitling/flashcart_core/issues/28).
Other changes have been made in the background, but there shouldn't be any huge differences.

v0.1.2

This release fixes initialization of carts, causing a wide-spread issue of carts not being properly detected.

v0.1.1

Fixed: Forgot to clear a buffer to 0, so sometimes a cart could 'brick' (Commit](kitlith/flashcart_core@ad5d125)).
Fixed: The name displayed in the program itself (ntrboothax installer -> ntrboot flasher).

v0.1

The initial release, supports the Acekard 2i and the R4i Gold 3DS RTS.

Credits

@Normmatt for initial implementation, bug squashing, expertise... etc.
@SciresM for sighax/boot9strap and flashcart RE.
@hedgeberg for testing and flashcart RE.
@handsomematt for UI, testing and flashcart RE.
@stuckpixel for testing.
@Myria for testing.
@Hikari for testing. Huge props to @d3m3vilurr for figuring this out independently.

External links

GitHub - https://github.com/ntrteam/ntrboot_flasher
3ds.guide - https://3ds.hacks.guide/ntrboot.html

@@ Line 2: / Line 2: @@
 |title=ntrboot_flasher
 |image=ntrboot_flasher.jpeg
-|description=A tool to flash that bootrom-hax goodness to your flashcart using your 3ds.
+|description=A tool to flash bootrom-hax to your flashcart using your 3DS.
 |author=ntrteam
 |lastupdated=2018/11/21
 |type=Utilities
 |version=0.5.0
-|license=Mixed
+|license=GPLv3
-|download=https://dlhb.gamebrew.org/3dshomebrew/ntrboot_flasher-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/ntrbootflasher.7z
-|website=https://github.com/ntrteam/ntrboot_flasher
+|website=https://3ds.hacks.guide/ntrboot.html
 |source=https://github.com/ntrteam/ntrboot_flasher
 }}
-<youtube>smhtNHVkdaw</youtube>
-= ntrboot_flasher =
+ntrboot_flasher is a tool to flash bootrom-hax to flashcart. For details on how ntrboot works, see the last few pages of [https://sciresm.github.io/33-and-a-half-c3 33.5c3].
-''A tool to flash that bootrom-hax goodness to your flashcart.'' For details on how ntrboot works, see the last few pages of [https://sciresm.github.io/33-and-a-half-c3/ 33.5c3].
-== Development has ceased ==
+'''Note from developers:'''
-ntrboot_flasher is no longer in active development. We consider it mostly complete. Support for flashcarts that are not already supported is extremely unlikely. [https://github.com/ntrteam/ntrboot_flasher/releases/tag/v0.5.0 v0.5.0] is the most up-to-date release. Although there are newer commits, they do not affect functionality (they fix build issues with newer devkitARM releases). There are no known serious issues. If there are any new issues discovered, we may fix them and issue (a) new release(s).
-== Supported Carts ==
+ntrboot_flasher is considered mostly complete and no longer in active development. Support for flashcarts that are not already supported is extremely unlikely. Although there are newer commits, they do not affect functionality (they fix build issues with newer devkitARM releases). There are no known serious issues.
+==Installation==
+Instructions are documented at [https://twitter.com/plailect?lang=en @Plailect's] [https://3ds.guide 3ds.guide] and are heavily recommended over any alternatives.
+===Compiling===
+To compile this, you need:
+* [https://3dbrew.org/wiki/Setting_up_Development_Environment devkitARM r47]
+* [https://github.com/TuxSH/firmtool firmtool]
+* [https://github.com/ntrteam/flashcart_core flashcart_core] - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you must use the --recursive option to grab it. Example: <code>git clone --recursive https://github.com/ntrteam/ntrboot_flasher.git</code>
+* [https://github.com/Normmatt/libelm3ds libelm3ds] - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you must use the --recursive option to grab it.
+==User guide==
+===Supported Carts===
 https://github.com/ntrteam/ntrboot_flasher/raw/master/carts.png
 * Acekard 2i HW-44
 * Acekard 2i HW-81
-* DSTT ('''some flash chips only!''')
+* DSTT (some flash chips only)
 * Infinity 3 R4i (r4infinity.com)
 * R4 3D Revolution (r4idsn.com)
 * R4i 3DS RTS (r4i-sdhc.com)
 * R4i Gold 3DS (RTS, revisions A5/A6/A7) (r4ids.cn)
-* R4i Gold 3DS Deluxe Edition (r4ids.cn) ('''variants of this such as 3dslink, Orange 3DS, etc. may work as well, but have not been tested!''')
+* R4i Gold 3DS Deluxe Edition (r4ids.cn) (variants of this such as 3dslink, Orange 3DS, etc. may also work, but have not been tested)
 * R4i Ultra (r4ultra.com)
 * R4i-B9S (r4i-sdhc.com)
@@ Line 33: / Line 46: @@
 * R4i-SDHC Gold Pro (r4isdhc.com)
 * R4i-SDHC RTS Lite (r4isdhc.com)
-* R4 SDHC Dual Core (revisions 5.06/7.00/7.07) (r4isdhc.hk) ('''R4iGold.cc may work as well, but have not been tested!''') '''Note:''' Flashcarts from r4isdhc.com tend to have yearly re-releases; all versions of these carts (2014-2017) should work but not all have been tested. Note that in some rare circumstances, it may be possible for the flashing process to '''brick''' a counterfeit flashcart and render it permanently unusable. This is unlikely, but nevertheless only the genuine (i.e. from the original manufacturer) versions of the listed flashcarts are officially supported. There is not a good way to test for counterfeit carts, unfortunately, as they usually report the same chip ID and revision as legitimate carts. Note that you are more likely to receive a counterfeit R4 than a counterfeit AK2i. Though there is a chance that many counterfeit versions of the listed flashcarts will work fine, there is too much variance to guarantee that any counterfeit is supported. As such, use this tool at your own risk.
+* R4 SDHC Dual Core (revisions 5.06/7.00/7.07) (r4isdhc.hk) (R4iGold.cc may work as well, but have not been tested)
-== Installation/Usage ==
-Instructions are documented at [https://twitter.com/plailect?lang=en @Plailect's] [https://3ds.guide 3ds.guide] and are heavily recommended over any alternatives.
+===Notes===
-== Compiling ==
+Flashcarts from r4isdhc.com tend to have yearly re-releases; all versions of these carts (2014-2017) should work but not all have been tested. Note that in some rare circumstances, it may be possible for the flashing process to brick a counterfeit flashcart and render it permanently unusable. This is unlikely, but nevertheless only the genuine (i.e. from the original manufacturer) versions of the listed flashcarts are officially supported. There is not a good way to test for counterfeit carts, unfortunately, as they usually report the same chip ID and revision as legitimate carts.
-To compile this, you need:
-* [https://3dbrew.org/wiki/Setting_up_Development_Environment devkitARM r47]
+Note that you are more likely to receive a counterfeit R4 than a counterfeit AK2i. Though there is a chance that many counterfeit versions of the listed flashcarts will work fine, there is too much variance to guarantee that any counterfeit is supported. As such, use this tool at your own risk.
-* [https://github.com/TuxSH/firmtool firmtool]
-* [https://github.com/ntrteam/flashcart_core flashcart_core] - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you '''must''' use the --recursive option to grab it. Example: <code>git clone --recursive https://github.com/ntrteam/ntrboot_flasher.git</code>
+==Changelog==
-* [https://github.com/Normmatt/libelm3ds libelm3ds] - This is bundled as a submodule in ntrboot_flasher. When cloning the repo, you '''must''' use the --recursive option to grab it.
+'''v0.5.0'''
-== Planned support/Community involvement ==
+* Updated flashcart_core to v1.1.0:
-While we initially planned to support more carts on release, we have not been able to expand beyond the current set of supported carts due to a lack of time/energy/manpower. If you have a cart you would like supported and have the know-how for debugging/reverse engineering a flashcart, please come find one of the devs in [https://kiwiirc.com/client/irc.freenode.net/?nick=ntrbootuser_?#Cakey #Cakey on freenode]. Ideally, this toolset is extensible towards any updatable Nintendo DS/DSi flashcart. See [https://github.com/kitling/flashcart_core flashcart_core] for more flashcart details. '''Do not submit a &quot;feature request&quot; on this repository asking &quot;When will &lt;my cart&gt; be supported?&quot; The answer to this question is &quot;We don't know&quot;. See [https://github.com/kitling/flashcart_core#requesting-support-for-a-new-card here] for details on requesting your cart.&quot;'''
+** R4isdhchk: Add support for r4isdhc.hk (AKA r4igold.cc) - thanks @EleventhSign.
-== Licensing ==
-This software is licensed under the terms of the GPLv3. You can find a copy of the license in the LICENSE file.
+'''v0.4.0'''
-== Credits ==
+* Backups now have the shortname of the cart prefixed for backup/restore. e.g. ak2i-backup.bin
+** If you have a backup.bin from an older version, you need to rename it to its new name before you can restore (TODO: list of possible names somewhere).
+* A backup is required before injection is possible (again).
+* The Ace3DS+ and clones (i.e. r4isdhc.com.cn) are now supported.
+'''v0.3.1'''
+* Support for r4i-sdhc.com and r4isdhc.com carts has been added.
+* Some minor things for DSTT were fixed.
+* Error checking added, since things are actually starting to return errors.
+'''v0.3.0'''
+* Logging support has been added to flashcart_core, and therefore to ntrboot_flasher.
+* Logs should be generated at /ntrboot/ntrboot.log, and should contain cart dependent information like the hardware revision for Kk2i and R4i Gold 3DS, or flashchip ID for DSTT. This should make some forms of debugging easier, now that the framework is in place.
+* Meanwhile, a few more DSTT chips have been given support.
+'''v0.2.0'''
+* DSTT Support has been added (not all of them, unfortunately).
+* Menu highlighting.
+* Progress bars.
+'''v0.1.3'''
+* Added support for a couple of very similar cards (https://github.com/kitling/flashcart_core/issues/26 and https://github.com/kitling/flashcart_core/issues/28).
+* Other changes have been made in the background, but there shouldn't be any huge differences.
+'''v0.1.2'''
+* This release fixes initialization of carts, causing a wide-spread issue of carts not being properly detected.
+'''v0.1.1'''
+* Fixed: Forgot to clear a buffer to 0, so sometimes a cart could 'brick' (Commit]([https://github.com/kitlith/flashcart_core/commit/ad5d125abd62c5effd9908f8dea8aa2aec65a45c kitlith/flashcart_core@ad5d125])).
+* Fixed: The name displayed in the program itself (ntrboothax installer -> ntrboot flasher).
+'''v0.1'''
+* The initial release, supports the Acekard 2i and the R4i Gold 3DS RTS.
+==Credits==
 * [https://github.com/Normmatt @Normmatt] for initial implementation, bug squashing, expertise... etc.
 * [https://twitter.com/SciresM @SciresM] for sighax/boot9strap and flashcart RE.
@@ Line 53: / Line 100: @@
 * [https://twitter.com/pixel_stuck @stuckpixel] for testing.
 * [https://twitter.com/Myriachan @Myria] for testing.
-* [https://twitter.com/yuukishiroko @Hikari] for testing. Huge props to [https://twitter.com/d3m3vilurr @d3m3vilurr] for figuring this out independently!
+* [https://twitter.com/yuukishiroko @Hikari] for testing. Huge props to [https://twitter.com/d3m3vilurr @d3m3vilurr] for figuring this out independently.
+==External links==
+* GitHub - https://github.com/ntrteam/ntrboot_flasher
+* 3ds.guide - https://3ds.hacks.guide/ntrboot.html
+[[Category:3DS homebrew applications]]
+[[Category:Homebrew utility applications on 3DS]]
+[[Category:Homebrew hack utility for 3DS games]]