Move hiyaCFW content from dsi.cfw.guide (#18)

* Move hiyaCFW content from dsi.cfw.guide

* Change installing page titles

* Fix links to hiya pages

* Move antivirus notice to alert

* Use colons in headings

* Update troubleshooting.md

Also adjust page title <hr> a bit

* Use liquid comments and minor wording change

* Make sidebar index be separate from page list

* Remove step to uncheck install TWiLight box

* Rename from installing-hiyacfw to installing
This commit is contained in:
Pk11 2021-06-02 15:25:14 -05:00 committed by GitHub
parent 9900ac5991
commit f9ccea7a1e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
17 changed files with 192 additions and 35 deletions

View File

@ -36,13 +36,16 @@
}
],
"nds-bootstrap": [
],
"gbarunner2": [
],
"hiyacfw": [
{
"key": "other",
"title": "Other"
}
],
"gbarunner2": [
],
"other": [

View File

@ -18,6 +18,10 @@
"title": "GBARunner2",
"url": "/gbarunner2"
},
{
"title": "hiyaCFW",
"url": "/hiyacfw"
},
{
"title": "Other Projects",
"url": "/other"

View File

@ -17,22 +17,23 @@ layout: compress
<div class="row mt-3">
<div class="col-md-3">
<div class="rounded-3 sidebar-container mb-3 p-3">
<!-- get category list -->
{% comment %} Get category list {% endcomment %}
{% assign items = site[page.collection] | where: "section", page.section | sort_natural: "title" %}
{% comment %} First do the index {% endcomment %}
{% for item in items %}
{% if item.url contains "index.html" %}
<a class="{% if page.title == item.title %}fw-bold{% endif %}" href="{{ item.url | remove: "index.html" }}">{{ item.title }}</a>
<hr class="mt-2 mb-2">
{% endif %}
{% endfor %}
<ul class="list-unstyled">
<!-- First do the index -->
{% for item in items %}
{% if item.url contains "index.html" %}
<li class="li-bullet {% if page.title == item.title %}fw-bold{% endif %}"><a href="{{ item.url | remove: "index.html" }}">{{ item.title }}</a></li>
{% endif %}
{% endfor %}
<!-- Then the pages not in categories -->
{% comment %} Then the pages not in categories {% endcomment %}
{% for item in items %}
{% unless item.url contains "index.html" or item.category %}
<li class="li-bullet {% if page.title == item.title %}fw-bold{% endif %}"><a href="{{ item.url | remove: ".html" }}">{{ item.title }}</a></li>
{% endunless %}
{% endfor %}
<!-- Finally, the other pages -->
{% comment %} Finally, the other pages {% endcomment %}
{% for cat in site.data[page.collection].categories[page.section] %}
<li>
<details {% if page.category == cat.key or page.category.first and page.category contains cat %}open{% endif %}>
@ -52,8 +53,8 @@ layout: compress
</div>
</div>
<div class="col-md-9">
<h1>{{ page.long_title | default: page.title }}</h1>
<hr>
<h1 class="mb-1">{{ page.long_title | default: page.title }}</h1>
<hr class="mt-0">
{% include anchor-headings.html html=content anchorBody="<small>#</small>" anchorClass="header-anchor" %}
<div class="alert alert-secondary small-alert" role="alert">
{{ site.data[page.collection].strings.need-help }}

View File

@ -33,6 +33,10 @@ h2 {
border-bottom: 1px solid var(--borders);
}
hr {
opacity: 0.5;
}
blockquote {
color: var(--blockquote-color);
margin-bottom: 20px;

View File

@ -2,8 +2,7 @@
lang: en-US
layout: wiki
section: community
title: Home
long_title: Community
title: Community
description: Information about the DS-Homebrew community
---

View File

@ -2,8 +2,7 @@
lang: en-US
layout: wiki
section: gbarunner2
title: Home
long_title: GBARunner2
title: GBARunner2
description: Information on how to use GBARunner2
---

View File

@ -1,21 +1,19 @@
---
lang: en-US
layout: wiki
section: other
title: hiyaCFW
description: Information about hiyaCFW
section: hiyacfw
title: Custom Splash Screens
category: other
description: How to use custom splash screens with hiyaCFW
---
Information for [hiyaCFW](https://github.com/RocketRobz/hiyaCFW), the world's first CFW for DSi.
### Custom splash screens
With hiyaCFW you can use custom splashes in either `.bmp` or `.gif` formats. They need to go in the `sd:/hiya` folder and need to be named `splashtop` for the top screen and `splashbottom` for the bottom, with the appropriate file extension, then make sure the splash screen is enabled in the configuration. The images do not need to be the same format, so one can be BMP and the other GIF, GIFs have priority over BMPs. Below are some details on the requirements for your images to work:
#### BMP
### BMP
- 16-bit (RGBA 1555, RGB 1555, or RGB 565)
- 256 x 192 or smaller
#### GIF
### GIF
- Simple answer: Most GIFs 256 x 192 or smaller will work
- They can be animated, but should stay under 1 MiB for ideal performance and must be under around 10 MiB between the two absolute maximum
- If both loop infinitely then they will be shown for 3 seconds, otherwise they will be shown until both are complete

View File

@ -0,0 +1,30 @@
---
lang: en-US
layout: wiki
section: hiyacfw
title: Forwarders
category: other
description: How to use nds-bootstrap forwarders with hiyaCFW
---
### Requirements
- A Nintendo DSi with [Unlaunch](https://dsi.cfw.guide/installing-unlaunch), [hiyaCFW](installing), and [TWiLight Menu++](/twilightmenu/installing-dsi) installed
- The latest release of [MakeForwarder](https://github.com/Ta180m/Make-Forwarder-Dsi/releases)
### Instructions
1. Extract *the contents of* `MakeForwarder.zip` to the root of your SD card
1. Launch TWiLight Menu++
1. Launch the Nintendo DS ROM you want to create a forwarder for
1. Once the ROM boots, turn off your console
- If it does not work, please follow the nds-bootstrap troubleshooting guide
1. Launch hiyaCFW
1. Once in the Nintendo DSi Menu, unwrap and launch "Forwarder Maker"
1. Set your target bootstrap depending on what your application is:
- **Retail ROM:** `sd:/_nds/nds-bootstrap-release.nds`
- **Homebrew:** `sd:/_nds/nds-bootstrap-hb-release.nds`
1. Select `create forwarder` and navigate to the location of your ROM
Repeat step 7 and 8 until you have created all desired forwarders.
- You do not need to reset the target bootstrap if using the same type of ROM
Once you've installed forwarders for all of your ROMs, reboot the system and launch hiyaCFW. They should now appear in gift boxes.

View File

@ -0,0 +1,13 @@
---
lang: en-US
layout: wiki
section: hiyacfw
title: hiyaCFW
description: Information on how to install and use hiyaCFW
---
[hiyaCFW](https://github.com/RocketRobz/hiyaCFW) is a custom firmware that will allow you to run your system NAND (internal storage) off of your SD card.
This allows you to install your own apps to the Nintendo DSi Menu without risk of bricking, as theyre installed to the SD card so problems can fixed easily.
It also allows easy installation of homebrew applications to the DSi Menu and displaying a custom splash screen on boot.

View File

@ -0,0 +1,79 @@
---
lang: en-US
layout: wiki
section: hiyacfw
title: Installing
long_title: Installing hiyaCFW
description: How to install hiyaCFW on the Nintendo DSi
tabs:
- windows: Windows
macos: macOS
other: Linux
---
Do not system update after installing hiyaCFW. Doing so will remove hiyaCFW's SD patches.
{: .alert .alert-danger}
### Requirements
- A Nintendo DSi with [Unlaunch installed](https://dsi.cfw.guide/installing-unlaunch)
- A NAND Backup taken from your device using dumpTool
- If you don't have one, follow the [Dumping NAND](https://dsi.cfw.guide/dumping-nand) guide on dsi.cfw.guide
- A Windows, macOS, or Linux device
### Part 1: Preparing your PC for installing hiyaCFW
{% capture tab-windows %}
The hiyaCFW Helper is known to cause false positives with Windows Defender and other antivirus programs, please temporarity disable such programs if you have trouble downloading or running it.
{: .alert .alert-info}
1. Download & install the latest version of [7-Zip](https://www.7-zip.org/download.html)
- This will not work with any other archive extractor tool, such as WinRAR, the hiyaCFW helper relies on 7-Zip itself, and not a general archive extractor
1. Download the latest Windows version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
1. Extract the hiyaCFW Helper archive anywhere on your PC
{% endcapture %}
{% assign tab-windows = tab-windows | split: "////////" %}
{% capture tab-macos %}
1. Download the latest macOS version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
1. Extract the hiyaCFW Helper archive anywhere on your PC
{% endcapture %}
{% assign tab-macos = tab-macos | split: "////////" %}
{% capture tab-other %}
1. Install Python 3 using your package manager if its not already installed
1. Download the latest Python version of the [hiyaCFW Helper](https://github.com/mondul/HiyaCFW-Helper/releases)
1. Extract the hiyaCFW Helper archive anywhere on your PC
1. Make sure the necessary Python packages are installed by running `pip3 install -r requirements.txt` in the directory containing the extracted files
- You can install pip by running `python3 -m ensurepip`
{% endcapture %}
{% assign tab-other = tab-other | split: "////////" %}
{% assign tabs = tab-windows | concat: tab-macos | concat: tab-other %}
{% include tabs.html index=0 tabs=tabs %}
### Part 2: Adding hiyaCFW files to your SD card
![Screenshot of the hiyaCFW Helper](https://image.ibb.co/hhzKRL/Screen-Shot-2018-10-18-at-16-30-18.png)
1. Launch the hiyaCFW Helper
- **Windows:** Launch the `HiyaCFW_Helper.exe` file extracted from the hiyaCFW Helper archive (you may need to temporarily disable your antivirus)
- **macOS:** Right click the `HiyaCFW_Helper` file extracted from the hiyaCFW Helper archive and choose `Open`
- **Linux:** Launch the `HiyaCFW_Helper.py` extracted from the hiyaCFW Helper archive
1. Click the `...` button in the "NAND file with No$GBA footer" box
1. Navigate to your NAND backup, and click `Open`
1. Press `Start`
1. In the new pop-up window, navigate to the root of your SD card, and press `OK`.
- The process may take several minutes
1. When the application says `Done!`, close out of the hiyaCFW Helper
1. Close the terminal window
### Part 3: Configuring Unlaunch and hiyaCFW
1. Power on your Nintendo DSi console while holding <kbd class="face">A</kbd> and <kbd class="face">B</kbd>
- This should take you to Unlaunch's file menu
1. Navigate to `OPTIONS`, then `NO BUTTON`
1. Select `hiyaCFW` and press <kbd class="face">A</kbd>
- This will make the system launch hiyaCFW automatically
1. Save your settings and restart your console
1. Hold <kbd>SELECT</kbd> while powering on your Nintendo DSi console to access the hiyaCFW settings
1. Change the settings to your liking, then press <kbd>START</kbd> to continue
If it shows `An error has occurred`, please see the [troubleshooting](troubleshooting#an-error-has-occurred) page.
{: .alert .alert-warning}

View File

@ -0,0 +1,32 @@
---
lang: en-US
layout: wiki
section: hiyacfw
title: Troubleshooting
category: other
description: Troubleshooting information for hiyaCFW
---
## #-2435-8325
If your Nintendo DSi shows an error in this format when booting, with the # being a number, that means that bootstage 2 thinks something is wrong with your SDNAND. This is usually fixed by [reinstalling hiyaCFW](installing-hiyacfw).
## "An error has occurred"
When the Nintendo DSi Menu detects a problem it will usually show this generic error message, some of the causes are:
#### The free space bug
The Nintendo DSi Menu has a bug when checking the free space on large storage devices. While this can't occur on the actual NAND (since the chip is only 256 MiB), it can happen when using an SD card.
What works and what doesn't goes by every other range of two gibibytes. For example, having 0-2 GiB of free space works, but 2-4 GiB doesn't. The same goes for 4-6 GiB vs 6-8 GiB, up until you get to the size of your SD card.
The latest hiyaCFW version can create dummy files to work around this, so make sure that you download the latest version of [hiyaCFW](https://github.com/RocketRobz/hiyaCFW/releases/latest/download/hiyaCFW.7z) and copy `hiya.dsi` from "for SDNAND SD card" to the root of your SD card.
#### Over 39 titles
The Nintendo DSi Menu has a limit of 39 titles. If you have more than that, delete some from the folders in `sd:/title` or use [TMFH](https://github.com/JeffRuLz/TMFH/releases/latest) to uninstall them.
#### Too much space used by DSiWare
There is also a limit of 200 blocks (25MB) for DSiWare in the `00030004` folder. This can be worked around by installing as system apps using [TMFH](https://github.com/JeffRuLz/TMFH/releases/latest).
#### Invalid title
There are several things you need to take into account when adding titles to hiyaCFW:
- Game card dumps cannot be run without being using a [forwarder](forwarders)
- Homebrew need to be built correctly using modern tools to work from the Nintendo DSi Menu

View File

@ -2,7 +2,6 @@
lang: en-US
layout: wiki
section: nds-bootstrap
category: other
title: FAQ & Troubleshooting
long_title: nds-bootstrap FAQ & Troubleshooting
description: FAQ & Troubleshooting for nds-bootstrap

View File

@ -2,8 +2,7 @@
lang: en-US
layout: wiki
section: nds-bootstrap
title: Home
long_title: nds-bootstrap
title: nds-bootstrap
description: Information on how to use nds-bootstrap
---

View File

@ -2,7 +2,6 @@
lang: en-US
layout: wiki
section: nds-bootstrap
category: other
title: Compatibility List & Testing Tips
description: Compatibility list and tips for testing games
---

View File

@ -11,7 +11,7 @@ Information for [GodMode9i](https://github.com/DS-Homebrew/GodMode9i), a full ac
### FAQ & Troubleshooting
#### How do I get past the "mounting drive(s)" screen while starting it up?
This happens when you launch GodMode9i from [hiyaCFW](https://wiki.ds-homebrew.com/other/hiyacfw). You can hold X while launching GodMode9i to skip NAND mounting. Alternatively, you can launch GodMode9i directly from unlaunch to be able to mount the NAND.
This happens when you launch GodMode9i from [hiyaCFW](/hiyacfw). You can hold X while launching GodMode9i to skip NAND mounting. Alternatively, you can launch GodMode9i directly from unlaunch to be able to mount the NAND.
#### Why can't I dump games on DSi?
You need Unlaunch installed in order to be able to dump games onto your SD card. You can install Unlaunch by following [dsi.cfw.guide](https://dsi.cfw.guide/).

View File

@ -2,8 +2,7 @@
lang: en-US
layout: wiki
section: other
title: Home
long_title: Other
title: Other Projects
description: Information about other DS-Homebrew projects
---

View File

@ -1,8 +1,7 @@
---
lang: en-US
section: twilightmenu
title: Home
long_title: TWiLight Menu++
title: TWiLight Menu++
description: Guides on how to use and customize TWiLight Menu++
---