Linux for 3DS: Difference between revisions

Linux for 3DS
Linux for 3DS
	File:Linuxfor3DS.jpg
General
Author	kleo, nickdesaulniers, ParzivalWolfram, Wolfvak, xerpi
Type	Operating systems
Version	2021
License	Mixed
Last Updated	2021/10/19
Links
	Download
	Website
	Source

Revision as of 06:27, 29 November 2021

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(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 and it should look like this:

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

Building

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

Uer 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 (FIRM Linux Loader for the Nintendo 3DS).
GitHub (arm9linuxfw) - https://github.com/linux-3ds/arm9linuxfw
GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187

@@ Line 1: / Line 1: @@
 {{Infobox 3DS Homebrews
-|title=linux for
+|title=Linux for 3DS
 |image=linuxfor3DS.jpg
-|description=Linux kernel source tree.
+|description=Run Linux on 3DS.
-|author=kleo, nick, wolfvak, xerpi
+|author=kleo, nickdesaulniers, ParzivalWolfram, Wolfvak, xerpi
-|lastupdated=2021/06/26
+|lastupdated=2021/10/19
 |type=Operating systems
-|version=build 3810c17
+|version=2021
 |license=Mixed
-|download=https://dlhb.gamebrew.org/3dshomebrew/linuxfornew3DS.rar
+|download=https://github.com/linux-3ds
-|website=https://github.com/linux-3ds/linux
+|website=https://github.com/linux-3ds
-|source=https://github.com/linux-3ds/linux
+|source=https://github.com/linux-3ds
 }}
-<youtube>al8aohdZjFE</youtube>
-==Linux kernel==
+Linux for 3DS is a homebrew project that allows you to run Linux on your 3DS.
-There are several guides for kernel developers and users. These guides can
+==Installation==
-be rendered in a number of formats, like HTML and PDF. Please read
+===Installing===
-Documentation/admin-guide/README.rst first.
+'''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).
-In order to build the documentation, use ``make htmldocs`` or
+You will need the following files:
-``make pdfdocs``.  The formatted documentation can also be read online at:
+* <code>zImage</code>, <code>nintendo3ds_ctr.dtb</code> or <code>nintendo3ds_ktr(N3DS)</code> from [https://github.com/linux-3ds/linux linux] (Linux kernel source tree), can be built from [https://github.com/linux-3ds/buildroot buildroot].
+* <code>firm_linux_loader.firm</code> from [https://github.com/linux-3ds/firm_linux_loader firm_linux_loader] (FIRM Linux Loader for the Nintendo 3DS).
+* <code>arm9linuxfw.bin</code> from [https://github.com/linux-3ds/arm9linuxfw arm9linuxfw] (implement virtio over PXI for ARM11 <-> ARM9 communications on the Nintendo 3DS console).
-*https://www.kernel.org/doc/html/latest/
+Copy them to your SD card and it should look like this:
-There are various text files in the Documentation/ subdirectory,
+ Root
-several of them using the Restructured Text markup notation.
+  |-linux/
+  |  |-arm9linuxfw.bin
+  |  |-nintendo3ds_ctr.dtb or nintendo3ds_ktr(N3DS)
+  |  |-zImage
+  |-luma/
+  |  |-payloads/
+  |  |  |-firm_linux_loader.firm
-Please read the Documentation/process/changes.rst file, as it contains the
-requirements for building and running the kernel, and information about
+===Building===
-the problems which may result by upgrading your kernel.
+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].
+==Uer guide==
+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 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 (FIRM Linux Loader for the Nintendo 3DS).
+* GitHub (arm9linuxfw) - https://github.com/linux-3ds/arm9linuxfw
+* GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187
+[[Category:3DS homebrew applications]]
+[[Category:Homebrew operating systems on 3DS]]