Ntrboot flasher 3DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = ntrboot_flasher
|title=NTRBoot Flasher
| image = https://dlhb.gamebrew.org/3dshomebrew/ntrboot_flasher.jpeg|250px
|image=Ntrbootflasher3.png
| type = Utilities
|description=Flash ntrboot to supported flashcarts using your 3DS.
| version = v0.5.0
|author=ntrteam
| licence = Mixed
|lastupdated=2018/11/21
| author = ntrteam
|type=Exploits
| website = https://github.com/ntrteam/ntrboot_flasher
|version=0.5.0
| download = https://dlhb.gamebrew.org/3dshomebrew/ntrboot_flasher-3DS.rar
|license=GPL-3.0
| source = https://dlhb.gamebrew.org/3dshomebrew/ntrboot_flasher-3DS.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/ntrbootflasher.7z
|website=https://3ds.hacks.guide/ntrboot.html
|source=https://github.com/ntrteam/ntrboot_flasher
}}
}}
<youtube>smhtNHVkdaw</youtube>
ntrboot_flasher is a tool to flash bootrom-hax to flashcart on your 3DS. For details on how ntrboot works, see the last few pages of [https://sciresm.github.io/33-and-a-half-c3 33.5c3].


= ntrboot_flasher =
'''Note:''' 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) and there are no known serious issues.
''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 ==
==Installation==
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).
Instructions are documented at [https://twitter.com/plailect?lang=en Plailect's] [https://3ds.guide 3ds.guide] and are heavily recommended over any alternatives.
== Supported Carts ==
 
https://github.com/ntrteam/ntrboot_flasher/raw/master/carts.png
==User guide==
===Supported Carts===
* Acekard 2i HW-44
* Acekard 2i HW-44
* Acekard 2i HW-81
* Acekard 2i HW-81
* DSTT ('''some flash chips only!''')
* DSTT (some flash chips only)
* Infinity 3 R4i (r4infinity.com)
* Infinity 3 R4i (r4infinity.com)
* R4 3D Revolution (r4idsn.com)
* R4 3D Revolution (r4idsn.com)
* R4i 3DS RTS (r4i-sdhc.com)
* R4i 3DS RTS (r4i-sdhc.com)
* R4i Gold 3DS (RTS, revisions A5/A6/A7) (r4ids.cn)
* 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 Ultra (r4ultra.com)
* R4i-B9S (r4i-sdhc.com)
* R4i-B9S (r4i-sdhc.com)
Line 31: Line 34:
* R4i-SDHC Gold Pro (r4isdhc.com)
* R4i-SDHC Gold Pro (r4isdhc.com)
* R4i-SDHC RTS Lite (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.
https://dlhb.gamebrew.org/3dshomebrews/ntrbootflasher2.png
== Compiling ==
 
To compile this, you need:
===Notes===
* [https://3dbrew.org/wiki/Setting_up_Development_Environment devkitARM r47]
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.  
* [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>
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/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.
 
== Planned support/Community involvement ==
Alternatively you can try jason0597's [https://github.com/jason0597/ntrboot_flasher_nds ntrboot_flasher_nds], a re-written version based on the official ntrboot_flasher with UI fix.
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;'''
 
== Licensing ==
==Changelog==
This software is licensed under the terms of the GPLv3. You can find a copy of the license in the LICENSE file.
'''v0.5.0'''
== Credits ==
* Updated flashcart_core to v1.1.0:
* [https://github.com/Normmatt @Normmatt] for initial implementation, bug squashing, expertise... etc.
** R4isdhchk: Add support for r4isdhc.hk (AKA r4igold.cc) - thanks @EleventhSign.
* [https://twitter.com/SciresM @SciresM] for sighax/boot9strap and flashcart RE.
 
* [https://twitter.com/hedgeberg @hedgeberg] for testing and flashcart RE.
'''v0.4.0'''
* [https://github.com/handsomematt @handsomematt] for UI, testing and flashcart RE.
* Backups now have the shortname of the cart prefixed for backup/restore. e.g. ak2i-backup.bin
* [https://twitter.com/pixel_stuck @stuckpixel] for testing.
** 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).
* [https://twitter.com/Myriachan @Myria] for testing.
* A backup is required before injection is possible (again).
* [https://twitter.com/yuukishiroko @Hikari] for testing. Huge props to [https://twitter.com/d3m3vilurr @d3m3vilurr] for figuring this out independently!
* 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.
* [https://twitter.com/hedgeberg hedgeberg] for testing and flashcart RE.
* [https://github.com/handsomematt handsomematt] for UI, testing and flashcart RE.
* [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.
 
==External links==
* GitHub - https://github.com/ntrteam/ntrboot_flasher
* 3DS Hacks Guide - https://3ds.hacks.guide/ntrboot.html
 
[[Category:3DS homebrew loaders]]
[[Category:Exploits for 3DS]]

Latest revision as of 09:50, 4 February 2022

NTRBoot Flasher
Ntrbootflasher3.png
General
Authorntrteam
TypeExploits
Version0.5.0
LicenseGPL-3.0
Last Updated2018/11/21
Links
Download
Website
Source

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

Note: 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) and there are no known serious issues.

Installation

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

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)

ntrbootflasher2.png

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.

Alternatively you can try jason0597's ntrboot_flasher_nds, a re-written version based on the official ntrboot_flasher with UI fix.

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

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

External links

Advertising: