Linux for 3DS: Difference between revisions

Linux for 3DS
Linux for 3DS
General
Author	kleo, nickdesaulniers, ParzivalWolfram, Wolfvak, xerpi
Type	Operating Systems
Version	2022
License	Mixed
Last Updated	2022/10/12
Links
	Download
	Website
	Source

Latest revision as of 11:22, 22 Haziran 2024

Linux for 3DS is a homebrew project that allows you to run Linux on your 3DS.

Installation

Installing

Note: You should already have boot9strap or fastboot3DS installed (if you followed the guide, boot9strap is your bootloader and Luma is your chainloader).

You will need the following files:

zImage, nintendo3ds_ctr.dtb or nintendo3ds_ktr.dtb(N3DS) from linux (Linux kernel source tree), can be built from buildroot.
firm_linux_loader.firm from firm_linux_loader (FIRM Linux Loader for the Nintendo 3DS).
arm9linuxfw.bin from arm9linuxfw (implement virtio over PXI for ARM11 <-> ARM9 communications on the Nintendo 3DS console).

Copy them to your SD card so it looks something like this:

Root 
 |-linux/ 
 |  |-arm9linuxfw.bin
 |  |-nintendo3ds_ctr.dtb or nintendo3ds_ktr.dtb(N3DS)
 |  |-zImage
 |-luma/
 |  |-payloads/
 |  |  |-firm_linux_loader.firm

Building

Please see the official wiki pages and the tutorial video below.

User guide

You need to boot the firm_linux_loader.firm file, which will in turn load all the generated binaries (zImage, nintendo3ds_ctr.dtb or nintendo3ds_ktr.dtb depending on your model and arm9linuxfw.bin) into memory and boot the kernel.

The default rootfs will ask you a username and password, currently there are no users so you can log in as root with the password toor.

Media

Building Linux for the Nintendo 3DS (Kleo Bercero)

External links

GitHub (Linux for 3DS) - https://github.com/linux-3ds
GitHub (linux) - https://github.com/linux-3ds/linux
GitHub (builtroot) - https://github.com/linux-3ds/buildroot
GitHub (firm_linux_loader) - https://github.com/linux-3ds/firm_linux_loader
GitHub (arm9linuxfw) - https://github.com/linux-3ds/arm9linuxfw
GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187
3DS Hacks Guide - https://3ds.hacks.guide

@@ Line 1: / Line 1: @@
 {{Infobox 3DS Homebrews
-| title = linux for
+|title=Linux for 3DS
-| image = linuxfor3DS.jpg|250px
+|image=Linuxfor3ds2.png
-| type = Operating systems
+|description=Run Linux on 3DS.
-| version=build 3810c17
+|author=kleo, nickdesaulniers, ParzivalWolfram, Wolfvak, xerpi
-| lastupdated = 2021/06/26
+|lastupdated=2022/10/12
-| license = Mixed
+|type=Operating Systems
-| author = kleo, nick, wolfvak, xerpi
+|version=2022
-| website = https://github.com/linux-3ds/linux
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/linuxfornew3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/linuxfor3ds.zip
-| source = https://github.com/linux-3ds/linux
+|website=https://github.com/linux-3ds
+|source=https://github.com/linux-3ds
 }}
-<youtube>al8aohdZjFE</youtube>
+Linux for 3DS is a homebrew project that allows you to run Linux on your 3DS.
-==Linux kernel==
+==Installation==
+===Installing===
+'''Note:''' You should already have boot9strap or fastboot3DS installed (if you followed [https://3ds.hacks.guide the guide], boot9strap is your bootloader and Luma is your chainloader).
-There are several guides for kernel developers and users. These guides can
+You will need the following files:
-be rendered in a number of formats, like HTML and PDF. Please read
+* <code>zImage</code>, <code>nintendo3ds_ctr.dtb</code> or <code>nintendo3ds_ktr.dtb(N3DS)</code> from [https://github.com/linux-3ds/linux/releases linux] (Linux kernel source tree), can be built from [https://github.com/linux-3ds/buildroot/releases buildroot].
-Documentation/admin-guide/README.rst first.
+* <code>firm_linux_loader.firm</code> from [https://github.com/linux-3ds/firm_linux_loader/releases firm_linux_loader] (FIRM Linux Loader for the Nintendo 3DS).
+* <code>arm9linuxfw.bin</code> from [https://github.com/linux-3ds/arm9linuxfw/releases arm9linuxfw] (implement virtio over PXI for ARM11 <-> ARM9 communications on the Nintendo 3DS console).
-In order to build the documentation, use ``make htmldocs`` or
+Copy them to your SD card so it looks something like this:
-``make pdfdocs``.  The formatted documentation can also be read online at:
-*https://www.kernel.org/doc/html/latest/
+ Root
+  |-linux/
+  |  |-arm9linuxfw.bin
+  |  |-nintendo3ds_ctr.dtb or nintendo3ds_ktr.dtb(N3DS)
+  |  |-zImage
+  |-luma/
+  |  |-payloads/
+  |  |  |-firm_linux_loader.firm
-There are various text files in the Documentation/ subdirectory,
+===Building===
-several of them using the Restructured Text markup notation.
+Please see the official [https://github.com/linux-3ds/linux/wiki wiki pages] and the [https://www.gamebrew.org/wiki/Linux_for_3DS#Media tutorial video below].
-Please read the Documentation/process/changes.rst file, as it contains the
+==User guide==
-requirements for building and running the kernel, and information about
+You need to boot the <code>firm_linux_loader.firm</code> file, which will in turn load all the generated binaries (<code>zImage</code>, <code>nintendo3ds_ctr.dtb</code> or <code>nintendo3ds_ktr.dtb</code> depending on your model and arm9linuxfw.bin) into memory and boot the kernel.
-the problems which may result by upgrading your kernel.
+The default rootfs will ask you a username and password, currently there are no users so you can log in as <code>root</code> with the password <code>toor</code>.
+==Media==
+'''Building Linux for the Nintendo 3DS''' ([https://www.youtube.com/watch?v=mTo8yb6q4Lw Kleo Bercero]) <br>
+<youtube>mTo8yb6q4Lw</youtube>
+==External links==
+* GitHub (Linux for 3DS) - https://github.com/linux-3ds
+* GitHub (linux) - https://github.com/linux-3ds/linux
+* GitHub (builtroot) - https://github.com/linux-3ds/buildroot
+* GitHub (firm_linux_loader) - https://github.com/linux-3ds/firm_linux_loader
+* GitHub (arm9linuxfw) - https://github.com/linux-3ds/arm9linuxfw
+* GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187
+* 3DS Hacks Guide - https://3ds.hacks.guide