Linux 3DS: Difference between revisions

Linux
Linux
General
Author	xerpi
Type	Operating systems
Version	5.10.0+
License	Mixed
Last Updated	2020/12/20
Links
	Download
	Website
	Source

Latest revision as of 12:54, 29 August 2023

This is a Linux port for the 3DS, which launches a minimalist Linux environment with Busybox (a one executable alternative to several unix utilities such ls, cat, top, etc) and a Wayland compositor for graphics.

It was created by xerpi and developement has moved to a new repository Linux For 3DS.

Note: The linux port is currently incomplete, serving more as a proof-of-concept only.

Installation

Installing

Note: You should already have boot9strap or fastboot3DS installed (if you followed 3DS Hacks Guide, boot9strap is your bootloader and Luma is your chainloader).

Release contains the folllowing precompiled binaries:

zImage and nintendo3ds_ctr.dtb - Linux kernel (repository page).
firm_linux_loader.firm - FIRM Linux Loader for the Nintendo 3DS (repository page).
arm9linuxfw.bin - Implement virtio over PXI for ARM11 <-> ARM9 communications on the Nintendo 3DS console (repository page).

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

Root 
 |-linux/ 
 |  |-arm9linuxfw.bin
 |  |-nintendo3ds_ctr.dtb
 |  |-zImage
 |-luma/
 |  |-payloads/
 |  |  |-firm_linux_loader.firm

Building

Please refer to the build instructions.

User guide

Power on the 3DS pressing Start (or the button you have assocciated with the FIRM Linux Loader Luma3DS payload), the username is root and the password is root.

You can start Weston by running:

# /start-weston.sh

You can change the input mode (keybord, mouse) by pressing Select.

Media

3DS Linux (kevansevans)

[Nintendo 3DS]Running Linux on the 3DS with A9LH (Gnmpolicemata)

Changelog

5.10.0+ 2020/12/20

nintendo3ds: Initial port.

4.12.0-rc7 2020/09/15

Nintendo 3DS: Add atheros,ath6kl to the DTS.

External links

GitHub (Linux 3DS) - https://github.com/xerpi/linux_3ds
GitHub (FIRM Linux loader) - https://github.com/xerpi/firm_linux_loader
GitHub (arm9linuxfw) - https://github.com/xerpi/arm9linuxfw
GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187
Reddit - https://www.reddit.com/r/3dshacks/comments/it6awe/update_3ds_linux_port_updated_to_590rc5
3DS Hacks Guide - https://3ds.hacks.guide

@@ Line 1: / Line 1: @@
-{{Infobox 3DS homebrew
+{{Infobox 3DS Homebrews
-| title = Linux
+|title=Linux
-| image = https://dlhb.gamebrew.org/3dshomebrew/Linux3ds.jpg|250px
+|image=Linux3dsxer.png
-| type = Operating systems
+|description=Linux on 3DS.
-| version = 5.9.0-rc5
+|author=xerpi
+|lastupdated=2020/12/20
+|type=Operating systems
+|version=5.10.0+
+|license=Mixed
+|download=https://dlhb.gamebrew.org/3dshomebrews/linux_3ds_xerpi.7z
+|website=https://github.com/xerpi/linux_3ds
+|source=https://github.com/xerpi/linux_3ds
+}}
+This is a Linux port for the 3DS, which launches a minimalist Linux environment with Busybox (a one executable alternative to several unix utilities such ls, cat, top, etc) and a Wayland compositor for graphics.
+It was created by xerpi and developement has moved to a new repository [[Linux_for_3DS|Linux For 3DS]].
+Note: The linux port is currently incomplete, serving more as a proof-of-concept only.
-| licence = Mixed
+==Installation==
-| author = xerpi
+===Installing===
-| website = https://www.reddit.com/r/3dshacks/comments/it6awe/update_3ds_linux_port_updated_to_590rc5/
+'''Note:''' You should already have boot9strap or fastboot3DS installed (if you followed [https://3ds.hacks.guide 3DS Hacks Guide], boot9strap is your bootloader and Luma is your chainloader).
-| download = https://dlhb.gamebrew.org/3dshomebrew/Linux3ds.rar
-| source = https://dlhb.gamebrew.org/3dshomebrew/Linux3ds.rar
+Release contains the folllowing precompiled binaries:
-}}
+* <code>zImage</code> and <code>nintendo3ds_ctr.dtb</code> - Linux kernel ([https://github.com/xerpi/linux_3ds repository page]).
-<youtube>VUHW46EDObE</youtube>
+* <code>firm_linux_loader.firm</code> - FIRM Linux Loader for the Nintendo 3DS ([https://github.com/xerpi/firm_linux_loader repository page]).
+* <code>arm9linuxfw.bin</code> - Implement virtio over PXI for ARM11 <-> ARM9 communications on the Nintendo 3DS console ([https://github.com/xerpi/arm9linuxfw repository page]).
+Copy them to your SD card so it looks something like this:
+ Root
+  |-linux/
+  |  |-arm9linuxfw.bin
+  |  |-nintendo3ds_ctr.dtb
+  |  |-zImage
+  |-luma/
+  |  |-payloads/
+  |  |  |-firm_linux_loader.firm
+===Building===
+Please refer to the [https://gist.github.com/xerpi/3c720d345820691a2985502fcd80268f build instructions].
+==User guide==
+Power on the 3DS pressing Start (or the button you have assocciated with the FIRM Linux Loader Luma3DS payload), the username is <code>root</code> and the password is <code>root</code>.
+You can start Weston by running:
+ # /start-weston.sh
+You can change the input mode (keybord, mouse) by pressing Select.
-Hi there!
+==Media==
+'''3DS Linux''' ([https://www.youtube.com/watch?v=al8aohdZjFE kevansevans]) <br>
+<youtube>al8aohdZjFE</youtube>
-I have rebased my Linux port for the 3DS to the latest Linux version (5.9.0-rc5) which was literally released yesterday (September 14th). It took me quite a few hours to get it working but hey, the effort paid off!
+'''[Nintendo 3DS]Running Linux on the 3DS with A9LH''' ([https://www.youtube.com/watch?v=VUHW46EDObE Gnmpolicemata]) <br>
+<youtube>VUHW46EDObE</youtube>
-r/3dshacks - [Update] 3DS Linux port updated to 5.9.0-rc5 Linux 5.9.0-rc5 running on a Nintendo 3DS (CTR)
+==Changelog==
+'''5.10.0+ 2020/12/20'''
+* nintendo3ds: Initial port.
-Unfortunately, I'm quite busy these days so I'm writing this post to see if anybody is interested in helping improve the port and write more drivers/features.
+'''4.12.0-rc7 2020/09/15'''
+* Nintendo 3DS: Add atheros,ath6kl to the DTS.
-Check this for boot instructions and this for build instructions.
+==External links==
+* GitHub (Linux 3DS) - https://github.com/xerpi/linux_3ds
+* GitHub (FIRM Linux loader) - https://github.com/xerpi/firm_linux_loader
+* GitHub (arm9linuxfw) - https://github.com/xerpi/arm9linuxfw
+* GBAtemp - https://gbatemp.net/threads/release-linux-for-the-3ds.407187
+* Reddit - https://www.reddit.com/r/3dshacks/comments/it6awe/update_3ds_linux_port_updated_to_590rc5
+* 3DS Hacks Guide - https://3ds.hacks.guide
-Feel free to ping me if you have questions!
+[[Category:3DS homebrew applications]]
+[[Category:Homebrew operating systems on 3DS]]