From db068980e26c2cb5ea774c71cf42e74a63ee74a3 Mon Sep 17 00:00:00 2001 From: Ian Skinner <56081713+IanSkinner1982@users.noreply.github.com> Date: Sat, 20 Feb 2021 18:45:35 -0500 Subject: [PATCH] Added nds-bootstrap section (#4) * Update index.md * Create faq.md * Made text the right size * Create testing.md * Update faq.md * Update faq.md --- pages/_en-US/nds-bootstrap/faq.md | 54 +++++++++++++++++++++++++++ pages/_en-US/nds-bootstrap/index.md | 6 +-- pages/_en-US/nds-bootstrap/testing.md | 16 ++++++++ 3 files changed, 73 insertions(+), 3 deletions(-) create mode 100644 pages/_en-US/nds-bootstrap/faq.md create mode 100644 pages/_en-US/nds-bootstrap/testing.md diff --git a/pages/_en-US/nds-bootstrap/faq.md b/pages/_en-US/nds-bootstrap/faq.md new file mode 100644 index 00000000..a8e25c7a --- /dev/null +++ b/pages/_en-US/nds-bootstrap/faq.md @@ -0,0 +1,54 @@ +--- +lang: en-US +layout: wiki +section: nds-bootstrap +category: other +title: FAQ & Troubleshooting +description: FAQ & Troubleshooting for nds-bootstrap +--- +#### Why do I get a white screen when trying to load a game from SD Card? +- First, check the [the nds-bootstrap compatibility list](https://docs.google.com/spreadsheets/d/1LRTkXOUXraTMjg1eedz_f7b5jiuyMv2x6e_jY_nyHSc/htmlview#gid=0) and make sure your game is compatible +- Try with all cheats disabled for that game as some cheats are not compatible with nds-bootstrap at the moment, you can use L to disable all cheats for a game +- If the game you’re trying to launch is a DSi Enhanced game, then make sure that TWiLight Menu++ is set to use `DS Mode` +- If it worked before, delete the `fatTable` and `patchOffsetCache` folders in `sd:/_nds/nds-bootstrap/` + +#### Why are there issues with ROM loading, even if they're run natively? +nds-bootstrap patches the ROM functions to run from an SD card, as the ROMs are hardcoded to read from Slot-1. +There are also timing issues and AP measures (which most are already removed), both of which would cause the ROMs to not work properly. +To improve performance, nds-bootstrap also shrinks the game's heap in memory, which breaks some games, though both the forwarders and TWiLight Menu++ have a heap shrink blacklist to fix the non-working games broken by heap shrink. + +#### Why use nds-bootstrap over a regular flashcard? +- Certain compatible ROMs are loaded into RAM, allowing for load times to be faster than even normal cartridges +- You can expand the VRAM memory bus to 32-bit +- Utilize the DSi's additional CPU speed +- Enhance your audio with 48khz. +- Use DSi mode, allowing for DSi features +- Using certain cartridges, you are able to use IR in your application +- nds-bootstrap is open source meaning devs can always update it to fix bugs and other things even if the company gets discontinued. +- the DS Memory Expansion card is emulated meaning games that require that accessory will work + +#### Donor ROMs +Most SDK5 games can be selected as a Donor ROM (which can be done via TWiLight Menu++). The Donor ROM's ARM7 binary is copied by nds-bootstrap and replaces the ARM7 binary for the game that it is trying to run. This allows certain and SDK5 games to boot and save. + +#### What is a nightly and where do I get it? +A nightly build is build for the latest commit. Nightly builds may be unstable, but has the most recent bugfixes added. +You can get nightly builds for nds-bootstap [here](https://github.com/TWLBot/Builds/raw/master/nds-bootstrap.7z) + +#### Why do my cheats not work? +The way E cheat types are implemented in nds-bootstrap is broken, meaning they'd only work half of the time. +Your cheat probably uses that type. It is not a fault of the cheat database, but rather a fault of nds-bootstrap. Please do not request these cheats to get deleted from the DB. + +#### Is there anything else I should know about cheats? +You can set heap shrink to `Hi` in settings for slightly better cheat support.
+For more info on cheats, look [here](https://wiki.ds-homebrew.com/ds-index/retail-roms#action-replay-cheats). + +#### nds-bootstrap troubleshooting +If you get issues with using the latest version of nds-bootstrap, here's how you could troubleshoot it. + +1. Run everything in 67mhz, DS Mode with 32 khz of audio. Basically, keep everything to DS settings. Don't try to improve it with DSi stuff +2. Delete the `fatTable` and `patchOffsetCache` folders in `sd:/_nds/nds-bootstrap/` +3. It's probably not that big of an issue; ask in the [Discord server](https://discord.gg/yD3spjv) + +If the server says it's an nds-bootstrap issue, check if the game hasn't been reported already on GitHub. Check the closed issues too in case we had one issue closed in preference a different one. If it doesn't have any GitHub issue attached to it, go ahead and make a new one + +Also, make sure you add it to the [compatibility list](https://wiki.ds-homebrew.com/nds-bootstrap/testing) on Google Sheets. diff --git a/pages/_en-US/nds-bootstrap/index.md b/pages/_en-US/nds-bootstrap/index.md index 116ae11c..e282b1ef 100644 --- a/pages/_en-US/nds-bootstrap/index.md +++ b/pages/_en-US/nds-bootstrap/index.md @@ -3,9 +3,9 @@ lang: en-US layout: wiki section: nds-bootstrap title: Home -description: Coming Soon™ +description: nds-bootstrap wiki --- -# nds-bootstrap Wiki Placeholder +# Welcome to the nds-bootstrap Wiki -This is a placeholder index page for the nds-bootstrap wiki, coming soon™! +nds-bootstrap is an open-source application that allows Nintendo DS/DSi ROMs and homebrew to be natively utilised rather than using an emulator. nds-bootstrap works on Nintendo DSi/3DS SD cards through CFW and on Nintendo DS through flashcarts. diff --git a/pages/_en-US/nds-bootstrap/testing.md b/pages/_en-US/nds-bootstrap/testing.md new file mode 100644 index 00000000..245e351f --- /dev/null +++ b/pages/_en-US/nds-bootstrap/testing.md @@ -0,0 +1,16 @@ +--- +lang: en-US +layout: wiki +section: nds-bootstrap +category: other +title: Compatibility List & Testing Tips +description: Compatibility List & Testing Tips +--- +#### Compatibility List +To view tested games, look [here](https://docs.google.com/spreadsheets/d/1LRTkXOUXraTMjg1eedz_f7b5jiuyMv2x6e_jY_nyHSc/edit#gid=0). If you want to contribute, press `view only` and then `request edit access`. + +#### Tips For Testing Games +- Look for screen flickering or sound issues +- If something looks off, run the game along console not using nds-bootstrap to compare +- Try as many features in the game as possible +- Be thorough