YSMenu: Difference between revisions

YSMenu
YSMenu
General
Author	Yasu, updated by RetroGameFan
Type	Kernels
Version	Update
License	Mixed
Last Updated	2019/10/08
Links
	Download
	Website

Revision as of 07:04, 6 February 2023

YSMenu is a Custom Menu for DS FlashCards, which is able to boot GBA, NDS, and emulators. NDS Loader is same as official kernel. It supports DSTT and AceKard2.

Features

Simple directory view.
Can backup/restore SAV file.
Can delete file.
Can boot GBA/Emulators directly (Slot2 cart required).
Sleeps when DS is closed.

Installation

How to install

RetroGameFan has adapted YSMenu which can be installed in a simple manner for your respective FlashCards (e.g. DSTT, DSOne, DSTWO, M3, R4i-SDHC, R4iSDHC and other carts).

Before installing, please backup your MicroSD to a backup folder on your PC, then format it with SD Formatter.

extract the latest Multi Cart Update and find the folder corresponding your Flashcard.

Follow the included install instructions depending on your FlashCard.

Original (Legacy)

Note that this guide is only for the original YSMenu made by Yasu.

To install TTMenu and YSMenu for DSTT, It's recommended to make a backup of your microSD card and reformat it.

Requirements:

Newest version of YSMenu.
The official TTMENU folder.
- For DSTTi, make sure your card is genuine but not a fake one, or it would be destroyed by the official fake-killer firmware.
- To prevent it, it is recommended to substitute with DSTT kernel (fake-killer-disabled).
- TTMENU.DAT (fake-killer-disabled).

DSTT:

Run ttextract.exe with OFFICIAL TTMENU.DAT.
ttdldi.dat and ttpatch.dat will be extracted.
Copy ttdldi.dat, ttpatch.dat and YSMenu.ini to TTMenu directory in TF.
Rename YSMENU.nds to TTMENU.DAT and copy it to TF instead of official TTMENU.DAT.

AceKard2:

Run akextract.exe with OFFICIAL akmenu4.nds. akloader.nds will be extracted.
Copy akloader.nds and YSMenu.ini to YSMenu directory in TF.
Rename YSMENU.nds to akmenu4.nds and copy it to TF instead of official akmenu4.nds.

Guide To Make YSMenu Work On The R4.

User guide

YSMenu Settings

Soft Reset - In game, Press L+R+X+Y+B+A.
Cheats - In YSMenu, Press Y on the game you want to use cheats on. Select the cheats you want, then press START to save and return to YSMenu.
Delete - In YSMenu, Press X to delete a file. (You'll need to edit the following line in YSMenu.ini to: NO_DEL=false).
Screen Brightness - In YSMenu, touch top-left corner of bottom screen (NOTE : This does not work on a 3DS).
Scrolling - In YSMenu, press Right to scroll down 1 page, press Left to scroll up 1 page.
Save Type - All .sav are created by default as FLASH 512kb 0xFF padded files, except for games listed in savlib.dat.
Skins - Both files must be in .bmp format, 256x192 in size & 24-bit depth 15-bit colour (YSMenu1.bmp for top, YSMenu2.bmp for bottom screen, placed in your TTMenu folder).
Font Colour - To change the font colour, edit these values in YSMenu.ini:
- COLOR_PATH=0x801F
- COLOR_FILE=0xC210
- COLOR_FOLDER=0x8000
- COLOR_SELECT=0xDF7C
- COLOR_SELTEXT=0x8C0E
- COLOR_TEXT=0x801F

Loading Error Codes

"errcode=-4/-5/-6/-8"

Required loading data missing in infolib or kernel can't interpret ARM9.
Also caused by outdated ttpatch.dat/r4patch.dat/m3patch.dat (file depends on which cart you are using).

"errcode=-81/-82/-83"

Caused by fragmentation on your µSD. Backup µSD to PC, then Full format with the Panasonic SD Formatter to rectify.
Any other error codes during loading, please refer to your carts website.

Controls

A - Launch file

X - Delete file

L+R+X+Y+B+A - Soft reset (in game)

NDS:

Y - Select cheat codes

GBA:

Y - Load GBA to PSRAM in slot2

Start - Use PassMe function or to boot slot2 GBA.

If there is DEFAULT.NDS in microSD, it will be load automatically. Press B to stop it.

Known issues

DS to Wii connectivity for Pokemon HeartGold/SoulSilver - Connecting to Wii causes 2 white screens.

TTMenu - Sort games in Alphabetical Order (currently only sorts by Time).

Changelog

2009/03/26 17:00

Replace the library for EZ3in1+ to the WANKO's one.

2009/03/21 17:00

Supports EZ3in1+.

2009/02/07 16:30

Fix: some Icon not shown.
Game List now shows files specified by FILETYPE in ini.
sav creation size can be specified by savlib.dat.

2009/01/19 01:11

BugFix: Can't use some Slot2 Carts.
BugFix: Reset is always ON.
Update EZ3in1 library.
Change Loading screen for 1.17.
You can add external app buttons in START Menu by ini settings.

2009/01/01 00:00

ttextract now accepts inflated TTMENU.DAT.
Default DMA/Reset Setting in ini.
AK2i?

2008/10/21 18:00

Cheat Item Name/Note will be line broken when it is too wide.

2008/09/13 22:22

Fix: a bug about 12MB lager GBA on EZ3in1.
Literals Games/Saves/All Setting in ini.

2008/05/22 22:22

SAV extension setting in ini.
Fix: Not boot on DSLinker.
Fix: ttextract for 0xE5 patch.

2008/05/20 02:55

Simple Text Viewer.
Draws Frame also with skin (u can disable by ini setting).
Fix: a bug after softreset.

2008/04/21 01:15

patching for 0xE5 filename problem by ttextract
supports 8Mbit save?

2008/04/20 01:15

Adjust loading (related time problem?).
supports AceKard2.

2008/03/20 01:15

Brightness Setting in the ini file.
You can Disable File Deletion by ini.
Booting DS Firmware Menu Function.

2008/02/25 23:25

Fix homebrew judge, Unknown file icon.
Adjust loading (related DL-play?).

2008/02/24 24:00

Adjust for GBA Expansion Pack, Ewin, EZ3in1.

2008/02/23 23:23

Adjust: PSRAM load for EZ3in1, GBA Expansion Pack.

2008/02/15 02:15

Adjust: TimeStamp sorting.

2008/02/14 01:45

Fix a bug: Can't boot emu on M3Adaptor.

2008/02/13 02:30

Can sort file list by TimeStamp of SAV.
Supports EwinExpPak EZ4Deluxe SuperCard(without SRAM).
Fix some bugs.

2008/02/11 02:30

read settings from YSMenu.ini.
load cfg for NES to hvca.

2008/02/10 00:10

Function to write to NOR in EZ3in1.
Fix some bugs.

2008/01/29 02:30

Read loader from file.
Setup EZ3in1,M3 as RAM Expansion (for UBR).
Setup EZ3in1 as Rumble Pack.

2008/01/26 17:00

English version.

External links

Author's website (Yasu) - http://home.usay.jp/pc/etc/nds
GBAtemp - https://gbatemp.net/threads/retrogamefan-updates-releases.267243
GBAtemp - https://gbatemp.net/download/retrogamefan-multi-cart-update.35737/

@@ Line 8: / Line 8: @@
 |version=Update
 |license=Mixed
-|download=https://gbatemp.net/threads/retrogamefan-updates-releases.267243
+|download=https://gbatemp.net/download/retrogamefan-multi-cart-update.35737
 |website=https://gbatemp.net/threads/retrogamefan-updates-releases.267243
 }}
@@ Line 21: / Line 21: @@
 ==Installation==
-===Original method===
+===How to install===
+RetroGameFan has adapted YSMenu which can be installed in a simple manner for your respective FlashCards (e.g. DSTT, DSOne, DSTWO, M3, R4i-SDHC, R4iSDHC and other carts).
+Before installing, please backup your MicroSD to a backup folder on your PC, then format it with [https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip SD Formatter].
+[https://www.7-zip.org/download.html extract] the latest [https://gbatemp.net/download/retrogamefan-multi-cart-update.35737/ Multi Cart Update] and find the folder corresponding your Flashcard.
+Follow the included install instructions depending on your FlashCard.
+===Original (Legacy)===
 Note that this guide is only for the original YSMenu made by Yasu.
@@ Line 45: / Line 54: @@
 [https://gbatemp.net/threads/guide-to-make-ysmenu-work-on-the-r4.97615/ Guide To Make YSMenu Work On The R4.]
-===Alternative method (update 2019)===
-[https://gbatemp.net/threads/retrogamefan-updates-releases.267243 RetroGameFan] has adapted YSMenu which can be installed in a simple manner for your respective FlashCards (e.g. DSTT, DSOne, DSTWO, M3, R4i-SDHC, R4iSDHC and other carts).
-Before installing, please format the MicroSD with Panasonic SD Formatter (provided).
-Then extract the [https://gbatemp.net/download/retrogamefan-multi-cart-update.35737/ updated YSMenu] by RetroGameFan, find the folder corredponding your Flashcard.
-Follow the included instructions depending on your FlashCard (the below method will enable dual booting, see the [https://gbatemp.net/threads/retrogamefan-updates-releases.267243 release thread] for the complete guide including lists of compatible carts).
-'''DSTT/DSTTi:'''
-* Make sure you already have the latest Firmware installed.
-* Extract these files from DSTTi-Clone TTMenu/YSMenu folder and copy to root of your SD:
-** Games folder.
-** TTMenu folder.
-** TTMenu.dat.
-** TTMenu.nds/YSMenu.nds.
-'''M3Real/M3iZero:'''
-* Make sure you already have the latest Sakura/TouchPod Kernel installed.
-* Extract these files from M3Real_M3iZero YSMenu folder and copy to root of your SD:
-** Games folder
-** TTMenu folder
-** SRESET.DAT
-** YSMenu.nds
-'''R4/R4i:'''
-* Make sure you already have the latest Firmware installed.
-* Extract the following files from R4-Clone YSMenu folder and copy to root of your SD:
-** Games folder
-** TTMenu folder
-** TTMenu.dat
-** YSMenu.nds
-'''DSOne/DSOnei:'''
-* Make sure you already have the latest EOS Kernel installed.
-* Extract the files from the DSONEi SDHC YSMenu folder and copy to root of your SD:
-** Games folder
-** TTMenu folder
-** MSFORSC.nds
-** TTMenu.dat
-'''DSTWO:'''
-* Make sure you already have the latest EOS Kernel installed.
-* Extract the files from the DSTWO YSMenu folder and copy to root of your SD:
-** _dstwoplug folder
-** Games folder
-** TTMenu folder
-** _DS_MENU.DAT
-** TTMenu.dat
 ==User guide==
-===Language===
+===YSMenu Settings===
-Change [YSMENU]LITERALS in YSMenu.ini if you use in English or another language (erase a semi-cron).
+* Soft Reset - In game, Press L+R+X+Y+B+A.
+* Cheats - In YSMenu, Press Y on the game you want to use cheats on. Select the cheats you want, then press START to save and return to YSMenu.
-If you use non-ASCII characters (e.g. Japanese), put next files for an encoding which you use to YSMenu directory (system.fon/system.ank/system.u2l/system.l2u).
+* Delete - In YSMenu, Press X to delete a file. (You'll need to edit the following line in YSMenu.ini to: NO_DEL=false).
+* Screen Brightness - In YSMenu, touch top-left corner of bottom screen (NOTE : This does not work on a 3DS).
-Put next files to YSMenu directory if you want/need/use (goomba.gba/PocketNES.gba/hvca.gba/YSMenu1.bmp/YSMenu2.bmp).
+* Scrolling - In YSMenu, press Right to scroll down 1 page, press Left to scroll up 1 page.
+* Save Type - All .sav are created by default as FLASH 512kb 0xFF padded files, except for games listed in savlib.dat.
-===Limitations===
+* Skins - Both files must be in .bmp format, 256x192 in size & 24-bit depth 15-bit colour (YSMenu1.bmp for top, YSMenu2.bmp for bottom screen, placed in your TTMenu folder).
-Doesn't support Multiple Skins/Themes (It's possible using 3rd party Homebrew).
+* Font Colour - To change the font colour, edit these values in YSMenu.ini:
+** COLOR_PATH=0x801F
+** COLOR_FILE=0xC210
+** COLOR_FOLDER=0x8000
+** COLOR_SELECT=0xDF7C
+** COLOR_SELTEXT=0x8C0E
+** COLOR_TEXT=0x801F
-Uses Official DSTT loaders - so any problems with DSTT then this will not fix them.
+===Loading Error Codes===
+"errcode=-4/-5/-6/-8"
+* Required loading data missing in infolib or kernel can't interpret ARM9.
+* Also caused by outdated ttpatch.dat/r4patch.dat/m3patch.dat (file depends on which cart you are using).
-Default Language/Help is Japanese, so some editing required change into English.
+"errcode=-81/-82/-83"
+* Caused by fragmentation on your µSD. Backup µSD to PC, then Full format with the Panasonic SD Formatter to rectify.
+* Any other error codes during loading, please refer to your carts website.
 ==Controls==
@@ Line 208: / Line 178: @@
 * Author's website (Yasu) - http://home.usay.jp/pc/etc/nds
 * GBAtemp - https://gbatemp.net/threads/retrogamefan-updates-releases.267243
+* GBAtemp - https://gbatemp.net/download/retrogamefan-multi-cart-update.35737/
 [[Category:DS homebrew applications]]
 [[Category:DS homebrew loaders]]