3DS:Open agb firm: Difference between revisions

open_agb_firm
Developer(s)	profi200
Console	Nintendo 3DS
Version	2022-4-25 (April 25, 2022; 2 years ago)
Links
GitHub	profi200/open_agb_firm
Download
	Universal-DB; GitHub release;
	v; t; e;

Latest revision as of 19:42, 19 December 2023

open_agb_firm is a bare-metal application for running Game Boy Advance games using the Nintendo 3DS's native GBA hardware capabilities.

Features

open_agb_firm uses the 3DS's native capabilities to run GBA software, just like the original AGB_FIRM. The main difference is that it allows running ROMs from files on the SD card, instead of requiring them to be installed as digital games. Save files are also put on the SD card, making access to them far easier than AGB_FIRM.

Like AGB_FIRM, additional hardware features like accelerometer and camera are not supported. Games that depend on these features like WarioWare: Twisted! and Game Boy Camera will not work. The exception is the real-time clock which is implemented, so games that use this such as the third-generation Pokémon games can use it as normal.

Installation

Universal-Updater

open_agb_firm is available on Universal-DB and can be installed and updated with Universal-Updater.

Manually

Download the latest release (the open_agb_firm .7z file)
Extract the open_agb_firm .7z file using 7-Zip (or another appropriate utility for your computer's operating system)
Copy open_agb_firm.firm from the extracted contents and place it in /luma/payloads/
Copy the 3ds folder from the extracted contents to the root of your SD card
- If your computer asks to merge or overwrite anything, allow it

Usage

Press and hold START while turning on the console to choose it through the Luma3DS chainloader. A reboot is required to select a different game.

ROMs can be placed anywhere on the SD card. Save files are put in /3ds/open_agb_firm/saves (e.g. if the game is at /roms/Mario Kart.gba, the save is at /3ds/open_agb_firm/Mario Kart.sav).

Example

(root)
- 3ds
  - open_agb_firm
    - saves
      - Mario Kart.sav
      - Pokemon Emerald.sav
    - gba_db.bin
- roms
  - Mario Kart.gba
- mygames
  - gba
    - Pokemon Emerald.gba

Configuration

Configuration settings are available on GitHub.

@@ Line 6: / Line 6: @@
 | universaldb = 3ds/open_agb_firm
 | githubtag = latest
+| developers = profi200
 | version = 2022-4-25
+| releasedate = 2022-04-25
 }}
-'''open_agb_firm''' is a bare-metal application for running Game Boy Advanced games using the Nintendo 3DS's native GBA hardware capabilities.
+'''open_agb_firm''' is a bare-metal application for running Game Boy Advance games using the Nintendo 3DS's native GBA hardware capabilities.
 == Features ==
-open_agb_firm uses the 3DS's native capabilities to run GBA software, just like the original AGB_FIRM. The main difference is that it allowes running ROMs from files on the SD card, instead of requiring them to be installed as digital games. Save files are also put on the SD card, making access to them far easier than AGB_FIRM.
+open_agb_firm uses the 3DS's native capabilities to run GBA software, just like the original AGB_FIRM. The main difference is that it allows running ROMs from files on the SD card, instead of requiring them to be installed as digital games. Save files are also put on the SD card, making access to them far easier than AGB_FIRM.
-Like AGB_FIRM, additional hardware features like accelerometer and camera are not supported. Games that depend on these features like {{iw|wikipedia|WarioWare: Twisted!}} and {{iw|wikipedia|Game Boy Camera}} will not work.
+Like AGB_FIRM, additional hardware features like accelerometer and camera are not supported. Games that depend on these features like {{iw|wikipedia|WarioWare: Twisted!}} and {{iw|wikipedia|Game Boy Camera}} will not work. The exception is the real-time clock which is implemented, so games that use this such as the third-generation Pokémon games can use it as normal.
 == Installation ==
 === Universal-Updater ===
-open_agb_firm is available on Universal-DB.
+[[udb:3ds/open_agb_firm|open_agb_firm]] is available on Universal-DB and can be installed and updated with [[3DS:Universal-Updater|Universal-Updater]].
 === Manually ===
-* {{GitHub|profi200/open_agb_firm/releases/latest|Download the latest release}}
+# {{GitHub|profi200/open_agb_firm/releases/latest|Download the latest release}} (the open_agb_firm <code>.7z</code> file)
-* Extract <code>open_agb_firm.firm</code> and place it in <code>/luma/payloads</code>
+# Extract the open_agb_firm <code>.7z</code> file using [https://www.7-zip.org/ 7-Zip] (or another appropriate utility for your computer's operating system)
+# Copy <code>open_agb_firm.firm</code> from the extracted contents and place it in <code>/luma/payloads/</code>
+# Copy the <code>3ds</code> folder from the extracted contents to the root of your SD card
+#* If your computer asks to merge or overwrite anything, allow it
 == Usage ==
 {{Section WIP}}
-Press and hold START while turning on the console to choose it through the Luma3DS chainloader.
+Press and hold START while turning on the console to choose it through the Luma3DS chainloader. A reboot is required to select a different game.
-ROMs can be placed anywhere on the SD card. Save files are put next to the games (e.g. if the game is at <code>/roms/Mario Kart.gba</code>, the save is at <code>/roms/Mario Kart.'''sav'''</code>).
+ROMs can be placed anywhere on the SD card. Save files are put in <code>/3ds/open_agb_firm/saves</code> (e.g. if the game is at <code>/roms/Mario Kart.gba</code>, the save is at <code>/3ds/open_agb_firm/Mario Kart.sav</code>).
+=== Example ===
+{{Tree list}}
+* {{Tree icon|sd}} (root)
+** {{Tree icon|d}} 3ds
+*** {{Tree icon|d}} open_agb_firm
+**** {{Tree icon|d}} saves
+***** {{Tree icon|f}} '''Mario Kart.sav'''
+***** {{Tree icon|f}} '''Pokemon Emerald.sav'''
+**** {{Tree icon|f}} gba_db.bin
+** {{Tree icon|d}} roms
+*** {{Tree icon|f}} '''Mario Kart.gba'''
+** {{Tree icon|d}} mygames
+*** {{Tree icon|d}} gba
+**** {{Tree icon|f}} '''Pokemon Emerald.gba'''
+{{Tree list/end}}
+== Configuration ==
+Configuration settings are [https://github.com/profi200/open_agb_firm#configuration available on GitHub].
 == See also ==
 * [[3DS:GBA games]]